Skip to content

Create the executable invariant ledger and generate the public proof matrix #79

Description

@clintecker

Problem

Press invariants are distributed across architecture prose, verifier implementations, issue acceptance criteria, fixtures, and scars. Nothing mechanically proves that every important claim has an owner, enforcer, positive witness, negative witness, CI layer, and documented limitation.

Scope

Create quality/invariants.yaml plus a validated schema and generated public reference.

Acceptance criteria

  • Define stable invariant IDs and fields for statement, risk, owner, producer, enforcer, required test layers, positive proofs, negative proofs, CI tier, and limitations.
  • Validate the ledger before test collection and produce locatable schema errors.
  • Fail when a critical invariant lacks an owner, enforcer, positive proof, or negative proof.
  • Fail when referenced tests, fixtures, functions, or artifacts no longer exist.
  • Generate docs/INVARIANTS.md from the ledger with invariant → boundary → proof → limitation traceability.
  • press selftest or the docs gate detects generated-reference drift.
  • Seed the ledger with all currently documented artifact, configuration, safety, design, release, and user-input-preservation invariants.

Dependencies

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docsPublic documentation and contract accuracyarea:dxContributor tooling, tests, maintainability, and development workflowarea:verificationExecutable contracts and artifact verificationenhancementNew feature or requestpriority:P1High: required for a trustworthy supported workflowtest-layer:L0Invariant inventory and collection-time contract gates

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions