MessageWeave/scripts/docs_check
anonsaber 655167e862 docs: close the TTL gap, re-anchor drifted code refs, add anchor tooling
opengaps.md: the TTL item is now closed on the code side. The 21-value
table is keyed by ttl constant rather than by line number, so it stops
drifting. The honest caveat is called out in the open instead of being
implied away: the two real-Redis assertions are wired but unrunnable with
the credentials on hand, so 'assertion ready' is not the same as 'verified
on real hardware'. The residual-risk note that was still sitting under the
closed item has been removed along with it.

charter.md: test baseline 88 -> 89 passed.

deployment.md, design.md, retired.md: 41 stale src/ line anchors. The
drift was real and the audit missed it every time, because
audit_anchors.py only asserts that a referenced line exists and is
non-blank. Three are off-by-one; the rest are wrong code --
state.rs:379 pointed at XREADGROUP XACK while the claim was about
read_batch, retired.md:99 pointed into Intent::Search::parse, the two
route-table anchors landed on state: Arc::new(state),, and one
register_push anchor sat 31 lines above the fn.

scripts/docs_check/reanchor.py: maps HEAD -> working-tree line numbers
straight off git diff -U0 hunks, applies the fix or reports only with
--check. scripts/docs_check/show_anchors.py: prints every doc anchor next
to the line it lands on, which is what caught the semantic errors the
audit structurally cannot.
2026-09-30 13:20:13 +08:00
..
audit_anchor_semantics.py docs: stop maintaining source line numbers in reference.md 2026-09-30 02:02:34 +08:00
audit_anchors.py docs: rename roadmap.md to opengaps.md and drop completed items 2026-09-29 19:38:38 +08:00
audit_paths.py docs: 回答 hoststack.yaml 的来历与官方做法,补上命令字段不回写的证据 2026-09-29 12:25:08 +08:00
check_file_size.py fix(mode): restore executable bit on the doc validators 2026-09-29 01:16:43 +08:00
check_sec_refs.py docs: rename roadmap.md to opengaps.md and drop completed items 2026-09-29 19:38:38 +08:00
check_tables.py docs: rename roadmap.md to opengaps.md and drop completed items 2026-09-29 19:38:38 +08:00
reanchor.py docs: close the TTL gap, re-anchor drifted code refs, add anchor tooling 2026-09-30 13:20:13 +08:00
run_all.sh docs+tooling: no document may name a path that does not exist 2026-09-29 09:28:29 +08:00
show_anchors.py docs: close the TTL gap, re-anchor drifted code refs, add anchor tooling 2026-09-30 13:20:13 +08:00
validate_docs.py docs: rename roadmap.md to opengaps.md and drop completed items 2026-09-29 19:38:38 +08:00