Skip to content

Publish Psyche protocol v1 schemas, golden vectors, and conformance runner #11

Description

@BunsDev

Outcome

Publish the first consumer-ready Psyche protocol release surface: versioned machine-readable schemas, canonical golden vectors, a compatibility policy, and a standalone conformance runner that adapters can execute without copying internal Rust structures by hand.

Parent roadmap: #9
Priority: P0 after #10
Target phase: Phase 1 — Sep 9–Sep 29, 2026
Accountable owner: @BunsDev

Protocol publication contract

  • Inventory every public record kind, identifier prefix, enum, digest, transition, and structured denial currently covered by the G2 foundation.
  • Classify each as stable-v1, experimental, internal, or deprecated.
  • Publish versioned JSON Schemas or an explicitly justified equivalent for stable wire/storage records.
  • Publish byte-exact canonical JSON and SHA-256 golden vectors.
  • Publish positive, denial, stale-correlation, unknown-version, crash/restart, and downgrade fixtures.
  • Provide a standalone CLI or package command that validates an adapter against the supported conformance profile.
  • Make generated artifacts reproducible and fail CI on uncommitted drift.
  • Document semantic versioning, compatibility windows, unknown-field/enum behavior, migration, downgrade, deprecation, and rollback.
  • Produce a signed/checksummed immutable protocol artifact set for downstream pinning.

Required profiles

At minimum, the consumer profile must cover:

  • contract and capability negotiation;
  • stable session/execution correlation;
  • snapshot/attempt binding;
  • adoption and durable non-adoption proof;
  • ambiguity reconciliation and fencing;
  • ordered cursor/restart behavior;
  • terminal authority;
  • cancellation acknowledgement and unresolved outcomes;
  • result/artifact binding;
  • crash/restart persistence;
  • structured denial and quarantine.

The existing C-S1 through C-S12 suites are the evidence baseline, not automatically the public artifact format.

Acceptance criteria

  • A downstream repository can fetch one immutable release and run conformance without checking out Psyche source.
  • Schema, fixture, and generated-language drift are detected deterministically.
  • Every stable record has explicit canonical bytes and compatibility behavior.
  • Unknown major versions and authority-widening changes fail closed.
  • Minor-version evolution does not require expression-order or source-text coupling in consumers.
  • The conformance runner emits bounded machine-readable results and never requires production credentials.
  • Psyche Build can pin the artifact set in Prove Psyche Build as the first Psyche-conforming reference client #13.
  • Release evidence identifies source SHA, artifact digests, toolchain, command, and result.

Non-goals

  • Declaring every current internal Rust type stable.
  • Publishing to crates.io merely for visibility.
  • Requiring a networked daemon for ordinary conformance.
  • Treating successful decode as proof of authorized execution.
  • Skipping negative and recovery vectors.

Dependencies

Evidence

Link the schema inventory, generated artifacts, fixture digests, conformance-runner PRs, release/tag, downstream dry run, and CI evidence.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions