Skip to content

Commit d45bd62

Browse files
committed
docs(machine-readable): bring echo-types governance scaffold to estate standard
echo-types had only 6a2/ — add the full estate scaffold (modelled on nextgen-typing; content from CLAUDE.md + roadmap-gates + the cross-repo bridge ledger), keeping echo-types' committed Guile-Scheme house style for the 6a2 set (no schema drift): - anchors/ANCHOR.a2ml — clade uuid/primary/assigned = 'TODO: assign via gv-clade-index registry' (NOT fabricated); trust/Trustfile asserts the clade stays TODO until assigned. - contractiles/ README + must/trust/dust/bust (harmonised with the root contractiles/). - svc/k9/ README + methodology-guard + kennel/yard/hunt templates + 3 examples. - agent_instructions/ README + methodology/coverage/debt. - integrations/ echotypes-jl, arghda-core, panll, groove, verisim. - bot_directives/ hypatia/gitbot-fleet/git-private-farm (no fabricated tokens). - 0-AI-MANIFEST + 6a2 STATE/META/ECOSYSTEM refreshed; EI-2 record preserved. FLAG: echo-types has NO clade assigned — needs a gv-clade-index registry assignment. https://claude.ai/code/session_013wg3Mtq2QFhYi4XVw1Z6z7
1 parent 64ef20a commit d45bd62

32 files changed

Lines changed: 2061 additions & 7 deletions

.machine_readable/6a2/ECOSYSTEM.a2ml

Lines changed: 78 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,21 @@
1515
;;;
1616
;;; SPDX-License-Identifier: MPL-2.0
1717
;;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell
18+
;;;
19+
;;; NOTE (refreshed 2026-06-12): `panll-constellation` and
20+
;;; `companion-and-bridge-projects` blocks added at the END to record the
21+
;;; concrete hyperpolymath / PanLL ecosystem position from CLAUDE.md and
22+
;;; docs/bridges/cross-repo-bridge-status.md (2026-06-02). The generic
23+
;;; sibling-projects block above is retained as historical context.
1824

1925
(define-module (echo-types ecosystem)
2026
#:export (constellation-membership
2127
schema-dependencies
2228
sibling-projects
2329
cross-repo-conventions
24-
integrity-checks))
30+
integrity-checks
31+
panll-constellation
32+
companion-and-bridge-projects))
2533

2634
;;; ============================================================
2735
;;; Constellation membership
@@ -155,6 +163,75 @@
155163
(current-status . pass)
156164
(verification . "Cross-checked at last update."))))
157165

