PUBLIC_TRACEABILITY_MATRIX.json

{
  "version": "0.2.0",
  "reviewed_at": "2026-03-29",
  "traces": [
    {
      "id": "law-and-schema-contract",
      "claim": "Capsule law is published as both human-readable doctrine and curated raw machine-readable artifacts, including confidence-vector, subtype, and version-lineage law-adjacent capsules.",
      "audiences": [
        "integrators",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/5-element-law.md",
        "docs/16-gates.md",
        "docs/relation-types.md",
        "schemas/capsule-schema.json",
        "capsules/capsule.foundation.capsuleos-schema.v1.json",
        "capsules/capsule.foundation.capsuleos.confidence-vector.v1.json",
        "capsules/capsule.foundation.capsuleos.versioning-protocol.v1.json",
        "capsules/capsule.foundation.capsuleos.subtype-atomic.v1.json",
        "capsules/capsule.foundation.capsuleos.subtype-hub.v1.json"
      ],
      "supporting_surfaces": [
        "docs/schema-reference.md",
        "docs/overview.md",
        "docs/examples.md",
        "capsules/README.md",
        "PUBLIC_CONTRACT_CATALOG.json",
        "docs/schema-family-reference.md",
        "schemas/README.md"
      ],
      "verify_commands": [
        "npm run check:raw-capsules",
        "npm run check:catalog",
        "npm run check:traceability"
      ]
    },
    {
      "id": "validator-api-and-client-contract",
      "claim": "The public validator HTTP surface is backed by OpenAPI, direct repo/package/Python OpenAPI readers, repo-local plus CommonJS/ESM/TypeScript installed-package OpenAPI code-generation recipes, envelope schemas, examples, compact machine-readable route-reference JSON, a reusable Python live-client bridge, shared TypeScript route constants plus route-behavior metadata, full-route client recipes, repo-relative TypeScript request builders plus typed request readers, repo-relative TypeScript live-client bridges plus installed-package CommonJS, ESM, and TypeScript live-client bridges, repo-relative Zod request parsers, repo-relative TypeScript typed response readers, repo-relative Zod response parsers, bounded shared error-envelope consumers, and installed-package request plus validate/support/error-response readers that cover single, batch, fix, gates, stats, plus shared generic rejection paths and a bounded support-route failure path without depending on private runtime code.",
      "audiences": [
        "integrators",
        "tool-builders"
      ],
      "strongest_surfaces": [
        "docs/api-envelopes.md",
        "docs/openapi.md",
        "docs/python-consumption.md",
        "docs/route-reference.md",
        "docs/validator.md",
        "examples/api/stats-error-response.sample.json",
        "examples/client/node-get-gates.mjs",
        "examples/client/node-validate-single.mjs",
        "examples/client/python-get-gates.py",
        "examples/client/python-live-validator-client.py",
        "examples/client/python-openapi-reference.py",
        "examples/client/python-parse-error-responses.py",
        "examples/client/python-parse-validate-responses.py",
        "examples/client/python-validate-single.py",
        "examples/client/ts-openapi-route-summary.ts",
        "openapi/validate.openapi.json",
        "references/validator-routes.json",
        "references/validator-envelope-families.json",
        "schemas/validator-api-envelopes.schema.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_EXAMPLE_COVERAGE.json",
        "docs/integration-guide.md",
        "docs/npm-consumption.md",
        "docs/route-reference.md",
        "docs/schema-family-reference.md",
        "examples/api/forbidden-response.sample.json",
        "examples/api/gates-response.sample.json",
        "examples/api/stats-error-response.sample.json",
        "examples/api/stats-response.sample.json",
        "examples/api/validate-request.batch.json",
        "examples/api/validate-request.fix.json",
        "examples/api/validate-request.single.json",
        "examples/api/validate-response.batch.json",
        "examples/api/validate-response.fail.json",
        "examples/api/validate-response.fix.sample.json",
        "examples/api/validate-response.pass.json",
        "examples/client/cjs-package-capsule-summary.cjs",
        "examples/client/cjs-package-error-responses.cjs",
        "examples/client/cjs-package-live-validator-client.cjs",
        "examples/client/cjs-package-openapi-reference.cjs",
        "examples/client/cjs-package-support-responses.cjs",
        "examples/client/cjs-package-validate-request.cjs",
        "examples/client/cjs-package-validate-response.cjs",
        "examples/client/curl-get-gates.sh",
        "examples/client/curl-get-stats.sh",
        "examples/client/esm-package-capsule-summary.mjs",
        "examples/client/esm-package-error-responses.mjs",
        "examples/client/esm-package-live-validator-client.mjs",
        "examples/client/esm-package-openapi-reference.mjs",
        "examples/client/esm-package-support-responses.mjs",
        "examples/client/esm-package-validate-request.mjs",
        "examples/client/esm-package-validate-response.mjs",
        "examples/client/node-get-stats.mjs",
        "examples/client/node-validate-fix.mjs",
        "examples/client/python-get-stats.py",
        "examples/client/python-live-validator-client.py",
        "examples/client/python-parse-support-responses.py",
        "examples/client/python-validate-batch.py",
        "examples/client/python-validate-fix.py",
        "examples/client/ts-build-validate-batch-request.ts",
        "examples/client/ts-build-validate-fix-request.ts",
        "examples/client/ts-live-validator-client.ts",
        "examples/client/ts-package-error-responses.ts",
        "examples/client/ts-package-live-validator-client.ts",
        "examples/client/ts-package-openapi-reference.ts",
        "examples/client/ts-package-support-responses.ts",
        "examples/client/ts-package-validate-batch-request.ts",
        "examples/client/ts-package-validate-fix-request.ts",
        "examples/client/ts-package-validate-request.ts",
        "examples/client/ts-package-validate-responses.ts",
        "examples/client/ts-parse-error-responses.ts",
        "examples/client/ts-parse-support-responses.ts",
        "examples/client/ts-parse-validate-responses.ts",
        "examples/client/ts-route-behavior-reference.ts",
        "examples/client/zod-parse-error-responses.ts",
        "examples/client/zod-parse-support-responses.ts",
        "examples/client/zod-parse-validate-batch-request.ts",
        "examples/client/zod-parse-validate-batch-response.ts",
        "examples/client/zod-parse-validate-fail-response.ts",
        "examples/client/zod-parse-validate-fix-request.ts",
        "examples/client/zod-parse-validate-fix-response.ts",
        "examples/client/zod-parse-validate-request.ts",
        "examples/client/zod-parse-validate-response.ts",
        "projections/index.ts",
        "projections/typescript/validator-routes.ts",
        "scripts/check-package-install.js",
        "scripts/check-python-recipes.js",
        "docs/openapi-codegen-recipes.md",
        "examples/client/openapi-generate-validator-types.mjs",
        "examples/client/cjs-package-openapi-codegen.cjs",
        "examples/client/ts-package-openapi-codegen.ts",
        "examples/client/esm-package-openapi-codegen.mjs",
        "scripts/check-openapi-codegen.js",
        "scripts/check-openapi-coherence.js"
      ],
      "verify_commands": [
        "npm run check:api-examples",
        "npm run check:api-schemas",
        "npm run check:client-recipes",
        "npm run check:python-recipes",
        "npm run check:traceability",
        "npm run check:package-surface",
        "npm run check:package-install",
        "npm run check:openapi-codegen",
        "npm run check:openapi-coherence"
      ]
    },
    {
      "id": "compact-contract-reference-pack",
      "claim": "Tool-builders can consume canonical enums, validation-gate families, validator option flags, and published validator route behavior summaries from a compact package-consumable reference layer without treating that layer as stronger than the schemas, gate docs, OpenAPI, or raw capsules it summarizes.",
      "audiences": [
        "integrators",
        "tool-builders"
      ],
      "strongest_surfaces": [
        "docs/reference-pack.md",
        "docs/python-consumption.md",
        "references/contract-constants.json",
        "references/validation-gates.json",
        "references/validator-routes.json",
        "references/validator-envelope-families.json",
        "scripts/check-reference-pack.js",
        "examples/client/python-contract-reference.py",
        "scripts/check-python-recipes.js"
      ],
      "supporting_surfaces": [
        "docs/integration-guide.md",
        "docs/npm-consumption.md",
        "docs/route-reference.md",
        "docs/16-gates.md",
        "schemas/capsule-schema.json",
        "schemas/neuro-concentrate.schema.json",
        "schemas/validator-api-envelopes.schema.json",
        "examples/client/cjs-package-contract-reference.cjs",
        "examples/client/ts-package-contract-reference.ts",
        "capsules/capsule.foundation.capsuleos.confidence-vector.v1.json",
        "scripts/check-package-install.js",
        "examples/client/ts-route-behavior-reference.ts",
        "examples/client/esm-package-contract-reference.mjs",
        "scripts/check-openapi-coherence.js"
      ],
      "verify_commands": [
        "npm run check:reference-pack",
        "npm run check:openapi-coherence",
        "npm run check:python-recipes",
        "npm run check:client-recipes",
        "npm run check:package-surface",
        "npm run check:package-install",
        "npm run check:traceability"
      ]
    },
    {
      "id": "raw-json-schema-consumer-path",
      "claim": "The public surface supports direct raw-schema and single-file bundled-schema validation of capsules, the client-recipe navigator, validator-envelope payloads, and archive-bundle payloads through Ajv-based recipes from both a repo checkout and an installed package, including explicit schema-invalid archive, client-recipe navigator, capsule, and validator-envelope fixtures, without forcing consumers onto the projection layer.",
      "audiences": [
        "integrators",
        "tool-builders",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/schema-validation-recipes.md",
        "docs/schema-bundles.md",
        "docs/invalid-capsule-examples.md",
        "schemas/capsule-schema.json",
        "schemas/capsule-schema.bundle.json",
        "schemas/neuro-concentrate.schema.json",
        "schemas/validator-api-envelopes.schema.json",
        "schemas/validator-api-envelopes.bundle.json",
        "scripts/check-schema-recipes.js",
        "docs/invalid-api-envelope-examples.md",
        "docs/invalid-archive-bundle-examples.md",
        "docs/invalid-client-recipe-index-examples.md"
      ],
      "supporting_surfaces": [
        "docs/integration-guide.md",
        "docs/client-recipes.md",
        "docs/npm-consumption.md",
        "examples/client/ajv-validate-schema-bundles.mjs",
        "examples/client/ajv-validate-capsule.mjs",
        "examples/client/ajv-validate-validator-envelope.mjs",
        "examples/client/ajv-reject-invalid-capsules.mjs",
        "examples/client/esm-package-ajv-validate-contracts.mjs",
        "examples/client/esm-package-ajv-validate-schema-bundles.mjs",
        "examples/client/esm-package-ajv-reject-invalid-capsules.mjs",
        "examples/invalid/README.md",
        "scripts/check-invalid-examples.js",
        "scripts/check-package-install.js",
        "scripts/check-schema-bundles.js",
        "docs/api-envelopes.md",
        "examples/client/ajv-reject-invalid-validator-envelopes.mjs",
        "examples/client/esm-package-ajv-reject-invalid-validator-envelopes.mjs",
        "examples/api-invalid/README.md",
        "scripts/check-invalid-api-examples.js",
        "examples/client/ajv-validate-archive-bundle.mjs",
        "examples/client/esm-package-ajv-validate-archive-bundle.mjs",
        "examples/client/ajv-reject-invalid-archive-bundles.mjs",
        "examples/client/esm-package-ajv-reject-invalid-archive-bundles.mjs",
        "examples/archive-invalid/README.md",
        "examples/archive-invalid/archive-bundle.invalid-created-at.json",
        "examples/archive-invalid/archive-bundle.invalid-content-class.json",
        "scripts/check-archive-recipes.js",
        "scripts/check-invalid-archive-examples.js",
        "examples/client/ajv-validate-client-recipe-index.mjs",
        "examples/client/ajv-reject-invalid-client-recipe-index.mjs",
        "examples/client/esm-package-ajv-validate-client-recipe-index.mjs",
        "examples/client/esm-package-ajv-reject-invalid-client-recipe-index.mjs",
        "examples/client-invalid/README.md",
        "scripts/check-invalid-client-recipe-index-examples.js",
        "examples/client/cjs-package-ajv-validate-contracts.cjs",
        "examples/client/cjs-package-ajv-reject-invalid-capsules.cjs",
        "examples/client/ts-package-ajv-validate-contracts.ts",
        "examples/client/ts-package-ajv-reject-invalid-capsules.ts",
        "examples/client/cjs-package-ajv-validate-archive-bundle.cjs",
        "examples/client/cjs-package-ajv-validate-schema-bundles.cjs",
        "examples/client/cjs-package-ajv-reject-invalid-archive-bundles.cjs",
        "examples/client/cjs-package-ajv-reject-invalid-validator-envelopes.cjs",
        "examples/client/ts-package-ajv-validate-archive-bundle.ts",
        "examples/client/ts-package-ajv-validate-schema-bundles.ts",
        "examples/client/ts-package-ajv-reject-invalid-archive-bundles.ts",
        "examples/client/ts-package-ajv-reject-invalid-validator-envelopes.ts"
      ],
      "verify_commands": [
        "npm run check:schema-recipes",
        "npm run check:schema-bundles",
        "npm run check:invalid-examples",
        "npm run check:package-install",
        "npm run check:traceability",
        "npm run check:invalid-api-examples",
        "npm run check:archive-recipes",
        "npm run check:invalid-archive-examples",
        "npm run check:invalid-client-recipe-index-examples"
      ]
    },
    {
      "id": "negative-evidence-and-fail-closed",
      "claim": "The public surface documents bounded negative paths instead of exposing only happy-path examples.",
      "audiences": [
        "reviewers",
        "integrators"
      ],
      "strongest_surfaces": [
        "PUBLIC_FAILURE_MODEL.json",
        "docs/failure-model.md",
        "docs/invalid-capsule-examples.md",
        "examples/example-validator-invalid-g16.capsule.json",
        "examples/invalid/example-invalid-missing-neuro-concentrate.capsule.json",
        "examples/invalid/example-invalid-relation-type.capsule.json",
        "examples/api/unauthorized-response.sample.json",
        "examples/api/forbidden-response.sample.json",
        "examples/api/conflict-response.sample.json",
        "docs/invalid-api-envelope-examples.md",
        "examples/api-invalid/validate-request.single.missing-capsule.json",
        "examples/api-invalid/validate-response.fail.invalid-gate.json",
        "examples/api/stats-error-response.sample.json"
      ],
      "supporting_surfaces": [
        "examples/api/validate-response.fail.json",
        "docs/openapi.md",
        "docs/portability.md",
        "schemas/public-failure-model.schema.json",
        "PUBLIC_EXAMPLE_COVERAGE.json",
        "scripts/check-invalid-examples.js",
        "examples/api-invalid/README.md",
        "scripts/check-invalid-api-examples.js",
        "examples/client/python-parse-error-responses.py",
        "examples/api/stats-error-response.sample.json"
      ],
      "verify_commands": [
        "npm run check:failure-model",
        "npm run check:invalid-examples",
        "npm run check:api-examples",
        "npm run check:traceability",
        "npm run check:invalid-api-examples"
      ]
    },
    {
      "id": "projection-boundaries-and-provenance",
      "claim": "Published-vs-deferred boundaries and public projection provenance are explicit and reviewable.",
      "audiences": [
        "contributors",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/projection-doctrine.md",
        "docs/domain-boundaries.md",
        "PUBLIC_BOUNDARY_MAP.json",
        "SOURCE_MANIFEST.json"
      ],
      "supporting_surfaces": [
        "docs/source-materials.md",
        "docs/repository-scope.md",
        "OPEN_CORE_PLAN.md",
        "schemas/public-boundary-map.schema.json"
      ],
      "verify_commands": [
        "npm run audit:public-surface",
        "npm run check:boundary-map",
        "npm run check:surface",
        "npm run check:traceability"
      ]
    },
    {
      "id": "reviewer-and-release-evidence",
      "claim": "External reviewers can follow a bounded path from project identity to release evidence without scraping the whole repository tree.",
      "audiences": [
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/reviewer-guide.md",
        "docs/evaluation-packet.md",
        "PUBLIC_PROJECT_PROFILE.json",
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_RELEASE_REVIEW.md",
        "docs/release-evidence.md",
        "PUBLIC_CONTRACT_CATALOG.json",
        "schemas/public-project-profile.schema.json",
        "schemas/public-evaluation-packet.schema.json",
        "schemas/public-release-metadata.schema.json"
      ],
      "verify_commands": [
        "npm run check:evaluation-packet",
        "npm run check:project-profile",
        "npm run check:release",
        "npm run check:traceability"
      ]
    },
    {
      "id": "portability-and-archive-contracts",
      "claim": "Public portability and archive trust posture are documented as bounded contracts with both positive and intentionally invalid archive-bundle examples rather than vague product promises.",
      "audiences": [
        "reviewers",
        "integrators"
      ],
      "strongest_surfaces": [
        "docs/portability.md",
        "docs/archive-bundles.md",
        "PUBLIC_PORTABILITY_PROFILE.json",
        "schemas/archive-bundle.schema.json",
        "examples/archive/archive-bundle.sample.json",
        "docs/archive-validation-recipes.md",
        "docs/invalid-archive-bundle-examples.md"
      ],
      "supporting_surfaces": [
        "docs/trust-model.md",
        "docs/compatibility.md",
        "schemas/public-portability-profile.schema.json",
        "examples/client/ajv-validate-archive-bundle.mjs",
        "examples/client/esm-package-ajv-validate-archive-bundle.mjs",
        "scripts/check-archive-recipes.js",
        "examples/archive-invalid/README.md",
        "examples/archive-invalid/archive-bundle.invalid-created-at.json",
        "examples/archive-invalid/archive-bundle.invalid-content-class.json",
        "examples/client/ajv-reject-invalid-archive-bundles.mjs",
        "examples/client/esm-package-ajv-reject-invalid-archive-bundles.mjs",
        "scripts/check-invalid-archive-examples.js",
        "examples/client/cjs-package-ajv-validate-archive-bundle.cjs",
        "examples/client/cjs-package-ajv-reject-invalid-archive-bundles.cjs",
        "examples/client/ts-package-ajv-validate-archive-bundle.ts",
        "examples/client/ts-package-ajv-reject-invalid-archive-bundles.ts"
      ],
      "verify_commands": [
        "npm run check:portability",
        "npm run check:archive-recipes",
        "npm run check:surface",
        "npm run check:traceability",
        "npm run check:invalid-archive-examples"
      ]
    },
    {
      "id": "maintainer-intake-and-practical-usability",
      "claim": "Contributor intake, public usability, and maintainer-facing expectations are explicit rather than implied.",
      "audiences": [
        "contributors",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/community-health.md",
        "CONTRIBUTING.md",
        "SUPPORT.md",
        "SECURITY.md",
        "PUBLIC_CAPABILITY_MATRIX.json",
        "PUBLIC_MAINTENANCE_MODEL.json",
        "docs/repo-validation-workflow.md"
      ],
      "supporting_surfaces": [
        ".github/ISSUE_TEMPLATE/integration_question.md",
        ".github/ISSUE_TEMPLATE/contract_change.md",
        "CODEOWNERS",
        "GOVERNANCE.md",
        "docs/capability-matrix.md",
        "docs/example-coverage.md",
        "docs/maintainer-operations.md",
        "docs/change-control.md",
        "docs/verification.md"
      ],
      "verify_commands": [
        "npm run check:community-health",
        "npm run check:capability-matrix",
        "npm run check:traceability",
        "npm run check:maintenance-model"
      ]
    },
    {
      "id": "change-control-and-release-discipline",
      "claim": "Additive, deprecated, and breaking public changes are described explicitly and tied to release evidence instead of being inferred from scattered prose.",
      "audiences": [
        "contributors",
        "integrators",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/change-control.md",
        "VERSIONING.md",
        "docs/compatibility.md",
        "PUBLIC_CHANGE_CONTROL_MODEL.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "CHANGELOG.md",
        "PUBLIC_RELEASE_REVIEW.md",
        "RELEASING.md",
        "PUBLIC_MAINTENANCE_MODEL.json",
        "schemas/public-change-control-model.schema.json"
      ],
      "verify_commands": [
        "npm run check:change-control",
        "npm run check:release",
        "npm run check:traceability"
      ]
    },
    {
      "id": "artifact-ownership-and-authority",
      "claim": "Public artifact families have explicit ownership and stronger-source hierarchy instead of leaving authority splits implicit across reviewer docs.",
      "audiences": [
        "contributors",
        "integrators",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/artifact-ownership.md",
        "PUBLIC_OWNERSHIP_MAP.json",
        "docs/trust-model.md",
        "docs/source-materials.md",
        "docs/projection-doctrine.md"
      ],
      "supporting_surfaces": [
        "PUBLIC_PROJECT_PROFILE.json",
        "PUBLIC_CONTRACT_CATALOG.json",
        "SOURCE_MANIFEST.json",
        "schemas/public-ownership-map.schema.json"
      ],
      "verify_commands": [
        "npm run check:ownership-map",
        "npm run check:traceability"
      ]
    },
    {
      "id": "dependency-order-and-reading-path",
      "claim": "The public stack publishes an explicit dependency and reading-order map instead of forcing reviewers to infer artifact order from folder layout alone.",
      "audiences": [
        "contributors",
        "integrators",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/dependency-graph.md",
        "PUBLIC_DEPENDENCY_GRAPH.json",
        "docs/reviewer-guide.md",
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_TRACEABILITY_MATRIX.json",
        "PUBLIC_OWNERSHIP_MAP.json",
        "PUBLIC_PROJECT_PROFILE.json",
        "schemas/public-dependency-graph.schema.json"
      ],
      "verify_commands": [
        "npm run check:dependency-graph",
        "npm run check:traceability"
      ]
    },
    {
      "id": "bounded-public-assurance-and-limits",
      "claim": "Bounded public claims, strongest evidence, and explicit non-claims are collected into one reviewer-facing layer instead of being inferred from scattered docs.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/assurance-case.md",
        "PUBLIC_ASSURANCE_CASE.json",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_FAILURE_MODEL.json",
        "PUBLIC_RELEASE_REVIEW.md"
      ],
      "supporting_surfaces": [
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_DEPENDENCY_GRAPH.json",
        "docs/reviewer-guide.md",
        "schemas/public-assurance-case.schema.json"
      ],
      "verify_commands": [
        "npm run check:assurance-case",
        "npm run check:traceability",
        "npm run check:release"
      ]
    },
    {
      "id": "co-moving-review-and-release-surfaces",
      "claim": "Co-moving reviewer, release, contract, and teaching surfaces are explicit instead of being left to maintainer memory.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/update-coherence.md",
        "PUBLIC_UPDATE_COHERENCE_MAP.json",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_RELEASE_REVIEW.md",
        "PUBLIC_CONTRACT_CATALOG.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_MAINTENANCE_MODEL.json",
        "PUBLIC_CHANGE_CONTROL_MODEL.json",
        "PUBLIC_ASSURANCE_CASE.json",
        "schemas/public-update-coherence-map.schema.json"
      ],
      "verify_commands": [
        "npm run check:update-coherence",
        "npm run check:maintenance-model",
        "npm run check:change-control",
        "npm run check:release",
        "npm run check:traceability"
      ]
    },
    {
      "id": "explicit-limitations-and-deferred-scope",
      "claim": "Deferred scope and public non-promises are explicit instead of being left to scattered caveats across reviewer docs and release review.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/limitations-register.md",
        "PUBLIC_LIMITATIONS_REGISTER.json",
        "PUBLIC_BOUNDARY_MAP.json",
        "docs/repository-scope.md",
        "PUBLIC_RELEASE_REVIEW.md"
      ],
      "supporting_surfaces": [
        "PUBLIC_ASSURANCE_CASE.json",
        "PUBLIC_EVALUATION_PACKET.json",
        "docs/domain-boundaries.md",
        "schemas/public-limitations-register.schema.json"
      ],
      "verify_commands": [
        "npm run check:limitations-register",
        "npm run check:boundary-map",
        "npm run check:traceability",
        "npm run check:release"
      ]
    },
    {
      "id": "active-maintenance-and-public-hardening-history",
      "claim": "Active maintenance and public-surface hardening are reviewable through a bounded timeline instead of requiring reviewers to infer maturity from raw git history.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/evidence-timeline.md",
        "PUBLIC_EVIDENCE_TIMELINE.json",
        "CHANGELOG.md",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_PROJECT_PROFILE.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_UPDATE_COHERENCE_MAP.json",
        "docs/reviewer-guide.md",
        "schemas/public-evidence-timeline.schema.json"
      ],
      "verify_commands": [
        "npm run check:evidence-timeline",
        "npm run check:traceability",
        "npm run check:release"
      ]
    },
    {
      "id": "bounded-reviewer-criteria-scorecard",
      "claim": "External reviewers can assess repository maturity against explicit bounded criteria instead of relying only on impressions, counts, or raw git history.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/review-scorecard.md",
        "PUBLIC_REVIEW_SCORECARD.json",
        "PUBLIC_PROJECT_PROFILE.json",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_EVALUATION_PACKET.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_EVIDENCE_TIMELINE.json",
        "PUBLIC_ASSURANCE_CASE.json",
        "PUBLIC_LIMITATIONS_REGISTER.json",
        "schemas/public-review-scorecard.schema.json"
      ],
      "verify_commands": [
        "npm run check:review-scorecard",
        "npm run check:traceability",
        "npm run check:release"
      ]
    },
    {
      "id": "verification-coverage-and-check-discipline",
      "claim": "Verification coverage is explicit and reviewable through bounded check families instead of being hidden behind one opaque verify command.",
      "audiences": [
        "reviewers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/verification-matrix.md",
        "PUBLIC_VERIFICATION_MATRIX.json",
        "docs/verification.md",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_REVIEW_SCORECARD.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_TRACEABILITY_MATRIX.json",
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_EVIDENCE_TIMELINE.json",
        "schemas/public-verification-matrix.schema.json"
      ],
      "verify_commands": [
        "npm run check:verification-matrix",
        "npm run check:traceability",
        "npm run check:release"
      ]
    },
    {
      "id": "audience-specific-entry-paths",
      "claim": "The public surface publishes bounded role-specific entry paths instead of assuming every audience should navigate the same generic walkthrough.",
      "audiences": [
        "contributors",
        "integrators",
        "tool-builders",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/audience-paths.md",
        "PUBLIC_AUDIENCE_PATHS.json",
        "docs/reviewer-guide.md",
        "ONBOARDING.md",
        "docs/integration-guide.md"
      ],
      "supporting_surfaces": [
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_CAPABILITY_MATRIX.json",
        "PUBLIC_VERIFICATION_MATRIX.json",
        "docs/maintainer-operations.md"
      ],
      "verify_commands": [
        "npm run check:audience-paths",
        "npm run check:traceability"
      ]
    },
    {
      "id": "evidence-strength-and-stronger-sources",
      "claim": "The public surface makes stronger-source hierarchy explicit instead of forcing readers to infer authority from filenames or summary prose.",
      "audiences": [
        "contributors",
        "integrators",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/evidence-strength.md",
        "PUBLIC_EVIDENCE_STRENGTH_MAP.json",
        "docs/trust-model.md",
        "docs/compatibility.md",
        "PUBLIC_OWNERSHIP_MAP.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_TRACEABILITY_MATRIX.json",
        "PUBLIC_VERIFICATION_MATRIX.json",
        "PUBLIC_AUDIENCE_PATHS.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "verify_commands": [
        "npm run check:evidence-strength",
        "npm run check:traceability"
      ]
    },
    {
      "id": "adoption-readiness-and-prerequisites",
      "claim": "Public audience readiness, prerequisites, and deferred hosted-runtime expectations are explicit instead of being inferred from examples, caveats, and role-specific docs.",
      "audiences": [
        "reviewers",
        "integrators",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/adoption-readiness.md",
        "PUBLIC_ADOPTION_READINESS.json",
        "PUBLIC_AUDIENCE_PATHS.json",
        "PUBLIC_LIMITATIONS_REGISTER.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "docs/integration-guide.md",
        "docs/community-health.md",
        "docs/maintainer-operations.md",
        "PUBLIC_EVIDENCE_STRENGTH_MAP.json",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:adoption-readiness",
        "npm run check:traceability"
      ]
    },
    {
      "id": "freshness-and-stale-signals",
      "claim": "The public surface makes freshness triggers and stale-summary signals explicit instead of letting reviewer and release summaries drift silently.",
      "audiences": [
        "reviewers",
        "contributors",
        "integrators"
      ],
      "strongest_surfaces": [
        "docs/freshness.md",
        "PUBLIC_FRESHNESS_MODEL.json",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_EVIDENCE_TIMELINE.json",
        "PUBLIC_UPDATE_COHERENCE_MAP.json"
      ],
      "supporting_surfaces": [
        "docs/release-evidence.md",
        "docs/verification.md",
        "PUBLIC_EVIDENCE_STRENGTH_MAP.json",
        "PUBLIC_ADOPTION_READINESS.json",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:freshness",
        "npm run check:traceability"
      ]
    },
    {
      "id": "ecosystem-value-and-external-utility",
      "claim": "The public surface makes its external utility explicit for reviewers, integrators, tool-builders, contributors, and OSS-support programs instead of forcing outside readers to infer value from raw counts, filenames, or vague aspiration.",
      "audiences": [
        "reviewers",
        "integrators",
        "tool-builders",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/ecosystem-value.md",
        "PUBLIC_ECOSYSTEM_VALUE_MAP.json",
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_ADOPTION_READINESS.json",
        "PUBLIC_FRESHNESS_MODEL.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_PROJECT_PROFILE.json",
        "PUBLIC_CAPABILITY_MATRIX.json",
        "docs/reviewer-guide.md",
        "docs/release-evidence.md",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:ecosystem-value",
        "npm run check:traceability"
      ]
    },
    {
      "id": "bounded-public-decisions-and-rationale",
      "claim": "The public surface makes major design decisions and trust-sensitive rationale explicit instead of forcing outside readers to infer intent from filenames, omissions, or maintainer folklore.",
      "audiences": [
        "reviewers",
        "contributors",
        "integrators"
      ],
      "strongest_surfaces": [
        "docs/decision-log.md",
        "PUBLIC_DECISION_LOG.json",
        "PUBLIC_BOUNDARY_MAP.json",
        "PUBLIC_ASSURANCE_CASE.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_TRACEABILITY_MATRIX.json",
        "PUBLIC_EVIDENCE_TIMELINE.json",
        "docs/reviewer-guide.md",
        "docs/release-evidence.md",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:decision-log",
        "npm run check:traceability"
      ]
    },
    {
      "id": "explicit-public-evidence-gaps",
      "claim": "The public surface makes still-open evidence gaps explicit so reviewers and programs can see where maturity is already well supported and where it remains intentionally bounded.",
      "audiences": [
        "reviewers",
        "contributors",
        "maintainers"
      ],
      "strongest_surfaces": [
        "docs/evidence-gaps.md",
        "PUBLIC_EVIDENCE_GAPS_REGISTER.json",
        "PUBLIC_LIMITATIONS_REGISTER.json",
        "PUBLIC_FRESHNESS_MODEL.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_ADOPTION_READINESS.json",
        "PUBLIC_ECOSYSTEM_VALUE_MAP.json",
        "docs/reviewer-guide.md",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:evidence-gaps",
        "npm run check:traceability"
      ]
    },
    {
      "id": "bounded-program-fit-for-reviewers-and-programs",
      "claim": "The public surface makes its reviewer/program fit explicit as a bounded, artifact-backed layer instead of forcing outside evaluators to infer OSS-support credibility from polish, counts, or vague aspiration.",
      "audiences": [
        "reviewers",
        "contributors",
        "maintainers"
      ],
      "strongest_surfaces": [
        "docs/program-fit.md",
        "PUBLIC_PROGRAM_FIT_MAP.json",
        "PUBLIC_PROJECT_PROFILE.json",
        "PUBLIC_EVALUATION_PACKET.json",
        "PUBLIC_RELEASE_METADATA.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_ECOSYSTEM_VALUE_MAP.json",
        "PUBLIC_EVIDENCE_GAPS_REGISTER.json",
        "docs/reviewer-guide.md",
        "docs/faq.md"
      ],
      "verify_commands": [
        "npm run check:program-fit",
        "npm run check:traceability"
      ]
    },
    {
      "id": "bounded-publication-state-and-safety",
      "claim": "The public surface makes publication-state readiness explicit as a bounded, artifact-backed layer instead of forcing maintainers or reviewers to infer public-release safety from polish, tree shape, or aspiration alone.",
      "audiences": [
        "reviewers",
        "maintainers",
        "contributors"
      ],
      "strongest_surfaces": [
        "docs/publication-readiness.md",
        "PUBLIC_PUBLICATION_READINESS.json",
        "PUBLIC_RELEASE_METADATA.json",
        "PUBLIC_LIMITATIONS_REGISTER.json",
        "PUBLIC_PROJECT_PROFILE.json"
      ],
      "supporting_surfaces": [
        "PUBLIC_PROGRAM_FIT_MAP.json",
        "PUBLIC_EVIDENCE_GAPS_REGISTER.json",
        "docs/reviewer-guide.md",
        "docs/release-evidence.md"
      ],
      "verify_commands": [
        "npm run check:publication-readiness",
        "npm run check:traceability"
      ]
    },
    {
      "id": "integrity-seal-rule-and-hash-proofs",
      "claim": "The public surface makes the G16 sealing rule reproducible through compact constants, human guidance, repo-local recipes, package-consumer recipes, and verifier-backed example/API hash proofs without requiring private validator helpers.",
      "audiences": [
        "integrators",
        "tool-builders",
        "reviewers"
      ],
      "strongest_surfaces": [
        "docs/integrity-recipes.md",
        "docs/python-consumption.md",
        "references/contract-constants.json",
        "examples/client/recompute-integrity-seal.mjs",
        "examples/client/esm-package-recompute-integrity-seal.mjs",
        "examples/client/python-recompute-integrity-seal.py",
        "scripts/check-integrity-recipes.js",
        "scripts/check-python-recipes.js"
      ],
      "supporting_surfaces": [
        "docs/5-element-law.md",
        "docs/16-gates.md",
        "docs/reference-pack.md",
        "examples/example-note.capsule.json",
        "examples/example-validator-invalid-g16.capsule.json",
        "examples/api/validate-response.pass.json",
        "examples/api/validate-response.fail.json",
        "examples/api/validate-response.batch.json",
        "examples/api/validate-response.fix.sample.json",
        "scripts/lib/integrity.js"
      ],
      "verify_commands": [
        "npm run check:integrity-recipes",
        "npm run check:python-recipes",
        "npm run check:examples",
        "npm run check:api-examples",
        "npm run check:package-install",
        "npm run check:traceability"
      ]
    }
  ],
  "non_claims": [
    "This matrix does not enumerate every private runtime dependency behind the upstream N1Hub repository.",
    "This matrix does not replace the stronger docs, schemas, examples, and release evidence it references."
  ],
  "review_commands": [
    "npm run check:traceability",
    "npm run verify:repo"
  ]
}