fix(writings): align biblical-roots appendix forward-ref to auto-heal target#174
Merged
fix(writings): align biblical-roots appendix forward-ref to auto-heal target#174
Conversation
… 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.
Canon Quality —
|
klappy
added a commit
that referenced
this pull request
May 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Aligns the appendix forward-reference in
the-broken-wall-and-the-buried-talent.mdto 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-rootsas a dead reference. The draft does exist atdraft-zeros/appendix-a-the-biblical-roots.md, but its frontmatter declaresuri: klappy://writings/the-biblical-roots. The mismatch meant the existingaudit-allowdirective 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 matchingcomplements:path) to the future homeklappy://writings/the-biblical-roots:related:URI in frontmattercomplements:fieldaudit-allowcomment 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-ai→preface-nothing-new-even-airename inagentic-software-development.md, and the four/page/...→klappy://...conversions ingetting-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-everythinginchoosing-faith-not-fear.mdandthe-voice-came-first.md) need no change — they already align withdraft-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.mdto consistently reference the appendix viaklappy://writings/the-biblical-rootsinstead of the olddraft-zeros/appendix-a-the-biblical-rootsslug.This adjusts the frontmatter
relatedentry, thecomplementslist, the closing inline appendix link, and theaudit-allownote 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.