diff --git a/DOCUMENTATION_STATUS.adoc b/DOCUMENTATION_STATUS.adoc index c9643736..cfcf821d 100644 --- a/DOCUMENTATION_STATUS.adoc +++ b/DOCUMENTATION_STATUS.adoc @@ -6,11 +6,11 @@ [arabic] . *Core Bridge Documentation* -* `+docs/EchoJanusBridge.md+` - Comprehensive explanation of echo types +* `+docs/bridges/EchoJanusBridge.adoc+` - Comprehensive explanation of echo types → JanusKey bridge * `+roadmap.adoc+` §"`Deferred research track`" - Strategic proof -development roadmap (consolidated from former `+docs/ProofRoadmap.md+`) -* `+docs/COMPREHENSIVE_DOCUMENTATION.md+` - Complete 3-2-1 structured +development roadmap (consolidated from the former proof-roadmap note) +* `+docs/COMPREHENSIVE_DOCUMENTATION.adoc+` - Complete 3-2-1 structured documentation . *Formal Proofs* * `+proofs/agda/EchoJanusBridge.agda+` - Core bridging theorems @@ -54,8 +54,8 @@ documentation * Comprehensive documentation in `+docs/+` * Updated `+All.agda+` module . *JanusKey Repository* -* Existing formal proofs directory: `+docs/wiki/formal-proofs/+` -* Theory documentation: `+docs/wiki/theory/formal-model.adoc+` +* Existing formal proofs directory (januskey repository): `+docs/wiki/formal-proofs/+` +* Theory documentation: `+docs/wiki/theory/formal-model.adoc+` in the januskey repository * Ready for echo type integration . *MAA Framework* * Potential integration with absolute-zero proofs @@ -94,10 +94,10 @@ code * [x] Create `+EchoJanusBridge.agda+` with core theorems * [x] Update `+All.agda+` to include new module -* [x] Write `+EchoJanusBridge.md+` documentation -* [x] Consolidate `+ProofRoadmap.md+` into `+roadmap.adoc+` (single +* [x] Write `+docs/bridges/EchoJanusBridge.adoc+` documentation +* [x] Consolidate the former proof-roadmap note into `+roadmap.adoc+` (single canonical roadmap) -* [x] Develop `+COMPREHENSIVE_DOCUMENTATION.md+` (3-2-1 structure) +* [x] Develop `+docs/COMPREHENSIVE_DOCUMENTATION.adoc+` (3-2-1 structure) * [x] Verify Agda proofs compile successfully * [ ] Add architecture diagrams * [ ] Create integration tests diff --git a/FOUNDATIONS_BRIDGE.adoc b/FOUNDATIONS_BRIDGE.adoc index eabaab4c..11005a34 100644 --- a/FOUNDATIONS_BRIDGE.adoc +++ b/FOUNDATIONS_BRIDGE.adoc @@ -18,9 +18,9 @@ Source of truth: |=== |Foundation |Axis exported |Contract |Machine-checked in |`+tropical-resource-typing+` |resource-grade axis -|`+FOUNDATION_CONTRACT.md+` |Lean 4 `+Resource.*+` +|`+FOUNDATION_CONTRACT.adoc+` |Lean 4 `+Resource.*+` -|`+echo-types+` |residual-modality axis |`+FOUNDATION_CONTRACT.md+` +|`+echo-types+` |residual-modality axis |`+FOUNDATION_CONTRACT.adoc+` |Agda `+Echo.*+` (`+--safe --without-K+`) |=== @@ -202,8 +202,8 @@ sharper informative-measure witness ''''' -_This brief restates the two `+FOUNDATION_CONTRACT.md+` files for the +_This brief restates the two `+FOUNDATION_CONTRACT.adoc+` files for the downstream direction and adds nothing to them. For the full contracts and the parametric transport / anti-collapse theorems, read each -foundation’s `+FOUNDATION_CONTRACT.md+` and (tropical) +foundation’s `+FOUNDATION_CONTRACT.adoc+` and, in the tropical foundation's own repository, `+docs/ECHO-RESIDUE-BRIDGE.adoc+`._ diff --git a/GLOSSARY.adoc b/GLOSSARY.adoc index b54b99b0..2ce29a43 100644 --- a/GLOSSARY.adoc +++ b/GLOSSARY.adoc @@ -190,7 +190,7 @@ Differential surface:: [[foundation-contract]] Foundation contract:: - The stable API surface (`Echo.*` namespace + `FOUNDATION_CONTRACT.md`) that downstream languages depend on, isolating them from research sprawl. + The stable API surface (`Echo.*` namespace + `FOUNDATION_CONTRACT.adoc`) that downstream languages depend on, isolating them from research sprawl. *Classification:* **project-specific**. [[anti-collapse-separation]] @@ -416,7 +416,7 @@ Differential surface:: [[foundation-contract]] Foundation contract:: - The stable API surface (`Echo.*` namespace + `FOUNDATION_CONTRACT.md`) that downstream languages depend on, isolating them from research sprawl. + The stable API surface (`Echo.*` namespace + `FOUNDATION_CONTRACT.adoc`) that downstream languages depend on, isolating them from research sprawl. *Classification:* **project-specific**. == Audience surfaces diff --git a/INDEX.adoc b/INDEX.adoc index b533d11d..047943a0 100644 --- a/INDEX.adoc +++ b/INDEX.adoc @@ -43,7 +43,7 @@ Current reader navigation has two later additions relevant to the public description of the repo: * Semantic-fibre vocabulary now lives in `README.md`, - `docs/echo-types/overview.md`, and `docs/echo-types/taxonomy.md`. + `docs/echo-types/overview.adoc`, and `docs/echo-types/taxonomy.adoc`. It distinguishes semantic fibre, avec fibre, sans fibre, residue, provenance/trace, and warrant. * Doc-side prototype sketches live under @@ -281,8 +281,8 @@ Distinctness against neighbour frameworks rests on the *truncation argument* (`echo-not-prop` family in `proofs/agda/examples/`, formalising that for non-injective `f` with multiple preimages of `y`, `Echo f y` is constructively not a mere proposition) and the -*2-cell argument* (Sophisticated submodules of `EchoVsQuotient.agda` -and `EchoVsGalois.agda`, formalising that natural 2-cells in +*2-cell argument* (Sophisticated submodules of the `EchoVsQuotient` +and `EchoVsGalois` modules, absent from the current tracked tree, formalising that natural 2-cells in neighbour frameworks are Σ-over-preimages-shaped). The integration recipe is *organising vocabulary*, not the locus of distinctness. diff --git a/README.adoc b/README.adoc index be7813b5..966f0901 100644 --- a/README.adoc +++ b/README.adoc @@ -200,7 +200,7 @@ Intended proof-use cases: non-injective computation, provenance, structured irre == Foundation Contract -If you are wiring Echo into another language, the stable entry point is `FOUNDATION_CONTRACT.md` plus the curated `Echo.*` namespace. It re-exports the proven core behind a small surface so you depend on the contract, not the research sprawl: +If you are wiring Echo into another language, the stable entry point is `FOUNDATION_CONTRACT.adoc` plus the curated `Echo.*` namespace. It re-exports the proven core behind a small surface so you depend on the contract, not the research sprawl: [cols="1,2", options="header"] |=== diff --git a/TOPOLOGY.adoc b/TOPOLOGY.adoc index 4063113b..3cd685af 100644 --- a/TOPOLOGY.adoc +++ b/TOPOLOGY.adoc @@ -38,7 +38,7 @@ echo-types/ └── (RSR template files at root) ---- -For planned work use link:roadmap.adoc[roadmap.adoc]; no uppercase `ROADMAP.adoc` exists in this checkout. +For planned work use link:roadmap.adoc[roadmap.adoc]; no uppercase-named roadmap file exists in this checkout. == Cross-repo dependencies diff --git a/_handoff.adoc b/_handoff.adoc index fd77001d..be61ec05 100644 --- a/_handoff.adoc +++ b/_handoff.adoc @@ -26,7 +26,7 @@ pieces as a stdlib `+Function.Bundles._↔_+` record. * `+CLAUDE.md+` — updated composition-track summary (cancel-iso staleness fixed, pentagon marked complete) and Phase 1.3 sub-bullet under "`Open at this rung`" marked landed. -* `+docs/echo-types/composition.md+` — Q4 ("`Pentagon coherence`") +* `+docs/echo-types/composition.adoc+` — Q4 ("`Pentagon coherence`") flipped from "`partially landed`" to "`landed`" with the `+Echo-comp-pent-Σ-assoc+` reference. @@ -120,7 +120,7 @@ The full frontier punch list from this session: . *`+rank-mono+`* in `+RankBrouwer.agda+` — falls out from #1 . *Unbudgeted `+wf-<ᵇʳᶠ+`* — assembled from #2 . *`+_<ᵇ⁺_+` WF Route B* — uses the same `+rank+` machinery; design note -at `+docs/echo-types/buchholz-extended-wf.md+` +at `+docs/bridges/buchholz-extended-wf.adoc+` . *Push surface-route WF back into `+Order.agda+`’s main `+_<ᵇ_+`* — gated on #4 . *EchoApprox headline pinning* — minor: diff --git a/core/skepticisms/is-this-just-sigma-types.adoc b/core/skepticisms/is-this-just-sigma-types.adoc index bc8ad10b..8918abe8 100644 --- a/core/skepticisms/is-this-just-sigma-types.adoc +++ b/core/skepticisms/is-this-just-sigma-types.adoc @@ -62,7 +62,7 @@ is one-way (defined as the residue lemma). case. All six are pinned in `+Smoke.agda+`. The family is what carries the -weight only as selected examples: each non-injective collapse lacks a left inverse. Raw Σ can express exactly these examples; it admits no missing inverse. See also `+docs/theorem-index.md+` and the prose write-up +weight only as selected examples: each non-injective collapse lacks a left inverse. Raw Σ can express exactly these examples; it admits no missing inverse. See also `+docs/theorem-index.adoc+` and the prose write-up at `+docs/characteristic.adoc+`. ==== 2. Loss is graded, and downgrades cannot be reversed @@ -161,12 +161,12 @@ the "`raw Σ would leak`" claim is prose, not a checked artefact. * Gate 2 audit (closest reviewer touchpoint): `+docs/characteristic.adoc+`. -* Theorem-by-theorem ledger: `+docs/theorem-index.md+`. +* Theorem-by-theorem ledger: `+docs/theorem-index.adoc+`. * Adjacency notes (per neighbour framework): `+docs/adjacency/+`. * Honest scope of the establishment claim: `+docs/echo-types/establishment-plan.adoc+` and `+docs/echo-types/paper.adoc+` §"`Reframing note`". * AsciiDoc reviewer companion to this file: `+docs/echo-types/sigma-distinctness-map.adoc+`. -* Companion skepticisms: `+is-this-just-fibers.md+`, -`+what-is-actually-new.md+`, `+failure-conditions.md+`. +* Companion skepticisms: `+is-this-just-fibers.adoc+`, +`+what-is-actually-new.adoc+`, `+failure-conditions.adoc+`. diff --git a/docs/CLAIMS_AUDIT.adoc b/docs/CLAIMS_AUDIT.adoc index 6b104dea..cada48cc 100644 --- a/docs/CLAIMS_AUDIT.adoc +++ b/docs/CLAIMS_AUDIT.adoc @@ -253,7 +253,7 @@ paper's own abstract grows into. | readme-status | degrade-law family lands across decoration layers (graded, linear/affine, choreographic, access, cost, search) | `EchoGraded.degrade-compose` + `EchoLinear.degradeMode-compose` + `EchoChoreo.applyChoreo-compose` + `EchoAccess` + `EchoCost` + `EchoSearch` -| Six decoration layers named; per-layer headlines listed in `docs/theorem-index.md`. +| Six decoration layers named; per-layer headlines listed in `docs/theorem-index.adoc`. | MATCHES | All six decoration layers ship a degrade-style composition headline: `EchoGraded.degrade-compose`, `EchoLinear.degradeMode-compose`, `EchoChoreo.applyChoreo-compose`, `EchoAccess.degrade-access-compose`, `EchoCost.echo-cost-compose`, `EchoSearch.echo-search-postcompose`/`relax` — all built `--safe --without-K`. diff --git a/docs/EI2_READINGS_COMPARISON.adoc b/docs/EI2_READINGS_COMPARISON.adoc index 22a00f62..49fd7646 100644 --- a/docs/EI2_READINGS_COMPARISON.adoc +++ b/docs/EI2_READINGS_COMPARISON.adoc @@ -36,8 +36,8 @@ The integration recipe with the existing five named axes does not carry substantive simultaneous cross-axis content. Distinctness against neighbour frameworks rests on the truncation argument (`echo-not-prop` family in `proofs/agda/examples/`) and the -2-cell argument (Sophisticated submodules in `EchoVsQuotient.agda` -and `EchoVsGalois.agda`), not on the integration argument. +2-cell argument (Sophisticated submodules of the `EchoVsQuotient` +and `EchoVsGalois` modules, absent from the current tracked tree), not on the integration argument. See `EI2_REPORT.adoc` for the authoritative termination record. The companion files `EI2_READING1_PATCHES.adoc` and diff --git a/docs/adjacency/INSERTION_NOTE.adoc b/docs/adjacency/INSERTION_NOTE.adoc index 4090ae52..d3397e43 100644 --- a/docs/adjacency/INSERTION_NOTE.adoc +++ b/docs/adjacency/INSERTION_NOTE.adoc @@ -39,9 +39,8 @@ Briefly: `proofs/agda/examples/`. * *2-cell arguments* (quotients, Galois): echo wins because the natural 2-cell in the neighbour's framework is - Σ-over-preimages-shaped. Formal certificates are - `EchoVsQuotient.Sophisticated.equalizer→echo-pair` and - `EchoVsGalois.Sophisticated.meet→echo-intersection`. + Σ-over-preimages-shaped. No formal certificate for this argument + is in the tracked tree; see `docs/gate-1-distinct-phenomenon.adoc`. Two neighbours not in the original five-neighbour list are now also covered: @@ -69,8 +68,8 @@ The files: |=== The honest summary: gate #1 has a strong consolidated argument -plus formalised obstructions against the two strongest neighbours -(quotients, Galois) plus formalised truncation wins on three +plus historical (not currently checked) obstructions against the two +strongest neighbours (quotients, Galois) plus formalised truncation wins on three domains (tropical, epistemic, linear). The remaining neighbours have framed but only-partially-formalised distinctness claims; see each file for what's done and what's open. @@ -102,5 +101,5 @@ After the surgery: asked whether to do it) is closed by the existence of this directory. The QC.1 entry should be updated in `next-questions.adoc` to reflect closure. -* The `gate-1-handoff.adoc` cross-lane observations remain as +* The Gate 1 cross-lane observations remain as evidence of how the split was reached; no edit needed. diff --git a/docs/adjacency/README.adoc b/docs/adjacency/README.adoc index c7d25abc..53c7165b 100644 --- a/docs/adjacency/README.adoc +++ b/docs/adjacency/README.adoc @@ -62,7 +62,7 @@ Truncation arguments are load-bearing against: Echo wins because the natural 2-cell in the neighbour's framework is *Σ-over-preimages-shaped*, i.e., already echo-shaped, when incomparable kernels force a true 2-cell rather than a refinement -map. The formal certificates: +map. The historical certificates (their modules are absent from the tracked tree and are not current checked evidence; see `docs/gate-1-distinct-phenomenon.adoc`): * `EchoVsQuotient.Sophisticated.equalizer→echo-pair` — quotients' 2-categorical encoding's natural 2-cell is the equalizer of two @@ -207,7 +207,7 @@ this directory is the intended structure. == Axis coverage matrix (Gate 1 refresh 2026-05-20) Cross-reference of each adjacency note against the 8 taxonomy axes -defined in `docs/echo-types/taxonomy.md`. Refreshed 2026-05-20 — most +defined in `docs/echo-types/taxonomy.adoc`. Refreshed 2026-05-20 — most notes predate axis 8 (added with the `EchoDecidable`/`EchoFiberCount` landings) and therefore do not currently engage it; the open ○ markings below flag where axis-8 implications exist but are not @@ -325,8 +325,9 @@ the three n=2 instances. The remaining open work is the gate-2 Σ-reducible and forwards only the constructed-`y` form), not the formalisation. -The 2-cell argument has formal exhibits for both of its target -neighbours (quotients via `EchoVsQuotient.Sophisticated`, Galois +The 2-cell argument had formal exhibits for both of its target +neighbours, now historical and absent from the tracked tree, not current +checked evidence (quotients via `EchoVsQuotient.Sophisticated`, Galois via `EchoVsGalois.Sophisticated`). The remaining neighbours (IFC, provenance, modal type theories, @@ -337,7 +338,8 @@ to Q2.x or example work to Q3.x. These are not a reopening of EI-2's terminated integration-distinctness claim. The honest summary: gate #1 has a strong consolidated argument -plus formalised obstructions against the two strongest neighbours -(quotients, Galois) plus formalised truncation wins on three +plus historical obstructions against the two strongest neighbours +(quotients, Galois; their modules are absent from the tracked tree and are +not current checked evidence) plus formalised truncation wins on three domains (tropical, epistemic, linear). The remaining neighbours have framed but unformalised distinctness claims. diff --git a/docs/adjacency/galois-connections.adoc b/docs/adjacency/galois-connections.adoc index d1bad233..5a964c3e 100644 --- a/docs/adjacency/galois-connections.adoc +++ b/docs/adjacency/galois-connections.adoc @@ -8,8 +8,8 @@ _Axes engaged: 5 (Comp), 7 (PR/PI). See `README.adoc` § "Axis coverage matrix". [.lead] *Verdict: distinct, by 2-cell argument.* The natural 2-cell in the abstraction lattice is the meet, which is structurally -Σ-over-preimages with a paired predicate. Formal exhibit in -`EchoVsGalois.Sophisticated`. Truncation argument applies in a +Σ-over-preimages with a paired predicate. Historical formal exhibit in +`EchoVsGalois.Sophisticated` (historical; the module is absent from the tracked tree and is not current checked evidence). Truncation argument applies in a modified form (Galois is propositional about the abstract domain). toc::[] @@ -60,7 +60,7 @@ This is the *simultaneous fiber* of α₁ over a₁ and α₂ over a₂. It is the *intersection of two Echo types*: a witness x that is simultaneously in both echoes. -Formal exhibit in `EchoVsGalois.Sophisticated`: +Historical formal exhibit in `EchoVsGalois.Sophisticated` (module absent from the tracked tree; not current checked evidence): * `meet→echo-intersection` — any meet witness `(x, p₁, p₂)` decomposes mechanically into `((x, p₁), (x, p₂))`: a pair of @@ -141,7 +141,8 @@ Neither has been exhibited. == Status -* 2-cell argument: *formalised* via `EchoVsGalois.Sophisticated`. +* 2-cell argument: *historically formalised* via `EchoVsGalois.Sophisticated` + (module absent from the tracked tree; not current checked evidence). Diagonal correspondence with the quotient case formalised. * Truncation argument: applies via the powerset-on-concrete-side framing; formal exhibit lives in gate-3's `EpistemicUpdate` @@ -156,7 +157,8 @@ artefact of any one neighbour theory's framework. * Cousot & Cousot, "Abstract Interpretation: A Unified Lattice Model for Static Analysis of Programs by Construction or Approximation of Fixpoints" (POPL 1977). -* `proofs/agda/EchoVsGalois.agda` for the formal exhibits cited - above. +* The `EchoVsGalois` module, which named the formal exhibits cited above, + is absent from the current tracked tree; those exhibits are not current + checked evidence (see `docs/gate-1-distinct-phenomenon.adoc`). * `quotients.adoc` for the parallel quotient-side argument with which the diagonal correspondence holds. diff --git a/docs/adjacency/quotients.adoc b/docs/adjacency/quotients.adoc index 78214e72..20a78be8 100644 --- a/docs/adjacency/quotients.adoc +++ b/docs/adjacency/quotients.adoc @@ -7,7 +7,9 @@ _Axes engaged: 1 (Ext/Int), 5 (Comp), 7 (PR/PI). See `README.adoc` § "Axis cove [.lead] *Verdict: distinct.* Both the truncation and 2-cell arguments are -active and formalised against this neighbour. This is the gate-1 +active against this neighbour. The truncation argument is formalised; +the 2-cell exhibits are historical (module absent from the tracked tree). +This is the gate-1 case argued in most depth. toc::[] @@ -120,7 +122,8 @@ Neither has been exhibited. * Truncation argument: *formalised* on three domains via `echo-not-prop`. General theorem awaits Q2.1. -* 2-cell argument: *formalised* via `EchoVsQuotient.Sophisticated` +* 2-cell argument: *historically formalised* via `EchoVsQuotient.Sophisticated` + (module absent from the tracked tree; not current checked evidence) with three sub-cases sealed (core + S-1 + S-2). S-3 and S-4 have informal closures. @@ -134,7 +137,8 @@ neighbours have weaker formalisation; this is the template. * The Cubical Agda primitives for higher-inductive quotients (out of scope for `--safe --without-K` here; relevant for the S-4 sub-case). -* `proofs/agda/EchoVsQuotient.agda` for the formal exhibits - cited above. +* The `EchoVsQuotient` module, which named the formal exhibits cited above, + is absent from the current tracked tree; those exhibits are not current + checked evidence (see `docs/gate-1-distinct-phenomenon.adoc`). * `gate-1-distinct-phenomenon.adoc` § "Falsification tests" for the T2 retraction protocol this note instantiates. diff --git a/docs/bridges/cross-repo-bridge-status.adoc b/docs/bridges/cross-repo-bridge-status.adoc index 8e8ccdde..d7a797f5 100644 --- a/docs/bridges/cross-repo-bridge-status.adoc +++ b/docs/bridges/cross-repo-bridge-status.adoc @@ -143,7 +143,7 @@ by residue / loss form (recoverable / constrained / residue-bearing / observationally equivalent / genuinely lost); Ochránce may supply concrete receipt evidence. Downstream application evidence only — not a new foundation. No mechanised cross-repo theorem currently exists. -Companion: `+docs/bridge-status.md+` §7 and +Companion: `+docs/bridge-status.adoc+` §7 and `+docs/echo-types/explorations/accountable-shell/README.adoc+`. |No shared schema and no Agda↔Idris2 / Agda↔Rust import path; the relationship is citation-level only. Echo Types makes *no* claim about @@ -618,7 +618,7 @@ citation-level (no Agda↔Rust path). bridge row as an exploratory downstream-consumer entry (Core Affect: NO; citation-level only, no bridge module, nothing wired into `+All.agda+` / `+Smoke.agda+` / `+EchoCanonicalIdentitySuite.agda+`). Mirrored in -`+docs/bridge-status.md+` §7 and the exploratory note +`+docs/bridge-status.adoc+` §7 and the exploratory note `+docs/echo-types/explorations/accountable-shell/README.adoc+`. * 2026-05-20: Closed CNO content-bridge row; baked Agda↔Coq↔Lean4 correspondence table in; updated JanusKey row with the structural-mirror diff --git a/docs/bridges/tropical-correspondence.adoc b/docs/bridges/tropical-correspondence.adoc index c50112ae..ea221e2c 100644 --- a/docs/bridges/tropical-correspondence.adoc +++ b/docs/bridges/tropical-correspondence.adoc @@ -12,7 +12,7 @@ named theorems; this document is a cross-reference that lets a reader verify "`the same fact is established in all three systems,`" but does not constitute a unified verification artefact. It closes the "`Adjacent repo not recently audited`" blocker noted in -`+cross-repo-bridge-status.md+`. +`+cross-repo-bridge-status.adoc+`. === Source files diff --git a/docs/characteristic.adoc b/docs/characteristic.adoc index 15376766..5e33a9fa 100644 --- a/docs/characteristic.adoc +++ b/docs/characteristic.adoc @@ -51,7 +51,7 @@ this correction changes no historical nominee, theorem, or audit verdict. For the sceptic-facing evidence map ("is this just renamed Σ?", organised under five demands and cross-linked to every in-tree artefact), see `docs/echo-types/sigma-distinctness-map.adoc` and its -internal companion `core/skepticisms/is-this-just-sigma-types.md`. +internal companion `core/skepticisms/is-this-just-sigma-types.adoc`. That doc is an evidence index; this file is the per-nominee Gate 2 audit and remains the authoritative gate artefact. diff --git a/docs/echo-types/abstraction-barrier.adoc b/docs/echo-types/abstraction-barrier.adoc index ba483d60..71a65e4f 100644 --- a/docs/echo-types/abstraction-barrier.adoc +++ b/docs/echo-types/abstraction-barrier.adoc @@ -19,7 +19,7 @@ the strongest honest statement available under ==== This is Track B of the "Echo ≠ Σ" identity-claim consolidation (`roadmap.adoc` §Lane 2; sceptic-facing map at -`core/skepticisms/is-this-just-sigma-types.md` §4). The theorems below +`core/skepticisms/is-this-just-sigma-types.adoc` §4). The theorems below respect the R-2026-05-18 retraction discipline: the claim is a *consumer-side free theorem at the headline affine instance*, NOT a general Reynolds-style parametricity result. The scope narrowness is @@ -175,7 +175,7 @@ The pair is the artefact. Either alone is half the story. * Agda module: `proofs/agda/EchoAbstractionBarrier.agda` (this file's companion). -* Sceptic-facing map: `core/skepticisms/is-this-just-sigma-types.md` +* Sceptic-facing map: `core/skepticisms/is-this-just-sigma-types.adoc` §4 and `docs/echo-types/sigma-distinctness-map.adoc` §"Demand 4". * The retraction governing the narrowing discipline: `docs/retractions.adoc` R-2026-05-18. diff --git a/docs/echo-types/applications-compiler-analysis.adoc b/docs/echo-types/applications-compiler-analysis.adoc index 92418780..c53050d8 100644 --- a/docs/echo-types/applications-compiler-analysis.adoc +++ b/docs/echo-types/applications-compiler-analysis.adoc @@ -50,7 +50,7 @@ intensional core is the per-target structure of what got lost. The framework's specific contribution is twofold: -. *Compositionality.* The accumulation isomorphism (`composition.md` +. *Compositionality.* The accumulation isomorphism (`composition.adoc` §1) says `Echo (g ∘ f) y ≅ Σ B (λ b → Echo f b × g b ≡ y)`. The residue of a multi-pass pipeline factors through the residue of each pass; nothing is collapsed. @@ -67,7 +67,7 @@ concrete pass. == Example 1 — Parser error recovery (axis 4) [.lead] -Example 9 of `examples.md`. The pass: +Example 9 of `examples.adoc`. The pass: [source] ---- @@ -137,7 +137,7 @@ operational stances: == Example 2 — Abstract interpretation widening (axis 2) [.lead] -Example 10 of `examples.md`. The pass: +Example 10 of `examples.adoc`. The pass: [source] ---- @@ -304,8 +304,8 @@ It is *not* additive value over: * `proofs/agda/EchoCost.agda` — axis 8 refinement 1. * `proofs/agda/EchoAccess.agda` — axis 8 refinement 2. * `proofs/agda/EchoSearch.agda` — axis 8 refinement 4. -* `docs/echo-types/composition.md` — compositionality details. -* `docs/echo-types/taxonomy.md` — the 8-axis taxonomy. +* `docs/echo-types/composition.adoc` — compositionality details. +* `docs/echo-types/taxonomy.adoc` — the 8-axis taxonomy. * `docs/adjacency/galois-connections.adoc` — Galois neighbour for example 2. * `docs/adjacency/refinement-types.adoc` — refinement-types @@ -325,4 +325,4 @@ be expanded to a fully worked Agda exhibit: `echo-approx-compose`. Both are tracked in `roadmap.adoc` as deferred examples-library work -(`Add example-library Agda files matching examples.md`). +(`Add example-library Agda files matching examples.adoc`). diff --git a/docs/echo-types/comparators.adoc b/docs/echo-types/comparators.adoc index 2a1a9297..6c2907ca 100644 --- a/docs/echo-types/comparators.adoc +++ b/docs/echo-types/comparators.adoc @@ -262,7 +262,7 @@ For balance — the affirmative side of the same discipline: * The retraction discipline that governs the narrowed claims here: `docs/retractions.adoc` R-2026-05-18. * Sceptic-facing answer to the "is this just Σ?" question, organised - under five demands: `core/skepticisms/is-this-just-sigma-types.md` + under five demands: `core/skepticisms/is-this-just-sigma-types.adoc` and `docs/echo-types/sigma-distinctness-map.adoc`. * The abstraction-barrier theorems referenced above: `proofs/agda/EchoAbstractionBarrier.agda` + diff --git a/docs/echo-types/decisions/gate1-adjacency-refresh.adoc b/docs/echo-types/decisions/gate1-adjacency-refresh.adoc index 6935e9d5..7fb35da3 100644 --- a/docs/echo-types/decisions/gate1-adjacency-refresh.adoc +++ b/docs/echo-types/decisions/gate1-adjacency-refresh.adoc @@ -8,7 +8,7 @@ :icons: font [.lead] -Coherence pass requested by the legacy `roadmap.md` (now consolidated into `roadmap.adoc`) § "Theory work" item +Coherence pass requested by the former echo-types roadmap note (now consolidated into `roadmap.adoc`) § "Theory work" item "Gate 1 adjacency refresh: the five existing adjacency notes predate the taxonomy. Cross-check each against the current axes and flag any neighbour whose identity claim should be @@ -83,7 +83,7 @@ this refresh — see `gate-1-distinct-phenomenon.adoc` lines == The current taxonomy lens The taxonomy that the notes are being cross-checked against -(`docs/echo-types/taxonomy.md`, refreshed through 2026-05-20) +(`docs/echo-types/taxonomy.adoc`, refreshed through 2026-05-20) is now eight numbered axes plus three open candidates. The five distinctness claims sit in a richer axis-space than they were originally written against: @@ -280,7 +280,7 @@ are coherence-flavoured and can be batched: this refresh. . *No new RE-EVALUATE work.* If a future axis is added to - `taxonomy.md`, this refresh should be re-run; the protocol + `../taxonomy.adoc`, this refresh should be re-run; the protocol is the same. The refresh is *not* premature — the five notes do predate axes 2 and 8 and the post-2026-05 Pillars A–D package, and the coherence gain from naming the axes @@ -293,14 +293,14 @@ are coherence-flavoured and can be batched: * No content rewrites scheduled in this PR; the coherence follow-ups (per-note one-liner, README refresh) are listed above as separate optional moves. -* the legacy `roadmap.md` (now consolidated into `roadmap.adoc`) § "Theory work" entry updated from `[unblocked]` +* the former echo-types roadmap note (now consolidated into `roadmap.adoc`) § "Theory work" entry updated from `[unblocked]` to `[refreshed — see decisions/gate1-adjacency-refresh.adoc]`. == Cross-references -* `roadmap.adoc` (legacy `docs/echo-types/roadmap.md` consolidated 2026-05-26) — Theory-work entry updated to +* `roadmap.adoc` (the former echo-types roadmap note, consolidated 2026-05-26) — Theory-work entry updated to `[refreshed]`. -* `docs/echo-types/taxonomy.md` — the eight-axis post-2026-05 +* `docs/echo-types/taxonomy.adoc` — the eight-axis post-2026-05 taxonomy this refresh cross-checks against. * `docs/adjacency/README.adoc` — the directory index; itself refresh-eligible (see § "Cross-cutting findings"). diff --git a/docs/echo-types/decisions/lane-4-bridges-ci-scope.adoc b/docs/echo-types/decisions/lane-4-bridges-ci-scope.adoc index 8900dae6..9db39244 100644 --- a/docs/echo-types/decisions/lane-4-bridges-ci-scope.adoc +++ b/docs/echo-types/decisions/lane-4-bridges-ci-scope.adoc @@ -161,7 +161,7 @@ saves the next session from re-deriving the unpark plan. == References * `roadmap.adoc` §"Lane 4 [PARKED] — Bridges-CI" -* `docs/bridges/cross-repo-bridge-status.md` — current per-bridge status +* `docs/bridges/cross-repo-bridge-status.adoc` — current per-bridge status * `proofs/agda/EchoJanusBridge.agda`, `EchoTropical.agda`, `EchoCNOBridge.agda`, `DyadicEchoBridge.agda` — in-tree mirrors * `CLAUDE.md` §"Ecosystem context" — list of adjacent target repos diff --git a/docs/echo-types/decisions/no-2-cat.adoc b/docs/echo-types/decisions/no-2-cat.adoc index 0062409c..cc1e974e 100644 --- a/docs/echo-types/decisions/no-2-cat.adoc +++ b/docs/echo-types/decisions/no-2-cat.adoc @@ -10,7 +10,7 @@ [.lead] Closure note for the `roadmap.adoc` entry "2-categorical shape: commit to a 2-category or rule it out" -and for `composition.md` §Q1 / §Q6. The verdict is *rule out*, +and for `../composition.adoc` §Q1 / §Q6. The verdict is *rule out*, on argued grounds against the landed Pillars A–D evidence. The question is closed; future composition write-ups need not hedge for a 2-cat refinement. @@ -78,17 +78,17 @@ forced trivial by a propositionality hypothesis. == Implication -* `composition.md` §Q1 is closed (rule-out). The composition +* `../composition.adoc` §Q1 is closed (rule-out). The composition laws (accumulation iso, cancel-iso, pentagon Σ-assoc, decoration commuting) are promoted from "ad-hoc candidates" to *the complete 1-categorical story* — not 2-coherence laws of a hypothesised 2-category, but the 1-categorical composition laws of a pullback-presented type, full stop. -* `composition.md` §Q6 (composition in the presence of recovery / +* `../composition.adoc` §Q6 (composition in the presence of recovery / echo-erasure) reformulates as a 1-categorical question: recovery as a slice morphism or a fibration section, not a 2-cell. Write-up-tractable on this footing. -* `composition.md` §Q4's "Evidence this is the right shape" +* `../composition.adoc` §Q4's "Evidence this is the right shape" upgrades to a *characterisation*: pentagon is `refl` because there is no associator 2-cell to obstruct it. * The `EchoGradedComonad` + `EchoRelModel` package is the @@ -119,7 +119,7 @@ None is on the active roadmap. The verdict stands. * `roadmap.adoc` — Theory-work entry updated to `[ruled out]`. -* `docs/echo-types/composition.md` §Q1 / §Q4 / §Q6 — open +* `docs/echo-types/composition.adoc` §Q1 / §Q4 / §Q6 — open framings folded into this closure. * `docs/echo-types/establishment-plan.adoc` — minimal cross-reference at the H2 verdict / guardrails site. diff --git a/docs/echo-types/decisions/presentation-dependence.adoc b/docs/echo-types/decisions/presentation-dependence.adoc index 2b9042ae..7e39abf7 100644 --- a/docs/echo-types/decisions/presentation-dependence.adoc +++ b/docs/echo-types/decisions/presentation-dependence.adoc @@ -8,11 +8,11 @@ :icons: font [.lead] -Closure note for the the legacy `roadmap.md` (now consolidated into `roadmap.adoc`) entry +Closure note for the former echo-types roadmap note (now consolidated into `roadmap.adoc`) entry "Presentation-dependence sub-theory: examples 5, 9, 10 cluster here; write up the common pattern". The verdict is *meta-pattern only — no new Agda module needed*: presentation-dependence is the existing -Axis 4 of `taxonomy.md`, and the three examples instantiate it by +Axis 4 of `../taxonomy.adoc`, and the three examples instantiate it by the same mechanism (intermediate-data residue carried *inside* the echo's witness component). The cluster is real but does not refine the axis; it sharpens what the axis names. @@ -21,10 +21,10 @@ toc::[] == The cluster -Three examples in `docs/echo-types/examples.md` are flagged as +Three examples in `docs/echo-types/examples.adoc` are flagged as sharing presentation-dependence (cross-cutting observation #2): -* *Example 5 — Database `GROUP BY`* (`examples.md` L88–106). Source +* *Example 5 — Database `GROUP BY`* (`../examples.adoc` L88–106). Source map `group_by_key : List Row → Map Key Row-Summary`. The echo is "the set of input row lists that would produce summary `s` under the aggregation"; under K-provenance the echo specialises to a @@ -33,14 +33,14 @@ sharing presentation-dependence (cross-cutting observation #2): contributed is residue, and that residue depends on the chosen provenance semiring (Bag, Why, How, …), not on `group_by_key` alone. -* *Example 9 — Parser error recovery* (`examples.md` L165–183). +* *Example 9 — Parser error recovery* (`../examples.adoc` L165–183). Source map `parse : List Token → Maybe SyntaxTree`. A more faithful echo "carries the recovery trace as part of the tree itself, making the echo split into a canonical-tree part and an error-annotation part". The recovery trace is residue *of the - parse algorithm chosen*, not of the input/output pair. Examples.md + parse algorithm chosen*, not of the input/output pair. examples.adoc explicitly cites this as the example that forces Axis 4. -* *Example 10 — Abstract interpretation (widening)* (`examples.md` +* *Example 10 — Abstract interpretation (widening)* (`../examples.adoc` L187–202). Source map `α : Values → AbstractValues` (Galois connection, e.g. `Int → Sign`). The echo records the concrete preimage class; the widening step introduces approximate echoes @@ -88,7 +88,7 @@ rather than baking it into the source map's type. == Where it lives in the axis system Presentation-dependence is already a numbered axis (Axis 4 of -`taxonomy.md` L87–107). The cluster does *not* motivate a new +`../taxonomy.adoc` L87–107). The cluster does *not* motivate a new axis. What it does sharpen is the axis's relation to the others: * *Axis 1 (extensional/intensional).* The cluster lives entirely on @@ -96,7 +96,7 @@ axis. What it does sharpen is the axis's relation to the others: insensitive to presentation, with all presentation-dependence in the intensional core. This matches `EchoIndexed`, `EchoChoreo`, and `EchoEpistemic` in the cross-classification table - (`taxonomy.md` L310–321), all of which the table already marks + (`../taxonomy.adoc` L310–321), all of which the table already marks `Pres-dep` along axis 4. * *Axis 2 (exact/approximate).* Example 10 (widening) crosses both axes. Its presentation-dependence (which widening operator) @@ -110,7 +110,7 @@ axis. What it does sharpen is the axis's relation to the others: the presentation parameter `R` itself composes. For K-provenance (example 5) it does (semiring multiplication); for parser-recovery and widening it is policy-dependent. This is the - concrete content behind `taxonomy.md`'s Axis 5 "open question" + concrete content behind `../taxonomy.adoc`'s Axis 5 "open question" about non-compositional echo classes. * *Axis 8 (info-theoretic/computational access).* Disjoint from the cluster: presentation-dependence is about *which witness @@ -144,7 +144,7 @@ landed-Agda instances of the same meta-pattern that examples 5, . *Per-decoration composition lemmas already cover the landed Pres-dep cases.* `EchoChoreo.applyChoreo-{comp,compose,via-join}` along `_⊑c_` and `EchoEpistemic.knowledge-monotone-{comp,id}` - (roadmap.md L128–136) are exactly compose-laws against a + (former roadmap note, L128–136) are exactly compose-laws against a decoration order that *is* the presentation parameter `R`. The cluster's "compositional iff R composes" prediction is therefore already discharged on the Agda side for the role and epistemic @@ -161,7 +161,7 @@ landed-Agda instances of the same meta-pattern that examples 5, pattern that is already implicit in (a) Axis 4 as it stands and (b) the landed `EchoIndexed`/`EchoChoreo`/`EchoEpistemic` decoration modules. The three informal examples (5, 9, 10) are best left as -informal entries in `examples.md` until a downstream consumer wants +informal entries in `../examples.adoc` until a downstream consumer wants one of them in Agda; at that point the existing decoration recipe (propositional order → join → factoring-free compose → via-join) applies directly, with `R` instantiated to the semiring / recovery @@ -178,7 +178,7 @@ Concretely: (i) and (ii) above — but does not answer it. Example 5 (K- provenance quotient) is the natural first test case if and when it gets formalised. -* *Optionally* annotate `examples.md` §"Cross-cutting +* *Optionally* annotate `../examples.adoc` §"Cross-cutting observations" #2 with a back-pointer to this decision document so future readers see the cluster has been adjudicated and the meta-pattern named. @@ -198,15 +198,15 @@ Concretely: == Cross-references -* `roadmap.adoc` (legacy `docs/echo-types/roadmap.md` consolidated 2026-05-26) — Theory-work entry updated to +* `roadmap.adoc` (the former echo-types roadmap note, consolidated 2026-05-26) — Theory-work entry updated to `[landed — see decisions/presentation-dependence.adoc]`. -* `docs/echo-types/taxonomy.md` §Axis 4 — the existing axis this +* `docs/echo-types/taxonomy.adoc` §Axis 4 — the existing axis this cluster instantiates; its "Open question" is sharpened (not closed) by this note. -* `docs/echo-types/taxonomy.md` §Cross-classification table — the +* `docs/echo-types/taxonomy.adoc` §Cross-classification table — the three `Pres-dep` entries (`EchoIndexed`, `EchoChoreo`, `EchoEpistemic`) are the landed-Agda half of the same pattern. -* `docs/echo-types/examples.md` §5, §9, §10 — the informal +* `docs/echo-types/examples.adoc` §5, §9, §10 — the informal cluster members; §"Cross-cutting observations" #2 names the cluster. * `proofs/agda/EchoChoreo.agda`, diff --git a/docs/echo-types/earn-back-plan.adoc b/docs/echo-types/earn-back-plan.adoc index 8627b771..76c5c499 100644 --- a/docs/echo-types/earn-back-plan.adoc +++ b/docs/echo-types/earn-back-plan.adoc @@ -315,12 +315,12 @@ single index; it moves no claim. wired into `All`/`Smoke`. Retraction follow-up F-2026-05-18a. | B -| Buchholz order: `Ordinal/Buchholz/Order.agda` `_<ᵇ_` compares ψ by +| Buchholz order: `Ordinal/Buchholz/Order.agda` (now in the ordinal-notation repository) `_<ᵇ_` compares ψ by Ω-index only and asserts `<ᵇ-ψΩ≤` as a constructor; same-binder sub-cases (`bpsi ν α <ᵇ bpsi ν β` with `α <ᵇ β`; `bplus x y₂ <ᵇ bplus x z₂` with `y₂ <ᵇ z₂`) are not constructible pending a K-free reformulation. Direct-constructor totality / WF do - not land; `ExtendedOrder.agda` is the honest closed wrapper (WF via + not land; `ExtendedOrder.agda` (likewise moved) is the honest closed wrapper (WF via the comparison *measure* `_<ᵇ⁺_`). | Disclosed structural-fidelity gap. *Off the echo-types paper critical path.* Long-tail workstream. diff --git a/docs/echo-types/examples.adoc b/docs/echo-types/examples.adoc index b297c9f3..86bcffde 100644 --- a/docs/echo-types/examples.adoc +++ b/docs/echo-types/examples.adoc @@ -80,7 +80,7 @@ determines the ordinal value. * *Extensional / intensional.* Both. The shadow is "`the canonical form exists`"; the intensional core records _which tree_ produced it, giving provenance across normalisation. -* *Reference.* `+proofs/agda/Ordinal/CNF.agda+`; trichotomy +* *Reference.* `+Ordinal/CNF.agda+` in the ordinal-notation repository (moved out of this repo, 2026-10-20); trichotomy (`+cnf-trichotomy+`, `+<ᶜ-trans+`, `+<ᶜ-irrefl+`) gives the order structure that makes this a well-behaved canonicalisation. @@ -119,7 +119,7 @@ been. * *Extensional / intensional.* Both. The approximate version brings in the "`Exact vs approximate`" axis (see taxonomy). * *Informal.* Approximate-echo formalisation is open (see -`+taxonomy.md+`, axis 2). +`+taxonomy.adoc+`, axis 2). ''''' @@ -155,7 +155,7 @@ enormous but enumerable (in principle) set. access to the echo, not its existence. * *Informal.* Not in repo. This is the example that forced the promotion of the information-theoretic/computational access axis — see -`+taxonomy.md+` axis 8. Candidate refinements of `+Echo+` that would +`+taxonomy.adoc+` axis 8. Candidate refinements of `+Echo+` that would capture the security claim (cost-indexed echo, graded access modality, decidability-respecting echo, witness-search abstract machine) are listed there. diff --git a/docs/echo-types/explorations/accountable-shell/README.adoc b/docs/echo-types/explorations/accountable-shell/README.adoc index 68e62290..da5690c5 100644 --- a/docs/echo-types/explorations/accountable-shell/README.adoc +++ b/docs/echo-types/explorations/accountable-shell/README.adoc @@ -114,5 +114,5 @@ in-repo residue / loss framing. Status anchors: -* `docs/bridge-status.md` §7 (concise ledger, Core Affect: NO); -* `docs/bridges/cross-repo-bridge-status.md` (cross-repo track table). +* `docs/bridge-status.adoc` §7 (concise ledger, Core Affect: NO); +* `docs/bridges/cross-repo-bridge-status.adoc` (cross-repo track table). diff --git a/docs/echo-types/explorations/decoration-bridge/README.adoc b/docs/echo-types/explorations/decoration-bridge/README.adoc index 44e1637b..bb6a6547 100644 --- a/docs/echo-types/explorations/decoration-bridge/README.adoc +++ b/docs/echo-types/explorations/decoration-bridge/README.adoc @@ -112,7 +112,7 @@ triggers immediate retirement of the offending content. == Echo-vs-Σ clearance argument Per `roadmap.adoc` Lane 2, any echo-types construction must clear the -Track A/B/C bar set out in `core/skepticisms/is-this-just-sigma-types.md`: +Track A/B/C bar set out in `core/skepticisms/is-this-just-sigma-types.adoc`: the construction has to lean on at least one echo-specific property that bare `Σ` + `≡` does not give. The bridge clears the bar via four inherited properties, in descending order of confidence: @@ -496,4 +496,4 @@ does not require gate theory. the `earn-back-summary § forbidden-rebrandings` list. * EI-2 termination record: `docs/EI2_REPORT.adoc` § "Status". * R-2026-05-18 retraction record: `docs/retractions.adoc`. -* Track A/B/C bar: `core/skepticisms/is-this-just-sigma-types.md`. +* Track A/B/C bar: `core/skepticisms/is-this-just-sigma-types.adoc`. diff --git a/docs/echo-types/fibration-package.adoc b/docs/echo-types/fibration-package.adoc index bd288fe5..62a33fdf 100644 --- a/docs/echo-types/fibration-package.adoc +++ b/docs/echo-types/fibration-package.adoc @@ -238,7 +238,7 @@ Citers of Echo's fibration package should read, in order: . `EchoFiberBridge.agda` — the definitional bridge to `fiber`; . `EchoFiberTriangulation.agda` — calibration against stdlib's own fibre / surjection notions; -. `docs/echo-types/composition.md` (or `composition.adoc` if +. `docs/echo-types/composition.adoc` (or `composition.adoc` if present) — the originally-handwritten narrative the mechanisation discharges. diff --git a/docs/echo-types/overview.adoc b/docs/echo-types/overview.adoc index bf2f0ff7..b65f3a3c 100644 --- a/docs/echo-types/overview.adoc +++ b/docs/echo-types/overview.adoc @@ -147,7 +147,7 @@ context in which information loss appears. . *Compositional.* Behave well under function composition, parallel product, slicing, and change of universe. . *Axis-aware.* Distinguish kinds of echoes along the axes in -`+taxonomy.md+` rather than presenting "`the`" echo construction. +`+taxonomy.adoc+` rather than presenting "`the`" echo construction. . *Formally tractable.* The theory is implementable in `+--safe --without-K+` Agda without postulates, at least for the extensional/intensional core and a growing list of canonical examples. @@ -181,7 +181,7 @@ iterated mediated wrappers, and the shared-binder lex cases (`+<ᵇ⁺-ψα+`, `+<ᵇ⁺-+2+`) are now internalised in the extended relation `+Ordinal.Buchholz.OrderExtended._<ᵇ⁺_+` with proven irrefl + trans; well-foundedness for `+_<ᵇ⁺_+` is the next open step, with two design -routes documented in `+docs/echo-types/buchholz-extended-wf.md+`. +routes documented in `+docs/bridges/buchholz-extended-wf.adoc+`. * *Not (yet) a completed categorical semantics — but* Pillar F Gate F5 FULL PASS (2026-05-27, follow-up F-2026-05-27a) mechanises the full (equivalence, projection) orthogonal factorisation system on Type _at @@ -194,7 +194,7 @@ narrative and `+docs/assessment.adoc+` for the older M5 verdict. === Extensional shadow vs intensional core This distinction is load-bearing for the rest of the theory and is -developed in detail in `+taxonomy.md+`. Briefly: +developed in detail in `+taxonomy.adoc+`. Briefly: * The *extensional shadow* of `+Echo(f)+` is the subset of `+B+` on which `+Echo f y+` is inhabited — equivalent to `+image(f)+`. The shadow @@ -220,9 +220,9 @@ headlines together as the "`why Echo deserves a name`" demo. (the categorical-universal-property story). * `+fibration-package.adoc+` — `+map-over+` + composition iso + cancellation iso + pentagon coherence (the fibration-side story). -* `+taxonomy.md+` — axes along which echoes differ. -* `+examples.md+` — worked cases. -* `+composition.md+` — how `+Echo+` behaves under function composition. +* `+taxonomy.adoc+` — axes along which echoes differ. +* `+examples.adoc+` — worked cases. +* `+composition.adoc+` — how `+Echo+` behaves under function composition. * `+roadmap.adoc+` — what can advance without the current proof -blockers, and what cannot (note: `+roadmap.md+` was consolidated into -`+roadmap.adoc+` in 2026-05-26). +blockers, and what cannot (note: the former echo-types roadmap note was +consolidated into `+roadmap.adoc+` in 2026-05-26). diff --git a/docs/echo-types/paper.adoc b/docs/echo-types/paper.adoc index 98e1204e..bad3378f 100644 --- a/docs/echo-types/paper.adoc +++ b/docs/echo-types/paper.adoc @@ -703,8 +703,10 @@ we treat it as such; what it does *not* do is independently corroborate the modality across decorations — the four instances are not four independent witnesses, they are one structural pattern applied four times. Cross-axis distinctness arguments -(`docs/gate-1-handoff.adoc`) supply the per-decoration independence -the recipe itself cannot. Anyone reading the four-instance +(`docs/gate-1-distinct-phenomenon.adoc`) are the intended route to +per-decoration independence, but that document leaves the +epistemic-versus-linear independence test open, so the independence is +unresolved here, not established. Anyone reading the four-instance table in §"Worked examples" as a robustness check should weaken that reading accordingly. diff --git a/docs/echo-types/prototypes/README.adoc b/docs/echo-types/prototypes/README.adoc index 49903b10..ef33f9bc 100644 --- a/docs/echo-types/prototypes/README.adoc +++ b/docs/echo-types/prototypes/README.adoc @@ -25,6 +25,6 @@ unqualified proof. Read this as an explanatory companion to: -* `../overview.md` - semantic fibre, avec fibre, sans fibre, warrant. -* `../taxonomy.md` - cross-axis fibre status and access distinctions. +* `../overview.adoc` - semantic fibre, avec fibre, sans fibre, warrant. +* `../taxonomy.adoc` - cross-axis fibre status and access distinctions. * `../../../README.md` - public README placement. diff --git a/docs/echo-types/sigma-distinctness-map.adoc b/docs/echo-types/sigma-distinctness-map.adoc index da8b9406..aec0f08d 100644 --- a/docs/echo-types/sigma-distinctness-map.adoc +++ b/docs/echo-types/sigma-distinctness-map.adoc @@ -15,7 +15,7 @@ [.lead] This file is the reviewer-facing companion to -`core/skepticisms/is-this-just-sigma-types.md`. Its job is one thing: +`core/skepticisms/is-this-just-sigma-types.adoc`. Its job is one thing: collect the in-repo constructions around `Echo f y`, which is definitionally `Σ A (λ x → f x ≡ y)`. None of the rows separates Echo from general dependent pairs. Selected lossy representations can forget information; that is a statement about those representations. [IMPORTANT] @@ -52,7 +52,7 @@ sceptic might want. `proofs/agda/Smoke.agda`. | Prose | `docs/characteristic.adoc`, -`docs/proof-obligations.md` §"No-section" entries, +`docs/proof-obligations.adoc` §"No-section" entries, `README.md` §"Characteristic family". | Narrowing | These are no-left-inverse results, not a general absence of categorical sections or a separation from dependent pairs. The family lemmas are negative results under @@ -156,7 +156,7 @@ just decorative wrapping. `proofs/agda/examples/EchoVsSigma.agda` — Track C in the work plan. Contrasts the chosen API with a deliberately lossy or insufficiently constrained representation. Raw `Σ` can express the same invariants as Echo; a universal raw-`Σ` leakage claim is false. -| Prose | `docs/echo-types/examples.md`, +| Prose | `docs/echo-types/examples.adoc`, `roadmap-gates.adoc` Gate 3. | Narrowing | Until Track C lands, the "raw `Σ` would leak" half is @@ -179,9 +179,9 @@ the gate decisions. In particular: == See also -* `core/skepticisms/is-this-just-sigma-types.md` — internal devil's +* `core/skepticisms/is-this-just-sigma-types.adoc` — internal devil's advocate ledger this file is the AsciiDoc companion to. -* `core/skepticisms/is-this-just-fibers.md` — adjacent skepticism. -* `core/skepticisms/what-is-actually-new.md` — the broader question. +* `core/skepticisms/is-this-just-fibers.adoc` — adjacent skepticism. +* `core/skepticisms/what-is-actually-new.adoc` — the broader question. * `docs/retractions.adoc` — the R-2026-05-18 narrowing that governs the prose discipline here. diff --git a/docs/echo-types/taxonomy.adoc b/docs/echo-types/taxonomy.adoc index 5b1bfe5d..0e7d3083 100644 --- a/docs/echo-types/taxonomy.adoc +++ b/docs/echo-types/taxonomy.adoc @@ -164,7 +164,7 @@ group? This could be the "`canonical-form`" operator for echoes. === Axis 5 — Compositional vs non-compositional _Definition._ *Compositional* echoes satisfy a clean law relating -`+Echo(g ∘ f)+` to `+Echo(f)+` and `+Echo(g)+` (see `+composition.md+`). +`+Echo(g ∘ f)+` to `+Echo(f)+` and `+Echo(g)+` (see `+composition.adoc+`). *Non-compositional* echoes do not — computing `+Echo(g ∘ f)+` requires global information beyond the component echoes. @@ -246,7 +246,7 @@ cryptographically strong hash function. `+Echo H y+` is information-theoretically inhabited for every `+y ∈ image(H)+` (pigeonhole — there exist preimages), but computationally inaccessible under the standard security assumption (no polynomial-time algorithm -produces a witness). See `+examples.md+` §8. - `+square⁻¹ : ℕ → ℕ+` +produces a witness). See `+examples.adoc+` §8. - `+square⁻¹ : ℕ → ℕ+` under the constructive square-root algorithm. Same information content as `+Echo square+`, but the witness is produced in `+O(log n)+` operations. Computationally accessible. @@ -369,7 +369,7 @@ _Composition conjecture._ Computational accessibility composes extracting a `+g ∘ f+` witness is bounded by the product of component costs. This is the standard complexity composition and should carry over; would need to be stated carefully since the accumulation iso of -`+composition.md+` §1 introduces an intermediate `+b : B+` whose +`+composition.adoc+` §1 introduces an intermediate `+b : B+` whose extraction cost is implicit. _Worked example motivating the axis._ Hash chains in a blockchain. Each @@ -449,6 +449,6 @@ morphisms factor through a residue). Currently indirect in _History note._ Axis 8 (information-theoretic vs computational access) was promoted from this list on the same commit that added it as a -numbered axis. The cryptographic-hash example in `+examples.md+` §8 was +numbered axis. The cryptographic-hash example in `+examples.adoc+` §8 was the case that forced the promotion: no other axis could distinguish "`preimage exists`" from "`preimage is findable`". diff --git a/docs/echo-types/tropical-correspondence.adoc b/docs/echo-types/tropical-correspondence.adoc index c50112ae..416e8173 100644 --- a/docs/echo-types/tropical-correspondence.adoc +++ b/docs/echo-types/tropical-correspondence.adoc @@ -12,7 +12,7 @@ named theorems; this document is a cross-reference that lets a reader verify "`the same fact is established in all three systems,`" but does not constitute a unified verification artefact. It closes the "`Adjacent repo not recently audited`" blocker noted in -`+cross-repo-bridge-status.md+`. +`+../bridges/cross-repo-bridge-status.adoc+`. === Source files diff --git a/docs/echo-types/types-list-note.adoc b/docs/echo-types/types-list-note.adoc index 7c7e15b9..8526894e 100644 --- a/docs/echo-types/types-list-note.adoc +++ b/docs/echo-types/types-list-note.adoc @@ -63,9 +63,10 @@ is, honestly, just the generic Σ fact "`a Σ with two first-component-distinct elements is not `+isProp+``"; only the _constructed-`+y+`_ form is more than that.) * *2-cell.* The natural 2-cell in the quotient and Galois encodings is -itself Σ-over-preimages-shaped (equalizer; lattice meet) — formal -exhibits `+EchoVsQuotient.Sophisticated+`, -`+EchoVsGalois.Sophisticated+`. +itself Σ-over-preimages-shaped (equalizer; lattice meet) — historical +formal exhibits `+EchoVsQuotient.Sophisticated+` and +`+EchoVsGalois.Sophisticated+`, whose modules are absent from the tracked tree +(not current checked evidence; do not cite them as available). A negative result is also recorded rather than hidden: a cross-axis "`integration recipe`" over the five named decoration axes does *not* @@ -90,7 +91,7 @@ it. Artifact (type-checked, gated, with the honest self-assessment): . The relevant module is `+proofs/agda/characteristic/NonTruncatable.agda+`; -the taxonomy is `+docs/echo-types/taxonomy.md+`; the falsifiable-claim +the taxonomy is `+docs/echo-types/taxonomy.adoc+`; the falsifiable-claim protocol is `+roadmap-gates.adoc+`. Grateful for pointers, corrections, or "`this is just X under another @@ -116,7 +117,7 @@ a notion`". * [ ] Replace `++` with the public URL at send time. * [ ] Trim to ≤ ~400 words of body before sending; list readers reward brevity. The taxonomy enumeration can become "`(8 axes; see -`+taxonomy.md+`)`". +`+taxonomy.adoc+`)`". === Why this is postable now (vs. earlier) diff --git a/docs/gate-1-distinct-phenomenon.adoc b/docs/gate-1-distinct-phenomenon.adoc index d3395c2d..bd83bdf9 100644 --- a/docs/gate-1-distinct-phenomenon.adoc +++ b/docs/gate-1-distinct-phenomenon.adoc @@ -47,9 +47,10 @@ Briefly: `proofs/agda/examples/`. * *2-cell arguments* (quotients, Galois): echo wins because the natural 2-cell in the neighbour's framework is - Σ-over-preimages-shaped. Formal certificates are + Σ-over-preimages-shaped. Historical attempt references are `EchoVsQuotient.Sophisticated.equalizer→echo-pair` and - `EchoVsGalois.Sophisticated.meet→echo-intersection`. + `EchoVsGalois.Sophisticated.meet→echo-intersection`; their modules are + absent from the current tracked tree (see "Status of attempts" below). Two neighbours not in the original five-neighbour list are now also covered: @@ -109,13 +110,14 @@ neighbouring frameworks rests on two structural arguments: . *2-cell argument.* The natural 2-cells in neighbour frameworks (quotient equalizers, Galois meets) are structurally - Σ-over-preimages-shaped — i.e., already echo-shaped. Formal - certificates in + Σ-over-preimages-shaped — i.e., already echo-shaped. Historical + attempt references in `proofs/agda/EchoVsQuotient.Sophisticated.equalizer→echo-pair` and `proofs/agda/EchoVsGalois.Sophisticated.meet→echo-intersection`, with diagonal correspondence via - `meet-on-diagonal→equalizer`. + `meet-on-diagonal→equalizer`. These modules are absent from the current + tracked tree and are not current checked evidence. The earlier framing — distinctness as the *coherent integration of structured loss across five orthogonal axes simultaneously* — @@ -159,7 +161,7 @@ A Galois-only encoding would establish a scoped correspondence for the selected statement. Record any required assumptions; an unclosed attempt is not a proof that no encoding exists. -Attempt scaffolded in `proofs/agda/EchoVsGalois.agda`. +Attempt scaffolded in the `EchoVsGalois` module, which is absent from the current tracked tree (see "Status of attempts" below). === T2 — Quotient reduction @@ -171,7 +173,7 @@ A quotient-only restatement would establish a scoped correspondence for the selected statement. A failure to construct one is not by itself a universal quotient no-go theorem. -Attempt scaffolded in `proofs/agda/EchoVsQuotient.agda`. +Attempt scaffolded in the `EchoVsQuotient` module, which is absent from the current tracked tree (see "Status of attempts" below). === T3 — Informativeness collapse @@ -190,7 +192,7 @@ This test is currently unstubbed; see <>. The attempt descriptions below name `proofs/agda/EchoVsGalois.agda` and `proofs/agda/EchoVsQuotient.agda`, which are absent from the current tracked checkout. Those named results are not current checked evidence in this audit. The current `characteristic.RoleGraded.choreo-grade-commute` is a scoped commutation lemma; `characteristic/IntegrationAudit.agda` and the EI-2 record do not license a universal encoding obstruction. Any revived T1/T2 attempt needs an actual source revision and its own check receipt. T1 (Galois):: -Scaffolded in `proofs/agda/EchoVsGalois.agda`. The basic reduction +Scaffolded in the (now absent) `EchoVsGalois` module. The basic reduction holds for the foundation module. The non-monotone-grade obstruction is now *witnessed* by the `Sophisticated` submodule, which attacks the natural AI 2-cell candidate — the MEET in the abstraction @@ -210,7 +212,7 @@ SPECIFIC, not an artifact of any one neighbour theory's framework. A further construction would refine these selected neighbour comparisons. Its success would not independently falsify Gate 1 or reopen EI-2. T2 (Quotient):: -Scaffolded in `proofs/agda/EchoVsQuotient.agda`. Foundation reduces +Scaffolded in the (now absent) `EchoVsQuotient` module. Foundation reduces cleanly. The naive-quotient-stacking obstruction is now *witnessed* by the `Miniature` submodule: a concrete two-element-type setting (A = Bool × Bool, one grade step, one role projection) where role @@ -266,7 +268,7 @@ candidate axis must come with its own characteristic theorem Q1.5 [partial answer]:: The smallest counter-example for naive quotient stacking has been -constructed: see `proofs/agda/EchoVsQuotient.agda` § `Miniature`. +constructed: see the `Miniature` submodule of the (now absent) `EchoVsQuotient` module. + The full T2 obligation is now decomposed into three claims: + diff --git a/docs/gate-2-handoff.adoc b/docs/gate-2-handoff.adoc index 6d9cdbc9..d0ee6906 100644 --- a/docs/gate-2-handoff.adoc +++ b/docs/gate-2-handoff.adoc @@ -7,7 +7,7 @@ [.lead] This file collects observations from the Gate 2 audit -(`docs/gate-2-characteristic.adoc`) that affect the other gates' work. +(`docs/characteristic.adoc`) that affect the other gates' work. Per parallel-instance lane discipline, this lane does not edit Gate 1's or Gate 3's files; this is the channel for cross-lane information. @@ -247,8 +247,9 @@ distinctness load is carried by the *truncation argument* (echo types are non-truncatable, formalised by the `echo-not-prop` family in `proofs/agda/examples/`) and the *2-cell argument* (natural 2-cells in neighbour frameworks are -Σ-over-preimages-shaped, formalised in -`EchoVsQuotient.Sophisticated` and `EchoVsGalois.Sophisticated`). +Σ-over-preimages-shaped; historically formalised in +`EchoVsQuotient.Sophisticated` and `EchoVsGalois.Sophisticated`, modules absent +from the tracked tree and not current checked evidence). `gate-1-distinct-phenomenon.adoc` § The Gate #1 claim has been updated to reflect this narrowing. diff --git a/docs/governance.adoc b/docs/governance.adoc index 349623c4..32640f59 100644 --- a/docs/governance.adoc +++ b/docs/governance.adoc @@ -6,11 +6,11 @@ proof-preservation rules. It is treated as a sensitive proof artifact. === Core vs. Bridge * *Core:* The minimal, mechanically verified theory of echo types -(`+proofs/agda/Echo/Core.agda+`, `+Characteristic.agda+`, -`+Residue.agda+`). This is the unshakeable foundation. +(`+proofs/agda/Echo.agda+`, `+proofs/agda/characteristic/All.agda+`, +`+proofs/agda/EchoResidue.agda+`). This is the unshakeable foundation. * *Bridge:* Speculative extensions, cross-domain mappings, and integrations. Bridge materials are strictly labeled (e.g., PARTIAL, -EXPLORATORY, BLOCKED) and reside in `+proofs/agda/Echo/Bridges/+` and +EXPLORATORY, BLOCKED) and reside in the `+proofs/agda/Echo*Bridge.agda+` modules and `+docs/bridges/+`. They do _not_ affect the core identity. === Retractions diff --git a/docs/theorem-index.adoc b/docs/theorem-index.adoc index d934c117..93a5f934 100644 --- a/docs/theorem-index.adoc +++ b/docs/theorem-index.adoc @@ -203,7 +203,7 @@ Separating model (locates the reduction): `+true ≢ false+` failure when the single load-bearing hypothesis `+≤g-prop+` is removed. -See `+core/skepticisms/is-this-just-sigma-types.md+` §2 and +See `+core/skepticisms/is-this-just-sigma-types.adoc+` §2 and `+docs/echo-types/sigma-distinctness-map.adoc+` §"`Demand 2`" for the sceptic-facing framing. Honest framing per `+docs/retractions.adoc+` R-2026-05-18: this is a _thin-poset reindexing modality_, not a graded @@ -240,7 +240,7 @@ above) |`+proofs/agda/EchoNoSectionGeneric.agda+` `+no-section-of-collapsing-map+`) |`+proofs/agda/EchoSecurity.agda+` |=== -See `+core/skepticisms/is-this-just-sigma-types.md+` §1 and +See `+core/skepticisms/is-this-just-sigma-types.adoc+` §1 and `+docs/echo-types/sigma-distinctness-map.adoc+` §"`Demand 1`" for the sceptic-facing framing. @@ -270,5 +270,5 @@ follow-ups: `+docs/retractions.adoc+` (R-2026-05-18 + F-2026-05-18a + F-2026-05-20a/b + F-2026-05-27a). _Note: For experimental bridges or retracted claims, refer to the -link:proof-obligations.md[Proof Obligation Ledger] and -link:bridge-status.md[Bridge Status]._ +link:proof-obligations.adoc[Proof Obligation Ledger] and +link:bridge-status.adoc[Bridge Status]._ diff --git a/roadmap-gates.adoc b/roadmap-gates.adoc index 181fe273..cde634a3 100644 --- a/roadmap-gates.adoc +++ b/roadmap-gates.adoc @@ -62,8 +62,10 @@ are specific to the models and witness information they retain. The current scoped evidence consists of the *truncation comparison* (the chosen fibres have distinct source projections, so propositional truncation cannot retain that same source-sensitive information, formally certified by the `echo-not-prop` family in `proofs/agda/examples/`) and the selected *2-cell constructions* (neighbour-framework natural 2-cells are Σ-over-preimages-shaped, formally certified by -`Sophisticated.equalizer→echo-pair` in `EchoVsQuotient.agda` and -`Sophisticated.meet→echo-intersection` in `EchoVsGalois.agda`). +`Sophisticated.equalizer→echo-pair` in the `EchoVsQuotient` module and +`Sophisticated.meet→echo-intersection` in the `EchoVsGalois` module; both +modules are absent from the current tracked tree, so these are historical +claims, not current checked evidence). The integration recipe (decoration order + echo-indexed family + transport action) is useful as organising vocabulary across the @@ -113,7 +115,7 @@ The library contains useful fibre presentations and examples. Their novelty, pri The reviewer-facing evidence map answering "is this just renamed Σ?" — organised under five sceptic demands — lives at `docs/echo-types/sigma-distinctness-map.adoc` (companion to -`core/skepticisms/is-this-just-sigma-types.md`). It is an *evidence +`core/skepticisms/is-this-just-sigma-types.adoc`). It is an *evidence index*, not a substitute for the per-nominee audit below or for the Gate 2 decision itself. ==== diff --git a/roadmap.adoc b/roadmap.adoc index c34c7c7c..58feb29e 100644 --- a/roadmap.adoc +++ b/roadmap.adoc @@ -24,8 +24,8 @@ The seven forge mirrors remain dormant by owner choice. [.lead] Single canonical roadmap for the echo-types project. As of 2026-05-26 this file replaces the previously fragmented set of overlapping -roadmaps (`docs/echo-types/roadmap.md`, `docs/PRIORITIZED_PROOF_ROADMAP.md`, -`docs/ProofRoadmap.md`, `docs/WORK_PLAN.md` — all deleted in this +roadmaps (the former echo-types roadmap, prioritized-proof-roadmap, +proof-roadmap and work-plan notes — all deleted in this sweep; CLAUDE.md retains the per-session rung-consolidation ledger, `roadmap-gates.adoc` retains the identity-claim gates, `docs/echo-types/establishment-plan.adoc` retains the five-pillar @@ -300,10 +300,10 @@ architectural keystone). `characteristic.N5Falsifier`) and finds none of it weakens any surviving nominee. -*Artefacts (landed today).* `core/skepticisms/is-this-just-sigma-types.md` +*Artefacts (landed today).* `core/skepticisms/is-this-just-sigma-types.adoc` (canonical answer doc, 5-section structure mirroring the demands); `docs/echo-types/sigma-distinctness-map.adoc` (AsciiDoc reviewer -companion); `docs/theorem-index.md` (no-section and degrade-law +companion); `docs/theorem-index.adoc` (no-section and degrade-law aggregate rows); cross-link from `roadmap-gates.adoc` Gate 2 and `docs/characteristic.adoc` §"Inherited spec". diff --git a/wiki/Architecture.adoc b/wiki/Architecture.adoc index 2eac3035..09ef40ea 100644 --- a/wiki/Architecture.adoc +++ b/wiki/Architecture.adoc @@ -39,7 +39,7 @@ toc::[] `Echo.Modality.{Interface,Core}` (the modality, measure-independent), `Echo.Separation.NotResourceInstance` (the *Echo IS-NOT a resource instance* invariant), `Echo.Measure.{Interface,Examples}` (the - residue-measure observation seam). Contract: `FOUNDATION_CONTRACT.md`. + residue-measure observation seam). Contract: `FOUNDATION_CONTRACT.adoc`. |=== == Track 1 — Composition (landed) @@ -155,7 +155,7 @@ vocabulary*, not a distinctness locus. == Ecosystem and cross-repo bridges echo-types is a foundational node in the hyperpolymath / PanLL constellation. -The authoritative ledger is `docs/bridges/cross-repo-bridge-status.md`. +The authoritative ledger is `docs/bridges/cross-repo-bridge-status.adoc`. [cols="1,1,2", options="header"] |=== diff --git a/wiki/Deniability.adoc b/wiki/Deniability.adoc index 64a52f46..d06c9240 100644 --- a/wiki/Deniability.adoc +++ b/wiki/Deniability.adoc @@ -238,13 +238,13 @@ These are `⊤`-aliased matched-negatives in `EchoDeniability.agda`; `proofs/agda/EchoDeniability.agda` — wired into `All.agda` and pinned in `Smoke.agda`. -Companion explorations (not part of the verified suite, standalone Agda files): +Companion explorations (local sketches kept outside this repository; not part of the verified suite): -- `Deniability.agda` — perfect case only (two histories, one residue constructor). -- `DeniabilityPartial.agda` — both cases side by side; failing proofs as commented +- `Deniability` — perfect case only (two histories, one residue constructor). +- `DeniabilityPartial` — both cases side by side; failing proofs as commented blocks with error annotations; counterexample `witness-distinguishes`; restricted `cannotDistinguishConstant`. -See also: `EchoObservationalEquivalence.adoc`, `EchoSecurity.adoc` in -`docs/echo-types/`, and `EchoNoSectionGeneric.agda` for the generic +See also: `EchoObservationalEquivalence.agda`, `EchoSecurity.agda` in +`proofs/agda/`, and `EchoNoSectionGeneric.agda` for the generic no-section theorem this module instantiates. diff --git a/wiki/Home.adoc b/wiki/Home.adoc index 20244c9e..2c3cf60f 100644 --- a/wiki/Home.adoc +++ b/wiki/Home.adoc @@ -88,13 +88,13 @@ echo-types serves three audiences. Find your lane, then follow the reading order 3. `scripts/kernel-guard.sh` + `.github/workflows/agda.yml` — the CI cone that must stay green. + 4. `.machine_readable/6a2/STATE.a2ml` (EI-2 record + current state) and - `docs/bridges/cross-repo-bridge-status.md` (downstream ledger). + + `docs/bridges/cross-repo-bridge-status.adoc` (downstream ledger). + 5. <> — the full gate-keeping + release runbook (build cone, gates, rung-consolidation, release checklist). | *An end user* + (wiring Echo into another language) -| 1. `FOUNDATION_CONTRACT.md` — the stable `Echo.*` interface and the boundary +| 1. `FOUNDATION_CONTRACT.adoc` — the stable `Echo.*` interface and the boundary invariant *Echo IS-NOT a resource instance*. Read this first. + 2. <> — what Echo adds and, crucially, what it does *not* add (honest scope). + @@ -113,13 +113,13 @@ This wiki is a *distillation*. The authoritative records are: * `CLAUDE.md` — current rung-state + the "DO NOT reopen" lists (read first). * `roadmap-gates.adoc` — the three identity gates and their failure actions. * `docs/echo-types/MAP.adoc` — the module map. -* `FOUNDATION_CONTRACT.md` — the *downstream-facing contract*: the stable +* `FOUNDATION_CONTRACT.adoc` — the *downstream-facing contract*: the stable `Echo.*` interface (index / modality / separation / measure seam) that consuming languages build against, and the boundary invariant *Echo IS-NOT a resource instance*. Read this first if you are wiring Echo into another language. * `.machine_readable/6a2/STATE.a2ml` — EI-2 record (permanent) + current-state block. -* `docs/bridges/cross-repo-bridge-status.md` — cross-repo bridge ledger. +* `docs/bridges/cross-repo-bridge-status.adoc` — cross-repo bridge ledger. == One-line status (as of 2026-10-26) diff --git a/wiki/Maintainer-Runbook.adoc b/wiki/Maintainer-Runbook.adoc index 6a3d7466..9098c99d 100644 --- a/wiki/Maintainer-Runbook.adoc +++ b/wiki/Maintainer-Runbook.adoc @@ -54,8 +54,8 @@ Per `CLAUDE.md`, each named theorem / iso-shape that lands triggers: decide landing / superseded / abandoned. . *Cherry-pick* to a consolidation branch off latest `main`, in dependency order (conflicts are usually additive, in `Smoke.agda` / `All.agda`). -. *Human docs* — sweep `roadmap.adoc`, `docs/echo-types/composition.md`, - `overview.md`, and the wiki for stale `(Open)` tags; use honest labels +. *Human docs* — sweep `roadmap.adoc`, `docs/echo-types/composition.adoc`, + `docs/echo-types/overview.adoc`, and the wiki for stale `(Open)` tags; use honest labels `(Landed)` / `(Partial)` / `(Open)`. . *Machine docs* — update `CLAUDE.md` current-rung-state and the `6a2/` files (see Section 4). @@ -72,7 +72,7 @@ When a *track's status changes*, the change must propagate to all of: framing (historical blocks are preserved, not deleted; mark them HISTORY). * `.machine_readable/6a2/META.a2ml` — add an ADR for any architecture-level decision (status / supersedes per `[development-practices.versioning-of-decisions]`). -* `docs/bridges/cross-repo-bridge-status.md` — the bridge ledger. +* `docs/bridges/cross-repo-bridge-status.adoc` — the bridge ledger. * the wiki (<> one-line status + <>). Worked example: the 2026-06-21 ordinal-track *retirement* (`D-2026-06-21`) was @@ -88,7 +88,7 @@ Versioning is SemVer 2.0.0 (current target `0.1.1`; recipe-extension target . [ ] Build cone green (Section 1) on `main`. . [ ] Identity gates reassessed (Section 2); any failure recorded in `docs/retractions.adoc`. -. [ ] `CHANGELOG.md` updated; `[Unreleased]` rolled to the version. +. [ ] `CHANGELOG.adoc` updated; `[Unreleased]` rolled to the version. . [ ] Machine docs current (Section 4): `6a2/STATE.a2ml`, `META.a2ml`, bridge ledger, wiki one-line status. . [ ] Tag minted; mirrors (gitlab, codeberg) consistent. diff --git a/wiki/Tutorial-Consuming-Echo.adoc b/wiki/Tutorial-Consuming-Echo.adoc index 6db7411b..8e9c021a 100644 --- a/wiki/Tutorial-Consuming-Echo.adoc +++ b/wiki/Tutorial-Consuming-Echo.adoc @@ -79,7 +79,7 @@ boundary invariant *Echo IS-NOT a resource instance* (see == 6. Four real consumers These are in-repo or in-estate bridges, not hypotheticals (ledger: -`docs/bridges/cross-repo-bridge-status.md`). +`docs/bridges/cross-repo-bridge-status.adoc`). * *phronesis (agentic ethics).* An ethical verdict's provenance IS `Echo verdict v`: the evaluator is non-injective, so the fibre retains *which* @@ -112,7 +112,7 @@ table. * `FOUNDATION_CONTRACT.adoc` — the stable `Echo.*` interface to build against. * *EchoTypes.jl* — run the finite-domain shadow on your own data. -* `docs/bridges/cross-repo-bridge-status.md` — every consumer bridge, with its +* `docs/bridges/cross-repo-bridge-status.adoc` — every consumer bridge, with its honest scope and main blocker. * <> — a worked first-class echo property (perfect vs partial; section vs no-section) to see the shape of a result. diff --git a/wiki/Working-Rules.adoc b/wiki/Working-Rules.adoc index 90ee6d1f..53f4cdcb 100644 --- a/wiki/Working-Rules.adoc +++ b/wiki/Working-Rules.adoc @@ -85,8 +85,8 @@ Each time a named theorem or iso-shape lands on the composition or ordinal tracks: . Branch housekeeping; cherry-pick to a consolidation branch in dependency order. -. Update human docs (`composition.md`, `roadmap.adoc`, `overview.md`, - `cross-repo-bridge-status.md`) — sweep stale `(Open)`/`[unblocked]` tags; +. Update human docs (`docs/echo-types/composition.adoc`, `roadmap.adoc`, `docs/echo-types/overview.adoc`, + `docs/bridges/cross-repo-bridge-status.adoc`) — sweep stale `(Open)`/`[unblocked]` tags; honest labels `(Landed)` / `(Partial)` / `(Open)`. . Update machine docs (`CLAUDE.md` current-rung-state + the `6a2/` files). . Verify `All.agda` + `Smoke.agda` exit 0; no postulates introduced.