166+
;;; ============================================================
167+
;;; PanLL constellation position (refreshed 2026-06-12)
168+
;;; Sourced from CLAUDE.md "Ecosystem context".
169+
;;; ============================================================
170+
171+
(define panll-constellation
172+
'((node . "echo-types")
173+
(role . "Foundational formal-verification library: constructive Agda formalisation of fiber-based structured loss. A theoretical artefact and downstream consumer of HoTT + category-theoretic concepts; not a runtime component of any HTI.")
174+
(neighbours
175+
(((name . "PanLL")
176+
(one-line . "Three-pane cognitive-relief HTI; Ambient / Symbolic / Neural / World panes.")
177+
(repo . "github.com/hyperpolymath/panll")
178+
(relation . "Top-level interface consumer of the constellation; echo-types is a foundation it can cite, not a build dependency."))
179+
((name . "Gossamer")
180+
(one-line . "Zig + WebKitGTK webview shell used by PanLL (~5 MB binary).")
181+
(relation . "PanLL presentation substrate; no echo-types dependency."))
182+
((name . "Burble")
183+
(one-line . "Self-hostable voice-comms platform; Zig SIMD audio, IEEE-1588 PTP sync, browser-based, configurable topology.")
184+
(relation . "PanLL team-replication service alongside Gossamer; no echo-types dependency."))
185+
((name . "Ephapax")
186+
(one-line . "Programming language with a linear type system guaranteeing WASM memory safety (compile-time no use-after-free / no leaks).")
187+
(repo . "github.com/hyperpolymath/ephapax")
188+
(relation . "ACTIVE BRIDGE — EchoEphapaxBridge.agda (L3, content bridge NARROW); ephapax/formal/Echo.v ports EchoLinear + EchoResidue under a K-free zero-axiom discipline."))
189+
((name . "VeriSim / VeriSimDB")
190+
(one-line . "Identity-state capture with filesystem fallback; VCL-total is its next-gen interaction language (10 levels of type safety).")
191+
(relation . "Constellation database / state layer; potential consumer, no current echo-types dependency."))
192+
((name . "Groove protocol")
193+
(one-line . "HTTP-based service-discovery; capabilities announce themselves for automatic detection + integration.")
194+
(relation . "Constellation snap-on/snap-off discovery mechanism; echo-types exposes no service yet (port unassigned)."))
195+
((name . "Echidna (hyperpolymath)")
196+
(one-line . "Planned high-assurance interface verification. NOT the Ethereum fuzzer of the same name.")
197+
(relation . "Conceptual sibling — broader prover ecosystem; exact repo still to confirm."))))))
198+
199+
;;; ============================================================
200+
;;; Companion + bridge projects (refreshed 2026-06-12)
201+
;;; Concrete, verifiable from the cross-repo bridge ledger.
202+
;;; ============================================================
203+
204+
(define companion-and-bridge-projects
205+
'(((name . "EchoTypes.jl")
206+
(repo . "github.com/hyperpolymath/EchoTypes.jl")
207+
(kind . executable-companion)
208+
(version . "0.2.0 (pinned to commit e7dded6)")
209+
(relation . "Executable Julia companion mirroring the finite-domain shadow of the Tier-1+Tier-2 spine + the unconditional F5 OFS fragment. Falsifies-by-counterexample on concrete data; makes NO proof claims — the Agda here remains the source of truth. R-2026-05-18 retracted surface + funext-qualified F5 clauses NOT mirrored.")
210+
(registry . "julia-professional-registry")
211+
(ci-coupling . "none in either direction"))
212+
213+
((name . "arghda-core")
214+
(repo . "github.com/hyperpolymath/arghda-core")
215+
(kind . extracted-tool)
216+
(relation . "Language-agnostic proof-workspace engine (triage folders inbox→working→proven/rejected, linter, DAG view). Extracted from echo-types 2026-05-30 (see echo-types#159); the arghda-core/ subtree + cross-refs were removed from this repo (PR #160). arghda-panll (Gossamer/ReScript presentation) is planned.")
217+
(motivating-pipeline . "docs/buchholz-plan.adoc appendix"))
218+
219+
((name . "absolute-zero")
220+
(kind . cross-prover-bridge)
221+
(relation . "EchoCNOBridge.agda imports IsCNO / empty-is-cno / halt-is-cno / cno-composition / absolute-zero-is-cno / seq-comp from absolute-zero/proofs/agda/CNO.agda; content-bridge done. Cross-prover Coq/Lean4 statement alignment table drafted in cross-repo-bridge-status.md."))
222+
223+
((name . "januskey")
224+
(kind . name-bridge)
225+
(relation . "EchoJanusBridge.agda — name-bridge only; structural-mirror to the 8-variant Idris2 OpKind ABI decided; content-bridge gated on januskey/PROOF-NEEDS.md."))
226+
227+
((name . "tropical-resource-typing")
228+
(kind . citation-level-alignment)
229+
(relation . "EchoTropical.agda ↔ Tropical.thy / TropicalSessionTypes.lean; Agda cannot import .thy/.lean, so alignment is statement-correspondence with independent per-language proof. First pair: ⊕-idem ↔ trop_add_idem ↔ add_comm_trop + add_assoc_trop."))
230+
231+
((name . "valence-shell / ochrance")
232+
(kind . exploratory-downstream-consumer)
233+
(relation . "Citation-level ONLY. Echo's structured-loss vocabulary (EchoResidue / EchoResidueTaxonomy / EchoLossTaxonomy / EchoObservationalEquivalence / EchoNoSectionGeneric) may classify shell state transitions; Ochránce may supply receipt evidence. Core Affect = NO: no bridge module, nothing wired into All.agda / Smoke.agda. echo-types makes no claim about their implementation correctness."))))
234+
158235
;;; ============================================================
159236
;;; END OF ECOSYSTEM
160237
;;; ============================================================

.machine_readable/6a2/META.a2ml

Lines changed: 53 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,18 @@
88
;;;
99
;;; SPDX-License-Identifier: MPL-2.0
1010
;;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell
11+
;;;
12+
;;; NOTE (refreshed 2026-06-12): adr-001..adr-006 capture the EI-2 closure;
13+
;;; adr-007..adr-009 capture the Pillar F earn-back programme (CLOSED
14+
;;; 2026-05-20). The `current-practices` block at the END of this file
15+
;;; states the live working-rules surface for a fresh session. No ADR was
16+
;;; reshaped in the 2026-06-12 governance sweep.
1117

1218
(define-module (echo-types meta)
1319
#:export (architecture-decisions
1420
development-practices
15-
design-rationale))
21+
design-rationale
22+
current-practices))
1623

