Skip to content

feat(scripts): link-rot guard — internal-pointer integrity as a standing check - #862

Merged
hyperpolymath merged 3 commits into
mainfrom
recon-2026-09-19/link-rot-guard
Sep 19, 2026
Merged

hyperpolymath merged 3 commits into
mainfrom
recon-2026-09-19/link-rot-guard

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

First census 2026-09-19: 677 broken internal links in this repo (441 outside the last-copy archive), including inside RSR-SPEC-v2.adoc itself (dead ../../a2ml/ pointer, off-by-one policy pointer) and 14 in rsr-template-repo. The deed-pointer sweep proved the fix pattern works by hand; this makes it a standing, CI-runnable check (just link-rot-guard).

Checks real link syntax only (asciidoc link:/image:, markdown relative links). The vendored rhodium-standard-repositories/ tree is excluded as a documented last-copy archive (standards-map: "ARCHIVE, do not delete"; upstream 404s) - its links are historical by definition.

The 441 live findings are the fix backlog for follow-up PRs; the guard going green is a P2 item, not a gate for this PR.

…ing check

The estate has repeatedly shipped docs pointing at paths a reorg moved
(2026-09-19 first census: 677 broken internal links in this repo, 194
outside the vendored dir and proof artefacts — including inside
RSR-SPEC-v2.adoc itself: dead ../../a2ml/ pointer, off-by-one
TEMPLATE-APPLICABILITY-POLICY pointer; and 14 in rsr-template-repo).
The deed-pointer sweep (f5ba975) proved the fix pattern works by hand;
this makes it a standing, CI-runnable check.

Checks real link syntax only (asciidoc link:/image:, markdown
[text](path)); relative targets; http/mailto/absolute/fragment-stripped
excluded; code-quoted paths deliberately not checked (false-positive
class). Exit 1 on any BROKEN finding.
@coderabbitai

coderabbitai Bot commented Sep 19, 2026 •

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

Next included review available in 57 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: c04fabbd-9183-4028-bc63-14be078b5e4e

📥 Commits

Reviewing files that changed from the base of the PR and between 7acfded and c808bcb.

📒 Files selected for processing (2)
  • Justfile
  • scripts/link-rot-guard.sh

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@hyperpolymath
hyperpolymath merged commit 097ac91 into main Sep 19, 2026
1 check passed
@hyperpolymath
hyperpolymath deleted the recon-2026-09-19/link-rot-guard branch September 19, 2026 19:43
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant