Skip to content

Commit 32125e3

Browse files
authored
Merge pull request #29 from BuddhiLW/staging
release: v1.15.0 (rounds 5-6)
2 parents ce4d5d4 + e068c17 commit 32125e3

172 files changed

Lines changed: 8759 additions & 1662 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/CLAUDE.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,9 @@ does not override the smell sensor. Mechanism: the smell corpus in memory, layer
4848
What is unfinished: `.dev/debt.yaml` + the kanban board.
4949
- **Read-only references**: cw v0 through git only (`git show v0.5.0:<path>`,
5050
or `git worktree add ../cw-v0 v0.5.0`). zwasm clone at
51-
`~/PP/referential-projects/zwasm`. The `~/Documents/OSS/{clojure,babashka,zig}`
52-
and `~/Documents/MyProducts/ClojureWasm` paths in older text are the
51+
`~/PP/zwasm` (origin `BuddhiLW/zwasm`, the fork `build.zig.zon` pins).
52+
The `~/Documents/OSS/{clojure,babashka,zig}` and
53+
`~/Documents/MyProducts/ClojureWasm` paths in older text are the
5354
**upstream author's machine layout**, inherited by the fork and never valid
5455
here. A survey that needs JVM Clojure, Babashka or the Zig stdlib must be
5556
pointed at a tree that exists, or clone one first.

‎.claude/skills/continue/SKILL.md‎

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: continue
3-
description: Resume fully autonomous work on the `main` branch and drive the per-task TDD loop. Trigger when the user says 続けて, "resume", "pick up where we left off", "/continue", "次", "go", or starts a fresh session expecting prior context. `/continue` may also be re-invoked automatically (cron / wake hook); treat every invocation as the same go signal. The full step-by-step loop spec (Step 0 → 7) lives in CLAUDE.md § Autonomous Workflow + § The only stop (single condition: user explicit stop) and is loaded into every turn's system prompt; this skill is the invocation trigger and carries the resume procedure, the Phase-boundary review chain, the subagent delegation cheatsheet, and the model-selection guidance.
3+
description: Resume fully autonomous work on the `staging` branch and drive the per-task TDD loop. Trigger when the user says 続けて, "resume", "pick up where we left off", "/continue", "次", "go", or starts a fresh session expecting prior context. `/continue` may also be re-invoked automatically (cron / wake hook); treat every invocation as the same go signal. The full step-by-step loop spec (Step 0 → 7) lives in CLAUDE.md § Autonomous Workflow + § The only stop (single condition: user explicit stop) and is loaded into every turn's system prompt; this skill is the invocation trigger and carries the resume procedure, the Phase-boundary review chain, the subagent delegation cheatsheet, and the model-selection guidance.
44
---
55

66
# continue
@@ -27,14 +27,17 @@ spec is not duplicated here — CLAUDE.md is the single source.
2727

2828
## Resume procedure (on every session pickup)
2929

30-
1. Read `.dev/handover.md` (SessionStart hook already prints it;
31-
re-read). Pay attention to any "Guardrail refresh" section —
32-
it points at recent principle.md / CLAUDE.md spirit edits the
33-
loop must honour.
34-
2. Read `CLAUDE.md` § Project spirit (top section, governs all
35-
other rules) and `.dev/principle.md` (Bad Smell catalogue +
36-
Structural imagination phase). These two are the meta layer
37-
the per-task loop is checked against.
30+
1. Run `project workflow catchup`. It drains the axioms and the
31+
live kanban cards. There is no handover file: `.dev/handover.md`
32+
was retired on 2026-09-11 (memory `20260910235746-74389f7f`), so
33+
any older text that points at it, or at its "First task on
34+
resume", is stale.
35+
2. Read `CLAUDE.md` § Project spirit (governs all other rules) and
36+
the smell sensors it indexes in hive memory (the `bad-smell`
37+
tag, the premises `20260911004145-29ffd52a`, structural
38+
imagination `20260911004146-720ff81e`). `.dev/principle.md` no
39+
longer exists. These are the meta layer the per-task loop is
40+
checked against.
3841
2a. Read `.dev/project_facts.md` (user-declared invariants —
3942
F-001 … F-007 at 2026-05-24) and `.dev/structure_plan.md`
4043
(anticipated directory tree Phase 5-20). When a task touches
@@ -43,16 +46,15 @@ spec is not duplicated here — CLAUDE.md is the single source.
4346
3. Read `.dev/ROADMAP.md` **§9.0** (the gap-area model — the
4447
phase-queue/§9.<N>-placeholder model is RETIRED per ADR-0142):
4548
the three gap areas' BUILT status + named gaps + draining
46-
`D-NNN` rows. Next-unit selection is `handover.md`'s "First
47-
task on resume" if concrete, else the `.dev/debt.yaml`
48-
`active:` list EASIEST-FIRST (CLAUDE.md § When the active
49-
work unit completes).
49+
`D-NNN` rows. Next-unit selection is a concrete live kanban
50+
card if catchup surfaced one, else the `.dev/debt.yaml`
51+
`active:` list EASIEST-FIRST (memory `20260910001609-5b3ea4d7`).
5052
4. (Dormant cadence per ADR-0025: skip the
5153
`docs/ja/learn_clojurewasm/` chapter check. `private/notes/`
52-
per-task notes continue.)
54+
per-task notes continue; they are gitignored and local-only.)
5355
5. `git log --oneline -10` — read the recent commit chain so
54-
the next task starts with the as-pushed reality, not the
55-
handover's narration of it.
56+
the next task starts with the as-pushed reality, not a
57+
narration of it.
5658
6. Confirm HEAD is green **without re-running the full gate** — the
5759
pushed HEAD was already gated when it landed. Check the
5860
`.dev/.gate_pass` / `.dev/.smoke_pass` fingerprint (or run a quick
@@ -92,15 +94,15 @@ self-selected unit without asking**:
9294
- **Subagent B**: built-in `security-review` on unpushed
9395
commits.
9496
- **Subagent C**: write any outstanding chapter(s) for the
95-
closed phase, pulling from `private/notes/` task-notes.
97+
closed phase, pulling from `private/notes/` task-notes (local-only; a fresh clone has none).
9698
3. Synthesise in main: 1 line per check + severity counts.
9799
No "shall I proceed?" question — proceed.
98100
4. (Bench sweep retired 2026-06-11 — the `bench/quick.sh` /
99101
`bench/quick_baseline.txt` auto-baseline was removed from the gate,
100102
so no dangling samples accumulate. Perf is measured on demand via
101103
`bench/compare_langs.sh` / `bench/run_bench.sh`.)
102-
5. Update `handover.md` to point at the next self-selected unit
103-
(debt.yaml easiest-first).
104+
5. Record the next self-selected unit (debt.yaml easiest-first) on
105+
the kanban board; there is no handover file to update.
104106
6. Proceed to that unit's Step 0. Auto-compaction handles context
105107
size transparently — no agent action needed.
106108

‎.dev/ROADMAP.md‎

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -347,6 +347,10 @@ modules/ comptime-gated optional (math, c-ffi, wasm)
347347
imports runtime/ + eval/ only
348348
```
349349

350+
The optional modules landed under `src/runtime/cljw/<area>/` rather than a
351+
top-level `modules/`: `wasm/` behind `-Dwasm` (ADR-0099) and `ffi/` behind
352+
`-Dffi` (ADR-0202, on by default for x86_64 / aarch64 Linux and macOS).
353+
350354
When a lower zone needs to call an upper zone: vtable pattern. The lower
351355
zone declares the `VTable` type, the upper zone injects function pointers
352356
at startup. `scripts/zone_check.sh --gate` blocks any violation in CI.
@@ -635,7 +639,7 @@ ClojureWasm/ (working dir on disk)
635639
│
636640
├── modules/ comptime-gated optional
637641
│ ├── math/ clojure.math
638-
│ ├── c_ffi/
642+
│ ├── c_ffi/ landed as src/runtime/cljw/ffi/ (cljw.ffi, ADR-0202)
639643
│ └── wasm/ cljw.wasm namespace
640644
│
641645
├── test/
@@ -1040,7 +1044,7 @@ audit trail, not as a forward-looking instruction.
10401044
| 15 | **Concurrency** — BUILT + race-hardened (gap area I; ADR-0142) | atom/ref+STM/agent/future/promise/delay/locking/volatile ship; gap = parity/load (R1) + D-442/D-105 (`:volatile-mutable` happens-before DONE 2026-06-16: ADR-0152) | 🔒 |
10411045
| 16 | **Wasm/edge-native** BUILT (gap area II) · ClojureScript→JS = future | component build/run/require ship (`cljw.wasm/*`); CLJS→JS genuinely unbuilt | |
10421046
| 17 | **VM perf: fusion → JIT** PARTIAL (gap area III) | superinstruction/fusion slice landed (D-386 / O-018/019/021/023); narrow ARM64 JIT = milestone M | |
1043-
| 18 | math + module/deps DONE · **C FFI** = future | `clojure.math` + deps.edn ship; C FFI (`dlopen`/libffi) genuinely unbuilt | |
1047+
| 18 | math + module/deps DONE · **C FFI** BUILT (register-only shape) | `clojure.math` + deps.edn ship; `cljw.ffi` dlopen + 6-int/8-double call shape, no libffi (ADR-0202); structs/varargs/callbacks unbuilt | |
10441048
| 19 | **Wasm/edge-native** cont. — WIT auto-binding (gap area II) | component require BUILT; gap = WIT marshalling (D-404); command/handle embedding shape settled by ADR-0124/D-350 | |
10451049
| 20 | **broad JIT** = future (distal; gated on gap-area-III fusion outcome) | narrow ARM64 JIT (milestone M) is the near-term scope; broad JIT decided after fusion lands | |
10461050

@@ -1065,7 +1069,7 @@ in ADRs / debt rows / overlays still resolve while R4/R5 rewrite them at source)
10651069
| Phase 15 (§9.17) | **Gap area I — Concurrency hardening** (BUILT + race-hardened) |
10661070
| Phase 16 (§9.18) | **Gap area II — Wasm/edge-native** (BUILT) · ClojureScript→JS = future bucket |
10671071
| Phase 17 (§9.19) | **Gap area III — VM perf: fusion → JIT** (PARTIAL) |
1068-
| Phase 18 (§9.20) | math + module/deps **DONE** · C FFI = future bucket |
1072+
| Phase 18 (§9.20) | math + module/deps **DONE** · C FFI **BUILT** (`cljw.ffi`, ADR-0202) |
10691073
| Phase 19 (§9.21) | **Gap area II — Wasm/edge-native** (WIT auto-binding; D-404) |
10701074
| Phase 20 (§9.22) | **future bucket** — broad JIT (distal; narrow ARM64 JIT = milestone M) |
10711075

@@ -1090,7 +1094,8 @@ in ADRs / debt rows / overlays still resolve while R4/R5 rewrite them at source)
10901094
(distal, D-005 / D-035).
10911095

10921096
**Genuinely-future bucket** (no impl; honest future): ClojureScript→JS compiler,
1093-
C FFI (`dlopen`/libffi), broad JIT (Phase 20).
1097+
broad JIT (Phase 20). C FFI left this bucket with `cljw.ffi` (ADR-0202); its
1098+
own future tail is structs by value, varargs and C-to-Clojure callbacks.
10941099

10951100
> **Milestone M** (F-010) = concurrency complete (gap area I drained to parity)
10961101
> + the cw-v0-level narrow ARM64 JIT. M is a **named milestone token**, not a
@@ -1560,13 +1565,17 @@ an independent cljw-bytecode→native path (NOT via zwasm; F-001); bytecode ABI
15601565
decoder-only-compatible (ADR-0033 D10 / ADR-0034 D6) so JIT go/no-go does not
15611566
perturb placement/build.
15621567
1563-
### 9.20 math + module/deps DONE (formerly "Phase 18") · C FFI = future
1568+
### 9.20 math + module/deps DONE (formerly "Phase 18") · C FFI BUILT
15641569
15651570
**Status: math + module/deps DONE.** `clojure.math` ships (`clojure/math.clj`,
15661571
e2e `phase14_math*`); the deps.edn resolver + the `modules/` zone rule already
1567-
exist (Phase 14). **C FFI = genuinely-future bucket**: no `dlopen`/`dlsym`/
1568-
`libffi`/`c_ffi`; `zig build -D<lib>` comptime-gated module builds are future
1569-
work, low priority.
1572+
exist (Phase 14). **C FFI BUILT** (ADR-0202): `cljw.ffi` (`open close sym
1573+
function call string bytes`) dlopens a library and calls any signature of at
1574+
most 6 integer-class and 8 double arguments through two function pointer
1575+
types, no libffi. Comptime-gated by `-Dffi` (default on for x86_64 / aarch64
1576+
Linux and macOS, absent on wasm). The surface is shared with clojurust's
1577+
`clojure.rust.ffi`. Future tail: structs by value, varargs, float32,
1578+
callbacks into Clojure.
15701579
15711580
### 9.21 Gap area II (cont.) — WIT auto-binding (formerly "Phase 19")
15721581

0 commit comments

Comments
 (0)