1724
;;; ============================================================
1825
;;; Architecture Decision Records
@@ -148,6 +155,51 @@
148155
(why-state-not-ad-hoc-handover
149156
"Earlier sessions used ad-hoc handover documents (text files, conversation summaries). This session captures the termination in state-a2ml STATE.scm form so it is machine-readable, schema-validated against standards/state-a2ml/spec/abnf/state.abnf, and joins the ecosystem of *-a2ml documents the user maintains. Future Claude sessions can parse and consult it programmatically.")))
150157

158+
;;; ============================================================
159+
;;; Current practices (refreshed 2026-06-12) — the live working-rules
160+
;;; surface. Sourced from CLAUDE.md "Working rules in this repo".
161+
;;; ============================================================
162+
163+
(define current-practices
164+
'((build-invariant
165+
(rule . "Every edit ends with an Agda compile command and captured output.")
166+
(target . "agda -i proofs/agda proofs/agda/All.agda + proofs/agda/Smoke.agda both exit 0 under --safe --without-K."))
167+
168+
(proof-discipline
169+
(safe-without-k . "--safe --without-K throughout — mandatory, no exceptions.")
170+
(no-postulates . "No postulates unless explicitly isolated and justified. Load-bearing tracks carry zero. Exploratory truncation postulates, where they exist, are enumerated in docs/proof-debt.md.")
171+
(no-escape-hatches . "No believe_me / primTrustMe / primEraseEquality / sorry / Admitted / unsafeCoerce / Obj.magic anywhere.")
172+
(no-funext-in-trusted-base . "funext is never a postulate; where strict forms need it (e.g. F4 / F5 strict clauses) it is taken as an explicit module parameter, isolated from the trusted base.")
173+
(kernel-cone . "The funext-free kernel cone is exactly { Echo, EchoKernel }, enforced by scripts/kernel-guard.sh against docs/echo-types/echo-kernel-note.adoc."))
174+
175+
(smoke-and-all-discipline
176+
(pin-every-headline . "Every headline theorem must be pinned in Smoke.agda via a `using` clause, under its own open-import block with a header comment.")
177+
(wire-every-module . "Every new module goes into All.agda as an open import. Orphan modules that compile but are not in All.agda are treated as dead code."))
178+
179+
(rung-consolidation-policy
180+
(when . "Each time a new proof rung lands on the composition or ordinal tracks (a named theorem or iso-shape).")
181+
(steps . ("branch housekeeping; cherry-pick to a consolidation branch in dependency order"
182+
"update human docs (composition.md, roadmap.adoc, overview.md, cross-repo-bridge-status.md) — sweep stale (Open)/[unblocked] tags; honest labels (Landed)/(Partial)/(Open)"
183+
"update machine docs (CLAUDE.md current-rung-state + these 6a2 files)"
184+
"verify All.agda + Smoke.agda exit 0; no postulates introduced"
185+
"fast-forward main; session ledger records rung name + commits + remaining open pieces + smallest useful next advance")))
186+
187+
(naming-traps
188+
(mode-graded . "ModeGraded (with trailing 'd') is canonical; proofs/agda/characteristic/ModeGrade.agda is FORBIDDEN (see STATE do-not-redo + AGENTIC G-003).")
189+
(decoration-join . "Abstract join field in DecorationStructure is `join`, not `_⊔_` (avoids Level._⊔_ collision); per-decoration modules keep suffixed forms (_⊔g_, _⊔m_, _⊔a_)."))
190+
191+
(parallel-session-discipline
192+
(rule . "Multiple Claude sessions may work the repo concurrently. Stay clear of another session's declared territory; use `--only <paths>` when both sessions must commit before sync.")
193+
(admin-merge . "Ordinal-track admin-merges should wait for CI green before merging — the same gate-discipline the rest of the repo follows (lesson from PR #133/#134)."))
194+
195+
(estate-conventions
196+
(license . "MPL-2.0 for code and docs (CC-BY-4.0 on some prose docs); SPDX header on every file.")
197+
(forge . "GitHub canonical; GitLab + Codeberg as read-only mirrors (sd-003 / adr-005).")
198+
(docs . "AsciiDoc preferred over Markdown (README.md is the GitHub-render exception).")
199+
(config . "Nickel/CUE/Dhall preferred over YAML (YAML only where GitHub Actions forces it).")
200+
(containers . "Containerfile (Podman), never Dockerfile; base images @sha256-pinned.")
201+
(build-driver . "Justfile (not Makefile); flake.nix + stapeln.toml present."))))
202+
151203
;;; ============================================================
152204
;;; END OF META
153205
;;; ============================================================

