{
  "schema": "guide14-current-source-basis-v1",
  "reviewedAtUtc": "2026-10-29T04:43:54.611929+00:00",
  "sourceFiles": [
    {
      "path": "pkg/workflow/workflow_documented_claim_verified.go",
      "sha256": "9f36fc1fe52ea016e294845bd42db792b715197b19a4c1c6c0fc1dfddbbf1c78",
      "bytes": 8514,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1,
          "end_line": 250,
          "text": "// documented_claim_verified \u2014 SPEC-stage WARN check for documented claim\n// evidence cells (issue #1019 Sprint 4 Feature #9).\n//\n// When a requirement declares `documented_behaviors:`, every entry must be\n// structurally complete and grounded:\n//\n//   - claim, documented_in, implementing_symbol, verify_by present\n//   - verify_by \u2208 {signal_present, test_reference, manual_review}\n//   - documented_in path exists on disk (optional #anchor / :line stripped)\n//   - kind-specific evidence field present and, where applicable, path exists:\n//     signal_present  \u2192 signal_id non-empty (declaration binds the signal)\n//     test_reference  \u2192 test_ref path exists\n//     manual_review   \u2192 review_note \u2265 min length\n//\n// Opt-in: no documented_behaviors anywhere \u2192 skip. Default severity is WARN\n// once claims are declared. This check verifies evidence *presence* for\n// declared claims; it does not yet execute signal rules against symbols\n// (running signals is a later hardening step).\npackage workflow\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"os\"\n\t\"path/filepath\"\n\t\"sort\"\n\t\"strings\"\n\n\t\"github.com/probelabs/proof/pkg/model\"\n\t\"github.com/probelabs/proof/pkg/repo\"\n)\n\n// documentedClaimVerifiedCheck surfaces declared documented behaviors whose\n// evidence cells are incomplete or ungrounded.\ntype documentedClaimVerifiedCheck struct{}\n\n// Implements: SYS-REQ-260806-RMP8\nfunc (c *documentedClaimVerifiedCheck) Name() string { return \"documented_claim_verified\" }\n\n// Implements: SYS-REQ-260806-RMP8\nfunc (c *documentedClaimVerifiedCheck) Stage() Stage { return StageSpec }\n\n// Implements: SYS-REQ-260806-RMP8\nfunc (c *documentedClaimVerifiedCheck) Severity() CheckSeverity {\n\treturn SeverityWarning\n}\n\n// documentedClaimRequirements is overridable in tests.\nvar documentedClaimRequirements = workflowLoadAllRequirements\n\n// Run implements the documented_claim_verified gate.\n// Implements: SYS-REQ-260806-RMP8\nfunc (c *documentedClaimVerifiedCheck) Run(_ context.Context, project *repo.Project, cfg *WorkflowConfig) CheckResult {\n\tcr := CheckResult{Name: c.Name(), Severity: c.Severity()}\n\n\tif project == nil || project.Manifest == nil {\n\t\tcr.Status = \"skip\"\n\t\tcr.Summary = \"no project loaded\"\n\t\tcr.SkipReason = \"no project loaded\"\n\t\treturn cr\n\t}\n\n\treqs, err := documentedClaimRequirements(project)\n\tif err != nil {\n\t\tcr.Status = \"fail\"\n\t\tcr.Summary = fmt.Sprintf(\"load requirements: %v\", err)\n\t\treturn cr\n\t}\n\n\tvar (\n\t\tdetails  []string\n\t\tissueIDs []string\n\t\tchecked  int\n\t\troot     = project.Root\n\t)\n\tfor _, r := range reqs {\n\t\tif r == nil || r.IsExcludedFromActiveChecks() {\n\t\t\tcontinue\n\t\t}\n\t\tif len(r.DocumentedBehaviors) == 0 {\n\t\t\tcontinue\n\t\t}\n\t\tfor i, b := range r.DocumentedBehaviors {\n\t\t\tchecked++\n\t\t\tlabel := model.DocumentedBehaviorLabel(r.ID, b, i)\n\t\t\tfindings := evaluateDocumentedBehavior(root, label, b)\n\t\t\tif len(findings) == 0 {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tissueIDs = append(issueIDs, label)\n\t\t\tfor _, f := range findings {\n\t\t\t\tdetails = append(details, fmt.Sprintf(\"%s: %s\", label, f))\n\t\t\t}\n\t\t}\n\t}\n\n\tif checked == 0 {\n\t\tcr.Status = \"skip\"\n\t\tcr.Summary = \"no documented_behaviors declared (documented claim evidence check opt-in)\"\n\t\tcr.SkipReason = \"no documented_behaviors declared\"\n\t\treturn cr\n\t}\n\n\tif len(details) == 0 {\n\t\tcr.Status = \"pass\"\n\t\tcr.Summary = fmt.Sprintf(\"all %d documented claim(s) have evidence present\", checked)\n\t\treturn cr\n\t}\n\n\tsort.Strings(details)\n\tsort.Strings(issueIDs)\n\tcr.Status = \"warn\"\n\tcr.IssueCount = len(issueIDs)\n\tcr.IssueIDs = issueIDs\n\tcr.Summary = fmt.Sprintf(\"%d documented claim(s) missing evidence (%d finding(s))\", len(issueIDs), len(details))\n\t// proof:domain-exempt: output preview/truncation cap (show first N, then summarize); not a requirement-domain quantity\n\tcr.Details = cfg.previewFindingDetails(details, 20)\n\treturn cr\n}\n\n// GuidanceFor points authors at completing documented_behaviors evidence cells.\n// Implements: SYS-REQ-260806-RMP8\nfunc (c *documentedClaimVerifiedCheck) GuidanceFor(result CheckResult) *Guidance {\n\treturn &Guidance{\n\t\tWhat: result.Summary,\n\t\tWhy: \"Documented claims (man pages, godoc, NatSpec, \u2026) that are not bound to \" +\n\t\t\t\"an implementing symbol and a verify_by evidence kind leave documentation \" +\n\t\t\t\"promises unenforced \u2014 the class of gap where docs describe behavior the \" +\n\t\t\t\"code never implements.\",\n\t\tHow: \"For each listed claim, complete the documented_behaviors cell on the \" +\n\t\t\t\"requirement YAML:\\n\" +\n\t\t\t\"  - claim: human-readable assertion from the docs\\n\" +\n\t\t\t\"  - documented_in: path to the man page / godoc / NatSpec source\\n\" +\n\t\t\t\"  - implementing_symbol: the function/method that should enforce it\\n\" +\n\t\t\t\"  - verify_by: signal_present | test_reference | manual_review\\n\" +\n\t\t\t\"  - kind field: signal_id / test_ref / review_note\\n\" +\n\t\t\t\"Ensure documented_in and test_ref paths exist. Then re-run:\\n\" +\n\t\t\t\"  proof audit --check documented_claim_verified\",\n\t\tDocs:           \"docs/help/checks/documented_claim_verified.md\",\n\t\tEscalationType: \"fix_spec\",\n\t}\n}\n\n// evaluateDocumentedBehavior returns zero or more finding messages for one cell.\n// Implements: SYS-REQ-260806-RMP8\nfunc evaluateDocumentedBehavior(root, label string, b model.DocumentedBehavior) []string {\n\tvar findings []string\n\tif err := model.ValidateDocumentedBehavior(b); err != nil {\n\t\t// Structural gaps already name the field; keep message short.\n\t\tfindings = append(findings, err.Error())\n\t\t// Still check path existence when documented_in is set so authors\n\t\t// see both structural and grounding gaps in one pass.\n\t\tif path := strings.TrimSpace(b.DocumentedIn); path != \"\" {\n\t\t\tif !documentedPathExists(root, path) {\n\t\t\t\tfindings = append(findings, fmt.Sprintf(\"documented_in path %q does not exist\", stripDocLocation(path)))\n\t\t\t}\n\t\t}\n\t\tif strings.TrimSpace(b.VerifyBy) == model.DocumentedClaimVerifyByTestReference {\n\t\t\tif ref := strings.TrimSpace(b.TestRef); ref != \"\" && !testRefExists(root, ref) {\n\t\t\t\tfindings = append(findings, fmt.Sprintf(\"test_ref path %q does not exist\", stripTestRefPath(ref)))\n\t\t\t}\n\t\t}\n\t\treturn findings\n\t}\n\n\t// Structural OK \u2014 ground paths.\n\tif !documentedPathExists(root, b.DocumentedIn) {\n\t\tfindings = append(findings, fmt.Sprintf(\"documented_in path %q does not exist\", stripDocLocation(b.DocumentedIn)))\n\t}\n\tif strings.TrimSpace(b.VerifyBy) == model.DocumentedClaimVerifyByTestReference {\n\t\tif !testRefExists(root, b.TestRef) {\n\t\t\tfindings = append(findings, fmt.Sprintf(\"test_ref path %q does not exist\", stripTestRefPath(b.TestRef)))\n\t\t}\n\t}\n\t_ = label // reserved for future per-claim detail formatting\n\treturn findings\n}\n\n// stripDocLocation drops optional \"#anchor\" and trailing \":digits\" line\n// suffixes so path existence checks the file, not the fragment.\n// Implements: SYS-REQ-260806-RMP8\nfunc stripDocLocation(loc string) string {\n\tloc = strings.TrimSpace(loc)\n\tif i := strings.Index(loc, \"#\"); i >= 0 {\n\t\tloc = loc[:i]\n\t}\n\t// path:line form (e.g. docs/man/auth.5:42) \u2014 only strip when the suffix\n\t// is pure digits so Windows drive letters and package paths are preserved.\n\tif i := strings.LastIndex(loc, \":\"); i >= 0 && i < len(loc)-1 {\n\t\tsuffix := loc[i+1:]\n\t\tallDigits := true\n\t\tfor _, r := range suffix {\n\t\t\tif r < '0' || r > '9' {\n\t\t\t\tallDigits = false\n\t\t\t\tbreak\n\t\t\t}\n\t\t}\n\t\tif allDigits {\n\t\t\tloc = loc[:i]\n\t\t}\n\t}\n\treturn strings.TrimSpace(loc)\n}\n\n// stripTestRefPath drops an optional :TestName suffix for path existence.\n// Implements: SYS-REQ-260806-RMP8\nfunc stripTestRefPath(ref string) string {\n\tref = strings.TrimSpace(ref)\n\t// Prefer path:TestName only when the suffix looks like a Go test identifier\n\t// (starts with Test / test / Fuzz / Benchmark) so ordinary paths with\n\t// colons are not mangled.\n\tif i := strings.LastIndex(ref, \":\"); i >= 0 && i < len(ref)-1 {\n\t\tsuffix := ref[i+1:]\n\t\tif strings.HasPrefix(suffix, \"Test\") ||\n\t\t\tstrings.HasPrefix(suffix, \"test\") ||\n\t\t\tstrings.HasPrefix(suffix, \"Fuzz\") ||\n\t\t\tstrings.HasPrefix(suffix, \"Benchmark\") {\n\t\t\treturn strings.TrimSpace(ref[:i])\n\t\t}\n\t}\n\treturn ref\n}\n\n// Implements: SYS-REQ-260806-RMP8\nfunc documentedPathExists(root, loc string) bool {\n\tpath := stripDocLocation(loc)\n\tif path == \"\" {\n\t\treturn false\n\t}\n\tfull := path\n\tif !filepath.IsAbs(path) {\n\t\tfull = filepath.Join(root, path)\n\t}\n\t_, err := os.Stat(full)\n\treturn err == nil\n}\n\n// Implements: SYS-REQ-260806-RMP8\nfunc testRefExists(root, ref string) bool {\n\tpath := stripTestRefPath(ref)\n\tif path == \"\" {\n\t\treturn false\n\t}\n\tfull := path\n\tif !filepath.IsAbs(path) {\n\t\tfull = filepath.Join(root, path)\n\t}\n\t_, err := os.Stat(full)\n\treturn err == nil\n}\n"
        }
      ]
    },
    {
      "path": "pkg/model/requirement.go",
      "sha256": "26711a030ec2f87f1de038d4bb8f9b05d21e7d42008cfdf078b19823d0f37e6e",
      "bytes": 317519,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1088,
          "end_line": 1095,
          "text": "\t// DocumentedBehaviors is the documented-claim evidence registry (issue\n\t// #1019 Feature #9). Each entry binds a claim extracted from docs (man\n\t// pages, godoc, NatSpec, JSDoc, docstrings, \u2026) to an implementing\n\t// symbol and a verify_by evidence kind. The documented_claim_verified\n\t// SPEC check verifies that evidence for each declared claim is present.\n\t// Empty/missing is identical to today's behavior (opt-in). Omitted when empty.\n\tDocumentedBehaviors []DocumentedBehavior `yaml:\"documented_behaviors,omitempty\" json:\"documented_behaviors,omitempty\"`\n\t// NominalEvidenceExemptions records reviewer-stamped, per-class decisions\n"
        },
        {
          "start_line": 1570,
          "end_line": 1587,
          "text": "// IsExcludedFromActiveChecks returns true if the requirement is in a status that\n// should be skipped by completeness/quality/linkage workflow checks. This covers\n// terminal-state tombstones (retired, superseded) and rejected requirements that\n// will never be implemented. Active workflow checks must not flag these specs\n// because they are legitimately not expected to satisfy normal quality gates.\n// SYS-REQ-260924-JDRC: lifecycle-aware exclusion for active-spec checks.\nfunc (r *Requirement) IsExcludedFromActiveChecks() bool {\n\treturn r.Status == StatusRetired || r.Status == StatusSuperseded || r.Status == StatusRejected\n}\n\n// IsStatusExcludedFromActiveChecks mirrors IsExcludedFromActiveChecks for callers\n// that only have a raw status string (e.g., from a SQL-backed projection row)\n// rather than a full Requirement value.\n// SYS-REQ-260924-JDRC: lifecycle-aware exclusion for active-spec checks.\nfunc IsStatusExcludedFromActiveChecks(status string) bool {\n\ts := RequirementStatus(status)\n\treturn s == StatusRetired || s == StatusSuperseded || s == StatusRejected\n}\n"
        },
        {
          "start_line": 2382,
          "end_line": 2494,
          "text": "// DocumentedBehavior is one documented-claim evidence cell (issue #1019\n// Feature #9). It binds a claim from documentation (man page, godoc,\n// NatSpec, \u2026) to the code symbol that should implement it and a verify_by\n// evidence kind that the documented_claim_verified check validates.\n//\n// Claims are explicitly registered (not auto-extracted from free text). The\n// same explicit-declaration doctrine as SharedStateRule and BuildTarget.\ntype DocumentedBehavior struct {\n\t// ID is an optional stable claim identifier (e.g. auth_users_comma_parsing).\n\tID string `yaml:\"id,omitempty\" json:\"id,omitempty\"`\n\t// Claim is the human-readable documented assertion text.\n\tClaim string `yaml:\"claim\" json:\"claim\"`\n\t// DocumentedIn is the documentation location (repo-relative path;\n\t// optional \"#anchor\" or \":line\" suffix is stripped when checking path\n\t// existence).\n\tDocumentedIn string `yaml:\"documented_in\" json:\"documented_in\"`\n\t// ImplementingSymbol is the code symbol expected to implement the claim\n\t// (function, method, or free-form path::symbol form).\n\tImplementingSymbol string `yaml:\"implementing_symbol\" json:\"implementing_symbol\"`\n\t// VerifyBy is how evidence is established. Closed vocabulary:\n\t// signal_present | test_reference | manual_review.\n\tVerifyBy string `yaml:\"verify_by\" json:\"verify_by\"`\n\t// SignalID is required when VerifyBy=signal_present: the signal rule id\n\t// that should fire on the implementing symbol.\n\tSignalID string `yaml:\"signal_id,omitempty\" json:\"signal_id,omitempty\"`\n\t// TestRef is required when VerifyBy=test_reference: a test path or\n\t// path:TestName reference that witnesses the claim.\n\tTestRef string `yaml:\"test_ref,omitempty\" json:\"test_ref,omitempty\"`\n\t// ReviewNote is required when VerifyBy=manual_review: an auditor note\n\t// recording that the claim was reviewed against the implementation.\n\tReviewNote string `yaml:\"review_note,omitempty\" json:\"review_note,omitempty\"`\n}\n\n// Documented claim verify_by closed vocabulary (issue #1019 Feature #9).\nconst (\n\tDocumentedClaimVerifyBySignalPresent = \"signal_present\"\n\tDocumentedClaimVerifyByTestReference = \"test_reference\"\n\tDocumentedClaimVerifyByManualReview  = \"manual_review\"\n)\n\n// ValidDocumentedClaimVerifyBy lists accepted DocumentedBehavior.VerifyBy values.\nvar ValidDocumentedClaimVerifyBy = []string{\n\tDocumentedClaimVerifyBySignalPresent,\n\tDocumentedClaimVerifyByTestReference,\n\tDocumentedClaimVerifyByManualReview,\n}\n\n// DocumentedClaimReviewNoteMinLength is the minimum character count for a\n// manual_review ReviewNote so a stub cannot silently satisfy the check.\nconst DocumentedClaimReviewNoteMinLength = 16\n\n// ValidateDocumentedBehavior checks structural completeness of one claim cell.\n// It does not inspect the filesystem \u2014 path existence is the check's job.\n// Returns nil when the entry is well-formed for its verify_by kind.\n// Implements: SYS-REQ-260806-RMP8\nfunc ValidateDocumentedBehavior(b DocumentedBehavior) error {\n\tif strings.TrimSpace(b.Claim) == \"\" {\n\t\treturn fmt.Errorf(\"documented_behavior: claim is required\")\n\t}\n\tif strings.TrimSpace(b.DocumentedIn) == \"\" {\n\t\treturn fmt.Errorf(\"documented_behavior: documented_in is required\")\n\t}\n\tif strings.TrimSpace(b.ImplementingSymbol) == \"\" {\n\t\treturn fmt.Errorf(\"documented_behavior: implementing_symbol is required\")\n\t}\n\tkind := strings.TrimSpace(b.VerifyBy)\n\tif kind == \"\" {\n\t\treturn fmt.Errorf(\"documented_behavior: verify_by is required\")\n\t}\n\tvalid := false\n\tfor _, v := range ValidDocumentedClaimVerifyBy {\n\t\tif kind == v {\n\t\t\tvalid = true\n\t\t\tbreak\n\t\t}\n\t}\n\tif !valid {\n\t\treturn fmt.Errorf(\"documented_behavior: verify_by %q is not one of %v\", kind, ValidDocumentedClaimVerifyBy)\n\t}\n\tswitch kind {\n\tcase DocumentedClaimVerifyBySignalPresent:\n\t\tif strings.TrimSpace(b.SignalID) == \"\" {\n\t\t\treturn fmt.Errorf(\"documented_behavior: signal_id is required when verify_by=signal_present\")\n\t\t}\n\tcase DocumentedClaimVerifyByTestReference:\n\t\tif strings.TrimSpace(b.TestRef) == \"\" {\n\t\t\treturn fmt.Errorf(\"documented_behavior: test_ref is required when verify_by=test_reference\")\n\t\t}\n\tcase DocumentedClaimVerifyByManualReview:\n\t\tnote := strings.TrimSpace(b.ReviewNote)\n\t\tif utf8.RuneCountInString(note) < DocumentedClaimReviewNoteMinLength {\n\t\t\treturn fmt.Errorf(\"documented_behavior: review_note must be \u2265%d characters when verify_by=manual_review (got %d)\",\n\t\t\t\tDocumentedClaimReviewNoteMinLength, utf8.RuneCountInString(note))\n\t\t}\n\t}\n\treturn nil\n}\n\n// DocumentedBehaviorLabel returns a stable short label for findings and issue IDs.\n// Implements: SYS-REQ-260806-RMP8\nfunc DocumentedBehaviorLabel(reqID string, b DocumentedBehavior, index int) string {\n\tif id := strings.TrimSpace(b.ID); id != \"\" {\n\t\tif reqID != \"\" {\n\t\t\treturn reqID + \":\" + id\n\t\t}\n\t\treturn id\n\t}\n\tif reqID != \"\" {\n\t\treturn fmt.Sprintf(\"%s:claim[%d]\", reqID, index)\n\t}\n\treturn fmt.Sprintf(\"claim[%d]\", index)\n}\n\n"
        },
        {
          "start_line": 3142,
          "end_line": 3561,
          "text": "type ProjectChecksConfig struct {\n\tImplementationReachable ImplementationReachableCheckConfig `yaml:\"implementation_reachable,omitempty\" json:\"implementation_reachable,omitempty\"`\n\tSolverLatencyClean      CheckThresholdConfig               `yaml:\"solver_latency_clean,omitempty\" json:\"solver_latency_clean,omitempty\"`\n\tTestsPass               TestsPassCheckConfig               `yaml:\"tests_pass,omitempty\" json:\"tests_pass,omitempty\"`\n\tBuildPasses             BuildPassesCheckConfig             `yaml:\"build_passes,omitempty\" json:\"build_passes,omitempty\"`\n\tCoverageThreshold       CoverageThresholdConfig            `yaml:\"coverage_threshold,omitempty\" json:\"coverage_threshold,omitempty\"`\n\tTestResults             TestResultsCheckConfig             `yaml:\"test_results,omitempty\" json:\"test_results,omitempty\"`\n\tSlowTests               SlowTestsCheckConfig               `yaml:\"slow_tests,omitempty\" json:\"slow_tests,omitempty\"`\n\tEvidenceDiversity       EvidenceDiversityCheckConfig       `yaml:\"evidence_diversity,omitempty\" json:\"evidence_diversity,omitempty\"`\n\tMCDCCoverage            MCDCCoverageCheckConfig            `yaml:\"mcdc_coverage,omitempty\" json:\"mcdc_coverage,omitempty\"`\n\tUnderModeled            UnderModeledCheckConfig            `yaml:\"under_modeled_requirements,omitempty\" json:\"under_modeled_requirements,omitempty\"`\n\tProofComplexity         WorkflowProofComplexityConfig      `yaml:\"proof_complexity_clean,omitempty\" json:\"proof_complexity_clean,omitempty\"`\n\tCodeMCDC                CodeMCDCCheckConfig                `yaml:\"code_mcdc,omitempty\" json:\"code_mcdc,omitempty\"`\n\tWaiversReviewed         WaiversReviewedCheckConfig         `yaml:\"waivers_reviewed,omitempty\" json:\"waivers_reviewed,omitempty\"`\n\t// KnownIssueWithdrawal gates withdrawal of confirmed-real Known Issues\n\t// behind explicit human authorization (see the config type for the\n\t// default posture).\n\tKnownIssueWithdrawal KnownIssueWithdrawalCheckConfig `yaml:\"known_issue_withdrawal,omitempty\" json:\"known_issue_withdrawal,omitempty\"`\n\t// OrphanScope narrows ONLY the orphan_tests_clean / orphan_code_clean\n\t// scans: \"all\" (default) walks every recognized source file in the\n\t// project tree; \"traced\" restricts both checks to files that\n\t// participate in the requirement trace graph (a file carrying at least\n\t// one recognized annotation, or named as a code target in a\n\t// requirement's traces). Unlike verification_scope it does NOT narrow\n\t// coverage or MC/DC measurement surfaces.\n\tOrphanScope string `yaml:\"orphan_scope,omitempty\" json:\"orphan_scope,omitempty\"`\n\t// PropertyFixturesExist, FlipFixturesExist, FixtureStaleness, and\n\t// CodeSignalObligations are opt-in (disabled by default): the audit only\n\t// enforces these example/evidence and inference policies when projects\n\t// explicitly turn them on. See pkg/workflow/check_descriptors.go for the\n\t// DisabledByDefault contract.\n\tPropertyFixturesExist FixturePolicyCheckConfig `yaml:\"property_fixtures_exist,omitempty\" json:\"property_fixtures_exist,omitempty\"`\n\tFlipFixturesExist     FixturePolicyCheckConfig `yaml:\"flip_fixtures_exist,omitempty\" json:\"flip_fixtures_exist,omitempty\"`\n\tFixtureStaleness      FixturePolicyCheckConfig `yaml:\"fixture_staleness_clean,omitempty\" json:\"fixture_staleness_clean,omitempty\"`\n\tCodeSignalObligations FixturePolicyCheckConfig `yaml:\"code_signal_obligations_reviewed,omitempty\" json:\"code_signal_obligations_reviewed,omitempty\"`\n\t// SecuritySurfaceCovered is opt-in (disabled by default): the code-derived\n\t// mandatory security floor. When enabled, the audit scans in-scope\n\t// production code for authz / egress / secret / crypto sinks and requires\n\t// every detected sink file to be OWNED by an active requirement whose\n\t// obligation_checklist carries a catalog SecurityClasses() class \u2014 which in\n\t// turn forces a `:negative` witness through negative_path_witness_required.\n\t// An uncovered sink is release-blocking (ERROR). Off by default because it\n\t// is a heavy code-scanning gate a project turns on once its security\n\t// surface is spec-governed; see pkg/workflow/check_descriptors.go for the\n\t// DisabledByDefault contract.\n\tSecuritySurfaceCovered FixturePolicyCheckConfig         `yaml:\"security_surface_covered,omitempty\" json:\"security_surface_covered,omitempty\"`\n\tExecgraphFlowReviewed  ExecgraphFlowReviewedCheckConfig `yaml:\"execgraph_flow_reviewed,omitempty\" json:\"execgraph_flow_reviewed,omitempty\"`\n\t// CodeSignalUnbindable is opt-in (disabled by default): the audit only\n\t// surfaces unbindable proposes_class declarations when projects\n\t// explicitly turn the check on. See pkg/workflow/check_descriptors.go\n\t// for the DisabledByDefault contract.\n\tCodeSignalUnbindable FixturePolicyCheckConfig `yaml:\"code_signal_unbindable,omitempty\" json:\"code_signal_unbindable,omitempty\"`\n\t// SignalFixturesValid is opt-in (disabled by default): the audit enforces\n\t// the signal validation-pack contract (issue #790) \u2014 required\n\t// positive/negative fixtures plus an opengrep behavioral run \u2014 only when a\n\t// project explicitly turns the check on. See\n\t// pkg/workflow/check_descriptors.go for the DisabledByDefault contract.\n\tSignalFixturesValid FixturePolicyCheckConfig `yaml:\"signal_fixtures_valid,omitempty\" json:\"signal_fixtures_valid,omitempty\"`\n\t// SYS-REQ-1220: verification_plan_evidence check policy. Severity is\n\t// `warning` by default; setting `severity: info` downgrades findings\n\t// to advisory so the check participates in audit reporting without\n\t// contributing to the warning count.\n\tVerificationPlanEvidence VerificationPlanEvidenceCheckConfig `yaml:\"verification_plan_evidence,omitempty\" json:\"verification_plan_evidence,omitempty\"`\n\t// SYS-REQ-1221: verification_state_consistent check policy. Mirrors\n\t// VerificationPlanEvidence \u2014 Severity defaults to \"warning\"; set\n\t// \"info\" to downgrade to advisory.\n\tVerificationStateConsistent VerificationStateConsistentCheckConfig `yaml:\"verification_state_consistent,omitempty\" json:\"verification_state_consistent,omitempty\"`\n\t// SYS-REQ-1344: gap-analysis policy. determinism_max_states caps the\n\t// combined boolean x non-boolean-domain state space enumerated by\n\t// determinism analysis (default 4096; values below 1 fall back to it).\n\tGaps GapsCheckConfig `yaml:\"gaps,omitempty\" json:\"gaps,omitempty\"`\n\t// SYS-REQ-1352: enumerable-domain signal policy for the\n\t// solver_modeling_opportunity check and the req new/set authoring\n\t// nudge. keywords REPLACES the default English lexical keyword set;\n\t// lexical_enabled toggles the whole lexical layer (structural signals\n\t// are not configurable \u2014 they are the language-agnostic backbone).\n\tSolverModelingOpportunity SolverModelingOpportunityCheckConfig `yaml:\"solver_modeling_opportunity,omitempty\" json:\"solver_modeling_opportunity,omitempty\"`\n\t// SYS-REQ-1359: trusted_outputs_from_untrusted_inputs policy.\n\t// financial_tags REPLACES the default trigger-tag set when non-empty;\n\t// sanitizers lists variable names a requirement may reference to\n\t// attest validated data (component-scoped \"<component>.<variable>\" or\n\t// bare names matching any component).\n\tTrust TrustCheckConfig `yaml:\"trust,omitempty\" json:\"trust,omitempty\"`\n\t// DescriptionGrammarEnumerationComplete is opt-in (disabled by default):\n\t// the audit only warns when an approved requirement's description\n\t// enumerates a closed bracket-trailer token set that the traced parser\n\t// has since outgrown (it accepts a `[<name>:` trailer the description\n\t// omits). Off by default because the check is deliberately narrow and a\n\t// project enables it once it wants spec/parser grammar drift guarded. See\n\t// pkg/workflow/check_descriptors.go for the DisabledByDefault contract.\n\tDescriptionGrammarEnumerationComplete FixturePolicyCheckConfig `yaml:\"description_grammar_enumeration_complete,omitempty\" json:\"description_grammar_enumeration_complete,omitempty\"`\n\t// NoAuthoredChangeSurfaceReviewed is opt-in (disabled by default): the\n\t// audit only warns when a `no-authored-change` impact review covers a Go\n\t// source file that gained new exported surface in-branch (a new exported\n\t// func/type/method/const/var vs the review's base ref) AND that new symbol\n\t// is named in no tracing requirement's description \u2014 the strongest available\n\t// signal (issue #191) that the change was not a pure refactor and the review\n\t// should be re-confirmed (update the spec / file a DEFECT / add a\n\t// LocalChange) rather than silently accepted. Off by default so it never\n\t// adds a warning to a default audit until a project enables it. See\n\t// pkg/workflow/check_descriptors.go for the DisabledByDefault contract.\n\tNoAuthoredChangeSurfaceReviewed FixturePolicyCheckConfig `yaml:\"no_authored_change_surface_reviewed,omitempty\" json:\"no_authored_change_surface_reviewed,omitempty\"`\n\t// ChangeEvidenceComplete is opt-in (disabled by default): the forward-looking\n\t// change-evidence gate (issue #194). When enabled, for each in-branch-changed\n\t// traced Go production file whose impact review DECLARES a change-type, the\n\t// audit verifies the backing evidence exists: refactor needs a bare\n\t// no-authored-change review; fix needs a resolvable, closure-covering DEFECT;\n\t// feature needs a resolvable feature LocalChange AND a spec update. Reviews\n\t// with NO declared change-type are GRANDFATHERED (never fire), so the gate is\n\t// forward-looking and never retro-flags legacy reviews or historical code. Off\n\t// by default so it never adds a warning to a default audit until a project\n\t// enables it. See pkg/workflow/check_descriptors.go for the DisabledByDefault\n\t// contract.\n\tChangeEvidenceComplete FixturePolicyCheckConfig `yaml:\"change_evidence_complete,omitempty\" json:\"change_evidence_complete,omitempty\"`\n\t// AcceptanceCriteriaWitnessed (issue #199) is DEFAULT-ON via its tri-state\n\t// Enabled pointer (see AcceptanceCriteriaWitnessedCheckConfig). It requires\n\t// every `testable: true` stakeholder acceptance criterion to carry a\n\t// demonstrating witness (direct acceptance-test annotation OR decomposition\n\t// credit from a nominal-covered derived_req). Set `enabled: false` to opt out.\n\tAcceptanceCriteriaWitnessed AcceptanceCriteriaWitnessedCheckConfig `yaml:\"acceptance_criteria_witnessed,omitempty\" json:\"acceptance_criteria_witnessed,omitempty\"`\n\t// AcceptanceWitnessQuality (issue #199, SYS-REQ-260815-AWQ1) is DEFAULT-ON\n\t// via its tri-state Enabled pointer (see AcceptanceWitnessQualityCheckConfig).\n\t// It requires every credited `:acceptance` tag to sit on a genuine\n\t// end-to-end acceptance test \u2014 not on a unit/integration test of a derived\n\t// SYS/SW/INT requirement. Decomposition is not acceptance. Set\n\t// `enabled: false` to opt out.\n\tAcceptanceWitnessQuality AcceptanceWitnessQualityCheckConfig `yaml:\"acceptance_witness_quality,omitempty\" json:\"acceptance_witness_quality,omitempty\"`\n\t// ReviewCadenceCurrent (issue #366) is opt-in: the lint flags approved\n\t// requirements whose verification.review.reviewed_at is older than the\n\t// configured max_age_days. The check is a no-op when max_age_days <= 0 so\n\t// existing corpora never surface findings until the project explicitly opts\n\t// in (review cadence is a governance choice, not a universal invariant).\n\tReviewCadenceCurrent ReviewCadenceCheckConfig `yaml:\"review_cadence_current,omitempty\" json:\"review_cadence_current,omitempty\"`\n\t// PlanOfRecordCurrent (issue #366) is opt-in: the lint flags every approved\n\t// parent requirement whose most-recent review predates the most-recent\n\t// reviewed_at of any of its children, surfacing the \"parent's evidence is\n\t// stale relative to its decomposition\" condition. Off by default; set\n\t// `enabled: true` to opt in.\n\tPlanOfRecordCurrent PlanOfRecordCheckConfig `yaml:\"plan_of_record_current,omitempty\" json:\"plan_of_record_current,omitempty\"`\n\t// IntegrationEvidenceWitnessed (issue #201) is DEFAULT-ON via its tri-state\n\t// Enabled pointer (see IntegrationEvidenceWitnessedCheckConfig). It requires\n\t// every active INT-REQ (interface requirement) to carry a DIRECT integration-\n\t// test witness (`<INT-REQ>:integration:integration`) OR be honestly deferred\n\t// via an `obligation_deferrals` entry for the `integration` class. It is the\n\t// INT-REQ/interface row of the V-model level->test-type model. Set\n\t// `enabled: false` to opt out.\n\tIntegrationEvidenceWitnessed IntegrationEvidenceWitnessedCheckConfig `yaml:\"integration_evidence_witnessed,omitempty\" json:\"integration_evidence_witnessed,omitempty\"`\n\t// KnownIssueComplete (issue #206) is DEFAULT-ON via its tri-state Enabled\n\t// pointer (see KnownIssueCompleteCheckConfig). It enforces a QUALITY FLOOR on\n\t// every active KnownIssue: EVIDENCE is mandatory (but the KIND is a choice \u2014\n\t// a resolvable bound test, a reproducer_command, reproduction_steps, or an\n\t// environment_note), and high/critical/security-relevant KIs must ALSO carry\n\t// owner, review_date, severity, and a mitigation/remediation. Set\n\t// `enabled: false` to opt out.\n\tKnownIssueComplete KnownIssueCompleteCheckConfig `yaml:\"known_issue_complete,omitempty\" json:\"known_issue_complete,omitempty\"`\n\t// KnownIssuesReviewed carries the review CADENCE for active KnownIssue\n\t// records. See KnownIssuesReviewedCheckConfig: absent means the default\n\t// 90-day interval, not a zero-day one.\n\tKnownIssuesReviewed KnownIssuesReviewedCheckConfig `yaml:\"known_issues_reviewed,omitempty\" json:\"known_issues_reviewed,omitempty\"`\n\t// KnownIssueTemplateTransfer (Metric kill-hygiene A3) is DEFAULT-ON via its\n\t// tri-state Enabled pointer. It WARNs when open KIs carry incomplete\n\t// template-transfer metadata (template_class without isomorphic_sites) or\n\t// high/critical precision-floor bugs without a template_class. Set\n\t// `enabled: false` to opt out.\n\tKnownIssueTemplateTransfer KnownIssueTemplateTransferCheckConfig `yaml:\"known_issue_template_transfer,omitempty\" json:\"known_issue_template_transfer,omitempty\"`\n\t// KnownIssueSiblingDisposition (issue #1019 Sprint 2 Component A) is\n\t// DEFAULT-ON via its tri-state Enabled pointer. It WARNs when a fixed KI\n\t// leaves open/reviewed siblings in the same template_class (primary) or\n\t// kill_domain (secondary), or leaves isomorphic_sites without a per-site\n\t// disposition marker (#fixed / #na / #n/a). Set `enabled: false` to opt out.\n\tKnownIssueSiblingDisposition KnownIssueSiblingDispositionCheckConfig `yaml:\"known_issue_sibling_disposition,omitempty\" json:\"known_issue_sibling_disposition,omitempty\"`\n\t// ResidualKillHygiene (Metric kill-hygiene A3) is DEFAULT-ON via its\n\t// tri-state Enabled pointer. It audits proof/residuals/ for closed\n\t// quantitative kills missing sample_table, same-domain strengthens, and\n\t// falsified reopen_if still marked closed. Missing residuals dir is a no-op.\n\t// Set `enabled: false` to opt out.\n\tResidualKillHygiene ResidualKillHygieneCheckConfig `yaml:\"residual_kill_hygiene,omitempty\" json:\"residual_kill_hygiene,omitempty\"`\n\t// SurfaceCoverage is DEFAULT-ON via its tri-state Enabled pointer. It runs\n\t// the package surface matrix (pkg/surfacecoverage) during proof audit and\n\t// WARNs when GAP cells remain (no AC / residual / N/A disposition). Empty\n\t// extract (cold projects, no matching package trees) is a clean pass so\n\t// existing corpora do not get noise. DEBT (residual disposition) alone does\n\t// not fail. Set `enabled: false` to opt out.\n\tSurfaceCoverage SurfaceCoverageCheckConfig `yaml:\"surface_coverage,omitempty\" json:\"surface_coverage,omitempty\"`\n\t// ProcessChecklist is DEFAULT-ON via its tri-state Enabled pointer. It\n\t// WARNs when the active process campaign checklist (project.checklists.active,\n\t// default onboard_v1) is incomplete so agents discover the deterministic\n\t// spine on every audit. Set `enabled: false` to opt out. Set\n\t// project.checklists.active to \"none\" to declare no campaign spine.\n\tProcessChecklist ProcessChecklistCheckConfig `yaml:\"process_checklist,omitempty\" json:\"process_checklist,omitempty\"`\n\t// ConcernAdjudicated (issue #1019 Sprint 4 Feature #8) is DEFAULT-ON via\n\t// its tri-state Enabled pointer. It WARNs when an open Concern under\n\t// proof/concerns/ is past its review_due \u2014 informal observations must be\n\t// promoted to a KnownIssue or waived with rationale. Missing concerns dir\n\t// is a no-op. Set `enabled: false` to opt out.\n\tConcernAdjudicated ConcernAdjudicatedCheckConfig `yaml:\"concern_adjudicated,omitempty\" json:\"concern_adjudicated,omitempty\"`\n\t// DefectReviewCurrent is DEFAULT-ON via its tri-state Enabled pointer.\n\t// It walks the per-requirement defect_review stamps (plus the linked\n\t// session summaries under proof/claims/sessions/) for specs in the\n\t// effective verification scope and WARNs on the lifecycle faces: no\n\t// stamp, stale input fingerprint (spec/code/claims/prompt drift),\n\t// claims lacking a verification outcome, verified claims never promoted\n\t// to a KnownIssue, dismissals without a reason, and partial sessions\n\t// with errored cells. A project with no stamps, no sessions, and no\n\t// adoption flag sees a clean no-op pass. Severity is configurable\n\t// (error|warning|info, default warning). Set `adopted: true` to declare\n\t// adoption before the first session lands. Set `enabled: false` to opt\n\t// out.\n\tDefectReviewCurrent DefectReviewCurrentCheckConfig `yaml:\"defect_review_current,omitempty\" json:\"defect_review_current,omitempty\"`\n\t// UnresearchedP0Vectors (vector-campaign MVP) is DEFAULT-ON via its\n\t// tri-state Enabled pointer. It WARNs when proof/vectors/ contains P0\n\t// campaigns still in unresearched status (no campaign exit). Missing\n\t// vectors dir is a no-op. Set `enabled: false` to opt out.\n\t// Set fail_as_error: true (or project.external_review.require_p0_vectors_closed)\n\t// to promote findings to ERROR (hard external-review gate).\n\tUnresearchedP0Vectors UnresearchedP0VectorsCheckConfig `yaml:\"unresearched_p0_vectors,omitempty\" json:\"unresearched_p0_vectors,omitempty\"`\n\t// VectorCampaignHygiene validates vector structural exits and forward\n\t// links (related_known_issues / related_residuals) under proof/vectors/.\n\t// Missing vectors dir is a no-op. DEFAULT-ON via tri-state Enabled.\n\t// Set `enabled: false` to opt out.\n\tVectorCampaignHygiene VectorCampaignHygieneCheckConfig `yaml:\"vector_campaign_hygiene,omitempty\" json:\"vector_campaign_hygiene,omitempty\"`\n\t// HighSeverityObligationWithoutVector is DEFAULT-ON via its tri-state\n\t// Enabled pointer. It WARNs when an active requirement authors a high or\n\t// critical ObligationHazard class that no vector under proof/vectors/\n\t// lists in related_obligation_classes. Missing vectors dir means all such\n\t// classes are uncovered. Set `enabled: false` to opt out.\n\tHighSeverityObligationWithoutVector HighSeverityObligationWithoutVectorCheckConfig `yaml:\"high_severity_obligation_without_vector,omitempty\" json:\"high_severity_obligation_without_vector,omitempty\"`\n\t// CodeSignalDeadlineCast (Metric Blind spot A / \u00a715.3) is DEFAULT-ON:\n\t// WARNs when proof/signals packs contain deadline/timelock narrow-cast\n\t// shaped findings that still need hunt disposition.\n\tCodeSignalDeadlineCast CodeSignalDeadlineCastCheckConfig `yaml:\"code_signal_deadline_cast_unreviewed,omitempty\" json:\"code_signal_deadline_cast_unreviewed,omitempty\"`\n\t// HighSeverityReproducerGrade (issue #350) is DEFAULT-ON via its tri-state\n\t// Enabled pointer (see HighSeverityReproducerGradeCheckConfig). It is the\n\t// evidence-grade GATE on high/critical-severity OR CVE-surface\n\t// KnownIssues: severity_basis must be `reproducer` AND \u22651 evidence_manifests\n\t// entry must resolve on disk. Unlike known_issue_complete (honest-amber\n\t// warning), this is a release-blocking ERROR per the auditor doctrine\n\t// (#347) \u2014 a high-stakes claim shall not rest on static analysis alone.\n\t// Set `enabled: false` to opt out (transitional only).\n\tHighSeverityReproducerGrade HighSeverityReproducerGradeCheckConfig `yaml:\"high_severity_reproducer_grade,omitempty\" json:\"high_severity_reproducer_grade,omitempty\"`\n\t// DisclosureSafe (issue #349) is DEFAULT-ON via its tri-state Enabled\n\t// pointer (see DisclosureSafeCheckConfig). It is the deterministic\n\t// responsible-disclosure GATE: when any active KnownIssue carries an\n\t// effective `disclosure: private` (or under-embargo) posture AND any\n\t// configured git remote is publicly visible, the check REFUSES the audit.\n\t// Severity ERROR per the auditor doctrine (#347) \u2014 letting a `private`\n\t// KI leak to a public remote is the false-confidence outcome the\n\t// assurance program exists to prevent. Set `enabled: false` to opt out\n\t// (transitional only \u2014 the check goes silent and `private` KIs may\n\t// then leak).\n\tDisclosureSafe DisclosureSafeCheckConfig `yaml:\"disclosure_safe,omitempty\" json:\"disclosure_safe,omitempty\"`\n\t// RoleReferencesResolve gates the role_references_resolve check (issue #204),\n\t// which asserts every machine-checkable reference each installed role declares\n\t// \u2014 the check-ids its exit condition drives, the `proof help` topics it cites,\n\t// and the requirement ids it documents \u2014 resolves to a real check/topic/req.\n\t// A dangling reference would silently mislead an agent following the role, so\n\t// the check is DEFAULT-ON via its tri-state Enabled pointer: nil/true keep it\n\t// on; only an explicit `enabled: false` opts out.\n\tRoleReferencesResolve RoleReferencesResolveCheckConfig `yaml:\"role_references_resolve,omitempty\" json:\"role_references_resolve,omitempty\"`\n\t// ProblemReportClassMitigationEvidence gates the\n\t// problem_report_class_mitigation_evidence check (SW-REQ-260701-ZFHW). It\n\t// requires DEFECTs with a mitigated disposition (covered_by_requirement)\n\t// that add an obligation via hardening.added_obligations to bind at least\n\t// one of: an mcdc_witnesses entry (proves the obligation is exercised) OR\n\t// a project signal-rule (project.signals.rule_packs) whose\n\t// metadata.proof.obligations lists the same class (statically detects\n\t// future occurrences). The check ALSO surfaces an INFO-LEVEL nudge when\n\t// `hardening.sibling_sweep` is absent on a mitigated disposition \u2014\n\t// fixing/registering one instance says nothing about other live instances\n\t// of the anti-pattern. Default-on via tri-state; set `enabled: false` to\n\t// opt out.\n\tProblemReportClassMitigationEvidence ProblemReportClassMitigationEvidenceCheckConfig `yaml:\"problem_report_class_mitigation_evidence,omitempty\" json:\"problem_report_class_mitigation_evidence,omitempty\"`\n\t// DecompositionAddsRefinement (issue #367) policy for the\n\t// spec_lint_decomposition_adds_refinement check. SimilarityThreshold\n\t// overrides the default token-set Jaccard threshold (0.85) used to flag a\n\t// child requirement whose authored FRETish + description restates a parent\n\t// near-verbatim. Out-of-range values (<= 0 or > 1) fall back to the default.\n\tDecompositionAddsRefinement DecompositionAddsRefinementCheckConfig `yaml:\"decomposition_adds_refinement,omitempty\" json:\"decomposition_adds_refinement,omitempty\"`\n\t// HazardReviewCurrent (issue #377) gates the hazard_review_current\n\t// spec lint that surfaces requirements whose hazard_review block is\n\t// stale, drifts from the project's effective catalog version, has\n\t// incomplete category coverage, or carries the bad-smell \"every\n\t// category not_applicable\" pattern. The check is DEFAULT-ON; absence\n\t// of a hazard_review block is treated as \"pending initial hazard\n\t// analysis\" and reported as a single project-level summary finding\n\t// (not per-requirement) so existing corpora upgrading to v1.1.0 of\n\t// the catalog do not see a warning storm.\n\tHazardReviewCurrent HazardReviewCurrentCheckConfig `yaml:\"hazard_review_current,omitempty\" json:\"hazard_review_current,omitempty\"`\n\t// HazardConsequence (SYS-REQ-260705-HZRD) gates the hazard_consequence\n\t// spec lint that enforces the obligation_hazards data contract. The\n\t// check is DEFAULT-ON; absence of the obligation_hazards block is\n\t// reported as a single project-level INFO summary finding (never per-\n\t// requirement) so existing corpora upgrading to the v1 schema do not\n\t// see a warning storm. Malformed-when-present entries surface per-req\n\t// findings. Severity is authored-only \u2014 no catalog fallback.\n\tHazardConsequence HazardConsequenceCheckConfig `yaml:\"hazard_consequence,omitempty\" json:\"hazard_consequence,omitempty\"`\n\t// PropertyBasedTestCoverage (issue #383, SYS-REQ-260627-FN1F) gates the\n\t// property_based_test_coverage check. Severity is the override knob:\n\t// projects can promote the default warning to error once they have\n\t// finished annotating their pure-function surface. The check operates on\n\t// the project's verification scope (no separate include/exclude block of\n\t// its own).\n\tPropertyBasedTestCoverage PropertyBasedTestCoverageCheckConfig `yaml:\"property_based_test_coverage,omitempty\" json:\"property_based_test_coverage,omitempty\"`\n\t// MirrorComplete (SYS-REQ-260701-MRR1) gates the mirror_complete check.\n\t// A Mirror declares that a target file-set must reproduce the\n\t// verification ledger of a source file-set for every requirement in\n\t// scope, across the enabled dimensions. Severity is derived from each\n\t// Mirror's own `status` \u2014 planned=info, in_progress=warn (never\n\t// promoted under audit.evidence_strict), complete=error. This tri-state\n\t// pointer is the master enable/disable: nil/true => on for any declared\n\t// mirror; explicit false => the check is skipped entirely.\n\tMirrorComplete MirrorCompleteCheckConfig `yaml:\"mirror_complete,omitempty\" json:\"mirror_complete,omitempty\"`\n\t// MirrorStale (SYS-REQ-260925-VETQ) gates the mirror_stale check: when\n\t// a declared Mirror's source (or target) file-set CONTENT changes\n\t// without a new annotation cell, mirror_complete stays green \u2014 the cell\n\t// sets are unchanged. mirror_stale closes that hole by requiring a\n\t// reaffirmation record (proof/mirrors/affirmations/<MIR-id>.yaml,\n\t// written by `proof mirror reaffirm`) whose stored source/target content\n\t// digests match the live file-sets. Who may write that record is the\n\t// project's approval policy (project.approval), read against the most\n\t// restrictive assurance level the mirror governs. Same tri-state semantics as\n\t// MirrorComplete: nil/true => on, explicit false => skipped entirely.\n\tMirrorStale MirrorStaleCheckConfig `yaml:\"mirror_stale,omitempty\" json:\"mirror_stale,omitempty\"`\n\t// DifferentialConformance (differential-conformance Phase 1) gates the\n\t// differential_conformance check: fixture-driven cross-implementation\n\t// behavioral parity.\n\tDifferentialConformance DifferentialConformanceCheckConfig `yaml:\"differential_conformance,omitempty\" json:\"differential_conformance,omitempty\"`\n\t// PoCQualityChecked (ACC-15) gates the poc_quality_checked audit check.\n\t// MinSeverity overrides the default severity threshold (\"medium\"); a KI\n\t// is in scope when ANY of its severity / code_severity / bounty_severity\n\t// fields meets or exceeds MinSeverity. Accepted values:\n\t// informational | low | medium | high | critical. Empty/invalid falls\n\t// back to \"medium\".\n\tPoCQualityChecked PoCQualityCheckedCheckConfig `yaml:\"poc_quality_checked,omitempty\" json:\"poc_quality_checked,omitempty\"`\n\t// DeploymentTvlVerified (ACC-09) gates the deployment_tvl_verified audit\n\t// check. The check auto-detects Web3/DeFi projects and is ENABLED-ONLY\n\t// for those by default; non-Web3 projects (Go web servers, Rust CLIs,\n\t// etc.) get a silent pass unless the project explicitly opts in via\n\t// `enabled: true`. Tri-state Enabled pointer:\n\t//   - nil  -> auto-detect (run for Web3 projects, skip for non-Web3)\n\t//   - *true  -> always run (force-on override for non-Web3 projects)\n\t//   - *false -> always skip (force-off override)\n\tDeploymentTvlVerified DeploymentTvlVerifiedCheckConfig `yaml:\"deployment_tvl_verified,omitempty\" json:\"deployment_tvl_verified,omitempty\"`\n\t// ObligationWitnessGrounded (issue #866, SYS-REQ-260710-8W6G) gates the\n\t// obligation_witness_grounded check: a coverage-trackable obligation\n\t// witness must execute \u22651 line of its requirement's implemented_by code\n\t// (coverage-intersection), refusing annotation-theater. Enabled is a\n\t// tri-state pointer (nil/true => default-on, explicit false => opt out);\n\t// Severity promotes the default warning to error once a corpus is clean.\n\tObligationWitnessGrounded ObligationWitnessGroundedCheckConfig `yaml:\"obligation_witness_grounded,omitempty\" json:\"obligation_witness_grounded,omitempty\"`\n\t// ObligationEvidenceComplete (issue #294) gates the\n\t// obligation_evidence_complete audit check. Its Enabled tri-state pointer\n\t// is the escape hatch for the Go-only language-constrained evidence\n\t// auto-relaxation: a class that declares `language_constraints` (today only\n\t// `invariant_preservation`, whose `lemma` evidence is discharged by the\n\t// Go-only prover at pkg/lemma/prover/) has its language-bound evidence\n\t// requirement DROPPED on a non-Go implementing context, since it is\n\t// categorically impossible to author there. An explicit\n\t// `enabled: true` forces the full requirement (lemma stays required) on\n\t// every implementing context, including non-Go ones.\n\t//   - nil    -> auto-relax language-bound evidence on non-matching languages\n\t//   - *true  -> always require it (force-on override)\n\t//   - *false -> same as nil for the relaxation (the check itself is toggled\n\t//               via project.checks.disabled, not here)\n\tObligationEvidenceComplete ObligationEvidenceCompleteCheckConfig `yaml:\"obligation_evidence_complete,omitempty\" json:\"obligation_evidence_complete,omitempty\"`\n\t// The three spec-corpus lints below are OPT-IN (disabled by default;\n\t// see the disabledByDefaultDescriptor entries in\n\t// specLintDescriptorOverrides at pkg/workflow/check_descriptors.go).\n\t// They are corpus-health metrics rather than work queues \u2014 on the\n\t// corpus they were measured against they flag roughly one requirement\n\t// in six (the two property-disposition lints) and one in ten (the\n\t// mediation lint), and the two property lints also read the traced\n\t// source of every requirement they judge. These slots are the opt-in:\n\t// `enabled: true` turns the check on. They are keyed by the FULL\n\t// workflow check id (`spec_lint_*`) because the generic enablement\n\t// resolver (workflow.checkEnabledOverride) matches the check id\n\t// against these yaml tags.\n\t//\n\t// SYS-REQ-260815-NAPC AC-005, SYS-REQ-260815-NAEV, SYS-REQ-260815-MEDC AC-006\n\tSpecLintNADeniesPropertyTheCodeManages   FixturePolicyCheckConfig `yaml:\"spec_lint_na_denies_property_the_code_manages,omitempty\" json:\"spec_lint_na_denies_property_the_code_manages,omitempty\"`\n\tSpecLintNADeniesPropertyEnforcedUnevenly FixturePolicyCheckConfig `yaml:\"spec_lint_na_denies_property_enforced_unevenly,omitempty\" json:\"spec_lint_na_denies_property_enforced_unevenly,omitempty\"`\n\tSpecLintMediationContractContradicted    FixturePolicyCheckConfig `yaml:\"spec_lint_mediation_contract_contradicted,omitempty\" json:\"spec_lint_mediation_contract_contradicted,omitempty\"`\n\t// KnownIssueTextHygiene configures the six deterministic KnownIssue\n\t// prose/ledger lints (spec_lint_ki_*): banned prose markers, the open-\n\t// actionability rune floor, and per-KI exemptions with automatic expiry.\n\t// See KnownIssueTextHygieneConfig \u2014 every default is zero-config sensible,\n\t// so an absent block leaves all six checks running with built-in\n\t// thresholds. The unmirrored-residual codec overlay (SYS-REQ-260720-FEDP)\n\t// loads and round-trips this subtree without a hand-written codec arm.\n\tKnownIssueTextHygiene KnownIssueTextHygieneConfig `yaml:\"known_issue_text_hygiene,omitempty\" json:\"known_issue_text_hygiene,omitempty\"`\n\t// ThreatSurface preserves project.checks.threat_surface policy from the\n\t// threat-surface synthesis phase (Phase 2): declared profile/oracle-family\n\t// arming with equivalence-contract references, ladder na_reasons, and\n\t// vector-campaign closure deferrals. Zero value = disabled/silent.\n\tThreatSurface ThreatSurfaceConfig `yaml:\"threat_surface,omitempty\" json:\"threat_surface,omitempty\"`\n\t// RequirementsTextHygiene is the requirement-side sibling section: it\n\t// steers spec_lint_prose_ste100 over requirement subjects \u2014 the ASD-STE100 structural prose scan over\n\t// description/rationale/stakeholder story/acceptance-criterion text. The\n\t// nested Ste100 pointer follows the same pointer-section pattern as the\n\t// tri-state check configs: nil = disabled (adoption opt-in), non-nil with\n\t// enabled: true = every rule on with built-in defaults. Like the KI block,\n\t// it round-trips through the unmirrored-residual codec overlay without a\n\t// hand-written codec arm.\n\tRequirementsTextHygiene RequirementsTextHygieneConfig `yaml:\"requirements_text_hygiene,omitempty\" json:\"requirements_text_hygiene,omitempty\"`\n\t// ProseTextHygiene is the GENERIC prose-scan section: it gates\n\t// spec_lint_prose_ste100, the ASD-STE100 structural scan over EVERY\n\t// prose-bearing governance object (known issues, requirements, problem\n\t// reports, changes, concerns, accepted risks, manual evidence, mirrors,\n\t// vectors) via the Ste100Subject adapters. The nested Ste100 pointer\n\t// follows the same pointer-section pattern as the sibling hygiene\n\t// blocks: nil = enabled with built-in defaults (DEFAULT-ON), an\n\t// explicit `disabled: true` opts out. The block is independent of\n\t// known_issue_text_hygiene.ste100 / requirements_text_hygiene.ste100 \u2014\n\t// those gate only their own per-type checks. The unmirrored-residual\n\t// codec overlay loads and round-trips this subtree without a\n\t// hand-written codec arm.\n\tProseTextHygiene ProseTextHygieneConfig `yaml:\"prose_text_hygiene,omitempty\" json:\"prose_text_hygiene,omitempty\"`\n\tDisabled         []string               `yaml:\"disabled,omitempty\" json:\"disabled,omitempty\"`\n}\n\n"
        }
      ]
    },
    {
      "path": "pkg/workflow/workflow.go",
      "sha256": "7ad6058e35ce103368c6d8524f9ccd1965bc5c02b3e8219b0b33eadcf22aa24b",
      "bytes": 654675,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1028,
          "end_line": 1069,
          "text": "\t\t\tskipCheck(idx, check, CheckResult{\n\t\t\t\tName:       check.Name(),\n\t\t\t\tStatus:     \"skip\",\n\t\t\t\tSeverity:   check.Severity(),\n\t\t\t\tSummary:    summary,\n\t\t\t\tSkipReason: summary,\n\t\t\t})\n\t\t\tcontinue\n\t\t}\n\n\t\t// Check mode-based skip policy before queueing the check.\n\t\tif IsCheckSkippedByMode(cfg.Mode, stage, check.Name()) {\n\t\t\tskipCheck(idx, check, CheckResult{\n\t\t\t\tName:       check.Name(),\n\t\t\t\tStatus:     \"skip\",\n\t\t\t\tSeverity:   check.Severity(),\n\t\t\t\tSummary:    fmt.Sprintf(\"skipped (%s mode -- %s)\", string(cfg.Mode), ModeSkipExplanation(cfg.Mode, stage, check.Name())),\n\t\t\t\tSkipReason: SkipReasonForMode(cfg.Mode, stage),\n\t\t\t})\n\t\t\tcontinue\n\t\t}\n\n\t\tif cr, skipped := userSkippedCheckResult(cfg.SkipChecks, check.Name(), check.Severity()); skipped {\n\t\t\tskipCheck(idx, check, cr)\n\t\t\tcontinue\n\t\t}\n\t\tpending = append(pending, stageCheckTask{index: idx, check: check})\n\t}\n\n\t// SYS-REQ-1085: a check whose verdict the audit cache gives when the\n\t// check is due may not run at all. Only the checks that surely run\n\t// decide the shared MC/DC test run and the stage prewarm, so a verdict\n\t// that the cache then serves costs no extra work and changes no\n\t// evidence the run writes.\n\tsurelyRun := pending\n\tif cfg.DueLookup != nil {\n\t\tsurelyRun = make([]stageCheckTask, 0, len(pending))\n\t\tfor _, task := range pending {\n\t\t\tif !cfg.DueLookup.defers(task.check.Name()) {\n\t\t\t\tsurelyRun = append(surelyRun, task)\n\t\t\t}\n\t\t}\n"
        },
        {
          "start_line": 1259,
          "end_line": 1284,
          "text": "\n\tresult.Checks = results\n\n\t// Compute stage status.\n\tfor _, cr := range result.Checks {\n\t\tswitch cr.Status {\n\t\tcase \"fail\":\n\t\t\tif cr.Severity == SeverityError {\n\t\t\t\tresult.Errors++\n\t\t\t} else {\n\t\t\t\tresult.Warnings++\n\t\t\t}\n\t\tcase \"warn\":\n\t\t\tresult.Warnings++\n\t\t}\n\t}\n\n\tswitch {\n\tcase result.Errors > 0:\n\t\tresult.Status = \"fail\"\n\tcase result.Warnings > 0:\n\t\tresult.Status = \"warn\"\n\tdefault:\n\t\tresult.Status = \"pass\"\n\t}\n\tresult.CanAdvance = canAdvanceForCounts(result.Errors, result.Warnings, result.FailLevel)\n"
        },
        {
          "start_line": 1561,
          "end_line": 1578,
          "text": "// ExitCodeForStage returns the exit code implied by the stage result and the\n// active workflow fail-level policy.\n// SYS-REQ-702\nfunc ExitCodeForStage(result *StageResult, failLevel string) int {\n\tif result == nil {\n\t\treturn 0\n\t}\n\tif result.Errors > 0 {\n\t\treturn 1\n\t}\n\tif result.Warnings > 0 && warningsBlockAdvancement(failLevel) {\n\t\treturn 2\n\t}\n\treturn 0\n}\n\n// BlockingIssueSummary describes the issue counts currently preventing stage\n// advancement.\n"
        },
        {
          "start_line": 1870,
          "end_line": 1920,
          "text": "// When cfg.Quick is true, returns only the fast checks for tight iteration loops.\n// Implements: SYS-REQ-701\nfunc checksForStage(stage Stage, cfg *WorkflowConfig) []Check {\n\tvar checks []Check\n\tif cfg != nil && cfg.Quick {\n\t\tchecks = quickChecksForStage(stage, cfg)\n\t} else {\n\t\tswitch stage {\n\t\tcase StageSpec:\n\t\t\tchecks = specChecks(cfg)\n\t\tcase StageImplement:\n\t\t\tchecks = implementChecks(cfg)\n\t\tcase StageVerify:\n\t\t\tchecks = verifyChecks(cfg)\n\t\tcase StageDocument:\n\t\t\tchecks = documentChecks(cfg)\n\t\tdefault:\n\t\t\tchecks = nil\n\t\t}\n\t}\n\treturn filterChecksBySelection(checks, cfg)\n}\n\n// Implements: SW-REQ-174\nfunc filterChecksBySelection(checks []Check, cfg *WorkflowConfig) []Check {\n\tif cfg == nil {\n\t\treturn checks\n\t}\n\tif len(cfg.OnlyChecks) == 0 {\n\t\treturn checks\n\t}\n\tif len(checks) == 0 {\n\t\treturn checks\n\t}\n\tallowed := make(map[string]struct{}, len(cfg.OnlyChecks))\n\tfor _, name := range cfg.OnlyChecks {\n\t\tname = strings.TrimSpace(name)\n\t\tif name != \"\" {\n\t\t\tallowed[name] = struct{}{}\n\t\t}\n\t}\n\tif len(allowed) == 0 {\n\t\treturn checks\n\t}\n\tfiltered := make([]Check, 0, len(checks))\n\tfor _, check := range checks {\n\t\tif _, ok := allowed[check.Name()]; ok {\n\t\t\tfiltered = append(filtered, check)\n\t\t}\n\t}\n\treturn filtered\n"
        },
        {
          "start_line": 2487,
          "end_line": 2507,
          "text": "\t}\n\t// Per-level requirement checks run after basic checks.\n\tchecks = append(checks,\n\t\t&l0StakeholderCompleteCheck{},\n\t\t&l1SystemCompleteCheck{},\n\t\t&obligationCompletenessCheck{},\n\t\t&obligationBaselineCheck{},              // catalog M3\n\t\t&obligationSuppressionRationaleCheck{},  // catalog M3\n\t\t&obligationSuppressionReviewerCheck{},   // catalog M3\n\t\t&obligationDelegationResolvesCheck{},    // DEFECT-260630-Q800 follow-up\n\t\t&catalogVersionPinnedCheck{},            // catalog M7 Phase C\n\t\t&catalogCompletenessCheck{},             // issue #386 \u2014 drift between proof.yaml obligation_classes, catalog, signal rules, and req checklists\n\t\t&obligationEnforcementBackedCheck{},     // issue #1019 \u2014 cataloged checklist items with no signal rule and no evidence (silent no-ops)\n\t\t&documentedClaimVerifiedCheck{},         // issue #1019 Feature #9 \u2014 documented claim evidence cells (man/godoc/NatSpec)\n\t\t&catalogSemanticBindingsReviewedCheck{}, // semantic-scan adoption: every flagged match must be bound or explicitly rejected\n\t\t&systemFormalizationCompleteCheck{},     // see SYS-REQ-862\n\n\t\t&l2SoftwareCompleteCheck{},\n\t\t&sysHasSoftwareChildCheck{},\n\t\t&traceBypassesDecompositionCheck{}, // SW-REQ-261004-TBDC: traced is not specified\n\t\t&levelsConnectedCheck{},\n"
        }
      ]
    },
    {
      "path": "pkg/workflow/config.go",
      "sha256": "257d57877f43018cf8247b9f636b95fbdf683e82583376d31ef090d5b88388d6",
      "bytes": 54387,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 896,
          "end_line": 985,
          "text": "func IsCheckListedDisabled(checks model.ProjectChecksConfig, checkName string) bool {\n\tfor _, name := range checks.Disabled {\n\t\tif name == checkName {\n\t\t\treturn true\n\t\t}\n\t}\n\treturn false\n}\n\n// Implements: SYS-REQ-260720-FEDP\nfunc IsCheckDisabledByPolicy(checks model.ProjectChecksConfig, checkName string) bool {\n\tif IsCheckListedDisabled(checks, checkName) {\n\t\treturn true\n\t}\n\t// Per-check explicit `enabled: false` opt-out for default-on checks\n\t// that carry a tri-state Enabled pointer. Without this gate the\n\t// per-check config slot is silently ignored \u2014 issue #454 surfaced\n\t// the bug for property_based_test_coverage: setting\n\t//   project.checks.property_based_test_coverage:\n\t//     enabled: false\n\t// did NOT suppress the check, leaving auditors unable to opt out of\n\t// a check that emits misleading output on a corpus the enumerator\n\t// cannot see.\n\t//\n\t// Every check with a tri-state `enabled:` key goes through this arm,\n\t// including the ones that ALSO short-circuit inside their own Run()\n\t// (CheckManagesOwnEnablement). One user intent \u2014 \"do not run this check\" \u2014\n\t// must produce one status, and a check that evaluated nothing reports\n\t// `skip`, never `pass`: `pass` asserts \"I checked this and it is fine\",\n\t// which a switched-off check has not established. The check-specific\n\t// wording those checks used to carry is not lost \u2014 it lives in the\n\t// descriptor catalog (CheckDisabledSummary) and is emitted with the skip.\n\tif isCheckExplicitlyDisabled(checks, checkName) {\n\t\treturn true\n\t}\n\t// Disabled-by-default checks (e.g. property_fixtures_exist,\n\t// flip_fixtures_exist, fixture_staleness_clean,\n\t// code_signal_obligations_reviewed) are skipped\n\t// unless the project explicitly opts in via\n\t// project.checks.<check>.enabled = true.\n\tif IsCheckDisabledByDefault(checkName) && !isCheckExplicitlyEnabled(checks, checkName) {\n\t\treturn true\n\t}\n\treturn false\n}\n\n// checkEnabledOverride reports the project's explicit `enabled:` setting for a\n// check, resolved GENERICALLY: the check id is matched against the yaml tags of\n// model.ProjectChecksConfig and the matching policy struct's `Enabled` field is\n// read. Hand-written switches over check ids were the previous mechanism and\n// they drifted \u2014 a check would document `proof config set\n// project.checks.<id>.enabled true` in its own help output while the switch\n// never listed it, so the setting did nothing.\n//\n// The second return value distinguishes \"the project said something\" from\n// \"unset\":\n//   - Enabled *bool (tri-state, default-on checks): nil => unset; otherwise the\n//     pointee is the explicit value.\n//   - Enabled bool (opt-in checks): true => explicit opt-in; false is the zero\n//     value and therefore indistinguishable from unset, so it is NOT explicit.\n//\n// Implements: SYS-REQ-260720-FEDP\nfunc checkEnabledOverride(checks model.ProjectChecksConfig, checkName string) (bool, bool) {\n\tv := reflect.ValueOf(checks)\n\tt := v.Type()\n\tfor i := 0; i < t.NumField(); i++ {\n\t\ttag := t.Field(i).Tag.Get(\"yaml\")\n\t\tif strings.Split(tag, \",\")[0] != checkName {\n\t\t\tcontinue\n\t\t}\n\t\tfield := v.Field(i)\n\t\tif field.Kind() != reflect.Struct {\n\t\t\treturn false, false\n\t\t}\n\t\tenabled := field.FieldByName(\"Enabled\")\n\t\tif !enabled.IsValid() {\n\t\t\treturn false, false\n\t\t}\n\t\tswitch enabled.Kind() {\n\t\tcase reflect.Bool:\n\t\t\treturn enabled.Bool(), enabled.Bool()\n\t\tcase reflect.Pointer:\n\t\t\tif enabled.IsNil() || enabled.Elem().Kind() != reflect.Bool {\n\t\t\t\treturn false, false\n\t\t\t}\n\t\t\treturn enabled.Elem().Bool(), true\n\t\t}\n\t\treturn false, false\n\t}\n\treturn false, false\n"
        }
      ]
    },
    {
      "path": "pkg/workflow/check_descriptors.go",
      "sha256": "762fdc944b0e5a14434b59065553a9a2124b7e77db46c534576e8a8d30955965",
      "bytes": 263611,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 2108,
          "end_line": 2115,
          "text": "\t// documented_claim_verified (issue #1019 Feature #9): reads per-req\n\t// documented_behaviors cells (DependencySpecSemantics) and grounds\n\t// documented_in / test_ref paths on disk (DependencyCode for source\n\t// docs and DependencyTests for test_ref). Opt-in via declaring\n\t// documented_behaviors; default-on WARN once claims are present.\n\t// No proof.yaml config keys \u2014 skip gate is empty documented_behaviors.\n\t\"documented_claim_verified\": descriptor(CachePolicyPlanned, DependencySpecContent, DependencyCode, DependencyTests),\n\t// catalog_semantic_bindings_reviewed reads the committed\n"
        }
      ]
    },
    {
      "path": "pkg/repo/manifest_checks_access.go",
      "sha256": "cb39cf99ba0f485cf7fae930b1923a6a6930f8eefb84548f651ca7bad05117ea",
      "bytes": 5788,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1,
          "end_line": 164,
          "text": "// Implements: SYS-REQ-260720-FEDP\npackage repo\n\nimport (\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"reflect\"\n\t\"strconv\"\n\t\"strings\"\n\n\t\"gopkg.in/yaml.v3\"\n\n\t\"github.com/probelabs/proof/pkg/model\"\n)\n\n// `proof config get|set project.checks.<id>...` dispatches through a\n// hand-written switch in cmd/proof \u2014 a THIRD copy of the `project.checks`\n// schema, alongside the model and the codec mirror. It drifted the same way\n// the codec did: `proof config set project.checks.disclosure_safe.enabled\n// false` failed with `unknown checks key \"disclosure_safe\"` even though the\n// check documents that exact key and the loader honors it when hand-authored.\n//\n// The two functions below are the generic fallback for that switch: they\n// resolve a dotted `project.checks` path against model.ProjectChecksConfig's\n// own yaml tags, at any depth. The hand-written arms stay FIRST because they\n// carry per-key validation and normalization (enum checks, CSV parsing); these\n// take over only where there is no arm, which is exactly where a key would\n// otherwise be rejected for existing.\n\n// checksPathError is the shared \"no such key\" error. The wording matches the\n// hand-written arms so callers and tests see one message.\nfunc checksPathError(path []string) error {\n\treturn fmt.Errorf(\"unknown checks key %q\", strings.Join(path, \".\"))\n}\n\n// resolveChecksPath walks path into v by yaml tag and returns the leaf value.\n// alloc controls whether nil pointers along the way are materialized (set) or\n// terminate the walk (get).\nfunc resolveChecksPath(v reflect.Value, path []string, alloc bool) (reflect.Value, error) {\n\tfor i, segment := range path {\n\t\tfor v.Kind() == reflect.Pointer {\n\t\t\tif v.IsNil() {\n\t\t\t\tif !alloc || !v.CanSet() {\n\t\t\t\t\treturn reflect.Value{}, checksPathError(path[:i])\n\t\t\t\t}\n\t\t\t\tv.Set(reflect.New(v.Type().Elem()))\n\t\t\t}\n\t\t\tv = v.Elem()\n\t\t}\n\t\tif v.Kind() != reflect.Struct {\n\t\t\treturn reflect.Value{}, checksPathError(path[:i+1])\n\t\t}\n\t\tidx := fieldIndexByYAMLKey(v.Type(), segment)\n\t\tif idx < 0 {\n\t\t\treturn reflect.Value{}, checksPathError(path[:i+1])\n\t\t}\n\t\tv = v.Field(idx)\n\t}\n\treturn v, nil\n}\n\n// SetProjectChecksValue sets the `project.checks.<path>` leaf named by path\n// (yaml-tag segments, e.g. [\"disclosure_safe\", \"enabled\"]) from its string\n// form. It returns an \"unknown checks key\" error when the model does not\n// represent the path, so a typo is still rejected \u2014 only keys that genuinely\n// exist start working.\nfunc SetProjectChecksValue(cfg *model.ProjectChecksConfig, path []string, value string) error {\n\tif cfg == nil || len(path) == 0 {\n\t\treturn checksPathError(path)\n\t}\n\tleaf, err := resolveChecksPath(reflect.ValueOf(cfg).Elem(), path, true)\n\tif err != nil {\n\t\treturn err\n\t}\n\tif !leaf.CanSet() {\n\t\treturn checksPathError(path)\n\t}\n\treturn setLeafFromString(leaf, value, strings.Join(path, \".\"))\n}\n\n// setLeafFromString assigns value to leaf, converting by the leaf's kind.\n// Compound leaves (maps, structs, slices) accept a YAML or JSON payload \u2014\n// JSON is a subset of YAML, so one decode covers both.\nfunc setLeafFromString(leaf reflect.Value, value, key string) error {\n\tif leaf.Kind() == reflect.Pointer {\n\t\tif leaf.IsNil() {\n\t\t\tleaf.Set(reflect.New(leaf.Type().Elem()))\n\t\t}\n\t\treturn setLeafFromString(leaf.Elem(), value, key)\n\t}\n\tswitch leaf.Kind() {\n\tcase reflect.Bool:\n\t\tb, err := strconv.ParseBool(strings.TrimSpace(value))\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"invalid boolean value %q for project.checks.%s\", value, key)\n\t\t}\n\t\tleaf.SetBool(b)\n\tcase reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:\n\t\tn, err := strconv.ParseInt(strings.TrimSpace(value), 10, 64)\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"invalid integer value %q for project.checks.%s\", value, key)\n\t\t}\n\t\tleaf.SetInt(n)\n\tcase reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:\n\t\tn, err := strconv.ParseUint(strings.TrimSpace(value), 10, 64)\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"invalid integer value %q for project.checks.%s\", value, key)\n\t\t}\n\t\tleaf.SetUint(n)\n\tcase reflect.Float32, reflect.Float64:\n\t\tf, err := strconv.ParseFloat(strings.TrimSpace(value), 64)\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"invalid number value %q for project.checks.%s\", value, key)\n\t\t}\n\t\tleaf.SetFloat(f)\n\tcase reflect.String:\n\t\tleaf.SetString(value)\n\tdefault:\n\t\tfresh := reflect.New(leaf.Type())\n\t\tif err := yaml.Unmarshal([]byte(value), fresh.Interface()); err != nil {\n\t\t\treturn fmt.Errorf(\"invalid value %q for project.checks.%s: %w\", value, key, err)\n\t\t}\n\t\tleaf.Set(fresh.Elem())\n\t}\n\treturn nil\n}\n\n// GetProjectChecksValue returns the printable form of the\n// `project.checks.<path>` leaf: scalars bare (so shell pipelines keep working),\n// everything else as JSON \u2014 the convention `proof config get` already follows\n// for compound values.\nfunc GetProjectChecksValue(cfg model.ProjectChecksConfig, path []string) (string, error) {\n\tif len(path) == 0 {\n\t\treturn \"\", checksPathError(path)\n\t}\n\tleaf, err := resolveChecksPath(reflect.ValueOf(&cfg).Elem(), path, false)\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\tfor leaf.Kind() == reflect.Pointer {\n\t\tif leaf.IsNil() {\n\t\t\treturn \"\", nil\n\t\t}\n\t\tleaf = leaf.Elem()\n\t}\n\tswitch leaf.Kind() {\n\tcase reflect.Bool:\n\t\treturn strconv.FormatBool(leaf.Bool()), nil\n\tcase reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:\n\t\treturn strconv.FormatInt(leaf.Int(), 10), nil\n\tcase reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:\n\t\treturn strconv.FormatUint(leaf.Uint(), 10), nil\n\tcase reflect.Float32, reflect.Float64:\n\t\treturn strconv.FormatFloat(leaf.Float(), 'g', -1, 64), nil\n\tcase reflect.String:\n\t\treturn leaf.String(), nil\n\tdefault:\n\t\tdata, err := json.Marshal(leaf.Interface())\n\t\tif err != nil {\n\t\t\treturn \"\", checksPathError(path)\n\t\t}\n\t\treturn string(data), nil\n\t}\n}\n"
        }
      ]
    },
    {
      "path": "cmd/proof/config.go",
      "sha256": "df70711a707575414ace589dc0f50a53c68cff7cd53126c794312a85f168f98c",
      "bytes": 88236,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 867,
          "end_line": 874,
          "text": "\t\t}\n\t\t// No hand-written arm: resolve the key against\n\t\t// model.ProjectChecksConfig itself, so a documented per-check policy\n\t\t// is readable the moment its model field exists.\n\t\treturn repo.GetProjectChecksValue(cfg.Checks, strings.Split(strings.Join(parts[1:], \".\"), \".\"))\n\tcase \"workflow\":\n\t\t// proof:domain-exempt: structural arity/length guard on parsed input before indexing; not a requirement-domain quantity\n\t\tif len(parts) < 2 {\n"
        },
        {
          "start_line": 1757,
          "end_line": 1766,
          "text": "\t\t\t}\n\t\tdefault:\n\t\t\t// No hand-written arm: resolve the key against\n\t\t\t// model.ProjectChecksConfig itself. A per-check policy is\n\t\t\t// therefore settable the moment its model field exists, and a\n\t\t\t// key the model does not represent is still rejected.\n\t\t\treturn repo.SetProjectChecksValue(&cfg.Checks, append([]string{parts[1]}, strings.Split(parts[2], \".\")...), value)\n\t\t}\n\tcase \"workflow\":\n\t\t// proof:domain-exempt: structural arity/length guard on parsed input before indexing; not a requirement-domain quantity\n"
        }
      ]
    },
    {
      "path": "cmd/proof/audit.go",
      "sha256": "fb5283e5d7911c80bbca46860156e8f1f907655633574842d7fbd9326a097f90",
      "bytes": 96934,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 160,
          "end_line": 179,
          "text": "\tauditCmd.Flags().StringVar(&auditFormat, \"format\", \"table\", \"Output format: table|json|markdown. Unscoped audits normally emit newline-delimited JSON events (JSONL: one stage_start/check_start/check_done object per line, then one final audit_done object with totals and exit status); parse line-by-line. With --only <REQ-ID>, JSON is a single pretty-printed result document with only_scope; parse the whole document, not JSONL. Active mutes emit a single compact result object instead of event records. Only JSON is written to stdout; human Help/Next trailers are suppressed.\")\n\tauditCmd.Flags().StringVar(&auditFailLevel, \"fail-level\", \"warn\", \"Severity threshold for non-zero exit: error|warn|info\")\n\tauditCmd.Flags().StringVar(&auditScope, \"scope\", string(audit.ScopeFull), \"Audit scope: full (every active requirement) | baseline (narrow coverage_threshold + documentation_coverage to requirements whose fingerprint changed since the captured baseline; activate deletion_without_retirement)\")\n\tauditCmd.Flags().StringVar(&auditBaseRef, \"base\", \"\", \"Base git ref of this run. The branch-diff checks (authored_delta_expected, changed_requirements_reviewed, description_delta_reviewed and the other checks that compare HEAD with a base) compare HEAD with the merge-base of this ref and HEAD; it overrides project.workflow.base_branch for this run. With --scope baseline and no .proof/workflow.json baseline, the requirement baseline is also captured at that merge-base\")\n\tauditCmd.Flags().BoolVar(&auditVerbose, \"verbose\", false, \"Show every detail row of every check. Without it, the stage section lists at most 10 rows per check and the Findings section at most --max-findings rows (default 3)\")\n\tauditCmd.Flags().StringArrayVar(&auditProfiles, \"profile\", nil, \"Named project.profiles entry to apply before explicit --set overrides (repeatable)\")\n\tauditCmd.Flags().StringArrayVar(&auditOverrides, \"set\", nil, \"Temporary config override key=value (repeatable)\")\n\tauditCmd.Flags().StringArrayVar(&auditVerificationScope, \"verification-scope\", nil, \"Temporary verification-scope include override for this run only (repeatable or comma-separated); does not affect audit --scope full|baseline\")\n\tauditCmd.Flags().StringArrayVar(&auditMCDCCoverageRequirements, \"mcdc-coverage-requirement\", nil, \"Internal: limit mcdc_coverage to requirement ID(s) for review-gate focused audit\")\n\t_ = auditCmd.Flags().MarkHidden(\"mcdc-coverage-requirement\")\n\tauditCmd.Flags().StringArrayVar(&auditRequirementScope, \"requirement-scope\", nil, \"Internal: limit requirement-aware checks to requirement ID(s) for review-gate focused audit\")\n\t_ = auditCmd.Flags().MarkHidden(\"requirement-scope\")\n\tauditCmd.Flags().StringArrayVar(&auditChecks, \"check\", nil, \"Run only the selected check ID(s) (repeatable or comma-separated)\")\n\tauditCmd.Flags().StringVar(&auditCheckSet, \"check-set\", \"\", \"Run only the named check set: promotion-gate (every enabled static check \u2014 no build, test, solver or prover, no run evidence; what a KI promotion is judged by before it lands). A static set never refreshes evidence or signals, whatever refresh_on_audit says. Composes with --check by intersection; use --scope baseline --base <ref> so deletion_without_retirement has a requirement baseline\")\n\t// SYS-REQ-260716-52KD: requirement-scoped audit.\n\tauditCmd.Flags().StringArrayVar(&auditOnly, \"only\", nil, \"Scope the audit to the named requirement ID(s) (repeatable or comma-separated). Per-requirement checks report findings only for the named requirement(s); corpus-scoped checks (build/tests, thresholds, pins, cross-requirement consistency) are skipped with an explicit notice. Composes with --check by intersection. NOT a full audit gate \u2014 run 'proof audit' before closing a change.\")\n\tauditCmd.Flags().StringArrayVar(&auditStages, \"stage\", nil, \"Run only the selected workflow stage(s): spec|implement|verify|document (repeatable or comma-separated)\")\n\tauditCmd.Flags().BoolVar(&auditListChecks, \"list-checks\", false, \"List available audit checks and exit\")\n\tauditCmd.Flags().BoolVar(&auditListDependencies, \"dependencies\", false, \"Include check dependency domains with --list-checks\")\n\tauditCmd.Flags().BoolVar(&auditDescribeChecks, \"describe-checks\", false, \"Emit full per-check metadata (title, severity, summary, body) and exit; never runs the audit\")\n"
        },
        {
          "start_line": 1260,
          "end_line": 1278,
          "text": "\n\tcfg := project.Manifest.Project.Audit\n\tif !cmd.Flags().Changed(\"fail-level\") && cfg.FailLevel != \"\" {\n\t\topts.FailLevel = cfg.FailLevel\n\t}\n\tif !cmd.Flags().Changed(\"scope\") && cfg.Scope != \"\" {\n\t\topts.Scope = cfg.Scope\n\t}\n\tif !cmd.Flags().Changed(\"verbose\") && cfg.Verbose {\n\t\topts.Verbose = true\n\t}\n\n\tswitch opts.FailLevel {\n\tcase \"error\", \"warn\", \"info\":\n\tdefault:\n\t\treturn auditOptions{}, fmt.Errorf(\"invalid audit fail level %q in project.audit.fail_level (expected error|warn|info)\", opts.FailLevel)\n\t}\n\tswitch audit.Scope(opts.Scope) {\n\tcase audit.ScopeFull, audit.ScopeBaseline:\n"
        }
      ]
    },
    {
      "path": "pkg/audit/audit.go",
      "sha256": "ccca90fb8840cd2a34df715a51362f998705f5aca87f3755b62c115cc66ac987",
      "bytes": 169968,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 961,
          "end_line": 989,
          "text": "func ExitCode(result *AuditResult, failLevel string) int {\n\tswitch failLevel {\n\tcase \"error\":\n\t\tif result.Errors > 0 {\n\t\t\treturn 1\n\t\t}\n\t\treturn 0\n\tcase \"warn\":\n\t\tif result.Errors > 0 {\n\t\t\treturn 1\n\t\t}\n\t\tif result.Warnings > 0 {\n\t\t\treturn 2\n\t\t}\n\t\treturn 0\n\tdefault:\n\t\tif result.Errors > 0 {\n\t\t\treturn 1\n\t\t}\n\t\tif result.Warnings > 0 {\n\t\t\treturn 2\n\t\t}\n\t\treturn 0\n\t}\n}\n\n// stageCategoryName maps workflow stages to audit category display names.\n// SYS-REQ-783\nfunc stageCategoryName(stage workflow.Stage) string {\n"
        }
      ]
    },
    {
      "path": "pkg/workflow/workflow_documented_claim_verified_test.go",
      "sha256": "388880279325c2739e2fcac59b9b3e44a233c833a47ac143d287ff4d42b154c4",
      "bytes": 14368,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 14,
          "end_line": 76,
          "text": "// TestDocumentedClaimVerified_SkipsWhenNone \u2014 opt-in: no documented_behaviors \u2192 skip.\n// Verifies: SYS-REQ-701\n// Verifies: SYS-REQ-260806-RMP8\n// MCDC SYS-REQ-260806-RMP8: documented_behaviors_declared=F, documented_claim_evidence_present=F => TRUE [no-action: no documented behavior is declared, so the check skips]\nfunc TestDocumentedClaimVerified_SkipsWhenNone(t *testing.T) {\n\tproject, _ := setupMinimalProject(t)\n\n\tcr := (&documentedClaimVerifiedCheck{}).Run(context.Background(), project, &WorkflowConfig{})\n\tif cr.Status != \"skip\" {\n\t\tt.Fatalf(\"want skip with no documented_behaviors, got status=%s summary=%q\", cr.Status, cr.Summary)\n\t}\n\tif !strings.Contains(cr.Summary, \"no documented_behaviors\") {\n\t\tt.Fatalf(\"summary should mention opt-in, got %q\", cr.Summary)\n\t}\n}\n\n// TestDocumentedClaimVerified_NilProjectSkips \u2014 no project is a skip, not a fail.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_NilProjectSkips(t *testing.T) {\n\tcr := (&documentedClaimVerifiedCheck{}).Run(context.Background(), nil, nil)\n\tif cr.Status != \"skip\" {\n\t\tt.Fatalf(\"want skip for nil project, got status=%s summary=%q\", cr.Status, cr.Summary)\n\t}\n}\n\n// TestDocumentedClaimVerified_MetadataAndGuidance \u2014 identity + guidance contract.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_MetadataAndGuidance(t *testing.T) {\n\tcheck := &documentedClaimVerifiedCheck{}\n\tif check.Name() != \"documented_claim_verified\" {\n\t\tt.Fatalf(\"unexpected name %q\", check.Name())\n\t}\n\tif check.Stage() != StageSpec {\n\t\tt.Fatalf(\"unexpected stage %q\", check.Stage())\n\t}\n\tif check.Severity() != SeverityWarning {\n\t\tt.Fatalf(\"unexpected severity %q\", check.Severity())\n\t}\n\tg := check.GuidanceFor(CheckResult{Summary: \"gap\"})\n\tif g == nil || g.Docs != \"docs/help/checks/documented_claim_verified.md\" {\n\t\tt.Fatalf(\"unexpected guidance %+v\", g)\n\t}\n\tif !strings.Contains(g.How, \"verify_by\") {\n\t\tt.Fatalf(\"guidance How should mention verify_by, got %+v\", g)\n\t}\n\tif _, ok := checkDescriptorCatalog[\"documented_claim_verified\"]; !ok {\n\t\tt.Fatalf(\"documented_claim_verified must be registered in the check_descriptors catalog\")\n\t}\n}\n\n// TestDocumentedClaimVerified_RegisteredInSpecStage \u2014 specChecks includes the check.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_RegisteredInSpecStage(t *testing.T) {\n\tfound := false\n\tfor _, c := range specChecks(nil) {\n\t\tif c.Name() == \"documented_claim_verified\" {\n\t\t\tfound = true\n\t\t\tbreak\n\t\t}\n\t}\n\tif !found {\n\t\tt.Fatal(\"specChecks does not include documented_claim_verified\")\n\t}\n"
        },
        {
          "start_line": 173,
          "end_line": 234,
          "text": "\n// TestDocumentedClaimVerified_PassesTestReference \u2014 complete test_reference cell.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_PassesTestReference(t *testing.T) {\n\tproject := writeDocumentedClaimProject(t, []model.DocumentedBehavior{{\n\t\tID:                 \"boundary\",\n\t\tClaim:              \"returns error for inputs > MaxSize\",\n\t\tDocumentedIn:       \"docs/api.md#maxsize\",\n\t\tImplementingSymbol: \"ValidateSize\",\n\t\tVerifyBy:           model.DocumentedClaimVerifyByTestReference,\n\t\tTestRef:            \"pkg/size/size_test.go:TestValidateSize\",\n\t}}, map[string]string{\n\t\t\"docs/api.md\":             \"# API\\nreturns error for inputs > MaxSize\\n\",\n\t\t\"pkg/size/size_test.go\":   \"package size\\nfunc TestValidateSize(t *testing.T) {}\\n\",\n\t})\n\n\tcr := (&documentedClaimVerifiedCheck{}).Run(context.Background(), project, &WorkflowConfig{})\n\tif cr.Status != \"pass\" {\n\t\tt.Fatalf(\"want pass for complete test_reference claim, got status=%s summary=%q details=%v\", cr.Status, cr.Summary, cr.Details)\n\t}\n}\n\n// TestDocumentedClaimVerified_PassesManualReview \u2014 complete manual_review cell.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_PassesManualReview(t *testing.T) {\n\tproject := writeDocumentedClaimProject(t, []model.DocumentedBehavior{{\n\t\tID:                 \"idempotent\",\n\t\tClaim:              \"the operation is idempotent under retry\",\n\t\tDocumentedIn:       \"docs/guide.md\",\n\t\tImplementingSymbol: \"ApplyOnce\",\n\t\tVerifyBy:           model.DocumentedClaimVerifyByManualReview,\n\t\tReviewNote:         \"Reviewed ApplyOnce: double-apply is a no-op via seen set.\",\n\t}}, map[string]string{\n\t\t\"docs/guide.md\": \"the operation is idempotent under retry\\n\",\n\t})\n\n\tcr := (&documentedClaimVerifiedCheck{}).Run(context.Background(), project, &WorkflowConfig{})\n\tif cr.Status != \"pass\" {\n\t\tt.Fatalf(\"want pass for complete manual_review claim, got status=%s summary=%q details=%v\", cr.Status, cr.Summary, cr.Details)\n\t}\n}\n\n// TestDocumentedClaimVerified_WarnsShortReviewNote \u2014 manual_review note too short.\n// Verifies: SYS-REQ-701\nfunc TestDocumentedClaimVerified_WarnsShortReviewNote(t *testing.T) {\n\tproject := writeDocumentedClaimProject(t, []model.DocumentedBehavior{{\n\t\tID:                 \"idempotent\",\n\t\tClaim:              \"the operation is idempotent under retry\",\n\t\tDocumentedIn:       \"docs/guide.md\",\n\t\tImplementingSymbol: \"ApplyOnce\",\n\t\tVerifyBy:           model.DocumentedClaimVerifyByManualReview,\n\t\tReviewNote:         \"ok\",\n\t}}, map[string]string{\n\t\t\"docs/guide.md\": \"the operation is idempotent under retry\\n\",\n\t})\n\n\tcr := (&documentedClaimVerifiedCheck{}).Run(context.Background(), project, &WorkflowConfig{})\n\tif cr.Status != \"warn\" {\n\t\tt.Fatalf(\"want warn for short review_note, got status=%s summary=%q details=%v\", cr.Status, cr.Summary, cr.Details)\n\t}\n\tjoined := strings.Join(cr.Details, \"\\n\")\n\tif !strings.Contains(joined, \"review_note\") {\n"
        },
        {
          "start_line": 310,
          "end_line": 362,
          "text": "// writeDocumentedClaimProject builds a minimal project with one SYS requirement\n// carrying the given documented_behaviors, plus optional extra files.\nfunc writeDocumentedClaimProject(t *testing.T, behaviors []model.DocumentedBehavior, files map[string]string) *repo.Project {\n\tt.Helper()\n\troot := t.TempDir()\n\n\t// Minimal proof.yaml + specs layout.\n\tfor _, d := range []string{\n\t\t\"specs/system/requirements\",\n\t\t\"docs\",\n\t} {\n\t\tif err := os.MkdirAll(filepath.Join(root, d), 0o755); err != nil {\n\t\t\tt.Fatalf(\"mkdir %s: %v\", d, err)\n\t\t}\n\t}\n\tmanifestBody := \"project:\\n  name: documented-claim-test\\n  specs:\\n    - path: specs/system\\n      prefix: SYS-REQ\\n      type: system\\n\"\n\tif err := os.WriteFile(filepath.Join(root, \"proof.yaml\"), []byte(manifestBody), 0o644); err != nil {\n\t\tt.Fatalf(\"write proof.yaml: %v\", err)\n\t}\n\n\treq := &model.Requirement{\n\t\tID:                  \"SYS-REQ-001\",\n\t\tVersion:             1,\n\t\tStatus:              model.StatusApproved,\n\t\tPriority:            \"shall\",\n\t\tCategory:            \"functional\",\n\t\tReqType:             model.ReqTypeGuarantee,\n\t\tDescription:         \"documented claim fixture requirement\",\n\t\tComponent:           \"core\",\n\t\tDocumentedBehaviors: behaviors,\n\t}\n\treqPath := filepath.Join(root, \"specs/system/requirements/SYS-REQ-001.req.yaml\")\n\tif err := repo.WriteRequirement(reqPath, req); err != nil {\n\t\t// Fall back to yaml marshal if WriteRequirement needs more fields.\n\t\tt.Fatalf(\"write requirement: %v\", err)\n\t}\n\n\tfor rel, body := range files {\n\t\tfull := filepath.Join(root, rel)\n\t\tif err := os.MkdirAll(filepath.Dir(full), 0o755); err != nil {\n\t\t\tt.Fatalf(\"mkdir for %s: %v\", rel, err)\n\t\t}\n\t\tif err := os.WriteFile(full, []byte(body), 0o644); err != nil {\n\t\t\tt.Fatalf(\"write %s: %v\", rel, err)\n\t\t}\n\t}\n\n\tproject, err := repo.LoadProject(root)\n\tif err != nil {\n\t\tt.Fatalf(\"LoadProject: %v\", err)\n\t}\n\treturn project\n}\n"
        }
      ]
    },
    {
      "path": "docs/help/checks/documented_claim_verified.md",
      "sha256": "f4eee6ce361d00a15fb3a0b13bd406ff40c97a26e99fff686f42cf2170d280e0",
      "bytes": 5077,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1,
          "end_line": 139,
          "text": "---\nid: documented_claim_verified\ntitle: Documented Claim Verified\nsummary: \"WARN when a declared documented_behaviors claim cell is incomplete or its evidence paths are missing.\"\naliases:\n  - documented-claim-verified\n  - documented-behaviors\n  - doc-claim-evidence\nkind: check\nrelated_commands:\n  - proof audit --check documented_claim_verified\n  - proof req edit\n  - proof help documentation_coverage\nsee_also:\n  - documentation_coverage\n  - documentation_enforced\n  - obligation_enforcement_backed\nrelated_requirements:\n  - SYS-REQ-776\n  - SYS-REQ-780\n  - SYS-REQ-781\n  - SYS-REQ-260806-RMP8\n---\n<!-- Documents: SYS-REQ-776, SYS-REQ-780, SYS-REQ-781, SYS-REQ-260806-RMP8 -->\n\n# documented_claim_verified\n\nThe `documented_claim_verified` check runs at `--stage spec` and **WARNs** when\nan active requirement declares `documented_behaviors:` entries whose evidence\ncells are incomplete or ungrounded.\n\nDocumented claims come from surfaces such as man pages, godoc, NatSpec, JSDoc,\nand docstrings. Proof does **not** auto-extract free-text promises; authors\n**name** each claim and bind it to an implementing symbol and a `verify_by`\nevidence kind (the same explicit-declaration doctrine as `shared_state_rules`\nand `build_targets`).\n\n## Opt-in\n\nNo `documented_behaviors` on any active requirement \u2192 the check **skips**.\nOnce any claim is declared, every cell must pass the evidence-presence bar.\n\n## Schema\n\n```yaml\n# on a requirement YAML (e.g. specs/system/requirements/SYS-REQ-001.req.yaml)\ndocumented_behaviors:\n  - id: auth_users_comma_parsing          # optional stable id\n    claim: \"comma-separated values are parsed left-to-right\"\n    documented_in: docs/man/auth-users.5  # path; optional #anchor or :line\n    implementing_symbol: ParseAuthUsers\n    verify_by: signal_present             # | test_reference | manual_review\n    signal_id: go.parsing.comma-split     # required for signal_present\n\n  - id: maxsize_boundary\n    claim: \"returns error for inputs > MaxSize\"\n    documented_in: docs/api.md#maxsize\n    implementing_symbol: ValidateSize\n    verify_by: test_reference\n    test_ref: pkg/size/size_test.go:TestValidateSize\n\n  - id: idempotent_retry\n    claim: \"the operation is idempotent under retry\"\n    documented_in: docs/guide.md\n    implementing_symbol: ApplyOnce\n    verify_by: manual_review\n    review_note: \"Reviewed ApplyOnce: double-apply is a no-op via seen set.\"\n```\n\n| Field | Required | Notes |\n|-------|----------|--------|\n| `claim` | yes | Human-readable assertion from the docs |\n| `documented_in` | yes | Repo-relative doc path; `#anchor` / `:line` stripped for existence |\n| `implementing_symbol` | yes | Function/method (or `path::symbol`) that should enforce the claim |\n| `verify_by` | yes | `signal_present` \\| `test_reference` \\| `manual_review` |\n| `signal_id` | when `signal_present` | Signal rule id that should fire on the symbol |\n| `test_ref` | when `test_reference` | Test path or `path:TestName`; path must exist |\n| `review_note` | when `manual_review` | \u226516 characters; auditor note of the review |\n| `id` | no | Stable claim id used in findings |\n\n## What is checked\n\nFor each declared claim on an active (non-terminal) requirement:\n\n1. **Structural completeness** \u2014 required fields and a valid `verify_by`\n2. **Doc path existence** \u2014 `documented_in` resolves under the project root\n3. **Kind-specific evidence**\n   - `signal_present` \u2014 `signal_id` present (binds the claim to a signal rule)\n   - `test_reference` \u2014 `test_ref` path exists on disk\n   - `manual_review` \u2014 `review_note` meets the length floor\n\nThis check verifies **evidence presence** for declared cells. It does not yet\nexecute signal rules against the implementing symbol; that is a later\nhardening step. Completing a cell still makes the documentation promise\nauditable and reviewable.\n\n## Severity\n\nDefault **warning**. Under `fail-level warn` (the default audit policy),\nwarnings still block advancement. Use `proof audit --check documented_claim_verified`\nto run this check alone.\n\n## How to resolve a finding\n\n1. **Fill the missing fields** on the requirement's `documented_behaviors` entry.\n2. **Create or fix the path** for `documented_in` / `test_ref` so it exists in\n   the working tree.\n3. **Lengthen `review_note`** when using `manual_review` (minimum 16 characters).\n4. Re-run:\n\n```bash\nproof audit --check documented_claim_verified\n```\n\n## Opt out\n\n```bash\nproof config set project.checks.documented_claim_verified.enabled false\n```\n\nOr in `proof.yaml`:\n\n```yaml\nproject:\n  checks:\n    documented_claim_verified:\n      enabled: false\n```\n\nWhen the opt-out is in effect the check reports `skip` (never `pass`) with a\nsummary naming the setting that silenced it \u2014 a check that ran nothing must not\ncount toward the audit's pass total.\n\n## Related\n\n- `documentation_coverage` \u2014 requirements have `documented_by` links at all\n- `documentation_enforced` \u2014 project `documentation.enforce_sources` floor\n- `<!-- Documents: REQ-ID -->` annotations \u2014 autolink doc traces into\n  `traces.documented_by` (orthogonal to claim cells)\n"
        }
      ]
    },
    {
      "path": "pkg/catalog/data/property/documented_contract_tested.yaml",
      "sha256": "86c54a465ef6f3f28229f83adbfb11c4db2b06906ac270812d8946980c0d6315",
      "bytes": 6821,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1,
          "end_line": 122,
          "text": "id: documented_contract_tested\ncatalog_version: 7\ncategory: property\norder: 8\nstatus: active\nname: Documented contract tested\nsummary: >\n  Every behavior claim in shipped prose shall carry an executable witness\n  that fails when the code stops honoring the claim.\ndescription: |\n  Documentation that describes behavior is a requirement, not decoration.\n  Doc comments, reference pages, usage notes, and release promises state\n  what the shipped code shall do. This class asks one question per claim:\n  which witness fails when the code breaks this sentence? A claim with no\n  answer rots silently. Code changes, the prose stays, and readers trust\n  a contract nothing enforces.\nplain_english: |\n  Prose and code live in different files and change at different speeds.\n  When a behavior claim has no test, the next edit updates one side and\n  forgets the other. The reader then follows instructions the code no\n  longer honors: a documented error never fires, a documented default\n  changed value, a documented limit moved. Nothing crashes at the moment\n  of drift. The failure appears later, in production, on the person who\n  believed the page.\n\n  The obligation pins each claim to a witness. Find every sentence of\n  shipped prose that asserts observable behavior. Attach a test that\n  drives the code through the claim and asserts the promised outcome.\n  When the behavior changes on purpose, change the prose and the witness\n  in the same release. A claim nobody is willing to test is a claim to\n  delete, not a claim to keep.\napplies_when:\n  description: |\n    Shipped prose states observable behavior of code that ships in the\n    same release: doc comments on exported and internal interfaces,\n    reference pages for operations or configuration, usage notes, help\n    text, changelog compatibility promises, and error-message catalogs\n    that promise outcomes. Prose that ships with the product counts;\n    private scratch notes do not.\n  trigger_phrases:\n    - \"as documented\"\n    - \"doc comment\"\n    - \"reference states\"\n    - \"default value\"\n    - \"documented error\"\n    - \"compatibility window\"\n    - \"help text\"\n    - \"usage note\"\nexample_req: |\n  When the reference prose states that an operation returns a typed error\n  when its queue is full, a test shall fill the queue, call the\n  operation, and assert the documented typed error; any change to the\n  queue-full behavior shall update the prose and this test in the same\n  release.\nif_missing: |\n  Untested claims rot silently. The code moves ahead of the page:\n  defaults change, errors retype, limits move, promised compat windows\n  close early. Readers follow the stale claim and hit behavior nobody\n  documents. Because no witness pinned the claim, the drift passes\n  review, passes tests, and surfaces as user-visible contradiction\n  between the product and its own words.\nrecommended_evidence:\n  - kind: nominal\n    note: \"One test per claim: drive the code through the documented condition and assert the exact promised outcome (value, error, status, default).\"\n  - kind: review\n    note: \"Inventory pass: list the behavior claims in shipped prose and name the witness for each; claims without a witness get a test or get deleted.\"\nexample_obligations_complement:\n  - idempotency\n  - atomicity\n  - errors_propagated\nrelated_classes:\n  - id: documented_interface_semantics_consistent\n    relationship: complements\n  - id: documented_behavior_verified\n    relationship: complements\ndefault_assurance: B\ndefault_obligation_severity: shall\nversioning:\n  introduced_in_catalog_version: 7\nfit_examples:\n  - text: \"When reference prose states that an operation returns a stored record unchanged, a test shall call the operation on a stored record and assert the returned value equals the stored value.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"canonical claim-to-witness shape: the prose names the outcome, the test drives it\"\n  - text: \"When help text documents an exit status for rejected input, a test shall run the entry point on rejected input and assert the documented status.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"documented statuses are contracts callers branch on; untested they drift first\"\n  - text: \"When configuration reference documents a default applied when a key is absent, a test shall load configuration without the key and assert the documented default.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"defaults are silent behavior claims that edits change without notice\"\n  - text: \"When release notes promise a compatibility window for a replaced operation, a witness shall exercise the replaced operation until the promised window closes.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"compatibility promises need a standing witness, not goodwill\"\n  - text: \"When reference prose bounds a wait time or retry count, a test shall measure the wait or count the attempts and assert the documented bound.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"numeric claims rot quietly when tuning changes constants\"\n  - text: \"When documentation claims an operation leaves state unchanged after a failure, a test shall force a failure mid-operation and assert no change persisted.\"\n    provenance: \"reqproof:corpus-hazard-sweep-2026-07\"\n    why: \"failure-mode prose claims are the most common untested assertions\"\nantifit_examples:\n  - text: \"Public interface prose, generated clients, and runtime guards shall accept and reject the same modes and boundary values.\"\n    provenance: \"sibling:documented_interface_semantics_consistent\"\n    why: \"multi-artifact semantic parity among interfaces is narrower than pinning every shipped behavior claim to a witness\"\n  - text: \"A stale comment describing mechanics inside an internal helper shall be corrected during maintenance.\"\n    provenance: \"generalized:private-comment-cleanup\"\n    why: \"mechanics narration without a behavioral promise gives consumers nothing to rely on; this class needs an observable claim\"\n  - text: \"For every reachable input combination, the specification shall name an outcome.\"\n    provenance: \"sibling:totality\"\n    why: \"specification coverage over the input space is totality; this class pins existing prose claims to witnesses\"\n  - text: \"When a called operation fails, the caller shall propagate or map the error instead of continuing.\"\n    provenance: \"sibling:errors_propagated\"\n    why: \"runtime error flow stands on its own; this class fires only when prose asserts the behavior\"\nagent_hints:\n  trigger_phrases_high_confidence:\n    - \"as documented\"\n    - \"documented default\"\n    - \"documented error\"\n    - \"per the reference\"\n    - \"compatibility window\"\n  trigger_phrases_review_needed:\n    - \"comment says\"\n    - \"docs mention\"\n    - \"help text\"\n"
        }
      ]
    },
    {
      "path": "website/demo.html",
      "sha256": "902a9dc2a5f71745d1047ccbc160848510e53fc6e2d43f90ebd597e26d5cbc26",
      "bytes": 24503,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 151,
          "end_line": 159,
          "text": "             wall beside the form. The column now carries the headline, one\n             sentence, and what the reader brings. The agenda and the three\n             ways to begin are folded under the form (.dm-fold), open on\n             demand; the reassurance line is already the form's own note. -->\n        <div class=\"dm-need\"><p><strong>Software factory:</strong> Proof coordinates implementation and verification.</p><p><strong>Continuous audit:</strong> your team builds; Proof maintains intent and checks the evidence.</p><p><a href=\"/topics/software-correctness-audit#sample-scope\">See a sample scope and handoff \u2192</a></p>\n          <p class=\"kicker dm-need-h\">You&rsquo;ll need</p>\n          <ul class=\"dm-need-list\">\n            <li><svg viewBox=\"0 0 12 12\" aria-hidden=\"true\"><path d=\"M1.6 6.4 L4.4 9.1 L10.4 2.6\"/></svg><span>A work email</span></li>\n            <li><svg viewBox=\"0 0 12 12\" aria-hidden=\"true\"><path d=\"M1.6 6.4 L4.4 9.1 L10.4 2.6\"/></svg><span>Forty minutes, or twenty if you prefer a shorter call</span></li>\n"
        },
        {
          "start_line": 180,
          "end_line": 190,
          "text": "          <div class=\"step-1\">\n            <label for=\"lf-email\">Work email</label>\n            <input id=\"lf-email\" name=\"email\" type=\"email\" required autocomplete=\"email\" placeholder=\"you@company.com\">\n            <label for=\"lf-engagement\">How would you like to work? (optional)</label>\n            <select id=\"lf-engagement\" name=\"engagement\"><option value=\"\">Help me choose</option><option value=\"factory\">Software factory</option><option value=\"audit\">Continuous audit alongside our development</option></select>\n            <label for=\"lf-interest\">What would you start with? (optional)</label>\n            <select id=\"lf-interest\" name=\"interest\"><option value=\"\">Choose a starting point</option><option value=\"agent-change\">An agent-written change</option><option value=\"backlog\">Unresolved backlog</option><option value=\"business-logic\">Business logic</option><option value=\"migration\">Migration or legacy transformation</option><option value=\"requirements\">Requirements and intent recovery</option><option value=\"correctness\">Component correctness</option></select>\n            <label for=\"lf-message\">Anything we should know</label>\n            <textarea id=\"lf-message\" name=\"message\" rows=\"4\"></textarea>\n            <button class=\"btn btn-primary\" type=\"submit\">Book a demo</button>\n          </div>\n"
        },
        {
          "start_line": 239,
          "end_line": 245,
          "text": "        </details>\n\n        <details class=\"dm-fold\">\n          <summary>What a first engagement includes</summary>\n          <div class=\"dm-fold-body\"><p>Agree one component or change, its owner, access, required evidence, exclusions and a handoff date. For a backlog, each accepted item receives a recorded disposition; an agreed subset proceeds to a fix.</p><p>You keep the requirements, reproductions, tests, observed results and remaining decisions. Factory scope also includes implementation. An audit can remain alongside your development for future changes.</p><p>We agree price and timing after scoping the build, dependencies and verification work. <a href=\"/topics/software-correctness-audit#sample-scope\">Read the sample deliverables.</a></p></div>\n        </details>\n      </div>\n"
        }
      ]
    },
    {
      "path": "website/assets/engagement-intake.js",
      "sha256": "72df4637e1adc355fbabecb70b80f2ec0e41c89855deef941bd3314dde23472f",
      "bytes": 6531,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 1,
          "end_line": 27,
          "text": "/* Only recognized choices prefill the visible, editable inquiry fields. */\n(function () {\n  var params = new URLSearchParams(window.location.search);\n  var page = (window.location.pathname || \"\").replace(/\\.html$/, \"\").replace(/\\/$/, \"\");\n  var topicInterests = {\n    \"do178c\": \"DO-178C evidence chain\",\n    \"iec-62304\": \"Medical software change evidence\",\n    \"iso-26262\": \"Automotive software change evidence\",\n    \"property-based-testing\": \"Properties and test oracles\"\n  };\n  [\"engagement\", \"interest\"].forEach(function (name) {\n    var field = document.querySelector('.lead-form select[name=\"' + name + '\"]');\n    var value = params.get(name);\n    if (!field || field.value || !value) return;\n    if (name === \"interest\" && page === \"/demo\" &&\n        Object.prototype.hasOwnProperty.call(topicInterests, value) &&\n        !Array.from(field.options).some(function (option) { return option.value === value; })) {\n      var option = document.createElement(\"option\");\n      option.value = value;\n      option.textContent = topicInterests[value];\n      field.appendChild(option);\n    }\n    if (Array.from(field.options).some(function (option) { return option.value === value; })) {\n      field.value = value;\n    }\n  });\n\n"
        }
      ]
    },
    {
      "path": "website/audit.html",
      "sha256": "3ec78a32ca31a0126911bbefc18734241c52f63c6c36bb72626cd51eb96cd376",
      "bytes": 57827,
      "readScope": "Complete exact regions embedded; not a full repository or all-claims audit",
      "regions": [
        {
          "start_line": 94,
          "end_line": 99,
          "text": "      <p class=\"au-bound\">The claim is bounded on purpose: <strong>within a declared scope, for declared behaviors, with evidence commensurate with the consequence of failure</strong>. A person validates every finding before you see it, so we take a small number of engagements at a time.</p>\n      <div class=\"au-body\">\n        <p><strong>Choose how Proof fits your work.</strong> Keep your development process and use the audit as a verification sidecar. Your team owns implementation and release decisions; Proof maintains the requirements and evidence within the agreed scope.</p>\n        <p><a href=\"/topics/software-correctness-audit#sample-scope\">See a sample scope and handoff.</a> If you want help taking work through implementation as well, <a href=\"/demo?engagement=factory\">scope a change or backlog with us</a> through the <a href=\"/product\">software factory</a>. The audit is a standalone offer. Adopting the factory is optional.</p>\n      </div>\n    </div>\n"
        },
        {
          "start_line": 134,
          "end_line": 141,
          "text": "        <p>Three things to get started. The audit uses read-only repository access; your team continues development.</p>\n      </div>\n      <div class=\"tiles tiles-3 au-need\" data-reveal>\n        <div class=\"tile\"><span class=\"tile-n\">01</span><h3>Two or three engineers who own the component</h3><p>About two hours a week while we install. They know what the code is meant to do; we write it down with them.</p></div>\n        <div class=\"tile\"><span class=\"tile-n\">02</span><h3>A repository we can read</h3><p>Public, or private under NDA with read-only access. Private stays private.</p></div>\n        <div class=\"tile\"><span class=\"tile-n\">03</span><h3>One person who can approve</h3><p>Agree approval authority before work starts. Delegate lower-assurance work to agents within a defined scope; reserve higher-assurance intent and consequential exceptions for a person. Changes to these boundaries follow the previously approved policy. A passing check supplies evidence. It does not grant permission to merge or deploy.</p></div>\n      </div>\n    </div>\n"
        },
        {
          "start_line": 436,
          "end_line": 449,
          "text": "  <!-- #fix-sprints is linked from life-after-the-audit.html. Keep the id. -->\n  <section class=\"section\" id=\"fix-sprints\">\n    <div class=\"wrap\">\n      <div class=\"section-head\">\n        <p class=\"kicker\">06 &middot; Independence</p>\n        <h2>Fix work stays separate from audit.</h2>\n        <p class=\"lead\">Fix work is never bundled into the audit. The audit fee never depends on finding volume or remediation volume. Every fix, including ours, must satisfy the same approved requirements and the same customer-owned evidence gate.</p>\n      </div>\n\n      <div class=\"au-body\">\n        <p><strong>Your team can handle the fixes in its existing workflow.</strong> We provide the findings and evidence, and re-verify fixes within the agreed audit scope. If you want implementation help, fix sprints are a separate choice.</p>\n        <p>The finding record gives your engineers or coding agents the expected behavior, reproduction and evidence to work from. A fix needs to address the reported failure and preserve the other behavior in scope. Our fix sprints are scoped and priced separately, and delivered as pull requests your engineers review and merge.</p>\n        <p>The gate grades our fixes exactly as it grades anyone's. A fix that does not satisfy the approved requirement does not merge, whoever wrote it.</p>\n      </div>\n"
        }
      ]
    }
  ],
  "claims": [
    {
      "claim": "Explicit active documented_behaviors cells only; no free-text extraction or all-shipped-prose inventory",
      "basis": [
        "pkg/workflow/workflow_documented_claim_verified.go:51-120",
        "pkg/model/requirement.go:1088-1095,1570-1587,2382-2494"
      ],
      "limits": "Active means excludes retired/superseded/rejected, not approved-only. The fixture draft is eligible without becoming approved."
    },
    {
      "claim": "SPEC stage, warning severity; nil project/manifest or no eligible cells SKIP; requirement load error row FAIL; complete cells PASS; incomplete/path findings WARN",
      "basis": [
        "pkg/workflow/workflow_documented_claim_verified.go:35-120"
      ],
      "limits": "Only missing-test WARN and existing-test PASS were actually exercised; no nil/empty/load-error native case here. Row severity and aggregate threshold/exit are separate."
    },
    {
      "claim": "Nonempty claim/documented_in/implementing_symbol/verify_by; exact closed kinds signal_present/test_reference/manual_review",
      "basis": [
        "pkg/model/requirement.go:2437-2478"
      ],
      "limits": "Symbol/signal IDs only checked nonempty after trimming; no resolution/execution or semantic validation."
    },
    {
      "claim": "manual_review note uses trimmed UTF8 RuneCountInString >=16",
      "basis": [
        "pkg/model/requirement.go:2430-2477"
      ],
      "limits": "Not byte count, proof of human review, authenticated reviewer, correctness or evidence execution. This boundary is source-inspected, not exercised by three native snapshots."
    },
    {
      "claim": "Docs strip first #fragment and optional trailing ASCII-digit :line; tests strip only final suffix beginning Test/test/Fuzz/Benchmark",
      "basis": [
        "pkg/workflow/workflow_documented_claim_verified.go:184-259"
      ],
      "limits": "No general test:line convention, anchor validation or test/symbol resolution. Native uses only regular relative docs and witness paths."
    },
    {
      "claim": "Documentation/test path helpers use os.Stat success",
      "basis": [
        "pkg/workflow/workflow_documented_claim_verified.go:232-259"
      ],
      "limits": "Not regular-file/root-containment checks: directories, followed symlinks, absolute and parent paths can pass when Stat succeeds. No exploit/path-shape campaign performed."
    },
    {
      "claim": "Current help dedicated enabled:false recipe is unsupported by typed per-check config; generic project.checks.disabled list is supported",
      "basis": [
        "docs/help/checks/documented_claim_verified.md:114-130",
        "pkg/model/requirement.go:3142-3561",
        "pkg/workflow/config.go:896-985",
        "pkg/workflow/workflow.go:1028-1069",
        "pkg/repo/manifest_checks_access.go:1-166",
        "cmd/proof/config.go:867-874,1757-1766",
        "pkg/workflow/check_descriptors.go:2108-2115"
      ],
      "limits": "Source inspection only: no dedicated/generic optout command was executed. Use YAML disabled list if explaining suppression, and call it SKIP rather than PASS."
    },
    {
      "claim": "Selected check/stage and explicit --fail-level warn; warning aggregate exits2, errors exit1, no blocking findings exit0",
      "basis": [
        "cmd/proof/audit.go:160-179,1260-1278",
        "pkg/workflow/workflow.go:1259-1284,1561-1578,1870-1920",
        "pkg/audit/audit.go:961-989"
      ],
      "limits": "Loader FAIL with warning severity contributes warnings; do not infer exit1 from row status. Actual native S0/S1/S2 observed2/0/0."
    },
    {
      "claim": "documented_contract_tested is broader than the structural checker",
      "basis": [
        "pkg/catalog/data/property/documented_contract_tested.yaml:1-122"
      ],
      "limits": "One declared cancellation cell and a useful actual witness do not establish all shipped claims or promote this reference into obligation fulfillment."
    },
    {
      "claim": "Existing editable /demo?engagement=audit&interest=requirements intake is supported; audit ownership/implementation and release stay scoped",
      "basis": [
        "website/demo.html:151-159,180-190,239-245",
        "website/assets/engagement-intake.js:1-27",
        "website/audit.html:94-99,134-141,436-449"
      ],
      "limits": "No new option, actual engagement, form submission, approval or deployment. No native check gives permission to release."
    }
  ],
  "actualNativeEvidence": "Three selected-check snapshots and their exact persisted check rows/JSONL are supplied separately; source-inspected branches beyond them remain unexecuted."
}
