Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions DOCUMENTATION_STATUS.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions FOUNDATIONS_BRIDGE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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+`)
|===

Expand Down Expand Up @@ -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+`._
4 changes: 2 additions & 2 deletions GLOSSARY.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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]]
Expand Down Expand Up @@ -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
Expand Down
6 changes: 3 additions & 3 deletions INDEX.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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"]
|===
Expand Down
2 changes: 1 addition & 1 deletion TOPOLOGY.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
4 changes: 2 additions & 2 deletions _handoff.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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:
Expand Down
8 changes: 4 additions & 4 deletions core/skepticisms/is-this-just-sigma-types.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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+`.
2 changes: 1 addition & 1 deletion docs/CLAIMS_AUDIT.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

Expand Down
4 changes: 2 additions & 2 deletions docs/EI2_READINGS_COMPARISON.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
11 changes: 5 additions & 6 deletions docs/adjacency/INSERTION_NOTE.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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.
14 changes: 8 additions & 6 deletions docs/adjacency/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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,
Expand All @@ -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.
14 changes: 8 additions & 6 deletions docs/adjacency/galois-connections.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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::[]
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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`
Expand All @@ -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.
12 changes: 8 additions & 4 deletions docs/adjacency/quotients.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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::[]
Expand Down Expand Up @@ -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.

Expand All @@ -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.
4 changes: 2 additions & 2 deletions docs/bridges/cross-repo-bridge-status.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/bridges/tropical-correspondence.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/characteristic.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Loading
Loading