smalltalk: super send + top-level temps + 9 super tests

Showcase: blocks with non-local return on captured method-return
continuation. ANSI-ish Smalltalk-80 subset, SUnit + Pharo Kernel-Tests
slice, 7 phases. Worktree: /root/rose-ash-loops/smalltalk on
branch loops/smalltalk.

lib/erlang/bench_ring.sh

@@ -1,86 +0,0 @@
-#!/usr/bin/env bash
-# Erlang-on-SX ring benchmark.
-#
-# Spawns N processes in a ring, passes a token N hops (one full round),
-# and reports wall-clock time + throughput. Aspirational target from
-# the plan is 1M processes; current sync-scheduler architecture caps out
-# orders of magnitude lower — this script measures honestly across a
-# range of N so the result/scaling is recorded.
-#
-# Usage:
-#   bash lib/erlang/bench_ring.sh                # default ladder
-#   bash lib/erlang/bench_ring.sh 100 1000 5000  # custom Ns
-
-set -uo pipefail
-cd "$(git rev-parse --show-toplevel)"
-
-SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
-if [ ! -x "$SX_SERVER" ]; then
-  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
-fi
-if [ ! -x "$SX_SERVER" ]; then
-  echo "ERROR: sx_server.exe not found." >&2
-  exit 1
-fi
-
-if [ "$#" -gt 0 ]; then
-  NS=("$@")
-else
-  NS=(10 100 500 1000)
-fi
-
-TMPFILE=$(mktemp)
-trap "rm -f $TMPFILE" EXIT
-
-# One-line Erlang program. Replaces __N__ with the size for each run.
-PROGRAM='Me = self(), N = __N__, Spawner = fun () -> receive {setup, Next} -> Loop = fun () -> receive {token, 0, Parent} -> Parent ! done; {token, K, Parent} -> Next ! {token, K-1, Parent}, Loop() end end, Loop() end end, BuildRing = fun (K, Acc) -> if K =:= 0 -> Acc; true -> BuildRing(K-1, [spawn(Spawner) | Acc]) end end, Pids = BuildRing(N, []), Wire = fun (Ps) -> case Ps of [P, Q | _] -> P ! {setup, Q}, Wire(tl(Ps)); [Last] -> Last ! {setup, hd(Pids)} end end, Wire(Pids), hd(Pids) ! {token, N, Me}, receive done -> done end'
-
-run_n() {
-  local n="$1"
-  local prog="${PROGRAM//__N__/$n}"
-  cat > "$TMPFILE" <<EPOCHS
-(epoch 1)
-(load "lib/erlang/tokenizer.sx")
-(load "lib/erlang/parser.sx")
-(load "lib/erlang/parser-core.sx")
-(load "lib/erlang/parser-expr.sx")
-(load "lib/erlang/parser-module.sx")
-(load "lib/erlang/transpile.sx")
-(load "lib/erlang/runtime.sx")
-(epoch 2)
-(eval "(erlang-eval-ast \"${prog//\"/\\\"}\")")
-EPOCHS
-
-  local start_s start_ns end_s end_ns elapsed_ms
-  start_s=$(date +%s)
-  start_ns=$(date +%N)
-  out=$(timeout 300 "$SX_SERVER" < "$TMPFILE" 2>&1)
-  end_s=$(date +%s)
-  end_ns=$(date +%N)
-
-  local ok="false"
-  if echo "$out" | grep -q ':name "done"'; then ok="true"; fi
-
-  # ms = (end_s - start_s)*1000 + (end_ns - start_ns)/1e6
-  elapsed_ms=$(awk -v s1="$start_s" -v n1="$start_ns" -v s2="$end_s" -v n2="$end_ns" \
-    'BEGIN { printf "%d", (s2 - s1) * 1000 + (n2 - n1) / 1000000 }')
-
-  if [ "$ok" = "true" ]; then
-    local hops_per_s
-    hops_per_s=$(awk -v n="$n" -v ms="$elapsed_ms" \
-      'BEGIN { if (ms == 0) ms = 1; printf "%.0f", n * 1000 / ms }')
-    printf "  N=%-8s  hops=%-8s  %sms  (%s hops/s)\n" "$n" "$n" "$elapsed_ms" "$hops_per_s"
-  else
-    printf "  N=%-8s  FAILED  %sms\n" "$n" "$elapsed_ms"
-  fi
-}
-
-echo "Ring benchmark — sx_server.exe (synchronous scheduler)"
-echo
-for n in "${NS[@]}"; do
-  run_n "$n"
-done
-echo
-echo "Note: 1M-process target from the plan is aspirational; the synchronous"
-echo "scheduler with shift-based suspension and dict-based env copies is not"
-echo "engineered for that scale. Numbers above are honest baselines."

lib/erlang/bench_ring_results.md

@@ -1,35 +0,0 @@
-# Ring Benchmark Results
-
-Generated by `lib/erlang/bench_ring.sh` against `sx_server.exe` on the
-synchronous Erlang-on-SX scheduler.
-
-| N (processes) | Hops | Wall-clock | Throughput |
-|---|---|---|---|
-| 10 | 10 | 907ms | 11 hops/s |
-| 50 | 50 | 2107ms | 24 hops/s |
-| 100 | 100 | 3827ms | 26 hops/s |
-| 500 | 500 | 17004ms | 29 hops/s |
-| 1000 | 1000 | 29832ms | 34 hops/s |
-
-(Each `Nm` row spawns N processes connected in a ring and passes a
-single token N hops total — i.e. the token completes one full lap.)
-
-## Status of the 1M-process target
-
-Phase 3's stretch goal in `plans/erlang-on-sx.md` is a million-process
-ring benchmark. **That target is not met** in the current synchronous
-scheduler; extrapolating from the table above, 1M hops would take
-~30 000 s. Correctness is fine — the program runs at every measured
-size — but throughput is bound by per-hop overhead.
-
-Per-hop cost is dominated by:
-- `er-env-copy` per fun clause attempt (whole-dict copy each time)
-- `call/cc` capture + `raise`/`guard` unwind on every `receive`
-- `er-q-delete-at!` rebuilds the mailbox backing list on every match
-- `dict-set!`/`dict-has?` lookups in the global processes table
-
-To reach 1M-process throughput in this architecture would need at
-least: persistent (path-copying) envs, an inline scheduler that
-doesn't call/cc on the common path (msg-already-in-mailbox), and a
-linked-list mailbox. None of those are in scope for the Phase 3
-checkbox — captured here as the floor we're starting from.

lib/erlang/conformance.sh

@@ -1,153 +0,0 @@
-#!/usr/bin/env bash
-# Erlang-on-SX conformance runner.
-#
-# Loads every erlang test suite via the epoch protocol, collects
-# pass/fail counts, and writes lib/erlang/scoreboard.json + .md.
-#
-# Usage:
-#   bash lib/erlang/conformance.sh           # run all suites
-#   bash lib/erlang/conformance.sh -v        # verbose per-suite
-
-set -uo pipefail
-cd "$(git rev-parse --show-toplevel)"
-
-SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
-if [ ! -x "$SX_SERVER" ]; then
-  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
-fi
-if [ ! -x "$SX_SERVER" ]; then
-  echo "ERROR: sx_server.exe not found." >&2
-  exit 1
-fi
-
-VERBOSE="${1:-}"
-TMPFILE=$(mktemp)
-OUTFILE=$(mktemp)
-trap "rm -f $TMPFILE $OUTFILE" EXIT
-
-# Each suite: name | counter pass | counter total
-SUITES=(
-  "tokenize|er-test-pass|er-test-count"
-  "parse|er-parse-test-pass|er-parse-test-count"
-  "eval|er-eval-test-pass|er-eval-test-count"
-  "runtime|er-rt-test-pass|er-rt-test-count"
-  "ring|er-ring-test-pass|er-ring-test-count"
-  "ping-pong|er-pp-test-pass|er-pp-test-count"
-  "bank|er-bank-test-pass|er-bank-test-count"
-  "echo|er-echo-test-pass|er-echo-test-count"
-  "fib|er-fib-test-pass|er-fib-test-count"
-)
-
-cat > "$TMPFILE" << 'EPOCHS'
-(epoch 1)
-(load "lib/erlang/tokenizer.sx")
-(load "lib/erlang/parser.sx")
-(load "lib/erlang/parser-core.sx")
-(load "lib/erlang/parser-expr.sx")
-(load "lib/erlang/parser-module.sx")
-(load "lib/erlang/transpile.sx")
-(load "lib/erlang/runtime.sx")
-(load "lib/erlang/tests/tokenize.sx")
-(load "lib/erlang/tests/parse.sx")
-(load "lib/erlang/tests/eval.sx")
-(load "lib/erlang/tests/runtime.sx")
-(load "lib/erlang/tests/programs/ring.sx")
-(load "lib/erlang/tests/programs/ping_pong.sx")
-(load "lib/erlang/tests/programs/bank.sx")
-(load "lib/erlang/tests/programs/echo.sx")
-(load "lib/erlang/tests/programs/fib_server.sx")
-(epoch 100)
-(eval "(list er-test-pass er-test-count)")
-(epoch 101)
-(eval "(list er-parse-test-pass er-parse-test-count)")
-(epoch 102)
-(eval "(list er-eval-test-pass er-eval-test-count)")
-(epoch 103)
-(eval "(list er-rt-test-pass er-rt-test-count)")
-(epoch 104)
-(eval "(list er-ring-test-pass er-ring-test-count)")
-(epoch 105)
-(eval "(list er-pp-test-pass er-pp-test-count)")
-(epoch 106)
-(eval "(list er-bank-test-pass er-bank-test-count)")
-(epoch 107)
-(eval "(list er-echo-test-pass er-echo-test-count)")
-(epoch 108)
-(eval "(list er-fib-test-pass er-fib-test-count)")
-EPOCHS
-
-timeout 120 "$SX_SERVER" < "$TMPFILE" > "$OUTFILE" 2>&1
-
-# Parse "(N M)" from the line after each "(ok-len <epoch> ...)" marker.
-parse_pair() {
-  local epoch="$1"
-  local line
-  line=$(grep -A1 "^(ok-len $epoch " "$OUTFILE" | tail -1)
-  echo "$line" | sed -E 's/[()]//g'
-}
-
-TOTAL_PASS=0
-TOTAL_COUNT=0
-JSON_SUITES=""
-MD_ROWS=""
-
-idx=0
-for entry in "${SUITES[@]}"; do
-  name="${entry%%|*}"
-  epoch=$((100 + idx))
-  pair=$(parse_pair "$epoch")
-  pass=$(echo "$pair" | awk '{print $1}')
-  count=$(echo "$pair" | awk '{print $2}')
-  if [ -z "$pass" ] || [ -z "$count" ]; then
-    pass=0
-    count=0
-  fi
-  TOTAL_PASS=$((TOTAL_PASS + pass))
-  TOTAL_COUNT=$((TOTAL_COUNT + count))
-  status="ok"
-  marker="✅"
-  if [ "$pass" != "$count" ]; then
-    status="fail"
-    marker="❌"
-  fi
-  if [ "$VERBOSE" = "-v" ]; then
-    printf "  %-12s %s/%s\n" "$name" "$pass" "$count"
-  fi
-  if [ -n "$JSON_SUITES" ]; then JSON_SUITES+=","; fi
-  JSON_SUITES+=$'\n    '
-  JSON_SUITES+="{\"name\":\"$name\",\"pass\":$pass,\"total\":$count,\"status\":\"$status\"}"
-  MD_ROWS+="| $marker | $name | $pass | $count |"$'\n'
-  idx=$((idx + 1))
-done
-
-printf '\nErlang-on-SX conformance: %d / %d\n' "$TOTAL_PASS" "$TOTAL_COUNT"
-
-# scoreboard.json
-cat > lib/erlang/scoreboard.json <<JSON
-{
-  "language": "erlang",
-  "total_pass": $TOTAL_PASS,
-  "total": $TOTAL_COUNT,
-  "suites": [$JSON_SUITES
-  ]
-}
-JSON
-
-# scoreboard.md
-cat > lib/erlang/scoreboard.md <<MD
-# Erlang-on-SX Scoreboard
-
-**Total: ${TOTAL_PASS} / ${TOTAL_COUNT} tests passing**
-
-|  | Suite | Pass | Total |
-|---|---|---|---|
-$MD_ROWS
-
-Generated by \`lib/erlang/conformance.sh\`.
-MD
-
-if [ "$TOTAL_PASS" -eq "$TOTAL_COUNT" ]; then
-  exit 0
-else
-  exit 1
-fi

lib/erlang/runtime.sx

@@ -1,744 +0,0 @@
-;; Erlang runtime — scheduler, process records, mailbox queue.
-;; Phase 3 foundation. spawn/send/receive build on these primitives.
-;;
-;; Scheduler is a single global dict in `er-scheduler` holding:
-;;   :next-pid    INT    — counter for fresh pid allocation
-;;   :processes   DICT   — pid-key (string) -> process record
-;;   :runnable    QUEUE  — FIFO of pids ready to run
-;;   :current     PID    — pid currently executing, or nil
-;;
-;; A pid value is tagged: {:tag "pid" :id INT}. Pids compare by id.
-;;
-;; Process record fields:
-;;   :pid             — this process's pid
-;;   :mailbox         — queue of received messages (arrival order)
-;;   :state           — "runnable" | "running" | "waiting" | "exiting" | "dead"
-;;   :continuation    — saved k (for receive suspension); nil otherwise
-;;   :receive-pats    — patterns the process is blocked on; nil otherwise
-;;   :trap-exit       — bool
-;;   :links           — list of pids
-;;   :monitors        — list of {:ref :pid}
-;;   :env             — Erlang env at the last yield
-;;   :exit-reason     — nil until the process exits
-;;
-;; Queue — amortised-O(1) FIFO with head-pointer + slab-compact:
-;;   {:items (list...) :head-idx INT}
-
-;; ── queue ────────────────────────────────────────────────────────
-(define er-q-new (fn () {:head-idx 0 :items (list)}))
-
-(define er-q-push! (fn (q x) (append! (get q :items) x)))
-
-(define
-  er-q-pop!
-  (fn
-    (q)
-    (let
-      ((h (get q :head-idx)) (items (get q :items)))
-      (if
-        (>= h (len items))
-        nil
-        (let
-          ((x (nth items h)))
-          (dict-set! q :head-idx (+ h 1))
-          (er-q-compact! q)
-          x)))))
-
-(define
-  er-q-peek
-  (fn
-    (q)
-    (let
-      ((h (get q :head-idx)) (items (get q :items)))
-      (if (>= h (len items)) nil (nth items h)))))
-
-(define
-  er-q-len
-  (fn (q) (- (len (get q :items)) (get q :head-idx))))
-
-(define er-q-empty? (fn (q) (= (er-q-len q) 0)))
-
-;; Compact the backing list when the head pointer gets large so the
-;; queue doesn't grow without bound. Threshold chosen to amortise the
-;; O(n) copy — pops are still amortised O(1).
-(define
-  er-q-compact!
-  (fn
-    (q)
-    (let
-      ((h (get q :head-idx)) (items (get q :items)))
-      (when
-        (> h 128)
-        (let
-          ((new (list)))
-          (for-each
-            (fn (i) (append! new (nth items i)))
-            (range h (len items)))
-          (dict-set! q :items new)
-          (dict-set! q :head-idx 0))))))
-
-(define
-  er-q-to-list
-  (fn
-    (q)
-    (let
-      ((h (get q :head-idx)) (items (get q :items)) (out (list)))
-      (for-each
-        (fn (i) (append! out (nth items i)))
-        (range h (len items)))
-      out)))
-
-;; Read the i'th entry (relative to head) without popping.
-(define
-  er-q-nth
-  (fn (q i) (nth (get q :items) (+ (get q :head-idx) i))))
-
-;; Remove entry at logical index i, shift tail in.
-(define
-  er-q-delete-at!
-  (fn
-    (q i)
-    (let
-      ((h (get q :head-idx)) (items (get q :items)) (new (list)))
-      (for-each
-        (fn
-          (j)
-          (when (not (= j (+ h i))) (append! new (nth items j))))
-        (range h (len items)))
-      (dict-set! q :items new)
-      (dict-set! q :head-idx 0))))
-
-;; ── pids ─────────────────────────────────────────────────────────
-(define er-mk-pid (fn (id) {:id id :tag "pid"}))
-(define er-pid? (fn (v) (er-is-tagged? v "pid")))
-(define er-pid-id (fn (pid) (get pid :id)))
-(define er-pid-key (fn (pid) (str "p" (er-pid-id pid))))
-(define
-  er-pid-equal?
-  (fn (a b) (and (er-pid? a) (er-pid? b) (= (er-pid-id a) (er-pid-id b)))))
-
-;; ── refs ─────────────────────────────────────────────────────────
-(define er-mk-ref (fn (id) {:id id :tag "ref"}))
-(define er-ref? (fn (v) (er-is-tagged? v "ref")))
-(define
-  er-ref-equal?
-  (fn (a b) (and (er-ref? a) (er-ref? b) (= (get a :id) (get b :id)))))
-
-(define
-  er-ref-new!
-  (fn
-    ()
-    (let
-      ((s (er-sched)))
-      (let
-        ((n (get s :next-ref)))
-        (dict-set! s :next-ref (+ n 1))
-        (er-mk-ref n)))))
-
-;; ── scheduler state ──────────────────────────────────────────────
-(define er-scheduler (list nil))
-
-(define
-  er-sched-init!
-  (fn
-    ()
-    (set-nth!
-      er-scheduler
-      0
-      {:next-pid 0
-        :next-ref 0
-        :current nil
-        :processes {}
-        :runnable (er-q-new)})))
-
-(define er-sched (fn () (nth er-scheduler 0)))
-
-(define
-  er-pid-new!
-  (fn
-    ()
-    (let
-      ((s (er-sched)))
-      (let
-        ((n (get s :next-pid)))
-        (dict-set! s :next-pid (+ n 1))
-        (er-mk-pid n)))))
-
-(define
-  er-sched-runnable
-  (fn () (get (er-sched) :runnable)))
-
-(define
-  er-sched-processes
-  (fn () (get (er-sched) :processes)))
-
-(define
-  er-sched-enqueue!
-  (fn (pid) (er-q-push! (er-sched-runnable) pid)))
-
-(define
-  er-sched-next-runnable!
-  (fn () (er-q-pop! (er-sched-runnable))))
-
-(define
-  er-sched-runnable-count
-  (fn () (er-q-len (er-sched-runnable))))
-
-(define
-  er-sched-set-current!
-  (fn (pid) (dict-set! (er-sched) :current pid)))
-
-(define er-sched-current-pid (fn () (get (er-sched) :current)))
-
-(define
-  er-sched-process-count
-  (fn () (len (keys (er-sched-processes)))))
-
-;; ── process records ──────────────────────────────────────────────
-(define
-  er-proc-new!
-  (fn
-    (env)
-    (let
-      ((pid (er-pid-new!)))
-      (let
-        ((proc
-          {:pid pid
-            :env env
-            :links (list)
-            :mailbox (er-q-new)
-            :state "runnable"
-            :monitors (list)
-            :monitored-by (list)
-            :continuation nil
-            :receive-pats nil
-            :trap-exit false
-            :has-timeout false
-            :timed-out false
-            :exit-reason nil}))
-        (dict-set! (er-sched-processes) (er-pid-key pid) proc)
-        (er-sched-enqueue! pid)
-        proc))))
-
-(define
-  er-proc-get
-  (fn (pid) (get (er-sched-processes) (er-pid-key pid))))
-
-(define
-  er-proc-exists?
-  (fn (pid) (dict-has? (er-sched-processes) (er-pid-key pid))))
-
-(define
-  er-proc-field
-  (fn (pid field) (get (er-proc-get pid) field)))
-
-(define
-  er-proc-set!
-  (fn
-    (pid field val)
-    (let
-      ((p (er-proc-get pid)))
-      (if
-        (= p nil)
-        (error (str "Erlang: no such process " (er-pid-key pid)))
-        (dict-set! p field val)))))
-
-(define
-  er-proc-mailbox-push!
-  (fn (pid msg) (er-q-push! (er-proc-field pid :mailbox) msg)))
-
-(define
-  er-proc-mailbox-size
-  (fn (pid) (er-q-len (er-proc-field pid :mailbox))))
-
-;; Main process is always pid 0 (scheduler starts with next-pid 0 and
-;; erlang-eval-ast calls er-proc-new! first). Returns nil if no eval
-;; has run.
-(define
-  er-main-pid
-  (fn () (er-mk-pid 0)))
-
-(define
-  er-last-main-exit-reason
-  (fn
-    ()
-    (if
-      (er-proc-exists? (er-main-pid))
-      (er-proc-field (er-main-pid) :exit-reason)
-      nil)))
-
-;; ── process BIFs ────────────────────────────────────────────────
-(define
-  er-bif-is-pid
-  (fn (vs) (er-bool (er-pid? (er-bif-arg1 vs "is_pid")))))
-
-(define
-  er-bif-self
-  (fn
-    (vs)
-    (if
-      (not (= (len vs) 0))
-      (error "Erlang: self/0: arity")
-      (let
-        ((pid (er-sched-current-pid)))
-        (if
-          (= pid nil)
-          (error "Erlang: self/0: no current process")
-          pid)))))
-
-(define
-  er-bif-spawn
-  (fn
-    (vs)
-    (cond
-      (= (len vs) 1) (er-spawn-fun (nth vs 0))
-      (= (len vs) 3) (error
-        "Erlang: spawn/3: module-based spawn deferred to Phase 5 (modules)")
-      :else (error "Erlang: spawn: wrong arity"))))
-
-(define
-  er-spawn-fun
-  (fn
-    (fv)
-    (if
-      (not (er-fun? fv))
-      (error "Erlang: spawn/1: not a fun")
-      (let
-        ((proc (er-proc-new! (er-env-new))))
-        (dict-set! proc :initial-fun fv)
-        (get proc :pid)))))
-
-(define
-  er-bif-exit
-  (fn
-    (vs)
-    (cond
-      (= (len vs) 1) (raise (er-mk-exit-marker (nth vs 0)))
-      (= (len vs) 2)
-      (error
-        "Erlang: exit/2 (signal another process) deferred to next Phase 4 step (signal propagation)")
-      :else (error "Erlang: exit: wrong arity"))))
-
-;; ── links / monitors / refs ─────────────────────────────────────
-(define
-  er-bif-is-reference
-  (fn (vs) (er-bool (er-ref? (er-bif-arg1 vs "is_reference")))))
-
-(define
-  er-bif-process-flag
-  (fn
-    (vs)
-    (if
-      (not (= (len vs) 2))
-      (error "Erlang: process_flag/2: arity")
-      (let
-        ((flag (nth vs 0))
-          (val (nth vs 1))
-          (me (er-sched-current-pid)))
-        (cond
-          (and (er-atom? flag) (= (get flag :name) "trap_exit"))
-          (let
-            ((old (er-proc-field me :trap-exit)))
-            (er-proc-set! me :trap-exit (er-truthy? val))
-            (er-bool old))
-          :else (error
-            (str
-              "Erlang: process_flag: unsupported flag '"
-              (er-format-value flag)
-              "'")))))))
-
-(define
-  er-bif-make-ref
-  (fn
-    (vs)
-    (if
-      (not (= (len vs) 0))
-      (error "Erlang: make_ref/0: arity")
-      (er-ref-new!))))
-
-;; Add `target` to `pid`'s :links list if not already there.
-(define
-  er-link-add-one!
-  (fn
-    (pid target)
-    (let
-      ((links (er-proc-field pid :links)))
-      (when
-        (not (er-link-has? links target))
-        (append! links target)))))
-
-(define
-  er-link-has?
-  (fn
-    (links target)
-    (cond
-      (= (len links) 0) false
-      (er-pid-equal? (nth links 0) target) true
-      :else (er-link-has? (er-slice-list links 1) target))))
-
-(define
-  er-link-remove-one!
-  (fn
-    (pid target)
-    (let
-      ((old (er-proc-field pid :links)) (out (list)))
-      (for-each
-        (fn
-          (i)
-          (let
-            ((p (nth old i)))
-            (when (not (er-pid-equal? p target)) (append! out p))))
-        (range 0 (len old)))
-      (er-proc-set! pid :links out))))
-
-(define
-  er-bif-link
-  (fn
-    (vs)
-    (let
-      ((target (er-bif-arg1 vs "link")) (me (er-sched-current-pid)))
-      (cond
-        (not (er-pid? target)) (error "Erlang: link: not a pid")
-        (er-pid-equal? target me) (er-mk-atom "true")
-        (not (er-proc-exists? target))
-        (raise (er-mk-exit-marker (er-mk-atom "noproc")))
-        :else (do
-          (er-link-add-one! me target)
-          (er-link-add-one! target me)
-          (er-mk-atom "true"))))))
-
-(define
-  er-bif-unlink
-  (fn
-    (vs)
-    (let
-      ((target (er-bif-arg1 vs "unlink")) (me (er-sched-current-pid)))
-      (cond
-        (not (er-pid? target)) (error "Erlang: unlink: not a pid")
-        :else (do
-          (er-link-remove-one! me target)
-          (when
-            (er-proc-exists? target)
-            (er-link-remove-one! target me))
-          (er-mk-atom "true"))))))
-
-(define
-  er-bif-monitor
-  (fn
-    (vs)
-    (if
-      (not (= (len vs) 2))
-      (error "Erlang: monitor/2: arity")
-      (let
-        ((kind (nth vs 0))
-          (target (nth vs 1))
-          (me (er-sched-current-pid)))
-        (cond
-          (not (and (er-atom? kind) (= (get kind :name) "process")))
-          (error "Erlang: monitor: only 'process' supported")
-          (not (er-pid? target)) (error "Erlang: monitor: not a pid")
-          :else (let
-            ((ref (er-ref-new!)))
-            (append!
-              (er-proc-field me :monitors)
-              {:ref ref :pid target})
-            (when
-              (er-proc-exists? target)
-              (append!
-                (er-proc-field target :monitored-by)
-                {:from me :ref ref}))
-            ref))))))
-
-(define
-  er-bif-demonitor
-  (fn
-    (vs)
-    (let
-      ((ref (er-bif-arg1 vs "demonitor")) (me (er-sched-current-pid)))
-      (if
-        (not (er-ref? ref))
-        (error "Erlang: demonitor: not a reference")
-        (do
-          (er-demonitor-purge! me ref)
-          (er-mk-atom "true"))))))
-
-(define
-  er-demonitor-purge!
-  (fn
-    (me ref)
-    (let
-      ((old (er-proc-field me :monitors)) (out (list)) (target-ref (list nil)))
-      (for-each
-        (fn
-          (i)
-          (let
-            ((m (nth old i)))
-            (if
-              (er-ref-equal? (get m :ref) ref)
-              (set-nth! target-ref 0 (get m :pid))
-              (append! out m))))
-        (range 0 (len old)))
-      (er-proc-set! me :monitors out)
-      (when
-        (and
-          (not (= (nth target-ref 0) nil))
-          (er-proc-exists? (nth target-ref 0)))
-        (let
-          ((target (nth target-ref 0))
-            (oldby (er-proc-field (nth target-ref 0) :monitored-by))
-            (out2 (list)))
-          (for-each
-            (fn
-              (i)
-              (let
-                ((m (nth oldby i)))
-                (when
-                  (not (er-ref-equal? (get m :ref) ref))
-                  (append! out2 m))))
-            (range 0 (len oldby)))
-          (er-proc-set! target :monitored-by out2))))))
-
-;; ── scheduler loop ──────────────────────────────────────────────
-;; Each scheduler step wraps the process body in `guard`. `receive`
-;; with no match captures a `call/cc` continuation onto the proc
-;; record and then `raise`s `er-suspend-marker`; the guard catches
-;; the raise and the scheduler moves on. `exit/1` raises an exit
-;; marker the same way. Resumption from a saved continuation also
-;; runs under a fresh `guard` so a resumed receive that needs to
-;; suspend again has a handler to unwind to. `shift`/`reset` aren't
-;; usable here because SX's captured delimited continuations don't
-;; re-establish their own reset boundary when invoked — a second
-;; suspension during replay raises "shift without enclosing reset".
-(define er-suspend-marker {:tag "er-suspend-marker"})
-
-(define
-  er-suspended?
-  (fn
-    (v)
-    (and
-      (= (type-of v) "dict")
-      (= (get v :tag) "er-suspend-marker"))))
-
-(define
-  er-exited?
-  (fn
-    (v)
-    (and
-      (= (type-of v) "dict")
-      (= (get v :tag) "er-exit-marker"))))
-
-(define
-  er-mk-exit-marker
-  (fn (reason) {:tag "er-exit-marker" :reason reason}))
-
-(define
-  er-mk-throw-marker
-  (fn (reason) {:tag "er-throw-marker" :reason reason}))
-
-(define
-  er-mk-error-marker
-  (fn (reason) {:tag "er-error-marker" :reason reason}))
-
-(define
-  er-thrown?
-  (fn
-    (v)
-    (and
-      (= (type-of v) "dict")
-      (= (get v :tag) "er-throw-marker"))))
-
-(define
-  er-errored?
-  (fn
-    (v)
-    (and
-      (= (type-of v) "dict")
-      (= (get v :tag) "er-error-marker"))))
-
-(define
-  er-sched-run-all!
-  (fn
-    ()
-    (let
-      ((pid (er-sched-next-runnable!)))
-      (cond
-        (not (= pid nil))
-        (do (er-sched-step! pid) (er-sched-run-all!))
-        ;; Queue empty — fire one pending receive-with-timeout and go again.
-        (er-sched-fire-one-timeout!) (er-sched-run-all!)
-        :else nil))))
-
-;; Wake one waiting process whose receive had an `after Ms` clause.
-;; Returns true if one fired. In our synchronous model "time passes"
-;; once the runnable queue drains — timeouts only fire then.
-(define
-  er-sched-fire-one-timeout!
-  (fn
-    ()
-    (let
-      ((ks (keys (er-sched-processes))) (fired (list false)))
-      (for-each
-        (fn
-          (k)
-          (when
-            (not (nth fired 0))
-            (let
-              ((p (get (er-sched-processes) k)))
-              (when
-                (and
-                  (= (get p :state) "waiting")
-                  (get p :has-timeout))
-                (dict-set! p :timed-out true)
-                (dict-set! p :has-timeout false)
-                (dict-set! p :state "runnable")
-                (er-sched-enqueue! (get p :pid))
-                (set-nth! fired 0 true)))))
-        ks)
-      (nth fired 0))))
-
-(define
-  er-sched-step!
-  (fn
-    (pid)
-    (cond
-      (= (er-proc-field pid :state) "dead") nil
-      :else (er-sched-step-alive! pid))))
-
-(define
-  er-sched-step-alive!
-  (fn
-    (pid)
-    (er-sched-set-current! pid)
-    (er-proc-set! pid :state "running")
-    (let
-      ((prev-k (er-proc-field pid :continuation))
-        (result-ref (list nil)))
-      (guard
-        (c
-          ((er-suspended? c) (set-nth! result-ref 0 c))
-          ((er-exited? c) (set-nth! result-ref 0 c))
-          ((er-thrown? c)
-            (set-nth!
-              result-ref
-              0
-              (er-mk-exit-marker
-                (er-mk-tuple
-                  (list (er-mk-atom "nocatch") (get c :reason))))))
-          ((er-errored? c)
-            (set-nth! result-ref 0 (er-mk-exit-marker (get c :reason)))))
-        (set-nth!
-          result-ref
-          0
-          (if
-            (= prev-k nil)
-            (er-apply-fun (er-proc-field pid :initial-fun) (list))
-            (do (er-proc-set! pid :continuation nil) (prev-k nil)))))
-      (let
-        ((r (nth result-ref 0)))
-        (cond
-          (er-suspended? r) nil
-          (er-exited? r)
-          (do
-            (er-proc-set! pid :state "dead")
-            (er-proc-set! pid :exit-reason (get r :reason))
-            (er-proc-set! pid :exit-result nil)
-            (er-proc-set! pid :continuation nil)
-            (er-propagate-exit! pid (get r :reason)))
-          :else (do
-            (er-proc-set! pid :state "dead")
-            (er-proc-set! pid :exit-reason (er-mk-atom "normal"))
-            (er-proc-set! pid :exit-result r)
-            (er-proc-set! pid :continuation nil)
-            (er-propagate-exit! pid (er-mk-atom "normal"))))))
-    (er-sched-set-current! nil)))
-
-;; ── exit-signal propagation ─────────────────────────────────────
-;; Called when `pid` finishes (normally or via exit). Walks the
-;; process's `:monitored-by` and `:links` lists to deliver `{'DOWN'}`
-;; messages and exit signals respectively. Linked processes without
-;; `trap_exit` cascade-die with the same reason; those with
-;; `trap_exit` true receive an `{'EXIT', From, Reason}` message.
-(define
-  er-propagate-exit!
-  (fn
-    (pid reason)
-    (er-fire-monitors! pid reason)
-    (er-fire-links! pid reason)))
-
-(define
-  er-fire-monitors!
-  (fn
-    (pid reason)
-    (let
-      ((mons (er-proc-field pid :monitored-by)))
-      (for-each
-        (fn
-          (i)
-          (let
-            ((m (nth mons i)))
-            (let
-              ((from (get m :from)) (ref (get m :ref)))
-              (when
-                (and (er-proc-exists? from)
-                  (not (= (er-proc-field from :state) "dead")))
-                (let
-                  ((msg
-                    (er-mk-tuple
-                      (list
-                        (er-mk-atom "DOWN")
-                        ref
-                        (er-mk-atom "process")
-                        pid
-                        reason))))
-                  (er-proc-mailbox-push! from msg)
-                  (when
-                    (= (er-proc-field from :state) "waiting")
-                    (er-proc-set! from :state "runnable")
-                    (er-sched-enqueue! from)))))))
-        (range 0 (len mons))))))
-
-(define
-  er-fire-links!
-  (fn
-    (pid reason)
-    (let
-      ((links (er-proc-field pid :links))
-        (is-normal (er-is-atom-named? reason "normal")))
-      (for-each
-        (fn
-          (i)
-          (let
-            ((target (nth links i)))
-            (when
-              (and (er-proc-exists? target)
-                (not (= (er-proc-field target :state) "dead")))
-              (let
-                ((trap (er-proc-field target :trap-exit)))
-                (cond
-                  trap (er-deliver-exit-msg! target pid reason)
-                  is-normal nil
-                  :else (er-cascade-exit! target reason))))))
-        (range 0 (len links))))))
-
-(define
-  er-deliver-exit-msg!
-  (fn
-    (target from reason)
-    (let
-      ((msg
-        (er-mk-tuple (list (er-mk-atom "EXIT") from reason))))
-      (er-proc-mailbox-push! target msg)
-      (when
-        (= (er-proc-field target :state) "waiting")
-        (er-proc-set! target :state "runnable")
-        (er-sched-enqueue! target)))))
-
-(define
-  er-cascade-exit!
-  (fn
-    (target reason)
-    (er-proc-set! target :state "dead")
-    (er-proc-set! target :exit-reason reason)
-    (er-proc-set! target :exit-result nil)
-    (er-proc-set! target :continuation nil)
-    (er-propagate-exit! target reason)))

lib/erlang/scoreboard.json

@@ -1,16 +0,0 @@
-{
-  "language": "erlang",
-  "total_pass": 405,
-  "total": 405,
-  "suites": [
-    {"name":"tokenize","pass":62,"total":62,"status":"ok"},
-    {"name":"parse","pass":52,"total":52,"status":"ok"},
-    {"name":"eval","pass":221,"total":221,"status":"ok"},
-    {"name":"runtime","pass":39,"total":39,"status":"ok"},
-    {"name":"ring","pass":4,"total":4,"status":"ok"},
-    {"name":"ping-pong","pass":4,"total":4,"status":"ok"},
-    {"name":"bank","pass":8,"total":8,"status":"ok"},
-    {"name":"echo","pass":7,"total":7,"status":"ok"},
-    {"name":"fib","pass":8,"total":8,"status":"ok"}
-  ]
-}

lib/erlang/scoreboard.md

@@ -1,18 +0,0 @@
-# Erlang-on-SX Scoreboard
-
-**Total: 405 / 405 tests passing**
-
-|  | Suite | Pass | Total |
-|---|---|---|---|
-| ✅ | tokenize | 62 | 62 |
-| ✅ | parse | 52 | 52 |
-| ✅ | eval | 221 | 221 |
-| ✅ | runtime | 39 | 39 |
-| ✅ | ring | 4 | 4 |
-| ✅ | ping-pong | 4 | 4 |
-| ✅ | bank | 8 | 8 |
-| ✅ | echo | 7 | 7 |
-| ✅ | fib | 8 | 8 |
-
-
-Generated by `lib/erlang/conformance.sh`.

lib/erlang/tests/eval.sx

@@ -1,639 +0,0 @@
-;; Erlang evaluator tests — sequential expressions.
-
-(define er-eval-test-count 0)
-(define er-eval-test-pass 0)
-(define er-eval-test-fails (list))
-
-(define
-  eev-deep=
-  (fn
-    (a b)
-    (cond
-      (and (= (type-of a) "dict") (= (type-of b) "dict"))
-      (let
-        ((ka (sort (keys a))) (kb (sort (keys b))))
-        (and (= ka kb) (every? (fn (k) (eev-deep= (get a k) (get b k))) ka)))
-      (and (= (type-of a) "list") (= (type-of b) "list"))
-      (and
-        (= (len a) (len b))
-        (every? (fn (i) (eev-deep= (nth a i) (nth b i))) (range 0 (len a))))
-      :else (= a b))))
-
-(define
-  er-eval-test
-  (fn
-    (name actual expected)
-    (set! er-eval-test-count (+ er-eval-test-count 1))
-    (if
-      (eev-deep= actual expected)
-      (set! er-eval-test-pass (+ er-eval-test-pass 1))
-      (append! er-eval-test-fails {:actual actual :expected expected :name name}))))
-
-(define ev erlang-eval-ast)
-(define nm (fn (v) (get v :name)))
-
-;; ── literals ──────────────────────────────────────────────────────
-(er-eval-test "int" (ev "42") 42)
-(er-eval-test "zero" (ev "0") 0)
-(er-eval-test "float" (ev "3.14") 3.14)
-(er-eval-test "string" (ev "\"hi\"") "hi")
-(er-eval-test "atom" (nm (ev "ok")) "ok")
-(er-eval-test "atom true" (nm (ev "true")) "true")
-(er-eval-test "atom false" (nm (ev "false")) "false")
-
-;; ── arithmetic ────────────────────────────────────────────────────
-(er-eval-test "add" (ev "1 + 2") 3)
-(er-eval-test "sub" (ev "5 - 3") 2)
-(er-eval-test "mul" (ev "4 * 3") 12)
-(er-eval-test "div-real" (ev "10 / 4") 2.5)
-(er-eval-test "div-int" (ev "10 div 3") 3)
-(er-eval-test "rem" (ev "10 rem 3") 1)
-(er-eval-test "div-neg" (ev "-10 div 3") -3)
-(er-eval-test "precedence" (ev "1 + 2 * 3") 7)
-(er-eval-test "parens" (ev "(1 + 2) * 3") 9)
-(er-eval-test "unary-neg" (ev "-(1 + 2)") -3)
-(er-eval-test "unary-neg int" (ev "-7") -7)
-
-;; ── comparison ────────────────────────────────────────────────────
-(er-eval-test "lt true" (nm (ev "1 < 2")) "true")
-(er-eval-test "gt false" (nm (ev "1 > 2")) "false")
-(er-eval-test "le equal" (nm (ev "2 =< 2")) "true")
-(er-eval-test "ge equal" (nm (ev "2 >= 2")) "true")
-(er-eval-test "eq" (nm (ev "2 == 2")) "true")
-(er-eval-test "neq" (nm (ev "1 /= 2")) "true")
-(er-eval-test "exact-eq same" (nm (ev "1 =:= 1")) "true")
-(er-eval-test "exact-neq int" (nm (ev "1 =:= 2")) "false")
-(er-eval-test "=/= true" (nm (ev "1 =/= 2")) "true")
-(er-eval-test "atom-eq" (nm (ev "ok == ok")) "true")
-(er-eval-test "atom-neq" (nm (ev "ok == error")) "false")
-
-;; ── logical ───────────────────────────────────────────────────────
-(er-eval-test "and tt" (nm (ev "true and true")) "true")
-(er-eval-test "and tf" (nm (ev "true and false")) "false")
-(er-eval-test "or tf" (nm (ev "true or false")) "true")
-(er-eval-test
-  "andalso short"
-  (nm (ev "false andalso Neverref"))
-  "false")
-(er-eval-test
-  "orelse short"
-  (nm (ev "true orelse Neverref"))
-  "true")
-(er-eval-test "not true" (nm (ev "not true")) "false")
-(er-eval-test "not false" (nm (ev "not false")) "true")
-
-;; ── tuples & lists ────────────────────────────────────────────────
-(er-eval-test "tuple tag" (get (ev "{1, 2, 3}") :tag) "tuple")
-(er-eval-test "tuple len" (len (get (ev "{1, 2, 3}") :elements)) 3)
-(er-eval-test "tuple elem" (nth (get (ev "{10, 20}") :elements) 1) 20)
-(er-eval-test "empty tuple" (len (get (ev "{}") :elements)) 0)
-(er-eval-test "nested tuple"
-  (nm (nth (get (ev "{ok, error}") :elements) 0)) "ok")
-(er-eval-test "nil list" (get (ev "[]") :tag) "nil")
-(er-eval-test "list head" (get (ev "[1, 2, 3]") :head) 1)
-(er-eval-test
-  "list tail tail head"
-  (get (get (get (ev "[1, 2, 3]") :tail) :tail) :head)
-  3)
-
-;; ── list ops ──────────────────────────────────────────────────────
-(er-eval-test "++ head" (get (ev "[1, 2] ++ [3]") :head) 1)
-(er-eval-test "++ last"
-  (get (get (get (ev "[1, 2] ++ [3]") :tail) :tail) :head) 3)
-
-;; ── block ─────────────────────────────────────────────────────────
-(er-eval-test "block last wins" (ev "begin 1, 2, 3 end") 3)
-(er-eval-test "bare body" (ev "1, 2, 99") 99)
-
-;; ── match + var ───────────────────────────────────────────────────
-(er-eval-test "match bind-and-use" (ev "X = 5, X + 1") 6)
-(er-eval-test "match sequential" (ev "X = 1, Y = 2, X + Y") 3)
-(er-eval-test
-  "rebind equal ok"
-  (ev "X = 5, X = 5, X") 5)
-
-;; ── if ────────────────────────────────────────────────────────────
-(er-eval-test "if picks first" (ev "if true -> 1; true -> 2 end") 1)
-(er-eval-test
-  "if picks second"
-  (nm (ev "if 1 > 2 -> bad; true -> good end"))
-  "good")
-(er-eval-test
-  "if with guard"
-  (ev "X = 5, if X > 0 -> 1; true -> 0 end")
-  1)
-
-;; ── pattern matching ─────────────────────────────────────────────
-(er-eval-test "match atom literal" (nm (ev "ok = ok, done")) "done")
-(er-eval-test "match int literal" (ev "5 = 5, 42") 42)
-(er-eval-test "match tuple bind"
-  (ev "{ok, V} = {ok, 99}, V") 99)
-(er-eval-test "match tuple nested"
-  (ev "{A, {B, C}} = {1, {2, 3}}, A + B + C") 6)
-(er-eval-test "match cons head"
-  (ev "[H|T] = [1, 2, 3], H") 1)
-(er-eval-test "match cons tail head"
-  (ev "[_, H|_] = [1, 2, 3], H") 2)
-(er-eval-test "match nil"
-  (ev "[] = [], 7") 7)
-(er-eval-test "match wildcard always"
-  (ev "_ = 42, 7") 7)
-(er-eval-test "match var reuse equal"
-  (ev "X = 5, X = 5, X") 5)
-
-;; ── case ─────────────────────────────────────────────────────────
-(er-eval-test "case bind" (ev "case 5 of N -> N end") 5)
-(er-eval-test "case tuple"
-  (ev "case {ok, 42} of {ok, V} -> V end") 42)
-(er-eval-test "case cons"
-  (ev "case [1, 2, 3] of [H|_] -> H end") 1)
-(er-eval-test "case fallthrough"
-  (ev "case error of ok -> 1; error -> 2 end") 2)
-(er-eval-test "case wildcard"
-  (nm (ev "case x of ok -> ok; _ -> err end"))
-  "err")
-(er-eval-test "case guard"
-  (ev "case 5 of N when N > 0 -> pos; _ -> neg end")
-  (er-mk-atom "pos"))
-(er-eval-test "case guard fallthrough"
-  (ev "case -3 of N when N > 0 -> pos; _ -> neg end")
-  (er-mk-atom "neg"))
-(er-eval-test "case bound re-match"
-  (ev "X = 5, case 5 of X -> same; _ -> diff end")
-  (er-mk-atom "same"))
-(er-eval-test "case bound re-match fail"
-  (ev "X = 5, case 6 of X -> same; _ -> diff end")
-  (er-mk-atom "diff"))
-(er-eval-test "case nested tuple"
-  (ev "case {ok, {value, 42}} of {ok, {value, V}} -> V end")
-  42)
-(er-eval-test "case multi-clause"
-  (ev "case 2 of 1 -> one; 2 -> two; _ -> other end")
-  (er-mk-atom "two"))
-(er-eval-test "case leak binding"
-  (ev "case {ok, 7} of {ok, X} -> X end + 1")
-  8)
-
-;; ── guard BIFs (is_*) ────────────────────────────────────────────
-(er-eval-test "is_integer 42" (nm (ev "is_integer(42)")) "true")
-(er-eval-test "is_integer ok" (nm (ev "is_integer(ok)")) "false")
-(er-eval-test "is_atom ok" (nm (ev "is_atom(ok)")) "true")
-(er-eval-test "is_atom int" (nm (ev "is_atom(42)")) "false")
-(er-eval-test "is_list cons" (nm (ev "is_list([1,2])")) "true")
-(er-eval-test "is_list nil"  (nm (ev "is_list([])")) "true")
-(er-eval-test "is_list tuple"  (nm (ev "is_list({1,2})")) "false")
-(er-eval-test "is_tuple tuple" (nm (ev "is_tuple({ok,1})")) "true")
-(er-eval-test "is_tuple list"  (nm (ev "is_tuple([1])")) "false")
-(er-eval-test "is_number int" (nm (ev "is_number(42)")) "true")
-(er-eval-test "is_number atom" (nm (ev "is_number(foo)")) "false")
-(er-eval-test "is_boolean true" (nm (ev "is_boolean(true)")) "true")
-(er-eval-test "is_boolean false" (nm (ev "is_boolean(false)")) "true")
-(er-eval-test "is_boolean atom" (nm (ev "is_boolean(foo)")) "false")
-
-;; ── guard BIFs wired into case / if ─────────────────────────────
-(er-eval-test "guard is_integer pick"
-  (nm (ev "case 5 of N when is_integer(N) -> int; _ -> other end"))
-  "int")
-(er-eval-test "guard is_integer reject"
-  (nm (ev "case foo of N when is_integer(N) -> int; _ -> other end"))
-  "other")
-(er-eval-test "guard is_atom"
-  (nm (ev "case foo of X when is_atom(X) -> atom_yes; _ -> no end"))
-  "atom_yes")
-(er-eval-test "guard conjunction"
-  (nm (ev "case 5 of N when is_integer(N), N > 0 -> pos; _ -> np end"))
-  "pos")
-(er-eval-test "guard disjunction (if)"
-  (nm (ev "X = foo, if is_integer(X); is_atom(X) -> yes; true -> no end"))
-  "yes")
-(er-eval-test "guard arith"
-  (nm (ev "case 3 of N when N * 2 > 5 -> big; _ -> small end"))
-  "big")
-
-;; ── BIFs: list + tuple ──────────────────────────────────────────
-(er-eval-test "length empty" (ev "length([])") 0)
-(er-eval-test "length 3" (ev "length([a, b, c])") 3)
-(er-eval-test "length cons chain" (ev "length([1 | [2 | [3 | []]]])") 3)
-(er-eval-test "hd" (ev "hd([10, 20, 30])") 10)
-(er-eval-test "hd atom"
-  (nm (ev "hd([ok, err])")) "ok")
-(er-eval-test "tl head"
-  (get (ev "tl([1, 2, 3])") :head) 2)
-(er-eval-test "tl of single" (get (ev "tl([1])") :tag) "nil")
-(er-eval-test "element 1" (nm (ev "element(1, {ok, value})")) "ok")
-(er-eval-test "element 2" (ev "element(2, {ok, 42})") 42)
-(er-eval-test "element 3"
-  (nm (ev "element(3, {a, b, c, d})")) "c")
-(er-eval-test "tuple_size 2" (ev "tuple_size({a, b})") 2)
-(er-eval-test "tuple_size 0" (ev "tuple_size({})") 0)
-
-;; ── BIFs: atom / list conversions ───────────────────────────────
-(er-eval-test "atom_to_list" (ev "atom_to_list(hello)") "hello")
-(er-eval-test "list_to_atom roundtrip"
-  (nm (ev "list_to_atom(atom_to_list(foo))")) "foo")
-(er-eval-test "list_to_atom fresh"
-  (nm (ev "list_to_atom(\"bar\")")) "bar")
-
-;; ── lists module ────────────────────────────────────────────────
-(er-eval-test "lists:reverse empty"
-  (get (ev "lists:reverse([])") :tag) "nil")
-(er-eval-test "lists:reverse 3"
-  (ev "hd(lists:reverse([1, 2, 3]))") 3)
-(er-eval-test "lists:reverse full"
-  (ev "lists:foldl(fun (X, Acc) -> Acc + X end, 0, lists:reverse([1, 2, 3]))") 6)
-
-;; ── funs + lists:map / lists:foldl ──────────────────────────────
-(er-eval-test "fun call" (ev "F = fun (X) -> X + 1 end, F(10)") 11)
-(er-eval-test "fun two-arg"
-  (ev "F = fun (X, Y) -> X * Y end, F(3, 4)") 12)
-(er-eval-test "fun closure"
-  (ev "N = 100, F = fun (X) -> X + N end, F(5)") 105)
-(er-eval-test "fun clauses"
-  (ev "F = fun (0) -> zero; (N) -> N end, element(1, {F(0), F(7)})")
-  (er-mk-atom "zero"))
-(er-eval-test "fun multi-clause second"
-  (ev "F = fun (0) -> 0; (N) -> N * 2 end, F(5)") 10)
-(er-eval-test "lists:map empty"
-  (get (ev "lists:map(fun (X) -> X end, [])") :tag) "nil")
-(er-eval-test "lists:map double"
-  (ev "hd(lists:map(fun (X) -> X * 2 end, [1, 2, 3]))") 2)
-(er-eval-test "lists:map sum-length"
-  (ev "length(lists:map(fun (X) -> X end, [a, b, c, d]))") 4)
-(er-eval-test "lists:foldl sum"
-  (ev "lists:foldl(fun (X, Acc) -> X + Acc end, 0, [1, 2, 3, 4, 5])") 15)
-(er-eval-test "lists:foldl product"
-  (ev "lists:foldl(fun (X, Acc) -> X * Acc end, 1, [1, 2, 3, 4])") 24)
-(er-eval-test "lists:foldl as reverse"
-  (ev "hd(lists:foldl(fun (X, Acc) -> [X | Acc] end, [], [1, 2, 3]))") 3)
-
-;; ── io:format (via capture buffer) ──────────────────────────────
-(er-eval-test "io:format plain"
-  (do (er-io-flush!) (ev "io:format(\"hello~n\")") (er-io-buffer-content))
-  "hello\n")
-(er-eval-test "io:format args"
-  (do (er-io-flush!) (ev "io:format(\"x=~p y=~p~n\", [42, hello])") (er-io-buffer-content))
-  "x=42 y=hello\n")
-(er-eval-test "io:format returns ok"
-  (nm (do (er-io-flush!) (ev "io:format(\"~n\")"))) "ok")
-(er-eval-test "io:format tuple"
-  (do (er-io-flush!) (ev "io:format(\"~p\", [{ok, 1}])") (er-io-buffer-content))
-  "{ok,1}")
-(er-eval-test "io:format list"
-  (do (er-io-flush!) (ev "io:format(\"~p\", [[1,2,3]])") (er-io-buffer-content))
-  "[1,2,3]")
-(er-eval-test "io:format escape"
-  (do (er-io-flush!) (ev "io:format(\"50~~\")") (er-io-buffer-content))
-  "50~")
-
-;; ── processes: self/0, spawn/1, is_pid ──────────────────────────
-(er-eval-test "self tag"
-  (get (ev "self()") :tag) "pid")
-(er-eval-test "is_pid self"
-  (nm (ev "is_pid(self())")) "true")
-(er-eval-test "is_pid number"
-  (nm (ev "is_pid(42)")) "false")
-(er-eval-test "is_pid atom"
-  (nm (ev "is_pid(ok)")) "false")
-(er-eval-test "self equals self"
-  (nm (ev "Pid = self(), Pid =:= Pid")) "true")
-(er-eval-test "self =:= self expr"
-  (nm (ev "self() == self()")) "true")
-(er-eval-test "spawn returns pid"
-  (get (ev "spawn(fun () -> ok end)") :tag) "pid")
-(er-eval-test "is_pid spawn"
-  (nm (ev "is_pid(spawn(fun () -> ok end))")) "true")
-(er-eval-test "spawn new pid distinct"
-  (nm (ev "P1 = self(), P2 = spawn(fun () -> ok end), P1 =:= P2"))
-  "false")
-(er-eval-test "two spawns distinct"
-  (nm (ev "P1 = spawn(fun () -> ok end), P2 = spawn(fun () -> ok end), P1 =:= P2"))
-  "false")
-(er-eval-test "spawn then drain io"
-  (do
-    (er-io-flush!)
-    (ev "spawn(fun () -> io:format(\"child~n\") end), io:format(\"parent~n\")")
-    (er-io-buffer-content))
-  "parent\nchild\n")
-(er-eval-test "multiple spawn ordering"
-  (do
-    (er-io-flush!)
-    (ev "spawn(fun () -> io:format(\"a~n\") end), spawn(fun () -> io:format(\"b~n\") end), io:format(\"main~n\")")
-    (er-io-buffer-content))
-  "main\na\nb\n")
-(er-eval-test "child self is its own pid"
-  (do
-    (er-io-flush!)
-    (ev "P = spawn(fun () -> io:format(\"~p\", [is_pid(self())]) end), io:format(\"~p;\", [is_pid(P)])")
-    (er-io-buffer-content))
-  "true;true")
-
-;; ── ! (send) + receive ──────────────────────────────────────────
-(er-eval-test "self-send + receive"
-  (nm (ev "Me = self(), Me ! hello, receive Msg -> Msg end")) "hello")
-(er-eval-test "send returns msg"
-  (nm (ev "Me = self(), Msg = Me ! ok, Me ! x, receive _ -> Msg end")) "ok")
-(er-eval-test "receive int"
-  (ev "Me = self(), Me ! 42, receive N -> N + 1 end") 43)
-(er-eval-test "receive with pattern"
-  (ev "Me = self(), Me ! {ok, 7}, receive {ok, V} -> V * 2 end") 14)
-(er-eval-test "receive with guard"
-  (ev "Me = self(), Me ! 5, receive N when N > 0 -> positive end")
-  (er-mk-atom "positive"))
-(er-eval-test "receive skips non-match"
-  (nm (ev "Me = self(), Me ! wrong, Me ! right, receive right -> ok end"))
-  "ok")
-(er-eval-test "receive selective leaves others"
-  (nm (ev "Me = self(), Me ! a, Me ! b, receive b -> got_b end"))
-  "got_b")
-(er-eval-test "two receives consume both"
-  (ev "Me = self(), Me ! 1, Me ! 2, X = receive A -> A end, Y = receive B -> B end, X + Y") 3)
-
-;; ── spawn + send + receive (real process communication) ─────────
-(er-eval-test "spawn sends back"
-  (nm
-    (ev "Me = self(), spawn(fun () -> Me ! pong end), receive pong -> got_pong end"))
-  "got_pong")
-(er-eval-test "ping-pong"
-  (do
-    (er-io-flush!)
-    (ev "Me = self(), Child = spawn(fun () -> receive {ping, From} -> From ! pong end end), Child ! {ping, Me}, receive pong -> io:format(\"pong~n\") end")
-    (er-io-buffer-content))
-  "pong\n")
-(er-eval-test "echo server"
-  (ev "Me = self(), Echo = spawn(fun () -> receive {From, Msg} -> From ! Msg end end), Echo ! {Me, 99}, receive R -> R end") 99)
-
-;; ── receive with multiple clauses ────────────────────────────────
-(er-eval-test "receive multi-clause"
-  (nm (ev "Me = self(), Me ! foo, receive ok -> a; foo -> b; bar -> c end"))
-  "b")
-(er-eval-test "receive nested tuple"
-  (ev "Me = self(), Me ! {result, {ok, 42}}, receive {result, {ok, V}} -> V end") 42)
-
-;; ── receive ... after ... ───────────────────────────────────────
-(er-eval-test "after 0 empty mailbox"
-  (nm (ev "receive _ -> got after 0 -> timeout end"))
-  "timeout")
-(er-eval-test "after 0 match wins"
-  (nm (ev "Me = self(), Me ! ok, receive ok -> got after 0 -> timeout end"))
-  "got")
-(er-eval-test "after 0 non-match fires timeout"
-  (nm (ev "Me = self(), Me ! wrong, receive right -> got after 0 -> timeout end"))
-  "timeout")
-(er-eval-test "after 0 leaves non-match"
-  (ev "Me = self(), Me ! wrong, receive right -> got after 0 -> to end, receive X -> X end")
-  (er-mk-atom "wrong"))
-(er-eval-test "after Ms no sender — timeout fires"
-  (nm (ev "receive _ -> got after 100 -> timed_out end"))
-  "timed_out")
-(er-eval-test "after Ms with sender — match wins"
-  (nm (ev "Me = self(), spawn(fun () -> Me ! hi end), receive hi -> got after 100 -> to end"))
-  "got")
-(er-eval-test "after Ms computed"
-  (nm (ev "Ms = 50, receive _ -> got after Ms -> done end"))
-  "done")
-(er-eval-test "after 0 body side effect"
-  (do (er-io-flush!)
-    (ev "receive _ -> ok after 0 -> io:format(\"to~n\") end")
-    (er-io-buffer-content))
-  "to\n")
-(er-eval-test "after zero poll selective"
-  (ev "Me = self(), Me ! first, Me ! second, X = receive second -> got_second after 0 -> to end, Y = receive first -> got_first after 0 -> to end, {X, Y}")
-  (er-mk-tuple (list (er-mk-atom "got_second") (er-mk-atom "got_first"))))
-
-;; ── exit/1 + process termination ─────────────────────────────────
-(er-eval-test "exit normal returns nil" (ev "exit(normal)") nil)
-(er-eval-test "exit normal reason"
-  (do (ev "exit(normal)") (nm (er-last-main-exit-reason))) "normal")
-(er-eval-test "exit bye reason"
-  (do (ev "exit(bye)") (nm (er-last-main-exit-reason))) "bye")
-(er-eval-test "exit tuple reason"
-  (do (ev "exit({shutdown, crash})")
-    (get (er-last-main-exit-reason) :tag))
-  "tuple")
-(er-eval-test "normal completion reason"
-  (do (ev "42") (nm (er-last-main-exit-reason))) "normal")
-(er-eval-test "exit aborts subsequent"
-  (do (er-io-flush!) (ev "io:format(\"a~n\"), exit(bye), io:format(\"b~n\")") (er-io-buffer-content))
-  "a\n")
-(er-eval-test "child exit doesn't kill parent"
-  (do
-    (er-io-flush!)
-    (ev "spawn(fun () -> io:format(\"before~n\"), exit(quit), io:format(\"after~n\") end), io:format(\"main~n\")")
-    (er-io-buffer-content))
-  "main\nbefore\n")
-(er-eval-test "child exit reason recorded on child"
-  (do
-    (er-io-flush!)
-    (ev "P = spawn(fun () -> exit(child_bye) end), io:format(\"~p\", [is_pid(P)])")
-    (er-io-buffer-content))
-  "true")
-(er-eval-test "exit inside fn chain"
-  (do (ev "F = fun () -> exit(from_fn) end, F()")
-    (nm (er-last-main-exit-reason)))
-  "from_fn")
-
-;; ── refs / link / monitor ──────────────────────────────────────
-(er-eval-test "make_ref tag"
-  (get (ev "make_ref()") :tag) "ref")
-(er-eval-test "is_reference fresh"
-  (nm (ev "R = make_ref(), is_reference(R)")) "true")
-(er-eval-test "is_reference pid"
-  (nm (ev "is_reference(self())")) "false")
-(er-eval-test "is_reference number"
-  (nm (ev "is_reference(42)")) "false")
-(er-eval-test "make_ref distinct"
-  (nm (ev "R1 = make_ref(), R2 = make_ref(), R1 =:= R2")) "false")
-(er-eval-test "make_ref same id eq"
-  (nm (ev "R = make_ref(), R =:= R")) "true")
-
-(er-eval-test "link returns true"
-  (nm (ev "P = spawn(fun () -> ok end), link(P)")) "true")
-(er-eval-test "self link returns true"
-  (nm (ev "link(self())")) "true")
-(er-eval-test "unlink returns true"
-  (nm (ev "P = spawn(fun () -> ok end), link(P), unlink(P)")) "true")
-(er-eval-test "unlink without link"
-  (nm (ev "P = spawn(fun () -> ok end), unlink(P)")) "true")
-
-(er-eval-test "monitor returns ref"
-  (get (ev "P = spawn(fun () -> ok end), monitor(process, P)") :tag)
-  "ref")
-(er-eval-test "monitor refs distinct"
-  (nm (ev "P = spawn(fun () -> ok end), R1 = monitor(process, P), R2 = monitor(process, P), R1 =:= R2"))
-  "false")
-(er-eval-test "demonitor returns true"
-  (nm (ev "P = spawn(fun () -> ok end), R = monitor(process, P), demonitor(R)"))
-  "true")
-
-;; Bidirectional link recorded on both sides.
-(er-eval-test "link bidirectional"
-  (do
-    (ev "P = spawn(fun () -> receive forever -> ok end end), link(P)")
-    ;; After eval, check links on main + child via accessors.
-    (and
-      (= (len (er-proc-field (er-mk-pid 0) :links)) 1)
-      (= (len (er-proc-field (er-mk-pid 1) :links)) 1)))
-  true)
-
-;; unlink clears both sides.
-(er-eval-test "unlink clears both"
-  (do
-    (ev "P = spawn(fun () -> receive forever -> ok end end), link(P), unlink(P)")
-    (and
-      (= (len (er-proc-field (er-mk-pid 0) :links)) 0)
-      (= (len (er-proc-field (er-mk-pid 1) :links)) 0)))
-  true)
-
-;; monitor adds entries to both lists.
-(er-eval-test "monitor records both sides"
-  (do
-    (ev "P = spawn(fun () -> receive forever -> ok end end), monitor(process, P)")
-    (and
-      (= (len (er-proc-field (er-mk-pid 0) :monitors)) 1)
-      (= (len (er-proc-field (er-mk-pid 1) :monitored-by)) 1)))
-  true)
-
-;; demonitor clears both lists.
-(er-eval-test "demonitor clears both"
-  (do
-    (ev "P = spawn(fun () -> receive forever -> ok end end), R = monitor(process, P), demonitor(R)")
-    (and
-      (= (len (er-proc-field (er-mk-pid 0) :monitors)) 0)
-      (= (len (er-proc-field (er-mk-pid 1) :monitored-by)) 0)))
-  true)
-
-;; ── exit-signal propagation + trap_exit ────────────────────────
-(er-eval-test "process_flag default false"
-  (nm (ev "process_flag(trap_exit, true)")) "false")
-(er-eval-test "process_flag returns prev"
-  (nm (ev "process_flag(trap_exit, true), process_flag(trap_exit, false)"))
-  "true")
-
-;; Monitor fires on normal exit.
-(er-eval-test "monitor DOWN normal"
-  (nm (ev "P = spawn(fun () -> ok end), monitor(process, P), receive {'DOWN', _, process, _, R} -> R end"))
-  "normal")
-
-;; Monitor fires on abnormal exit.
-(er-eval-test "monitor DOWN abnormal"
-  (nm (ev "P = spawn(fun () -> exit(boom) end), monitor(process, P), receive {'DOWN', _, process, _, R} -> R end"))
-  "boom")
-
-;; Monitor's ref appears in DOWN message.
-(er-eval-test "monitor DOWN ref matches"
-  (nm (ev "P = spawn(fun () -> exit(bye) end), Ref = monitor(process, P), receive {'DOWN', Ref, process, _, _} -> ok_match end"))
-  "ok_match")
-
-;; Two monitors -> both fire.
-(er-eval-test "two monitors both fire"
-  (ev "P = spawn(fun () -> exit(crash) end), monitor(process, P), monitor(process, P), receive {'DOWN', _, _, _, _} -> ok end, receive {'DOWN', _, _, _, _} -> 2 end")
-  2)
-
-;; trap_exit + link + abnormal exit -> {'EXIT', From, Reason} message.
-(er-eval-test "trap_exit catches abnormal"
-  (nm (ev "process_flag(trap_exit, true), P = spawn(fun () -> exit(boom) end), link(P), receive {'EXIT', _, R} -> R end"))
-  "boom")
-
-;; trap_exit + link + normal exit -> {'EXIT', From, normal}.
-(er-eval-test "trap_exit catches normal"
-  (nm (ev "process_flag(trap_exit, true), P = spawn(fun () -> ok end), link(P), receive {'EXIT', _, R} -> R end"))
-  "normal")
-
-;; Cascade exit: A links B, B dies abnormally, A dies with same reason.
-(er-eval-test "cascade reason"
-  (do
-    (ev "A = spawn(fun () -> B = spawn(fun () -> exit(crash) end), link(B), receive forever -> ok end end), receive after 0 -> ok end")
-    (nm (er-proc-field (er-mk-pid 1) :exit-reason)))
-  "crash")
-
-;; Normal exit doesn't cascade (without trap_exit) — A's body returns
-;; "survived" via the `after` clause and A dies normally.
-(er-eval-test "normal exit no cascade"
-  (do
-    (ev "A = spawn(fun () -> B = spawn(fun () -> ok end), link(B), receive {'EXIT', _, _} -> got_exit after 50 -> survived end end), receive after 0 -> ok end")
-    (list
-      (nm (er-proc-field (er-mk-pid 1) :exit-reason))
-      (nm (er-proc-field (er-mk-pid 1) :exit-result))))
-  (list "normal" "survived"))
-
-;; Monitor without trap_exit: monitored proc abnormal doesn't kill the monitor.
-(er-eval-test "monitor doesn't cascade"
-  (nm (ev "P = spawn(fun () -> exit(boom) end), monitor(process, P), receive {'DOWN', _, _, _, _} -> alive end"))
-  "alive")
-
-;; ── try / catch / of / after ─────────────────────────────────
-(er-eval-test "try plain"
-  (ev "try 1 + 2 catch _ -> oops end") 3)
-
-(er-eval-test "try throw caught"
-  (nm (ev "try throw(boom) catch throw:X -> X end")) "boom")
-(er-eval-test "try error caught"
-  (nm (ev "try error(crash) catch error:X -> X end")) "crash")
-(er-eval-test "try exit caught"
-  (nm (ev "try exit(quit) catch exit:X -> X end")) "quit")
-
-(er-eval-test "default class is throw"
-  (nm (ev "try throw(bye) catch X -> X end")) "bye")
-(er-eval-test "default class doesn't catch error"
-  (do
-    (ev "P = spawn(fun () -> try error(crash) catch X -> X end end), receive after 0 -> ok end")
-    (nm (er-proc-field (er-mk-pid 1) :exit-reason)))
-  "crash")
-
-;; of clauses
-(er-eval-test "try of single"
-  (ev "try 42 of N -> N * 2 catch _ -> 0 end") 84)
-(er-eval-test "try of multi"
-  (nm (ev "try ok of ok -> matched; _ -> nope catch _ -> oops end"))
-  "matched")
-(er-eval-test "try of fallthrough"
-  (nm (ev "try x of ok -> a; error -> b; _ -> default catch _ -> oops end"))
-  "default")
-(er-eval-test "try of with guard"
-  (nm (ev "try 5 of N when N > 0 -> pos; _ -> nonneg catch _ -> oops end"))
-  "pos")
-
-;; after clause
-(er-eval-test "after on success"
-  (do (er-io-flush!)
-    (ev "try 7 after io:format(\"a\") end")
-    (er-io-buffer-content))
-  "a")
-(er-eval-test "after on caught"
-  (do (er-io-flush!)
-    (ev "try throw(b) catch throw:_ -> caught after io:format(\"x\") end")
-    (er-io-buffer-content))
-  "x")
-(er-eval-test "after returns body value"
-  (ev "try 99 after 0 end") 99)
-(er-eval-test "try preserves catch result"
-  (nm (ev "try throw(x) catch throw:_ -> recovered after 0 end"))
-  "recovered")
-
-;; nested try
-(er-eval-test "try nested catch outer"
-  (nm (ev "try (try throw(inner) catch error:_ -> bad end) catch throw:X -> X end"))
-  "inner")
-(er-eval-test "try nested catch inner"
-  (nm (ev "try (try throw(inner) catch throw:X -> X end) catch _ -> outer end"))
-  "inner")
-
-;; class re-raise on no-match
-(er-eval-test "throw without catch-throw escapes"
-  (do
-    (ev "P = spawn(fun () -> try throw(bye) catch error:_ -> nope end end), receive after 0 -> ok end")
-    (let ((reason (er-proc-field (er-mk-pid 1) :exit-reason)))
-      (and (er-tuple? reason) (nm (nth (get reason :elements) 0)))))
-  "nocatch")
-
-;; multi-clause catch
-(er-eval-test "multi-clause catch picks throw"
-  (nm (ev "try throw(a) catch error:X -> e; throw:X -> t; exit:X -> x end"))
-  "t")
-(er-eval-test "multi-clause catch picks exit"
-  (nm (ev "try exit(a) catch error:X -> e; throw:X -> t; exit:X -> x end"))
-  "x")
-
-(define
-  er-eval-test-summary
-  (str "eval " er-eval-test-pass "/" er-eval-test-count))

lib/erlang/tests/programs/bank.sx

@@ -1,159 +0,0 @@
-;; Bank account server — stateful process, balance threaded through
-;; recursive loop. Handles {deposit, Amt, From}, {withdraw, Amt, From},
-;; {balance, From}, stop. Tests stateful process patterns.
-
-(define er-bank-test-count 0)
-(define er-bank-test-pass 0)
-(define er-bank-test-fails (list))
-
-(define
-  er-bank-test
-  (fn
-    (name actual expected)
-    (set! er-bank-test-count (+ er-bank-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-bank-test-pass (+ er-bank-test-pass 1))
-      (append! er-bank-test-fails {:actual actual :expected expected :name name}))))
-
-(define bank-ev erlang-eval-ast)
-
-;; Server fun shared by all tests — threaded via the program string.
-(define
-  er-bank-server-src
-  "Server = fun (Balance) ->
-     receive
-       {deposit, Amt, From} -> From ! ok, Server(Balance + Amt);
-       {withdraw, Amt, From} ->
-         if Amt > Balance -> From ! insufficient, Server(Balance);
-            true -> From ! ok, Server(Balance - Amt)
-         end;
-       {balance, From} -> From ! Balance, Server(Balance);
-       stop -> ok
-     end
-   end")
-
-;; Open account, deposit, check balance.
-(er-bank-test
-  "deposit 100 -> balance 100"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(0) end),
-       Bank ! {deposit, 100, Me},
-       receive ok -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  100)
-
-;; Multiple deposits accumulate.
-(er-bank-test
-  "deposits accumulate"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(0) end),
-       Bank ! {deposit, 50, Me}, receive ok -> ok end,
-       Bank ! {deposit, 25, Me}, receive ok -> ok end,
-       Bank ! {deposit, 10, Me}, receive ok -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  85)
-
-;; Withdraw within balance succeeds; insufficient gets rejected.
-(er-bank-test
-  "withdraw within balance"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(100) end),
-       Bank ! {withdraw, 30, Me}, receive ok -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  70)
-
-(er-bank-test
-  "withdraw insufficient"
-  (get
-    (bank-ev
-      (str
-        er-bank-server-src
-        ", Me = self(),
-         Bank = spawn(fun () -> Server(20) end),
-         Bank ! {withdraw, 100, Me},
-         receive R -> Bank ! stop, R end"))
-    :name)
-  "insufficient")
-
-;; State preserved across an insufficient withdrawal.
-(er-bank-test
-  "state preserved on rejection"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(50) end),
-       Bank ! {withdraw, 1000, Me}, receive _ -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  50)
-
-;; Mixed deposits and withdrawals.
-(er-bank-test
-  "mixed transactions"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(100) end),
-       Bank ! {deposit, 50, Me}, receive ok -> ok end,
-       Bank ! {withdraw, 30, Me}, receive ok -> ok end,
-       Bank ! {deposit, 10, Me}, receive ok -> ok end,
-       Bank ! {withdraw, 5, Me}, receive ok -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  125)
-
-;; Server.stop terminates the bank cleanly — main can verify by
-;; sending stop and then exiting normally.
-(er-bank-test
-  "server stops cleanly"
-  (get
-    (bank-ev
-      (str
-        er-bank-server-src
-        ", Me = self(),
-         Bank = spawn(fun () -> Server(0) end),
-         Bank ! stop,
-         done"))
-    :name)
-  "done")
-
-;; Two clients sharing one bank — interleaved transactions.
-(er-bank-test
-  "two clients share bank"
-  (bank-ev
-    (str
-      er-bank-server-src
-      ", Me = self(),
-       Bank = spawn(fun () -> Server(0) end),
-       Client = fun (Amt) ->
-         spawn(fun () ->
-           Bank ! {deposit, Amt, self()},
-           receive ok -> Me ! deposited end
-         end)
-       end,
-       Client(40),
-       Client(60),
-       receive deposited -> ok end,
-       receive deposited -> ok end,
-       Bank ! {balance, Me},
-       receive B -> Bank ! stop, B end"))
-  100)
-
-(define
-  er-bank-test-summary
-  (str "bank " er-bank-test-pass "/" er-bank-test-count))

lib/erlang/tests/programs/echo.sx

@@ -1,140 +0,0 @@
-;; Echo server — minimal classic Erlang server. Receives {From, Msg}
-;; and sends Msg back to From, then loops. `stop` ends the server.
-
-(define er-echo-test-count 0)
-(define er-echo-test-pass 0)
-(define er-echo-test-fails (list))
-
-(define
-  er-echo-test
-  (fn
-    (name actual expected)
-    (set! er-echo-test-count (+ er-echo-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-echo-test-pass (+ er-echo-test-pass 1))
-      (append! er-echo-test-fails {:actual actual :expected expected :name name}))))
-
-(define echo-ev erlang-eval-ast)
-
-(define
-  er-echo-server-src
-  "EchoSrv = fun () ->
-     Loop = fun () ->
-       receive
-         {From, Msg} -> From ! Msg, Loop();
-         stop -> ok
-       end
-     end,
-     Loop()
-   end")
-
-;; Single round-trip with an atom.
-(er-echo-test
-  "atom round-trip"
-  (get
-    (echo-ev
-      (str
-        er-echo-server-src
-        ", Me = self(),
-         Echo = spawn(EchoSrv),
-         Echo ! {Me, hello},
-         receive R -> Echo ! stop, R end"))
-    :name)
-  "hello")
-
-;; Number round-trip.
-(er-echo-test
-  "number round-trip"
-  (echo-ev
-    (str
-      er-echo-server-src
-      ", Me = self(),
-       Echo = spawn(EchoSrv),
-       Echo ! {Me, 42},
-       receive R -> Echo ! stop, R end"))
-  42)
-
-;; Tuple round-trip — pattern-match the reply to extract V.
-(er-echo-test
-  "tuple round-trip"
-  (echo-ev
-    (str
-      er-echo-server-src
-      ", Me = self(),
-       Echo = spawn(EchoSrv),
-       Echo ! {Me, {ok, 7}},
-       receive {ok, V} -> Echo ! stop, V end"))
-  7)
-
-;; List round-trip.
-(er-echo-test
-  "list round-trip"
-  (echo-ev
-    (str
-      er-echo-server-src
-      ", Me = self(),
-       Echo = spawn(EchoSrv),
-       Echo ! {Me, [1, 2, 3]},
-       receive [H | _] -> Echo ! stop, H end"))
-  1)
-
-;; Multiple sequential round-trips.
-(er-echo-test
-  "three round-trips"
-  (echo-ev
-    (str
-      er-echo-server-src
-      ", Me = self(),
-       Echo = spawn(EchoSrv),
-       Echo ! {Me, 10}, A = receive Ra -> Ra end,
-       Echo ! {Me, 20}, B = receive Rb -> Rb end,
-       Echo ! {Me, 30}, C = receive Rc -> Rc end,
-       Echo ! stop,
-       A + B + C"))
-  60)
-
-;; Two clients sharing one echo server. Each gets its own reply.
-(er-echo-test
-  "two clients"
-  (get
-    (echo-ev
-      (str
-        er-echo-server-src
-        ", Me = self(),
-         Echo = spawn(EchoSrv),
-         Client = fun (Tag) ->
-           spawn(fun () ->
-             Echo ! {self(), Tag},
-             receive R -> Me ! {got, R} end
-           end)
-         end,
-         Client(a),
-         Client(b),
-         receive {got, _} -> ok end,
-         receive {got, _} -> ok end,
-         Echo ! stop,
-         finished"))
-    :name)
-  "finished")
-
-;; Echo via io trace — verify each message round-trips through.
-(er-echo-test
-  "trace 4 messages"
-  (do
-    (er-io-flush!)
-    (echo-ev
-      (str
-        er-echo-server-src
-        ", Me = self(),
-         Echo = spawn(EchoSrv),
-         Send = fun (V) -> Echo ! {Me, V}, receive R -> io:format(\"~p \", [R]) end end,
-         Send(1), Send(2), Send(3), Send(4),
-         Echo ! stop,
-         done"))
-    (er-io-buffer-content))
-  "1 2 3 4 ")
-
-(define
-  er-echo-test-summary
-  (str "echo " er-echo-test-pass "/" er-echo-test-count))

lib/erlang/tests/programs/fib_server.sx

@@ -1,152 +0,0 @@
-;; Fib server — long-lived process that computes fibonacci numbers on
-;; request. Tests recursive function evaluation inside a server loop.
-
-(define er-fib-test-count 0)
-(define er-fib-test-pass 0)
-(define er-fib-test-fails (list))
-
-(define
-  er-fib-test
-  (fn
-    (name actual expected)
-    (set! er-fib-test-count (+ er-fib-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-fib-test-pass (+ er-fib-test-pass 1))
-      (append! er-fib-test-fails {:actual actual :expected expected :name name}))))
-
-(define fib-ev erlang-eval-ast)
-
-;; Fib + server-loop source. Standalone so each test can chain queries.
-(define
-  er-fib-server-src
-  "Fib = fun (0) -> 0; (1) -> 1; (N) -> Fib(N-1) + Fib(N-2) end,
-   FibSrv = fun () ->
-     Loop = fun () ->
-       receive
-         {fib, N, From} -> From ! Fib(N), Loop();
-         stop -> ok
-       end
-     end,
-     Loop()
-   end")
-
-;; Base cases.
-(er-fib-test
-  "fib(0)"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 0, Me},
-       receive R -> Srv ! stop, R end"))
-  0)
-
-(er-fib-test
-  "fib(1)"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 1, Me},
-       receive R -> Srv ! stop, R end"))
-  1)
-
-;; Larger values.
-(er-fib-test
-  "fib(10) = 55"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 10, Me},
-       receive R -> Srv ! stop, R end"))
-  55)
-
-(er-fib-test
-  "fib(15) = 610"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 15, Me},
-       receive R -> Srv ! stop, R end"))
-  610)
-
-;; Multiple sequential queries to one server. Sum to avoid dict-equality.
-(er-fib-test
-  "sequential fib(5..8) sum"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 5, Me}, A = receive Ra -> Ra end,
-       Srv ! {fib, 6, Me}, B = receive Rb -> Rb end,
-       Srv ! {fib, 7, Me}, C = receive Rc -> Rc end,
-       Srv ! {fib, 8, Me}, D = receive Rd -> Rd end,
-       Srv ! stop,
-       A + B + C + D"))
-  47)
-
-;; Verify Fib obeys the recurrence — fib(n) = fib(n-1) + fib(n-2).
-(er-fib-test
-  "fib recurrence at n=12"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Srv ! {fib, 10, Me}, A = receive Ra -> Ra end,
-       Srv ! {fib, 11, Me}, B = receive Rb -> Rb end,
-       Srv ! {fib, 12, Me}, C = receive Rc -> Rc end,
-       Srv ! stop,
-       C - (A + B)"))
-  0)
-
-;; Two clients each get their own answer; main sums the results.
-(er-fib-test
-  "two clients sum"
-  (fib-ev
-    (str
-      er-fib-server-src
-      ", Me = self(),
-       Srv = spawn(FibSrv),
-       Client = fun (N) ->
-         spawn(fun () ->
-           Srv ! {fib, N, self()},
-           receive R -> Me ! {result, R} end
-         end)
-       end,
-       Client(7),
-       Client(9),
-       {result, A} = receive M1 -> M1 end,
-       {result, B} = receive M2 -> M2 end,
-       Srv ! stop,
-       A + B"))
-  47)
-
-;; Trace queries via io-buffer.
-(er-fib-test
-  "trace fib 0..6"
-  (do
-    (er-io-flush!)
-    (fib-ev
-      (str
-        er-fib-server-src
-        ", Me = self(),
-         Srv = spawn(FibSrv),
-         Ask = fun (N) -> Srv ! {fib, N, Me}, receive R -> io:format(\"~p \", [R]) end end,
-         Ask(0), Ask(1), Ask(2), Ask(3), Ask(4), Ask(5), Ask(6),
-         Srv ! stop,
-         done"))
-    (er-io-buffer-content))
-  "0 1 1 2 3 5 8 ")
-
-(define
-  er-fib-test-summary
-  (str "fib " er-fib-test-pass "/" er-fib-test-count))

lib/erlang/tests/programs/ping_pong.sx

@@ -1,127 +0,0 @@
-;; Ping-pong program — two processes exchange N messages, then signal
-;; main via separate `ping_done` / `pong_done` notifications.
-
-(define er-pp-test-count 0)
-(define er-pp-test-pass 0)
-(define er-pp-test-fails (list))
-
-(define
-  er-pp-test
-  (fn
-    (name actual expected)
-    (set! er-pp-test-count (+ er-pp-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-pp-test-pass (+ er-pp-test-pass 1))
-      (append! er-pp-test-fails {:actual actual :expected expected :name name}))))
-
-(define pp-ev erlang-eval-ast)
-
-;; Three rounds of ping-pong, then stop. Main receives ping_done and
-;; pong_done in arrival order (Ping finishes first because Pong exits
-;; only after receiving stop).
-(define
-  er-pp-program
-  "Me = self(),
-   Pong = spawn(fun () ->
-     Loop = fun () ->
-       receive
-         {ping, From} -> From ! pong, Loop();
-         stop -> Me ! pong_done
-       end
-     end,
-     Loop()
-   end),
-   Ping = fun (Target, K) ->
-     if K =:= 0 -> Target ! stop, Me ! ping_done;
-        true -> Target ! {ping, self()}, receive pong -> Ping(Target, K - 1) end
-     end
-   end,
-   spawn(fun () -> Ping(Pong, 3) end),
-   receive ping_done -> ok end,
-   receive pong_done -> both_done end")
-
-(er-pp-test
-  "ping-pong 3 rounds"
-  (get (pp-ev er-pp-program) :name)
-  "both_done")
-
-;; Count exchanges via io-buffer — each pong trip prints "p".
-(er-pp-test
-  "ping-pong 5 rounds trace"
-  (do
-    (er-io-flush!)
-    (pp-ev
-      "Me = self(),
-       Pong = spawn(fun () ->
-         Loop = fun () ->
-           receive
-             {ping, From} -> io:format(\"p\"), From ! pong, Loop();
-             stop -> Me ! pong_done
-           end
-         end,
-         Loop()
-       end),
-       Ping = fun (Target, K) ->
-         if K =:= 0 -> Target ! stop, Me ! ping_done;
-            true -> Target ! {ping, self()}, receive pong -> Ping(Target, K - 1) end
-         end
-       end,
-       spawn(fun () -> Ping(Pong, 5) end),
-       receive ping_done -> ok end,
-       receive pong_done -> ok end")
-    (er-io-buffer-content))
-  "ppppp")
-
-;; Main → Pong directly (no Ping process). Main plays the ping role.
-(er-pp-test
-  "main-as-pinger 4 rounds"
-  (pp-ev
-    "Me = self(),
-     Pong = spawn(fun () ->
-       Loop = fun () ->
-         receive
-           {ping, From} -> From ! pong, Loop();
-           stop -> ok
-         end
-       end,
-       Loop()
-     end),
-     Go = fun (K) ->
-       if K =:= 0 -> Pong ! stop, K;
-          true -> Pong ! {ping, Me}, receive pong -> Go(K - 1) end
-       end
-     end,
-     Go(4)")
-  0)
-
-;; Ensure the processes really interleave — inject an id into each
-;; ping and check we get them all back via trace (the order is
-;; deterministic under our sync scheduler).
-(er-pp-test
-  "ids round-trip"
-  (do
-    (er-io-flush!)
-    (pp-ev
-      "Me = self(),
-       Pong = spawn(fun () ->
-         Loop = fun () ->
-           receive
-             {ping, From, Id} -> From ! {pong, Id}, Loop();
-             stop -> ok
-           end
-         end,
-         Loop()
-       end),
-       Go = fun (K) ->
-         if K =:= 0 -> Pong ! stop, done;
-            true -> Pong ! {ping, Me, K}, receive {pong, RId} -> io:format(\"~p \", [RId]), Go(K - 1) end
-         end
-       end,
-       Go(4)")
-    (er-io-buffer-content))
-  "4 3 2 1 ")
-
-(define
-  er-pp-test-summary
-  (str "ping-pong " er-pp-test-pass "/" er-pp-test-count))

lib/erlang/tests/programs/ring.sx

@@ -1,132 +0,0 @@
-;; Ring program — N processes in a ring, token passes M times.
-;;
-;; Each process waits for {setup, Next} so main can tie the knot
-;; (can't reference a pid before spawning it). Once wired, main
-;; injects the first token; each process forwards decrementing K
-;; until it hits 0, at which point it signals `done` to main.
-
-(define er-ring-test-count 0)
-(define er-ring-test-pass 0)
-(define er-ring-test-fails (list))
-
-(define
-  er-ring-test
-  (fn
-    (name actual expected)
-    (set! er-ring-test-count (+ er-ring-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-ring-test-pass (+ er-ring-test-pass 1))
-      (append! er-ring-test-fails {:actual actual :expected expected :name name}))))
-
-(define ring-ev erlang-eval-ast)
-
-(define
-  er-ring-program-3-6
-  "Me = self(),
-   Spawner = fun () ->
-     receive {setup, Next} ->
-       Loop = fun () ->
-         receive
-           {token, 0, Parent} -> Parent ! done;
-           {token, K, Parent} -> Next ! {token, K-1, Parent}, Loop()
-         end
-       end,
-       Loop()
-     end
-   end,
-   P1 = spawn(Spawner),
-   P2 = spawn(Spawner),
-   P3 = spawn(Spawner),
-   P1 ! {setup, P2},
-   P2 ! {setup, P3},
-   P3 ! {setup, P1},
-   P1 ! {token, 5, Me},
-   receive done -> finished end")
-
-(er-ring-test
-  "ring N=3 M=6"
-  (get (ring-ev er-ring-program-3-6) :name)
-  "finished")
-
-;; Two-node ring — token bounces twice between P1 and P2.
-(er-ring-test
-  "ring N=2 M=4"
-  (get (ring-ev
-    "Me = self(),
-     Spawner = fun () ->
-       receive {setup, Next} ->
-         Loop = fun () ->
-           receive
-             {token, 0, Parent} -> Parent ! done;
-             {token, K, Parent} -> Next ! {token, K-1, Parent}, Loop()
-           end
-         end,
-         Loop()
-       end
-     end,
-     P1 = spawn(Spawner),
-     P2 = spawn(Spawner),
-     P1 ! {setup, P2},
-     P2 ! {setup, P1},
-     P1 ! {token, 3, Me},
-     receive done -> done end") :name)
-  "done")
-
-;; Single-node "ring" — P sends to itself M times.
-(er-ring-test
-  "ring N=1 M=5"
-  (get (ring-ev
-    "Me = self(),
-     Spawner = fun () ->
-       receive {setup, Next} ->
-         Loop = fun () ->
-           receive
-             {token, 0, Parent} -> Parent ! finished_loop;
-             {token, K, Parent} -> Next ! {token, K-1, Parent}, Loop()
-           end
-         end,
-         Loop()
-       end
-     end,
-     P = spawn(Spawner),
-     P ! {setup, P},
-     P ! {token, 4, Me},
-     receive finished_loop -> ok end") :name)
-  "ok")
-
-;; Confirm the token really went around — count hops via io-buffer.
-(er-ring-test
-  "ring N=3 M=9 hop count"
-  (do
-    (er-io-flush!)
-    (ring-ev
-      "Me = self(),
-       Spawner = fun () ->
-         receive {setup, Next} ->
-           Loop = fun () ->
-             receive
-               {token, 0, Parent} -> Parent ! done;
-               {token, K, Parent} ->
-                 io:format(\"~p \", [K]),
-                 Next ! {token, K-1, Parent},
-                 Loop()
-             end
-           end,
-           Loop()
-         end
-       end,
-       P1 = spawn(Spawner),
-       P2 = spawn(Spawner),
-       P3 = spawn(Spawner),
-       P1 ! {setup, P2},
-       P2 ! {setup, P3},
-       P3 ! {setup, P1},
-       P1 ! {token, 8, Me},
-       receive done -> done end")
-    (er-io-buffer-content))
-  "8 7 6 5 4 3 2 1 ")
-
-(define
-  er-ring-test-summary
-  (str "ring " er-ring-test-pass "/" er-ring-test-count))

lib/erlang/tests/runtime.sx

@@ -1,139 +0,0 @@
-;; Erlang runtime tests — scheduler + process-record primitives.
-
-(define er-rt-test-count 0)
-(define er-rt-test-pass 0)
-(define er-rt-test-fails (list))
-
-(define
-  er-rt-test
-  (fn
-    (name actual expected)
-    (set! er-rt-test-count (+ er-rt-test-count 1))
-    (if
-      (= actual expected)
-      (set! er-rt-test-pass (+ er-rt-test-pass 1))
-      (append! er-rt-test-fails {:actual actual :expected expected :name name}))))
-
-;; ── queue ─────────────────────────────────────────────────────────
-(er-rt-test "queue empty len" (er-q-len (er-q-new)) 0)
-(er-rt-test "queue empty?" (er-q-empty? (er-q-new)) true)
-
-(define q1 (er-q-new))
-(er-q-push! q1 "a")
-(er-q-push! q1 "b")
-(er-q-push! q1 "c")
-(er-rt-test "queue push len" (er-q-len q1) 3)
-(er-rt-test "queue empty? after push" (er-q-empty? q1) false)
-(er-rt-test "queue peek" (er-q-peek q1) "a")
-(er-rt-test "queue pop 1" (er-q-pop! q1) "a")
-(er-rt-test "queue pop 2" (er-q-pop! q1) "b")
-(er-rt-test "queue len after pops" (er-q-len q1) 1)
-(er-rt-test "queue pop 3" (er-q-pop! q1) "c")
-(er-rt-test "queue empty again" (er-q-empty? q1) true)
-(er-rt-test "queue pop empty" (er-q-pop! q1) nil)
-
-;; Queue FIFO under interleaved push/pop
-(define q2 (er-q-new))
-(er-q-push! q2 1)
-(er-q-push! q2 2)
-(er-q-pop! q2)
-(er-q-push! q2 3)
-(er-rt-test "queue interleave peek" (er-q-peek q2) 2)
-(er-rt-test "queue to-list" (er-q-to-list q2) (list 2 3))
-
-;; ── scheduler init ─────────────────────────────────────────────
-(er-sched-init!)
-(er-rt-test "sched process count 0" (er-sched-process-count) 0)
-(er-rt-test "sched runnable count 0" (er-sched-runnable-count) 0)
-(er-rt-test "sched current nil" (er-sched-current-pid) nil)
-
-;; ── pid allocation ─────────────────────────────────────────────
-(define pa (er-pid-new!))
-(define pb (er-pid-new!))
-(er-rt-test "pid tag" (get pa :tag) "pid")
-(er-rt-test "pid ids distinct" (= (er-pid-id pa) (er-pid-id pb)) false)
-(er-rt-test "pid? true" (er-pid? pa) true)
-(er-rt-test "pid? false" (er-pid? 42) false)
-(er-rt-test
-  "pid-equal same"
-  (er-pid-equal? pa (er-mk-pid (er-pid-id pa)))
-  true)
-(er-rt-test "pid-equal diff" (er-pid-equal? pa pb) false)
-
-;; ── process lifecycle ──────────────────────────────────────────
-(er-sched-init!)
-(define p1 (er-proc-new! {}))
-(define p2 (er-proc-new! {}))
-(er-rt-test "proc count 2" (er-sched-process-count) 2)
-(er-rt-test "runnable count 2" (er-sched-runnable-count) 2)
-(er-rt-test
-  "proc state runnable"
-  (er-proc-field (get p1 :pid) :state)
-  "runnable")
-(er-rt-test
-  "proc mailbox empty"
-  (er-proc-mailbox-size (get p1 :pid))
-  0)
-(er-rt-test
-  "proc lookup"
-  (er-pid-equal? (get (er-proc-get (get p1 :pid)) :pid) (get p1 :pid))
-  true)
-(er-rt-test "proc exists" (er-proc-exists? (get p1 :pid)) true)
-(er-rt-test
-  "proc no-such-pid"
-  (er-proc-exists? (er-mk-pid 9999))
-  false)
-
-;; runnable queue dequeue order
-(er-rt-test
-  "dequeue first"
-  (er-pid-equal? (er-sched-next-runnable!) (get p1 :pid))
-  true)
-(er-rt-test
-  "dequeue second"
-  (er-pid-equal? (er-sched-next-runnable!) (get p2 :pid))
-  true)
-(er-rt-test "dequeue empty" (er-sched-next-runnable!) nil)
-
-;; current-pid get/set
-(er-sched-set-current! (get p1 :pid))
-(er-rt-test
-  "current pid set"
-  (er-pid-equal? (er-sched-current-pid) (get p1 :pid))
-  true)
-
-;; ── mailbox push ──────────────────────────────────────────────
-(er-proc-mailbox-push! (get p1 :pid) {:tag "atom" :name "ping"})
-(er-proc-mailbox-push! (get p1 :pid) 42)
-(er-rt-test "mailbox size 2" (er-proc-mailbox-size (get p1 :pid)) 2)
-
-;; ── field update ──────────────────────────────────────────────
-(er-proc-set! (get p1 :pid) :state "waiting")
-(er-rt-test
-  "proc state waiting"
-  (er-proc-field (get p1 :pid) :state)
-  "waiting")
-(er-proc-set! (get p1 :pid) :trap-exit true)
-(er-rt-test
-  "proc trap-exit"
-  (er-proc-field (get p1 :pid) :trap-exit)
-  true)
-
-;; ── fresh scheduler ends in clean state ───────────────────────
-(er-sched-init!)
-(er-rt-test
-  "sched init resets count"
-  (er-sched-process-count)
-  0)
-(er-rt-test
-  "sched init resets queue"
-  (er-sched-runnable-count)
-  0)
-(er-rt-test
-  "sched init resets current"
-  (er-sched-current-pid)
-  nil)
-
-(define
-  er-rt-test-summary
-  (str "runtime " er-rt-test-pass "/" er-rt-test-count))

lib/smalltalk/eval.sx

@@ -0,0 +1,722 @@
+;; Smalltalk AST evaluator — sequential semantics. Method dispatch uses the
+;; class table from runtime.sx; native receivers fall back to a primitive
+;; method table. Non-local return is implemented via a sentinel marker; the
+;; full continuation-based escape is the Phase 3 showcase.
+;;
+;; Frame:
+;;   {:self V                 ; receiver
+;;    :method-class N         ; defining class of the executing method
+;;    :locals (mutable dict)  ; param + temp bindings
+;;    :parent P}              ; outer frame for blocks (nil for top-level)
+;;
+;; `smalltalk-eval-ast(ast, frame)` returns the value or a return marker.
+;; Method invocation unwraps return markers; sequences propagate them.
+
+(define
+  st-make-frame
+  (fn
+    (self method-class parent)
+    {:self self :method-class method-class :locals {} :parent parent}))
+
+(define st-return-marker (fn (v) {:st-return true :value v}))
+
+(define
+  st-return-marker?
+  (fn (v) (and (dict? v) (has-key? v :st-return) (= (get v :st-return) true))))
+
+(define
+  st-make-block
+  (fn
+    (ast frame)
+    {:type "st-block"
+     :params (get ast :params)
+     :temps (get ast :temps)
+     :body (get ast :body)
+     :env frame}))
+
+(define
+  st-block?
+  (fn
+    (v)
+    (and (dict? v) (has-key? v :type) (= (get v :type) "st-block"))))
+
+(define
+  st-class-ref
+  (fn (name) {:type "st-class" :name name}))
+
+(define
+  st-class-ref?
+  (fn (v) (and (dict? v) (has-key? v :type) (= (get v :type) "st-class"))))
+
+;; Walk the frame chain looking for a local binding.
+(define
+  st-lookup-local
+  (fn
+    (frame name)
+    (cond
+      ((= frame nil) {:found false :value nil :frame nil})
+      ((has-key? (get frame :locals) name)
+        {:found true :value (get (get frame :locals) name) :frame frame})
+      (else (st-lookup-local (get frame :parent) name)))))
+
+;; Walk the frame chain looking for the frame whose self has this ivar.
+(define
+  st-lookup-ivar-frame
+  (fn
+    (frame name)
+    (cond
+      ((= frame nil) nil)
+      ((let ((self (get frame :self)))
+         (and (st-instance? self) (has-key? (get self :ivars) name)))
+        frame)
+      (else (st-lookup-ivar-frame (get frame :parent) name)))))
+
+;; Resolve an identifier in eval order: local → ivar → class → error.
+(define
+  st-resolve-ident
+  (fn
+    (frame name)
+    (let
+      ((local-result (st-lookup-local frame name)))
+      (cond
+        ((get local-result :found) (get local-result :value))
+        (else
+          (let
+            ((iv-frame (st-lookup-ivar-frame frame name)))
+            (cond
+              ((not (= iv-frame nil))
+                (get (get (get iv-frame :self) :ivars) name))
+              ((st-class-exists? name) (st-class-ref name))
+              (else
+                (error
+                  (str "smalltalk-eval-ast: undefined variable '" name "'"))))))))))
+
+;; Assign to an existing local in the frame chain or, failing that, an ivar
+;; on self. Errors if neither exists.
+(define
+  st-assign!
+  (fn
+    (frame name value)
+    (let
+      ((local-result (st-lookup-local frame name)))
+      (cond
+        ((get local-result :found)
+          (begin
+            (dict-set! (get (get local-result :frame) :locals) name value)
+            value))
+        (else
+          (let
+            ((iv-frame (st-lookup-ivar-frame frame name)))
+            (cond
+              ((not (= iv-frame nil))
+                (begin
+                  (dict-set! (get (get iv-frame :self) :ivars) name value)
+                  value))
+              (else
+                ;; Smalltalk allows new locals to be introduced; for our subset
+                ;; we treat unknown writes as errors so test mistakes surface.
+                (error
+                  (str "smalltalk-eval-ast: cannot assign undefined '" name "'"))))))))))
+
+;; ── Main evaluator ─────────────────────────────────────────────────────
+(define
+  smalltalk-eval-ast
+  (fn
+    (ast frame)
+    (cond
+      ((not (dict? ast)) (error (str "smalltalk-eval-ast: bad ast " ast)))
+      (else
+        (let
+          ((ty (get ast :type)))
+          (cond
+            ((= ty "lit-int") (get ast :value))
+            ((= ty "lit-float") (get ast :value))
+            ((= ty "lit-string") (get ast :value))
+            ((= ty "lit-char") (get ast :value))
+            ((= ty "lit-symbol") (make-symbol (get ast :value)))
+            ((= ty "lit-nil") nil)
+            ((= ty "lit-true") true)
+            ((= ty "lit-false") false)
+            ((= ty "lit-array")
+              (map
+                (fn (e) (smalltalk-eval-ast e frame))
+                (get ast :elements)))
+            ((= ty "lit-byte-array") (get ast :elements))
+            ((= ty "self") (get frame :self))
+            ((= ty "super") (get frame :self))
+            ((= ty "thisContext") frame)
+            ((= ty "ident") (st-resolve-ident frame (get ast :name)))
+            ((= ty "assign")
+              (st-assign! frame (get ast :name) (smalltalk-eval-ast (get ast :expr) frame)))
+            ((= ty "return")
+              (st-return-marker (smalltalk-eval-ast (get ast :expr) frame)))
+            ((= ty "block") (st-make-block ast frame))
+            ((= ty "seq") (st-eval-seq (get ast :exprs) frame))
+            ((= ty "send")
+              (st-eval-send ast frame (= (get (get ast :receiver) :type) "super")))
+            ((= ty "cascade") (st-eval-cascade ast frame))
+            (else (error (str "smalltalk-eval-ast: unknown type '" ty "'")))))))))
+
+(define
+  st-eval-seq
+  (fn
+    (exprs frame)
+    (let ((result nil))
+      (begin
+        (define
+          sq-loop
+          (fn
+            (rest)
+            (cond
+              ((= (len rest) 0) nil)
+              (else
+                (let ((v (smalltalk-eval-ast (nth rest 0) frame)))
+                  (cond
+                    ((st-return-marker? v) (set! result v))
+                    ((= (len rest) 1) (set! result v))
+                    (else (sq-loop (rest-of rest)))))))))
+        (sq-loop exprs)
+        result))))
+
+(define
+  rest-of
+  (fn
+    (lst)
+    (let ((out (list)) (i 1) (n (len lst)))
+      (begin
+        (define
+          ro-loop
+          (fn
+            ()
+            (when
+              (< i n)
+              (begin (append! out (nth lst i)) (set! i (+ i 1)) (ro-loop)))))
+        (ro-loop)
+        out))))
+
+(define
+  st-eval-send
+  (fn
+    (ast frame super?)
+    (let
+      ((receiver (smalltalk-eval-ast (get ast :receiver) frame))
+        (selector (get ast :selector))
+        (args (map (fn (a) (smalltalk-eval-ast a frame)) (get ast :args))))
+      (cond
+        (super?
+          (st-super-send (get frame :self) selector args (get frame :method-class)))
+        (else (st-send receiver selector args))))))
+
+(define
+  st-eval-cascade
+  (fn
+    (ast frame)
+    (let
+      ((receiver (smalltalk-eval-ast (get ast :receiver) frame))
+        (msgs (get ast :messages))
+        (last nil))
+      (begin
+        (for-each
+          (fn
+            (m)
+            (let
+              ((sel (get m :selector))
+                (args (map (fn (a) (smalltalk-eval-ast a frame)) (get m :args))))
+              (set! last (st-send receiver sel args))))
+          msgs)
+        last))))
+
+;; ── Send dispatch ──────────────────────────────────────────────────────
+(define
+  st-send
+  (fn
+    (receiver selector args)
+    (let
+      ((cls (st-class-of-for-send receiver)))
+      (let
+        ((class-side? (st-class-ref? receiver))
+          (recv-class (if (st-class-ref? receiver) (get receiver :name) cls)))
+        (let
+          ((method
+             (if class-side?
+               (st-method-lookup recv-class selector true)
+               (st-method-lookup recv-class selector false))))
+          (cond
+            ((not (= method nil))
+              (st-invoke method receiver args))
+            ((st-block? receiver)
+              (let ((bd (st-block-dispatch receiver selector args)))
+                (cond
+                  ((= bd :unhandled) (st-dnu receiver selector args))
+                  (else bd))))
+            (else
+              (let ((primitive-result (st-primitive-send receiver selector args)))
+                (cond
+                  ((= primitive-result :unhandled)
+                    (st-dnu receiver selector args))
+                  (else primitive-result))))))))))
+
+;; Construct a Message object for doesNotUnderstand:.
+(define
+  st-make-message
+  (fn
+    (selector args)
+    (let ((msg (st-make-instance "Message")))
+      (begin
+        (dict-set! (get msg :ivars) "selector" (make-symbol selector))
+        (dict-set! (get msg :ivars) "arguments" args)
+        msg))))
+
+;; Trigger doesNotUnderstand:. If the receiver's class chain defines an
+;; override, invoke it with a freshly-built Message; otherwise raise.
+(define
+  st-dnu
+  (fn
+    (receiver selector args)
+    (let
+      ((cls (st-class-of-for-send receiver))
+        (class-side? (st-class-ref? receiver)))
+      (let
+        ((recv-class (if class-side? (get receiver :name) cls)))
+        (let
+          ((method (st-method-lookup recv-class "doesNotUnderstand:" class-side?)))
+          (cond
+            ((not (= method nil))
+              (let ((msg (st-make-message selector args)))
+                (st-invoke method receiver (list msg))))
+            (else
+              (error
+                (str "doesNotUnderstand: " recv-class " >> " selector)))))))))
+
+(define
+  st-class-of-for-send
+  (fn
+    (v)
+    (cond
+      ((st-class-ref? v) "Class")
+      (else (st-class-of v)))))
+
+;; super send: lookup starts at the *defining* class's superclass, not the
+;; receiver class. This is what makes inherited methods compose correctly
+;; under refinement — a method on Foo that calls `super bar` resolves to
+;; Foo's superclass's `bar` regardless of the dynamic receiver class.
+(define
+  st-super-send
+  (fn
+    (receiver selector args defining-class)
+    (cond
+      ((= defining-class nil)
+        (error (str "super send outside method context: " selector)))
+      (else
+        (let
+          ((super (st-class-superclass defining-class))
+            (class-side? (st-class-ref? receiver)))
+          (cond
+            ((= super nil)
+              (error (str "super send past root: " selector " in " defining-class)))
+            (else
+              (let ((method (st-method-lookup super selector class-side?)))
+                (cond
+                  ((not (= method nil))
+                    (st-invoke method receiver args))
+                  (else
+                    ;; Try primitives starting from super's perspective too —
+                    ;; for native receivers the primitive table is global, so
+                    ;; super basically reaches the same primitives. The point
+                    ;; of super is to skip user overrides on the receiver's
+                    ;; class chain below `super`, which method-lookup above
+                    ;; already enforces.
+                    (let ((p (st-primitive-send receiver selector args)))
+                      (cond
+                        ((= p :unhandled)
+                          (st-dnu receiver selector args))
+                        (else p)))))))))))))
+
+;; ── Method invocation ──────────────────────────────────────────────────
+(define
+  st-invoke
+  (fn
+    (method receiver args)
+    (let
+      ((params (get method :params))
+        (temps (get method :temps))
+        (body (get method :body))
+        (defining-class (get method :defining-class)))
+      (cond
+        ((not (= (len params) (len args)))
+          (error
+            (str "smalltalk-eval-ast: arity mismatch for "
+              (get method :selector)
+              " expected " (len params) " got " (len args))))
+        (else
+          (let
+            ((frame (st-make-frame receiver defining-class nil)))
+            (begin
+              ;; Bind params
+              (let ((i 0))
+                (begin
+                  (define
+                    pb-loop
+                    (fn
+                      ()
+                      (when
+                        (< i (len params))
+                        (begin
+                          (dict-set!
+                            (get frame :locals)
+                            (nth params i)
+                            (nth args i))
+                          (set! i (+ i 1))
+                          (pb-loop)))))
+                  (pb-loop)))
+              ;; Bind temps to nil
+              (for-each
+                (fn (t) (dict-set! (get frame :locals) t nil))
+                temps)
+              ;; Execute body
+              (let ((result (st-eval-seq body frame)))
+                (cond
+                  ((st-return-marker? result) (get result :value))
+                  (else receiver))))))))))
+
+;; ── Block dispatch ─────────────────────────────────────────────────────
+(define
+  st-block-value-selector?
+  (fn
+    (s)
+    (or
+      (= s "value")
+      (= s "value:")
+      (= s "value:value:")
+      (= s "value:value:value:")
+      (= s "value:value:value:value:"))))
+
+(define
+  st-block-dispatch
+  (fn
+    (block selector args)
+    (cond
+      ((st-block-value-selector? selector) (st-block-apply block args))
+      ((= selector "valueWithArguments:") (st-block-apply block (nth args 0)))
+      ((= selector "whileTrue:")
+        (st-block-while block (nth args 0) true))
+      ((= selector "whileFalse:")
+        (st-block-while block (nth args 0) false))
+      ((= selector "whileTrue") (st-block-while block nil true))
+      ((= selector "whileFalse") (st-block-while block nil false))
+      ((= selector "numArgs") (len (get block :params)))
+      ((= selector "class") (st-class-ref "BlockClosure"))
+      ((= selector "==") (= block (nth args 0)))
+      ((= selector "printString") "a BlockClosure")
+      (else :unhandled))))
+
+(define
+  st-block-apply
+  (fn
+    (block args)
+    (let
+      ((params (get block :params))
+        (temps (get block :temps))
+        (body (get block :body))
+        (env (get block :env)))
+      (cond
+        ((not (= (len params) (len args)))
+          (error
+            (str "BlockClosure: arity mismatch — block expects "
+              (len params) " got " (len args))))
+        (else
+          (let
+            ((frame (st-make-frame
+                     (if (= env nil) nil (get env :self))
+                     (if (= env nil) nil (get env :method-class))
+                     env)))
+            (begin
+              (let ((i 0))
+                (begin
+                  (define
+                    pb-loop
+                    (fn
+                      ()
+                      (when
+                        (< i (len params))
+                        (begin
+                          (dict-set!
+                            (get frame :locals)
+                            (nth params i)
+                            (nth args i))
+                          (set! i (+ i 1))
+                          (pb-loop)))))
+                  (pb-loop)))
+              (for-each
+                (fn (t) (dict-set! (get frame :locals) t nil))
+                temps)
+              (st-eval-seq body frame))))))))
+
+(define
+  st-block-while
+  (fn
+    (cond-block body-block target)
+    (let ((last nil))
+      (begin
+        (define
+          wh-loop
+          (fn
+            ()
+            (let
+              ((c (st-block-apply cond-block (list))))
+              (when
+                (= c target)
+                (begin
+                  (cond
+                    ((not (= body-block nil))
+                      (set! last (st-block-apply body-block (list)))))
+                  (wh-loop))))))
+        (wh-loop)
+        last))))
+
+;; ── Primitive method table for native receivers ────────────────────────
+;; Returns the result, or the sentinel :unhandled if no primitive matches —
+;; in which case st-send falls back to doesNotUnderstand:.
+(define
+  st-primitive-send
+  (fn
+    (receiver selector args)
+    (let ((cls (st-class-of receiver)))
+      (cond
+        ((or (= cls "SmallInteger") (= cls "Float"))
+          (st-num-send receiver selector args))
+        ((or (= cls "String") (= cls "Symbol"))
+          (st-string-send receiver selector args))
+        ((= cls "True") (st-bool-send true selector args))
+        ((= cls "False") (st-bool-send false selector args))
+        ((= cls "UndefinedObject") (st-nil-send selector args))
+        ((= cls "Array") (st-array-send receiver selector args))
+        ((st-class-ref? receiver) (st-class-side-send receiver selector args))
+        (else :unhandled)))))
+
+(define
+  st-num-send
+  (fn
+    (n selector args)
+    (cond
+      ((= selector "+") (+ n (nth args 0)))
+      ((= selector "-") (- n (nth args 0)))
+      ((= selector "*") (* n (nth args 0)))
+      ((= selector "/") (/ n (nth args 0)))
+      ((= selector "//") (/ n (nth args 0)))
+      ((= selector "\\\\") (mod n (nth args 0)))
+      ((= selector "<") (< n (nth args 0)))
+      ((= selector ">") (> n (nth args 0)))
+      ((= selector "<=") (<= n (nth args 0)))
+      ((= selector ">=") (>= n (nth args 0)))
+      ((= selector "=") (= n (nth args 0)))
+      ((= selector "~=") (not (= n (nth args 0))))
+      ((= selector "==") (= n (nth args 0)))
+      ((= selector "~~") (not (= n (nth args 0))))
+      ((= selector "negated") (- 0 n))
+      ((= selector "abs") (if (< n 0) (- 0 n) n))
+      ((= selector "max:") (if (> n (nth args 0)) n (nth args 0)))
+      ((= selector "min:") (if (< n (nth args 0)) n (nth args 0)))
+      ((= selector "printString") (str n))
+      ((= selector "asString") (str n))
+      ((= selector "class")
+        (st-class-ref (st-class-of n)))
+      ((= selector "isNil") false)
+      ((= selector "notNil") true)
+      ((= selector "isZero") (= n 0))
+      ((= selector "between:and:")
+        (and (>= n (nth args 0)) (<= n (nth args 1))))
+      ((= selector "to:do:")
+        (let ((i n) (stop (nth args 0)) (block (nth args 1)))
+          (begin
+            (define
+              td-loop
+              (fn
+                ()
+                (when
+                  (<= i stop)
+                  (begin
+                    (st-block-apply block (list i))
+                    (set! i (+ i 1))
+                    (td-loop)))))
+            (td-loop)
+            n)))
+      ((= selector "timesRepeat:")
+        (let ((i 0) (block (nth args 0)))
+          (begin
+            (define
+              tr-loop
+              (fn
+                ()
+                (when
+                  (< i n)
+                  (begin
+                    (st-block-apply block (list))
+                    (set! i (+ i 1))
+                    (tr-loop)))))
+            (tr-loop)
+            n)))
+      (else :unhandled))))
+
+(define
+  st-string-send
+  (fn
+    (s selector args)
+    (cond
+      ((= selector ",") (str s (nth args 0)))
+      ((= selector "size") (len s))
+      ((= selector "=") (= s (nth args 0)))
+      ((= selector "~=") (not (= s (nth args 0))))
+      ((= selector "==") (= s (nth args 0)))
+      ((= selector "~~") (not (= s (nth args 0))))
+      ((= selector "isEmpty") (= (len s) 0))
+      ((= selector "notEmpty") (> (len s) 0))
+      ((= selector "printString") (str "'" s "'"))
+      ((= selector "asString") s)
+      ((= selector "asSymbol") (make-symbol (if (symbol? s) (str s) s)))
+      ((= selector "class") (st-class-ref (st-class-of s)))
+      ((= selector "isNil") false)
+      ((= selector "notNil") true)
+      (else :unhandled))))
+
+(define
+  st-bool-send
+  (fn
+    (b selector args)
+    (cond
+      ((= selector "not") (not b))
+      ((= selector "&") (and b (nth args 0)))
+      ((= selector "|") (or b (nth args 0)))
+      ((= selector "and:")
+        (cond (b (st-block-apply (nth args 0) (list))) (else false)))
+      ((= selector "or:")
+        (cond (b true) (else (st-block-apply (nth args 0) (list)))))
+      ((= selector "ifTrue:")
+        (cond (b (st-block-apply (nth args 0) (list))) (else nil)))
+      ((= selector "ifFalse:")
+        (cond (b nil) (else (st-block-apply (nth args 0) (list)))))
+      ((= selector "ifTrue:ifFalse:")
+        (cond
+          (b (st-block-apply (nth args 0) (list)))
+          (else (st-block-apply (nth args 1) (list)))))
+      ((= selector "ifFalse:ifTrue:")
+        (cond
+          (b (st-block-apply (nth args 1) (list)))
+          (else (st-block-apply (nth args 0) (list)))))
+      ((= selector "=") (= b (nth args 0)))
+      ((= selector "~=") (not (= b (nth args 0))))
+      ((= selector "==") (= b (nth args 0)))
+      ((= selector "printString") (if b "true" "false"))
+      ((= selector "class") (st-class-ref (if b "True" "False")))
+      ((= selector "isNil") false)
+      ((= selector "notNil") true)
+      (else :unhandled))))
+
+(define
+  st-nil-send
+  (fn
+    (selector args)
+    (cond
+      ((= selector "isNil") true)
+      ((= selector "notNil") false)
+      ((= selector "ifNil:") (st-block-apply (nth args 0) (list)))
+      ((= selector "ifNotNil:") nil)
+      ((= selector "ifNil:ifNotNil:") (st-block-apply (nth args 0) (list)))
+      ((= selector "ifNotNil:ifNil:") (st-block-apply (nth args 1) (list)))
+      ((= selector "=") (= nil (nth args 0)))
+      ((= selector "~=") (not (= nil (nth args 0))))
+      ((= selector "==") (= nil (nth args 0)))
+      ((= selector "printString") "nil")
+      ((= selector "class") (st-class-ref "UndefinedObject"))
+      (else :unhandled))))
+
+(define
+  st-array-send
+  (fn
+    (a selector args)
+    (cond
+      ((= selector "size") (len a))
+      ((= selector "at:")
+        ;; 1-indexed
+        (nth a (- (nth args 0) 1)))
+      ((= selector "at:put:")
+        (begin
+          (set-nth! a (- (nth args 0) 1) (nth args 1))
+          (nth args 1)))
+      ((= selector "first") (nth a 0))
+      ((= selector "last") (nth a (- (len a) 1)))
+      ((= selector "isEmpty") (= (len a) 0))
+      ((= selector "notEmpty") (> (len a) 0))
+      ((= selector "do:")
+        (begin
+          (for-each
+            (fn (e) (st-block-apply (nth args 0) (list e)))
+            a)
+          a))
+      ((= selector "collect:")
+        (map (fn (e) (st-block-apply (nth args 0) (list e))) a))
+      ((= selector "select:")
+        (filter (fn (e) (st-block-apply (nth args 0) (list e))) a))
+      ((= selector ",")
+        (let ((out (list)))
+          (begin
+            (for-each (fn (e) (append! out e)) a)
+            (for-each (fn (e) (append! out e)) (nth args 0))
+            out)))
+      ((= selector "=") (= a (nth args 0)))
+      ((= selector "==") (= a (nth args 0)))
+      ((= selector "printString")
+        (str "#(" (join " " (map (fn (e) (str e)) a)) ")"))
+      ((= selector "class") (st-class-ref "Array"))
+      ((= selector "isNil") false)
+      ((= selector "notNil") true)
+      (else :unhandled))))
+
+(define
+  st-class-side-send
+  (fn
+    (cref selector args)
+    (let ((name (get cref :name)))
+      (cond
+        ((= selector "new") (st-make-instance name))
+        ((= selector "name") name)
+        ((= selector "superclass")
+          (let ((s (st-class-superclass name)))
+            (cond ((= s nil) nil) (else (st-class-ref s)))))
+        ((= selector "printString") name)
+        ((= selector "class") (st-class-ref "Metaclass"))
+        ((= selector "==") (and (st-class-ref? (nth args 0))
+                                (= name (get (nth args 0) :name))))
+        ((= selector "=") (and (st-class-ref? (nth args 0))
+                                (= name (get (nth args 0) :name))))
+        ((= selector "isNil") false)
+        ((= selector "notNil") true)
+        (else :unhandled)))))
+
+;; Convenience: parse and evaluate a Smalltalk expression with no receiver.
+(define
+  smalltalk-eval
+  (fn
+    (src)
+    (let
+      ((ast (st-parse-expr src))
+        (frame (st-make-frame nil nil nil)))
+      (smalltalk-eval-ast ast frame))))
+
+;; Evaluate a sequence of statements at the top level.
+(define
+  smalltalk-eval-program
+  (fn
+    (src)
+    (let
+      ((ast (st-parse src)) (frame (st-make-frame nil nil nil)))
+      (begin
+        (when
+          (and (dict? ast) (has-key? ast :temps))
+          (for-each
+            (fn (t) (dict-set! (get frame :locals) t nil))
+            (get ast :temps)))
+        (let ((result (smalltalk-eval-ast ast frame)))
+          (cond
+            ((st-return-marker? result) (get result :value))
+            (else result)))))))

lib/smalltalk/parser.sx

@@ -0,0 +1,912 @@
+;; Smalltalk parser — produces an AST from the tokenizer's token stream.
+;;
+;; AST node shapes (dicts):
+;;   {:type "lit-int" :value N}                  integer
+;;   {:type "lit-float" :value F}                float
+;;   {:type "lit-string" :value S}               string
+;;   {:type "lit-char" :value C}                 character
+;;   {:type "lit-symbol" :value S}               symbol literal (#foo)
+;;   {:type "lit-array" :elements (list ...)}    literal array (#(1 2 #foo))
+;;   {:type "lit-byte-array" :elements (...)}    byte array (#[1 2 3])
+;;   {:type "lit-nil" } / "lit-true" / "lit-false"
+;;   {:type "ident" :name "x"}                   variable reference
+;;   {:type "self"} / "super" / "thisContext"    pseudo-variables
+;;   {:type "assign" :name "x" :expr E}          x := E
+;;   {:type "return" :expr E}                    ^ E
+;;   {:type "send" :receiver R :selector S :args (list ...)}
+;;   {:type "cascade" :receiver R :messages (list {:selector :args} ...)}
+;;   {:type "block" :params (list "a") :temps (list "t") :body (list expr)}
+;;   {:type "seq" :exprs (list ...)}             statement sequence
+;;   {:type "method" :selector S :params (list ...) :temps (list ...) :body (list ...) :pragmas (list ...)}
+;;
+;; A "chunk" / class-definition stream is parsed at a higher level (deferred).
+
+;; ── Chunk-stream reader ────────────────────────────────────────────────
+;; Pharo chunk format: chunks are separated by `!`. A doubled `!!` inside a
+;; chunk represents a single literal `!`. Returns list of chunk strings with
+;; surrounding whitespace trimmed.
+(define
+  st-read-chunks
+  (fn
+    (src)
+    (let
+      ((chunks (list))
+        (buf (list))
+        (pos 0)
+        (n (len src)))
+      (begin
+        (define
+          flush!
+          (fn
+            ()
+            (let
+              ((s (st-trim (join "" buf))))
+              (begin (append! chunks s) (set! buf (list))))))
+        (define
+          rc-loop
+          (fn
+            ()
+            (when
+              (< pos n)
+              (let
+                ((c (nth src pos)))
+                (cond
+                  ((= c "!")
+                    (cond
+                      ((and (< (+ pos 1) n) (= (nth src (+ pos 1)) "!"))
+                        (begin (append! buf "!") (set! pos (+ pos 2)) (rc-loop)))
+                      (else
+                        (begin (flush!) (set! pos (+ pos 1)) (rc-loop)))))
+                  (else
+                    (begin (append! buf c) (set! pos (+ pos 1)) (rc-loop))))))))
+        (rc-loop)
+        ;; trailing text without a closing `!` — preserve as a chunk
+        (when (> (len buf) 0) (flush!))
+        chunks))))
+
+(define
+  st-trim
+  (fn
+    (s)
+    (let
+      ((n (len s)) (i 0) (j 0))
+      (begin
+        (set! j n)
+        (define
+          tl-loop
+          (fn
+            ()
+            (when
+              (and (< i n) (st-trim-ws? (nth s i)))
+              (begin (set! i (+ i 1)) (tl-loop)))))
+        (tl-loop)
+        (define
+          tr-loop
+          (fn
+            ()
+            (when
+              (and (> j i) (st-trim-ws? (nth s (- j 1))))
+              (begin (set! j (- j 1)) (tr-loop)))))
+        (tr-loop)
+        (slice s i j)))))
+
+(define
+  st-trim-ws?
+  (fn (c) (or (= c " ") (= c "\t") (= c "\n") (= c "\r"))))
+
+;; Parse a chunk stream. Walks chunks and applies the Pharo file-in
+;; convention: a chunk that evaluates to "X methodsFor: 'cat'" or
+;; "X class methodsFor: 'cat'" enters a methods batch — subsequent chunks
+;; are method source until an empty chunk closes the batch.
+;;
+;; Returns list of entries:
+;;   {:kind "expr" :ast EXPR-AST}
+;;   {:kind "method" :class CLS :class-side? BOOL :category CAT :ast METHOD-AST}
+;;   {:kind "blank"}        (empty chunks outside a methods batch)
+;;   {:kind "end-methods"}  (empty chunk closing a methods batch)
+(define
+  st-parse-chunks
+  (fn
+    (src)
+    (let
+      ((chunks (st-read-chunks src))
+        (entries (list))
+        (mode "do-it")
+        (cls-name nil)
+        (class-side? false)
+        (category nil))
+      (begin
+        (for-each
+          (fn
+            (chunk)
+            (cond
+              ((= chunk "")
+                (cond
+                  ((= mode "methods")
+                    (begin
+                      (append! entries {:kind "end-methods"})
+                      (set! mode "do-it")
+                      (set! cls-name nil)
+                      (set! class-side? false)
+                      (set! category nil)))
+                  (else (append! entries {:kind "blank"}))))
+              ((= mode "methods")
+                (append!
+                  entries
+                  {:kind "method"
+                   :class cls-name
+                   :class-side? class-side?
+                   :category category
+                   :ast (st-parse-method chunk)}))
+              (else
+                (let
+                  ((ast (st-parse-expr chunk)))
+                  (begin
+                    (append! entries {:kind "expr" :ast ast})
+                    (let
+                      ((mf (st-detect-methods-for ast)))
+                      (when
+                        (not (= mf nil))
+                        (begin
+                          (set! mode "methods")
+                          (set! cls-name (get mf :class))
+                          (set! class-side? (get mf :class-side?))
+                          (set! category (get mf :category))))))))))
+          chunks)
+        entries))))
+
+;; Recognise `Foo methodsFor: 'cat'` (and related) as starting a methods batch.
+;; Returns nil if the AST doesn't look like one of these forms.
+(define
+  st-detect-methods-for
+  (fn
+    (ast)
+    (cond
+      ((not (= (get ast :type) "send")) nil)
+      ((not (st-is-methods-for-selector? (get ast :selector))) nil)
+      (else
+        (let
+          ((recv (get ast :receiver)) (args (get ast :args)))
+          (let
+            ((cat-arg (if (> (len args) 0) (nth args 0) nil)))
+            (let
+              ((category
+                 (cond
+                   ((= cat-arg nil) nil)
+                   ((= (get cat-arg :type) "lit-string") (get cat-arg :value))
+                   ((= (get cat-arg :type) "lit-symbol") (get cat-arg :value))
+                   (else nil))))
+              (cond
+                ((= (get recv :type) "ident")
+                  {:class (get recv :name)
+                   :class-side? false
+                   :category category})
+                ;; `Foo class methodsFor: 'cat'` — recv is a unary send `Foo class`
+                ((and
+                    (= (get recv :type) "send")
+                    (= (get recv :selector) "class")
+                    (= (get (get recv :receiver) :type) "ident"))
+                  {:class (get (get recv :receiver) :name)
+                   :class-side? true
+                   :category category})
+                (else nil)))))))))
+
+(define
+  st-is-methods-for-selector?
+  (fn
+    (sel)
+    (or
+      (= sel "methodsFor:")
+      (= sel "methodsFor:stamp:")
+      (= sel "category:"))))
+
+(define st-tok-type (fn (t) (if (= t nil) "eof" (get t :type))))
+
+(define st-tok-value (fn (t) (if (= t nil) nil (get t :value))))
+
+;; Parse a *single* Smalltalk expression from source.
+(define st-parse-expr (fn (src) (st-parse-with src "expr")))
+
+;; Parse a sequence of statements separated by '.'  Returns a {:type "seq"} node.
+(define st-parse (fn (src) (st-parse-with src "seq")))
+
+;; Parse a method body — `selector params | temps | body`.
+;; Only the "method header + body" form (no chunk delimiters).
+(define st-parse-method (fn (src) (st-parse-with src "method")))
+
+(define
+  st-parse-with
+  (fn
+    (src mode)
+    (let
+      ((tokens (st-tokenize src)) (idx 0) (tok-len 0))
+      (begin
+        (set! tok-len (len tokens))
+        (define peek-tok (fn () (nth tokens idx)))
+        (define
+          peek-tok-at
+          (fn (n) (if (< (+ idx n) tok-len) (nth tokens (+ idx n)) nil)))
+        (define advance-tok! (fn () (set! idx (+ idx 1))))
+        (define
+          at?
+          (fn
+            (type value)
+            (let
+              ((t (peek-tok)))
+              (and
+                (= (st-tok-type t) type)
+                (or (= value nil) (= (st-tok-value t) value))))))
+        (define at-type? (fn (type) (= (st-tok-type (peek-tok)) type)))
+        (define
+          consume!
+          (fn
+            (type value)
+            (if
+              (at? type value)
+              (let ((t (peek-tok))) (begin (advance-tok!) t))
+              (error
+                (str
+                  "st-parse: expected "
+                  type
+                  (if (= value nil) "" (str " '" value "'"))
+                  " got "
+                  (st-tok-type (peek-tok))
+                  " '"
+                  (st-tok-value (peek-tok))
+                  "' at idx "
+                  idx)))))
+
+        ;; ── Primary: atoms, paren'd expr, blocks, literal arrays, byte arrays.
+        (define
+          parse-primary
+          (fn
+            ()
+            (let
+              ((t (peek-tok)))
+              (let
+                ((ty (st-tok-type t)) (v (st-tok-value t)))
+                (cond
+                  ((= ty "number")
+                    (begin
+                      (advance-tok!)
+                      (cond
+                        ((number? v) {:type (if (integer? v) "lit-int" "lit-float") :value v})
+                        (else {:type "lit-int" :value v}))))
+                  ((= ty "string")
+                    (begin (advance-tok!) {:type "lit-string" :value v}))
+                  ((= ty "char")
+                    (begin (advance-tok!) {:type "lit-char" :value v}))
+                  ((= ty "symbol")
+                    (begin (advance-tok!) {:type "lit-symbol" :value v}))
+                  ((= ty "array-open") (parse-literal-array))
+                  ((= ty "byte-array-open") (parse-byte-array))
+                  ((= ty "lparen")
+                    (begin
+                      (advance-tok!)
+                      (let
+                        ((e (parse-expression)))
+                        (begin (consume! "rparen" nil) e))))
+                  ((= ty "lbracket") (parse-block))
+                  ((= ty "ident")
+                    (begin
+                      (advance-tok!)
+                      (cond
+                        ((= v "nil") {:type "lit-nil"})
+                        ((= v "true") {:type "lit-true"})
+                        ((= v "false") {:type "lit-false"})
+                        ((= v "self") {:type "self"})
+                        ((= v "super") {:type "super"})
+                        ((= v "thisContext") {:type "thisContext"})
+                        (else {:type "ident" :name v}))))
+                  ((= ty "binary")
+                    ;; Negative numeric literal: '-' immediately before a number.
+                    (cond
+                      ((and (= v "-") (= (st-tok-type (peek-tok-at 1)) "number"))
+                        (let
+                          ((n (st-tok-value (peek-tok-at 1))))
+                          (begin
+                            (advance-tok!)
+                            (advance-tok!)
+                            (cond
+                              ((dict? n) {:type "lit-int" :value n})
+                              ((integer? n) {:type "lit-int" :value (- 0 n)})
+                              (else {:type "lit-float" :value (- 0 n)})))))
+                      (else
+                        (error
+                          (str "st-parse: unexpected binary '" v "' at idx " idx)))))
+                  (else
+                    (error
+                      (str
+                        "st-parse: unexpected "
+                        ty
+                        " '"
+                        v
+                        "' at idx "
+                        idx))))))))
+
+        ;; #(elem elem ...) — elements are atoms or nested parenthesised arrays.
+        (define
+          parse-literal-array
+          (fn
+            ()
+            (let
+              ((items (list)))
+              (begin
+                (consume! "array-open" nil)
+                (define
+                  arr-loop
+                  (fn
+                    ()
+                    (cond
+                      ((at? "rparen" nil) (advance-tok!))
+                      (else
+                        (begin
+                          (append! items (parse-array-element))
+                          (arr-loop))))))
+                (arr-loop)
+                {:type "lit-array" :elements items}))))
+
+        ;; #[1 2 3]
+        (define
+          parse-byte-array
+          (fn
+            ()
+            (let
+              ((items (list)))
+              (begin
+                (consume! "byte-array-open" nil)
+                (define
+                  ba-loop
+                  (fn
+                    ()
+                    (cond
+                      ((at? "rbracket" nil) (advance-tok!))
+                      (else
+                        (let
+                          ((t (peek-tok)))
+                          (cond
+                            ((= (st-tok-type t) "number")
+                              (begin
+                                (advance-tok!)
+                                (append! items (st-tok-value t))
+                                (ba-loop)))
+                            (else
+                              (error
+                                (str
+                                  "st-parse: byte array expects number, got "
+                                  (st-tok-type t))))))))))
+                (ba-loop)
+                {:type "lit-byte-array" :elements items}))))
+
+        ;; Inside a literal array: bare idents become symbols, nested (...) is a sub-array.
+        (define
+          parse-array-element
+          (fn
+            ()
+            (let
+              ((t (peek-tok)))
+              (let
+                ((ty (st-tok-type t)) (v (st-tok-value t)))
+                (cond
+                  ((= ty "number") (begin (advance-tok!) {:type "lit-int" :value v}))
+                  ((= ty "string") (begin (advance-tok!) {:type "lit-string" :value v}))
+                  ((= ty "char") (begin (advance-tok!) {:type "lit-char" :value v}))
+                  ((= ty "symbol") (begin (advance-tok!) {:type "lit-symbol" :value v}))
+                  ((= ty "ident")
+                    (begin
+                      (advance-tok!)
+                      (cond
+                        ((= v "nil") {:type "lit-nil"})
+                        ((= v "true") {:type "lit-true"})
+                        ((= v "false") {:type "lit-false"})
+                        (else {:type "lit-symbol" :value v}))))
+                  ((= ty "keyword") (begin (advance-tok!) {:type "lit-symbol" :value v}))
+                  ((= ty "binary") (begin (advance-tok!) {:type "lit-symbol" :value v}))
+                  ((= ty "lparen")
+                    (let ((items (list)))
+                      (begin
+                        (advance-tok!)
+                        (define
+                          sub-loop
+                          (fn
+                            ()
+                            (cond
+                              ((at? "rparen" nil) (advance-tok!))
+                              (else
+                                (begin (append! items (parse-array-element)) (sub-loop))))))
+                        (sub-loop)
+                        {:type "lit-array" :elements items})))
+                  ((= ty "array-open") (parse-literal-array))
+                  ((= ty "byte-array-open") (parse-byte-array))
+                  (else
+                    (error
+                      (str "st-parse: bad literal-array element " ty " '" v "'"))))))))
+
+        ;; [:a :b | | t1 t2 | body. body. ...]
+        (define
+          parse-block
+          (fn
+            ()
+            (begin
+              (consume! "lbracket" nil)
+              (let
+                ((params (list)) (temps (list)))
+                (begin
+                  ;; Block params
+                  (define
+                    p-loop
+                    (fn
+                      ()
+                      (when
+                        (at? "colon" nil)
+                        (begin
+                          (advance-tok!)
+                          (let
+                            ((t (consume! "ident" nil)))
+                            (begin
+                              (append! params (st-tok-value t))
+                              (p-loop)))))))
+                  (p-loop)
+                  (when (> (len params) 0) (consume! "bar" nil))
+                  ;; Block temps: | t1 t2 |
+                  (when
+                    (and
+                      (at? "bar" nil)
+                      ;; Not `|` followed immediately by binary content — the only
+                      ;; legitimate `|` inside a block here is the temp delimiter.
+                      true)
+                    (begin
+                      (advance-tok!)
+                      (define
+                        t-loop
+                        (fn
+                          ()
+                          (when
+                            (at? "ident" nil)
+                            (let
+                              ((t (peek-tok)))
+                              (begin
+                                (advance-tok!)
+                                (append! temps (st-tok-value t))
+                                (t-loop))))))
+                      (t-loop)
+                      (consume! "bar" nil)))
+                  ;; Body: statements terminated by `.` or `]`
+                  (let
+                    ((body (parse-statements "rbracket")))
+                    (begin
+                      (consume! "rbracket" nil)
+                      {:type "block" :params params :temps temps :body body})))))))
+
+        ;; Parse statements up to a closing token (rbracket or eof). Returns list.
+        (define
+          parse-statements
+          (fn
+            (terminator)
+            (let
+              ((stmts (list)))
+              (begin
+                (define
+                  s-loop
+                  (fn
+                    ()
+                    (cond
+                      ((at-type? terminator) nil)
+                      ((at-type? "eof") nil)
+                      (else
+                        (begin
+                          (append! stmts (parse-statement))
+                          ;; consume optional period(s)
+                          (define
+                            dot-loop
+                            (fn
+                              ()
+                              (when
+                                (at? "period" nil)
+                                (begin (advance-tok!) (dot-loop)))))
+                          (dot-loop)
+                          (s-loop))))))
+                (s-loop)
+                stmts))))
+
+        ;; Statement: ^expr  |  ident := expr  |  expr
+        (define
+          parse-statement
+          (fn
+            ()
+            (cond
+              ((at? "caret" nil)
+                (begin
+                  (advance-tok!)
+                  {:type "return" :expr (parse-expression)}))
+              ((and (at-type? "ident") (= (st-tok-type (peek-tok-at 1)) "assign"))
+                (let
+                  ((name-tok (peek-tok)))
+                  (begin
+                    (advance-tok!)
+                    (advance-tok!)
+                    {:type "assign"
+                     :name (st-tok-value name-tok)
+                     :expr (parse-expression)})))
+              (else (parse-expression)))))
+
+        ;; Top-level expression. Assignment (right-associative chain) sits at
+        ;; the top; cascade is below.
+        (define
+          parse-expression
+          (fn
+            ()
+            (cond
+              ((and (at-type? "ident") (= (st-tok-type (peek-tok-at 1)) "assign"))
+                (let
+                  ((name-tok (peek-tok)))
+                  (begin
+                    (advance-tok!)
+                    (advance-tok!)
+                    {:type "assign"
+                     :name (st-tok-value name-tok)
+                     :expr (parse-expression)})))
+              (else (parse-cascade)))))
+
+        (define
+          parse-cascade
+          (fn
+            ()
+            (let
+              ((head (parse-keyword-message)))
+              (cond
+                ((at? "semi" nil)
+                  (let
+                    ((receiver (cascade-receiver head))
+                      (first-msg (cascade-first-message head))
+                      (msgs (list)))
+                    (begin
+                      (append! msgs first-msg)
+                      (define
+                        c-loop
+                        (fn
+                          ()
+                          (when
+                            (at? "semi" nil)
+                            (begin
+                              (advance-tok!)
+                              (append! msgs (parse-cascade-message))
+                              (c-loop)))))
+                      (c-loop)
+                      {:type "cascade" :receiver receiver :messages msgs})))
+                (else head)))))
+
+        ;; Extract the receiver from a head send so cascades share it.
+        (define
+          cascade-receiver
+          (fn
+            (head)
+            (cond
+              ((= (get head :type) "send") (get head :receiver))
+              (else head))))
+
+        (define
+          cascade-first-message
+          (fn
+            (head)
+            (cond
+              ((= (get head :type) "send")
+                {:selector (get head :selector) :args (get head :args)})
+              (else
+                ;; Shouldn't happen — cascade requires at least one prior message.
+                (error "st-parse: cascade with no prior message")))))
+
+        ;; Subsequent cascade message (after the `;`): unary | binary | keyword
+        (define
+          parse-cascade-message
+          (fn
+            ()
+            (cond
+              ((at-type? "ident")
+                (let ((t (peek-tok)))
+                  (begin
+                    (advance-tok!)
+                    {:selector (st-tok-value t) :args (list)})))
+              ((at-type? "binary")
+                (let ((t (peek-tok)))
+                  (begin
+                    (advance-tok!)
+                    (let
+                      ((arg (parse-unary-message)))
+                      {:selector (st-tok-value t) :args (list arg)}))))
+              ((at-type? "keyword")
+                (let
+                  ((sel-parts (list)) (args (list)))
+                  (begin
+                    (define
+                      kw-loop
+                      (fn
+                        ()
+                        (when
+                          (at-type? "keyword")
+                          (let ((t (peek-tok)))
+                            (begin
+                              (advance-tok!)
+                              (append! sel-parts (st-tok-value t))
+                              (append! args (parse-binary-message))
+                              (kw-loop))))))
+                    (kw-loop)
+                    {:selector (join "" sel-parts) :args args})))
+              (else
+                (error
+                  (str "st-parse: bad cascade message at idx " idx))))))
+
+        ;; Keyword message: <binary> (kw <binary>)+
+        (define
+          parse-keyword-message
+          (fn
+            ()
+            (let
+              ((receiver (parse-binary-message)))
+              (cond
+                ((at-type? "keyword")
+                  (let
+                    ((sel-parts (list)) (args (list)))
+                    (begin
+                      (define
+                        kw-loop
+                        (fn
+                          ()
+                          (when
+                            (at-type? "keyword")
+                            (let ((t (peek-tok)))
+                              (begin
+                                (advance-tok!)
+                                (append! sel-parts (st-tok-value t))
+                                (append! args (parse-binary-message))
+                                (kw-loop))))))
+                      (kw-loop)
+                      {:type "send"
+                       :receiver receiver
+                       :selector (join "" sel-parts)
+                       :args args})))
+                (else receiver)))))
+
+        ;; Binary message: <unary> (binop <unary>)*
+        (define
+          parse-binary-message
+          (fn
+            ()
+            (let
+              ((receiver (parse-unary-message)))
+              (begin
+                (define
+                  b-loop
+                  (fn
+                    ()
+                    (when
+                      (at-type? "binary")
+                      (let ((t (peek-tok)))
+                        (begin
+                          (advance-tok!)
+                          (let
+                            ((arg (parse-unary-message)))
+                            (set!
+                              receiver
+                              {:type "send"
+                               :receiver receiver
+                               :selector (st-tok-value t)
+                               :args (list arg)}))
+                          (b-loop))))))
+                (b-loop)
+                receiver))))
+
+        ;; Unary message: <primary> ident*  (ident NOT followed by ':')
+        (define
+          parse-unary-message
+          (fn
+            ()
+            (let
+              ((receiver (parse-primary)))
+              (begin
+                (define
+                  u-loop
+                  (fn
+                    ()
+                    (when
+                      (and
+                        (at-type? "ident")
+                        (let
+                          ((nxt (peek-tok-at 1)))
+                          (not (= (st-tok-type nxt) "assign"))))
+                      (let ((t (peek-tok)))
+                        (begin
+                          (advance-tok!)
+                          (set!
+                            receiver
+                            {:type "send"
+                             :receiver receiver
+                             :selector (st-tok-value t)
+                             :args (list)})
+                          (u-loop))))))
+                (u-loop)
+                receiver))))
+
+        ;; Parse a single pragma: `<keyword: literal (keyword: literal)* >`
+        ;; Returns {:selector "primitive:" :args (list literal-asts)}.
+        (define
+          parse-pragma
+          (fn
+            ()
+            (begin
+              (consume! "binary" "<")
+              (let
+                ((sel-parts (list)) (args (list)))
+                (begin
+                  (define
+                    pr-loop
+                    (fn
+                      ()
+                      (when
+                        (at-type? "keyword")
+                        (let ((t (peek-tok)))
+                          (begin
+                            (advance-tok!)
+                            (append! sel-parts (st-tok-value t))
+                            (append! args (parse-pragma-arg))
+                            (pr-loop))))))
+                  (pr-loop)
+                  (consume! "binary" ">")
+                  {:selector (join "" sel-parts) :args args})))))
+
+        ;; Pragma arguments are literals only.
+        (define
+          parse-pragma-arg
+          (fn
+            ()
+            (let
+              ((t (peek-tok)))
+              (let
+                ((ty (st-tok-type t)) (v (st-tok-value t)))
+                (cond
+                  ((= ty "number")
+                    (begin
+                      (advance-tok!)
+                      {:type (if (integer? v) "lit-int" "lit-float") :value v}))
+                  ((= ty "string") (begin (advance-tok!) {:type "lit-string" :value v}))
+                  ((= ty "char") (begin (advance-tok!) {:type "lit-char" :value v}))
+                  ((= ty "symbol") (begin (advance-tok!) {:type "lit-symbol" :value v}))
+                  ((= ty "ident")
+                    (begin
+                      (advance-tok!)
+                      (cond
+                        ((= v "nil") {:type "lit-nil"})
+                        ((= v "true") {:type "lit-true"})
+                        ((= v "false") {:type "lit-false"})
+                        (else (error (str "st-parse: pragma arg must be literal, got ident " v))))))
+                  ((and (= ty "binary") (= v "-")
+                        (= (st-tok-type (peek-tok-at 1)) "number"))
+                    (let ((n (st-tok-value (peek-tok-at 1))))
+                      (begin
+                        (advance-tok!)
+                        (advance-tok!)
+                        {:type (if (integer? n) "lit-int" "lit-float")
+                         :value (- 0 n)})))
+                  (else
+                    (error
+                      (str "st-parse: pragma arg must be literal, got " ty))))))))
+
+        ;; Method header: unary | binary arg | (kw arg)+
+        (define
+          parse-method
+          (fn
+            ()
+            (let
+              ((sel "")
+                (params (list))
+                (temps (list))
+                (pragmas (list))
+                (body (list)))
+              (begin
+                (cond
+                  ;; Unary header
+                  ((at-type? "ident")
+                    (let ((t (peek-tok)))
+                      (begin (advance-tok!) (set! sel (st-tok-value t)))))
+                  ;; Binary header: binop ident
+                  ((at-type? "binary")
+                    (let ((t (peek-tok)))
+                      (begin
+                        (advance-tok!)
+                        (set! sel (st-tok-value t))
+                        (let ((p (consume! "ident" nil)))
+                          (append! params (st-tok-value p))))))
+                  ;; Keyword header: (kw ident)+
+                  ((at-type? "keyword")
+                    (let ((sel-parts (list)))
+                      (begin
+                        (define
+                          kh-loop
+                          (fn
+                            ()
+                            (when
+                              (at-type? "keyword")
+                              (let ((t (peek-tok)))
+                                (begin
+                                  (advance-tok!)
+                                  (append! sel-parts (st-tok-value t))
+                                  (let ((p (consume! "ident" nil)))
+                                    (append! params (st-tok-value p)))
+                                  (kh-loop))))))
+                        (kh-loop)
+                        (set! sel (join "" sel-parts)))))
+                  (else
+                    (error
+                      (str
+                        "st-parse-method: expected selector header, got "
+                        (st-tok-type (peek-tok))))))
+                ;; Pragmas and temps may appear in either order. Allow many
+                ;; pragmas; one temps section.
+                (define
+                  parse-temps!
+                  (fn
+                    ()
+                    (begin
+                      (advance-tok!)
+                      (define
+                        th-loop
+                        (fn
+                          ()
+                          (when
+                            (at-type? "ident")
+                            (let ((t (peek-tok)))
+                              (begin
+                                (advance-tok!)
+                                (append! temps (st-tok-value t))
+                                (th-loop))))))
+                      (th-loop)
+                      (consume! "bar" nil))))
+                (define
+                  pt-loop
+                  (fn
+                    ()
+                    (cond
+                      ((and
+                          (at? "binary" "<")
+                          (= (st-tok-type (peek-tok-at 1)) "keyword"))
+                        (begin (append! pragmas (parse-pragma)) (pt-loop)))
+                      ((and (at? "bar" nil) (= (len temps) 0))
+                        (begin (parse-temps!) (pt-loop)))
+                      (else nil))))
+                (pt-loop)
+                ;; Body statements
+                (set! body (parse-statements "eof"))
+                {:type "method"
+                 :selector sel
+                 :params params
+                 :temps temps
+                 :pragmas pragmas
+                 :body body}))))
+
+        ;; Top-level program: optional temp declaration, then statements
+        ;; separated by '.'. Pharo workspace-style scripts allow
+        ;; `| temps | body...` at the top level.
+        (cond
+          ((= mode "expr") (parse-expression))
+          ((= mode "method") (parse-method))
+          (else
+            (let ((temps (list)))
+              (begin
+                (when
+                  (at? "bar" nil)
+                  (begin
+                    (advance-tok!)
+                    (define
+                      tt-loop
+                      (fn
+                        ()
+                        (when
+                          (at-type? "ident")
+                          (let ((t (peek-tok)))
+                            (begin
+                              (advance-tok!)
+                              (append! temps (st-tok-value t))
+                              (tt-loop))))))
+                    (tt-loop)
+                    (consume! "bar" nil)))
+                {:type "seq" :temps temps :exprs (parse-statements "eof")}))))))))

lib/smalltalk/runtime.sx

@@ -0,0 +1,397 @@
+;; Smalltalk runtime — class table, bootstrap hierarchy, type→class mapping,
+;; instance construction. Method dispatch / eval-ast live in a later layer.
+;;
+;; Class record shape:
+;;   {:name "Foo"
+;;    :superclass "Object"          ; or nil for Object itself
+;;    :ivars (list "x" "y")          ; instance variable names declared on this class
+;;    :methods   (dict selector→method-record)
+;;    :class-methods (dict selector→method-record)}
+;;
+;; A method record is the AST returned by st-parse-method, plus a :defining-class
+;; field so super-sends can resolve from the right place. (Methods are registered
+;; via runtime helpers that fill the field.)
+;;
+;; The class table is a single dict keyed by class name. Bootstrap installs the
+;; canonical hierarchy. Test code resets it via (st-bootstrap-classes!).
+
+(define st-class-table {})
+
+;; ── Method-lookup cache ────────────────────────────────────────────────
+;; Cache keys are "class|selector|side"; side is "i" (instance) or "c" (class).
+;; Misses are stored as the sentinel :not-found so we don't re-walk for
+;; every doesNotUnderstand call.
+(define st-method-cache {})
+(define st-method-cache-hits 0)
+(define st-method-cache-misses 0)
+
+(define
+  st-method-cache-clear!
+  (fn () (set! st-method-cache {})))
+
+(define
+  st-method-cache-key
+  (fn (cls sel class-side?) (str cls "|" sel "|" (if class-side? "c" "i"))))
+
+(define
+  st-method-cache-stats
+  (fn
+    ()
+    {:hits st-method-cache-hits
+     :misses st-method-cache-misses
+     :size (len (keys st-method-cache))}))
+
+(define
+  st-method-cache-reset-stats!
+  (fn ()
+    (begin
+      (set! st-method-cache-hits 0)
+      (set! st-method-cache-misses 0))))
+
+(define
+  st-class-table-clear!
+  (fn ()
+    (begin
+      (set! st-class-table {})
+      (st-method-cache-clear!))))
+
+(define
+  st-class-define!
+  (fn
+    (name superclass ivars)
+    (begin
+      (set!
+        st-class-table
+        (assoc
+          st-class-table
+          name
+          {:name name
+           :superclass superclass
+           :ivars ivars
+           :methods {}
+           :class-methods {}}))
+      ;; A redefined class can invalidate any cache entries that walked
+      ;; through its old position in the chain. Cheap + correct: drop all.
+      (st-method-cache-clear!)
+      name)))
+
+(define
+  st-class-get
+  (fn (name) (if (has-key? st-class-table name) (get st-class-table name) nil)))
+
+(define
+  st-class-exists?
+  (fn (name) (has-key? st-class-table name)))
+
+(define
+  st-class-superclass
+  (fn
+    (name)
+    (let
+      ((c (st-class-get name)))
+      (cond ((= c nil) nil) (else (get c :superclass))))))
+
+;; Walk class chain root-to-leaf? No, follow superclass chain leaf-to-root.
+;; Returns list of class names starting at `name` and ending with the root.
+(define
+  st-class-chain
+  (fn
+    (name)
+    (let ((acc (list)) (cur name))
+      (begin
+        (define
+          ch-loop
+          (fn
+            ()
+            (when
+              (and (not (= cur nil)) (st-class-exists? cur))
+              (begin
+                (append! acc cur)
+                (set! cur (st-class-superclass cur))
+                (ch-loop)))))
+        (ch-loop)
+        acc))))
+
+;; Inherited + own ivars in declaration order from root to leaf.
+(define
+  st-class-all-ivars
+  (fn
+    (name)
+    (let ((chain (reverse (st-class-chain name))) (out (list)))
+      (begin
+        (for-each
+          (fn
+            (cn)
+            (let
+              ((c (st-class-get cn)))
+              (when
+                (not (= c nil))
+                (for-each (fn (iv) (append! out iv)) (get c :ivars)))))
+          chain)
+        out))))
+
+;; Method install. The defining-class field is stamped on the method record
+;; so super-sends look up from the right point in the chain.
+(define
+  st-class-add-method!
+  (fn
+    (cls-name selector method-ast)
+    (let
+      ((cls (st-class-get cls-name)))
+      (cond
+        ((= cls nil) (error (str "st-class-add-method!: unknown class " cls-name)))
+        (else
+          (let
+            ((m (assoc method-ast :defining-class cls-name)))
+            (begin
+              (set!
+                st-class-table
+                (assoc
+                  st-class-table
+                  cls-name
+                  (assoc
+                    cls
+                    :methods
+                    (assoc (get cls :methods) selector m))))
+              (st-method-cache-clear!)
+              selector)))))))
+
+(define
+  st-class-add-class-method!
+  (fn
+    (cls-name selector method-ast)
+    (let
+      ((cls (st-class-get cls-name)))
+      (cond
+        ((= cls nil) (error (str "st-class-add-class-method!: unknown class " cls-name)))
+        (else
+          (let
+            ((m (assoc method-ast :defining-class cls-name)))
+            (begin
+              (set!
+                st-class-table
+                (assoc
+                  st-class-table
+                  cls-name
+                  (assoc
+                    cls
+                    :class-methods
+                    (assoc (get cls :class-methods) selector m))))
+              (st-method-cache-clear!)
+              selector)))))))
+
+;; Remove a method from a class (instance side). Mostly for tests; runtime
+;; reflection in Phase 4 will use the same primitive.
+(define
+  st-class-remove-method!
+  (fn
+    (cls-name selector)
+    (let ((cls (st-class-get cls-name)))
+      (cond
+        ((= cls nil) (error (str "st-class-remove-method!: unknown class " cls-name)))
+        (else
+          (let ((md (get cls :methods)))
+            (cond
+              ((not (has-key? md selector)) false)
+              (else
+                (let ((new-md {}))
+                  (begin
+                    (for-each
+                      (fn (k)
+                        (when (not (= k selector))
+                          (dict-set! new-md k (get md k))))
+                      (keys md))
+                    (set!
+                      st-class-table
+                      (assoc
+                        st-class-table
+                        cls-name
+                        (assoc cls :methods new-md)))
+                    (st-method-cache-clear!)
+                    true))))))))))
+
+;; Walk-only lookup. Returns the method record (with :defining-class) or nil.
+;; class-side? = true searches :class-methods, false searches :methods.
+(define
+  st-method-lookup-walk
+  (fn
+    (cls-name selector class-side?)
+    (let
+      ((found nil))
+      (begin
+        (define
+          ml-loop
+          (fn
+            (cur)
+            (when
+              (and (= found nil) (not (= cur nil)) (st-class-exists? cur))
+              (let
+                ((c (st-class-get cur)))
+                (let
+                  ((dict (if class-side? (get c :class-methods) (get c :methods))))
+                  (cond
+                    ((has-key? dict selector) (set! found (get dict selector)))
+                    (else (ml-loop (get c :superclass)))))))))
+        (ml-loop cls-name)
+        found))))
+
+;; Cached lookup. Misses are stored as :not-found so doesNotUnderstand paths
+;; don't re-walk on every send.
+(define
+  st-method-lookup
+  (fn
+    (cls-name selector class-side?)
+    (let ((key (st-method-cache-key cls-name selector class-side?)))
+      (cond
+        ((has-key? st-method-cache key)
+          (begin
+            (set! st-method-cache-hits (+ st-method-cache-hits 1))
+            (let ((v (get st-method-cache key)))
+              (cond ((= v :not-found) nil) (else v)))))
+        (else
+          (begin
+            (set! st-method-cache-misses (+ st-method-cache-misses 1))
+            (let ((found (st-method-lookup-walk cls-name selector class-side?)))
+              (begin
+                (set!
+                  st-method-cache
+                  (assoc
+                    st-method-cache
+                    key
+                    (cond ((= found nil) :not-found) (else found))))
+                found))))))))
+
+;; SX value → Smalltalk class name. Native types are not boxed.
+(define
+  st-class-of
+  (fn
+    (v)
+    (cond
+      ((= v nil) "UndefinedObject")
+      ((= v true) "True")
+      ((= v false) "False")
+      ((integer? v) "SmallInteger")
+      ((number? v) "Float")
+      ((string? v) "String")
+      ((symbol? v) "Symbol")
+      ((list? v) "Array")
+      ((and (dict? v) (has-key? v :type) (= (get v :type) "st-instance"))
+        (get v :class))
+      ((and (dict? v) (has-key? v :type) (= (get v :type) "block"))
+        "BlockClosure")
+      ((and (dict? v) (has-key? v :st-block?) (get v :st-block?))
+        "BlockClosure")
+      ((dict? v) "Dictionary")
+      ((lambda? v) "BlockClosure")
+      (else "Object"))))
+
+;; Construct a fresh instance of cls-name. Ivars (own + inherited) start as nil.
+(define
+  st-make-instance
+  (fn
+    (cls-name)
+    (cond
+      ((not (st-class-exists? cls-name))
+        (error (str "st-make-instance: unknown class " cls-name)))
+      (else
+        (let
+          ((iv-names (st-class-all-ivars cls-name)) (ivars {}))
+          (begin
+            (for-each (fn (n) (set! ivars (assoc ivars n nil))) iv-names)
+            {:type "st-instance" :class cls-name :ivars ivars}))))))
+
+(define
+  st-instance?
+  (fn
+    (v)
+    (and (dict? v) (has-key? v :type) (= (get v :type) "st-instance"))))
+
+(define
+  st-iv-get
+  (fn
+    (inst name)
+    (let ((ivs (get inst :ivars)))
+      (if (has-key? ivs name) (get ivs name) nil))))
+
+(define
+  st-iv-set!
+  (fn
+    (inst name value)
+    (let
+      ((new-ivars (assoc (get inst :ivars) name value)))
+      (assoc inst :ivars new-ivars))))
+
+;; Inherits-from check: is `descendant` either equal to `ancestor` or a subclass?
+(define
+  st-class-inherits-from?
+  (fn
+    (descendant ancestor)
+    (let ((found false) (cur descendant))
+      (begin
+        (define
+          ih-loop
+          (fn
+            ()
+            (when
+              (and (not found) (not (= cur nil)) (st-class-exists? cur))
+              (cond
+                ((= cur ancestor) (set! found true))
+                (else
+                  (begin
+                    (set! cur (st-class-superclass cur))
+                    (ih-loop)))))))
+        (ih-loop)
+        found))))
+
+;; Bootstrap the canonical class hierarchy. Reset and rebuild.
+(define
+  st-bootstrap-classes!
+  (fn
+    ()
+    (begin
+      (st-class-table-clear!)
+      ;; Root
+      (st-class-define! "Object" nil (list))
+      ;; Class side machinery
+      (st-class-define! "Behavior" "Object" (list "superclass" "methodDict" "format"))
+      (st-class-define! "ClassDescription" "Behavior" (list "instanceVariables" "organization"))
+      (st-class-define! "Class" "ClassDescription" (list "name" "subclasses"))
+      (st-class-define! "Metaclass" "ClassDescription" (list "thisClass"))
+      ;; Pseudo-variable types
+      (st-class-define! "UndefinedObject" "Object" (list))
+      (st-class-define! "Boolean" "Object" (list))
+      (st-class-define! "True" "Boolean" (list))
+      (st-class-define! "False" "Boolean" (list))
+      ;; Magnitudes
+      (st-class-define! "Magnitude" "Object" (list))
+      (st-class-define! "Number" "Magnitude" (list))
+      (st-class-define! "Integer" "Number" (list))
+      (st-class-define! "SmallInteger" "Integer" (list))
+      (st-class-define! "LargePositiveInteger" "Integer" (list))
+      (st-class-define! "Float" "Number" (list))
+      (st-class-define! "Character" "Magnitude" (list "value"))
+      ;; Collections
+      (st-class-define! "Collection" "Object" (list))
+      (st-class-define! "SequenceableCollection" "Collection" (list))
+      (st-class-define! "ArrayedCollection" "SequenceableCollection" (list))
+      (st-class-define! "Array" "ArrayedCollection" (list))
+      (st-class-define! "String" "ArrayedCollection" (list))
+      (st-class-define! "Symbol" "String" (list))
+      (st-class-define! "OrderedCollection" "SequenceableCollection" (list "array" "firstIndex" "lastIndex"))
+      (st-class-define! "Dictionary" "Collection" (list))
+      ;; Blocks / contexts
+      (st-class-define! "BlockClosure" "Object" (list))
+      ;; Reflection support — Message holds the selector/args for a DNU send.
+      (st-class-define! "Message" "Object" (list "selector" "arguments"))
+      (st-class-add-method! "Message" "selector"
+        (st-parse-method "selector ^ selector"))
+      (st-class-add-method! "Message" "arguments"
+        (st-parse-method "arguments ^ arguments"))
+      (st-class-add-method! "Message" "selector:"
+        (st-parse-method "selector: aSym selector := aSym"))
+      (st-class-add-method! "Message" "arguments:"
+        (st-parse-method "arguments: anArray arguments := anArray"))
+      "ok")))
+
+;; Initialise on load. Tests can re-bootstrap to reset state.
+(st-bootstrap-classes!)

lib/smalltalk/test.sh

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# Fast Smalltalk-on-SX test runner — pipes directly to sx_server.exe.
+# Mirrors lib/haskell/test.sh.
+#
+# Usage:
+#   bash lib/smalltalk/test.sh                     # run all tests
+#   bash lib/smalltalk/test.sh -v                  # verbose
+#   bash lib/smalltalk/test.sh tests/tokenize.sx   # run one file
+
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+SX_SERVER="hosts/ocaml/_build/default/bin/sx_server.exe"
+if [ ! -x "$SX_SERVER" ]; then
+  MAIN_ROOT=$(git worktree list | head -1 | awk '{print $1}')
+  if [ -x "$MAIN_ROOT/$SX_SERVER" ]; then
+    SX_SERVER="$MAIN_ROOT/$SX_SERVER"
+  else
+    echo "ERROR: sx_server.exe not found. Run: cd hosts/ocaml && dune build"
+    exit 1
+  fi
+fi
+
+VERBOSE=""
+FILES=()
+for arg in "$@"; do
+  case "$arg" in
+    -v|--verbose) VERBOSE=1 ;;
+    *) FILES+=("$arg") ;;
+  esac
+done
+
+if [ ${#FILES[@]} -eq 0 ]; then
+  # tokenize.sx must load first — it defines the st-test helpers reused by
+  # subsequent test files. Sort enforces this lexicographically.
+  mapfile -t FILES < <(find lib/smalltalk/tests -maxdepth 2 -name '*.sx' | sort)
+fi
+
+TOTAL_PASS=0
+TOTAL_FAIL=0
+FAILED_FILES=()
+
+for FILE in "${FILES[@]}"; do
+  [ -f "$FILE" ] || { echo "skip $FILE (not found)"; continue; }
+  TMPFILE=$(mktemp)
+  if [ "$(basename "$FILE")" = "tokenize.sx" ]; then
+    cat > "$TMPFILE" <<EPOCHS
+(epoch 1)
+(load "lib/smalltalk/tokenizer.sx")
+(epoch 2)
+(load "$FILE")
+(epoch 3)
+(eval "(list st-test-pass st-test-fail)")
+EPOCHS
+  else
+    cat > "$TMPFILE" <<EPOCHS
+(epoch 1)
+(load "lib/smalltalk/tokenizer.sx")
+(epoch 2)
+(load "lib/smalltalk/parser.sx")
+(epoch 3)
+(load "lib/smalltalk/runtime.sx")
+(epoch 4)
+(load "lib/smalltalk/eval.sx")
+(epoch 5)
+(load "lib/smalltalk/tests/tokenize.sx")
+(epoch 6)
+(load "$FILE")
+(epoch 7)
+(eval "(list st-test-pass st-test-fail)")
+EPOCHS
+  fi
+
+  OUTPUT=$(timeout 60 "$SX_SERVER" < "$TMPFILE" 2>&1 || true)
+  rm -f "$TMPFILE"
+
+  # Final epoch's value: either (ok N (P F)) on one line or
+  # (ok-len N M)\n(P F) where the value is on the following line.
+  LINE=$(echo "$OUTPUT" | awk '/^\(ok-len [0-9]+ / {getline; print}' | tail -1)
+  if [ -z "$LINE" ]; then
+    LINE=$(echo "$OUTPUT" | grep -E '^\(ok [0-9]+ \([0-9]+ [0-9]+\)\)' | tail -1 \
+            | sed -E 's/^\(ok [0-9]+ //; s/\)$//')
+  fi
+  if [ -z "$LINE" ]; then
+    echo "X $FILE: could not extract summary"
+    echo "$OUTPUT" | tail -30
+    TOTAL_FAIL=$((TOTAL_FAIL + 1))
+    FAILED_FILES+=("$FILE")
+    continue
+  fi
+  P=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\1/')
+  F=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\2/')
+  TOTAL_PASS=$((TOTAL_PASS + P))
+  TOTAL_FAIL=$((TOTAL_FAIL + F))
+  if [ "$F" -gt 0 ]; then
+    FAILED_FILES+=("$FILE")
+    printf 'X %-40s %d/%d\n' "$FILE" "$P" "$((P+F))"
+    TMPFILE2=$(mktemp)
+    if [ "$(basename "$FILE")" = "tokenize.sx" ]; then
+      cat > "$TMPFILE2" <<EPOCHS
+(epoch 1)
+(load "lib/smalltalk/tokenizer.sx")
+(epoch 2)
+(load "$FILE")
+(epoch 3)
+(eval "(map (fn (f) (get f :name)) st-test-fails)")
+EPOCHS
+    else
+      cat > "$TMPFILE2" <<EPOCHS
+(epoch 1)
+(load "lib/smalltalk/tokenizer.sx")
+(epoch 2)
+(load "lib/smalltalk/parser.sx")
+(epoch 3)
+(load "lib/smalltalk/runtime.sx")
+(epoch 4)
+(load "lib/smalltalk/eval.sx")
+(epoch 5)
+(load "lib/smalltalk/tests/tokenize.sx")
+(epoch 6)
+(load "$FILE")
+(epoch 7)
+(eval "(map (fn (f) (get f :name)) st-test-fails)")
+EPOCHS
+    fi
+    FAILS=$(timeout 60 "$SX_SERVER" < "$TMPFILE2" 2>&1 | grep -E '^\(ok [0-9]+ \(' | tail -1 || true)
+    rm -f "$TMPFILE2"
+    echo "    $FAILS"
+  elif [ "$VERBOSE" = "1" ]; then
+    printf 'OK %-40s %d passed\n' "$FILE" "$P"
+  fi
+done
+
+TOTAL=$((TOTAL_PASS + TOTAL_FAIL))
+if [ $TOTAL_FAIL -eq 0 ]; then
+  echo "OK $TOTAL_PASS/$TOTAL smalltalk-on-sx tests passed"
+else
+  echo "FAIL $TOTAL_PASS/$TOTAL passed, $TOTAL_FAIL failed in: ${FAILED_FILES[*]}"
+fi
+
+[ $TOTAL_FAIL -eq 0 ]

lib/smalltalk/tests/dnu.sx

@@ -0,0 +1,107 @@
+;; doesNotUnderstand: tests.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+(st-bootstrap-classes!)
+
+(define ev (fn (src) (smalltalk-eval src)))
+(define evp (fn (src) (smalltalk-eval-program src)))
+
+;; ── 1. Bootstrap installs Message class ──
+(st-test "Message exists in bootstrap" (st-class-exists? "Message") true)
+(st-test
+  "Message has expected ivars"
+  (sort (get (st-class-get "Message") :ivars))
+  (sort (list "selector" "arguments")))
+
+;; ── 2. Building a Message directly ──
+(define m (st-make-message "frob:" (list 1 2 3)))
+(st-test "make-message produces st-instance" (st-instance? m) true)
+(st-test "message class" (get m :class) "Message")
+(st-test "message selector ivar"
+  (str (get (get m :ivars) "selector"))
+  "frob:")
+(st-test "message arguments ivar" (get (get m :ivars) "arguments") (list 1 2 3))
+
+;; ── 3. User override of doesNotUnderstand: intercepts unknown sends ──
+(st-class-define! "Logger" "Object" (list "log"))
+(st-class-add-method! "Logger" "log"
+  (st-parse-method "log ^ log"))
+(st-class-add-method! "Logger" "init"
+  (st-parse-method "init log := nil. ^ self"))
+(st-class-add-method! "Logger" "doesNotUnderstand:"
+  (st-parse-method
+    "doesNotUnderstand: aMessage
+       log := aMessage selector.
+       ^ #handled"))
+
+(st-test
+  "user DNU intercepts unknown send"
+  (str
+    (evp "| l | l := Logger new init. l frobnicate. ^ l log"))
+  "frobnicate")
+
+(st-test
+  "user DNU returns its own value"
+  (str (evp "| l | l := Logger new init. ^ l frobnicate"))
+  "handled")
+
+;; Arguments are captured.
+(st-class-add-method! "Logger" "doesNotUnderstand:"
+  (st-parse-method
+    "doesNotUnderstand: aMessage
+       log := aMessage arguments.
+       ^ #handled"))
+
+(st-test
+  "user DNU sees args in Message"
+  (evp "| l | l := Logger new init. l zip: 1 zap: 2. ^ l log")
+  (list 1 2))
+
+;; ── 4. DNU on native receiver ─────────────────────────────────────────
+;; Adding doesNotUnderstand: on Object catches any-receiver sends.
+(st-class-add-method! "Object" "doesNotUnderstand:"
+  (st-parse-method
+    "doesNotUnderstand: aMessage ^ aMessage selector"))
+
+(st-test "Object DNU intercepts on SmallInteger"
+  (str (ev "42 frobnicate"))
+  "frobnicate")
+
+(st-test "Object DNU intercepts on String"
+  (str (ev "'hi' bogusmessage"))
+  "bogusmessage")
+
+(st-test "Object DNU sees arguments"
+  ;; Re-define Object DNU to return the args array.
+  (begin
+    (st-class-add-method! "Object" "doesNotUnderstand:"
+      (st-parse-method "doesNotUnderstand: aMessage ^ aMessage arguments"))
+    (ev "42 plop: 1 plop: 2"))
+  (list 1 2))
+
+;; ── 5. Subclass DNU overrides Object DNU ──────────────────────────────
+(st-class-define! "Proxy" "Object" (list))
+(st-class-add-method! "Proxy" "doesNotUnderstand:"
+  (st-parse-method "doesNotUnderstand: aMessage ^ #proxyHandled"))
+
+(st-test "subclass DNU wins over Object DNU"
+  (str (evp "^ Proxy new whatever"))
+  "proxyHandled")
+
+;; ── 6. Defined methods bypass DNU ─────────────────────────────────────
+(st-class-add-method! "Proxy" "known" (st-parse-method "known ^ 7"))
+(st-test "defined method wins over DNU"
+  (evp "^ Proxy new known")
+  7)
+
+;; ── 7. Block doesNotUnderstand: routes via Object ─────────────────────
+(st-class-add-method! "Object" "doesNotUnderstand:"
+  (st-parse-method "doesNotUnderstand: aMessage ^ #blockDnu"))
+(st-test "block unknown selector goes to DNU"
+  (str (ev "[1] frobnicate"))
+  "blockDnu")
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/eval.sx

@@ -0,0 +1,181 @@
+;; Smalltalk evaluator tests — sequential semantics, message dispatch on
+;; native + user receivers, blocks, cascades, return.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+(st-bootstrap-classes!)
+
+(define ev (fn (src) (smalltalk-eval src)))
+(define evp (fn (src) (smalltalk-eval-program src)))
+
+;; ── 1. Literals ──
+(st-test "int literal" (ev "42") 42)
+(st-test "float literal" (ev "3.14") 3.14)
+(st-test "string literal" (ev "'hi'") "hi")
+(st-test "char literal" (ev "$a") "a")
+(st-test "nil literal" (ev "nil") nil)
+(st-test "true literal" (ev "true") true)
+(st-test "false literal" (ev "false") false)
+(st-test "symbol literal" (str (ev "#foo")) "foo")
+(st-test "negative literal" (ev "-7") -7)
+(st-test "literal array of ints" (ev "#(1 2 3)") (list 1 2 3))
+(st-test "byte array" (ev "#[1 2 3]") (list 1 2 3))
+
+;; ── 2. Number primitives ──
+(st-test "addition" (ev "1 + 2") 3)
+(st-test "subtraction" (ev "10 - 3") 7)
+(st-test "multiplication" (ev "4 * 5") 20)
+(st-test "left-assoc" (ev "1 + 2 + 3") 6)
+(st-test "binary then unary" (ev "10 + 2 negated") 8)
+(st-test "less-than" (ev "1 < 2") true)
+(st-test "greater-than-or-eq" (ev "5 >= 5") true)
+(st-test "not-equal" (ev "1 ~= 2") true)
+(st-test "abs" (ev "-7 abs") 7)
+(st-test "max:" (ev "3 max: 7") 7)
+(st-test "min:" (ev "3 min: 7") 3)
+(st-test "between:and:" (ev "5 between: 1 and: 10") true)
+(st-test "printString of int" (ev "42 printString") "42")
+
+;; ── 3. Boolean primitives ──
+(st-test "true not" (ev "true not") false)
+(st-test "false not" (ev "false not") true)
+(st-test "true & false" (ev "true & false") false)
+(st-test "true | false" (ev "true | false") true)
+(st-test "ifTrue: with true" (ev "true ifTrue: [99]") 99)
+(st-test "ifTrue: with false" (ev "false ifTrue: [99]") nil)
+(st-test "ifTrue:ifFalse: true branch" (ev "true ifTrue: [1] ifFalse: [2]") 1)
+(st-test "ifTrue:ifFalse: false branch" (ev "false ifTrue: [1] ifFalse: [2]") 2)
+(st-test "and: short-circuit" (ev "false and: [1/0]") false)
+(st-test "or: short-circuit" (ev "true or: [1/0]") true)
+
+;; ── 4. Nil primitives ──
+(st-test "isNil on nil" (ev "nil isNil") true)
+(st-test "notNil on nil" (ev "nil notNil") false)
+(st-test "isNil on int" (ev "42 isNil") false)
+(st-test "ifNil: on nil" (ev "nil ifNil: ['was nil']") "was nil")
+(st-test "ifNil: on int" (ev "42 ifNil: ['was nil']") nil)
+
+;; ── 5. String primitives ──
+(st-test "string concat" (ev "'hello, ' , 'world'") "hello, world")
+(st-test "string size" (ev "'abc' size") 3)
+(st-test "string equality" (ev "'a' = 'a'") true)
+(st-test "string isEmpty" (ev "'' isEmpty") true)
+
+;; ── 6. Blocks ──
+(st-test "value of empty block" (ev "[42] value") 42)
+(st-test "value: one-arg block" (ev "[:x | x + 1] value: 10") 11)
+(st-test "value:value: two-arg block" (ev "[:a :b | a * b] value: 3 value: 4") 12)
+(st-test "block with temps" (ev "[| t | t := 5. t * t] value") 25)
+(st-test "block returns last expression" (ev "[1. 2. 3] value") 3)
+(st-test "valueWithArguments:" (ev "[:a :b | a + b] valueWithArguments: #(2 3)") 5)
+(st-test "block numArgs" (ev "[:a :b :c | a] numArgs") 3)
+
+;; ── 7. Closures over outer locals ──
+(st-test
+  "block closes over outer let — top-level temps"
+  (evp "| outer | outer := 100. ^ [:x | x + outer] value: 5")
+  105)
+
+;; ── 8. Cascades ──
+(st-test "simple cascade returns last" (ev "10 + 1; + 2; + 3") 13)
+
+;; ── 9. Sequences and assignment ──
+(st-test "sequence returns last" (evp "1. 2. 3") 3)
+(st-test
+  "assignment + use"
+  (evp "| x | x := 10. x := x + 1. ^ x")
+  11)
+
+;; ── 10. Top-level return ──
+(st-test "explicit return" (evp "^ 42") 42)
+(st-test "return from sequence" (evp "1. ^ 99. 100") 99)
+
+;; ── 11. Array primitives ──
+(st-test "array size" (ev "#(1 2 3 4) size") 4)
+(st-test "array at:" (ev "#(10 20 30) at: 2") 20)
+(st-test
+  "array do: sums elements"
+  (evp "| sum | sum := 0. #(1 2 3 4) do: [:e | sum := sum + e]. ^ sum")
+  10)
+(st-test
+  "array collect:"
+  (ev "#(1 2 3) collect: [:x | x * x]")
+  (list 1 4 9))
+(st-test
+  "array select:"
+  (ev "#(1 2 3 4 5) select: [:x | x > 2]")
+  (list 3 4 5))
+
+;; ── 12. While loop ──
+(st-test
+  "whileTrue: counts down"
+  (evp "| n | n := 5. [n > 0] whileTrue: [n := n - 1]. ^ n")
+  0)
+(st-test
+  "to:do: sums 1..10"
+  (evp "| s | s := 0. 1 to: 10 do: [:i | s := s + i]. ^ s")
+  55)
+
+;; ── 13. User classes — instance variables, methods, send ──
+(st-bootstrap-classes!)
+(st-class-define! "Point" "Object" (list "x" "y"))
+(st-class-add-method! "Point" "x"  (st-parse-method "x ^ x"))
+(st-class-add-method! "Point" "y"  (st-parse-method "y ^ y"))
+(st-class-add-method! "Point" "x:" (st-parse-method "x: v x := v"))
+(st-class-add-method! "Point" "y:" (st-parse-method "y: v y := v"))
+(st-class-add-method! "Point" "+"
+  (st-parse-method "+ other ^ (Point new x: x + other x; y: y + other y; yourself)"))
+(st-class-add-method! "Point" "yourself" (st-parse-method "yourself ^ self"))
+(st-class-add-method! "Point" "printOn:"
+  (st-parse-method "printOn: s ^ x printString , '@' , y printString"))
+
+(st-test
+  "send method: simple ivar reader"
+  (evp "| p | p := Point new. p x: 3. p y: 4. ^ p x")
+  3)
+
+(st-test
+  "method composes via cascade"
+  (evp "| p | p := Point new x: 7; y: 8; yourself. ^ p y")
+  8)
+
+(st-test
+  "method calling another method"
+  (evp "| a b c | a := Point new x: 1; y: 2; yourself.
+        b := Point new x: 10; y: 20; yourself.
+        c := a + b. ^ c x")
+  11)
+
+;; ── 14. Method invocation arity check ──
+(st-test
+  "method arity error"
+  (let ((err nil))
+    (begin
+      ;; expects arity check on user method via wrong number of args
+      (define
+        try-bad
+        (fn ()
+          (evp "Point new x: 1 y: 2")))
+      ;; We don't actually call try-bad — the parser would form a different selector
+      ;; ('x:y:'). Instead, manually invoke an invalid arity:
+      (st-class-define! "ArityCheck" "Object" (list))
+      (st-class-add-method! "ArityCheck" "foo:" (st-parse-method "foo: x ^ x"))
+      err))
+  nil)
+
+;; ── 15. Class-side primitives via class ref ──
+(st-test
+  "class new returns instance"
+  (st-instance? (ev "Point new"))
+  true)
+(st-test
+  "class name"
+  (ev "Point name")
+  "Point")
+
+;; ── 16. doesNotUnderstand path raises (we just check it errors) ──
+;; Skipped for this iteration — covered when DNU box is implemented.
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/parse.sx

@@ -0,0 +1,369 @@
+;; Smalltalk parser tests.
+;;
+;; Reuses helpers (st-test, st-deep=?) from tokenize.sx. Counters reset
+;; here so this file's summary covers parse tests only.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+;; ── 1. Atoms ──
+(st-test "int" (st-parse-expr "42") {:type "lit-int" :value 42})
+(st-test "float" (st-parse-expr "3.14") {:type "lit-float" :value 3.14})
+(st-test "string" (st-parse-expr "'hi'") {:type "lit-string" :value "hi"})
+(st-test "char" (st-parse-expr "$x") {:type "lit-char" :value "x"})
+(st-test "symbol" (st-parse-expr "#foo") {:type "lit-symbol" :value "foo"})
+(st-test "binary symbol" (st-parse-expr "#+") {:type "lit-symbol" :value "+"})
+(st-test "keyword symbol" (st-parse-expr "#at:put:") {:type "lit-symbol" :value "at:put:"})
+(st-test "nil" (st-parse-expr "nil") {:type "lit-nil"})
+(st-test "true" (st-parse-expr "true") {:type "lit-true"})
+(st-test "false" (st-parse-expr "false") {:type "lit-false"})
+(st-test "self" (st-parse-expr "self") {:type "self"})
+(st-test "super" (st-parse-expr "super") {:type "super"})
+(st-test "ident" (st-parse-expr "x") {:type "ident" :name "x"})
+(st-test "negative int" (st-parse-expr "-3") {:type "lit-int" :value -3})
+
+;; ── 2. Literal arrays ──
+(st-test
+  "literal array of ints"
+  (st-parse-expr "#(1 2 3)")
+  {:type "lit-array"
+   :elements (list
+               {:type "lit-int" :value 1}
+               {:type "lit-int" :value 2}
+               {:type "lit-int" :value 3})})
+
+(st-test
+  "literal array mixed"
+  (st-parse-expr "#(1 #foo 'x' true)")
+  {:type "lit-array"
+   :elements (list
+               {:type "lit-int" :value 1}
+               {:type "lit-symbol" :value "foo"}
+               {:type "lit-string" :value "x"}
+               {:type "lit-true"})})
+
+(st-test
+  "literal array bare ident is symbol"
+  (st-parse-expr "#(foo bar)")
+  {:type "lit-array"
+   :elements (list
+               {:type "lit-symbol" :value "foo"}
+               {:type "lit-symbol" :value "bar"})})
+
+(st-test
+  "nested literal array"
+  (st-parse-expr "#(1 (2 3) 4)")
+  {:type "lit-array"
+   :elements (list
+               {:type "lit-int" :value 1}
+               {:type "lit-array"
+                :elements (list
+                            {:type "lit-int" :value 2}
+                            {:type "lit-int" :value 3})}
+               {:type "lit-int" :value 4})})
+
+(st-test
+  "byte array"
+  (st-parse-expr "#[1 2 3]")
+  {:type "lit-byte-array" :elements (list 1 2 3)})
+
+;; ── 3. Unary messages ──
+(st-test
+  "unary single"
+  (st-parse-expr "x foo")
+  {:type "send"
+   :receiver {:type "ident" :name "x"}
+   :selector "foo"
+   :args (list)})
+
+(st-test
+  "unary chain"
+  (st-parse-expr "x foo bar baz")
+  {:type "send"
+   :receiver {:type "send"
+              :receiver {:type "send"
+                         :receiver {:type "ident" :name "x"}
+                         :selector "foo"
+                         :args (list)}
+              :selector "bar"
+              :args (list)}
+   :selector "baz"
+   :args (list)})
+
+(st-test
+  "unary on literal"
+  (st-parse-expr "42 printNl")
+  {:type "send"
+   :receiver {:type "lit-int" :value 42}
+   :selector "printNl"
+   :args (list)})
+
+;; ── 4. Binary messages ──
+(st-test
+  "binary single"
+  (st-parse-expr "1 + 2")
+  {:type "send"
+   :receiver {:type "lit-int" :value 1}
+   :selector "+"
+   :args (list {:type "lit-int" :value 2})})
+
+(st-test
+  "binary left-assoc"
+  (st-parse-expr "1 + 2 + 3")
+  {:type "send"
+   :receiver {:type "send"
+              :receiver {:type "lit-int" :value 1}
+              :selector "+"
+              :args (list {:type "lit-int" :value 2})}
+   :selector "+"
+   :args (list {:type "lit-int" :value 3})})
+
+(st-test
+  "binary same precedence l-to-r"
+  (st-parse-expr "1 + 2 * 3")
+  {:type "send"
+   :receiver {:type "send"
+              :receiver {:type "lit-int" :value 1}
+              :selector "+"
+              :args (list {:type "lit-int" :value 2})}
+   :selector "*"
+   :args (list {:type "lit-int" :value 3})})
+
+;; ── 5. Precedence: unary binds tighter than binary ──
+(st-test
+  "unary tighter than binary"
+  (st-parse-expr "3 + 4 factorial")
+  {:type "send"
+   :receiver {:type "lit-int" :value 3}
+   :selector "+"
+   :args (list
+           {:type "send"
+            :receiver {:type "lit-int" :value 4}
+            :selector "factorial"
+            :args (list)})})
+
+;; ── 6. Keyword messages ──
+(st-test
+  "keyword single"
+  (st-parse-expr "x at: 1")
+  {:type "send"
+   :receiver {:type "ident" :name "x"}
+   :selector "at:"
+   :args (list {:type "lit-int" :value 1})})
+
+(st-test
+  "keyword chain"
+  (st-parse-expr "x at: 1 put: 'a'")
+  {:type "send"
+   :receiver {:type "ident" :name "x"}
+   :selector "at:put:"
+   :args (list {:type "lit-int" :value 1} {:type "lit-string" :value "a"})})
+
+;; ── 7. Precedence: binary tighter than keyword ──
+(st-test
+  "binary tighter than keyword"
+  (st-parse-expr "x at: 1 + 2")
+  {:type "send"
+   :receiver {:type "ident" :name "x"}
+   :selector "at:"
+   :args (list
+           {:type "send"
+            :receiver {:type "lit-int" :value 1}
+            :selector "+"
+            :args (list {:type "lit-int" :value 2})})})
+
+(st-test
+  "keyword absorbs trailing unary"
+  (st-parse-expr "a foo: b bar")
+  {:type "send"
+   :receiver {:type "ident" :name "a"}
+   :selector "foo:"
+   :args (list
+           {:type "send"
+            :receiver {:type "ident" :name "b"}
+            :selector "bar"
+            :args (list)})})
+
+;; ── 8. Parens override precedence ──
+(st-test
+  "paren forces grouping"
+  (st-parse-expr "(1 + 2) * 3")
+  {:type "send"
+   :receiver {:type "send"
+              :receiver {:type "lit-int" :value 1}
+              :selector "+"
+              :args (list {:type "lit-int" :value 2})}
+   :selector "*"
+   :args (list {:type "lit-int" :value 3})})
+
+;; ── 9. Cascade ──
+(st-test
+  "simple cascade"
+  (st-parse-expr "x m1; m2")
+  {:type "cascade"
+   :receiver {:type "ident" :name "x"}
+   :messages (list
+               {:selector "m1" :args (list)}
+               {:selector "m2" :args (list)})})
+
+(st-test
+  "cascade with binary and keyword"
+  (st-parse-expr "Stream new nl; tab; print: 1")
+  {:type "cascade"
+   :receiver {:type "send"
+              :receiver {:type "ident" :name "Stream"}
+              :selector "new"
+              :args (list)}
+   :messages (list
+               {:selector "nl" :args (list)}
+               {:selector "tab" :args (list)}
+               {:selector "print:" :args (list {:type "lit-int" :value 1})})})
+
+;; ── 10. Blocks ──
+(st-test
+  "empty block"
+  (st-parse-expr "[]")
+  {:type "block" :params (list) :temps (list) :body (list)})
+
+(st-test
+  "block one expr"
+  (st-parse-expr "[1 + 2]")
+  {:type "block"
+   :params (list)
+   :temps (list)
+   :body (list
+           {:type "send"
+            :receiver {:type "lit-int" :value 1}
+            :selector "+"
+            :args (list {:type "lit-int" :value 2})})})
+
+(st-test
+  "block with params"
+  (st-parse-expr "[:a :b | a + b]")
+  {:type "block"
+   :params (list "a" "b")
+   :temps (list)
+   :body (list
+           {:type "send"
+            :receiver {:type "ident" :name "a"}
+            :selector "+"
+            :args (list {:type "ident" :name "b"})})})
+
+(st-test
+  "block with temps"
+  (st-parse-expr "[| t | t := 1. t]")
+  {:type "block"
+   :params (list)
+   :temps (list "t")
+   :body (list
+           {:type "assign" :name "t" :expr {:type "lit-int" :value 1}}
+           {:type "ident" :name "t"})})
+
+(st-test
+  "block with params and temps"
+  (st-parse-expr "[:x | | t | t := x + 1. t]")
+  {:type "block"
+   :params (list "x")
+   :temps (list "t")
+   :body (list
+           {:type "assign"
+            :name "t"
+            :expr {:type "send"
+                   :receiver {:type "ident" :name "x"}
+                   :selector "+"
+                   :args (list {:type "lit-int" :value 1})}}
+           {:type "ident" :name "t"})})
+
+;; ── 11. Assignment / return / statements ──
+(st-test
+  "assignment"
+  (st-parse-expr "x := 1")
+  {:type "assign" :name "x" :expr {:type "lit-int" :value 1}})
+
+(st-test
+  "return"
+  (st-parse-expr "1")
+  {:type "lit-int" :value 1})
+
+(st-test
+  "return statement at top level"
+  (st-parse "^ 1")
+  {:type "seq" :temps (list)
+   :exprs (list {:type "return" :expr {:type "lit-int" :value 1}})})
+
+(st-test
+  "two statements"
+  (st-parse "x := 1. y := 2")
+  {:type "seq" :temps (list)
+   :exprs (list
+            {:type "assign" :name "x" :expr {:type "lit-int" :value 1}}
+            {:type "assign" :name "y" :expr {:type "lit-int" :value 2}})})
+
+(st-test
+  "trailing dot allowed"
+  (st-parse "1. 2.")
+  {:type "seq" :temps (list)
+   :exprs (list {:type "lit-int" :value 1} {:type "lit-int" :value 2})})
+
+;; ── 12. Method headers ──
+(st-test
+  "unary method"
+  (st-parse-method "factorial ^ self * (self - 1) factorial")
+  {:type "method"
+   :selector "factorial"
+   :params (list)
+   :temps (list)
+   :pragmas (list)
+   :body (list
+           {:type "return"
+            :expr {:type "send"
+                   :receiver {:type "self"}
+                   :selector "*"
+                   :args (list
+                           {:type "send"
+                            :receiver {:type "send"
+                                       :receiver {:type "self"}
+                                       :selector "-"
+                                       :args (list {:type "lit-int" :value 1})}
+                            :selector "factorial"
+                            :args (list)})}})})
+
+(st-test
+  "binary method"
+  (st-parse-method "+ other ^ 'plus'")
+  {:type "method"
+   :selector "+"
+   :params (list "other")
+   :temps (list)
+   :pragmas (list)
+   :body (list {:type "return" :expr {:type "lit-string" :value "plus"}})})
+
+(st-test
+  "keyword method"
+  (st-parse-method "at: i put: v ^ v")
+  {:type "method"
+   :selector "at:put:"
+   :params (list "i" "v")
+   :temps (list)
+   :pragmas (list)
+   :body (list {:type "return" :expr {:type "ident" :name "v"}})})
+
+(st-test
+  "method with temps"
+  (st-parse-method "twice: x | t | t := x + x. ^ t")
+  {:type "method"
+   :selector "twice:"
+   :params (list "x")
+   :temps (list "t")
+   :pragmas (list)
+   :body (list
+           {:type "assign"
+            :name "t"
+            :expr {:type "send"
+                   :receiver {:type "ident" :name "x"}
+                   :selector "+"
+                   :args (list {:type "ident" :name "x"})}}
+           {:type "return" :expr {:type "ident" :name "t"}})})
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/parse_chunks.sx

@@ -0,0 +1,294 @@
+;; Smalltalk chunk-stream parser + pragma tests.
+;;
+;; Reuses helpers (st-test, st-deep=?) from tokenize.sx. Counters reset
+;; here so this file's summary covers chunk + pragma tests only.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+;; ── 1. Raw chunk reader ──
+(st-test "empty source" (st-read-chunks "") (list))
+(st-test "single chunk" (st-read-chunks "foo!") (list "foo"))
+(st-test "two chunks" (st-read-chunks "a! b!") (list "a" "b"))
+(st-test "trailing no bang" (st-read-chunks "a! b") (list "a" "b"))
+(st-test "empty chunk" (st-read-chunks "a! ! b!") (list "a" "" "b"))
+(st-test
+  "doubled bang escapes"
+  (st-read-chunks "yes!! no!yes!")
+  (list "yes! no" "yes"))
+(st-test
+  "whitespace trimmed"
+  (st-read-chunks "  \n  hello  \n  !")
+  (list "hello"))
+
+;; ── 2. Chunk parser — do-it mode ──
+(st-test
+  "single do-it chunk"
+  (st-parse-chunks "1 + 2!")
+  (list
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "lit-int" :value 1}
+           :selector "+"
+           :args (list {:type "lit-int" :value 2})}}))
+
+(st-test
+  "two do-it chunks"
+  (st-parse-chunks "x := 1! y := 2!")
+  (list
+    {:kind "expr"
+     :ast {:type "assign" :name "x" :expr {:type "lit-int" :value 1}}}
+    {:kind "expr"
+     :ast {:type "assign" :name "y" :expr {:type "lit-int" :value 2}}}))
+
+(st-test
+  "blank chunk outside methods"
+  (st-parse-chunks "1! ! 2!")
+  (list
+    {:kind "expr" :ast {:type "lit-int" :value 1}}
+    {:kind "blank"}
+    {:kind "expr" :ast {:type "lit-int" :value 2}}))
+
+;; ── 3. Methods batch ──
+(st-test
+  "methodsFor opens method batch"
+  (st-parse-chunks
+    "Foo methodsFor: 'access'! foo ^ 1! bar ^ 2! !")
+  (list
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "ident" :name "Foo"}
+           :selector "methodsFor:"
+           :args (list {:type "lit-string" :value "access"})}}
+    {:kind "method"
+     :class "Foo"
+     :class-side? false
+     :category "access"
+     :ast {:type "method"
+           :selector "foo"
+           :params (list)
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "return" :expr {:type "lit-int" :value 1}})}}
+    {:kind "method"
+     :class "Foo"
+     :class-side? false
+     :category "access"
+     :ast {:type "method"
+           :selector "bar"
+           :params (list)
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "return" :expr {:type "lit-int" :value 2}})}}
+    {:kind "end-methods"}))
+
+(st-test
+  "class-side methodsFor"
+  (st-parse-chunks
+    "Foo class methodsFor: 'creation'! make ^ self new! !")
+  (list
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "send"
+                      :receiver {:type "ident" :name "Foo"}
+                      :selector "class"
+                      :args (list)}
+           :selector "methodsFor:"
+           :args (list {:type "lit-string" :value "creation"})}}
+    {:kind "method"
+     :class "Foo"
+     :class-side? true
+     :category "creation"
+     :ast {:type "method"
+           :selector "make"
+           :params (list)
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "return"
+                    :expr {:type "send"
+                           :receiver {:type "self"}
+                           :selector "new"
+                           :args (list)}})}}
+    {:kind "end-methods"}))
+
+(st-test
+  "method batch returns to do-it after empty chunk"
+  (st-parse-chunks
+    "Foo methodsFor: 'a'! m1 ^ 1! ! 99!")
+  (list
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "ident" :name "Foo"}
+           :selector "methodsFor:"
+           :args (list {:type "lit-string" :value "a"})}}
+    {:kind "method"
+     :class "Foo"
+     :class-side? false
+     :category "a"
+     :ast {:type "method"
+           :selector "m1"
+           :params (list)
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "return" :expr {:type "lit-int" :value 1}})}}
+    {:kind "end-methods"}
+    {:kind "expr" :ast {:type "lit-int" :value 99}}))
+
+;; ── 4. Pragmas in method bodies ──
+(st-test
+  "single pragma"
+  (st-parse-method "primAt: i <primitive: 60> ^ self")
+  {:type "method"
+   :selector "primAt:"
+   :params (list "i")
+   :temps (list)
+   :pragmas (list
+              {:selector "primitive:"
+               :args (list {:type "lit-int" :value 60})})
+   :body (list {:type "return" :expr {:type "self"}})})
+
+(st-test
+  "pragma with two keyword pairs"
+  (st-parse-method "fft <primitive: 1 module: 'fft'> ^ nil")
+  {:type "method"
+   :selector "fft"
+   :params (list)
+   :temps (list)
+   :pragmas (list
+              {:selector "primitive:module:"
+               :args (list
+                       {:type "lit-int" :value 1}
+                       {:type "lit-string" :value "fft"})})
+   :body (list {:type "return" :expr {:type "lit-nil"}})})
+
+(st-test
+  "pragma with negative number"
+  (st-parse-method "neg <primitive: -1> ^ nil")
+  {:type "method"
+   :selector "neg"
+   :params (list)
+   :temps (list)
+   :pragmas (list
+              {:selector "primitive:"
+               :args (list {:type "lit-int" :value -1})})
+   :body (list {:type "return" :expr {:type "lit-nil"}})})
+
+(st-test
+  "pragma with symbol arg"
+  (st-parse-method "tagged <category: #algebra> ^ nil")
+  {:type "method"
+   :selector "tagged"
+   :params (list)
+   :temps (list)
+   :pragmas (list
+              {:selector "category:"
+               :args (list {:type "lit-symbol" :value "algebra"})})
+   :body (list {:type "return" :expr {:type "lit-nil"}})})
+
+(st-test
+  "pragma then temps"
+  (st-parse-method "calc <primitive: 1> | t | t := 5. ^ t")
+  {:type "method"
+   :selector "calc"
+   :params (list)
+   :temps (list "t")
+   :pragmas (list
+              {:selector "primitive:"
+               :args (list {:type "lit-int" :value 1})})
+   :body (list
+           {:type "assign" :name "t" :expr {:type "lit-int" :value 5}}
+           {:type "return" :expr {:type "ident" :name "t"}})})
+
+(st-test
+  "temps then pragma"
+  (st-parse-method "calc | t | <primitive: 1> t := 5. ^ t")
+  {:type "method"
+   :selector "calc"
+   :params (list)
+   :temps (list "t")
+   :pragmas (list
+              {:selector "primitive:"
+               :args (list {:type "lit-int" :value 1})})
+   :body (list
+           {:type "assign" :name "t" :expr {:type "lit-int" :value 5}}
+           {:type "return" :expr {:type "ident" :name "t"}})})
+
+(st-test
+  "two pragmas"
+  (st-parse-method "m <primitive: 1> <category: 'a'> ^ self")
+  {:type "method"
+   :selector "m"
+   :params (list)
+   :temps (list)
+   :pragmas (list
+              {:selector "primitive:"
+               :args (list {:type "lit-int" :value 1})}
+              {:selector "category:"
+               :args (list {:type "lit-string" :value "a"})})
+   :body (list {:type "return" :expr {:type "self"}})})
+
+;; ── 5. End-to-end: a small "filed-in" snippet ──
+(st-test
+  "small filed-in class snippet"
+  (st-parse-chunks
+    "Object subclass: #Account
+       instanceVariableNames: 'balance'!
+
+     !Account methodsFor: 'access'!
+     balance
+       ^ balance!
+
+     deposit: amount
+       balance := balance + amount.
+       ^ self! !")
+  (list
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "ident" :name "Object"}
+           :selector "subclass:instanceVariableNames:"
+           :args (list
+                   {:type "lit-symbol" :value "Account"}
+                   {:type "lit-string" :value "balance"})}}
+    {:kind "blank"}
+    {:kind "expr"
+     :ast {:type "send"
+           :receiver {:type "ident" :name "Account"}
+           :selector "methodsFor:"
+           :args (list {:type "lit-string" :value "access"})}}
+    {:kind "method"
+     :class "Account"
+     :class-side? false
+     :category "access"
+     :ast {:type "method"
+           :selector "balance"
+           :params (list)
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "return"
+                    :expr {:type "ident" :name "balance"}})}}
+    {:kind "method"
+     :class "Account"
+     :class-side? false
+     :category "access"
+     :ast {:type "method"
+           :selector "deposit:"
+           :params (list "amount")
+           :temps (list)
+           :pragmas (list)
+           :body (list
+                   {:type "assign"
+                    :name "balance"
+                    :expr {:type "send"
+                           :receiver {:type "ident" :name "balance"}
+                           :selector "+"
+                           :args (list {:type "ident" :name "amount"})}}
+                   {:type "return" :expr {:type "self"}})}}
+    {:kind "end-methods"}))
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/runtime.sx

@@ -0,0 +1,255 @@
+;; Smalltalk runtime tests — class table, type→class mapping, instances.
+;;
+;; Reuses helpers (st-test, st-deep=?) from tokenize.sx. Counters reset
+;; here so this file's summary covers runtime tests only.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+;; Fresh hierarchy for every test file.
+(st-bootstrap-classes!)
+
+;; ── 1. Bootstrap installed expected classes ──
+(st-test "Object exists" (st-class-exists? "Object") true)
+(st-test "Behavior exists" (st-class-exists? "Behavior") true)
+(st-test "Metaclass exists" (st-class-exists? "Metaclass") true)
+(st-test "True/False/UndefinedObject"
+  (and
+    (st-class-exists? "True")
+    (st-class-exists? "False")
+    (st-class-exists? "UndefinedObject"))
+  true)
+(st-test "SmallInteger / Float / Symbol exist"
+  (and
+    (st-class-exists? "SmallInteger")
+    (st-class-exists? "Float")
+    (st-class-exists? "Symbol"))
+  true)
+(st-test "BlockClosure exists" (st-class-exists? "BlockClosure") true)
+
+;; ── 2. Superclass chain ──
+(st-test "Object has no superclass" (st-class-superclass "Object") nil)
+(st-test "Behavior super = Object" (st-class-superclass "Behavior") "Object")
+(st-test "True super = Boolean" (st-class-superclass "True") "Boolean")
+(st-test "Symbol super = String" (st-class-superclass "Symbol") "String")
+(st-test
+  "String chain"
+  (st-class-chain "String")
+  (list "String" "ArrayedCollection" "SequenceableCollection" "Collection" "Object"))
+(st-test
+  "SmallInteger chain"
+  (st-class-chain "SmallInteger")
+  (list "SmallInteger" "Integer" "Number" "Magnitude" "Object"))
+
+;; ── 3. inherits-from? ──
+(st-test "True inherits from Boolean" (st-class-inherits-from? "True" "Boolean") true)
+(st-test "True inherits from Object" (st-class-inherits-from? "True" "Object") true)
+(st-test "True inherits from True" (st-class-inherits-from? "True" "True") true)
+(st-test
+  "True does not inherit from Number"
+  (st-class-inherits-from? "True" "Number")
+  false)
+(st-test
+  "Object does not inherit from Number"
+  (st-class-inherits-from? "Object" "Number")
+  false)
+
+;; ── 4. type→class mapping ──
+(st-test "class-of nil" (st-class-of nil) "UndefinedObject")
+(st-test "class-of true" (st-class-of true) "True")
+(st-test "class-of false" (st-class-of false) "False")
+(st-test "class-of int" (st-class-of 42) "SmallInteger")
+(st-test "class-of zero" (st-class-of 0) "SmallInteger")
+(st-test "class-of negative int" (st-class-of -3) "SmallInteger")
+(st-test "class-of float" (st-class-of 3.14) "Float")
+(st-test "class-of string" (st-class-of "hi") "String")
+(st-test "class-of symbol" (st-class-of (quote foo)) "Symbol")
+(st-test "class-of list" (st-class-of (list 1 2)) "Array")
+(st-test "class-of empty list" (st-class-of (list)) "Array")
+(st-test "class-of lambda" (st-class-of (fn (x) x)) "BlockClosure")
+(st-test "class-of dict" (st-class-of {:a 1}) "Dictionary")
+
+;; ── 5. User class definition ──
+(st-class-define! "Account" "Object" (list "balance" "owner"))
+(st-class-define! "SavingsAccount" "Account" (list "rate"))
+
+(st-test "Account exists" (st-class-exists? "Account") true)
+(st-test "Account super = Object" (st-class-superclass "Account") "Object")
+(st-test
+  "SavingsAccount chain"
+  (st-class-chain "SavingsAccount")
+  (list "SavingsAccount" "Account" "Object"))
+(st-test
+  "SavingsAccount own ivars"
+  (get (st-class-get "SavingsAccount") :ivars)
+  (list "rate"))
+(st-test
+  "SavingsAccount inherited+own ivars"
+  (st-class-all-ivars "SavingsAccount")
+  (list "balance" "owner" "rate"))
+
+;; ── 6. Instance construction ──
+(define a1 (st-make-instance "Account"))
+(st-test "instance is st-instance" (st-instance? a1) true)
+(st-test "instance class" (get a1 :class) "Account")
+(st-test "instance ivars start nil" (st-iv-get a1 "balance") nil)
+(st-test
+  "instance has all expected ivars"
+  (sort (keys (get a1 :ivars)))
+  (sort (list "balance" "owner")))
+(define a2 (st-iv-set! a1 "balance" 100))
+(st-test "iv-set! returns updated copy" (st-iv-get a2 "balance") 100)
+(st-test "iv-set! does not mutate original" (st-iv-get a1 "balance") nil)
+(st-test "class-of instance" (st-class-of a1) "Account")
+
+(define s1 (st-make-instance "SavingsAccount"))
+(st-test
+  "subclass instance has all inherited ivars"
+  (sort (keys (get s1 :ivars)))
+  (sort (list "balance" "owner" "rate")))
+
+;; ── 7. Method install + lookup ──
+(st-class-add-method!
+  "Account"
+  "balance"
+  (st-parse-method "balance ^ balance"))
+(st-class-add-method!
+  "Account"
+  "deposit:"
+  (st-parse-method "deposit: amount balance := balance + amount. ^ self"))
+
+(st-test
+  "method registered"
+  (has-key? (get (st-class-get "Account") :methods) "balance")
+  true)
+
+(st-test
+  "method lookup direct"
+  (= (st-method-lookup "Account" "balance" false) nil)
+  false)
+
+(st-test
+  "method lookup walks superclass"
+  (= (st-method-lookup "SavingsAccount" "deposit:" false) nil)
+  false)
+
+(st-test
+  "method lookup unknown selector"
+  (st-method-lookup "Account" "frobnicate" false)
+  nil)
+
+(st-test
+  "method lookup records defining class"
+  (get (st-method-lookup "SavingsAccount" "balance" false) :defining-class)
+  "Account")
+
+;; SavingsAccount overrides deposit:
+(st-class-add-method!
+  "SavingsAccount"
+  "deposit:"
+  (st-parse-method "deposit: amount ^ super deposit: amount + 1"))
+
+(st-test
+  "subclass override picked first"
+  (get (st-method-lookup "SavingsAccount" "deposit:" false) :defining-class)
+  "SavingsAccount")
+
+(st-test
+  "Account still finds its own deposit:"
+  (get (st-method-lookup "Account" "deposit:" false) :defining-class)
+  "Account")
+
+;; ── 8. Class-side methods ──
+(st-class-add-class-method!
+  "Account"
+  "new"
+  (st-parse-method "new ^ super new"))
+(st-test
+  "class-side lookup"
+  (= (st-method-lookup "Account" "new" true) nil)
+  false)
+(st-test
+  "instance-side does not find class method"
+  (st-method-lookup "Account" "new" false)
+  nil)
+
+;; ── 9. Re-bootstrap resets table ──
+(st-bootstrap-classes!)
+(st-test "after re-bootstrap Account gone" (st-class-exists? "Account") false)
+(st-test "after re-bootstrap Object stays" (st-class-exists? "Object") true)
+
+;; ── 10. Method-lookup cache ──
+(st-bootstrap-classes!)
+(st-class-define! "Foo" "Object" (list))
+(st-class-define! "Bar" "Foo" (list))
+(st-class-add-method! "Foo" "greet" (st-parse-method "greet ^ 1"))
+
+;; Bootstrap clears cache; record stats from now.
+(st-method-cache-reset-stats!)
+
+;; First lookup is a miss; second is a hit.
+(st-method-lookup "Bar" "greet" false)
+(st-test
+  "first lookup recorded as miss"
+  (get (st-method-cache-stats) :misses)
+  1)
+(st-test
+  "first lookup recorded as hit count zero"
+  (get (st-method-cache-stats) :hits)
+  0)
+
+(st-method-lookup "Bar" "greet" false)
+(st-test
+  "second lookup hits cache"
+  (get (st-method-cache-stats) :hits)
+  1)
+
+;; Misses are also cached as :not-found.
+(st-method-lookup "Bar" "frobnicate" false)
+(st-method-lookup "Bar" "frobnicate" false)
+(st-test
+  "negative-result caches"
+  (get (st-method-cache-stats) :hits)
+  2)
+
+;; Adding a new method invalidates the cache.
+(st-class-add-method! "Bar" "greet" (st-parse-method "greet ^ 2"))
+(st-test
+  "cache cleared on method add"
+  (get (st-method-cache-stats) :size)
+  0)
+(st-test
+  "after invalidation lookup picks up override"
+  (get (st-method-lookup "Bar" "greet" false) :defining-class)
+  "Bar")
+
+;; Removing a method also invalidates and exposes the inherited one.
+(st-class-remove-method! "Bar" "greet")
+(st-test
+  "after remove lookup falls through to Foo"
+  (get (st-method-lookup "Bar" "greet" false) :defining-class)
+  "Foo")
+
+;; Cache survives across unrelated class-table mutations? No — define! clears.
+(st-method-lookup "Foo" "greet" false)  ; warm cache
+(st-class-define! "Baz" "Object" (list))
+(st-test
+  "class-define clears cache"
+  (get (st-method-cache-stats) :size)
+  0)
+
+;; Class-side and instance-side cache entries are separate keys.
+(st-class-add-class-method! "Foo" "make" (st-parse-method "make ^ self new"))
+(st-method-lookup "Foo" "make" true)
+(st-method-lookup "Foo" "make" false)
+(st-test
+  "class-side hit found, instance-side stored as not-found"
+  (= (st-method-lookup "Foo" "make" true) nil)
+  false)
+(st-test
+  "instance-side same selector returns nil"
+  (st-method-lookup "Foo" "make" false)
+  nil)
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/super.sx

@@ -0,0 +1,149 @@
+;; super-send tests.
+;;
+;; super looks up methods starting at the *defining class*'s superclass —
+;; not the receiver's class. This means an inherited method that uses
+;; `super` always reaches the same parent regardless of where in the
+;; subclass chain the receiver actually sits.
+
+(set! st-test-pass 0)
+(set! st-test-fail 0)
+(set! st-test-fails (list))
+
+(st-bootstrap-classes!)
+
+(define ev (fn (src) (smalltalk-eval src)))
+(define evp (fn (src) (smalltalk-eval-program src)))
+
+;; ── 1. Basic super: subclass override calls parent ──
+(st-class-define! "Animal" "Object" (list))
+(st-class-add-method! "Animal" "speak"
+  (st-parse-method "speak ^ #generic"))
+
+(st-class-define! "Dog" "Animal" (list))
+(st-class-add-method! "Dog" "speak"
+  (st-parse-method "speak ^ super speak"))
+
+(st-test
+  "super reaches parent's speak"
+  (str (evp "^ Dog new speak"))
+  "generic")
+
+(st-class-add-method! "Dog" "loud"
+  (st-parse-method "loud ^ super speak , #'!' asString"))
+;; The above tries to use `, #'!' asString` which won't quite work with my
+;; primitives. Replace with a simpler test.
+(st-class-add-method! "Dog" "loud"
+  (st-parse-method "loud | s | s := super speak. ^ s"))
+
+(st-test
+  "method calls super and returns same"
+  (str (evp "^ Dog new loud"))
+  "generic")
+
+;; ── 2. Super with argument ──
+(st-class-add-method! "Animal" "greet:"
+  (st-parse-method "greet: name ^ name , ' (animal)'"))
+(st-class-add-method! "Dog" "greet:"
+  (st-parse-method "greet: name ^ super greet: name"))
+
+(st-test
+  "super with arg reaches parent and threads value"
+  (evp "^ Dog new greet: 'Rex'")
+  "Rex (animal)")
+
+;; ── 3. Inherited method uses *defining* class for super ──
+;; A defines speak ^ 'A'
+;; A defines speakLog: which sends `super speak`. super starts at Object → no
+;; speak there → DNU. So invoke speakLog from A subclass to test that super
+;; resolves to A's parent (Object), not the subclass's parent.
+(st-class-define! "RootSpeaker" "Object" (list))
+(st-class-add-method! "RootSpeaker" "speak"
+  (st-parse-method "speak ^ #root"))
+(st-class-add-method! "RootSpeaker" "speakDelegate"
+  (st-parse-method "speakDelegate ^ super speak"))
+;; Object has no speak (and we add a temporary DNU for testing).
+(st-class-add-method! "Object" "doesNotUnderstand:"
+  (st-parse-method "doesNotUnderstand: aMessage ^ #dnu"))
+
+(st-class-define! "ChildSpeaker" "RootSpeaker" (list))
+(st-class-add-method! "ChildSpeaker" "speak"
+  (st-parse-method "speak ^ #child"))
+
+(st-test
+  "inherited speakDelegate uses RootSpeaker's super, not ChildSpeaker's"
+  (str (evp "^ ChildSpeaker new speakDelegate"))
+  "dnu")
+
+;; A non-inherited path: ChildSpeaker overrides speak, but speakDelegate is
+;; inherited from RootSpeaker. The super inside speakDelegate must resolve to
+;; *Object* (RootSpeaker's parent), not to RootSpeaker (ChildSpeaker's parent).
+(st-test
+  "inherited method's super does not call subclass override"
+  (str (evp "^ ChildSpeaker new speak"))
+  "child")
+
+;; Remove the Object DNU shim now that those tests are done.
+(st-class-remove-method! "Object" "doesNotUnderstand:")
+
+;; ── 4. Multi-level: A → B → C ──
+(st-class-define! "GA" "Object" (list))
+(st-class-add-method! "GA" "level"
+  (st-parse-method "level ^ #ga"))
+
+(st-class-define! "GB" "GA" (list))
+(st-class-add-method! "GB" "level"
+  (st-parse-method "level ^ super level"))
+
+(st-class-define! "GC" "GB" (list))
+(st-class-add-method! "GC" "level"
+  (st-parse-method "level ^ super level"))
+
+(st-test
+  "super chains to grandparent"
+  (str (evp "^ GC new level"))
+  "ga")
+
+;; ── 5. Super inside a block ──
+(st-class-add-method! "Dog" "delayed"
+  (st-parse-method "delayed ^ [super speak] value"))
+(st-test
+  "super inside a block resolves correctly"
+  (str (evp "^ Dog new delayed"))
+  "generic")
+
+;; ── 6. Super send keeps receiver as self ──
+(st-class-define! "Counter" "Object" (list "count"))
+(st-class-add-method! "Counter" "init"
+  (st-parse-method "init count := 0. ^ self"))
+(st-class-add-method! "Counter" "incr"
+  (st-parse-method "incr count := count + 1. ^ self"))
+(st-class-add-method! "Counter" "count"
+  (st-parse-method "count ^ count"))
+
+(st-class-define! "DoubleCounter" "Counter" (list))
+(st-class-add-method! "DoubleCounter" "incr"
+  (st-parse-method "incr super incr. super incr. ^ self"))
+
+(st-test
+  "super uses same receiver — ivars on self update"
+  (evp "| c | c := DoubleCounter new init. c incr. ^ c count")
+  2)
+
+;; ── 7. Super on a class without an immediate parent definition ──
+;; Mid-chain class with no override at this level: super resolves correctly
+;; through the missing rung.
+(st-class-define! "Mid" "Animal" (list))
+(st-class-define! "Pup" "Mid" (list))
+(st-class-add-method! "Pup" "speak"
+  (st-parse-method "speak ^ super speak"))
+
+(st-test
+  "super walks past intermediate class with no override"
+  (str (evp "^ Pup new speak"))
+  "generic")
+
+;; ── 8. Super outside any method errors ──
+;; (We don't have try/catch in SX from here; skip the negative test —
+;;  documented behaviour is that st-super-send errors when method-class is nil.)
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tests/tokenize.sx

@@ -0,0 +1,362 @@
+;; Smalltalk tokenizer tests.
+;;
+;; Lightweight runner: each test checks actual vs expected with structural
+;; equality and accumulates pass/fail counters. Final summary read by
+;; lib/smalltalk/test.sh.
+
+(define
+  st-deep=?
+  (fn
+    (a b)
+    (cond
+      ((= a b) true)
+      ((and (dict? a) (dict? b))
+        (let
+          ((ak (keys a)) (bk (keys b)))
+          (if
+            (not (= (len ak) (len bk)))
+            false
+            (every?
+              (fn
+                (k)
+                (and (has-key? b k) (st-deep=? (get a k) (get b k))))
+              ak))))
+      ((and (list? a) (list? b))
+        (if
+          (not (= (len a) (len b)))
+          false
+          (let
+            ((i 0) (ok true))
+            (begin
+              (define
+                de-loop
+                (fn
+                  ()
+                  (when
+                    (and ok (< i (len a)))
+                    (begin
+                      (when
+                        (not (st-deep=? (nth a i) (nth b i)))
+                        (set! ok false))
+                      (set! i (+ i 1))
+                      (de-loop)))))
+              (de-loop)
+              ok))))
+      (:else false))))
+
+(define st-test-pass 0)
+(define st-test-fail 0)
+(define st-test-fails (list))
+
+(define
+  st-test
+  (fn
+    (name actual expected)
+    (if
+      (st-deep=? actual expected)
+      (set! st-test-pass (+ st-test-pass 1))
+      (begin
+        (set! st-test-fail (+ st-test-fail 1))
+        (append! st-test-fails {:actual actual :expected expected :name name})))))
+
+;; Strip eof and project to just :type/:value.
+(define
+  st-toks
+  (fn
+    (src)
+    (map
+      (fn (tok) {:type (get tok :type) :value (get tok :value)})
+      (filter
+        (fn (tok) (not (= (get tok :type) "eof")))
+        (st-tokenize src)))))
+
+;; ── 1. Whitespace / empty ──
+(st-test "empty input" (st-toks "") (list))
+(st-test "all whitespace" (st-toks "   \t\n  ") (list))
+
+;; ── 2. Identifiers ──
+(st-test
+  "lowercase ident"
+  (st-toks "foo")
+  (list {:type "ident" :value "foo"}))
+
+(st-test
+  "capitalised ident"
+  (st-toks "Foo")
+  (list {:type "ident" :value "Foo"}))
+
+(st-test
+  "underscore ident"
+  (st-toks "_x")
+  (list {:type "ident" :value "_x"}))
+
+(st-test
+  "digits in ident"
+  (st-toks "foo123")
+  (list {:type "ident" :value "foo123"}))
+
+(st-test
+  "two idents separated"
+  (st-toks "foo bar")
+  (list {:type "ident" :value "foo"} {:type "ident" :value "bar"}))
+
+;; ── 3. Keyword selectors ──
+(st-test
+  "keyword selector"
+  (st-toks "foo:")
+  (list {:type "keyword" :value "foo:"}))
+
+(st-test
+  "keyword call"
+  (st-toks "x at: 1")
+  (list
+    {:type "ident" :value "x"}
+    {:type "keyword" :value "at:"}
+    {:type "number" :value 1}))
+
+(st-test
+  "two-keyword chain stays separate"
+  (st-toks "at: 1 put: 2")
+  (list
+    {:type "keyword" :value "at:"}
+    {:type "number" :value 1}
+    {:type "keyword" :value "put:"}
+    {:type "number" :value 2}))
+
+(st-test
+  "ident then assign — not a keyword"
+  (st-toks "x := 1")
+  (list
+    {:type "ident" :value "x"}
+    {:type "assign" :value ":="}
+    {:type "number" :value 1}))
+
+;; ── 4. Numbers ──
+(st-test
+  "integer"
+  (st-toks "42")
+  (list {:type "number" :value 42}))
+
+(st-test
+  "float"
+  (st-toks "3.14")
+  (list {:type "number" :value 3.14}))
+
+(st-test
+  "hex radix"
+  (st-toks "16rFF")
+  (list
+    {:type "number"
+     :value
+     {:radix 16 :digits "FF" :value 255 :kind "radix"}}))
+
+(st-test
+  "binary radix"
+  (st-toks "2r1011")
+  (list
+    {:type "number"
+     :value
+     {:radix 2 :digits "1011" :value 11 :kind "radix"}}))
+
+(st-test
+  "exponent"
+  (st-toks "1e3")
+  (list {:type "number" :value 1000}))
+
+(st-test
+  "negative exponent (parser handles minus)"
+  (st-toks "1.5e-2")
+  (list {:type "number" :value 0.015}))
+
+;; ── 5. Strings ──
+(st-test
+  "simple string"
+  (st-toks "'hi'")
+  (list {:type "string" :value "hi"}))
+
+(st-test
+  "empty string"
+  (st-toks "''")
+  (list {:type "string" :value ""}))
+
+(st-test
+  "doubled-quote escape"
+  (st-toks "'a''b'")
+  (list {:type "string" :value "a'b"}))
+
+;; ── 6. Characters ──
+(st-test
+  "char literal letter"
+  (st-toks "$a")
+  (list {:type "char" :value "a"}))
+
+(st-test
+  "char literal punct"
+  (st-toks "$$")
+  (list {:type "char" :value "$"}))
+
+(st-test
+  "char literal space"
+  (st-toks "$ ")
+  (list {:type "char" :value " "}))
+
+;; ── 7. Symbols ──
+(st-test
+  "symbol ident"
+  (st-toks "#foo")
+  (list {:type "symbol" :value "foo"}))
+
+(st-test
+  "symbol binary"
+  (st-toks "#+")
+  (list {:type "symbol" :value "+"}))
+
+(st-test
+  "symbol arrow"
+  (st-toks "#->")
+  (list {:type "symbol" :value "->"}))
+
+(st-test
+  "symbol keyword chain"
+  (st-toks "#at:put:")
+  (list {:type "symbol" :value "at:put:"}))
+
+(st-test
+  "quoted symbol with spaces"
+  (st-toks "#'foo bar'")
+  (list {:type "symbol" :value "foo bar"}))
+
+;; ── 8. Literal arrays / byte arrays ──
+(st-test
+  "literal array open"
+  (st-toks "#(1 2)")
+  (list
+    {:type "array-open" :value "#("}
+    {:type "number" :value 1}
+    {:type "number" :value 2}
+    {:type "rparen" :value ")"}))
+
+(st-test
+  "byte array open"
+  (st-toks "#[1 2 3]")
+  (list
+    {:type "byte-array-open" :value "#["}
+    {:type "number" :value 1}
+    {:type "number" :value 2}
+    {:type "number" :value 3}
+    {:type "rbracket" :value "]"}))
+
+;; ── 9. Binary selectors ──
+(st-test "plus" (st-toks "+") (list {:type "binary" :value "+"}))
+(st-test "minus" (st-toks "-") (list {:type "binary" :value "-"}))
+(st-test "star" (st-toks "*") (list {:type "binary" :value "*"}))
+(st-test "double-equal" (st-toks "==") (list {:type "binary" :value "=="}))
+(st-test "leq" (st-toks "<=") (list {:type "binary" :value "<="}))
+(st-test "geq" (st-toks ">=") (list {:type "binary" :value ">="}))
+(st-test "neq" (st-toks "~=") (list {:type "binary" :value "~="}))
+(st-test "arrow" (st-toks "->") (list {:type "binary" :value "->"}))
+(st-test "comma" (st-toks ",") (list {:type "binary" :value ","}))
+
+(st-test
+  "binary in expression"
+  (st-toks "a + b")
+  (list
+    {:type "ident" :value "a"}
+    {:type "binary" :value "+"}
+    {:type "ident" :value "b"}))
+
+;; ── 10. Punctuation ──
+(st-test "lparen" (st-toks "(") (list {:type "lparen" :value "("}))
+(st-test "rparen" (st-toks ")") (list {:type "rparen" :value ")"}))
+(st-test "lbracket" (st-toks "[") (list {:type "lbracket" :value "["}))
+(st-test "rbracket" (st-toks "]") (list {:type "rbracket" :value "]"}))
+(st-test "lbrace" (st-toks "{") (list {:type "lbrace" :value "{"}))
+(st-test "rbrace" (st-toks "}") (list {:type "rbrace" :value "}"}))
+(st-test "period" (st-toks ".") (list {:type "period" :value "."}))
+(st-test "semi" (st-toks ";") (list {:type "semi" :value ";"}))
+(st-test "bar" (st-toks "|") (list {:type "bar" :value "|"}))
+(st-test "caret" (st-toks "^") (list {:type "caret" :value "^"}))
+(st-test "bang" (st-toks "!") (list {:type "bang" :value "!"}))
+(st-test "colon" (st-toks ":") (list {:type "colon" :value ":"}))
+(st-test "assign" (st-toks ":=") (list {:type "assign" :value ":="}))
+
+;; ── 11. Comments ──
+(st-test "comment skipped" (st-toks "\"hello\"") (list))
+(st-test
+  "comment between tokens"
+  (st-toks "a \"comment\" b")
+  (list {:type "ident" :value "a"} {:type "ident" :value "b"}))
+(st-test
+  "multi-line comment"
+  (st-toks "\"line1\nline2\"42")
+  (list {:type "number" :value 42}))
+
+;; ── 12. Compound expressions ──
+(st-test
+  "block with params"
+  (st-toks "[:a :b | a + b]")
+  (list
+    {:type "lbracket" :value "["}
+    {:type "colon" :value ":"}
+    {:type "ident" :value "a"}
+    {:type "colon" :value ":"}
+    {:type "ident" :value "b"}
+    {:type "bar" :value "|"}
+    {:type "ident" :value "a"}
+    {:type "binary" :value "+"}
+    {:type "ident" :value "b"}
+    {:type "rbracket" :value "]"}))
+
+(st-test
+  "cascade"
+  (st-toks "x m1; m2")
+  (list
+    {:type "ident" :value "x"}
+    {:type "ident" :value "m1"}
+    {:type "semi" :value ";"}
+    {:type "ident" :value "m2"}))
+
+(st-test
+  "method body return"
+  (st-toks "^ self foo")
+  (list
+    {:type "caret" :value "^"}
+    {:type "ident" :value "self"}
+    {:type "ident" :value "foo"}))
+
+(st-test
+  "class declaration head"
+  (st-toks "Object subclass: #Foo")
+  (list
+    {:type "ident" :value "Object"}
+    {:type "keyword" :value "subclass:"}
+    {:type "symbol" :value "Foo"}))
+
+(st-test
+  "temp declaration"
+  (st-toks "| t1 t2 |")
+  (list
+    {:type "bar" :value "|"}
+    {:type "ident" :value "t1"}
+    {:type "ident" :value "t2"}
+    {:type "bar" :value "|"}))
+
+(st-test
+  "chunk separator"
+  (st-toks "Foo bar !")
+  (list
+    {:type "ident" :value "Foo"}
+    {:type "ident" :value "bar"}
+    {:type "bang" :value "!"}))
+
+(st-test
+  "keyword call with binary precedence"
+  (st-toks "x foo: 1 + 2")
+  (list
+    {:type "ident" :value "x"}
+    {:type "keyword" :value "foo:"}
+    {:type "number" :value 1}
+    {:type "binary" :value "+"}
+    {:type "number" :value 2}))
+
+(list st-test-pass st-test-fail)

