Find and fix broken markdown links in the repository. Use when links return "Cannot find file" or "Cannot find fragment" errors. Runs find-broken-links to detect problems, then repairs each broken link by locating the correct target or updating the fragment anchor.
Find all broken markdown links in the repository and fix each one.
nix develop -c find-broken-links from the repository root. Capture the output.
If the command fails (e.g., nix is not available), stop and tell the user.file:line:col: [ERROR] link-target
Reason
where Reason is either Cannot find file or Cannot find fragment.
Group errors by source file. Deduplicate entries that appear more than once
(the tool may report the same link under multiple reasons).Found 0 broken link(s), print "No broken links found." and stop.nix develop -c find-broken-links. Verify that fixed
links no longer appear in the output.find-broken-links output. Do not modify
any other links or file content.After all fixes, print a summary with three sections:
Fixed — one line per link fixed, in the format file:line: old-target → new-target.
Unresolvable — one line per link that could not be fixed, with the reason.
Counts — totals for fixed, unresolvable, and total broken links found.