simon/jolt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Docs: Chez-only, drop the Janet-era references and obsolete migration notes

Browse source 
Bring the docs in line with the actual implementation now that Chez is the sole
substrate.

Deleted the migration/spike/handoff artifacts that only documented the Janet
era or the port effort: the port plan, phase-0 and foundational-runtime spike
writeups (+ the stray root-level copy), the self-hosting design notes, the
architecture-refactor plan, and spike/chez/RESULTS.md.

Rewrote the current reference docs against the Chez facts: building-and-deps and
tools-deps (no jpm/build step — bin/joltc off the checked-in seed, deps via
jolt.deps into ~/.jolt/gitlibs), libraries (SQLite is built-in jdbc.core over
libsqlite3, not a Janet driver), the conformance/spec test-flow docs (the Chez
corpus runner + certify, no .janet harnesses), and the transient / type-hint /
seed-overlay design notes (Chez representations: mutable transients, flat
copy-on-write vectors, HAMT maps, the seed/overlay twin). Fixed the README
collections line (vectors aren't 32-way tries) and added the ffi/transient gate
targets. rfc 0001's numerics open-question is resolved (the Scheme tower).

Renamed the built-in HTTP adapter to jolt.http.server only (dropped the
ring-janet.adapter alias — a Janet-era name).
This commit is contained in:
Yogthos 2026-06-22 09:05:35 -04:00
parent fe3fdf6b9c
commit 45876998ad
28 changed files with 253 additions and 2012 deletions
Download patch file Download diff file Expand all files Collapse all files

7
host/chez/http-server.ss
View file

@ -3,8 +3,8 @@
;; connection handled at a time on a background accept thread; synchronous Ring
;; handlers. Enough to serve a small web app.
;;
;; Exposed as jolt.http.server/run-server and (for the ring-app example) as
;; ring-janet.adapter/run-server + stop-server — both baked namespaces.
;; Exposed as jolt.http.server/run-server + stop-server — a baked namespace an
;; app requires for a Ring-style adapter (run a handler, stop the server).
(load-shared-object #f) ; resolve socket/bind/listen/accept/recv/send in the process
@ -227,6 +227,3 @@
(def-var! "jolt.http.server" "run-server" (lambda (handler . opt) (http-run-server handler (if (pair? opt) (car opt) (jolt-hash-map)))))
(def-var! "jolt.http.server" "stop-server" http-stop-server)
;; the ring-app example reaches the server through this adapter namespace.
(def-var! "ring-janet.adapter" "run-server" (lambda (handler . opt) (http-run-server handler (if (pair? opt) (car opt) (jolt-hash-map)))))
(def-var! "ring-janet.adapter" "stop-server" http-stop-server)

4
host/chez/seed/README.md
View file

@ -1,7 +1,7 @@
# Chez bootstrap seed
These two files are the **bootstrap compiler** for jolt-on-Chez — the seed that
makes the build self-hosting with no Janet in the loop:
These two files are the **bootstrap compiler** for jolt — the seed that makes
the build self-hosting:
- `prelude.ss` — the `clojure.core` prelude (all tiers + clojure.string/walk/
template/edn/set/pprint) as Scheme `def-var!` forms.