Skip to content

ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections - #5531

Merged
briansrls merged 4 commits into
mainfrom
roadmap/transcription-authority
Jun 22, 2026
Merged

briansrls merged 4 commits into
mainfrom
roadmap/transcription-authority

Conversation

@briansrls

@briansrls briansrls commented Jun 22, 2026 •

Copy link
Copy Markdown
Contributor

ROADMAP transcription — author roadmap_authority as the .dag source + fold the 6 status corrections

The transcription increment of the ROADMAP inversion lane (docs/plans/invert-hand-maintained.md).
Authors the real ROADMAP as .dag data (gunbc.roadmap_authority) — the markdown analogue of
ci.yml's authored data ci_workflow, the single authority the ROADMAP.md projection derives from.

Frame is the win: the frame is modelled (sections, nested checkbox forests via dependency edges,
sub-group labels, plan-doc pointers, PR bindings); pure prose (section intros, the ◆ Milestones
spine) is fenced verbatim as opaque authored Strings (the §5 DecodeFidelity fence), never modelled
into medium constructs.

Model evolution (subsumes the slice-2 single-list section, no fork §3)

  • roadmap_model — SectionElement = Prose{content} | Group{label,nodes,edges}. A section is now an
    ordered element sequence (prose interleaved with labelled checkbox sub-groups). The old flat
    RoadmapSection{nodes,edges} is one Group{label:""}. Label is semantic text; the uniform
    **{label}:** frame is projection-owned (single authority).
  • roadmap_emit — emit-refs-from-binding: a DerivableLine emits its (#N/#M) annotation from
    prs (§3); mentions keep refs in their AuthoredLine prose. Section projection folds elements in order.
  • roadmap_document — RoadmapSection carries elements: List<SectionElement>.

The 6 status corrections (authored to MERGED REALITY)

Verification (green by execution)

All 5 roadmap witnesses true: status, model, emit, document, authority. The authority witness
proves the frame, the 6 corrections, emit-refs-from-binding, and the two ruling invariants — (a) prose
emits byte-verbatim incl internal markup, (b) ordered element interleaving — with a
perturbed-merged-set derivation discriminator and a reversed-order negative.

The effectful RoadmapGate (read ROADMAP.md + byte-compare) is deferred to a later increment
(checkpoint to the lane owner before it lands), per the lane design.

Notes

🤖 Generated with Claude Code

briansrls and others added 3 commits June 22, 2026 14:40
…leLine|AuthoredLine)

Subsume the slice-1 CompletionBinding (CompletesIff|HandChecked) one layer down into a
single RoadmapItem line authority that carries per-arm content (§3 no fork): a DerivableLine
{prs,title,description} derives its box + emits its title; an AuthoredLine {done,content} is
opaque prose emitted verbatim (the §5 DecodeFidelity fence). The mention-can't-derive
soundness is now STRUCTURAL — a mention is AuthoredLine content with no prs, so the bad
"mention => derived box" state is unwritable, not runtime-rejected (§5 construction).

status_drift reparameterizes claimed_done (a stored box) -> committed_box argument (the box
is host-fed at drift time, not copied into the authority). Ripples through roadmap_model
(RoadmapNode.line: RoadmapItem; node_status_drift takes committed_box), roadmap_emit
(line_inlines dispatches both arms), roadmap_document (comment only), and all four witnesses.

All four green by execution (status/model/emit/document); golden ROADMAP bytes unchanged
(AuthoredLine bakes the bold into content, DerivableLine title emit-bolded).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gunbai-bot gunbai-bot Bot changed the title Continue the ROADMAP inversion lane - successor to archived quiet-hawk-47 - open step-3b from the durable wip branch wip/quiet-hawk-47-step3b as a PR off fresh main then do the real-ROADMAP transcription into roadmap_authority folding 6 status corrections per the frame-is-the-win and prose-as-fenced ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections Jun 22, 2026
@gunbai-bot
gunbai-bot Bot marked this pull request as ready for review June 22, 2026 15:12
@gunbai-bot gunbai-bot Bot changed the title ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections [STACKED on #5529 — MERGE #5529 FIRST] ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections Jun 22, 2026
…-authority

# Conflicts:
#	dsl/gunbc/roadmap_emit.dag
#	dsl/test/claim/roadmap_document_test.dag
#	dsl/test/claim/roadmap_emit_test.dag
@gunbai-bot gunbai-bot Bot changed the title [STACKED on #5529 — MERGE #5529 FIRST] ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections ROADMAP transcription: author roadmap_authority as the .dag source + fold 6 status corrections Jun 22, 2026
@gunbai-bot

gunbai-bot Bot commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

#5529 (step-3b) has merged, so I merged fresh main into this branch — the 3b overlap reconciled and dropped out; the diff is now transcription-only (roadmap_authority + the SectionElement/emit-refs evolution + 3 tests). Conflicts in roadmap_emit/document_test/emit_test were resolved by taking this branch's superset (3b base + transcription). All 5 roadmap witnesses (status/model/emit/document/authority) re-verified green by execution post-merge; mergeable=MERGEABLE. Removed the now-obsolete [MERGE #5529 FIRST] title guard (the twin hazard is gone). The head bump stales the prior approval — re-review welcome. — sent from merry-deer-299

@briansrls
briansrls merged commit 48dd3ec into main Jun 22, 2026
1 check passed
@briansrls
briansrls deleted the roadmap/transcription-authority branch June 22, 2026 17:30
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