Skip to content
This repository was archived by the owner on Aug 12, 2026. It is now read-only.

Commit 52c587e

Browse files
committed
doc/roadmap.md: S1 no longer promises the surface 0015 declined to build
The roadmap defined S1 as "`require` a component as a namespace and call it". 0015 decided not to build that: Clojure has no compile-time arity check for a var call, so the macro's headline benefit does not exist; clj-kondo does not execute macros, so bb lint goes red on the first use and a hook cannot help; and a top-level macro cannot skip itself, so the namespace becomes unloadable outside nix develop. All three measured. Leaving the stage's own definition pointing at a deferred deliverable makes the plan a claim that is not true. S1 now says what it delivers -- the primitive underneath that surface -- and names 0015 for why the surface waits and what shape it should take when it comes. S1 also had no stop condition, which the file's own framing asks for ("each stage can kill the project cheaply"). It has one now, and two of its three parts already hold. Claude-Session: https://claude.ai/code/session_01XF5Hfq4Ca2N2XYEzWQQuHt
1 parent da0df90 commit 52c587e

1 file changed

Lines changed: 16 additions & 2 deletions

File tree

‎doc/roadmap.md‎

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,13 +68,27 @@ stage's verdict is `doc/design/0010-*`.
6868

6969
### S1 — `cljwit.host`: call Wasm from JVM Clojure (weeks)
7070

71-
A plain Clojure library. No dialect, no compiler. `require` a component as a
72-
namespace and call it.
71+
A plain Clojure library. No dialect, no compiler.
7372

7473
This exists first for three reasons: it is **useful on its own**, it forces the
7574
**WIT ↔ Clojure type mapping** (the hardest shared problem) to be solved once,
7675
and it makes the project real to people before the compiler exists.
7776

77+
**Amended 2026-07-30.** This stage was stated as "`require` a component as a
78+
namespace and call it". That surface is **deferred** (`0015`): Clojure has no
79+
compile-time arity check for a var call, `clj-kondo` cannot see a macro's
80+
interned vars, and a top-level macro cannot skip itself, so it would take the
81+
gate red outside `nix develop`. When it is built it should be a generated
82+
`.clj`, not a macro. The primitive underneath it — a reflected handle whose
83+
exports are ordinary functions — is what S1 delivers instead (`0014`).
84+
85+
**Stop condition.** A component this project did not author, calling and being
86+
called, with every WIT type a shipped release can express. Two of the three
87+
hold: `dev/resources/zoo.wit` is the un-authored component, and `0012`'s rows
88+
are marshalled in both directions except `map`, `list<T,N>`, `stream`/`future`
89+
and `error-context`, none of which are in a shipped release. Host imports are
90+
the third (`0017`).
91+
7892
### S2 — Developer experience skeleton (weeks)
7993

8094
`cljwit.edn`, an nREPL entry point, a file watcher. The compiler can still be

0 commit comments

Comments
 (0)