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

Commit c98d3a3

Browse files
committed
Status and README learn about cljwit.edn
Claude-Session: https://claude.ai/code/session_01XF5Hfq4Ca2N2XYEzWQQuHt
1 parent aa7c935 commit c98d3a3

2 files changed

Lines changed: 23 additions & 5 deletions

File tree

‎README.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,22 @@ an ordinary namespace and check it in
8181
;; => "src/acme/component.clj" — then: (acme.component/greet i "world")
8282
```
8383

84+
With more than one component, declare them once in `cljwit.edn` at the
85+
project root and let `cljwit.project` reconcile
86+
([`doc/design/0021`](doc/design/0021-cljwit-edn.md)):
87+
88+
```clojure
89+
;; cljwit.edn
90+
{:components {acme.resize {:wasm "components/resize.wasm"}}}
91+
```
92+
93+
```clojure
94+
(require '[cljwit.project :as project])
95+
(project/sync!) ; regenerate what changed
96+
(project/check) ; CI: throw if anything drifted — stale, edited,
97+
; missing, or orphaned
98+
```
99+
84100
## Why now
85101

86102
Three things landed that were not true a year ago:

‎doc/status.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,13 @@ _Short by design, and printed at every session start — so findings live in
1212
third-party component reopens it — and a resource nested in a container
1313
in an import's signature is refused at instantiate (`:nested-resource`)
1414
rather than marshalled.
15-
2. **S2 — developer experience skeleton** (`doc/roadmap.md`): `cljwit.edn`,
16-
an nREPL entry point, the shadow-cljs shape. `0020` opened it: the
17-
generator's option keys (`:ns`, `:interface`, `:rename`, `:dir`) are
18-
`cljwit.edn`'s keys, and the regenerate-and-diff drift check the
19-
generated files cannot do for themselves belongs there.
15+
2. **S2 — developer experience skeleton** (`doc/roadmap.md`). Its first
16+
unit is done: **`cljwit.edn` exists** (`0021`, `cljwit.project`) —
17+
components keyed by namespace, `sync!` plans-then-writes, `status`
18+
reports tiered drift (`:stale`/`:modified`/`:missing`/`:orphans`), and
19+
`check` is the CI verb. What remains of S2: the nREPL entry point and
20+
the file watcher, both of which should decide the fate of the
21+
provisional `-X` coordinate.
2022

2123
Done since the last update: `0016` `own<T>` handles, `0017` host imports
2224
(A–F), `0018` host-defined resources, `0012`'s `ex-data` contract shrunk to

0 commit comments

Comments
 (0)