plan: tick Phase 20 bytevectors — complete, Phase 21 next

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

hosts/javascript/run_tests.js

@@ -293,6 +293,8 @@ env["pop-suite"] = function() {
   return null;
 };
 
+env["test-allowed?"] = function(name) { return true; };
+
 // Load test framework
 const projectDir = path.join(__dirname, "..", "..");
 const specTests = path.join(projectDir, "spec", "tests");
@@ -341,6 +343,20 @@ if (fs.existsSync(swapPath)) {
   }
 }
 
+// Load spec library files (define-library modules imported by tests)
+for (const libFile of ["signals.sx", "coroutines.sx"]) {
+  const libPath = path.join(projectDir, "spec", libFile);
+  if (fs.existsSync(libPath)) {
+    const libSrc = fs.readFileSync(libPath, "utf8");
+    const libExprs = Sx.parse(libSrc);
+    for (const expr of libExprs) {
+      try { Sx.eval(expr, env); } catch (e) {
+        console.error(`Error loading spec/${libFile}: ${e.message}`);
+      }
+    }
+  }
+}
+
 // Load tw system (needed by spec/tests/test-tw.sx)
 const twDir = path.join(projectDir, "shared", "sx", "templates");
 for (const twFile of ["tw-type.sx", "tw-layout.sx", "tw.sx"]) {

hosts/ocaml/bin/run_tests.ml

@@ -37,7 +37,10 @@ let rec deep_equal a b =
   match a, b with
   | Nil, Nil -> true
   | Bool a, Bool b -> a = b
+  | Integer a, Integer b -> a = b
   | Number a, Number b -> a = b
+  | Integer a, Number b -> float_of_int a = b
+  | Number a, Integer b -> a = float_of_int b
   | String a, String b -> a = b
   | Symbol a, Symbol b -> a = b
   | Keyword a, Keyword b -> a = b
@@ -226,7 +229,7 @@ let make_test_env () =
     | [String s] ->
       let parsed = Sx_parser.parse_all s in
       (match parsed with
-       | [List (Symbol "sxbc" :: Number _ :: payload :: _)] -> payload
+       | [List (Symbol "sxbc" :: (Number _ | Integer _) :: payload :: _)] -> payload
        | _ -> raise (Eval_error "bytecode-deserialize: invalid sxbc format"))
     | _ -> raise (Eval_error "bytecode-deserialize: expected string"));
 
@@ -240,7 +243,7 @@ let make_test_env () =
     | [String s] ->
       let parsed = Sx_parser.parse_all s in
       (match parsed with
-       | [List (Symbol "cek-state" :: Number _ :: payload :: _)] -> payload
+       | [List (Symbol "cek-state" :: (Number _ | Integer _) :: payload :: _)] -> payload
        | _ -> raise (Eval_error "cek-deserialize: invalid cek-state format"))
     | _ -> raise (Eval_error "cek-deserialize: expected string"));
 
@@ -320,7 +323,10 @@ let make_test_env () =
   bind "identical?" (fun args ->
     match args with
     | [a; b] -> Bool (match a, b with
+      | Integer x, Integer y -> x = y
       | Number x, Number y -> x = y
+      | Integer x, Number y -> float_of_int x = y
+      | Number x, Integer y -> x = float_of_int y
       | String x, String y -> x = y
       | Bool x, Bool y -> x = y
       | Nil, Nil -> true
@@ -366,11 +372,15 @@ let make_test_env () =
 
   bind "append!" (fun args ->
     match args with
-    | [ListRef r; v; Number n] when int_of_float n = 0 ->
+    | [ListRef r; v; (Number n)] when int_of_float n = 0 ->
       r := v :: !r; ListRef r  (* prepend *)
+    | [ListRef r; v; (Integer 0)] ->
+      r := v :: !r; ListRef r  (* prepend Integer index *)
     | [ListRef r; v] -> r := !r @ [v]; ListRef r  (* append in place *)
-    | [List items; v; Number n] when int_of_float n = 0 ->
+    | [List items; v; (Number n)] when int_of_float n = 0 ->
       List (v :: items)  (* immutable prepend *)
+    | [List items; v; (Integer 0)] ->
+      List (v :: items)  (* immutable prepend Integer index *)
     | [List items; v] -> List (items @ [v])  (* immutable fallback *)
     | _ -> raise (Eval_error "append!: expected list and value"));
 
@@ -546,7 +556,10 @@ let make_test_env () =
   bind "batch-begin!" (fun _args -> Sx_ref.batch_begin_b ());
   bind "batch-end!" (fun _args -> Sx_ref.batch_end_b ());
   bind "now-ms" (fun _args -> Number 1000.0);
-  bind "random-int" (fun args -> match args with [Number lo; _] -> Number lo | _ -> Number 0.0);
+  bind "random-int" (fun args -> match args with
+    | [Number lo; _] -> Number lo
+    | [Integer lo; _] -> Integer lo
+    | _ -> Integer 0);
   bind "try-rerender-page" (fun _args -> Nil);
   bind "collect!" (fun args ->
     match args with
@@ -1107,6 +1120,47 @@ let make_test_env () =
     | _ :: _ -> String "confirmed"
     | _ -> Nil);
 
+  bind "values" (fun args ->
+    match args with
+    | [v] -> v
+    | vs ->
+      let d = Hashtbl.create 2 in
+      Hashtbl.replace d "_values" (Bool true);
+      Hashtbl.replace d "_list" (List vs);
+      Dict d);
+
+  bind "call-with-values" (fun args ->
+    match args with
+    | [producer; consumer] ->
+      let result = Sx_ref.cek_call producer (List []) in
+      let spread = (match result with
+        | Dict d when (match Hashtbl.find_opt d "_values" with Some (Bool true) -> true | _ -> false) ->
+          (match Hashtbl.find_opt d "_list" with Some (List l) -> l | _ -> [result])
+        | _ -> [result])
+      in
+      Sx_ref.cek_call consumer (List spread)
+    | _ -> raise (Eval_error "call-with-values: expected 2 args"));
+
+  bind "promise?" (fun args ->
+    match args with
+    | [v] -> Bool (Sx_ref.is_promise v)
+    | _ -> Bool false);
+
+  bind "make-promise" (fun args ->
+    match args with
+    | [v] ->
+      let d = Hashtbl.create 4 in
+      Hashtbl.replace d "_promise" (Bool true);
+      Hashtbl.replace d "forced" (Bool true);
+      Hashtbl.replace d "value" v;
+      Dict d
+    | _ -> Nil);
+
+  bind "force" (fun args ->
+    match args with
+    | [p] -> Sx_ref.force_promise p
+    | _ -> Nil);
+
   env
 
 (* ====================================================================== *)
@@ -1142,18 +1196,20 @@ let run_foundation_tests () =
   in
 
   Printf.printf "Suite: parser\n";
-  assert_eq "number" (Number 42.0) (List.hd (parse_all "42"));
+  assert_eq "number" (Integer 42) (List.hd (parse_all "42"));
   assert_eq "string" (String "hello") (List.hd (parse_all "\"hello\""));
   assert_eq "bool true" (Bool true) (List.hd (parse_all "true"));
   assert_eq "nil" Nil (List.hd (parse_all "nil"));
   assert_eq "keyword" (Keyword "class") (List.hd (parse_all ":class"));
   assert_eq "symbol" (Symbol "foo") (List.hd (parse_all "foo"));
-  assert_eq "list" (List [Symbol "+"; Number 1.0; Number 2.0]) (List.hd (parse_all "(+ 1 2)"));
+  assert_eq "list" (List [Symbol "+"; Integer 1; Integer 2]) (List.hd (parse_all "(+ 1 2)"));
   (match List.hd (parse_all "(div :class \"card\" (p \"hi\"))") with
    | List [Symbol "div"; Keyword "class"; String "card"; List [Symbol "p"; String "hi"]] ->
      incr pass_count; Printf.printf "  PASS: nested list\n"
    | v -> incr fail_count; Printf.printf "  FAIL: nested list — got %s\n" (Sx_types.inspect v));
   (match List.hd (parse_all "'(1 2 3)") with
+   | List [Symbol "quote"; List [Integer 1; Integer 2; Integer 3]] ->
+     incr pass_count; Printf.printf "  PASS: quote sugar\n"
    | List [Symbol "quote"; List [Number 1.0; Number 2.0; Number 3.0]] ->
      incr pass_count; Printf.printf "  PASS: quote sugar\n"
    | v -> incr fail_count; Printf.printf "  FAIL: quote sugar — got %s\n" (Sx_types.inspect v));
@@ -1161,7 +1217,7 @@ let run_foundation_tests () =
    | Dict d when dict_has d "a" && dict_has d "b" ->
      incr pass_count; Printf.printf "  PASS: dict literal\n"
    | v -> incr fail_count; Printf.printf "  FAIL: dict literal — got %s\n" (Sx_types.inspect v));
-  assert_eq "comment" (Number 42.0) (List.hd (parse_all ";; comment\n42"));
+  assert_eq "comment" (Integer 42) (List.hd (parse_all ";; comment\n42"));
   assert_eq "string escape" (String "hello\nworld") (List.hd (parse_all "\"hello\\nworld\""));
   assert_eq "multiple exprs" (Number 2.0) (Number (float_of_int (List.length (parse_all "(1 2 3) (4 5)"))));
 
@@ -1978,6 +2034,10 @@ let run_spec_tests env test_files =
       (match Hashtbl.find_opt d "children" with
        | Some (List l) when i >= 0 && i < List.length l -> List.nth l i
        | _ -> (match Hashtbl.find_opt d (string_of_int i) with Some v -> v | None -> Nil))
+    | [Dict d; Integer n] ->
+      (match Hashtbl.find_opt d "children" with
+       | Some (List l) when n >= 0 && n < List.length l -> List.nth l n
+       | _ -> (match Hashtbl.find_opt d (string_of_int n) with Some v -> v | None -> Nil))
     | _ -> Nil);
 
   (* Stringify a value for DOM string properties *)
@@ -2052,8 +2112,8 @@ let run_spec_tests env test_files =
          Hashtbl.replace d "childNodes" (List [])
        | _ -> ());
       stored
-    | [ListRef r; Number n; value] ->
-      let idx = int_of_float n in
+    | [ListRef r; idx_v; value] when (match idx_v with Number _ | Integer _ -> true | _ -> false) ->
+      let idx = match idx_v with Number n -> int_of_float n | Integer n -> n | _ -> 0 in
       let lst = !r in
       if idx >= 0 && idx < List.length lst then
         r := List.mapi (fun i v -> if i = idx then value else v) lst
@@ -2190,7 +2250,7 @@ let run_spec_tests env test_files =
             | [String name; value] ->
               let attrs = match Hashtbl.find_opt d "attributes" with Some (Dict a) -> a | _ ->
                 let a = Hashtbl.create 4 in Hashtbl.replace d "attributes" (Dict a); a in
-              let sv = match value with String s -> s | Number n ->
+              let sv = match value with String s -> s | Integer n -> string_of_int n | Number n ->
                 let i = int_of_float n in if float_of_int i = n then string_of_int i
                 else string_of_float n | _ -> Sx_types.inspect value in
               Hashtbl.replace attrs name (String sv);
@@ -2632,6 +2692,7 @@ let run_spec_tests env test_files =
   let rec json_of_value = function
     | Nil -> `Null
     | Bool b -> `Bool b
+    | Integer n -> `Int n
     | Number n ->
       if Float.is_integer n && Float.abs n < 1e16
       then `Int (int_of_float n) else `Float n
@@ -2647,8 +2708,8 @@ let run_spec_tests env test_files =
   let rec value_of_json = function
     | `Null -> Nil
     | `Bool b -> Bool b
-    | `Int i -> Number (float_of_int i)
-    | `Intlit s -> (try Number (float_of_string s) with _ -> String s)
+    | `Int i -> Integer i
+    | `Intlit s -> (try Integer (int_of_string s) with _ -> try Number (float_of_string s) with _ -> String s)
     | `Float f -> Number f
     | `String s -> String s
     | `List xs -> List (List.map value_of_json xs)

hosts/ocaml/bin/sx_server.ml

@@ -296,6 +296,10 @@ let read_blob () =
       (* consume trailing newline *)
       (try ignore (input_line stdin) with End_of_file -> ());
       data
+    | [List [Symbol "blob"; Integer n]] ->
+      let data = read_exact_bytes n in
+      (try ignore (input_line stdin) with End_of_file -> ());
+      data
     | _ -> raise (Eval_error ("read_blob: expected (blob N), got: " ^ line))
 
 (** Batch IO mode — collect requests during aser-slot, resolve after. *)
@@ -357,6 +361,11 @@ let rec read_io_response () =
     | [List (Symbol "io-response" :: Number n :: values)]
       when int_of_float n = !current_epoch ->
       (match values with [v] -> v | _ -> List values)
+    | [List [Symbol "io-response"; Integer n; value]]
+      when n = !current_epoch -> value
+    | [List (Symbol "io-response" :: Integer n :: values)]
+      when n = !current_epoch ->
+      (match values with [v] -> v | _ -> List values)
     (* Legacy untagged: (io-response value) — accept for backwards compat *)
     | [List [Symbol "io-response"; value]] -> value
     | [List (Symbol "io-response" :: values)] ->
@@ -396,6 +405,12 @@ let read_batched_io_response () =
         when int_of_float n = !current_epoch -> s
       | [List [Symbol "io-response"; Number n; v]]
         when int_of_float n = !current_epoch -> serialize_value v
+      | [List [Symbol "io-response"; Integer n; String s]]
+        when n = !current_epoch -> s
+      | [List [Symbol "io-response"; Integer n; SxExpr s]]
+        when n = !current_epoch -> s
+      | [List [Symbol "io-response"; Integer n; v]]
+        when n = !current_epoch -> serialize_value v
       (* Legacy untagged *)
       | [List [Symbol "io-response"; String s]]
       | [List [Symbol "io-response"; SxExpr s]] -> s
@@ -959,6 +974,7 @@ let setup_io_bridges env =
   bind "sleep" (fun args -> io_request "sleep" args);
   bind "set-response-status" (fun args -> match args with
     | [Number n] -> _pending_response_status := int_of_float n; Nil
+    | [Integer n] -> _pending_response_status := n; Nil
     | _ -> Nil);
   bind "set-response-header" (fun args -> io_request "set-response-header" args)
 
@@ -1361,6 +1377,7 @@ let rec dispatch env cmd =
         | Bool true -> "true"
         | Bool false -> "false"
         | Number n -> Sx_types.format_number n
+        | Integer n -> string_of_int n
         | String s -> "\"" ^ escape_sx_string s ^ "\""
         | Symbol s -> s
         | Keyword k -> ":" ^ k
@@ -1374,6 +1391,10 @@ let rec dispatch env cmd =
         | Island i -> "~" ^ i.i_name
         | SxExpr s -> s
         | RawHTML s -> "\"" ^ escape_sx_string s ^ "\""
+        | Char n -> Sx_types.inspect (Char n)
+        | Eof -> Sx_types.inspect Eof
+        | Port _ -> Sx_types.inspect result
+        | Rational (n, d) -> Printf.sprintf "%d/%d" n d
         | _ -> "nil"
       in
       send_ok_raw (raw_serialize result)
@@ -4450,6 +4471,8 @@ let site_mode () =
           match exprs with
           | [List [Symbol "epoch"; Number n]] ->
             current_epoch := int_of_float n
+          | [List [Symbol "epoch"; Integer n]] ->
+            current_epoch := n
           (* render-page: full SSR pipeline — URL → complete HTML *)
           | [List [Symbol "render-page"; String path]] ->
             (try match http_render_page env path [] with
@@ -4507,6 +4530,8 @@ let () =
             (* Epoch marker: (epoch N) — set current epoch, read next command *)
             | [List [Symbol "epoch"; Number n]] ->
               current_epoch := int_of_float n
+            | [List [Symbol "epoch"; Integer n]] ->
+              current_epoch := n
             | [cmd] -> dispatch env cmd
             | _ -> send_error ("Expected single command, got " ^ string_of_int (List.length exprs))
           end

hosts/ocaml/bootstrap.py

@@ -47,7 +47,9 @@ open Sx_runtime
 let trampoline_fn : (value -> value) ref = ref (fun v -> v)
 let trampoline v = !trampoline_fn v
 
-
+(* Step limit for timeout detection — set to 0 to disable *)
+let step_limit : int ref = ref 0
+let step_count : int ref = ref 0
 
 (* === Mutable globals — backing refs for transpiler's !_ref / _ref := === *)
 let _strict_ref = ref (Bool false)
@@ -126,6 +128,90 @@ let enhance_error_with_trace msg =
   _last_error_kont_ref := Nil;
   msg ^ (format_comp_trace trace)
 
+(* Hand-written sf_define_type — skipped from transpile because the spec uses
+   &rest params and empty-dict literals that the transpiler can't emit cleanly.
+   Implements: (define-type Name (Ctor1 f1 f2) (Ctor2 f3) ...)
+   Creates constructor fns, Name?/Ctor? predicates, Ctor-field accessors,
+   and records ctors in *adt-registry*. *)
+let sf_define_type args env_val =
+  let items = (match args with List l -> l | _ -> []) in
+  let type_sym = List.nth items 0 in
+  let type_name = value_to_string type_sym in
+  let ctor_specs = List.tl items in
+  let env_has_v k = sx_truthy (env_has env_val (String k)) in
+  let env_bind_v k v = ignore (env_bind env_val (String k) v) in
+  let env_get_v k = env_get env_val (String k) in
+  if not (env_has_v "*adt-registry*") then
+    env_bind_v "*adt-registry*" (Dict (Hashtbl.create 8));
+  let registry = env_get_v "*adt-registry*" in
+  let ctor_names = List.map (fun spec ->
+    (match spec with List (sym :: _) -> String (value_to_string sym) | _ -> Nil)
+  ) ctor_specs in
+  (match registry with Dict d -> Hashtbl.replace d type_name (List ctor_names) | _ -> ());
+  env_bind_v (type_name ^ "?")
+    (NativeFn (type_name ^ "?", fun pargs ->
+      (match pargs with
+      | [v] ->
+        (match v with
+        | Dict d -> Bool (Hashtbl.mem d "_adt" &&
+          (match Hashtbl.find_opt d "_type" with Some (String t) -> t = type_name | _ -> false))
+        | _ -> Bool false)
+      | _ -> Bool false)));
+  List.iter (fun spec ->
+    (match spec with
+    | List (sym :: fields) ->
+      let cn = value_to_string sym in
+      let field_names = List.map value_to_string fields in
+      let arity = List.length fields in
+      env_bind_v cn
+        (NativeFn (cn, fun ctor_args ->
+          if List.length ctor_args <> arity then
+            raise (Eval_error (Printf.sprintf "%s: expected %d args, got %d"
+              cn arity (List.length ctor_args)))
+          else begin
+            let d = Hashtbl.create 4 in
+            Hashtbl.replace d "_adt"    (Bool true);
+            Hashtbl.replace d "_type"   (String type_name);
+            Hashtbl.replace d "_ctor"   (String cn);
+            Hashtbl.replace d "_fields" (List ctor_args);
+            Dict d
+          end));
+      env_bind_v (cn ^ "?")
+        (NativeFn (cn ^ "?", fun pargs ->
+          (match pargs with
+          | [v] ->
+            (match v with
+            | Dict d -> Bool (Hashtbl.mem d "_adt" &&
+              (match Hashtbl.find_opt d "_ctor" with Some (String c) -> c = cn | _ -> false))
+            | _ -> Bool false)
+          | _ -> Bool false)));
+      List.iteri (fun idx fname ->
+        env_bind_v (cn ^ "-" ^ fname)
+          (NativeFn (cn ^ "-" ^ fname, fun pargs ->
+            (match pargs with
+            | [v] ->
+              (match v with
+              | Dict d ->
+                (match Hashtbl.find_opt d "_fields" with
+                | Some (List fs) ->
+                  if idx < List.length fs then List.nth fs idx
+                  else raise (Eval_error (cn ^ "-" ^ fname ^ ": index out of bounds"))
+                | _ -> raise (Eval_error (cn ^ "-" ^ fname ^ ": not an ADT")))
+              | _ -> raise (Eval_error (cn ^ "-" ^ fname ^ ": not a dict")))
+            | _ -> raise (Eval_error (cn ^ "-" ^ fname ^ ": expected 1 arg")))))
+      ) field_names
+    | _ -> ())
+  ) ctor_specs;
+  Nil
+
+(* Register define-type via custom_special_forms so the CEK dispatch finds it.
+   The top-level (register-special-form! ...) in spec/evaluator.sx is not a
+   define and therefore is not transpiled; we wire it up here instead. *)
+let () = ignore (register_special_form (String "define-type")
+  (NativeFn ("define-type", fun call_args ->
+    match call_args with
+    | [args; env] -> sf_define_type args env
+    | _ -> Nil)))
 
 
 """
@@ -171,7 +257,10 @@ def compile_spec_to_ml(spec_dir: str | None = None) -> str:
                 "debug-log", "debug_log", "range", "chunk-every", "zip-pairs",
                 "string-contains?", "starts-with?", "ends-with?",
                 "string-replace", "trim", "split", "index-of",
-                "pad-left", "pad-right", "char-at", "substring"}
+                "pad-left", "pad-right", "char-at", "substring",
+                # sf-define-type uses &rest + empty-dict literals that the transpiler
+                # can't emit as valid OCaml; hand-written implementation in FIXUPS.
+                "sf-define-type"}
         defines = [(n, e) for n, e in defines if n not in skip]
 
         # Deduplicate — keep last definition for each name (CEK overrides tree-walk)

hosts/ocaml/lib/sx_parser.ml

@@ -89,7 +89,35 @@ let read_symbol s =
   while s.pos < s.len && is_symbol_char s.src.[s.pos] do advance s done;
   String.sub s.src start (s.pos - start)
 
+let gcd a b =
+  let rec g a b = if b = 0 then a else g b (a mod b) in g (abs a) (abs b)
+
+let make_rat n d =
+  if d = 0 then raise (Parse_error "rational: division by zero");
+  let sign = if d < 0 then -1 else 1 in
+  let g = gcd (abs n) (abs d) in
+  let rn = sign * n / g and rd = sign * d / g in
+  if rd = 1 then Integer rn else Rational (rn, rd)
+
 let try_number str =
+  (* Integers (no '.' or 'e'/'E') → exact Integer; rationals N/D; floats → inexact Number *)
+  let has_dec = String.contains str '.' in
+  let has_exp = String.contains str 'e' || String.contains str 'E' in
+  if has_dec || has_exp then
+    match float_of_string_opt str with
+    | Some n -> Some (Number n)
+    | None -> None
+  else
+    match String.split_on_char '/' str with
+    | [num_s; den_s] when num_s <> "" && den_s <> "" ->
+      (match int_of_string_opt num_s, int_of_string_opt den_s with
+       | Some n, Some d -> (try Some (make_rat n d) with _ -> None)
+       | _ -> None)
+    | _ ->
+      match int_of_string_opt str with
+      | Some n -> Some (Integer n)
+      | None ->
+        (* handles "nan", "inf", "-inf" *)
         match float_of_string_opt str with
         | Some n -> Some (Number n)
         | None -> None
@@ -108,6 +136,34 @@ let rec read_value s : value =
   | '"' -> String (read_string s)
   | '\'' -> advance s; List [Symbol "quote"; read_value s]
   | '`' -> advance s; List [Symbol "quasiquote"; read_value s]
+  | '#' when s.pos + 1 < s.len && s.src.[s.pos + 1] = '\\' ->
+    (* Character literal: #\a, #\space, #\newline, etc. *)
+    advance s; advance s;
+    if at_end s then raise (Parse_error "Unexpected end of input after #\\");
+    let char_start = s.pos in
+    (* Read a name if starts with ident char, else single char *)
+    if is_ident_start s.src.[s.pos] then begin
+      while s.pos < s.len && is_ident_char s.src.[s.pos] do advance s done;
+      let name = String.sub s.src char_start (s.pos - char_start) in
+      let cp = match name with
+        | "space" -> 32 | "newline" -> 10 | "tab" -> 9
+        | "return" -> 13 | "nul" -> 0 | "null" -> 0
+        | "escape" -> 27 | "delete" -> 127 | "backspace" -> 8
+        | "altmode" -> 27 | "rubout" -> 127
+        | _ -> Char.code name.[0]  (* single letter like #\a *)
+      in Char cp
+    end else begin
+      let c = s.src.[s.pos] in
+      advance s;
+      Char (Char.code c)
+    end
+  | '#' when s.pos + 1 < s.len &&
+             (s.src.[s.pos + 1] = 't' || s.src.[s.pos + 1] = 'f') &&
+             (s.pos + 2 >= s.len || not (is_ident_char s.src.[s.pos + 2])) ->
+    (* #t / #f — boolean literals (R7RS shorthand) *)
+    let b = s.src.[s.pos + 1] = 't' in
+    advance s; advance s;
+    Bool b
   | '#' when s.pos + 1 < s.len && s.src.[s.pos + 1] = ';' ->
     (* Datum comment: #; discards next expression *)
     advance s; advance s;

hosts/ocaml/lib/sx_runtime.ml

@@ -46,7 +46,7 @@ let sx_call f args =
     !Sx_types._cek_eval_lambda_ref f args
   | Continuation (k, _) ->
     k (match args with x :: _ -> x | [] -> Nil)
-  | CallccContinuation _ ->
+  | CallccContinuation (_, _) ->
     raise (Eval_error "callcc continuations must be invoked through the CEK machine")
   | _ ->
     let nargs = List.length args in
@@ -156,6 +156,9 @@ let get_val container key =
      | "extra" -> f.cf_extra | "extra2" -> f.cf_extra2
      | "subscribers" -> f.cf_results
      | "prev-tracking" -> f.cf_extra
+     | "after-thunk" -> f.cf_f        (* wind-after frame *)
+     | "winders-len" -> f.cf_extra    (* wind-after frame *)
+     | "body-result" -> f.cf_name     (* wind-return frame *)
      | _ -> Nil)
   | VmFrame f, String k ->
     (match k with
@@ -208,6 +211,8 @@ let get_val container key =
   | Dict d, Keyword k -> dict_get d k
   | (List l | ListRef { contents = l }), Number n ->
     (try List.nth l (int_of_float n) with _ -> Nil)
+  | (List l | ListRef { contents = l }), Integer n ->
+    (try List.nth l n with _ -> Nil)
   | Nil, _ -> Nil  (* nil.anything → nil *)
   | _, _ -> Nil    (* type mismatch → nil (matches JS/Python behavior) *)
 
@@ -381,15 +386,20 @@ let continuation_data v = match v with
   | _ -> raise (Eval_error "not a continuation")
 
 (* Callcc (undelimited) continuation support *)
-let callcc_continuation_p v = match v with CallccContinuation _ -> Bool true | _ -> Bool false
+let callcc_continuation_p v = match v with CallccContinuation (_, _) -> Bool true | _ -> Bool false
 
-let make_callcc_continuation captured =
-  CallccContinuation (sx_to_list captured)
+let make_callcc_continuation captured winders_len =
+  let n = match winders_len with Number f -> int_of_float f | Integer n -> n | _ -> 0 in
+  CallccContinuation (sx_to_list captured, n)
 
 let callcc_continuation_data v = match v with
-  | CallccContinuation frames -> List frames
+  | CallccContinuation (frames, _) -> List frames
   | _ -> raise (Eval_error "not a callcc continuation")
 
+let callcc_continuation_winders_len v = match v with
+  | CallccContinuation (_, n) -> Number (float_of_int n)
+  | _ -> Number 0.0
+
 (* Dynamic wind — simplified for OCaml (no async) *)
 let host_error msg =
   raise (Eval_error (value_to_str msg))

hosts/ocaml/lib/sx_types.ml

@@ -44,7 +44,8 @@ type env = {
 and value =
   | Nil
   | Bool    of bool
-  | Number of float
+  | Integer of int    (** Exact integer — distinct from inexact float. *)
+  | Number  of float  (** Inexact float. *)
   | String  of string
   | Symbol of string
   | Keyword of string
@@ -56,7 +57,7 @@ and value =
   | Macro  of macro
   | Thunk  of value * env
   | Continuation of (value -> value) * dict option
-  | CallccContinuation of value list  (** Undelimited continuation — captured kont frames *)
+  | CallccContinuation of value list * int  (** Undelimited continuation — captured kont frames + winders depth at capture *)
   | NativeFn of string * (value list -> value)
   | Signal of signal
   | RawHTML of string
@@ -72,6 +73,25 @@ and value =
   | Record of record  (** R7RS record — opaque, generative, field-indexed. *)
   | Parameter of parameter  (** R7RS parameter — dynamic binding via kont-stack provide frames. *)
   | Vector of value array  (** R7RS vector — mutable fixed-size array. *)
+  | StringBuffer of Buffer.t  (** Mutable string buffer — O(1) amortized append. *)
+  | HashTable of (value, value) Hashtbl.t  (** Mutable hash table with arbitrary keys. *)
+  | Char of int  (** Unicode codepoint — R7RS char type. *)
+  | Eof            (** EOF sentinel — returned by read-char etc. at end of input. *)
+  | Port of sx_port  (** String port — input (string cursor) or output (buffer). *)
+  | Rational of int * int  (** Exact rational: numerator, denominator (reduced, denom>0). *)
+  | SxSet of (string, value) Hashtbl.t  (** Mutable set keyed by inspect(value). *)
+  | SxRegexp of string * string * Re.re  (** Regexp: source, flags, compiled. *)
+  | SxBytevector of bytes  (** Mutable bytevector — R7RS bytevector type. *)
+
+(** String input port: source string + mutable cursor position. *)
+and sx_port_kind =
+  | PortInput of string * int ref
+  | PortOutput of Buffer.t
+
+and sx_port = {
+  mutable sp_closed : bool;
+  sp_kind : sx_port_kind;
+}
 
 (** CEK machine state — record instead of Dict for performance.
     5 fields × 55K steps/sec = 275K Hashtbl allocations/sec eliminated. *)
@@ -392,6 +412,7 @@ let format_number n =
 
 let value_to_string = function
   | String s -> s | Symbol s -> s | Keyword k -> k
+  | Integer n -> string_of_int n
   | Number n -> format_number n
   | Bool true -> "true" | Bool false -> "false"
   | Nil -> "" | _ -> "<value>"
@@ -461,6 +482,7 @@ let make_keyword name = Keyword (value_to_string name)
 let type_of = function
   | Nil            -> "nil"
   | Bool _         -> "boolean"
+  | Integer _      -> "number"
   | Number _       -> "number"
   | String _       -> "string"
   | Symbol _       -> "symbol"
@@ -473,7 +495,7 @@ let type_of = function
   | Macro _        -> "macro"
   | Thunk _        -> "thunk"
   | Continuation (_, _) -> "continuation"
-  | CallccContinuation _ -> "continuation"
+  | CallccContinuation (_, _) -> "continuation"
   | NativeFn _     -> "function"
   | Signal _       -> "signal"
   | RawHTML _      -> "raw-html"
@@ -488,6 +510,16 @@ let type_of = function
   | Record r       -> r.r_type.rt_name
   | Parameter _    -> "parameter"
   | Vector _       -> "vector"
+  | StringBuffer _ -> "string-buffer"
+  | HashTable _    -> "hash-table"
+  | Char _         -> "char"
+  | Eof            -> "eof-object"
+  | Port { sp_kind = PortInput _; _ }  -> "input-port"
+  | Port { sp_kind = PortOutput _; _ } -> "output-port"
+  | Rational _  -> "rational"
+  | SxSet _          -> "set"
+  | SxRegexp _       -> "regexp"
+  | SxBytevector _   -> "bytevector"
 
 let is_nil = function Nil -> true | _ -> false
 let is_lambda = function Lambda _ -> true | _ -> false
@@ -503,7 +535,7 @@ let is_signal = function
 let is_record = function Record _ -> true | _ -> false
 
 let is_callable = function
-  | Lambda _ | NativeFn _ | Continuation (_, _) | CallccContinuation _ | VmClosure _ -> true
+  | Lambda _ | NativeFn _ | Continuation (_, _) | CallccContinuation (_, _) | VmClosure _ -> true
   | _ -> false
 
 
@@ -616,6 +648,7 @@ let thunk_env = function
 (** {1 Record operations} *)
 
 let val_to_int = function
+  | Integer n -> n
   | Number n -> int_of_float n
   | v -> raise (Eval_error ("Expected number, got " ^ type_of v))
 
@@ -777,6 +810,7 @@ let rec inspect = function
   | Nil -> "nil"
   | Bool true -> "true"
   | Bool false -> "false"
+  | Integer n -> string_of_int n
   | Number n -> format_number n
   | String s ->
     let buf = Buffer.create (String.length s + 2) in
@@ -810,7 +844,7 @@ let rec inspect = function
     Printf.sprintf "<%s(%s)>" tag (String.concat ", " m.m_params)
   | Thunk _ -> "<thunk>"
   | Continuation (_, _) -> "<continuation>"
-  | CallccContinuation _ -> "<callcc-continuation>"
+  | CallccContinuation (_, _) -> "<callcc-continuation>"
   | NativeFn (name, _) -> Printf.sprintf "<native:%s>" name
   | Signal _ -> "<signal>"
   | RawHTML s -> Printf.sprintf "\"<raw-html:%d>\"" (String.length s)
@@ -831,3 +865,23 @@ let rec inspect = function
     Printf.sprintf "#(%s)" (String.concat " " elts)
   | VmFrame f -> Printf.sprintf "<vm-frame:ip=%d base=%d>" f.vf_ip f.vf_base
   | VmMachine m -> Printf.sprintf "<vm-machine:sp=%d frames=%d>" m.vm_sp (List.length m.vm_frames)
+  | StringBuffer buf -> Printf.sprintf "<string-buffer:%d>" (Buffer.length buf)
+  | HashTable ht -> Printf.sprintf "<hash-table:%d>" (Hashtbl.length ht)
+  | Char n ->
+    let name = match n with
+      | 32 -> "space" | 10 -> "newline" | 9 -> "tab"
+      | 13 -> "return" | 0 -> "nul" | 27 -> "escape"
+      | 127 -> "delete" | 8 -> "backspace"
+      | _ -> let buf = Buffer.create 1 in
+             Buffer.add_utf_8_uchar buf (Uchar.of_int n);
+             Buffer.contents buf
+    in "#\\" ^ name
+  | Eof -> "#!eof"
+  | Port { sp_kind = PortInput (_, pos); sp_closed } ->
+    Printf.sprintf "<input-port:pos=%d%s>" !pos (if sp_closed then ":closed" else "")
+  | Port { sp_kind = PortOutput buf; sp_closed } ->
+    Printf.sprintf "<output-port:len=%d%s>" (Buffer.length buf) (if sp_closed then ":closed" else "")
+  | Rational (n, d) -> Printf.sprintf "%d/%d" n d
+  | SxSet ht -> Printf.sprintf "<set:%d>" (Hashtbl.length ht)
+  | SxRegexp (src, flags, _) -> Printf.sprintf "#/%s/%s" src flags
+  | SxBytevector b -> Printf.sprintf "#u8(%s)" (String.concat " " (List.init (Bytes.length b) (fun i -> string_of_int (Char.code (Bytes.get b i)))))

hosts/ocaml/lib/sx_vm.ml

@@ -185,7 +185,8 @@ let code_from_value v =
       | Some _ as r -> r | None -> Hashtbl.find_opt d k2 in
     let bc_list = match find2 "bytecode" "vc-bytecode" with
       | Some (List l | ListRef { contents = l }) ->
-        Array.of_list (List.map (fun x -> match x with Number n -> int_of_float n | _ -> 0) l)
+        Array.of_list (List.map (fun x -> match x with
+          | Integer n -> n | Number n -> int_of_float n | _ -> 0) l)
       | _ -> [||]
     in
     let entries = match find2 "constants" "vc-constants" with
@@ -198,10 +199,10 @@ let code_from_value v =
       | _ -> entry
     ) entries in
     let arity = match find2 "arity" "vc-arity" with
-      | Some (Number n) -> int_of_float n | _ -> 0
+      | Some (Integer n) -> n | Some (Number n) -> int_of_float n | _ -> 0
     in
     let rest_arity = match find2 "rest-arity" "vc-rest-arity" with
-      | Some (Number n) -> int_of_float n | _ -> -1
+      | Some (Integer n) -> n | Some (Number n) -> int_of_float n | _ -> -1
     in
     (* Compute locals from bytecode: scan for highest LOCAL_GET/LOCAL_SET slot.
        The compiler's arity may undercount when nested lets add many locals. *)
@@ -749,10 +750,7 @@ and run vm =
             | _ -> (Hashtbl.find Sx_primitives.primitives "/") [a; b])
         | 164 (* OP_EQ *) ->
           let b = pop vm and a = pop vm in
-          let rec norm = function
-            | ListRef { contents = l } -> List (List.map norm l)
-            | List l -> List (List.map norm l) | v -> v in
-          push vm (Bool (norm a = norm b))
+          push vm ((Hashtbl.find Sx_primitives.primitives "=") [a; b])
         | 165 (* OP_LT *) ->
           let b = pop vm and a = pop vm in
           push vm (match a, b with
@@ -771,10 +769,10 @@ and run vm =
         | 168 (* OP_LEN *) ->
           let v = pop vm in
           push vm (match v with
-            | List l | ListRef { contents = l } -> Number (float_of_int (List.length l))
-            | String s -> Number (float_of_int (String.length s))
-            | Dict d -> Number (float_of_int (Hashtbl.length d))
-            | Nil -> Number 0.0
+            | List l | ListRef { contents = l } -> Integer (List.length l)
+            | String s -> Integer (String.length s)
+            | Dict d -> Integer (Hashtbl.length d)
+            | Nil -> Integer 0
             | _ -> (Hashtbl.find Sx_primitives.primitives "len") [v])
         | 169 (* OP_FIRST *) ->
           let v = pop vm in

hosts/ocaml/transpiler.sx

@@ -256,6 +256,7 @@
     "callcc-continuation?"
     "callcc-continuation-data"
     "make-callcc-continuation"
+    "callcc-continuation-winders-len"
     "dynamic-wind-call"
     "strip-prefix"
     "component-set-param-types!"
@@ -295,7 +296,8 @@
     "*bind-tracking*"
     "*provide-batch-depth*"
     "*provide-batch-queue*"
-    "*provide-subscribers*"))
+    "*provide-subscribers*"
+    "*winders*"))
 
 (define
   ml-is-mutable-global?
@@ -533,13 +535,13 @@
               "; cf_env = "
               (ef "env")
               "; cf_name = "
-              (if (= frame-type "if") (ef "else") (ef "name"))
+              (if (= frame-type "if") (ef "else") (cond (some (fn (k) (= k "body-result")) items) (ef "body-result") :else (ef "name")))
               "; cf_body = "
               (if (= frame-type "if") (ef "then") (ef "body"))
               "; cf_remaining = "
               (ef "remaining")
               "; cf_f = "
-              (ef "f")
+              (cond (some (fn (k) (= k "after-thunk")) items) (ef "after-thunk") (some (fn (k) (= k "f")) items) (ef "f") :else "Nil")
               "; cf_args = "
               (cond
                 (some (fn (k) (= k "evaled")) items)
@@ -582,6 +584,8 @@
                 (ef "prev-tracking")
                 (some (fn (k) (= k "extra")) items)
                 (ef "extra")
+                (some (fn (k) (= k "winders-len")) items)
+                (ef "winders-len")
                 :else "Nil")
               "; cf_extra2 = "
               (cond

lib/js/conformance.sh

@@ -49,6 +49,8 @@ trap "rm -f $TMPFILE" EXIT
   echo '(load "lib/js/transpile.sx")'
   echo '(epoch 5)'
   echo '(load "lib/js/runtime.sx")'
+  echo '(epoch 6)'
+  echo '(load "lib/js/regex.sx")'
 
   epoch=100
   for f in "${FIXTURES[@]}"; do

lib/js/lexer.sx

@@ -29,16 +29,6 @@
       (and (>= c "a") (<= c "f"))
       (and (>= c "A") (<= c "F")))))
 
-(define
-  js-hex-value
-  (fn
-    (c)
-    (cond
-      ((and (>= c "0") (<= c "9")) (- (char-code c) 48))
-      ((and (>= c "a") (<= c "f")) (- (char-code c) 87))
-      ((and (>= c "A") (<= c "F")) (- (char-code c) 55))
-      (else 0))))
-
 (define
   js-letter?
   (fn (c) (or (and (>= c "a") (<= c "z")) (and (>= c "A") (<= c "Z")))))
@@ -47,9 +37,9 @@
 
 (define js-ident-char? (fn (c) (or (js-ident-start? c) (js-digit? c))))
 
-;; ── Reserved words ────────────────────────────────────────────────
 (define js-ws? (fn (c) (or (= c " ") (= c "\t") (= c "\n") (= c "\r"))))
 
+;; ── Reserved words ────────────────────────────────────────────────
 (define
   js-keywords
   (list
@@ -96,18 +86,15 @@
     "await"
     "of"))
 
-;; ── Main tokenizer ────────────────────────────────────────────────
 (define js-keyword? (fn (word) (contains? js-keywords word)))
 
+;; ── Main tokenizer ────────────────────────────────────────────────
 (define
   js-tokenize
   (fn
     (src)
     (let
-      ((tokens (list))
-        (pos 0)
-        (src-len (len src))
-        (nl-before false))
+      ((tokens (list)) (pos 0) (src-len (len src)))
       (define
         js-peek
         (fn
@@ -122,7 +109,11 @@
           (let
             ((sl (len s)))
             (and (<= (+ pos sl) src-len) (= (slice src pos (+ pos sl)) s)))))
-      (define js-emit! (fn (type value start) (append! tokens {:nl nl-before :type type :value value :pos start})))
+      (define
+        js-emit!
+        (fn
+          (type value start)
+          (append! tokens (js-make-token type value start))))
       (define
         skip-line-comment!
         (fn
@@ -145,13 +136,7 @@
           ()
           (cond
             ((>= pos src-len) nil)
-            ((js-ws? (cur))
-              (do
-                (when
-                  (or (= (cur) "\n") (= (cur) "\r"))
-                  (set! nl-before true))
-                (advance! 1)
-                (skip-ws!)))
+            ((js-ws? (cur)) (do (advance! 1) (skip-ws!)))
             ((and (= (cur) "/") (< (+ pos 1) src-len) (= (js-peek 1) "/"))
               (do (advance! 2) (skip-line-comment!) (skip-ws!)))
             ((and (= (cur) "/") (< (+ pos 1) src-len) (= (js-peek 1) "*"))
@@ -269,55 +254,11 @@
                               ((= ch "b") (append! chars "\\b"))
                               ((= ch "f") (append! chars "\\f"))
                               ((= ch "v") (append! chars "\\v"))
-                              ((= ch "u")
-                                (if
-                                  (and
-                                    (< (+ pos 4) src-len)
-                                    (js-hex-digit? (js-peek 1))
-                                    (js-hex-digit? (js-peek 2))
-                                    (js-hex-digit? (js-peek 3))
-                                    (js-hex-digit? (js-peek 4)))
-                                  (do
-                                    (append!
-                                      chars
-                                      (char-from-code
-                                        (+
-                                          (*
-                                            4096
-                                            (js-hex-value
-                                              (js-peek 1)))
-                                          (*
-                                            256
-                                            (js-hex-value
-                                              (js-peek 2)))
-                                          (*
-                                            16
-                                            (js-hex-value
-                                              (js-peek 3)))
-                                          (js-hex-value (js-peek 4)))))
-                                    (advance! 4))
-                                  (append! chars ch)))
-                              ((= ch "x")
-                                (if
-                                  (and
-                                    (< (+ pos 2) src-len)
-                                    (js-hex-digit? (js-peek 1))
-                                    (js-hex-digit? (js-peek 2)))
-                                  (do
-                                    (append!
-                                      chars
-                                      (char-from-code
-                                        (+
-                                          (* 16 (js-hex-value (js-peek 1)))
-                                          (js-hex-value (js-peek 2)))))
-                                    (advance! 2))
-                                  (append! chars ch)))
                               (else (append! chars ch)))
                             (advance! 1))))
                       (loop)))
                   ((= (cur) quote-char) (advance! 1))
-                  (else
-                    (do (append! chars (cur)) (advance! 1) (loop))))))
+                  (else (do (append! chars (cur)) (advance! 1) (loop))))))
             (loop)
             (join "" chars))))
       (define
@@ -348,8 +289,7 @@
                       ()
                       (cond
                         ((>= pos src-len) nil)
-                        ((and (= (cur) "}") (= depth 1))
-                          (advance! 1))
+                        ((and (= (cur) "}") (= depth 1)) (advance! 1))
                         ((= (cur) "}")
                           (do
                             (append! buf (cur))
@@ -385,9 +325,7 @@
                                             (advance! 1)))
                                         (sloop)))
                                     ((= (cur) q)
-                                      (do
-                                        (append! buf (cur))
-                                        (advance! 1)))
+                                      (do (append! buf (cur)) (advance! 1)))
                                     (else
                                       (do
                                         (append! buf (cur))
@@ -396,10 +334,7 @@
                               (sloop)
                               (expr-loop))))
                         (else
-                          (do
-                            (append! buf (cur))
-                            (advance! 1)
-                            (expr-loop))))))
+                          (do (append! buf (cur)) (advance! 1) (expr-loop))))))
                   (expr-loop)
                   (join "" buf))))
             (define
@@ -441,17 +376,14 @@
                               (else (append! chars ch)))
                             (advance! 1))))
                       (loop)))
-                  (else
-                    (do (append! chars (cur)) (advance! 1) (loop))))))
+                  (else (do (append! chars (cur)) (advance! 1) (loop))))))
             (loop)
             (flush-chars!)
             (if
               (= (len parts) 0)
               ""
               (if
-                (and
-                  (= (len parts) 1)
-                  (= (nth (nth parts 0) 0) "str"))
+                (and (= (len parts) 1) (= (nth (nth parts 0) 0) "str"))
                 (nth (nth parts 0) 1)
                 parts)))))
       (define
@@ -467,7 +399,7 @@
                 ((ty (dict-get tk "type")) (vv (dict-get tk "value")))
                 (cond
                   ((= ty "punct")
-                    (and (not (= vv ")")) (not (= vv "]")) (not (= vv "}"))))
+                    (and (not (= vv ")")) (not (= vv "]"))))
                   ((= ty "op") true)
                   ((= ty "keyword")
                     (contains?
@@ -521,13 +453,9 @@
                       (append! buf (cur))
                       (advance! 1)
                       (body-loop)))
-                  ((and (= (cur) "/") (not in-class))
-                    (advance! 1))
+                  ((and (= (cur) "/") (not in-class)) (advance! 1))
                   (else
-                    (begin
-                      (append! buf (cur))
-                      (advance! 1)
-                      (body-loop))))))
+                    (begin (append! buf (cur)) (advance! 1) (body-loop))))))
             (body-loop)
             (let
               ((flags-buf (list)))
@@ -542,7 +470,7 @@
                       (advance! 1)
                       (flags-loop)))))
               (flags-loop)
-              {:flags (join "" flags-buf) :pattern (join "" buf)}))))
+              {:pattern (join "" buf) :flags (join "" flags-buf)}))))
       (define
         try-op-4!
         (fn
@@ -582,113 +510,64 @@
         (fn
           (start)
           (cond
-            ((at? "==")
-              (do (js-emit! "op" "==" start) (advance! 2) true))
-            ((at? "!=")
-              (do (js-emit! "op" "!=" start) (advance! 2) true))
-            ((at? "<=")
-              (do (js-emit! "op" "<=" start) (advance! 2) true))
-            ((at? ">=")
-              (do (js-emit! "op" ">=" start) (advance! 2) true))
-            ((at? "&&")
-              (do (js-emit! "op" "&&" start) (advance! 2) true))
-            ((at? "||")
-              (do (js-emit! "op" "||" start) (advance! 2) true))
-            ((at? "??")
-              (do (js-emit! "op" "??" start) (advance! 2) true))
-            ((at? "=>")
-              (do (js-emit! "op" "=>" start) (advance! 2) true))
-            ((at? "**")
-              (do (js-emit! "op" "**" start) (advance! 2) true))
-            ((at? "<<")
-              (do (js-emit! "op" "<<" start) (advance! 2) true))
-            ((at? ">>")
-              (do (js-emit! "op" ">>" start) (advance! 2) true))
-            ((at? "++")
-              (do (js-emit! "op" "++" start) (advance! 2) true))
-            ((at? "--")
-              (do (js-emit! "op" "--" start) (advance! 2) true))
-            ((at? "+=")
-              (do (js-emit! "op" "+=" start) (advance! 2) true))
-            ((at? "-=")
-              (do (js-emit! "op" "-=" start) (advance! 2) true))
-            ((at? "*=")
-              (do (js-emit! "op" "*=" start) (advance! 2) true))
-            ((at? "/=")
-              (do (js-emit! "op" "/=" start) (advance! 2) true))
-            ((at? "%=")
-              (do (js-emit! "op" "%=" start) (advance! 2) true))
-            ((at? "&=")
-              (do (js-emit! "op" "&=" start) (advance! 2) true))
-            ((at? "|=")
-              (do (js-emit! "op" "|=" start) (advance! 2) true))
-            ((at? "^=")
-              (do (js-emit! "op" "^=" start) (advance! 2) true))
-            ((at? "?.")
-              (do (js-emit! "op" "?." start) (advance! 2) true))
+            ((at? "==") (do (js-emit! "op" "==" start) (advance! 2) true))
+            ((at? "!=") (do (js-emit! "op" "!=" start) (advance! 2) true))
+            ((at? "<=") (do (js-emit! "op" "<=" start) (advance! 2) true))
+            ((at? ">=") (do (js-emit! "op" ">=" start) (advance! 2) true))
+            ((at? "&&") (do (js-emit! "op" "&&" start) (advance! 2) true))
+            ((at? "||") (do (js-emit! "op" "||" start) (advance! 2) true))
+            ((at? "??") (do (js-emit! "op" "??" start) (advance! 2) true))
+            ((at? "=>") (do (js-emit! "op" "=>" start) (advance! 2) true))
+            ((at? "**") (do (js-emit! "op" "**" start) (advance! 2) true))
+            ((at? "<<") (do (js-emit! "op" "<<" start) (advance! 2) true))
+            ((at? ">>") (do (js-emit! "op" ">>" start) (advance! 2) true))
+            ((at? "++") (do (js-emit! "op" "++" start) (advance! 2) true))
+            ((at? "--") (do (js-emit! "op" "--" start) (advance! 2) true))
+            ((at? "+=") (do (js-emit! "op" "+=" start) (advance! 2) true))
+            ((at? "-=") (do (js-emit! "op" "-=" start) (advance! 2) true))
+            ((at? "*=") (do (js-emit! "op" "*=" start) (advance! 2) true))
+            ((at? "/=") (do (js-emit! "op" "/=" start) (advance! 2) true))
+            ((at? "%=") (do (js-emit! "op" "%=" start) (advance! 2) true))
+            ((at? "&=") (do (js-emit! "op" "&=" start) (advance! 2) true))
+            ((at? "|=") (do (js-emit! "op" "|=" start) (advance! 2) true))
+            ((at? "^=") (do (js-emit! "op" "^=" start) (advance! 2) true))
+            ((at? "?.") (do (js-emit! "op" "?." start) (advance! 2) true))
             (else false))))
       (define
         emit-one-op!
         (fn
           (ch start)
           (cond
-            ((= ch "(")
-              (do (js-emit! "punct" "(" start) (advance! 1)))
-            ((= ch ")")
-              (do (js-emit! "punct" ")" start) (advance! 1)))
-            ((= ch "[")
-              (do (js-emit! "punct" "[" start) (advance! 1)))
-            ((= ch "]")
-              (do (js-emit! "punct" "]" start) (advance! 1)))
-            ((= ch "{")
-              (do (js-emit! "punct" "{" start) (advance! 1)))
-            ((= ch "}")
-              (do (js-emit! "punct" "}" start) (advance! 1)))
-            ((= ch ",")
-              (do (js-emit! "punct" "," start) (advance! 1)))
-            ((= ch ";")
-              (do (js-emit! "punct" ";" start) (advance! 1)))
-            ((= ch ":")
-              (do (js-emit! "punct" ":" start) (advance! 1)))
-            ((= ch ".")
-              (do (js-emit! "punct" "." start) (advance! 1)))
-            ((= ch "?")
-              (do (js-emit! "op" "?" start) (advance! 1)))
-            ((= ch "+")
-              (do (js-emit! "op" "+" start) (advance! 1)))
-            ((= ch "-")
-              (do (js-emit! "op" "-" start) (advance! 1)))
-            ((= ch "*")
-              (do (js-emit! "op" "*" start) (advance! 1)))
-            ((= ch "/")
-              (do (js-emit! "op" "/" start) (advance! 1)))
-            ((= ch "%")
-              (do (js-emit! "op" "%" start) (advance! 1)))
-            ((= ch "=")
-              (do (js-emit! "op" "=" start) (advance! 1)))
-            ((= ch "<")
-              (do (js-emit! "op" "<" start) (advance! 1)))
-            ((= ch ">")
-              (do (js-emit! "op" ">" start) (advance! 1)))
-            ((= ch "!")
-              (do (js-emit! "op" "!" start) (advance! 1)))
-            ((= ch "&")
-              (do (js-emit! "op" "&" start) (advance! 1)))
-            ((= ch "|")
-              (do (js-emit! "op" "|" start) (advance! 1)))
-            ((= ch "^")
-              (do (js-emit! "op" "^" start) (advance! 1)))
-            ((= ch "~")
-              (do (js-emit! "op" "~" start) (advance! 1)))
-            ((= ch "\\")
-              (error "Unexpected char '\\' in source"))
+            ((= ch "(") (do (js-emit! "punct" "(" start) (advance! 1)))
+            ((= ch ")") (do (js-emit! "punct" ")" start) (advance! 1)))
+            ((= ch "[") (do (js-emit! "punct" "[" start) (advance! 1)))
+            ((= ch "]") (do (js-emit! "punct" "]" start) (advance! 1)))
+            ((= ch "{") (do (js-emit! "punct" "{" start) (advance! 1)))
+            ((= ch "}") (do (js-emit! "punct" "}" start) (advance! 1)))
+            ((= ch ",") (do (js-emit! "punct" "," start) (advance! 1)))
+            ((= ch ";") (do (js-emit! "punct" ";" start) (advance! 1)))
+            ((= ch ":") (do (js-emit! "punct" ":" start) (advance! 1)))
+            ((= ch ".") (do (js-emit! "punct" "." start) (advance! 1)))
+            ((= ch "?") (do (js-emit! "op" "?" start) (advance! 1)))
+            ((= ch "+") (do (js-emit! "op" "+" start) (advance! 1)))
+            ((= ch "-") (do (js-emit! "op" "-" start) (advance! 1)))
+            ((= ch "*") (do (js-emit! "op" "*" start) (advance! 1)))
+            ((= ch "/") (do (js-emit! "op" "/" start) (advance! 1)))
+            ((= ch "%") (do (js-emit! "op" "%" start) (advance! 1)))
+            ((= ch "=") (do (js-emit! "op" "=" start) (advance! 1)))
+            ((= ch "<") (do (js-emit! "op" "<" start) (advance! 1)))
+            ((= ch ">") (do (js-emit! "op" ">" start) (advance! 1)))
+            ((= ch "!") (do (js-emit! "op" "!" start) (advance! 1)))
+            ((= ch "&") (do (js-emit! "op" "&" start) (advance! 1)))
+            ((= ch "|") (do (js-emit! "op" "|" start) (advance! 1)))
+            ((= ch "^") (do (js-emit! "op" "^" start) (advance! 1)))
+            ((= ch "~") (do (js-emit! "op" "~" start) (advance! 1)))
             (else (advance! 1)))))
       (define
         scan!
         (fn
           ()
           (do
-            (set! nl-before false)
             (skip-ws!)
             (when
               (< pos src-len)

lib/js/parser.sx

@@ -153,32 +153,6 @@
           (do (jp-advance! st) (list (quote js-ident) "this")))
         ((and (= (get t :type) "keyword") (= (get t :value) "new"))
           (do (jp-advance! st) (jp-parse-new-expr st)))
-        ((and (= (get t :type) "keyword") (= (get t :value) "function"))
-          (do
-            (jp-advance! st)
-            (let
-              ((nm
-                 (if
-                   (= (get (jp-peek st) :type) "ident")
-                   (let ((n (get (jp-peek st) :value))) (do (jp-advance! st) n))
-                   nil)))
-              (let
-                ((params (jp-parse-param-list st)))
-                (let
-                  ((body (jp-parse-fn-body st)))
-                  (list (quote js-funcexpr) nm params body))))))
-        ((and (= (get t :type) "keyword") (= (get t :value) "true"))
-          (do (jp-advance! st) (list (quote js-bool) true)))
-        ((and (= (get t :type) "keyword") (= (get t :value) "false"))
-          (do (jp-advance! st) (list (quote js-bool) false)))
-        ((and (= (get t :type) "keyword") (= (get t :value) "null"))
-          (do (jp-advance! st) (list (quote js-null))))
-        ((and (= (get t :type) "keyword") (= (get t :value) "undefined"))
-          (do (jp-advance! st) (list (quote js-undef))))
-        ((= (get t :type) "number")
-          (do (jp-advance! st) (list (quote js-num) (get t :value))))
-        ((= (get t :type) "string")
-          (do (jp-advance! st) (list (quote js-str) (get t :value))))
         ((and (= (get t :type) "punct") (= (get t :value) "("))
           (jp-parse-paren-or-arrow st))
         (else
@@ -237,7 +211,7 @@
               (let
                 ((params (jp-parse-param-list st)))
                 (let
-                  ((body (jp-parse-fn-body st)))
+                  ((body (jp-parse-block st)))
                   (list (quote js-funcexpr-async) nm params body))))))
         ((= (get t :type) "ident")
           (do
@@ -389,7 +363,7 @@
               (let
                 ((params (jp-parse-param-list st)))
                 (let
-                  ((body (jp-parse-fn-body st)))
+                  ((body (jp-parse-block st)))
                   (list (quote js-funcexpr) nm params body))))))
         ((= (get t :type) "ident")
           (do
@@ -444,51 +418,16 @@
               (dict-set! st :idx saved)
               (jp-advance! st)
               (let
-                ((e (jp-parse-comma-seq st)))
+                ((e (jp-parse-assignment st)))
                 (jp-expect! st "punct" ")")
-                (jp-paren-wrap e))))
+                e)))
           (do
             (dict-set! st :idx saved)
             (jp-advance! st)
             (let
-              ((e (jp-parse-comma-seq st)))
+              ((e (jp-parse-assignment st)))
               (jp-expect! st "punct" ")")
-              (jp-paren-wrap e))))))))
-
-(define
-  jp-paren-wrap
-  (fn
-    (e)
-    (cond
-      ((and (list? e) (= (first e) (quote js-unop)))
-        (list (quote js-paren) e))
-      (else e))))
-
-(define
-  jp-parse-comma-seq
-  (fn
-    (st)
-    (let
-      ((first-expr (jp-parse-assignment st)))
-      (if
-        (jp-at? st "punct" ",")
-        (jp-parse-comma-seq-rest st (list first-expr))
-        first-expr))))
-
-(define
-  jp-parse-comma-seq-rest
-  (fn
-    (st acc)
-    (do
-      (jp-advance! st)
-      (let
-        ((next-expr (jp-parse-assignment st)))
-        (let
-          ((acc2 (append acc (list next-expr))))
-          (if
-            (jp-at? st "punct" ",")
-            (jp-parse-comma-seq-rest st acc2)
-            (cons (quote js-comma) (list acc2))))))))
+              e)))))))
 
 (define
   jp-collect-params
@@ -546,11 +485,6 @@
     (st elems)
     (cond
       ((jp-at? st "punct" "]") nil)
-      ((jp-at? st "punct" ",")
-        (begin
-          (append! elems (list (quote js-undef)))
-          (jp-advance! st)
-          (jp-array-loop st elems)))
       (else
         (begin
           (cond
@@ -624,20 +558,6 @@
             (jp-advance! st)
             (jp-expect! st "punct" ":")
             (append! kvs {:value (jp-parse-assignment st) :key (get t :value)})))
-        ((and (= (get t :type) "punct") (= (get t :value) "["))
-          (do
-            (jp-advance! st)
-            (let
-              ((key-expr (jp-parse-assignment st)))
-              (jp-expect! st "punct" "]")
-              (jp-expect! st "punct" ":")
-              (append!
-                kvs
-                {:value (jp-parse-assignment st) :computed-key key-expr :key ""}))))
-        ((and (= (get t :type) "punct") (= (get t :value) "..."))
-          (do
-            (jp-advance! st)
-            (append! kvs {:spread (jp-parse-assignment st)})))
         (else (error (str "Unexpected in object: " (get t :type))))))))
 
 (define
@@ -709,7 +629,7 @@
                       st
                       (list (quote js-optchain-member) left (get t :value))))
                   (error "expected ident, [ or ( after ?.")))))))
-      ((and (or (jp-at? st "op" "++") (jp-at? st "op" "--")) (not (jp-token-nl? st)))
+      ((or (jp-at? st "op" "++") (jp-at? st "op" "--"))
         (let
           ((op (get (jp-peek st) :value)))
           (jp-advance! st)
@@ -762,12 +682,6 @@
             (cond
               ((< prec 0) left)
               ((< prec min-prec) left)
-              ((and (= op "**") (list? left) (= (first left) (quote js-unop)))
-                (error
-                  (str
-                    "SyntaxError: Unary operator '"
-                    (nth left 1)
-                    "' used immediately before exponentiation expression")))
               (else
                 (do
                   (jp-advance! st)
@@ -921,12 +835,6 @@
   jp-eat-semi
   (fn (st) (if (jp-at? st "punct" ";") (do (jp-advance! st) nil) nil)))
 
-(define
-  jp-token-nl?
-  (fn
-    (st)
-    (let ((tok (jp-peek st))) (if tok (= (get tok :nl) true) false))))
-
 (define
   jp-parse-vardecl
   (fn
@@ -1144,63 +1052,15 @@
         ((c (jp-parse-assignment st)))
         (do
           (jp-expect! st "punct" ")")
-          (jp-disallow-decl-stmt! st "if")
           (let
             ((t (jp-parse-stmt st)))
             (if
               (jp-at? st "keyword" "else")
               (do
                 (jp-advance! st)
-                (jp-disallow-decl-stmt! st "else")
                 (list (quote js-if) c t (jp-parse-stmt st)))
               (list (quote js-if) c t nil))))))))
 
-(define
-  jp-disallow-decl-stmt!
-  (fn
-    (st context)
-    (let
-      ((t (jp-peek st)))
-      (cond
-        ((and (= (get t :type) "keyword")
-              (or (= (get t :value) "let")
-                  (= (get t :value) "const")
-                  (= (get t :value) "function")
-                  (= (get t :value) "class")))
-          (cond
-            ((and (= (get t :value) "let")
-                  (or (= (get (jp-peek-at st 1) :type) "ident")
-                      (and (= (get (jp-peek-at st 1) :type) "punct")
-                           (or (= (get (jp-peek-at st 1) :value) "[")
-                               (= (get (jp-peek-at st 1) :value) "{")))))
-              (error
-                (str
-                  "SyntaxError: Lexical declaration cannot appear in single-statement context: "
-                  context)))
-            ((or (= (get t :value) "const")
-                 (= (get t :value) "function")
-                 (= (get t :value) "class"))
-              (error
-                (str
-                  "SyntaxError: "
-                  (get t :value)
-                  " declaration cannot appear in single-statement context: "
-                  context)))
-            (else nil)))
-        (else nil)))))
-
-(define
-  jp-bump!
-  (fn
-    (st key)
-    (dict-set! st key (+ (get st key) 1))))
-
-(define
-  jp-decr!
-  (fn
-    (st key)
-    (dict-set! st key (- (get st key) 1))))
-
 (define
   jp-parse-while-stmt
   (fn
@@ -1212,11 +1072,7 @@
         ((c (jp-parse-assignment st)))
         (do
           (jp-expect! st "punct" ")")
-          (jp-disallow-decl-stmt! st "while")
-          (jp-bump! st :loop-depth)
-          (let ((body (jp-parse-stmt st)))
-            (jp-decr! st :loop-depth)
-            (list (quote js-while) c body)))))))
+          (let ((body (jp-parse-stmt st))) (list (quote js-while) c body)))))))
 
 (define
   jp-parse-do-while-stmt
@@ -1224,11 +1080,8 @@
     (st)
     (do
       (jp-advance! st)
-      (jp-disallow-decl-stmt! st "do")
-      (jp-bump! st :loop-depth)
       (let
         ((body (jp-parse-stmt st)))
-        (jp-decr! st :loop-depth)
         (do
           (if
             (jp-at? st "keyword" "while")
@@ -1273,11 +1126,8 @@
                   (let
                     ((iter (jp-parse-assignment st)))
                     (jp-expect! st "punct" ")")
-                    (jp-disallow-decl-stmt! st "for-of/in")
-                    (jp-bump! st :loop-depth)
                     (let
                       ((body (jp-parse-stmt st)))
-                      (jp-decr! st :loop-depth)
                       (list (quote js-for-of-in) iter-kind ident iter body)))))))
           (else
             (let
@@ -1288,11 +1138,8 @@
                 (let
                   ((step (if (jp-at? st "punct" ")") nil (jp-parse-assignment st))))
                   (jp-expect! st "punct" ")")
-                  (jp-disallow-decl-stmt! st "for")
-                  (jp-bump! st :loop-depth)
                   (let
                     ((body (jp-parse-stmt st)))
-                    (jp-decr! st :loop-depth)
                     (list (quote js-for) init cond-ast step body)))))))))))
 
 (define
@@ -1315,14 +1162,10 @@
     (st)
     (do
       (jp-advance! st)
-      (when
-        (= (get st :fn-depth) 0)
-        (error "SyntaxError: Illegal return statement"))
       (if
         (or
           (jp-at? st "punct" ";")
           (jp-at? st "punct" "}")
-          (jp-token-nl? st)
           (jp-at? st "eof" nil))
         (do (jp-eat-semi st) (list (quote js-return) nil))
         (let
@@ -1345,7 +1188,7 @@
           (let
             ((params (jp-parse-param-list st)))
             (let
-              ((body (jp-parse-fn-body st)))
+              ((body (jp-parse-block st)))
               (list (quote js-funcdecl) nm params body))))))))
 
 (define
@@ -1364,7 +1207,7 @@
           (let
             ((params (jp-parse-param-list st)))
             (let
-              ((body (jp-parse-fn-body st)))
+              ((body (jp-parse-block st)))
               (list (quote js-funcdecl-async) nm params body))))))))
 
 (define
@@ -1413,7 +1256,7 @@
           (let
             ((params (jp-parse-param-list st)))
             (let
-              ((body (jp-parse-fn-body st)))
+              ((body (jp-parse-block st)))
               (list
                 (quote js-method)
                 (if static? "static" "instance")
@@ -1441,11 +1284,9 @@
       ((disc (jp-parse-assignment st)))
       (jp-expect! st "punct" ")")
       (jp-expect! st "punct" "{")
-      (jp-bump! st :switch-depth)
       (let
         ((cases (list)))
         (jp-parse-switch-cases st cases)
-        (jp-decr! st :switch-depth)
         (jp-expect! st "punct" "}")
         (list (quote js-switch) disc cases)))))
 
@@ -1521,40 +1362,9 @@
       ((jp-at? st "keyword" "for") (jp-parse-for-stmt st))
       ((jp-at? st "keyword" "return") (jp-parse-return-stmt st))
       ((jp-at? st "keyword" "break")
-        (do
-          (jp-advance! st)
-          (cond
-            ((= (get (jp-peek st) :type) "ident")
         (do (jp-advance! st) (jp-eat-semi st) (list (quote js-break))))
-            (else
-              (do
-                (when
-                  (and (= (get st :loop-depth) 0) (= (get st :switch-depth) 0))
-                  (error "SyntaxError: Illegal break statement"))
-                (jp-eat-semi st)
-                (list (quote js-break)))))))
       ((jp-at? st "keyword" "continue")
-        (do
-          (jp-advance! st)
-          (cond
-            ((= (get (jp-peek st) :type) "ident")
         (do (jp-advance! st) (jp-eat-semi st) (list (quote js-continue))))
-            (else
-              (do
-                (when
-                  (= (get st :loop-depth) 0)
-                  (error "SyntaxError: Illegal continue statement"))
-                (jp-eat-semi st)
-                (list (quote js-continue)))))))
-      ((and
-         (= (get (jp-peek st) :type) "ident")
-         (= (get (jp-peek-at st 1) :type) "punct")
-         (= (get (jp-peek-at st 1) :value) ":"))
-        (do
-          (jp-advance! st)
-          (jp-advance! st)
-          (jp-disallow-decl-stmt! st "label")
-          (jp-parse-stmt st)))
       ((jp-at? st "keyword" "class") (jp-parse-class-decl st))
       ((jp-at? st "keyword" "throw") (jp-parse-throw-stmt st))
       ((jp-at? st "keyword" "try") (jp-parse-try-stmt st))
@@ -1564,7 +1374,7 @@
       ((jp-at? st "keyword" "switch") (jp-parse-switch-stmt st))
       (else
         (let
-          ((e (jp-parse-comma-seq st)))
+          ((e (jp-parse-assignment st)))
           (do (jp-eat-semi st) (list (quote js-exprstmt) e)))))))
 
 (define
@@ -1590,33 +1400,10 @@
   jp-parse-arrow-body
   (fn
     (st)
-    (jp-bump! st :fn-depth)
-    (let
-      ((saved-loop (get st :loop-depth)) (saved-switch (get st :switch-depth)))
-      (dict-set! st :loop-depth 0)
-      (dict-set! st :switch-depth 0)
-      (let
-        ((body (if (jp-at? st "punct" "{") (jp-parse-block st) (jp-parse-assignment st))))
-        (jp-decr! st :fn-depth)
-        (dict-set! st :loop-depth saved-loop)
-        (dict-set! st :switch-depth saved-switch)
-        body))))
-
-(define
-  jp-parse-fn-body
-  (fn
-    (st)
-    (jp-bump! st :fn-depth)
-    (let
-      ((saved-loop (get st :loop-depth)) (saved-switch (get st :switch-depth)))
-      (dict-set! st :loop-depth 0)
-      (dict-set! st :switch-depth 0)
-      (let
-        ((body (jp-parse-block st)))
-        (jp-decr! st :fn-depth)
-        (dict-set! st :loop-depth saved-loop)
-        (dict-set! st :switch-depth saved-switch)
-        body))))
+    (if
+      (jp-at? st "punct" "{")
+      (jp-parse-block st)
+      (jp-parse-assignment st))))
 
 (define
   js-parse
@@ -1627,7 +1414,7 @@
         (= (len tokens) 0)
         (and (= (len tokens) 1) (= (get (nth tokens 0) :type) "eof")))
       (list (quote js-program) (list))
-      (let ((st {:idx 0 :tokens tokens :arrow-candidate true :loop-depth 0 :switch-depth 0 :fn-depth 0})) (jp-parse-program st)))))
+      (let ((st {:idx 0 :tokens tokens :arrow-candidate true})) (jp-parse-program st)))))
 
 (define
   js-parse-expr
@@ -1640,4 +1427,4 @@
           (= (len tokens) 0)
           (and (= (len tokens) 1) (= (get (nth tokens 0) :type) "eof")))
         (list)
-        (let ((st {:idx 0 :tokens tokens :arrow-candidate true :loop-depth 0 :switch-depth 0 :fn-depth 0})) (jp-parse-assignment st))))))
+        (let ((st {:idx 0 :tokens tokens :arrow-candidate true})) (jp-parse-assignment st))))))

lib/js/regex.sx

@@ -0,0 +1,943 @@
+;; lib/js/regex.sx — pure-SX recursive backtracking regex engine
+;;
+;; Installed via (js-regex-platform-override! ...) at load time.
+;; Covers: character classes (\d\w\s . [abc] [^abc] [a-z]),
+;;   anchors (^ $ \b \B), quantifiers (* + ? {n,m} lazy variants),
+;;   groups (capturing + non-capturing), alternation (a|b),
+;;   flags: i (case-insensitive), g (global), m (multiline).
+;;
+;; Architecture:
+;;   1. rx-parse-pattern  — pattern string → compiled node list
+;;   2. rx-match-nodes    — recursive backtracker
+;;   3. rx-exec / rx-test — public interface
+;;   4. Install as {:test rx-test :exec rx-exec}
+
+;; ── Utilities ─────────────────────────────────────────────────────
+
+(define
+  rx-char-at
+  (fn (s i) (if (and (>= i 0) (< i (len s))) (char-at s i) "")))
+
+(define
+  rx-digit?
+  (fn
+    (c)
+    (and (not (= c "")) (>= (char-code c) 48) (<= (char-code c) 57))))
+
+(define
+  rx-word?
+  (fn
+    (c)
+    (and
+      (not (= c ""))
+      (or
+        (and (>= (char-code c) 65) (<= (char-code c) 90))
+        (and (>= (char-code c) 97) (<= (char-code c) 122))
+        (and (>= (char-code c) 48) (<= (char-code c) 57))
+        (= c "_")))))
+
+(define
+  rx-space?
+  (fn
+    (c)
+    (or (= c " ") (= c "\t") (= c "\n") (= c "\r") (= c "\\f") (= c ""))))
+
+(define rx-newline? (fn (c) (or (= c "\n") (= c "\r"))))
+
+(define
+  rx-downcase-char
+  (fn
+    (c)
+    (let
+      ((cc (char-code c)))
+      (if (and (>= cc 65) (<= cc 90)) (char-from-code (+ cc 32)) c))))
+
+(define
+  rx-char-eq?
+  (fn
+    (a b ci?)
+    (if ci? (= (rx-downcase-char a) (rx-downcase-char b)) (= a b))))
+
+(define
+  rx-parse-int
+  (fn
+    (pat i acc)
+    (let
+      ((c (rx-char-at pat i)))
+      (if
+        (rx-digit? c)
+        (rx-parse-int pat (+ i 1) (+ (* acc 10) (- (char-code c) 48)))
+        (list acc i)))))
+
+(define
+  rx-hex-digit-val
+  (fn
+    (c)
+    (cond
+      ((and (>= (char-code c) 48) (<= (char-code c) 57))
+        (- (char-code c) 48))
+      ((and (>= (char-code c) 65) (<= (char-code c) 70))
+        (+ 10 (- (char-code c) 65)))
+      ((and (>= (char-code c) 97) (<= (char-code c) 102))
+        (+ 10 (- (char-code c) 97)))
+      (else -1))))
+
+(define
+  rx-parse-hex-n
+  (fn
+    (pat i n acc)
+    (if
+      (= n 0)
+      (list (char-from-code acc) i)
+      (let
+        ((v (rx-hex-digit-val (rx-char-at pat i))))
+        (if
+          (< v 0)
+          (list (char-from-code acc) i)
+          (rx-parse-hex-n pat (+ i 1) (- n 1) (+ (* acc 16) v)))))))
+
+;; ── Pattern compiler ──────────────────────────────────────────────
+
+;; Node types (stored in dicts with "__t__" key):
+;;   literal  : {:__t__ "literal" :__c__ char}
+;;   any      : {:__t__ "any"}
+;;   class-d  : {:__t__ "class-d"  :__neg__ bool}
+;;   class-w  : {:__t__ "class-w"  :__neg__ bool}
+;;   class-s  : {:__t__ "class-s"  :__neg__ bool}
+;;   char-class: {:__t__ "char-class" :__neg__ bool :__items__ list}
+;;   anchor-start / anchor-end / anchor-word / anchor-nonword
+;;   quant    : {:__t__ "quant" :__node__ n :__min__ m :__max__ mx :__lazy__ bool}
+;;   group    : {:__t__ "group" :__idx__ i :__nodes__ list}
+;;   ncgroup  : {:__t__ "ncgroup" :__nodes__ list}
+;;   alt      : {:__t__ "alt" :__branches__ list-of-node-lists}
+
+;; parse one escape after `\`, returns (node new-i)
+(define
+  rx-parse-escape
+  (fn
+    (pat i)
+    (let
+      ((c (rx-char-at pat i)))
+      (cond
+        ((= c "d") (list (dict "__t__" "class-d" "__neg__" false) (+ i 1)))
+        ((= c "D") (list (dict "__t__" "class-d" "__neg__" true) (+ i 1)))
+        ((= c "w") (list (dict "__t__" "class-w" "__neg__" false) (+ i 1)))
+        ((= c "W") (list (dict "__t__" "class-w" "__neg__" true) (+ i 1)))
+        ((= c "s") (list (dict "__t__" "class-s" "__neg__" false) (+ i 1)))
+        ((= c "S") (list (dict "__t__" "class-s" "__neg__" true) (+ i 1)))
+        ((= c "b") (list (dict "__t__" "anchor-word") (+ i 1)))
+        ((= c "B") (list (dict "__t__" "anchor-nonword") (+ i 1)))
+        ((= c "n") (list (dict "__t__" "literal" "__c__" "\n") (+ i 1)))
+        ((= c "r") (list (dict "__t__" "literal" "__c__" "\r") (+ i 1)))
+        ((= c "t") (list (dict "__t__" "literal" "__c__" "\t") (+ i 1)))
+        ((= c "f") (list (dict "__t__" "literal" "__c__" "\\f") (+ i 1)))
+        ((= c "v") (list (dict "__t__" "literal" "__c__" "") (+ i 1)))
+        ((= c "u")
+          (let
+            ((res (rx-parse-hex-n pat (+ i 1) 4 0)))
+            (list (dict "__t__" "literal" "__c__" (nth res 0)) (nth res 1))))
+        ((= c "x")
+          (let
+            ((res (rx-parse-hex-n pat (+ i 1) 2 0)))
+            (list (dict "__t__" "literal" "__c__" (nth res 0)) (nth res 1))))
+        (else (list (dict "__t__" "literal" "__c__" c) (+ i 1)))))))
+
+;; parse a char-class item inside [...], returns (item new-i)
+(define
+  rx-parse-class-item
+  (fn
+    (pat i)
+    (let
+      ((c (rx-char-at pat i)))
+      (cond
+        ((= c "\\")
+          (let
+            ((esc (rx-parse-escape pat (+ i 1))))
+            (let
+              ((node (nth esc 0)) (ni (nth esc 1)))
+              (let
+                ((t (get node "__t__")))
+                (cond
+                  ((= t "class-d")
+                    (list
+                      (dict "kind" "class-d" "neg" (get node "__neg__"))
+                      ni))
+                  ((= t "class-w")
+                    (list
+                      (dict "kind" "class-w" "neg" (get node "__neg__"))
+                      ni))
+                  ((= t "class-s")
+                    (list
+                      (dict "kind" "class-s" "neg" (get node "__neg__"))
+                      ni))
+                  (else
+                    (let
+                      ((lc (get node "__c__")))
+                      (if
+                        (and
+                          (= (rx-char-at pat ni) "-")
+                          (not (= (rx-char-at pat (+ ni 1)) "]")))
+                        (let
+                          ((hi-c (rx-char-at pat (+ ni 1))))
+                          (list
+                            (dict "kind" "range" "lo" lc "hi" hi-c)
+                            (+ ni 2)))
+                        (list (dict "kind" "lit" "c" lc) ni)))))))))
+        (else
+          (if
+            (and
+              (not (= c ""))
+              (= (rx-char-at pat (+ i 1)) "-")
+              (not (= (rx-char-at pat (+ i 2)) "]"))
+              (not (= (rx-char-at pat (+ i 2)) "")))
+            (let
+              ((hi-c (rx-char-at pat (+ i 2))))
+              (list (dict "kind" "range" "lo" c "hi" hi-c) (+ i 3)))
+            (list (dict "kind" "lit" "c" c) (+ i 1))))))))
+
+(define
+  rx-parse-class-items
+  (fn
+    (pat i items)
+    (let
+      ((c (rx-char-at pat i)))
+      (if
+        (or (= c "]") (= c ""))
+        (list items i)
+        (let
+          ((res (rx-parse-class-item pat i)))
+          (begin
+            (append! items (nth res 0))
+            (rx-parse-class-items pat (nth res 1) items)))))))
+
+;; parse a sequence until stop-ch or EOF; returns (nodes new-i groups-count)
+(define
+  rx-parse-seq
+  (fn
+    (pat i stop-ch ds)
+    (let
+      ((c (rx-char-at pat i)))
+      (cond
+        ((= c "") (list (get ds "nodes") i (get ds "groups")))
+        ((= c stop-ch) (list (get ds "nodes") i (get ds "groups")))
+        ((= c "|") (rx-parse-alt-rest pat i ds))
+        (else
+          (let
+            ((res (rx-parse-atom pat i ds)))
+            (let
+              ((node (nth res 0)) (ni (nth res 1)) (ds2 (nth res 2)))
+              (let
+                ((qres (rx-parse-quant pat ni node)))
+                (begin
+                  (append! (get ds2 "nodes") (nth qres 0))
+                  (rx-parse-seq pat (nth qres 1) stop-ch ds2))))))))))
+
+;; when we hit | inside a sequence, collect all alternatives
+(define
+  rx-parse-alt-rest
+  (fn
+    (pat i ds)
+    (let
+      ((left-branch (get ds "nodes")) (branches (list)))
+      (begin
+        (append! branches left-branch)
+        (rx-parse-alt-branches pat i (get ds "groups") branches)))))
+
+(define
+  rx-parse-alt-branches
+  (fn
+    (pat i n-groups branches)
+    (let
+      ((new-nodes (list)) (ds2 (dict "groups" n-groups "nodes" new-nodes)))
+      (let
+        ((res (rx-parse-seq pat (+ i 1) "|" ds2)))
+        (begin
+          (append! branches (nth res 0))
+          (let
+            ((ni2 (nth res 1)) (g2 (nth res 2)))
+            (if
+              (= (rx-char-at pat ni2) "|")
+              (rx-parse-alt-branches pat ni2 g2 branches)
+              (list
+                (list (dict "__t__" "alt" "__branches__" branches))
+                ni2
+                g2))))))))
+
+;; parse quantifier suffix, returns (node new-i)
+(define
+  rx-parse-quant
+  (fn
+    (pat i node)
+    (let
+      ((c (rx-char-at pat i)))
+      (cond
+        ((= c "*")
+          (let
+            ((lazy? (= (rx-char-at pat (+ i 1)) "?")))
+            (list
+              (dict
+                "__t__"
+                "quant"
+                "__node__"
+                node
+                "__min__"
+                0
+                "__max__"
+                -1
+                "__lazy__"
+                lazy?)
+              (if lazy? (+ i 2) (+ i 1)))))
+        ((= c "+")
+          (let
+            ((lazy? (= (rx-char-at pat (+ i 1)) "?")))
+            (list
+              (dict
+                "__t__"
+                "quant"
+                "__node__"
+                node
+                "__min__"
+                1
+                "__max__"
+                -1
+                "__lazy__"
+                lazy?)
+              (if lazy? (+ i 2) (+ i 1)))))
+        ((= c "?")
+          (let
+            ((lazy? (= (rx-char-at pat (+ i 1)) "?")))
+            (list
+              (dict
+                "__t__"
+                "quant"
+                "__node__"
+                node
+                "__min__"
+                0
+                "__max__"
+                1
+                "__lazy__"
+                lazy?)
+              (if lazy? (+ i 2) (+ i 1)))))
+        ((= c "{")
+          (let
+            ((mres (rx-parse-int pat (+ i 1) 0)))
+            (let
+              ((mn (nth mres 0)) (mi (nth mres 1)))
+              (let
+                ((sep (rx-char-at pat mi)))
+                (cond
+                  ((= sep "}")
+                    (let
+                      ((lazy? (= (rx-char-at pat (+ mi 1)) "?")))
+                      (list
+                        (dict
+                          "__t__"
+                          "quant"
+                          "__node__"
+                          node
+                          "__min__"
+                          mn
+                          "__max__"
+                          mn
+                          "__lazy__"
+                          lazy?)
+                        (if lazy? (+ mi 2) (+ mi 1)))))
+                  ((= sep ",")
+                    (let
+                      ((c2 (rx-char-at pat (+ mi 1))))
+                      (if
+                        (= c2 "}")
+                        (let
+                          ((lazy? (= (rx-char-at pat (+ mi 2)) "?")))
+                          (list
+                            (dict
+                              "__t__"
+                              "quant"
+                              "__node__"
+                              node
+                              "__min__"
+                              mn
+                              "__max__"
+                              -1
+                              "__lazy__"
+                              lazy?)
+                            (if lazy? (+ mi 3) (+ mi 2))))
+                        (let
+                          ((mxres (rx-parse-int pat (+ mi 1) 0)))
+                          (let
+                            ((mx (nth mxres 0)) (mxi (nth mxres 1)))
+                            (let
+                              ((lazy? (= (rx-char-at pat (+ mxi 1)) "?")))
+                              (list
+                                (dict
+                                  "__t__"
+                                  "quant"
+                                  "__node__"
+                                  node
+                                  "__min__"
+                                  mn
+                                  "__max__"
+                                  mx
+                                  "__lazy__"
+                                  lazy?)
+                                (if lazy? (+ mxi 2) (+ mxi 1)))))))))
+                  (else (list node i)))))))
+        (else (list node i))))))
+
+;; parse one atom, returns (node new-i new-ds)
+(define
+  rx-parse-atom
+  (fn
+    (pat i ds)
+    (let
+      ((c (rx-char-at pat i)))
+      (cond
+        ((= c ".") (list (dict "__t__" "any") (+ i 1) ds))
+        ((= c "^") (list (dict "__t__" "anchor-start") (+ i 1) ds))
+        ((= c "$") (list (dict "__t__" "anchor-end") (+ i 1) ds))
+        ((= c "\\")
+          (let
+            ((esc (rx-parse-escape pat (+ i 1))))
+            (list (nth esc 0) (nth esc 1) ds)))
+        ((= c "[")
+          (let
+            ((neg? (= (rx-char-at pat (+ i 1)) "^")))
+            (let
+              ((start (if neg? (+ i 2) (+ i 1))) (items (list)))
+              (let
+                ((res (rx-parse-class-items pat start items)))
+                (let
+                  ((ci (nth res 1)))
+                  (list
+                    (dict
+                      "__t__"
+                      "char-class"
+                      "__neg__"
+                      neg?
+                      "__items__"
+                      items)
+                    (+ ci 1)
+                    ds))))))
+        ((= c "(")
+          (let
+            ((c2 (rx-char-at pat (+ i 1))))
+            (if
+              (and (= c2 "?") (= (rx-char-at pat (+ i 2)) ":"))
+              (let
+                ((inner-nodes (list))
+                  (inner-ds
+                    (dict "groups" (get ds "groups") "nodes" inner-nodes)))
+                (let
+                  ((res (rx-parse-seq pat (+ i 3) ")" inner-ds)))
+                  (list
+                    (dict "__t__" "ncgroup" "__nodes__" (nth res 0))
+                    (+ (nth res 1) 1)
+                    (dict "groups" (nth res 2) "nodes" (get ds "nodes")))))
+              (let
+                ((gidx (+ (get ds "groups") 1)) (inner-nodes (list)))
+                (let
+                  ((inner-ds (dict "groups" gidx "nodes" inner-nodes)))
+                  (let
+                    ((res (rx-parse-seq pat (+ i 1) ")" inner-ds)))
+                    (list
+                      (dict
+                        "__t__"
+                        "group"
+                        "__idx__"
+                        gidx
+                        "__nodes__"
+                        (nth res 0))
+                      (+ (nth res 1) 1)
+                      (dict "groups" (nth res 2) "nodes" (get ds "nodes")))))))))
+        (else (list (dict "__t__" "literal" "__c__" c) (+ i 1) ds))))))
+
+;; top-level compile
+(define
+  rx-compile
+  (fn
+    (pattern)
+    (let
+      ((nodes (list)) (ds (dict "groups" 0 "nodes" nodes)))
+      (let
+        ((res (rx-parse-seq pattern 0 "" ds)))
+        (dict "nodes" (nth res 0) "ngroups" (nth res 2))))))
+
+;; ── Matcher ───────────────────────────────────────────────────────
+
+;; Match a char-class item against character c
+(define
+  rx-item-matches?
+  (fn
+    (item c ci?)
+    (let
+      ((kind (get item "kind")))
+      (cond
+        ((= kind "lit") (rx-char-eq? c (get item "c") ci?))
+        ((= kind "range")
+          (let
+            ((lo (if ci? (rx-downcase-char (get item "lo")) (get item "lo")))
+              (hi
+                (if ci? (rx-downcase-char (get item "hi")) (get item "hi")))
+              (dc (if ci? (rx-downcase-char c) c)))
+            (and
+              (>= (char-code dc) (char-code lo))
+              (<= (char-code dc) (char-code hi)))))
+        ((= kind "class-d")
+          (let ((m (rx-digit? c))) (if (get item "neg") (not m) m)))
+        ((= kind "class-w")
+          (let ((m (rx-word? c))) (if (get item "neg") (not m) m)))
+        ((= kind "class-s")
+          (let ((m (rx-space? c))) (if (get item "neg") (not m) m)))
+        (else false)))))
+
+(define
+  rx-class-items-any?
+  (fn
+    (items c ci?)
+    (if
+      (empty? items)
+      false
+      (if
+        (rx-item-matches? (first items) c ci?)
+        true
+        (rx-class-items-any? (rest items) c ci?)))))
+
+(define
+  rx-class-matches?
+  (fn
+    (node c ci?)
+    (let
+      ((neg? (get node "__neg__")) (items (get node "__items__")))
+      (let
+        ((hit (rx-class-items-any? items c ci?)))
+        (if neg? (not hit) hit)))))
+
+;; Word boundary check
+(define
+  rx-is-word-boundary?
+  (fn
+    (s i slen)
+    (let
+      ((before (if (> i 0) (rx-word? (char-at s (- i 1))) false))
+        (after (if (< i slen) (rx-word? (char-at s i)) false)))
+      (not (= before after)))))
+
+;; ── Core matcher ──────────────────────────────────────────────────
+;;
+;; rx-match-nodes : nodes s i slen ci? mi? groups → end-pos or -1
+;;
+;; Matches `nodes` starting at position `i` in string `s`.
+;; Returns the position after the last character consumed, or -1 on failure.
+;; Mutates `groups` dict to record captures.
+
+(define
+  rx-match-nodes
+  (fn
+    (nodes s i slen ci? mi? groups)
+    (if
+      (empty? nodes)
+      i
+      (let
+        ((node (first nodes)) (rest-nodes (rest nodes)))
+        (let
+          ((t (get node "__t__")))
+          (cond
+            ((= t "literal")
+              (if
+                (and
+                  (< i slen)
+                  (rx-char-eq? (char-at s i) (get node "__c__") ci?))
+                (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                -1))
+            ((= t "any")
+              (if
+                (and (< i slen) (not (rx-newline? (char-at s i))))
+                (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                -1))
+            ((= t "class-d")
+              (let
+                ((m (and (< i slen) (rx-digit? (char-at s i)))))
+                (if
+                  (if (get node "__neg__") (not m) m)
+                  (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                  -1)))
+            ((= t "class-w")
+              (let
+                ((m (and (< i slen) (rx-word? (char-at s i)))))
+                (if
+                  (if (get node "__neg__") (not m) m)
+                  (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                  -1)))
+            ((= t "class-s")
+              (let
+                ((m (and (< i slen) (rx-space? (char-at s i)))))
+                (if
+                  (if (get node "__neg__") (not m) m)
+                  (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                  -1)))
+            ((= t "char-class")
+              (if
+                (and (< i slen) (rx-class-matches? node (char-at s i) ci?))
+                (rx-match-nodes rest-nodes s (+ i 1) slen ci? mi? groups)
+                -1))
+            ((= t "anchor-start")
+              (if
+                (or
+                  (= i 0)
+                  (and mi? (rx-newline? (rx-char-at s (- i 1)))))
+                (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+                -1))
+            ((= t "anchor-end")
+              (if
+                (or (= i slen) (and mi? (rx-newline? (rx-char-at s i))))
+                (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+                -1))
+            ((= t "anchor-word")
+              (if
+                (rx-is-word-boundary? s i slen)
+                (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+                -1))
+            ((= t "anchor-nonword")
+              (if
+                (not (rx-is-word-boundary? s i slen))
+                (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+                -1))
+            ((= t "group")
+              (let
+                ((gidx (get node "__idx__"))
+                  (inner (get node "__nodes__")))
+                (let
+                  ((g-end (rx-match-nodes inner s i slen ci? mi? groups)))
+                  (if
+                    (>= g-end 0)
+                    (begin
+                      (dict-set!
+                        groups
+                        (js-to-string gidx)
+                        (substring s i g-end))
+                      (let
+                        ((final-end (rx-match-nodes rest-nodes s g-end slen ci? mi? groups)))
+                        (if
+                          (>= final-end 0)
+                          final-end
+                          (begin
+                            (dict-set! groups (js-to-string gidx) nil)
+                            -1))))
+                    -1))))
+            ((= t "ncgroup")
+              (let
+                ((inner (get node "__nodes__")))
+                (rx-match-nodes
+                  (append inner rest-nodes)
+                  s
+                  i
+                  slen
+                  ci?
+                  mi?
+                  groups)))
+            ((= t "alt")
+              (let
+                ((branches (get node "__branches__")))
+                (rx-try-branches branches rest-nodes s i slen ci? mi? groups)))
+            ((= t "quant")
+              (let
+                ((inner-node (get node "__node__"))
+                  (mn (get node "__min__"))
+                  (mx (get node "__max__"))
+                  (lazy? (get node "__lazy__")))
+                (if
+                  lazy?
+                  (rx-quant-lazy
+                    inner-node
+                    mn
+                    mx
+                    rest-nodes
+                    s
+                    i
+                    slen
+                    ci?
+                    mi?
+                    groups
+                    0)
+                  (rx-quant-greedy
+                    inner-node
+                    mn
+                    mx
+                    rest-nodes
+                    s
+                    i
+                    slen
+                    ci?
+                    mi?
+                    groups
+                    0))))
+            (else -1)))))))
+
+(define
+  rx-try-branches
+  (fn
+    (branches rest-nodes s i slen ci? mi? groups)
+    (if
+      (empty? branches)
+      -1
+      (let
+        ((res (rx-match-nodes (append (first branches) rest-nodes) s i slen ci? mi? groups)))
+        (if
+          (>= res 0)
+          res
+          (rx-try-branches (rest branches) rest-nodes s i slen ci? mi? groups))))))
+
+;; Greedy: expand as far as possible, then try rest from the longest match
+;; Strategy: recurse forward (extend first); only try rest when extension fails
+(define
+  rx-quant-greedy
+  (fn
+    (inner-node mn mx rest-nodes s i slen ci? mi? groups count)
+    (let
+      ((can-extend (and (< i slen) (or (= mx -1) (< count mx)))))
+      (if
+        can-extend
+        (let
+          ((ni (rx-match-one inner-node s i slen ci? mi? groups)))
+          (if
+            (>= ni 0)
+            (let
+              ((res (rx-quant-greedy inner-node mn mx rest-nodes s ni slen ci? mi? groups (+ count 1))))
+              (if
+                (>= res 0)
+                res
+                (if
+                  (>= count mn)
+                  (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+                  -1)))
+            (if
+              (>= count mn)
+              (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+              -1)))
+        (if
+          (>= count mn)
+          (rx-match-nodes rest-nodes s i slen ci? mi? groups)
+          -1)))))
+
+;; Lazy: try rest first, extend only if rest fails
+(define
+  rx-quant-lazy
+  (fn
+    (inner-node mn mx rest-nodes s i slen ci? mi? groups count)
+    (if
+      (>= count mn)
+      (let
+        ((res (rx-match-nodes rest-nodes s i slen ci? mi? groups)))
+        (if
+          (>= res 0)
+          res
+          (if
+            (and (< i slen) (or (= mx -1) (< count mx)))
+            (let
+              ((ni (rx-match-one inner-node s i slen ci? mi? groups)))
+              (if
+                (>= ni 0)
+                (rx-quant-lazy
+                  inner-node
+                  mn
+                  mx
+                  rest-nodes
+                  s
+                  ni
+                  slen
+                  ci?
+                  mi?
+                  groups
+                  (+ count 1))
+                -1))
+            -1)))
+      (if
+        (< i slen)
+        (let
+          ((ni (rx-match-one inner-node s i slen ci? mi? groups)))
+          (if
+            (>= ni 0)
+            (rx-quant-lazy
+              inner-node
+              mn
+              mx
+              rest-nodes
+              s
+              ni
+              slen
+              ci?
+              mi?
+              groups
+              (+ count 1))
+            -1))
+        -1))))
+
+;; Match a single node at position i, return new pos or -1
+(define
+  rx-match-one
+  (fn
+    (node s i slen ci? mi? groups)
+    (rx-match-nodes (list node) s i slen ci? mi? groups)))
+
+;; ── Engine entry points ───────────────────────────────────────────
+
+;; Try matching at exactly position i. Returns result dict or nil.
+(define
+  rx-try-at
+  (fn
+    (compiled s i slen ci? mi?)
+    (let
+      ((nodes (get compiled "nodes")) (ngroups (get compiled "ngroups")))
+      (let
+        ((groups (dict)))
+        (let
+          ((end (rx-match-nodes nodes s i slen ci? mi? groups)))
+          (if
+            (>= end 0)
+            (dict "start" i "end" end "groups" groups "ngroups" ngroups)
+            nil))))))
+
+;; Find first match scanning from search-start.
+(define
+  rx-find-from
+  (fn
+    (compiled s search-start slen ci? mi?)
+    (if
+      (> search-start slen)
+      nil
+      (let
+        ((res (rx-try-at compiled s search-start slen ci? mi?)))
+        (if
+          res
+          res
+          (rx-find-from compiled s (+ search-start 1) slen ci? mi?))))))
+
+;; Build exec result dict from raw match result
+(define
+  rx-build-exec-result
+  (fn
+    (s match-res)
+    (let
+      ((start (get match-res "start"))
+        (end (get match-res "end"))
+        (groups (get match-res "groups"))
+        (ngroups (get match-res "ngroups")))
+      (let
+        ((matched (substring s start end))
+          (caps (rx-build-captures groups ngroups 1)))
+        (dict "match" matched "index" start "input" s "groups" caps)))))
+
+(define
+  rx-build-captures
+  (fn
+    (groups ngroups idx)
+    (if
+      (> idx ngroups)
+      (list)
+      (let
+        ((cap (get groups (js-to-string idx))))
+        (cons
+          (if (= cap nil) :js-undefined cap)
+          (rx-build-captures groups ngroups (+ idx 1)))))))
+
+;; ── Public interface ──────────────────────────────────────────────
+
+;; Lazy compile: build NFA on first use, cache under "__compiled__"
+(define
+  rx-ensure-compiled!
+  (fn
+    (rx)
+    (if
+      (dict-has? rx "__compiled__")
+      (get rx "__compiled__")
+      (let
+        ((c (rx-compile (get rx "source"))))
+        (begin (dict-set! rx "__compiled__" c) c)))))
+
+(define
+  rx-test
+  (fn
+    (rx s)
+    (let
+      ((compiled (rx-ensure-compiled! rx))
+        (ci? (get rx "ignoreCase"))
+        (mi? (get rx "multiline"))
+        (slen (len s)))
+      (let
+        ((start (if (get rx "global") (let ((li (get rx "lastIndex"))) (if (number? li) li 0)) 0)))
+        (let
+          ((res (rx-find-from compiled s start slen ci? mi?)))
+          (if
+            (get rx "global")
+            (begin
+              (dict-set! rx "lastIndex" (if res (get res "end") 0))
+              (if res true false))
+            (if res true false)))))))
+
+(define
+  rx-exec
+  (fn
+    (rx s)
+    (let
+      ((compiled (rx-ensure-compiled! rx))
+        (ci? (get rx "ignoreCase"))
+        (mi? (get rx "multiline"))
+        (slen (len s)))
+      (let
+        ((start (if (get rx "global") (let ((li (get rx "lastIndex"))) (if (number? li) li 0)) 0)))
+        (let
+          ((res (rx-find-from compiled s start slen ci? mi?)))
+          (if
+            res
+            (begin
+              (when
+                (get rx "global")
+                (dict-set! rx "lastIndex" (get res "end")))
+              (rx-build-exec-result s res))
+            (begin
+              (when (get rx "global") (dict-set! rx "lastIndex" 0))
+              nil)))))))
+
+;; match-all for String.prototype.matchAll
+(define
+  js-regex-match-all
+  (fn
+    (rx s)
+    (let
+      ((compiled (rx-ensure-compiled! rx))
+        (ci? (get rx "ignoreCase"))
+        (mi? (get rx "multiline"))
+        (slen (len s))
+        (results (list)))
+      (rx-match-all-loop compiled s 0 slen ci? mi? results))))
+
+(define
+  rx-match-all-loop
+  (fn
+    (compiled s i slen ci? mi? results)
+    (if
+      (> i slen)
+      results
+      (let
+        ((res (rx-find-from compiled s i slen ci? mi?)))
+        (if
+          res
+          (begin
+            (append! results (rx-build-exec-result s res))
+            (let
+              ((next (get res "end")))
+              (rx-match-all-loop
+                compiled
+                s
+                (if (= next i) (+ i 1) next)
+                slen
+                ci?
+                mi?
+                results)))
+          results)))))
+
+;; ── Install platform ──────────────────────────────────────────────
+
+(js-regex-platform-override! "test" rx-test)
+(js-regex-platform-override! "exec" rx-exec)

lib/js/test.sh

@@ -33,6 +33,8 @@ cat > "$TMPFILE" << 'EPOCHS'
 (load "lib/js/transpile.sx")
 (epoch 5)
 (load "lib/js/runtime.sx")
+(epoch 6)
+(load "lib/js/regex.sx")
 
 ;; ── Phase 0: stubs still behave ─────────────────────────────────
 (epoch 10)
@@ -1323,24 +1325,107 @@ cat > "$TMPFILE" << 'EPOCHS'
 (epoch 3505)
 (eval "(js-eval \"var a = {length: 3, 0: 10, 1: 20, 2: 30}; var sum = 0; Array.prototype.forEach.call(a, function(x){sum += x;}); sum\")")
 
-;; ── Phase 1.ASI: automatic semicolon insertion ─────────────────
-(epoch 4200)
-(eval "(js-eval \"function f() { return\n42\n} f()\")")
-(epoch 4201)
-(eval "(js-eval \"function g() { return 42 } g()\")")
-(epoch 4202)
-(eval "(let ((toks (js-tokenize \"a\nb\"))) (get (nth toks 1) :nl))")
-(epoch 4203)
-(eval "(let ((toks (js-tokenize \"a b\"))) (get (nth toks 1) :nl))")
+;; ── Phase 12: Regex engine ────────────────────────────────────────
+;; Platform is installed (test key is a function, not undefined)
+(epoch 5000)
+(eval "(js-undefined? (get __js_regex_platform__ \"test\"))")
+(epoch 5001)
+(eval "(js-eval \"/foo/.test('hi foo bar')\")")
+(epoch 5002)
+(eval "(js-eval \"/foo/.test('hi bar')\")")
+;; Case-insensitive flag
+(epoch 5003)
+(eval "(js-eval \"/FOO/i.test('hello foo world')\")")
+;; Anchors
+(epoch 5004)
+(eval "(js-eval \"/^hello/.test('hello world')\")")
+(epoch 5005)
+(eval "(js-eval \"/^hello/.test('say hello')\")")
+(epoch 5006)
+(eval "(js-eval \"/world$/.test('hello world')\")")
+;; Character classes
+(epoch 5007)
+(eval "(js-eval \"/\\\\d+/.test('abc 123')\")")
+(epoch 5008)
+(eval "(js-eval \"/\\\\w+/.test('hello')\")")
+(epoch 5009)
+(eval "(js-eval \"/[abc]/.test('dog')\")")
+(epoch 5010)
+(eval "(js-eval \"/[abc]/.test('cat')\")")
+;; Quantifiers
+(epoch 5011)
+(eval "(js-eval \"/a*b/.test('b')\")")
+(epoch 5012)
+(eval "(js-eval \"/a+b/.test('b')\")")
+(epoch 5013)
+(eval "(js-eval \"/a{2,3}/.test('aa')\")")
+(epoch 5014)
+(eval "(js-eval \"/a{2,3}/.test('a')\")")
+;; Dot
+(epoch 5015)
+(eval "(js-eval \"/h.llo/.test('hello')\")")
+(epoch 5016)
+(eval "(js-eval \"/h.llo/.test('hllo')\")")
+;; exec result
+(epoch 5017)
+(eval "(js-eval \"var m = /foo(\\\\w+)/.exec('foobar'); m.match\")")
+(epoch 5018)
+(eval "(js-eval \"var m = /foo(\\\\w+)/.exec('foobar'); m.index\")")
+(epoch 5019)
+(eval "(js-eval \"var m = /foo(\\\\w+)/.exec('foobar'); m.groups[0]\")")
+;; Alternation
+(epoch 5020)
+(eval "(js-eval \"/cat|dog/.test('I have a dog')\")")
+(epoch 5021)
+(eval "(js-eval \"/cat|dog/.test('I have a fish')\")")
+;; Non-capturing group
+(epoch 5022)
+(eval "(js-eval \"/(?:foo)+/.test('foofoo')\")")
+;; Negated char class
+(epoch 5023)
+(eval "(js-eval \"/[^abc]/.test('d')\")")
+(epoch 5024)
+(eval "(js-eval \"/[^abc]/.test('a')\")")
+;; Range inside char class
+(epoch 5025)
+(eval "(js-eval \"/[a-z]+/.test('hello')\")")
+;; Word boundary
+(epoch 5026)
+(eval "(js-eval \"/\\\\bword\\\\b/.test('a word here')\")")
+(epoch 5027)
+(eval "(js-eval \"/\\\\bword\\\\b/.test('password')\")")
+;; Lazy quantifier
+(epoch 5028)
+(eval "(js-eval \"var m = /a+?/.exec('aaa'); m.match\")")
+;; Global flag exec
+(epoch 5029)
+(eval "(js-eval \"var r=/\\\\d+/g; r.exec('a1b2'); r.exec('a1b2').match\")")
+;; String.prototype.match with regex
+(epoch 5030)
+(eval "(js-eval \"'hello world'.match(/\\\\w+/).match\")")
+;; String.prototype.search
+(epoch 5031)
+(eval "(js-eval \"'hello world'.search(/world/)\")")
+;; String.prototype.replace with regex
+(epoch 5032)
+(eval "(js-eval \"'hello world'.replace(/world/, 'there')\")")
+;; multiline anchor
+(epoch 5033)
+(eval "(js-eval \"/^bar/m.test('foo\\nbar')\")")
 
-(epoch 4300)
-(eval "(js-eval \"var x = 5; x\")")
-(epoch 4301)
-(eval "(js-eval \"function f() { return x; var x = 42; } f()\")")
-(epoch 4302)
-(eval "(js-eval \"function f() { var y = 7; return y; } f()\")")
-(epoch 4303)
-(eval "(js-eval \"function f() { var z; z = 3; return z; } f()\")")
+;; ── Phase 13: let/const TDZ infrastructure ───────────────────────
+;; The TDZ sentinel and checker are defined in runtime.sx.
+;; let/const bindings work normally after initialization.
+(epoch 5100)
+(eval "(js-eval \"let x = 5; x\")")
+(epoch 5101)
+(eval "(js-eval \"const y = 42; y\")")
+;; TDZ sentinel exists and is detectable
+(epoch 5102)
+(eval "(js-tdz? __js_tdz_sentinel__)")
+;; js-tdz-check passes through non-sentinel values
+(epoch 5103)
+(eval "(js-tdz-check \"x\" 42)")
 
 EPOCHS
 
@@ -2061,16 +2146,47 @@ check 3503 "indexOf.call arrLike"          '1'
 check 3504 "filter.call arrLike"           '"2,3"'
 check 3505 "forEach.call arrLike sum"      '60'
 
-# ── Phase 1.ASI: automatic semicolon insertion ────────────────────
-check 4200 "return+newline → undefined"    '"js-undefined"'
-check 4201 "return+space+val → val"        '42'
-check 4202 "nl-before flag set after newline" 'true'
-check 4203 "nl-before flag false on same line" 'false'
+# ── Phase 12: Regex engine ────────────────────────────────────────
+check 5000 "regex platform installed"           'false'
+check 5001 "/foo/ matches"                      'true'
+check 5002 "/foo/ no match"                     'false'
+check 5003 "/FOO/i case-insensitive"            'true'
+check 5004 "/^hello/ anchor match"              'true'
+check 5005 "/^hello/ anchor no-match"           'false'
+check 5006 "/world$/ end anchor"                'true'
+check 5007 "/\\d+/ digit class"                 'true'
+check 5008 "/\\w+/ word class"                  'true'
+check 5009 "/[abc]/ class no-match"             'false'
+check 5010 "/[abc]/ class match"                'true'
+check 5011 "/a*b/ zero-or-more"                 'true'
+check 5012 "/a+b/ one-or-more no-match"         'false'
+check 5013 "/a{2,3}/ quant match"               'true'
+check 5014 "/a{2,3}/ quant no-match"            'false'
+check 5015 "dot matches any"                    'true'
+check 5016 "dot requires char"                  'false'
+check 5017 "exec match string"                  '"foobar"'
+check 5018 "exec match index"                   '0'
+check 5019 "exec capture group"                 '"bar"'
+check 5020 "alternation cat|dog match"          'true'
+check 5021 "alternation cat|dog no-match"       'false'
+check 5022 "non-capturing group"                'true'
+check 5023 "negated class match"                'true'
+check 5024 "negated class no-match"             'false'
+check 5025 "range [a-z]+"                       'true'
+check 5026 "word boundary match"                'true'
+check 5027 "word boundary no-match"             'false'
+check 5028 "lazy quantifier"                    '"a"'
+check 5029 "global exec advances"               '"2"'
+check 5030 "String.match regex"                 '"hello"'
+check 5031 "String.search regex"                '6'
+check 5032 "String.replace regex"               '"hello there"'
+check 5033 "multiline anchor"                   'true'
 
-check 4300 "var decl program-level"         '5'
-check 4301 "var hoisted before use → undef" '"js-undefined"'
-check 4302 "var in function body"           '7'
-check 4303 "var then set in function"       '3'
+# ── Phase 13: let/const TDZ infrastructure ───────────────────────
+check 5100 "let binding initialized"            '5'
+check 5101 "const binding initialized"          '42'
+check 5102 "TDZ sentinel is detectable"         'true'
+check 5103 "tdz-check passes non-sentinel"      '42'
 
 TOTAL=$((PASS + FAIL))
 if [ $FAIL -eq 0 ]; then

lib/js/test262-runner.py

@@ -52,7 +52,7 @@ UPSTREAM = REPO / "lib" / "js" / "test262-upstream"
 TEST_ROOT = UPSTREAM / "test"
 HARNESS_DIR = UPSTREAM / "harness"
 
-DEFAULT_PER_TEST_TIMEOUT_S = 15.0
+DEFAULT_PER_TEST_TIMEOUT_S = 5.0
 DEFAULT_BATCH_TIMEOUT_S = 120
 
 # Cache dir for precomputed SX source of harness JS (one file per Python run).
@@ -134,9 +134,6 @@ var verifyProperty = function (obj, name, desc, opts) {
   }
 };
 var verifyPrimordialProperty = verifyProperty;
-var verifyEqualTo = function (obj, name, value) {
-  assert.sameValue(obj[name], value, name + " equals");
-};
 var verifyNotEnumerable = function (o, n, v, w, x) { };
 var verifyNotWritable = function (o, n, v, w, x) { };
 var verifyNotConfigurable = function (o, n, v, w, x) { };
@@ -149,50 +146,6 @@ var isConstructor = function (f) {
   // Best-effort: built-in functions and arrows aren't; declared `function` decls are.
   return false;
 };
-// $DONE / asyncTest — async-flag tests call $DONE(err) to signal completion.
-// Since we drain microtasks synchronously, $DONE is just a final-assertion sink.
-var $DONE = function (err) {
-  if (err) { throw new Test262Error((err && err.message) || err); }
-};
-var asyncTest = function (testFunc) {
-  Promise.resolve(testFunc()).then(function () { $DONE(); }, function (e) { $DONE(e); });
-};
-// promiseHelper.js include — used by Promise.all/race tests for ordering checks.
-var checkSequence = function (arr, message) {
-  for (var i = 0; i < arr.length; i = i + 1) {
-    if (arr[i] !== (i + 1)) {
-      throw new Test262Error((message || "Sequence") + " expected " + (i+1) + " at index " + i + " but got " + arr[i]);
-    }
-  }
-  return true;
-};
-var checkSettledPromises = function (settleds, expected, message) {
-  var msg = message ? message + " " : "";
-  if (settleds.length !== expected.length) {
-    throw new Test262Error(msg + "lengths differ: " + settleds.length + " vs " + expected.length);
-  }
-  for (var i = 0; i < settleds.length; i = i + 1) {
-    if (settleds[i].status !== expected[i].status) {
-      throw new Test262Error(msg + "status[" + i + "]: " + settleds[i].status + " vs " + expected[i].status);
-    }
-    if (expected[i].status === "fulfilled" && settleds[i].value !== expected[i].value) {
-      throw new Test262Error(msg + "value[" + i + "]: " + settleds[i].value + " vs " + expected[i].value);
-    }
-    if (expected[i].status === "rejected" && settleds[i].reason !== expected[i].reason) {
-      throw new Test262Error(msg + "reason[" + i + "]: " + settleds[i].reason + " vs " + expected[i].reason);
-    }
-  }
-};
-// decimalToHexString.js include — used by URI/escape tests.
-var decimalToHexString = function (n) {
-  var hex = "0123456789ABCDEF";
-  if (n < 0) { n = n + 65536; }
-  return hex[(n >> 12) & 15] + hex[(n >> 8) & 15] + hex[(n >> 4) & 15] + hex[n & 15];
-};
-var decimalToPercentHexString = function (n) {
-  var hex = "0123456789ABCDEF";
-  return "%" + hex[(n >> 4) & 15] + hex[n & 15];
-};
 // Trivial helper for tests that use Array.isArray-like functionality
 // (many tests reach for it via compareArray)
 """
@@ -405,8 +358,6 @@ def classify_negative_result(fm: Frontmatter, kind: str, payload: str):
             or ("expected" in low and "got" in low)
             or "js-transpile-unop" in low
             or "js-transpile-binop" in low
-            or "js-transpile-assign" in low
-            or "js-transpile" in low
             or "js-compound-update" in low
             or "parse" in low
         ):
@@ -847,6 +798,7 @@ class ServerSession:
         self._run_and_collect(3, '(load "lib/js/parser.sx")', timeout=60.0)
         self._run_and_collect(4, '(load "lib/js/transpile.sx")', timeout=60.0)
         self._run_and_collect(5, '(load "lib/js/runtime.sx")', timeout=60.0)
+        self._run_and_collect(50, '(load "lib/js/regex.sx")', timeout=60.0)
         # Preload the stub harness — use precomputed SX cache when available
         # (huge win: ~15s js-eval HARNESS_STUB → ~0s load precomputed .sx).
         cache_rel = _harness_cache_rel_path()
@@ -1060,45 +1012,11 @@ def _worker_run(args):
 # ---------------------------------------------------------------------------
 
 
-_HARNESS_INCLUDE_CACHE: dict = {}
-
-# Only inline these small harness files per-test. Large ones like propertyHelper.js
-# multiply js-eval/JIT cost by ~5-10x and push tests over the per-test timeout.
-_INLINE_INCLUDES = {"nans.js", "sta.js", "byteConversionValues.js", "compareArray.js"}
-
-
-def _load_harness_include(name: str) -> str:
-    """Read an upstream harness include file (e.g. nans.js).
-    Returns empty string if the file isn't present.
-    """
-    if name in _HARNESS_INCLUDE_CACHE:
-        return _HARNESS_INCLUDE_CACHE[name]
-    path = HARNESS_DIR / name
-    try:
-        src = path.read_text()
-    except OSError:
-        src = ""
-    _HARNESS_INCLUDE_CACHE[name] = src
-    return src
-
-
 def assemble_source(t):
     """Return JS source to feed to js-eval. Harness is preloaded, so we only
-    append the test source (plus a small allowlist of per-test includes).
+    append the test source (plus negative-test prep if needed).
     """
-    if not getattr(t.fm, "includes", None):
     return t.src
-    parts = []
-    for inc in t.fm.includes:
-        if inc not in _INLINE_INCLUDES:
-            continue
-        chunk = _load_harness_include(inc)
-        if chunk:
-            parts.append(chunk)
-    if not parts:
-        return t.src
-    parts.append(t.src)
-    return "\n".join(parts)
 
 
 def aggregate(results):
@@ -1276,7 +1194,7 @@ def main(argv):
     shards = [[] for _ in range(n_workers)]
     for i, t in enumerate(tests):
         shards[i % n_workers].append(
-            (t.rel, t.category, assemble_source(t), t.fm.negative_phase, t.fm.negative_type)
+            (t.rel, t.category, t.src, t.fm.negative_phase, t.fm.negative_type)
         )
 
     t_run_start = time.monotonic()

lib/js/test262-scoreboard.json

@@ -1,53 +1,137 @@
 {
   "totals": {
-    "pass": 4,
-    "fail": 10,
-    "skip": 16,
-    "timeout": 0,
-    "total": 30,
-    "runnable": 14,
-    "pass_rate": 28.6
+    "pass": 162,
+    "fail": 128,
+    "skip": 1597,
+    "timeout": 10,
+    "total": 1897,
+    "runnable": 300,
+    "pass_rate": 54.0
   },
   "categories": [
     {
-      "category": "built-ins/Function",
-      "total": 30,
-      "pass": 4,
-      "fail": 10,
-      "skip": 16,
-      "timeout": 0,
-      "pass_rate": 28.6,
+      "category": "built-ins/Math",
+      "total": 327,
+      "pass": 43,
+      "fail": 56,
+      "skip": 227,
+      "timeout": 1,
+      "pass_rate": 43.0,
       "top_failures": [
         [
-          "SyntaxError (parse/unsupported syntax)",
+          "TypeError: not a function",
+          36
+        ],
+        [
+          "Test262Error (assertion failed)",
+          20
+        ],
+        [
+          "Timeout",
+          1
+        ]
+      ]
+    },
+    {
+      "category": "built-ins/Number",
+      "total": 340,
+      "pass": 77,
+      "fail": 19,
+      "skip": 240,
+      "timeout": 4,
+      "pass_rate": 77.0,
+      "top_failures": [
+        [
+          "Test262Error (assertion failed)",
+          19
+        ],
+        [
+          "Timeout",
           4
+        ]
+      ]
+    },
+    {
+      "category": "built-ins/String",
+      "total": 1223,
+      "pass": 42,
+      "fail": 53,
+      "skip": 1123,
+      "timeout": 5,
+      "pass_rate": 42.0,
+      "top_failures": [
+        [
+          "Test262Error (assertion failed)",
+          44
+        ],
+        [
+          "Timeout",
+          5
         ],
         [
           "ReferenceError (undefined symbol)",
-          3
+          2
         ],
         [
-          "TypeError (other)",
-          3
+          "Unhandled: Not callable: {:__proto__ {:toLowerCase <lambda(&rest, args)",
+          2
+        ],
+        [
+          "Unhandled: Not callable: \\\\\\",
+          2
         ]
       ]
+    },
+    {
+      "category": "built-ins/StringIteratorPrototype",
+      "total": 7,
+      "pass": 0,
+      "fail": 0,
+      "skip": 7,
+      "timeout": 0,
+      "pass_rate": 0.0,
+      "top_failures": []
     }
   ],
   "top_failure_modes": [
     [
-      "SyntaxError (parse/unsupported syntax)",
-      4
+      "Test262Error (assertion failed)",
+      83
+    ],
+    [
+      "TypeError: not a function",
+      36
+    ],
+    [
+      "Timeout",
+      10
     ],
     [
       "ReferenceError (undefined symbol)",
-      3
+      2
     ],
     [
-      "TypeError (other)",
-      3
+      "Unhandled: Not callable: {:__proto__ {:toLowerCase <lambda(&rest, args)",
+      2
+    ],
+    [
+      "Unhandled: Not callable: \\\\\\",
+      2
+    ],
+    [
+      "SyntaxError (parse/unsupported syntax)",
+      1
+    ],
+    [
+      "Unhandled: Not callable: {:__proto__ {:valueOf <lambda()> :propertyIsEn",
+      1
+    ],
+    [
+      "Unhandled: js-transpile-binop: unsupported op: >>>\\",
+      1
     ]
   ],
   "pinned_commit": "d5e73fc8d2c663554fb72e2380a8c2bc1a318a33",
-  "elapsed_seconds": 11.2,
+  "elapsed_seconds": 274.5,
   "workers": 1
 }

lib/js/test262-scoreboard.md

@@ -1,26 +1,47 @@
 # test262 scoreboard
 
 Pinned commit: `d5e73fc8d2c663554fb72e2380a8c2bc1a318a33`
-Wall time: 11.2s
+Wall time: 274.5s
 
-**Total:** 4/14 runnable passed (28.6%). Raw: pass=4 fail=10 skip=16 timeout=0 total=30.
+**Total:** 162/300 runnable passed (54.0%). Raw: pass=162 fail=128 skip=1597 timeout=10 total=1897.
 
 ## Top failure modes
 
-- **4x** SyntaxError (parse/unsupported syntax)
-- **3x** ReferenceError (undefined symbol)
-- **3x** TypeError (other)
+- **83x** Test262Error (assertion failed)
+- **36x** TypeError: not a function
+- **10x** Timeout
+- **2x** ReferenceError (undefined symbol)
+- **2x** Unhandled: Not callable: {:__proto__ {:toLowerCase <lambda(&rest, args)
+- **2x** Unhandled: Not callable: \\\
+- **1x** SyntaxError (parse/unsupported syntax)
+- **1x** Unhandled: Not callable: {:__proto__ {:valueOf <lambda()> :propertyIsEn
+- **1x** Unhandled: js-transpile-binop: unsupported op: >>>\
 
 ## Categories (worst pass-rate first, min 10 runnable)
 
 | Category | Pass | Fail | Skip | Timeout | Total | Pass % |
 |---|---:|---:|---:|---:|---:|---:|
-| built-ins/Function | 4 | 10 | 16 | 0 | 30 | 28.6% |
+| built-ins/String | 42 | 53 | 1123 | 5 | 1223 | 42.0% |
+| built-ins/Math | 43 | 56 | 227 | 1 | 327 | 43.0% |
+| built-ins/Number | 77 | 19 | 240 | 4 | 340 | 77.0% |
 
 ## Per-category top failures (min 10 runnable, worst first)
 
-### built-ins/Function  (4/14 — 28.6%)
+### built-ins/String  (42/100 — 42.0%)
 
-- **4x** SyntaxError (parse/unsupported syntax)
-- **3x** ReferenceError (undefined symbol)
-- **3x** TypeError (other)
+- **44x** Test262Error (assertion failed)
+- **5x** Timeout
+- **2x** ReferenceError (undefined symbol)
+- **2x** Unhandled: Not callable: {:__proto__ {:toLowerCase <lambda(&rest, args)
+- **2x** Unhandled: Not callable: \\\
+
+### built-ins/Math  (43/100 — 43.0%)
+
+- **36x** TypeError: not a function
+- **20x** Test262Error (assertion failed)
+- **1x** Timeout
+
+### built-ins/Number  (77/100 — 77.0%)
+
+- **19x** Test262Error (assertion failed)
+- **4x** Timeout

lib/js/transpile.sx

@@ -98,7 +98,6 @@
             (list (js-sym "js-regex-new") (nth ast 1) (nth ast 2)))
           ((js-tag? ast "js-null") nil)
           ((js-tag? ast "js-undef") (list (js-sym "quote") :js-undefined))
-          ((js-tag? ast "js-paren") (js-transpile (nth ast 1)))
           ((js-tag? ast "js-ident") (js-transpile-ident (nth ast 1)))
           ((js-tag? ast "js-unop")
             (js-transpile-unop (nth ast 1) (nth ast 2)))
@@ -117,8 +116,7 @@
           ((js-tag? ast "js-arrow")
             (js-transpile-arrow (nth ast 1) (nth ast 2)))
           ((js-tag? ast "js-program") (js-transpile-stmts (nth ast 1)))
-          ((js-tag? ast "js-block")
-            (cons (js-sym "begin") (js-transpile-stmt-list (nth ast 1))))
+          ((js-tag? ast "js-block") (js-transpile-stmts (nth ast 1)))
           ((js-tag? ast "js-exprstmt") (js-transpile (nth ast 1)))
           ((js-tag? ast "js-empty") nil)
           ((js-tag? ast "js-var")
@@ -166,8 +164,6 @@
             (js-transpile-new (nth ast 1) (nth ast 2)))
           ((js-tag? ast "js-class")
             (js-transpile-class (nth ast 1) (nth ast 2) (nth ast 3)))
-          ((js-tag? ast "js-comma")
-            (cons (js-sym "begin") (map js-transpile (nth ast 1))))
           ((js-tag? ast "js-throw") (js-transpile-throw (nth ast 1)))
           ((js-tag? ast "js-try")
             (js-transpile-try (nth ast 1) (nth ast 2) (nth ast 3)))
@@ -225,23 +221,7 @@
               (js-sym "js-delete-prop")
               (js-transpile (nth arg 1))
               (js-transpile (nth arg 2))))
-          ((js-tag? arg "js-ident") false)
-          ((js-tag? arg "js-paren") (js-transpile-unop op (nth arg 1)))
           (else true)))
-      ((and (= op "typeof") (js-tag? arg "js-ident"))
-        (let
-          ((name (nth arg 1)))
-          (list
-            (js-sym "if")
-            (list
-              (js-sym "or")
-              (list
-                (js-sym "env-has?")
-                (list (js-sym "current-env"))
-                name)
-              (list (js-sym "dict-has?") (js-sym "js-global") name))
-            (list (js-sym "js-typeof") (js-transpile arg))
-            "undefined")))
       (else
         (let
           ((a (js-transpile arg)))
@@ -251,8 +231,7 @@
             ((= op "!") (list (js-sym "js-not") a))
             ((= op "~") (list (js-sym "js-bitnot") a))
             ((= op "typeof") (list (js-sym "js-typeof") a))
-            ((= op "void")
-              (list (js-sym "begin") a (list (js-sym "quote") :js-undefined)))
+            ((= op "void") (list (js-sym "quote") :js-undefined))
             (else (error (str "js-transpile-unop: unsupported op: " op)))))))))
 
 ;; ── Array literal ─────────────────────────────────────────────────
@@ -316,21 +295,6 @@
               (list (js-sym "js-undefined?") (js-sym "_a")))
             (js-transpile r)
             (js-sym "_a"))))
-      ((= op ">>>")
-        (list
-          (js-sym "js-unsigned-rshift")
-          (js-transpile l)
-          (js-transpile r)))
-      ((= op "<<")
-        (list (js-sym "js-shl") (js-transpile l) (js-transpile r)))
-      ((= op ">>")
-        (list (js-sym "js-shr") (js-transpile l) (js-transpile r)))
-      ((= op "&")
-        (list (js-sym "js-bitand") (js-transpile l) (js-transpile r)))
-      ((= op "|")
-        (list (js-sym "js-bitor") (js-transpile l) (js-transpile r)))
-      ((= op "^")
-        (list (js-sym "js-bitxor") (js-transpile l) (js-transpile r)))
       (else (error (str "js-transpile-binop: unsupported op: " op))))))
 
 ;; ── Object literal ────────────────────────────────────────────────
@@ -409,19 +373,7 @@
     (list
       (js-sym "js-new-call")
       (js-transpile callee)
-      (cond
-        ((js-has-spread? args)
-          (cons
-            (js-sym "js-array-spread-build")
-            (map
-              (fn
-                (e)
-                (if
-                  (js-tag? e "js-spread")
-                  (list (js-sym "list") "js-spread" (js-transpile (nth e 1)))
-                  (list (js-sym "list") "js-value" (js-transpile e))))
-              args)))
-        (else (cons (js-sym "js-args") (map js-transpile args)))))))
+      (cons (js-sym "list") (map js-transpile args)))))
 
 (define
   js-transpile-array
@@ -439,7 +391,7 @@
               (list (js-sym "list") "js-spread" (js-transpile (nth e 1)))
               (list (js-sym "list") "js-value" (js-transpile e))))
           elts))
-      (cons (js-sym "js-make-list") (map js-transpile elts)))))
+      (cons (js-sym "list") (map js-transpile elts)))))
 
 (define
   js-has-spread?
@@ -469,7 +421,7 @@
               (list (js-sym "list") "js-spread" (js-transpile (nth e 1)))
               (list (js-sym "list") "js-value" (js-transpile e))))
           args))
-      (cons (js-sym "js-args") (map js-transpile args)))))
+      (cons (js-sym "list") (map js-transpile args)))))
 
 ;; Transpile a JS expression string to SX source text (for inspection
 ;; in tests). Useful for asserting the exact emitted tree.
@@ -479,28 +431,18 @@
     (entries)
     (list
       (js-sym "let")
-      (list (list (js-sym "_obj") (list (js-sym "js-make-obj"))))
+      (list (list (js-sym "_obj") (list (js-sym "dict"))))
       (cons
         (js-sym "begin")
         (append
           (map
             (fn
               (entry)
-              (cond
-                ((contains? (keys entry) :spread)
               (list
-                    (js-sym "js-obj-spread!")
+                (js-sym "dict-set!")
                 (js-sym "_obj")
-                    (js-transpile (get entry :spread))))
-                (else
-                  (list
-                    (js-sym "js-obj-set!")
-                    (js-sym "_obj")
-                    (if
-                      (contains? (keys entry) :computed-key)
-                      (list (js-sym "js-to-string") (js-transpile (get entry :computed-key)))
-                      (get entry :key))
-                    (js-transpile (get entry :value))))))
+                (get entry :key)
+                (js-transpile (get entry :value))))
             entries)
           (list (js-sym "_obj")))))))
 
@@ -544,95 +486,6 @@
                 (append inits (list (js-transpile body))))))))
       (list (js-sym "fn") param-syms body-tr))))
 
-(define
-  js-collect-var-decl-names
-  (fn
-    (decls)
-    (cond
-      ((empty? decls) (list))
-      ((js-tag? (first decls) "js-vardecl")
-        (cons
-          (nth (first decls) 1)
-          (js-collect-var-decl-names (rest decls))))
-      (else (js-collect-var-decl-names (rest decls))))))
-
-(define
-  js-collect-var-names
-  (fn
-    (stmts)
-    (cond
-      ((empty? stmts) (list))
-      (else
-        (append
-          (js-collect-var-names-stmt (first stmts))
-          (js-collect-var-names (rest stmts)))))))
-
-(define
-  js-collect-var-names-stmt
-  (fn
-    (stmt)
-    (cond
-      ((not (list? stmt)) (list))
-      ((and (js-tag? stmt "js-var") (= (nth stmt 1) "var"))
-        (js-collect-var-decl-names (nth stmt 2)))
-      ((js-tag? stmt "js-block") (js-collect-var-names (nth stmt 1)))
-      ((js-tag? stmt "js-for")
-        (append
-          (js-collect-var-names-stmt (nth stmt 1))
-          (js-collect-var-names-stmt (nth stmt 4))))
-      ((js-tag? stmt "js-for-of-in")
-        (js-collect-var-names-stmt (nth stmt 4)))
-      ((js-tag? stmt "js-while")
-        (js-collect-var-names-stmt (nth stmt 2)))
-      ((js-tag? stmt "js-do-while")
-        (js-collect-var-names-stmt (nth stmt 1)))
-      ((js-tag? stmt "js-if")
-        (append
-          (js-collect-var-names-stmt (nth stmt 2))
-          (if (>= (len stmt) 4) (js-collect-var-names-stmt (nth stmt 3)) (list))))
-      ((js-tag? stmt "js-try")
-        (append
-          (js-collect-var-names-stmt (nth stmt 1))
-          (if (and (>= (len stmt) 3) (list? (nth stmt 2)))
-              (js-collect-var-names-stmt (nth (nth stmt 2) 2))
-              (list))
-          (if (>= (len stmt) 4) (js-collect-var-names-stmt (nth stmt 3)) (list))))
-      ((js-tag? stmt "js-switch")
-        (js-collect-var-names-cases (nth stmt 2)))
-      (else (list)))))
-
-(define
-  js-collect-var-names-cases
-  (fn
-    (cases)
-    (cond
-      ((empty? cases) (list))
-      (else
-        (append
-          (js-collect-var-names (nth (first cases) 2))
-          (js-collect-var-names-cases (rest cases)))))))
-
-(define
-  js-dedup-names
-  (fn
-    (names seen)
-    (cond
-      ((empty? names) (list))
-      ((some (fn (s) (= s (first names))) seen)
-        (js-dedup-names (rest names) seen))
-      (else
-        (cons
-          (first names)
-          (js-dedup-names (rest names) (cons (first names) seen)))))))
-
-(define
-  js-var-hoist-forms
-  (fn
-    (names)
-    (map
-      (fn (name) (list (js-sym "define") (js-sym name) :js-undefined))
-      names)))
-
 (define
   js-transpile-tpl
   (fn
@@ -724,12 +577,6 @@
             (list (js-sym "js-undefined?") lhs-expr))
           rhs-expr
           lhs-expr))
-      ((= op "<<=") (list (js-sym "js-shl") lhs-expr rhs-expr))
-      ((= op ">>=") (list (js-sym "js-shr") lhs-expr rhs-expr))
-      ((= op ">>>=") (list (js-sym "js-unsigned-rshift") lhs-expr rhs-expr))
-      ((= op "&=") (list (js-sym "js-bitand") lhs-expr rhs-expr))
-      ((= op "|=") (list (js-sym "js-bitor") lhs-expr rhs-expr))
-      ((= op "^=") (list (js-sym "js-bitxor") lhs-expr rhs-expr))
       (else (error (str "js-compound-update: unsupported op: " op))))))
 
 (define
@@ -959,7 +806,7 @@
                 (if
                   (= iter-kind "of")
                   (list (js-sym "js-iterable-to-list") iter-sx)
-                  (list (js-sym "js-for-in-keys") iter-sx))))
+                  (list (js-sym "js-object-keys") iter-sx))))
             (list
               (js-sym "for-each")
               (list
@@ -988,7 +835,7 @@
   (fn
     (params)
     (cond
-      ((empty? params) (list (js-sym "&rest") (js-sym "__extra_args__")))
+      ((empty? params) (list))
       ((and (list? (first params)) (js-tag? (first params) "js-rest"))
         (list (js-sym "&rest") (js-sym (nth (first params) 1))))
       (else
@@ -996,27 +843,6 @@
           (js-param-sym (first params))
           (js-build-param-list (rest params)))))))
 
-(define
-  js-arguments-build-form
-  (fn
-    (params)
-    (list (js-sym "js-list-copy") (js-arguments-build-form-raw params))))
-
-(define
-  js-arguments-build-form-raw
-  (fn
-    (params)
-    (cond
-      ((empty? params)
-        (js-sym "__extra_args__"))
-      ((and (list? (first params)) (js-tag? (first params) "js-rest"))
-        (js-sym (nth (first params) 1)))
-      (else
-        (list
-          (js-sym "cons")
-          (js-param-sym (first params))
-          (js-arguments-build-form-raw (rest params)))))))
-
 (define
   js-param-init-forms
   (fn
@@ -1050,7 +876,7 @@
   (fn
     (stmts)
     (let
-      ((hoisted (append (js-var-hoist-forms (js-dedup-names (js-collect-var-names stmts) (list))) (js-collect-funcdecls stmts))))
+      ((hoisted (js-collect-funcdecls stmts)))
       (let
         ((rest-stmts (js-transpile-stmt-list stmts)))
         (cons (js-sym "begin") (append hoisted rest-stmts))))))
@@ -1109,12 +935,12 @@
 
 (define
   js-transpile-var
-  (fn (kind decls) (cons (js-sym "begin") (js-vardecl-forms decls (= kind "var")))))
+  (fn (kind decls) (cons (js-sym "begin") (js-vardecl-forms kind decls))))
 
 (define
   js-vardecl-forms
   (fn
-    (decls is-var)
+    (kind decls)
     (cond
       ((empty? decls) (list))
       (else
@@ -1124,10 +950,10 @@
             ((js-tag? d "js-vardecl")
               (cons
                 (list
-                  (js-sym (if is-var "set!" "define"))
+                  (js-sym "define")
                   (js-sym (nth d 1))
                   (js-transpile (nth d 2)))
-                (js-vardecl-forms (rest decls) is-var)))
+                (js-vardecl-forms kind (rest decls))))
             ((js-tag? d "js-vardecl-obj")
               (let
                 ((names (nth d 1))
@@ -1138,7 +964,7 @@
                   (js-vardecl-obj-forms
                     names
                     tmp-sym
-                    (js-vardecl-forms (rest decls) is-var)))))
+                    (js-vardecl-forms kind (rest decls))))))
             ((js-tag? d "js-vardecl-arr")
               (let
                 ((names (nth d 1))
@@ -1150,7 +976,7 @@
                     names
                     tmp-sym
                     0
-                    (js-vardecl-forms (rest decls) is-var)))))
+                    (js-vardecl-forms kind (rest decls))))))
             (else (error "js-vardecl-forms: unexpected decl"))))))))
 
 (define
@@ -1450,28 +1276,7 @@
     (let
       ((body-tr (js-transpile body)))
       (let
-        ((with-catch
-           (cond
-             ((= catch-part nil) body-tr)
-             (else
-               (let
-                 ((pname (nth catch-part 0))
-                   (cbody (nth catch-part 1))
-                   (raw-sym (js-sym "__raw_exc__")))
-                 (list
-                   (js-sym "guard")
-                   (list
-                     raw-sym
-                     (list
-                       (js-sym "else")
-                       (cond
-                         ((= pname nil) (js-transpile cbody))
-                         (else
-                           (list
-                             (js-sym "let")
-                             (list (list (js-sym pname) (list (js-sym "js-wrap-exn") raw-sym)))
-                             (js-transpile cbody))))))
-                   body-tr))))))
+        ((with-catch (cond ((= catch-part nil) body-tr) (else (let ((pname (nth catch-part 0)) (cbody (nth catch-part 1))) (list (js-sym "guard") (list (if (= pname nil) (js-sym "__exc__") (js-sym pname)) (list (js-sym "else") (js-transpile cbody))) body-tr))))))
         (cond
           ((= finally-part nil) with-catch)
           (else
@@ -1492,7 +1297,7 @@
           (if
             (and (list? body) (js-tag? body "js-block"))
             (let
-              ((hoisted (append (js-var-hoist-forms (js-dedup-names (js-collect-var-names (nth body 1)) (list))) (js-collect-funcdecls (nth body 1)))))
+              ((hoisted (js-collect-funcdecls (nth body 1))))
               (append hoisted (js-transpile-stmt-list (nth body 1))))
             (list (js-transpile body)))))
       (list
@@ -1500,9 +1305,7 @@
         param-syms
         (list
           (js-sym "let")
-          (list
-            (list (js-sym "this") (list (js-sym "js-this")))
-            (list (js-sym "arguments") (js-arguments-build-form params)))
+          (list (list (js-sym "this") (list (js-sym "js-this"))))
           (list
             (js-sym "let")
             (list
@@ -1513,7 +1316,7 @@
                   (list
                     (js-sym "fn")
                     (list (js-sym "__return__"))
-                    (cons (js-sym "begin") (append (append inits body-forms) (list nil)))))))
+                    (cons (js-sym "begin") (append inits body-forms))))))
             (list
               (js-sym "if")
               (list (js-sym "=") (js-sym "__r__") nil)
@@ -1530,7 +1333,7 @@
           (if
             (and (list? body) (js-tag? body "js-block"))
             (let
-              ((hoisted (append (js-var-hoist-forms (js-dedup-names (js-collect-var-names (nth body 1)) (list))) (js-collect-funcdecls (nth body 1)))))
+              ((hoisted (js-collect-funcdecls (nth body 1))))
               (append hoisted (js-transpile-stmt-list (nth body 1))))
             (list (js-transpile body)))))
       (list
@@ -1598,7 +1401,7 @@
   (fn
     (src)
     (let
-      ((result (eval-expr (list (quote let) (list (list (js-sym "this") (list (js-sym "js-this")))) (js-transpile (js-parse (js-tokenize src)))))))
+      ((result (eval-expr (js-transpile (js-parse (js-tokenize src))))))
       (js-drain-microtasks!)
       result)))
 

plans/agent-briefings/apl-loop.md

@@ -0,0 +1,81 @@
+# apl-on-sx loop agent (single agent, queue-driven)
+
+Role: iterates `plans/apl-on-sx.md` forever. Rank-polymorphic primitives + 6 operators on the JIT is the headline showcase — APL is the densest combinator algebra you can put on top of a primitive table. Every program is `array → array` pure pipelines, exactly what the JIT was built for.
+
+```
+description: apl-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/apl-on-sx.md`. Isolated worktree, forever, one commit per feature. Never push.
+
+## Restart baseline — check before iterating
+
+1. Read `plans/apl-on-sx.md` — roadmap + Progress log.
+2. `ls lib/apl/` — pick up from the most advanced file.
+3. If `lib/apl/tests/*.sx` exist, run them. Green before new work.
+4. If `lib/apl/scoreboard.md` exists, that's your baseline.
+
+## The queue
+
+Phase order per `plans/apl-on-sx.md`:
+
+- **Phase 1** — tokenizer + parser. Unicode glyphs, `¯` for negative, strands (juxtaposition), right-to-left, valence resolution by syntactic position
+- **Phase 2** — array model + scalar primitives. `make-array {shape, ravel}`, scalar promotion, broadcast for `+ - × ÷ ⌈ ⌊ * ⍟ | ! ○`, comparison, logical, `⍳`, `⎕IO`
+- **Phase 3** — structural primitives + indexing. `⍴ , ⍉ ↑ ↓ ⌽ ⊖ ⌷ ⍋ ⍒ ⊂ ⊃ ∊`
+- **Phase 4** — **THE SHOWCASE**: operators. `f/` (reduce), `f¨` (each), `∘.f` (outer), `f.g` (inner), `f⍨` (commute), `f∘g` (compose), `f⍣n` (power), `f⍤k` (rank), `@` (at)
+- **Phase 5** — dfns + tradfns + control flow. `{⍺+⍵}`, `∇` recurse, `⍺←default`, tradfn header, `:If/:While/:For/:Select`
+- **Phase 6** — classic programs (life, mandelbrot, primes, n-queens, quicksort) + idiom corpus + drive to 100+
+
+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/apl/**` and `plans/apl-on-sx.md`. Do **not** edit `spec/`, `hosts/`, `shared/`, other `lib/<lang>/` dirs, `lib/stdlib.sx`, or `lib/` root. APL primitives go in `lib/apl/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.
+- **SX files:** `sx-tree` MCP tools ONLY. `sx_validate` after edits.
+- **Unicode in `.sx`:** raw UTF-8 only, never `\uXXXX` escapes. Glyphs land directly in source.
+- **Worktree:** commit locally. Never push. Never touch `main`.
+- **Commit granularity:** one feature per commit.
+- **Plan file:** update Progress log + tick boxes every commit.
+
+## APL-specific gotchas
+
+- **Right-to-left, no precedence among functions.** `2 × 3 + 4` is `2 × (3 + 4)` = 14, not 10. Operators bind tighter than functions: `+/ ⍳5` is `+/(⍳5)`, and `2 +.× 3 4` is `2 (+.×) 3 4`.
+- **Valence by position.** `-3` is monadic negate (`-` with no left arg). `5-3` is dyadic subtract. The parser must look left to decide. Same glyph; different fn.
+- **`¯` is part of a number literal**, not a prefix function. `¯3` is the literal negative three; `-3` is the function call. Tokenizer eats `¯` into the numeric token.
+- **Strands.** `1 2 3` is a 3-element vector, not three separate calls. Adjacent literals fuse into a strand at parse time. Adjacent names do *not* fuse — `a b c` is three separate references.
+- **Scalar promotion.** `1 + 2 3 4` ↦ `3 4 5`. Any scalar broadcasts against any-rank conformable shape.
+- **Conformability** = exactly matching shapes, OR one side scalar, OR (in some dialects) one side rank-1 cycling against rank-N. Keep strict in v1: matching shape or scalar only.
+- **`⍳` is overloaded.** Monadic `⍳N` = vector 1..N (or 0..N-1 if `⎕IO=0`). Dyadic `V ⍳ W` = first-index lookup, returns `≢V+1` for not-found.
+- **Reduce with `+/⍳0`** = `0` (identity for `+`). Each scalar primitive has a defined identity used by reduce-on-empty. Don't crash; return identity.
+- **Reduce direction.** `f/` reduces the *last* axis. `f⌿` reduces the *first*. Matters for matrices.
+- **Indexing is 1-based** by default (`⎕IO=1`). Do not silently translate to 0-based; respect `⎕IO`.
+- **Bracket indexing** `A[I]` is sugar for `I⌷A` (squad-quad). Multi-axis: `A[I;J]` is `I J⌷A` with semicolon-separated axes; `A[;J]` selects all of axis 0.
+- **Dfn `{...}`** — `⍺` = left arg (may be unbound for monadic call → check with `⍺←default`), `⍵` = right arg, `∇` = recurse. Default left arg syntax: `⍺←0`.
+- **Tradfn vs dfn** — tradfns use line-numbered `→linenum` for goto; dfns use guards `cond:expr`. Pick the right one for the user's syntax.
+- **Empty array** = rank-N array where some dim is 0. `0⍴⍳0` is empty rank-1. Scalar prototype matters for empty-array operations; ignore in v1, return 0/space.
+- **Test corpus:** custom + idioms. Place programs in `lib/apl/tests/programs/` with `.apl` extension.
+
+## 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/apl-on-sx.md` inline.
+- Short, factual commit messages (`apl: outer product ∘. (+9)`).
+- One feature per iteration. Commit. Log. Next.
+
+Go. Read the plan; find first `[ ]`; implement.

plans/agent-briefings/common-lisp-loop.md

@@ -0,0 +1,80 @@
+# common-lisp-on-sx loop agent (single agent, queue-driven)
+
+Role: iterates `plans/common-lisp-on-sx.md` forever. Conditions + restarts on delimited continuations is the headline showcase — every other Lisp reinvents resumable exceptions on the host stack. On SX `signal`/`invoke-restart` is just a captured continuation. Plus CLOS, the LOOP macro, packages.
+
+```
+description: common-lisp-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/common-lisp-on-sx.md`. Isolated worktree, forever, one commit per feature. Never push.
+
+## Restart baseline — check before iterating
+
+1. Read `plans/common-lisp-on-sx.md` — roadmap + Progress log.
+2. `ls lib/common-lisp/` — pick up from the most advanced file.
+3. If `lib/common-lisp/tests/*.sx` exist, run them. Green before new work.
+4. If `lib/common-lisp/scoreboard.md` exists, that's your baseline.
+
+## The queue
+
+Phase order per `plans/common-lisp-on-sx.md`:
+
+- **Phase 1** — reader + parser (read macros `#'` `'` `` ` `` `,` `,@` `#( … )` `#:` `#\char` `#xFF` `#b1010`, ratios, dispatch chars, lambda lists with `&optional`/`&rest`/`&key`/`&aux`)
+- **Phase 2** — sequential eval + special forms (`let`/`let*`/`flet`/`labels`, `block`/`return-from`, `tagbody`/`go`, `unwind-protect`, multiple values, `setf` subset, dynamic variables)
+- **Phase 3** — **THE SHOWCASE**: condition system + restarts. `define-condition`, `signal`/`error`/`cerror`/`warn`, `handler-bind` (non-unwinding), `handler-case` (unwinding), `restart-case`, `restart-bind`, `find-restart`/`invoke-restart`/`compute-restarts`, `with-condition-restarts`. Classic programs (restart-demo, parse-recover, interactive-debugger) green.
+- **Phase 4** — CLOS: `defclass`, `defgeneric`, `defmethod` with `:before`/`:after`/`:around`, `call-next-method`, multiple dispatch
+- **Phase 5** — macros + LOOP macro + reader macros
+- **Phase 6** — packages + stdlib (sequence functions, FORMAT directives, drive corpus to 200+)
+
+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/common-lisp/**` and `plans/common-lisp-on-sx.md`. Do **not** edit `spec/`, `hosts/`, `shared/`, other `lib/<lang>/` dirs, `lib/stdlib.sx`, or `lib/` root. CL primitives go in `lib/common-lisp/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.
+
+## Common-Lisp-specific gotchas
+
+- **`handler-bind` is non-unwinding** — handlers can decline by returning normally, in which case `signal` keeps walking the chain. **`handler-case` is unwinding** — picking a handler aborts the protected form via a captured continuation. Don't conflate them.
+- **Restarts are not handlers.** `restart-case` establishes named *resumption points*; `signal` runs handler code with restarts visible; the handler chooses a restart by calling `invoke-restart`, which abandons handler stack and resumes at the restart point. Two stacks: handlers walk down, restarts wait to be invoked.
+- **`block` / `return-from`** is lexical. `block name … (return-from name v) …` captures `^k` once at entry; `return-from` invokes it. `return-from` to a name not in scope is an error (don't fall back to outer block).
+- **`tagbody` / `go`** — each tag in tagbody is a continuation; `go tag` invokes it. Tags are lexical, can only target tagbodies in scope.
+- **`unwind-protect`** runs cleanup on *any* non-local exit (return-from, throw, condition unwind). Implement as a scope frame fired by the cleanup machinery.
+- **Multiple values**: primary-value-only contexts (function args, `if` test, etc.) drop extras silently. `values` produces multiple. `multiple-value-bind` / `multiple-value-call` consume them. Don't auto-list.
+- **CLOS dispatch:** sort applicable methods by argument-list specificity (`subclassp` per arg, left-to-right); standard method combination calls primary methods most-specific-first via `call-next-method` chain. `:before` runs all before primaries; `:after` runs all after, in reverse-specificity. `:around` wraps everything.
+- **`call-next-method`** is a *continuation* available only inside a method body. Implement as a thunk stored in a dynamic-extent variable.
+- **Generalised reference (`setf`)**: `(setf (foo x) v)` ↦ `(setf-foo v x)`. Look up the setf-expander, not just a writer fn. `define-setf-expander` is mandatory for non-trivial places. Start with the symbolic / list / aref / slot-value cases.
+- **Dynamic variables (specials):** `defvar`/`defparameter` mark a symbol as special. `let` over a special name *rebinds* in dynamic extent (use parameterize-style scope), not lexical.
+- **Symbols are package-qualified.** Reader resolves `cl:car`, `mypkg::internal`, bare `foo` (current package). Internal vs external matters for `:` (one colon) reads.
+- **`nil` is also `()` is also the empty list.** Same object. `nil` is also false. CL has no distinct unit value.
+- **LOOP macro is huge.** Build incrementally — start with `for/in`, `for/from`, `collect`, `sum`, `count`, `repeat`. Add conditional clauses (`when`, `if`, `else`) once iteration drivers stable. `named` blocks + `return-from named` last.
+- **Test corpus:** custom + curated `ansi-test` slice. Place programs in `lib/common-lisp/tests/programs/` with `.lisp` extension.
+
+## 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/common-lisp-on-sx.md` inline.
+- Short, factual commit messages (`common-lisp: handler-bind + 12 tests`).
+- One feature per iteration. Commit. Log. Next.
+
+Go. Read the plan; find first `[ ]`; implement.

plans/agent-briefings/loop.md

@@ -14,7 +14,7 @@ You are the sole background agent working `/root/rose-ash/plans/js-on-sx.md`. A
 
 ## Current state (restart baseline — verify before iterating)
 
-- Branch: `loops/js`.
+- Branch: `architecture`. HEAD: `14b6586e` (HS-related, not js-on-sx).
 - `lib/js/` is **untracked** — nothing is committed yet. First commit should stage everything current on disk.
 - `lib/js/test262-upstream/` is a clone of tc39/test262 pinned at `d5e73fc8d2c663554fb72e2380a8c2bc1a318a33`. **Gitignore it** (`lib/js/.gitignore` → `test262-upstream/`). Do not commit the 50k test files.
 - `lib/js/test262-runner.py` exists but is buggy — current scoreboard is `0/8 (7 timeouts, 1 fail)`. The runner needs real work: harness script loading, batching, per-test timeout tuning, strict-mode skipping.
@@ -61,7 +61,7 @@ Tagged dict: `{:__js_string__ true :utf16 <list-of-uint16> :str <lazy-utf8-cache
 - **Scope:** only `lib/js/**` and `plans/js-on-sx.md`. Do NOT touch `spec/`, `shared/`, `lib/hyperscript/`. Shared-file issues go under the plan's "Blockers" section.
 - **SX files:** `sx-tree` MCP tools ONLY. `sx_summarise` / `sx_read_subtree` / `sx_find_all` / `sx_get_context` before edits. `sx_replace_node` / `sx_insert_child` / `sx_insert_near` / `sx_replace_by_pattern` / `sx_rename_symbol` for edits. `sx_validate` after. `sx_write_file` for new files. Never `Edit`/`Read`/`Write` on `.sx`.
 - **Shell, Python, Markdown, JSON:** edit normally.
-- **Branch:** `loops/js`. Commit, then push to `origin/loops/js`. Never touch `main`.
+- **Branch:** `architecture`. Commit locally. Never push. Never touch `main`.
 - **Commit granularity:** one feature per commit. Short, factual commit messages. Commit even if a partial fix — don't hoard changes.
 - **Tests:** `bash lib/js/test.sh` (254/254 baseline) and `bash lib/js/conformance.sh` (148/148 baseline). Never regress. If a feature requires larger refactor, split into multiple commits each green.
 - **Plan file:** append one paragraph per iteration to "Progress log". Tick `[x]` boxes. Don't rewrite history.

plans/agent-briefings/primitives-loop.md

@@ -0,0 +1,769 @@
+# SX Primitives — Meta-Loop Briefing
+
+Goal: add fundamental missing SX primitives in sequence, then sweep all language
+implementations to replace their workarounds. Full rationale: vectors fix O(n) array
+access across every language; numeric tower fixes float/int conflation; dynamic-wind
+fixes cleanup semantics; coroutine primitive unifies Ruby/Lua/Tcl; string buffer fixes
+O(n²) concat; algebraic data types eliminate the tagged-dict pattern everywhere.
+
+**Each fire: find the first unchecked `[ ]`, do it, commit, tick it, stop.**
+Sub-items within a Phase may span multiple fires — just commit progress and tick what's done.
+
+---
+
+## Phase 0 — Prep (gate)
+
+- [x] Stop new-language loops: send `/exit` to sx-loops windows for the four blank-slate
+      languages that haven't committed workarounds yet:
+      ```
+      tmux send-keys -t sx-loops:common-lisp "/exit" Enter
+      tmux send-keys -t sx-loops:apl          "/exit" Enter
+      tmux send-keys -t sx-loops:ruby         "/exit" Enter
+      tmux send-keys -t sx-loops:tcl          "/exit" Enter
+      ```
+      Verify all four windows are idle (claude prompt, no active task).
+
+- [x] E38 + E39 landed: check both Bucket-E branches for implementation commits.
+      ```
+      git log --oneline hs-e38-sourceinfo | head -5
+      git log --oneline hs-e39-webworker  | head -5
+      ```
+      If either branch has only its base commit (no impl work yet): note "pending" and stop —
+      next fire re-checks. Proceed only when both have at least one implementation commit.
+
+---
+
+## Phase 1 — Vectors
+
+Native mutable integer-indexed arrays. Fix: Lua O(n) sort, APL rank polymorphism, Ruby
+Array, Tcl lists, Common Lisp vectors, all using string-keyed dicts today.
+
+Primitives to add:
+- `make-vector` `n` `[fill]` → vector of length n
+- `vector?` `v` → bool
+- `vector-ref` `v` `i` → element at index i (0-based)
+- `vector-set!` `v` `i` `x` → mutate in place
+- `vector-length` `v` → integer
+- `vector->list` `v` → list
+- `list->vector` `lst` → vector
+- `vector-fill!` `v` `x` → fill all elements
+- `vector-copy` `v` `[start]` `[end]` → fresh copy of slice
+
+Steps:
+- [x] OCaml: add `SxVector of value array` to `hosts/ocaml/sx_types.ml`; implement all
+      primitives in `hosts/ocaml/sx_primitives.ml` (or equivalent); wire into evaluator.
+      Note: Vector type + most prims were already present; added bounds-checked vector-ref/set!
+      and optional start/end to vector-copy. 10/10 vector tests pass (r7rs suite).
+- [x] Spec: add vector entries to `spec/primitives.sx` with type signatures and descriptions.
+      All 10 vector primitives now have :as type annotations, :returns, and :doc strings.
+      make-vector: optional fill param; vector-copy: optional start/end (done prev step).
+- [x] JS bootstrapper: implement vectors in `hosts/javascript/platform.js` (or equivalent);
+      ensure `sx-browser.js` rebuild picks them up.
+      Fixed index-of for lists (was returning -1 not NIL, breaking bind-lambda-params),
+      added _lastErrorKont_/hostError/try-catch/without-io-hook stubs. Vectors work.
+- [x] Tests: 40+ tests in `spec/tests/test-vectors.sx` covering construction, ref, set!,
+      length, conversions, fill, copy, bounds behaviour.
+      42 tests, all pass. 1847 standard / 2362 full passing (up from 5).
+- [x] Verify: full test suite still passes (`node hosts/javascript/run_tests.js --full`).
+      2362/4924 pass (improvement from pre-existing lambda binding bug, no regressions).
+- [x] Commit: `spec: vector primitive (make-vector/vector-ref/vector-set!/etc)`
+      Committed as: js: fix lambda binding (index-of on lists), add vectors + R7RS platform stubs
+
+---
+
+## Phase 2 — Numeric tower
+
+Float ≠ integer distinction. Fix: Erlang `=:=`, Lua `math.type()`, Haskell `Num`/`Integral`,
+Common Lisp `integerp`/`floatp`/`ratio`, JS `Number.isInteger`.
+
+Changes:
+- `parse-number` preserves float identity: `"1.0"` → float 1.0, not integer 1
+- New predicates: `integer?`, `float?`, `exact?`, `inexact?`
+- New coercions: `exact->inexact`, `inexact->exact`
+- Fix `floor`/`ceiling`/`truncate`/`round` to return integers when applied to floats
+- `number->string` renders `1.0` as `"1.0"`, `1` as `"1"`
+- Arithmetic: `(+ 1 1.0)` → `2.0` (float contagion), `(+ 1 1)` → `2` (integer)
+
+Steps:
+- [x] OCaml: distinguish `Integer of int` / `Number of float` in `sx_types.ml`; update all
+      arithmetic primitives for float contagion; fix `parse-number`.
+      92/92 numeric tower tests pass; 4874 total (394 pre-existing hs-upstream fails unchanged).
+- [x] Spec: update `spec/primitives.sx` with new predicates + coercions; document contagion rules.
+      Added integer?/float? predicates; updated number? body; / returns "float"; floor/ceil/truncate
+      return "integer"; +/-/* doc float contagion; fixed double-paren params; 4874/394 baseline.
+- [x] JS bootstrapper: update number representation and arithmetic.
+      Added integer?/float?/exact?/inexact?/truncate/remainder/modulo/random-int/exact->inexact/
+      inexact->exact/parse-number. Fixed sx_server.ml epoch protocol for Integer type.
+      JS: 1940 passed (+60); OCaml: 4874/394 unchanged. 6 tests JS-only fail (float≡int limitation).
+- [x] Tests: 92 tests in `spec/tests/test-numeric-tower.sx` — int-arithmetic, float-contagion,
+      division, predicates, coercions, rounding, parse-number, equality, modulo, min-max, stringify.
+- [x] Verify: full suite passes. OCaml 4874/394 (baseline unchanged). JS 1940/2500 (+60 vs pre-tower).
+      No regressions on any test that relied on `1.0 = 1` — those tests were already using integer
+      literals which remain identical in JS. 6 JS-only failures are platform-inherent (JS float≡int).
+- [x] Commit: all work landed across 4 commits (c70bbdeb, 45ec5535, b12a22e6, f5acb31c).
+
+---
+
+## Phase 3 — Dynamic-wind
+
+Fix: Common Lisp `unwind-protect`, Ruby `ensure`, JS `finally`, Tcl `catch`+cleanup,
+Erlang `try...after` (currently uses double-nested guard workaround).
+
+- [x] Spec: implement `dynamic-wind` in `spec/evaluator.sx` such that the after-thunk fires
+      on both normal return AND non-local exit (raise/call-cc escape). Must compose with
+      `guard` — currently they don't interact.
+- [x] OCaml: wire `dynamic-wind` through the CEK machine with a `WindFrame` continuation.
+- [x] JS bootstrapper: update.
+- [x] Tests: 20+ tests covering normal return, raise, call/cc escape, nested dynamic-winds.
+- [x] Commit: `spec: dynamic-wind + guard integration`
+
+---
+
+## Phase 4 — Coroutine primitive
+
+Unify Ruby fibers, Lua coroutines, Tcl coroutines — all currently reimplemented separately
+using call/cc+perform/resume.
+
+- [x] Spec: add `make-coroutine`, `coroutine-resume`, `coroutine-yield`, `coroutine?`,
+      `coroutine-alive?` to `spec/primitives.sx`. Build on existing `perform`/`cek-resume`
+      machinery — coroutines ARE perform/resume with a stable identity.
+      Implemented as `spec/coroutines.sx` define-library; `make-coroutine` stub in evaluator.sx.
+      17/17 coroutine tests pass (OCaml). Drives iteration via define+fn recursion (not named let —
+      named let uses cek_call→cek_run which errors on IO suspension).
+- [x] OCaml: implement coroutine type; wire resume/yield through CEK suspension.
+      No new native type needed — dict-based coroutine identity + existing cek-step-loop/
+      cek-resume/perform primitives in run_tests.ml ARE the OCaml implementation. 17/17 pass.
+- [x] JS bootstrapper: update.
+      All CEK primitives already in sx-browser.js. Fix: pre-load spec/coroutines.sx +
+      spec/signals.sx in run_tests.js so (import (sx coroutines)) resolves without suspension.
+      17/17 pass in JS. 1965/2500 (+25 vs 1940 baseline). Zero new failures.
+- [x] Tests: 25+ tests — multi-yield, final return, arg passthrough, alive? predicate,
+      nested coroutines, "final return vs yield" distinction (the Lua gotcha).
+      27 tests: added 10 new — state field inspection (ready/suspended/dead), yield from
+      nested helper, initial resume arg ignored, mutable closure state, complex yield values,
+      round-robin scheduling, factory-shared-no-state, non-coroutine error. 27/27 OCaml+JS.
+- [x] Commit: `spec: coroutine primitive (make-coroutine/resume/yield)`
+      Phase 4 landed across 4 commits: 21cb9cf5 (spec library), 9eb12c66 (ocaml verified),
+      b78e06a7 (js pre-load), 0ffe208e (27 tests). Phase 4 complete.
+
+---
+
+## Phase 5 — String buffer
+
+Fix O(n²) string concatenation in loops across Lua, Ruby, Common Lisp, Tcl.
+
+- [x] Spec + OCaml: add `make-string-buffer`, `string-buffer-append!`, `string-buffer->string`,
+      `string-buffer-length` to primitives. OCaml: `Buffer.t` wrapper. JS: array+join.
+      Also: string-buffer? predicate; SxStringBuffer._string_buffer marker for typeOf/dict?
+      exclusion; inspect case in sx_types.ml. 17/17 tests OCaml+JS.
+- [x] Tests: 15+ tests.
+      17 tests written inline with Spec+OCaml step: construction, type-of, empty/length,
+      single/multi-append, append-returns-nil, empty-string-append, reuse-after-to-string,
+      independence, loop-building, CSV-row, unicode, repeated-to-string, join-pattern.
+      17/17 OCaml+JS.
+- [x] Commit: `spec: string-buffer primitive`
+      Committed as d98b5fa2 — all work in one commit (OCaml type + primitives + JS + spec + 17 tests).
+
+---
+
+## Phase 6 — Algebraic data types
+
+The deepest structural gap. Every language uses `{:tag "..." :field ...}` tagged dicts to
+simulate sum types. A native `define-type` + `match` form eliminates this everywhere.
+
+- [x] Design: write `plans/designs/sx-adt.md` covering syntax, CEK dispatch, interaction with
+      existing `cond`/`case`, exhaustiveness checking, recursive types, pattern variables.
+      Draft, then stop — next fire reviews design before implementing.
+      Written: define-type/match syntax, AdtValue runtime rep, stepSfDefineType + MatchFrame
+      CEK dispatch, exhaustiveness warnings via _adt_registry, recursive types, nested patterns,
+      wildcard _, 3-phase impl plan (basic/nested/exhaustiveness), open questions on accessors/singletons/inspect.
+
+- [x] Spec: implement `define-type` special form in `spec/evaluator.sx`:
+      `(define-type Name (Ctor1 field...) (Ctor2 field...) ...)`
+      Creates constructor functions `Ctor1`, `Ctor2` + predicate `Name?`.
+
+- [x] Spec: implement `match` special form:
+      `(match expr ((Ctor1 a b) body) ((Ctor2 x) body) (else body))`
+      Exhaustiveness warning if not all constructors covered and no `else`.
+
+- [x] OCaml: add `SxAdt of string * value array` to types; implement constructors + match.
+      Dict-based ADT (no native type needed — matches spec). Hand-written sf_define_type
+      in bootstrap.py FIXUPS; registered via register_special_form. 172 assertions pass.
+      4280/1080 full suite (37 improvement over old baseline 4243/1117).
+- [x] JS bootstrapper: update.
+      No changes needed — define-type/match are spec-level; sx-browser.js rebuilt at 0dc7e159.
+      40/40 ADT tests pass JS. 2032/2500 total (+67 vs 1965 phase-4 baseline).
+- [x] Tests: 40+ tests in `spec/tests/test-adt.sx`.
+      40 tests written across two spec commits (6c872107+0dc7e159). All pass OCaml+JS.
+- [x] Commit: `spec: algebraic data types (define-type + match)`
+      Phase 6 landed across 5 commits: 6c872107 (define-type spec), 0dc7e159 (match spec),
+      5d1913e7 (ocaml bootstrap), f63b2147 (plan tick). JS already current.
+
+---
+
+## Phase 7 — Bitwise operations
+
+Completely absent today. Needed by: Forth (core), APL (array masks), Erlang (bitmatch),
+JS (typed arrays, bitfields), Common Lisp (`logand`/`logior`/`logxor`/`lognot`/`ash`).
+
+Primitives to add:
+- `bitwise-and` `a` `b` → integer
+- `bitwise-or` `a` `b` → integer
+- `bitwise-xor` `a` `b` → integer
+- `bitwise-not` `a` → integer
+- `arithmetic-shift` `a` `count` → integer (left if count > 0, right if count < 0)
+- `bit-count` `a` → number of set bits (popcount)
+- `integer-length` `a` → number of bits needed to represent a
+
+Steps:
+- [x] Spec: add entries to `spec/primitives.sx` with type signatures.
+      stdlib.bitwise module with 7 entries appended to spec/primitives.sx.
+- [x] OCaml: implement in `hosts/ocaml/sx_primitives.ml` using OCaml `land`/`lor`/`lxor`/`lnot`/`lsl`/`asr`.
+      land/lor/lxor/lnot/lsl/asr in sx_primitives.ml. bit-count: Kernighan loop. integer-length: lsr loop.
+- [x] JS bootstrapper: implement in `hosts/javascript/platform.js` using JS `&`/`|`/`^`/`~`/`<<`/`>>`.
+      stdlib.bitwise module added to PRIMITIVES_JS_MODULES. bit-count: Hamming weight. integer-length: Math.clz32.
+- [x] Tests: 25+ tests in `spec/tests/test-bitwise.sx` — basic ops, shift left/right, negative numbers, popcount.
+      26 tests, 158 assertions, all pass OCaml+JS.
+- [x] Commit: `spec: bitwise operations (bitwise-and/or/xor/not, arithmetic-shift, bit-count)`
+      Committed a8a79dc9. Phase 7 complete in single commit.
+
+---
+
+## Phase 8 — Multiple values
+
+R7RS standard. Common Lisp uses them heavily; Haskell tuples map naturally; Erlang
+multi-return. Without them, every function returning two things encodes it as a list or dict.
+
+Primitives / forms to add:
+- `values` `v...` → multiple-value object
+- `call-with-values` `producer` `consumer` → applies consumer to values from producer
+- `let-values` `(((a b) expr) ...)` `body` — binding form (special form in evaluator)
+- `define-values` `(a b ...)` `expr` — top-level multi-value bind
+
+Steps:
+- [x] Spec: add `SxValues` type to evaluator; implement `values` + `call-with-values` in
+      `spec/evaluator.sx`; add `let-values` / `define-values` special forms.
+- [x] OCaml: add `SxValues of value list` to `sx_types.ml`; wire through CEK.
+- [x] JS bootstrapper: implement values type + forms.
+- [x] Tests: 25+ tests in `spec/tests/test-values.sx` — basic producer/consumer, let-values
+      destructuring, define-values, interaction with `begin`/`do`.
+- [x] Commit: `spec: multiple values (values/call-with-values/let-values)`
+
+---
+
+## Phase 9 — Promises (lazy evaluation)
+
+Critical for Haskell — lazy evaluation is so central that without it the Haskell
+implementation can't be idiomatic. Also useful for lazy lists in Common Lisp and
+lazy streams in Scheme-style code generally.
+
+Primitives / forms to add:
+- `delay` `expr` → promise (special form — expr not evaluated yet)
+- `force` `p` → evaluate promise, cache result, return it
+- `make-promise` `v` → already-forced promise wrapping v
+- `promise?` `v` → bool
+- `delay-force` `expr` → for iterative lazy sequences (avoids stack growth in lazy streams)
+
+Steps:
+- [x] Spec: add `delay` / `delay-force` special forms to `spec/evaluator.sx`; add promise
+      type with mutable forced/value slots; `force` checks if already forced before eval.
+- [x] OCaml: add `SxPromise of { mutable forced: bool; mutable value: value; thunk: value }`;
+      wire `delay`/`force`/`delay-force` through CEK.
+- [x] JS bootstrapper: implement promise type + forms.
+- [x] Tests: 25+ tests in `spec/tests/test-promises.sx` — basic delay/force, memoisation
+      (forced only once), delay-force lazy stream, promise? predicate, make-promise.
+- [x] Commit: `spec: promises — delay/force/delay-force for lazy evaluation`
+
+---
+
+## Phase 10 — Mutable hash tables
+
+Distinct from SX's immutable dicts. Dict primitives copy on every update — fine for
+functional code, wrong for table-heavy language implementations. Lua tables, Smalltalk
+dicts, Erlang process dictionaries, and JS Map all need O(1) mutable associative storage.
+
+Primitives to add:
+- `make-hash-table` `[capacity]` → fresh mutable hash table
+- `hash-table?` `v` → bool
+- `hash-table-set!` `ht` `key` `val` → mutate in place
+- `hash-table-ref` `ht` `key` `[default]` → value or default/error
+- `hash-table-delete!` `ht` `key` → remove entry
+- `hash-table-size` `ht` → integer
+- `hash-table-keys` `ht` → list of keys
+- `hash-table-values` `ht` → list of values
+- `hash-table->alist` `ht` → list of (key . value) pairs
+- `hash-table-for-each` `ht` `fn` → iterate (fn key val) for side effects
+- `hash-table-merge!` `dst` `src` → merge src into dst in place
+
+Steps:
+- [x] Spec: add entries to `spec/primitives.sx`.
+      stdlib.hash-table module with 11 define-primitive entries appended to spec/primitives.sx.
+- [x] OCaml: add `HashTable of (value, value) Hashtbl.t` to `sx_types.ml`; implement
+      all primitives in `hosts/ocaml/sx_primitives.ml`.
+      HashTable variant in sx_types.ml; type_of/inspect cases added; 11 primitives in sx_primitives.ml;
+      fixed _cek_call_ref reference for hash-table-for-each. 4385/1080 (+28).
+- [x] JS bootstrapper: implement using JS `Map` in `hosts/javascript/platform.js`.
+      SxHashTable class with Map; _hash_table marker; dict?/type-of exclusion; apply() for for-each.
+      2137/2500 (+4 vs phase-9 baseline).
+- [x] Tests: 30+ tests in `spec/tests/test-hash-table.sx` — set/ref/delete, size, iteration,
+      default on missing key, merge, keys/values lists.
+      28 tests; all pass OCaml+JS. Used empty? not assert= for empty-list comparisons.
+- [x] Commit: `spec: mutable hash tables (make-hash-table/ref/set!/delete!/etc)`
+      Committed 133bdf52. Phase 10 complete.
+
+---
+
+## Phase 11 — Sequence protocol
+
+Unified iteration over lists and vectors without conversion. Currently `map`/`filter`/
+`for-each` only work on lists — you must `vector->list` first, which defeats the purpose
+of vectors. A sequence protocol makes all collection operations polymorphic.
+
+Approach: extend existing `map`/`filter`/`reduce`/`for-each`/`some`/`every?` to dispatch
+on type (list → existing path, vector → index loop, string → char iteration). Add:
+- `in-range` `start` `[end]` `[step]` → lazy range sequence (works with `for-each`/`map`)
+- `sequence->list` `s` → coerce any sequence to list
+- `sequence->vector` `s` → coerce any sequence to vector
+- `sequence-length` `s` → length of any sequence
+- `sequence-ref` `s` `i` → element by index (lists and vectors)
+- `sequence-append` `s1` `s2` → concatenate two same-type sequences
+
+Steps:
+- [x] Spec: extend `map`/`filter`/`reduce`/`for-each`/`some`/`every?` in `spec/evaluator.sx`
+      to type-dispatch; add `in-range` lazy sequence type + helpers.
+- [x] OCaml: update HO form dispatch; add `SxRange` or use lazy list; implement `sequence-*`
+      primitives.
+      seq_to_list helper before let-rec block; ho_setup_dispatch wraps all 7 coll bindings;
+      seq-to-list/sequence-to-list/vector/length/ref/append/in-range in sx_primitives.ml.
+      4385/1080 (all failures pre-existing hs-*/regex; 0 regressions).
+- [x] JS bootstrapper: update.
+      Already done in Spec step (da4b526a) — sx-browser.js rebuilt with seqToList/sequenceToList/
+      sequenceToVector/sequenceLength/sequenceRef/sequenceAppend/inRange. 2137/2500 JS tests pass.
+- [x] Tests: 30+ tests in `spec/tests/test-sequences.sx` — map over vector, filter over
+      range, for-each over string chars, sequence-append, sequence->list/vector coercions.
+      45 tests all passing: JS 2185/2498 (+48), OCaml 4424/1087 (+39). Fixed: vector? rename
+      (isVector), vectorLength/vectorRef/reverse aliases, in-range letrec→build-range,
+      sequence-length nil=0, assert-equal for list comparisons. Committed 0fe00bf7.
+- [x] Commit: `spec: sequence protocol — polymorphic map/filter/for-each over list/vector/range`
+      Work landed across da4b526a (Spec), 7286629c (OCaml), 06a3eee1 (JS bootstrap), 0fe00bf7 (Tests).
+
+---
+
+## Phase 12 — gensym + symbol interning
+
+Unique symbol generation. Tiny to implement; broadly needed: Prolog uses it for fresh
+variable names, Common Lisp uses it constantly in macros, any hygienic macro system needs
+it, and Smalltalk uses it for anonymous class/method naming.
+
+Primitives to add:
+- `gensym` `[prefix]` → unique symbol, e.g. `g42`, `var-17`. Counter-based, monotonically increasing.
+- `symbol-interned?` `s` → bool — whether the symbol is in the global intern table
+- `intern` `str` → symbol — intern a string as a symbol (string->symbol already exists; this is
+  the explicit interning operation for languages that distinguish interned vs uninterned)
+
+Steps:
+- [x] Spec: add `gensym` counter to evaluator state; implement in `spec/evaluator.sx`.
+      `string->symbol` already exists — `gensym` is just a counter-suffixed variant.
+      Added *gensym-counter*/gensym/string->symbol/symbol->string/intern/symbol-interned? to
+      evaluator.sx. Added string->symbol/symbol->string transpiler renames + platform.py aliases.
+      JS 2186/+1. OCaml builds. Committed edf4e525.
+- [x] OCaml: add global gensym counter; implement primitives.
+      gensym_counter ref + gensym/string->symbol/symbol->string/intern/symbol-interned? in sx_primitives.ml.
+      Also fixed ListRef case in seq_to_list (both sx_ref.ml + sx_primitives.ml). 4431/1080 (was 4385/1080).
+- [x] JS bootstrapper: implement.
+      Already done in Spec step. JS 2186/2497, all sequence tests pass.
+- [x] Tests: 15+ tests in `spec/tests/test-gensym.sx` — uniqueness, prefix, symbol?, string->symbol round-trip.
+      19 tests. OCaml 4450/1080, JS 2205/2497, zero regressions.
+- [x] Commit: `spec: gensym + symbol interning` — 0862a614
+
+---
+
+## Phase 13 — Character type
+
+Common Lisp and Haskell have a distinct `Char` type that is not a string. Without it both
+implementations are approximations — CL's `#\a` literal and Haskell's `'a'` both need a
+real char value, not a length-1 string.
+
+Primitives to add:
+- `char?` `v` → bool
+- `char->integer` `c` → Unicode codepoint integer
+- `integer->char` `n` → char
+- `char=?` `char<?` `char>?` `char<=?` `char>=?` → comparators
+- `char-ci=?` `char-ci<?` etc. → case-insensitive comparators
+- `char-alphabetic?` `char-numeric?` `char-whitespace?` → predicates
+- `char-upper-case?` `char-lower-case?` → predicates
+- `char-upcase` `char-downcase` → char → char
+- `string->list` extended to return chars (not length-1 strings)
+- `list->string` accepting chars
+
+Also: `#\a` reader syntax for char literals (parser addition).
+
+Steps:
+- [x] Spec: add `SxChar` type to evaluator; add char literal syntax `#\a`/`#\space`/`#\newline`
+      to `spec/parser.sx`; implement all predicates + comparators.
+- [x] OCaml: add `SxChar of char` to `sx_types.ml`; implement primitives.
+- [x] JS bootstrapper: implement char type wrapping a codepoint integer.
+- [x] Tests: 30+ tests in `spec/tests/test-chars.sx` — literals, char->integer round-trip,
+      comparators, predicates, upcase/downcase, string<->list with chars.
+- [x] Commit: `spec: character type (char? char->integer #\\a literals + predicates)`
+
+---
+
+## Phase 14 — String ports
+
+Needed for any language with a reader protocol: Common Lisp's `read`, Prolog's term parser,
+Smalltalk's `printString`. Without string ports these all do their own character walking
+on raw strings rather than treating a string as an I/O stream.
+
+Primitives to add:
+- `open-input-string` `str` → input port
+- `open-output-string` → output port
+- `get-output-string` `port` → string (flush output port to string)
+- `input-port?` `output-port?` `port?` → predicates
+- `read-char` `[port]` → char or eof-object
+- `peek-char` `[port]` → char or eof-object (non-consuming)
+- `read-line` `[port]` → string or eof-object
+- `write-char` `char` `[port]` → void
+- `write-string` `str` `[port]` → void
+- `eof-object` → the eof sentinel
+- `eof-object?` `v` → bool
+- `close-port` `port` → void
+
+Steps:
+- [x] Spec: add port type + eof-object to evaluator; implement all primitives.
+      Ports are mutable objects with a position cursor (input) or accumulation buffer (output).
+- [x] OCaml: add `SxPort` variant covering string-input-port and string-output-port;
+      Buffer.t for output, string+offset for input.
+- [x] JS bootstrapper: implement port type.
+- [x] Tests: 25+ tests in `spec/tests/test-ports.sx` — open/read/peek/eof, output accumulation,
+      read-line, write-char, close.
+- [x] Commit: `spec: string ports (open-input-string/open-output-string/read-char/etc)` — 3d8937d7
+
+---
+
+## Phase 15 — Math completeness
+
+Filling specific gaps that multiple language implementations need.
+
+### 15a — modulo / remainder / quotient distinction
+They differ on negative numbers — critical for Erlang `rem`, Haskell `mod`/`rem`, CL `mod`/`rem`:
+- `quotient` `a` `b` → truncate toward zero (same sign as dividend)
+- `remainder` `a` `b` → sign follows dividend (truncation division)
+- `modulo` `a` `b` → sign follows divisor (floor division) — R7RS
+
+### 15b — Trigonometry and transcendentals
+Lua, Haskell, Erlang, CL all need: `sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `exp`,
+`log`, `sqrt`, `expt`. Check which are already present; add missing ones.
+
+### 15c — GCD / LCM
+`gcd` `a` `b` → greatest common divisor; `lcm` `a` `b` → least common multiple.
+Needed by Haskell `Rational`, CL, and any language doing fraction arithmetic.
+
+### 15d — Radix number parsing / formatting
+`(number->string n radix)` → e.g. `(number->string 255 16)` → `"ff"`.
+`(string->number s radix)` → e.g. `(string->number "ff" 16)` → `255`.
+Needed by: Common Lisp, Smalltalk, Erlang integer formatting.
+
+Steps:
+- [x] Audit which trig / math functions are already in `spec/primitives.sx`; note gaps.
+- [x] Spec + OCaml + JS: implement missing trig (`sin`/`cos`/`tan`/`asin`/`acos`/`atan`/`exp`/`log`).
+- [x] Spec + OCaml + JS: `quotient`/`remainder`/`modulo` with correct negative semantics.
+- [x] Spec + OCaml + JS: `gcd`/`lcm`.
+- [x] Spec + OCaml + JS: radix variants of `number->string`/`string->number`.
+- [x] Tests: 40+ tests in `spec/tests/test-math.sx`.
+- [x] Commit: `spec: math completeness — trig, quotient/remainder/modulo, gcd/lcm, radix`
+
+---
+
+## Phase 16 — Rational numbers
+
+Haskell's `Rational` type and Common Lisp ratios (`1/3`) both need this. Natural extension
+of the numeric tower (Phase 2) — rationals are the third numeric type alongside int and float.
+
+Primitives to add:
+- `make-rational` `numerator` `denominator` → rational (auto-reduced by GCD)
+- `rational?` `v` → bool
+- `numerator` `r` → integer
+- `denominator` `r` → integer
+- Reader syntax: `1/3` parsed as rational literal
+- Arithmetic: `(+ 1/3 1/6)` → `1/2`; `(* 1/3 3)` → `1`; mixed int/rational → rational
+- `exact->inexact` on rational → float; `inexact->exact` on float → rational approximation
+- `(number->string 1/3)` → `"1/3"`
+
+Steps:
+- [x] Spec: add `SxRational` type; add `n/d` reader syntax to `spec/parser.sx`; extend
+      all arithmetic primitives for rational contagion (int op rational → rational, rational
+      op float → float).
+- [x] OCaml: add `SxRational of int * int` (stored in reduced form); implement all arithmetic.
+      as_number + safe_eq extended for cross-type rational equality (= 2.5 5/2) → true.
+- [x] JS bootstrapper: implement rational type.
+      JS keeps int/int → float for CSS backward compatibility; SxRational class with _rational marker.
+- [x] Tests: 30+ tests in `spec/tests/test-rationals.sx` — literals, arithmetic, reduction,
+      mixed numeric tower, exact<->inexact conversion. 62 tests, all pass.
+- [x] Commit: `spec: rational numbers — 1/3 literals, arithmetic, numeric tower integration`
+      Committed 036022cc. JS: 2232 passed. OCaml: 4532 passed (+11).
+
+---
+
+## Phase 17 — read / write / display
+
+Completes the I/O model. Builds on string ports (Phase 14) and char type (Phase 13).
+`read` parses any SX value from a port; `write` serializes with quoting (round-trippable);
+`display` serializes without quoting (human-readable). Common Lisp's `read` macro,
+Prolog term I/O, and Smalltalk's `printString` all need this.
+
+Primitives to add:
+- `read` `[port]` → SX value or eof-object — full SX parser reading from a port
+- `read-char` already in Phase 14; `read` uses it internally
+- `write` `val` `[port]` → void — serializes with quotes: `"hello"`, `#\a`, `(1 2 3)`
+- `display` `val` `[port]` → void — serializes without quotes: `hello`, `a`, `(1 2 3)`
+- `newline` `[port]` → void — writes `\n`
+- `write-to-string` `val` → string — convenience: `(write val (open-output-string))`
+- `display-to-string` `val` → string — convenience
+
+Steps:
+- [x] Spec: implement `read` in `spec/evaluator.sx` — wraps the existing parser to read
+      one datum from a port cursor; handles eof gracefully.
+- [x] Spec: implement `write`/`display`/`newline` — extend the existing serializer for
+      port output; `write` quotes strings + uses `#\` for chars, `display` does not.
+- [x] OCaml: wire `read` through port type; implement `write`/`display` output path.
+- [x] JS bootstrapper: implement.
+- [x] Tests: 25+ tests in `spec/tests/test-read-write.sx` — read string literal, read list,
+      read eof, write round-trip, display vs write quoting, newline, write-to-string.
+- [x] Commit: `spec: read/write/display — S-expression reader/writer on ports`
+
+---
+
+## Phase 18 — Sets
+
+O(1) membership testing. Distinct from hash tables (unkeyed) and lists (O(n)).
+Erlang has sets as a stdlib staple, Haskell `Data.Set`, APL uses set operations
+constantly, Common Lisp has `union`/`intersection` on lists but a native set is O(1).
+
+Primitives to add:
+- `make-set` `[list]` → fresh set, optionally seeded from list
+- `set?` `v` → bool
+- `set-add!` `s` `val` → void
+- `set-member?` `s` `val` → bool
+- `set-remove!` `s` `val` → void
+- `set-size` `s` → integer
+- `set->list` `s` → list (unspecified order)
+- `list->set` `lst` → set
+- `set-union` `s1` `s2` → new set
+- `set-intersection` `s1` `s2` → new set
+- `set-difference` `s1` `s2` → new set (elements in s1 not in s2)
+- `set-for-each` `s` `fn` → iterate for side effects
+- `set-map` `s` `fn` → new set of mapped values
+
+Steps:
+- [x] Spec: add entries to `spec/primitives.sx`.
+- [x] OCaml: implement using `Hashtbl.t` with unit values (or a proper `Set` functor
+      with a comparison function); add `SxSet` to `sx_types.ml`.
+- [x] JS bootstrapper: implement using JS `Set`.
+- [x] Tests: 30+ tests in `spec/tests/test-sets.sx` — add/member/remove, union/intersection/
+      difference, list conversion, for-each, size.
+- [x] Commit: `spec: sets (make-set/set-add!/set-member?/union/intersection/etc)`
+
+---
+
+## Phase 19 — Regular expressions as primitives
+
+`lib/js/regex.sx` is a pure-SX regex engine already written. Promoting it to a primitive
+gives every language free regex without reinventing: Lua patterns, Tcl `regexp`, Ruby regex,
+JS regex, Erlang `re` module. Mostly a wiring job — the implementation exists.
+
+Primitives to add:
+- `make-regexp` `pattern` `[flags]` → regexp object (`flags`: `"i"` case-insensitive, `"g"` global, `"m"` multiline)
+- `regexp?` `v` → bool
+- `regexp-match` `re` `str` → match dict `{:match "..." :start N :end N :groups (...)}` or nil
+- `regexp-match-all` `re` `str` → list of match dicts
+- `regexp-replace` `re` `str` `replacement` → string with first match replaced
+- `regexp-replace-all` `re` `str` `replacement` → string with all matches replaced
+- `regexp-split` `re` `str` → list of strings (split on matches)
+- Reader syntax: `#/pattern/flags` for regexp literals (parser addition)
+
+Steps:
+- [x] Audit `lib/js/regex.sx` — understand the API it already exposes; map to the
+      primitive API above.
+- [x] Spec: add `SxRegexp` type to evaluator; add `#/pattern/flags` literal syntax to
+      `spec/parser.sx`; wire `lib/js/regex.sx` engine as the implementation.
+- [x] OCaml: implement using OCaml `Re` library (or `Str`); add `SxRegexp` to types.
+- [x] JS bootstrapper: use native JS `RegExp`; wrap in the primitive API.
+- [x] Tests: 30+ tests in `spec/tests/test-regexp.sx` — basic match, groups, replace,
+      replace-all, split, flags (case-insensitive), no-match nil return.
+- [x] Commit: `spec: regular expressions (make-regexp/regexp-match/regexp-replace + #/pat/ literals)`
+
+---
+
+## Phase 20 — Bytevectors
+
+R7RS standard. Needed for WebSocket binary frames (E36), binary protocol parsing, and
+efficient string encoding. Also the foundation for proper Unicode: `string->utf8` /
+`utf8->string` require a byte array type.
+
+Primitives to add:
+- `make-bytevector` `n` `[fill]` → bytevector of n bytes (fill defaults to 0)
+- `bytevector?` `v` → bool
+- `bytevector-length` `bv` → integer
+- `bytevector-u8-ref` `bv` `i` → byte 0–255
+- `bytevector-u8-set!` `bv` `i` `byte` → void
+- `bytevector-copy` `bv` `[start]` `[end]` → fresh copy
+- `bytevector-copy!` `dst` `at` `src` `[start]` `[end]` → in-place copy
+- `bytevector-append` `bv...` → concatenated bytevector
+- `utf8->string` `bv` `[start]` `[end]` → string decoded as UTF-8
+- `string->utf8` `str` `[start]` `[end]` → bytevector UTF-8 encoded
+- `bytevector->list` / `list->bytevector` → conversion
+
+Steps:
+- [x] Spec: add `SxBytevector` type; implement all primitives in `spec/evaluator.sx` / `spec/primitives.sx`.
+- [x] OCaml: add `SxBytevector of bytes` to `sx_types.ml`; implement primitives using
+      OCaml `Bytes`.
+- [x] JS bootstrapper: implement using `Uint8Array`.
+- [x] Tests: 30+ tests in `spec/tests/test-bytevectors.sx` — construction, ref/set, copy,
+      append, utf8 round-trip, slice.
+- [x] Commit: `spec: bytevectors (make-bytevector/u8-ref/u8-set!/utf8->string/etc)`
+
+---
+
+## Phase 21 — format
+
+CL-style string formatting beyond `str`. `(format "Hello ~a, age ~d" name age)`.
+Haskell `printf`, Erlang `io:format`, CL `format`, and general string templating all use this idiom.
+
+Directives:
+- `~a` — display (no quotes)
+- `~s` — write (with quotes)
+- `~d` — decimal integer
+- `~x` — hexadecimal integer
+- `~o` — octal integer
+- `~b` — binary integer
+- `~f` — fixed-point float
+- `~e` — scientific notation float
+- `~%` — newline
+- `~&` — fresh line (newline only if not already at start of line)
+- `~~` — literal tilde
+- `~t` — tab
+
+Signature: `(format template arg...)` → string.
+Optional: `(format port template arg...)` — write to port directly.
+
+Steps:
+- [ ] Spec: implement `format` as a pure SX function in `spec/primitives.sx` — parses
+      `~X` directives, dispatches to `display`/`write`/`number->string` as appropriate.
+      Pure SX: no host calls needed. Self-hosting — uses string-buffer (Phase 5) internally.
+- [ ] OCaml: expose as a primitive (or let it run as SX through the evaluator).
+- [ ] JS bootstrapper: same.
+- [ ] Tests: 25+ tests in `spec/tests/test-format.sx` — each directive, multiple args,
+      nested format, port variant, `~~` escape.
+- [ ] Commit: `spec: format — CL-style string formatting (~a ~s ~d ~x ~% etc)`
+
+---
+
+## Phase 22 — Language sweep
+
+Replace workarounds with primitives. One language per fire (or per sub-item for big ones).
+Start with blank slates (CL, APL, Ruby, Tcl) — they haven't committed to workarounds yet.
+
+**Scope per language:** only `lib/<lang>/**`. Don't touch spec or other languages.
+Brief each language's loop agent (or do inline) after rebasing their branch onto architecture.
+
+- [ ] Restart CL/APL/Ruby/Tcl loops with updated briefing pointing to new primitives.
+      Add a note to each `plans/<lang>-on-sx.md` under a `## SX primitive baseline` section:
+      "Use vectors for arrays; numeric tower + rationals for numbers; ADTs for tagged data;
+      coroutines for fibers; string-buffer for mutable string building; bitwise ops for bit
+      manipulation; multiple values for multi-return; promises for lazy evaluation; hash tables
+      for mutable associative storage; sets for O(1) membership; sequence protocol for
+      polymorphic iteration; gensym for unique symbols; char type for characters; string ports
+      + read/write for reader protocols; regexp for pattern matching; bytevectors for binary
+      data; format for string templating."
+
+- [ ] Common Lisp: char type (`#\a`); string ports + `read`/`write` for reader/printer;
+      gensym for macros; rational numbers for CL ratios; multiple values; sets for CL set ops;
+      `modulo`/`remainder`/`quotient`; radix formatting; `format` for `cl:format`.
+
+- [ ] Lua: vectors for arrays; hash tables for Lua tables; `delay`/`force` for lazy iterators;
+      regexp for Lua pattern matching; trig from math completeness; bytevectors for binary I/O.
+
+- [ ] Erlang: numeric tower for float/int; bitwise ops for bitmatch; multiple values for
+      multi-return; sets for Erlang sets; `remainder` for `rem`; regexp for `re` module.
+
+- [ ] Haskell: numeric tower for `Num`/`Integral`/`Fractional`; promises for lazy evaluation
+      (critical); multiple values for tuples; rational numbers for `Rational`; char type for
+      `Char`; `gcd`/`lcm`; sets for `Data.Set`; `read`/`write` for `Show`/`Read` instances.
+
+- [ ] JS: vectors for Array; hash tables for `Map`; sets for `Set`; bitwise ops for typed
+      arrays; regexp for JS regex; bytevectors for `Uint8Array`; radix formatting.
+
+- [ ] Smalltalk: vectors for `Array new:`; hash tables for `Dictionary new`; sets for
+      `Set new`; char type for `Character`; string ports + `read`/`write` for `printString`.
+
+- [ ] APL: vectors as core array type; bitwise ops for array masks; sets for APL set ops;
+      sequence protocol for rank-polymorphic operations; format for APL output formatting.
+
+- [ ] Ruby: coroutines for fibers; hash tables for `Hash`; sets for `Set`; regexp for
+      Ruby regex; string ports for `StringIO`; bytevectors for `String` binary encoding.
+
+- [ ] Tcl: string ports for Tcl channel abstraction; string-buffer for `append`; coroutines
+      for Tcl coroutines; regexp for Tcl `regexp`; format for Tcl `format`.
+
+- [ ] Forth: bitwise ops (core); string-buffer for word-definition accumulation; bytevectors
+      for Forth's raw memory model.
+
+---
+
+## Ground rules
+
+- Work on the `architecture` branch in `/root/rose-ash` (main worktree).
+- Use sx-tree MCP for all `.sx` file edits. Never use raw Edit/Write/Read on `.sx` files.
+- Commit after each concrete unit of work. Never leave the branch broken.
+- Never push to `main` — only push to `origin/architecture`.
+- Update this checklist every fire: tick `[x]` done, add inline notes on blockers.
+
+---
+
+## Progress log
+
+_Newest first._
+
+- 2026-04-26: Phase 7 complete — bitwise-and/or/xor/not + arithmetic-shift + bit-count + integer-length. OCaml: land/lor/lxor/lnot/lsl/asr + Kernighan popcount + lsr loop for integer-length. JS: bitwise ops + Hamming weight + Math.clz32. 26 tests, 158 assertions, all pass. a8a79dc9.
+- 2026-04-26: Phase 6 complete — JS+Tests+Commit all ticked. JS needed no changes (spec-level forms). 40/40 ADT tests pass JS. 2032/2500 JS total (+67 vs phase-4). Phase 6 fully landed: 6c872107+0dc7e159+5d1913e7. Phase 7 (bitwise) next.
+- 2026-04-26: Phase 6 OCaml done — Dict-based ADT (no native SxAdt type needed); hand-written sf_define_type in bootstrap.py FIXUPS (skipped from transpile — &rest params + empty-dict {} literals); registered via register_special_form; step_limit/step_count added to PREAMBLE. 172 assertions pass (test-adt). Full suite 4280/1080 (was 4243/1117, +37). Committed 5d1913e7.
+- 2026-04-26: Phase 6 Spec match done — ADT case added to match-pattern in spec/evaluator.sx: checks (list? pattern)+(symbol? first)+(dict? value)+(get value :_adt), then matches :_ctor+arity and recursively binds field patterns. No-clause error now uses make-cek-value+raise-eval-frame so guard can catch it. 20 new match tests pass; 40/40 total ADT tests green. Zero regressions.
+- 2026-04-26: Phase 6 Spec define-type done — sf-define-type registered via register-special-form! in spec/evaluator.sx; AdtValue as {:_adt true :_type "..." :_ctor "..." :_fields (list ...)}; ctor fns + arity checking + Name?/Ctor? predicates + Ctor-field accessors; *adt-registry* dict populated per define-type call. 20/20 JS tests pass in spec/tests/test-adt.sx. OCaml define-type is next task.
+- 2026-04-26: Phase 6 Design done — plans/designs/sx-adt.md written. Covers define-type/match syntax, AdtValue CEK runtime, stepSfDefineType+MatchFrame dispatch, exhaustiveness warnings, recursive types, nested patterns, wildcard _. 3-phase impl plan. Next fire: Spec implement define-type.
+- 2026-04-26: Phase 5 complete — string buffer fully landed (d98b5fa2). 17 tests, 17/17 OCaml+JS. Phase 6 (ADTs) next.
+- 2026-04-26: Phase 5 Spec+OCaml+JS step done — StringBuffer of Buffer.t in sx_types.ml; make-string-buffer/append!/->string/length/string-buffer? in sx_primitives.ml; SxStringBuffer with _string_buffer marker + typeOf/dict? fixes in platform.py; JS rebuilt. 17/17 tests OCaml+JS.
+- 2026-04-26: Phase 4 complete — coroutine primitive fully landed (4 commits: spec library + OCaml verified + JS pre-load + 27 tests). Phase 5 (string buffer) next.
+- 2026-04-26: Phase 4 Tests step done — 27 tests total (10 new: state field inspection, yield-from-helper, initial-arg-ignored, mutable-closure, complex-values, round-robin, factory-no-state, non-coroutine-error). 27/27 OCaml+JS.
+- 2026-04-26: Phase 4 JS step done — all CEK primitives already in sx-browser.js; fix was pre-loading spec/coroutines.sx+spec/signals.sx in run_tests.js so (import (sx coroutines)) resolves synchronously. 17/17 coroutine tests pass JS. 1965/2500 total (+25), zero new failures.
+- 2026-04-26: Phase 4 OCaml step done — no native SxCoroutine type needed; existing cek-step-loop/cek-resume/perform/make-cek-state primitives in run_tests.ml fully support the spec/coroutines.sx library. 284/284 pass (coroutines+vectors+numeric-tower+dynamic-wind), zero regressions.
+- 2026-04-26: Phase 4 Spec step done — spec/coroutines.sx define-library with make-coroutine/coroutine-resume/coroutine-yield/coroutine?/coroutine-alive?; make-coroutine stub in evaluator.sx; 17/17 coroutine tests pass (OCaml). Key insight: coroutine body must use (define loop (fn...)) + (loop 0) not named let — named let uses cek_call→cek_run which errors on IO suspension.
+- 2026-05-01: Phase 10 complete — mutable hash tables. HashTable variant in OCaml; JS Map-based SxHashTable. 11 primitives: make-hash-table/hash-table?/set!/ref/delete!/size/keys/values/->alist/for-each/merge!. 28 tests, all pass OCaml+JS. 133bdf52.
+- 2026-05-01: Phase 9 complete — delay/force/delay-force/make-promise/promise?. Dict-based promise {:_promise :forced :thunk :value}; :_iterative flag for delay-force chain following. 25/25 tests OCaml (4357) and JS (2109). Committed e44cb89a.
+- 2026-05-01: Phase 8 complete — values/call-with-values/let-values/define-values. Dict marker {:_values true :_list [...]} (no new type). step-sf-define desugars shorthand (define (f x) body) on both hosts. 25/25 tests OCaml+JS. Committed 43cc1d90.
+- 2026-04-26: Phase 3 complete — OCaml+JS done. CallccContinuation gains winders-depth int; make_callcc_continuation/callcc_continuation_winders_len wired; wind-after/wind-return CekFrame fields fixed (cf_f=after-thunk, cf_extra=winders-len, cf_name=body-result); get_val + transpiler.sx updated. 8/8 dynamic-wind tests pass on OCaml; 235/235 (callcc+guard+do+r7rs) zero regressions. Committed 6602ec8c.
+- 2026-04-26: Phase 3 Spec+Tests done — dynamic-wind CEK implementation: wind-after/wind-return frames, *winders* stack, kont-unwind-to-handler, wind-escape-to. callcc frame stores winders-len in continuation; callcc-continuation? calls wind-escape-to before escape. 8/8 dynamic-wind tests pass (normal return, raise, call/cc, nested LIFO, guard ordering). 1948/2500 JS (+8). Zero regressions. Committed a9d5a108.
+- 2026-04-26: Phase 2 complete — Verify+Commit done. OCaml 4874/394, JS 1940/2500 (+60). No regressions. 6 JS-only failures are float≡int platform-inherent. Phase 2 fully landed across 4 commits.
+- 2026-04-26: Phase 2 JS bootstrapper done — integer?/float?/exact?/inexact? added (Number.isInteger); truncate/remainder/modulo/random-int/exact->inexact/inexact->exact/parse-number added. Fixed sx_server.ml epoch+blob+io-response protocol for Integer type. JS: 1940/2500 (+60). OCaml: 4874/394 baseline. 6 JS tests fail (JS float≡int platform limit). Committed b12a22e6.
+- 2026-04-26: Phase 2 Spec done — integer?/float? predicates added to spec/primitives.sx; floor/ceil/truncate :returns updated to "integer"; / to "float"; exact->inexact/inexact->exact docs and returns updated; float contagion documented on +/-/*; 4874/394 baseline. Committed 45ec5535.
+- 2026-04-26: Phase 2 OCaml+Tests done — `Integer of int` / `Number of float` in sx_types.ml; float contagion across all arithmetic; floor/truncate/round → Integer; integer?/float?/exact?/inexact?/exact->inexact/inexact->exact; 92/92 numeric tower tests pass; 4874 total (394 pre-existing unchanged). Committed c70bbdeb.
+- 2026-04-26: Phase 1 complete — JS step done. Fixed fundamental lambda binding bug (index-of on arrays returned -1 not NIL, making bind-lambda-params mis-fire &rest branch). Added _lastErrorKont_/hostError/try-catch stubs. 42/42 vector tests pass. 1847 std / 2362 full passing (up from 5). Committed.
+- 2026-04-25: Phase 1 spec step done — all 10 vector primitives in spec/primitives.sx have full :as type annotations, :returns, :doc; make-vector optional fill param added.
+- 2026-04-25: Phase 1 OCaml step done — bounds-checked vector-ref/set!, vector-copy now accepts optional start/end, spec/primitives.sx doc updated. 10/10 r7rs vector tests pass, 4747 total (394 pre-existing hs-upstream fails unchanged).
+- 2026-04-25: Phase 0 complete — stopped CL/APL/Ruby/Tcl loops (all 4 idle at shell); confirmed E38 (tokenizer :end/:line) and E39 (WebWorker stub) both have implementation commits.
+- 2026-05-01: Phase 20 complete — bytevectors. SxBytevector of bytes in OCaml using Bytes; Uint8Array-backed SxBytevector in JS. 12 primitives: make-bytevector, bytevector?, bytevector-length, bytevector-u8-ref, bytevector-u8-set!, bytevector-copy, bytevector-copy!, bytevector-append, utf8->string, string->utf8, bytevector->list, list->bytevector. 32 tests, all pass. JS 2535, OCaml 4725. a3811545.
+- 2026-05-01: Phase 19 complete — regular expressions. SxRegexp(src,flags,Re.re) in OCaml via Re.Pcre; SxRegexp wrapper around JS RegExp. 9 primitives: make-regexp, regexp?, regexp-source, regexp-flags, regexp-match, regexp-match-all, regexp-replace, regexp-replace-all, regexp-split. Match dicts with :match/:start/:end/:groups. 32 tests, all pass. JS 2503, OCaml 4693. d8d5588e.
+- 2026-05-01: Phase 18 complete — sets. SxSet as (string,value) Hashtbl keyed by inspect(val) in OCaml; Map keyed by write-to-string in JS. 13 primitives: make-set, set?, set-add!, set-member?, set-remove!, set-size, set->list, list->set, set-union, set-intersection, set-difference, set-for-each, set-map. 33 tests, all pass. JS 2469, OCaml 4659. 3b0ac67a.
+- 2026-05-01: Phase 17 complete — read/write/display. OCaml: sx_write_val/sx_display_val helpers; read via Sx_parser.read_value with #t/#f and N/D rational support added to parser; postprocess ()→Nil. JS: sxReadNormalize (#t/#f→true/false), sxReadConvert (()→NIL), sxEq list equality, sxWriteVal symbol/keyword name fix (v.name not v._sym), readerMacroGet registry. 42 tests (test-read-write.sx), all pass both hosts. JS 2436, OCaml 4626. 7d329f02.
+- 2026-05-01: Phase 16 complete — rational numbers. SxRational type in OCaml (Rational of int*int, reduced, denom>0) and JS (SxRational class, _rational marker). n/d reader in spec/parser.sx. Arithmetic contagion: int op rational → rational, rational op float → float. JS keeps int/int → float for CSS compat. OCaml as_number+safe_eq extended for cross-type rational equality. 62 tests in test-rationals.sx, all pass. JS 2232, OCaml 4532 (+11). 036022cc.
+- 2026-05-01: Phase 15 complete — math completeness. stdlib.math module: sin/cos/tan/asin/acos/atan(1-2 args)/exp/log/expt/quotient/gcd/lcm/number->string(radix)/string->number(radix). OCaml atan updated for optional 2nd arg. Strict radix parsing in JS string->number. 44 tests in test-math.sx, all pass. JS 2311/4801, OCaml 4547/5629. be2b11ac.
+- 2026-05-01: Phase 14 OCaml done — Eof + Port{PortInput/PortOutput} in sx_types.ml; 15 port primitives in sx_primitives.ml; raw_serialize updated; 4532/4532 (+39, zero regressions). 8ba0a33f.
+- 2026-05-01: Phase 14 Spec+JS+Tests+Commit done — port type {_port,_kind,_source/_buffer,_pos,_closed}; eof singleton; 15 primitives in spec/primitives.sx (stdlib.ports) + platform.py; 39/39 tests in test-ports.sx. Committed 3d8937d7. OCaml step next.
+- 2026-05-01: Phase 13 OCaml done — Char of int in sx_types.ml; #\ reader in sx_parser.ml; all char primitives in sx_primitives.ml; fixed get_val for Integer n list indexing (was Number-only); fixed raw_serialize for Integer/Char. 4493/4493 (+43, zero regressions). b939becd.
+- 2026-05-01: Phase 13 Spec+JS+Tests+Commit done — SxChar tagged {_char,codepoint}; char? char->integer integer->char char-upcase/downcase; 10 comparators (ordered+ci); 5 predicates; string->list/list->string as platform primitives; #\a #\space #\newline reader syntax in spec/parser.sx; js-char-renames dict in transpiler.sx; 43/43 tests pass JS (2254/4745). Committed 4b600f17. OCaml step next.
+- 2026-05-01: Phase 12 complete — gensym + symbol interning. gensym_counter/gensym/string->symbol/symbol->string/intern/symbol-interned? in spec + OCaml + JS. Fixed ListRef case in seq_to_list (both hosts). 19 tests, all pass. OCaml 4450/1080, JS 2205/2497. Commits: edf4e525 Spec, 0862a614 OCaml+Tests.
+- 2026-05-01: Phase 11 complete — sequence protocol done. Commits: da4b526a Spec, 7286629c OCaml, 06a3eee1 JS, 0fe00bf7 Tests. JS 2185/+48, OCaml 4424/+39.
+- 2026-05-01: Phase 11 Tests done — 45 tests in test-sequences.sx all passing (JS 2185/+48, OCaml 4424/+39). Fixed vector? rename, vectorLength/vectorRef/reverse aliases, in-range letrec→build-range, sequence-length nil, assert-equal for lists. Committed 0fe00bf7.
+- 2026-05-01: Phase 11 JS bootstrapper step done — confirmed sx-browser.js current (built in Spec step da4b526a); 19 sequence primitive refs in output; 2137/2500 JS tests passing.
+- 2026-05-01: Phase 11 OCaml step done — seq_to_list helper added before let-rec; ho_setup_dispatch wraps all 7 coll bindings with seq_to_list; seq-to-list/sequence-to-list/to-vector/length/ref/append + in-range primitives in sx_primitives.ml. 4385/4385 baseline unchanged, 0 regressions. Committed 7286629c.
+- 2026-05-01: Phase 11 Spec step done — seq-to-list coercion helper; ho-setup-dispatch extended with seqToList on all collection args; sequence-to-list/vector/length/ref/append + in-range added to evaluator.sx. Restored 3 accidentally-deleted make-cek-state/value/suspended definitions. Fixed 8 shorthand define forms + added vector->list/list->vector transpiler renames. JS: 2137 passing (+28 vs HEAD baseline of 2109).

plans/agent-briefings/ruby-loop.md

@@ -0,0 +1,83 @@
+# ruby-on-sx loop agent (single agent, queue-driven)
+
+Role: iterates `plans/ruby-on-sx.md` forever. Fibers via delcc is the headline showcase — `Fiber.new`/`Fiber.yield`/`Fiber.resume` are textbook delimited continuations with sugar, where MRI does it via C-stack swapping. Plus blocks/yield (lexical escape continuations, same shape as Smalltalk's non-local return), method_missing, and singleton classes.
+
+```
+description: ruby-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/ruby-on-sx.md`. Isolated worktree, forever, one commit per feature. Never push.
+
+## Restart baseline — check before iterating
+
+1. Read `plans/ruby-on-sx.md` — roadmap + Progress log.
+2. `ls lib/ruby/` — pick up from the most advanced file.
+3. If `lib/ruby/tests/*.sx` exist, run them. Green before new work.
+4. If `lib/ruby/scoreboard.md` exists, that's your baseline.
+
+## The queue
+
+Phase order per `plans/ruby-on-sx.md`:
+
+- **Phase 1** — tokenizer + parser. Keywords, identifier sigils (`@` ivar, `@@` cvar, `$` global), strings with interpolation, `%w[]`/`%i[]`, symbols, blocks `{|x| …}` and `do |x| … end`, splats, default args, method def
+- **Phase 2** — object model + sequential eval. Class table, ancestor-chain dispatch, `super`, singleton classes, `method_missing` fallback, dynamic constant lookup
+- **Phase 3** — blocks + procs + lambdas. Method captures escape continuation `^k`; `yield` / `return` / `break` / `next` / `redo` semantics; lambda strict arity vs proc lax
+- **Phase 4** — **THE SHOWCASE**: fibers via delcc. `Fiber.new`/`Fiber.resume`/`Fiber.yield`/`Fiber.transfer`. Classic programs (generator, producer-consumer, tree-walk) green
+- **Phase 5** — modules + mixins + metaprogramming. `include`/`prepend`/`extend`, `define_method`, `class_eval`/`instance_eval`, `respond_to?`/`respond_to_missing?`, hooks
+- **Phase 6** — stdlib drive. `Enumerable` mixin, `Comparable`, Array/Hash/Range/String/Integer methods, drive corpus to 200+
+
+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/ruby/**` and `plans/ruby-on-sx.md`. Do **not** edit `spec/`, `hosts/`, `shared/`, other `lib/<lang>/` dirs, `lib/stdlib.sx`, or `lib/` root. Ruby primitives go in `lib/ruby/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.
+
+## Ruby-specific gotchas
+
+- **Block `return` vs lambda `return`.** Inside a block `{ ... return v }`, `return` invokes the *enclosing method's* escape continuation (non-local return). Inside a lambda `->(){ ... return v }`, `return` returns from the *lambda*. Don't conflate. Implement: blocks bind their `^method-k`; lambdas bind their own `^lambda-k`.
+- **`break` from inside a block** invokes a different escape — the *iteration loop's* escape — and the loop returns the break-value. `next` is escape from current iteration, returns iteration value. `redo` re-enters current iteration without advancing.
+- **Proc arity is lax.** `proc { |a, b, c| … }.call(1, 2)` ↦ `c = nil`. Lambda is strict — same call raises ArgumentError. Check arity at call site for lambdas only.
+- **Block argument unpacking.** `[[1,2],[3,4]].each { |a, b| … }` — single Array arg auto-unpacks for blocks (not lambdas). One arg, one Array → unpack. Frequent footgun.
+- **Method dispatch chain order:** prepended modules → class methods → included modules → superclass → BasicObject → method_missing. `super` walks from the *defining* class's position, not the receiver class's.
+- **Singleton classes** are lazily allocated. Looking up the chain for an object passes through its singleton class first, then its actual class. `class << obj; …; end` opens the singleton.
+- **`method_missing`** — fallback when ancestor walk misses. Receives `(name_symbol, *args, &blk)`. Pair with `respond_to_missing?` for `respond_to?` to also report true. Do **not** swallow NoMethodError silently.
+- **Ivars are per-object dicts.** Reading an unset ivar yields `nil` and a warning (`-W`). Don't error.
+- **Constant lookup** is first lexical (Module.nesting), then inheritance (Module.ancestors of the innermost class). Different from method lookup.
+- **`Object#send`** invokes private and public methods alike; `Object#public_send` skips privates.
+- **Class reopening.** `class Foo; def bar; …; end; end` plus a later `class Foo; def baz; …; end; end` adds methods to the same class. Class table lookups must be by-name, mutable; methods dict is mutable.
+- **Fiber semantics.** `Fiber.new { |arg| … }` creates a fiber suspended at entry. First `Fiber.resume(v)` enters with `arg = v`. Inside, `Fiber.yield(w)` returns `w` to the resumer; the next `Fiber.resume(v')` returns `v'` to the yield site. End of block returns final value to last resumer; subsequent `Fiber.resume` raises FiberError.
+- **`Fiber.transfer`** is symmetric — either side can transfer to the other; no resume/yield asymmetry. Implement on top of the same continuation pair, just don't enforce direction.
+- **Symbols are interned.** `:foo == :foo` is identity. Use SX symbols.
+- **Strings are mutable.** `s = "abc"; s << "d"; s == "abcd"`. Hash keys can be strings; hash dups string keys at insertion to be safe (or freeze them).
+- **Truthiness:** only `false` and `nil` are falsy. `0`, `""`, `[]` are truthy.
+- **Test corpus:** custom + curated RubySpec slice. Place programs in `lib/ruby/tests/programs/` with `.rb` extension.
+
+## 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/ruby-on-sx.md` inline.
+- Short, factual commit messages (`ruby: Fiber.yield + Fiber.resume (+8)`).
+- One feature per iteration. Commit. Log. Next.
+
+Go. Read the plan; find first `[ ]`; implement.

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/agent-briefings/tcl-loop.md

@@ -0,0 +1,83 @@
+# tcl-on-sx loop agent (single agent, queue-driven)
+
+Role: iterates `plans/tcl-on-sx.md` forever. `uplevel`/`upvar` is the headline showcase — Tcl's superpower for defining your own control structures, requiring deep VM cooperation in any normal host but falling out of SX's first-class env-chain. Plus the Dodekalogue (12 rules), command-substitution everywhere, and "everything is a string" homoiconicity.
+
+```
+description: tcl-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/tcl-on-sx.md`. Isolated worktree, forever, one commit per feature. Never push.
+
+## Restart baseline — check before iterating
+
+1. Read `plans/tcl-on-sx.md` — roadmap + Progress log.
+2. `ls lib/tcl/` — pick up from the most advanced file.
+3. If `lib/tcl/tests/*.sx` exist, run them. Green before new work.
+4. If `lib/tcl/scoreboard.md` exists, that's your baseline.
+
+## The queue
+
+Phase order per `plans/tcl-on-sx.md`:
+
+- **Phase 1** — tokenizer + parser. The Dodekalogue (12 rules): word-splitting, command sub `[…]`, var sub `$name`/`${name}`/`$arr(idx)`, double-quote vs brace word, backslash, `;`, `#` comments only at command start, single-pass left-to-right substitution
+- **Phase 2** — sequential eval + core commands. `set`/`unset`/`incr`/`append`/`lappend`, `puts`/`gets`, `expr` (own mini-language), `if`/`while`/`for`/`foreach`/`switch`, string commands, list commands, dict commands
+- **Phase 3** — **THE SHOWCASE**: `proc` + `uplevel` + `upvar`. Frame stack with proc-call push/pop; `uplevel #N script` evaluates in caller's frame; `upvar` aliases names across frames. Classic programs (for-each-line, assert macro, with-temp-var) green
+- **Phase 4** — `return -code N`, `catch`, `try`/`trap`/`finally`, `throw`. Control flow as integer codes
+- **Phase 5** — namespaces + ensembles. `namespace eval`, qualified names `::ns::cmd`, ensembles, `namespace path`
+- **Phase 6** — coroutines (built on fibers, same delcc as Ruby fibers) + system commands + drive corpus to 150+
+
+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/tcl/**` and `plans/tcl-on-sx.md`. Do **not** edit `spec/`, `hosts/`, `shared/`, other `lib/<lang>/` dirs, `lib/stdlib.sx`, or `lib/` root. Tcl primitives go in `lib/tcl/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.
+
+## Tcl-specific gotchas
+
+- **Everything is a string.** Internally cache shimmer reps (list, dict, int, double) for performance, but every value must be re-stringifiable. Mutating one rep dirties the cached string and vice versa.
+- **The Dodekalogue is strict.** Substitution is **one-pass**, **left-to-right**. The result of a substitution is a value, not a script — it does NOT get re-parsed for further substitutions. This is what makes Tcl safe-by-default. Don't accidentally re-parse.
+- **Brace word `{…}`** is the only way to defer evaluation. No substitution inside, just balanced braces. Used for `if {expr}` body, `proc body`, `expr` arguments.
+- **Double-quote word `"…"`** is identical to a bare word for substitution purposes — it just allows whitespace in a single word. `\` escapes still apply.
+- **Comments are only at command position.** `# this is a comment` after a `;` or newline; *not* inside a command. `set x 1 # not a comment` is a 4-arg `set`.
+- **`expr` has its own grammar** — operator precedence, function calls — and does its own substitution. Brace `expr {$x + 1}` to avoid double-substitution and to enable bytecode caching.
+- **`if` and `while` re-parse** the condition only if not braced. Always use `if {…}`/`while {…}` form. The unbraced form re-substitutes per iteration.
+- **`return` from a `proc`** uses control code 2. `break` is 3, `continue` is 4. `error` is 1. `catch` traps any non-zero code; user can return non-zero with `return -code error -errorcode FOO message`.
+- **`uplevel #0 script`** is global frame. `uplevel 1 script` (or just `uplevel script`) is caller's frame. `uplevel #N` is absolute level N (0=global, 1=top-level proc, 2=proc-called-from-top, …). Negative levels are errors.
+- **`upvar #N otherVar localVar`** binds `localVar` in the current frame as an *alias* — both names refer to the same storage. Reads and writes go through the alias.
+- **`info level`** with no arg returns current level number. `info level N` (positive) returns the command list that invoked level N. `info level -N` returns the command list of the level N relative-up.
+- **Variable names with `(…)`** are array elements: `set arr(foo) 1`. Arrays are not first-class values — you can't `set x $arr`. `array get arr` gives a flat list `{key1 val1 key2 val2 …}`.
+- **List vs string.** `set l "a b c"` and `set l [list a b c]` look the same when printed but the second has a cached list rep. `lindex` works on both via shimmering. Most user code can't tell the difference.
+- **`incr x`** errors if x doesn't exist; pre-set with `set x 0` or use `incr x 0` first if you mean "create-or-increment". Or use `dict incr` for dicts.
+- **Coroutines are fibers.** `coroutine name body` starts a coroutine; calling `name` resumes it; `yield value` from inside suspends and returns `value` to the resumer. Same primitive as Ruby fibers — share the implementation under the hood.
+- **`switch`** matches first clause whose pattern matches. Default is `default`. Variant matches: glob (default), `-exact`, `-glob`, `-regexp`. Body `-` means "fall through to next clause's body".
+- **Test corpus:** custom + slice of Tcl's own tests. Place programs in `lib/tcl/tests/programs/` with `.tcl` extension.
+
+## 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/tcl-on-sx.md` inline.
+- Short, factual commit messages (`tcl: uplevel + upvar (+11)`).
+- One feature per iteration. Commit. Log. Next.
+
+Go. Read the plan; find first `[ ]`; implement.

plans/apl-on-sx.md

@@ -0,0 +1,115 @@
+# APL-on-SX: rank-polymorphic primitives + glyph parser
+
+The headline showcase is **rank polymorphism** — a single primitive (`+`, `⌈`, `⊂`, `⍳`) works uniformly on scalars, vectors, matrices, and higher-rank arrays. ~80 glyph primitives + 6 operators bind together with right-to-left evaluation; the entire language is a high-density combinator algebra. The JIT compiler + primitive table pay off massively here because almost every program is `array → array` pure pipelines.
+
+End-state goal: Dyalog-flavoured APL subset, dfns + tradfns, classic programs (game-of-life, mandelbrot, prime-sieve, n-queens, conway), 100+ green tests.
+
+## Scope decisions (defaults — override by editing before we spawn)
+
+- **Syntax:** Dyalog APL surface, Unicode glyphs. `⎕`-quad system functions for I/O. `∇` tradfn header.
+- **Conformance:** "Reads like APL, runs like APL." Not byte-compat with Dyalog; we care about right-to-left semantics and rank polymorphism.
+- **Test corpus:** custom — APL idioms (Roger Hui style), classic programs, plus ~50 pattern tests for primitives.
+- **Out of scope:** ⎕-namespaces beyond a handful, complex numbers, full TAO ordering, `⎕FX` runtime function definition (use static `∇` only), nested-array-of-functions higher orders, the editor.
+- **Glyphs:** input via plain Unicode in `.apl` source files. Backtick-prefix shortcuts handled by the user's editor — we don't ship one.
+
+## Ground rules
+
+- **Scope:** only touch `lib/apl/**` and `plans/apl-on-sx.md`. Don't edit `spec/`, `hosts/`, `shared/`, or any other `lib/<lang>/**`. APL primitives go in `lib/apl/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
+
+```
+APL source (Unicode glyphs)
+    │
+    ▼
+lib/apl/tokenizer.sx   — glyphs, identifiers, numbers (¯ for negative), strings, strands
+    │
+    ▼
+lib/apl/parser.sx      — right-to-left with valence resolution (mon vs dyadic by position)
+    │
+    ▼
+lib/apl/transpile.sx   — AST → SX AST (entry: apl-eval-ast)
+    │
+    ▼
+lib/apl/runtime.sx     — array model, ~80 primitives, 6 operators, dfns/tradfns
+```
+
+Core mapping:
+- **Array** = SX dict `{:shape (d1 d2 …) :ravel #(v1 v2 …)}`. Scalar is rank-0 (empty shape), vector is rank-1, matrix rank-2, etc. Type uniformity not required (heterogeneous nested arrays via "boxed" elements `⊂x`).
+- **Rank polymorphism** — every scalar primitive is broadcast: `1 2 3 + 4 5 6` ↦ `5 7 9`; `(2 3⍴⍳6) + 1` ↦ broadcast scalar to matrix.
+- **Conformability** = matching shapes, or one-side scalar, or rank-1 cycling (deferred — keep strict in v1).
+- **Valence** = each glyph has a monadic and a dyadic meaning; resolution is purely positional (left-arg present → dyadic).
+- **Operator** = takes one or two function operands, returns a derived function (`f¨` = `each f`, `f/` = `reduce f`, `f∘g` = `compose`, `f⍨` = `commute`).
+- **Tradfn** `∇R←L F R; locals` = named function with explicit header.
+- **Dfn** `{⍺+⍵}` = anonymous, `⍺` = left arg, `⍵` = right arg, `∇` = recurse.
+
+## Roadmap
+
+### Phase 1 — tokenizer + parser
+- [ ] Tokenizer: Unicode glyphs (the full APL set: `+ - × ÷ * ⍟ ⌈ ⌊ | ! ? ○ ~ < ≤ = ≥ > ≠ ∊ ∧ ∨ ⍱ ⍲ , ⍪ ⍴ ⌽ ⊖ ⍉ ↑ ↓ ⊂ ⊃ ⊆ ∪ ∩ ⍳ ⍸ ⌷ ⍋ ⍒ ⊥ ⊤ ⊣ ⊢ ⍎ ⍕ ⍝`), operators (`/ \ ¨ ⍨ ∘ . ⍣ ⍤ ⍥ @`), numbers (`¯` for negative, `1E2`, `1J2` complex deferred), characters (`'a'`, `''` escape), strands (juxtaposition of literals: `1 2 3`), names, comments `⍝ …`
+- [ ] Parser: right-to-left; classify each token as function, operator, value, or name; resolve valence positionally; dfn `{…}` body, tradfn `∇` header, guards `:`, control words `:If :While :For …` (Dyalog-style)
+- [ ] Unit tests in `lib/apl/tests/parse.sx`
+
+### Phase 2 — array model + scalar primitives
+- [ ] Array constructor: `make-array shape ravel`, `scalar v`, `vector v…`, `enclose`/`disclose`
+- [ ] Shape arithmetic: `⍴` (shape), `,` (ravel), `≢` (tally / first-axis-length), `≡` (depth)
+- [ ] Scalar arithmetic primitives broadcast: `+ - × ÷ ⌈ ⌊ * ⍟ | ! ○`
+- [ ] Scalar comparison primitives: `< ≤ = ≥ > ≠`
+- [ ] Scalar logical: `~ ∧ ∨ ⍱ ⍲`
+- [ ] Index generator: `⍳n` (vector 1..n or 0..n-1 depending on `⎕IO`)
+- [ ] `⎕IO` = 1 default (Dyalog convention)
+- [ ] 40+ tests in `lib/apl/tests/scalar.sx`
+
+### Phase 3 — structural primitives + indexing
+- [ ] Reshape `⍴`, ravel `,`, transpose `⍉` (full + dyadic axis spec)
+- [ ] Take `↑`, drop `↓`, rotate `⌽` (last axis), `⊖` (first axis)
+- [ ] Catenate `,` (last axis) and `⍪` (first axis)
+- [ ] Index `⌷` (squad), bracket-indexing `A[I]` (sugar for `⌷`)
+- [ ] Grade-up `⍋`, grade-down `⍒`
+- [ ] Enclose `⊂`, disclose `⊃`, partition (subset deferred)
+- [ ] Membership `∊`, find `⍳` (dyadic), without `~` (dyadic), unique `∪` (deferred to phase 6)
+- [ ] 40+ tests in `lib/apl/tests/structural.sx`
+
+### Phase 4 — operators (THE SHOWCASE)
+- [ ] Reduce `f/` (last axis), `f⌿` (first axis) — including `∧/`, `∨/`, `+/`, `×/`, `⌈/`, `⌊/`
+- [ ] Scan `f\`, `f⍀`
+- [ ] Each `f¨` — applies `f` to each scalar/element
+- [ ] Outer product `∘.f` — `1 2 3 ∘.× 1 2 3` ↦ multiplication table
+- [ ] Inner product `f.g` — `+.×` is matrix multiply
+- [ ] Commute `f⍨` — `f⍨ x` ↔ `x f x`, `x f⍨ y` ↔ `y f x`
+- [ ] Compose `f∘g` — applies `g` first then `f`
+- [ ] Power `f⍣n` — apply f n times; `f⍣≡` until fixed point
+- [ ] Rank `f⍤k` — apply f at sub-rank k
+- [ ] At `@` — selective replace
+- [ ] 40+ tests in `lib/apl/tests/operators.sx`
+
+### Phase 5 — dfns + tradfns + control flow
+- [ ] Dfn `{…}` with `⍺` (left arg, may be absent → niladic/monadic), `⍵` (right arg), `∇` (recurse), guards `cond:expr`, default left arg `⍺←default`
+- [ ] Local assignment via `←` (lexical inside dfn)
+- [ ] Tradfn `∇` header: `R←L F R;l1;l2`, statement-by-statement, branch via `→linenum`
+- [ ] Dyalog control words: `:If/:Else/:EndIf`, `:While/:EndWhile`, `:For X :In V :EndFor`, `:Select/:Case/:EndSelect`, `:Trap`/`:EndTrap`
+- [ ] Niladic / monadic / dyadic dispatch (function valence at definition time)
+- [ ] `lib/apl/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
+
+### Phase 6 — classic programs + drive corpus
+- [ ] Classic programs in `lib/apl/tests/programs/`:
+  - [ ] `life.apl` — Conway's Game of Life as a one-liner using `⊂` `⊖` `⌽` `+/`
+  - [ ] `mandelbrot.apl` — complex iteration with rank-polymorphic `+ × ⌊` (or real-axis subset)
+  - [ ] `primes.apl` — `(2=+⌿0=A∘.|A)/A←⍳N` sieve
+  - [ ] `n-queens.apl` — backtracking via reduce
+  - [ ] `quicksort.apl` — the classic Roger Hui one-liner
+- [ ] System functions: `⎕FMT`, `⎕FR` (float repr), `⎕TS` (timestamp), `⎕IO`, `⎕ML` (migration level — fixed at 1), `⎕←` (print)
+- [ ] Drive corpus to 100+ green
+- [ ] Idiom corpus — `lib/apl/tests/idioms.sx` covering classic Roger Hui / Phil Last idioms
+
+## Progress log
+
+_Newest first._
+
+- _(none yet)_
+
+## Blockers
+
+- _(none yet)_

plans/common-lisp-on-sx.md

@@ -0,0 +1,121 @@
+# Common-Lisp-on-SX: conditions + restarts on delimited continuations
+
+The headline showcase is the **condition system**. Restarts are *resumable* exceptions — every other Lisp implementation reinvents this on host-stack unwind tricks. On SX restarts are textbook delimited continuations: `signal` walks the handler chain; `invoke-restart` resumes the captured continuation at the restart point. Same delcc primitive that powers Erlang actors, expressed as a different surface.
+
+End-state goal: ANSI Common Lisp subset with a working condition/restart system, CLOS multimethods (with `:before`/`:after`/`:around`), the LOOP macro, packages, and ~150 hand-written + classic programs.
+
+## Scope decisions (defaults — override by editing before we spawn)
+
+- **Syntax:** ANSI Common Lisp surface. Read tables, dispatch macros (`#'`, `#(`, `#\`, `#:`, `#x`, `#b`, `#o`, ratios `1/3`).
+- **Conformance:** ANSI X3.226 *as a target*, not bug-for-bug SBCL/CCL. "Reads like CL, runs like CL."
+- **Test corpus:** custom + a curated slice of `ansi-test`. Plus classic programs: condition-system demo, restart-driven debugger, multiple-dispatch geometry, LOOP corpus.
+- **Out of scope:** compilation to native, FFI, sockets, threads, MOP class redefinition, full pathname/logical-pathname machinery, structures with `:include` deep customization.
+- **Packages:** simple — `defpackage`/`in-package`/`export`/`use-package`/`:cl`/`:cl-user`. No nicknames, no shadowing-import edge cases.
+
+## Ground rules
+
+- **Scope:** only touch `lib/common-lisp/**` and `plans/common-lisp-on-sx.md`. Don't edit `spec/`, `hosts/`, `shared/`, or any other `lib/<lang>/**`. CL primitives go in `lib/common-lisp/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
+
+```
+Common Lisp source
+    │
+    ▼
+lib/common-lisp/reader.sx     — tokenizer + reader (read macros, dispatch chars)
+    │
+    ▼
+lib/common-lisp/parser.sx     — AST: forms, declarations, lambda lists
+    │
+    ▼
+lib/common-lisp/transpile.sx  — AST → SX AST (entry: cl-eval-ast)
+    │
+    ▼
+lib/common-lisp/runtime.sx    — special forms, condition system, CLOS, packages, BIFs
+```
+
+Core mapping:
+- **Symbol** = SX symbol with package prefix; package table is a flat dict.
+- **Cons cell** = SX pair via `cons`/`car`/`cdr`; lists native.
+- **Multiple values** = thread through `values`/`multiple-value-bind`; primary-value default for one-context callers.
+- **Block / return-from** = captured continuation; `return-from name v` invokes the block-named `^k`.
+- **Tagbody / go** = each tag is a continuation; `go tag` invokes it.
+- **Unwind-protect** = scope frame with a cleanup thunk fired on any non-local exit.
+- **Conditions / restarts** = layered handler chain on top of `handler-bind` + delcc. `signal` walks handlers; `invoke-restart` resumes a captured continuation.
+- **CLOS** = generic functions are dispatch tables on argument-class lists; method combination computed lazily; `call-next-method` is a continuation.
+- **Macros** = SX macros (sentinel-body) — defmacro lowers directly.
+
+## Roadmap
+
+### Phase 1 — reader + parser
+- [ ] Tokenizer: symbols (with package qualification `pkg:sym` / `pkg::sym`), numbers (int, float, ratio `1/3`, `#xFF`, `#b1010`, `#o17`), strings `"…"` with `\` escapes, characters `#\Space` `#\Newline` `#\a`, comments `;`, block comments `#| … |#`
+- [ ] Reader: list, dotted pair, quote `'`, function `#'`, quasiquote `` ` ``, unquote `,`, splice `,@`, vector `#(…)`, uninterned `#:foo`, nil/t literals
+- [ ] Parser: lambda lists with `&optional` `&rest` `&key` `&aux` `&allow-other-keys`, defaults, supplied-p variables
+- [ ] Unit tests in `lib/common-lisp/tests/read.sx`
+
+### Phase 2 — sequential eval + special forms
+- [ ] `cl-eval-ast`: `quote`, `if`, `progn`, `let`, `let*`, `flet`, `labels`, `setq`, `setf` (subset), `function`, `lambda`, `the`, `locally`, `eval-when`
+- [ ] `block` + `return-from` via captured continuation
+- [ ] `tagbody` + `go` via per-tag continuations
+- [ ] `unwind-protect` cleanup frame
+- [ ] `multiple-value-bind`, `multiple-value-call`, `multiple-value-prog1`, `values`, `nth-value`
+- [ ] `defun`, `defparameter`, `defvar`, `defconstant`, `declaim`, `proclaim` (no-op)
+- [ ] Dynamic variables — `defvar`/`defparameter` produce specials; `let` rebinds via parameterize-style scope
+- [ ] 60+ tests in `lib/common-lisp/tests/eval.sx`
+
+### Phase 3 — conditions + restarts (THE SHOWCASE)
+- [ ] `define-condition` — class hierarchy rooted at `condition`/`error`/`warning`/`simple-error`/`simple-warning`/`type-error`/`arithmetic-error`/`division-by-zero`
+- [ ] `signal`, `error`, `cerror`, `warn` — all walk the handler chain
+- [ ] `handler-bind` — non-unwinding handlers, may decline by returning normally
+- [ ] `handler-case` — unwinding handlers (delcc abort)
+- [ ] `restart-case`, `with-simple-restart`, `restart-bind`
+- [ ] `find-restart`, `invoke-restart`, `invoke-restart-interactively`, `compute-restarts`
+- [ ] `with-condition-restarts` — associate restarts with a specific condition
+- [ ] `*break-on-signals*`, `*debugger-hook*` (basic)
+- [ ] Classic programs in `lib/common-lisp/tests/programs/`:
+  - [ ] `restart-demo.lisp` — division with `:use-zero` and `:retry` restarts
+  - [ ] `parse-recover.lisp` — parser with skipped-token restart
+  - [ ] `interactive-debugger.lisp` — ASCII REPL using `:debugger-hook`
+- [ ] `lib/common-lisp/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
+
+### Phase 4 — CLOS
+- [ ] `defclass` with `:initarg`/`:initform`/`:accessor`/`:reader`/`:writer`/`:allocation`
+- [ ] `make-instance`, `slot-value`, `(setf slot-value)`, `with-slots`, `with-accessors`
+- [ ] `defgeneric` with `:method-combination` (standard, plus `+`, `and`, `or`)
+- [ ] `defmethod` with `:before` / `:after` / `:around` qualifiers
+- [ ] `call-next-method` (continuation), `next-method-p`
+- [ ] `class-of`, `find-class`, `slot-boundp`, `change-class` (basic)
+- [ ] Multiple dispatch — method specificity by argument-class precedence list
+- [ ] Built-in classes registered for tagged values (`integer`, `float`, `string`, `symbol`, `cons`, `null`, `t`)
+- [ ] Classic programs:
+  - [ ] `geometry.lisp` — `intersect` generic dispatching on (point line), (line line), (line plane)…
+  - [ ] `mop-trace.lisp` — `:before` + `:after` printing call trace
+
+### Phase 5 — macros + LOOP + reader macros
+- [ ] `defmacro`, `macrolet`, `symbol-macrolet`, `macroexpand-1`, `macroexpand`
+- [ ] `gensym`, `gentemp`
+- [ ] `set-macro-character`, `set-dispatch-macro-character`, `get-macro-character`
+- [ ] **The LOOP macro** — iteration drivers (`for … in/across/from/upto/downto/by`, `while`, `until`, `repeat`), accumulators (`collect`, `append`, `nconc`, `count`, `sum`, `maximize`, `minimize`), conditional clauses (`if`/`when`/`unless`/`else`), termination (`finally`/`thereis`/`always`/`never`), `named` blocks
+- [ ] LOOP test corpus: 30+ tests covering all clause types
+
+### Phase 6 — packages + stdlib drive
+- [ ] `defpackage`, `in-package`, `export`, `use-package`, `import`, `find-package`
+- [ ] Package qualification at the reader level — `cl:car`, `mypkg::internal`
+- [ ] `:common-lisp` (`:cl`) and `:common-lisp-user` (`:cl-user`) packages
+- [ ] Sequence functions — `mapcar`, `mapc`, `mapcan`, `reduce`, `find`, `find-if`, `position`, `count`, `every`, `some`, `notany`, `notevery`, `remove`, `remove-if`, `subst`
+- [ ] List ops — `assoc`, `getf`, `nth`, `last`, `butlast`, `nthcdr`, `tailp`, `ldiff`
+- [ ] String ops — `string=`, `string-upcase`, `string-downcase`, `subseq`, `concatenate`
+- [ ] FORMAT — basic directives `~A`, `~S`, `~D`, `~F`, `~%`, `~&`, `~T`, `~{...~}` (iteration), `~[...~]` (conditional), `~^` (escape), `~P` (plural)
+- [ ] Drive corpus to 200+ green
+
+## Progress log
+
+_Newest first._
+
+- _(none yet)_
+
+## Blockers
+
+- _(none yet)_

plans/designs/sx-adt.md

@@ -0,0 +1,257 @@
+# SX Algebraic Data Types — Design
+
+## Motivation
+
+Every language implementation currently uses `{:tag "..." :field ...}` tagged dicts to
+simulate sum types. This is verbose, error-prone (typos in tag strings go undetected), and
+produces no exhaustiveness warnings. Native ADTs eliminate the pattern everywhere.
+
+Examples of current workarounds:
+- Haskell `Maybe a` → `{:tag "Just" :value x}` / `{:tag "Nothing"}`
+- Prolog terms → `{:tag "functor" :name "foo" :args (list x y)}`
+- Lua result type → `{:tag "ok" :value v}` / `{:tag "err" :msg s}`
+- Common Lisp `cons` pairs → `{:tag "cons" :car a :cdr b}`
+
+---
+
+## Syntax
+
+### `define-type`
+
+```lisp
+(define-type Name
+  (Ctor1 field1 field2 ...)
+  (Ctor2 field1 ...)
+  ...)
+```
+
+Creates:
+- Constructor functions: `Ctor1`, `Ctor2`, … (callable like normal functions)
+- Type predicate: `Name?` — returns true for any value of type `Name`
+- Constructor predicates: `Ctor1?`, `Ctor2?`, … (optional, auto-generated)
+- Field accessors: `Ctor1-field1`, `Ctor1-field2`, … (optional, auto-generated)
+
+Examples:
+
+```lisp
+(define-type Maybe
+  (Just value)
+  (Nothing))
+
+(define-type Result
+  (Ok value)
+  (Err message))
+
+(define-type Tree
+  (Leaf)
+  (Node left value right))
+
+(define-type List-of
+  (Nil-of)
+  (Cons-of head tail))
+```
+
+Constructors with no fields are zero-argument constructors (singletons by value):
+
+```lisp
+(Nothing)     ; => #<Nothing>
+(Leaf)        ; => #<Leaf>
+```
+
+### `match`
+
+```lisp
+(match expr
+  ((Ctor1 a b) body)
+  ((Ctor2 x)   body)
+  ((Ctor3)     body)
+  (else        body))
+```
+
+- Clauses are tried in order; first match wins.
+- `else` clause is optional but suppresses exhaustiveness warnings.
+- Pattern variables (`a`, `b`, `x`) are bound in the body scope.
+- Wildcard `_` discards the matched value.
+- Literal patterns: `42`, `"str"`, `true`, `nil` — match by value equality.
+- Nested patterns: `((Node left (Leaf) right) body)` — nested constructor patterns.
+
+Examples:
+
+```lisp
+(match result
+  ((Ok v)  (str "got: " v))
+  ((Err m) (str "error: " m)))
+
+(match tree
+  ((Leaf)        0)
+  ((Node l v r)  (+ 1 (tree-depth l) (tree-depth r))))
+```
+
+---
+
+## CEK Dispatch
+
+### Runtime representation
+
+ADT values are OCaml records (not dicts) — opaque, non-inspectable via `get`:
+
+```ocaml
+type adt_value = {
+  av_type  : string;   (* type name, e.g. "Maybe" *)
+  av_ctor  : string;   (* constructor name, e.g. "Just" *)
+  av_fields: value array;  (* positional fields *)
+}
+```
+
+In JS: `{ _adt: true, _type: "Maybe", _ctor: "Just", _fields: [v] }`.
+
+`typeOf` returns the ADT type name (e.g. `"Maybe"`).
+
+### `define-type` — special form
+
+`stepSfDefineType(args, env, kont)`:
+
+1. Parse `Name` and list of `(CtorN field...)` clauses.
+2. For each constructor `CtorK` with fields `[f1, f2, …]`:
+   - Register `CtorK` as a `NativeFn` that takes `|fields|` args and returns an `AdtValue`.
+   - Register `CtorK?` as a predicate (`AdtValue` with matching ctor name → `true`).
+   - Register `CtorK-fN` as field accessor (returns `av_fields[N]`).
+3. Register `Name?` as a predicate (`AdtValue` with matching type name → `true`).
+4. All bindings go into the current environment via `env-bind!`.
+5. Returns `Nil`.
+
+This is an environment mutation — no new frame needed. Evaluates in one step.
+
+### `match` — special form
+
+`stepSfMatch(args, env, kont)`:
+
+1. Push `MatchFrame` with `clauses` and `env` onto kont.
+2. Return state evaluating the scrutinee `expr`.
+3. `MatchFrame` continue: receive scrutinee value, walk clauses:
+   - For each `((CtorN vars...) body)`:
+     - If scrutinee is an `AdtValue` with `av_ctor = "CtorN"` and `av_fields.length = |vars|`:
+       - Bind `vars[i]` → `av_fields[i]` in fresh child env.
+       - Return state evaluating `body` in that env.
+   - `(else body)` — always matches, body evaluated in current env.
+   - Literal `42`/`"str"` patterns: match by value equality.
+   - Wildcard `_`: always matches, binds nothing.
+4. If no clause matched and no `else`: raise `"match: no clause matched <value>"`.
+
+Frame type: `"match"` — stores `cf_remaining` (clauses), `cf_env` (enclosing env).
+
+---
+
+## Interaction with `cond` / `case`
+
+`match` is the primary dispatch form for ADTs. `cond` / `case` remain unchanged:
+
+- `cond` tests arbitrary boolean expressions — still useful for non-ADT dispatch.
+- `case` matches on equality to literal values — unchanged.
+- `match` is the new form: structural pattern matching on ADT constructors.
+
+They are orthogonal. A `match` clause can contain a `cond`; a `cond` clause can contain a `match`.
+
+---
+
+## Exhaustiveness checking
+
+Emit a **warning** (not an error) when:
+- A `match` has no `else` clause, AND
+- Not all constructors of the scrutinee's type are covered.
+
+Detection: when `define-type` runs, it registers the constructor set in a global table
+`_adt_registry: type_name → [ctor_names]`. At `match` compile/evaluation time:
+- If the scrutinee's type is in `_adt_registry` and not all ctors appear as patterns:
+  - `console.warn("[sx] match: non-exhaustive — missing: Ctor3, Ctor4 for type Maybe")`
+  - Execution continues (warning, not error).
+
+This is best-effort: the scrutinee type is only known at runtime. The warning fires on
+first non-exhaustive match evaluation, not at definition time.
+
+---
+
+## Recursive types
+
+Recursive types work because constructors are registered as functions, and function bodies
+are evaluated lazily:
+
+```lisp
+(define-type Tree
+  (Leaf)
+  (Node left value right))
+
+; Recursive function over a recursive type:
+(define (depth tree)
+  (match tree
+    ((Leaf)        0)
+    ((Node l v r)  (+ 1 (max (depth l) (depth r))))))
+```
+
+No special treatment needed — the type definition doesn't need to know about recursion.
+The constructor `Node` accepts any values, including other `Node` or `Leaf` values.
+
+---
+
+## Pattern variables
+
+In `match` clauses, identifiers in constructor position that are NOT constructor names are
+treated as pattern variables (bound to matched field values):
+
+```lisp
+(match x
+  ((Just v)    v)          ; v bound to the wrapped value
+  ((Nothing)   nil))
+
+(match pair
+  ((Cons-of h t)  (list h t)))  ; h, t bound to head and tail
+```
+
+**Wildcard**: `_` is always a wildcard — matches anything, binds nothing.
+
+```lisp
+(match x
+  ((Just _)    "has value")
+  ((Nothing)   "empty"))
+```
+
+**Nested patterns**:
+
+```lisp
+(match tree
+  ((Node (Leaf) v (Leaf))  (str "leaf node: " v))
+  ((Node l v r)             (str "inner node: " v)))
+```
+
+Nested patterns are matched recursively: the inner `(Leaf)` pattern checks that the
+`left` field is itself a `Leaf` ADT value.
+
+---
+
+## Implementation Plan
+
+### Phase 6a — `define-type` + basic `match` (no nested patterns, no exhaustiveness)
+
+1. OCaml: add `AdtValue of adt_value` to `sx_types.ml`.
+2. Evaluator: add `step-sf-define-type` — parse clauses, register ctor fns + predicates + accessors.
+3. Evaluator: add `step-sf-match` + `MatchFrame` — linear scan of clauses, flat patterns only.
+4. JS: same (AdtValue as plain object with `_adt`/`_type`/`_ctor`/`_fields` props).
+
+### Phase 6b — nested patterns (separate fire)
+
+Recursive `matchPattern(pattern, value, env)` helper that:
+- Returns `{matched: bool, bindings: map}` 
+- Recursively matches sub-patterns against ADT fields.
+
+### Phase 6c — exhaustiveness warnings (separate fire)
+
+`_adt_registry` global + warning emission on first non-exhaustive match.
+
+---
+
+## Open questions (deferred to review)
+
+1. **Accessor auto-generation**: should `Ctor-field` accessors be generated always, or only on demand? Risk: name collisions if two types have constructors with same field names.
+2. **Singleton constructors**: `(Nothing)` — zero-arg ctor — should these be interned (same object every call) or fresh each time? Interning enables `eq?` checks but requires a global table.
+3. **Printing/inspect**: `inspect` on an AdtValue should show `(Just 42)` not `#<adt:Just>`. Implement in `inspect` function or via `display`/`write` (Phase 17 ports).
+4. **Pattern-matching on non-ADT values**: should `match` handle list patterns `(a . b)` and literal patterns in clause heads? Deferred — add only if needed by a language implementation.

plans/hs-blockers-drain.md

@@ -0,0 +1,96 @@
+# HS conformance — blockers drain
+
+Goal: take hyperscript conformance from **1277/1496 (85.4%)** to **1496/1496 (100%)** by clearing the blocked clusters and the design-done Bucket E subsystems.
+
+This plan exists because the per-iteration `loops/hs` agent can't fit these into its 30-min budget — they need dedicated multi-commit sit-downs. Track progress here; refer to `plans/hs-conformance-to-100.md` for the canonical cluster ledger.
+
+## Current state (2026-04-25)
+
+- Loop running in `/root/rose-ash-loops/hs` (branch `loops/hs`)
+- sx-tree MCP **fixed** (was a session-stale binary issue — restart of claude in the tmux window picked it up). Loop hinted to retry **#32**, **#29** first.
+- Recent loop progress: ~1 commit/6h — easy wins drained, what's left needs focused attention.
+
+## Remaining work
+
+### Bucket-A/B/C blockers (small, in-place fixes)
+
+| # | Cluster | Tests | Effort | Blocker | Fix sketch |
+|---|---------|------:|--------|---------|------------|
+| **17** | `tell` semantics | +3 | ~1h | Implicit-default-target ambiguity. `bare add .bar` inside `tell X` should target `X` but explicit `to me` must reach the original element. | Add `beingTold` symbol distinct from `me`; bare commands compile to `beingTold-or-me`; explicit `me` always the original. |
+| **22** | window global fn fallback | +2-4 | ~1h | `foo()` where `foo` isn't SX-defined needs to fall back to `(host-global "foo")`. Three attempts failed: guard (host-level error not catchable), `env-has?` (not in HS kernel), `hs-win-call` (NativeFn not callable from CALL). | Add `symbol-bound?` predicate to HS kernel **OR** a host-call-fn primitive with arity-agnostic dispatch. |
+| **29** | `hyperscript:before:init` / `:after:init` / `:parse-error` events | +4-6 | ~30m (post sx-tree fix) | Was sx-tree MCP outage. Now unblocked — loop should retry. 4 of 6 tests need stricter parser error-rejection (out of scope; mark partial). | Edit `integration.sx` to fire DOM events at activation boundaries. |
+
+### Bucket D — medium features
+
+| # | Cluster | Tests | Effort | Status |
+|---|---------|------:|--------|--------|
+| **31** | runtime null-safety error reporting | **+15-18** | **2-4h** | **THIS SESSION'S TARGET.** Plan node fully spec'd: 5 pieces of work. |
+| **32** | MutationObserver mock + `on mutation` | +10-15 | ~2h | Was sx-tree-blocked. Now unblocked — loop hinted to retry. Multi-file: parser, compiler, runtime, runner mock, generator skip-list. |
+| **33** | cookie API | +2 (remaining) | ~30m | Partial done (+3). Remaining 2 need `hs-method-call` runtime fallback for unknown methods + `hs-for-each` recognising host-array/proxy collections. |
+| 34 | event modifier DSL | +6-8 | ~1-2h | `elsewhere`, `every`, count filters (`once`/`twice`/`3 times`/ranges), `from elsewhere`. Pending. |
+| 35 | namespaced `def` | +3 | ~30m | Pending. |
+
+### Bucket E — subsystems (design docs landed, multi-commit each)
+
+Each has a design doc with a step-by-step checklist. These are 1-2 days of focused work each, not loop-fits.
+
+| # | Subsystem | Tests | Design doc | Branch |
+|---|-----------|------:|------------|--------|
+| 36 | WebSocket + `socket` + RPC Proxy | +12-16 | `plans/designs/e36-websocket.md` | `worktree-agent-a9daf73703f520257` |
+| 37 | Tokenizer-as-API | +16-17 | `plans/designs/e37-tokenizer-api.md` | `worktree-agent-a6bb61d59cc0be8b4` |
+| 38 | SourceInfo API | +4 | `plans/designs/e38-sourceinfo.md` | `agent-e38-sourceinfo` |
+| 39 | WebWorker plugin (parser-only stub) | +1 | `plans/designs/e39-webworker.md` | `hs-design-e39-webworker` |
+| 40 | Real Fetch / non-2xx / before-fetch | +7 | `plans/designs/e40-real-fetch.md` | `worktree-agent-a94612a4283eaa5e0` |
+
+### Bucket F — generator translation gaps
+
+~25 tests SKIP'd because `tests/playwright/generate-sx-tests.py` bails with `return None`. Single dedicated generator-repair sit-down once Bucket D is drained. ~half-day.
+
+## Order of attack
+
+In approximate cost-per-test order:
+
+1. **Loop self-heal** (no human work) — wait for #29, #32 to land via the running loop ⏱️ ~next 1-2 hours
+2. **#31 null-safety** — biggest scoped single win, dedicated worktree agent (this session)
+3. **#33 cookie API remainder** — quick partial completion
+4. **#17 / #22 / #34 / #35** — small fiddly fixes, one sit-down each
+5. **Bucket E** — pick one subsystem at a time. **#39 (WebWorker stub) first** — single commit, smallest. Then **#38 (SourceInfo)** — 4 commits. Then the bigger three (#36, #37, #40).
+6. **Bucket F** — generator repair sweep at the end.
+
+Estimated total to 100%: ~10-15 days of focused work, parallelisable across branches.
+
+## Cluster #31 spec (full detail)
+
+The plan note from `hs-conformance-to-100.md`:
+
+> 18 tests in `runtimeErrors`. When accessing `.foo` on nil, emit a structured error with position info. One coordinated fix in the compiler emit paths for property access, function calls, set/put.
+
+**Required pieces:**
+
+1. **Generator-side `eval-hs-error` helper + recognizer** for `expect(await error("HS")).toBe("MSG")` blocks. In `tests/playwright/generate-sx-tests.py`.
+2. **Runtime helpers** in `lib/hyperscript/runtime.sx`:
+   - `hs-null-error!` raising `'<sel>' is null`
+   - `hs-named-target` — wraps a query result with the original selector source
+   - `hs-named-target-list` — same for list results
+3. **Compiler patches at every target-position `(query SEL)` emit** — wrap in named-target carrying the original selector source. ~17 command emit paths in `lib/hyperscript/compiler.sx`:
+   add, remove, hide, show, measure, settle, trigger, send, set, default, increment, decrement, put, toggle, transition, append, take.
+4. **Function-call null-check** at bare `(name)`, `hs-method-call`, and `host-get` chains, deriving the leftmost-uncalled-name (`'x'` / `'x.y'`) from the parse tree.
+5. **Possessive-base null-check** (`set x's y to true` → `'x' is null`).
+
+**Files in scope:**
+- `lib/hyperscript/runtime.sx` (new helpers)
+- `lib/hyperscript/compiler.sx` (~17 emit-path edits)
+- `tests/playwright/generate-sx-tests.py` (test recognizer)
+- `tests/hs-run-filtered.js` (if mock helpers needed)
+- `shared/static/wasm/sx/hs-runtime.sx` + `hs-compiler.sx` (WASM staging copies)
+
+**Approach:** target-named pieces incrementally — runtime helpers first (no compiler change), then compiler emit paths in batches (group similar commands), then function-call/possessive at the end. Each batch is one commit if it lands +N tests; mark partial if it only unlocks part.
+
+**Watch for:** smoke-range regressions (tests flipping pass→fail). Each commit: rerun smoke 0-195 and the `runtimeErrors` suite.
+
+## Notes for future sessions
+
+- `plans/hs-conformance-to-100.md` is the canonical cluster ledger — update it on every commit.
+- `plans/hs-conformance-scoreboard.md` is the live tally — bump `Merged:` and the bucket roll-up.
+- Loop has scope rule "never edit `spec/evaluator.sx` or broader SX kernel" — most fixes here stay in `lib/hyperscript/**`, `tests/`, generator. If a fix needs kernel work, surface to the user; don't merge silently.
+- Cluster #22's `symbol-bound?` predicate would be a kernel addition — that's a real cross-boundary scope expansion.

plans/js-on-sx.md

@@ -65,7 +65,7 @@ Each item: implement → tests → update progress. Mark `[x]` when tests green.
 - [x] Punctuation: `( ) { } [ ] , ; : . ...`
 - [x] Operators: `+ - * / % ** = == === != !== < > <= >= && || ! ?? ?: & | ^ ~ << >> >>> += -= ...`
 - [x] Comments (`//`, `/* */`)
-- [x] Automatic Semicolon Insertion (defer — initially require semicolons)
+- [ ] Automatic Semicolon Insertion (defer — initially require semicolons)
 
 ### Phase 2 — Expression parser (Pratt-style)
 - [x] Literals → AST nodes
@@ -124,8 +124,8 @@ Each item: implement → tests → update progress. Mark `[x]` when tests green.
 - [x] Closures — work via SX `fn` env capture
 - [x] Rest params (`...rest` → `&rest`)
 - [x] Default parameters (desugar to `if (param === undefined) param = default`)
-- [x] `var` hoisting (shallow — collects direct `var` decls, emits `(define name :js-undefined)` before funcdecls)
-- [ ] `let`/`const` TDZ (deferred)
+- [ ] `var` hoisting (deferred — treated as `let` for now)
+- [x] `let`/`const` TDZ — sentinel infrastructure (`__js_tdz_sentinel__`, `js-tdz?`, `js-tdz-check` in runtime.sx)
 
 ### Phase 8 — Objects, prototypes, `this`
 - [x] Property descriptors (simplified — plain-dict `__proto__` chain, `js-set-prop` mutates)
@@ -158,272 +158,6 @@ Each item: implement → tests → update progress. Mark `[x]` when tests green.
 
 Append-only record of completed iterations. Loop writes one line per iteration: date, what was done, test count delta.
 
-- 2026-05-10 — **`String.prototype.repeat` no longer arity-collides with itself; raises RangeError on negative or +Infinity counts.** Earlier JSON.stringify iteration introduced a 2-arg `js-string-repeat` that shadowed the existing 3-arg `(s n acc)` accumulator implementation, breaking every `s.repeat(n)` call with "expects 2 args, got 3". Renamed the accumulator helper to `js-string-repeat-loop` and made `js-string-repeat` a 2-arg facade that delegates. Hooked the repeat method to raise RangeError when `count < 0` or `count = Infinity` per spec. Result: built-ins/String/prototype/repeat 7/13 → 11/13 (+4). conformance.sh: 148/148.
-
-- 2026-05-10 — **test262-runner inlines small upstream harness includes (`nans.js`, `sta.js`, `byteConversionValues.js`, `compareArray.js`) per-test.** The runner parsed `includes:` frontmatter but never used it, so tests like `built-ins/isNaN/return-true-nan.js` (which depends on `var NaNs = [...]`) failed with "ReferenceError: undefined symbol". Added `_load_harness_include` (cached) and `assemble_source` now prepends each allowlisted include's source to the test. Allowlist excludes large helpers like `propertyHelper.js` because per-test js-eval+JIT cost on a 371-line harness pushes tests over the 15s per-test timeout (regressed Math/abs 7/7 → 4/7 in a first-pass attempt before allowlisting). Result: built-ins/isNaN 2/7 → 3/7. conformance.sh: 148/148.
-
-- 2026-05-10 — **Real `Date.prototype.setFullYear/setMonth/setDate/setHours/setMinutes/setSeconds/setMilliseconds` (+ UTC variants) and a corrected `setTime`.** All Date setters were missing — only `setTime` existed and didn't validate. Added a unified `js-date-setter(d, field, args)` that decomposes the current ms into `(y mo da hh mm ss msv)` via `js-date-decompose`, splices in the `args` per the field's optional-arg contract (e.g. `setHours(h, m?, s?, ms?)`), recomposes via `js-date-civil-to-days`, and TimeClips at ±8.64e15. NaN args anywhere → ms set to NaN. Wired all 14 setters to the helper. Hit a parser gotcha: SX `cond` clause body is single-form only — multi-expression bodies like `(else (dict-set! ...) new-ms)` silently treat the second form as `(<first-result> new-ms)` ("Not callable: false"). Wrapped these in `(begin ...)`. Result: setFullYear 5/18 → 13/18 (+8). setHours 5/21 → 15/21 (+10). setMonth 3/15 → 9/15 (+6). setMinutes 4/16 → 10/16 (+6). setSeconds 3/15 → 9/15 (+6). setDate 2/12 → 6/12 (+4). setMilliseconds 2/12 → 6/12 (+4). setTime 4/9 → 6/9 (+2). conformance.sh: 148/148.
-
-- 2026-05-10 — **`Object.assign` keys now visible to `Object.keys` / `JSON.stringify`.** `Object.assign({}, {a:1})` was mutating the target via `dict-set!` which bypasses our `__js_order__` insertion-order side table; `Object.keys(t)` (which iterates `__js_order__` when present) returned `[]`, and `JSON.stringify` saw nothing. Switched `js-object-assign` to use `js-set-prop` (which calls `js-obj-order-add!` on new keys) for both dict and string sources. Result: built-ins/Object/assign 13/25 → 14/25. conformance.sh: 148/148.
-
-- 2026-05-10 — **User functions' `prototype` chain through Object.prototype + auto-set `constructor`.** Per ES spec, every function's `prototype` slot defaults to `{ constructor: F, __proto__: Object.prototype }`. Our `js-get-ctor-proto` lazily created a fresh empty `(dict)` for user functions on first access — so `(new F) instanceof Object` was `false`, `F.prototype.constructor` was undefined, and `x.constructor === F` failed. Now the lazy-init seeds the proto with `__proto__ → Object.prototype` and `constructor → F` before caching in `__js_proto_table__`. Result: language/expressions/instanceof 25/30 → 26/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **Postfix `++`/`--` reject a preceding LineTerminator (ASI).** Per ES spec, `x\n++;` is a syntax error: no LineTerminator allowed between LHS and postfix `++`/`--`. Our `jp-parse-postfix` was matching `++`/`--` regardless of whether the preceding token had `:nl true`. Added `(not (jp-token-nl? st))` guard so newline-before-`++` makes the postfix arm fall through, the `++` then becomes a prefix-expr starting a new statement, which fails to parse and the runner classifies as SyntaxError. Result: language/expressions/postfix-increment 16/30 → 18/30 (+2). postfix-decrement 16/30 → 18/30 (+2). conformance.sh: 148/148.
-
-- 2026-05-10 — **Parse-time SyntaxError when `let`/`const`/`function`/`class` appear as a single-statement body of `if`/`while`/`do`/`for`/labeled.** Per ES grammar, those positions accept a Statement, not a Declaration — only block bodies (`{ ... }`) may contain Declarations. Added `jp-disallow-decl-stmt!` helper that, when the next token is a Declaration keyword in single-statement context, raises SyntaxError. The `let` arm checks for `let <ident>`, `let [`, or `let {` to avoid mis-rejecting `let;` (where `let` is just an identifier expression). Hook calls in `jp-parse-if-stmt` (then + else branches), `jp-parse-while-stmt`, `jp-parse-do-while-stmt`, both for-of/in and C-for body sites, and the labeled-statement entry. Result: language/statements/while 16/30 → 20/30. statements/labeled 4/15 → 7/15. statements/if 20/30 → 21/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **Parse-time SyntaxError for `break`/`continue` outside loops/switches and `return` outside functions; `void <expr>` evaluates `<expr>` for side effects.** Parser tracks `:loop-depth`, `:switch-depth`, and `:fn-depth` on the state dict (initialized to 0). `jp-parse-while-stmt`, `jp-parse-do-while-stmt`, `jp-parse-for-stmt` (both for-of/in and C-for) bump `:loop-depth` around body parsing; `jp-parse-switch-stmt` bumps `:switch-depth`; new `jp-parse-fn-body` and `jp-parse-arrow-body` save+reset loop/switch depth and bump `:fn-depth` (so `break` inside an outer loop's nested function is rejected). Bare `break` requires `loop-depth > 0 OR switch-depth > 0`; bare `continue` requires `loop-depth > 0`; `return` requires `fn-depth > 0`. Separately, `void <expr>` was compiling to just `:js-undefined` (dropping the expression entirely); now `(begin <expr> :js-undefined)` so side effects fire. Result: language/statements/return 4/15 → 14/15 (+10). statements/break 9/20 → 12/20. statements/continue 12/24 → 15/24. expressions/void 7/9 → 8/9. conformance.sh: 148/148.
-
-- 2026-05-10 — **`Math.hypot` and `Math.cbrt` honour spec edges for NaN, ±Infinity, and ±0.** `Math.hypot(NaN, Infinity)` was returning NaN instead of +Infinity (spec: any ±Infinity arg dominates NaN). Rewrote `js-math-hypot` to scan args once tracking inf/nan flags, return +Infinity if any arg is ±Infinity, else NaN if any was NaN, else `sqrt(sum of squares)`. `Math.cbrt(NaN)` was 0 (because `pow(NaN, 1/3)` produced 0 in our path); also `Math.cbrt(-0)` returned +0 instead of -0. Added explicit short-circuits: NaN→NaN, ±Infinity→arg, ±0→arg, plus changed `(/ 1 3)` (rational) to `(/ 1.0 3.0)` (inexact) to avoid rational fractional-power oddities. Result: built-ins/Math/hypot 9/11 → 10/11. Math/cbrt 3/4 → 4/4. conformance.sh: 148/148.
-
-- 2026-05-10 — **`globalThis.globalThis === globalThis`; `Number.prototype.toFixed` honours digit-range and ≥1e21 fallback.** (1) `globalThis` was bound to `nil` in the global object literal (originally to dodge an inspect-cycle hang) — added `(dict-set! js-global "globalThis" js-global)` after the literal so `globalThis.globalThis === globalThis` per spec. (2) `Number.prototype.toFixed` rewrites: RangeError when fractionDigits is NaN or outside `[0,100]` (was silently producing garbage), and for `|x| >= 1e21` returns `js-number-to-string` (the value's own ToString) per spec step 9. conformance.sh: 148/148.
-
-- 2026-05-10 — **`delete <ident>` returns `false` instead of `true` per non-strict spec.** ES non-strict semantics: `delete x` where `x` is a declared binding (variable / function / parameter) returns `false` and does not unbind. Our transpiler was emitting `true` for any `delete <expr>` whose argument wasn't a member or index access. Now `delete <js-ident>` → `false`, and `delete <js-paren expr>` recurses on the inner expression so `delete (1+2)` still works. Result: language/expressions/delete 14/30 → 18/30 (+4). conformance.sh: 148/148.
-
-- 2026-05-10 — **Parser rejects unary-op directly before `**` (e.g. `-1 ** 2`, `delete o.p ** 2`, `!x ** 2`, `~x ** 2`) per ES spec.** ES disallows `UnaryExpression ** ExponentiationExpression`; only `UpdateExpression ** ExponentiationExpression` and `(<UnaryExpr>) ** ...` are legal. Added a guard in `jp-binary-loop`: when op is `**` and the LHS is a `(js-unop ...)` node, raise SyntaxError. Parens are made transparent for everything except this check via a new `jp-paren-wrap` helper that emits `(js-paren <unop>)` only when wrapping an explicit unary op (so `(-1) ** 2` parses fine), and a new `js-paren` AST tag in `js-transpile` that just unwraps. Result: language/expressions/exponentiation 25/30 → 28/30 (+3). conformance.sh: 148/148.
-
-- 2026-05-10 — **`Math.round` / `Math.max` / `Math.min` honour spec edge cases for NaN, ±Infinity, and ±0.** `Math.round(NaN)` was returning 0 because `floor(NaN+0.5)` doesn't propagate NaN; ditto `±Infinity` paths. `Math.max({})` silently returned `-Infinity` (initial accumulator) because the first arg wasn't ToNumber'd. `Math.max(0, -0)` returned `-0` because `>` doesn't distinguish them. Rewrites: round NaN/±Infinity/±0 short-circuits; max/min ToNumber the first arg, propagate NaN immediately, and use a `js-is-positive-zero?` (rational-safe) tiebreaker so `Math.max(0, -0) === 0` per spec. Result: built-ins/Math/round 5/10 → 8/10 (+3). Math/max 6/9 → 8/9 (+2). Math/min 6/9 → 8/9 (+2). conformance.sh: 148/148.
-
-- 2026-05-10 — **`Map.prototype.*` and `Set.prototype.*` raise TypeError when called on non-Map / non-Set `this`.** All five `js-map-do-*` and four `js-set-do-*` helpers were assuming `this` had `__map_keys__` / `__set_items__`, so `Map.prototype.clear.call({})` silently returned undefined (after creating dangling state) instead of throwing. Added `js-map-check!` / `js-set-check!` guards run as the first step of each method; raise spec-correct `TypeError` instances. Result: built-ins/Map 18/30 → 22/30 (+4). built-ins/Set 15/30 → 28/30 (+13). conformance.sh: 148/148.
-
-- 2026-05-10 — **`Date.UTC` / `new Date(...)` propagate NaN/±Infinity arguments and return NaN.** `Date.UTC()` (no args) returned 0 instead of NaN; `Date.UTC(NaN, ...)` did the math and produced bogus ms; `new Date(year, NaN)` constructed a normal Date instead of an invalid one. Added `js-date-args-have-nan?` (also detects ±Infinity and propagates from rationals) used by both `Date.UTC` and the multi-arg constructor branch; UTC now returns NaN on no-arg / any-NaN-arg / out-of-range result, and `new Date(args)` stores NaN in `__date_value__` when any arg is NaN. Also fixed `js-date-from-one(undefined)` to return NaN. Result: built-ins/Date/UTC 6/16 → 10/16 (+4). Date 17/30 → 26/30 (timeouts dropped from 12 → 4 because invalid Dates now short-circuit). conformance.sh: 148/148.
-
-- 2026-05-10 — **Real `Date` construction + getters via Howard-Hinnant civil-day arithmetic.** `js-date-from-parts` now computes a true ms-since-epoch from `(year, month, day, hour, min, sec, ms)` via `js-date-civil-to-days` (the inverse of last iteration's `days-to-ymd`), with the legacy 2-digit-year coercion (0..99 → 1900+y). `getFullYear/Month/Date/Day/Hours/Minutes/Seconds/Milliseconds` (UTC + non-UTC) all share a new `js-date-getter`: TypeErrors on non-Date this, returns NaN on invalid time, otherwise decomposes ms into y/m/d/h/m/s/ms/dow. Plus added `Date.prototype.constructor = Date` (was missing). Result: each of the 8 Date getter categories went 2/6 → 5/6 (+3 each, +24 total). Date toISOString 11/16 → 13/16. Some Date construction-loop tests now exceed the 15s per-test timeout — the new civil math is heavier than the old (year-1970)*ms-per-year approximation, but correctness wins. conformance.sh: 148/148.
-
-- 2026-05-10 — **`Date.prototype.toISOString` produces real `YYYY-MM-DDTHH:mm:ss.sssZ` and validates input.** Old `js-date-iso` only computed the year and hardcoded the rest as `01-01T00:00:00.000Z`. Added: (1) TypeError when this isn't a Date (no `__js_is_date__` slot); (2) RangeError when ms is NaN, undefined, or |ms| > 8.64e15; (3) full date breakdown via Howard-Hinnant `days_to_civil` algorithm (`js-date-days-to-ymd`) → year/month/day, plus modular hours/min/sec/ms; (4) extended-year format `±YYYYYY` for years outside 0..9999. Result: built-ins/Date/prototype/toISOString 7/16 → 11/16 (+4). Date 21/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **`JSON.stringify` honours `replacer` (function + array forms), `space`, and `toJSON`.** Previous impl ignored the second/third arguments entirely and never called `toJSON`. Rewrote around a `js-json-serialize-property(key, holder, rep-fn, rep-keys, gap, indent)` core: walks `toJSON` first, then replacer-fn (with `holder` as `this`); arrays-as-replacer become a property-name allowlist; numeric `space` clamped to 0..10 spaces, string `space` truncated to 10 chars, non-empty gap activates indented output with `:` → `: ` separator. Number wrapper / String wrapper / Boolean wrapper unwrap before serialization; non-finite numbers serialize as `"null"`; functions serialize as `undefined`. Result: built-ins/JSON/stringify 6/30 → 14/30 (+8). conformance.sh: 148/148.
-
-- 2026-05-10 — **`JSON.parse` raises spec-correct `SyntaxError` instances and rejects malformed input.** Previously `JSON.parse("12 34")` silently returned `12` (no trailing-content check), `JSON.parse('""')` accepted control chars in strings, an unterminated string read off the end, and the inner `(error "JSON: ...")` calls produced generic Errors not `instanceof SyntaxError`. Added: (1) post-value whitespace skip + trailing-content check in `js-json-parse`; (2) control-char rejection (code < 0x20) and unterminated-string check in `js-json-parse-string-loop`; (3) all internal "JSON: ..." errors now `(raise (js-new-call SyntaxError ...))`. Result: built-ins/JSON/parse 7/30 → 25/30 (+18). JSON 26/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **`arguments` object inside functions is now a mutable list.** `js-arguments-build-form` produced `(cons p1 (cons p2 __extra_args__))` which yielded a structurally-shared (immutable) list — `arguments[1] = 7; arguments[1]++` raised "set-nth!: list is immutable". Wrapping the build in `js-list-copy` so each function entry constructs a fresh mutable list. Existing reads (`arguments.length`, `arguments[i]`) unaffected. Result: language/expressions/postfix-increment 14/30 → 15/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **`String.prototype.split(undefined)` returns `[wholeString]`; function-expression bodies have spec-correct implicit `undefined` return.** (1) `js-string-method "split"` was calling `js-to-string` on the separator unconditionally, so `"undefinedd".split(undefined)` produced `["", "d"]` (split by `"undefined"`); also `limit=0` returned the whole-string list instead of `[]`. New arms: `undefined` separator → `[s]`, `limit=0` → `[]`, otherwise existing string-split. (2) Function expressions wrapped the body in `(call/cc (fn (__return__) (begin <stmts>)))` and used the begin's last expression as the implicit return value. So `function F(){ this.x = function(){return 99} }` returned the inner lambda (because `js-set-prop` returns the rhs), and `new F()` saw a callable return and replaced the freshly-allocated `this` with it — so `i.x` was missing. Append `nil` to the begin so the implicit completion is always `:js-undefined`; explicit `return` still works via call/cc as before. Result: built-ins/String/prototype/split 8/30 → 10/30. Constructors with function-valued `this.X` now keep their assignments. conformance.sh: 148/148.
-
-- 2026-05-10 — **Number/Boolean primitive method dispatch falls back to `Number.prototype` / `Boolean.prototype`.** When a user assigned a String method onto `Number.prototype` (e.g. `Number.prototype.toUpperCase = String.prototype.toUpperCase; NaN.toUpperCase()`), `js-invoke-number-method` rejected the unknown key with "is not a function (on number)" — it never walked the prototype. Added a fallback in both `js-invoke-number-method` and `js-invoke-boolean-method`: on unknown keys, `js-dict-get-walk` the constructor prototype; if found, `js-call-with-this` it. Result: built-ins/String/prototype/toUpperCase 16/25 → 19/25 (+3). Boolean 29/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **`String.prototype.*` ToString-coerces non-string/non-undef this; `.call` / `.apply` skip global-coercion for built-in callables.** `String.prototype.trim.call(false)` was returning `"[object Object]"` because (a) `.call`/`.apply` blanket-coerced null/undefined `thisArg` to `js-global-this`, swallowing the original null, and (b) `js-string-proto-fn` fell back to `"[object Object]"` for any non-string this. (1) `js-string-proto-fn` now ToString-coerces primitive thisVal and raises TypeError for null/undefined (matches `RequireObjectCoercible` semantics for built-in String methods). (2) New `js-call-this-coerce` helper applies the legacy `js-coerce-this-arg` only when `recv` is a user lambda/component; built-in dict-with-`__callable__` methods get the raw `thisArg` (so they can see and reject null/undefined themselves, or accept primitive thisArgs without ToObject). Result: built-ins/String/prototype/trim 7/30 → 30/30 (+23). Function/prototype/apply 10/30 → 21/30. expressions/array 21/30 → 22/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **`**` / `Math.pow` honour JS spec edge cases for NaN, ±0, abs(base)=1+Infinity, plus `Number.prototype.valueOf` accepts ignored args.** (1) New `js-pow-spec` shared by `js-pow` (operator) and `js-math-pow`: NaN exponent → NaN, exponent 0 → 1 (even with NaN base), NaN base + non-zero exp → NaN, abs(base)=1 with exp=±Infinity → NaN. Underlying `pow` handles the rest. (2) Number.prototype.valueOf was `(fn () ...)` and rejected the spec-allowed extra arg with "lambda expects 0 args, got 1"; now `(fn (&rest args) ...)`. Result: language/expressions/exponentiation 23/30 → 25/30 (+2). built-ins/Math/pow 27/27 holds. conformance.sh: 148/148.
-
-- 2026-05-10 — **`Number.prototype.toString(radix)` no longer crashes on rational division-by-zero.** `js-num-to-str-radix` was probing for ±Infinity by comparing against `(/ 1 0)` / `(/ -1 0)` — but on the rational arithmetic path that throws "rational: division by zero" before the comparison ever happens, so every `Number(x).toString(radix)` call exploded. Replaced the probes with `(js-infinity-value)` / `(- 0 (js-infinity-value))` and the NaN check with `js-number-is-nan`. Result: built-ins/Number/prototype/toString 0/30 → 29/30 (+29). Number 26/30. conformance.sh: 148/148.
-
-- 2026-05-10 — **Array literal elision (holes), `list instanceof Array`, `array.toString` identity.** Three coupled fixes for `language/expressions/array`. (1) Parser: `jp-array-loop` accepts a leading or interior `,` as elision and pushes `(js-undef)`, so `[,]`, `[,,3,,,]`, `[1,,3]` parse and produce length 1, 5, 3. (2) Runtime: `js-instanceof` adds a `(list? obj)` arm that returns true when the right-hand side is `Array` (or `Object`). (3) Runtime: `js-get-prop` for `key="toString"` on a list returns the actual `Array.prototype.toString` slot via `js-dict-get-walk` instead of a fresh `js-array-method` callable, so `[1,2,3].toString === Array.prototype.toString`. `toLocaleString` left on the legacy arm — its proto entry is a dict-with-`__callable__` whose body re-enters `js-invoke-method`, which would loop. Result: language/expressions/array 13/30 → 21/30 (+8). conformance.sh: 148/148.
-
-- 2026-05-10 — **`Object.getOwnPropertyDescriptor` skips internal `__proto__` and `__js_order__` keys.** Was returning a regular property descriptor for our internal `__proto__` and `__js_order__` markers — `Object.getOwnPropertyDescriptor({__proto__: null}, "__proto__")` returned `{configurable, enumerable, value: null, writable}` instead of `undefined` per spec. Added a `(js-key-internal? sk)` short-circuit in the descriptor path that returns `:js-undefined` for internal keys. Result: language/expressions/object 13/30 → 16/30. Object 30/30 holds, getOwnPropertyDescriptor 28/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **Object literal spread `{...src}` parses + executes.** Per ES spec, object literals can include `...expr` to copy own enumerable properties from a source. `jp-parse-object-entry` was rejecting the leading `...` punct. Added a parser branch that records the AST under `:spread`. `js-transpile-object` emits `(js-obj-spread! _obj <src-expr>)` for spread entries, alongside the existing `(js-obj-set! _obj k v)` for regular entries. New `js-obj-spread!` runtime helper: dict source copies own enumerable keys (skipping internal `__js_order__` / `__proto__`); string source copies each character at its numeric index; list source copies elements at their numeric index; null/undefined no-op. Result: language/expressions/array 5/30 → 13/30 (+8). Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Object.getOwnPropertyNames` throws on null/undefined and includes `"length"` for strings/arrays.** Was returning `(list)` for non-list/non-dict inputs; per spec it ToObject's the argument and returns own keys including the implicit `"length"` property for strings/arrays. Added explicit branches: null/undefined → TypeError, string → `["0","1",…,"n-1","length"]` via `js-string-keys-loop` then append, list → indices + `"length"`, dict → existing ordered path. Result: built-ins/Object/getOwnPropertyNames 19/30 → 20/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Object.values`/`entries` throw on null/undefined and walk strings.** Same shape as the previous `Object.keys` fix. Both methods returned `(list)` for non-dict input; per spec they ToObject the argument and yield the property values / `[k, v]` pairs. Added explicit branches: null/undefined → TypeError, string → walk character indices, dict → iterate own enumerable keys (skipping internal `__js_order__` / `__proto__`). Result: built-ins/Object/values 5/16 → 8/16, entries 5/17 → 9/17. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Object.keys` throws TypeError on null/undefined and walks indices on strings/arrays.** Was returning `(list)` for non-dict input — `Object.keys(null)` silently returned `[]` instead of throwing per spec, and `Object.keys("abc")` returned `[]` instead of `["0","1","2"]`. Added explicit branches: null/undefined → TypeError, string/list → `["0","1",..."n-1"]` via `js-string-keys-loop`. Result: built-ins/Object/keys 19/30 → 22/30. Object 30/30, Map 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Object.assign` ToObject's target, throws TypeError on null/undefined, copies own enumerable props from string sources.** Was returning the raw target unchanged when given a primitive (`Object.assign("a")` returned the string `"a"`), and silently no-op'd on null/undefined target instead of throwing per spec. Now coerces target via `js-coerce-this-arg` (boxes primitives), guards null/undefined with TypeError, and walks each source: dict → copy own keys (skipping internal `__js_order__` / `__proto__`), string → copy each character at numeric index, null/undefined → skip. Now `Object.assign("a")` returns a String wrapper whose `valueOf()` is `"a"`, and `Object.assign(null)` throws TypeError. Result: built-ins/Object/assign 5/25 → 13/25 (+8). Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Number.prototype.toFixed`/`toString`/etc. unwrap Number wrappers and throw TypeError on non-Number receivers.** Was passing `(js-this)` straight through to `js-number-to-fixed`, so calling `Number.prototype.toFixed(1)` directly on `Number.prototype` (a Number wrapper dict) raised `"Expected number, got dict"`. Per spec, these methods must extract the Number primitive value (from primitive or wrapper) and throw TypeError otherwise. Added `js-number-this-val` helper that handles primitive number, rational, `__js_number_value__`-marked wrapper, and raises TypeError for everything else. Routed all six Number.prototype methods through it. Result: built-ins/Number/prototype/toFixed 5/13 → 7/13. Number 26/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Array.prototype` methods carry spec lengths and names.** Continuation of the same fix. `js-array-proto-fn` was returning bare lambdas → `Array.prototype.push.length === 0` instead of `1`. Added `js-array-proto-fn-length` (lookup table for the ~30 method names — `push:1`, `slice:2`, `splice:2`, `concat:1`, `forEach:1`, `every:1`, `flat:0`, etc.) and changed the helper to return the dict-with-`__callable__` form. Now `Array.prototype.push.length === 1`, `Array.prototype.slice.length === 2`. Array 27/50, Array.prototype 8/30, Object 30/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Number.prototype` and `String.prototype` methods carry spec lengths and names.** Same shape as the earlier Function.prototype fix. Number.prototype.{toFixed/toExponential/toPrecision/toString/valueOf/toLocaleString} were bare `(fn ...)` lambdas → length 0 → tests assert e.g. `Number.prototype.toExponential.length === 1`. Wrapped each in a dict-with-`__callable__` with `:length` and `:name`. For String.prototype, `js-string-proto-fn` was a single helper applied to ~30 method names; added `js-string-proto-fn-length` (lookup table for spec-defined lengths: `concat:1`, `indexOf:1`, `slice:2`, `substring:2`, `replace:2`, etc.) and changed the helper to return the dict form, so all string methods now report correctly. Result: built-ins/Number/prototype 18/30 → 20/30, String/prototype 18/30 → 21/30. Number 26/30 holds, String 29/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Boolean.prototype.toString`/`valueOf` throw TypeError on non-Boolean receivers.** Per spec, both methods are not generic — calling them with a `this` that isn't a Boolean primitive or wrapper must throw TypeError. Was silently returning `"true"`/`"false"` based on whether the receiver was truthy (`s1.toString = Boolean.prototype.toString; s1.toString()` returned `"true"` for any non-empty string instead of throwing). Added an `else (raise (js-new-call TypeError ...))` branch to both prototype methods. Result: built-ins/Boolean 28/30 → 29/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Array.prototype.reduce`/`reduceRight` callback receives `(acc, cur, idx, array)`.** Was calling `(f acc cur)` — only two args, no index, no source array. Per spec the reducer signature is `(accumulator, currentValue, currentIndex, array)`. Updated `js-list-reduce-loop` and `js-list-reduce-right-loop` to call via `js-call-with-this js-undefined f (list acc cur i arr)`. Result: built-ins/Array/prototype/reduce 6/30 → 8/30, reduceRight 6/30 → 8/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Array.prototype.find`/`findIndex`/`some`/`every` honour `thisArg` and pass `(value, index, array)`.** Same shape as the previous `forEach`/`map`/`filter` fix — these were calling `(f x)` directly. Updated each prototype method to extract optional `thisArg` (defaulting to globalThis when null/undefined) and route through `js-call-with-this` with the full `(value, index, array)` triple. Updated `js-list-find-loop` / `js-list-find-index-loop` / `js-list-some-loop` / `js-list-every-loop` to match. Result: built-ins/Array/prototype/find 5/30 → 6/30. Modest delta this round (most remaining failures need deeper Array semantics — sparse arrays, ToLength on `length`, etc.). Object 30/30, Map 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Array.prototype.forEach`/`map`/`filter` honour `thisArg` and pass `(value, index, array)` to callback.** Was calling the callback with just `(value)` from a bare `(f x)` and ignoring the optional second `thisArg` parameter. Per spec, the callback receives `(value, index, array)` and `this` is `thisArg ?? globalThis` in non-strict. Updated the prototype methods to take `&rest args`, extract `thisArg` (defaulting to globalThis when null/undefined), and route through `js-call-with-this` with the full triple. Updated `js-list-foreach-loop` / `js-list-map-loop` / `js-list-filter-loop` accordingly. Result: built-ins/Array/prototype/forEach 2/30 → 9/30, filter 5/30 → 10/30. Array 18/30, Object 30/30, Map 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Map.prototype.forEach` / `Set.prototype.forEach` honour `thisArg` and pass `(value, key, collection)` to callback.** Was hardcoding `js-undefined` as the callback receiver and only passing `(value, key)`. Per spec, the callback receives `(value, key, collection)` and `this` is `thisArg ?? globalThis` in non-strict. Updated `js-map-do-foreach` / `js-set-do-foreach` to accept an optional `thisArg`, defaulting to `globalThis` when null/undefined; the prototype methods now route the second positional arg through. Result: built-ins/Map/prototype 11/30 → 13/30, built-ins/Set/prototype +similar. Map 18/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`for…in` walks the prototype chain (with shadowing) but stops at native prototypes.** Was using `js-object-keys` which only returns own enumerable keys, so `for (k in instance)` only saw the instance's own properties — not inherited ones from `FACTORY.prototype`. Per spec, for-in walks the entire chain and yields each unique enumerable key once. Added `js-for-in-keys` + `js-for-in-walk` that iterate the chain, deduping via `contains?`. Stops at `Object.prototype` / `Array.prototype` / etc. since those carry "non-enumerable" methods we don't track property-attribute-wise — without this guard, `for (k in {})` would enumerate `toString`/`valueOf`/etc. Result: language/statements/for-in 10/30 → 12/30. Object 30/30, Array 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Parser swallows label declarations + accepts optional ident on `break`/`continue`.** Was rejecting `outer: while (...) { break outer; }` at parse time. Per spec, labels are valid syntax and target unwinding to the labeled enclosing loop. Added a parser branch for `<ident> ':' <stmt>` that just parses through to the inner statement (label is dropped; the runtime treats unlabeled `break`/`continue` the same way for the common case where the inner loop is the target). Also extended `break`/`continue` to optionally consume a trailing ident. Result: language/statements/while 14/30 → 16/30, for 27/30 → 28/30. labeled itself dropped 6/15 → 4/15 because we now accept some sources that should be parse errors (e.g. `label: let x;` is a SyntaxError per spec) — net positive across the suite. Object 30/30, Array 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`new function(){...}(args)` and `new f(...rest)` now parse and execute.** Two fixes for `new` expression handling: (1) `jp-parse-new-primary` didn't accept the `function` keyword as a primary, so `new function(){...}` raised "Unexpected token after new"; added a branch that mirrors `jp-parse-async-tail` for the function-expression case. (2) `js-transpile-new` always built the args via `js-args` regardless of spread, so `new f(1, ...[])` failed at transpile with "unknown AST tag: js-spread"; now uses `js-array-spread-build` when any arg is a spread, matching what `js-transpile-args` does for regular calls. Result: language/expressions/new 16/30 → 19/30. Object 30/30, Array 18/30, language/expressions/call 21/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Parser accepts `new <literal>` (boolean/number/string/null/undefined) and lets it throw TypeError at runtime.** Was failing at parse time with `"Unexpected token after new: keyword 'true'"` for `new true` etc. Per spec, the grammar accepts any LeftHandSideExpression after `new`, and the runtime throws TypeError if the value isn't constructable. Extended `jp-parse-new-primary` with branches for the `true`/`false`/`null`/`undefined` keywords plus number/string literals, returning the corresponding AST tag. `js-new-call`'s existing `(not (js-function? ctor))` guard then raises the right TypeError. Result: language/expressions/new 11/30 → 16/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`bind` returns a dict-with-`__callable__` so bound functions are mutable + carry spec metadata.** Was returning a bare `(fn ...)` lambda — `obj.property = 12` on the bound result silently no-op'd because `js-set-prop` on a lambda only handles the `"prototype"` key. Now bind returns `{:__callable__ <closure> :length <target.length - bound.length, clamped at 0> :name "bound" :__js_bound_target__ recv}`. Notably skipped the `"bound " + target.name` style — for dict constructors (`Number`, `String`) `js-extract-fn-name` calls `inspect` which walks the entire prototype chain and is pathologically slow on those huge dicts (timed out 6 tests). Result: built-ins/Function/prototype/bind 22/30 → 24/30, Function/prototype 19/30 maintained. Object 30/30, Array 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Function.prototype.call` / `apply` box primitive `thisArg` per non-strict ToObject.** Per spec, in non-strict mode the called function receives `ToObject(thisArg)` as `this` — so `f.call(1)` should see a `Number(1)` wrapper, not the raw primitive. We were passing primitives through unchanged, so `this.touched = true` inside the function silently no-op'd (`js-set-prop` on a number returns val unchanged). Extracted a `js-coerce-this-arg` helper that does the spec coercion: undefined/null → globalThis, number/rational → `new Number(v)`, string → `new String(v)`, boolean → `new Boolean(v)`, else as-is. Result: built-ins/Function/prototype/call 19/30 → 23/30, apply 22/30 → 25/30. bind 22/30, Object 30/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Function.prototype.bind` throws TypeError when target isn't callable.** Per spec step 2 of `bind`, if the target (the receiver) isn't callable, throw TypeError. We were happily building a `(fn (&rest more) ...)` closure that would later fail to call — long after the bind() invocation. Added a `(not (js-function? recv))` guard at the top of the bind branch in `js-invoke-function-method` that raises a `TypeError` instance via `js-new-call`. Now `Function.prototype.bind.call(undefined)` etc. throw at the bind call site. Result: built-ins/Function/prototype/bind 14/30 → 22/30 (+8), call 18/30 → 19/30. Object 30/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Function.prototype.{call, apply, bind}` carry their spec lengths and names.** Per spec, `Function.prototype.call.length === 1`, `apply.length === 2`, `bind.length === 1`. We were storing them as bare lambdas with `&rest args`, so `js-fn-length` fell back to the param-counting path which yielded 0. Wrapped each in the dict-with-`__callable__` pattern with explicit `length` and `name` slots; `toString` got `length: 0`. Result: built-ins/Function/prototype/apply 18/30 → 22/30, call 17/30 → 18/30. bind 14/30 holds (its remaining failures are deeper bind semantics — bound length, target check). Object 30/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Function.prototype.{call, apply, bind, toString}` delegate to the real implementation when invoked through the proto chain.** Was: stub functions returning `:js-undefined` / a no-op closure. So `Number.bind(null)` resolved through `Number.__proto__ === Function.prototype` to the stub bind, which returned `(fn () :js-undefined)` instead of an actual bound function. Replaced each stub with `(fn (&rest args) (js-invoke-function-method (js-this) "<name>" args))`, so the prototype methods route to the same implementation that `js-invoke-method` uses when calling on a lambda directly. Now `Number.bind(null)(42) === 42`. Result: built-ins/Function/prototype/bind 9/30 → 14/30, call 12/30 → 17/30, apply 16/30 → 18/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **Functions inherit through their `__proto__` chain in `js-dict-get-walk`; `fn.prototype = X` actually persists.** Two related fixes around the function-as-object semantics: (1) `js-dict-get-walk` was returning undefined the moment it hit any non-dict in the proto chain — but the chain often runs through a function (e.g. `obj.__proto__ === proto` where `proto` is itself a function returned by `Function()`). Now treats lambda/function/component as if they have `__proto__ === Function.prototype` and continues the walk. (2) `js-set-prop` was a no-op when called on a function with key `"prototype"` (returned val without storing) — so `FACTORY.prototype = proto` silently dropped on the floor. Now redirects to `__js_proto_table__` so the next `new FACTORY` picks up the right proto. Result: built-ins/Function/prototype/call 7/30 → 12/30, apply 12/30 → 16/30. Object 30/30, Map 18/30, Array 18/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Function.prototype.call` / `apply` substitute global as `this` when caller passes null/undefined.** Per non-strict ES, `f.apply(null)` and `f.call(undefined)` should bind `this` to the global object inside `f`. We were passing `null`/`undefined` straight through to `js-call-with-this`, so `this.field = "green"` (the test pattern) silently failed because the function's `this` was still undefined and `this.field` did nothing. Updated both clauses in `js-invoke-function-method` to swap in `js-global-this` when the caller's `this`-arg is null or `:js-undefined`. Result: built-ins/Function/prototype 4/30 → 11/30 (+7), apply 0+ → 12/30, call 0+ → 7/30. Object 30/30 holds. conformance.sh: 148/148.
-
-- 2026-05-09 — **`js-global` exposes more built-in constructors and helpers.** Was missing `Function` (so `typeof this.Function === "undefined"`), the seven Error subclasses, the URI helpers, `eval`, `Promise`, and stubs for `Symbol` / `AggregateError` / `SuppressedError`. Added all of them. Did NOT add `globalThis` as a self-reference — that creates a cycle which makes `inspect` (used by `js-ctor-id`) hang on every error path that tries to format a constructor identity. Result: built-ins/global 19/29 → 22/27. Object 30/30, property-accessors 14/21 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Top-level expression statements support the comma operator.** Was using `jp-parse-assignment` for the expression in `jp-parse-stmt`'s fallback branch, so `false, true;` raised "Unexpected token: punct ','". Switched to `jp-parse-comma-seq`, which already returns either a plain assignment (no comma seen) or a `js-comma` AST. Per spec, ExpressionStatement → Expression, and Expression includes the comma operator. Result: language/expressions/comma 1/5 → 3/5, language/statements 22/30 → 23/30. Object/Array/Map unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`instanceof` accepts function operands.** `js-instanceof` was returning false on the very first check `(not (= (type-of obj) "dict"))` for any non-dict left-hand side — but functions are objects too, so `MyFunct instanceof Function` should be true (functions inherit from `Function.prototype`) and `MyFunct instanceof Object` likewise. Added a `js-function?` arm that special-cases against `Function.prototype` and `Object.prototype`, and falls through to the proto-walk if the function happens to also have a `__proto__` slot (dict-with-`__callable__` constructors do). Result: language/expressions/instanceof 20/30 → 24/30. Object 30/30, Error 22/30, Function 4/30 unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Relational operators ToPrimitive their operands (string-vs-numeric decision); `<= / >=` short-circuit to false on NaN.** `js-lt` was checking only `(type-of)` for `"string"` to pick the string-compare branch, so `{} < function(){return 1}` fell into `(< NaN NaN)` (returning false) while `{}.toString() < fn.toString()` returned true (lex). Reused `js-add-unwrap` (now extended to coerce lambda/function/component to their `js-to-string` representation, matching the function's `[object Function]` / `function () { [native code] }` semantics) so both operands are first reduced to primitives. Added explicit NaN check in the numeric branch of `js-lt` and `js-le`. `js-le` no longer does `(not (js-lt b a))` — that gave the wrong answer on NaN (NaN ≤ x must be false, not !(x < NaN) = true). `js-ge` similarly switched to `(js-le b a)`. Result: language/expressions/less-than 23/30 → 24/30, greater-than 23/30 → 24/30, addition 24/30 → 25/30. Object 30/30 maintained. conformance.sh: 148/148.
-
-- 2026-05-09 — **`Error(msg)` / `TypeError(msg)` / etc. (called without `new`) now return a proper instance.** Was checking `(if (= (type-of this) "dict") <init> nil)` and falling through to return undefined when called as a plain function — but per spec, every Error subclass must return a new instance regardless of `new`. Refactored each constructor to `(js-error-init! (js-error-receiver Ctor) "Name" args)`: `js-error-receiver` returns `this` if it's a dict (the `new`-call case) and otherwise re-enters via `js-new-call ctor (list)` to create a properly-prototyped instance; `js-error-init!` sets `message`, `name`, `__js_error_data__`. Cleaner than the seven near-identical duplicated bodies. Result: built-ins/Error 17/30 → 22/30 (+5), language/expressions/instanceof 18/30 → 20/30. NativeErrors holds at 27/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **`typeof <undeclaredIdent>` returns `"undefined"` instead of throwing ReferenceError.** Per JS spec, `typeof` on an unresolvable Reference is special-cased — it must return `"undefined"` without throwing. We were transpiling `typeof X` to `(js-typeof <symbol-X>)`, and the symbol lookup itself errored for undeclared globals. New transpiler branch in `js-transpile-unop`: when the operand is a `js-ident`, emit `(if (or (env-has? (current-env) "name") (dict-has? js-global "name")) (js-typeof <name>) "undefined")` — checks both the lexical env (for local var/let/const/parameters) and the global object, and only references the symbol when the if branch is taken (SX `if` is lazy, so the unbound symbol in the false branch never errors). Result: language/expressions/typeof 9/13 → 10/13, built-ins/Object 29/30 → 30/30 (full pass — the `S15.2.1.1_A2_T11.js` test was using `typeof obj` on an undeclared name). conformance.sh: 148/148.
-
-- 2026-05-09 — **`==` returns false when either side is NaN, even across the numeric/string paths.** `js-loose-eq` was converting both sides to numbers (`Number.NaN == "string"` → `NaN == NaN`) and using SX `(=)`, which apparently returns true when both NaN values are the same reference. Per JS, NaN compares unequal to everything including itself. Wrapped both cross-type numeric/string branches in `(or (js-number-is-nan an) (js-number-is-nan bn))` short-circuits to false. Result: language/expressions/equals 20/30 → 23/30. strict-equals/Number/Object unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Lexer: `}` ends the regex context, like `)` and `]`.** Was treating `/` after `}` as the start of a regex literal, so `({}) / function(){return 1}` lexed `} / function(){...})` as `}` + regex `/ function(){return 1}/`. Per JS, after `}` of an object literal we're in expression-end position and `/` is division. The "block vs object" distinction is context-sensitive, but in practice expression-position `}` is the common case and there is no statement/block hazard for our parser since blocks at expression position don't typically have a following `/`. Single-char addition to the no-regex-context check. Result: language/expressions/division 25/30 → 26/30. asi/Map/Object unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`js-to-number` of functions/lists returns NaN / sensible coercion (was 0).** `js-to-number` had no clauses for `lambda`/`function`/`component`/`list` types, so they fell into the `(else 0)` arm. Per spec: ToNumber of any function is NaN, and ToNumber of an Array goes through ToPrimitive which calls `Array.prototype.toString` (the comma-join), so `[]` → "" → 0, `[5]` → "5" → 5, and `[1,2]` → "1,2" → NaN. Added explicit lambda/function/component clauses (return NaN) and a list clause (length 0 → 0, length 1 → recurse, else NaN). Now `function(){return 1} - function(){return 1}` is NaN instead of 0. Result: language/expressions/subtraction 25/30 → 26/30; multiplication 90%, division 83% confirmed unchanged-or-better. Object/Array/Number unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`+` operator now ToPrimitive's plain Objects + Dates via `valueOf`/`toString`.** Followup to the wrapper-unwrap fix. `js-add-unwrap` only handled `__js_string_value__` / `__js_number_value__` / `__js_boolean_value__` markers — for plain `{}` or `new Date()`, it returned the dict as-is, which then fell into `js-to-number` and produced `NaN`. Added two helpers: `js-add-toprim-default` calls `valueOf()` first (the "default" hint, used by `+`), and falls back to `toString()` if valueOf returns an object; for Date instances (`__js_is_date__` marker) we go straight to `toString` per spec. `js-add-call-method` walks the proto chain via `js-dict-get-walk`, calls the method with the receiver bound, and gives up if the slot is missing or not callable. Now `date + date === date.toString() + date.toString()`. Result: language/expressions/addition 23/30 → 24/30. Object/Array unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`+` operator unwraps Number/String/Boolean wrapper objects before deciding string-vs-numeric.** `js-add` was only checking `(type-of a)` / `(type-of b)` for `"string"` to decide string concat — but a `new String("1")` instance is type `"dict"`, so `new String("1") + "1"` was falling into the numeric branch and producing `2` instead of `"11"`. Added `js-add-unwrap` (mirrors ToPrimitive for the wrapper cases): if a dict has `__js_string_value__` / `__js_number_value__` / `__js_boolean_value__`, return the inner primitive. Then `js-add` applies the string-concat-vs-numeric decision to the unwrapped values. Result: language/expressions/addition 19/30 → 23/30. String stays 30/30. Number/Object unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Rational handling in `js-typeof` / `js-to-string` / `js-strict-eq` / `js-loose-eq` / `Object.prototype.toString`.** Followup to the `js-to-number` fix. SX rationals were leaking into other paths: `typeof 1/2` returned `"object"` (should be `"number"`), `String(1/2)` fell into the dict branch and returned `"[object Object]"`, and `1/2 === 0.5` was false because strict-eq compared types and `"rational"` ≠ `"number"`. Added rational arms to `js-typeof` and `js-object-tostring-class`, normalised rationals via `(exact->inexact)` in `js-to-string`'s number branch, and introduced a `js-numeric-type?` / `js-numeric-norm` pair that lets strict-eq and loose-eq treat both numeric kinds uniformly. Result: language/expressions/strict-equals 16/22 → 19/22; Math 30/30 confirmed (no regression — but it never had one). Object/Array/Map unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`js-to-number` now coerces SX rationals via `exact->inexact`.** SX `(/ 59 16)` returns the rational `59/16` with `(type-of)` `"rational"` — not `"number"` — so `js-to-number` was falling through to the dict branch and ultimately returning `0`. That broke any path that did integer-divide intermediate math (e.g. `js-hex-2` for percent-encoding: `(js-math-trunc (/ 59 16))` was returning 0, so `encodeURIComponent(";")` produced `"%0B"` instead of `"%3B"`). Added a `((= (type-of v) "rational") (exact->inexact v))` clause in `js-to-number` between the existing `"number"` and `"string"` branches. Result: built-ins/encodeURIComponent 9/30 → 15/30, built-ins/encodeURI 22/60 → 28/60, built-ins/decodeURI 11/60 → 20/60. Object/Array unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`parseFloat("+")` / `parseFloat("-")` / `parseFloat(".")` return NaN (were returning 0).** `js-float-prefix-end` happily consumed leading `+`/`-` and dot characters even with no digits — and `js-parse-num-safe` of those characters returned 0. Per spec, the prefix must contain at least one digit. Added a `js-str-has-digit?` walker called between `js-float-prefix-end` and `js-parse-num-safe`; if no digit is present in the consumed slice, return NaN. Result: built-ins/parseFloat 20/30 → 23/30, built-ins/parseInt 22/30 → 24/30. Number unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **`parseFloat` recognises `"Infinity"` / `"±Infinity"` prefixes (not just exact matches).** Per spec, parseFloat parses the longest StrDecimalLiteral prefix — `Infinity` is one — so `parseFloat("Infinity1")`, `parseFloat("Infinityx")`, `parseFloat("Infinity+1")` should all return `Infinity`. Was only matching `s === "Infinity"` / `"+Infinity"` / `"-Infinity"` exactly. Added `js-float-has-infinity-prefix?` helper and three new branches at the top of `js-parse-float-prefix`. Result: built-ins/parseFloat 17/30 → 20/30. conformance.sh: 148/148.
-
-- 2026-05-09 — **JS lexer rejects bare `\` in source (e.g. `{` outside an identifier-escape context).** Was silently advancing past unknown chars in the punctuator-fallback branch, so `{` became `\` (skipped) + ident `u007B`, and `((1))` parsed as something close to `(1)` after our SX-string layer pre-converted half of them. Now `(else (advance! 1))` is a `(error "Unexpected char '\\' in source")` for `\` specifically (other unknown chars still advance — keeps multi-byte UTF-8 idents working at the byte level). Result: language/punctuators 1/11 → 11/11 (full pass), language/literals 25/30 → 28/30, language/identifiers 11/30 → 13/30. Object/Map unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Negative-test classifier maps `js-transpile-assign` and any `js-transpile-*` error to SyntaxError.** `language/types/boolean/S8.3_A2.{1,2}.js` (testing `true=1`/`false=0` reject) raises `js-transpile-assign: unsupported target` at our transpile pass — that's a parse-phase error in test262's sense (the source is structurally invalid before any runtime evaluation), but the runner's classifier didn't recognise the prefix and reported the test as failing. Added `js-transpile-assign` and the broader `js-transpile` prefix to the SyntaxError-mappable patterns in `classify_negative_result`. Result: language/types 26/30 → 28/30 (the two `true = 1` / `false = 0` tests). conformance.sh: 148/148.
-
-- 2026-05-09 — **`Object.getOwnPropertyDescriptor` now returns descriptors for arrays and strings, not just dicts.** Was: `(if (and (dict? o) ...) {...} :js-undefined)` — every list and string returned `undefined`. Extended: lists give `{value: arr[i], writable: true, enumerable: true, configurable: true}` for valid integer indices, plus `{value: arr.length, writable: true, enumerable: false, configurable: false}` for `"length"`. Strings give read-only descriptors for `"length"` and individual code units. The integer-index test reuses `js-int-key?` (added earlier for `__js_order__` integer-key sorting). Result: built-ins/Object/getOwnPropertyDescriptor 50/60 → 54/60, language/arguments-object 12/30 → 13/30. Array unchanged. conformance.sh: 148/148.
-
-- 2026-05-09 — **Fixed `RegExp.prototype.test/exec` calling `nil` as a function when no regex platform impl is registered.** `js-regex-invoke-method` was checking `(js-undefined? impl)` to decide whether to fall back to the stub — but `(get __js_regex_platform__ "test")` returns `nil` (not `:js-undefined`) when the key is absent, so the check was false and the next branch `(impl rx arg)` tried to call `nil`. The OCaml CEK reports this as `Not callable: <next-arg>` (showing the regex receiver in the error, which made the failure look like the regex itself wasn't callable). Changed both `test` and `exec` clauses to `(or (js-undefined? impl) (= impl nil))`. Now `RegExp("0").exec("1")` returns `null` (correctly, no match) instead of crashing. Result: language/literals 24/30 → 25/30. RegExp unchanged (still needs a real engine for the rest). conformance.sh: 148/148.
-
-- 2026-05-09 — **`RegExp` constructor exposed as a global.** Was undefined — every test in `built-ins/RegExp` died at `new RegExp(...)` with ReferenceError. The internals (`js-regex-new`, `js-regex?`, `js-regex-stub-test`, `js-regex-stub-exec`) already existed for regex literals; this iteration just wraps them as a JS-visible constructor with the dict-with-`__callable__` pattern. Constructor handles `new RegExp(/x/, "g")` (re-flags an existing regex), `new RegExp(pattern)` and `new RegExp(pattern, flags)`. Prototype methods: `test`, `exec`, `toString`, `compile` (matching the stub semantics — substring search with `i` flag honoured, no real regex engine). Added `RegExp` to `js-global` and the post-init `__proto__` chain. Result: built-ins/RegExp 0/30 → 1/30; the rest still need a real regex engine (or fail on character-class escapes / lookaheads / etc.). conformance.sh: 148/148.
-
-- 2026-05-08 — **`js-is-space?` recognises the full ES whitespace set** (was only ` \t\n\r`). `parseFloat("1.1")`, `parseFloat(" 1.1")`, etc. now strip leading whitespace correctly per spec. Added: form feed (12), vertical tab (11), NBSP (160), Ogham space mark (5760), the en/em-width run 8192–8202, line/paragraph separator (8232/8233), narrow no-break space (8239), medium math space (8287), ideographic space (12288), ZWNBSP/BOM (65279). Single helper used by every trim/whitespace path (`parseFloat`, `parseInt`, `String.prototype.trim*`, `js-string-to-number`, JSON parse-ws). Result: built-ins/parseFloat 15/30 → 17/30. String/Number/parseInt unchanged. conformance.sh: 148/148.
-
-- 2026-05-08 — **NativeError prototype chain wired: `Object.getPrototypeOf(EvalError) === Error`, `Error.prototype.constructor === Error`, `[object Error]` brand.** Three pieces: (1) `js-object-tostring-class` now recognises `__js_error_data__` (returns `"[object Error]"`), `__js_is_date__` (`"[object Date]"`), `__map_keys__` / `__set_items__` (`"[object Map]"` / `"[object Set]"`) — these were all falling through to `"[object Object]"`. (2) New `__js_ctor_proto__` side-table maps lambda-ctor identity → its [[Prototype]] constructor; `js-object-get-prototype-of` consults it for non-dict callables. Populated for all six native error subclasses (TypeError/RangeError/SyntaxError/ReferenceError/URIError/EvalError) → Error. (3) Each subclass's `prototype.__proto__` set to `Error.prototype`, and `Error.prototype` gets `name`, `message`, `constructor` populated; each subclass prototype also gets its own `name` and `constructor`. Result: built-ins/NativeErrors 14/30 → 27/30 (+13), built-ins/Error 11/30 → 17/30 (+6). Object/Map/Array unchanged. conformance.sh: 148/148.
-
-- 2026-05-08 — **Object literals get `__proto__: Object.prototype`; try/catch wraps SX error strings into JS Error instances.** Two fixes that work together: (1) `js-make-obj` now sets `__proto__` to `(get Object "prototype")` on every plain object literal `{}` — was missing, so `({}) instanceof Object` was `false`. (2) `js-transpile-try` now wraps the catch param via `js-wrap-exn` — when SX throws an `Eval_error("TypeError: ...")` / `("RangeError: ...")` / `("SyntaxError: ...")` etc. into the catch body, the user previously got a plain string. Now each prefix dispatches to the matching `js-new-call` so `e instanceof TypeError` etc. is truthy. Note: `Eval_error("Undefined symbol: y")` is NOT caught by SX `guard` at all, so the `1 + y → ReferenceError` shape remains unfixable from JS land — out of scope (would need OCaml-side change to make symbol lookup raisable). Result: language/expressions/instanceof 13/30 → 18/30 (+5). Object/Map/Array unchanged. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Date` constructor + prototype stubs.** `Date` was undefined globally — every test in `built-ins/Date` died at `new Date(...)` with ReferenceError. Implemented as a dict-with-`__callable__` (same pattern as `Map`/`Set`/`Object`). Constructor accepts 0 args (epoch 0), 1 number arg (ms), 1 string arg (parses leading `YYYY` to compute approx ms via `(year-1970)*31557600000`), or 2+ args (year, month, day → simple ms calc). `__date_value__` is the internal slot. Statics: `Date.now()`, `Date.parse(s)`, `Date.UTC(...)`. Prototype: `getTime` / `valueOf` / `setTime`, all `getX` / `getUTCX` (most return 0/1 — only `getFullYear` actually computes), `toISOString` / `toJSON` / `toString` / `toUTCString` produce `YYYY-01-01T00:00:00.000Z` from the stored year, plus the locale variants. Wired `Date` into `js-global` and the post-init `__proto__` chain. The maths is approximate (ignores leap years, varying month lengths, timezone offsets) — but the structural tests `typeof new Date(...) === "object"` and the basic flow now work. Result: built-ins/Date 0/30 → 3/30 (rest timeouts/assertions on month-rollover/leap-year math we don't model). conformance.sh: 148/148.
-
-- 2026-05-08 — **`Error.isError` static + `[[ErrorData]]` slot + `verifyEqualTo` harness helper.** Added `Error.isError(v)` per the Stage-3 proposal: returns `true` only for objects with the internal `[[ErrorData]]` slot. Implemented as `__js_error_data__: true` set on `this` by every Error subclass constructor (Error/TypeError/RangeError/SyntaxError/ReferenceError/URIError/EvalError); `js-error-is-error` walks `__proto__` looking for the marker. Wired through the lambda-static-prop path next to the existing `Promise.resolve` / `Promise.reject` lookup. Defined `AggregateError` and `SuppressedError` as `:js-undefined` so `typeof AggregateError !== 'undefined'` resolves cleanly (without these, the bare ident lookup throws ReferenceError). Added `verifyEqualTo` to the harness — `propertyHelper.js` includes it, used by `Error/message_property.js` etc. Result: built-ins/Error 6/30 → 11/30 (+5), Error/isError sub-suite 0/9 → 5/9. Map/Object unchanged. conformance.sh: 148/148.
-
-- 2026-05-08 — **Harness: `$DONE` / `asyncTest` and `checkSequence` / `checkSettledPromises` stubs added.** Async-flagged Promise tests call `$DONE(err?)` to signal completion — we run synchronously and drain microtasks, so the stub just throws a `Test262Error` if `err` is passed. `asyncTest(fn)` wraps the test fn in `Promise.resolve().then(..., $DONE)`. `checkSequence(arr, msg)` (from `promiseHelper.js`) verifies `arr[i] === i+1` — used by ordering tests on `Promise.all` / `Promise.race`. `checkSettledPromises(actual, expected, msg)` matches what `Promise.allSettled` tests expect. Result: built-ins/Promise 1/30 → 15/30 (50%, 14 new passes from previously ReferenceError'ing on `$DONE`/`checkSequence`). conformance.sh: 148/148.
-
-- 2026-05-08 — **`Map` and `Set` constructors with full instance API.** Both were undefined globally — every test in those categories died at `new Map()` / `new Set()` with ReferenceError. Implemented as plain SX storage on the instance dict (`__map_keys__` + `__map_vals__` parallel lists for Map, `__set_items__` for Set) using SX `=` for key/value comparisons. Wired prototype methods: `.get`, `.set`, `.has`, `.delete`, `.clear`, `.forEach`, `.keys`, `.values`, `.entries` for Map; `.add`, `.has`, `.delete`, `.clear`, `.forEach`, `.keys`, `.values`, `.entries` for Set. `.size` is a real own property updated on every mutation (no getters). Constructors use the dict-with-`__callable__` pattern (like `Object`) so `Map.length`, `Map.name`, `Map.prototype` work as regular dict reads. Constructor accepts an iterable of `[k,v]` pairs (Map) or values (Set). Added `Map`/`Set` to `js-global` and to the prototype-chain post-init block. Result: built-ins/Map 1/30 → 18/30 (60%), built-ins/Set 0/30 → 15/30 (50%, rest mostly timeouts on iterator-protocol tests). conformance.sh: 148/148.
-
-- 2026-05-08 — **`decodeURI` / `decodeURIComponent` actually decode (and throw URIError on malformed input); harness `decimalToHexString` helper added.** Both were `(fn (v) (js-to-string v))` — passthrough stubs. Implemented the spec algorithm in pure SX: walk percent-encoded sequences, parse hex pair, classify single-byte vs multi-byte (110xxxxx → 2 bytes / 1110xxxx → 3 / 11110xxx → 4), validate the continuation bytes are 10xxxxxx, build the codepoint, reject UTF-16 surrogates and out-of-range. `decodeURI` keeps reserved bytes (`;/?:@&=+$,#`) as literal `%XX`. Malformed sequences throw `URIError` via existing constructor. Also added `decimalToHexString` / `decimalToPercentHexString` to the harness stub — most decodeURI tests `include` that file but the runner doesn't honour `includes`, so the suite was failing with ReferenceError before reaching any URI logic. Result: built-ins/decodeURI 0/60 → 11/60 (rest mostly per-test timeouts on full-codepoint sweeps), built-ins/decodeURIComponent 0/30 → 10/30, built-ins/encodeURI 13/15 → 22/60 unblocked. conformance.sh: 148/148.
-
-- 2026-05-08 — **Object literals: computed keys `[expr]: val`, insertion-order tracking, integer-key-first ordering for `getOwnPropertyNames`.** Three related issues: (1) parser rejected `{[expr]: val}` with "Unexpected in object: punct"; (2) SX dicts use hash-order so `Object.getOwnPropertyNames` returned keys in non-insertion order; (3) `var list = {...}` shadowed the SX `list` primitive, so any later `new Foo()` (which transpiled to `(js-new-call ... (list ...))`) crashed with "Not callable: <dict>". Fixes: parser `jp-parse-object-entry` now accepts `[<expr>]:` and stores `:computed-key`; `js-transpile-object` emits `js-make-obj` (initializes `__js_order__` list) + `js-obj-set!` (appends key on first set); `js-set-prop` / `js-delete-prop` keep the order list in sync; `js-object-keys` and `js-object-get-own-property-names` filter internal keys (`__js_order__` / `__proto__`) and the latter sorts integer keys first per ES spec via a small bubble-sort. Replaced `(list ...)` emissions for `js-new-call` args and array literals with `(js-args ...)` and `(js-make-list ...)` (closure-captured) — the latter remains mutable. Fixes 0/2 → 2/2 on `language/computed-property-names/basics`, +3 on built-ins/Array (Array.from with mapFn + closures over `var list` no longer crashes), no regressions on Object/Number. conformance.sh: 148/148.
-
-- 2026-05-08 — **Bitwise ops `& | ^ << >>` (+ compound assigns) now transpile and evaluate.** Previously the transpiler raised `unsupported op: &/>>/<<` for any source using them, and the punctuator suite (0/11) plus a wider scatter of Number/expression tests bombed on first reference. Added pure-SX runtime helpers: `js-to-uint32` / `js-to-int32` / `js-uint32-to-int32` for ToUint32/ToInt32 coercion; `js-bitwise-loop` that walks all 32 bit positions emitting `and`/`or`/`xor` (no native bit primitive available); `js-bitand` / `js-bitor` / `js-bitxor` and `js-shl` / `js-shr` (shr uses `floor(ai / 2^sh)` which is correct for signed values). Wired `<<`, `>>`, `&`, `|`, `^` into `js-transpile-binop`, and the corresponding `<<=`, `>>=`, `>>>=`, `&=`, `|=`, `^=` into `js-compound-update`. Lexer + parser already produced the tokens with correct precedence. language/punctuators: 0/11 → 1/11 (the remaining 10 are negative tests for `\u`-escaped punctuator rejection). Also unblocks the 8x `&`, 2x `>>`, 1x `<<` "unsupported op" failures from the prior broad sweep. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Function(arg1, arg2, ..., body)` constructor compiles + evaluates JS source.** Was unconditionally throwing `"TypeError: Function constructor not supported"`. Now `js-function-ctor` joins the param strings with commas, wraps the body in `(function(<params>){<body>})`, and runs it through `js-eval`. Side helpers (`js-fn-args-to-strs`, `js-fn-take-init`, `js-fn-take-last`, `js-fn-join-commas`) keep the implementation self-contained and use existing primitives. Now `Function('a', 'b', 'return a + b')(3,4) === 7`. built-ins/Function: 0/14 → 4/14. conformance.sh: 148/148.
-
-- 2026-05-08 — **`arguments` object inside JS functions; `Array.from` calls mapFn correctly.** Three related fixes: (1) Every JS function body now binds `arguments` to `(cons p1 (cons p2 ... __extra_args__))` — a list of all received args, declared and rest. (2) `Array.from(iter, mapFn)` now invokes mapFn through `js-call-with-this` with the index as second arg (was `(map-fn x)` direct, missing index and inheriting outer `this`). (3) Defaults the `thisArg` to `js-global-this` when caller didn't pass one (per non-strict ES). Now `function f() { return arguments[1]; } f(1, 2)` returns 2; `Array.from([1,2,3], (v, i) => v + i*100)` returns `[1, 102, 203]`. conformance.sh: 148/148.
-
-- 2026-05-08 — **`String(arr)` consults `Array.prototype.toString` (not the hardcoded join).** Was always emitting the comma-joined elements via `js-list-join`, so user-visible mutations of `Array.prototype.toString` had no effect on `String(arr)` / `"" + arr`. Now look up the override via `js-dict-get-walk` and call it on the list as `this`; fall back to `(js-list-join v ",")` when the override doesn't return a string. Default behaviour preserved (Array.prototype.toString already calls `js-list-join`). built-ins/String fail count: 11 → 9. conformance.sh: 148/148.
-
-- 2026-05-08 — **Top-level `this` resolves to the global object.** Per non-strict ES script semantics, `this` at the top level is the global object (window/global/globalThis). Was throwing "Undefined symbol: this" because the SX let-wrap added by `js-eval` didn't bind `this`. Two-part fix: (1) added `js-global-this` runtime variable, set to `js-global` after globals are defined, with `js-this` falling back to it when no `this` is currently active; (2) `js-eval` wraps the transpiled body in `(let ((this (js-this))) ...)` so the JS-source `this` resolves to the function's bound `this` or, at top level, to the global. Fixes `String(this)`, `this.Object === Object`, etc. built-ins/Object: 46/50 → 47/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **Comma operator `(a, b, c)` parses and evaluates left-to-right, returning last.** Was failing with `Expected punct ')' got punct ','` because `jp-try-arrow-or-paren` only consumed a single assignment expression. Added `jp-parse-comma-seq` / `jp-parse-comma-seq-rest` helpers that build a `js-comma` AST node with the list of expressions; the transpiler emits `(begin ...)` which evaluates each in order and returns the last. Fixes `Object((null,2,3),1,2)`-style tests. built-ins/Object: 44/50 → 46/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **ToPrimitive treats functions as non-primitive in `js-to-string` / `js-to-number`.** Per ES, ToPrimitive only accepts strings/numbers/booleans/null/undefined as primitives — objects AND functions must trigger the next conversion step. Was treating function returns from toString/valueOf as primitives (recursing to extract a string), so a `toString` returning a function wouldn't fall through to `valueOf`. Widened the dict-only check to `(or (= type "dict") (js-function? result))` in both ToPrimitive paths. Now `var o = {toString: () => function(){}, valueOf: () => { throw 'x' }}; new String(o)` propagates `'x'` from valueOf. built-ins/String: 85/99 → 86/99. conformance.sh: 148/148.
-
-- 2026-05-08 — **`fn.toString()` and `String(fn)` honour `Function.prototype.toString` overrides.** Two hardcoded paths returned `"function () { [native code] }"` regardless of any user override: the function-method dispatch in `js-invoke-function-method`, and the lambda branch of `js-to-string`. Both now look up `Function.prototype.toString` via `js-dict-get-walk` and invoke it on the function (`recv`/`v`) when available, falling back to the native marker only if no override exists. Now `Function.prototype.toString = ...; (function(){}).toString()` returns the override, and `new String(fn)` stores the override result. built-ins/String: 84/99 → 85/99. conformance.sh: 148/148.
-
-- 2026-05-08 — **Native prototypes carry the wrapped primitive marker.** Per ES, `Boolean.prototype` is a Boolean wrapper around `false`, `Number.prototype` wraps `0`, `String.prototype` wraps `""`. So `Boolean.prototype == false` (loose-eq unwraps), `Object.prototype.toString.call(Number.prototype) === "[object Number]"`, etc. Set `__js_boolean_value__: false` / `__js_number_value__: 0` / `__js_string_value__: ""` on the respective prototypes in the post-init block. built-ins/Boolean: 23/27 → 24/27, String: 80/99 → 84/99. conformance.sh: 148/148.
-
-- 2026-05-08 — **`js-to-number` throws TypeError when valueOf+toString both return non-primitive.** Mirrors the earlier `js-to-string` fix. Per spec, `Number(obj)` must throw if `ToPrimitive` cannot extract a primitive. Was returning `NaN` silently. Replaced the inner `(js-nan-value)` fallback with `(raise (js-new-call TypeError ...))`. built-ins/Number: 45/50 → 46/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Array.prototype` / `Number.prototype` / etc. inherit from `Object.prototype`.** Per ES, every native prototype's `[[Prototype]]` is `Object.prototype` (and `Function.prototype.[[Prototype]]` is also `Object.prototype`). Was missing those `__proto__` links, so `Object.prototype.isPrototypeOf(Boolean.prototype)` returned false (the explicit isPrototypeOf walks `__proto__`, not the recent fallback). Added 5 `dict-set!` lines to the post-init block at the end of `runtime.sx`. built-ins/Boolean: 22/27 → 23/27, built-ins/Number: 44/50 → 45/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **`delete obj.key` actually removes the key.** `js-delete-prop` was setting the value to `js-undefined` instead of removing the key, so subsequent `'key' in obj` returned true and proto-chain lookup didn't fall through to the parent. Switched to `dict-delete!` (existing SX primitive). Now `delete Boolean.prototype.toString; Boolean.prototype.toString()` correctly walks up to `Object.prototype.toString` and returns `"[object Boolean]"`. built-ins/Boolean: 21/27 → 22/27. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Boolean(NaN) === false` (and `!NaN === true`).** `js-to-boolean` was returning `true` for NaN because NaN ≠ 0 by IEEE semantics, so the `(= v 0)` test fell through to the truthy-else clause. Per ES, NaN is one of the falsy values. Added a `(js-number-is-nan v)` clause. built-ins/Boolean: 19/27 → 21/27. conformance.sh: 148/148.
-
-- 2026-05-08 — **Global `eval(src)` actually evaluates the source.** Was returning the input string unchanged: `eval('1+2')` returned `"1+2"`, not `3`. Per spec, `eval(string)` parses and evaluates as JS; non-string input passes through. Wired the runtime stub through `js-eval` (which already does the lex/parse/transpile/eval pipeline) when the arg is a string. Fixes `String(eval('var x'))`, the harness internal `eval(...)`, and any test that calls `eval` for runtime evaluation. built-ins/String fail count: 13 → 11. conformance.sh: 148/148.
-
-- 2026-05-08 — **`new <non-callable>` throws TypeError instead of hanging.** `new (new Object(""))` (calling `new` on a String wrapper dict) hung because `js-new-call` called `js-get-ctor-proto` which fell through to `js-ctor-id` which called `inspect ctor` — and `inspect` on a wrapper-with-proto-chain recurses through the prototype's lambdas forever. Added a `(js-function? ctor)` precheck at the top of `js-new-call`: when the receiver isn't callable, raise a `TypeError` instance instead. Now `try { new x } catch(e) { e instanceof TypeError }` returns `true` for non-callable `x`. conformance.sh: 148/148. String 80/99, Array 23/45 maintained.
-
-- 2026-05-08 — **JS functions accept extra args silently (per spec).** SX strictly arity-checks: `(fn (a) ...)` rejects 2 args, but JS allows passing more args than declared (the extras are accessible via `arguments`). Was raising `f expects 1 args, got 2` whenever Array.from passed `(value, index)` to a 1-arg mapFn, etc. Fixed in `js-build-param-list` (transpile.sx): every JS function param list now ends with `&rest __extra_args__` (unless an explicit rest param is already present), so extras are silently absorbed. Headline scoreboards unchanged but unblocks a class of harness-mediated failures. conformance.sh: 148/148.
-
-- 2026-05-08 — **Lowered array padding bail-out from 2^32-1 to 1M.** Yesterday's 2^32-1 threshold still allowed indices like `2147483648` to pad billions of `js-undefined` entries, hanging the worker. Without sparse-array support there's no semantic value in supporting >1M sparse padding; lowering the bail to 1M turns those tests into fast assertion failures instead of timeouts. Removes another timeout (Array 7→1). built-ins/Array stays at 23/45, but the run is faster and no longer wall-time-bound. conformance.sh: 148/148.
-
-- 2026-05-08 — **Out-of-range array indices and lengths no longer hang.** `arr[4294967295] = 'x'` and `arr.length = 4294967295` were padding the SX list with `js-undefined` for ~4 billion entries — guaranteed timeout. Per ES spec, indices ≥ 2^32-1 aren't array indices (they're regular properties, which we can't store on a list). Added a `(>= i 4294967295)` bail-out clause to both `js-list-set!` (numeric index path) and the `length` setter; both now no-op at that bound. Removed 5 of the 7 Array timeouts. built-ins/Array: 21/45 → 23/45. conformance.sh: 148/148.
-
-- 2026-05-08 — **Built-in `.length` returns spec-defined values for variadic functions.** `String.fromCharCode.length`, `Math.max.length`, `Array.from.length` were all returning `0` because the underlying SX lambdas use `&rest args` with no required params — but the spec assigns each built-in a specific length (`fromCharCode === 1`, `max === 2`, etc.). Added `js-builtin-fn-length` that maps the unmapped JS name to its spec length (12 entries covering fromCharCode, fromCodePoint, raw, of, from, isArray, max, min, hypot, atan2, imul, pow). `js-fn-length` consults this table first and falls back to counting real params. built-ins/String: 79/99 → 80/99, built-ins/Array: 20/45 → 21/45. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Object.prototype.toString` dispatches by [[Class]].** Was hardcoded to `"[object Object]"` for everything; per ES it should return `"[object Array]"`, `"[object Function]"`, `"[object Number]"`, etc. based on the receiver's class. Added `js-object-tostring-class` helper that switches on `(type-of v)` and on dict-internal markers (`__js_string_value__`, `__js_number_value__`, `__js_boolean_value__`, `__callable__`). Also added prototype-identity checks so `Object.prototype.toString.call(Number.prototype)` returns `"[object Number]"` (similar for String/Boolean/Array). built-ins/Array: 18/45 → 20/45, built-ins/Number: 43/50 → 44/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **`Math.X.name` returns the JS-style method name.** `Math.acos.name`, `Math.acosh.name`, `Math.asin.name` were returning the SX symbol name (`"js-math-acos"` etc.). `js-unmap-fn-name` had mappings for the older Math methods but not the trig/hyperbolic/log family added later. Added mappings for sin, cos, tan, asin, acos, atan, atan2, sinh, cosh, tanh, asinh, acosh, atanh, exp, log, log2, log10, expm1, log1p, clz32, imul, fround. built-ins/Math: 42/45 → 45/45 (100%). conformance.sh: 148/148.
-
-- 2026-05-08 — **`fn.constructor === Function` for function instances.** Per ES, every function instance's `constructor` slot points to the `Function` global. Was returning undefined for `(function () {}).constructor`. Added `constructor` to the function-property cond in `js-get-prop`; returns `js-function-global`. Headline scoreboards unchanged (the test that reads it also has unsupported features), but the fix unblocks future tests that check constructor identity. conformance.sh: 148/148.
-
-- 2026-05-08 — **`js-new-call` honours function-typed constructor returns (not just dict/list).** `new Object(func)` should return `func` itself per ES spec ("if value is a native ECMAScript object, return it"), but `js-new-call` only kept the constructor's return when it was dict/list — functions fell through to the empty wrapper. Added `(js-function? ret)` to the accept set. Now `new Object(fn) === fn` and `new Object(fn)()` invokes `fn`. built-ins/Object: 42/50 → 44/50. conformance.sh: 148/148.
-
-- 2026-05-08 — **`var` declarations hoist out of nested blocks; nested `var` becomes `set!`.** JS `var` is function-scoped, but the transpiler was only collecting top-level vars for hoisting and re-emitting `(define name value)` everywhere — so `for (var i = 0; ...) { var r = i; } r` saw `r` as undefined because the inner `(define r ...)` shadowed the (un-hoisted) outer scope. Three-part fix: (1) `js-collect-var-names` now recurses into `js-block`, `js-for`, `js-for-of-in`, `js-while`, `js-do-while`, `js-if`, `js-try`, `js-switch` to find every `var` decl at function scope; (2) `var`-kind decls emit `set!` (mutate hoisted) instead of `define` (create new binding); (3) `js-block` no longer goes through `js-transpile-stmts` (which re-hoists) — uses plain `js-transpile-stmt-list` so the function-level hoist is the only place a binding is created. built-ins/Array: 17/45 → 18/45, String: 77/99 → 78/99. conformance.sh: 148/148.
-
-- 2026-05-08 — **`arr.length = N` extends the array (no-op for shrink).** `js-list-set!` was a no-op for the `length` key. Added a clause that pads with `js-undefined` via `js-pad-list!` when N > current length. Skipped truncation for now: the `pop-last!` SX primitive doesn't actually mutate the list (verified by direct test — length unchanged after pop), so there's no clean way to shrink in place from SX. Extension covers the common test262 cases (`var x = []; x.length = 5`). built-ins/Array: 16/45 → 17/45. conformance.sh: 148/148.
-
-- 2026-05-08 — **Arrays inherit unknown properties from `Array.prototype` (and onwards via `__proto__`).** `Array.prototype.myprop = 42; var x = []; x.myprop` was returning undefined and `x.hasOwnProperty(...)` raised TypeError, because `js-get-prop` for SX lists fell through to `js-undefined` for any key not in its hardcoded method list. Switched the fallback to `(js-dict-get-walk (get Array "prototype") (js-to-string key))`, which walks Array.prototype → (via the recent `__proto__` fallback) Object.prototype. Now custom Array.prototype properties propagate, and `arr.hasOwnProperty` resolves to `Object.prototype.hasOwnProperty`. built-ins/Array: 14/45 → 16/45. conformance.sh: 148/148.
-
-- 2026-05-08 — **Arrays accept numeric-string property keys (`arr["0"]`).** JS arrays must treat string indices that look like numbers (`"0"`, `"42"`) as the corresponding integer slot — `var x = []; x["0"] = 5; x[0] === 5`. `js-get-prop` and `js-list-set!` only handled numeric `key`, falling through to `js-undefined` / no-op for string keys. Added a clause that converts numeric strings via `js-string-to-number` and recurses with the integer key. built-ins/Array: 13/45 → 14/45. conformance.sh: 148/148.
-
-- 2026-05-07 — **JS top-level `var` no longer pollutes SX global env; call args use `js-args` to avoid `list` shadow.** `var list = X` transpiled to `(define list X)` at top level, which permanently rebound the SX `list` primitive. Then any later code (including the runtime itself) calling `(list ...)` got "Not callable: <X>". Two-part fix: (1) wrap the whole transpiled program in `(let () ...)` in `js-eval` so `define`s scope to the eval session and don't leak; (2) rename the call-args constructor in `js-transpile-args` from `list` to `js-args` (a new variadic alias) so even within the eval's own scope, JS variables named `list` don't shadow argument-list construction. Array-literal transpile keeps `list` (lists must be mutable). built-ins/Object: 41/50 → 42/50; Array.from on array-likes now works. conformance.sh: 148/148.
-
-- 2026-05-07 — **`Object.__callable__` returns `this` for `new Object()` no-args path.** `js-new-call Object` had `obj.__proto__ = Object.prototype` already set, but then Object.__callable__ returned a fresh `(dict)`, which `js-new-call`'s "use returned dict over `obj`" rule honoured — losing the proto. Added a `is-new` check (`this.__proto__ === Object.prototype`) and return `this` instead of a fresh dict when invoked as a constructor with no/null args. Now `new Object().__proto__ === Object.prototype`, `Object.prototype.isPrototypeOf(new Object())`, and `.constructor === Object` all work. built-ins/Object: 37/50 → 41/50. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-loose-eq` unwraps Number and Boolean wrappers (was String-only).** `Object(1.1) == 1.1` was returning `false`: loose-eq only had a clause for `__js_string_value__`. Added parallel clauses for `__js_number_value__` and `__js_boolean_value__` (both directions). Now `new Number(5) == 5`, `Object(true) == true`, etc. built-ins/Object: 26/50 → 37/50. conformance.sh: 148/148.
-
-- 2026-05-07 — **`Object(value)` wraps primitives in their corresponding wrapper.** Per ES spec, `Object('s') instanceof String === true`, `Object(42).constructor === Number`, etc. Was passing primitives through as-is, so `Object('s').constructor` was undefined. Added clauses to `Object.__callable__` that dispatch by `(type-of arg)` / `(js-typeof arg)`: strings → `js-new-call String`, numbers → `js-new-call Number`, booleans → `js-new-call Boolean`. The wrapper constructors already store `__js_string_value__` / `__js_number_value__` / `__js_boolean_value__` on `this`. built-ins/Object: 16/50 → 26/50. conformance.sh: 148/148.
-
-- 2026-05-07 — **`Object(null)` and `Object(undefined)` return a new empty object.** Per ES spec, `Object(value)` returns a new object when `value` is null or undefined; otherwise it returns `ToObject(value)`. Was returning the null/undefined argument itself, breaking `Object(null).toString()`. Added a clause to the `Object.__callable__` cond that detects `nil` or `js-undefined` first arg and falls through to `(dict)`. built-ins/Object: 15/50 → 16/50. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-num-from-string` uses SX `string->number` for exponent-form numbers.** Was computing `m * pow(10, e)` from a manual mantissa/exponent split; floating-point multiplication introduced rounding (`Number(".12345e-3") - 0.00012345 == 2.7e-20`). The SX `string->number` primitive parses the whole literal in one IEEE round, matching what JS literals do. When `string->number` returns nil (invalid form), fall back to the old `m * pow(10, e)` path. built-ins/Number: 42/50 → 43/50. conformance.sh: 148/148.
-
-- 2026-05-07 — **Constructors (`Object`/`Array`/`Number`/`String`/`Boolean`) carry `__proto__ = Function.prototype`.** Per spec, the constructors are functions and inherit from `Function.prototype`, so `Function.prototype.foo = 1; Array.foo === 1`. Previously the constructor dicts had no `__proto__`, so they only saw `Object.prototype` via the recent fallback — `Function.prototype` mutations were invisible. Added a `(begin (dict-set! ...))` post-init at the end of `runtime.sx` after the constructors are defined. Combined with the existing Object.prototype fallback, the proto chain now terminates correctly for the constructor → `Function.prototype` → `Object.prototype` walk. built-ins/Number: 41/50 → 42/50, built-ins/String: 75/99 → 78/99, built-ins/Array: 12/45 → 13/45. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-neg` preserves IEEE-754 negative zero.** `-0` was returning `0` (rational integer) because `js-neg` did `(- 0 (js-to-number a))`, which loses sign-of-zero in any arithmetic implementation that follows IEEE 754. Per JS spec, `-0` and `1/-0 === -Infinity` must be observable. Switched to `(* -1 (exact->inexact (js-to-number a)))` so the result is always a float and `-0.0` is preserved. Fixes `Math.asinh(-0)` and other `-0`-sensitive tests; `1/(-0) === -Infinity` now works. built-ins/Math: 41/45 → 42/45. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-div` coerces divisor to inexact before dividing.** When both operands are SX rationals (e.g. `(js-div 1 0)` from JS-transpiled `1/0` reaching the harness's `_isSameValue` +0/-0 check), SX integer-rational division throws "rational: division by zero" instead of producing JS `Infinity`. Wrapped the divisor in `(exact->inexact ...)` so it's always a float; integer-by-zero now returns `inf` (positive numerator), `-inf` (negative), `nan` (zero numerator), matching JS semantics. Was hitting harness assertion failures even when the test value matched expected. built-ins/Number: 37/50 → 41/50. built-ins/String: 77/99. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-to-string` throws `TypeError` when both toString and valueOf return non-primitives.** Per ECMA, `String(obj)` (and any string coercion) should throw TypeError when `obj.toString()` and `obj.valueOf()` both return objects. Was returning the literal `"[object Object]"` instead, silently swallowing the spec violation. Replaced the inner `"[object Object]"` fallback with `(raise (js-new-call TypeError (list "Cannot convert object to primitive value")))`. Preserves the outer `"[object Object]"` for the case where there's no `toString` lambda at all. Fixes `S8.12.8_A1`. built-ins/String: 75/99 → 77/99 (canonical, best of three runs; timeout flakiness varies the headline by ±3). conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-apply-fn` TypeError uses `type-of fn-val` not `(str fn-val)` to avoid runaway formatting.** Yesterday's TypeError-on-not-callable change formatted the bad callee with `(str fn-val)`. For String/Number wrapper dicts (and anything else whose `__proto__` chains into a prototype dict containing lambdas), SX `str` recursively formats the proto chain and hangs — turning previously fast TypeErrors into per-test timeouts. Switched to `(type-of fn-val)` (e.g. "dict is not a function"). Less specific but always terminates. built-ins/String: 73/99 → 75/99 (canonical). conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-apply-fn` raises a JS-level `TypeError` instance when the callee isn't callable.** Calling a non-callable (`'a'()`, `(1+2)()`, etc.) raised an OCaml-level `Eval_error "Not callable"` from the CEK call dispatcher, which the JS `try { } catch(e)` (which transpiles to `(guard ...)`) couldn't intercept. Added a `(js-function? callable)` precheck at the top of `js-apply-fn`: when false, `(raise (js-new-call TypeError ...))` produces an instance whose proto chain makes `e instanceof TypeError === true`. Also rewrote the `undefined()` case in `js-call-plain` to use the same constructor path (was raising a bare string). built-ins/String: 71/99 → 73/99 (canonical), 74/99 → 75/99 (isolated). conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-dict-get-walk` falls back to `Object.prototype` when an object has no `__proto__`.** Object literals (`{}`, `{a:1}`) didn't carry a `__proto__` link, so `({}).toString()` couldn't find `Object.prototype.toString` — and overriding `Object.prototype.toString` had no effect on plain objects. Added a cond clause in `js-dict-get-walk`: if the object has no `__proto__` AND is not `Object.prototype` itself, walk into `Object.prototype`. Termination guaranteed because Object.prototype is the recursion base case. Now `({}).toString() === "[object Object]"`, override of `Object.prototype.toString` propagates to plain objects, and `({a:1}).hasOwnProperty('a') === true`. built-ins/String: 69/99 → 71/99 (canonical), 71/99 → 74/99 (isolated). conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-new-call` accepts list-typed constructor returns (not just dict).** `new Array(1,2,3)` was returning an empty wrapper object because `js-new-call` only honoured a non-undefined return when `(type-of ret) === "dict"`; SX lists (which represent JS arrays here) were silently discarded in favour of the empty `obj`. Widened the check to accept `"list"` returns. Fixes `new Array(1,2,3).length`, `String(new Array(1,2,3))`, and any constructor whose body returns a list. built-ins/String 67/99 → 69/99 (canonical), 70/99 → 71/99 (isolated). conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-num-from-string` uses `pow` (float) instead of `js-pow-int` for the exponent.** Numeric literals like `1e20` and `100000000000000000000` were parsing as `-1457092405402533888` because `js-pow-int 10 20` overflows int64 (10^20 > 2^63). The OCaml SX `pow` primitive uses float-domain power and produces `1e+20` correctly. Replaced the single `(js-pow-int 10 e)` call in `js-num-from-string` with `(pow 10 e)`. Fixes `String(1e20)`, `String(1e30)`, `String(100000000000000000000)`, etc. With isolation built-ins/String 67/99 → 70/99. conformance.sh: 148/148.
-
-- 2026-05-07 — **`js-to-string` of arrays returns comma-joined elements, not SX list source.** `String([1,2,3])` was returning `"(1 2 3)"` (SX `(str v)` formatting) — should be `"1,2,3"`. Replaced the catch-all `(str v)` fallback in `js-to-string` with a check for `(type-of v)` `"list"` that delegates to `(js-list-join v ",")`. Fixes `String(new Array(...))`, `"" + arr`, and any implicit array-to-string coercion. built-ins/String 65/99 → 67/99. conformance.sh: 148/148.
-
-- 2026-05-07 — **JS lexer: handle `\uXXXX` and `\xXX` escape sequences in string literals.** The `read-string` cond fell through to the literal-char branch for `\u` and `\x`, silently stripping the backslash (so `"A".length` returned 5 instead of 1). Added `js-hex-value` helper and two new cond clauses that read the hex digits via `js-peek` + `js-hex-digit?`, compute the code point, and emit it via `char-from-code`. Invalid escapes (no following hex digits) fall through to the literal-char behaviour for compatibility. With test isolation (`--restart-every 1`) built-ins/String 65/99 → 68/99. Without isolation the headline stays at 65/99 because state pollution between sibling tests dominates. conformance.sh: 148/148.
-
-- 2026-05-07 — **Bump test262 runner default per-test timeout 5s→15s.** With 4 parallel workers contending for CPU, the 5s default was timing out the vast majority of tests (e.g. 85/99 on built-ins/String). Direct invocation showed individual tests complete in ~3s, but parallel scheduling stretched wall time to >5s. Bumping to 15s makes the scoreboard usable: built-ins/String 14.1% → 65.7% (65/99), with real failure modes now visible (16x Test262Error, 6x TypeError, etc.) instead of "85x Timeout" drowning the signal. Regenerated scoreboard to reflect the new state. conformance.sh: 148/148.
-
-- 2026-05-06 — **Fix rational-zero-division regression in core JS constants + charCodeAt missing primitives.** OCaml binary uses rationals for integer literals, so `(/ 0 0)` and `(/ 1 0)` throw "rational: division by zero" instead of producing NaN/Infinity. Replaced `(/ 0 0)` → `nan` (`js-nan-value`); `(/ 1 0)` → `inf` (`js-infinity-value`, `js-math-min` empty case, `js-number-is-finite`); `(- 0 (/ 1 0))` → `-inf` (`js-math-max` empty case); `(/ -1 0)` → `-inf` (`js-number-is-finite`). `js-max-value-approx` was looping forever (rationals never reach float infinity) — replaced with literal `1.7976931348623157e+308`. Fixed `charCodeAt` and string `.length` to use `(len s)` and `(char-code (char-at s idx))` instead of missing `unicode-len`/`unicode-char-code-at` primitives. conformance.sh: 0→148/148. Unit tests: 521/530 best run (baseline run was 417/530; both timeout-flaky).
-
-- 2026-04-25 — **High-precision number-to-string via round-trip + digit extraction.** `js-big-int-str-loop` extracts decimal digits from integer-valued float. `js-find-decimal-k` finds minimum decimal places k where `round(n*10^k)/10^k == n` (up to 17). `js-format-decimal-digits` inserts decimal point. `js-number-to-string` now uses digit extraction when 6-sig-fig round-trip fails and n in [1e-6, 1e21): `String(1.0000001)="1.0000001"`, `String(1/3)="0.3333333333333333"`. String test262 subset: 58→62/100. 529/530 unit, 148/148 slice.
-
-- 2026-04-25 — **String wrapper objects + number-to-string sci notation.** `js-to-string` now returns `__js_string_value__` for String wrapper dicts instead of `"[object Object]"`. `js-loose-eq` coerces String wrapper objects (new String()) to primitive before comparison. String `__callable__` sets `__js_string_value__` + `length` on `this` when called as constructor. New `js-expand-sci-notation` helper converts mantissa+exp-n to decimal or integer form; `js-number-to-string` now expands `1e-06→0.000001`, `1e+06→1000000`, fixes `1e21→1e+21`. String test262 subset: 45→58/100. 529/530 unit, 148/148 slice.
-
-- 2026-04-25 — **String fixes (constructor, indexOf/split/lastIndexOf multi-arg, fromCodePoint, matchAll, js-to-string dict fix).** Added `String.fromCodePoint` (fixes 1 ReferenceError); fixed `indexOf`/`lastIndexOf`/`split` to accept optional second argument; added `matchAll` stub; wired string property dispatch `else` fallback to `String.prototype` (fixes `'a'.constructor === String`); fixed `js-to-string` for dicts to return `"[object Object]"` instead of recursing into circular `String.prototype.constructor` structure. Scoreboard: String 42→43, timeouts 32→13. Total 162→202/300 (54%→67.3%). 529/530 unit, 148/148 slice.
-
-- 2026-04-25 — **Number/String wrapper constructor-detection fix + Array.prototype.toString + js-to-number for wrappers + `>>>` operator.** `Number.__callable__` and `String.__callable__` now check `this.__proto__ === Number/String.prototype` before treating the call as a constructor — prevents false-positive slot-writing when called as plain function. `js-to-number` extended to unwrap `__js_number/boolean/string_value__` wrapper dicts and call `valueOf`/`toString` for plain objects. `Array.prototype.toString` replaced with a direct implementation using `js-list-join` (avoids infinite recursion when called on dict-based arrays). `>>>` (unsigned right-shift) added to transpiler + runtime (`js-unsigned-rshift` via modulo-4294967296). String test262 subset: 62→66/100. 529/530 unit, 147/148 slice.
-
-- 2026-04-25 — **Math methods (trig/log/hyperbolic/bit ops).** Added 22 missing Math methods to `runtime.sx`: `sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `atan2`, `sinh`, `cosh`, `tanh`, `asinh`, `acosh`, `atanh`, `exp`, `log`, `log2`, `log10`, `expm1`, `log1p`, `clz32`, `imul`, `fround`. All use existing SX primitives. `clz32` uses log2-based formula; `imul` uses modulo arithmetic; `fround` stubs to identity. Addresses 36x "TypeError: not a function" in built-ins/Math (43% → ~79% expected). 529/530 unit (unchanged), 148/148 slice. Commit `5f38e49b`.
-
-- 2026-04-25 — **`var` hoisting.** Added `js-collect-var-decl-names`, `js-collect-var-names`, `js-dedup-names`, `js-var-hoist-forms` helpers to `transpile.sx`. Modified `js-transpile-stmts`, `js-transpile-funcexpr`, and `js-transpile-funcexpr-async` to prepend `(define name :js-undefined)` forms for all `var`-declared names before function-declaration hoists. Shallow collection (direct statements only). 4 new tests: program-level var, hoisted before use → undefined, var in function, var + assign. 529/530 unit (+4), 148/148 slice unchanged. Commit `11315d91`.
-
-- 2026-04-25 — **ASI (Automatic Semicolon Insertion).** Lexer: added `:nl` (newline-before) boolean to every token dict; `skip-ws!` sets it true when consuming `\n`/`\r`; `scan!` resets it to `false` at the start of each token scan. Parser: new `jp-token-nl?` helper reads `:nl` from the current token; `jp-parse-return-stmt` stops before parsing the expression when `jp-token-nl?` is true (restricted production: `return\nvalue` → `return undefined`). 4 new tests (flag presence, flag value, restricted return). 525/526 unit (+4), 148/148 slice unchanged. Commit `ae86579a`.
-
 - 2026-04-23 — scaffold landed: lib/js/{lexer,parser,transpile,runtime}.sx stubs + test.sh. 7/7 smoke tests pass (js-tokenize/js-parse/js-transpile stubs + js-to-boolean coercion cases).
 - 2026-04-23 — Phase 1 (Lexer) complete: numbers (int/float/hex/exp/leading-dot), strings (escapes), idents/keywords, punctuation, all operators (1-4 char, longest-match), // and /* */ comments. 38/38 tests pass. Gotchas found: `peek` and `emit!` are primitives (shadowed to `js-peek`, `js-emit!`); `cond` clauses take ONE body only, multi-expr needs `(do ...)` wrapper.
 - 2026-04-23 — Phase 2 (Pratt expression parser) complete: literals, binary precedence (w/ `**` right-assoc), unary (`- + ! ~ typeof void`), member access (`.`/`[]`), call chains, array/object literals (ident+string+number keys), ternary, arrow fns (zero/one/many params; curried), assignment (right-assoc incl. compound `+=` etc.). AST node shapes all match the `js-*` names already wired. 47 new tests, 85/85 total. Most of the Phase 2 scaffolding was already written in an earlier session — this iteration verified every path, added the parser test suite, and greened everything on the first pass. No new gotchas beyond Phase 1.
@@ -507,6 +241,8 @@ Append-only record of completed iterations. Loop writes one line per iteration:
   - 29× Timeout (slow string/regex loops)
   - 16× ReferenceError — still some missing globals
 
+- 2026-04-25 — **Regex engine (lib/js/regex.sx) + let/const TDZ infrastructure.** New file `lib/js/regex.sx`: 39-form pure-SX recursive backtracking engine installed via `js-regex-platform-override!`. Covers literals, `.`, `\d\w\s` + negations, `[abc]/[^abc]/[a-z]` char classes, `^\$\b\B` anchors, greedy+lazy quantifiers (`* + ? {n,m} *? +? ??`), capturing groups, non-capturing `(?:...)`, alternation `a|b`, flags `i`/`g`/`m`. Groups: match inner first → set capture → match rest (correct boundary), avoids including rest-nodes content in capture. Greedy: expand-first then backtrack (correct longest-match semantics). `js-regex-match-all` for String.matchAll. Fixed `String.prototype.match` to use platform engine (was calling stub). TDZ infrastructure added to `runtime.sx`: `__js_tdz_sentinel__` (unique sentinel dict), `js-tdz?`, `js-tdz-check`. `transpile.sx` passes `kind` through `js-transpile-var → js-vardecl-forms` (no behavioral change yet — infrastructure ready). `test262-runner.py` and `conformance.sh` updated to load `regex.sx` as epoch 6/50. Unit: **559/560** (was 522/522 before regex tests added, now +38 new tests; 1 pre-existing backtick failure). Conformance: **148/148** (unchanged). Gotchas: (1) `sx_insert_near` on a pattern inside a top-level function body inserts there (not at top level) — need to use `sx_insert_near` on a top-level symbol name. (2) Greedy quantifier must expand-first before trying rest-nodes; the naive "try rest at each step" produces lazy behavior. (3) Capturing groups must match inner nodes in isolation first (to get the group's end position) then match rest — appending inner+rest-nodes would include rest in the capture string.
+
 ## Phase 3-5 gotchas
 
 Worth remembering for later phases:
@@ -525,17 +261,7 @@ Anything that would require a change outside `lib/js/` goes here with a minimal
 
 - **Pending-Promise await** — our `js-await-value` drains microtasks and unwraps *settled* Promises; it cannot truly suspend a JS fiber and resume later. Every Promise that settles eventually through the synchronous `resolve`/`reject` + microtask path works. A Promise that never settles without external input (e.g. a real `setTimeout` waiting on the event loop) would hit the `"await on pending Promise (no scheduler)"` error. Proper async suspension would need the JS eval path to run under `cek-step-loop` (not `eval-expr` → `cek-run`) and treat `await pending-Promise` as a `perform` that registers a resume thunk on the Promise's callback list. Non-trivial plumbing; out of scope for this phase. Consider it a Phase 9.5 item.
 
-- **Regex platform primitives** — runtime ships a substring-based stub (`js-regex-stub-test` / `-exec`). Overridable via `js-regex-platform-override!` so a real engine can be dropped in. Required platform-primitive surface:
-  - `regex-compile pattern flags` — build an opaque compiled handle
-  - `regex-test compiled s` → bool
-  - `regex-exec compiled s` → match dict `{match index input groups}` or nil
-  - `regex-match-all compiled s` → list of match dicts (or empty list)
-  - `regex-replace compiled s replacement` → string
-  - `regex-replace-fn compiled s fn` → string (fn receives match+groups, returns string)
-  - `regex-split compiled s` → list of strings
-  - `regex-source compiled` → string
-  - `regex-flags compiled` → string
-  Ideally a single `(js-regex-platform-install-all! platform)` entry point the host calls once at boot. OCaml would wrap `Str` / `Re` or a dedicated regex lib; JS host can just delegate to the native `RegExp`.
+- ~~**Regex platform primitives**~~ **RESOLVED** — `lib/js/regex.sx` ships a pure-SX recursive backtracking engine. Installs via `js-regex-platform-override!` at load. Covers: literals, `.`, `\d\w\s` and negations, `[abc]` / `[^abc]` / ranges, `^` `$` `\b \B`, `* + ? {n,m}` (greedy + lazy), capturing + non-capturing groups, alternation `a|b`, flags `i` (case-insensitive), `g` (global, advances lastIndex), `m` (multiline anchors). `js-regex-match-all` for String.matchAll. String.prototype.match regex path updated to use platform engine (was calling stub). 34 new unit tests added (5000–5033). Conformance: 148/148 (unchanged — slice had no regex fixtures).
 
 - **Math trig + transcendental primitives missing.** The scoreboard shows 34× "TypeError: not a function" across the Math category — every one a test calling `Math.sin/cos/tan/log/…` on our runtime. We shim `Math` via `js-global`; the SX runtime supplies `sqrt`, `pow`, `abs`, `floor`, `ceil`, `round` and a hand-rolled `trunc`/`sign`/`cbrt`/`hypot`. Nothing else. Missing platform primitives (each is a one-line OCaml/JS binding, but a primitive all the same — we can't land approximation polynomials from inside the JS shim, they'd blow `Math.sin(1e308)` precision):
   - Trig: `sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `atan2`

plans/ruby-on-sx.md

@@ -0,0 +1,124 @@
+# Ruby-on-SX: fibers + blocks + open classes on delimited continuations
+
+The headline showcase is **fibers** — Ruby's `Fiber.new { … Fiber.yield v … }` / `Fiber.resume` are textbook delimited continuations with sugar. MRI implements them by swapping C stacks; on SX they fall out of the existing `perform`/`cek-resume` machinery for free. Plus blocks/yield (lexical escape continuations, same shape as Smalltalk's non-local return), method_missing, and singleton classes.
+
+End-state goal: Ruby 2.7-flavoured subset, Enumerable mixin, fibers + threads-via-fibers (no real OS threads), method_missing-driven DSLs, ~150 hand-written + classic programs.
+
+## Scope decisions (defaults — override by editing before we spawn)
+
+- **Syntax:** Ruby 2.7. No 3.x pattern matching, no rightward assignment, no endless methods. We pick 2.7 because it's the biggest semantic surface that still parses cleanly.
+- **Conformance:** "Reads like Ruby, runs like Ruby." Slice of RubySpec (Core + Library subset), not full RubySpec.
+- **Test corpus:** custom + curated RubySpec slice. Plus classic programs: fiber-based generator, internal DSL with method_missing, mixin-based Enumerable on a custom class.
+- **Out of scope:** real threads, GIL, refinements, `binding_of_caller` from non-Ruby contexts, Encoding object beyond UTF-8/ASCII-8BIT, RubyVM::* introspection beyond bytecode-disassembly placeholder, IO subsystem beyond `puts`/`gets`/`File.read`.
+- **Symbols:** SX symbols. Strings are mutable copies; symbols are interned.
+
+## Ground rules
+
+- **Scope:** only touch `lib/ruby/**` and `plans/ruby-on-sx.md`. Don't edit `spec/`, `hosts/`, `shared/`, or any other `lib/<lang>/**`. Ruby primitives go in `lib/ruby/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
+
+```
+Ruby source
+    │
+    ▼
+lib/ruby/tokenizer.sx   — keywords, ops, %w[], %i[], heredocs (deferred), regex (deferred)
+    │
+    ▼
+lib/ruby/parser.sx      — AST: classes, modules, methods, blocks, calls
+    │
+    ▼
+lib/ruby/transpile.sx   — AST → SX AST (entry: rb-eval-ast)
+    │
+    ▼
+lib/ruby/runtime.sx     — class table, MOP, dispatch, fibers, primitives
+```
+
+Core mapping:
+- **Object** = SX dict `{:class :ivars :singleton-class?}`. Instance variables live in `ivars` keyed by symbol.
+- **Class** = SX dict `{:name :superclass :methods :class-methods :metaclass :includes :prepends}`. Class table is flat.
+- **Method dispatch** = lookup walks ancestor chain (prepended → class → included modules → superclass → …). Falls back to `method_missing` with a `Symbol`+args.
+- **Block** = lambda + escape continuation. `yield` invokes the block in current context. `return` from within a block invokes the enclosing-method's escape continuation.
+- **Proc** = lambda without strict arity. `Proc.new` + `proc {}`.
+- **Lambda** = lambda with strict arity + `return`-returns-from-lambda semantics.
+- **Fiber** = pair of continuations (resume-k, yield-k) wrapped in a record. `Fiber.new { … }` builds it; `Fiber.resume` invokes the resume-k; `Fiber.yield` invokes the yield-k. Built directly on `perform`/`cek-resume`.
+- **Module** = class without instance allocation. `include` puts it in the chain; `prepend` puts it earlier; `extend` puts it on the singleton.
+- **Singleton class** = lazily allocated per-object class for `def obj.foo` definitions.
+- **Symbol** = interned SX symbol. `:foo` reads as `(quote foo)` flavour.
+
+## Roadmap
+
+### Phase 1 — tokenizer + parser
+- [ ] Tokenizer: keywords (`def end class module if unless while until do return yield begin rescue ensure case when then else elsif`), identifiers (lowercase = local/method, `@` = ivar, `@@` = cvar, `$` = global, uppercase = constant), numbers (int, float, `0x` `0o` `0b`, `_` separators), strings (`"…"` interpolation, `'…'` literal, `%w[a b c]`, `%i[a b c]`), symbols `:foo` `:"…"`, operators (`+ - * / % ** == != < > <= >= <=> === =~ !~ << >> & | ^ ~ ! && || and or not`), `:: . , ; ( ) [ ] { } -> => |`, comments `#`
+- [ ] Parser: program is sequence of statements separated by newlines or `;`; method def `def name(args) … end`; class `class Foo < Bar … end`; module `module M … end`; block `do |a, b| … end` and `{ |a, b| … }`; call sugar (no parens), `obj.method`, `Mod::Const`; arg shapes (positional, default, splat `*args`, double-splat `**opts`, block `&blk`)
+- [ ] If/while/case expressions (return values), `unless`/`until`, postfix modifiers
+- [ ] Begin/rescue/ensure/retry, raise, raise with class+message
+- [ ] Unit tests in `lib/ruby/tests/parse.sx`
+
+### Phase 2 — object model + sequential eval
+- [ ] Class table bootstrap: `BasicObject`, `Object`, `Kernel`, `Module`, `Class`, `Numeric`, `Integer`, `Float`, `String`, `Symbol`, `Array`, `Hash`, `Range`, `NilClass`, `TrueClass`, `FalseClass`, `Proc`, `Method`
+- [ ] `rb-eval-ast`: literals, variables (local, ivar, cvar, gvar, constant), assignment (single and parallel `a, b = 1, 2`, splat receive), method call, message dispatch
+- [ ] Method lookup walks ancestor chain; cache hit-class per `(class, selector)`
+- [ ] `method_missing` fallback constructing args list
+- [ ] `super` and `super(args)` — lookup in defining class's superclass
+- [ ] Singleton class allocation on first `def obj.foo` or `class << obj`
+- [ ] `nil`, `true`, `false` are singletons of their classes; tagged values aren't boxed
+- [ ] Constant lookup (lexical-then-inheritance) with `Module.nesting`
+- [ ] 60+ tests in `lib/ruby/tests/eval.sx`
+
+### Phase 3 — blocks + procs + lambdas
+- [ ] Method invocation captures escape continuation `^k` for `return`; binds it as block's escape
+- [ ] `yield` invokes implicit block
+- [ ] `block_given?`, `&blk` parameter, `&proc` arg unpacking
+- [ ] `Proc.new`, `proc { }`, `lambda { }` (or `->(x) { x }`)
+- [ ] Lambda strict arity + lambda-local `return` semantics
+- [ ] Proc lax arity (`a, b, c` unpacks Array; missing args nil)
+- [ ] `break`, `next`, `redo` — `break` is escape-from-loop-or-block; `next` is escape-from-block-iteration; `redo` re-runs current iteration
+- [ ] 30+ tests in `lib/ruby/tests/blocks.sx`
+
+### Phase 4 — fibers (THE SHOWCASE)
+- [ ] `Fiber.new { |arg| … Fiber.yield v … }` allocates a fiber record with paired continuations
+- [ ] `Fiber.resume(args…)` resumes the fiber, returning the value passed to `Fiber.yield`
+- [ ] `Fiber.yield(v)` from inside the fiber suspends and returns control to the resumer
+- [ ] `Fiber.current` from inside the fiber
+- [ ] `Fiber#alive?`, `Fiber#raise` (deferred)
+- [ ] `Fiber.transfer` — symmetric coroutines (resume from any side)
+- [ ] Classic programs in `lib/ruby/tests/programs/`:
+  - [ ] `generator.rb` — pull-style infinite enumerator built on fibers
+  - [ ] `producer-consumer.rb` — bounded buffer with `Fiber.transfer`
+  - [ ] `tree-walk.rb` — recursive tree walker that yields each node, driven by `Fiber.resume`
+- [ ] `lib/ruby/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
+
+### Phase 5 — modules + mixins + metaprogramming
+- [ ] `include M` — appends M's methods after class methods in chain
+- [ ] `prepend M` — prepends M before class methods
+- [ ] `extend M` — adds M to singleton class
+- [ ] `Module#ancestors`, `Module#included_modules`
+- [ ] `define_method`, `class_eval`, `instance_eval`, `module_eval`
+- [ ] `respond_to?`, `respond_to_missing?`, `method_missing`
+- [ ] `Object#send`, `Object#public_send`, `Object#__send__`
+- [ ] `Module#method_added`, `singleton_method_added` hooks
+- [ ] Hooks: `included`, `extended`, `inherited`, `prepended`
+- [ ] Internal-DSL classic program: `lib/ruby/tests/programs/dsl.rb`
+
+### Phase 6 — stdlib drive
+- [ ] `Enumerable` mixin: `each` (abstract), `map`, `select`/`filter`, `reject`, `reduce`/`inject`, `each_with_index`, `each_with_object`, `take`, `drop`, `take_while`, `drop_while`, `find`/`detect`, `find_index`, `any?`, `all?`, `none?`, `one?`, `count`, `min`, `max`, `min_by`, `max_by`, `sort`, `sort_by`, `group_by`, `partition`, `chunk`, `each_cons`, `each_slice`, `flat_map`, `lazy`
+- [ ] `Comparable` mixin: `<=>`, `<`, `<=`, `>`, `>=`, `==`, `between?`, `clamp`
+- [ ] `Array`: indexing, slicing, `push`/`pop`/`shift`/`unshift`, `concat`, `flatten`, `compact`, `uniq`, `sort`, `reverse`, `zip`, `dig`, `pack`/`unpack` (deferred)
+- [ ] `Hash`: `[]`, `[]=`, `delete`, `merge`, `each_pair`, `keys`, `values`, `to_a`, `dig`, `fetch`, default values, default proc
+- [ ] `Range`: `each`, `step`, `cover?`, `include?`, `size`, `min`, `max`
+- [ ] `String`: indexing, slicing, `split`, `gsub` (string-arg version, regex deferred), `sub`, `upcase`, `downcase`, `strip`, `chomp`, `chars`, `bytes`, `to_i`, `to_f`, `to_sym`, `*`, `+`, `<<`, format with `%`
+- [ ] `Integer`: `times`, `upto`, `downto`, `step`, `digits`, `gcd`, `lcm`
+- [ ] Drive corpus to 200+ green
+
+## Progress log
+
+_Newest first._
+
+- _(none yet)_
+
+## Blockers
+
+- _(none yet)_

plans/smalltalk-on-sx.md

@@ -0,0 +1,116 @@
+# 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
+- [ ] Tokenizer: identifiers, keywords (`foo:`), binary selectors (`+`, `==`, `,`, `->`, `~=` etc.), numbers (radix `16r1F`, scaled `1.5s2`), strings `'…''…'`, characters `$c`, symbols `#foo` `#'foo bar'` `#+`, byte arrays `#[1 2 3]`, literal arrays `#(1 #foo 'x')`, comments `"…"`
+- [ ] Parser: chunk format (`! !` separators), class definitions (`Object subclass: #X instanceVariableNames: '…' classVariableNames: '…' …`), method definitions (`extend: #Foo with: 'bar ^self'`), pragmas `<primitive: 1>`, blocks `[:a :b | | t1 t2 | …]`, cascades, message precedence (unary > binary > keyword)
+- [ ] Unit tests in `lib/smalltalk/tests/parse.sx`
+
+### Phase 2 — object model + sequential eval
+- [ ] Class table + bootstrap: `Object`, `Behavior`, `Class`, `Metaclass`, `UndefinedObject`, `Boolean`/`True`/`False`, `Number`/`Integer`/`Float`, `String`, `Symbol`, `Array`, `Block`
+- [ ] `smalltalk-eval-ast`: literals, variable reference, assignment, message send, cascade, sequence, return
+- [ ] Method lookup: walk class → superclass; cache hit-class on `(class, selector)`
+- [ ] `doesNotUnderstand:` fallback constructing `Message` object
+- [ ] `super` send (lookup starts at superclass of *defining* class, not receiver class)
+- [ ] 30+ tests in `lib/smalltalk/tests/eval.sx`
+
+### 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._
+
+- _(none yet)_
+
+## Blockers
+
+_Shared-file issues that need someone else to fix. Minimal repro only._
+
+- _(none yet)_

plans/tcl-on-sx.md

@@ -0,0 +1,127 @@
+# Tcl-on-SX: uplevel/upvar = stack-walking delcc, everything-is-a-string
+
+The headline showcase is **uplevel/upvar** — Tcl's superpower for defining your own control structures. `uplevel` evaluates a script in the *caller's* stack frame; `upvar` aliases a variable in the caller. On a normal language host this requires deep VM cooperation; on SX it falls out of the env-chain made first-class via captured continuations. Plus the *Dodekalogue* (12 rules), command-substitution everywhere, and "everything is a string" homoiconicity.
+
+End-state goal: Tcl 8.6-flavoured subset, the Dodekalogue parser, namespaces, `try`/`catch`/`return -code`, `coroutine` (built on fibers), classic programs that show off uplevel-driven DSLs, ~150 hand-written tests.
+
+## Scope decisions (defaults — override by editing before we spawn)
+
+- **Syntax:** Tcl 8.6 surface. The 12-rule Dodekalogue. Brace-quoted scripts deferred-evaluate; double-quoted ones substitute.
+- **Conformance:** "Reads like Tcl, runs like Tcl." Slice of Tcl's own test suite, not full TCT.
+- **Test corpus:** custom + curated `tcl-tests/` slice. Plus classic programs: define-your-own `for-each-line`, expression-language compiler-in-Tcl, fiber-based event loop.
+- **Out of scope:** Tk, sockets beyond a stub, threads (mapped to `coroutine` only), `package require` of binary loadables, `dde`/`registry` Windows shims, full `clock format` locale support.
+- **Channels:** `puts` and `gets` on `stdout`/`stdin`/`stderr`; `open` on regular files; no async I/O beyond what `coroutine` gives.
+
+## Ground rules
+
+- **Scope:** only touch `lib/tcl/**` and `plans/tcl-on-sx.md`. Don't edit `spec/`, `hosts/`, `shared/`, or any other `lib/<lang>/**`. Tcl primitives go in `lib/tcl/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
+
+```
+Tcl source
+    │
+    ▼
+lib/tcl/tokenizer.sx   — the Dodekalogue: words, [..], ${..}, "..", {..}, ;, \n, \, #
+    │
+    ▼
+lib/tcl/parser.sx      — list-of-words AST (script = list of commands; command = list of words)
+    │
+    ▼
+lib/tcl/transpile.sx   — AST → SX AST (entry: tcl-eval-script)
+    │
+    ▼
+lib/tcl/runtime.sx     — env stack, command table, uplevel/upvar, coroutines, BIFs
+```
+
+Core mapping:
+- **Value** = string. Internally we cache a "shimmer" representation (list, dict, integer, double) for performance, but every value can be re-stringified.
+- **Variable** = entry in current frame's env. Frames form a stack; level-0 is the global frame.
+- **Command** = entry in command table; first word of any list dispatches into it. User-defined via `proc`. Built-ins are SX functions registered in the table.
+- **Frame** = `{:locals (dict) :level n :parent frame}`. Each `proc` call pushes a frame; commands run in current frame.
+- **`uplevel #N script`** = walk frame chain to absolute level N (or relative if no `#`); evaluate script in that frame's env.
+- **`upvar [#N] varname localname`** = bind `localname` in the current frame as an alias to `varname` in the level-N frame (env-chain delegate).
+- **`return -code N`** = control flow as integers: 0=ok, 1=error, 2=return, 3=break, 4=continue. `catch` traps any non-zero; `try` adds named handlers.
+- **`coroutine`** = fiber on top of `perform`/`cek-resume`. `yield`/`yieldto` suspend; calling the coroutine command resumes.
+- **List / dict** = list-shaped string ("element1 element2 …") with a cached parsed form. Modifications dirty the string cache.
+
+## Roadmap
+
+### Phase 1 — tokenizer + parser (the Dodekalogue)
+- [ ] Tokenizer applying the 12 rules:
+  1. Commands separated by `;` or newlines
+  2. Words separated by whitespace within a command
+  3. Double-quoted words: `\` escapes + `[…]` + `${…}` + `$var` substitution
+  4. Brace-quoted words: literal, no substitution; brace count must balance
+  5. Argument expansion: `{*}list`
+  6. Command substitution: `[script]` evaluates script, takes its return value
+  7. Variable substitution: `$name`, `${name}`, `$arr(idx)`, `$arr($i)`
+  8. Backslash substitution: `\n`, `\t`, `\\`, `\xNN`, `\uNNNN`, `\<newline>` continues
+  9. Comments: `#` only at the start of a command
+  10. Order of substitution is left-to-right, single-pass
+  11. Substitutions don't recurse — substituted text is not re-parsed
+  12. The result of any substitution is the value, not a new script
+- [ ] Parser: script = list of commands; command = list of words; word = literal string + list of substitutions
+- [ ] Unit tests in `lib/tcl/tests/parse.sx`
+
+### Phase 2 — sequential eval + core commands
+- [ ] `tcl-eval-script`: walk command list, dispatch each first-word into command table
+- [ ] Core commands: `set`, `unset`, `incr`, `append`, `lappend`, `puts`, `gets`, `expr`, `if`, `while`, `for`, `foreach`, `switch`, `break`, `continue`, `return`, `error`, `eval`, `subst`, `format`, `scan`
+- [ ] `expr` is its own mini-language — operator precedence, function calls (`sin`, `sqrt`, `pow`, `abs`, `int`, `double`), variable substitution, command substitution
+- [ ] String commands: `string length`, `string index`, `string range`, `string compare`, `string match`, `string toupper`, `string tolower`, `string trim`, `string map`, `string repeat`, `string first`, `string last`, `string is`, `string cat`
+- [ ] List commands: `list`, `lindex`, `lrange`, `llength`, `lreverse`, `lsearch`, `lsort`, `lsort -integer/-real/-dictionary`, `lreplace`, `linsert`, `concat`, `split`, `join`
+- [ ] Dict commands: `dict create`, `dict get`, `dict set`, `dict unset`, `dict exists`, `dict keys`, `dict values`, `dict size`, `dict for`, `dict update`, `dict merge`
+- [ ] 60+ tests in `lib/tcl/tests/eval.sx`
+
+### Phase 3 — proc + uplevel + upvar (THE SHOWCASE)
+- [ ] `proc name args body` — register user-defined command; args supports defaults `{name default}` and rest `args`
+- [ ] Frame stack: each proc call pushes a frame with locals dict; pop on return
+- [ ] `uplevel ?level? script` — evaluate `script` in level-N frame's env; default level is 1 (caller). `#0` is global, `#1` is relative-1
+- [ ] `upvar ?level? otherVar localVar ?…?` — alias localVar to a variable in level-N frame; reads/writes go through the alias
+- [ ] `info level`, `info level N`, `info frame`, `info vars`, `info locals`, `info globals`, `info commands`, `info procs`, `info args`, `info body`
+- [ ] `global var ?…?` — alias to global frame (sugar for `upvar #0 var var`)
+- [ ] `variable name ?value?` — namespace-scoped global
+- [ ] Classic programs in `lib/tcl/tests/programs/`:
+  - [ ] `for-each-line.tcl` — define your own loop construct using `uplevel`
+  - [ ] `assert.tcl` — assertion macro that reports caller's line
+  - [ ] `with-temp-var.tcl` — scoped variable rebind via `upvar`
+- [ ] `lib/tcl/conformance.sh` + runner, `scoreboard.json` + `scoreboard.md`
+
+### Phase 4 — control flow + error handling
+- [ ] `return -code (ok|error|return|break|continue|N) -errorinfo … -errorcode … -level N value`
+- [ ] `catch script ?resultVar? ?optionsVar?` — runs script, returns code; sets resultVar to return value/message; optionsVar to the dict
+- [ ] `try script ?on code var body ...? ?trap pattern var body...? ?finally body?`
+- [ ] `throw type message`
+- [ ] `error message ?info? ?code?`
+- [ ] Stack-trace with `errorInfo` / `errorCode`
+- [ ] 30+ tests in `lib/tcl/tests/error.sx`
+
+### Phase 5 — namespaces + ensembles
+- [ ] `namespace eval ns body`, `namespace current`, `namespace which`, `namespace import`, `namespace export`, `namespace forget`, `namespace delete`
+- [ ] Qualified names: `::ns::cmd`, `::ns::var`
+- [ ] Ensembles: `namespace ensemble create -map { sub1 cmd1 sub2 cmd2 }`
+- [ ] `namespace path` for resolution chain
+- [ ] `proc` and `variable` work inside namespaces
+
+### Phase 6 — coroutines + drive corpus
+- [ ] `coroutine name cmd ?args…?` — start a coroutine; future calls to `name` resume it
+- [ ] `yield ?value?` — suspend, return value to resumer
+- [ ] `yieldto cmd ?args…?` — symmetric transfer
+- [ ] `coroutine` semantics built on fibers (same delcc primitive as Ruby fibers)
+- [ ] Classic programs: `event-loop.tcl` — cooperative scheduler with multiple coroutines
+- [ ] System: `clock seconds`, `clock format`, `clock scan` (subset)
+- [ ] File I/O: `open`, `close`, `read`, `gets`, `puts -nonewline`, `flush`, `eof`, `seek`, `tell`
+- [ ] Drive corpus to 150+ green
+- [ ] Idiom corpus — `lib/tcl/tests/idioms.sx` covering classic Welch/Jones idioms
+
+## Progress log
+
+_Newest first._
+
+- _(none yet)_
+
+## Blockers
+
+- _(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 common-lisp apl ruby tcl; 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 loops/common-lisp loops/apl loops/ruby loops/tcl"
 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 12 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 ... 11=tcl)
 #   Ctrl-B + d to detach (loops keep running, SSH-safe)
 #
 # Stop: ./scripts/sx-loops-down.sh
@@ -38,8 +38,13 @@ declare -A BRIEFING=(
   [haskell]=haskell-loop.md
   [js]=loop.md
   [hs]=hs-loop.md
+  [smalltalk]=smalltalk-loop.md
+  [common-lisp]=common-lisp-loop.md
+  [apl]=apl-loop.md
+  [ruby]=ruby-loop.md
+  [tcl]=tcl-loop.md
 )
-ORDER=(lua prolog forth erlang haskell js hs)
+ORDER=(lua prolog forth erlang haskell js hs smalltalk common-lisp apl ruby tcl)
 
 mkdir -p "$WORKTREE_BASE"
 
@@ -60,13 +65,13 @@ for lang in "${ORDER[@]}"; do
   fi
 done
 
-# Create tmux session with 7 windows, each cwd in its worktree
+# Create tmux session with one window per language, each cwd in its worktree
 tmux new-session -d -s "$SESSION" -n "${ORDER[0]}" -c "$WORKTREE_BASE/${ORDER[0]}"
 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 ${#ORDER[@]} claude sessions..."
 for lang in "${ORDER[@]}"; do
   tmux send-keys -t "$SESSION:$lang" "claude" C-m
 done
@@ -89,10 +94,10 @@ for lang in "${ORDER[@]}"; do
 done
 
 echo ""
-echo "Done. 7 loops started in tmux session '$SESSION', each in its own worktree."
+echo "Done. ${#ORDER[@]} 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..11>  (0=lua 1=prolog 2=forth 3=erlang 4=haskell 5=js 6=hs 7=smalltalk 8=common-lisp 9=apl 10=ruby 11=tcl)"
 echo "  List:      Ctrl-B w"
 echo "  Detach:    Ctrl-B d"
 echo "  Stop:      ./scripts/sx-loops-down.sh"

scripts/sx-primitives-up.sh

@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+# Spawn a single claude session to implement SX primitives in sequence.
+# Runs in its own git worktree on branch sx-primitives from architecture.
+#
+# Usage: ./scripts/sx-primitives-up.sh [interval]
+#   interval defaults to self-paced (omit to let model decide)
+#
+# After the script prints done:
+#   tmux a -t sx-primitives
+#   Ctrl-B + d to detach
+#
+# Stop: ./scripts/sx-primitives-down.sh
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+SESSION="sx-primitives"
+WORKTREE="$ROOT"          # runs in the main worktree — architecture branch
+BRANCH="architecture"
+INTERVAL="${1:-}"
+BOOT_WAIT=20
+
+if tmux has-session -t "$SESSION" 2>/dev/null; then
+  echo "Session '$SESSION' already exists."
+  echo "  Attach:  tmux a -t $SESSION"
+  echo "  Kill:    ./scripts/sx-primitives-down.sh"
+  exit 1
+fi
+
+# Write settings into the main worktree .claude dir
+SETTINGS_DIR="$ROOT/.claude"
+mkdir -p "$SETTINGS_DIR"
+cat > "$SETTINGS_DIR/settings.local.json" <<'SETTINGS'
+{
+  "permissions": {
+    "allow": [
+      "mcp__sx-tree__sx_summarise",
+      "mcp__sx-tree__sx_read_tree",
+      "mcp__sx-tree__sx_read_subtree",
+      "mcp__sx-tree__sx_get_context",
+      "mcp__sx-tree__sx_find_all",
+      "mcp__sx-tree__sx_find_across",
+      "mcp__sx-tree__sx_get_siblings",
+      "mcp__sx-tree__sx_validate",
+      "mcp__sx-tree__sx_replace_node",
+      "mcp__sx-tree__sx_insert_child",
+      "mcp__sx-tree__sx_insert_near",
+      "mcp__sx-tree__sx_delete_node",
+      "mcp__sx-tree__sx_wrap_node",
+      "mcp__sx-tree__sx_rename_symbol",
+      "mcp__sx-tree__sx_replace_by_pattern",
+      "mcp__sx-tree__sx_rename_across",
+      "mcp__sx-tree__sx_write_file",
+      "mcp__sx-tree__sx_pretty_print",
+      "mcp__sx-tree__sx_eval",
+      "mcp__sx-tree__sx_harness_eval",
+      "mcp__sx-tree__sx_macroexpand",
+      "mcp__sx-tree__sx_trace",
+      "mcp__sx-tree__sx_deps",
+      "mcp__sx-tree__sx_diff",
+      "mcp__sx-tree__sx_diff_branch",
+      "mcp__sx-tree__sx_changed",
+      "mcp__sx-tree__sx_blame",
+      "mcp__sx-tree__sx_build",
+      "mcp__sx-tree__sx_build_manifest",
+      "mcp__sx-tree__sx_build_bytecode",
+      "mcp__sx-tree__sx_test",
+      "mcp__sx-tree__sx_format_check",
+      "mcp__sx-tree__sx_comp_list",
+      "mcp__sx-tree__sx_comp_usage",
+      "mcp__sx-tree__sx_nav",
+      "mcp__sx-tree__sx_env",
+      "mcp__sx-tree__sx_playwright",
+      "mcp__hs-test__hs_test_run",
+      "mcp__hs-test__hs_test_regen",
+      "mcp__hs-test__hs_test_kill",
+      "mcp__hs-test__hs_test_status",
+      "Bash(node *)",
+      "Bash(python3 *)",
+      "Bash(bash *)",
+      "Bash(cp *)",
+      "Bash(git *)",
+      "Bash(tmux *)"
+    ]
+  },
+  "enabledMcpjsonServers": [
+    "sx-tree",
+    "rose-ash-services",
+    "hs-test"
+  ]
+}
+SETTINGS
+
+echo "Creating tmux session '$SESSION' in $ROOT ..."
+tmux new-session -d -s "$SESSION" -n "primitives" -c "$ROOT"
+
+echo "Starting claude..."
+tmux send-keys -t "$SESSION:primitives" "claude" C-m
+
+echo "Waiting ${BOOT_WAIT}s for claude to boot..."
+sleep "$BOOT_WAIT"
+
+if [ -n "$INTERVAL" ]; then
+  preamble="/loop $INTERVAL "
+else
+  preamble="/loop "
+fi
+
+cmd="${preamble}Read plans/agent-briefings/primitives-loop.md and do ONE step per fire: find the first unchecked [ ] task, implement it fully, run the relevant tests to verify, commit with a short factual message, push to origin/architecture, tick the box [x] in the plan, append one dated line to the Progress log (newest first), then stop. You are on branch architecture in /root/rose-ash. Use sx-tree MCP for all .sx edits. Never push to main."
+
+tmux send-keys -t "$SESSION:primitives" "$cmd"
+sleep 0.5
+tmux send-keys -t "$SESSION:primitives" Enter
+
+echo ""
+echo "Done. SX primitives loop started in tmux session '$SESSION'."
+echo ""
+echo "  Attach:    tmux a -t $SESSION"
+echo "  Detach:    Ctrl-B d"
+echo "  Stop:      ./scripts/sx-primitives-down.sh"
+echo ""

spec/coroutines.sx

@@ -0,0 +1,56 @@
+(define-library
+  (sx coroutines)
+  (export
+    make-coroutine
+    coroutine?
+    coroutine-alive?
+    coroutine-yield
+    coroutine-handle-result
+    coroutine-resume)
+  (begin
+    (define make-coroutine (fn (thunk) {:suspension nil :thunk thunk :type "coroutine" :state "ready"}))
+    (define
+      coroutine?
+      (fn (v) (and (dict? v) (= (get v "type") "coroutine"))))
+    (define
+      coroutine-alive?
+      (fn (c) (and (coroutine? c) (not (= (get c "state") "dead")))))
+    (define coroutine-yield (fn (val) (perform {:value val :op "coroutine-yield"})))
+    (define
+      coroutine-handle-result
+      (fn
+        (c result)
+        (if
+          (cek-terminal? result)
+          (do (dict-set! c "state" "dead") {:done true :value (cek-value result)})
+          (let
+            ((request (cek-io-request result)))
+            (if
+              (and (dict? request) (= (get request "op") "coroutine-yield"))
+              (do
+                (dict-set! c "state" "suspended")
+                (dict-set! c "suspension" result)
+                {:done false :value (get request "value")})
+              (perform request))))))
+    (define
+      coroutine-resume
+      (fn
+        (c val)
+        (cond
+          (not (coroutine? c))
+          (error "coroutine-resume: not a coroutine")
+          (= (get c "state") "dead")
+          (error "coroutine-resume: coroutine is dead")
+          (= (get c "state") "ready")
+          (do
+            (dict-set! c "state" "running")
+            (coroutine-handle-result
+              c
+              (cek-step-loop
+                (make-cek-state (list (get c "thunk")) (make-env) (list)))))
+          (= (get c "state") "suspended")
+          (do
+            (dict-set! c "state" "running")
+            (coroutine-handle-result c (cek-resume (get c "suspension") val)))
+          :else (error
+            (str "coroutine-resume: unexpected state: " (get c "state"))))))))

spec/parser.sx

@@ -14,13 +14,15 @@
 ;;   list       → '(' expr* ')'
 ;;   vector     → '[' expr* ']'   (sugar for list)
 ;;   map        → '{' (key expr)* '}'
-;;   atom       → string | number | keyword | symbol | boolean | nil
+;;   atom       → string | number | rational | keyword | symbol | boolean | nil | char
 ;;   string     → '"' (char | escape)* '"'
 ;;   number     → '-'? digit+ ('.' digit+)? ([eE] [+-]? digit+)?
+;;   rational   → integer '/' digit+
 ;;   keyword    → ':' ident
 ;;   symbol     → ident
 ;;   boolean    → 'true' | 'false'
 ;;   nil        → 'nil'
+;;   char       → '#\' (ident | single-char)
 ;;   ident      → ident-start ident-char*
 ;;   comment    → ';' to end of line (discarded)
 ;;
@@ -34,6 +36,8 @@
 ;;   #;expr           → datum comment (read and discard expr)
 ;;   #|raw chars|     → raw string literal (no escape processing)
 ;;   #'expr           → (quote expr)
+;;   #\a              → character literal (char value)
+;;   #\space          → named character (space = 32)
 ;;   #name expr       → extensible dispatch (calls registered handler)
 ;;
 ;; Platform interface (each target implements natively):
@@ -42,6 +46,11 @@
 ;;   (make-symbol name)  → Symbol value
 ;;   (make-keyword name) → Keyword value
 ;;   (escape-string s)   → string with " and \ escaped for serialization
+;;   (make-char n)       → Char value from Unicode codepoint
+;;   (make-rational n d) → Rational value (auto-reduced by GCD)
+;;   (char->integer c)   → Unicode codepoint of char c
+;;   (char-from-code n)  → single-char string from codepoint
+;;   (char-code s)       → codepoint of first char in string s
 ;; ==========================================================================
 
 
@@ -51,59 +60,73 @@
 ;; Returns a list of top-level AST expressions.
 
 ;; Parse SX source string into AST
-(define sx-parse :effects []
-  (fn ((source :as string))
-    (let ((pos 0)
-          (len-src (len source)))
-
-      ;; -- Cursor helpers (closure over pos, source, len-src) --
-
-      (define skip-comment :effects []
-        (fn ()
-          (when (and (< pos len-src) (not (= (nth source pos) "\n")))
+(define
+  sx-parse
+  :effects ()
+  (fn
+    ((source :as string))
+    (let
+      ((pos 0) (len-src (len source)))
+      (define
+        skip-comment
+        :effects ()
+        (fn
+          ()
+          (when
+            (and (< pos len-src) (not (= (nth source pos) "\n")))
             (set! pos (inc pos))
             (skip-comment))))
-
-      (define skip-ws :effects []
-        (fn ()
-          (when (< pos len-src)
-            (let ((ch (nth source pos)))
+      (define
+        skip-ws
+        :effects ()
+        (fn
+          ()
+          (when
+            (< pos len-src)
+            (let
+              ((ch (nth source pos)))
               (cond
-                ;; Whitespace
                 (or (= ch " ") (= ch "\t") (= ch "\n") (= ch "\r"))
                 (do (set! pos (inc pos)) (skip-ws))
-                ;; Comment — skip to end of line
                 (= ch ";")
-                  (do (set! pos (inc pos))
-                      (skip-comment)
-                      (skip-ws))
-                ;; Not whitespace or comment — stop
+                (do (set! pos (inc pos)) (skip-comment) (skip-ws))
                 :else nil)))))
-
-      ;; -- Atom readers --
-
-      (define hex-digit-value :effects []
+      (define
+        hex-digit-value
+        :effects ()
         (fn (ch) (index-of "0123456789abcdef" (lower ch))))
-
-      (define read-string :effects []
-        (fn ()
-          (set! pos (inc pos))  ;; skip opening "
-          (let ((buf ""))
-            (define read-str-loop :effects []
-              (fn ()
-                (if (>= pos len-src)
+      (define
+        read-string
+        :effects ()
+        (fn
+          ()
+          (set! pos (inc pos))
+          (let
+            ((buf ""))
+            (define
+              read-str-loop
+              :effects ()
+              (fn
+                ()
+                (if
+                  (>= pos len-src)
                   (error "Unterminated string")
-                  (let ((ch (nth source pos)))
+                  (let
+                    ((ch (nth source pos)))
                     (cond
                       (= ch "\"")
-                        (do (set! pos (inc pos)) nil)  ;; done
+                      (do (set! pos (inc pos)) nil)
                       (= ch "\\")
-                        (do (set! pos (inc pos))
-                            (let ((esc (nth source pos)))
-                              (if (= esc "u")
-                                ;; Unicode escape: \uXXXX → char
-                                (do (set! pos (inc pos))
-                                    (let ((d0 (hex-digit-value (nth source pos)))
+                      (do
+                        (set! pos (inc pos))
+                        (let
+                          ((esc (nth source pos)))
+                          (if
+                            (= esc "u")
+                            (do
+                              (set! pos (inc pos))
+                              (let
+                                ((d0 (hex-digit-value (nth source pos)))
                                   (_ (set! pos (inc pos)))
                                   (d1 (hex-digit-value (nth source pos)))
                                   (_ (set! pos (inc pos)))
@@ -111,111 +134,181 @@
                                   (_ (set! pos (inc pos)))
                                   (d3 (hex-digit-value (nth source pos)))
                                   (_ (set! pos (inc pos))))
-                                      (set! buf (str buf (char-from-code
-                                        (+ (* d0 4096) (* d1 256) (* d2 16) d3))))
+                                (set!
+                                  buf
+                                  (str
+                                    buf
+                                    (char-from-code
+                                      (+
+                                        (* d0 4096)
+                                        (* d1 256)
+                                        (* d2 16)
+                                        d3))))
                                 (read-str-loop)))
-                                ;; Standard escapes: \n \t \r or literal
-                                (do (set! buf (str buf
+                            (do
+                              (set!
+                                buf
+                                (str
+                                  buf
                                   (cond
-                                        (= esc "n") "\n"
-                                        (= esc "t") "\t"
-                                        (= esc "r") "\r"
+                                    (= esc "n")
+                                    "\n"
+                                    (= esc "t")
+                                    "\t"
+                                    (= esc "r")
+                                    "\r"
                                     :else esc)))
                               (set! pos (inc pos))
                               (read-str-loop)))))
-                      :else
-                        (do (set! buf (str buf ch))
+                      :else (do
+                        (set! buf (str buf ch))
                         (set! pos (inc pos))
                         (read-str-loop)))))))
             (read-str-loop)
             buf)))
-
-      (define read-ident :effects []
-        (fn ()
-          (let ((start pos))
-            (define read-ident-loop :effects []
-              (fn ()
-                (when (and (< pos len-src)
-                           (ident-char? (nth source pos)))
+      (define
+        read-ident
+        :effects ()
+        (fn
+          ()
+          (let
+            ((start pos))
+            (define
+              read-ident-loop
+              :effects ()
+              (fn
+                ()
+                (when
+                  (and (< pos len-src) (ident-char? (nth source pos)))
                   (set! pos (inc pos))
                   (read-ident-loop))))
             (read-ident-loop)
             (slice source start pos))))
-
-      (define read-keyword :effects []
-        (fn ()
-          (set! pos (inc pos))  ;; skip :
-          (make-keyword (read-ident))))
-
-      (define read-number :effects []
-        (fn ()
-          (let ((start pos))
-            ;; Optional leading minus
-            (when (and (< pos len-src) (= (nth source pos) "-"))
+      (define
+        read-keyword
+        :effects ()
+        (fn () (set! pos (inc pos)) (make-keyword (read-ident))))
+      (define
+        read-number
+        :effects ()
+        (fn
+          ()
+          (let
+            ((start pos))
+            (when
+              (and (< pos len-src) (= (nth source pos) "-"))
               (set! pos (inc pos)))
-            ;; Integer digits
-            (define read-digits :effects []
-              (fn ()
-                (when (and (< pos len-src)
-                           (let ((c (nth source pos)))
+            (define
+              read-digits
+              :effects ()
+              (fn
+                ()
+                (when
+                  (and
+                    (< pos len-src)
+                    (let
+                      ((c (nth source pos)))
                       (and (>= c "0") (<= c "9"))))
                   (set! pos (inc pos))
                   (read-digits))))
             (read-digits)
-            ;; Decimal part
-            (when (and (< pos len-src) (= (nth source pos) "."))
+            (if
+              (and
+                (< pos len-src)
+                (= (nth source pos) "/")
+                (< (inc pos) len-src)
+                (let
+                  ((nc (nth source (inc pos))))
+                  (and (>= nc "0") (<= nc "9"))))
+              (let
+                ((numer (parse-number (slice source start pos))))
+                (set! pos (inc pos))
+                (let
+                  ((denom-start pos))
+                  (read-digits)
+                  (make-rational
+                    numer
+                    (parse-number (slice source denom-start pos)))))
+              (do
+                (when
+                  (and (< pos len-src) (= (nth source pos) "."))
                   (set! pos (inc pos))
                   (read-digits))
-            ;; Exponent
-            (when (and (< pos len-src)
-                       (or (= (nth source pos) "e")
-                           (= (nth source pos) "E")))
+                (when
+                  (and
+                    (< pos len-src)
+                    (or (= (nth source pos) "e") (= (nth source pos) "E")))
                   (set! pos (inc pos))
-              (when (and (< pos len-src)
-                         (or (= (nth source pos) "+")
+                  (when
+                    (and
+                      (< pos len-src)
+                      (or
+                        (= (nth source pos) "+")
                         (= (nth source pos) "-")))
                     (set! pos (inc pos)))
                   (read-digits))
-            (parse-number (slice source start pos)))))
-
-      (define read-symbol :effects []
-        (fn ()
-          (let ((name (read-ident)))
+                (parse-number (slice source start pos)))))))
+      (define
+        read-symbol
+        :effects ()
+        (fn
+          ()
+          (let
+            ((name (read-ident)))
             (cond
-              (= name "true")  true
-              (= name "false") false
-              (= name "nil")   nil
+              (= name "true")
+              true
+              (= name "false")
+              false
+              (= name "nil")
+              nil
               :else (make-symbol name)))))
-
-      ;; -- Composite readers --
-
-      (define read-list :effects []
-        (fn ((close-ch :as string))
-          (let ((items (list)))
-            (define read-list-loop :effects []
-              (fn ()
+      (define
+        read-list
+        :effects ()
+        (fn
+          ((close-ch :as string))
+          (let
+            ((items (list)))
+            (define
+              read-list-loop
+              :effects ()
+              (fn
+                ()
                 (skip-ws)
-                (if (>= pos len-src)
+                (if
+                  (>= pos len-src)
                   (error "Unterminated list")
-                  (if (= (nth source pos) close-ch)
-                    (do (set! pos (inc pos)) nil)  ;; done
-                    (do (append! items (read-expr))
-                        (read-list-loop))))))
+                  (if
+                    (= (nth source pos) close-ch)
+                    (do (set! pos (inc pos)) nil)
+                    (do (append! items (read-expr)) (read-list-loop))))))
             (read-list-loop)
             items)))
-
-      (define read-map :effects []
-        (fn ()
-          (let ((result (dict)))
-            (define read-map-loop :effects []
-              (fn ()
+      (define
+        read-map
+        :effects ()
+        (fn
+          ()
+          (let
+            ((result (dict)))
+            (define
+              read-map-loop
+              :effects ()
+              (fn
+                ()
                 (skip-ws)
-                (if (>= pos len-src)
+                (if
+                  (>= pos len-src)
                   (error "Unterminated map")
-                  (if (= (nth source pos) "}")
-                    (do (set! pos (inc pos)) nil)  ;; done
-                    (let ((key-expr (read-expr))
-                          (key-str  (if (= (type-of key-expr) "keyword")
+                  (if
+                    (= (nth source pos) "}")
+                    (do (set! pos (inc pos)) nil)
+                    (let
+                      ((key-expr (read-expr))
+                        (key-str
+                          (if
+                            (= (type-of key-expr) "keyword")
                             (keyword-name key-expr)
                             (str key-expr)))
                         (val-expr (read-expr)))
@@ -223,136 +316,180 @@
                       (read-map-loop))))))
             (read-map-loop)
             result)))
-
-      ;; -- Raw string reader (for #|...|) --
-
-      (define read-raw-string :effects []
-        (fn ()
-          (let ((buf ""))
-            (define raw-loop :effects []
-              (fn ()
-                (if (>= pos len-src)
+      (define
+        read-raw-string
+        :effects ()
+        (fn
+          ()
+          (let
+            ((buf ""))
+            (define
+              raw-loop
+              :effects ()
+              (fn
+                ()
+                (if
+                  (>= pos len-src)
                   (error "Unterminated raw string")
-                  (let ((ch (nth source pos)))
-                    (if (= ch "|")
-                      (do (set! pos (inc pos)) nil)  ;; done
-                      (do (set! buf (str buf ch))
+                  (let
+                    ((ch (nth source pos)))
+                    (if
+                      (= ch "|")
+                      (do (set! pos (inc pos)) nil)
+                      (do
+                        (set! buf (str buf ch))
                         (set! pos (inc pos))
                         (raw-loop)))))))
             (raw-loop)
             buf)))
-
-      ;; -- Main expression reader --
-
-      (define read-expr :effects []
-        (fn ()
-          (skip-ws)
-          (if (>= pos len-src)
-            (error "Unexpected end of input")
-            (let ((ch (nth source pos)))
+      (define
+        read-char-literal
+        :effects ()
+        (fn
+          ()
+          (if
+            (>= pos len-src)
+            (error "Unexpected end of input after #\\")
+            (let
+              ((first-ch (nth source pos)))
+              (if
+                (ident-start? first-ch)
+                (let
+                  ((char-start pos))
+                  (define
+                    read-char-name-loop
+                    :effects ()
+                    (fn
+                      ()
+                      (when
+                        (and (< pos len-src) (ident-char? (nth source pos)))
+                        (set! pos (inc pos))
+                        (read-char-name-loop))))
+                  (read-char-name-loop)
+                  (let
+                    ((char-name (slice source char-start pos)))
+                    (make-char
+                      (cond
+                        (= char-name "space")
+                        32
+                        (= char-name "newline")
+                        10
+                        (= char-name "tab")
+                        9
+                        (= char-name "nul")
+                        0
+                        (= char-name "null")
+                        0
+                        (= char-name "return")
+                        13
+                        (= char-name "escape")
+                        27
+                        (= char-name "delete")
+                        127
+                        (= char-name "backspace")
+                        8
+                        (= char-name "altmode")
+                        27
+                        (= char-name "rubout")
+                        127
+                        :else (char-code first-ch)))))
+                (do (set! pos (inc pos)) (make-char (char-code first-ch))))))))
+      (define
+        read-expr
+        :effects ()
+        (fn
+          ()
+          (skip-ws)
+          (if
+            (>= pos len-src)
+            (error "Unexpected end of input")
+            (let
+              ((ch (nth source pos)))
               (cond
-                ;; Lists
                 (= ch "(")
                 (do (set! pos (inc pos)) (read-list ")"))
                 (= ch "[")
                 (do (set! pos (inc pos)) (read-list "]"))
-
-                ;; Map
                 (= ch "{")
                 (do (set! pos (inc pos)) (read-map))
-
-                ;; String
                 (= ch "\"")
                 (read-string)
-
-                ;; Keyword
                 (= ch ":")
                 (read-keyword)
-
-                ;; Quote sugar
                 (= ch "'")
-                  (do (set! pos (inc pos))
+                (do
+                  (set! pos (inc pos))
                   (list (make-symbol "quote") (read-expr)))
-
-                ;; Quasiquote sugar
                 (= ch "`")
-                  (do (set! pos (inc pos))
+                (do
+                  (set! pos (inc pos))
                   (list (make-symbol "quasiquote") (read-expr)))
-
-                ;; Unquote / splice-unquote
                 (= ch ",")
-                  (do (set! pos (inc pos))
-                      (if (and (< pos len-src) (= (nth source pos) "@"))
-                        (do (set! pos (inc pos))
+                (do
+                  (set! pos (inc pos))
+                  (if
+                    (and (< pos len-src) (= (nth source pos) "@"))
+                    (do
+                      (set! pos (inc pos))
                       (list (make-symbol "splice-unquote") (read-expr)))
                     (list (make-symbol "unquote") (read-expr))))
-
-                ;; Reader macros: #
                 (= ch "#")
-                  (do (set! pos (inc pos))
-                      (if (>= pos len-src)
+                (do
+                  (set! pos (inc pos))
+                  (if
+                    (>= pos len-src)
                     (error "Unexpected end of input after #")
-                        (let ((dispatch-ch (nth source pos)))
+                    (let
+                      ((dispatch-ch (nth source pos)))
                       (cond
-                            ;; #; — datum comment: read and discard next expr
                         (= dispatch-ch ";")
-                              (do (set! pos (inc pos))
-                                  (read-expr)    ;; read and discard
-                                  (read-expr))   ;; return the NEXT expr
-
-                            ;; #| — raw string
+                        (do (set! pos (inc pos)) (read-expr) (read-expr))
                         (= dispatch-ch "|")
-                              (do (set! pos (inc pos))
-                                  (read-raw-string))
-
-                            ;; #' — quote shorthand
+                        (do (set! pos (inc pos)) (read-raw-string))
                         (= dispatch-ch "'")
-                              (do (set! pos (inc pos))
+                        (do
+                          (set! pos (inc pos))
                           (list (make-symbol "quote") (read-expr)))
-
-                            ;; #name — extensible dispatch
+                        (= dispatch-ch "\\")
+                        (do (set! pos (inc pos)) (read-char-literal))
                         (ident-start? dispatch-ch)
-                              (let ((macro-name (read-ident)))
-                                (let ((handler (reader-macro-get macro-name)))
-                                  (if handler
+                        (let
+                          ((macro-name (read-ident)))
+                          (let
+                            ((handler (reader-macro-get macro-name)))
+                            (if
+                              handler
                               (handler (read-expr))
-                                    (error (str "Unknown reader macro: #" macro-name)))))
-
-                            :else
-                              (error (str "Unknown reader macro: #" dispatch-ch))))))
-
-                ;; Number (or negative number)
-                (or (and (>= ch "0") (<= ch "9"))
-                    (and (= ch "-")
+                              (error
+                                (str "Unknown reader macro: #" macro-name)))))
+                        :else (error (str "Unknown reader macro: #" dispatch-ch))))))
+                (or
+                  (and (>= ch "0") (<= ch "9"))
+                  (and
+                    (= ch "-")
                     (< (inc pos) len-src)
-                         (let ((next-ch (nth source (inc pos))))
+                    (let
+                      ((next-ch (nth source (inc pos))))
                       (and (>= next-ch "0") (<= next-ch "9")))))
                 (read-number)
-
-                ;; Ellipsis (... as a symbol)
-                (and (= ch ".")
+                (and
+                  (= ch ".")
                   (< (+ pos 2) len-src)
                   (= (nth source (+ pos 1)) ".")
                   (= (nth source (+ pos 2)) "."))
-                  (do (set! pos (+ pos 3))
-                      (make-symbol "..."))
-
-                ;; Symbol (must be ident-start char)
+                (do (set! pos (+ pos 3)) (make-symbol "..."))
                 (ident-start? ch)
                 (read-symbol)
-
-                ;; Unexpected
-                :else
-                  (error (str "Unexpected character: " ch)))))))
-
-      ;; -- Entry point: parse all top-level expressions --
-      (let ((exprs (list)))
-        (define parse-loop :effects []
-          (fn ()
+                :else (error (str "Unexpected character: " ch)))))))
+      (let
+        ((exprs (list)))
+        (define
+          parse-loop
+          :effects ()
+          (fn
+            ()
             (skip-ws)
-            (when (< pos len-src)
-              (append! exprs (read-expr))
-              (parse-loop))))
+            (when (< pos len-src) (append! exprs (read-expr)) (parse-loop))))
         (parse-loop)
         exprs))))
 
@@ -362,30 +499,77 @@
 ;; --------------------------------------------------------------------------
 
 ;; Serialize AST value back to SX source
-(define sx-serialize :effects []
-  (fn (val)
-    (case (type-of val)
-      "nil"       "nil"
-      "boolean"   (if val "true" "false")
-      "number"    (str val)
-      "string"    (str "\"" (escape-string val) "\"")
-      "symbol"    (symbol-name val)
-      "keyword"   (str ":" (keyword-name val))
-      "list"      (str "(" (join " " (map sx-serialize val)) ")")
-      "dict"      (sx-serialize-dict val)
-      "sx-expr"   (sx-expr-source val)
-      "spread"    (str "(make-spread " (sx-serialize-dict (spread-attrs val)) ")")
+(define
+  sx-serialize
+  :effects ()
+  (fn
+    (val)
+    (case
+      (type-of val)
+      "nil"
+      "nil"
+      "boolean"
+      (if val "true" "false")
+      "number"
+      (str val)
+      "rational"
+      (str (numerator val) "/" (denominator val))
+      "string"
+      (str "\"" (escape-string val) "\"")
+      "symbol"
+      (symbol-name val)
+      "keyword"
+      (str ":" (keyword-name val))
+      "list"
+      (str "(" (join " " (map sx-serialize val)) ")")
+      "dict"
+      (sx-serialize-dict val)
+      "sx-expr"
+      (sx-expr-source val)
+      "spread"
+      (str "(make-spread " (sx-serialize-dict (spread-attrs val)) ")")
+      "char"
+      (let
+        ((n (char->integer val)))
+        (str
+          "#\\"
+          (cond
+            (= n 32)
+            "space"
+            (= n 10)
+            "newline"
+            (= n 9)
+            "tab"
+            (= n 13)
+            "return"
+            (= n 0)
+            "nul"
+            (= n 27)
+            "escape"
+            (= n 127)
+            "delete"
+            (= n 8)
+            "backspace"
+            :else (char-from-code n))))
       :else (str val))))
 
 
 ;; Serialize a dict to SX {:key val} format
-(define sx-serialize-dict :effects []
-  (fn ((d :as dict))
-    (str "{"
-      (join " "
+(define
+  sx-serialize-dict
+  :effects ()
+  (fn
+    ((d :as dict))
+    (str
+      "{"
+      (join
+        " "
         (reduce
-          (fn ((acc :as list) (key :as string))
-            (concat acc (list (str ":" key) (sx-serialize (dict-get d key)))))
+          (fn
+            ((acc :as list) (key :as string))
+            (concat
+              acc
+              (list (str ":" key) (sx-serialize (dict-get d key)))))
           (list)
           (keys d)))
       "}")))
@@ -410,10 +594,15 @@
 ;;   (make-symbol name)    → Symbol value
 ;;   (make-keyword name)   → Keyword value
 ;;   (parse-number s)      → number (int or float from string)
+;;   (make-char n)         → Char value from Unicode codepoint n
+;;   (make-rational n d)   → Rational value (auto-reduced by GCD; d=0 is an error)
+;;   (char->integer c)     → Unicode codepoint of char c
 ;;
 ;; String utilities:
 ;;   (escape-string s)   → string with " and \ escaped
 ;;   (sx-expr-source e)  → unwrap SxExpr to its source string
+;;   (char-from-code n)  → single-char string from codepoint n
+;;   (char-code s)       → codepoint of first char in string s
 ;;
 ;; Reader macro registry:
 ;;   (reader-macro-get name)          → handler fn or nil

spec/primitives.sx

@@ -43,35 +43,35 @@
   "+"
   :params (&rest (args :as number))
   :returns "number"
-  :doc "Sum all arguments."
+  :doc "Sum all arguments. Returns integer iff all args are exact integers (float contagion)."
   :body (reduce (fn (a b) (native-add a b)) 0 args))
 
 (define-primitive
   "-"
   :params ((a :as number) &rest (b :as number))
   :returns "number"
-  :doc "Subtract. Unary: negate. Binary: a - b."
+  :doc "Subtract. Unary: negate. Binary: a - b. Float contagion: returns integer iff all args are integers."
   :body (if (empty? b) (native-neg a) (native-sub a (first b))))
 
 (define-primitive
   "*"
   :params (&rest (args :as number))
   :returns "number"
-  :doc "Multiply all arguments."
+  :doc "Multiply all arguments. Float contagion: integer result iff all args are exact integers."
   :body (reduce (fn (a b) (native-mul a b)) 1 args))
 
 (define-primitive
   "/"
   :params ((a :as number) (b :as number))
-  :returns "number"
-  :doc "Divide a by b."
+  :returns "float"
+  :doc "Divide a by b. Always returns inexact float."
   :body (native-div a b))
 
 (define-primitive
   "mod"
   :params ((a :as number) (b :as number))
   :returns "number"
-  :doc "Modulo a % b."
+  :doc "Modulo a % b. Returns integer iff both args are integers."
   :body (native-mod a b))
 
 (define-primitive
@@ -108,26 +108,26 @@
 (define-primitive
   "floor"
   :params ((x :as number))
-  :returns "number"
-  :doc "Floor to integer.")
+  :returns "integer"
+  :doc "Floor toward negative infinity — returns exact integer.")
 
 (define-primitive
   "ceil"
   :params ((x :as number))
-  :returns "number"
-  :doc "Ceiling to integer.")
+  :returns "integer"
+  :doc "Ceiling toward positive infinity — returns exact integer.")
 
 (define-primitive
   "round"
   :params ((x :as number) &rest (ndigits :as number))
   :returns "number"
-  :doc "Round to ndigits decimal places (default 0).")
+  :doc "Round to ndigits decimal places (default 0). Returns integer when ndigits is 0.")
 
 (define-primitive
   "truncate"
-  :params (((x :as number)))
-  :returns "number"
-  :doc "Truncate toward zero.")
+  :params ((x :as number))
+  :returns "integer"
+  :doc "Truncate toward zero — returns exact integer.")
 
 (define-primitive
   "remainder"
@@ -143,42 +143,42 @@
 
 (define-primitive
   "exact?"
-  :params (((x :as number)))
+  :params ((x :as number))
   :returns "boolean"
-  :doc "True if x is exact (integer-valued).")
+  :doc "True if x is an exact integer (not an inexact float).")
 
 (define-primitive
   "inexact?"
-  :params (((x :as number)))
+  :params ((x :as number))
   :returns "boolean"
-  :doc "True if x is inexact (non-integer).")
+  :doc "True if x is an inexact float (not an exact integer).")
 
 ;; --------------------------------------------------------------------------
 ;; Core — Comparison
 ;; --------------------------------------------------------------------------
 (define-primitive
   "exact->inexact"
-  :params (((x :as number)))
-  :returns "number"
-  :doc "Convert exact to inexact (identity for float tower).")
+  :params ((x :as number))
+  :returns "float"
+  :doc "Convert exact integer to inexact float. Floats pass through unchanged.")
 
 (define-primitive
   "inexact->exact"
-  :params (((x :as number)))
-  :returns "number"
-  :doc "Convert inexact to nearest exact integer.")
+  :params ((x :as number))
+  :returns "integer"
+  :doc "Convert inexact float to nearest exact integer (truncates). Integers pass through unchanged.")
 
 (define-primitive
   "make-vector"
-  :params ((n :as number))
+  :params ((n :as number) (fill :as any :optional true))
   :returns "vector"
-  :doc "Create vector of size n, optionally filled.")
+  :doc "Create vector of length n, each element initialised to fill (default nil).")
 
 (define-primitive
   "vector"
-  :params ()
+  :params (:rest (elts :as any))
   :returns "vector"
-  :doc "Create vector from arguments.")
+  :doc "Construct a vector from its arguments.")
 
 (define-primitive
   "vector?"
@@ -190,31 +190,31 @@
   "vector-length"
   :params ((v :as vector))
   :returns "number"
-  :doc "Number of elements.")
+  :doc "Number of elements in vector v.")
 
 (define-primitive
   "vector-ref"
   :params ((v :as vector) (i :as number))
   :returns "any"
-  :doc "Element at index.")
+  :doc "Element at 0-based index i. Error if out of bounds.")
 
 (define-primitive
   "vector-set!"
   :params ((v :as vector) (i :as number) (val :as any))
   :returns "nil"
-  :doc "Set element at index.")
+  :doc "Mutate element at index i to val. Error if out of bounds.")
 
 (define-primitive
   "vector->list"
   :params ((v :as vector))
   :returns "list"
-  :doc "Convert vector to list.")
+  :doc "Convert vector to a fresh list.")
 
 (define-primitive
   "list->vector"
   :params ((l :as list))
   :returns "vector"
-  :doc "Convert list to vector.")
+  :doc "Convert list to a fresh vector.")
 
 ;; --------------------------------------------------------------------------
 ;; Core — Predicates
@@ -223,13 +223,15 @@
   "vector-fill!"
   :params ((v :as vector) (val :as any))
   :returns "nil"
-  :doc "Fill all elements.")
+  :doc "Set every element of v to val in place.")
 
 (define-primitive
   "vector-copy"
-  :params ((v :as vector))
+  :params ((v :as vector)
+    (start :as number :optional true)
+    (end :as number :optional true))
   :returns "vector"
-  :doc "Independent shallow copy.")
+  :doc "Shallow copy of vector, optionally sliced from start (inclusive) to end (exclusive).")
 
 (define-primitive
   "min"
@@ -372,8 +374,20 @@
   "number?"
   :params (x)
   :returns "boolean"
-  :doc "True if x is a number (int or float)."
-  :body (= (type-of x) "number"))
+  :doc "True if x is any number — exact integer or inexact float."
+  :body (or (= (type-of x) "number") (integer? x)))
+
+(define-primitive
+  "integer?"
+  :params (x)
+  :returns "boolean"
+  :doc "True if x is an exact integer, or a float with no fractional part (e.g. 1.0).")
+
+(define-primitive
+  "float?"
+  :params (x)
+  :returns "boolean"
+  :doc "True if x is an inexact float (Number type). Does not match exact integers.")
 
 (define-primitive
   "string?"
@@ -478,6 +492,12 @@
   :returns "string"
   :doc "Convert Unicode code point to single-character string.")
 
+(define-primitive
+  "char-code"
+  :params ((s :as string))
+  :returns "number"
+  :doc "Unicode codepoint of the first character of string s.")
+
 (define-primitive
   "substring"
   :params ((s :as string) (start :as number) (end :as number))
@@ -532,15 +552,15 @@
   :returns "boolean"
   :doc "True if string s starts with prefix.")
 
+;; --------------------------------------------------------------------------
+;; Core — Dict operations
+;; --------------------------------------------------------------------------
 (define-primitive
   "ends-with?"
   :params ((s :as string) (suffix :as string))
   :returns "boolean"
   :doc "True if string s ends with suffix.")
 
-;; --------------------------------------------------------------------------
-;; Core — Dict operations
-;; --------------------------------------------------------------------------
 (define-module :core.collections)
 
 (define-primitive
@@ -585,15 +605,15 @@
   :returns "any"
   :doc "Last element, or nil if empty.")
 
+;; --------------------------------------------------------------------------
+;; Stdlib — Format
+;; --------------------------------------------------------------------------
 (define-primitive
   "rest"
   :params ((coll :as list))
   :returns "list"
   :doc "All elements except the first.")
 
-;; --------------------------------------------------------------------------
-;; Stdlib — Format
-;; --------------------------------------------------------------------------
 (define-primitive
   "nth"
   :params ((coll :as list) (n :as number))
@@ -618,15 +638,15 @@
   :returns "list"
   :doc "Mutate coll by appending x in-place. Returns coll.")
 
+;; --------------------------------------------------------------------------
+;; Stdlib — Text
+;; --------------------------------------------------------------------------
 (define-primitive
   "reverse"
   :params ((coll :as list))
   :returns "list"
   :doc "Return coll in reverse order.")
 
-;; --------------------------------------------------------------------------
-;; Stdlib — Text
-;; --------------------------------------------------------------------------
 (define-primitive
   "flatten"
   :params ((coll :as list))
@@ -645,29 +665,29 @@
   :returns "list"
   :doc "Consecutive pairs: (1 2 3 4) → ((1 2) (2 3) (3 4)).")
 
-(define-module :core.dict)
-
 ;; --------------------------------------------------------------------------
 ;; Stdlib — Style
 ;; --------------------------------------------------------------------------
 ;; --------------------------------------------------------------------------
 ;; Stdlib — Debug
 ;; --------------------------------------------------------------------------
+(define-module :core.dict)
+
 (define-primitive
   "keys"
   :params ((d :as dict))
   :returns "list"
   :doc "List of dict keys.")
 
+;; --------------------------------------------------------------------------
+;; Type introspection — platform primitives
+;; --------------------------------------------------------------------------
 (define-primitive
   "vals"
   :params ((d :as dict))
   :returns "list"
   :doc "List of dict values.")
 
-;; --------------------------------------------------------------------------
-;; Type introspection — platform primitives
-;; --------------------------------------------------------------------------
 (define-primitive
   "merge"
   :params (&rest (dicts :as dict))
@@ -783,3 +803,526 @@
   :params ((source :as string))
   :returns "list"
   :doc "Parse SX source string into a list of AST expressions.")
+
+(define-primitive
+  "make-string-buffer"
+  :params ()
+  :returns "string-buffer"
+  :doc "Create a new empty mutable string buffer for O(1) amortised append.")
+
+(define-module :stdlib.coroutines)
+
+(define-module :stdlib.bitwise)
+
+(define-primitive
+  "bitwise-and"
+  :params (((a :as number) (b :as number)))
+  :returns "number"
+  :doc "Bitwise AND of two integers.")
+
+(define-primitive
+  "bitwise-or"
+  :params (((a :as number) (b :as number)))
+  :returns "number"
+  :doc "Bitwise OR of two integers.")
+
+(define-primitive
+  "bitwise-xor"
+  :params (((a :as number) (b :as number)))
+  :returns "number"
+  :doc "Bitwise XOR of two integers.")
+
+(define-primitive
+  "bitwise-not"
+  :params ((a :as number))
+  :returns "number"
+  :doc "Bitwise NOT (one's complement) of an integer.")
+
+(define-primitive
+  "arithmetic-shift"
+  :params (((a :as number) (count :as number)))
+  :returns "number"
+  :doc "Arithmetic shift: left if count > 0, right if count < 0.")
+
+(define-primitive
+  "bit-count"
+  :params ((a :as number))
+  :returns "number"
+  :doc "Count set bits (popcount) in a non-negative integer.")
+
+(define-primitive
+  "integer-length"
+  :params ((a :as number))
+  :returns "number"
+  :doc "Number of bits needed to represent integer a (excluding sign).")
+
+(define-module :stdlib.ports)
+
+(define-primitive
+  "eof-object"
+  :params ()
+  :returns "eof-object"
+  :doc "The EOF sentinel value.")
+
+(define-primitive
+  "eof-object?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is the EOF sentinel.")
+
+(define-primitive
+  "open-input-string"
+  :params ((s :as string))
+  :returns "input-port"
+  :doc "Open a string as an input port.")
+
+(define-primitive
+  "open-output-string"
+  :params ()
+  :returns "output-port"
+  :doc "Open a fresh output string port.")
+
+(define-primitive
+  "get-output-string"
+  :params ((p :as output-port))
+  :returns "string"
+  :doc "Flush output port contents to a string.")
+
+(define-primitive
+  "port?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is any port.")
+
+(define-primitive
+  "input-port?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is an input port.")
+
+(define-primitive
+  "output-port?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is an output port.")
+
+(define-primitive
+  "close-port"
+  :params ((p :as port))
+  :returns "nil"
+  :doc "Close a port.")
+
+(define-primitive
+  "read-char"
+  :params (&rest (p :as input-port))
+  :returns "any"
+  :doc "Read next char from port; returns eof-object at end.")
+
+(define-primitive
+  "peek-char"
+  :params (&rest (p :as input-port))
+  :returns "any"
+  :doc "Peek next char without consuming; returns eof-object at end.")
+
+(define-primitive
+  "read-line"
+  :params (&rest (p :as input-port))
+  :returns "any"
+  :doc "Read a line from port; returns eof-object at end.")
+
+(define-primitive
+  "write-char"
+  :params ((c :as char) &rest (p :as output-port))
+  :returns "nil"
+  :doc "Write a char to output port.")
+
+(define-primitive
+  "write-string"
+  :params ((s :as string) &rest (p :as output-port))
+  :returns "nil"
+  :doc "Write a string to output port.")
+
+(define-primitive
+  "char-ready?"
+  :params (&rest (p :as input-port))
+  :returns "boolean"
+  :doc "True if a char is immediately available on the port.")
+
+
+(define-primitive
+  "read"
+  :params (&rest (p :as input-port))
+  :returns "any"
+  :doc "Read one datum from port; returns eof-object at end.")
+
+(define-primitive
+  "write"
+  :params (v &rest (p :as output-port))
+  :returns "nil"
+  :doc "Serialize v to port with quoting — strings quoted, chars as #\\a notation.")
+
+(define-primitive
+  "display"
+  :params (v &rest (p :as output-port))
+  :returns "nil"
+  :doc "Serialize v to port without quoting — strings unquoted, chars as characters.")
+
+(define-primitive
+  "newline"
+  :params (&rest (p :as output-port))
+  :returns "nil"
+  :doc "Write a newline to port.")
+
+(define-primitive
+  "write-to-string"
+  :params (v)
+  :returns "string"
+  :doc "Serialize v with write quoting, return as string.")
+
+(define-primitive
+  "display-to-string"
+  :params (v)
+  :returns "string"
+  :doc "Serialize v with display format, return as string.")
+
+(define-primitive
+  "current-input-port"
+  :params ()
+  :returns "any"
+  :doc "Return current default input port.")
+
+(define-primitive
+  "current-output-port"
+  :params ()
+  :returns "any"
+  :doc "Return current default output port.")
+
+(define-primitive
+  "current-error-port"
+  :params ()
+  :returns "any"
+  :doc "Return current error port.")
+
+(define-module :stdlib.math)
+
+(define-primitive
+  "sin"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Sine of x (radians).")
+
+(define-primitive
+  "cos"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Cosine of x (radians).")
+
+(define-primitive
+  "tan"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Tangent of x (radians).")
+
+(define-primitive
+  "asin"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Arc sine of x; result in radians.")
+
+(define-primitive
+  "acos"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Arc cosine of x; result in radians.")
+
+(define-primitive
+  "atan"
+  :params ((x :as number) &rest (y :as number))
+  :returns "float"
+  :doc "Arc tangent. (atan x) → radians in (-π/2, π/2). (atan y x) → atan2(y, x).")
+
+(define-primitive
+  "exp"
+  :params ((x :as number))
+  :returns "float"
+  :doc "e raised to the power x.")
+
+(define-primitive
+  "log"
+  :params ((x :as number))
+  :returns "float"
+  :doc "Natural logarithm of x.")
+
+(define-primitive
+  "expt"
+  :params ((base :as number) (exp :as number))
+  :returns "number"
+  :doc "base raised to the power exp. Alias: pow.")
+
+(define-primitive
+  "quotient"
+  :params ((a :as number) (b :as number))
+  :returns "integer"
+  :doc "Integer quotient: truncate(a / b) toward zero. Sign follows dividend.")
+
+(define-primitive
+  "gcd"
+  :params ((a :as number) (b :as number))
+  :returns "integer"
+  :doc "Greatest common divisor of a and b.")
+
+(define-primitive
+  "lcm"
+  :params ((a :as number) (b :as number))
+  :returns "integer"
+  :doc "Least common multiple of a and b.")
+
+(define-primitive
+  "number->string"
+  :params ((n :as number) &rest (radix :as number))
+  :returns "string"
+  :doc "Convert number n to string. Optional radix (default 10). E.g. (number->string 255 16) → \"ff\".")
+
+(define-primitive
+  "string->number"
+  :params ((s :as string) &rest (radix :as number))
+  :returns "any"
+  :doc "Parse string s as a number. Optional radix (default 10). Returns nil on failure.")
+
+(define-module :stdlib.rational)
+
+(define-primitive
+  "make-rational"
+  :params (n d)
+  :returns "rational"
+  :doc "Rational n/d, auto-reduced by GCD. Error if d=0.")
+
+(define-primitive
+  "rational?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is a rational number.")
+
+(define-primitive
+  "numerator"
+  :params ((r :as rational))
+  :returns "integer"
+  :doc "Numerator of rational r (after reduction).")
+
+(define-primitive
+  "denominator"
+  :params ((r :as rational))
+  :returns "integer"
+  :doc "Denominator of rational r (after reduction, always positive).")
+
+(define-module :stdlib.hash-table)
+
+(define-module :stdlib.sets)
+
+(define-primitive
+  "make-set"
+  :params (&rest (lst :as list))
+  :returns "set"
+  :doc "Create a fresh empty set. Optional list argument seeds the set: (make-set '(1 2 3)).")
+
+(define-primitive
+  "set?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is a set.")
+
+(define-primitive
+  "set-add!"
+  :params (s val)
+  :returns "nil"
+  :doc "Add val to set s in place. No-op if already present.")
+
+(define-primitive
+  "set-member?"
+  :params (s val)
+  :returns "boolean"
+  :doc "True if val is in set s.")
+
+(define-primitive
+  "set-remove!"
+  :params (s val)
+  :returns "nil"
+  :doc "Remove val from set s in place. No-op if absent.")
+
+(define-primitive
+  "set-size"
+  :params (s)
+  :returns "integer"
+  :doc "Number of elements in set s.")
+
+(define-primitive
+  "set->list"
+  :params (s)
+  :returns "list"
+  :doc "All elements of set s as a list (unspecified order).")
+
+(define-primitive
+  "list->set"
+  :params (lst)
+  :returns "set"
+  :doc "Create a new set containing all elements of lst.")
+
+(define-primitive
+  "set-union"
+  :params (s1 s2)
+  :returns "set"
+  :doc "New set with all elements from s1 and s2.")
+
+(define-primitive
+  "set-intersection"
+  :params (s1 s2)
+  :returns "set"
+  :doc "New set with elements present in both s1 and s2.")
+
+(define-primitive
+  "set-difference"
+  :params (s1 s2)
+  :returns "set"
+  :doc "New set with elements in s1 that are not in s2.")
+
+(define-primitive
+  "set-for-each"
+  :params (s fn)
+  :returns "nil"
+  :doc "Call (fn val) for each element in set s. Order unspecified.")
+
+(define-primitive
+  "set-map"
+  :params (s fn)
+  :returns "set"
+  :doc "New set of results of (fn val) for each element in s.")
+
+(define-module :stdlib.regexp)
+
+(define-primitive
+  "make-regexp"
+  :params ((pattern :as string) &rest (flags :as string))
+  :returns "regexp"
+  :doc "Compile regexp from pattern string and optional flags string (\"i\" case-insensitive, \"m\" multiline, \"s\" dotall).")
+
+(define-primitive
+  "regexp?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is a compiled regexp.")
+
+(define-primitive
+  "regexp-source"
+  :params ((re :as regexp))
+  :returns "string"
+  :doc "Pattern string of a regexp.")
+
+(define-primitive
+  "regexp-flags"
+  :params ((re :as regexp))
+  :returns "string"
+  :doc "Flags string of a regexp.")
+
+(define-primitive
+  "regexp-match"
+  :params ((re :as regexp) (str :as string))
+  :returns "any"
+  :doc "First match of re in str. Returns {:match \"...\" :start N :end N :groups (...)} or nil.")
+
+(define-primitive
+  "regexp-match-all"
+  :params ((re :as regexp) (str :as string))
+  :returns "list"
+  :doc "All non-overlapping matches of re in str as a list of match dicts.")
+
+(define-primitive
+  "regexp-replace"
+  :params ((re :as regexp) (str :as string) (replacement :as string))
+  :returns "string"
+  :doc "Replace first match of re in str with replacement. $& = whole match, $1..$9 = groups.")
+
+(define-primitive
+  "regexp-replace-all"
+  :params ((re :as regexp) (str :as string) (replacement :as string))
+  :returns "string"
+  :doc "Replace all matches of re in str with replacement.")
+
+(define-primitive
+  "regexp-split"
+  :params ((re :as regexp) (str :as string))
+  :returns "list"
+  :doc "Split str on every match of re; returns list of strings.")
+
+(define-module :stdlib.bytevectors)
+
+(define-primitive
+  "make-bytevector"
+  :params (n &rest fill)
+  :returns "bytevector"
+  :doc "Create a bytevector of n bytes, all initialised to fill (default 0).")
+
+(define-primitive
+  "bytevector?"
+  :params (v)
+  :returns "boolean"
+  :doc "True if v is a bytevector.")
+
+(define-primitive
+  "bytevector-length"
+  :params ((bv :as bytevector))
+  :returns "number"
+  :doc "Number of bytes in bv.")
+
+(define-primitive
+  "bytevector-u8-ref"
+  :params ((bv :as bytevector) (i :as number))
+  :returns "number"
+  :doc "Byte value 0-255 at index i.")
+
+(define-primitive
+  "bytevector-u8-set!"
+  :params ((bv :as bytevector) (i :as number) (byte :as number))
+  :returns "nil"
+  :doc "Set byte at index i to byte 0-255. Mutates bv.")
+
+(define-primitive
+  "bytevector-copy"
+  :params ((bv :as bytevector) &rest bounds)
+  :returns "bytevector"
+  :doc "Fresh copy of bv, optionally sliced to [start, end).")
+
+(define-primitive
+  "bytevector-copy!"
+  :params ((dst :as bytevector) (at :as number) (src :as bytevector) &rest bounds)
+  :returns "nil"
+  :doc "Copy bytes from src[start..end) into dst starting at at. Mutates dst.")
+
+(define-primitive
+  "bytevector-append"
+  :params (&rest bvs)
+  :returns "bytevector"
+  :doc "Concatenate bytevectors into a new bytevector.")
+
+(define-primitive
+  "utf8->string"
+  :params ((bv :as bytevector) &rest bounds)
+  :returns "string"
+  :doc "Decode bv[start..end) as UTF-8 and return the string.")
+
+(define-primitive
+  "string->utf8"
+  :params ((s :as string) &rest bounds)
+  :returns "bytevector"
+  :doc "Encode s[start..end) as UTF-8 and return a bytevector.")
+
+(define-primitive
+  "bytevector->list"
+  :params ((bv :as bytevector))
+  :returns "list"
+  :doc "Convert bytevector to a list of byte integers.")
+
+(define-primitive
+  "list->bytevector"
+  :params ((lst :as list))
+  :returns "bytevector"
+  :doc "Build a bytevector from a list of byte integers 0-255.")

spec/tests/test-adt.sx

@@ -0,0 +1,278 @@
+(defsuite
+  "algebraic-data-types"
+  (deftest
+    "constructor creates dict with adt marker"
+    (do
+      (define-type Maybe (Just value) (Nothing))
+      (assert= true (get (Just 42) :_adt))))
+  (deftest
+    "constructor stores type name"
+    (do
+      (define-type Shape (Circle radius) (Square side))
+      (assert= "Shape" (get (Circle 5) :_type))
+      (assert= "Shape" (get (Square 3) :_type))))
+  (deftest
+    "constructor stores constructor name"
+    (do
+      (define-type Opt (Some val) (None))
+      (assert= "Some" (get (Some 1) :_ctor))
+      (assert= "None" (get (None) :_ctor))))
+  (deftest
+    "constructor stores fields as list"
+    (do
+      (define-type Pair (Pair-of fst snd))
+      (assert-equal
+        (list 1 2)
+        (get (Pair-of 1 2) :_fields))))
+  (deftest
+    "zero-arg constructor has empty fields"
+    (do
+      (define-type Flag (Set) (Unset))
+      (assert-equal (list) (get (Set) :_fields))
+      (assert-equal (list) (get (Unset) :_fields))))
+  (deftest
+    "type predicate true for all constructors"
+    (do
+      (define-type Expr (Num n) (Add left right) (Neg e))
+      (assert= true (Expr? (Num 5)))
+      (assert= true (Expr? (Add (Num 1) (Num 2))))
+      (assert= true (Expr? (Neg (Num 3))))))
+  (deftest
+    "type predicate false for non-adt values"
+    (do
+      (define-type Box (Box-of x))
+      (assert= false (Box? 42))
+      (assert= false (Box? "hello"))
+      (assert= false (Box? nil))
+      (assert= false (Box? (list 1 2)))
+      (assert= false (Box? {}))))
+  (deftest
+    "type predicate false for wrong adt type"
+    (do
+      (define-type AT (AV x))
+      (define-type BT (BV x))
+      (assert= false (AT? (BV 1)))
+      (assert= false (BT? (AV 1)))))
+  (deftest
+    "constructor predicate true for matching constructor"
+    (do
+      (define-type Result (Ok value) (Err msg))
+      (assert= true (Ok? (Ok 42)))
+      (assert= true (Err? (Err "bad")))))
+  (deftest
+    "constructor predicate false for wrong constructor"
+    (do
+      (define-type Coin (Heads) (Tails))
+      (assert= false (Heads? (Tails)))
+      (assert= false (Tails? (Heads)))))
+  (deftest
+    "constructor predicate false for non-adt"
+    (do
+      (define-type Wrap (Wrapped x))
+      (assert= false (Wrapped? 42))
+      (assert= false (Wrapped? nil))
+      (assert= false (Wrapped? "str"))))
+  (deftest
+    "single-field accessor returns field value"
+    (do
+      (define-type Holder (Held content))
+      (assert= 99 (Held-content (Held 99)))
+      (assert= "hello" (Held-content (Held "hello")))))
+  (deftest
+    "multi-field accessors return correct fields"
+    (do
+      (define-type Triple (Triple-of a b c))
+      (let
+        ((t (Triple-of 10 20 30)))
+        (assert= 10 (Triple-of-a t))
+        (assert= 20 (Triple-of-b t))
+        (assert= 30 (Triple-of-c t)))))
+  (deftest
+    "tree constructors and accessors"
+    (do
+      (define-type Tree (Leaf) (Node left val right))
+      (let
+        ((t (Node (Leaf) 5 (Node (Leaf) 3 (Leaf)))))
+        (assert= true (Node? t))
+        (assert= 5 (Node-val t))
+        (assert= true (Leaf? (Node-left t)))
+        (assert= true (Node? (Node-right t)))
+        (assert= 3 (Node-val (Node-right t))))))
+  (deftest
+    "arity error on too few args"
+    (do
+      (define-type Pair2 (Pair2-of a b))
+      (let
+        ((ok false))
+        (guard (exn (else (set! ok true))) (Pair2-of 1))
+        (assert ok))))
+  (deftest
+    "arity error on too many args"
+    (do
+      (define-type Single (Single-of x))
+      (let
+        ((ok false))
+        (guard
+          (exn (else (set! ok true)))
+          (Single-of 1 2))
+        (assert ok))))
+  (deftest
+    "multiple types are independent"
+    (do
+      (define-type Color2 (Red2) (Green2) (Blue2))
+      (define-type Suit (Hearts) (Diamonds) (Clubs) (Spades))
+      (assert= false (Color2? (Hearts)))
+      (assert= false (Suit? (Red2)))
+      (assert= true (Color2? (Blue2)))
+      (assert= true (Suit? (Spades)))))
+  (deftest
+    "adt fields can hold any value"
+    (do
+      (define-type Container (Hold x))
+      (assert-equal
+        (list 1 2 3)
+        (Hold-x (Hold (list 1 2 3))))
+      (assert-equal {:a 1} (Hold-x (Hold {:a 1})))))
+  (deftest
+    "adt-registry tracks type constructor names"
+    (do
+      (define-type Days (Mon) (Tue) (Wed) (Thu) (Fri))
+      (assert-equal
+        (list "Mon" "Tue" "Wed" "Thu" "Fri")
+        (get *adt-registry* "Days"))))
+  (deftest
+    "constructors with same field name in different types are independent"
+    (do
+      (define-type P1 (P1-ctor value))
+      (define-type P2 (P2-ctor value))
+      (assert= 10 (P1-ctor-value (P1-ctor 10)))
+      (assert= 20 (P2-ctor-value (P2-ctor 20)))))
+  (deftest
+    "match dispatches on first matching constructor"
+    (do
+      (define-type Color (Red) (Green) (Blue))
+      (assert= "red" (match (Red) ((Red) "red") ((Green) "green") ((Blue) "blue")))
+      (assert= "green" (match (Green) ((Red) "red") ((Green) "green") ((Blue) "blue")))
+      (assert= "blue" (match (Blue) ((Red) "red") ((Green) "green") ((Blue) "blue")))))
+  (deftest
+    "match binds field to variable"
+    (do
+      (define-type Wrapper (Wrap val))
+      (assert= 42 (match (Wrap 42) ((Wrap v) v)))
+      (assert= "hi" (match (Wrap "hi") ((Wrap v) v)))))
+  (deftest
+    "match zero-arg constructor"
+    (do
+      (define-type Signal (On) (Off))
+      (assert= "on" (match (On) ((On) "on") ((Off) "off")))
+      (assert= "off" (match (Off) ((On) "on") ((Off) "off")))))
+  (deftest
+    "match multi-field constructor binds all fields"
+    (do
+      (define-type Vec2 (V2 x y))
+      (let ((v (V2 3 4)))
+        (assert= 7 (match v ((V2 a b) (+ a b)))))))
+  (deftest
+    "match with else clause"
+    (do
+      (define-type Opt2 (Some2 val) (None2))
+      (assert= 10 (match (Some2 10) ((Some2 v) v) (else 0)))
+      (assert= 0 (match (None2) ((Some2 v) v) (else 0)))))
+  (deftest
+    "match else catches non-adt values"
+    (do
+      (assert= "other" (match 42 ((else) "other") (else "other")))
+      (assert= "other" (match "str" (else "other")))))
+  (deftest
+    "match returns body expression value"
+    (do
+      (define-type Num (Num-of n))
+      (assert= 100 (match (Num-of 10) ((Num-of n) (* n n))))))
+  (deftest
+    "match second arm fires when first does not match"
+    (do
+      (define-type Either (Left val) (Right val))
+      (assert= "left-1" (match (Left 1) ((Left v) (str "left-" v)) ((Right v) (str "right-" v))))
+      (assert= "right-2" (match (Right 2) ((Left v) (str "left-" v)) ((Right v) (str "right-" v))))))
+  (deftest
+    "match wildcard _ in constructor pattern"
+    (do
+      (define-type Pair3 (Pair3-of a b))
+      (assert= 5 (match (Pair3-of 5 99) ((Pair3-of x _) x)))
+      (assert= 99 (match (Pair3-of 5 99) ((Pair3-of _ y) y)))))
+  (deftest
+    "match nested adt constructor pattern"
+    (do
+      (define-type Tree2 (Leaf2) (Node2 left val right))
+      (let ((t (Node2 (Leaf2) 7 (Leaf2))))
+        (assert= 7 (match t ((Node2 _ v _) v)))
+        (assert= true (match t ((Node2 (Leaf2) _ _) true) (else false))))))
+  (deftest
+    "match literal pattern"
+    (do
+      (assert= "zero" (match 0 (0 "zero") (else "nonzero")))
+      (assert= "hello" (match "hello" ("hello" "hello") (else "other")))))
+  (deftest
+    "match symbol binding pattern"
+    (do
+      (assert= 42 (match 42 (x x)))))
+  (deftest
+    "match no matching clause raises error"
+    (do
+      (define-type AB (A-val) (B-val))
+      (let ((ok false))
+        (guard (exn (else (set! ok true)))
+          (match (A-val) ((B-val) "b")))
+        (assert ok))))
+  (deftest
+    "match result used in further computation"
+    (do
+      (define-type Num2 (N v))
+      (assert= 30
+        (+
+          (match (N 10) ((N v) v))
+          (match (N 20) ((N v) v))))))
+  (deftest
+    "match with define"
+    (do
+      (define-type Tag (Tagged label value))
+      (define get-label (fn (t) (match t ((Tagged lbl _) lbl))))
+      (define get-value (fn (t) (match t ((Tagged _ val) val))))
+      (let ((t (Tagged "name" 99)))
+        (assert= "name" (get-label t))
+        (assert= 99 (get-value t)))))
+  (deftest
+    "match three-field constructor"
+    (do
+      (define-type Triple2 (T3 a b c))
+      (assert= 6 (match (T3 1 2 3) ((T3 a b c) (+ a b c))))))
+  (deftest
+    "match clauses tried in order"
+    (do
+      (define-type Expr2 (Lit n) (Add l r) (Mul l r))
+      (define eval-expr2 (fn (e)
+        (match e
+          ((Lit n) n)
+          ((Add l r) (+ (eval-expr2 l) (eval-expr2 r)))
+          ((Mul l r) (* (eval-expr2 l) (eval-expr2 r))))))
+      (assert= 7 (eval-expr2 (Add (Lit 3) (Lit 4))))
+      (assert= 12 (eval-expr2 (Mul (Lit 3) (Lit 4))))
+      (assert= 11 (eval-expr2 (Add (Lit 2) (Mul (Lit 3) (Lit 3)))))))
+  (deftest
+    "match else binding captures value"
+    (do
+      (define-type Coin2 (Heads2) (Tails2))
+      (assert= "Tails2" (match (Tails2) ((Heads2) "Heads2") (x (get x :_ctor))))))
+  (deftest
+    "match on adt with string field"
+    (do
+      (define-type Msg (Hello name) (Bye name))
+      (assert= "Hello, Alice" (match (Hello "Alice") ((Hello n) (str "Hello, " n)) ((Bye n) (str "Bye, " n))))
+      (assert= "Bye, Bob" (match (Bye "Bob") ((Hello n) (str "Hello, " n)) ((Bye n) (str "Bye, " n))))))
+  (deftest
+    "match nested pattern with variable binding"
+    (do
+      (define-type Box2 (Box2-of v))
+      (define-type Inner (Inner-of n))
+      (assert= 5 (match (Box2-of (Inner-of 5)) ((Box2-of (Inner-of n)) n)))))
+)

spec/tests/test-bitwise.sx

@@ -0,0 +1,157 @@
+(defsuite
+  "bitwise-operations"
+  (deftest
+    "bitwise-and basic"
+    (do
+      (assert= 0 (bitwise-and 0 0))
+      (assert= 1 (bitwise-and 3 1))
+      (assert= 0 (bitwise-and 5 2))
+      (assert= 4 (bitwise-and 12 6))))
+  (deftest
+    "bitwise-and identity and zero"
+    (do
+      (assert= 255 (bitwise-and 255 255))
+      (assert= 0 (bitwise-and 255 0))))
+  (deftest
+    "bitwise-or basic"
+    (do
+      (assert= 0 (bitwise-or 0 0))
+      (assert= 3 (bitwise-or 1 2))
+      (assert= 7 (bitwise-or 5 3))
+      (assert= 15 (bitwise-or 9 6))))
+  (deftest
+    "bitwise-or identity"
+    (do
+      (assert= 255 (bitwise-or 255 0))
+      (assert= 255 (bitwise-or 0 255))))
+  (deftest
+    "bitwise-xor basic"
+    (do
+      (assert= 0 (bitwise-xor 0 0))
+      (assert= 3 (bitwise-xor 1 2))
+      (assert= 6 (bitwise-xor 3 5))
+      (assert= 0 (bitwise-xor 255 255))))
+  (deftest
+    "bitwise-xor toggle bits"
+    (do
+      (assert= 14 (bitwise-xor 10 4))
+      (assert= 10 (bitwise-xor 14 4))))
+  (deftest
+    "bitwise-not zero"
+    (do (assert= -1 (bitwise-not 0))))
+  (deftest
+    "bitwise-not positive"
+    (do
+      (assert= -2 (bitwise-not 1))
+      (assert= -5 (bitwise-not 4))
+      (assert= -256 (bitwise-not 255))))
+  (deftest
+    "bitwise-not negative"
+    (do
+      (assert= 0 (bitwise-not -1))
+      (assert= 1 (bitwise-not -2))
+      (assert= 4 (bitwise-not -5))))
+  (deftest
+    "bitwise-not double negation"
+    (do
+      (assert= 42 (bitwise-not (bitwise-not 42)))
+      (assert= 0 (bitwise-not (bitwise-not 0)))))
+  (deftest
+    "arithmetic-shift left"
+    (do
+      (assert= 2 (arithmetic-shift 1 1))
+      (assert= 4 (arithmetic-shift 1 2))
+      (assert= 16 (arithmetic-shift 1 4))
+      (assert= 8 (arithmetic-shift 2 2))))
+  (deftest
+    "arithmetic-shift right"
+    (do
+      (assert= 1 (arithmetic-shift 2 -1))
+      (assert= 1 (arithmetic-shift 4 -2))
+      (assert= 5 (arithmetic-shift 10 -1))
+      (assert= 2 (arithmetic-shift 16 -3))))
+  (deftest
+    "arithmetic-shift by zero"
+    (do
+      (assert= 42 (arithmetic-shift 42 0))
+      (assert= 0 (arithmetic-shift 0 5))))
+  (deftest
+    "arithmetic-shift negative value right preserves sign"
+    (do
+      (assert= -1 (arithmetic-shift -1 -1))
+      (assert= -2 (arithmetic-shift -4 -1))))
+  (deftest
+    "bit-count zero"
+    (do (assert= 0 (bit-count 0))))
+  (deftest
+    "bit-count powers of two"
+    (do
+      (assert= 1 (bit-count 1))
+      (assert= 1 (bit-count 2))
+      (assert= 1 (bit-count 4))
+      (assert= 1 (bit-count 128))))
+  (deftest
+    "bit-count all-ones values"
+    (do
+      (assert= 8 (bit-count 255))
+      (assert= 4 (bit-count 15))
+      (assert= 2 (bit-count 3))))
+  (deftest
+    "bit-count mixed"
+    (do
+      (assert= 3 (bit-count 7))
+      (assert= 2 (bit-count 5))
+      (assert= 3 (bit-count 11))
+      (assert= 4 (bit-count 30))))
+  (deftest
+    "integer-length zero"
+    (do (assert= 0 (integer-length 0))))
+  (deftest
+    "integer-length powers of two"
+    (do
+      (assert= 1 (integer-length 1))
+      (assert= 2 (integer-length 2))
+      (assert= 3 (integer-length 4))
+      (assert= 4 (integer-length 8))
+      (assert= 8 (integer-length 128))))
+  (deftest
+    "integer-length non-powers"
+    (do
+      (assert= 2 (integer-length 3))
+      (assert= 3 (integer-length 5))
+      (assert= 3 (integer-length 7))
+      (assert= 8 (integer-length 255))
+      (assert= 9 (integer-length 256))))
+  (deftest
+    "bitwise ops compose"
+    (do
+      (assert=
+        5
+        (bitwise-and
+          (bitwise-or 5 3)
+          (bitwise-xor 7 2)))
+      (assert= 0 (bitwise-and 170 85))))
+  (deftest
+    "arithmetic-shift round-trip"
+    (do
+      (assert=
+        10
+        (arithmetic-shift (arithmetic-shift 10 3) -3))))
+  (deftest
+    "extract bits with mask"
+    (do
+      (let
+        ((x 52))
+        (assert=
+          5
+          (bitwise-and (arithmetic-shift x -2) 7)))))
+  (deftest
+    "clear low bits with bitwise-not mask"
+    (do
+      (assert= 252 (bitwise-and 255 (bitwise-not 3)))))
+  (deftest
+    "integer-length after shift"
+    (do
+      (assert=
+        4
+        (integer-length (arithmetic-shift 1 3))))))

spec/tests/test-bytevectors.sx

@@ -0,0 +1,236 @@
+;; ==========================================================================
+;; test-bytevectors.sx — Tests for bytevector primitives
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; make-bytevector / bytevector?
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:create"
+  (deftest
+    "make-bytevector returns bytevector"
+    (assert (bytevector? (make-bytevector 4))))
+  (deftest
+    "make-bytevector zeroes by default"
+    (let
+      ((bv (make-bytevector 3)))
+      (assert
+        (and
+          (= (bytevector-u8-ref bv 0) 0)
+          (= (bytevector-u8-ref bv 1) 0)
+          (= (bytevector-u8-ref bv 2) 0)))))
+  (deftest
+    "make-bytevector with fill"
+    (let
+      ((bv (make-bytevector 3 42)))
+      (assert
+        (and
+          (= (bytevector-u8-ref bv 0) 42)
+          (= (bytevector-u8-ref bv 1) 42)
+          (= (bytevector-u8-ref bv 2) 42)))))
+  (deftest
+    "make-bytevector length 0"
+    (assert= (bytevector-length (make-bytevector 0)) 0))
+  (deftest
+    "bytevector? true for bytevector"
+    (assert (bytevector? (make-bytevector 2))))
+  (deftest
+    "bytevector? false for string"
+    (assert (not (bytevector? "hello"))))
+  (deftest "bytevector? false for nil" (assert (not (bytevector? nil))))
+  (deftest
+    "bytevector? false for list"
+    (assert (not (bytevector? (list 1 2 3))))))
+
+;; --------------------------------------------------------------------------
+;; bytevector-length / u8-ref / u8-set!
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:access"
+  (deftest
+    "bytevector-length"
+    (assert= (bytevector-length (make-bytevector 5)) 5))
+  (deftest
+    "u8-ref reads fill byte"
+    (assert=
+      (bytevector-u8-ref (make-bytevector 4 99) 2)
+      99))
+  (deftest
+    "u8-set! mutates"
+    (let
+      ((bv (make-bytevector 3 0)))
+      (bytevector-u8-set! bv 1 200)
+      (assert= (bytevector-u8-ref bv 1) 200)))
+  (deftest
+    "u8-set! boundary byte 255"
+    (let
+      ((bv (make-bytevector 1 0)))
+      (bytevector-u8-set! bv 0 255)
+      (assert= (bytevector-u8-ref bv 0) 255)))
+  (deftest
+    "u8-set! byte 0"
+    (let
+      ((bv (make-bytevector 1 255)))
+      (bytevector-u8-set! bv 0 0)
+      (assert= (bytevector-u8-ref bv 0) 0))))
+
+;; --------------------------------------------------------------------------
+;; bytevector-copy
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:copy"
+  (deftest
+    "copy produces equal content"
+    (let
+      ((bv (make-bytevector 3 7)))
+      (let
+        ((bv2 (bytevector-copy bv)))
+        (assert
+          (and
+            (= (bytevector-u8-ref bv2 0) 7)
+            (= (bytevector-u8-ref bv2 1) 7)
+            (= (bytevector-u8-ref bv2 2) 7))))))
+  (deftest
+    "copy is independent"
+    (let
+      ((bv (make-bytevector 2 0)))
+      (let
+        ((bv2 (bytevector-copy bv)))
+        (bytevector-u8-set! bv2 0 99)
+        (assert= (bytevector-u8-ref bv 0) 0))))
+  (deftest
+    "copy with start"
+    (let
+      ((bv (list->bytevector (list 10 20 30 40))))
+      (let
+        ((bv2 (bytevector-copy bv 2)))
+        (assert
+          (and
+            (= (bytevector-length bv2) 2)
+            (= (bytevector-u8-ref bv2 0) 30))))))
+  (deftest
+    "copy with start and end"
+    (let
+      ((bv (list->bytevector (list 10 20 30 40))))
+      (let
+        ((bv2 (bytevector-copy bv 1 3)))
+        (assert
+          (and
+            (= (bytevector-length bv2) 2)
+            (= (bytevector-u8-ref bv2 0) 20)
+            (= (bytevector-u8-ref bv2 1) 30)))))))
+
+;; --------------------------------------------------------------------------
+;; bytevector-copy!
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:copy-bang"
+  (deftest
+    "copy! overwrites dst region"
+    (let
+      ((dst (make-bytevector 4 0)))
+      (let
+        ((src (list->bytevector (list 1 2 3))))
+        (bytevector-copy! dst 1 src)
+        (assert
+          (and
+            (= (bytevector-u8-ref dst 0) 0)
+            (= (bytevector-u8-ref dst 1) 1)
+            (= (bytevector-u8-ref dst 2) 2)
+            (= (bytevector-u8-ref dst 3) 3))))))
+  (deftest
+    "copy! with src bounds"
+    (let
+      ((dst (make-bytevector 2 0)))
+      (let
+        ((src (list->bytevector (list 10 20 30 40))))
+        (bytevector-copy! dst 0 src 1 3)
+        (assert
+          (and
+            (= (bytevector-u8-ref dst 0) 20)
+            (= (bytevector-u8-ref dst 1) 30)))))))
+
+;; --------------------------------------------------------------------------
+;; bytevector-append
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:append"
+  (deftest
+    "append two bytevectors"
+    (let
+      ((bv (bytevector-append (list->bytevector (list 1 2)) (list->bytevector (list 3 4)))))
+      (assert
+        (and
+          (= (bytevector-length bv) 4)
+          (= (bytevector-u8-ref bv 0) 1)
+          (= (bytevector-u8-ref bv 3) 4)))))
+  (deftest
+    "append three bytevectors"
+    (let
+      ((bv (bytevector-append (list->bytevector (list 1)) (list->bytevector (list 2)) (list->bytevector (list 3)))))
+      (assert= (bytevector-length bv) 3)))
+  (deftest
+    "append empty"
+    (assert=
+      (bytevector-length
+        (bytevector-append
+          (make-bytevector 0)
+          (make-bytevector 0)))
+      0)))
+
+;; --------------------------------------------------------------------------
+;; list->bytevector / bytevector->list
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:conversion"
+  (deftest
+    "list->bytevector roundtrip"
+    (let
+      ((lst (list 10 20 30)))
+      (assert= (bytevector->list (list->bytevector lst)) lst)))
+  (deftest
+    "list->bytevector empty"
+    (assert= (bytevector-length (list->bytevector nil)) 0))
+  (deftest
+    "bytevector->list from make-bytevector"
+    (let
+      ((lst (bytevector->list (make-bytevector 3 5))))
+      (assert= lst (list 5 5 5)))))
+
+;; --------------------------------------------------------------------------
+;; utf8 roundtrip
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "bv:utf8"
+  (deftest
+    "string->utf8 returns bytevector"
+    (assert (bytevector? (string->utf8 "hello"))))
+  (deftest
+    "string->utf8 length"
+    (assert= (bytevector-length (string->utf8 "abc")) 3))
+  (deftest
+    "utf8->string roundtrip"
+    (assert= (utf8->string (string->utf8 "hello")) "hello"))
+  (deftest
+    "utf8->string with slice"
+    (let
+      ((bv (string->utf8 "hello")))
+      (assert= (utf8->string bv 1 4) "ell")))
+  (deftest
+    "string->utf8 with start"
+    (assert= (utf8->string (string->utf8 "hello" 2)) "llo"))
+  (deftest
+    "string->utf8 with start and end"
+    (assert=
+      (utf8->string (string->utf8 "hello" 1 4))
+      "ell"))
+  (deftest
+    "empty string round-trips"
+    (assert= (utf8->string (string->utf8 "")) "")))

spec/tests/test-chars.sx

@@ -0,0 +1,185 @@
+;; Tests for character type (Phase 13)
+;; Uses (make-char n) and (char-code "x") instead of #\x literals
+;; (char literal parser syntax tested via sx-parse call)
+
+(deftest
+  "make-char produces a char"
+  (assert= true (char? (make-char 97))))
+
+(deftest "char? false for string" (assert= false (char? "a")))
+
+(deftest "char? false for number" (assert= false (char? 65)))
+
+(deftest "char? false for nil" (assert= false (char? nil)))
+
+(deftest
+  "char->integer extracts codepoint"
+  (assert= 97 (char->integer (make-char 97))))
+
+(deftest
+  "integer->char alias for make-char"
+  (assert= 65 (char->integer (integer->char 65))))
+
+(deftest
+  "char->integer round-trip"
+  (assert= 122 (char->integer (make-char 122))))
+
+(deftest
+  "char=? equal"
+  (assert= true (char=? (make-char 97) (make-char 97))))
+
+(deftest
+  "char=? unequal"
+  (assert= false (char=? (make-char 97) (make-char 98))))
+
+(deftest
+  "char<? ordering"
+  (assert= true (char<? (make-char 97) (make-char 98))))
+
+(deftest
+  "char>? ordering"
+  (assert= true (char>? (make-char 98) (make-char 97))))
+
+(deftest
+  "char<=? equal"
+  (assert= true (char<=? (make-char 65) (make-char 65))))
+
+(deftest
+  "char>=? greater"
+  (assert= true (char>=? (make-char 90) (make-char 65))))
+
+(deftest
+  "char-ci=? ignores case (a vs A)"
+  (assert= true (char-ci=? (make-char 97) (make-char 65))))
+
+(deftest
+  "char-ci<? a < b case-insensitive"
+  (assert= true (char-ci<? (make-char 97) (make-char 98))))
+
+(deftest
+  "char-ci>? b > a case-insensitive"
+  (assert= true (char-ci>? (make-char 66) (make-char 65))))
+
+(deftest
+  "char-alphabetic? true for a"
+  (assert= true (char-alphabetic? (make-char 97))))
+
+(deftest
+  "char-alphabetic? true for Z"
+  (assert= true (char-alphabetic? (make-char 90))))
+
+(deftest
+  "char-alphabetic? false for digit"
+  (assert= false (char-alphabetic? (make-char 48))))
+
+(deftest
+  "char-numeric? true for 0"
+  (assert= true (char-numeric? (make-char 48))))
+
+(deftest
+  "char-numeric? true for 9"
+  (assert= true (char-numeric? (make-char 57))))
+
+(deftest
+  "char-numeric? false for letter"
+  (assert= false (char-numeric? (make-char 65))))
+
+(deftest
+  "char-whitespace? true for space"
+  (assert= true (char-whitespace? (make-char 32))))
+
+(deftest
+  "char-whitespace? true for newline"
+  (assert= true (char-whitespace? (make-char 10))))
+
+(deftest
+  "char-whitespace? false for letter"
+  (assert= false (char-whitespace? (make-char 65))))
+
+(deftest
+  "char-upper-case? true for A"
+  (assert= true (char-upper-case? (make-char 65))))
+
+(deftest
+  "char-upper-case? false for a"
+  (assert= false (char-upper-case? (make-char 97))))
+
+(deftest
+  "char-lower-case? true for a"
+  (assert= true (char-lower-case? (make-char 97))))
+
+(deftest
+  "char-lower-case? false for A"
+  (assert= false (char-lower-case? (make-char 65))))
+
+(deftest
+  "char-upcase converts a to A"
+  (assert= 65 (char->integer (char-upcase (make-char 97)))))
+
+(deftest
+  "char-downcase converts A to a"
+  (assert=
+    97
+    (char->integer (char-downcase (make-char 65)))))
+
+(deftest
+  "char-upcase idempotent on uppercase"
+  (assert= 65 (char->integer (char-upcase (make-char 65)))))
+
+(deftest
+  "string->list returns list of chars"
+  (assert= 3 (len (string->list "abc"))))
+
+(deftest
+  "string->list element 0 is char"
+  (assert= true (char? (get (string->list "abc") 0))))
+
+(deftest
+  "string->list codepoints correct"
+  (assert= 97 (char->integer (get (string->list "abc") 0))))
+
+(deftest
+  "list->string from chars produces string"
+  (assert=
+    "abc"
+    (list->string
+      (list
+        (make-char 97)
+        (make-char 98)
+        (make-char 99)))))
+
+(deftest
+  "string->list list->string round-trip"
+  (let ((s "hello")) (assert= s (list->string (string->list s)))))
+
+(deftest
+  "char literal parsed via sx-parse"
+  (let
+    ((ast (sx-parse "#\\a")))
+    (assert= true (char? (get ast 0)))))
+
+(deftest
+  "char literal codepoint via sx-parse"
+  (let
+    ((ast (sx-parse "#\\a")))
+    (assert= 97 (char->integer (get ast 0)))))
+
+(deftest
+  "named char space via sx-parse"
+  (let
+    ((ast (sx-parse "#\\space")))
+    (assert= 32 (char->integer (get ast 0)))))
+
+(deftest
+  "named char newline via sx-parse"
+  (let
+    ((ast (sx-parse "#\\newline")))
+    (assert= 10 (char->integer (get ast 0)))))
+
+(deftest
+  "char-ci<=? equal case-insensitive"
+  (assert= true (char-ci<=? (make-char 65) (make-char 97))))
+
+(deftest
+  "char-ci>=? equal case-insensitive"
+  (assert= true (char-ci>=? (make-char 97) (make-char 65))))

spec/tests/test-coroutines.sx

@@ -0,0 +1,305 @@
+(import (sx coroutines))
+
+(defsuite
+  "coroutine"
+  (deftest
+    "coroutine? recognizes coroutine objects"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (assert (coroutine? co))
+      (assert= false (coroutine? 42))
+      (assert= false (coroutine? "hello"))
+      (assert= false (coroutine? nil))
+      (assert= false (coroutine? (list)))))
+  (deftest
+    "coroutine-alive? true for ready coroutine"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (assert (coroutine-alive? co))))
+  (deftest
+    "coroutine-alive? false for non-coroutine"
+    (assert= false (coroutine-alive? 42)))
+  (deftest
+    "immediate return — done true, value is body result"
+    (let
+      ((co (make-coroutine (fn () 42))))
+      (let
+        ((r (coroutine-resume co nil)))
+        (assert= true (get r "done"))
+        (assert= 42 (get r "value")))))
+  (deftest
+    "immediate nil return"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (let
+        ((r (coroutine-resume co nil)))
+        (assert= true (get r "done"))
+        (assert= nil (get r "value")))))
+  (deftest
+    "coroutine-alive? false after completion"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (coroutine-resume co nil)
+      (assert= false (coroutine-alive? co))))
+  (deftest
+    "single yield — done false on yield, done true on finish"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield 10) 20))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co nil)))
+          (assert= false (get r1 "done"))
+          (assert= 10 (get r1 "value"))
+          (assert= true (get r2 "done"))
+          (assert= 20 (get r2 "value"))))))
+  (deftest
+    "coroutine-alive? true between yield and next resume"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield nil) nil))))
+      (assert (coroutine-alive? co))
+      (coroutine-resume co nil)
+      (assert (coroutine-alive? co))
+      (coroutine-resume co nil)
+      (assert= false (coroutine-alive? co))))
+  (deftest
+    "three yields then return"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield "a") (coroutine-yield "b") (coroutine-yield "c") "z"))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co nil)))
+          (let
+            ((r3 (coroutine-resume co nil)))
+            (let
+              ((r4 (coroutine-resume co nil)))
+              (assert= "a" (get r1 "value"))
+              (assert= false (get r1 "done"))
+              (assert= "b" (get r2 "value"))
+              (assert= false (get r2 "done"))
+              (assert= "c" (get r3 "value"))
+              (assert= false (get r3 "done"))
+              (assert= "z" (get r4 "value"))
+              (assert= true (get r4 "done"))))))))
+  (deftest
+    "final return vs yield — done flag distinguishes them"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield "yielded") "returned"))))
+      (let
+        ((y (coroutine-resume co nil)))
+        (let
+          ((r (coroutine-resume co nil)))
+          (assert= false (get y "done"))
+          (assert= "yielded" (get y "value"))
+          (assert= true (get r "done"))
+          (assert= "returned" (get r "value"))))))
+  (deftest
+    "resume val becomes yield return value"
+    (let
+      ((co (make-coroutine (fn () (let ((received (coroutine-yield "first"))) received)))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co 99)))
+          (assert= "first" (get r1 "value"))
+          (assert= false (get r1 "done"))
+          (assert= 99 (get r2 "value"))
+          (assert= true (get r2 "done"))))))
+  (deftest
+    "multiple resume values passed through yields"
+    (let
+      ((co (make-coroutine (fn () (let ((a (coroutine-yield 1))) (let ((b (coroutine-yield 2))) (+ a b)))))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co 10)))
+          (let
+            ((r3 (coroutine-resume co 20)))
+            (assert= 1 (get r1 "value"))
+            (assert= 2 (get r2 "value"))
+            (assert= true (get r3 "done"))
+            (assert= 30 (get r3 "value")))))))
+  (deftest
+    "coroutine captures lexical environment"
+    (let
+      ((x 10)
+        (co
+          (make-coroutine
+            (fn () (coroutine-yield (* x 2)) (* x 3)))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co nil)))
+          (assert= 20 (get r1 "value"))
+          (assert= 30 (get r2 "value"))))))
+  (deftest
+    "resuming dead coroutine raises error"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (coroutine-resume co nil)
+      (assert-throws (fn () (coroutine-resume co nil)))))
+  (deftest
+    "coroutine drives iteration via recursive body"
+    (let
+      ((co (make-coroutine (fn () (define loop (fn (i) (when (< i 4) (coroutine-yield i) (loop (+ i 1))))) (loop 0))))
+        (results (list)))
+      (let
+        drive
+        ()
+        (let
+          ((r (coroutine-resume co nil)))
+          (when
+            (not (get r "done"))
+            (append! results (get r "value"))
+            (drive))))
+      (assert= 4 (len results))
+      (assert= 0 (nth results 0))
+      (assert= 1 (nth results 1))
+      (assert= 2 (nth results 2))
+      (assert= 3 (nth results 3))))
+  (deftest
+    "nested coroutine — inner resumed from outer body"
+    (let
+      ((inner (make-coroutine (fn () (coroutine-yield "inner-a") "inner-done")))
+        (outer
+          (make-coroutine
+            (fn
+              ()
+              (let
+                ((i1 (coroutine-resume inner nil)))
+                (coroutine-yield (get i1 "value")))
+              (let ((i2 (coroutine-resume inner nil))) (get i2 "value"))))))
+      (let
+        ((o1 (coroutine-resume outer nil)))
+        (let
+          ((o2 (coroutine-resume outer nil)))
+          (assert= false (get o1 "done"))
+          (assert= "inner-a" (get o1 "value"))
+          (assert= true (get o2 "done"))
+          (assert= "inner-done" (get o2 "value"))))))
+  (deftest
+    "two independent coroutines interleave correctly"
+    (let
+      ((co1 (make-coroutine (fn () (coroutine-yield 1) 5)))
+        (co2
+          (make-coroutine (fn () (coroutine-yield 2) 6))))
+      (let
+        ((a (coroutine-resume co1 nil)))
+        (let
+          ((b (coroutine-resume co2 nil)))
+          (let
+            ((c (coroutine-resume co1 nil)))
+            (let
+              ((d (coroutine-resume co2 nil)))
+              (assert= false (get a "done"))
+              (assert= 1 (get a "value"))
+              (assert= false (get b "done"))
+              (assert= 2 (get b "value"))
+              (assert= true (get c "done"))
+              (assert= 5 (get c "value"))
+              (assert= true (get d "done"))
+              (assert= 6 (get d "value"))))))))
+  (deftest
+    "coroutine state field is ready before first resume"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield 1)))))
+      (assert= "ready" (get co "state"))))
+  (deftest
+    "coroutine state field is suspended between yields"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield 1) 2))))
+      (coroutine-resume co nil)
+      (assert= "suspended" (get co "state"))))
+  (deftest
+    "coroutine state field is dead after completion"
+    (let
+      ((co (make-coroutine (fn () nil))))
+      (coroutine-resume co nil)
+      (assert= "dead" (get co "state"))))
+  (deftest
+    "yield works when called from nested helper function"
+    (let
+      ((co (make-coroutine (fn () (define helper (fn (x) (coroutine-yield x))) (helper 10) (helper 20)))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co nil)))
+          (let
+            ((r3 (coroutine-resume co nil)))
+            (assert= false (get r1 "done"))
+            (assert= 10 (get r1 "value"))
+            (assert= false (get r2 "done"))
+            (assert= 20 (get r2 "value"))
+            (assert= true (get r3 "done")))))))
+  (deftest
+    "initial resume argument is ignored by ready coroutine"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield 42)))))
+      (let
+        ((r (coroutine-resume co "ignored")))
+        (assert= false (get r "done"))
+        (assert= 42 (get r "value")))))
+  (deftest
+    "coroutine with mutable closure state"
+    (let
+      ((counter {:value 0}))
+      (let
+        ((co (make-coroutine (fn () (dict-set! counter "value" 1) (coroutine-yield "a") (dict-set! counter "value" 2) (coroutine-yield "b")))))
+        (assert= 0 (get counter "value"))
+        (coroutine-resume co nil)
+        (assert= 1 (get counter "value"))
+        (coroutine-resume co nil)
+        (assert= 2 (get counter "value")))))
+  (deftest
+    "coroutine can yield complex values"
+    (let
+      ((co (make-coroutine (fn () (coroutine-yield (list 1 2 3)) (coroutine-yield {:key "val"})))))
+      (let
+        ((r1 (coroutine-resume co nil)))
+        (let
+          ((r2 (coroutine-resume co nil)))
+          (assert= false (get r1 "done"))
+          (assert= 3 (len (get r1 "value")))
+          (assert= false (get r2 "done"))
+          (assert= "val" (get (get r2 "value") "key"))))))
+  (deftest
+    "round-robin scheduling of multiple coroutines"
+    (let
+      ((results (list))
+        (co1
+          (make-coroutine
+            (fn () (coroutine-yield "a") (coroutine-yield "b"))))
+        (co2
+          (make-coroutine
+            (fn () (coroutine-yield "c") (coroutine-yield "d")))))
+      (append! results (get (coroutine-resume co1 nil) "value"))
+      (append! results (get (coroutine-resume co2 nil) "value"))
+      (append! results (get (coroutine-resume co1 nil) "value"))
+      (append! results (get (coroutine-resume co2 nil) "value"))
+      (assert= 4 (len results))
+      (assert= "a" (nth results 0))
+      (assert= "c" (nth results 1))
+      (assert= "b" (nth results 2))
+      (assert= "d" (nth results 3))))
+  (deftest
+    "coroutines created from same factory share no state"
+    (let
+      ((make-counter (fn (start) (make-coroutine (fn () (define loop (fn (n) (coroutine-yield n) (loop (+ n 1)))) (loop start))))))
+      (let
+        ((c1 (make-counter 0)) (c2 (make-counter 100)))
+        (let
+          ((a (get (coroutine-resume c1 nil) "value")))
+          (let
+            ((b (get (coroutine-resume c2 nil) "value")))
+            (let
+              ((c (get (coroutine-resume c1 nil) "value")))
+              (let
+                ((d (get (coroutine-resume c2 nil) "value")))
+                (assert= 0 a)
+                (assert= 100 b)
+                (assert= 1 c)
+                (assert= 101 d))))))))
+  (deftest
+    "resuming non-coroutine raises error"
+    (assert-throws (fn () (coroutine-resume "not-a-coroutine" nil)))))

spec/tests/test-dynamic-wind.sx

@@ -0,0 +1,113 @@
+;; Tests for dynamic-wind: after-thunk fires on normal return,
+;; non-local exit via raise/guard, and call/cc escape.
+
+(defsuite
+  "dynamic-wind-basic"
+  (deftest
+    "after fires on normal return"
+    (let
+      ((log (list)))
+      (dynamic-wind
+        (fn () (append! log "before"))
+        (fn () (append! log "body"))
+        (fn () (append! log "after")))
+      (assert= 3 (len log))
+      (assert= "before" (nth log 0))
+      (assert= "body" (nth log 1))
+      (assert= "after" (nth log 2))))
+  (deftest
+    "after fires on raise escape"
+    (let
+      ((log (list)))
+      (guard
+        (e (true nil))
+        (dynamic-wind
+          (fn () (append! log "before"))
+          (fn () (append! log "body") (error "boom"))
+          (fn () (append! log "after"))))
+      (assert= 3 (len log))
+      (assert= "before" (nth log 0))
+      (assert= "body" (nth log 1))
+      (assert= "after" (nth log 2))))
+  (deftest
+    "after fires on call/cc escape"
+    (let
+      ((log (list)))
+      (call/cc
+        (fn
+          (k)
+          (dynamic-wind
+            (fn () (append! log "before"))
+            (fn () (append! log "body") (k nil))
+            (fn () (append! log "after")))))
+      (assert= 3 (len log))
+      (assert= "before" (nth log 0))
+      (assert= "body" (nth log 1))
+      (assert= "after" (nth log 2))))
+  (deftest
+    "nested dynamic-wind after-thunks fire LIFO on normal return"
+    (let
+      ((log (list)))
+      (dynamic-wind
+        (fn () (append! log "outer-before"))
+        (fn
+          ()
+          (dynamic-wind
+            (fn () (append! log "inner-before"))
+            (fn () (append! log "inner-body"))
+            (fn () (append! log "inner-after"))))
+        (fn () (append! log "outer-after")))
+      (assert= 5 (len log))
+      (assert= "outer-before" (nth log 0))
+      (assert= "inner-before" (nth log 1))
+      (assert= "inner-body" (nth log 2))
+      (assert= "inner-after" (nth log 3))
+      (assert= "outer-after" (nth log 4))))
+  (deftest
+    "nested dynamic-wind after-thunks fire LIFO on raise"
+    (let
+      ((log (list)))
+      (guard
+        (e (true nil))
+        (dynamic-wind
+          (fn () (append! log "outer-before"))
+          (fn
+            ()
+            (dynamic-wind
+              (fn () (append! log "inner-before"))
+              (fn () (append! log "inner-body") (error "boom"))
+              (fn () (append! log "inner-after"))))
+          (fn () (append! log "outer-after"))))
+      (assert= 5 (len log))
+      (assert= "outer-before" (nth log 0))
+      (assert= "inner-before" (nth log 1))
+      (assert= "inner-body" (nth log 2))
+      (assert= "inner-after" (nth log 3))
+      (assert= "outer-after" (nth log 4))))
+  (deftest
+    "before and after are called"
+    (let
+      ((count 0))
+      (dynamic-wind
+        (fn () (set! count (+ count 1)))
+        (fn () nil)
+        (fn () (set! count (+ count 10))))
+      (assert= 11 count)))
+  (deftest
+    "dynamic-wind return value is body result"
+    (let
+      ((result (dynamic-wind (fn () nil) (fn () 42) (fn () nil))))
+      (assert= 42 result)))
+  (deftest
+    "after fires before guard handler"
+    (let
+      ((log (list)))
+      (guard
+        (e (true (append! log "guard-handler")))
+        (dynamic-wind
+          (fn () nil)
+          (fn () (error "boom"))
+          (fn () (append! log "after"))))
+      (assert= 2 (len log))
+      (assert= "after" (nth log 0))
+      (assert= "guard-handler" (nth log 1)))))

spec/tests/test-eval.sx

@@ -10,57 +10,56 @@
 ;; Literals and types
 ;; --------------------------------------------------------------------------
 
-(defsuite "literals"
-  (deftest "numbers are numbers"
+(defsuite
+  "literals"
+  (deftest
+    "numbers are numbers"
     (assert-type "number" 42)
     (assert-type "number" 3.14)
     (assert-type "number" -1))
-
-  (deftest "strings are strings"
+  (deftest
+    "strings are strings"
     (assert-type "string" "hello")
     (assert-type "string" ""))
-
-  (deftest "booleans are booleans"
+  (deftest
+    "booleans are booleans"
     (assert-type "boolean" true)
     (assert-type "boolean" false))
-
-  (deftest "nil is nil"
-    (assert-type "nil" nil)
-    (assert-nil nil))
-
-  (deftest "lists are lists"
+  (deftest "nil is nil" (assert-type "nil" nil) (assert-nil nil))
+  (deftest
+    "lists are lists"
     (assert-type "list" (list 1 2 3))
     (assert-type "list" (list)))
-
-  (deftest "dicts are dicts"
-    (assert-type "dict" {:a 1 :b 2})))
+  (deftest "dicts are dicts" (assert-type "dict" {:b 2 :a 1})))
 
 
 ;; --------------------------------------------------------------------------
 ;; Arithmetic
 ;; --------------------------------------------------------------------------
 
-(defsuite "arithmetic"
-  (deftest "addition"
+(defsuite
+  "arithmetic"
+  (deftest
+    "addition"
     (assert-equal 3 (+ 1 2))
     (assert-equal 0 (+ 0 0))
     (assert-equal -1 (+ 1 -2))
     (assert-equal 10 (+ 1 2 3 4)))
-
-  (deftest "subtraction"
+  (deftest
+    "subtraction"
     (assert-equal 1 (- 3 2))
     (assert-equal -1 (- 2 3)))
-
-  (deftest "multiplication"
+  (deftest
+    "multiplication"
     (assert-equal 6 (* 2 3))
     (assert-equal 0 (* 0 100))
     (assert-equal 24 (* 1 2 3 4)))
-
-  (deftest "division"
+  (deftest
+    "division"
     (assert-equal 2 (/ 6 3))
     (assert-equal 2.5 (/ 5 2)))
-
-  (deftest "modulo"
+  (deftest
+    "modulo"
     (assert-equal 1 (mod 7 3))
     (assert-equal 0 (mod 6 3))))
 
@@ -69,20 +68,26 @@
 ;; Comparison
 ;; --------------------------------------------------------------------------
 
-(defsuite "comparison"
-  (deftest "equality"
+(defsuite
+  "comparison"
+  (deftest
+    "equality"
     (assert-true (= 1 1))
     (assert-false (= 1 2))
     (assert-true (= "a" "a"))
     (assert-false (= "a" "b")))
-
-  (deftest "deep equality"
-    (assert-true (equal? (list 1 2 3) (list 1 2 3)))
-    (assert-false (equal? (list 1 2) (list 1 3)))
+  (deftest
+    "deep equality"
+    (assert-true
+      (equal?
+        (list 1 2 3)
+        (list 1 2 3)))
+    (assert-false
+      (equal? (list 1 2) (list 1 3)))
     (assert-true (equal? {:a 1} {:a 1}))
     (assert-false (equal? {:a 1} {:a 2})))
-
-  (deftest "ordering"
+  (deftest
+    "ordering"
     (assert-true (< 1 2))
     (assert-false (< 2 1))
     (assert-true (> 2 1))
@@ -96,34 +101,36 @@
 ;; String operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "strings"
-  (deftest "str concatenation"
+(defsuite
+  "strings"
+  (deftest
+    "str concatenation"
     (assert-equal "abc" (str "a" "b" "c"))
     (assert-equal "hello world" (str "hello" " " "world"))
     (assert-equal "42" (str 42))
     (assert-equal "" (str)))
-
-  (deftest "string-length"
+  (deftest
+    "string-length"
     (assert-equal 5 (string-length "hello"))
     (assert-equal 0 (string-length "")))
-
-  (deftest "substring"
+  (deftest
+    "substring"
     (assert-equal "ell" (substring "hello" 1 4))
     (assert-equal "hello" (substring "hello" 0 5)))
-
-  (deftest "string-contains?"
+  (deftest
+    "string-contains?"
     (assert-true (string-contains? "hello world" "world"))
     (assert-false (string-contains? "hello" "xyz")))
-
-  (deftest "upcase and downcase"
+  (deftest
+    "upcase and downcase"
     (assert-equal "HELLO" (upcase "hello"))
     (assert-equal "hello" (downcase "HELLO")))
-
-  (deftest "trim"
+  (deftest
+    "trim"
     (assert-equal "hello" (trim "  hello  "))
     (assert-equal "hello" (trim "hello")))
-
-  (deftest "split and join"
+  (deftest
+    "split and join"
     (assert-equal (list "a" "b" "c") (split "a,b,c" ","))
     (assert-equal "a-b-c" (join "-" (list "a" "b" "c")))))
 
@@ -132,121 +139,145 @@
 ;; List operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "lists"
-  (deftest "constructors"
-    (assert-equal (list 1 2 3) (list 1 2 3))
+(defsuite
+  "lists"
+  (deftest
+    "constructors"
+    (assert-equal
+      (list 1 2 3)
+      (list 1 2 3))
     (assert-equal (list) (list))
     (assert-length 3 (list 1 2 3)))
-
-  (deftest "first and rest"
+  (deftest
+    "first and rest"
     (assert-equal 1 (first (list 1 2 3)))
-    (assert-equal (list 2 3) (rest (list 1 2 3)))
+    (assert-equal
+      (list 2 3)
+      (rest (list 1 2 3)))
     (assert-nil (first (list)))
     (assert-equal (list) (rest (list))))
-
-  (deftest "nth"
-    (assert-equal 1 (nth (list 1 2 3) 0))
-    (assert-equal 2 (nth (list 1 2 3) 1))
-    (assert-equal 3 (nth (list 1 2 3) 2)))
-
-  (deftest "last"
+  (deftest
+    "nth"
+    (assert-equal
+      1
+      (nth (list 1 2 3) 0))
+    (assert-equal
+      2
+      (nth (list 1 2 3) 1))
+    (assert-equal
+      3
+      (nth (list 1 2 3) 2)))
+  (deftest
+    "last"
     (assert-equal 3 (last (list 1 2 3)))
     (assert-nil (last (list))))
-
-  (deftest "cons and append"
-    (assert-equal (list 0 1 2) (cons 0 (list 1 2)))
-    (assert-equal (list 1 2 3 4) (append (list 1 2) (list 3 4))))
-
-  (deftest "reverse"
-    (assert-equal (list 3 2 1) (reverse (list 1 2 3)))
+  (deftest
+    "cons and append"
+    (assert-equal
+      (list 0 1 2)
+      (cons 0 (list 1 2)))
+    (assert-equal
+      (list 1 2 3 4)
+      (append (list 1 2) (list 3 4))))
+  (deftest
+    "reverse"
+    (assert-equal
+      (list 3 2 1)
+      (reverse (list 1 2 3)))
     (assert-equal (list) (reverse (list))))
-
-  (deftest "empty?"
+  (deftest
+    "empty?"
     (assert-true (empty? (list)))
     (assert-false (empty? (list 1))))
-
-  (deftest "len"
+  (deftest
+    "len"
     (assert-equal 0 (len (list)))
     (assert-equal 3 (len (list 1 2 3))))
-
-  (deftest "contains?"
-    (assert-true (contains? (list 1 2 3) 2))
-    (assert-false (contains? (list 1 2 3) 4)))
-
-  (deftest "flatten"
-    (assert-equal (list 1 2 3 4) (flatten (list (list 1 2) (list 3 4))))))
+  (deftest
+    "contains?"
+    (assert-true
+      (contains? (list 1 2 3) 2))
+    (assert-false
+      (contains? (list 1 2 3) 4)))
+  (deftest
+    "flatten"
+    (assert-equal
+      (list 1 2 3 4)
+      (flatten
+        (list (list 1 2) (list 3 4))))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Dict operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "dicts"
-  (deftest "dict literal"
-    (assert-type "dict" {:a 1 :b 2})
+(defsuite
+  "dicts"
+  (deftest
+    "dict literal"
+    (assert-type "dict" {:b 2 :a 1})
     (assert-equal 1 (get {:a 1} "a"))
-    (assert-equal 2 (get {:a 1 :b 2} "b")))
-
-  (deftest "assoc"
-    (assert-equal {:a 1 :b 2} (assoc {:a 1} "b" 2))
+    (assert-equal 2 (get {:b 2 :a 1} "b")))
+  (deftest
+    "assoc"
+    (assert-equal {:b 2 :a 1} (assoc {:a 1} "b" 2))
     (assert-equal {:a 99} (assoc {:a 1} "a" 99)))
-
-  (deftest "dissoc"
-    (assert-equal {:b 2} (dissoc {:a 1 :b 2} "a")))
-
-  (deftest "keys and vals"
-    (let ((d {:a 1 :b 2}))
+  (deftest "dissoc" (assert-equal {:b 2} (dissoc {:b 2 :a 1} "a")))
+  (deftest
+    "keys and vals"
+    (let
+      ((d {:b 2 :a 1}))
       (assert-length 2 (keys d))
       (assert-length 2 (vals d))
       (assert-contains "a" (keys d))
       (assert-contains "b" (keys d))))
-
-  (deftest "has-key?"
+  (deftest
+    "has-key?"
     (assert-true (has-key? {:a 1} "a"))
     (assert-false (has-key? {:a 1} "b")))
-
-  (deftest "merge"
-    (assert-equal {:a 1 :b 2 :c 3}
-      (merge {:a 1 :b 2} {:c 3}))
-    (assert-equal {:a 99 :b 2}
-      (merge {:a 1 :b 2} {:a 99}))))
+  (deftest
+    "merge"
+    (assert-equal {:c 3 :b 2 :a 1} (merge {:b 2 :a 1} {:c 3}))
+    (assert-equal {:b 2 :a 99} (merge {:b 2 :a 1} {:a 99}))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Predicates
 ;; --------------------------------------------------------------------------
 
-(defsuite "predicates"
-  (deftest "nil?"
+(defsuite
+  "predicates"
+  (deftest
+    "nil?"
     (assert-true (nil? nil))
     (assert-false (nil? 0))
     (assert-false (nil? false))
     (assert-false (nil? "")))
-
-  (deftest "number?"
+  (deftest
+    "number?"
     (assert-true (number? 42))
     (assert-true (number? 3.14))
     (assert-false (number? "42")))
-
-  (deftest "string?"
+  (deftest
+    "string?"
     (assert-true (string? "hello"))
     (assert-false (string? 42)))
-
-  (deftest "list?"
+  (deftest
+    "list?"
     (assert-true (list? (list 1 2)))
     (assert-false (list? "not a list")))
-
-  (deftest "dict?"
+  (deftest
+    "dict?"
     (assert-true (dict? {:a 1}))
     (assert-false (dict? (list 1))))
-
-  (deftest "boolean?"
+  (deftest
+    "boolean?"
     (assert-true (boolean? true))
     (assert-true (boolean? false))
     (assert-false (boolean? nil))
     (assert-false (boolean? 0)))
-
-  (deftest "not"
+  (deftest
+    "not"
     (assert-true (not false))
     (assert-true (not nil))
     (assert-false (not true))
@@ -258,77 +289,67 @@
 ;; Special forms
 ;; --------------------------------------------------------------------------
 
-(defsuite "special-forms"
-  (deftest "if"
+(defsuite
+  "special-forms"
+  (deftest
+    "if"
     (assert-equal "yes" (if true "yes" "no"))
     (assert-equal "no" (if false "yes" "no"))
     (assert-equal "no" (if nil "yes" "no"))
     (assert-nil (if false "yes")))
-
-  (deftest "when"
+  (deftest
+    "when"
     (assert-equal "yes" (when true "yes"))
     (assert-nil (when false "yes")))
-
-  (deftest "cond"
+  (deftest
+    "cond"
     (assert-equal "a" (cond true "a" :else "b"))
     (assert-equal "b" (cond false "a" :else "b"))
-    (assert-equal "c" (cond
-                        false "a"
-                        false "b"
-                        :else "c")))
-
-  (deftest "cond with 2-element predicate as first test"
-    ;; Regression: cond misclassifies Clojure-style as scheme-style when
-    ;; the first test is a 2-element list like (nil? x) or (empty? x).
-    ;; The evaluator checks: is first arg a 2-element list? If yes, treats
-    ;; as scheme-style ((test body) ...) — returning the arg instead of
-    ;; evaluating the predicate call.
+    (assert-equal "c" (cond false "a" false "b" :else "c")))
+  (deftest
+    "cond with 2-element predicate as first test"
     (assert-equal 0 (cond (nil? nil) 0 :else 1))
     (assert-equal 1 (cond (nil? "x") 0 :else 1))
     (assert-equal "empty" (cond (empty? (list)) "empty" :else "not-empty"))
-    (assert-equal "not-empty" (cond (empty? (list 1)) "empty" :else "not-empty"))
+    (assert-equal
+      "not-empty"
+      (cond (empty? (list 1)) "empty" :else "not-empty"))
     (assert-equal "yes" (cond (not false) "yes" :else "no"))
     (assert-equal "no" (cond (not true) "yes" :else "no")))
-
-  (deftest "cond with 2-element predicate and no :else"
-    ;; Same bug, but without :else — this is the worst case because the
-    ;; bootstrapper heuristic also breaks (all clauses are 2-element lists).
-    (assert-equal "found"
-      (cond (nil? nil) "found"
-            (nil? "x") "other"))
-    (assert-equal "b"
-      (cond (nil? "x") "a"
-            (not false) "b")))
-
-  (deftest "and"
+  (deftest
+    "cond with 2-element predicate and no :else"
+    (assert-equal "found" (cond (nil? nil) "found" (nil? "x") "other"))
+    (assert-equal "b" (cond (nil? "x") "a" (not false) "b")))
+  (deftest
+    "and"
     (assert-true (and true true))
     (assert-false (and true false))
     (assert-false (and false true))
     (assert-equal 3 (and 1 2 3)))
-
-  (deftest "or"
+  (deftest
+    "or"
     (assert-equal 1 (or 1 2))
     (assert-equal 2 (or false 2))
     (assert-equal "fallback" (or nil false "fallback"))
     (assert-false (or false false)))
-
-  (deftest "let"
-    (assert-equal 3 (let ((x 1) (y 2)) (+ x y)))
-    (assert-equal "hello world"
+  (deftest
+    "let"
+    (assert-equal
+      3
+      (let ((x 1) (y 2)) (+ x y)))
+    (assert-equal
+      "hello world"
       (let ((a "hello") (b " world")) (str a b))))
-
-  (deftest "let clojure-style"
+  (deftest
+    "let clojure-style"
     (assert-equal 3 (let (x 1 y 2) (+ x y))))
-
-  (deftest "do / begin"
+  (deftest
+    "do / begin"
     (assert-equal 3 (do 1 2 3))
     (assert-equal "last" (begin "first" "middle" "last")))
-
-  (deftest "define"
-    (define x 42)
-    (assert-equal 42 x))
-
-  (deftest "set!"
+  (deftest "define" (define x 42) (assert-equal 42 x))
+  (deftest
+    "set!"
     (define x 1)
     (set! x 2)
     (assert-equal 2 x)))
@@ -338,86 +359,126 @@
 ;; Lambda and closures
 ;; --------------------------------------------------------------------------
 
-(defsuite "lambdas"
-  (deftest "basic lambda"
-    (let ((add (fn (a b) (+ a b))))
+(defsuite
+  "lambdas"
+  (deftest
+    "basic lambda"
+    (let
+      ((add (fn (a b) (+ a b))))
       (assert-equal 3 (add 1 2))))
-
-  (deftest "closure captures env"
-    (let ((x 10))
-      (let ((add-x (fn (y) (+ x y))))
+  (deftest
+    "closure captures env"
+    (let
+      ((x 10))
+      (let
+        ((add-x (fn (y) (+ x y))))
         (assert-equal 15 (add-x 5)))))
-
-  (deftest "lambda as argument"
-    (assert-equal (list 2 4 6)
-      (map (fn (x) (* x 2)) (list 1 2 3))))
-
-  (deftest "recursive lambda via define"
-    (define factorial
-      (fn (n) (if (<= n 1) 1 (* n (factorial (- n 1))))))
+  (deftest
+    "lambda as argument"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (list 1 2 3))))
+  (deftest
+    "recursive lambda via define"
+    (define
+      factorial
+      (fn
+        (n)
+        (if
+          (<= n 1)
+          1
+          (* n (factorial (- n 1))))))
     (assert-equal 120 (factorial 5)))
-
-  (deftest "higher-order returns lambda"
-    (let ((make-adder (fn (n) (fn (x) (+ n x)))))
-      (let ((add5 (make-adder 5)))
+  (deftest
+    "higher-order returns lambda"
+    (let
+      ((make-adder (fn (n) (fn (x) (+ n x)))))
+      (let
+        ((add5 (make-adder 5)))
         (assert-equal 8 (add5 3)))))
-
-  (deftest "multi-body lambda returns last value"
-    ;; All body expressions must execute. Return value is the last.
-    ;; Catches: sf-lambda using nth(args,1) instead of rest(args).
-    (let ((f (fn (x) (+ x 1) (+ x 2) (+ x 3))))
+  (deftest
+    "multi-body lambda returns last value"
+    (let
+      ((f (fn (x) (+ x 1) (+ x 2) (+ x 3))))
       (assert-equal 13 (f 10))))
-
-  (deftest "multi-body lambda side effects via dict mutation"
-    ;; Verify all body expressions run by mutating a shared dict.
-    (let ((state (dict "a" 0 "b" 0)))
-      (let ((f (fn ()
-                 (dict-set! state "a" 1)
-                 (dict-set! state "b" 2)
-                 "done")))
+  (deftest
+    "multi-body lambda side effects via dict mutation"
+    (let
+      ((state (dict "a" 0 "b" 0)))
+      (let
+        ((f (fn () (dict-set! state "a" 1) (dict-set! state "b" 2) "done")))
         (assert-equal "done" (f))
         (assert-equal 1 (get state "a"))
         (assert-equal 2 (get state "b")))))
-
-  (deftest "multi-body lambda two expressions"
-    ;; Simplest case: two body expressions, return value is second.
-    (assert-equal 20
+  (deftest
+    "multi-body lambda two expressions"
+    (assert-equal
+      20
       ((fn (x) (+ x 1) (* x 2)) 10))
-    ;; And with zero-arg lambda
-    (assert-equal 42
-      ((fn () (+ 1 2) 42)))))
+    (assert-equal 42 ((fn () (+ 1 2) 42)))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Higher-order forms
 ;; --------------------------------------------------------------------------
 
-(defsuite "higher-order"
-  (deftest "map"
-    (assert-equal (list 2 4 6)
-      (map (fn (x) (* x 2)) (list 1 2 3)))
+(defsuite
+  "higher-order"
+  (deftest
+    "map"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (list 1 2 3)))
     (assert-equal (list) (map (fn (x) x) (list))))
-
-  (deftest "filter"
-    (assert-equal (list 2 4)
-      (filter (fn (x) (= (mod x 2) 0)) (list 1 2 3 4)))
-    (assert-equal (list)
+  (deftest
+    "filter"
+    (assert-equal
+      (list 2 4)
+      (filter
+        (fn (x) (= (mod x 2) 0))
+        (list 1 2 3 4)))
+    (assert-equal
+      (list)
       (filter (fn (x) false) (list 1 2 3))))
-
-  (deftest "reduce"
-    (assert-equal 10 (reduce (fn (acc x) (+ acc x)) 0 (list 1 2 3 4)))
-    (assert-equal 0 (reduce (fn (acc x) (+ acc x)) 0 (list))))
-
-  (deftest "some"
-    (assert-true (some (fn (x) (> x 3)) (list 1 2 3 4 5)))
-    (assert-false (some (fn (x) (> x 10)) (list 1 2 3))))
-
-  (deftest "every?"
-    (assert-true (every? (fn (x) (> x 0)) (list 1 2 3)))
-    (assert-false (every? (fn (x) (> x 2)) (list 1 2 3))))
-
-  (deftest "map-indexed"
-    (assert-equal (list "0:a" "1:b" "2:c")
+  (deftest
+    "reduce"
+    (assert-equal
+      10
+      (reduce
+        (fn (acc x) (+ acc x))
+        0
+        (list 1 2 3 4)))
+    (assert-equal
+      0
+      (reduce (fn (acc x) (+ acc x)) 0 (list))))
+  (deftest
+    "some"
+    (assert-true
+      (some
+        (fn (x) (> x 3))
+        (list 1 2 3 4 5)))
+    (assert-false
+      (some
+        (fn (x) (> x 10))
+        (list 1 2 3))))
+  (deftest
+    "every?"
+    (assert-true
+      (every?
+        (fn (x) (> x 0))
+        (list 1 2 3)))
+    (assert-false
+      (every?
+        (fn (x) (> x 2))
+        (list 1 2 3))))
+  (deftest
+    "map-indexed"
+    (assert-equal
+      (list "0:a" "1:b" "2:c")
       (map-indexed (fn (i x) (str i ":" x)) (list "a" "b" "c")))))
 
 
@@ -425,49 +486,39 @@
 ;; Components
 ;; --------------------------------------------------------------------------
 
-(defsuite "components"
-  (deftest "defcomp creates component"
-    (defcomp ~test-comp (&key title)
-      (div title))
+(defsuite
+  "components"
+  (deftest
+    "defcomp creates component"
+    (defcomp ~test-comp (&key title) (div title))
     (assert-true (not (nil? ~test-comp))))
-
-  (deftest "component renders with keyword args"
-    (defcomp ~greeting (&key name)
-      (span (str "Hello, " name "!")))
+  (deftest
+    "component renders with keyword args"
+    (defcomp ~greeting (&key name) (span (str "Hello, " name "!")))
     (assert-true (not (nil? ~greeting))))
-
-  (deftest "component with children"
-    (defcomp ~box (&key &rest children)
-      (div :class "box" children))
+  (deftest
+    "component with children"
+    (defcomp ~box (&key &rest children) (div :class "box" children))
     (assert-true (not (nil? ~box))))
-
-  (deftest "component with default via or"
-    (defcomp ~label (&key text)
-      (span (or text "default")))
+  (deftest
+    "component with default via or"
+    (defcomp ~label (&key text) (span (or text "default")))
     (assert-true (not (nil? ~label))))
-
-  (deftest "defcomp default affinity is auto"
-    (defcomp ~aff-default (&key x)
-      (div x))
+  (deftest
+    "defcomp default affinity is auto"
+    (defcomp ~aff-default (&key x) (div x))
     (assert-equal "auto" (component-affinity ~aff-default)))
-
-  (deftest "defcomp affinity client"
-    (defcomp ~aff-client (&key x)
-      :affinity :client
-      (div x))
+  (deftest
+    "defcomp affinity client"
+    (defcomp ~aff-client (&key x) :affinity :client (div x))
     (assert-equal "client" (component-affinity ~aff-client)))
-
-  (deftest "defcomp affinity server"
-    (defcomp ~aff-server (&key x)
-      :affinity :server
-      (div x))
+  (deftest
+    "defcomp affinity server"
+    (defcomp ~aff-server (&key x) :affinity :server (div x))
     (assert-equal "server" (component-affinity ~aff-server)))
-
-  (deftest "defcomp affinity preserves body"
-    (defcomp ~aff-body (&key val)
-      :affinity :client
-      (span val))
-    ;; Component should still render correctly
+  (deftest
+    "defcomp affinity preserves body"
+    (defcomp ~aff-body (&key val) :affinity :client (span val))
     (assert-equal "client" (component-affinity ~aff-body))
     (assert-true (not (nil? ~aff-body)))))
 
@@ -476,93 +527,98 @@
 ;; Macros
 ;; --------------------------------------------------------------------------
 
-(defsuite "macros"
-  (deftest "defmacro creates macro"
-    (defmacro unless (cond &rest body)
-      `(if (not ,cond) (do ,@body)))
+(defsuite
+  "macros"
+  (deftest
+    "defmacro creates macro"
+    (defmacro
+      unless
+      (cond &rest body)
+      (quasiquote (if (not (unquote cond)) (do (splice-unquote body)))))
     (assert-equal "yes" (unless false "yes"))
     (assert-nil (unless true "no")))
-
-  (deftest "quasiquote and unquote"
-    (let ((x 42))
-      (assert-equal (list 1 42 3) `(1 ,x 3))))
-
-  (deftest "splice-unquote"
-    (let ((xs (list 2 3 4)))
-      (assert-equal (list 1 2 3 4 5) `(1 ,@xs 5)))))
+  (deftest
+    "quasiquote and unquote"
+    (let
+      ((x 42))
+      (assert-equal
+        (list 1 42 3)
+        (quasiquote (1 (unquote x) 3)))))
+  (deftest
+    "splice-unquote"
+    (let
+      ((xs (list 2 3 4)))
+      (assert-equal
+        (list 1 2 3 4 5)
+        (quasiquote (1 (splice-unquote xs) 5))))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Threading macro
 ;; --------------------------------------------------------------------------
 
-(defsuite "threading"
-  (deftest "thread-first"
+(defsuite
+  "threading"
+  (deftest
+    "thread-first"
     (assert-equal 8 (-> 5 (+ 1) (+ 2)))
     (assert-equal "HELLO" (-> "hello" upcase))
-    (assert-equal "HELLO WORLD"
-      (-> "hello"
-          (str " world")
-          upcase))))
+    (assert-equal "HELLO WORLD" (-> "hello" (str " world") upcase))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Truthiness
 ;; --------------------------------------------------------------------------
 
-(defsuite "truthiness"
-  (deftest "truthy values"
+(defsuite
+  "truthiness"
+  (deftest
+    "truthy values"
     (assert-true (if 1 true false))
     (assert-true (if "x" true false))
     (assert-true (if (list 1) true false))
     (assert-true (if true true false)))
-
-  (deftest "falsy values"
+  (deftest
+    "falsy values"
     (assert-false (if false true false))
-    (assert-false (if nil true false)))
-
-  ;; NOTE: empty list, zero, and empty string truthiness is
-  ;; platform-dependent. Python treats all three as falsy.
-  ;; JavaScript treats [] as truthy but 0 and "" as falsy.
-  ;; These tests are omitted — each bootstrapper should emit
-  ;; platform-specific truthiness tests instead.
-  )
+    (assert-false (if nil true false))))
 
 
 ;; --------------------------------------------------------------------------
 ;; Edge cases and regression tests
 ;; --------------------------------------------------------------------------
 
-(defsuite "edge-cases"
-  (deftest "nested let scoping"
-    (let ((x 1))
-      (let ((x 2))
-        (assert-equal 2 x))
-      ;; outer x should be unchanged by inner let
-      ;; (this tests that let creates a new scope)
-      ))
-
-  (deftest "recursive map"
-    (assert-equal (list (list 2 4) (list 6 8))
-      (map (fn (sub) (map (fn (x) (* x 2)) sub))
+(defsuite
+  "edge-cases"
+  (deftest
+    "nested let scoping"
+    (let
+      ((x 1))
+      (let ((x 2)) (assert-equal 2 x))))
+  (deftest
+    "recursive map"
+    (assert-equal
+      (list (list 2 4) (list 6 8))
+      (map
+        (fn (sub) (map (fn (x) (* x 2)) sub))
         (list (list 1 2) (list 3 4)))))
-
-  (deftest "keyword as value"
+  (deftest
+    "keyword as value"
     (assert-equal "class" :class)
     (assert-equal "id" :id))
-
-  (deftest "dict with evaluated values"
-    (let ((x 42))
-      (assert-equal 42 (get {:val x} "val"))))
-
-  (deftest "nil propagation"
+  (deftest
+    "dict with evaluated values"
+    (let ((x 42)) (assert-equal 42 (get {:val x} "val"))))
+  (deftest
+    "nil propagation"
     (assert-nil (get {:a 1} "missing"))
     (assert-equal "default" (or (get {:a 1} "missing") "default")))
-
-  (deftest "empty operations"
+  (deftest
+    "empty operations"
     (assert-equal (list) (map (fn (x) x) (list)))
     (assert-equal (list) (filter (fn (x) true) (list)))
-    (assert-equal 0 (reduce (fn (acc x) (+ acc x)) 0 (list)))
+    (assert-equal
+      0
+      (reduce (fn (acc x) (+ acc x)) 0 (list)))
     (assert-equal 0 (len (list)))
     (assert-equal "" (str))))
-

spec/tests/test-gensym.sx

@@ -0,0 +1,78 @@
+(defsuite
+  "gensym"
+  (deftest "gensym returns a symbol" (assert= true (symbol? (gensym))))
+  (deftest
+    "gensym default prefix is g"
+    (let
+      ((s (symbol-name (gensym))))
+      (assert= true (string-contains? s "g"))))
+  (deftest
+    "gensym with prefix uses that prefix"
+    (let
+      ((s (symbol-name (gensym "var"))))
+      (assert= "var" (substring s 0 3))))
+  (deftest
+    "gensym produces unique symbols"
+    (let
+      ((a (gensym)) (b (gensym)))
+      (assert= false (= (symbol-name a) (symbol-name b)))))
+  (deftest
+    "gensym same prefix produces unique symbols"
+    (let
+      ((a (gensym "x")) (b (gensym "x")) (c (gensym "x")))
+      (assert= false (= (symbol-name a) (symbol-name b)))
+      (assert= false (= (symbol-name b) (symbol-name c)))))
+  (deftest
+    "gensym counter increases: names differ"
+    (let
+      ((a (gensym "k")) (b (gensym "k")))
+      (assert= false (= (symbol-name a) (symbol-name b)))))
+  (deftest
+    "gensym no-arg and prefix-arg both unique"
+    (let
+      ((a (gensym)) (b (gensym "g")))
+      (assert= false (= (symbol-name a) (symbol-name b)))))
+  (deftest
+    "string->symbol returns a symbol"
+    (assert= true (symbol? (string->symbol "hello"))))
+  (deftest
+    "string->symbol symbol has correct name"
+    (assert= "hello" (symbol-name (string->symbol "hello"))))
+  (deftest
+    "string->symbol empty string"
+    (assert= true (symbol? (string->symbol ""))))
+  (deftest
+    "symbol->string returns a string"
+    (assert= true (string? (symbol->string (quote foo)))))
+  (deftest
+    "symbol->string round-trips with string->symbol"
+    (assert= "hello" (symbol->string (string->symbol "hello"))))
+  (deftest
+    "string->symbol/symbol->string round-trip"
+    (let
+      ((sym (string->symbol "my-var")))
+      (assert= "my-var" (symbol->string sym))))
+  (deftest
+    "intern returns a symbol"
+    (assert= true (symbol? (intern "foo"))))
+  (deftest
+    "intern same as string->symbol"
+    (assert= "bar" (symbol-name (intern "bar"))))
+  (deftest
+    "symbol-interned? true for literal symbols"
+    (assert= true (symbol-interned? (quote hello))))
+  (deftest
+    "symbol-interned? true for gensym'd symbol"
+    (assert= true (symbol-interned? (gensym "g"))))
+  (deftest
+    "symbol-interned? true for string->symbol"
+    (assert= true (symbol-interned? (string->symbol "test"))))
+  (deftest
+    "multiple gensym calls all unique"
+    (let
+      ((syms (map (fn (i) (gensym "t")) (in-range 5))))
+      (let
+        ((names (map symbol-name syms)))
+        (let
+          ((unique-names (reduce (fn (acc n) (if (some (fn (x) (= x n)) acc) acc (cons n acc))) (list) names)))
+          (assert-equal 5 (len unique-names)))))))

spec/tests/test-hash-table.sx

@@ -0,0 +1,166 @@
+;; Tests for mutable hash tables (Phase 10)
+
+(defsuite
+  "hash-table"
+  (deftest
+    "make-hash-table returns a hash table"
+    (assert (hash-table? (make-hash-table))))
+  (deftest
+    "hash-table? false for dict"
+    (assert= false (hash-table? {:a 1})))
+  (deftest "hash-table? false for nil" (assert= false (hash-table? nil)))
+  (deftest
+    "hash-table? false for list"
+    (assert= false (hash-table? (list 1 2))))
+  (deftest
+    "empty table has size 0"
+    (assert= 0 (hash-table-size (make-hash-table))))
+  (deftest
+    "size after one set"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 1)
+      (assert= 1 (hash-table-size ht))))
+  (deftest
+    "size after multiple sets"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 1)
+      (hash-table-set! ht "b" 2)
+      (hash-table-set! ht "c" 3)
+      (assert= 3 (hash-table-size ht))))
+  (deftest
+    "set same key does not grow size"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 1)
+      (hash-table-set! ht "a" 2)
+      (assert= 1 (hash-table-size ht))))
+  (deftest
+    "ref returns set value"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "k" 42)
+      (assert= 42 (hash-table-ref ht "k"))))
+  (deftest
+    "ref returns updated value after overwrite"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "k" 1)
+      (hash-table-set! ht "k" 99)
+      (assert= 99 (hash-table-ref ht "k"))))
+  (deftest
+    "ref with default returns default for missing key"
+    (assert=
+      "fallback"
+      (hash-table-ref (make-hash-table) "missing" "fallback")))
+  (deftest
+    "ref with default returns value when key exists"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "x" 7)
+      (assert= 7 (hash-table-ref ht "x" 0))))
+  (deftest
+    "keyword keys work"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht :foo "bar")
+      (assert= "bar" (hash-table-ref ht :foo))))
+  (deftest
+    "number keys work"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht 0 "zero")
+      (assert= "zero" (hash-table-ref ht 0))))
+  (deftest
+    "delete removes key"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "x" 1)
+      (hash-table-delete! ht "x")
+      (assert= "gone" (hash-table-ref ht "x" "gone"))))
+  (deftest
+    "delete reduces size"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 1)
+      (hash-table-set! ht "b" 2)
+      (hash-table-delete! ht "a")
+      (assert= 1 (hash-table-size ht))))
+  (deftest
+    "delete missing key is no-op"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-delete! ht "absent")
+      (assert= 0 (hash-table-size ht))))
+  (deftest
+    "keys of empty table is empty"
+    (assert (empty? (hash-table-keys (make-hash-table)))))
+  (deftest
+    "keys has correct count"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 1)
+      (hash-table-set! ht "b" 2)
+      (assert= 2 (len (hash-table-keys ht)))))
+  (deftest
+    "values has correct count"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "a" 10)
+      (hash-table-set! ht "b" 20)
+      (assert= 2 (len (hash-table-values ht)))))
+  (deftest
+    "alist of empty table is empty"
+    (assert (empty? (hash-table->alist (make-hash-table)))))
+  (deftest
+    "alist has correct length"
+    (let
+      ((ht (make-hash-table)))
+      (hash-table-set! ht "x" 1)
+      (hash-table-set! ht "y" 2)
+      (assert= 2 (len (hash-table->alist ht)))))
+  (deftest
+    "for-each visits all entries"
+    (let
+      ((ht (make-hash-table)) (count 0))
+      (hash-table-set! ht "a" 1)
+      (hash-table-set! ht "b" 2)
+      (hash-table-set! ht "c" 3)
+      (hash-table-for-each ht (fn (k v) (set! count (+ count 1))))
+      (assert= 3 count)))
+  (deftest
+    "for-each sums values"
+    (let
+      ((ht (make-hash-table)) (total 0))
+      (hash-table-set! ht "a" 10)
+      (hash-table-set! ht "b" 20)
+      (hash-table-set! ht "c" 30)
+      (hash-table-for-each ht (fn (k v) (set! total (+ total v))))
+      (assert= 60 total)))
+  (deftest
+    "merge copies entries from src to dst"
+    (let
+      ((dst (make-hash-table)) (src (make-hash-table)))
+      (hash-table-set! src "x" 1)
+      (hash-table-set! src "y" 2)
+      (hash-table-merge! dst src)
+      (assert= 2 (hash-table-size dst))))
+  (deftest
+    "merge overwrites existing keys in dst"
+    (let
+      ((dst (make-hash-table)) (src (make-hash-table)))
+      (hash-table-set! dst "k" "old")
+      (hash-table-set! src "k" "new")
+      (hash-table-merge! dst src)
+      (assert= "new" (hash-table-ref dst "k"))))
+  (deftest
+    "merge does not modify src"
+    (let
+      ((dst (make-hash-table)) (src (make-hash-table)))
+      (hash-table-set! src "a" 1)
+      (hash-table-merge! dst src)
+      (assert= 1 (hash-table-size src))))
+  (deftest
+    "type-of returns hash-table"
+    (assert= "hash-table" (type-of (make-hash-table)))))

spec/tests/test-hyperscript-behavioral.sx

@@ -88,6 +88,27 @@
                 (raise _e))))
           (handler me-val))))))
 
+;; Evaluate a hyperscript expression, catch the first error raised, and
+;; return its message string. Used by runtimeErrors tests.
+;; Returns nil if no error is raised (test would then fail equality).
+(define eval-hs-error
+  (fn (src)
+    (let ((sx (hs-to-sx (hs-compile src))))
+      (let ((handler (eval-expr-cek
+              (list (quote fn) (list (quote me))
+                (list (quote let) (list (list (quote it) nil) (list (quote event) nil)) sx)))))
+        (guard
+          (_e
+            (true
+              (if
+                (string? _e)
+                _e
+                (if
+                  (and (list? _e) (= (first _e) "hs-return"))
+                  nil
+                  (str _e)))))
+          (begin (handler nil) nil))))))
+
 ;; ── add (19 tests) ──
 (defsuite "hs-upstream-add"
   (deftest "can add a value to a set"
@@ -2153,41 +2174,75 @@
 ;; ── core/runtimeErrors (18 tests) ──
 (defsuite "hs-upstream-core/runtimeErrors"
   (deftest "reports basic function invocation null errors properly"
-    (error "SKIP (untranslated): reports basic function invocation null errors properly"))
+    (assert= (eval-hs-error "x()") "'x' is null")
+    (assert= (eval-hs-error "x.y()") "'x' is null")
+    (assert= (eval-hs-error "x.y.z()") "'x.y' is null")
+  )
   (deftest "reports basic function invocation null errors properly w/ of"
-    (error "SKIP (untranslated): reports basic function invocation null errors properly w/ of"))
+    (assert= (eval-hs-error "z() of y of x") "'z' is null")
+  )
   (deftest "reports basic function invocation null errors properly w/ possessives"
-    (error "SKIP (untranslated): reports basic function invocation null errors properly w/ possessives"))
+    (assert= (eval-hs-error "x's y()") "'x' is null")
+    (assert= (eval-hs-error "x's y's z()") "'x's y' is null")
+  )
   (deftest "reports null errors on add command properly"
-    (error "SKIP (untranslated): reports null errors on add command properly"))
+    (assert= (eval-hs-error "add .foo to #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "add @foo to #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "add {display:none} to #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on decrement command properly"
-    (error "SKIP (untranslated): reports null errors on decrement command properly"))
+    (assert= (eval-hs-error "decrement #doesntExist's innerHTML") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on default command properly"
-    (error "SKIP (untranslated): reports null errors on default command properly"))
+    (assert= (eval-hs-error "default #doesntExist's innerHTML to 'foo'") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on hide command properly"
-    (error "SKIP (untranslated): reports null errors on hide command properly"))
+    (assert= (eval-hs-error "hide #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on increment command properly"
-    (error "SKIP (untranslated): reports null errors on increment command properly"))
+    (assert= (eval-hs-error "increment #doesntExist's innerHTML") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on measure command properly"
-    (error "SKIP (untranslated): reports null errors on measure command properly"))
+    (assert= (eval-hs-error "measure #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on put command properly"
-    (error "SKIP (untranslated): reports null errors on put command properly"))
+    (assert= (eval-hs-error "put 'foo' into #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' into #doesntExist's innerHTML") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' into #doesntExist.innerHTML") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' before #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' after #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' at the start of #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "put 'foo' at the end of #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on remove command properly"
-    (error "SKIP (untranslated): reports null errors on remove command properly"))
+    (assert= (eval-hs-error "remove .foo from #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "remove @foo from #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "remove #doesntExist from #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on send command properly"
-    (error "SKIP (untranslated): reports null errors on send command properly"))
+    (assert= (eval-hs-error "send 'foo' to #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on sets properly"
-    (error "SKIP (untranslated): reports null errors on sets properly"))
+    (assert= (eval-hs-error "set x's y to true") "'x' is null")
+    (assert= (eval-hs-error "set x's @y to true") "'x' is null")
+  )
   (deftest "reports null errors on settle command properly"
-    (error "SKIP (untranslated): reports null errors on settle command properly"))
+    (assert= (eval-hs-error "settle #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on show command properly"
-    (error "SKIP (untranslated): reports null errors on show command properly"))
+    (assert= (eval-hs-error "show #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on toggle command properly"
-    (error "SKIP (untranslated): reports null errors on toggle command properly"))
+    (assert= (eval-hs-error "toggle .foo on #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "toggle between .foo and .bar on #doesntExist") "'#doesntExist' is null")
+    (assert= (eval-hs-error "toggle @foo on #doesntExist") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on transition command properly"
-    (error "SKIP (untranslated): reports null errors on transition command properly"))
+    (assert= (eval-hs-error "transition #doesntExist's *visibility to 0") "'#doesntExist' is null")
+  )
   (deftest "reports null errors on trigger command properly"
-    (error "SKIP (untranslated): reports null errors on trigger command properly"))
+    (assert= (eval-hs-error "trigger 'foo' on #doesntExist") "'#doesntExist' is null")
+  )
 )
 
 ;; ── core/scoping (20 tests) ──

spec/tests/test-math.sx

@@ -0,0 +1,131 @@
+
+(deftest
+  "math completeness"
+  (deftest
+    "trigonometry"
+    (deftest
+      "sin"
+      (assert= 0 (round (sin 0)) "sin 0 = 0")
+      (assert=
+        1
+        (round (sin (/ 3.14159 2)))
+        "sin pi/2 = 1")
+      (assert= 0 (round (sin 3.14159)) "sin pi = 0"))
+    (deftest
+      "cos"
+      (assert= 1 (round (cos 0)) "cos 0 = 1")
+      (assert=
+        0
+        (round (cos (/ 3.14159 2)))
+        "cos pi/2 = 0")
+      (assert= -1 (round (cos 3.14159)) "cos pi = -1"))
+    (deftest
+      "tan"
+      (assert= 0 (round (tan 0)) "tan 0 = 0")
+      (assert= 1 (round (tan 0.785398)) "tan pi/4 = 1"))
+    (deftest
+      "asin"
+      (assert= 0 (round (asin 0)) "asin 0 = 0")
+      (let
+        (r (asin 1))
+        (assert= true (and (> r 1.5) (< r 1.6)) "asin 1 ≈ pi/2")))
+    (deftest
+      "acos"
+      (assert= 0 (round (acos 1)) "acos 1 = 0")
+      (let
+        (r (acos 0))
+        (assert= true (and (> r 1.5) (< r 1.6)) "acos 0 ≈ pi/2")))
+    (deftest
+      "atan"
+      (assert= 0 (round (atan 0)) "atan 0 = 0")
+      (let
+        (r (atan 1))
+        (assert= true (and (> r 0.78) (< r 0.8)) "atan 1 ≈ pi/4"))
+      (let
+        (r (atan 1 1))
+        (assert=
+          true
+          (and (> r 0.78) (< r 0.8))
+          "atan 1 1 = atan2(1,1) ≈ pi/4"))
+      (let
+        (r (atan 1 0))
+        (assert= true (and (> r 1.5) (< r 1.6)) "atan 1 0 ≈ pi/2")))
+    (deftest
+      "exp"
+      (assert= 1 (round (exp 0)) "exp 0 = 1")
+      (let
+        (r (exp 1))
+        (assert= true (and (> r 2.71) (< r 2.72)) "exp 1 ≈ e")))
+    (deftest
+      "log"
+      (assert= 0 (round (log 1)) "log 1 = 0")
+      (let
+        (r (log 2.71828))
+        (assert= true (and (> r 0.99) (< r 1.01)) "log e ≈ 1"))))
+  (deftest
+    "expt"
+    (assert= 8 (expt 2 3) "2^3 = 8")
+    (assert= 1 (expt 5 0) "5^0 = 1")
+    (assert= 1000 (expt 10 3) "10^3 = 1000")
+    (let
+      (r (expt 2 0.5))
+      (assert= true (and (> r 1.41) (< r 1.43)) "2^0.5 ≈ sqrt(2)")))
+  (deftest
+    "quotient"
+    (assert= 3 (quotient 13 4) "13/4 = 3")
+    (assert=
+      -3
+      (quotient -13 4)
+      "-13/4 = -3 (truncate toward zero)")
+    (assert=
+      -3
+      (quotient 13 -4)
+      "13/-4 = -3 (truncate toward zero)")
+    (assert= 3 (quotient -13 -4) "-13/-4 = 3")
+    (assert= 0 (quotient 0 5) "0/5 = 0"))
+  (deftest
+    "gcd"
+    (assert= 6 (gcd 12 18) "gcd 12 18 = 6")
+    (assert= 1 (gcd 7 13) "gcd 7 13 = 1 (coprime)")
+    (assert= 4 (gcd 8 12) "gcd 8 12 = 4")
+    (assert= 5 (gcd 0 5) "gcd 0 5 = 5")
+    (assert= 6 (gcd -12 18) "gcd handles negatives"))
+  (deftest
+    "lcm"
+    (assert= 12 (lcm 4 6) "lcm 4 6 = 12")
+    (assert= 36 (lcm 12 18) "lcm 12 18 = 36")
+    (assert= 0 (lcm 0 5) "lcm 0 5 = 0")
+    (assert= 15 (lcm 3 5) "lcm 3 5 = 15"))
+  (deftest
+    "number->string"
+    (assert= "42" (number->string 42) "integer to string")
+    (assert= "0" (number->string 0) "zero to string")
+    (assert= "-7" (number->string -7) "negative to string")
+    (assert= "ff" (number->string 255 16) "255 in hex")
+    (assert= "1111" (number->string 15 2) "15 in binary")
+    (assert= "377" (number->string 255 8) "255 in octal")
+    (assert= "z" (number->string 35 36) "35 in base 36"))
+  (deftest
+    "string->number"
+    (assert= 42 (string->number "42") "string to integer")
+    (assert= -7 (string->number "-7") "negative string to integer")
+    (assert= 255 (string->number "ff" 16) "hex string")
+    (assert= 15 (string->number "1111" 2) "binary string")
+    (assert= 255 (string->number "377" 8) "octal string")
+    (assert= nil (string->number "not-a-number") "invalid returns nil")
+    (assert= nil (string->number "fg" 16) "invalid hex returns nil"))
+  (deftest
+    "numeric tower integration"
+    (assert=
+      true
+      (< (abs (- (sin (asin 0.5)) 0.5)) 0.0001)
+      "sin(asin(x)) = x")
+    (assert=
+      true
+      (< (abs (- (cos (acos 0.5)) 0.5)) 0.0001)
+      "cos(acos(x)) = x")
+    (assert= true (< (abs (- (exp (log 2)) 2)) 0.0001) "exp(log(x)) = x")
+    (assert=
+      (* 12 18)
+      (* (gcd 12 18) (lcm 12 18))
+      "gcd * lcm = a * b")))

spec/tests/test-numeric-tower.sx

@@ -0,0 +1,230 @@
+;; ==========================================================================
+;; test-numeric-tower.sx — Numeric tower: Integer vs Float distinction
+;;
+;; Tests for float contagion, integer arithmetic, predicates,
+;; coercions, parsing, and rendering.
+;;
+;; Note: Use fractional floats (1.5, 3.14) or exact->inexact for round floats,
+;; since the SX serializer renders Number 1.0 as "1" (int form).
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; Integer arithmetic — result stays Integer when all args are Integer
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:int-arithmetic"
+  (deftest "int + int = int" (assert (integer? (+ 1 2))))
+  (deftest "int + int value" (assert= (+ 1 2) 3))
+  (deftest "int - int = int" (assert (integer? (- 10 3))))
+  (deftest "int - int value" (assert= (- 10 3) 7))
+  (deftest "int * int = int" (assert (integer? (* 4 5))))
+  (deftest "int * int value" (assert= (* 4 5) 20))
+  (deftest "zero identity" (assert= (+ 0 0) 0))
+  (deftest "negative int" (assert= (- 0 5) -5))
+  (deftest
+    "int negation is int"
+    (assert (integer? (- 0 7))))
+  (deftest
+    "large int product"
+    (assert= (* 100 100) 10000)))
+
+;; --------------------------------------------------------------------------
+;; Float contagion — any float arg promotes result to float
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:float-contagion"
+  (deftest "int + float = float" (assert (float? (+ 1 1.5))))
+  (deftest "int + float value" (assert= (+ 1 1.5) 2.5))
+  (deftest "float + int = float" (assert (float? (+ 1.5 2))))
+  (deftest "float + float = float" (assert (float? (+ 1.5 2.5))))
+  (deftest "int * float = float" (assert (float? (* 2 1.5))))
+  (deftest "int * float value" (assert= (* 2 1.5) 3))
+  (deftest "int - float = float" (assert (float? (- 5 2.5))))
+  (deftest "float - int = float" (assert (float? (- 5.5 2))))
+  (deftest
+    "three args with float"
+    (assert (float? (+ 1 2 3.5))))
+  (deftest
+    "exact->inexact promotes to float"
+    (assert (float? (exact->inexact 5)))))
+
+;; --------------------------------------------------------------------------
+;; Division
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:division"
+  (deftest
+    "exact division value"
+    (assert= (/ 6 2) 3))
+  (deftest "inexact division value" (assert= (/ 1 4) 0.25))
+  (deftest "float / float = float" (assert (float? (/ 3.5 2.5))))
+  (deftest
+    "rational / int = rational"
+    (assert (rational? (/ 1/2 2))))
+  (deftest "rational division value" (assert= (/ 1/2 2) 1/4)))
+
+;; --------------------------------------------------------------------------
+;; Type predicates
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:predicates"
+  (deftest "integer? on int" (assert (integer? 42)))
+  (deftest "integer? on negative" (assert (integer? -7)))
+  (deftest "integer? on zero" (assert (integer? 0)))
+  (deftest
+    "integer? on float-int"
+    (assert (integer? (exact->inexact 2))))
+  (deftest "integer? on fractional float" (assert (not (integer? 1.5))))
+  (deftest "float? on 1.5" (assert (float? 1.5)))
+  (deftest
+    "float? on exact->inexact"
+    (assert (float? (exact->inexact 2))))
+  (deftest "float? on int" (assert (not (float? 42))))
+  (deftest "number? on int" (assert (number? 42)))
+  (deftest "number? on float" (assert (number? 3.14)))
+  (deftest "number? on rational" (assert (number? 1/3)))
+  (deftest "number? on string" (assert (not (number? "42"))))
+  (deftest "exact? on int" (assert (exact? 1)))
+  (deftest "exact? on rational" (assert (exact? 1/3)))
+  (deftest
+    "exact? on exact->inexact"
+    (assert (not (exact? (exact->inexact 1)))))
+  (deftest "inexact? on 1.5" (assert (inexact? 1.5)))
+  (deftest "inexact? on int" (assert (not (inexact? 3)))))
+
+;; --------------------------------------------------------------------------
+;; Coercions
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:coercions"
+  (deftest
+    "exact->inexact int"
+    (assert= (exact->inexact 3) 3))
+  (deftest
+    "exact->inexact produces float"
+    (assert (float? (exact->inexact 5))))
+  (deftest
+    "exact->inexact float passthrough"
+    (assert= (exact->inexact 1.5) 1.5))
+  (deftest "exact->inexact rational" (assert= (exact->inexact 1/4) 0.25))
+  (deftest "inexact->exact 1.5" (assert= (inexact->exact 1.5) 2))
+  (deftest
+    "inexact->exact produces int"
+    (assert (integer? (inexact->exact (exact->inexact 4)))))
+  (deftest "inexact->exact 2.7" (assert= (inexact->exact 2.7) 3))
+  (deftest
+    "inexact->exact int passthrough"
+    (assert= (inexact->exact 5) 5)))
+
+;; --------------------------------------------------------------------------
+;; floor / ceiling / truncate / round — return Integer for floats
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:rounding"
+  (deftest "floor 3.7" (assert= (floor 3.7) 3))
+  (deftest "floor produces int" (assert (integer? (floor 3.7))))
+  (deftest "floor negative" (assert= (floor -2.3) -3))
+  (deftest "truncate 3.9" (assert= (truncate 3.9) 3))
+  (deftest "truncate negative" (assert= (truncate -3.9) -3))
+  (deftest "truncate produces int" (assert (integer? (truncate 3.9))))
+  (deftest "round 2.3 down" (assert= (round 2.3) 2))
+  (deftest "round produces int" (assert (integer? (round 2.3))))
+  (deftest
+    "floor of int passthrough"
+    (assert= (floor 5) 5))
+  (deftest "floor of int stays int" (assert (integer? (floor 5)))))
+
+;; --------------------------------------------------------------------------
+;; parse-number distinguishes int vs float strings
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:parse-number"
+  (deftest
+    "parse-number int string"
+    (assert= (parse-number "42") 42))
+  (deftest
+    "parse-number int is integer?"
+    (assert (integer? (parse-number "42"))))
+  (deftest "parse-number 3.14" (assert= (parse-number "3.14") 3.14))
+  (deftest
+    "parse-number float is float?"
+    (assert (float? (parse-number "3.14"))))
+  (deftest
+    "parse-number 1.5 is float?"
+    (assert (float? (parse-number "1.5"))))
+  (deftest
+    "parse-number negative int"
+    (assert= (parse-number "-5") -5))
+  (deftest
+    "parse-number negative int is integer?"
+    (assert (integer? (parse-number "-5"))))
+  (deftest "parse-int returns integer" (assert (integer? (parse-int "7"))))
+  (deftest "parse-int value" (assert= (parse-int "7") 7)))
+
+;; --------------------------------------------------------------------------
+;; Equality across numeric types
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:equality"
+  (deftest "int = same int" (assert= 5 5))
+  (deftest
+    "int = float eq"
+    (assert (= 1 (exact->inexact 1))))
+  (deftest
+    "float = int eq"
+    (assert (= (exact->inexact 1) 1)))
+  (deftest "int != different int" (assert (!= 1 2)))
+  (deftest "int < float" (assert (< 1 1.5)))
+  (deftest "float > int" (assert (> 2.5 2)))
+  (deftest "int <= float" (assert (<= 2 2.5)))
+  (deftest "int >= int" (assert (>= 3 3))))
+
+;; --------------------------------------------------------------------------
+;; mod / remainder / modulo with integers
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:modulo"
+  (deftest
+    "mod int int = int"
+    (assert (integer? (mod 10 3))))
+  (deftest "mod value" (assert= (mod 10 3) 1))
+  (deftest
+    "remainder int int = int"
+    (assert (integer? (remainder 10 3))))
+  (deftest
+    "remainder value"
+    (assert= (remainder 10 3) 1)))
+
+;; --------------------------------------------------------------------------
+;; min / max with mixed types
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:min-max"
+  (deftest "min two ints" (assert= (min 3 7) 3))
+  (deftest
+    "min int result type"
+    (assert (integer? (min 3 7))))
+  (deftest "max two ints" (assert= (max 3 7) 7))
+  (deftest "min with float" (assert= (min 3 2.5) 2.5))
+  (deftest "max with float" (assert= (max 3 3.5) 3.5)))
+
+;; --------------------------------------------------------------------------
+;; str rendering of int vs float
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "numeric-tower:stringify"
+  (deftest "str of int" (assert= (str 42) "42"))
+  (deftest "str of negative int" (assert= (str -5) "-5"))
+  (deftest "str of 3.14" (assert= (str 3.14) "3.14"))
+  (deftest "str of 1.5" (assert= (str 1.5) "1.5")))

spec/tests/test-ports.sx

@@ -0,0 +1,232 @@
+;; Phase 14 — String ports + eof-object
+
+(deftest
+  "eof-object"
+  (deftest
+    "eof-object is eof"
+    (assert=
+      true
+      (eof-object? (eof-object))
+      "eof-object? returns true for eof-object"))
+  (deftest
+    "non-eof values are not eof"
+    (assert= false (eof-object? nil) "nil is not eof")
+    (assert= false (eof-object? "") "string is not eof")
+    (assert= false (eof-object? 0) "zero is not eof")
+    (assert= false (eof-object? false) "false is not eof"))
+  (deftest
+    "type-of eof-object"
+    (assert=
+      "eof-object"
+      (type-of (eof-object))
+      "type-of eof-object is eof-object")))
+
+(deftest
+  "open-input-string"
+  (deftest
+    "creates input port"
+    (let
+      (p (open-input-string "hello"))
+      (assert= true (port? p) "is a port")
+      (assert= true (input-port? p) "is an input port")
+      (assert= false (output-port? p) "is not an output port")))
+  (deftest
+    "type-of input port"
+    (let
+      (p (open-input-string "x"))
+      (assert= "input-port" (type-of p) "type-of is input-port"))))
+
+(deftest
+  "open-output-string"
+  (deftest
+    "creates output port"
+    (let
+      (p (open-output-string))
+      (assert= true (port? p) "is a port")
+      (assert= true (output-port? p) "is an output port")
+      (assert= false (input-port? p) "is not an input port")))
+  (deftest
+    "type-of output port"
+    (let
+      (p (open-output-string))
+      (assert= "output-port" (type-of p) "type-of is output-port"))))
+
+(deftest
+  "read-char"
+  (deftest
+    "reads chars sequentially"
+    (let
+      (p (open-input-string "ab"))
+      (let
+        (c1 (read-char p))
+        (assert= true (char? c1) "first result is char")
+        (assert= 97 (char->integer c1) "first char is a"))))
+  (deftest
+    "reads second char"
+    (let
+      (p (open-input-string "ab"))
+      (read-char p)
+      (let
+        (c2 (read-char p))
+        (assert= true (char? c2) "second result is char")
+        (assert= 98 (char->integer c2) "second char is b"))))
+  (deftest
+    "returns eof at end"
+    (let
+      (p (open-input-string "x"))
+      (read-char p)
+      (assert= true (eof-object? (read-char p)) "eof after last char")))
+  (deftest
+    "empty string yields eof immediately"
+    (let
+      (p (open-input-string ""))
+      (assert= true (eof-object? (read-char p)) "eof from empty string"))))
+
+(deftest
+  "peek-char"
+  (deftest
+    "peeks without consuming"
+    (let
+      (p (open-input-string "x"))
+      (let
+        (c1 (peek-char p))
+        (let
+          (c2 (peek-char p))
+          (assert=
+            (char->integer c1)
+            (char->integer c2)
+            "peek twice gives same char")))))
+  (deftest
+    "peek then read"
+    (let
+      (p (open-input-string "z"))
+      (let
+        (peeked (peek-char p))
+        (let
+          (read (read-char p))
+          (assert=
+            (char->integer peeked)
+            (char->integer read)
+            "peek and read agree")))))
+  (deftest
+    "peek at end returns eof"
+    (let
+      (p (open-input-string ""))
+      (assert= true (eof-object? (peek-char p)) "eof on empty peek"))))
+
+(deftest
+  "read-line"
+  (deftest
+    "reads a single line"
+    (let
+      (p (open-input-string "hello"))
+      (assert= "hello" (read-line p) "reads whole string as line")))
+  (deftest
+    "reads line up to newline"
+    (let
+      (p (open-input-string "foo\nbar"))
+      (assert= "foo" (read-line p) "first line is foo")))
+  (deftest
+    "reads second line"
+    (let
+      (p (open-input-string "foo\nbar"))
+      (read-line p)
+      (assert= "bar" (read-line p) "second line is bar")))
+  (deftest
+    "returns eof on empty port"
+    (let
+      (p (open-input-string ""))
+      (assert= true (eof-object? (read-line p)) "eof on empty")))
+  (deftest
+    "returns eof after last line"
+    (let
+      (p (open-input-string "hi"))
+      (read-line p)
+      (assert= true (eof-object? (read-line p)) "eof after reading"))))
+
+(deftest
+  "write-char and get-output-string"
+  (deftest
+    "write single char"
+    (let
+      (p (open-output-string))
+      (write-char (make-char 65) p)
+      (assert= "A" (get-output-string p) "write char A")))
+  (deftest
+    "write multiple chars"
+    (let
+      (p (open-output-string))
+      (write-char (make-char 72) p)
+      (write-char (make-char 105) p)
+      (assert= "Hi" (get-output-string p) "write Hi"))))
+
+(deftest
+  "write-string"
+  (deftest
+    "write a string to port"
+    (let
+      (p (open-output-string))
+      (write-string "hello" p)
+      (assert= "hello" (get-output-string p) "write-string result")))
+  (deftest
+    "multiple writes concatenate"
+    (let
+      (p (open-output-string))
+      (write-string "foo" p)
+      (write-string "bar" p)
+      (assert= "foobar" (get-output-string p) "concatenated writes"))))
+
+(deftest
+  "get-output-string idempotent"
+  (let
+    (p (open-output-string))
+    (write-string "test" p)
+    (assert= "test" (get-output-string p) "first call")
+    (assert= "test" (get-output-string p) "second call same result")))
+
+(deftest
+  "char-ready?"
+  (deftest
+    "ready when chars available"
+    (let
+      (p (open-input-string "x"))
+      (assert= true (char-ready? p) "ready with content")))
+  (deftest
+    "not ready when empty"
+    (let
+      (p (open-input-string ""))
+      (assert= false (char-ready? p) "not ready when empty"))))
+
+(deftest
+  "close-port"
+  (deftest
+    "close input port"
+    (let
+      (p (open-input-string "hello"))
+      (close-port p)
+      (assert= true (eof-object? (read-char p)) "read after close gives eof")))
+  (deftest
+    "close output port"
+    (let
+      (p (open-output-string))
+      (write-string "ok" p)
+      (close-port p)
+      (assert= "ok" (get-output-string p) "output preserved after close"))))
+
+(deftest
+  "roundtrip string via ports"
+  (let
+    (in (open-input-string "abc"))
+    (let
+      (out (open-output-string))
+      (do
+        (let
+          (c1 (read-char in))
+          (when (not (eof-object? c1)) (write-char c1 out)))
+        (let
+          (c2 (read-char in))
+          (when (not (eof-object? c2)) (write-char c2 out)))
+        (let
+          (c3 (read-char in))
+          (when (not (eof-object? c3)) (write-char c3 out)))
+        (assert= "abc" (get-output-string out) "roundtrip via ports")))))

spec/tests/test-primitives.sx

@@ -6,20 +6,36 @@
 ;; Arithmetic
 ;; --------------------------------------------------------------------------
 
-(defsuite "arithmetic"
+(defsuite
+  "arithmetic"
   (deftest "add" (assert-equal 3 (+ 1 2)))
-  (deftest "add multiple" (assert-equal 10 (+ 1 2 3 4)))
+  (deftest
+    "add multiple"
+    (assert-equal 10 (+ 1 2 3 4)))
   (deftest "add zero" (assert-equal 5 (+ 5 0)))
-  (deftest "add negative" (assert-equal -1 (+ 1 -2)))
+  (deftest
+    "add negative"
+    (assert-equal -1 (+ 1 -2)))
   (deftest "subtract" (assert-equal 3 (- 5 2)))
-  (deftest "subtract negative" (assert-equal 7 (- 5 -2)))
+  (deftest
+    "subtract negative"
+    (assert-equal 7 (- 5 -2)))
   (deftest "multiply" (assert-equal 12 (* 3 4)))
-  (deftest "multiply zero" (assert-equal 0 (* 5 0)))
-  (deftest "multiply negative" (assert-equal -6 (* 2 -3)))
+  (deftest
+    "multiply zero"
+    (assert-equal 0 (* 5 0)))
+  (deftest
+    "multiply negative"
+    (assert-equal -6 (* 2 -3)))
   (deftest "divide" (assert-equal 3 (/ 9 3)))
   (deftest "divide float" (assert-equal 2.5 (/ 5 2)))
   (deftest "mod" (assert-equal 1 (mod 7 3)))
-  (deftest "mod negative" (assert-true (or (= (mod -1 3) 2) (= (mod -1 3) -1))))
+  (deftest
+    "mod negative"
+    (assert-true
+      (or
+        (= (mod -1 3) 2)
+        (= (mod -1 3) -1))))
   (deftest "inc" (assert-equal 6 (inc 5)))
   (deftest "dec" (assert-equal 4 (dec 5)))
   (deftest "abs positive" (assert-equal 5 (abs 5)))
@@ -32,7 +48,8 @@
 ;; Comparison
 ;; --------------------------------------------------------------------------
 
-(defsuite "comparison"
+(defsuite
+  "comparison"
   (deftest "equal numbers" (assert-true (= 1 1)))
   (deftest "not equal numbers" (assert-false (= 1 2)))
   (deftest "equal strings" (assert-true (= "a" "a")))
@@ -52,7 +69,8 @@
 ;; Predicates
 ;; --------------------------------------------------------------------------
 
-(defsuite "predicates"
+(defsuite
+  "predicates"
   (deftest "nil? nil" (assert-true (nil? nil)))
   (deftest "nil? number" (assert-false (nil? 0)))
   (deftest "nil? string" (assert-false (nil? "")))
@@ -76,15 +94,22 @@
 ;; String operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "strings"
-  (deftest "str concat" (assert-equal "hello world" (str "hello" " " "world")))
+(defsuite
+  "strings"
+  (deftest
+    "str concat"
+    (assert-equal "hello world" (str "hello" " " "world")))
   (deftest "str number" (assert-equal "42" (str 42)))
   (deftest "str empty" (assert-equal "" (str)))
   (deftest "len string" (assert-equal 5 (len "hello")))
   (deftest "len empty" (assert-equal 0 (len "")))
-  (deftest "slice" (assert-equal "ell" (slice "hello" 1 4)))
+  (deftest
+    "slice"
+    (assert-equal "ell" (slice "hello" 1 4)))
   (deftest "slice from" (assert-equal "llo" (slice "hello" 2)))
-  (deftest "slice empty" (assert-equal "" (slice "hello" 2 2)))
+  (deftest
+    "slice empty"
+    (assert-equal "" (slice "hello" 2 2)))
   (deftest "join" (assert-equal "a,b,c" (join "," (list "a" "b" "c"))))
   (deftest "join empty" (assert-equal "" (join "," (list))))
   (deftest "join single" (assert-equal "a" (join "," (list "a"))))
@@ -101,88 +126,238 @@
   (deftest "replace" (assert-equal "hXllo" (replace "hello" "e" "X")))
   (deftest "string-length" (assert-equal 5 (string-length "hello")))
   (deftest "index-of found" (assert-equal 2 (index-of "hello" "l")))
-  (deftest "index-of not found" (assert-equal -1 (index-of "hello" "z"))))
+  (deftest
+    "index-of not found"
+    (assert-equal -1 (index-of "hello" "z"))))
 
 ;; --------------------------------------------------------------------------
 ;; List operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "lists"
-  (deftest "list create" (assert-equal (list 1 2 3) (list 1 2 3)))
-  (deftest "first" (assert-equal 1 (first (list 1 2 3))))
+(defsuite
+  "lists"
+  (deftest
+    "list create"
+    (assert-equal
+      (list 1 2 3)
+      (list 1 2 3)))
+  (deftest
+    "first"
+    (assert-equal 1 (first (list 1 2 3))))
   (deftest "first empty" (assert-nil (first (list))))
-  (deftest "rest" (assert-equal (list 2 3) (rest (list 1 2 3))))
+  (deftest
+    "rest"
+    (assert-equal
+      (list 2 3)
+      (rest (list 1 2 3))))
   (deftest "rest single" (assert-equal (list) (rest (list 1))))
   (deftest "rest empty" (assert-equal (list) (rest (list))))
-  (deftest "nth" (assert-equal 2 (nth (list 1 2 3) 1)))
-  (deftest "nth out of bounds" (assert-nil (nth (list 1 2) 5)))
-  (deftest "last" (assert-equal 3 (last (list 1 2 3))))
+  (deftest
+    "nth"
+    (assert-equal
+      2
+      (nth (list 1 2 3) 1)))
+  (deftest
+    "nth out of bounds"
+    (assert-nil (nth (list 1 2) 5)))
+  (deftest
+    "last"
+    (assert-equal 3 (last (list 1 2 3))))
   (deftest "last single" (assert-equal 1 (last (list 1))))
-  (deftest "len list" (assert-equal 3 (len (list 1 2 3))))
+  (deftest
+    "len list"
+    (assert-equal 3 (len (list 1 2 3))))
   (deftest "len empty" (assert-equal 0 (len (list))))
-  (deftest "cons" (assert-equal (list 0 1 2) (cons 0 (list 1 2))))
-  (deftest "append" (assert-equal (list 1 2 3 4) (append (list 1 2) (list 3 4))))
-  (deftest "append element" (assert-equal (list 1 2 3) (append (list 1 2) (list 3))))
-  (deftest "slice list" (assert-equal (list 2 3) (slice (list 1 2 3 4) 1 3)))
-  (deftest "concat" (assert-equal (list 1 2 3 4) (concat (list 1 2) (list 3 4))))
-  (deftest "reverse" (assert-equal (list 3 2 1) (reverse (list 1 2 3))))
+  (deftest
+    "cons"
+    (assert-equal
+      (list 0 1 2)
+      (cons 0 (list 1 2))))
+  (deftest
+    "append"
+    (assert-equal
+      (list 1 2 3 4)
+      (append (list 1 2) (list 3 4))))
+  (deftest
+    "append element"
+    (assert-equal
+      (list 1 2 3)
+      (append (list 1 2) (list 3))))
+  (deftest
+    "slice list"
+    (assert-equal
+      (list 2 3)
+      (slice
+        (list 1 2 3 4)
+        1
+        3)))
+  (deftest
+    "concat"
+    (assert-equal
+      (list 1 2 3 4)
+      (concat (list 1 2) (list 3 4))))
+  (deftest
+    "reverse"
+    (assert-equal
+      (list 3 2 1)
+      (reverse (list 1 2 3))))
   (deftest "reverse empty" (assert-equal (list) (reverse (list))))
-  (deftest "contains? list" (assert-true (contains? (list 1 2 3) 2)))
-  (deftest "contains? list false" (assert-false (contains? (list 1 2 3) 5)))
-  (deftest "range" (assert-equal (list 0 1 2) (range 0 3)))
-  (deftest "range step" (assert-equal (list 0 2 4) (range 0 6 2)))
-  (deftest "flatten" (assert-equal (list 1 2 3 4) (flatten (list (list 1 2) (list 3 4))))))
+  (deftest
+    "contains? list"
+    (assert-true
+      (contains? (list 1 2 3) 2)))
+  (deftest
+    "contains? list false"
+    (assert-false
+      (contains? (list 1 2 3) 5)))
+  (deftest
+    "range"
+    (assert-equal
+      (list 0 1 2)
+      (range 0 3)))
+  (deftest
+    "range step"
+    (assert-equal
+      (list 0 2 4)
+      (range 0 6 2)))
+  (deftest
+    "flatten"
+    (assert-equal
+      (list 1 2 3 4)
+      (flatten
+        (list (list 1 2) (list 3 4))))))
 
 ;; --------------------------------------------------------------------------
 ;; Dict operations
 ;; --------------------------------------------------------------------------
 
-(defsuite "dicts"
-  (deftest "dict create" (assert-equal 1 (get (dict "a" 1 "b" 2) "a")))
+(defsuite
+  "dicts"
+  (deftest
+    "dict create"
+    (assert-equal 1 (get (dict "a" 1 "b" 2) "a")))
   (deftest "get missing" (assert-nil (get (dict "a" 1) "z")))
-  (deftest "get default" (assert-equal 99 (get (dict "a" 1) "z" 99)))
-  (deftest "keys" (assert-true (contains? (keys (dict "a" 1 "b" 2)) "a")))
+  (deftest
+    "get default"
+    (assert-equal 99 (get (dict "a" 1) "z" 99)))
+  (deftest
+    "keys"
+    (assert-true
+      (contains? (keys (dict "a" 1 "b" 2)) "a")))
   (deftest "has-key?" (assert-true (has-key? (dict "a" 1) "a")))
-  (deftest "has-key? false" (assert-false (has-key? (dict "a" 1) "z")))
-  (deftest "assoc" (assert-equal 2 (get (assoc (dict "a" 1) "b" 2) "b")))
-  (deftest "dissoc" (assert-false (has-key? (dissoc (dict "a" 1 "b" 2) "a") "a")))
-  (deftest "len dict" (assert-equal 2 (len (dict "a" 1 "b" 2))))
+  (deftest
+    "has-key? false"
+    (assert-false (has-key? (dict "a" 1) "z")))
+  (deftest
+    "assoc"
+    (assert-equal
+      2
+      (get (assoc (dict "a" 1) "b" 2) "b")))
+  (deftest
+    "dissoc"
+    (assert-false
+      (has-key? (dissoc (dict "a" 1 "b" 2) "a") "a")))
+  (deftest
+    "len dict"
+    (assert-equal 2 (len (dict "a" 1 "b" 2))))
   (deftest "len empty dict" (assert-equal 0 (len (dict))))
   (deftest "empty? dict" (assert-true (empty? (dict))))
-  (deftest "empty? nonempty dict" (assert-false (empty? (dict "a" 1)))))
+  (deftest
+    "empty? nonempty dict"
+    (assert-false (empty? (dict "a" 1)))))
 
 ;; --------------------------------------------------------------------------
 ;; Higher-order functions
 ;; --------------------------------------------------------------------------
 
-(defsuite "higher-order"
-  (deftest "map" (assert-equal (list 2 4 6) (map (fn (x) (* x 2)) (list 1 2 3))))
+(defsuite
+  "higher-order"
+  (deftest
+    "map"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (list 1 2 3))))
   (deftest "map empty" (assert-equal (list) (map (fn (x) x) (list))))
-  (deftest "filter" (assert-equal (list 2 4) (filter (fn (x) (= (mod x 2) 0)) (list 1 2 3 4 5))))
-  (deftest "filter none" (assert-equal (list) (filter (fn (x) false) (list 1 2 3))))
-  (deftest "reduce" (assert-equal 10 (reduce (fn (acc x) (+ acc x)) 0 (list 1 2 3 4))))
-  (deftest "reduce empty" (assert-equal 0 (reduce (fn (acc x) (+ acc x)) 0 (list))))
-  (deftest "some true" (assert-true (some (fn (x) (> x 3)) (list 1 2 3 4 5))))
-  (deftest "some false" (assert-false (some (fn (x) (> x 10)) (list 1 2 3))))
+  (deftest
+    "filter"
+    (assert-equal
+      (list 2 4)
+      (filter
+        (fn (x) (= (mod x 2) 0))
+        (list 1 2 3 4 5))))
+  (deftest
+    "filter none"
+    (assert-equal
+      (list)
+      (filter (fn (x) false) (list 1 2 3))))
+  (deftest
+    "reduce"
+    (assert-equal
+      10
+      (reduce
+        (fn (acc x) (+ acc x))
+        0
+        (list 1 2 3 4))))
+  (deftest
+    "reduce empty"
+    (assert-equal
+      0
+      (reduce (fn (acc x) (+ acc x)) 0 (list))))
+  (deftest
+    "some true"
+    (assert-true
+      (some
+        (fn (x) (> x 3))
+        (list 1 2 3 4 5))))
+  (deftest
+    "some false"
+    (assert-false
+      (some
+        (fn (x) (> x 10))
+        (list 1 2 3))))
   (deftest "some empty" (assert-false (some (fn (x) true) (list))))
-  (deftest "every? true" (assert-true (every? (fn (x) (> x 0)) (list 1 2 3))))
-  (deftest "every? false" (assert-false (every? (fn (x) (> x 2)) (list 1 2 3))))
+  (deftest
+    "every? true"
+    (assert-true
+      (every?
+        (fn (x) (> x 0))
+        (list 1 2 3))))
+  (deftest
+    "every? false"
+    (assert-false
+      (every?
+        (fn (x) (> x 2))
+        (list 1 2 3))))
   (deftest "every? empty" (assert-true (every? (fn (x) false) (list))))
-  (deftest "for-each returns nil"
-    (let ((log (list)))
-      (for-each (fn (x) (append! log x)) (list 1 2 3))
+  (deftest
+    "for-each returns nil"
+    (let
+      ((log (list)))
+      (for-each
+        (fn (x) (append! log x))
+        (list 1 2 3))
       (assert-equal (list 1 2 3) log)))
-  (deftest "map-indexed"
-    (assert-equal (list (list 0 "a") (list 1 "b"))
+  (deftest
+    "map-indexed"
+    (assert-equal
+      (list (list 0 "a") (list 1 "b"))
       (map-indexed (fn (i x) (list i x)) (list "a" "b")))))
 
 ;; --------------------------------------------------------------------------
 ;; Type coercion
 ;; --------------------------------------------------------------------------
 
-(defsuite "type-coercion"
-  (deftest "str bool" (assert-true (or (= (str true) "true") (= (str true) "True"))))
+(defsuite
+  "type-coercion"
+  (deftest
+    "str bool"
+    (assert-true (or (= (str true) "true") (= (str true) "True"))))
   (deftest "str nil" (assert-equal "" (str nil)))
-  (deftest "str list" (assert-true (not (empty? (str (list 1 2 3))))))
+  (deftest
+    "str list"
+    (assert-true
+      (not (empty? (str (list 1 2 3))))))
   (deftest "parse-int" (assert-equal 42 (parse-int "42")))
   (deftest "parse-float skipped" (assert-true true)))

spec/tests/test-promises.sx

@@ -0,0 +1,150 @@
+(defsuite
+  "promises"
+  (deftest
+    "delay creates a promise"
+    (do (assert (promise? (delay 42)))))
+  (deftest
+    "delay does not evaluate immediately"
+    (do
+      (let
+        ((count 0))
+        (let
+          ((p (delay (do (set! count (+ count 1)) count))))
+          (assert= 0 count)))))
+  (deftest
+    "force evaluates the expression"
+    (do (assert= 42 (force (delay 42)))))
+  (deftest
+    "force with arithmetic"
+    (do (assert= 10 (force (delay (+ 3 7))))))
+  (deftest
+    "force memoises result"
+    (do
+      (let
+        ((count 0))
+        (let
+          ((p (delay (do (set! count (+ count 1)) count))))
+          (force p)
+          (force p)
+          (assert= 1 count)))))
+  (deftest
+    "force returns same value on repeated calls"
+    (do
+      (let
+        ((p (delay (+ 1 2))))
+        (assert= 3 (force p))
+        (assert= 3 (force p)))))
+  (deftest
+    "make-promise creates an already-forced promise"
+    (do
+      (let
+        ((p (make-promise 99)))
+        (assert (promise? p))
+        (assert= 99 (force p)))))
+  (deftest
+    "make-promise memoises without evaluating"
+    (do
+      (let
+        ((count 0))
+        (let
+          ((p (make-promise 42)))
+          (force p)
+          (force p)
+          (assert= 0 count)))))
+  (deftest
+    "promise? returns true for delay"
+    (do (assert (promise? (delay 1)))))
+  (deftest
+    "promise? returns true for make-promise"
+    (do (assert (promise? (make-promise 1)))))
+  (deftest
+    "promise? returns false for non-promise"
+    (do
+      (assert= false (promise? 42))
+      (assert= false (promise? "hello"))
+      (assert= false (promise? nil))
+      (assert= false (promise? (list 1 2)))))
+  (deftest
+    "force non-promise returns value unchanged"
+    (do
+      (assert= 42 (force 42))
+      (assert= "hi" (force "hi"))
+      (assert= nil (force nil))))
+  (deftest
+    "delay captures environment"
+    (do
+      (let
+        ((x 10))
+        (let
+          ((p (delay (+ x 5))))
+          (assert= 15 (force p))))))
+  (deftest
+    "delay-force basic"
+    (do (assert= 42 (force (delay-force (delay 42))))))
+  (deftest
+    "delay-force chains"
+    (do
+      (assert=
+        5
+        (force (delay-force (delay-force (delay 5)))))))
+  (deftest
+    "delay with string"
+    (do (assert= "hello" (force (delay "hello")))))
+  (deftest
+    "delay with list"
+    (do
+      (assert-equal
+        (list 1 2 3)
+        (force (delay (list 1 2 3))))))
+  (deftest
+    "delay with function call"
+    (do (assert= 6 (force (delay (* 2 3))))))
+  (deftest
+    "nested delay"
+    (do
+      (let
+        ((p (delay (delay 99))))
+        (assert (promise? (force p))))))
+  (deftest
+    "force already forced promise"
+    (do
+      (let
+        ((p (make-promise 7)))
+        (assert= 7 (force p))
+        (assert= 7 (force p)))))
+  (deftest
+    "lazy stream first element"
+    (do
+      (define (stream-cons x s) (delay (list x s)))
+      (define (stream-car s) (first (force s)))
+      (define (stream-cdr s) (nth (force s) 1))
+      (let
+        ((s (stream-cons 1 (stream-cons 2 (stream-cons 3 nil)))))
+        (assert= 1 (stream-car s))
+        (assert= 2 (stream-car (stream-cdr s))))))
+  (deftest
+    "delay-force is a promise"
+    (do (assert (promise? (delay-force (delay 1))))))
+  (deftest
+    "force with side effects runs once"
+    (do
+      (let
+        ((log (list)))
+        (let
+          ((p (delay (do (set! log (cons 42 log)) 42))))
+          (force p)
+          (force p)
+          (assert= 1 (len log))))))
+  (deftest
+    "make-promise with nil"
+    (do
+      (let
+        ((p (make-promise nil)))
+        (assert (promise? p))
+        (assert= nil (force p)))))
+  (deftest
+    "delay in let binding"
+    (do
+      (let
+        ((p (delay (+ 10 20))))
+        (assert= 30 (force p))))))

spec/tests/test-rationals.sx

@@ -0,0 +1,135 @@
+;; ==========================================================================
+;; test-rationals.sx — Rational number type: literals, arithmetic, tower
+;;
+;; Note: in the JS host, (/ int int) returns float (backward-compatible).
+;; Use rational literals (1/3, 3/4) or make-rational for exact rationals.
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; Literals and type
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:literals"
+  (deftest "1/3 is rational" (assert (rational? 1/3)))
+  (deftest "1/2 is rational" (assert (rational? 1/2)))
+  (deftest "2/3 is rational" (assert (rational? 2/3)))
+  (deftest "literal numerator 1/3" (assert= (numerator 1/3) 1))
+  (deftest "literal denominator 1/3" (assert= (denominator 1/3) 3))
+  (deftest "literal numerator 2/3" (assert= (numerator 2/3) 2))
+  (deftest "auto-reduce 2/4 = 1/2" (assert= 2/4 1/2))
+  (deftest "auto-reduce 6/9 = 2/3" (assert= 6/9 2/3))
+  (deftest "negative literal" (assert= (numerator -1/3) -1)))
+
+;; --------------------------------------------------------------------------
+;; Constructor and predicates
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:constructor"
+  (deftest
+    "make-rational basic"
+    (assert (rational? (make-rational 1 3))))
+  (deftest
+    "make-rational reduces"
+    (assert= (make-rational 2 4) 1/2))
+  (deftest
+    "make-rational exact int"
+    (assert (integer? (make-rational 6 3))))
+  (deftest
+    "make-rational 6/3 = 2"
+    (assert= (make-rational 6 3) 2))
+  (deftest
+    "make-rational negative"
+    (assert= (numerator (make-rational -1 3)) -1))
+  (deftest
+    "make-rational neg denom"
+    (assert= (numerator (make-rational 1 -3)) -1))
+  (deftest "rational? on int" (assert (not (rational? 5))))
+  (deftest "rational? on float" (assert (not (rational? 1.5))))
+  (deftest "rational? on string" (assert (not (rational? "1/2"))))
+  (deftest "number? on rational" (assert (number? 1/3)))
+  (deftest "exact? on rational" (assert (exact? 1/3)))
+  (deftest "inexact? on rational" (assert (not (inexact? 1/3))))
+  (deftest "integer? on rational" (assert (not (integer? 1/3))))
+  (deftest "dict? on rational" (assert (not (dict? 1/3)))))
+
+;; --------------------------------------------------------------------------
+;; Accessors
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:accessors"
+  (deftest "numerator 1/3" (assert= (numerator 1/3) 1))
+  (deftest "denominator 1/3" (assert= (denominator 1/3) 3))
+  (deftest "numerator 3/4" (assert= (numerator 3/4) 3))
+  (deftest "denominator 3/4" (assert= (denominator 3/4) 4))
+  (deftest "numerator of int" (assert= (numerator 5) 5))
+  (deftest
+    "denominator of int"
+    (assert= (denominator 5) 1)))
+
+;; --------------------------------------------------------------------------
+;; Arithmetic
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:arithmetic"
+  (deftest "add two rationals" (assert= (+ 1/3 1/3) 2/3))
+  (deftest "add to integer" (assert= (+ 1 1/2) 3/2))
+  (deftest "add integer to rational" (assert= (+ 1/2 1) 3/2))
+  (deftest "add reduces" (assert= (+ 1/6 1/6) 1/3))
+  (deftest "add to whole number" (assert (integer? (+ 1/2 1/2))))
+  (deftest "add whole = 1" (assert= (+ 1/2 1/2) 1))
+  (deftest "subtract rationals" (assert= (- 3/4 1/4) 1/2))
+  (deftest "subtract int from rational" (assert= (- 3/2 1) 1/2))
+  (deftest "negate rational" (assert= (- 1/3) -1/3))
+  (deftest "multiply rationals" (assert= (* 2/3 3/4) 1/2))
+  (deftest "multiply int and rational" (assert= (* 2 1/3) 2/3))
+  (deftest "multiply reduces to int" (assert (integer? (* 3 1/3))))
+  (deftest "divide rational by int" (assert= (/ 2/3 2) 1/3))
+  (deftest "divide rational by rational" (assert= (/ 1/2 1/4) 2))
+  (deftest
+    "divide rational gives int when exact"
+    (assert (integer? (/ 1/2 1/2)))))
+
+;; --------------------------------------------------------------------------
+;; Float contagion
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:float-contagion"
+  (deftest "rational + float = float" (assert (float? (+ 1/3 0.5))))
+  (deftest "float + rational = float" (assert (float? (+ 0.5 1/3))))
+  (deftest "rational * float = float" (assert (float? (* 1/2 2))))
+  (deftest "rational - float = float" (assert (float? (- 1/2 0.1)))))
+
+;; --------------------------------------------------------------------------
+;; Comparison
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:comparison"
+  (deftest "equal rationals" (assert (= 1/2 1/2)))
+  (deftest "equal reduced" (assert (= 2/4 1/2)))
+  (deftest "not equal" (assert (not (= 1/3 1/2))))
+  (deftest "less than" (assert (< 1/3 1/2)))
+  (deftest "less than int" (assert (< 1/3 1)))
+  (deftest "greater than" (assert (> 2/3 1/2)))
+  (deftest "less equal" (assert (<= 1/3 1/3)))
+  (deftest "greater equal" (assert (>= 2/3 2/3)))
+  (deftest "rational less than float" (assert (< 1/3 0.5))))
+
+;; --------------------------------------------------------------------------
+;; Coercion
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "rationals:coercion"
+  (deftest "exact->inexact 1/2" (assert= (exact->inexact 1/2) 0.5))
+  (deftest "exact->inexact 1/4" (assert= (exact->inexact 1/4) 0.25))
+  (deftest
+    "exact->inexact 1/3 is float"
+    (assert (float? (exact->inexact 1/3))))
+  (deftest "number->string 1/2" (assert= (number->string 1/2) "1/2"))
+  (deftest "number->string 3/4" (assert= (number->string 3/4) "3/4")))

spec/tests/test-read-write.sx

@@ -0,0 +1,212 @@
+;; ==========================================================================
+;; test-read-write.sx — Tests for read / write / display / newline
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; read — parse one datum from an input port
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "read:basics"
+  (deftest
+    "read integer"
+    (let ((p (open-input-string "42"))) (assert= (read p) 42)))
+  (deftest
+    "read float"
+    (let ((p (open-input-string "3.14"))) (assert= (read p) 3.14)))
+  (deftest
+    "read string"
+    (let ((p (open-input-string "\"hello\""))) (assert= (read p) "hello")))
+  (deftest
+    "read boolean true"
+    (let ((p (open-input-string "#t"))) (assert (read p))))
+  (deftest
+    "read boolean false"
+    (let ((p (open-input-string "#f"))) (assert (not (read p)))))
+  (deftest
+    "read nil"
+    (let ((p (open-input-string "()"))) (assert-nil (read p))))
+  (deftest
+    "read list"
+    (let
+      ((p (open-input-string "(1 2 3)")))
+      (assert= (read p) (list 1 2 3))))
+  (deftest
+    "read nested list"
+    (let
+      ((p (open-input-string "(+ 1 (* 2 3))")))
+      (assert=
+        (read p)
+        (list (quote +) 1 (list (quote *) 2 3))))))
+
+;; --------------------------------------------------------------------------
+;; read — eof and multi-read
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "read:eof"
+  (deftest
+    "read eof returns eof-object"
+    (let ((p (open-input-string ""))) (assert (eof-object? (read p)))))
+  (deftest
+    "read whitespace-only returns eof"
+    (let ((p (open-input-string "   "))) (assert (eof-object? (read p)))))
+  (deftest
+    "read two forms"
+    (let
+      ((p (open-input-string "1 2")))
+      (let
+        ((a (read p)) (b (read p)))
+        (assert (and (= a 1) (= b 2))))))
+  (deftest
+    "read returns eof after last form"
+    (let
+      ((p (open-input-string "42")))
+      (read p)
+      (assert (eof-object? (read p))))))
+
+;; --------------------------------------------------------------------------
+;; write — serialize with quoting
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "write:basics"
+  (deftest "write integer" (assert= (write-to-string 42) "42"))
+  (deftest
+    "write negative integer"
+    (assert= (write-to-string -5) "-5"))
+  (deftest "write float" (assert= (write-to-string 3.14) "3.14"))
+  (deftest "write true" (assert= (write-to-string true) "#t"))
+  (deftest "write false" (assert= (write-to-string false) "#f"))
+  (deftest "write nil" (assert= (write-to-string nil) "()"))
+  (deftest
+    "write string quotes"
+    (assert= (write-to-string "hello") "\"hello\""))
+  (deftest
+    "write string with escapes"
+    (assert= (write-to-string "a\"b") "\"a\\\"b\""))
+  (deftest
+    "write list"
+    (assert=
+      (write-to-string (list 1 2 3))
+      "(1 2 3)"))
+  (deftest
+    "write nested list"
+    (assert=
+      (write-to-string (list 1 (list 2 3)))
+      "(1 (2 3))"))
+  (deftest "write symbol" (assert= (write-to-string (quote foo)) "foo"))
+  (deftest "write rational" (assert= (write-to-string 1/3) "1/3")))
+
+;; --------------------------------------------------------------------------
+;; display — serialize without quoting
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "display:basics"
+  (deftest "display integer" (assert= (display-to-string 42) "42"))
+  (deftest
+    "display string no quotes"
+    (assert= (display-to-string "hello") "hello"))
+  (deftest "display true" (assert= (display-to-string true) "#t"))
+  (deftest "display nil" (assert= (display-to-string nil) "()"))
+  (deftest
+    "display list"
+    (assert=
+      (display-to-string (list 1 2 3))
+      "(1 2 3)")))
+
+;; --------------------------------------------------------------------------
+;; write vs display distinction
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "write-vs-display"
+  (deftest
+    "write quotes string, display does not"
+    (let
+      ((s "hello"))
+      (assert
+        (and
+          (= (write-to-string s) "\"hello\"")
+          (= (display-to-string s) "hello")))))
+  (deftest
+    "write and display same for numbers"
+    (assert= (write-to-string 42) (display-to-string 42)))
+  (deftest
+    "write and display same for lists"
+    (assert=
+      (write-to-string (list 1 2))
+      (display-to-string (list 1 2)))))
+
+;; --------------------------------------------------------------------------
+;; write/display/newline to port
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "write-to-port"
+  (deftest
+    "write to output port"
+    (let
+      ((p (open-output-string)))
+      (write 42 p)
+      (assert= (get-output-string p) "42")))
+  (deftest
+    "display to output port"
+    (let
+      ((p (open-output-string)))
+      (display "hi" p)
+      (assert= (get-output-string p) "hi")))
+  (deftest
+    "newline to output port"
+    (let
+      ((p (open-output-string)))
+      (newline p)
+      (assert= (get-output-string p) "\n")))
+  (deftest
+    "write then newline"
+    (let
+      ((p (open-output-string)))
+      (write "hello" p)
+      (newline p)
+      (assert= (get-output-string p) "\"hello\"\n")))
+  (deftest
+    "display multiple values"
+    (let
+      ((p (open-output-string)))
+      (display 1 p)
+      (display " " p)
+      (display 2 p)
+      (assert= (get-output-string p) "1 2"))))
+
+;; --------------------------------------------------------------------------
+;; write round-trip
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "write:round-trip"
+  (deftest
+    "integer round-trips"
+    (let
+      ((p (open-input-string (write-to-string 42))))
+      (assert= (read p) 42)))
+  (deftest
+    "string round-trips"
+    (let
+      ((p (open-input-string (write-to-string "hello world"))))
+      (assert= (read p) "hello world")))
+  (deftest
+    "list round-trips"
+    (let
+      ((p (open-input-string (write-to-string (list 1 2 3)))))
+      (assert= (read p) (list 1 2 3))))
+  (deftest
+    "boolean true round-trips"
+    (let
+      ((p (open-input-string (write-to-string true))))
+      (assert (read p))))
+  (deftest
+    "boolean false round-trips"
+    (let
+      ((p (open-input-string (write-to-string false))))
+      (assert (not (read p))))))

spec/tests/test-regexp.sx

@@ -0,0 +1,191 @@
+;; ==========================================================================
+;; test-regexp.sx — Tests for regexp primitives
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; make-regexp / regexp?
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:create"
+  (deftest "make-regexp returns regexp" (assert (regexp? (make-regexp "abc"))))
+  (deftest
+    "make-regexp with flags"
+    (assert (regexp? (make-regexp "[a-z]+" "i"))))
+  (deftest "regexp? true for regexp" (assert (regexp? (make-regexp "x"))))
+  (deftest "regexp? false for string" (assert (not (regexp? "abc"))))
+  (deftest "regexp? false for nil" (assert (not (regexp? nil))))
+  (deftest
+    "regexp-source"
+    (assert= (regexp-source (make-regexp "hello")) "hello"))
+  (deftest
+    "regexp-flags"
+    (assert= (regexp-flags (make-regexp "x" "im")) "im"))
+  (deftest
+    "regexp-flags empty string"
+    (assert= (regexp-flags (make-regexp "x")) "")))
+
+;; --------------------------------------------------------------------------
+;; regexp-match — basic
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:match"
+  (deftest
+    "match returns dict"
+    (let
+      ((m (regexp-match (make-regexp "hel+o") "hello world")))
+      (assert (dict? m))))
+  (deftest
+    "match :match key"
+    (let
+      ((m (regexp-match (make-regexp "hel+o") "say hello")))
+      (assert= (get m "match") "hello")))
+  (deftest
+    "match :start key"
+    (let
+      ((m (regexp-match (make-regexp "lo") "hello")))
+      (assert= (get m "start") 3)))
+  (deftest
+    "match :end key"
+    (let
+      ((m (regexp-match (make-regexp "lo") "hello")))
+      (assert= (get m "end") 5)))
+  (deftest
+    "no match returns nil"
+    (assert-nil (regexp-match (make-regexp "xyz") "hello")))
+  (deftest
+    "match at start"
+    (let
+      ((m (regexp-match (make-regexp "^hel") "hello")))
+      (assert= (get m "start") 0)))
+  (deftest
+    "match digit pattern"
+    (let
+      ((m (regexp-match (make-regexp "[0-9]+") "abc 123 def")))
+      (assert= (get m "match") "123"))))
+
+;; --------------------------------------------------------------------------
+;; regexp-match — groups
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:groups"
+  (deftest
+    "no capture groups → empty list"
+    (let
+      ((m (regexp-match (make-regexp "hello") "hello world")))
+      (assert= (length (get m "groups")) 0)))
+  (deftest
+    "one capture group"
+    (let
+      ((m (regexp-match (make-regexp "([0-9]+)") "price: 42")))
+      (assert= (first (get m "groups")) "42")))
+  (deftest
+    "two capture groups"
+    (let
+      ((m (regexp-match (make-regexp "([a-z]+)=([0-9]+)") "x=10")))
+      (let
+        ((gs (get m "groups")))
+        (assert
+          (and (= (first gs) "x") (= (first (rest gs)) "10")))))))
+
+;; --------------------------------------------------------------------------
+;; regexp-match-all
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:match-all"
+  (deftest
+    "match-all returns list"
+    (let
+      ((ms (regexp-match-all (make-regexp "[0-9]+") "1 and 2 and 3")))
+      (assert (list? ms))))
+  (deftest
+    "match-all count"
+    (assert=
+      (length (regexp-match-all (make-regexp "[0-9]+") "1 and 2 and 3"))
+      3))
+  (deftest
+    "match-all first match"
+    (let
+      ((ms (regexp-match-all (make-regexp "[0-9]+") "10 20 30")))
+      (assert= (get (first ms) "match") "10")))
+  (deftest
+    "match-all empty when no match"
+    (assert=
+      (length (regexp-match-all (make-regexp "xyz") "hello"))
+      0)))
+
+;; --------------------------------------------------------------------------
+;; regexp-replace / regexp-replace-all
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:replace"
+  (deftest
+    "replace first match"
+    (assert= (regexp-replace (make-regexp "o+") "foobar boo" "0") "f0bar boo"))
+  (deftest
+    "replace no match returns original"
+    (assert= (regexp-replace (make-regexp "xyz") "hello" "X") "hello"))
+  (deftest
+    "replace-all all matches"
+    (assert= (regexp-replace-all (make-regexp "o") "foo boo" "0") "f00 b00"))
+  (deftest
+    "replace with $& (whole match)"
+    (assert=
+      (regexp-replace (make-regexp "[0-9]+") "price 42" "[$&]")
+      "price [42]"))
+  (deftest
+    "replace-all removes digits"
+    (assert=
+      (regexp-replace-all (make-regexp "[0-9]") "a1b2c3" "")
+      "abc")))
+
+;; --------------------------------------------------------------------------
+;; regexp-split
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:split"
+  (deftest
+    "split on whitespace"
+    (let
+      ((parts (regexp-split (make-regexp " +") "hello world foo")))
+      (assert= (length parts) 3)))
+  (deftest
+    "split first part"
+    (let
+      ((parts (regexp-split (make-regexp ",") "a,b,c")))
+      (assert= (first parts) "a")))
+  (deftest
+    "split last part"
+    (let
+      ((parts (regexp-split (make-regexp ",") "a,b,c")))
+      (assert= (first (rest (rest parts))) "c")))
+  (deftest
+    "split no match → single element"
+    (let
+      ((parts (regexp-split (make-regexp ",") "hello")))
+      (assert= (length parts) 1))))
+
+;; --------------------------------------------------------------------------
+;; flags
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "regexp:flags"
+  (deftest
+    "case-insensitive flag"
+    (let
+      ((m (regexp-match (make-regexp "HELLO" "i") "hello world")))
+      (assert (not (nil? m)))))
+  (deftest
+    "case-sensitive without flag"
+    (assert-nil (regexp-match (make-regexp "HELLO") "hello world")))
+  (deftest
+    "multiline ^ matches line starts"
+    (let
+      ((ms (regexp-match-all (make-regexp "^[a-z]" "m") "a\nb\nc")))
+      (assert= (length ms) 3))))

spec/tests/test-sequences.sx

@@ -0,0 +1,202 @@
+;; test-sequences.sx — Phase 11: sequence protocol tests
+
+(defsuite
+  "sequences"
+  (deftest
+    "seq-to-list nil is empty list"
+    (assert-equal (list) (seq-to-list nil)))
+  (deftest
+    "seq-to-list list is identity"
+    (assert-equal
+      (list 1 2 3)
+      (seq-to-list (list 1 2 3))))
+  (deftest
+    "seq-to-list vector to list"
+    (assert-equal
+      (list 10 20 30)
+      (seq-to-list (vector 10 20 30))))
+  (deftest
+    "seq-to-list string to char list"
+    (assert-equal (list "a" "b" "c") (seq-to-list "abc")))
+  (deftest
+    "seq-to-list empty string to empty list"
+    (assert-equal (list) (seq-to-list "")))
+  (deftest
+    "sequence-to-list nil is empty list"
+    (assert-equal (list) (sequence-to-list nil)))
+  (deftest
+    "sequence-to-list list is identity"
+    (assert-equal
+      (list 1 2 3)
+      (sequence-to-list (list 1 2 3))))
+  (deftest
+    "sequence-to-list vector to list"
+    (assert-equal (list "x" "y") (sequence-to-list (vector "x" "y"))))
+  (deftest
+    "sequence-to-list string to char list"
+    (assert-equal (list "h" "i") (sequence-to-list "hi")))
+  (deftest
+    "sequence-to-vector nil is empty vector"
+    (let
+      ((v (sequence-to-vector nil)))
+      (do (assert (vector? v)) (assert= 0 (vector-length v)))))
+  (deftest
+    "sequence-to-vector list to vector"
+    (let
+      ((v (sequence-to-vector (list 1 2 3))))
+      (do
+        (assert (vector? v))
+        (assert= 3 (vector-length v))
+        (assert= 1 (vector-ref v 0))
+        (assert= 3 (vector-ref v 2)))))
+  (deftest
+    "sequence-to-vector string to vector of chars"
+    (let
+      ((v (sequence-to-vector "abc")))
+      (do
+        (assert (vector? v))
+        (assert= 3 (vector-length v))
+        (assert= "a" (vector-ref v 0))
+        (assert= "c" (vector-ref v 2)))))
+  (deftest
+    "sequence-length nil is 0"
+    (assert= 0 (sequence-length nil)))
+  (deftest
+    "sequence-length empty list is 0"
+    (assert= 0 (sequence-length (list))))
+  (deftest
+    "sequence-length list of 3"
+    (assert=
+      3
+      (sequence-length (list 1 2 3))))
+  (deftest
+    "sequence-length empty vector is 0"
+    (assert= 0 (sequence-length (vector))))
+  (deftest
+    "sequence-length vector of 4"
+    (assert=
+      4
+      (sequence-length (vector 10 20 30 40))))
+  (deftest
+    "sequence-length empty string is 0"
+    (assert= 0 (sequence-length "")))
+  (deftest
+    "sequence-length string hello"
+    (assert= 5 (sequence-length "hello")))
+  (deftest
+    "sequence-ref list first"
+    (assert=
+      10
+      (sequence-ref (list 10 20 30) 0)))
+  (deftest
+    "sequence-ref list last"
+    (assert=
+      30
+      (sequence-ref (list 10 20 30) 2)))
+  (deftest
+    "sequence-ref vector middle"
+    (assert=
+      20
+      (sequence-ref (vector 10 20 30) 1)))
+  (deftest
+    "sequence-ref string first char"
+    (assert= "h" (sequence-ref "hello" 0)))
+  (deftest
+    "sequence-ref string last char"
+    (assert= "o" (sequence-ref "hello" 4)))
+  (deftest
+    "sequence-append two lists"
+    (assert-equal
+      (list 1 2 3 4)
+      (sequence-append
+        (list 1 2)
+        (list 3 4))))
+  (deftest
+    "sequence-append list with empty"
+    (assert-equal
+      (list 1 2)
+      (sequence-append (list 1 2) (list))))
+  (deftest
+    "sequence-append two strings"
+    (assert= "hello world" (sequence-append "hello " "world")))
+  (deftest
+    "sequence-append empty strings"
+    (assert= "abc" (sequence-append "" "abc")))
+  (deftest
+    "in-range 1-arg gives 0..n-1"
+    (assert-equal
+      (list 0 1 2 3 4)
+      (in-range 5)))
+  (deftest
+    "in-range 1-arg zero is empty"
+    (assert-equal (list) (in-range 0)))
+  (deftest
+    "in-range 2-arg start and end"
+    (assert-equal
+      (list 1 2 3)
+      (in-range 1 4)))
+  (deftest
+    "in-range 2-arg same start end is empty"
+    (assert-equal (list) (in-range 3 3)))
+  (deftest
+    "in-range 3-arg with step 2"
+    (assert-equal
+      (list 0 2 4)
+      (in-range 0 6 2)))
+  (deftest
+    "in-range result is a list"
+    (assert (list? (in-range 5))))
+  (deftest
+    "in-range length is correct"
+    (assert= 10 (len (in-range 10))))
+  (deftest
+    "map over vector"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (vector 1 2 3))))
+  (deftest
+    "filter over vector keeps odds"
+    (assert-equal
+      (list 1 3 5)
+      (filter
+        odd?
+        (vector 1 2 3 4 5))))
+  (deftest
+    "reduce over vector sums"
+    (assert=
+      10
+      (reduce
+        +
+        0
+        (vector 1 2 3 4))))
+  (deftest
+    "some over vector finds odd"
+    (assert (some odd? (vector 2 4 3 6))))
+  (deftest
+    "every? over vector all even"
+    (assert
+      (every? even? (vector 2 4 6 8))))
+  (deftest
+    "every? over vector fails with odd"
+    (assert= false (every? even? (vector 2 3 6))))
+  (deftest
+    "map over in-range squares"
+    (assert-equal
+      (list 0 1 4 9 16)
+      (map (fn (x) (* x x)) (in-range 5))))
+  (deftest
+    "filter over in-range keeps evens"
+    (assert-equal
+      (list 0 2 4 6)
+      (filter even? (in-range 7))))
+  (deftest
+    "reduce over in-range sums"
+    (assert= 15 (reduce + 0 (in-range 6))))
+  (deftest
+    "map over string returns char list"
+    (assert-equal (list "a" "b" "c") (map (fn (c) c) "abc")))
+  (deftest
+    "filter over string keeps matching chars"
+    (assert-equal (list "p" "p") (filter (fn (c) (= c "p")) "apple"))))

spec/tests/test-sets.sx

@@ -0,0 +1,200 @@
+;; ==========================================================================
+;; test-sets.sx — Tests for set primitives
+;; ==========================================================================
+
+;; --------------------------------------------------------------------------
+;; make-set / set?
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "sets:create"
+  (deftest "make-set returns a set" (assert (set? (make-set))))
+  (deftest "empty set has size 0" (assert= (set-size (make-set)) 0))
+  (deftest
+    "make-set from list"
+    (let ((s (make-set (list 1 2 3)))) (assert= (set-size s) 3)))
+  (deftest
+    "make-set deduplicates"
+    (let ((s (make-set (list 1 2 2 3 3)))) (assert= (set-size s) 3)))
+  (deftest "set? true for sets" (assert (set? (make-set))))
+  (deftest "set? false for list" (assert (not (set? (list 1 2 3)))))
+  (deftest "set? false for nil" (assert (not (set? nil))))
+  (deftest "set? false for number" (assert (not (set? 42)))))
+
+;; --------------------------------------------------------------------------
+;; set-add! / set-member? / set-remove!
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "sets:mutation"
+  (deftest
+    "set-add! increases size"
+    (let
+      ((s (make-set)))
+      (set-add! s 1)
+      (assert= (set-size s) 1)))
+  (deftest
+    "set-add! idempotent"
+    (let
+      ((s (make-set)))
+      (set-add! s 1)
+      (set-add! s 1)
+      (assert= (set-size s) 1)))
+  (deftest
+    "set-member? true after add"
+    (let
+      ((s (make-set)))
+      (set-add! s "hello")
+      (assert (set-member? s "hello"))))
+  (deftest
+    "set-member? false for absent"
+    (let
+      ((s (make-set (list 1 2 3))))
+      (assert (not (set-member? s 99)))))
+  (deftest
+    "set-remove! reduces size"
+    (let
+      ((s (make-set (list 1 2 3))))
+      (set-remove! s 2)
+      (assert= (set-size s) 2)))
+  (deftest
+    "set-remove! removes element"
+    (let
+      ((s (make-set (list 1 2 3))))
+      (set-remove! s 2)
+      (assert (not (set-member? s 2)))))
+  (deftest
+    "set-remove! no-op for absent"
+    (let
+      ((s (make-set (list 1 2 3))))
+      (set-remove! s 99)
+      (assert= (set-size s) 3)))
+  (deftest
+    "set handles strings"
+    (let
+      ((s (make-set)))
+      (set-add! s "a")
+      (set-add! s "b")
+      (assert (and (set-member? s "a") (set-member? s "b")))))
+  (deftest
+    "set handles symbols"
+    (let
+      ((s (make-set)))
+      (set-add! s (quote foo))
+      (assert (set-member? s (quote foo))))))
+
+;; --------------------------------------------------------------------------
+;; set->list / list->set
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "sets:conversion"
+  (deftest
+    "list->set creates set"
+    (let ((s (list->set (list 1 2 3)))) (assert (set? s))))
+  (deftest
+    "list->set size"
+    (let ((s (list->set (list 1 2 3)))) (assert= (set-size s) 3)))
+  (deftest
+    "list->set deduplicates"
+    (let ((s (list->set (list 1 1 2)))) (assert= (set-size s) 2)))
+  (deftest
+    "set->list has all elements"
+    (let
+      ((s (make-set (list 1 2 3)))
+       (lst (set->list s)))
+      (assert= (length lst) 3)))
+  (deftest
+    "set->list round-trip membership"
+    (let
+      ((s (make-set (list 10 20 30)))
+       (lst (set->list s)))
+      (assert
+        (and
+          (set-member? (list->set lst) 10)
+          (set-member? (list->set lst) 20)
+          (set-member? (list->set lst) 30))))))
+
+;; --------------------------------------------------------------------------
+;; set-union / set-intersection / set-difference
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "sets:operations"
+  (deftest
+    "union size"
+    (let
+      ((a (make-set (list 1 2 3)))
+       (b (make-set (list 3 4 5))))
+      (assert= (set-size (set-union a b)) 5)))
+  (deftest
+    "union contains all"
+    (let
+      ((u (set-union (make-set (list 1 2)) (make-set (list 3 4)))))
+      (assert
+        (and
+          (set-member? u 1)
+          (set-member? u 3)
+          (set-member? u 4)))))
+  (deftest
+    "intersection size"
+    (let
+      ((a (make-set (list 1 2 3)))
+       (b (make-set (list 2 3 4))))
+      (assert= (set-size (set-intersection a b)) 2)))
+  (deftest
+    "intersection contains overlap"
+    (let
+      ((i (set-intersection (make-set (list 1 2 3)) (make-set (list 2 3 4)))))
+      (assert (and (set-member? i 2) (set-member? i 3) (not (set-member? i 1))))))
+  (deftest
+    "intersection empty when disjoint"
+    (let
+      ((a (make-set (list 1 2)))
+       (b (make-set (list 3 4))))
+      (assert= (set-size (set-intersection a b)) 0)))
+  (deftest
+    "difference size"
+    (let
+      ((a (make-set (list 1 2 3)))
+       (b (make-set (list 2 3))))
+      (assert= (set-size (set-difference a b)) 1)))
+  (deftest
+    "difference keeps only a-exclusive"
+    (let
+      ((d (set-difference (make-set (list 1 2 3)) (make-set (list 2 3 4)))))
+      (assert (and (set-member? d 1) (not (set-member? d 2)) (not (set-member? d 4))))))
+  (deftest
+    "union does not mutate inputs"
+    (let
+      ((a (make-set (list 1 2)))
+       (b (make-set (list 3 4))))
+      (set-union a b)
+      (assert= (set-size a) 2))))
+
+;; --------------------------------------------------------------------------
+;; set-for-each / set-map
+;; --------------------------------------------------------------------------
+
+(defsuite
+  "sets:higher-order"
+  (deftest
+    "set-for-each visits all"
+    (let
+      ((s (make-set (list 1 2 3)))
+       (acc (list)))
+      (set-for-each s (fn (v) (set! acc (cons v acc))))
+      (assert= (length acc) 3)))
+  (deftest
+    "set-map doubles values"
+    (let
+      ((s (make-set (list 1 2 3)))
+       (s2 (set-map s (fn (v) (* v 2)))))
+      (assert
+        (and
+          (set-member? s2 2)
+          (set-member? s2 4)
+          (set-member? s2 6)))))
+  (deftest
+    "set-map result is a set"
+    (assert (set? (set-map (make-set (list 1 2)) (fn (v) v))))))

spec/tests/test-string-buffer.sx

@@ -0,0 +1,131 @@
+(defsuite
+  "string-buffer"
+  (deftest
+    "make-string-buffer creates a string-buffer"
+    (let ((buf (make-string-buffer))) (assert (string-buffer? buf))))
+  (deftest
+    "string-buffer? is false for non-buffers"
+    (assert= false (string-buffer? "hello"))
+    (assert= false (string-buffer? 42))
+    (assert= false (string-buffer? nil))
+    (assert= false (string-buffer? (list)))
+    (assert= false (string-buffer? {:key "val"})))
+  (deftest
+    "type-of returns string-buffer"
+    (assert= "string-buffer" (type-of (make-string-buffer))))
+  (deftest
+    "empty buffer converts to empty string"
+    (let
+      ((buf (make-string-buffer)))
+      (assert= "" (string-buffer->string buf))))
+  (deftest
+    "empty buffer has length zero"
+    (let
+      ((buf (make-string-buffer)))
+      (assert= 0 (string-buffer-length buf))))
+  (deftest
+    "single append accumulates string"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "hello")
+      (assert= "hello" (string-buffer->string buf))))
+  (deftest
+    "multiple appends join in order"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "foo")
+      (string-buffer-append! buf "bar")
+      (string-buffer-append! buf "baz")
+      (assert= "foobarbaz" (string-buffer->string buf))))
+  (deftest
+    "length tracks total bytes appended"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "abc")
+      (string-buffer-append! buf "de")
+      (assert= 5 (string-buffer-length buf))))
+  (deftest
+    "append returns nil"
+    (let
+      ((buf (make-string-buffer)))
+      (assert= nil (string-buffer-append! buf "x"))))
+  (deftest
+    "appending empty string is harmless"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "start")
+      (string-buffer-append! buf "")
+      (string-buffer-append! buf "end")
+      (assert= "startend" (string-buffer->string buf))
+      (assert= 8 (string-buffer-length buf))))
+  (deftest
+    "buffer is still usable after string-buffer->string"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "hello")
+      (string-buffer->string buf)
+      (string-buffer-append! buf " world")
+      (assert= "hello world" (string-buffer->string buf))))
+  (deftest
+    "two buffers are independent"
+    (let
+      ((b1 (make-string-buffer)) (b2 (make-string-buffer)))
+      (string-buffer-append! b1 "one")
+      (string-buffer-append! b2 "two")
+      (string-buffer-append! b1 "ONE")
+      (assert= "oneONE" (string-buffer->string b1))
+      (assert= "two" (string-buffer->string b2))))
+  (deftest
+    "loop building — linear string concat"
+    (let
+      ((buf (make-string-buffer)))
+      (let
+        loop
+        ((i 0))
+        (when
+          (< i 5)
+          (string-buffer-append! buf (str i))
+          (loop (+ i 1))))
+      (assert= "01234" (string-buffer->string buf))
+      (assert= 5 (string-buffer-length buf))))
+  (deftest
+    "building CSV row with separator"
+    (let
+      ((buf (make-string-buffer)) (items (list "a" "b" "c" "d")))
+      (let
+        loop
+        ((remaining items) (is-first true))
+        (when
+          (not (empty? remaining))
+          (when (not is-first) (string-buffer-append! buf ","))
+          (string-buffer-append! buf (first remaining))
+          (loop (rest remaining) false)))
+      (assert= "a,b,c,d" (string-buffer->string buf))))
+  (deftest
+    "unicode characters accumulate correctly"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "こんにちは")
+      (string-buffer-append! buf " ")
+      (string-buffer-append! buf "世界")
+      (assert= "こんにちは 世界" (string-buffer->string buf))))
+  (deftest
+    "repeated to-string calls are consistent"
+    (let
+      ((buf (make-string-buffer)))
+      (string-buffer-append! buf "test")
+      (assert= (string-buffer->string buf) (string-buffer->string buf))))
+  (deftest
+    "building with join pattern produces correct output"
+    (let
+      ((buf (make-string-buffer))
+        (words (list "the" "quick" "brown" "fox")))
+      (let
+        loop
+        ((remaining words) (sep ""))
+        (when
+          (not (empty? remaining))
+          (string-buffer-append! buf sep)
+          (string-buffer-append! buf (first remaining))
+          (loop (rest remaining) " ")))
+      (assert= "the quick brown fox" (string-buffer->string buf)))))

spec/tests/test-values.sx

@@ -0,0 +1,172 @@
+(defsuite
+  "multiple-values"
+  (deftest
+    "values single returns value directly"
+    (do
+      (assert= 42 (values 42))
+      (assert= "hi" (values "hi"))
+      (assert= nil (values nil))))
+  (deftest
+    "values multiple returns marker dict"
+    (do
+      (let
+        ((v (values 1 2 3)))
+        (assert (dict? v))
+        (assert= true (get v :_values false))
+        (assert-equal (list 1 2 3) (get v :_list)))))
+  (deftest
+    "call-with-values basic two values"
+    (do
+      (assert=
+        3
+        (call-with-values
+          (fn () (values 1 2))
+          (fn (a b) (+ a b))))))
+  (deftest
+    "call-with-values three values"
+    (do
+      (assert=
+        6
+        (call-with-values
+          (fn () (values 1 2 3))
+          (fn (a b c) (+ a b c))))))
+  (deftest
+    "call-with-values single value passthrough"
+    (do
+      (assert= 10 (call-with-values (fn () 10) (fn (x) x)))))
+  (deftest
+    "call-with-values passes non-values result as single arg"
+    (do (assert= "hello" (call-with-values (fn () "hello") (fn (x) x)))))
+  (deftest
+    "call-with-values with string concat"
+    (do
+      (assert=
+        "ab"
+        (call-with-values (fn () (values "a" "b")) (fn (a b) (str a b))))))
+  (deftest
+    "let-values basic two bindings"
+    (do
+      (let-values
+        (((a b) (values 10 20)))
+        (assert= 10 a)
+        (assert= 20 b))))
+  (deftest
+    "let-values computes with bindings"
+    (do
+      (let-values
+        (((x y) (values 3 4)))
+        (assert= 7 (+ x y)))))
+  (deftest
+    "let-values three values"
+    (do
+      (let-values
+        (((a b c) (values 1 2 3)))
+        (assert= 6 (+ a b c)))))
+  (deftest
+    "let-values single value binding"
+    (do (let-values (((x) (values 42))) (assert= 42 x))))
+  (deftest
+    "let-values multiple binding clauses"
+    (do
+      (let-values
+        (((a b) (values 1 2))
+          ((c d) (values 3 4)))
+        (assert= 10 (+ a b c d)))))
+  (deftest
+    "let-values body is multiple expressions"
+    (do
+      (let-values
+        (((a b) (values 5 6)))
+        (define sum (+ a b))
+        (assert= 11 sum))))
+  (deftest
+    "let-values with no bindings evals body"
+    (do (let-values () (assert= 99 99))))
+  (deftest
+    "define-values binds multiple names"
+    (do
+      (define-values (x y) (values 7 8))
+      (assert= 7 x)
+      (assert= 8 y)))
+  (deftest
+    "define-values three names"
+    (do
+      (define-values (a b c) (values 10 20 30))
+      (assert= 10 a)
+      (assert= 20 b)
+      (assert= 30 c)))
+  (deftest
+    "define-values single name"
+    (do (define-values (n) (values 42)) (assert= 42 n)))
+  (deftest
+    "define-values used in computation"
+    (do
+      (define-values (w h) (values 6 7))
+      (assert= 42 (* w h))))
+  (deftest
+    "values in let binding"
+    (do
+      (let
+        ((v (values 100 200)))
+        (assert= true (get v :_values false))
+        (assert= 100 (first (get v :_list))))))
+  (deftest
+    "call-with-values with swap"
+    (do
+      (define (swap a b) (values b a))
+      (assert=
+        5
+        (call-with-values
+          (fn () (swap 3 5))
+          (fn (first-val second-val) first-val)))))
+  (deftest
+    "let-values from function returning values"
+    (do
+      (define (min-max a b) (values (min a b) (max a b)))
+      (let-values
+        (((lo hi) (min-max 7 3)))
+        (assert= 3 lo)
+        (assert= 7 hi))))
+  (deftest
+    "nested let-values"
+    (do
+      (let-values
+        (((a b) (values 1 2)))
+        (let-values
+          (((c d) (values 3 4)))
+          (assert= 10 (+ a b c d))))))
+  (deftest
+    "call-with-values chained"
+    (do
+      (define
+        result
+        (call-with-values
+          (fn
+            ()
+            (call-with-values
+              (fn () (values 4 6))
+              (fn (a b) (* a b))))
+          (fn (x) x)))
+      (assert= 24 result)))
+  (deftest
+    "values zero args produces dict"
+    (do
+      (let
+        ((v (values)))
+        (assert (dict? v))
+        (assert (get v :_values false))
+        (assert-equal (list) (get v :_list)))))
+  (deftest
+    "let-values strings"
+    (do
+      (let-values
+        (((first-name last-name) (values "Alice" "Smith")))
+        (assert= "Alice Smith" (str first-name " " last-name)))))
+  (deftest
+    "define-values with list values"
+    (do
+      (define-values
+        (head tail)
+        (values 1 (list 2 3 4)))
+      (assert= 1 head)
+      (assert-equal (list 2 3 4) tail))))

spec/tests/test-vectors.sx

@@ -0,0 +1,207 @@
+;; test-vectors.sx — Tests for vector primitives
+
+(defsuite
+  "vectors"
+  (deftest
+    "make-vector default fill is nil"
+    (let
+      ((v (make-vector 3)))
+      (assert (vector? v))
+      (assert-equal 3 (vector-length v))
+      (assert-equal nil (vector-ref v 0))
+      (assert-equal nil (vector-ref v 1))
+      (assert-equal nil (vector-ref v 2))))
+  (deftest
+    "make-vector with fill value"
+    (let
+      ((v (make-vector 4 99)))
+      (assert-equal 4 (vector-length v))
+      (assert-equal 99 (vector-ref v 0))
+      (assert-equal 99 (vector-ref v 1))
+      (assert-equal 99 (vector-ref v 2))
+      (assert-equal 99 (vector-ref v 3))))
+  (deftest
+    "make-vector size zero"
+    (let ((v (make-vector 0))) (assert-equal 0 (vector-length v))))
+  (deftest
+    "make-vector size one"
+    (let
+      ((v (make-vector 1 "x")))
+      (assert-equal 1 (vector-length v))
+      (assert-equal "x" (vector-ref v 0))))
+  (deftest
+    "vector constructor no args"
+    (let ((v (vector))) (assert-equal 0 (vector-length v))))
+  (deftest
+    "vector constructor with args"
+    (let
+      ((v (vector 10 20 30)))
+      (assert-equal 3 (vector-length v))
+      (assert-equal 10 (vector-ref v 0))
+      (assert-equal 20 (vector-ref v 1))
+      (assert-equal 30 (vector-ref v 2))))
+  (deftest
+    "vector constructor strings"
+    (let
+      ((v (vector "a" "b" "c")))
+      (assert-equal "a" (vector-ref v 0))
+      (assert-equal "b" (vector-ref v 1))
+      (assert-equal "c" (vector-ref v 2))))
+  (deftest "vector? true for vector" (assert (vector? (make-vector 3))))
+  (deftest "vector? false for list" (assert (not (vector? (list 1 2 3)))))
+  (deftest "vector? false for number" (assert (not (vector? 42))))
+  (deftest "vector? false for nil" (assert (not (vector? nil))))
+  (deftest "vector? false for string" (assert (not (vector? "hello"))))
+  (deftest "vector-length zero" (assert-equal 0 (vector-length (vector))))
+  (deftest
+    "vector-length three"
+    (assert-equal 3 (vector-length (vector 1 2 3))))
+  (deftest
+    "vector-length after make-vector"
+    (assert-equal 7 (vector-length (make-vector 7 0))))
+  (deftest
+    "vector-ref first element"
+    (assert-equal 1 (vector-ref (vector 1 2 3) 0)))
+  (deftest
+    "vector-ref last element"
+    (assert-equal 3 (vector-ref (vector 1 2 3) 2)))
+  (deftest
+    "vector-ref middle element"
+    (assert-equal 2 (vector-ref (vector 1 2 3) 1)))
+  (deftest
+    "vector-set! mutates in place"
+    (let
+      ((v (vector 1 2 3)))
+      (vector-set! v 1 99)
+      (assert-equal 99 (vector-ref v 1))
+      (assert-equal 1 (vector-ref v 0))
+      (assert-equal 3 (vector-ref v 2))))
+  (deftest
+    "vector-set! first slot"
+    (let
+      ((v (make-vector 3 0)))
+      (vector-set! v 0 42)
+      (assert-equal 42 (vector-ref v 0))))
+  (deftest
+    "vector-set! last slot"
+    (let
+      ((v (make-vector 3 0)))
+      (vector-set! v 2 77)
+      (assert-equal 77 (vector-ref v 2))))
+  (deftest
+    "vector-set! returns nil"
+    (let ((v (make-vector 3 0))) (assert-equal nil (vector-set! v 0 1))))
+  (deftest
+    "vector->list empty"
+    (assert-equal (list) (vector->list (vector))))
+  (deftest
+    "vector->list numbers"
+    (assert-equal (list 1 2 3) (vector->list (vector 1 2 3))))
+  (deftest
+    "vector->list strings"
+    (assert-equal (list "a" "b") (vector->list (vector "a" "b"))))
+  (deftest
+    "list->vector empty"
+    (let ((v (list->vector (list)))) (assert-equal 0 (vector-length v))))
+  (deftest
+    "list->vector numbers"
+    (let
+      ((v (list->vector (list 10 20 30))))
+      (assert-equal 3 (vector-length v))
+      (assert-equal 10 (vector-ref v 0))
+      (assert-equal 20 (vector-ref v 1))
+      (assert-equal 30 (vector-ref v 2))))
+  (deftest
+    "vector-fill! sets all elements"
+    (let
+      ((v (vector 1 2 3)))
+      (vector-fill! v 0)
+      (assert-equal 0 (vector-ref v 0))
+      (assert-equal 0 (vector-ref v 1))
+      (assert-equal 0 (vector-ref v 2))))
+  (deftest
+    "vector-fill! returns nil"
+    (assert-equal nil (vector-fill! (make-vector 2 0) 7)))
+  (deftest
+    "vector-fill! string fill"
+    (let
+      ((v (make-vector 3 "")))
+      (vector-fill! v "x")
+      (assert-equal "x" (vector-ref v 0))
+      (assert-equal "x" (vector-ref v 2))))
+  (deftest
+    "vector-copy full copy"
+    (let
+      ((v1 (vector 1 2 3)) (v2 (vector-copy (vector 1 2 3))))
+      (assert-equal 3 (vector-length v2))
+      (assert-equal 1 (vector-ref v2 0))
+      (assert-equal 2 (vector-ref v2 1))
+      (assert-equal 3 (vector-ref v2 2))))
+  (deftest
+    "vector-copy is independent"
+    (let
+      ((v1 (vector 1 2 3)))
+      (let
+        ((v2 (vector-copy v1)))
+        (vector-set! v1 0 99)
+        (assert-equal 1 (vector-ref v2 0)))))
+  (deftest
+    "vector-copy with start"
+    (let
+      ((v (vector-copy (vector 10 20 30 40) 1)))
+      (assert-equal 3 (vector-length v))
+      (assert-equal 20 (vector-ref v 0))
+      (assert-equal 30 (vector-ref v 1))
+      (assert-equal 40 (vector-ref v 2))))
+  (deftest
+    "vector-copy with start and end"
+    (let
+      ((v (vector-copy (vector 10 20 30 40) 1 3)))
+      (assert-equal 2 (vector-length v))
+      (assert-equal 20 (vector-ref v 0))
+      (assert-equal 30 (vector-ref v 1))))
+  (deftest
+    "vector-copy empty slice"
+    (let
+      ((v (vector-copy (vector 1 2 3) 1 1)))
+      (assert-equal 0 (vector-length v))))
+  (deftest
+    "vector-ref out of bounds raises"
+    (let
+      ((ok false))
+      (guard (exn (else (set! ok true))) (vector-ref (vector 1 2 3) 5))
+      (assert ok)))
+  (deftest
+    "vector-ref negative index raises"
+    (let
+      ((ok false))
+      (guard (exn (else (set! ok true))) (vector-ref (vector 1 2 3) -1))
+      (assert ok)))
+  (deftest
+    "vector-set! out of bounds raises"
+    (let
+      ((ok false))
+      (guard
+        (exn (else (set! ok true)))
+        (vector-set! (vector 1 2 3) 10 99))
+      (assert ok)))
+  (deftest
+    "vector list round-trip"
+    (let
+      ((lst (list 5 10 15 20)))
+      (assert-equal lst (vector->list (list->vector lst)))))
+  (deftest
+    "vector mutation does not affect copy"
+    (let
+      ((v1 (vector 1 2 3)))
+      (let
+        ((v2 (vector-copy v1)))
+        (vector-set! v2 0 100)
+        (assert-equal 1 (vector-ref v1 0))
+        (assert-equal 100 (vector-ref v2 0)))))
+  (deftest
+    "vector-length after fill"
+    (let
+      ((v (make-vector 5 0)))
+      (vector-fill! v 1)
+      (assert-equal 5 (vector-length v)))))

spec/tests/test.sx

@@ -1,195 +1,156 @@
 ;; ==========================================================================
 ;; test.sx — Self-hosting SX test suite (backward-compatible entry point)
-;;
-;; This file includes the test framework and core eval tests inline.
-;; It exists for backward compatibility — runners that load "test.sx"
-;; get the same 81 tests as before.
-;;
-;; For modular testing, runners should instead load:
-;;   1. test-framework.sx  (macros + assertions)
-;;   2. One or more test specs: test-eval.sx, test-parser.sx,
-;;      test-router.sx, test-render.sx, etc.
-;;
-;; Platform functions required:
-;;   try-call     (thunk)        -> {:ok true} | {:ok false :error "msg"}
-;;   report-pass  (name)         -> platform-specific pass output
-;;   report-fail  (name error)   -> platform-specific fail output
-;;   push-suite   (name)         -> push suite name onto context stack
-;;   pop-suite    ()             -> pop suite name from context stack
-;;
-;; Usage:
-;;   ;; Host injects platform functions into env, then:
-;;   (eval-file "test.sx" env)
-;;
-;; The same test.sx runs on every host — Python, JavaScript, etc.
 ;; ==========================================================================
 
+(defmacro
+  deftest
+  (name &rest body)
+  (quasiquote
+    (let
+      ((result (try-call (fn () (splice-unquote body)))))
+      (if
+        (get result "ok")
+        (report-pass (unquote name))
+        (report-fail (unquote name) (get result "error"))))))
 
-;; --------------------------------------------------------------------------
-;; 1. Test framework macros
-;; --------------------------------------------------------------------------
-;;
-;; deftest and defsuite are macros that make test.sx directly executable.
-;; The host provides try-call (error catching), reporting, and suite
-;; context — everything else is pure SX.
+(defmacro
+  defsuite
+  (name &rest items)
+  (quasiquote
+    (do (push-suite (unquote name)) (splice-unquote items) (pop-suite))))
 
-(defmacro deftest (name &rest body)
-  `(let ((result (try-call (fn () ,@body))))
-     (if (get result "ok")
-       (report-pass ,name)
-       (report-fail ,name (get result "error")))))
-
-(defmacro defsuite (name &rest items)
-  `(do (push-suite ,name)
-       ,@items
-       (pop-suite)))
-
-
-;; --------------------------------------------------------------------------
-;; 2. Assertion helpers — defined in SX, available in test bodies
-;; --------------------------------------------------------------------------
-;;
-;; These are regular functions (not special forms). They use the `assert`
-;; primitive underneath but provide better error messages.
-
-(define assert-equal
-  (fn (expected actual)
-    (assert (equal? expected actual)
+(define
+  assert-equal
+  (fn
+    (expected actual)
+    (assert
+      (equal? expected actual)
       (str "Expected " (str expected) " but got " (str actual)))))
 
-(define assert-not-equal
-  (fn (a b)
-    (assert (not (equal? a b))
+(define
+  assert-not-equal
+  (fn
+    (a b)
+    (assert
+      (not (equal? a b))
       (str "Expected values to differ but both are " (str a)))))
 
-(define assert-true
-  (fn (val)
-    (assert val (str "Expected truthy but got " (str val)))))
+(define
+  assert-true
+  (fn (val) (assert val (str "Expected truthy but got " (str val)))))
 
-(define assert-false
-  (fn (val)
-    (assert (not val) (str "Expected falsy but got " (str val)))))
+(define
+  assert-false
+  (fn (val) (assert (not val) (str "Expected falsy but got " (str val)))))
 
-(define assert-nil
-  (fn (val)
-    (assert (nil? val) (str "Expected nil but got " (str val)))))
+(define
+  assert-nil
+  (fn (val) (assert (nil? val) (str "Expected nil but got " (str val)))))
 
-(define assert-type
-  (fn (expected-type val)
-    ;; Implemented via predicate dispatch since type-of is a platform
-    ;; function not available in all hosts. Uses nested if to avoid
-    ;; Scheme-style cond detection for 2-element predicate calls.
-    ;; Boolean checked before number (subtypes on some platforms).
-    (let ((actual-type
-            (if (nil? val) "nil"
-              (if (boolean? val) "boolean"
-                (if (number? val) "number"
-                  (if (string? val) "string"
-                    (if (list? val) "list"
-                      (if (dict? val) "dict"
-                        "unknown"))))))))
-      (assert (= expected-type actual-type)
+(define
+  assert-type
+  (fn
+    (expected-type val)
+    (let
+      ((actual-type (if (nil? val) "nil" (if (boolean? val) "boolean" (if (number? val) "number" (if (string? val) "string" (if (list? val) "list" (if (dict? val) "dict" "unknown"))))))))
+      (assert
+        (= expected-type actual-type)
         (str "Expected type " expected-type " but got " actual-type)))))
 
-(define assert-length
-  (fn (expected-len col)
-    (assert (= (len col) expected-len)
+(define
+  assert-length
+  (fn
+    (expected-len col)
+    (assert
+      (= (len col) expected-len)
       (str "Expected length " expected-len " but got " (len col)))))
 
-(define assert-contains
-  (fn (item col)
-    (assert (some (fn (x) (equal? x item)) col)
+(define
+  assert-contains
+  (fn
+    (item col)
+    (assert
+      (some (fn (x) (equal? x item)) col)
       (str "Expected collection to contain " (str item)))))
 
-(define assert-throws
-  (fn (thunk)
-    (let ((result (try-call thunk)))
-      (assert (not (get result "ok"))
+(define
+  assert-throws
+  (fn
+    (thunk)
+    (let
+      ((result (try-call thunk)))
+      (assert
+        (not (get result "ok"))
         "Expected an error to be thrown but none was"))))
 
-
-;; ==========================================================================
-;; 3. Test suites — SX testing SX
-;; ==========================================================================
-
-
-;; --------------------------------------------------------------------------
-;; 3a. Literals and types
-;; --------------------------------------------------------------------------
-
-(defsuite "literals"
-  (deftest "numbers are numbers"
+(defsuite
+  "literals"
+  (deftest
+    "numbers are numbers"
     (assert-type "number" 42)
     (assert-type "number" 3.14)
     (assert-type "number" -1))
-
-  (deftest "strings are strings"
+  (deftest
+    "strings are strings"
     (assert-type "string" "hello")
     (assert-type "string" ""))
-
-  (deftest "booleans are booleans"
+  (deftest
+    "booleans are booleans"
     (assert-type "boolean" true)
     (assert-type "boolean" false))
-
-  (deftest "nil is nil"
-    (assert-type "nil" nil)
-    (assert-nil nil))
-
-  (deftest "lists are lists"
+  (deftest "nil is nil" (assert-type "nil" nil) (assert-nil nil))
+  (deftest
+    "lists are lists"
     (assert-type "list" (list 1 2 3))
     (assert-type "list" (list)))
+  (deftest "dicts are dicts" (assert-type "dict" {:b 2 :a 1})))
 
-  (deftest "dicts are dicts"
-    (assert-type "dict" {:a 1 :b 2})))
-
-
-;; --------------------------------------------------------------------------
-;; 3b. Arithmetic
-;; --------------------------------------------------------------------------
-
-(defsuite "arithmetic"
-  (deftest "addition"
+(defsuite
+  "arithmetic"
+  (deftest
+    "addition"
     (assert-equal 3 (+ 1 2))
     (assert-equal 0 (+ 0 0))
     (assert-equal -1 (+ 1 -2))
     (assert-equal 10 (+ 1 2 3 4)))
-
-  (deftest "subtraction"
+  (deftest
+    "subtraction"
     (assert-equal 1 (- 3 2))
     (assert-equal -1 (- 2 3)))
-
-  (deftest "multiplication"
+  (deftest
+    "multiplication"
     (assert-equal 6 (* 2 3))
     (assert-equal 0 (* 0 100))
     (assert-equal 24 (* 1 2 3 4)))
-
-  (deftest "division"
+  (deftest
+    "division"
     (assert-equal 2 (/ 6 3))
     (assert-equal 2.5 (/ 5 2)))
-
-  (deftest "modulo"
+  (deftest
+    "modulo"
     (assert-equal 1 (mod 7 3))
     (assert-equal 0 (mod 6 3))))
 
-
-;; --------------------------------------------------------------------------
-;; 3c. Comparison
-;; --------------------------------------------------------------------------
-
-(defsuite "comparison"
-  (deftest "equality"
+(defsuite
+  "comparison"
+  (deftest
+    "equality"
     (assert-true (= 1 1))
     (assert-false (= 1 2))
     (assert-true (= "a" "a"))
     (assert-false (= "a" "b")))
-
-  (deftest "deep equality"
-    (assert-true (equal? (list 1 2 3) (list 1 2 3)))
-    (assert-false (equal? (list 1 2) (list 1 3)))
+  (deftest
+    "deep equality"
+    (assert-true
+      (equal?
+        (list 1 2 3)
+        (list 1 2 3)))
+    (assert-false
+      (equal? (list 1 2) (list 1 3)))
     (assert-true (equal? {:a 1} {:a 1}))
     (assert-false (equal? {:a 1} {:a 2})))
-
-  (deftest "ordering"
+  (deftest
+    "ordering"
     (assert-true (< 1 2))
     (assert-false (< 2 1))
     (assert-true (> 2 1))
@@ -198,405 +159,418 @@
     (assert-true (>= 2 2))
     (assert-true (>= 3 2))))
 
-
-;; --------------------------------------------------------------------------
-;; 3d. String operations
-;; --------------------------------------------------------------------------
-
-(defsuite "strings"
-  (deftest "str concatenation"
+(defsuite
+  "strings"
+  (deftest
+    "str concatenation"
     (assert-equal "abc" (str "a" "b" "c"))
     (assert-equal "hello world" (str "hello" " " "world"))
     (assert-equal "42" (str 42))
     (assert-equal "" (str)))
-
-  (deftest "string-length"
+  (deftest
+    "string-length"
     (assert-equal 5 (string-length "hello"))
     (assert-equal 0 (string-length "")))
-
-  (deftest "substring"
+  (deftest
+    "substring"
     (assert-equal "ell" (substring "hello" 1 4))
     (assert-equal "hello" (substring "hello" 0 5)))
-
-  (deftest "string-contains?"
+  (deftest
+    "string-contains?"
     (assert-true (string-contains? "hello world" "world"))
     (assert-false (string-contains? "hello" "xyz")))
-
-  (deftest "upcase and downcase"
+  (deftest
+    "upcase and downcase"
     (assert-equal "HELLO" (upcase "hello"))
     (assert-equal "hello" (downcase "HELLO")))
-
-  (deftest "trim"
+  (deftest
+    "trim"
     (assert-equal "hello" (trim "  hello  "))
     (assert-equal "hello" (trim "hello")))
-
-  (deftest "split and join"
+  (deftest
+    "split and join"
     (assert-equal (list "a" "b" "c") (split "a,b,c" ","))
     (assert-equal "a-b-c" (join "-" (list "a" "b" "c")))))
 
-
-;; --------------------------------------------------------------------------
-;; 3e. List operations
-;; --------------------------------------------------------------------------
-
-(defsuite "lists"
-  (deftest "constructors"
-    (assert-equal (list 1 2 3) (list 1 2 3))
+(defsuite
+  "lists"
+  (deftest
+    "constructors"
+    (assert-equal
+      (list 1 2 3)
+      (list 1 2 3))
     (assert-equal (list) (list))
     (assert-length 3 (list 1 2 3)))
-
-  (deftest "first and rest"
+  (deftest
+    "first and rest"
     (assert-equal 1 (first (list 1 2 3)))
-    (assert-equal (list 2 3) (rest (list 1 2 3)))
+    (assert-equal
+      (list 2 3)
+      (rest (list 1 2 3)))
     (assert-nil (first (list)))
     (assert-equal (list) (rest (list))))
-
-  (deftest "nth"
-    (assert-equal 1 (nth (list 1 2 3) 0))
-    (assert-equal 2 (nth (list 1 2 3) 1))
-    (assert-equal 3 (nth (list 1 2 3) 2)))
-
-  (deftest "last"
+  (deftest
+    "nth"
+    (assert-equal
+      1
+      (nth (list 1 2 3) 0))
+    (assert-equal
+      2
+      (nth (list 1 2 3) 1))
+    (assert-equal
+      3
+      (nth (list 1 2 3) 2)))
+  (deftest
+    "last"
     (assert-equal 3 (last (list 1 2 3)))
     (assert-nil (last (list))))
-
-  (deftest "cons and append"
-    (assert-equal (list 0 1 2) (cons 0 (list 1 2)))
-    (assert-equal (list 1 2 3 4) (append (list 1 2) (list 3 4))))
-
-  (deftest "reverse"
-    (assert-equal (list 3 2 1) (reverse (list 1 2 3)))
+  (deftest
+    "cons and append"
+    (assert-equal
+      (list 0 1 2)
+      (cons 0 (list 1 2)))
+    (assert-equal
+      (list 1 2 3 4)
+      (append (list 1 2) (list 3 4))))
+  (deftest
+    "reverse"
+    (assert-equal
+      (list 3 2 1)
+      (reverse (list 1 2 3)))
     (assert-equal (list) (reverse (list))))
-
-  (deftest "empty?"
+  (deftest
+    "empty?"
     (assert-true (empty? (list)))
     (assert-false (empty? (list 1))))
-
-  (deftest "len"
+  (deftest
+    "len"
     (assert-equal 0 (len (list)))
     (assert-equal 3 (len (list 1 2 3))))
+  (deftest
+    "contains?"
+    (assert-true
+      (contains? (list 1 2 3) 2))
+    (assert-false
+      (contains? (list 1 2 3) 4)))
+  (deftest
+    "flatten"
+    (assert-equal
+      (list 1 2 3 4)
+      (flatten
+        (list (list 1 2) (list 3 4))))))
 
-  (deftest "contains?"
-    (assert-true (contains? (list 1 2 3) 2))
-    (assert-false (contains? (list 1 2 3) 4)))
-
-  (deftest "flatten"
-    (assert-equal (list 1 2 3 4) (flatten (list (list 1 2) (list 3 4))))))
-
-
-;; --------------------------------------------------------------------------
-;; 3f. Dict operations
-;; --------------------------------------------------------------------------
-
-(defsuite "dicts"
-  (deftest "dict literal"
-    (assert-type "dict" {:a 1 :b 2})
+(defsuite
+  "dicts"
+  (deftest
+    "dict literal"
+    (assert-type "dict" {:b 2 :a 1})
     (assert-equal 1 (get {:a 1} "a"))
-    (assert-equal 2 (get {:a 1 :b 2} "b")))
-
-  (deftest "assoc"
-    (assert-equal {:a 1 :b 2} (assoc {:a 1} "b" 2))
+    (assert-equal 2 (get {:b 2 :a 1} "b")))
+  (deftest
+    "assoc"
+    (assert-equal {:b 2 :a 1} (assoc {:a 1} "b" 2))
     (assert-equal {:a 99} (assoc {:a 1} "a" 99)))
-
-  (deftest "dissoc"
-    (assert-equal {:b 2} (dissoc {:a 1 :b 2} "a")))
-
-  (deftest "keys and vals"
-    (let ((d {:a 1 :b 2}))
+  (deftest "dissoc" (assert-equal {:b 2} (dissoc {:b 2 :a 1} "a")))
+  (deftest
+    "keys and vals"
+    (let
+      ((d {:b 2 :a 1}))
       (assert-length 2 (keys d))
       (assert-length 2 (vals d))
       (assert-contains "a" (keys d))
       (assert-contains "b" (keys d))))
-
-  (deftest "has-key?"
+  (deftest
+    "has-key?"
     (assert-true (has-key? {:a 1} "a"))
     (assert-false (has-key? {:a 1} "b")))
+  (deftest
+    "merge"
+    (assert-equal {:c 3 :b 2 :a 1} (merge {:b 2 :a 1} {:c 3}))
+    (assert-equal {:b 2 :a 99} (merge {:b 2 :a 1} {:a 99}))))
 
-  (deftest "merge"
-    (assert-equal {:a 1 :b 2 :c 3}
-      (merge {:a 1 :b 2} {:c 3}))
-    (assert-equal {:a 99 :b 2}
-      (merge {:a 1 :b 2} {:a 99}))))
-
-
-;; --------------------------------------------------------------------------
-;; 3g. Predicates
-;; --------------------------------------------------------------------------
-
-(defsuite "predicates"
-  (deftest "nil?"
+(defsuite
+  "predicates"
+  (deftest
+    "nil?"
     (assert-true (nil? nil))
     (assert-false (nil? 0))
     (assert-false (nil? false))
     (assert-false (nil? "")))
-
-  (deftest "number?"
+  (deftest
+    "number?"
     (assert-true (number? 42))
     (assert-true (number? 3.14))
     (assert-false (number? "42")))
-
-  (deftest "string?"
+  (deftest
+    "string?"
     (assert-true (string? "hello"))
     (assert-false (string? 42)))
-
-  (deftest "list?"
+  (deftest
+    "list?"
     (assert-true (list? (list 1 2)))
     (assert-false (list? "not a list")))
-
-  (deftest "dict?"
+  (deftest
+    "dict?"
     (assert-true (dict? {:a 1}))
     (assert-false (dict? (list 1))))
-
-  (deftest "boolean?"
+  (deftest
+    "boolean?"
     (assert-true (boolean? true))
     (assert-true (boolean? false))
     (assert-false (boolean? nil))
     (assert-false (boolean? 0)))
-
-  (deftest "not"
+  (deftest
+    "not"
     (assert-true (not false))
     (assert-true (not nil))
     (assert-false (not true))
     (assert-false (not 1))
     (assert-false (not "x"))))
 
-
-;; --------------------------------------------------------------------------
-;; 3h. Special forms
-;; --------------------------------------------------------------------------
-
-(defsuite "special-forms"
-  (deftest "if"
+(defsuite
+  "special-forms"
+  (deftest
+    "if"
     (assert-equal "yes" (if true "yes" "no"))
     (assert-equal "no" (if false "yes" "no"))
     (assert-equal "no" (if nil "yes" "no"))
     (assert-nil (if false "yes")))
-
-  (deftest "when"
+  (deftest
+    "when"
     (assert-equal "yes" (when true "yes"))
     (assert-nil (when false "yes")))
-
-  (deftest "cond"
+  (deftest
+    "cond"
     (assert-equal "a" (cond true "a" :else "b"))
     (assert-equal "b" (cond false "a" :else "b"))
-    (assert-equal "c" (cond
-                        false "a"
-                        false "b"
-                        :else "c")))
-
-  (deftest "and"
+    (assert-equal "c" (cond false "a" false "b" :else "c")))
+  (deftest
+    "and"
     (assert-true (and true true))
     (assert-false (and true false))
     (assert-false (and false true))
     (assert-equal 3 (and 1 2 3)))
-
-  (deftest "or"
+  (deftest
+    "or"
     (assert-equal 1 (or 1 2))
     (assert-equal 2 (or false 2))
     (assert-equal "fallback" (or nil false "fallback"))
     (assert-false (or false false)))
-
-  (deftest "let"
-    (assert-equal 3 (let ((x 1) (y 2)) (+ x y)))
-    (assert-equal "hello world"
+  (deftest
+    "let"
+    (assert-equal
+      3
+      (let ((x 1) (y 2)) (+ x y)))
+    (assert-equal
+      "hello world"
       (let ((a "hello") (b " world")) (str a b))))
-
-  (deftest "let clojure-style"
+  (deftest
+    "let clojure-style"
     (assert-equal 3 (let (x 1 y 2) (+ x y))))
-
-  (deftest "do / begin"
+  (deftest
+    "do / begin"
     (assert-equal 3 (do 1 2 3))
     (assert-equal "last" (begin "first" "middle" "last")))
-
-  (deftest "define"
-    (define x 42)
-    (assert-equal 42 x))
-
-  (deftest "set!"
+  (deftest "define" (define x 42) (assert-equal 42 x))
+  (deftest
+    "set!"
     (define x 1)
     (set! x 2)
     (assert-equal 2 x)))
 
-
-;; --------------------------------------------------------------------------
-;; 3i. Lambda and closures
-;; --------------------------------------------------------------------------
-
-(defsuite "lambdas"
-  (deftest "basic lambda"
-    (let ((add (fn (a b) (+ a b))))
+(defsuite
+  "lambdas"
+  (deftest
+    "basic lambda"
+    (let
+      ((add (fn (a b) (+ a b))))
       (assert-equal 3 (add 1 2))))
-
-  (deftest "closure captures env"
-    (let ((x 10))
-      (let ((add-x (fn (y) (+ x y))))
+  (deftest
+    "closure captures env"
+    (let
+      ((x 10))
+      (let
+        ((add-x (fn (y) (+ x y))))
         (assert-equal 15 (add-x 5)))))
-
-  (deftest "lambda as argument"
-    (assert-equal (list 2 4 6)
-      (map (fn (x) (* x 2)) (list 1 2 3))))
-
-  (deftest "recursive lambda via define"
-    (define factorial
-      (fn (n) (if (<= n 1) 1 (* n (factorial (- n 1))))))
+  (deftest
+    "lambda as argument"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (list 1 2 3))))
+  (deftest
+    "recursive lambda via define"
+    (define
+      factorial
+      (fn
+        (n)
+        (if
+          (<= n 1)
+          1
+          (* n (factorial (- n 1))))))
     (assert-equal 120 (factorial 5)))
-
-  (deftest "higher-order returns lambda"
-    (let ((make-adder (fn (n) (fn (x) (+ n x)))))
-      (let ((add5 (make-adder 5)))
+  (deftest
+    "higher-order returns lambda"
+    (let
+      ((make-adder (fn (n) (fn (x) (+ n x)))))
+      (let
+        ((add5 (make-adder 5)))
         (assert-equal 8 (add5 3))))))
 
-
-;; --------------------------------------------------------------------------
-;; 3j. Higher-order forms
-;; --------------------------------------------------------------------------
-
-(defsuite "higher-order"
-  (deftest "map"
-    (assert-equal (list 2 4 6)
-      (map (fn (x) (* x 2)) (list 1 2 3)))
+(defsuite
+  "higher-order"
+  (deftest
+    "map"
+    (assert-equal
+      (list 2 4 6)
+      (map
+        (fn (x) (* x 2))
+        (list 1 2 3)))
     (assert-equal (list) (map (fn (x) x) (list))))
-
-  (deftest "filter"
-    (assert-equal (list 2 4)
-      (filter (fn (x) (= (mod x 2) 0)) (list 1 2 3 4)))
-    (assert-equal (list)
+  (deftest
+    "filter"
+    (assert-equal
+      (list 2 4)
+      (filter
+        (fn (x) (= (mod x 2) 0))
+        (list 1 2 3 4)))
+    (assert-equal
+      (list)
       (filter (fn (x) false) (list 1 2 3))))
-
-  (deftest "reduce"
-    (assert-equal 10 (reduce (fn (acc x) (+ acc x)) 0 (list 1 2 3 4)))
-    (assert-equal 0 (reduce (fn (acc x) (+ acc x)) 0 (list))))
-
-  (deftest "some"
-    (assert-true (some (fn (x) (> x 3)) (list 1 2 3 4 5)))
-    (assert-false (some (fn (x) (> x 10)) (list 1 2 3))))
-
-  (deftest "every?"
-    (assert-true (every? (fn (x) (> x 0)) (list 1 2 3)))
-    (assert-false (every? (fn (x) (> x 2)) (list 1 2 3))))
-
-  (deftest "map-indexed"
-    (assert-equal (list "0:a" "1:b" "2:c")
+  (deftest
+    "reduce"
+    (assert-equal
+      10
+      (reduce
+        (fn (acc x) (+ acc x))
+        0
+        (list 1 2 3 4)))
+    (assert-equal
+      0
+      (reduce (fn (acc x) (+ acc x)) 0 (list))))
+  (deftest
+    "some"
+    (assert-true
+      (some
+        (fn (x) (> x 3))
+        (list 1 2 3 4 5)))
+    (assert-false
+      (some
+        (fn (x) (> x 10))
+        (list 1 2 3))))
+  (deftest
+    "every?"
+    (assert-true
+      (every?
+        (fn (x) (> x 0))
+        (list 1 2 3)))
+    (assert-false
+      (every?
+        (fn (x) (> x 2))
+        (list 1 2 3))))
+  (deftest
+    "map-indexed"
+    (assert-equal
+      (list "0:a" "1:b" "2:c")
       (map-indexed (fn (i x) (str i ":" x)) (list "a" "b" "c")))))
 
-
-;; --------------------------------------------------------------------------
-;; 3k. Components
-;; --------------------------------------------------------------------------
-
-(defsuite "components"
-  (deftest "defcomp creates component"
-    (defcomp ~test-comp (&key title)
-      (div title))
-    ;; Component is bound and not nil
+(defsuite
+  "components"
+  (deftest
+    "defcomp creates component"
+    (defcomp ~test-comp (&key title) (div title))
     (assert-true (not (nil? ~test-comp))))
-
-  (deftest "component renders with keyword args"
-    (defcomp ~greeting (&key name)
-      (span (str "Hello, " name "!")))
+  (deftest
+    "component renders with keyword args"
+    (defcomp ~greeting (&key name) (span (str "Hello, " name "!")))
     (assert-true (not (nil? ~greeting))))
-
-  (deftest "component with children"
-    (defcomp ~box (&key &rest children)
-      (div :class "box" children))
+  (deftest
+    "component with children"
+    (defcomp ~box (&key &rest children) (div :class "box" children))
     (assert-true (not (nil? ~box))))
-
-  (deftest "component with default via or"
-    (defcomp ~label (&key text)
-      (span (or text "default")))
+  (deftest
+    "component with default via or"
+    (defcomp ~label (&key text) (span (or text "default")))
     (assert-true (not (nil? ~label)))))
 
-
-;; --------------------------------------------------------------------------
-;; 3l. Macros
-;; --------------------------------------------------------------------------
-
-(defsuite "macros"
-  (deftest "defmacro creates macro"
-    (defmacro unless (cond &rest body)
-      `(if (not ,cond) (do ,@body)))
+(defsuite
+  "macros"
+  (deftest
+    "defmacro creates macro"
+    (defmacro
+      unless
+      (cond &rest body)
+      (quasiquote (if (not (unquote cond)) (do (splice-unquote body)))))
     (assert-equal "yes" (unless false "yes"))
     (assert-nil (unless true "no")))
+  (deftest
+    "quasiquote and unquote"
+    (let
+      ((x 42))
+      (assert-equal
+        (list 1 42 3)
+        (quasiquote (1 (unquote x) 3)))))
+  (deftest
+    "splice-unquote"
+    (let
+      ((xs (list 2 3 4)))
+      (assert-equal
+        (list 1 2 3 4 5)
+        (quasiquote (1 (splice-unquote xs) 5))))))
 
-  (deftest "quasiquote and unquote"
-    (let ((x 42))
-      (assert-equal (list 1 42 3) `(1 ,x 3))))
-
-  (deftest "splice-unquote"
-    (let ((xs (list 2 3 4)))
-      (assert-equal (list 1 2 3 4 5) `(1 ,@xs 5)))))
-
-
-;; --------------------------------------------------------------------------
-;; 3m. Threading macro
-;; --------------------------------------------------------------------------
-
-(defsuite "threading"
-  (deftest "thread-first"
+(defsuite
+  "threading"
+  (deftest
+    "thread-first"
     (assert-equal 8 (-> 5 (+ 1) (+ 2)))
     (assert-equal "HELLO" (-> "hello" upcase))
-    (assert-equal "HELLO WORLD"
-      (-> "hello"
-          (str " world")
-          upcase))))
+    (assert-equal "HELLO WORLD" (-> "hello" (str " world") upcase))))
 
-
-;; --------------------------------------------------------------------------
-;; 3n. Truthiness
-;; --------------------------------------------------------------------------
-
-(defsuite "truthiness"
-  (deftest "truthy values"
+(defsuite
+  "truthiness"
+  (deftest
+    "truthy values"
     (assert-true (if 1 true false))
     (assert-true (if "x" true false))
     (assert-true (if (list 1) true false))
     (assert-true (if true true false)))
-
-  (deftest "falsy values"
+  (deftest
+    "falsy values"
     (assert-false (if false true false))
-    (assert-false (if nil true false)))
+    (assert-false (if nil true false))))
 
-  ;; NOTE: empty list, zero, and empty string truthiness is
-  ;; platform-dependent. Python treats all three as falsy.
-  ;; JavaScript treats [] as truthy but 0 and "" as falsy.
-  ;; These tests are omitted — each bootstrapper should emit
-  ;; platform-specific truthiness tests instead.
-  )
-
-
-;; --------------------------------------------------------------------------
-;; 3o. Edge cases and regression tests
-;; --------------------------------------------------------------------------
-
-(defsuite "edge-cases"
-  (deftest "nested let scoping"
-    (let ((x 1))
-      (let ((x 2))
-        (assert-equal 2 x))
-      ;; outer x should be unchanged by inner let
-      ;; (this tests that let creates a new scope)
-      ))
-
-  (deftest "recursive map"
-    (assert-equal (list (list 2 4) (list 6 8))
-      (map (fn (sub) (map (fn (x) (* x 2)) sub))
+(defsuite
+  "edge-cases"
+  (deftest
+    "nested let scoping"
+    (let
+      ((x 1))
+      (let ((x 2)) (assert-equal 2 x))))
+  (deftest
+    "recursive map"
+    (assert-equal
+      (list (list 2 4) (list 6 8))
+      (map
+        (fn (sub) (map (fn (x) (* x 2)) sub))
         (list (list 1 2) (list 3 4)))))
-
-  (deftest "keyword as value"
+  (deftest
+    "keyword as value"
     (assert-equal "class" :class)
     (assert-equal "id" :id))
-
-  (deftest "dict with evaluated values"
-    (let ((x 42))
-      (assert-equal 42 (get {:val x} "val"))))
-
-  (deftest "nil propagation"
+  (deftest
+    "dict with evaluated values"
+    (let ((x 42)) (assert-equal 42 (get {:val x} "val"))))
+  (deftest
+    "nil propagation"
     (assert-nil (get {:a 1} "missing"))
     (assert-equal "default" (or (get {:a 1} "missing") "default")))
-
-  (deftest "empty operations"
+  (deftest
+    "empty operations"
     (assert-equal (list) (map (fn (x) x) (list)))
     (assert-equal (list) (filter (fn (x) true) (list)))
-    (assert-equal 0 (reduce (fn (acc x) (+ acc x)) 0 (list)))
+    (assert-equal
+      0
+      (reduce (fn (acc x) (+ acc x)) 0 (list)))
     (assert-equal 0 (len (list)))
     (assert-equal "" (str))))

tests/playwright/generate-sx-tests.py

@@ -2333,6 +2333,25 @@ def generate_eval_only_test(test, idx):
         hs_expr = extract_hs_expr(m.group(2))
         assertions.append(f'    (assert-throws (eval-hs "{hs_expr}"))')
 
+    # Pattern 4: eval-hs-error — expect(await error("expr")).toBe("msg")
+    # These test that running HS raises an error with a specific message string.
+    for m in re.finditer(
+        r'(?:const\s+\w+\s*=\s*)?(?:await\s+)?error\((["\x27`])(.+?)\1\)'
+        r'(?:[^;]|\n)*?(?:expect\([^)]*\)\.toBe\(([^)]+)\)|\.toBe\(([^)]+)\))',
+        body, re.DOTALL
+    ):
+        hs_expr = extract_hs_expr(m.group(2))
+        expected_raw = (m.group(3) or m.group(4) or '').strip()
+        # Strip only the outermost JS string delimiter (double or single quote)
+        # without touching inner quotes inside the string value.
+        if len(expected_raw) >= 2 and expected_raw[0] == expected_raw[-1] and expected_raw[0] in ('"', "'"):
+            inner = expected_raw[1:-1]
+            expected_sx = '"' + inner.replace('\\', '\\\\').replace('"', '\\"') + '"'
+        else:
+            expected_sx = js_val_to_sx(expected_raw)
+        hs_escaped = hs_expr.replace('\\', '\\\\').replace('"', '\\"')
+        assertions.append(f'    (assert= (eval-hs-error "{hs_escaped}") {expected_sx})')
+
     if not assertions:
         return None  # Can't convert this body pattern
 
@@ -2692,6 +2711,27 @@ output.append('                (nth _e 1)')
 output.append('                (raise _e))))')
 output.append('          (handler me-val))))))')
 output.append('')
+output.append(';; Evaluate a hyperscript expression, catch the first error raised, and')
+output.append(';; return its message string. Used by runtimeErrors tests.')
+output.append(';; Returns nil if no error is raised (test would then fail equality).')
+output.append('(define eval-hs-error')
+output.append('  (fn (src)')
+output.append('    (let ((sx (hs-to-sx (hs-compile src))))')
+output.append('      (let ((handler (eval-expr-cek')
+output.append('              (list (quote fn) (list (quote me))')
+output.append('                (list (quote let) (list (list (quote it) nil) (list (quote event) nil)) sx)))))')
+output.append('        (guard')
+output.append('          (_e')
+output.append('            (true')
+output.append('              (if')
+output.append('                (string? _e)')
+output.append('                _e')
+output.append('                (if')
+output.append('                  (and (list? _e) (= (first _e) "hs-return"))')
+output.append('                  nil')
+output.append('                  (str _e)))))')
+output.append('          (begin (handler nil) nil))))))')
+output.append('')
 
 # Group by category
 categories = OrderedDict()