Skip to content

History / 09 Architecture Decisions Continued

Revisions

  • ADR-061 corrections: per-shape SITE_COUNT, structure-preserving canonical forms, σ-axis homogeneity Applies the architect's corrections to ADR-061 (in the AsciiDoc source; rendered pages regenerated): - Per-shape SITE_COUNT made explicit and consistent across the ADR §(2) bullets and the glossary entry: G2ProductShape = 2 × COMPONENT_LABEL_BYTES (binary); F4QuotientShape / E7AugmentationShape / E8EmbeddingShape = COMPONENT_LABEL_BYTES; E6FiltrationShape = COMPONENT_LABEL_BYTES + 1. - E6 filtration clarified as structure-preserving (not quotient-like): canonical form retains the operand bytes plus a one-byte degree-partition tag (degree-5 vs degree-6). - E7 augmentation clarified as canonical-form-internal: operand normalized to its S₄-orbit canonical representative, no prepended bytes. - E8 embedding clarified as identity on canonical-form bytes; the composed κ-label is distinguished from the operand's by realization-IRI provenance, not digest bytes. - Canonicalize-verb rule sharpened to enumerate all five per-shape rules (lexicographic-min-first for G2; mirror-class lex-min representative for F4; degree-partition tag for E6; S₄-orbit lex-min representative for E7; identity for E8) and to require the canonical form match the shape's SITE_COUNT. - New σ-axis-homogeneity requirement: all operand κ-labels of a composition share the composition's σ-axis (operands under different σ-projections live in different codomain spaces; no cross-σ-axis bridge is committed). Reflected in ADR-061 §(5), the ch 8 concepts summary, and the glossary entry. Cross-surface consistency verified: SITE_COUNT values agree between ADR bullets and glossary; σ-axis homogeneity present in ch 8/9/12. All eight validators pass; page-size guard OK (glossary 494 KiB, warning band, under limit). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @afflom afflom committed May 23, 2026
  • ADR-061 (Proposed): operational κ-label composition surface over the Atlas's categorical operations Prism-runtime-level decision building on ADR-058 + ADR-059; no foundation or SDK change. Operationalizes ADR-059's five categorical operations on the Atlas image inside E₈ — product (G₂), quotient (F₄), filtration (E₆), augmentation (E₇), direct embedding (E₈) — as five ConstrainedTypeShapes in prism's standard type library (G2ProductShape<N> binary; the other four unary). A composition of N component κ-labels under an operation is a typed-input value the existing ψ-pipeline consumes through the existing σ-projection; the realization's canonicalize verb emits a canonical form whose κ-label is the composed κ-label — itself a κ-label, recursively composable (closed under the Atlas). Arity ≤ 3 / depth ≤ 8 per the Categorical X regime split (ADR-025) and ADR-059's H-/O-level bounds; wide compositions decompose via ConstraintRef::Recurse (ADR-057). σ-axis substitutability (ADR-047) and cross-substrate universality (ADR-058 + ADR-059) lift to compositions. Byte-concatenation / tree-hash composition rejected (collapses ADR-059's algebraic codomain to byte-pigeonhole). Substrate footprint: foundation unchanged (TypedCommitment per ADR-048 and ObservablePredicate per ADR-049 closed sets retained; no wire-format change), SDK unchanged, prism gains the five standard-type-library shapes; audit-trail row marked "No." Propagation: ADR-061 section + audit row + heading (ADR-038 through ADR-061) in ch 9 (lands on the Continued page, now ~322 KiB); composition shapes added to the ch 5 standard-type-library entry; ch 8 ADR-058/059 cluster extended with the composition-surface reading; ch 4 strategic row cross-ref; a "κ-label composition shapes" glossary entry. Applied domain-neutral per the wiki's discipline: the downstream content- addressing realization crate, its Lean module paths, and its realization roster are generalized to "a content-addressing realization (Layer-3 per ADR-031)"; format names (PNG/PDF/GGUF/ONNX/JSON) kept as illustrative domains only. Audit resolved, while applying: the source ADR's principle numbering gap ((1)(2)(4)(5)(6) → renumbered (1)–(6)); a dangling prism::std_types::RouteShape reference (generalized to "route-declaration shapes," no such type in the wiki); and grounded "Categorical X" in the existing ADR-025 regime split (T=3 H-level, O=8 O-level) rather than as a free-floating theorem name. All eight validators (V1–V8) pass; page-size guard OK (glossary at 494 KiB — warning band, under the 512 KiB limit). Status: Proposed (as authored). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @afflom afflom committed May 23, 2026
  • Split Architecture Decisions page at ADR-038 (GitHub 512 KiB render limit) The Architecture Decisions chapter grew to ~695 KiB, exceeding GitHub's ~512 KiB per-page rich-markdown rendering limit: the live wiki truncated mid-ADR-46 (ADR-047 began at byte ~512,380, right at the boundary), so ADR-047 through ADR-060 did not render. Fix: stage-to-wiki-root.sh now splits the staged page at the first `## ADR-038 ` heading — the start of the "substrate-amendment audit trail (ADR-038 through ADR-NNN)" cohort. Page 1 (09-Architecture-Decisions.md, ~396 KiB) keeps the chapter intro, the audit-trail table, and ADR-001..037; page 2 (09-Architecture-Decisions-Continued.md, ~300 KiB) carries ADR-038 onward. Both pages are well under 512 KiB, so every ADR renders. New ADRs append to page 2; ADR-001..037 is stable, so the split point and page-1 size do not drift. The split is deterministic (first ADR-038 heading line), so Stage 5 idempotence holds; it runs after image-reference rewriting so page 2 inherits the already-rewritten tail. Cross-navigation links added in both directions; the Sidebar gains a nested "ADR-038 onward" entry under chapter 9. The source stays one .adoc (09_architecture_decisions.adoc), so V1 arc42 structural alignment is unaffected. All eight validators (V1-V8) pass; idempotence check clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

    @afflom afflom committed May 22, 2026