Skip to content

Commit dce87e4

Browse files
claudehyperpolymath
authored andcommitted
docs: ecosystem status (must/intend/wish) + AFFIRMATION + wokelang handoff
- docs/ecosystem-status.adoc -- Must/Intend/Wish status tables for JtV (the normative anchor), Absolute Zero, JanusKey, and maa-framework (Mutually Assured Accountability -- not yet in working scope), grounded in each repo's STATE + contractiles. - AFFIRMATION.adoc -- point-in-time affirmation of JtV's verified state and standard-compliance at commit fff9689, timestamped 2026-06-19, following the RSR/estate convention (the standards repo wasn't in scope to copy its exact template; noted inline). - docs/handoffs/wokelang-kickoff.md -- a copy-pasteable kickoff prompt for a future Claude session on wokelang. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BJmfoz1ZS1Pejy9LLMY742
1 parent fff9689 commit dce87e4

3 files changed

Lines changed: 223 additions & 0 deletions

File tree

AFFIRMATION.adoc

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
// SPDX-License-Identifier: CC-BY-SA-4.0
2+
// Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3+
4+
= AFFIRMATION — JtV
5+
Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
6+
:revdate: 2026-06-19
7+
:revnumber: 1.0
8+
:toc: macro
9+
10+
[.lead]
11+
A point-in-time affirmation of the verified state and standard-compliance of the
12+
*JtV* repository (`hyperpolymath/jtv`, formerly `julia-the-viper`), recorded per
13+
the Rhodium Standard Repositories (RSR) / hyperpolymath estate convention.
14+
15+
[NOTE]
16+
====
17+
The hyperpolymath `standards` repository was not in this session's working scope,
18+
so this document follows the apparent RSR/estate convention and the in-repo
19+
contractile structure (`Mustfile`/`Intentfile`/`Trustfile`). Reconcile against
20+
the canonical `AFFIRMATION` template in `standards` when available.
21+
====
22+
23+
== Affirmation
24+
25+
As of *2026-06-19*, at commit `fff9689` on `main`, the following is affirmed of
26+
this repository.
27+
28+
=== Core guarantees (the normative MUSTs)
29+
30+
* *Harvard separation* — the Control language (Turing-complete) and the Data
31+
language (Total, addition-only) are grammatically separated; code injection is
32+
structurally — not heuristically — excluded.
33+
* *Totality* — the Data language is addition-only and provably halting.
34+
* *Reversibility / Echo soundness* — the `reverse {}` admissibility gate
35+
classifies against the *actual* (carrier-aware, inferred) Echo grade;
36+
annotations cannot loosen it. Float locals are soundly rejected (ADR-0010).
37+
* *ADR-0009 effect surface complete* — Echo and Epistemic are first-class graded
38+
function effects, on declarations (`@echo(...)` / `@epi(...)`) and in function
39+
types, with an upper-bound check against the composed grade.
40+
41+
=== Verification status
42+
43+
* *Rust* — `cargo build --workspace`, `cargo fmt --check`, and `cargo clippy`
44+
clean; *142 jtv-core lib tests* plus integration suites green.
45+
* *Lean 4* — the proof suite compiles with *0 `sorry` / `admit` / `axiom`*.
46+
* *Idris2* — the ABI definitions type-check.
47+
48+
=== Standard-compliance
49+
50+
* *Language policy* — Rust (core), Lean 4 / Idris2 (proofs), per the hyperpolymath
51+
standard; no banned languages introduced.
52+
* *Licensing* — MPL-2.0 (code) + CC-BY-SA-4.0 (docs), full per-file SPDX
53+
(gap-006 resolved).
54+
* *Provenance* — contractiles present; `.machine_readable/6a2/STATE.a2ml` current.
55+
56+
=== Honest open items (NOT yet affirmed)
57+
58+
* First-class function *values* (lambdas) — required to make the function-type
59+
effect check active (currently latent / representational).
60+
* `gap-005` — value-level number-system semantics beyond `τ = int`.
61+
* The GitHub repository-slug rename `julia-the-viper → jtv` (manual settings step,
62+
still pending).
63+
64+
== Signatory
65+
66+
Affirmed for the maintainer:
67+
68+
[%hardbreaks]
69+
Name: Jonathan D.A. Jewell (hyperpolymath)
70+
Date: 2026-06-19
71+
Commit: `fff9689`
72+
Repository: `hyperpolymath/jtv`
73+
74+
_Prepared during an automated (Claude Code) session and submitted for the
75+
maintainer's affirmation._

docs/ecosystem-status.adoc

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
// SPDX-License-Identifier: CC-BY-SA-4.0
2+
// Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3+
4+
= Ecosystem Status — Musts / Intends / Wishes
5+
Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
6+
:revdate: 2026-06-19
7+
:revnumber: 1.0
8+
:toc: left
9+
:sectnums:
10+
11+
[.lead]
12+
A point-in-time status of four hyperpolymath projects, each grouped into the
13+
normative tiers *MUST* (invariants / required), *INTEND* (declared, in-progress),
14+
and *WISH* (aspirational). JtV is the normative anchor.
15+
16+
Legend: ✅ done · ◑ partial · ◻ planned · ⚠ gap · ○ aspirational.
17+
18+
Sources / freshness: JtV is live (this session, commit `fff9689`); Absolute Zero
19+
from `STATE.a2ml` (2026-05-27); JanusKey from `STATE.a2ml` (2026-04-04, older) +
20+
README; maa-framework not yet in working scope (see §5).
21+
22+
== JtV — the normative anchor
23+
24+
Harvard-architecture language: Control (Turing-complete) vs Data (Total,
25+
addition-only); code injection grammatically impossible. Echo + Epistemic effect
26+
system for reversibility / structured loss.
27+
28+
[cols="1,5,3",options="header"]
29+
|===
30+
| Tier | Item | Where we are
31+
| MUST | Harvard separation → code injection *grammatically* impossible | ✅ structural
32+
| MUST | Data language addition-only & Total (provably halting) | ✅
33+
| MUST | Reversibility / Echo soundness — `reverse` gate on the *actual* grade; Lean proofs 0 `sorry/admit/axiom` | ✅ (carrier-aware + float-locals, ADR-0010)
34+
| MUST | ADR-0009 effect surface: Echo + Epistemic on declarations *and* function types | ✅ (#48–#50)
35+
| INTEND | First-class function *values* (lambdas) → activates the function-type effect check | ◻ next rung
36+
| INTEND | `gap-005`: value-level number-system semantics beyond `τ=int` | ◻ open
37+
| INTEND | `Settings → jtv` repo-slug rename (make the rebrand live) | ◻ manual
38+
| INTEND | PataCL Phase 1 → coprocessor implementation | ◻ external dep
39+
| WISH | v2 reversible-computing / quantum-algorithm simulation (Landauer, Grover/Shor) | ○ spec only
40+
| WISH | Router-visualization playground (the "killer demo") | ○
41+
|===
42+
43+
== Absolute Zero
44+
45+
Multi-prover formal verification of Certified Null Operations (CNO). ~65%,
46+
proof-completion phase.
47+
48+
[cols="1,5,3",options="header"]
49+
|===
50+
| Tier | Item | Where we are
51+
| MUST | Proofs green across provers: Coq 11/11 (0 `Admitted`), Lean 1631/1632, Agda `CNO.agda` clean | ✅ (2026-05-27)
52+
| MUST | Core CNO + category theory + statistical mechanics fully proven | ✅
53+
| MUST | Trusted-base discipline — 72 Coq axioms triaged (52 trusted / 17 discharge / 3 property-test) | ◑ Phase 1 (PR #58)
54+
| MUST | No Python (RSR) | ⚠ currently violated (high blocker)
55+
| INTEND | v0.8 compliance sprint (40%); discharge 17 §a Coq backlog axioms; Phase-2 triage (Lean 52 + Idris2 7) | ◻ in progress
56+
| INTEND | Migrate Python→Rust; physics-constant dedup; v0.9 container verification | ◻
57+
| WISH | v1.0 publication release + paper draft | ○
58+
| WISH | Mizar (10% stub) + Isabelle (40%) brought to parity | ○
59+
|===
60+
61+
== JanusKey
62+
63+
Architecturally-reversible file operations (data loss "impossible" by design, not
64+
backups). ~60%; content-addressed (SHA256), Rust.
65+
66+
[cols="1,5,3",options="header"]
67+
|===
68+
| Tier | Item | Where we are
69+
| MUST | 100% reversible file ops by *architecture* | ◑ implemented — *formal proofs still pending* (per README)
70+
| MUST | Content-addressed (SHA256) storage, audit trail, transactions | ✅
71+
| MUST | Coverage across p2p / e2e / aspect-security / concurrency | ✅ 56 tests / 64 points (CRG D→C blitz)
72+
| MUST | License = MPL-2.0 | ✅ migrated (a740439, #52); PMPL stragglers retired (#65)
73+
| INTEND | API stability review (stated current phase) | ◻
74+
| INTEND | Land the formal reversibility proofs; climb CRG grade (D→C→…) | ◻
75+
| WISH | Broader packaging / adoption | ○ thin in current state
76+
|===
77+
78+
== maa-framework — Mutually Assured Accountability
79+
80+
The *Mutually Assured Accountability* framework. ⚠ *Not yet groundable from this
81+
session:* it is not in the current working repo scope, not cloned locally, and the
82+
repo-management tooling (`list_repos`/`add_repo`) was unavailable — so no MUST /
83+
INTEND / WISH rows are recorded here rather than invent them. Add it to scope
84+
(when the tooling is available) to populate this section from its own `STATE` and
85+
contractiles.
86+
87+
== Where we are (synthesis)
88+
89+
* *JtV* is the most mature and the only one advanced this session: core guarantees
90+
and the full Echo + Epistemic effect surface are done and proven; remaining work
91+
is feature-reach (function values) plus one manual rename.
92+
* *Absolute Zero* is deep in proof-completion — green across provers, grinding down
93+
axiom / Python debt toward a publishable v1.0.
94+
* *JanusKey* is feature- and test-complete in architecture but has not yet *proven*
95+
its headline reversibility claim; its license migration is now finished.
96+
* *maa-framework* awaits inclusion in working scope.

docs/handoffs/wokelang-kickoff.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
2+
<!-- Copyright (c) 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> -->
3+
<!-- Prepared 2026-06-19 as a handoff prompt for a future Claude session on wokelang. -->
4+
5+
# Kickoff prompt — wokelang
6+
7+
Paste the block below to the next Claude session that has the **wokelang** repo
8+
(`hyperpolymath/wokelang`, one of the nextgen-languages portfolio) in scope.
9+
10+
---
11+
12+
You are continuing work on **wokelang**, a language in the hyperpolymath /
13+
nextgen-languages portfolio. Work on the designated `claude/...` feature branch;
14+
commit with clear messages; push; open a **draft** PR when a rung lands.
15+
16+
**First, orient yourself (read before changing anything):**
17+
1. `.claude/CLAUDE.md` and any root `CLAUDE.md` — project-specific rules override defaults.
18+
2. `.machine_readable/6a2/STATE.a2ml` — current state, milestones, blockers, next-actions.
19+
3. `README.adoc` / `README.md` and `docs/` — purpose and design.
20+
4. `contractiles/``Mustfile` (invariants that MUST hold), `Intentfile` (declared intent), `Trustfile` (provenance).
21+
5. The build entrypoint — `Justfile` (run `just --list`), `guix.scm` (primary) / `flake.nix` (fallback).
22+
23+
**Then produce a status before diving in:** a short table grouped into **MUST /
24+
INTEND / WISH** (mirror `hyperpolymath/jtv:docs/ecosystem-status.adoc`), grounded
25+
in `STATE.a2ml` + contractiles — and propose the single smallest useful next rung.
26+
Confirm direction if it's ambiguous or architecturally significant.
27+
28+
**Hyperpolymath standards to hold to:**
29+
- **Language policy:** AffineScript (primary app code) · Rust (systems/CLI/WASM) ·
30+
Deno (runtime/pkg) · Gleam (BEAM services) · Julia (batch/data) · Guile Scheme
31+
(state/meta `.a2ml`) · Nickel (config) · OCaml/Ada where specified.
32+
**Banned:** TypeScript, ReScript (→ AffineScript), Node/npm/bun/pnpm/yarn (→ Deno),
33+
Go (→ Rust), Python (→ Julia/Rust), Java/Kotlin/Swift/RN/Flutter (→ Rust/Tauri/Dioxus).
34+
- **Licensing:** MPL-2.0 (code) + CC-BY-SA-4.0 (docs), full per-file SPDX headers.
35+
The PMPL-1.0 / Palimpsest *license* is retired across the estate (keep "Palimpsest"
36+
only as philosophy/name, never as an SPDX id or a separate `LICENSE`).
37+
- **Hygiene (RSR):** `Justfile` not `Makefile`; `Containerfile` not `Dockerfile`;
38+
no hardcoded developer paths; HTTPS only; SHA256+ (no MD5/SHA1); no hardcoded
39+
secrets; SHA-pinned deps; Guix primary / Nix fallback.
40+
41+
**Working discipline (mirror the JtV cadence):**
42+
- Every change ends with the relevant build/test command **run**, with captured output.
43+
- Headline results pinned (tests/CI green) — no overclaiming; if something is
44+
partial or representational, say so explicitly.
45+
- Update `.machine_readable/6a2/STATE.a2ml` (session-history + next-actions) and the
46+
contractiles when a rung lands.
47+
- One concern per PR; draft PRs; never push to `main`.
48+
49+
Start by reading the orientation files above and reporting wokelang's current
50+
MUST/INTEND/WISH status + your proposed first rung.
51+
52+
---

0 commit comments

Comments
 (0)