Skip to content

fix(writings): align biblical-roots appendix forward-ref to auto-heal target#174

Merged
klappy merged 1 commit intomainfrom
fix/biblical-roots-appendix-slug
May 5, 2026
Merged

fix(writings): align biblical-roots appendix forward-ref to auto-heal target#174
klappy merged 1 commit intomainfrom
fix/biblical-roots-appendix-slug

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented May 5, 2026

What

Aligns the appendix forward-reference in the-broken-wall-and-the-buried-talent.md to the URI the draft itself declares, so promotion of the draft will auto-heal the link instead of leaving an orphan.

Why

Audit job #36 reported klappy://draft-zeros/appendix-a-the-biblical-roots as a dead reference. The draft does exist at draft-zeros/appendix-a-the-biblical-roots.md, but its frontmatter declares uri: klappy://writings/the-biblical-roots. The mismatch meant the existing audit-allow directive could not actually self-heal on promotion — the link slug and the draft's declared URI disagreed.

Changes

One file, four edits, all rewriting klappy://draft-zeros/appendix-a-the-biblical-roots (and the matching complements: path) to the future home klappy://writings/the-biblical-roots:

  • related: URI in frontmatter
  • complements: field
  • inline body link in the closing teaser
  • audit-allow comment reason text (now references the actual auto-heal target)

Audit report context

The other 5 findings from canon-quality job #36 (the nothing-new-even-aipreface-nothing-new-even-ai rename in agentic-software-development.md, and the four /page/...klappy://... conversions in getting-started-with-odd-and-oddkit.md) are already resolved in main. The audit report appears stale relative to current HEAD.

The Ch.7 forward-refs (klappy://writings/four-questions-that-change-everything in choosing-faith-not-fear.md and the-voice-came-first.md) need no change — they already align with draft-zeros/ch07-four-questions-that-change-everything.md's declared URI and will auto-heal cleanly on promotion.

Disposition

Per operator decision (option B): fix the appendix slug to auto-heal, leave Ch.7 refs as-is.


Note

Low Risk
Low risk: updates only internal metadata and links in a single markdown article, with no functional code changes. Main risk is an incorrect target URI causing a broken cross-reference if the appendix path differs.

Overview
Updates writings/the-broken-wall-and-the-buried-talent.md to consistently reference the appendix via klappy://writings/the-biblical-roots instead of the old draft-zeros/appendix-a-the-biblical-roots slug.

This adjusts the frontmatter related entry, the complements list, the closing inline appendix link, and the audit-allow note so the forward-ref matches the appendix’s intended published URI and stops tripping dead-reference audits.

Reviewed by Cursor Bugbot for commit 27c7b4d. Bugbot is set up for automated code reviews on this repo. Configure here.

… target

The appendix link in the-broken-wall-and-the-buried-talent.md pointed at
klappy://draft-zeros/appendix-a-the-biblical-roots, but the draft itself
(draft-zeros/appendix-a-the-biblical-roots.md) declares its uri as
klappy://writings/the-biblical-roots. The slug mismatch meant promotion
to writings/ would NOT auto-heal the link.

Updates four references in this single file to the auto-heal target:
  - frontmatter related: uri
  - frontmatter complements: path (now writings/the-biblical-roots.md)
  - inline body link
  - audit-allow comment reason text

Ch.7 forward-refs in choosing-faith-not-fear.md and the-voice-came-first.md
were already aligned (klappy://writings/four-questions-that-change-everything
matches draft-zeros/ch07-four-questions-that-change-everything.md's declared
uri) and need no change.

The other 5 findings from canon-quality job #36 (the agentic-software-development
nothing-new-even-ai rename and the four /page/ paths in
getting-started-with-odd-and-oddkit.md) are already resolved in main; the audit
report appears stale relative to current HEAD.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 5, 2026

Canon Quality — oddkit_audit

No dead klappy:// references or legacy link patterns found in writings/. 39 files scanned.

Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #45

@klappy klappy merged commit 09dce85 into main May 5, 2026
2 checks passed
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