Skip to content

Establish Psyche roadmap and agent-readiness foundation - #15

Draft
BunsDev wants to merge 1 commit into
mainfrom
program/agent-readiness-foundation
Draft

Establish Psyche roadmap and agent-readiness foundation#15
BunsDev wants to merge 1 commit into
mainfrom
program/agent-readiness-foundation

Conversation

@BunsDev

@BunsDev BunsDev commented Aug 26, 2026

Copy link
Copy Markdown
Member

Summary

Establish the first public operating layer for Psyche without changing protocol behavior:

  • add a root README with status, canonical ownership, architecture map, quick start, and active roadmap;
  • add a concise AGENTS.md with risk classes, invariants, protected surfaces, and evidence requirements;
  • add contribution, security, and MIT license surfaces;
  • add the active 90-day roadmap and proposed OpenCoven protocol-ownership matrix;
  • add agent/manifest.yaml as a machine-readable repository/contract/risk declaration;
  • add deterministic scripts/agent-bootstrap and scripts/agent-check fast|full entrypoints.

Why

The repository already has a substantial Rust/G2 contract foundation, but a clean-checkout contributor or coding agent has no root onboarding surface, active roadmap, explicit cross-repository ownership map, or single verification interface. This PR addresses that operational gap before protocol v1 publication and downstream adoption.

Scope and risk

Risk: R0/R1 documentation and verification orchestration around an R4 repository.

This PR does not change:

  • canonical IDs, records, enums, serialization, or digests;
  • migrations, durable storage, dispatch, cancellation, recovery, or conformance behavior;
  • existing CI workflow commands;
  • npm/Rust package behavior.

Tracking

Follow-on protocol artifacts remain in #11; the Psyche Build reference-client canary remains in #13.

Validation performed before push

  • Shell syntax: bash -n scripts/agent-bootstrap
  • Shell syntax: bash -n scripts/agent-check
  • YAML parse and required manifest keys
  • GitHub compare: one commit, ten expected added files, zero base divergence

Validation required on the exact PR head

  • Existing Rust matrix on Linux/macOS/Windows
  • Existing G2 conformance, migration, crash, and evidence checks
  • Existing dependency and full-history secret gates
  • Existing npm Node 20/22 checks
  • Clean-checkout ./scripts/agent-bootstrap
  • ./scripts/agent-check fast
  • ./scripts/agent-check full
  • Review of security-reporting route and canonical-ownership wording

Migration and rollback

No data or protocol migration. Rollback is removal/reversion of the new entrypoint and documentation files. The existing native commands and CI remain unchanged.

Evidence boundary

This PR establishes a plan and verification interface. It does not claim that psyche.protocol.v1 is released or that Psyche Build currently conforms. Those claims remain gated by #11 and #13.

Adds the public roadmap, canonical ownership proposal, repository entrypoints, machine-readable agent contract, and deterministic bootstrap/check commands without changing protocol behavior.

Refs #9
Refs #10
Refs #12
Refs #14
BunsDev added a commit that referenced this pull request Aug 26, 2026
Preserve the immutable historic G2 checker core while adding a separate, fail-closed retained-attestation scope for explicitly classified repository-readiness files. Unknown paths, protected sources, mode changes, deletions, renames, copies, submodules, and truncated trees remain rejected.

The scope starts as a candidate and requires an evidence-only follow-up after exact-head CI succeeds.

Refs #16
Blocks #15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant