Skip to content

Commit 524e0e3

Browse files
committed
docs: finish de-monorepo-ing the trackers and prose
Sweep the stale in-tree / count residue the reconciliation PRs did not reach: - PROOF-NEEDS.md: drop the ~456,000-LOC count and reframe the in-tree paths as living in each language's own repo (this coordinator holds no proof code). - README.adoc: disambiguate the Tangle language from the out-of-scope KRL resolution stack (heading, database-relationship line, entry-point note). - EXPLAINME.adoc: reconcile the language count (was 'ten / eight core + two') to the current 14 languages + KitchenSpeak DSL, pointing at LANGUAGES.a2ml as canonical and noting the representative table is a subset. - language-status-tracker.jl: make the repos dir overridable via HYPERPOLYMATH_REPOS_DIR so it is not pinned to ~/Documents. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
1 parent e8c68ac commit 524e0e3

4 files changed

Lines changed: 25 additions & 15 deletions

File tree

EXPLAINME.adoc

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,20 +22,21 @@ NOTE: `tentacles-agentic-syllabus` is NOT a programming language. It is an
2222
educational framework using My-Lang's dialects as a curriculum vehicle. Never
2323
audit it as a language implementation.
2424

25-
== Claim 1: "Ten languages that cover the full spectrum of modern software challenges"
25+
== Claim 1: "A family of languages covering the full spectrum of modern software challenges"
2626

2727
[quote, README]
2828
____
29-
A coordinated effort to design and develop ten programming languages that
29+
A coordinated effort to design and develop a family of programming languages that
3030
collectively cover the full spectrum of modern software challenges, from
3131
AI-native development to formally verified real-time systems.
3232
____
3333

3434
=== How it works
3535

36-
The eight core languages plus two specialised languages are designed to
37-
complement each other, not compete. They occupy distinct cells in the design
38-
space (each maintained as a standalone `hyperpolymath/<lang>` repo):
36+
The family currently spans fourteen languages plus the KitchenSpeak DSL — the canonical
37+
list is `.machine_readable/LANGUAGES.a2ml`. They are designed to complement each other, not
38+
compete, each occupying a distinct cell in the design space (each maintained as a standalone
39+
`hyperpolymath/<lang>` repo). The table below shows the representative core:
3940

4041
[cols="1,1,2,1"]
4142
|===
@@ -90,9 +91,14 @@ Gossamer backend. Rust compiler, Coq proofs.
9091
| Rust (17 crates), Coq proofs
9192
|===
9293

94+
NOTE: The table shows a representative core. The full family also includes *betlang*
95+
(probabilistic), *JtV* (systems / Harvard architecture), *Haec* (trope-particularity),
96+
*error-lang* (pedagogical), *Tangle* (topological), and *007* (a private agent
97+
meta-language) — see `.machine_readable/LANGUAGES.a2ml` for the canonical registry.
98+
9399
NOTE: *KitchenSpeak* — an experimental applied-type-theory teaching DSL
94100
(seven-type kitchen orchestration: Tropical, Linear, Choreographic, Echo,
95-
Dyadic, Ceremonial, Primitive) — is NOT one of the ten core languages and is
101+
Dyadic, Ceremonial, Primitive) — is NOT one of the core languages above and is
96102
no longer carried in this repo. It is canonical at the standalone
97103
link:https://github.com/hyperpolymath/kitchenspeak[`hyperpolymath/kitchenspeak`]
98104
repository (v2.0: physics-in-the-types, reference OCaml compiler, machine-checked

PROOF-NEEDS.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,14 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
66

77
## Current State
88

9-
- **src/abi/*.idr**: YES (in oblibeny) — `Interface.idr`
10-
- **Dangerous patterns**: 4 `Admitted` in ephapax/formal/Semantics.v (ctx_transfer 15/24, subst_lemma, preservation)
11-
- **LOC**: ~456,000 (OCaml + Rust + Coq + Idris2 + Lean)
12-
- **Existing proofs**: Ephapax has Coq proofs, Tangle has Lean proofs, Idris2 in multiple sub-languages
9+
`nextgen-languages` is a pure coordinator and holds **no** proof code. This file tracks the
10+
family's proof gaps across the standalone `hyperpolymath/<lang>` repos; every path below is
11+
relative to the named language's own repo, not this one.
12+
13+
- **Ephapax** — Coq proofs present; 4 `Admitted` remain in `formal/Semantics.v` (ctx_transfer 15/24, subst_lemma, preservation, + one more).
14+
- **Tangle** — Lean proofs present (`Tangle.lean`); coverage partial.
15+
- **Oblíbený** — Idris2 ABI present (`src/abi/Interface.idr`); minimal.
16+
- **AffineScript** — OCaml type checker + Rust runtime; soundness proofs outstanding.
1317

1418
## What Needs Proving
1519

README.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,9 @@ Status: design-stage, with partial specifications and experimental implementatio
4343

4444
---
4545

46-
=== KRL — Knot Resolution Language (Tangle)
46+
=== Tangle
4747

48-
A topologically inspired language where programs are represented as tangles (braids), and equivalence is defined by isotopy.
48+
A topologically inspired language where programs are represented as tangles (braids), and equivalence is defined by isotopy. Its IR (TangleIR) is consumed by the separate *KRL resolution stack* (`krl → TangleIR → VeriSimCore → Skein.jl / QuandleDB`), which is tracked by the database estate — not part of this coordinator's language family.
4949

5050
* Composition and tensor operations correspond to braid structure
5151
* Formal semantics specified
@@ -141,7 +141,7 @@ Type-theoretic boundaries are made explicit: total proof-like fragments are dist
141141

142142
These languages are designed to work with systems that treat equivalence, provenance, and semantic identity as first-class concepts:
143143

144-
KRL ↔ QuandleDB / Skein
144+
Tangle (via the separate KRL resolution stack) ↔ QuandleDB / Skein
145145
JtV ↔ future equivalence-aware runtime and storage models
146146

147147
See the nextgen-databases repository for details.
@@ -196,7 +196,7 @@ production system. The work it tracks spans, across the individual language repo
196196
Each language lives in its own `hyperpolymath/<lang>` repo; start there. For orientation:
197197

198198
* link:https://github.com/hyperpolymath/tangle[`hyperpolymath/tangle`] — `Tangle.lean`, the
199-
mechanised type-safety proof for the Tangle (KRL) core; topological language design
199+
mechanised type-safety proof for the Tangle core; topological language design
200200
* link:https://github.com/hyperpolymath/jtv[`hyperpolymath/jtv`] — computation as
201201
path-based construction
202202

language-status-tracker.jl

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
using Dates
77

8-
const REPOS_DIR = joinpath(homedir(), "Documents/hyperpolymath-repos")
8+
const REPOS_DIR = get(ENV, "HYPERPOLYMATH_REPOS_DIR", joinpath(homedir(), "Documents/hyperpolymath-repos"))
99

1010
# All known language repos
1111
const LANGUAGES = [

0 commit comments

Comments
 (0)