.machine_readable/6a2/STATE.a2ml

Lines changed: 94 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,13 @@
1212
;;; concluded; the verdict is negative; the documentation cascade has been
1313
;;; applied; the recipe is no longer a candidate locus of distinctness.
1414
;;;
15+
;;; NOTE (refreshed 2026-06-12): the original body of this file is the EI-2
16+
;;; termination capture (2026-04-29). It is PERMANENT RECORD and is referenced
17+
;;; by AGENTIC gates G-001/G-005 and by Trustfile check `ei-2-record-intact`.
18+
;;; Do not delete it. The `current-state` block at the END of this file brings
19+
;;; the project's three active workstreams up to current reality without
20+
;;; disturbing the historical record.
21+
;;;
1522
;;; SPDX-License-Identifier: MPL-2.0
1623
;;; SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell
1724

@@ -24,7 +31,10 @@
2431
cascade-applied
2532
do-not-redo
2633
next-actions
27-
forbidden-rebrandings))
34+
forbidden-rebrandings
35+
earn-back-summary
36+
theory-work-summary
37+
current-state))
2838

2939
;;; ============================================================
3040
;;; Project identity
@@ -353,6 +363,89 @@
353363
(example-10-abstract-interp . "EchoExampleAbsInt.agda (PR #82)")
354364
(example-6-numeric . "still unblocked, only remaining example item")))))
355365

