feat(wiki-lint): check #4 — top-level docs dangling links #227

Merged
clawdie merged 1 commit from fix/wiki-lint-cover-top-level-docs into main 2026-06-26 22:11:14 +02:00

1 commit

Author SHA1 Message Date
Sam & Claude
8ffbf09f12 feat(wiki-lint): check #4 — top-level docs dangling links
Some checks are pending
CI / rust (pull_request) Waiting to run
CI / markdown (pull_request) Waiting to run
CI / port (pull_request) Waiting to run
CI / agent-jail-pkgs (pull_request) Waiting to run
PR #224 fixed two stale references to removed docs by hand. The root
cause: wiki-lint only validated docs/wiki/, never the top-level
docs/*.md — so a doc could link to a removed sibling forever with
nothing to catch it.

Add check #4: scan docs/*.md for two doc-reference patterns and
verify they resolve (relative to docs/ or repo root):

  a) markdown links [label](local.md) — the exact #224 bug class
  b) backtick SHOUTING-CASE .md refs (e.g. `FOO-BAR.md`)

Scoped to doc-to-doc references deliberately. External URLs, anchors,
and cross-repo paths are skipped, and bare lowercase source filenames
(env.sh, build.sh — often runtime/contextual) are out of scope, so
the check has zero false positives on current main (171 pass) and
fail-closes under --strict (which CI already runs).

Calibrated by injecting fake removed-doc links: both the markdown
link and the backtick doc-name ref are detected and exit non-zero.

(Sam & Claude)
2026-06-26 21:50:07 +02:00