Skip to content

Fan-out the last 4 plan docs → .dag (ci-humming, edge-b, realization-measurement-loop, resolver-type-name-collision-wall) - #5727

Merged
briansrls merged 13 commits into
mainfrom
chore/dedup-plan-md-helpers
Jun 24, 2026
Merged

briansrls merged 13 commits into
mainfrom
chore/dedup-plan-md-helpers

Conversation

@gunbai-bot

@gunbai-bot gunbai-bot Bot commented Jun 24, 2026 •

Copy link
Copy Markdown
Contributor

What

Sweep of docs/plans/*.md against the plan-registry projection discipline (every plan doc is a generated projection of a .dag Plan authority, drift-gated). Four recently-committed plan docs were hand-written and not represented in .dag — the only gap in the corpus:

  • ci-humming
  • edge-b-rust-dag-provenance-brief
  • realization-measurement-loop
  • resolver-type-name-collision-wall

This models each as a gunbc.plans.* Plan (using the shared gunbc.plans.md_helpers), registers them in a new plan_registry_batch_g, and regenerates the four .md from the model so they are byte-exact projections. After this, all 35 docs/plans/*.md are registry-backed; ROADMAP.md/DESIGN.md (and the README/CLAUDE symlinks to DESIGN.md) were already modeled.

Fidelity

The .md line churn is purely hard-wrap → single-line-paragraph normalization plus the appended ## Dissolution trigger (DESIGN §6) section the discipline requires. Content was verified character-identical to the originals (whitespace/wrap/list-marker/blockquote/hr/table-separator normalization aside) by a normalized word-stream comparison for all four docs. Tables, code blocks, blockquotes, ordered/unordered lists, and horizontal rules are all preserved.

main's T6 (cpu.weight axis) bullet, hand-added to ci-humming.md in parallel, was folded into the model on merge so it is not lost.

Verified by execution

  • run_generated_artifact_drift_gate → ExitSuccess (every committed artifact == its generated projection, including the 4 new docs)
  • generated_artifact_drift_witnesses → PASS (registry complete + per-artifact red receipts)
  • every_registered_plan_has_dissolution_trigger / every_registered_plan_is_titled → PASS

Out of scope

Non-plan .md (runbooks under docs/runbooks/, directory README.mds, src/v2/LAYOUT.md, gunbc-planning/*) are not under the plan-registry projection discipline and are left as-is.

🤖 Generated with Claude Code

briansrls and others added 13 commits June 23, 2026 19:20
The 29 plan modules each defined byte-identical copies of the markdown
construction helpers (h2/h3/p/li/li_blocks/ul/ol/cell/row/quote/tasks/todo/
task/hr) — a §2-horizontal redundancy flagged by the api-review on #5655.

Extract one authority `gunbc.plans.md_helpers` and repoint every module to
import the helpers it uses, removing the per-module duplicates. Also
consolidates the `quote`/`bq` nickname fork (§3) onto the single name `quote`.
Each module's `std.markdown` import is pruned to only the types its body
still references directly.

Pure refactor — zero output change. Verified by execution:
generated_artifact_drift_witnesses=true (all 29 docs byte-identical) and
both §6 lenses (every_registered_plan_has_dissolution_trigger /
_is_titled)=true. Net -316 lines.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…ion drift)

The auto-merge of origin/main into this branch collided on
dsl_v2_defork_audit.dag: main added the '2A. 2026-06-23 executed Q2
confirmation' section (#5652/#5640) to both the model and the committed .md,
but the conflict resolution kept this branch's dedup'd model (pre-2A),
dropping 39 lines of model content while the .md kept them — so
generated_artifact_drift_gate went red (regen deleted 2A from the .md).

Fix: take main's self-consistent model+\.md for this doc and re-apply the
md_helpers dedup to it. Now the model reproduces the committed .md byte-exact
(2A intact). Verified: run_generated_artifact_drift_gate=ExitSuccess,
generated_artifact_drift_witnesses=true, §6 lenses=true.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
main #5688-era hand-added a T6 bullet to docs/plans/ci-humming.md while this
branch was modeling ci-humming as a .dag Plan; the merge combined both but left
the model without T6 (drift). Add the T6 li to ci_humming.dag so the regenerated
.md reproduces it byte-exact.

Verified: run_generated_artifact_drift_gate=ExitSuccess, all plan witnesses PASS.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gunbai-bot gunbai-bot Bot changed the title get design docs into .dag Fan-out the last 4 plan docs → .dag (ci-humming, edge-b, realization-measurement-loop, resolver-type-name-collision-wall) Jun 24, 2026
@gunbai-bot
gunbai-bot Bot marked this pull request as ready for review June 24, 2026 14:24
@briansrls
briansrls merged commit 948fa1e into main Jun 24, 2026
2 checks passed
@briansrls
briansrls deleted the chore/dedup-plan-md-helpers branch June 24, 2026 15:07
briansrls added a commit that referenced this pull request Jun 24, 2026
… shell (§2 handler by emission)

Re-apply the post-operator apply-transport redirect into the migrated .dag
authority (dsl/gunbc/plans/ci_humming.dag, post #5727) + regenerate the
docs/plans/ci-humming.md projection:
- T5 reframed: host apply via gunbc-emitted .github/fleet-converge.sh (the §2
  regime-2 Doc-IR projection handler that inhabits the §6 carrier by emission),
  thin ctrl consume/run; supersedes the closed JS reconciler #1803.
- C1: reconcile -> reconcile_grounded (the flat-namespace collision PR2 #5720
  surfaced when grounding newly executed the fn in a closure holding two other
  reconcile fns).
- New "Re-sequence 2026-06-24" section: A (converge emit #5725) / B (thin
  consume/run #1805) / G (membership conjunct #5726) + the fail-closed
  grounding order.

Supersedes the closed #5723 (which edited the .md directly, pre-migration).
Verified green-by-execution: plan-lens (dissolution-trigger + titled) PASS,
read-side generated-artifact drift gate ExitSuccess (disk == projection),
regen idempotent.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
briansrls added a commit that referenced this pull request Jun 24, 2026
… shell (§2 handler by emission) (#5728)

Re-apply the post-operator apply-transport redirect into the migrated .dag
authority (dsl/gunbc/plans/ci_humming.dag, post #5727) + regenerate the
docs/plans/ci-humming.md projection:
- T5 reframed: host apply via gunbc-emitted .github/fleet-converge.sh (the §2
  regime-2 Doc-IR projection handler that inhabits the §6 carrier by emission),
  thin ctrl consume/run; supersedes the closed JS reconciler #1803.
- C1: reconcile -> reconcile_grounded (the flat-namespace collision PR2 #5720
  surfaced when grounding newly executed the fn in a closure holding two other
  reconcile fns).
- New "Re-sequence 2026-06-24" section: A (converge emit #5725) / B (thin
  consume/run #1805) / G (membership conjunct #5726) + the fail-closed
  grounding order.

Supersedes the closed #5723 (which edited the .md directly, pre-migration).
Verified green-by-execution: plan-lens (dissolution-trigger + titled) PASS,
read-side generated-artifact drift gate ExitSuccess (disk == projection),
regen idempotent.

Co-authored-by: Brian Searls <briansrls@gunb.ai>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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