fix(docs): reconcile stale docval backlog with current evidence (PLF-010) - #15
Conversation
Co-authored-by: Koru Agent <agent@coru.dev>
There was a problem hiding this comment.
Validator approval after policy checks for exact head 091948e3218559e21820d78808e386a1fe88b6e5.
Ticket: ticket-010
Correlation ID: local-semcod-costs-pr-15-ticket-010
Model: zai/glm-5.3
Advisory LLM review: LLM_UNAVAILABLE
Reason: complete review progress requires a bound subject and authenticated App signer
This approval rests on the deterministic checks alone; no advisory opinion was recorded for this head.
Semantic review prerequisite: not_required; policy 676cb4516bbfed2a000e40b9b1b6e4a430ecc761ec546aeb53d721a1905cfdd7.
Actual PR impact radar
Exact range: 75837a6335d344485e5553190dfc9281d5852d3a...091948e3218559e21820d78808e386a1fe88b6e5
Change digest: 4e99a5c42223085f2d1add04f20282d1433a961cad97dce636698c7843f56b4a
Score: 56/100 (L), estimated 65 min, split recommended: true
Affected services/components: repository-wide/unclassified
Machine-readable radar JSONL and SVG
{"actual_change":{"additions":480,"base_sha":"75837a6335d344485e5553190dfc9281d5852d3a","binary_files":0,"categories":{"code":1,"configuration":1,"docs":1,"tests":1},"change_digest":"4e99a5c42223085f2d1add04f20282d1433a961cad97dce636698c7843f56b4a","comparison":"75837a6335d344485e5553190dfc9281d5852d3a...091948e3218559e21820d78808e386a1fe88b6e5","deletions":159,"file_count":4,"files":["planfile.yaml","project/README.md","scripts/revalidate_docval_backlog.py","tests/test_docval_revalidation.py"],"head_sha":"091948e3218559e21820d78808e386a1fe88b6e5","service_count":0,"services":[]},"assessment_mode":"observed-pr","axes":{"coupling":5,"delivery":2,"scope":3,"uncertainty":3,"validation":1},"complexity":"L","confidence":0.9,"diagnostics":["RADAR-ACCEPTANCE-MISSING","RADAR-BUDGET-EXCEEDED"],"estimate":{"budget_minutes":30,"minutes":65,"within_budget":false},"impact":{"components":["project","repository-root","scripts","tests","unscanned"],"files":["planfile.yaml","project/README.md","scripts/revalidate_docval_backlog.py","tests/test_docval_revalidation.py","unscanned/ambiguous"],"public_interfaces":[],"runtime_dependencies":0},"schema":"subactor.ticket-radar/v1","score":56,"split":{"parts":[{"estimated_minutes":11,"name":"Implement project","scope":["project"]},{"estimated_minutes":11,"name":"Implement repository-root","scope":["repository-root"]},{"estimated_minutes":11,"name":"Implement scripts","scope":["scripts"]},{"estimated_minutes":11,"name":"Implement tests","scope":["tests"]},{"estimated_minutes":11,"name":"Implement unscanned","scope":["unscanned"]},{"estimated_minutes":15,"name":"Validate and project to trackers","scope":["tests","planfile","github/gitlab/jira projections"]}],"reason":"estimated_minutes_exceed_budget","recommended":true},"standards":[{"id":"wellmanifest/dsl","revision":"6c60fc4e0dd1f1bb74f46a7745e28019908d1203","version":"0.1.0-dev"},{"id":"wellmanifest/ticket-lifecycle","revision":"5bf581907a87b46a13a73e6c033d3abe4d9a306f","version":"0.1.0-dev"},{"id":"wellmanifest/git-lifecycle","revision":"7d77d4b7af57e69bc75c3a0290b3a4805c5c4438","version":"0.2.0-dev"},{"id":"wellmanifest/logs","revision":"48c284ef7a069055c0bcb6b900147ce5e65f8b43","version":"0.3.0"}],"ticket_ref":"ticket-010"}<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" role="img"><title>ticket-010: fix(docs): reconcile stale docval backlog with current evidence (PLF-010)</title><rect width="128" height="128" rx="12" fill="#f8fafc"/><g stroke-width="1"><polygon points="64,55 72,61 69,71 59,71 56,61" fill="none" stroke="#d7dde5"/><polygon points="64,47 80,59 74,78 54,78 48,59" fill="none" stroke="#d7dde5"/><polygon points="64,38 89,56 79,85 49,85 39,56" fill="none" stroke="#d7dde5"/><polygon points="64,30 97,53 84,92 44,92 31,53" fill="none" stroke="#d7dde5"/><polygon points="64,21 105,51 89,99 39,99 23,51" fill="none" stroke="#d7dde5"/><line x1="64" y1="64" x2="64" y2="21" stroke="#aab4c0"/><line x1="64" y1="64" x2="105" y2="51" stroke="#aab4c0"/><line x1="64" y1="64" x2="89" y2="99" stroke="#aab4c0"/><line x1="64" y1="64" x2="39" y2="99" stroke="#aab4c0"/><line x1="64" y1="64" x2="23" y2="51" stroke="#aab4c0"/></g><polygon points="64,38 105,51 79,85 59,71 48,59" fill="#fb923c" fill-opacity="0.45" stroke="#c2410c" stroke-width="2"/><circle cx="64" cy="64" r="3" fill="#c2410c"/><g font-family="sans-serif" font-size="7" fill="#334155"><text x="64" y="11" text-anchor="middle">SCO</text><text x="114" y="48" text-anchor="middle">COU</text><text x="95" y="107" text-anchor="middle">UNC</text><text x="33" y="107" text-anchor="middle">VAL</text><text x="14" y="48" text-anchor="middle">DEL</text></g><text x="64" y="124" text-anchor="middle" font-family="sans-serif" font-size="8" fill="#0f172a">L · 65m</text></svg>DECISION D-010-1091
TICKET ticket-010
HEAD_SHA 091948e3218559e21820d78808e386a1fe88b6e5
CORRELATION_ID local-semcod-costs-pr-15-ticket-010
ACTOR agent:ifuri-validator-agent[bot]
APPLIED_RULE P-CORE-015
INPUT author_login = "tom-sapletta-com"
INPUT observed_checks = ["test (3.9)=PASS","test (3.13)=PASS","update-badge=PASS","test (3.13)=PASS","test (3.9)=PASS"]
INPUT required_checks = ["test (3.13)","test (3.9)","update-badge"]
INPUT required_checks_source = "protected registry (env/request)"
INPUT reviewer_login = "ifuri-validator-agent[bot]"
INPUT semantic_review_assessment = {"schema":"subactor.validator/semantic-review-assessment/v1","subject":{"repository":"semcod/costs","pull_request":15,"head_sha":"091948e3218559e21820d78808e386a1fe88b6e5","base_sha":"75837a6335d344485e5553190dfc9281d5852d3a","diff_sha256":"ebd88be629008f0f8b933211e50cbbdb8ba5f0259613f81107ad92d111c8aa66"},"policy":{"policy_schema":"subactor.validator/semantic-review-policy/v1","policy_version":1,"policy_sha256":"676cb4516bbfed2a000e40b9b1b6e4a430ecc761ec546aeb53d721a1905cfdd7","required":false,"critical_paths":[],"observed_paths":["planfile.yaml","project/README.md","scripts/revalidate_docval_backlog.py","tests/test_docval_revalidation.py"]},"grounding":"full-diff-not-per-finding-proof","execution_authority":false,"status":"not_required","reason":null,"review_sha256":null,"unresolved":[]}
INPUT superseded_checks = []
INPUT ticket_radar_receipt = {"schema":"subactor.ticket-radar/v1","base_sha":"75837a6335d344485e5553190dfc9281d5852d3a","head_sha":"091948e3218559e21820d78808e386a1fe88b6e5","change_digest":"4e99a5c42223085f2d1add04f20282d1433a961cad97dce636698c7843f56b4a","score":56,"complexity":"L","estimated_minutes":65,"split_recommended":true,"services":[],"authority":"ADVISORY","promotion":"FORBIDDEN"}
VERDICT APPROVE AUTHORITY DETERMINISTIC
REJECTED REQUEST_CHANGES BECAUSE NO_UNSAFE_CHANGE_REASON_FOUND
ADVISORY llm_verdict = "" MODEL "zai/glm-5.3"
ASSERT VERDICT_AUTHORITY != "ADVISORY"
The historical docval export still marked resolved findings as open, including four critical broken links to content no longer present. A fresh scan supersedes 152 historical records (one was already marked done in the primary checkout) and preserves 31 still-reported records with source hashes and candidate locations. Repeated headings remain distinct tickets. Correct the stale analysis.toon artifact references to analysis.toon.yaml.
Add a conservative revalidation script that runs a fresh scan, rejects documentation changes during scanning and preserves unscanned/ambiguous records. Severity stays separate from evidence of present urgency. The remaining candidates stay available for the broader documentation review in #10.
Validation: full suite 56 passed; focused reconciliation tests 2 passed after freshness guard. The existing optional badge hook reported an unrelated installed tokenizer error; commit completed and README was unchanged.
Closes #14
Planfile: PLF-010 / ticket-010