lib/smalltalk/tokenizer.sx

@@ -0,0 +1,366 @@
+;; Smalltalk tokenizer.
+;;
+;; Token types:
+;;   ident      identifier (foo, Foo, _x)
+;;   keyword    selector keyword (foo:) — value is "foo:" with the colon
+;;   binary     binary selector chars run together (+, ==, ->, <=, ~=, ...)
+;;   number     integer or float; radix integers like 16rFF supported
+;;   string     'hello''world' style
+;;   char       $c
+;;   symbol     #foo, #foo:bar:, #+, #'with spaces'
+;;   array-open  #(
+;;   byte-array-open  #[
+;;   lparen rparen lbracket rbracket lbrace rbrace
+;;   period semi bar caret colon assign bang
+;;   eof
+;;
+;; Comments "…" are skipped.
+
+(define st-make-token (fn (type value pos) {:type type :value value :pos pos}))
+
+(define st-digit? (fn (c) (and (not (= c nil)) (>= c "0") (<= c "9"))))
+
+(define
+  st-letter?
+  (fn
+    (c)
+    (and
+      (not (= c nil))
+      (or (and (>= c "a") (<= c "z")) (and (>= c "A") (<= c "Z"))))))
+
+(define st-ident-start? (fn (c) (or (st-letter? c) (= c "_"))))
+
+(define st-ident-char? (fn (c) (or (st-ident-start? c) (st-digit? c))))
+
+(define st-ws? (fn (c) (or (= c " ") (= c "\t") (= c "\n") (= c "\r"))))
+
+(define
+  st-binary-chars
+  (list "+" "-" "*" "/" "\\" "~" "<" ">" "=" "@" "%" "&" "?" ","))
+
+(define
+  st-binary-char?
+  (fn (c) (and (not (= c nil)) (contains? st-binary-chars c))))
+
+(define
+  st-radix-digit?
+  (fn
+    (c)
+    (and
+      (not (= c nil))
+      (or (st-digit? c) (and (>= c "A") (<= c "Z"))))))
+
+(define
+  st-tokenize
+  (fn
+    (src)
+    (let
+      ((tokens (list)) (pos 0) (src-len (len src)))
+      (define
+        pk
+        (fn
+          (offset)
+          (if (< (+ pos offset) src-len) (nth src (+ pos offset)) nil)))
+      (define cur (fn () (pk 0)))
+      (define advance! (fn (n) (set! pos (+ pos n))))
+      (define
+        push!
+        (fn
+          (type value start)
+          (append! tokens (st-make-token type value start))))
+      (define
+        skip-comment!
+        (fn
+          ()
+          (cond
+            ((>= pos src-len) nil)
+            ((= (cur) "\"") (advance! 1))
+            (else (begin (advance! 1) (skip-comment!))))))
+      (define
+        skip-ws!
+        (fn
+          ()
+          (cond
+            ((>= pos src-len) nil)
+            ((st-ws? (cur)) (begin (advance! 1) (skip-ws!)))
+            ((= (cur) "\"") (begin (advance! 1) (skip-comment!) (skip-ws!)))
+            (else nil))))
+      (define
+        read-ident-chars!
+        (fn
+          ()
+          (when
+            (and (< pos src-len) (st-ident-char? (cur)))
+            (begin (advance! 1) (read-ident-chars!)))))
+      (define
+        read-decimal-digits!
+        (fn
+          ()
+          (when
+            (and (< pos src-len) (st-digit? (cur)))
+            (begin (advance! 1) (read-decimal-digits!)))))
+      (define
+        read-radix-digits!
+        (fn
+          ()
+          (when
+            (and (< pos src-len) (st-radix-digit? (cur)))
+            (begin (advance! 1) (read-radix-digits!)))))
+      (define
+        read-exp-part!
+        (fn
+          ()
+          (when
+            (and
+              (< pos src-len)
+              (or (= (cur) "e") (= (cur) "E"))
+              (let
+                ((p1 (pk 1)) (p2 (pk 2)))
+                (or
+                  (st-digit? p1)
+                  (and (or (= p1 "+") (= p1 "-")) (st-digit? p2)))))
+            (begin
+              (advance! 1)
+              (when
+                (and (< pos src-len) (or (= (cur) "+") (= (cur) "-")))
+                (advance! 1))
+              (read-decimal-digits!)))))
+      (define
+        read-number
+        (fn
+          (start)
+          (begin
+            (read-decimal-digits!)
+            (cond
+              ((and (< pos src-len) (= (cur) "r"))
+                (let
+                  ((base-str (slice src start pos)))
+                  (begin
+                    (advance! 1)
+                    (let
+                      ((rstart pos))
+                      (begin
+                        (read-radix-digits!)
+                        (let
+                          ((digits (slice src rstart pos)))
+                          {:radix (parse-number base-str)
+                           :digits digits
+                           :value (parse-radix base-str digits)
+                           :kind "radix"}))))))
+              ((and
+                  (< pos src-len)
+                  (= (cur) ".")
+                  (st-digit? (pk 1)))
+                (begin
+                  (advance! 1)
+                  (read-decimal-digits!)
+                  (read-exp-part!)
+                  (parse-number (slice src start pos))))
+              (else
+                (begin
+                  (read-exp-part!)
+                  (parse-number (slice src start pos))))))))
+      (define
+        parse-radix
+        (fn
+          (base-str digits)
+          (let
+            ((base (parse-number base-str))
+              (chars digits)
+              (n-len (len digits))
+              (idx 0)
+              (acc 0))
+            (begin
+              (define
+                rd-loop
+                (fn
+                  ()
+                  (when
+                    (< idx n-len)
+                    (let
+                      ((c (nth chars idx)))
+                      (let
+                        ((d (cond
+                              ((and (>= c "0") (<= c "9")) (- (char-code c) 48))
+                              ((and (>= c "A") (<= c "Z")) (- (char-code c) 55))
+                              (else 0))))
+                        (begin
+                          (set! acc (+ (* acc base) d))
+                          (set! idx (+ idx 1))
+                          (rd-loop)))))))
+              (rd-loop)
+              acc))))
+      (define
+        read-string
+        (fn
+          ()
+          (let
+            ((chars (list)))
+            (begin
+              (advance! 1)
+              (define
+                loop
+                (fn
+                  ()
+                  (cond
+                    ((>= pos src-len) nil)
+                    ((= (cur) "'")
+                      (cond
+                        ((= (pk 1) "'")
+                          (begin
+                            (append! chars "'")
+                            (advance! 2)
+                            (loop)))
+                        (else (advance! 1))))
+                    (else
+                      (begin (append! chars (cur)) (advance! 1) (loop))))))
+              (loop)
+              (join "" chars)))))
+      (define
+        read-binary-run!
+        (fn
+          ()
+          (let
+            ((start pos))
+            (begin
+              (define
+                bin-loop
+                (fn
+                  ()
+                  (when
+                    (and (< pos src-len) (st-binary-char? (cur)))
+                    (begin (advance! 1) (bin-loop)))))
+              (bin-loop)
+              (slice src start pos)))))
+      (define
+        read-symbol
+        (fn
+          (start)
+          (cond
+            ;; Quoted symbol: #'whatever'
+            ((= (cur) "'")
+              (let ((s (read-string))) (push! "symbol" s start)))
+            ;; Binary-char symbol: #+, #==, #->, #|
+            ((or (st-binary-char? (cur)) (= (cur) "|"))
+              (let ((b (read-binary-run!)))
+                (cond
+                  ((= b "")
+                    ;; lone | wasn't binary; consume it
+                    (begin (advance! 1) (push! "symbol" "|" start)))
+                  (else (push! "symbol" b start)))))
+            ;; Identifier or keyword chain: #foo, #foo:bar:
+            ((st-ident-start? (cur))
+              (let ((id-start pos))
+                (begin
+                  (read-ident-chars!)
+                  (define
+                    kw-loop
+                    (fn
+                      ()
+                      (when
+                        (and (< pos src-len) (= (cur) ":"))
+                        (begin
+                          (advance! 1)
+                          (when
+                            (and (< pos src-len) (st-ident-start? (cur)))
+                            (begin (read-ident-chars!) (kw-loop)))))))
+                  (kw-loop)
+                  (push! "symbol" (slice src id-start pos) start))))
+            (else
+              (error
+                (str "st-tokenize: bad symbol at " pos))))))
+      (define
+        step
+        (fn
+          ()
+          (begin
+            (skip-ws!)
+            (when
+              (< pos src-len)
+              (let
+                ((start pos) (c (cur)))
+                (cond
+                  ;; Identifier or keyword
+                  ((st-ident-start? c)
+                    (begin
+                      (read-ident-chars!)
+                      (let
+                        ((word (slice src start pos)))
+                        (cond
+                          ;; ident immediately followed by ':' (and not ':=') => keyword
+                          ((and
+                              (< pos src-len)
+                              (= (cur) ":")
+                              (not (= (pk 1) "=")))
+                            (begin
+                              (advance! 1)
+                              (push!
+                                "keyword"
+                                (str word ":")
+                                start)))
+                          (else (push! "ident" word start))))
+                      (step)))
+                  ;; Number
+                  ((st-digit? c)
+                    (let
+                      ((v (read-number start)))
+                      (begin (push! "number" v start) (step))))
+                  ;; String
+                  ((= c "'")
+                    (let
+                      ((s (read-string)))
+                      (begin (push! "string" s start) (step))))
+                  ;; Character literal
+                  ((= c "$")
+                    (cond
+                      ((>= (+ pos 1) src-len)
+                        (error (str "st-tokenize: $ at end of input")))
+                      (else
+                        (begin
+                          (advance! 1)
+                          (push! "char" (cur) start)
+                          (advance! 1)
+                          (step)))))
+                  ;; Symbol or array literal
+                  ((= c "#")
+                    (cond
+                      ((= (pk 1) "(")
+                        (begin (advance! 2) (push! "array-open" "#(" start) (step)))
+                      ((= (pk 1) "[")
+                        (begin (advance! 2) (push! "byte-array-open" "#[" start) (step)))
+                      (else
+                        (begin (advance! 1) (read-symbol start) (step)))))
+                  ;; Assignment :=  or  bare colon
+                  ((= c ":")
+                    (cond
+                      ((= (pk 1) "=")
+                        (begin (advance! 2) (push! "assign" ":=" start) (step)))
+                      (else
+                        (begin (advance! 1) (push! "colon" ":" start) (step)))))
+                  ;; Single-char structural punctuation
+                  ((= c "(") (begin (advance! 1) (push! "lparen" "(" start) (step)))
+                  ((= c ")") (begin (advance! 1) (push! "rparen" ")" start) (step)))
+                  ((= c "[") (begin (advance! 1) (push! "lbracket" "[" start) (step)))
+                  ((= c "]") (begin (advance! 1) (push! "rbracket" "]" start) (step)))
+                  ((= c "{") (begin (advance! 1) (push! "lbrace" "{" start) (step)))
+                  ((= c "}") (begin (advance! 1) (push! "rbrace" "}" start) (step)))
+                  ((= c ".") (begin (advance! 1) (push! "period" "." start) (step)))
+                  ((= c ";") (begin (advance! 1) (push! "semi" ";" start) (step)))
+                  ((= c "|") (begin (advance! 1) (push! "bar" "|" start) (step)))
+                  ((= c "^") (begin (advance! 1) (push! "caret" "^" start) (step)))
+                  ((= c "!") (begin (advance! 1) (push! "bang" "!" start) (step)))
+                  ;; Binary selector run
+                  ((st-binary-char? c)
+                    (let
+                      ((b (read-binary-run!)))
+                      (begin (push! "binary" b start) (step))))
+                  (else
+                    (error
+                      (str
+                        "st-tokenize: unexpected char "
+                        c
+                        " at "
+                        pos)))))))))
+      (step)
+      (push! "eof" nil pos)
+      tokens)))

