Skip to content

docs: correct namespace-resolution census fork-worklist (0 consolidate-now forks) - #6334

Merged
briansrls merged 1 commit into
mainfrom
session/loyal-dove-903-doc-fix
Jul 6, 2026
Merged

briansrls merged 1 commit into
mainfrom
session/loyal-dove-903-doc-fix

Conversation

@gunbai-bot

@gunbai-bot gunbai-bot Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Small follow-up to the merged #6329. Docs-only (DESIGN.md + the design doc), no code.

On investigating the census's "2 real §3 forks" worklist, both proved to be false positives — the doc + DESIGN.md were sending an implementer to a wrong consolidation, so this corrects them:

  • Reconciliation is a homonym, not a fork. std.realization_reconcile.Reconciliation<A,E> = Converged|NotConverged (a generic effect-grounding outcome) vs product.budget_tree.Reconciliation = AllSatisfied|Evicted|GuaranteedShortfall (a budget-admission outcome). Different concepts and variant sets — the "identical variant-set" was a census variant-extraction artifact. Consolidating would be wrong.
  • ImportTrigger is seed-file duplication, not a standalone fork — 1 of 8 types in a whole-file v1-seed mirror (src/v1/languages.dag ↔ dag/std/languages.dag), DESIGN §7 seed-shrink territory.

Net: the census forces zero consolidate-now forks; the same-name residue is homonyms (resolve by subtree under nearest-wins) + seed-file duplication (dissolves with the seed).

Docs-only; ci floor is pre-existing-red (compile-wall #6239), rust_tests is the relevant gate.

🤖 Generated with Claude Code

…te-now forks

Follow-up to #6329. Verified by reading the decls (2026-07-06): the 2 same-name
pairs the census flagged are NOT genuine cross-tree §3 forks, so the doc + DESIGN.md
should not send an implementer to merge them:
- Reconciliation is a HOMONYM — std.realization_reconcile.Reconciliation<A,E>
  (Converged|NotConverged, effect-grounding) vs product.budget_tree.Reconciliation
  (AllSatisfied|Evicted|GuaranteedShortfall, budget-admission). Different concepts;
  the 'identical variant-set' was a census extraction artifact. Consolidating = wrong.
- ImportTrigger is one of 8 types in a whole-file v1-seed mirror (src/v1/languages.dag
  vs dag/std/languages.dag) — DESIGN §7 seed-shrink, not standalone.

Corrects §5.1 + the DESIGN.md open-thread entry.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@briansrls
briansrls merged commit e0da1d4 into main Jul 6, 2026
1 of 3 checks passed
@briansrls
briansrls deleted the session/loyal-dove-903-doc-fix branch July 6, 2026 22:46
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