Skip to content

backlog(B-0141): brittle-pointer auto-rewriter — section-number to anchor-link / stable-ID (Aaron 2026-05-01; ID reserved 2 days ago, never filed)#1347

Merged
AceHack merged 1 commit intomainfrom
backlog/B-0141-brittle-pointer-anchor-link-auto-rewriter-aaron-2026-05-01
May 3, 2026
Merged

backlog(B-0141): brittle-pointer auto-rewriter — section-number to anchor-link / stable-ID (Aaron 2026-05-01; ID reserved 2 days ago, never filed)#1347
AceHack merged 1 commit intomainfrom
backlog/B-0141-brittle-pointer-anchor-link-auto-rewriter-aaron-2026-05-01

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented May 3, 2026

Summary

Files `B-0141` — the row Aaron 2026-05-03 referenced in the B-0176 casing-fix discussion. The ID was reserved by Aaron 2026-05-01 in the parallelism-scaling-ladder memo's mechanized-guardrail table:

| Brittle-pointer (B-0141, not yet filed) | Pre/post check fails | Auto-rewriter converts §N → anchor-link |

Two days later (2026-05-03) the per-row file still didn't exist. Aaron caught it during the B-0176 casing review:

"B-0176 lowercase-title vs B-0170 there is a baclog item for md links that survive rename where possible"

"it might have the word technical numbering or somthing in it"

Empirical validation of B-0177

This row's existence IS the first concrete hit for B-0177's audit hypothesis: "a lot of backlog lost in our memories." The parallelism-scaling-ladder memo named the B-0141 ID; the row never materialized; nobody noticed until Aaron remembered + flagged.

Row scope

Auto-rewriter that converts brittle pointers to less-brittle forms:

  • Brittle: `§N` section-numbers (break under renumbering); direct paths (break under rename)
  • Less brittle: anchor-links `path#heading-slug` (survive renumbering, break under heading-text-edit)
  • Most stable: B-NNNN / BP-NN IDs (survive renumbering AND filename rename)

Detection regex → markdown-AST resolution → rewrite to stable form → bidirectional check.

Composes with

  • B-0170 (substrate-claim-checker): sibling-instance of mechanized-quality-tooling
  • B-0175 (substrate-retrieval-index): layer-3 mechanization that helps layer-4 active retrieval find correct targets
  • B-0177 (audit memos for misfiled backlog): B-0141 IS the first concrete hit for B-0177's audit; demonstrates the failure mode in the substrate

Test plan

  • Backlog row format follows existing P2 convention
  • BACKLOG.md regenerated to include B-0141 with capitalized title
  • markdownlint passes locally
  • Composes-with chain references B-0170, B-0175, B-0177

…chor-link / stable-ID conversion (Aaron 2026-05-01; reserved ID never filed; surfaced 2026-05-03)

Aaron 2026-05-01 named "B-0141, not yet filed" in the parallelism-
scaling-ladder memo's mechanized-guardrail table. ID was reserved;
per-row file was never filed. Aaron 2026-05-03 reminder during
B-0176 casing review surfaced the missing row: "B-0176 lowercase-
title vs B-0170 there is a baclog item for md links that survive
rename where possible".

This is empirical evidence FOR B-0177's hypothesis (memos contain
backlog candidates that should have been filed as B-NNNN rows): the
parallelism-scaling-ladder memo named the B-0141 ID, the row never
materialized, two days later it's still missing — caught only because
Aaron remembered.

The row scope: auto-rewriter that converts brittle section-number
pointers (§N, §N.M) to less-brittle forms (anchor-links via heading-
text slug, OR stable B-NNNN/BP-NN IDs where applicable). Composes
with B-0170 (substrate-claim-checker), B-0175 (retrieval-index),
B-0177 (audit pass — this row IS the audit's first concrete hit).

Brittleness ranking: B-NNNN/BP-NN IDs > anchor-links > section-
numbers > direct paths. Stable forms survive renumbering AND/OR
rename; brittle forms break under one or both.
Copilot AI review requested due to automatic review settings May 3, 2026 07:38
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack enabled auto-merge (squash) May 3, 2026 07:38
@AceHack AceHack merged commit ca2e578 into main May 3, 2026
24 checks passed
@AceHack AceHack deleted the backlog/B-0141-brittle-pointer-anchor-link-auto-rewriter-aaron-2026-05-01 branch May 3, 2026 07:40
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the missing backlog row B-0141 (referenced previously but never filed) and updates the main backlog index so the item is visible and trackable.

Changes:

  • Add docs/backlog/P2/B-0141-… describing the “brittle-pointer auto-rewriter” tool concept and its motivation.
  • Update docs/BACKLOG.md to include a new P2 checkbox entry for B-0141.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/backlog/P2/B-0141-brittle-pointer-anchor-link-auto-rewriter-aaron-2026-05-01.md New P2 backlog row capturing scope/motivation for rewriting brittle §N refs into more stable link/ID forms.
docs/BACKLOG.md Adds B-0141 to the P2 index list so it’s discoverable from the main backlog.

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.

2 participants