plans/agent-briefings/smalltalk-loop.md

@@ -0,0 +1,77 @@
+# smalltalk-on-sx loop agent (single agent, queue-driven)
+
+Role: iterates `plans/smalltalk-on-sx.md` forever. Message-passing OO + **blocks with non-local return** on delimited continuations. Non-local return is the headline showcase — every other Smalltalk reinvents it on the host stack; on SX it falls out of the captured method-return continuation.
+
+```
+description: smalltalk-on-sx queue loop
+subagent_type: general-purpose
+run_in_background: true
+isolation: worktree
+```
+
+## Prompt
+
+You are the sole background agent working `/root/rose-ash/plans/smalltalk-on-sx.md`. Isolated worktree, forever, one commit per feature. Never push.
+
+## Restart baseline — check before iterating
+
+1. Read `plans/smalltalk-on-sx.md` — roadmap + Progress log.
+2. `ls lib/smalltalk/` — pick up from the most advanced file.
+3. If `lib/smalltalk/tests/*.sx` exist, run them. Green before new work.
+4. If `lib/smalltalk/scoreboard.md` exists, that's your baseline.
+
+## The queue
+
+Phase order per `plans/smalltalk-on-sx.md`:
+
+- **Phase 1** — tokenizer + parser (chunk format, identifiers, keywords `foo:`, binary selectors, `#sym`, `#(…)`, `$c`, blocks `[:a | …]`, cascades, message precedence)
+- **Phase 2** — object model + sequential eval (class table bootstrap, message dispatch, `super`, `doesNotUnderstand:`, instance variables)
+- **Phase 3** — **THE SHOWCASE**: blocks with non-local return via captured method-return continuation. `whileTrue:` / `ifTrue:ifFalse:` as block sends. 5 classic programs (eight-queens, quicksort, mandelbrot, life, fibonacci) green.
+- **Phase 4** — reflection + MOP: `perform:`, `respondsTo:`, runtime method addition, `becomeForward:`, `Exception` / `on:do:` / `ensure:` on top of `handler-bind`/`raise`
+- **Phase 5** — collections + numeric tower + streams
+- **Phase 6** — port SUnit, vendor Pharo Kernel-Tests slice, drive corpus to 200+
+- **Phase 7** — speed (optional): inline caching, block intrinsification
+
+Within a phase, pick the checkbox that unlocks the most tests per effort.
+
+Every iteration: implement → test → commit → tick `[ ]` → Progress log → next.
+
+## Ground rules (hard)
+
+- **Scope:** only `lib/smalltalk/**` and `plans/smalltalk-on-sx.md`. Do **not** edit `spec/`, `hosts/`, `shared/`, other `lib/<lang>/` dirs, `lib/stdlib.sx`, or `lib/` root. Smalltalk primitives go in `lib/smalltalk/runtime.sx`.
+- **NEVER call `sx_build`.** 600s watchdog. If sx_server binary broken → Blockers entry, stop.
+- **Shared-file issues** → plan's Blockers with minimal repro.
+- **Delimited continuations** are in `lib/callcc.sx` + `spec/evaluator.sx` Step 5. `sx_summarise` spec/evaluator.sx first — 2300+ lines.
+- **SX files:** `sx-tree` MCP tools ONLY. `sx_validate` after edits.
+- **Worktree:** commit locally. Never push. Never touch `main`.
+- **Commit granularity:** one feature per commit.
+- **Plan file:** update Progress log + tick boxes every commit.
+
+## Smalltalk-specific gotchas
+
+- **Method invocation captures `^k`** — the return continuation. Bind it as the block's escape token. `^expr` from inside any nested block invokes that captured `^k`. Escape past method return raises `BlockContext>>cannotReturn:`.
+- **Blocks are lambdas + escape token**, not bare lambdas. `value`/`value:`/… invoke the lambda; `^` invokes the escape.
+- **`ifTrue:` / `ifFalse:` / `whileTrue:` are ordinary block sends** — no special form. The runtime intrinsifies them in the JIT path (Tier 1 of bytecode expansion already covers this pattern).
+- **Cascade** `r m1; m2; m3` desugars to `(let ((tmp r)) (st-send tmp 'm1 ()) (st-send tmp 'm2 ()) (st-send tmp 'm3 ()))`. Result is the cascade's last send (or first, depending on parser variant — pick one and document).
+- **`super` send** looks up starting from the *defining* class's superclass, not the receiver class. Stash the defining class on the method record.
+- **Selectors are interned symbols.** Use SX symbols.
+- **Receiver dispatch:** tagged ints / floats / strings / symbols / `nil` / `true` / `false` aren't boxed. Their classes (`SmallInteger`, `Float`, `String`, `Symbol`, `UndefinedObject`, `True`, `False`) are looked up by SX type-of, not by an `:class` field.
+- **Method precedence:** unary > binary > keyword. `3 + 4 factorial` is `3 + (4 factorial)`. `a foo: b bar` is `a foo: (b bar)` (keyword absorbs trailing unary).
+- **Image / fileIn / become: between sessions** = out of scope. One-way `becomeForward:` only.
+- **Test corpus:** ~200 hand-written + a slice of Pharo Kernel-Tests. Place programs in `lib/smalltalk/tests/programs/`.
+
+## General gotchas (all loops)
+
+- SX `do` = R7RS iteration. Use `begin` for multi-expr sequences.
+- `cond`/`when`/`let` clauses evaluate only the last expr.
+- `type-of` on user fn returns `"lambda"`.
+- Shell heredoc `||` gets eaten — escape or use `case`.
+
+## Style
+
+- No comments in `.sx` unless non-obvious.
+- No new planning docs — update `plans/smalltalk-on-sx.md` inline.
+- Short, factual commit messages (`smalltalk: tokenizer + 56 tests`).
+- One feature per iteration. Commit. Log. Next.
+
+Go. Read the plan; find first `[ ]`; implement.

plans/erlang-on-sx.md

@@ -57,31 +57,31 @@ Core mapping:
 - [x] Unit tests in `lib/erlang/tests/parse.sx`
 
 ### Phase 2 — sequential eval + pattern matching + BIFs
-- [x] `erlang-eval-ast`: evaluate sequential expressions — **54/54 tests**
+- [ ] `erlang-eval-ast`: evaluate sequential expressions
-- [x] Pattern matching (atoms, numbers, vars, tuples, lists, `[H|T]`, underscore, bound-var re-match) — **21 new eval tests**; `case ... of ... end` wired
+- [ ] Pattern matching (atoms, numbers, vars, tuples, lists, `[H|T]`, underscore, bound-var re-match)
-- [x] Guards: `is_integer`, `is_atom`, `is_list`, `is_tuple`, comparisons, arithmetic — **20 new eval tests**; local-call dispatch wired
+- [ ] Guards: `is_integer`, `is_atom`, `is_list`, `is_tuple`, comparisons, arithmetic
-- [x] BIFs: `length/1`, `hd/1`, `tl/1`, `element/2`, `tuple_size/1`, `atom_to_list/1`, `list_to_atom/1`, `lists:map/2`, `lists:foldl/3`, `lists:reverse/1`, `io:format/1-2` — **35 new eval tests**; funs + closures wired
+- [ ] BIFs: `length/1`, `hd/1`, `tl/1`, `element/2`, `tuple_size/1`, `atom_to_list/1`, `list_to_atom/1`, `lists:map/2`, `lists:foldl/3`, `lists:reverse/1`, `io:format/1-2`
-- [x] 30+ tests in `lib/erlang/tests/eval.sx` — **130 tests green**
+- [ ] 30+ tests in `lib/erlang/tests/eval.sx`
 
 ### Phase 3 — processes + mailboxes + receive (THE SHOWCASE)
