@research-engineering/agentic-proofkit 0.1.159 → 0.2.0

package/docs/specs/proofkit-spec-proof-core/requirements.v1.json

@@ -8,7 +8,7 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-001",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Requirement source admission validates structured REQ-* records and source-package shape without owning requirement meaning or scanning overview prose as authority.",
+      "invariant": "Requirement source admission validates structured REQ-* records and source-package shape without owning requirement meaning or scanning overview prose as authority; the shipped README routes one marker-bounded exact offline command and exactly one JSON example through the installed current product as a first valid input, using bounded expansion-free literal shell-word semantics so safe Bash quoting and directly executed argv remain equivalent.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": [
@@ -224,7 +224,7 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-009",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Requirement spec tree views render admitted caller-owned spec-tree hierarchy through shared safe browser document fragments, deterministic CLI JSON, Markdown, HTML, explicit output paths, and loopback browser serving without accepting caller-owned raw HTML or making rendered output authoritative.",
+      "invariant": "Requirement spec tree views render admitted caller-owned spec-tree hierarchy through shared safe browser document fragments, deterministic CLI JSON, Markdown, HTML, explicit output paths through repository-confined same-parent atomic replacement after final destination-parent plus temporary-object identity, mode, and content admission, and loopback browser serving without accepting caller-owned raw HTML or making rendered output authoritative; the browser command and runtime share one exact supported-view vocabulary, and invalid-view diagnostics list all and only those views.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": [
@@ -234,7 +234,7 @@
         "NC-PROOFKIT-SPEC-009"
       ],
       "nonClaims": [
-        "This requirement does not claim repository scanning, source freshness computation from files, requirement meaning, native witness execution, committed generated HTML, merge approval, release approval, rollout approval, or production readiness."
+        "This requirement does not claim repository scanning, source freshness computation from files, requirement meaning, native witness execution, protection from adversarial concurrent content or namespace mutation by the same operating-system user during the operation, filesystem crash or fsync durability, committed generated HTML, merge approval, release approval, rollout approval, or production readiness."
       ],
       "lifecycle": {
         "state": "active",
@@ -278,7 +278,7 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-011",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Adoption contract envelope admission validates a complete caller-owned aggregate adoption envelope, selects one child adoption, bootstrap, guidance, workflow, or pilot route through orthogonal CLI flags, and delegates to existing child command contracts without scanning repositories, writing files, executing witnesses, or creating a second adoption readiness policy.",
+      "invariant": "Adoption contract envelope admission validates a complete caller-owned aggregate adoption envelope, selects one child adoption, bootstrap, guidance, workflow, or pilot route through orthogonal CLI flags, rejects repeated single-value mode or pilot selectors and an explicitly empty pilot value rather than changing or misreporting the selected root variant, binds its union output contract to the exact successful public-CLI root-shape witness and native source owner, and delegates to existing child command contracts without scanning repositories, writing files, executing witnesses, or creating a second adoption readiness policy.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": [
@@ -467,7 +467,7 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-018",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Command family navigation projects the complete public CLI command inventory from one authored family catalog into a deterministic private runtime projection, preserves root and per-command help invocation forms, stdout and stderr channel discipline, no-input behavior, and leaf dispatch, admits only opt-in family help forms, rejects missing, duplicated, oversized, unsorted, or reserved-operand-colliding families, and does not infer command selection, execute commands through family membership, or create a second command inventory owner.",
+      "invariant": "Command family navigation projects the complete public CLI command inventory from one authored family catalog into a deterministic private runtime projection, preserves root and per-command help invocation forms, stdout and stderr channel discipline, no-input behavior, and leaf dispatch, exposes one token-bounded root discovery route, and projects the exact stack-preset vocabulary from the authored CLI contract into generated runtime IDs, direct help, and invalid-ID diagnostics; it admits only opt-in family help forms, rejects missing, duplicated, oversized, unsorted, or reserved-operand-colliding families, and does not infer command selection, execute commands through family membership, or create a second command inventory owner.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": [
@@ -494,12 +494,12 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-019",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Requirement context composition reads only caller-selected repository-relative catalog paths through a confined filesystem root, admits each source through its semantic owner, records current and optional expected digests, and emits one bounded content-bound derived snapshot without ambient scanning or new requirement, proof, coverage, freshness, or merge authority.",
+      "invariant": "Requirement context composition reads only caller-selected repository-relative catalog paths through a confined filesystem root, admits each source through its semantic owner, records current and optional expected digests, and emits one bounded content-bound schema-v2 derived snapshot whose expectedDigestCoverage is exactly none, partial, or all; the strict schema-v1 adapter fully admits the legacy record before mapping it to the same semantic snapshot, mixed v1/v2 vocabulary is rejected, and no producer emits v1.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-SPEC-019"],
-      "nonClaims": ["This requirement does not claim ambient repository discovery, later-checkout freshness, requirement meaning, proof adequacy, native witness execution, merge approval, release approval, rollout approval, or production readiness."],
+      "nonClaims": ["Expected-digest coverage records only equality between caller-supplied expected digests and admitted current bytes; it does not authenticate a producer, baseline, checkout, or freshness and does not claim ambient repository discovery, requirement meaning, proof adequacy, native witness execution, merge approval, release approval, rollout approval, or production readiness."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.spec-proof-core", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
@@ -520,12 +520,12 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-021",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "The loopback requirement workspace visibly preserves presentation-only authority boundaries, non-claims, snapshot and baseline identity, and trust-significant graph states while rendering immutable admitted context, optional semantic diff, and optional traceability graph through exact allowlisted routes, a per-process capability, same-origin handoff admission, source-digest and JSON-pointer anchors, Unicode code-point quote coordinates, bounded browser-session question packets after explicit UI submission across the admitted tree domain subject to explicit packet byte bounds, and terminal one-shot concurrent session semantics without persistence, command execution, provider access, or authority promotion.",
+      "invariant": "The loopback requirement workspace visibly preserves presentation-only authority boundaries, non-claims, snapshot identity, schema-v2 expected-digest coverage, and trust-significant graph states while rendering immutable admitted context, optional schema-v2 semantic diff, and optional traceability graph through exact allowlisted routes and schema-v2 manifest and affected API projections, a per-process capability removed from the document before API use, one exact loopback root URL passed to one fixed platform launcher argv, visible bootstrap loading and sanitized terminal failure states with stable identities, native list and article semantics, active-view aria-current, a visibly headed handoff region, same-origin handoff admission, source-digest and JSON-pointer anchors, Unicode code-point quote coordinates, bounded browser-session question packets after explicit UI submission across the admitted list domain subject to explicit packet byte bounds, and terminal one-shot concurrent session semantics without persistence, caller-supplied command execution, native-witness execution, provider access, or authority promotion; the only local-process side effect is the fixed launcher above.",
       "claimLevel": "blocking",
       "riskClass": "critical",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-SPEC-021"],
-      "nonClaims": ["This requirement does not authenticate the surrounding browser profile or operating-system user and does not claim remote access, annotation persistence, agent execution, provider delivery, proof freshness, merge approval, release approval, rollout approval, branded Safari behavior, or production readiness."],
+      "nonClaims": ["Expected-digest coverage does not authenticate a producer, baseline, checkout, or freshness; successful launcher invocation does not prove browser rendering; this requirement also does not authenticate the surrounding browser profile or operating-system user and does not claim remote access, annotation persistence, agent execution, provider delivery, complete screen-reader interoperability, full WCAG 2.2 conformance, every operating-system theme, 400-percent zoom behavior, merge approval, release approval, rollout approval, branded Safari behavior, or production readiness."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.spec-proof-core", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
@@ -533,12 +533,12 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-022",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Requirement semantic diff compares two admitted context snapshots by stable requirement identity and owner-declared scalar, set, and map field classes, producing deterministic added, removed, and modified facts without textual diff, inferred move semantics, or authority over requirement meaning.",
+      "invariant": "Requirement semantic diff schema-v2 input compares two fully admitted normalized context snapshots by stable requirement identity and owner-declared scalar, set, map, and lifecycle field classes, producing a schema-v2 canonically ordered output with base and current expected-digest coverage that remains closed under output re-admission; strict schema-v1 input and output adapters fully admit legacy records before normalization and reject mixed-version vocabulary.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-SPEC-022"],
-      "nonClaims": ["This requirement does not claim textual equivalence, inferred moves, product meaning, proof freshness, merge approval, release approval, rollout approval, or production readiness."],
+      "nonClaims": ["Expected-digest coverage does not authenticate a producer, baseline, checkout, or freshness; this requirement also does not claim textual equivalence, inferred moves, product meaning, merge approval, release approval, rollout approval, or production readiness."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.spec-proof-core", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
@@ -546,12 +546,12 @@
     {
       "requirementId": "REQ-PROOFKIT-SPEC-023",
       "ownerId": "proofkit.spec-proof-core",
-      "invariant": "Requirement traceability graph deterministically projects admitted specification and proof topology plus explicit caller-owned code topology while preserving specification, proof, code traceability, and native execution as distinct evidence planes and rejecting dangling topology references.",
+      "invariant": "Requirement traceability graph input schema v2 deterministically consumes a fully admitted normalized context snapshot, including strict schema-v1 adaptation or native schema-v2 expected-digest coverage, and projects admitted specification and proof topology plus explicit caller-owned code topology while preserving specification, proof, code traceability, and native execution as distinct evidence planes; one typed topology validator rejects dangling endpoints, enforces the bijection between non-root parentNodeId facts and contains edges with broader parent abstraction, verifies every supplied code-source digest, and applies node, edge, and source-byte budgets before per-item semantic materialization.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-SPEC-023"],
-      "nonClaims": ["This requirement does not infer code topology, line or branch coverage, native execution, proof freshness, merge approval, release approval, rollout approval, or production readiness."],
+      "nonClaims": ["Expected-digest coverage does not authenticate a producer, baseline, checkout, or freshness; this requirement also does not infer code topology, line or branch coverage, native execution, merge approval, release approval, rollout approval, or production readiness."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.spec-proof-core", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}

package/docs/specs/proofkit-supply-chain-quality/overview.md

@@ -15,25 +15,44 @@ vulnerability absence, or consumer rollout safety by itself.
   inventory and optional GitHub artifact attestations without claiming
   public-source provenance before a public-source tag release exists.
 - `REQ-PROOFKIT-QUALITY-002`: release evidence includes a deterministic SBOM
-  for package, wheel, binary, and Go module inventory without claiming
-  vulnerability absence or license approval.
+  whose runtime edges and digest come from one immutable byte snapshot of the
+  exact owning binary through an identity-checked pinned handle with a final
+  same-handle content check; source/tool module inventory is excluded and
+  package or wheel representations invent no runtime edges.
 - `REQ-PROOFKIT-QUALITY-003`: pure parser and canonicalization boundaries have
   fuzz/property tests that prove no-panic and round-trip stability without
   fuzzing side-effecting CLI or filesystem flows.
 - `REQ-PROOFKIT-QUALITY-004`: public CLI ABI has a small golden corpus and
   canonical ABI hash covering command topology, exit code, stdout/stderr
-  channel discipline, JSON parseability, stable public diagnostics, explicit
-  output schema evolution for breaking JSON field changes, and
-  descriptor/contract/help parity without making private descriptors public API.
+  channel discipline, JSON parseability, stable public diagnostics, complete
+  versioned root-shape input/output variants, exact source-checkout selectors,
+  exact native source sets and requirement scenarios for root-distinct output
+  witnesses, generated help and preset projections, explicit root schema
+  evolution, and descriptor/contract/help parity without making private
+  descriptors public API. The admitted adoption-envelope machine condition
+  model uses complete
+  canonical flag conjunctions, proves finite valid-option closure against
+  native admission, binds exercised argv to one exact condition and variant,
+  and rejects repeated mode or pilot selectors plus an empty pilot value that
+  would normalize to absence. Any later condition-model owner requires its own
+  admitted native-closure witness. The separate pilot-admission route declares
+  its contract-envelope stack-diverse alias and rejects repeated or mixed
+  `--pilot` and `--stack-diverse` selectors instead of applying last-write-wins
+  routing. Nested fields, leaf types, cardinality,
+  nullability, and cross-field semantics remain native-command concerns rather
+  than machine-contract claims.
 - `REQ-PROOFKIT-QUALITY-005`: CodeQL workflow source is admitted as an
-  independent semantic security analysis signal for Go source without replacing
-  native Go static gates.
+  independent semantic security analysis signal for Go source; advisory
+  analysis remains read-only, provider publication is isolated and disabled on
+  pull requests, and native Go static gates remain required.
 - `REQ-PROOFKIT-QUALITY-006`: OSV workflow source is admitted as an advisory
-  multi-ecosystem dependency signal without replacing `govulncheck`
-  reachable-code evidence.
+  multi-ecosystem dependency signal; advisory analysis remains read-only,
+  provider publication is isolated and disabled on pull requests, and
+  `govulncheck` reachable-code evidence remains required.
 - `REQ-PROOFKIT-QUALITY-007`: Scorecard workflow source is admitted as an
-  advisory repository hygiene signal without claiming branch protection or
-  provider settings that the repository cannot prove from source.
+  advisory repository hygiene signal; advisory analysis remains read-only,
+  public publication authority is isolated with exact output inputs, and
+  source does not claim branch protection or unobserved provider settings.
 - `REQ-PROOFKIT-QUALITY-008`: GitHub Actions workflow syntax and expression
   semantics are checked by actionlint in the local package gate.
 - `REQ-PROOFKIT-QUALITY-009`: performance-sensitive parser and serializer
@@ -41,23 +60,42 @@ vulnerability absence, or consumer rollout safety by itself.
   required PR gate before stable baselines exist.
 - `REQ-PROOFKIT-QUALITY-010`: coverage metrics report requirement, binding,
   witness, CLI inventory linkage, and descriptor-owned command proof-route
-  candidates from admitted test-evidence-inventory rows. The gate fails closed
-  on linkage dead zones, failed inventory admission, missing candidates,
-  unknown command refs, contract-only commands, or route-only commands. Static
-  route metadata and source syntax never become semantic falsifier evidence.
+  candidates from admitted test-evidence-inventory rows, while critical
+  anti-vacuity scenarios retain exact closed selector inventories. Each linkage and route
+  conjunct has an independent fail-closed falsifier, and each source-checkout
+  selector resolves to a valid function in an active Go test file with its
+  exact executable command; static route metadata, prose, source markers, test
+  existence, and failure-capable syntax never become semantic falsifier
+  evidence.
 - `REQ-PROOFKIT-QUALITY-011`: CI separates the OS-independent full
   source/package gate from macOS platform smoke, executes the complete Go
   package set through its owner command, uses explicit hosted runner labels
   instead of floating latest labels, and exposes one fail-closed aggregate gate
-  that requires every required leaf check to finish with success.
+  whose exact expression and script reject neutralization and require every
+  required leaf check to finish with success, while the aggregate job omits
+  job defaults and `continue-on-error` entirely. Exact workflow-level bash
+  defaults plus a closed inventory require exact provider-check names and
+  scalar runners, bind the macOS job's presence-aware exact ordered step
+  inventory and exact local setup-action bytes to the fail-closed
+  package-script owner command, require every required leaf job and step to
+  omit conditions except for exact named owner conditions, and reject
+  dynamically false or explicit-null conditions, dual `run`/`uses` keys,
+  non-string runner labels, nested or top-level semantic shadow steps,
+  reusable-job substitution, inherited or local environment entries, shell,
+  working-directory, and `continue-on-error` overrides.
 - `REQ-PROOFKIT-QUALITY-012`: release and adoption channel identifiers use one
   canonical authority vocabulary that separates durable authority channels from
   display labels, publisher environments, statuses, and candidate evidence.
 - `REQ-PROOFKIT-QUALITY-013`: self-hosting workflow package-gate evidence is
   checked by a typed workflow oracle instead of text search, proving the
-  package gate is reachable, exact, advisory, success-gated for always-running
-  downstream jobs and required evidence-publication steps, and ordered before
-  evidence publication.
+  package gate is reachable, exact, advisory, and guarded only by absent or
+  exact owner-reviewed conditions for every trust-significant job and step
+  across the closed required CI and release inventories; dynamically false and
+  neutralized expressions are rejected alongside unsafe workflow run defaults,
+  unexpected workflow or step environment entries, gate-job defaults or
+  environment entries, and shell, working-directory, or
+  `continue-on-error` override on any step in the gate job; the gate remains
+  ordered before evidence publication.
 - `REQ-PROOFKIT-QUALITY-014`: release authority consumers compare downstream
   policy against the admitted typed release-authority projection and admitted
   report digest instead of rereading caller-owned raw `releaseAuthorityInput`
@@ -68,8 +106,8 @@ vulnerability absence, or consumer rollout safety by itself.
 - `REQ-PROOFKIT-QUALITY-016`: release platform targets use one private owner
   that projects platform suffixes, Go build targets, npm OS/CPU metadata,
   package tar entries, Python wheel tags, PyPI candidate completeness,
-  self-hosting native binary selection, and SBOM binary subjects without
-  becoming public API.
+  self-hosting native binary selection, SBOM binary subjects, and the exact
+  marker-bounded README platform matrix without becoming public API.
 - `REQ-PROOFKIT-QUALITY-017`: report-visible secret-shaped JSON traversal
   uses one private kernel owner for deterministic paths and finding kinds while
   command packages only map findings to their local report policy.
@@ -78,7 +116,13 @@ vulnerability absence, or consumer rollout safety by itself.
   npm and PyPI channels and release closeout rejects publication claims without
   that tuple.
 - `REQ-PROOFKIT-QUALITY-019`: installed package smoke proof verifies one
-  successful JSON report command, one failed-report command, and the current
+  continuous offline route through every displayed family and leaf-help
+  transition, binds each installed invocation to its ordered exact bare Usage
+  command token, requires every exact generated preset command to retain the
+  offline npm prefix, re-executes one emitted continuation, reaches the first
+  valid README input, executes one successful JSON report command and one
+  failed-report command, applies bounded expansion-free literal parsing to
+  emitted and README argv, and verifies the current
   `json-report-cli-adapter-source` generated source artifact from the
   package-managed binary, including report identity, state, exit code, stdout,
   stderr discipline, generated-source hash, owner-source parity, and exact
@@ -96,8 +140,36 @@ vulnerability absence, or consumer rollout safety by itself.
 - `REQ-PROOFKIT-QUALITY-022`: the requirement workspace uses an explicit
   embedded asset set, strict authored-JavaScript type checking, exact secured
   routes, bounded server cleanup, repository-confined non-symlink proof
-  artifacts, and machine-admitted per-project rendered engine evidence without
-  runtime dependencies or a production bundler.
+  artifacts, and machine-admitted per-project rendered engine evidence for its
+  stable-state accessibility matrix, including independently held bootstrap,
+  specifications, diff, and graph loading states, target size, 320-pixel
+  reflow, labelled internal overflow, and light/dark rendered contrast without
+  runtime dependencies or a production bundler; one direct audit initializes
+  pinned axe code through the browser-context script channel, admits only the
+  main frame and exact engine identity, preserves same-origin and Playwright
+  branding, and runs default rules plus explicitly enabled target size, while
+  failed attempts retain attempt-scoped action, DOM, network, and source traces
+  without continuous screenshot capture plus a bounded best-effort failure
+  screenshot, without creating passed proof.
+- `REQ-PROOFKIT-QUALITY-023`: Python wheels independently bind advertised
+  platform compatibility to decoded executable bytes, and the wheel set rejects
+  version, identity, presence, and digest drift; wheels carry Core Metadata 2.4
+  plus an exact, RECORD-closed repository license payload.
+- `REQ-PROOFKIT-QUALITY-024`: a closed version-bound machine record binds the
+  exact previous/current SemVer pair and compatible/breaking class, declares the
+  exact complete current breaking, addition, and migration inventories
+  including channel-specific generated continuation bytes, rejects missing,
+  substituted, reordered, or surplus entries, and owns one independently
+  authored byte-exact complete current release-note projection, while one
+  retained-
+  evidence owner builds and verifies checksums against exact
+  downloadable artifact-relative paths without inferring change completeness
+  from the source diff.
+- `REQ-PROOFKIT-QUALITY-025`: exact workflow inventory, closed raw-YAML keys
+  before typed decoding, exact release deployment environments, pinned action
+  commit identities, admitted status expressions, the required aggregate shell
+  program, and read-only treatment of an existing release are source-oracle
+  invariants.
 
 ## Non-Claims
 

package/docs/specs/proofkit-supply-chain-quality/requirements.v1.json

@@ -25,7 +25,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-002",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Release evidence includes a deterministic SBOM for package, wheel, binary, and Go module inventory without claiming vulnerability absence or license approval.",
+      "invariant": "Release evidence includes a deterministic SBOM in which source and tool Go module inventory is explicitly excluded, package and wheel representations invent no runtime edges, and each required runtime dependency edge and subject digest are derived from one immutable byte snapshot read through an identity-checked pinned handle to the exact release binary that owns the edge, with a final same-handle content check, without claiming reachability, vulnerability absence, or license approval.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -51,12 +51,12 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-004",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Public CLI ABI has a small golden corpus and canonical ABI hash covering command topology, exit code, stdout and stderr channel discipline, JSON parseability, stable public diagnostics, explicit output schema evolution for breaking JSON field changes, and descriptor/contract/help parity without making private descriptors a public API.",
+      "invariant": "Public CLI ABI has a small golden corpus and canonical ABI hash covering command topology, exit code, stdout and stderr channel discipline, JSON parseability, stable public diagnostics, complete versioned root-shape input and JSON-output variant declarations, exact source-checkout witness selectors, exact native source-path sets and requirement scenarios for every root-distinct output witness, deterministic generated help and stack-preset projections, explicit output schema evolution for breaking JSON root changes, and descriptor/contract/help parity without making private descriptors a public API; the admitted adoption-contract-envelope machine condition model uses canonical complete flag conjunctions, rejects ambiguous or incomplete assignments, closes the finite valid option space against native option admission, binds each exercised argv to its exact condition and variant, and rejects repeated mode or pilot flags or an empty pilot value rather than silently changing or misreporting the selected variant, while any later condition-model owner requires its own admitted native-closure witness; the separate pilot-admission route declares its contract-envelope stack-diverse alias and rejects repeated or mixed --pilot and --stack-diverse selectors instead of applying last-write-wins routing.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-QUALITY-004"],
-      "nonClaims": ["This requirement does not claim exhaustive command semantic completeness beyond the declared route inventory or byte-for-byte stability for diagnostics outside the public CLI ABI."],
+      "nonClaims": ["This requirement does not claim nested field shape, scalar type, collection cardinality, nullability, exhaustive command semantic completeness beyond the declared route inventory, installation of source-checkout witness files, runtime JSON Schema validation, or byte-for-byte stability for diagnostics outside the public CLI ABI."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.supply-chain-quality", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
@@ -64,7 +64,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-005",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "CodeQL workflow source is admitted as an independent semantic security analysis signal for Go source without replacing native Go static gates.",
+      "invariant": "CodeQL workflow source is admitted as an independent semantic security analysis signal for Go source; advisory analysis remains read-only, provider publication authority is isolated and disabled on pull requests, and native Go static gates remain required.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -77,7 +77,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-006",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "OSV workflow source is admitted as an advisory multi-ecosystem dependency signal without replacing govulncheck reachable-code evidence.",
+      "invariant": "OSV workflow source is admitted as an advisory multi-ecosystem dependency signal; advisory analysis remains read-only, provider publication authority is isolated and disabled on pull requests, and govulncheck reachable-code evidence remains required.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -90,7 +90,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-007",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Scorecard workflow source is admitted as an advisory repository hygiene signal without claiming branch protection or provider settings that the repository cannot prove from source.",
+      "invariant": "Scorecard workflow source is admitted as an advisory repository hygiene signal; advisory analysis remains read-only, public publication authority is isolated with exact output inputs, and source does not claim branch protection or unobserved provider settings.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -129,7 +129,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-010",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Coverage metrics report requirement, binding, witness, CLI inventory linkage, and descriptor-owned command proof-route candidates from admitted test-evidence-inventory rows, failing closed on explicit requirement/proof linkage dead zones, failed command-route inventory admission, missing candidate routes, unknown command refs, contract-only commands, or route-only commands; static route metadata, prose, source markers, test existence, and failure-capable syntax remain candidate evidence and cannot satisfy semantic_falsifier coverage.",
+      "invariant": "Coverage metrics report requirement, binding, witness, CLI inventory linkage, and descriptor-owned command proof-route candidates from admitted test-evidence-inventory rows, failing closed independently for each requirement/proof linkage dead-zone class and each missing-candidate, unknown-candidate-ref, unknown-semantic-ref, contract-only, or route-only command-route class; source-checkout witness selectors must resolve to valid functions in active Go test files with exact executable commands, critical anti-vacuity scenarios must retain their exact closed selector inventories, and failed command-route inventory admission also fails closed, while static route metadata, prose, source markers, test existence, and failure-capable syntax remain candidate evidence and cannot satisfy semantic_falsifier coverage.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -142,7 +142,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-011",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "CI separates the OS-independent full source/package gate from the platform-specific macOS execution smoke, executes the complete Go package set through the owner command rather than a partial package list, uses explicit hosted runner labels instead of floating latest labels, and exposes one fail-closed aggregate quality gate that requires every required leaf check to finish with success so skipped, failed, or cancelled leaf jobs cannot satisfy branch-protection evidence.",
+      "invariant": "CI separates the OS-independent full source/package gate from the platform-specific macOS execution smoke, executes the complete Go package set through the owner command rather than a partial package list, uses exact scalar hosted runners and provider-check names, requires the macOS job's presence-aware exact ordered step inventory and exact repository-local setup-action bytes to execute the exact fail-closed platform-smoke package-script owner command, and exposes one exact fail-closed aggregate quality gate under exact bash workflow run defaults with no inherited working-directory or environment entries; a closed inventory requires every required leaf job and step to omit conditions except for exact owner-reviewed named conditions, every required leaf job and the aggregate job omit job defaults, reusable-workflow substitution, and continue-on-error and have no job environment entries, all of their steps omit shell, working-directory, and continue-on-error and have no step environment entries, and the aggregate's reviewed expression and script require every exact required leaf check to finish with success; neutralizing wrappers, dynamically false or explicit-null conditions, execution overrides, dual run/uses keys, extra disjunctions, non-string runner labels, nested or top-level semantic shadow steps, no-op or reusable-job substitution, skipped, failed, or cancelled leaf jobs cannot satisfy branch-protection evidence.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -168,7 +168,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-013",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Self-hosting workflow package-gate evidence is checked by a typed workflow oracle that proves the package gate is reachable, exact, advisory, success-gated for always-running downstream jobs and required evidence-publication steps, and ordered before evidence publication instead of relying on workflow text search.",
+      "invariant": "Self-hosting workflow package-gate evidence is checked by a typed workflow oracle that proves the package gate is reachable, exact, advisory, and guarded only by an absent condition or the exact owner-reviewed condition for every trust-significant job and step; the oracle checks the complete required CI and release job inventories, rejects neutralizing or dynamically false expression variants, requires any workflow run defaults to retain exact bash without a working-directory override, admits only the exact owner-reviewed workflow and step environment entries, requires the gate job to omit job defaults and continue-on-error and have no job environment entries, requires every step in that job to omit shell, working-directory, and continue-on-error, and orders the gate before evidence publication instead of relying on workflow text search.",
       "claimLevel": "blocking",
       "riskClass": "medium",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -207,7 +207,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-016",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Release platform targets have one private owner that projects exact platform suffixes, Go build targets, npm OS/CPU metadata, package tar binary entries, Python wheel tags, PyPI candidate completeness, self-hosting native binary selection, and SBOM binary subjects without turning the platform matrix into public API.",
+      "invariant": "Release platform targets have one private owner that projects exact platform suffixes, Go build targets, npm OS/CPU metadata, package tar binary entries, Python wheel tags, PyPI candidate completeness, self-hosting native binary selection, SBOM binary subjects, and the marker-bounded README platform and architecture matrix in both directions without turning the platform matrix into public API.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -246,7 +246,7 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-019",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Installed package smoke proof verifies the package-managed binary can process explicit JSON input for one successful report command and one failed-report command, and can emit the current json-report-cli-adapter-source artifact from the installed package binary with source bytes equal to the generator owner source, preserving report kind, report id, state, explicit input counts, exit code, stdout JSON, generated-source hash, and stderr channel discipline without admitting unlisted consumer working-directory files in addition to help discoverability.",
+      "invariant": "Installed package smoke proof builds the current product, installs the exact local tarball, and verifies a continuous npm exec --offline route from root help through every displayed family and leaf-help transition, with each installed invocation exactly bound to its ordered bare Usage command token; it then verifies exact stack-preset vocabulary, requires every exact generated preset command string to retain the offline npm prefix, re-executes one emitted self-continuation, and continues to exactly one marker-bounded README command and JSON first input, with every emitted or README argv admitted through bounded expansion-free literal shell-word semantics before direct execution. It also verifies that the package-managed binary can process explicit JSON input for one successful report command and one failed-report command and emit the current json-report-cli-adapter-source artifact with source bytes equal to the generator owner source, preserving report kind, report id, state, explicit input counts, exit code, stdout JSON, generated-source hash, and stderr channel discipline without admitting unlisted consumer working-directory files.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
@@ -285,12 +285,51 @@
     {
       "requirementId": "REQ-PROOFKIT-QUALITY-022",
       "ownerId": "proofkit.supply-chain-quality",
-      "invariant": "Authored requirement workspace JavaScript and CSS are embedded through an explicit compile-time asset set, served only by exact routes with restrictive response headers, strictly type-checked without a production bundler, and covered by Go lifecycle, concurrent terminal-state, HTTP security, and repository-confined non-symlink artifact falsifiers plus a machine-admitted per-project execution report proving the same non-empty passed test identities in pinned Chromium, Firefox, and Playwright WebKit, with bounded browser-server cleanup and no added runtime package dependencies.",
+      "invariant": "Authored requirement workspace JavaScript and CSS are embedded through an explicit compile-time asset set, served only by exact routes with restrictive response headers, and strictly type-checked without a production bundler; Go lifecycle, concurrent terminal-state, HTTP security, and repository-confined non-symlink artifact falsifiers plus one machine-admitted state-matrix execution report prove the same non-empty passed test identities in pinned Chromium, Firefox, and Playwright WebKit across independently held bootstrap, specifications, diff, and graph loading states, bootstrap failure, terminal specifications, diff, graph, unavailable views, view failure, handoff result, and handoff failure, with one direct audit initializing the pinned axe distribution through the browser-context script channel, admitting only the main frame and exact engine identity, preserving same-origin and Playwright branding, and running default rules plus explicitly enabled target-size after state identity, followed by 320 CSS-pixel document reflow, labelled internal graph and table overflow, and rendered light/dark text, boundary, and focus contrast oracles, a combined negative fixture for undersized named and normal-sized unnamed controls, bounded browser-server cleanup, attempt-scoped failed-run action, DOM, network, and source traces without continuous screenshot capture plus one bounded best-effort failure screenshot retained separately from authoritative passed proof, and no added runtime package dependencies.",
       "claimLevel": "blocking",
       "riskClass": "high",
       "proofBindingRefs": ["proofkit/requirement-bindings.json"],
       "nonClaimRefs": ["NC-PROOFKIT-QUALITY-022"],
-      "nonClaims": ["This requirement does not claim full WCAG conformance, every branded browser, provider CI ingestion, registry publication, release approval, rollout approval, or production readiness."],
+      "nonClaims": ["This requirement does not claim full WCAG 2.2 conformance, branded Safari behavior, complete screen-reader interoperability, every operating-system theme, 400-percent zoom behavior, continuous screenshot evidence, guaranteed capture of the best-effort failure screenshot, provider CI ingestion, registry publication, release approval, rollout approval, or production readiness."],
+      "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
+      "deferral": null,
+      "updatePolicy": {"reviewOwnerId": "proofkit.supply-chain-quality", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
+    },
+    {
+      "requirementId": "REQ-PROOFKIT-QUALITY-023",
+      "ownerId": "proofkit.supply-chain-quality",
+      "invariant": "Each Python wheel binds its embedded executable to the release binary digest, and the wheel-set verifier independently rejects version drift, duplicate identities, missing files, and SHA drift; each wheel independently decodes Darwin Mach-O bytes so an advertised macOS platform minimum is never lower than the executable minimum, uses Core Metadata 2.4 License-Expression and License-File fields, carries an exact repository LICENSE copy under the wheel licenses directory, and closes every payload entry through RECORD.",
+      "claimLevel": "blocking",
+      "riskClass": "critical",
+      "proofBindingRefs": ["proofkit/requirement-bindings.json"],
+      "nonClaimRefs": ["NC-PROOFKIT-QUALITY-023"],
+      "nonClaims": ["This requirement does not claim execution on every accepted operating-system version, legal approval, registry publication, release approval, rollout approval, or production readiness."],
+      "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
+      "deferral": null,
+      "updatePolicy": {"reviewOwnerId": "proofkit.supply-chain-quality", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
+    },
+    {
+      "requirementId": "REQ-PROOFKIT-QUALITY-024",
+      "ownerId": "proofkit.supply-chain-quality",
+      "invariant": "Release metadata generation admits one closed schema-versioned machine-readable declaration of the reviewed public-contract change set, requires exact ordered equality for the complete current breaking-change, addition, and migration inventories, including channel-specific changes to public generated continuation bytes, binds its exact previous and current canonical SemVer values to a compatible or breaking change class, rejects missing, substituted, reordered, or surplus current entries plus non-monotonic or patch-range breaking releases, and renders one byte-exact independently authored complete current release-note projection with no relocated, duplicate, appended, surplus, or second owned section, while one repository-owned retained-evidence builder and verifier checksum the exact final downloadable artifact topology with artifact-relative paths, reject unbound evidence files and symlink substitution, and fail release closeout on record, note, path, or digest drift.",
+      "claimLevel": "blocking",
+      "riskClass": "high",
+      "proofBindingRefs": ["proofkit/requirement-bindings.json"],
+      "nonClaimRefs": ["NC-PROOFKIT-QUALITY-024"],
+      "nonClaims": ["This requirement does not infer change-record completeness from source changes, make release notes approval authority, or prove provider publication, attestation authenticity, consumer adoption, rollout approval, or production readiness."],
+      "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
+      "deferral": null,
+      "updatePolicy": {"reviewOwnerId": "proofkit.supply-chain-quality", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}
+    },
+    {
+      "requirementId": "REQ-PROOFKIT-QUALITY-025",
+      "ownerId": "proofkit.supply-chain-quality",
+      "invariant": "Every tracked GitHub Actions workflow is admitted by one exact sorted inventory and a closed raw-YAML key grammar at workflow, job, and step boundaries before typed decoding, with only exact owner-reviewed release deployment environments; every external action reference is pinned to a full lowercase 40-hex commit identity; local action references remain repository-confined; status expressions and the required CI aggregate match exact owner-reviewed forms; and an already-existing GitHub Release is a read-only object whose metadata, exact asset set, and asset bytes must match the candidate before the workflow exits successfully.",
+      "claimLevel": "blocking",
+      "riskClass": "critical",
+      "proofBindingRefs": ["proofkit/requirement-bindings.json"],
+      "nonClaimRefs": ["NC-PROOFKIT-QUALITY-025"],
+      "nonClaims": ["This requirement does not claim external action safety, tag equivalence, provider execution, branch-protection configuration, release publication, or provider-side asset immutability."],
       "lifecycle": {"state": "active", "replacementRequirementIds": [], "evidenceRefs": []},
       "deferral": null,
       "updatePolicy": {"reviewOwnerId": "proofkit.supply-chain-quality", "requiresImpactDeclaration": true, "requiresProofBindingReview": true}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@research-engineering/agentic-proofkit",
   "description": "Reusable proof profile, report, graph, and witness-planning primitives.",
-  "version": "0.1.159",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
@@ -22,8 +22,6 @@
   },
   "files": [
     "ADOPTION.md",
-    "AGENTS.md",
-    "CONTRIBUTING.md",
     "LICENSE",
     "NON_CLAIMS.md",
     "README.md",
@@ -36,9 +34,9 @@
   ],
   "scripts": {
     "build": "go run ./internal/tools/packagebuild",
-    "check": "npm run npm:version && npm run source-hygiene && npm run command-family:check && npm run text-policy && npm run mermaid:check && npm run browser:check && npm run go:check && npm run package:artifact && npm run self:receipt && npm run self:coverage && npm run release:closeout",
+    "check": "npm run npm:version && npm run source-hygiene && npm run command-contract:check && npm run command-family:check && npm run text-policy && npm run mermaid:check && npm run go:check && npm run browser:check && npm run package:artifact && npm run self:receipt && npm run self:coverage && npm run release:closeout",
     "browser:check": "npm run browser:static-check && npm run browser:test",
-    "browser:static-check": "tsc -p tsconfig.browser.json && node --test scripts/browser-proof-execution.test.mjs scripts/browser-proof-inputs.test.mjs scripts/browser-selection-authority.test.mjs",
+    "browser:static-check": "tsc -p tsconfig.browser.json && node --test scripts/browser-proof-execution.test.mjs scripts/browser-proof-inputs.test.mjs scripts/browser-selection-authority.test.mjs scripts/stable-json.test.mjs",
     "browser:test": "go run ./internal/tools/browserproofverify --run",
     "command-family:check": "go run ./internal/tools/commandfamilygen --check",
     "go:actionlint": "go tool actionlint",
@@ -63,7 +61,8 @@
     "text-policy": "go run ./internal/tools/textpolicyinput | go run ./cmd/agentic-proofkit text-policy --input -",
     "mermaid:check": "go run ./internal/tools/mermaidcheck",
     "go:staticcheck": "go tool staticcheck ./...",
-    "go:vulncheck": "go tool govulncheck ./..."
+    "go:vulncheck": "go tool govulncheck ./...",
+    "command-contract:check": "go run ./internal/tools/commandcontractgen --check"
   },
   "os": [
     "darwin",
@@ -74,8 +73,8 @@
     "x64"
   ],
   "devDependencies": {
-    "@axe-core/playwright": "4.12.1",
-    "@playwright/test": "1.61.1",
+    "@playwright/test": "1.62.0",
+    "axe-core": "4.12.1",
     "typescript": "7.0.2"
   }
 }