366+
;;; ============================================================
367+
;;; Current state (refreshed 2026-06-12) — the three active
368+
;;; workstreams. Sourced from CLAUDE.md rung-state + roadmap-gates.adoc
369+
;;; + docs/bridges/cross-repo-bridge-status.md (2026-06-02).
370+
;;; ============================================================
371+
;;;
372+
;;; This block is the up-to-date status surface. The EI-2 record above
373+
;;; is permanent history; this block is the living state. Honest labels
374+
;;; are (landed) / (partial) / (open) per the rung-consolidation policy.
375+
376+
(define current-state
377+
'((as-of . "2026-06-12")
378+
(one-line . "Constructive Agda formalisation of fiber-based structured loss (\"echo types\"): Echo f y := Σ (x : A) , (f x ≡ y). --safe --without-K throughout; zero postulates in load-bearing tracks; gated identity-claim development.")
379+
(build-invariant
380+
. "agda -i proofs/agda proofs/agda/All.agda and proofs/agda/Smoke.agda both exit 0 under --safe --without-K. Every headline theorem pinned in Smoke.agda via a `using` clause; every module wired into All.agda. scripts/kernel-guard.sh PASS.")
381+
(toolchain
382+
. ((agda . ">= 2.6.3")
383+
(stdlib . ">= 2.3 (CI installs v2.3)")
384+
(ci-workflow . ".github/workflows/agda.yml")))
385+
386+
(workstreams
387+
((composition-track
388+
(doc . "Echo.agda + docs/echo-types/{composition,fibration-package,universal-property}.adoc")
389+
(status . landed)
390+
(highlights
391+
. ("Base accumulation iso Echo-comp-iso (packaged _↔_)"
392+
"Cancellation iso cancel-iso parameterised by s-left/s-right + both triangle identities (PR #25)"
393+
"Pentagon coherence complete: Echo-comp-iso-pent-{B,echo} as refl; full Σ-associativity iso Echo-comp-pent-Σ-assoc packaged via stdlib Function.Bundles._↔_")))
394+
395+
(ordinal-track
396+
(doc . "docs/echo-types/buchholz-plan.adoc + buchholz-rank-obstruction.adoc")
397+
(status . partial)
398+
(target . "Bachmann–Howard ψ₀(Ω_ω) as first credible milestone; stretch ψ(Ω_Ω) ≈ TFBO")
399+
(highlights
400+
. ("E1–E7 landed (OT syntax, ℕ-staged closure, CNF, pedagogical ψ, Buchholz scaffold, well-formedness, echo bridge)"
401+
"WfCNF restriction + limit-shaped ω-power rank: RankPow / RankPowDomination / HeadOmega / HeadOmegaInversion landed"
402+
"Slice 3+4 Route A arc landed (PRs #165–#170): RankMonoUnion umbrella over source-rule extensions; well-foundedness of _<ᵇᵘ_ via rank-embedding transport (#170)"
403+
"WF-0 partial Buchholz order _<ᵇ_ and WF-1 well-foundedness wf-<ᵇ landed for the admitted core"))
404+
(open
405+
. ("Full constructor set beyond the admitted core (K-limited shared-binder cases <ᵇ-ψα, <ᵇ-+2)"
406+
"Unbudgeted _<ᵇʳᶠ_ global WF — eliminate the explicit ℕ budget from wf-<ᵇʳᶠᵇ without leaving --safe --without-K"
407+
"Push the surface-route WF back into Order.agda's main _<ᵇ_ package")))
408+
409+
(establishment-track
410+
(doc . "docs/echo-types/establishment-plan.adoc + earn-back-plan.adoc + paper.adoc + types-abstract.adoc")
411+
(status . partial)
412+
(thesis . "Echo characterised as a *reindexing modality of structured loss* (coeffect/quantitative lineage) — explicitly NOT the linear/dependent judgmental ladder; Echo adds no new judgment, it is definitionally fib.")
413+
(highlights
414+
. ("Pillars A–D internal programme COMPLETE + verified (2026-05-17): EchoFiberBridge, EchoPullback, EchoGradedComonad, EchoSeparating, EchoRelModel"
415+
"Pillar F earn-back programme CLOSED (2026-05-20): F4+F2 (2026-05-18), F1+F3 (2026-05-20) — see earn-back-summary + META adr-007/008/009"
416+
"Tier-1+2+3 canonical-identity spine + audience moves + EchoCanonicalIdentitySuite (2026-05-27)"
417+
"R-2026-05-18 retractions discipline: five claims retracted, four earned back at honest strength, conservativity metatheorem stays retracted"))
418+
(open
419+
. ("Pillar E only: clear paper.adoc [EXPAND] tags (background primer landed; related-work / evaluation / ordinal consumer-evidence appendix pending — last gated on Bachmann–Howard)"
420+
"THEN offline/author-driven: Zenodo DOI + installable library packaging + outreach (flag to user; do NOT auto-run)")))))
421+
422+
(cross-repo-bridges
423+
;; Source of truth: docs/bridges/cross-repo-bridge-status.md (2026-06-02).
424+
((cno-bridge . "content-bridge done (EchoCNOBridge.agda ↔ absolute-zero/CNO.agda); cross-prover Coq/Lean4 alignment is the next row")
425+
(janus-bridge . "name-bridge only; structural-mirror to januskey Idris2 OpKind decided, content-bridge deferred")
426+
(tropical . "citation-level alignment (Agda cannot import .thy/.lean); first alignable pair identified")
427+
(echotypes-jl . "executable companion shipped — EchoTypes.jl v0.2.0 (pinned e7dded6); finite-domain shadow, no proof claims; Agda is source of truth")
428+
(ephapax-l3 . "navigability bridge done, content bridge NARROW (EchoEphapaxBridge.agda; L3 only)")
429+
(valence-ochrance . "exploratory downstream consumer; citation-level only, NO bridge module, Core Affect = NO")))
430+
431+
(governance-artefacts-added
432+
;; This 2026-06-12 machine-readable / governance sweep.
433+
((6a2 . "AGENTIC/NEUROSYM/PLAYBOOK already present (Guile Scheme); STATE/META/ECOSYSTEM refreshed to current reality")
434+
(anchors . "anchors/ANCHOR.a2ml created; clade assignment is a TODO (gv-clade-index registry)")
435+
(contractiles . ".machine_readable/contractiles/{must,dust,bust,trust} created, harmonised with the existing root contractiles/")
436+
(svc-k9 . "svc/k9 self-validation templates added")
437+
(agent-instructions . "agent_instructions/{methodology,coverage,debt,README} added")
438+
(integrations . "integrations/{echotypes-jl,arghda-core,panll,groove,verisim} added from real bridge facts")
439+
(bot-directives . "bot_directives/{hypatia,gitbot-fleet,git-private-farm} hook directives added")
440+
(wiki . "in-tree wiki/ authored: Home + Overview + Architecture + Working-Rules + Roadmap (AsciiDoc)")))
441+
442+
(do-not-reopen-current
443+
. ("Pillars A–D internal programme (complete since 2026-05-17)"
444+
"Pillar F gates F1–F4 (closed 2026-05-20; F1 via EchoGradedComonadF1, F3 via two non-iso grade-monoid instances)"
445+
"the R-2026-05-18 retraction narrowings (conservativity metatheorem stays retracted)"
446+
"the closed Buchholz constructor set under WfCNF + admissibility + lex-pair"
447+
"EI-2 (terminated 2026-04-29; see terminated-questions above)"))))
448+
356449
;;; ============================================================
357450
;;; END OF STATE
358451
;;; ============================================================

0 commit comments

Comments
 (0)