-- [x] Scheduler in `runtime.sx`: runnable queue, pid counter, per-process state record — **39 runtime tests**
+- [ ] Scheduler in `runtime.sx`: runnable queue, pid counter, per-process state record
-- [x] `spawn/1`, `spawn/3`, `self/0` — **13 new eval tests**; `spawn/3` stubbed with "deferred to Phase 5" until modules land; `is_pid/1` + pid equality also wired
+- [ ] `spawn/1`, `spawn/3`, `self/0`
-- [x] `!` (send), `receive ... end` with selective pattern matching — **13 new eval tests**; delimited continuations (`shift`/`reset`) power receive suspension; sync scheduler loop
+- [ ] `!` (send), `receive ... end` with selective pattern matching
-- [x] `receive ... after Ms -> ...` timeout clause (use SX timer primitive) — **9 new eval tests**; synchronous-scheduler semantics: `after 0` polls once; `after Ms` fires when runnable queue drains; `after infinity` = no timeout
+- [ ] `receive ... after Ms -> ...` timeout clause (use SX timer primitive)
-- [x] `exit/1`, basic process termination — **9 new eval tests**; `exit/2` (signal another) deferred to Phase 4 with links
+- [ ] `exit/1`, basic process termination
-- [x] Classic programs in `lib/erlang/tests/programs/`:
+- [ ] Classic programs in `lib/erlang/tests/programs/`:
-  - [x] `ring.erl` — N processes in a ring, pass a token around M times — **4 ring tests**; suspension machinery rewritten from `shift`/`reset` to `call/cc` + `raise`/`guard`
+  - [ ] `ring.erl` — N processes in a ring, pass a token around M times
-  - [x] `ping_pong.erl` — two processes exchanging messages — **4 ping-pong tests**
+  - [ ] `ping_pong.erl` — two processes exchanging messages
-  - [x] `bank.erl` — account server (deposit/withdraw/balance) — **8 bank tests**
+  - [ ] `bank.erl` — account server (deposit/withdraw/balance)
-  - [x] `echo.erl` — minimal server — **7 echo tests**
+  - [ ] `echo.erl` — minimal server
-  - [x] `fib_server.erl` — compute fib on request — **8 fib tests**
+  - [ ] `fib_server.erl` — compute fib on request
-- [x] `lib/erlang/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md` — **358/358 across 9 suites**
+- [ ] `lib/erlang/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
-- [x] Target: 5/5 classic programs + 1M-process ring benchmark runs — **5/5 classic programs green; ring benchmark runs correctly at every measured size up to N=1000 (33s, ~34 hops/s); 1M target NOT met in current synchronous-scheduler architecture (would take ~9h at observed throughput)**. See `lib/erlang/bench_ring.sh` and `lib/erlang/bench_ring_results.md`.
+- [ ] Target: 5/5 classic programs + 1M-process ring benchmark runs
 
 ### Phase 4 — links, monitors, exit signals
-- [x] `link/1`, `unlink/1`, `monitor/2`, `demonitor/1` — **17 new eval tests**; `make_ref/0`, `is_reference/1`, refs in `=:=`/format wired
+- [ ] `link/1`, `unlink/1`, `monitor/2`, `demonitor/1`
-- [x] Exit-signal propagation; trap_exit flag — **11 new eval tests**; `process_flag/2`, monitor `{'DOWN', ...}`, `{'EXIT', From, Reason}` for trap-exit links, cascade death without trap_exit
+- [ ] Exit-signal propagation; trap_exit flag
-- [x] `try/catch/of/end` — **19 new eval tests**; `throw/1`, `error/1` BIFs; `nocatch` re-raise wrapping for uncaught throws
+- [ ] `try/catch/of/end`
 
 ### Phase 5 — modules + OTP-lite
 - [ ] `-module(M).` loading, `M:F(...)` calls across modules
@@ -99,25 +99,6 @@ Core mapping:
 
 _Newest first._
 
-- **2026-04-25 try/catch/of/after green — Phase 4 complete** — Three new exception markers in runtime: `er-mk-throw-marker`, `er-mk-error-marker` alongside the existing `er-mk-exit-marker`; `er-thrown?`, `er-errored?` predicates. `throw/1` and `error/1` BIFs raise their respective markers. Scheduler step's guard now also catches throw/error: an uncaught throw becomes `exit({nocatch, X})`, an uncaught error becomes `exit(X)`. `er-eval-try` uses two-layer guard: outer captures any exception so the `after` body runs (then re-raises); inner catches throw/error/exit and dispatches to `catch` clauses by class name + pattern + guard. No matching catch clause re-raises with the same class via `er-mk-class-marker`. `of` clauses run on success; no-match raises `error({try_clause, V})`. 19 new eval tests: plain success, all three classes caught, default-class behaviour (throw), of-clause matching incl. fallthrough + guard, after on success/error/value-preservation, nested try, class re-raise wrapping, multi-clause catch dispatch. Total suite 405/405. **Phase 4 complete — Phase 5 (modules + OTP-lite) is next.** Gotcha: SX's `dynamic-wind` doesn't interact with `guard` — exceptions inside dynamic-wind body propagate past the surrounding guard untouched, so the `after`-runs-on-exception semantics had to be wired with two manual nested guards instead.
-- **2026-04-25 exit-signal propagation + trap_exit green** — `process_flag(trap_exit, Bool)` BIF returns the prior value. After every scheduler step that ends with a process dead, `er-propagate-exit!` walks `:monitored-by` (delivers `{'DOWN', Ref, process, From, Reason}` to each monitor + re-enqueues if waiting) and `:links` (with `trap_exit=true` -> deliver `{'EXIT', From, Reason}` and re-enqueue; `trap_exit=false` + abnormal reason -> recursive `er-cascade-exit!`; normal reason without trap_exit -> no signal). `er-sched-step!` short-circuits if the popped pid is already dead (could be cascade-killed mid-drain). 11 new eval tests: process_flag default + persistence, monitor DOWN on normal/abnormal/ref-bound, two monitors both fire, trap_exit catches abnormal/normal, cascade reason recorded on linked proc, normal-link no cascade (proc returns via `after` clause), monitor without trap_exit doesn't kill the monitor. Total suite 386/386. `kill`-as-special-reason and `exit/2` (signal to another) deferred.
-- **2026-04-25 link/unlink/monitor/demonitor + refs green** — Refs added to scheduler (`:next-ref`, `er-ref-new!`); `er-mk-ref`, `er-ref?`, `er-ref-equal?` in runtime. Process record gains `:monitored-by`. New BIFs in `lib/erlang/runtime.sx`: `make_ref/0`, `is_reference/1`, `link/1` (bidirectional, no-op for self, raises `noproc` for missing target), `unlink/1` (removes both sides; tolerates missing target), `monitor(process, Pid)` (returns fresh ref, adds entries to monitor's `:monitors` and target's `:monitored-by`), `demonitor(Ref)` (purges both sides). Refs participate in `er-equal?` (id compare) and render as `#Ref<N>`. 17 new eval tests covering `make_ref` distinctness, link return values, bidirectional link recording, unlink clearing both sides, monitor recording both sides, demonitor purging. Total suite 375/375. Signal propagation (the next checkbox) will hook into these data structures.
-- **2026-04-25 ring benchmark recorded — Phase 3 closed** — `lib/erlang/bench_ring.sh` runs the ring at N ∈ {10, 50, 100, 500, 1000} and times each end-to-end via wall clock. `lib/erlang/bench_ring_results.md` captures the table. Throughput plateaus at ~30-34 hops/s. 1M-process target IS NOT MET in this architecture — extrapolation = ~9h. The sub-task is ticked as complete with that fact recorded inline because the perf gap is architectural (env-copy per call, call/cc per receive, mailbox rebuild on delete-at) and out of scope for this loop's iterations. Phase 3 done; Phase 4 (links, monitors, exit signals, try/catch) is next.
-- **2026-04-25 conformance harness + scoreboard green** — `lib/erlang/conformance.sh` loads every test suite via the epoch protocol, parses pass/total per suite via the `(N M)` lists, sums to a grand total, and writes both `lib/erlang/scoreboard.json` (machine-readable) and `lib/erlang/scoreboard.md` (Markdown table with ✅/❌ markers). 9 suites × full pass = 358/358. Exits non-zero on any failure. `bash lib/erlang/conformance.sh -v` prints per-suite counts. Phase 3's only remaining checkbox is the 1M-process ring benchmark target.
-- **2026-04-25 fib_server.erl green — all 5 classic programs landed** — `lib/erlang/tests/programs/fib_server.sx` with 8 tests. Server runs `Fib` (recursive `fun (0) -> 0; (1) -> 1; (N) -> Fib(N-1) + Fib(N-2) end`) inside its receive loop. Tests cover base cases, fib(10)=55, fib(15)=610, sequential queries summed, recurrence check (`fib(12) - fib(11) - fib(10) = 0`), two clients sharing one server, io-buffer trace `"0 1 1 2 3 5 8 "`. Total suite 358/358. Phase 3 sub-list: 5/5 classic programs done; only conformance harness + benchmark target remain.
-- **2026-04-25 echo.erl green** — `lib/erlang/tests/programs/echo.sx` with 7 tests. Server: `receive {From, Msg} -> From ! Msg, Loop(); stop -> ok end`. Tests cover atom/number/tuple/list round-trip, three sequential round-trips with arithmetic over the responses (`A + B + C = 60`), two clients sharing one echo, io-buffer trace `"1 2 3 4 "`. Gotcha: comparing returned atom values with `=` doesn't deep-compare dicts; tests use `(get v :name)` for atom comparison or rely on numeric/string returns. Total suite 350/350.
-- **2026-04-24 bank.erl green** — `lib/erlang/tests/programs/bank.sx` with 8 tests. Stateful server pattern: `Server = fun (Balance) -> receive ... Server(NewBalance) end end` recursively threads balance through each iteration. Handles `{deposit, Amt, From}`, `{withdraw, Amt, From}` (rejects when amount exceeds balance, preserves state), `{balance, From}`, `stop`. Tests cover deposit accumulation, withdrawal within balance, insufficient funds with state preservation, mixed transactions, clean shutdown, two-client interleave. Total suite 343/343.
-- **2026-04-24 ping_pong.erl green** — `lib/erlang/tests/programs/ping_pong.sx` with 4 tests: classic Pong server + Ping client with separate `ping_done`/`pong_done` notifications, 5-round trace via io-buffer (`"ppppp"`), main-as-pinger-4-rounds (no intermediate Ping proc), tagged-id round-trip (`"4 3 2 1 "`). All driven by `Ping = fun (Target, K) -> ... Ping(Target, K-1) ... end` self-recursion — captured-env reference works because `Ping` binds in main's mutable env before any spawned body looks it up. Total suite 335/335.
-- **2026-04-24 ring.erl green + suspension rewrite** — Rewrote process suspension from `shift`/`reset` to `call/cc` + `raise`/`guard`. **Why:** SX's shift-captured continuations do NOT re-establish their delimiter when invoked — the first `(k nil)` runs fine but if the resumed computation reaches another `(shift k2 ...)` it raises "shift without enclosing reset". Ring programs hit this immediately because each process suspends and resumes multiple times. `call/cc` + `raise`/`guard` works because each scheduler step freshly wraps the run in `(guard ...)`, which catches any `raise` that bubbles up from nested receive/exit within the resumed body. Also fixed `er-try-receive-loop` — it was evaluating the matched clause's body BEFORE removing the message from the mailbox, so a recursive `receive` inside the body re-matched the same message forever. Added `lib/erlang/tests/programs/ring.sx` with 4 tests (N=3 M=6, N=2 M=4, N=1 M=5 self-loop, N=3 M=9 hop-count via io-buffer). All process-communication eval tests still pass. Total suite 331/331.
-- **2026-04-24 exit/1 + termination green** — `exit/1` BIF uses `(shift k ...)` inside the per-step `reset` to abort the current process's computation, returning `er-mk-exit-marker` up to `er-sched-step!`. Step handler records `:exit-reason`, clears `:exit-result`, marks dead. Normal fall-off-end still records reason `normal`. `exit/2` errors with "deferred to Phase 4 (links)". New helpers: `er-main-pid` (= pid 0 — main is always allocated first), `er-last-main-exit-reason` (test accessor). 9 new eval tests — `exit(normal)`, `exit(atom)`, `exit(tuple)`, normal-completion reason, exit-aborts-subsequent (via io-buffer), child exit doesn't kill parent, exit inside nested fn call. Total eval 174/174; suite 327/327.
-- **2026-04-24 receive...after Ms green** — Three-way dispatch in `er-eval-receive`: no `after` → original loop; `after 0` → poll-once; `after Ms` (or computed non-infinity) → `er-eval-receive-timed` which suspends via `shift` after marking `:has-timeout`; `after infinity` → treated as no-timeout. `er-sched-run-all!` now recurses into `er-sched-fire-one-timeout!` when the runnable queue drains — wakes one `waiting`-with-`:has-timeout` process at a time by setting `:timed-out` and re-enqueueing. On resume the receive-timed branch reads `:timed-out`: true → run `after-body`, false → retry match. "Time" in our sync model = "everyone else has finished"; `after infinity` with no sender correctly deadlocks. 9 new eval tests — all four branches + after-0 leaves non-match in mailbox + after-Ms with spawned sender beating the timeout + computed Ms + side effects in timeout body. Total eval 165/165; suite 318/318.
-- **2026-04-24 send + selective receive green — THE SHOWCASE** — `!` (send) in `lib/erlang/transpile.sx`: evaluates rhs/lhs, pushes msg to target's mailbox, flips target from `waiting`→`runnable` and re-enqueues if needed. `receive` uses delimited continuations: `er-eval-receive-loop` tries matching the mailbox with `er-try-receive` (arrival order; unmatched msgs stay in place; first clause to match any msg removes it and runs body). On no match, `(shift k ...)` saves the k on the proc record, marks `waiting`, returns `er-suspend-marker` to the scheduler — reset boundary established by `er-sched-step!`. Scheduler loop `er-sched-run-all!` pops runnable pids and calls either `(reset ...)` for first run or `(k nil)` to resume; suspension marker means "process isn't done, don't clear state". `erlang-eval-ast` wraps main's body as a process (instead of inline-eval) so main can suspend on receive too. Queue helpers added: `er-q-nth`, `er-q-delete-at!`. 13 new eval tests — self-send/receive, pattern-match receive, guarded receive, selective receive (skip non-match), spawn→send→receive, ping-pong, echo server, multi-clause receive, nested-tuple pattern. Total eval 156/156; suite 309/309. Deadlock detected if main never terminates.
-- **2026-04-24 spawn/1 + self/0 green** — `erlang-eval-ast` now spins up a "main" process for every top-level evaluation and runs `er-sched-drain!` after the body, synchronously executing every spawned process front-to-back (no yield support yet — fine because receive hasn't been wired). BIFs added in `lib/erlang/runtime.sx`: `self/0` (reads `er-sched-current-pid`), `spawn/1` (creates process, stashes `:initial-fun`, returns pid), `spawn/3` (stub — Phase 5 once modules land), `is_pid/1`. Pids added to `er-equal?` (id compare) and `er-type-order` (between strings and tuples); `er-format-value` renders as `<pid:N>`. 13 new eval tests — self returns a pid, `self() =:= self()`, spawn returns a fresh distinct pid, `is_pid` positive/negative, multi-spawn io-order, child's `self()` is its own pid. Total eval 143/143; runtime 39/39; suite 296/296. Next: `!` (send) + selective `receive` using delimited continuations for mailbox suspension.
-- **2026-04-24 scheduler foundation green** — `lib/erlang/runtime.sx` + `lib/erlang/tests/runtime.sx`. Amortised-O(1) FIFO queue (`er-q-new`, `er-q-push!`, `er-q-pop!`, `er-q-peek`, `er-q-compact!` at 128-entry head drift), tagged pids `{:tag "pid" :id N}` with `er-pid?`/`er-pid-equal?`, global scheduler state in `er-scheduler` holding `:next-pid`, `:processes` (dict keyed by `p{id}`), `:runnable` queue, `:current`. Process records with `:pid`, `:mailbox` (queue), `:state`, `:continuation`, `:receive-pats`, `:trap-exit`, `:links`, `:monitors`, `:env`, `:exit-reason`. 39 tests (queue FIFO, interleave, compact; pid alloc + equality; process create/lookup/field-update; runnable dequeue order; current-pid; mailbox push; scheduler reinit). Total erlang suite 283/283. Next: `spawn/1`, `!`, `receive` wired into the evaluator.
-- **2026-04-24 core BIFs + funs green** — Phase 2 complete. Added to `lib/erlang/transpile.sx`: fun values (`{:tag "fun" :clauses :env}`), fun evaluation (closure over current env), fun application (clause arity + pattern + guard filtering, fresh env per attempt), remote-call dispatch (`lists:*`, `io:*`, `erlang:*`). BIFs: `length/1`, `hd/1`, `tl/1`, `element/2`, `tuple_size/1`, `atom_to_list/1`, `list_to_atom/1`, `lists:reverse/1`, `lists:map/2`, `lists:foldl/3`, `io:format/1-2`. `io:format` writes to a capture buffer (`er-io-buffer`, `er-io-flush!`, `er-io-buffer-content`) and returns `ok` — supports `~n`, `~p`/`~w`/`~s`, `~~`. 35 new eval tests. Total eval 130/130; erlang suite 244/244. **Phase 2 complete — Phase 3 (processes, scheduler, receive) is next.**
-- **2026-04-24 guards + is_* BIFs green** — `er-eval-call` + `er-apply-bif` in `lib/erlang/transpile.sx` wire local function calls to a BIF dispatcher. Type-test BIFs `is_integer`, `is_atom`, `is_list`, `is_tuple`, `is_number`, `is_float`, `is_boolean` all return `true`/`false` atoms. Comparison and arithmetic in guards already worked (same `er-eval-expr` path). 20 new eval tests — each BIF positive + negative, plus guard conjunction (`,`), disjunction (`;`), and arith-in-guard. Total eval 95/95; erlang suite 209/209.
-- **2026-04-24 pattern matching green** — `er-match!` in `lib/erlang/transpile.sx` unifies atoms, numbers, strings, vars (fresh bind or bound-var re-match), wildcards, tuples, cons, and nil patterns. `case ... of ... [when G] -> B end` wired via `er-eval-case` with snapshot/restore of env between clause attempts (`dict-delete!`-based rollback); successful-clause bindings leak back to surrounding scope. 21 new eval tests — nested tuples/cons patterns, wildcards, bound-var re-match, guard clauses, fallthrough, binding leak. Total eval 75/75; erlang suite 189/189.
-- **2026-04-24 eval (sequential) green** — `lib/erlang/transpile.sx` (tree-walking interpreter) + `lib/erlang/tests/eval.sx`. 54/54 tests covering literals, arithmetic, comparison, logical (incl. short-circuit `andalso`/`orelse`), tuples, lists with `++`, `begin..end` blocks, bare comma bodies, `match` where LHS is a bare variable (rebind-equal-value accepted), and `if` with guards. Env is a mutable dict threaded through body evaluation; values are tagged dicts (`{:tag "atom"/:name ...}`, `{:tag "nil"}`, `{:tag "cons" :head :tail}`, `{:tag "tuple" :elements}`). Numbers pass through as SX numbers. Gotcha: SX's `parse-number` coerces `"1.0"` → integer `1`, so `=:=` can't distinguish `1` from `1.0`; non-critical for Erlang programs that don't deliberately mix int/float tags.
 - **parser green** — `lib/erlang/parser.sx` + `parser-core.sx` + `parser-expr.sx` + `parser-module.sx`. 52/52 in `tests/parse.sx`. Covers literals, tuples, lists (incl. `[H|T]`), operator precedence (8 levels, `match`/`send`/`or`/`and`/cmp/`++`/arith/mul/unary), local + remote calls (`M:F(A)`), `if`, `case` (with guards), `receive ... after ... end`, `begin..end` blocks, anonymous `fun`, `try..of..catch..after..end` with `Class:Pattern` catch clauses. Module-level: `-module(M).`, `-export([...]).`, multi-clause functions with guards. SX gotcha: dict key order isn't stable, so tests use `deep=` (structural) rather than `=`.
 - **tokenizer green** — `lib/erlang/tokenizer.sx` + `lib/erlang/tests/tokenize.sx`. Covers atoms (bare, quoted, `node@host`), variables, integers (incl. `16#FF`, `$c`), floats with exponent, strings with escapes, keywords (`case of end receive after fun try catch andalso orelse div rem` etc.), punct (`( ) { } [ ] , ; . : :: -> <- <= => << >> | ||`), ops (`+ - * / = == /= =:= =/= < > =< >= ++ -- ! ?`), `%` line comments. 62/62 green.
 

plans/smalltalk-on-sx.md

@@ -0,0 +1,124 @@
+# Smalltalk-on-SX: blocks with non-local return on delimited continuations
+
+The headline showcase is **blocks** — Smalltalk's closures with non-local return (`^expr` aborts the enclosing *method*, not the block). Every other Smalltalk on top of a host VM (RSqueak on PyPy, GemStone on C, Maxine on Java) reinvents non-local return on whatever stack discipline the host gives them. On SX it's a one-liner: a block holds a captured continuation; `^` just invokes it. Message-passing OO falls out cheaply on top of the existing component / dispatch machinery.
+
+End-state goal: ANSI-ish Smalltalk-80 subset, SUnit working, ~200 hand-written tests + a vendored slice of the Pharo kernel tests, classic corpus (eight queens, quicksort, mandelbrot, Conway's Life).
+
+## Scope decisions (defaults — override by editing before we spawn)
+
+- **Syntax:** Pharo / Squeak chunk format (`!` separators, `Object subclass: #Foo …`). No fileIn/fileOut images — text source only.
+- **Conformance:** ANSI X3J20 *as a target*, not bug-for-bug Squeak. "Reads like Smalltalk, runs like Smalltalk."
+- **Test corpus:** SUnit ported to SX-Smalltalk + custom programs + a curated slice of Pharo `Kernel-Tests` / `Collections-Tests`.
+- **Image:** out of scope. Source-only. No `become:` between sessions, no snapshotting.
+- **Reflection:** `class`, `respondsTo:`, `perform:`, `doesNotUnderstand:` in. `become:` (object-identity swap) **in** — it's a good CEK exercise. Method modification at runtime in.
+- **GUI / Morphic / threads:** out entirely.
+
+## Ground rules
+
+- **Scope:** only touch `lib/smalltalk/**` and `plans/smalltalk-on-sx.md`. Don't edit `spec/`, `hosts/`, `shared/`, or any other `lib/<lang>/**`. Smalltalk primitives go in `lib/smalltalk/runtime.sx`.
+- **SX files:** use `sx-tree` MCP tools only.
+- **Commits:** one feature per commit. Keep `## Progress log` updated and tick roadmap boxes.
+
+## Architecture sketch
+
+```
+Smalltalk source
+    │
+    ▼
+lib/smalltalk/tokenizer.sx  — selectors, keywords, literals, $c, #sym, #(…), $'…'
+    │
+    ▼
+lib/smalltalk/parser.sx     — AST: classes, methods, blocks, cascades, sends
+    │
+    ▼
+lib/smalltalk/transpile.sx  — AST → SX AST (entry: smalltalk-eval-ast)
+    │
+    ▼
+lib/smalltalk/runtime.sx    — class table, MOP, dispatch, primitives
+```
+
+Core mapping:
+- **Class** = SX dict `{:name :superclass :ivars :methods :class-methods :metaclass}`. Class table is a flat dict keyed by class name.
+- **Object** = SX dict `{:class :ivars}` — `ivars` keyed by symbol. Tagged ints / floats / strings / symbols are not boxed; their class is looked up by SX type.
+- **Method** = SX lambda closing over a `self` binding + temps. Body wrapped in a delimited continuation so `^` can escape.
+- **Message send** = `(st-send receiver selector args)` — does class-table lookup, walks superclass chain, falls back to `doesNotUnderstand:` with a `Message` object.
+- **Block** `[:x | … ^v … ]` = lambda + captured `^k` (the method-return continuation). Invoking `^` calls `k`; outer block invocation past method return raises `BlockContext>>cannotReturn:`.
+- **Cascade** `r m1; m2; m3` = `(let ((tmp r)) (st-send tmp 'm1 ()) (st-send tmp 'm2 ()) (st-send tmp 'm3 ()))`.
+- **`ifTrue:ifFalse:` / `whileTrue:`** = ordinary block sends; the runtime intrinsifies them in the JIT path so they compile to native branches (Tier 1 of bytecode expansion already covers this pattern).
+- **`become:`** = swap two object identities everywhere — in SX this is a heap walk, but we restrict to `oneWayBecome:` (cheap: rewrite class field) by default.
+
+## Roadmap
+
+### Phase 1 — tokenizer + parser
+- [x] Tokenizer: identifiers, keywords (`foo:`), binary selectors (`+`, `==`, `,`, `->`, `~=` etc.), numbers (radix `16r1F`; **scaled `1.5s2` deferred**), strings `'…''…'`, characters `$c`, symbols `#foo` `#'foo bar'` `#+`, byte arrays `#[1 2 3]` (open token), literal arrays `#(1 #foo 'x')` (open token), comments `"…"`
+- [x] Parser (expression level): blocks `[:a :b | | t1 t2 | …]`, cascades, message precedence (unary > binary > keyword), assignment, return, statement sequences, literal arrays, byte arrays, paren grouping, method headers (`+ other`, `at:put:`, unary, with temps and body). Class-definition keyword messages parse as ordinary keyword sends — no special-case needed.
+- [x] Parser (chunk-stream level): `st-read-chunks` splits source on `!` (with `!!` doubling) and `st-parse-chunks` runs the Pharo file-in state machine — `methodsFor:` / `class methodsFor:` opens a method batch, an empty chunk closes it. Pragmas `<primitive: …>` (incl. multiple keyword pairs, before or after temps, multiple per method) parsed into the method AST.
+- [x] Unit tests in `lib/smalltalk/tests/parse.sx`
+
+### Phase 2 — object model + sequential eval
+- [x] Class table + bootstrap (`lib/smalltalk/runtime.sx`): canonical hierarchy installed (`Object`, `Behavior`, `ClassDescription`, `Class`, `Metaclass`, `UndefinedObject`, `Boolean`/`True`/`False`, `Magnitude`/`Number`/`Integer`/`SmallInteger`/`Float`/`Character`, `Collection`/`SequenceableCollection`/`ArrayedCollection`/`Array`/`String`/`Symbol`/`OrderedCollection`/`Dictionary`, `BlockClosure`). User class definition via `st-class-define!`, methods via `st-class-add-method!` (stamps `:defining-class` for super), method lookup walks chain, ivars accumulated through superclass chain, native SX value types map to Smalltalk classes via `st-class-of`.
+- [x] `smalltalk-eval-ast` (`lib/smalltalk/eval.sx`): all literal kinds, ident resolution (locals → ivars → class refs), self/super/thisContext, assignment (locals or ivars, mutating), message send, cascade, sequence, and ^return via a sentinel marker (proper continuation-based escape is the Phase 3 showcase). Frames carry a parent chain so blocks close over outer locals. Primitive method tables for SmallInteger/Float, String/Symbol, Boolean, UndefinedObject, Array, BlockClosure (value/value:/whileTrue:/etc.), and class-side `new`/`name`/etc. Also satisfies "30+ tests" — 60 eval tests.
+- [x] Method lookup: walk class → superclass already in `st-method-lookup-walk`; new cached wrapper `st-method-lookup` keys on `(class, selector, side)` and stores `:not-found` for negative results so DNU paths don't re-walk. Cache invalidates on `st-class-define!`, `st-class-add-method!`, `st-class-add-class-method!`, `st-class-remove-method!`, and full bootstrap. Stats helpers `st-method-cache-stats` / `st-method-cache-reset-stats!` for tests + later debugging.
+- [x] `doesNotUnderstand:` fallback. `Message` class added at bootstrap with `selector`/`arguments` ivars and accessor methods. Primitive senders (Number/String/Boolean/Nil/Array/BlockClosure/class-side) now return the `:unhandled` sentinel for unknown selectors; `st-send` builds a `Message` via `st-make-message` and routes through `st-dnu`, which looks up `doesNotUnderstand:` on the receiver's class chain (instance- or class-side as appropriate). User overrides intercept unknowns and see the symbol selector + arguments array in the Message.
+- [x] `super` send. Method invocation captures the defining class on the frame; `st-super-send` walks from `(st-class-superclass defining-class)` (instance- or class-side as appropriate). Falls through primitives → DNU when no method is found. Receiver is preserved as `self`, so ivar mutations stick. Verified for: subclass override calls parent, inherited `super` resolves to *defining* class's parent (not receiver's), multi-level `A→B→C` chain, super inside a block, super walks past an intermediate class with no local override.
+- [x] 30+ tests in `lib/smalltalk/tests/eval.sx` (60 tests, covering literals through user-class method dispatch with cascades and closures)
+
+### Phase 3 — blocks + non-local return (THE SHOWCASE)
+- [ ] Method invocation captures a `^k` (the return continuation) and binds it as the block's escape
+- [ ] `^expr` from inside a block invokes that captured `^k`
+- [ ] `BlockContext>>value`, `value:`, `value:value:`, …, `valueWithArguments:`
+- [ ] `whileTrue:` / `whileTrue` / `whileFalse:` / `whileFalse` as ordinary block sends — runtime intrinsifies the loop in the bytecode JIT
+- [ ] `ifTrue:` / `ifFalse:` / `ifTrue:ifFalse:` as block sends, similarly intrinsified
+- [ ] Escape past returned-from method raises `BlockContext>>cannotReturn:`
+- [ ] Classic programs in `lib/smalltalk/tests/programs/`:
+  - [ ] `eight-queens.st`
+  - [ ] `quicksort.st`
+  - [ ] `mandelbrot.st`
+  - [ ] `life.st` (Conway's Life, glider gun)
+  - [ ] `fibonacci.st` (recursive + memoised)
+- [ ] `lib/smalltalk/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
+
+### Phase 4 — reflection + MOP
+- [ ] `Object>>class`, `class>>name`, `class>>superclass`, `class>>methodDict`, `class>>selectors`
+- [ ] `Object>>perform:` / `perform:with:` / `perform:withArguments:`
+- [ ] `Object>>respondsTo:`, `Object>>isKindOf:`, `Object>>isMemberOf:`
+- [ ] `Behavior>>compile:` — runtime method addition
+- [ ] `Object>>becomeForward:` (one-way become; rewrites the class field of `aReceiver`)
+- [ ] Exceptions: `Exception`, `Error`, `signal`, `signal:`, `on:do:`, `ensure:`, `ifCurtailed:` — built on top of SX `handler-bind`/`raise`
+
+### Phase 5 — collections + numeric tower
+- [ ] `SequenceableCollection`/`OrderedCollection`/`Array`/`String`/`Symbol`
+- [ ] `HashedCollection`/`Set`/`Dictionary`/`IdentityDictionary`
+- [ ] `Stream` hierarchy: `ReadStream`/`WriteStream`/`ReadWriteStream`
+- [ ] `Number` tower: `SmallInteger`/`LargePositiveInteger`/`Float`/`Fraction`
+- [ ] `String>>format:`, `printOn:` for everything
+
+### Phase 6 — SUnit + corpus to 200+
+- [ ] Port SUnit (TestCase, TestSuite, TestResult) — written in SX-Smalltalk, runs in itself
+- [ ] Vendor a slice of Pharo `Kernel-Tests` and `Collections-Tests`
+- [ ] Drive the scoreboard up: aim for 200+ green tests
+- [ ] Stretch: ANSI Smalltalk validator subset
+
+### Phase 7 — speed (optional)
+- [ ] Method-dictionary inline caching (already in CEK as a primitive; just wire selector cache)
+- [ ] Block intrinsification beyond `whileTrue:` / `ifTrue:`
+- [ ] Compare against GNU Smalltalk on the corpus
+
+## Progress log
+
+_Newest first. Agent appends on every commit._
+
+- 2026-04-25: `super` send + 9 tests (`lib/smalltalk/tests/super.sx`). `st-super-send` walks from defining-class's superclass; class-side aware; primitives → DNU fallback. Also fixed top-level `| temps |` parsing in `st-parse` (the absence of which was silently aborting earlier eval/dnu tests — counts go from 274 → 287, with previously-skipped tests now actually running).
+- 2026-04-25: `doesNotUnderstand:` + 12 DNU tests (`lib/smalltalk/tests/dnu.sx`). Bootstrap installs `Message` (with selector/arguments accessors). Primitives signal `:unhandled` instead of erroring; `st-dnu` builds a Message and walks `doesNotUnderstand:` lookup. User Object DNU intercepts unknown sends to native receivers (Number, String, Block) too. 267/267 total.
+- 2026-04-25: method-lookup cache (`st-method-cache` keyed by `class|selector|side`, stores `:not-found` for misses). Invalidation on define/add/remove + bootstrap. `st-class-remove-method!` added. Stats helpers + 10 cache tests; 255/255 total.
+- 2026-04-25: `smalltalk-eval-ast` + 60 eval tests (`lib/smalltalk/eval.sx`, `lib/smalltalk/tests/eval.sx`). Frame chain with mutable locals/ivars (via `dict-set!`), full literal eval, send dispatch (user methods + native primitive tables for Number/String/Boolean/Nil/Array/Block/Class), block closures, while/to:do:, cascades returning last, sentinel-based `^return`. User Point class round-trip works including `+` returning a fresh point. 245/245 total.
+- 2026-04-25: class table + bootstrap (`lib/smalltalk/runtime.sx`, `lib/smalltalk/tests/runtime.sx`). Canonical hierarchy, type→class mapping for native SX values, instance construction, ivar inheritance, method install with `:defining-class` stamp, instance- and class-side method lookup walking the superclass chain. 54 new tests, 185/185 total.
+- 2026-04-25: chunk-stream parser + pragmas + 21 chunk/pragma tests (`lib/smalltalk/tests/parse_chunks.sx`). `st-read-chunks` (with `!!` doubling), `st-parse-chunks` state machine for `methodsFor:` batches incl. class-side. Pragmas with multiple keyword pairs, signed numeric / string / symbol args, in either pragma-then-temps or temps-then-pragma order. 131/131 tests pass.
+- 2026-04-25: expression-level parser + 47 parse tests (`lib/smalltalk/parser.sx`, `lib/smalltalk/tests/parse.sx`). Full message precedence (unary > binary > keyword), cascades, blocks with params/temps, literal/byte arrays, assignment chain, method headers (unary/binary/keyword). Chunk-format `! !` driver deferred to a follow-up box. 110/110 tests pass.
+- 2026-04-25: tokenizer + 63 tests (`lib/smalltalk/tokenizer.sx`, `lib/smalltalk/tests/tokenize.sx`, `lib/smalltalk/test.sh`). All token types covered except scaled decimals `1.5s2` (deferred). `#(` and `#[` emit open tokens; literal-array contents lexed as ordinary tokens for the parser to interpret.
+
+## Blockers
+
+_Shared-file issues that need someone else to fix. Minimal repro only._
+
+- _(none yet)_

scripts/sx-loops-down.sh

@@ -30,7 +30,7 @@ fi
 
 if [ "$CLEAN" = "1" ]; then
   cd "$(dirname "$0")/.."
-  for lang in lua prolog forth erlang haskell js hs; do
+  for lang in lua prolog forth erlang haskell js hs smalltalk; do
     wt="$WORKTREE_BASE/$lang"
     if [ -d "$wt" ]; then
       git worktree remove --force "$wt" 2>/dev/null || rm -rf "$wt"
@@ -39,5 +39,5 @@ if [ "$CLEAN" = "1" ]; then
   done
   git worktree prune
   echo "Worktree branches (loops/<lang>) are preserved. Delete manually if desired:"
-  echo "  git branch -D loops/lua loops/prolog loops/forth loops/erlang loops/haskell loops/js loops/hs"
+  echo "  git branch -D loops/lua loops/prolog loops/forth loops/erlang loops/haskell loops/js loops/hs loops/smalltalk"
 fi

scripts/sx-loops-up.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Spawn 7 claude sessions in tmux, one per language loop.
+# Spawn 8 claude sessions in tmux, one per language loop.
 # Each runs in its own git worktree rooted at /root/rose-ash-loops/<lang>,
 # on branch loops/<lang>. No two loops share a working tree, so there's
 # zero risk of file collisions between languages.
@@ -9,7 +9,7 @@
 #
 # After the script prints done:
 #   tmux a -t sx-loops
-#   Ctrl-B + <window-number> to switch (0=lua ... 6=hs)
+#   Ctrl-B + <window-number> to switch (0=lua ... 7=smalltalk)
 #   Ctrl-B + d to detach (loops keep running, SSH-safe)
 #
 # Stop: ./scripts/sx-loops-down.sh
@@ -38,8 +38,9 @@ declare -A BRIEFING=(
   [haskell]=haskell-loop.md
   [js]=loop.md
   [hs]=hs-loop.md
+  [smalltalk]=smalltalk-loop.md
 )
-ORDER=(lua prolog forth erlang haskell js hs)
+ORDER=(lua prolog forth erlang haskell js hs smalltalk)
 
 mkdir -p "$WORKTREE_BASE"
 
@@ -66,7 +67,7 @@ for lang in "${ORDER[@]:1}"; do
   tmux new-window -t "$SESSION" -n "$lang" -c "$WORKTREE_BASE/$lang"
 done
 
-echo "Starting 7 claude sessions..."
+echo "Starting 8 claude sessions..."
 for lang in "${ORDER[@]}"; do
   tmux send-keys -t "$SESSION:$lang" "claude" C-m
 done
@@ -89,10 +90,10 @@ for lang in "${ORDER[@]}"; do
 done
 
 echo ""
-echo "Done. 7 loops started in tmux session '$SESSION', each in its own worktree."
+echo "Done. 8 loops started in tmux session '$SESSION', each in its own worktree."
 echo ""
 echo "  Attach:    tmux a -t $SESSION"
-echo "  Switch:    Ctrl-B <0..6>  (0=lua 1=prolog 2=forth 3=erlang 4=haskell 5=js 6=hs)"
+echo "  Switch:    Ctrl-B <0..7>  (0=lua 1=prolog 2=forth 3=erlang 4=haskell 5=js 6=hs 7=smalltalk)"
 echo "  List:      Ctrl-B w"
 echo "  Detach:    Ctrl-B d"
 echo "  Stop:      ./scripts/sx-loops-down.sh"