Merge architecture into loops/forth

lib/apl/runtime.sx (60 forms):
- Core: apl-iota (1..N), apl-rho (shape), apl-at (1-indexed access).
- Rank-polymorphic apl-dyadic/apl-monadic helpers: scalar×scalar,
  scalar×vector, vector×vector all supported uniformly.
- Arithmetic: add/sub/mul/div/mod/pow/max/min, neg/abs/floor/ceil/sqrt.
- Comparison: eq/neq/lt/le/gt/ge → 0/1 result vectors.
- Boolean: and/or/not on 0/1 values, element-wise.
- Bitwise: bitand/bitor/bitxor/bitnot/lshift/rshift — element-wise.
- Reduction: reduce-add/mul/max/min/and/or; scan-add/mul.
- Vector ops: reverse, cat (scalar/vector catenate), take (±N), drop (±N),
  rotate, compress (boolean mask), index (multi-index).
- Set ops: member (∊, → 0/1), nub (∪, unique preserve-order),
  union, intersect (∩), without (~). All use SX make-set internally.
- Format (⍕): vector → space-separated string, scalar → str.

lib/apl/tests/runtime.sx + lib/apl/test.sh: 73/73 pass.

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 ["stdlib.sx", "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)
@@ -2811,6 +2872,7 @@ let run_spec_tests env test_files =
       match sx_vm_execute with
       | Some fn -> Sx_ref.cek_call fn (List args)
       | None -> Nil)));
+  load_module "stdlib.sx" spec_dir;   (* pure SX stdlib: format etc. *)
   load_module "signals.sx" spec_dir;  (* core reactive primitives *)
   load_module "signals.sx" web_dir;   (* web extensions *)
   load_module "freeze.sx" lib_dir;

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,10 +89,38 @@ 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 =
-  match float_of_string_opt str with
-  | Some n -> Some (Number n)
-  | None -> None
+  (* 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
 
 let rec read_value s : value =
   skip_whitespace_and_comments s;
@@ -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

@@ -43,9 +43,10 @@ type env = {
 
 and value =
   | Nil
-  | Bool   of bool
-  | Number of float
-  | String of string
+  | Bool    of bool
+  | Integer of int    (** Exact integer — distinct from inexact float. *)
+  | Number  of float  (** Inexact float. *)
+  | String  of string
   | Symbol of string
   | Keyword of string
   | List   of value list
@@ -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/apl/runtime.sx

@@ -0,0 +1,289 @@
+;; lib/apl/runtime.sx — APL primitives on SX
+;;
+;; APL vectors are represented as SX lists (functional, immutable results).
+;; Operations are rank-polymorphic: scalar/vector arguments both accepted.
+;; Index origin: 1 (traditional APL).
+;;
+;; Primitives used:
+;;   map (multi-arg, Phase 1)
+;;   bitwise-and/or/xor/not/arithmetic-shift (Phase 7)
+;;   make-set/set-member?/set-add!/set->list (Phase 18)
+
+;; ---------------------------------------------------------------------------
+;; 1. Core vector constructors
+;; ---------------------------------------------------------------------------
+
+;; ⍳N — iota: generate integer vector 1, 2, ..., N
+(define
+  (apl-iota n)
+  (letrec
+    ((go (fn (i acc) (if (< i 1) acc (go (- i 1) (cons i acc))))))
+    (go n (list))))
+
+;; ⍴A — shape (length of a vector)
+(define (apl-rho v) (if (list? v) (len v) 1))
+
+;; A[I] — 1-indexed access
+(define (apl-at v i) (nth v (- i 1)))
+
+;; Scalar predicate
+(define (apl-scalar? v) (not (list? v)))
+
+;; ---------------------------------------------------------------------------
+;; 2. Rank-polymorphic helpers
+;;    dyadic: scalar/vector × scalar/vector → scalar/vector
+;;    monadic: scalar/vector → scalar/vector
+;; ---------------------------------------------------------------------------
+
+(define
+  (apl-dyadic op a b)
+  (cond
+    ((and (list? a) (list? b)) (map op a b))
+    ((list? a) (map (fn (x) (op x b)) a))
+    ((list? b) (map (fn (y) (op a y)) b))
+    (else (op a b))))
+
+(define (apl-monadic op a) (if (list? a) (map op a) (op a)))
+
+;; ---------------------------------------------------------------------------
+;; 3. Arithmetic (element-wise, rank-polymorphic)
+;; ---------------------------------------------------------------------------
+
+(define (apl-add a b) (apl-dyadic + a b))
+(define (apl-sub a b) (apl-dyadic - a b))
+(define (apl-mul a b) (apl-dyadic * a b))
+(define (apl-div a b) (apl-dyadic / a b))
+(define (apl-mod a b) (apl-dyadic modulo a b))
+(define (apl-pow a b) (apl-dyadic pow a b))
+(define (apl-max a b) (apl-dyadic (fn (x y) (if (> x y) x y)) a b))
+(define (apl-min a b) (apl-dyadic (fn (x y) (if (< x y) x y)) a b))
+
+(define (apl-neg a) (apl-monadic (fn (x) (- 0 x)) a))
+(define (apl-abs a) (apl-monadic abs a))
+(define (apl-floor a) (apl-monadic floor a))
+(define (apl-ceil a) (apl-monadic ceil a))
+(define (apl-sqrt a) (apl-monadic sqrt a))
+(define (apl-exp a) (apl-monadic exp a))
+(define (apl-log a) (apl-monadic log a))
+
+;; ---------------------------------------------------------------------------
+;; 4. Comparison (element-wise, returns 0/1 booleans)
+;; ---------------------------------------------------------------------------
+
+(define (apl-bool v) (if v 1 0))
+
+(define (apl-eq a b) (apl-dyadic (fn (x y) (apl-bool (= x y))) a b))
+(define
+  (apl-neq a b)
+  (apl-dyadic (fn (x y) (apl-bool (not (= x y)))) a b))
+(define (apl-lt a b) (apl-dyadic (fn (x y) (apl-bool (< x y))) a b))
+(define (apl-le a b) (apl-dyadic (fn (x y) (apl-bool (<= x y))) a b))
+(define (apl-gt a b) (apl-dyadic (fn (x y) (apl-bool (> x y))) a b))
+(define (apl-ge a b) (apl-dyadic (fn (x y) (apl-bool (>= x y))) a b))
+
+;; Boolean logic (0/1 vectors)
+(define
+  (apl-and a b)
+  (apl-dyadic
+    (fn
+      (x y)
+      (if
+        (and (not (= x 0)) (not (= y 0)))
+        1
+        0))
+    a
+    b))
+(define
+  (apl-or a b)
+  (apl-dyadic
+    (fn
+      (x y)
+      (if
+        (or (not (= x 0)) (not (= y 0)))
+        1
+        0))
+    a
+    b))
+(define
+  (apl-not a)
+  (apl-monadic (fn (x) (if (= x 0) 1 0)) a))
+
+;; ---------------------------------------------------------------------------
+;; 5. Bitwise operations (element-wise)
+;; ---------------------------------------------------------------------------
+
+(define (apl-bitand a b) (apl-dyadic bitwise-and a b))
+(define (apl-bitor a b) (apl-dyadic bitwise-or a b))
+(define (apl-bitxor a b) (apl-dyadic bitwise-xor a b))
+(define (apl-bitnot a) (apl-monadic bitwise-not a))
+(define
+  (apl-lshift a b)
+  (apl-dyadic (fn (x n) (arithmetic-shift x n)) a b))
+(define
+  (apl-rshift a b)
+  (apl-dyadic (fn (x n) (arithmetic-shift x (- 0 n))) a b))
+
+;; ---------------------------------------------------------------------------
+;; 6. Reduction (fold) and scan
+;; ---------------------------------------------------------------------------
+
+(define (apl-reduce-add v) (reduce + 0 v))
+(define (apl-reduce-mul v) (reduce * 1 v))
+(define
+  (apl-reduce-max v)
+  (reduce (fn (acc x) (if (> acc x) acc x)) (first v) (rest v)))
+(define
+  (apl-reduce-min v)
+  (reduce (fn (acc x) (if (< acc x) acc x)) (first v) (rest v)))
+(define
+  (apl-reduce-and v)
+  (reduce
+    (fn
+      (acc x)
+      (if
+        (and (not (= acc 0)) (not (= x 0)))
+        1
+        0))
+    1
+    v))
+(define
+  (apl-reduce-or v)
+  (reduce
+    (fn
+      (acc x)
+      (if
+        (or (not (= acc 0)) (not (= x 0)))
+        1
+        0))
+    0
+    v))
+
+;; Scan: prefix reduction (yields a vector of running totals)
+(define
+  (apl-scan op v)
+  (if
+    (= (len v) 0)
+    (list)
+    (letrec
+      ((go (fn (xs acc result) (if (= (len xs) 0) (reverse result) (let ((next (op acc (first xs)))) (go (rest xs) next (cons next result)))))))
+      (go (rest v) (first v) (list (first v))))))
+
+(define (apl-scan-add v) (apl-scan + v))
+(define (apl-scan-mul v) (apl-scan * v))
+
+;; ---------------------------------------------------------------------------
+;; 7. Vector manipulation
+;; ---------------------------------------------------------------------------
+
+;; ⌽A — reverse
+(define (apl-reverse v) (reverse v))
+
+;; A,B — catenate
+(define
+  (apl-cat a b)
+  (cond
+    ((and (list? a) (list? b)) (append a b))
+    ((list? a) (append a (list b)))
+    ((list? b) (cons a b))
+    (else (list a b))))
+
+;; ↑N A — take first N elements (negative: take last N)
+(define
+  (apl-take n v)
+  (if
+    (>= n 0)
+    (letrec
+      ((go (fn (xs i) (if (or (= i 0) (= (len xs) 0)) (list) (cons (first xs) (go (rest xs) (- i 1)))))))
+      (go v n))
+    (apl-reverse (apl-take (- 0 n) (apl-reverse v)))))
+
+;; ↓N A — drop first N elements
+(define
+  (apl-drop n v)
+  (if
+    (>= n 0)
+    (letrec
+      ((go (fn (xs i) (if (or (= i 0) (= (len xs) 0)) xs (go (rest xs) (- i 1))))))
+      (go v n))
+    (apl-reverse (apl-drop (- 0 n) (apl-reverse v)))))
+
+;; Rotate left by n positions
+(define
+  (apl-rotate n v)
+  (let ((m (modulo n (len v)))) (append (apl-drop m v) (apl-take m v))))
+
+;; Compression: A/B — select elements of B where A is 1
+(define
+  (apl-compress mask v)
+  (if
+    (= (len mask) 0)
+    (list)
+    (let
+      ((rest-result (apl-compress (rest mask) (rest v))))
+      (if
+        (not (= (first mask) 0))
+        (cons (first v) rest-result)
+        rest-result))))
+
+;; Indexing: A[B] — select elements at indices B (1-indexed)
+(define (apl-index v indices) (map (fn (i) (apl-at v i)) indices))
+
+;; Grade up: indices that would sort the vector ascending
+(define
+  (apl-grade-up v)
+  (let
+    ((indexed (map (fn (x i) (list x i)) v (apl-iota (len v)))))
+    (map (fn (p) (nth p 1)) (sort indexed))))
+
+;; ---------------------------------------------------------------------------
+;; 8. Set operations (∊ ∪ ∩ ~)
+;; ---------------------------------------------------------------------------
+
+;; Membership ∊: for each element in A, is it in B? → 0/1 vector
+(define
+  (apl-member a b)
+  (let
+    ((bset (let ((s (make-set))) (for-each (fn (x) (set-add! s x)) b) s)))
+    (if
+      (list? a)
+      (map (fn (x) (apl-bool (set-member? bset x))) a)
+      (apl-bool (set-member? bset a)))))
+
+;; Nub ∪A — unique elements, preserving order
+(define
+  (apl-nub v)
+  (let
+    ((seen (make-set)))
+    (letrec
+      ((go (fn (xs acc) (if (= (len xs) 0) (reverse acc) (if (set-member? seen (first xs)) (go (rest xs) acc) (begin (set-add! seen (first xs)) (go (rest xs) (cons (first xs) acc))))))))
+      (go v (list)))))
+
+;; Union A∪B — nub of concatenation
+(define (apl-union a b) (apl-nub (apl-cat a b)))
+
+;; Intersection A∩B
+(define
+  (apl-intersect a b)
+  (let
+    ((bset (let ((s (make-set))) (for-each (fn (x) (set-add! s x)) b) s)))
+    (filter (fn (x) (set-member? bset x)) a)))
+
+;; Without A~B
+(define
+  (apl-without a b)
+  (let
+    ((bset (let ((s (make-set))) (for-each (fn (x) (set-add! s x)) b) s)))
+    (filter (fn (x) (not (set-member? bset x))) a)))
+
+;; ---------------------------------------------------------------------------
+;; 9. Format (⍕) — APL-style display
+;; ---------------------------------------------------------------------------
+
+(define
+  (apl-format v)
+  (if
+    (list? v)
+    (letrec
+      ((go (fn (xs acc) (if (= (len xs) 0) acc (go (rest xs) (str acc (if (= acc "") "" " ") (str (first xs))))))))
+      (go v ""))
+    (str v)))

lib/apl/test.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# lib/apl/test.sh — smoke-test the APL runtime layer.
+
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
+if [ ! -x "$SX_SERVER" ]; then
+  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
+fi
+if [ ! -x "$SX_SERVER" ]; then
+  echo "ERROR: sx_server.exe not found."
+  exit 1
+fi
+
+TMPFILE=$(mktemp); trap "rm -f $TMPFILE" EXIT
+
+cat > "$TMPFILE" << 'EPOCHS'
+(epoch 1)
+(load "spec/stdlib.sx")
+(load "lib/apl/runtime.sx")
+(epoch 2)
+(load "lib/apl/tests/runtime.sx")
+(epoch 3)
+(eval "(list apl-test-pass apl-test-fail)")
+EPOCHS
+
+OUTPUT=$(timeout 60 "$SX_SERVER" < "$TMPFILE" 2>/dev/null)
+
+LINE=$(echo "$OUTPUT" | awk '/^\(ok-len 3 / {getline; print; exit}')
+if [ -z "$LINE" ]; then
+  LINE=$(echo "$OUTPUT" | grep -E '^\(ok 3 \([0-9]+ [0-9]+\)\)' | tail -1 \
+          | sed -E 's/^\(ok 3 //; s/\)$//')
+fi
+if [ -z "$LINE" ]; then
+  echo "ERROR: could not extract summary"
+  echo "$OUTPUT" | tail -10
+  exit 1
+fi
+
+P=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\1/')
+F=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\2/')
+TOTAL=$((P + F))
+
+if [ "$F" -eq 0 ]; then
+  echo "ok $P/$TOTAL lib/apl tests passed"
+else
+  echo "FAIL $P/$TOTAL passed, $F failed"
+fi
+
+[ "$F" -eq 0 ]

lib/apl/tests/runtime.sx

@@ -0,0 +1,327 @@
+;; lib/apl/tests/runtime.sx — Tests for lib/apl/runtime.sx
+
+;; --- Test framework ---
+(define apl-test-pass 0)
+(define apl-test-fail 0)
+(define apl-test-fails (list))
+
+(define
+  (apl-test name got expected)
+  (if
+    (= got expected)
+    (set! apl-test-pass (+ apl-test-pass 1))
+    (begin
+      (set! apl-test-fail (+ apl-test-fail 1))
+      (set! apl-test-fails (append apl-test-fails (list {:got got :expected expected :name name}))))))
+
+;; ---------------------------------------------------------------------------
+;; 1. Core vector constructors
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "iota 5"
+  (apl-iota 5)
+  (list 1 2 3 4 5))
+(apl-test "iota 1" (apl-iota 1) (list 1))
+(apl-test "iota 0" (apl-iota 0) (list))
+(apl-test
+  "rho list"
+  (apl-rho (list 1 2 3))
+  3)
+(apl-test "rho scalar" (apl-rho 42) 1)
+(apl-test
+  "at 1"
+  (apl-at (list 10 20 30) 1)
+  10)
+(apl-test
+  "at 3"
+  (apl-at (list 10 20 30) 3)
+  30)
+
+;; ---------------------------------------------------------------------------
+;; 2. Arithmetic — element-wise and rank-polymorphic
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "add v+v"
+  (apl-add
+    (list 1 2 3)
+    (list 10 20 30))
+  (list 11 22 33))
+(apl-test
+  "add s+v"
+  (apl-add 10 (list 1 2 3))
+  (list 11 12 13))
+(apl-test
+  "add v+s"
+  (apl-add (list 1 2 3) 100)
+  (list 101 102 103))
+(apl-test "add s+s" (apl-add 3 4) 7)
+(apl-test
+  "sub v-v"
+  (apl-sub
+    (list 5 4 3)
+    (list 1 2 3))
+  (list 4 2 0))
+(apl-test
+  "mul v*s"
+  (apl-mul (list 1 2 3) 3)
+  (list 3 6 9))
+(apl-test
+  "neg -v"
+  (apl-neg (list 1 -2 3))
+  (list -1 2 -3))
+(apl-test
+  "abs v"
+  (apl-abs (list -1 2 -3))
+  (list 1 2 3))
+(apl-test
+  "floor v"
+  (apl-floor (list 1.7 2.2 3.9))
+  (list 1 2 3))
+(apl-test
+  "ceil v"
+  (apl-ceil (list 1.1 2.5 3))
+  (list 2 3 3))
+(apl-test
+  "max v v"
+  (apl-max
+    (list 1 5 3)
+    (list 4 2 6))
+  (list 4 5 6))
+(apl-test
+  "min v v"
+  (apl-min
+    (list 1 5 3)
+    (list 4 2 6))
+  (list 1 2 3))
+
+;; ---------------------------------------------------------------------------
+;; 3. Comparison (returns 0/1)
+;; ---------------------------------------------------------------------------
+
+(apl-test "eq 3 3" (apl-eq 3 3) 1)
+(apl-test "eq 3 4" (apl-eq 3 4) 0)
+(apl-test
+  "gt v>s"
+  (apl-gt (list 1 5 3 7) 4)
+  (list 0 1 0 1))
+(apl-test
+  "lt v<v"
+  (apl-lt
+    (list 1 2 3)
+    (list 3 2 1))
+  (list 1 0 0))
+(apl-test
+  "le v<=s"
+  (apl-le (list 3 4 5) 4)
+  (list 1 1 0))
+(apl-test
+  "ge v>=s"
+  (apl-ge (list 3 4 5) 4)
+  (list 0 1 1))
+(apl-test
+  "neq v!=s"
+  (apl-neq (list 1 2 3) 2)
+  (list 1 0 1))
+
+;; ---------------------------------------------------------------------------
+;; 4. Boolean logic (0/1 values)
+;; ---------------------------------------------------------------------------
+
+(apl-test "and 1 1" (apl-and 1 1) 1)
+(apl-test "and 1 0" (apl-and 1 0) 0)
+(apl-test "or 0 1" (apl-or 0 1) 1)
+(apl-test "or 0 0" (apl-or 0 0) 0)
+(apl-test "not 0" (apl-not 0) 1)
+(apl-test "not 1" (apl-not 1) 0)
+(apl-test
+  "not vec"
+  (apl-not (list 1 0 1 0))
+  (list 0 1 0 1))
+
+;; ---------------------------------------------------------------------------
+;; 5. Bitwise operations
+;; ---------------------------------------------------------------------------
+
+(apl-test "bitand s" (apl-bitand 5 3) 1)
+(apl-test "bitor s" (apl-bitor 5 3) 7)
+(apl-test "bitxor s" (apl-bitxor 5 3) 6)
+(apl-test "bitnot 0" (apl-bitnot 0) -1)
+(apl-test "lshift 1 4" (apl-lshift 1 4) 16)
+(apl-test "rshift 16 2" (apl-rshift 16 2) 4)
+(apl-test
+  "bitand vec"
+  (apl-bitand (list 5 6) (list 3 7))
+  (list 1 6))
+(apl-test
+  "bitor vec"
+  (apl-bitor (list 5 6) (list 3 7))
+  (list 7 7))
+
+;; ---------------------------------------------------------------------------
+;; 6. Reduction and scan
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "reduce-add"
+  (apl-reduce-add
+    (list 1 2 3 4 5))
+  15)
+(apl-test
+  "reduce-mul"
+  (apl-reduce-mul (list 1 2 3 4))
+  24)
+(apl-test
+  "reduce-max"
+  (apl-reduce-max
+    (list 3 1 4 1 5))
+  5)
+(apl-test
+  "reduce-min"
+  (apl-reduce-min
+    (list 3 1 4 1 5))
+  1)
+(apl-test
+  "reduce-and"
+  (apl-reduce-and (list 1 1 1))
+  1)
+(apl-test
+  "reduce-and0"
+  (apl-reduce-and (list 1 0 1))
+  0)
+(apl-test
+  "reduce-or"
+  (apl-reduce-or (list 0 1 0))
+  1)
+(apl-test
+  "scan-add"
+  (apl-scan-add (list 1 2 3 4))
+  (list 1 3 6 10))
+(apl-test
+  "scan-mul"
+  (apl-scan-mul (list 1 2 3 4))
+  (list 1 2 6 24))
+
+;; ---------------------------------------------------------------------------
+;; 7. Vector manipulation
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "reverse"
+  (apl-reverse (list 1 2 3 4))
+  (list 4 3 2 1))
+(apl-test
+  "cat v v"
+  (apl-cat (list 1 2) (list 3 4))
+  (list 1 2 3 4))
+(apl-test
+  "cat v s"
+  (apl-cat (list 1 2) 3)
+  (list 1 2 3))
+(apl-test
+  "cat s v"
+  (apl-cat 1 (list 2 3))
+  (list 1 2 3))
+(apl-test
+  "cat s s"
+  (apl-cat 1 2)
+  (list 1 2))
+(apl-test
+  "take 3"
+  (apl-take
+    3
+    (list 10 20 30 40 50))
+  (list 10 20 30))
+(apl-test
+  "take 0"
+  (apl-take 0 (list 1 2 3))
+  (list))
+(apl-test
+  "take neg"
+  (apl-take -2 (list 10 20 30))
+  (list 20 30))
+(apl-test
+  "drop 2"
+  (apl-drop 2 (list 10 20 30 40))
+  (list 30 40))
+(apl-test
+  "drop neg"
+  (apl-drop -1 (list 10 20 30))
+  (list 10 20))
+(apl-test
+  "rotate 2"
+  (apl-rotate
+    2
+    (list 1 2 3 4 5))
+  (list 3 4 5 1 2))
+(apl-test
+  "compress"
+  (apl-compress
+    (list 1 0 1 0)
+    (list 10 20 30 40))
+  (list 10 30))
+(apl-test
+  "index"
+  (apl-index
+    (list 10 20 30 40)
+    (list 2 4))
+  (list 20 40))
+
+;; ---------------------------------------------------------------------------
+;; 8. Set operations
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "member yes"
+  (apl-member
+    (list 1 2 5)
+    (list 2 4 6))
+  (list 0 1 0))
+(apl-test
+  "member s"
+  (apl-member 2 (list 1 2 3))
+  1)
+(apl-test
+  "member no"
+  (apl-member 9 (list 1 2 3))
+  0)
+(apl-test
+  "nub"
+  (apl-nub (list 1 2 1 3 2))
+  (list 1 2 3))
+(apl-test
+  "union"
+  (apl-union
+    (list 1 2 3)
+    (list 2 3 4))
+  (list 1 2 3 4))
+(apl-test
+  "intersect"
+  (apl-intersect
+    (list 1 2 3 4)
+    (list 2 4 6))
+  (list 2 4))
+(apl-test
+  "without"
+  (apl-without
+    (list 1 2 3 4)
+    (list 2 4))
+  (list 1 3))
+
+;; ---------------------------------------------------------------------------
+;; 9. Format
+;; ---------------------------------------------------------------------------
+
+(apl-test
+  "format vec"
+  (apl-format (list 1 2 3))
+  "1 2 3")
+(apl-test "format scalar" (apl-format 42) "42")
+(apl-test "format empty" (apl-format (list)) "")
+
+;; ---------------------------------------------------------------------------
+;; Summary
+;; ---------------------------------------------------------------------------
+
+(list apl-test-pass apl-test-fail)

lib/common-lisp/runtime.sx

@@ -0,0 +1,306 @@
+;; lib/common-lisp/runtime.sx — CL built-ins using SX spec primitives
+;;
+;; Provides CL-specific wrappers and helpers. Deliberately thin: wherever
+;; an SX spec primitive already does the job, we alias it rather than
+;; reinventing it.
+;;
+;; Primitives used from spec:
+;;   char/char->integer/integer->char/char-upcase/char-downcase
+;;   format   (Phase 21 — must be loaded before this file)
+;;   gensym   (Phase 12)
+;;   rational/rational?  (Phase 16)
+;;   make-set/set-member?/set-union/etc  (Phase 18)
+;;   open-input-string/read-char/etc  (Phase 14)
+;;   modulo/remainder/quotient/gcd/lcm/expt  (Phase 2 / Phase 15)
+;;   number->string with radix  (Phase 15)
+
+;; ---------------------------------------------------------------------------
+;; 1.  Type predicates
+;; ---------------------------------------------------------------------------
+
+(define (cl-null? x) (= x nil))
+(define (cl-consp? x) (and (list? x) (not (cl-empty? x))))
+(define (cl-listp? x) (or (cl-empty? x) (list? x)))
+(define (cl-atom? x) (not (cl-consp? x)))
+
+(define
+  (cl-numberp? x)
+  (let ((t (type-of x))) (or (= t "number") (= t "rational"))))
+
+(define cl-integerp? integer?)
+(define cl-floatp? float?)
+(define cl-rationalp? rational?)
+
+(define (cl-realp? x) (or (integer? x) (float? x) (rational? x)))
+
+(define cl-characterp? char?)
+(define cl-stringp? (fn (x) (= (type-of x) "string")))
+(define cl-symbolp? (fn (x) (= (type-of x) "symbol")))
+(define cl-keywordp? (fn (x) (= (type-of x) "keyword")))
+
+(define
+  (cl-functionp? x)
+  (let
+    ((t (type-of x)))
+    (or
+      (= t "function")
+      (= t "lambda")
+      (= t "native-fn")
+      (= t "component"))))
+
+(define cl-vectorp? vector?)
+(define cl-arrayp? vector?)
+
+;; sx_server: (rest (list x)) returns () not nil — cl-empty? handles both
+(define
+  (cl-empty? x)
+  (or (nil? x) (and (list? x) (= (len x) 0))))
+
+;; ---------------------------------------------------------------------------
+;; 2.  Arithmetic — thin aliases to spec primitives
+;; ---------------------------------------------------------------------------
+
+(define cl-mod modulo)
+(define cl-rem remainder)
+(define cl-gcd gcd)
+(define cl-lcm lcm)
+(define cl-expt expt)
+(define cl-floor floor)
+(define cl-ceiling ceil)
+(define cl-truncate truncate)
+(define cl-round round)
+(define cl-abs (fn (x) (if (< x 0) (- 0 x) x)))
+(define cl-min (fn (a b) (if (< a b) a b)))
+(define cl-max (fn (a b) (if (> a b) a b)))
+(define cl-quotient quotient)
+
+(define
+  (cl-signum x)
+  (cond
+    ((> x 0) 1)
+    ((< x 0) -1)
+    (else 0)))
+
+(define (cl-evenp? n) (= (modulo n 2) 0))
+(define (cl-oddp? n) (= (modulo n 2) 1))
+(define (cl-zerop? n) (= n 0))
+(define (cl-plusp? n) (> n 0))
+(define (cl-minusp? n) (< n 0))
+
+;; ---------------------------------------------------------------------------
+;; 3.  Character functions — alias spec char primitives + CL name mapping
+;; ---------------------------------------------------------------------------
+
+(define cl-char->integer char->integer)
+(define cl-integer->char integer->char)
+(define cl-char-upcase char-upcase)
+(define cl-char-downcase char-downcase)
+(define cl-char-code char->integer)
+(define cl-code-char integer->char)
+
+(define cl-char=? char=?)
+(define cl-char<? char<?)
+(define cl-char>? char>?)
+(define cl-char<=? char<=?)
+(define cl-char>=? char>=?)
+(define cl-char-ci=? char-ci=?)
+(define cl-char-ci<? char-ci<?)
+(define cl-char-ci>? char-ci>?)
+
+;; Inline predicates — char-alphabetic?/char-numeric? unreliable in sx_server
+(define
+  (cl-alpha-char-p c)
+  (let
+    ((n (char->integer c)))
+    (or
+      (and (>= n 65) (<= n 90))
+      (and (>= n 97) (<= n 122)))))
+
+(define
+  (cl-digit-char-p c)
+  (let ((n (char->integer c))) (and (>= n 48) (<= n 57))))
+
+(define
+  (cl-alphanumericp c)
+  (let
+    ((n (char->integer c)))
+    (or
+      (and (>= n 48) (<= n 57))
+      (and (>= n 65) (<= n 90))
+      (and (>= n 97) (<= n 122)))))
+
+(define
+  (cl-upper-case-p c)
+  (let ((n (char->integer c))) (and (>= n 65) (<= n 90))))
+
+(define
+  (cl-lower-case-p c)
+  (let ((n (char->integer c))) (and (>= n 97) (<= n 122))))
+
+;; Named character constants
+(define cl-char-space (integer->char 32))
+(define cl-char-newline (integer->char 10))
+(define cl-char-tab (integer->char 9))
+(define cl-char-backspace (integer->char 8))
+(define cl-char-return (integer->char 13))
+(define cl-char-null (integer->char 0))
+(define cl-char-escape (integer->char 27))
+(define cl-char-delete (integer->char 127))
+
+;; ---------------------------------------------------------------------------
+;; 4.  String + IO — use spec format and ports
+;; ---------------------------------------------------------------------------
+
+;; CL format: (cl-format nil "~a ~a" x y) — nil destination means return string
+(define
+  (cl-format dest template &rest args)
+  (let ((s (apply format (cons template args)))) (if (= dest nil) s s)))
+
+(define cl-write-to-string write-to-string)
+(define cl-princ-to-string display-to-string)
+
+;; CL read-from-string: parse value from a string using SX port
+(define
+  (cl-read-from-string s)
+  (let ((p (open-input-string s))) (read p)))
+
+;; String stream (output)
+(define cl-make-string-output-stream open-output-string)
+(define cl-get-output-stream-string get-output-string)
+
+;; String stream (input)
+(define cl-make-string-input-stream open-input-string)
+
+;; ---------------------------------------------------------------------------
+;; 5.  Gensym
+;; ---------------------------------------------------------------------------
+
+(define cl-gensym gensym)
+(define cl-gentemp gensym)
+
+;; ---------------------------------------------------------------------------
+;; 6.  Multiple values (CL: values / nth-value)
+;; ---------------------------------------------------------------------------
+
+(define (cl-values &rest args) {:_values true :_list args})
+
+(define
+  (cl-call-with-values producer consumer)
+  (let
+    ((mv (producer)))
+    (if
+      (and (dict? mv) (get mv :_values))
+      (apply consumer (get mv :_list))
+      (consumer mv))))
+
+(define
+  (cl-nth-value n mv)
+  (cond
+    ((and (dict? mv) (get mv :_values))
+      (let
+        ((lst (get mv :_list)))
+        (if (>= n (len lst)) nil (nth lst n))))
+    ((= n 0) mv)
+    (else nil)))
+
+;; ---------------------------------------------------------------------------
+;; 7.  Sets (CL: adjoin / member / union / intersection / set-difference)
+;; ---------------------------------------------------------------------------
+
+(define cl-make-set make-set)
+(define cl-set? set?)
+(define cl-set-add set-add!)
+(define cl-set-memberp set-member?)
+(define cl-set-remove set-remove!)
+(define cl-set-union set-union)
+(define cl-set-intersect set-intersection)
+(define cl-set-difference set-difference)
+(define cl-list->set list->set)
+(define cl-set->list set->list)
+
+;; CL: (member item list) — returns tail starting at item, or nil
+(define
+  (cl-member item lst)
+  (cond
+    ((cl-empty? lst) nil)
+    ((equal? item (first lst)) lst)
+    (else (cl-member item (rest lst)))))
+
+;; CL: (adjoin item list) — cons only if not already present
+(define (cl-adjoin item lst) (if (cl-member item lst) lst (cons item lst)))
+
+;; ---------------------------------------------------------------------------
+;; 8.  Radix formatting  (CL: (write-to-string n :base radix))
+;; ---------------------------------------------------------------------------
+
+(define (cl-integer-to-string n radix) (number->string n radix))
+
+(define (cl-string-to-integer s radix) (string->number s radix))
+
+;; CL ~R directive helpers
+(define (cl-format-binary n) (number->string n 2))
+(define (cl-format-octal n) (number->string n 8))
+(define (cl-format-hex n) (number->string n 16))
+(define (cl-format-decimal n) (number->string n 10))
+
+;; ---------------------------------------------------------------------------
+;; 9.  List utilities — cl-empty? guards against () from rest
+;; ---------------------------------------------------------------------------
+
+(define
+  (cl-last lst)
+  (cond
+    ((cl-empty? lst) nil)
+    ((cl-empty? (rest lst)) lst)
+    (else (cl-last (rest lst)))))
+
+(define
+  (cl-butlast lst)
+  (if
+    (or (cl-empty? lst) (cl-empty? (rest lst)))
+    nil
+    (cons (first lst) (cl-butlast (rest lst)))))
+
+(define
+  (cl-nthcdr n lst)
+  (if (= n 0) lst (cl-nthcdr (- n 1) (rest lst))))
+
+(define (cl-nth n lst) (first (cl-nthcdr n lst)))
+
+(define (cl-list-length lst) (len lst))
+
+(define
+  (cl-copy-list lst)
+  (if (cl-empty? lst) nil (cons (first lst) (cl-copy-list (rest lst)))))
+
+(define
+  (cl-flatten lst)
+  (cond
+    ((cl-empty? lst) nil)
+    ((list? (first lst))
+      (append (cl-flatten (first lst)) (cl-flatten (rest lst))))
+    (else (cons (first lst) (cl-flatten (rest lst))))))
+
+;; CL: (assoc key alist) — returns matching pair or nil
+(define
+  (cl-assoc key alist)
+  (cond
+    ((cl-empty? alist) nil)
+    ((equal? key (first (first alist))) (first alist))
+    (else (cl-assoc key (rest alist)))))
+
+;; CL: (rassoc val alist) — reverse assoc (match on second element)
+(define
+  (cl-rassoc val alist)
+  (cond
+    ((cl-empty? alist) nil)
+    ((equal? val (first (rest (first alist)))) (first alist))
+    (else (cl-rassoc val (rest alist)))))
+
+;; CL: (getf plist key) — property list lookup
+(define
+  (cl-getf plist key)
+  (cond
+    ((or (cl-empty? plist) (cl-empty? (rest plist))) nil)
+    ((equal? (first plist) key) (first (rest plist)))
+    (else (cl-getf (rest (rest plist)) key))))

lib/common-lisp/test.sh

@@ -0,0 +1,302 @@
+#!/usr/bin/env bash
+# lib/common-lisp/test.sh — quick smoke-test the CL runtime layer.
+# Uses sx_server.exe epoch protocol (same as lib/lua/test.sh).
+#
+# Usage:
+#   bash lib/common-lisp/test.sh
+#   bash lib/common-lisp/test.sh -v
+
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
+if [ ! -x "$SX_SERVER" ]; then
+  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
+fi
+if [ ! -x "$SX_SERVER" ]; then
+  echo "ERROR: sx_server.exe not found. Run: cd hosts/ocaml && dune build"
+  exit 1
+fi
+
+VERBOSE="${1:-}"
+PASS=0; FAIL=0; ERRORS=""
+TMPFILE=$(mktemp); trap "rm -f $TMPFILE" EXIT
+
+cat > "$TMPFILE" << 'EPOCHS'
+(epoch 1)
+(load "spec/stdlib.sx")
+(load "lib/common-lisp/runtime.sx")
+
+;; --- Type predicates ---
+(epoch 10)
+(eval "(cl-null? nil)")
+(epoch 11)
+(eval "(cl-null? false)")
+(epoch 12)
+(eval "(cl-consp? (list 1 2))")
+(epoch 13)
+(eval "(cl-consp? nil)")
+(epoch 14)
+(eval "(cl-listp? nil)")
+(epoch 15)
+(eval "(cl-listp? (list 1))")
+(epoch 16)
+(eval "(cl-atom? nil)")
+(epoch 17)
+(eval "(cl-atom? (list 1))")
+(epoch 18)
+(eval "(cl-integerp? 42)")
+(epoch 19)
+(eval "(cl-floatp? 3.14)")
+(epoch 20)
+(eval "(cl-characterp? (integer->char 65))")
+(epoch 21)
+(eval "(cl-stringp? \"hello\")")
+
+;; --- Arithmetic ---
+(epoch 30)
+(eval "(cl-mod 10 3)")
+(epoch 31)
+(eval "(cl-rem 10 3)")
+(epoch 32)
+(eval "(cl-quotient 10 3)")
+(epoch 33)
+(eval "(cl-gcd 12 8)")
+(epoch 34)
+(eval "(cl-lcm 4 6)")
+(epoch 35)
+(eval "(cl-abs -5)")
+(epoch 36)
+(eval "(cl-abs 5)")
+(epoch 37)
+(eval "(cl-min 2 7)")
+(epoch 38)
+(eval "(cl-max 2 7)")
+(epoch 39)
+(eval "(cl-evenp? 4)")
+(epoch 40)
+(eval "(cl-evenp? 3)")
+(epoch 41)
+(eval "(cl-oddp? 7)")
+(epoch 42)
+(eval "(cl-zerop? 0)")
+(epoch 43)
+(eval "(cl-plusp? 1)")
+(epoch 44)
+(eval "(cl-minusp? -1)")
+(epoch 45)
+(eval "(cl-signum 42)")
+(epoch 46)
+(eval "(cl-signum -7)")
+(epoch 47)
+(eval "(cl-signum 0)")
+
+;; --- Characters ---
+(epoch 50)
+(eval "(cl-char-code (integer->char 65))")
+(epoch 51)
+(eval "(char? (cl-code-char 65))")
+(epoch 52)
+(eval "(cl-char=? (integer->char 65) (integer->char 65))")
+(epoch 53)
+(eval "(cl-char<? (integer->char 65) (integer->char 90))")
+(epoch 54)
+(eval "(cl-char-code cl-char-space)")
+(epoch 55)
+(eval "(cl-char-code cl-char-newline)")
+(epoch 56)
+(eval "(cl-alpha-char-p (integer->char 65))")
+(epoch 57)
+(eval "(cl-digit-char-p (integer->char 48))")
+
+;; --- Format ---
+(epoch 60)
+(eval "(cl-format nil \"hello\")")
+(epoch 61)
+(eval "(cl-format nil \"~a\" \"world\")")
+(epoch 62)
+(eval "(cl-format nil \"~d\" 42)")
+(epoch 63)
+(eval "(cl-format nil \"~x\" 255)")
+(epoch 64)
+(eval "(cl-format nil \"x=~d y=~d\" 3 4)")
+
+;; --- Gensym ---
+(epoch 70)
+(eval "(= (type-of (cl-gensym)) \"symbol\")")
+(epoch 71)
+(eval "(not (= (cl-gensym) (cl-gensym)))")
+
+;; --- Sets ---
+(epoch 80)
+(eval "(cl-set? (cl-make-set))")
+(epoch 81)
+(eval "(let ((s (cl-make-set))) (do (cl-set-add s 1) (cl-set-memberp s 1)))")
+(epoch 82)
+(eval "(cl-set-memberp (cl-make-set) 42)")
+(epoch 83)
+(eval "(cl-set-memberp (cl-list->set (list 1 2 3)) 2)")
+
+;; --- Lists ---
+(epoch 90)
+(eval "(cl-nth 0 (list 1 2 3))")
+(epoch 91)
+(eval "(cl-nth 2 (list 1 2 3))")
+(epoch 92)
+(eval "(cl-last (list 1 2 3))")
+(epoch 93)
+(eval "(cl-butlast (list 1 2 3))")
+(epoch 94)
+(eval "(cl-nthcdr 1 (list 1 2 3))")
+(epoch 95)
+(eval "(cl-assoc \"b\" (list (list \"a\" 1) (list \"b\" 2)))")
+(epoch 96)
+(eval "(cl-assoc \"z\" (list (list \"a\" 1)))")
+(epoch 97)
+(eval "(cl-getf (list \"x\" 42 \"y\" 99) \"x\")")
+(epoch 98)
+(eval "(cl-adjoin 0 (list 1 2))")
+(epoch 99)
+(eval "(cl-adjoin 1 (list 1 2))")
+(epoch 100)
+(eval "(cl-member 2 (list 1 2 3))")
+(epoch 101)
+(eval "(cl-member 9 (list 1 2 3))")
+(epoch 102)
+(eval "(cl-flatten (list 1 (list 2 3) 4))")
+
+;; --- Radix ---
+(epoch 110)
+(eval "(cl-format-binary 10)")
+(epoch 111)
+(eval "(cl-format-octal 15)")
+(epoch 112)
+(eval "(cl-format-hex 255)")
+(epoch 113)
+(eval "(cl-format-decimal 42)")
+(epoch 114)
+(eval "(cl-integer-to-string 31 16)")
+(epoch 115)
+(eval "(cl-string-to-integer \"1f\" 16)")
+
+EPOCHS
+
+OUTPUT=$(timeout 30 "$SX_SERVER" < "$TMPFILE" 2>/dev/null)
+
+check() {
+  local epoch="$1" desc="$2" expected="$3"
+  local actual
+  # ok-len format: value appears on the line AFTER "(ok-len N length)"
+  actual=$(echo "$OUTPUT" | grep -A1 "^(ok-len $epoch " | tail -1 || true)
+  # strip any leading "(ok-len ...)" if grep -A1 returned it instead
+  if echo "$actual" | grep -q "^(ok-len"; then actual=""; fi
+  if [ -z "$actual" ]; then
+    actual=$(echo "$OUTPUT" | grep "^(ok $epoch " | head -1 || true)
+  fi
+  if [ -z "$actual" ]; then
+    actual=$(echo "$OUTPUT" | grep "^(error $epoch " | head -1 || true)
+  fi
+  [ -z "$actual" ] && actual="<no output for epoch $epoch>"
+
+  if echo "$actual" | grep -qF -- "$expected"; then
+    PASS=$((PASS+1))
+    [ "$VERBOSE" = "-v" ] && echo "  ok $desc"
+  else
+    FAIL=$((FAIL+1))
+    ERRORS+="  FAIL [$desc] (epoch $epoch) expected: $expected | actual: $actual
+"
+  fi
+}
+
+# Type predicates
+check 10  "cl-null? nil"           "true"
+check 11  "cl-null? false"         "false"
+check 12  "cl-consp? pair"         "true"
+check 13  "cl-consp? nil"          "false"
+check 14  "cl-listp? nil"          "true"
+check 15  "cl-listp? list"         "true"
+check 16  "cl-atom? nil"           "true"
+check 17  "cl-atom? pair"          "false"
+check 18  "cl-integerp?"           "true"
+check 19  "cl-floatp?"             "true"
+check 20  "cl-characterp?"         "true"
+check 21  "cl-stringp?"            "true"
+
+# Arithmetic
+check 30  "cl-mod 10 3"            "1"
+check 31  "cl-rem 10 3"            "1"
+check 32  "cl-quotient 10 3"       "3"
+check 33  "cl-gcd 12 8"            "4"
+check 34  "cl-lcm 4 6"             "12"
+check 35  "cl-abs -5"              "5"
+check 36  "cl-abs 5"               "5"
+check 37  "cl-min 2 7"             "2"
+check 38  "cl-max 2 7"             "7"
+check 39  "cl-evenp? 4"            "true"
+check 40  "cl-evenp? 3"            "false"
+check 41  "cl-oddp? 7"             "true"
+check 42  "cl-zerop? 0"            "true"
+check 43  "cl-plusp? 1"            "true"
+check 44  "cl-minusp? -1"          "true"
+check 45  "cl-signum pos"          "1"
+check 46  "cl-signum neg"          "-1"
+check 47  "cl-signum zero"         "0"
+
+# Characters
+check 50  "cl-char-code"           "65"
+check 51  "code-char returns char" "true"
+check 52  "cl-char=?"              "true"
+check 53  "cl-char<?"              "true"
+check 54  "cl-char-space code"     "32"
+check 55  "cl-char-newline code"   "10"
+check 56  "cl-alpha-char-p A"      "true"
+check 57  "cl-digit-char-p 0"      "true"
+
+# Format
+check 60  "cl-format plain"        '"hello"'
+check 61  "cl-format ~a"           '"world"'
+check 62  "cl-format ~d"           '"42"'
+check 63  "cl-format ~x"           '"ff"'
+check 64  "cl-format multi"        '"x=3 y=4"'
+
+# Gensym
+check 70  "gensym returns symbol"  "true"
+check 71  "gensyms are unique"     "true"
+
+# Sets
+check 80  "make-set is set?"       "true"
+check 81  "set-add + member"       "true"
+check 82  "member in empty"        "false"
+check 83  "list->set member"       "true"
+
+# Lists
+check 90  "cl-nth 0"               "1"
+check 91  "cl-nth 2"               "3"
+check 92  "cl-last"                "(3)"
+check 93  "cl-butlast"             "(1 2)"
+check 94  "cl-nthcdr 1"            "(2 3)"
+check 95  "cl-assoc hit"           '("b" 2)'
+check 96  "cl-assoc miss"          "nil"
+check 97  "cl-getf hit"            "42"
+check 98  "cl-adjoin new"          "(0 1 2)"
+check 99  "cl-adjoin dup"          "(1 2)"
+check 100 "cl-member hit"          "(2 3)"
+check 101 "cl-member miss"         "nil"
+check 102 "cl-flatten"             "(1 2 3 4)"
+
+# Radix
+check 110 "cl-format-binary 10"    '"1010"'
+check 111 "cl-format-octal 15"     '"17"'
+check 112 "cl-format-hex 255"      '"ff"'
+check 113 "cl-format-decimal 42"   '"42"'
+check 114 "n->s base 16"           '"1f"'
+check 115 "s->n base 16"           "31"
+
+TOTAL=$((PASS+FAIL))
+if [ $FAIL -eq 0 ]; then
+  echo "ok $PASS/$TOTAL lib/common-lisp tests passed"
+else
+  echo "FAIL $PASS/$TOTAL passed, $FAIL failed:"
+  echo "$ERRORS"
+fi
+[ $FAIL -eq 0 ]

lib/erlang/bench_ring.sh

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

lib/erlang/bench_ring_results.md

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

lib/erlang/conformance.sh

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

lib/erlang/parser-expr.sx

@@ -237,6 +237,8 @@
         (er-parse-fun-expr st)
         (er-is? st "keyword" "try")
         (er-parse-try st)
+        (er-is? st "punct" "<<")
+        (er-parse-binary st)
         :else (error
           (str
             "Erlang parse: unexpected "
@@ -281,12 +283,56 @@
   (fn
     (st)
     (er-expect! st "punct" "[")
-    (if
+    (cond
       (er-is? st "punct" "]")
       (do (er-advance! st) {:type "nil"})
-      (let
-        ((elems (list (er-parse-expr-prec st 0))))
-        (er-parse-list-tail st elems)))))
+      :else (let
+        ((first (er-parse-expr-prec st 0)))
+        (cond
+          (er-is? st "punct" "||") (er-parse-list-comp st first)
+          :else (er-parse-list-tail st (list first)))))))
+
+(define
+  er-parse-list-comp
+  (fn
+    (st head)
+    (er-advance! st)
+    (let
+      ((quals (list (er-parse-lc-qualifier st))))
+      (er-parse-list-comp-tail st head quals))))
+
+(define
+  er-parse-list-comp-tail
+  (fn
+    (st head quals)
+    (cond
+      (er-is? st "punct" ",")
+      (do
+        (er-advance! st)
+        (append! quals (er-parse-lc-qualifier st))
+        (er-parse-list-comp-tail st head quals))
+      (er-is? st "punct" "]")
+      (do (er-advance! st) {:head head :qualifiers quals :type "lc"})
+      :else (error
+        (str
+          "Erlang parse: expected ',' or ']' in list comprehension, got '"
+          (er-cur-value st)
+          "'")))))
+
+(define
+  er-parse-lc-qualifier
+  (fn
+    (st)
+    (let
+      ((e (er-parse-expr-prec st 0)))
+      (cond
+        (er-is? st "punct" "<-")
+        (do
+          (er-advance! st)
+          (let
+            ((source (er-parse-expr-prec st 0)))
+            {:kind "gen" :pattern e :source source}))
+        :else {:kind "filter" :expr e}))))
 
 (define
   er-parse-list-tail
@@ -532,3 +578,63 @@
           ((guards (if (er-is? st "keyword" "when") (do (er-advance! st) (er-parse-guards st)) (list))))
           (er-expect! st "punct" "->")
           (let ((body (er-parse-body st))) {:pattern pat :body body :class klass :guards guards}))))))
+
+;; ── binary literals / patterns ────────────────────────────────
+;; `<< [Seg {, Seg}] >>` where Seg = Value [: Size] [/ Spec]. Size is
+;; a literal integer (multiple of 8 supported); Spec is `integer`
+;; (default) or `binary` (rest-of-binary tail). Sufficient for the
+;; common `<<A:8, B:16, Rest/binary>>` patterns.
+(define
+  er-parse-binary
+  (fn
+    (st)
+    (er-expect! st "punct" "<<")
+    (cond
+      (er-is? st "punct" ">>")
+      (do (er-advance! st) {:segments (list) :type "binary"})
+      :else (let
+        ((segs (list (er-parse-binary-segment st))))
+        (er-parse-binary-tail st segs)))))
+
+(define
+  er-parse-binary-tail
+  (fn
+    (st segs)
+    (cond
+      (er-is? st "punct" ",")
+      (do
+        (er-advance! st)
+        (append! segs (er-parse-binary-segment st))
+        (er-parse-binary-tail st segs))
+      (er-is? st "punct" ">>")
+      (do (er-advance! st) {:segments segs :type "binary"})
+      :else (error
+        (str
+          "Erlang parse: expected ',' or '>>' in binary, got '"
+          (er-cur-value st)
+          "'")))))
+
+(define
+  er-parse-binary-segment
+  (fn
+    (st)
+    ;; Use `er-parse-primary` for the value so a leading `:` falls
+    ;; through to the segment's size suffix instead of being eaten
+    ;; by `er-parse-postfix-loop` as a `Mod:Fun` remote call.
+    (let
+      ((v (er-parse-primary st)))
+      (let
+        ((size (cond
+                 (er-is? st "punct" ":")
+                 (do (er-advance! st) (er-parse-primary st))
+                 :else nil))
+          (spec (cond
+                  (er-is? st "op" "/")
+                  (do
+                    (er-advance! st)
+                    (let
+                      ((tok (er-cur st)))
+                      (er-advance! st)
+                      (get tok :value)))
+                  :else "integer")))
+        {:size size :spec spec :value v}))))

lib/erlang/scoreboard.json

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

lib/erlang/scoreboard.md

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

lib/erlang/test.sh

@@ -0,0 +1,260 @@
+#!/usr/bin/env bash
+# lib/erlang/test.sh — smoke-test the Erlang runtime layer.
+# Uses sx_server.exe epoch protocol.
+#
+# Usage:
+#   bash lib/erlang/test.sh
+#   bash lib/erlang/test.sh -v
+
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
+if [ ! -x "$SX_SERVER" ]; then
+  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
+fi
+if [ ! -x "$SX_SERVER" ]; then
+  echo "ERROR: sx_server.exe not found. Run: cd hosts/ocaml && dune build"
+  exit 1
+fi
+
+VERBOSE="${1:-}"
+PASS=0; FAIL=0; ERRORS=""
+TMPFILE=$(mktemp); trap "rm -f $TMPFILE" EXIT
+
+cat > "$TMPFILE" << 'EPOCHS'
+(epoch 1)
+(load "lib/erlang/runtime.sx")
+
+;; --- Numeric tower ---
+(epoch 10)
+(eval "(er-is-integer? 42)")
+(epoch 11)
+(eval "(er-is-integer? 3.14)")
+(epoch 12)
+(eval "(er-is-float? 3.14)")
+(epoch 13)
+(eval "(er-is-float? 42)")
+(epoch 14)
+(eval "(er-is-number? 42)")
+(epoch 15)
+(eval "(er-is-number? 3.14)")
+(epoch 16)
+(eval "(er-float 5)")
+(epoch 17)
+(eval "(er-trunc 3.9)")
+(epoch 18)
+(eval "(er-round 3.5)")
+(epoch 19)
+(eval "(er-abs -7)")
+(epoch 20)
+(eval "(er-max 3 7)")
+(epoch 21)
+(eval "(er-min 3 7)")
+
+;; --- div + rem ---
+(epoch 30)
+(eval "(er-div 10 3)")
+(epoch 31)
+(eval "(er-div -10 3)")
+(epoch 32)
+(eval "(er-rem 10 3)")
+(epoch 33)
+(eval "(er-rem -10 3)")
+(epoch 34)
+(eval "(er-gcd 12 8)")
+
+;; --- Bitwise ---
+(epoch 40)
+(eval "(er-band 12 10)")
+(epoch 41)
+(eval "(er-bor 12 10)")
+(epoch 42)
+(eval "(er-bxor 12 10)")
+(epoch 43)
+(eval "(er-bnot 0)")
+(epoch 44)
+(eval "(er-bsl 1 4)")
+(epoch 45)
+(eval "(er-bsr 16 2)")
+
+;; --- Sets ---
+(epoch 50)
+(eval "(er-sets-is-set? (er-sets-new))")
+(epoch 51)
+(eval "(let ((s (er-sets-new))) (do (er-sets-add-element s 1) (er-sets-is-element s 1)))")
+(epoch 52)
+(eval "(er-sets-is-element (er-sets-new) 42)")
+(epoch 53)
+(eval "(er-sets-is-element (er-sets-from-list (list 1 2 3)) 2)")
+(epoch 54)
+(eval "(er-sets-size (er-sets-from-list (list 1 2 3)))")
+(epoch 55)
+(eval "(len (er-sets-to-list (er-sets-from-list (list 1 2 3))))")
+
+;; --- Regexp ---
+(epoch 60)
+(eval "(not (= (er-re-run \"hello\" \"ll\") nil))")
+(epoch 61)
+(eval "(= (er-re-run \"hello\" \"xyz\") nil)")
+(epoch 62)
+(eval "(get (er-re-run \"hello\" \"ll\") :match)")
+(epoch 63)
+(eval "(er-re-replace \"hello\" \"l\" \"r\")")
+(epoch 64)
+(eval "(er-re-replace-all \"hello\" \"l\" \"r\")")
+(epoch 65)
+(eval "(er-re-match-groups (er-re-run \"hello world\" \"(\\w+)\\s+(\\w+)\"))")
+(epoch 66)
+(eval "(len (er-re-split \"a,b,c\" \",\"))")
+
+;; --- List BIFs ---
+(epoch 70)
+(eval "(er-hd (list 1 2 3))")
+(epoch 71)
+(eval "(er-tl (list 1 2 3))")
+(epoch 72)
+(eval "(er-length (list 1 2 3))")
+(epoch 73)
+(eval "(er-lists-member 2 (list 1 2 3))")
+(epoch 74)
+(eval "(er-lists-member 9 (list 1 2 3))")
+(epoch 75)
+(eval "(er-lists-reverse (list 1 2 3))")
+(epoch 76)
+(eval "(er-lists-nth 2 (list 10 20 30))")
+(epoch 77)
+(eval "(er-lists-foldl + 0 (list 1 2 3 4 5))")
+(epoch 78)
+(eval "(er-lists-seq 1 5)")
+(epoch 79)
+(eval "(er-lists-flatten (list 1 (list 2 3) (list 4 (list 5))))")
+
+;; --- Type conversions ---
+(epoch 80)
+(eval "(er-integer-to-list 42)")
+(epoch 81)
+(eval "(er-list-to-integer \"42\")")
+(epoch 82)
+(eval "(er-integer-to-list-radix 255 16)")
+(epoch 83)
+(eval "(er-atom-to-list (make-symbol \"hello\"))")
+(epoch 84)
+(eval "(= (type-of (er-list-to-atom \"foo\")) \"symbol\")")
+
+;; --- ok/error tuples ---
+(epoch 90)
+(eval "(er-is-ok? (er-ok 42))")
+(epoch 91)
+(eval "(er-is-error? (er-error \"reason\"))")
+(epoch 92)
+(eval "(er-unwrap (er-ok 42))")
+(epoch 93)
+(eval "(er-is-ok? (er-error \"bad\"))")
+
+EPOCHS
+
+OUTPUT=$(timeout 30 "$SX_SERVER" < "$TMPFILE" 2>/dev/null)
+
+check() {
+  local epoch="$1" desc="$2" expected="$3"
+  local actual
+  actual=$(echo "$OUTPUT" | grep -A1 "^(ok-len $epoch " | tail -1 || true)
+  if echo "$actual" | grep -q "^(ok-len"; then actual=""; fi
+  if [ -z "$actual" ]; then
+    actual=$(echo "$OUTPUT" | grep "^(ok $epoch " | head -1 || true)
+  fi
+  if [ -z "$actual" ]; then
+    actual=$(echo "$OUTPUT" | grep "^(error $epoch " | head -1 || true)
+  fi
+  [ -z "$actual" ] && actual="<no output for epoch $epoch>"
+
+  if echo "$actual" | grep -qF -- "$expected"; then
+    PASS=$((PASS+1))
+    [ "$VERBOSE" = "-v" ] && echo "  ok $desc"
+  else
+    FAIL=$((FAIL+1))
+    ERRORS+="  FAIL [$desc] (epoch $epoch) expected: $expected | actual: $actual
+"
+  fi
+}
+
+# Numeric tower
+check 10  "is-integer? 42"        "true"
+check 11  "is-integer? float"     "false"
+check 12  "is-float? 3.14"        "true"
+check 13  "is-float? int"         "false"
+check 14  "is-number? int"        "true"
+check 15  "is-number? float"      "true"
+check 16  "float 5"               "5"
+check 17  "trunc 3.9"             "3"
+check 18  "round 3.5"             "4"
+check 19  "abs -7"                "7"
+check 20  "max 3 7"               "7"
+check 21  "min 3 7"               "3"
+
+# div + rem
+check 30  "div 10 3"              "3"
+check 31  "div -10 3"             "-3"
+check 32  "rem 10 3"              "1"
+check 33  "rem -10 3"             "-1"
+check 34  "gcd 12 8"              "4"
+
+# Bitwise
+check 40  "band 12 10"            "8"
+check 41  "bor 12 10"             "14"
+check 42  "bxor 12 10"            "6"
+check 43  "bnot 0"                "-1"
+check 44  "bsl 1 4"               "16"
+check 45  "bsr 16 2"              "4"
+
+# Sets
+check 50  "sets-new is-set?"      "true"
+check 51  "sets add+member"       "true"
+check 52  "member empty"          "false"
+check 53  "from-list member"      "true"
+check 54  "sets-size"             "3"
+check 55  "sets-to-list len"      "3"
+
+# Regexp
+check 60  "re-run match"          "true"
+check 61  "re-run no match"       "true"
+check 62  "re-run match text"     '"ll"'
+check 63  "re-replace first"      '"herlo"'
+check 64  "re-replace-all"        '"herro"'
+check 65  "re-match-groups"       '"hello"'
+check 66  "re-split count"        "3"
+
+# List BIFs
+check 70  "hd"                    "1"
+check 71  "tl"                    "(2 3)"
+check 72  "length"                "3"
+check 73  "member hit"            "true"
+check 74  "member miss"           "false"
+check 75  "reverse"               "(3 2 1)"
+check 76  "nth 2"                 "20"
+check 77  "foldl sum"             "15"
+check 78  "seq 1..5"              "(1 2 3 4 5)"
+check 79  "flatten"               "(1 2 3 4 5)"
+
+# Type conversions
+check 80  "integer-to-list"       '"42"'
+check 81  "list-to-integer"       "42"
+check 82  "integer-to-list hex"   '"ff"'
+check 83  "atom-to-list"          '"hello"'
+check 84  "list-to-atom"          "true"
+
+# ok/error
+check 90  "ok? ok-tuple"          "true"
+check 91  "error? error-tuple"    "true"
+check 92  "unwrap ok"             "42"
+check 93  "ok? error-tuple"       "false"
+
+TOTAL=$((PASS+FAIL))
+if [ $FAIL -eq 0 ]; then
+  echo "ok $PASS/$TOTAL lib/erlang tests passed"
+else
+  echo "FAIL $PASS/$TOTAL passed, $FAIL failed:"
+  echo "$ERRORS"
+fi
+[ $FAIL -eq 0 ]

lib/erlang/tests/programs/bank.sx

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

lib/erlang/tests/programs/echo.sx

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

lib/erlang/tests/programs/fib_server.sx

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

lib/erlang/tests/programs/ping_pong.sx

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

lib/erlang/tests/programs/ring.sx

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

lib/erlang/tests/runtime.sx

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

lib/forth/ans-tests/README.md

@@ -0,0 +1,14 @@
+ANS Forth conformance tests — vendored from
+https://github.com/gerryjackson/forth2012-test-suite (master, commit-locked
+on first fetch: 2026-04-24).
+
+Files in this directory are pristine copies of upstream — do not edit them.
+They are consumed by the conformance runner in `lib/forth/conformance.sh`.
+
+- `tester.fr` — John Hayes' test harness (`T{ ... -> ... }T`). (C) 1995
+  Johns Hopkins APL, distributable under its notice.
+- `core.fr` — Core word set tests (Hayes, ~1000 lines).
+- `coreexttest.fth` — Core Extension tests (Gerry Jackson).
+
+Only `core.fr` is expected to run green end-to-end for Phase 3; the others
+stay parked until later phases.

lib/forth/ans-tests/coreexttest.fth

@@ -0,0 +1,775 @@
+\ To test the ANS Forth Core Extension word set
+
+\ This program was written by Gerry Jackson in 2006, with contributions from
+\ others where indicated, and is in the public domain - it can be distributed
+\ and/or modified in any way but please retain this notice.
+
+\ This program is distributed in the hope that it will be useful,
+\ but WITHOUT ANY WARRANTY; without even the implied warranty of
+\ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+\ The tests are not claimed to be comprehensive or correct 
+
+\ ------------------------------------------------------------------------------
+\ Version 0.15 1 August 2025 Added two tests to VALUE
+\         0.14 21 July 2022 Updated first line of BUFFER: test as recommended
+\              in issue 32
+\         0.13 28 October 2015
+\              Replace <FALSE> and <TRUE> with FALSE and TRUE to avoid
+\              dependence on Core tests
+\              Moved SAVE-INPUT and RESTORE-INPUT tests in a file to filetest.fth
+\              Use of 2VARIABLE (from optional wordset) replaced with CREATE.
+\              Minor lower to upper case conversions.
+\              Calls to COMPARE replaced by S= (in utilities.fth) to avoid use
+\              of a word from an optional word set.
+\              UNUSED tests revised as UNUSED UNUSED = may return FALSE when an
+\              implementation has the data stack sharing unused dataspace.
+\              Double number input dependency removed from the HOLDS tests.
+\              Minor case sensitivities removed in definition names.
+\         0.11 25 April 2015
+\              Added tests for PARSE-NAME HOLDS BUFFER:
+\              S\" tests added
+\              DEFER IS ACTION-OF DEFER! DEFER@ tests added
+\              Empty CASE statement test added
+\              [COMPILE] tests removed because it is obsolescent in Forth 2012
+\         0.10 1 August 2014
+\             Added tests contributed by James Bowman for:
+\                <> U> 0<> 0> NIP TUCK ROLL PICK 2>R 2R@ 2R>
+\                HEX WITHIN UNUSED AGAIN MARKER
+\             Added tests for:
+\                .R U.R ERASE PAD REFILL SOURCE-ID 
+\             Removed ABORT from NeverExecuted to enable Win32
+\             to continue after failure of RESTORE-INPUT.
+\             Removed max-intx which is no longer used.
+\         0.7 6 June 2012 Extra CASE test added
+\         0.6 1 April 2012 Tests placed in the public domain.
+\             SAVE-INPUT & RESTORE-INPUT tests, position
+\             of T{ moved so that tests work with ttester.fs
+\             CONVERT test deleted - obsolete word removed from Forth 200X
+\             IMMEDIATE VALUEs tested
+\             RECURSE with :NONAME tested
+\             PARSE and .( tested
+\             Parsing behaviour of C" added
+\         0.5 14 September 2011 Removed the double [ELSE] from the
+\             initial SAVE-INPUT & RESTORE-INPUT test
+\         0.4 30 November 2009  max-int replaced with max-intx to
+\             avoid redefinition warnings.
+\         0.3  6 March 2009 { and } replaced with T{ and }T
+\                           CONVERT test now independent of cell size
+\         0.2  20 April 2007 ANS Forth words changed to upper case
+\                            Tests qd3 to qd6 by Reinhold Straub
+\         0.1  Oct 2006 First version released
+\ -----------------------------------------------------------------------------
+\ The tests are based on John Hayes test program for the core word set
+
+\ Words tested in this file are:
+\     .( .R 0<> 0> 2>R 2R> 2R@ :NONAME <> ?DO AGAIN C" CASE COMPILE, ENDCASE
+\     ENDOF ERASE FALSE HEX MARKER NIP OF PAD PARSE PICK REFILL
+\     RESTORE-INPUT ROLL SAVE-INPUT SOURCE-ID TO TRUE TUCK U.R U> UNUSED
+\     VALUE WITHIN [COMPILE]
+
+\ Words not tested or partially tested:
+\     \ because it has been extensively used already and is, hence, unnecessary
+\     REFILL and SOURCE-ID from the user input device which are not possible
+\     when testing from a file such as this one
+\     UNUSED (partially tested) as the value returned is system dependent
+\     Obsolescent words #TIB CONVERT EXPECT QUERY SPAN TIB as they have been
+\     removed from the Forth 2012 standard
+
+\ Results from words that output to the user output device have to visually
+\ checked for correctness. These are .R U.R .(
+
+\ -----------------------------------------------------------------------------
+\ Assumptions & dependencies:
+\     - tester.fr (or ttester.fs), errorreport.fth and utilities.fth have been
+\       included prior to this file
+\     - the Core word set available
+\ -----------------------------------------------------------------------------
+TESTING Core Extension words
+
+DECIMAL
+
+TESTING TRUE FALSE
+
+T{ TRUE  -> 0 INVERT }T
+T{ FALSE -> 0 }T
+
+\ -----------------------------------------------------------------------------
+TESTING <> U>   (contributed by James Bowman)
+
+T{ 0 0 <> -> FALSE }T
+T{ 1 1 <> -> FALSE }T
+T{ -1 -1 <> -> FALSE }T
+T{ 1 0 <> -> TRUE }T
+T{ -1 0 <> -> TRUE }T
+T{ 0 1 <> -> TRUE }T
+T{ 0 -1 <> -> TRUE }T
+
+T{ 0 1 U> -> FALSE }T
+T{ 1 2 U> -> FALSE }T
+T{ 0 MID-UINT U> -> FALSE }T
+T{ 0 MAX-UINT U> -> FALSE }T
+T{ MID-UINT MAX-UINT U> -> FALSE }T
+T{ 0 0 U> -> FALSE }T
+T{ 1 1 U> -> FALSE }T
+T{ 1 0 U> -> TRUE }T
+T{ 2 1 U> -> TRUE }T
+T{ MID-UINT 0 U> -> TRUE }T
+T{ MAX-UINT 0 U> -> TRUE }T
+T{ MAX-UINT MID-UINT U> -> TRUE }T
+
+\ -----------------------------------------------------------------------------
+TESTING 0<> 0>   (contributed by James Bowman)
+
+T{ 0 0<> -> FALSE }T
+T{ 1 0<> -> TRUE }T
+T{ 2 0<> -> TRUE }T
+T{ -1 0<> -> TRUE }T
+T{ MAX-UINT 0<> -> TRUE }T
+T{ MIN-INT 0<> -> TRUE }T
+T{ MAX-INT 0<> -> TRUE }T
+
+T{ 0 0> -> FALSE }T
+T{ -1 0> -> FALSE }T
+T{ MIN-INT 0> -> FALSE }T
+T{ 1 0> -> TRUE }T
+T{ MAX-INT 0> -> TRUE }T
+
+\ -----------------------------------------------------------------------------
+TESTING NIP TUCK ROLL PICK   (contributed by James Bowman)
+
+T{ 1 2 NIP -> 2 }T
+T{ 1 2 3 NIP -> 1 3 }T
+
+T{ 1 2 TUCK -> 2 1 2 }T
+T{ 1 2 3 TUCK -> 1 3 2 3 }T
+
+T{ : RO5 100 200 300 400 500 ; -> }T
+T{ RO5 3 ROLL -> 100 300 400 500 200 }T
+T{ RO5 2 ROLL -> RO5 ROT }T
+T{ RO5 1 ROLL -> RO5 SWAP }T
+T{ RO5 0 ROLL -> RO5 }T
+
+T{ RO5 2 PICK -> 100 200 300 400 500 300 }T
+T{ RO5 1 PICK -> RO5 OVER }T
+T{ RO5 0 PICK -> RO5 DUP }T
+
+\ -----------------------------------------------------------------------------
+TESTING 2>R 2R@ 2R>   (contributed by James Bowman)
+
+T{ : RR0 2>R 100 R> R> ; -> }T
+T{ 300 400 RR0 -> 100 400 300 }T
+T{ 200 300 400 RR0 -> 200 100 400 300 }T
+
+T{ : RR1 2>R 100 2R@ R> R> ; -> }T
+T{ 300 400 RR1 -> 100 300 400 400 300 }T
+T{ 200 300 400 RR1 -> 200 100 300 400 400 300 }T
+
+T{ : RR2 2>R 100 2R> ; -> }T
+T{ 300 400 RR2 -> 100 300 400 }T
+T{ 200 300 400 RR2 -> 200 100 300 400 }T
+
+\ -----------------------------------------------------------------------------
+TESTING HEX   (contributed by James Bowman)
+
+T{ BASE @ HEX BASE @ DECIMAL BASE @ - SWAP BASE ! -> 6 }T
+
+\ -----------------------------------------------------------------------------
+TESTING WITHIN   (contributed by James Bowman)
+
+T{ 0 0 0 WITHIN -> FALSE }T
+T{ 0 0 MID-UINT WITHIN -> TRUE }T
+T{ 0 0 MID-UINT+1 WITHIN -> TRUE }T
+T{ 0 0 MAX-UINT WITHIN -> TRUE }T
+T{ 0 MID-UINT 0 WITHIN -> FALSE }T
+T{ 0 MID-UINT MID-UINT WITHIN -> FALSE }T
+T{ 0 MID-UINT MID-UINT+1 WITHIN -> FALSE }T
+T{ 0 MID-UINT MAX-UINT WITHIN -> FALSE }T
+T{ 0 MID-UINT+1 0 WITHIN -> FALSE }T
+T{ 0 MID-UINT+1 MID-UINT WITHIN -> TRUE }T
+T{ 0 MID-UINT+1 MID-UINT+1 WITHIN -> FALSE }T
+T{ 0 MID-UINT+1 MAX-UINT WITHIN -> FALSE }T
+T{ 0 MAX-UINT 0 WITHIN -> FALSE }T
+T{ 0 MAX-UINT MID-UINT WITHIN -> TRUE }T
+T{ 0 MAX-UINT MID-UINT+1 WITHIN -> TRUE }T
+T{ 0 MAX-UINT MAX-UINT WITHIN -> FALSE }T
+T{ MID-UINT 0 0 WITHIN -> FALSE }T
+T{ MID-UINT 0 MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT 0 MID-UINT+1 WITHIN -> TRUE }T
+T{ MID-UINT 0 MAX-UINT WITHIN -> TRUE }T
+T{ MID-UINT MID-UINT 0 WITHIN -> TRUE }T
+T{ MID-UINT MID-UINT MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT MID-UINT MID-UINT+1 WITHIN -> TRUE }T
+T{ MID-UINT MID-UINT MAX-UINT WITHIN -> TRUE }T
+T{ MID-UINT MID-UINT+1 0 WITHIN -> FALSE }T
+T{ MID-UINT MID-UINT+1 MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT MID-UINT+1 MID-UINT+1 WITHIN -> FALSE }T
+T{ MID-UINT MID-UINT+1 MAX-UINT WITHIN -> FALSE }T
+T{ MID-UINT MAX-UINT 0 WITHIN -> FALSE }T
+T{ MID-UINT MAX-UINT MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT MAX-UINT MID-UINT+1 WITHIN -> TRUE }T
+T{ MID-UINT MAX-UINT MAX-UINT WITHIN -> FALSE }T
+T{ MID-UINT+1 0 0 WITHIN -> FALSE }T
+T{ MID-UINT+1 0 MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT+1 0 MID-UINT+1 WITHIN -> FALSE }T
+T{ MID-UINT+1 0 MAX-UINT WITHIN -> TRUE }T
+T{ MID-UINT+1 MID-UINT 0 WITHIN -> TRUE }T
+T{ MID-UINT+1 MID-UINT MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT+1 MID-UINT MID-UINT+1 WITHIN -> FALSE }T
+T{ MID-UINT+1 MID-UINT MAX-UINT WITHIN -> TRUE }T
+T{ MID-UINT+1 MID-UINT+1 0 WITHIN -> TRUE }T
+T{ MID-UINT+1 MID-UINT+1 MID-UINT WITHIN -> TRUE }T
+T{ MID-UINT+1 MID-UINT+1 MID-UINT+1 WITHIN -> FALSE }T
+T{ MID-UINT+1 MID-UINT+1 MAX-UINT WITHIN -> TRUE }T
+T{ MID-UINT+1 MAX-UINT 0 WITHIN -> FALSE }T
+T{ MID-UINT+1 MAX-UINT MID-UINT WITHIN -> FALSE }T
+T{ MID-UINT+1 MAX-UINT MID-UINT+1 WITHIN -> FALSE }T
+T{ MID-UINT+1 MAX-UINT MAX-UINT WITHIN -> FALSE }T
+T{ MAX-UINT 0 0 WITHIN -> FALSE }T
+T{ MAX-UINT 0 MID-UINT WITHIN -> FALSE }T
+T{ MAX-UINT 0 MID-UINT+1 WITHIN -> FALSE }T
+T{ MAX-UINT 0 MAX-UINT WITHIN -> FALSE }T
+T{ MAX-UINT MID-UINT 0 WITHIN -> TRUE }T
+T{ MAX-UINT MID-UINT MID-UINT WITHIN -> FALSE }T
+T{ MAX-UINT MID-UINT MID-UINT+1 WITHIN -> FALSE }T
+T{ MAX-UINT MID-UINT MAX-UINT WITHIN -> FALSE }T
+T{ MAX-UINT MID-UINT+1 0 WITHIN -> TRUE }T
+T{ MAX-UINT MID-UINT+1 MID-UINT WITHIN -> TRUE }T
+T{ MAX-UINT MID-UINT+1 MID-UINT+1 WITHIN -> FALSE }T
+T{ MAX-UINT MID-UINT+1 MAX-UINT WITHIN -> FALSE }T
+T{ MAX-UINT MAX-UINT 0 WITHIN -> TRUE }T
+T{ MAX-UINT MAX-UINT MID-UINT WITHIN -> TRUE }T
+T{ MAX-UINT MAX-UINT MID-UINT+1 WITHIN -> TRUE }T
+T{ MAX-UINT MAX-UINT MAX-UINT WITHIN -> FALSE }T
+
+T{ MIN-INT MIN-INT MIN-INT WITHIN -> FALSE }T
+T{ MIN-INT MIN-INT 0 WITHIN -> TRUE }T
+T{ MIN-INT MIN-INT 1 WITHIN -> TRUE }T
+T{ MIN-INT MIN-INT MAX-INT WITHIN -> TRUE }T
+T{ MIN-INT 0 MIN-INT WITHIN -> FALSE }T
+T{ MIN-INT 0 0 WITHIN -> FALSE }T
+T{ MIN-INT 0 1 WITHIN -> FALSE }T
+T{ MIN-INT 0 MAX-INT WITHIN -> FALSE }T
+T{ MIN-INT 1 MIN-INT WITHIN -> FALSE }T
+T{ MIN-INT 1 0 WITHIN -> TRUE }T
+T{ MIN-INT 1 1 WITHIN -> FALSE }T
+T{ MIN-INT 1 MAX-INT WITHIN -> FALSE }T
+T{ MIN-INT MAX-INT MIN-INT WITHIN -> FALSE }T
+T{ MIN-INT MAX-INT 0 WITHIN -> TRUE }T
+T{ MIN-INT MAX-INT 1 WITHIN -> TRUE }T
+T{ MIN-INT MAX-INT MAX-INT WITHIN -> FALSE }T
+T{ 0 MIN-INT MIN-INT WITHIN -> FALSE }T
+T{ 0 MIN-INT 0 WITHIN -> FALSE }T
+T{ 0 MIN-INT 1 WITHIN -> TRUE }T
+T{ 0 MIN-INT MAX-INT WITHIN -> TRUE }T
+T{ 0 0 MIN-INT WITHIN -> TRUE }T
+T{ 0 0 0 WITHIN -> FALSE }T
+T{ 0 0 1 WITHIN -> TRUE }T
+T{ 0 0 MAX-INT WITHIN -> TRUE }T
+T{ 0 1 MIN-INT WITHIN -> FALSE }T
+T{ 0 1 0 WITHIN -> FALSE }T
+T{ 0 1 1 WITHIN -> FALSE }T
+T{ 0 1 MAX-INT WITHIN -> FALSE }T
+T{ 0 MAX-INT MIN-INT WITHIN -> FALSE }T
+T{ 0 MAX-INT 0 WITHIN -> FALSE }T
+T{ 0 MAX-INT 1 WITHIN -> TRUE }T
+T{ 0 MAX-INT MAX-INT WITHIN -> FALSE }T
+T{ 1 MIN-INT MIN-INT WITHIN -> FALSE }T
+T{ 1 MIN-INT 0 WITHIN -> FALSE }T
+T{ 1 MIN-INT 1 WITHIN -> FALSE }T
+T{ 1 MIN-INT MAX-INT WITHIN -> TRUE }T
+T{ 1 0 MIN-INT WITHIN -> TRUE }T
+T{ 1 0 0 WITHIN -> FALSE }T
+T{ 1 0 1 WITHIN -> FALSE }T
+T{ 1 0 MAX-INT WITHIN -> TRUE }T
+T{ 1 1 MIN-INT WITHIN -> TRUE }T
+T{ 1 1 0 WITHIN -> TRUE }T
+T{ 1 1 1 WITHIN -> FALSE }T
+T{ 1 1 MAX-INT WITHIN -> TRUE }T
+T{ 1 MAX-INT MIN-INT WITHIN -> FALSE }T
+T{ 1 MAX-INT 0 WITHIN -> FALSE }T
+T{ 1 MAX-INT 1 WITHIN -> FALSE }T
+T{ 1 MAX-INT MAX-INT WITHIN -> FALSE }T
+T{ MAX-INT MIN-INT MIN-INT WITHIN -> FALSE }T
+T{ MAX-INT MIN-INT 0 WITHIN -> FALSE }T
+T{ MAX-INT MIN-INT 1 WITHIN -> FALSE }T
+T{ MAX-INT MIN-INT MAX-INT WITHIN -> FALSE }T
+T{ MAX-INT 0 MIN-INT WITHIN -> TRUE }T
+T{ MAX-INT 0 0 WITHIN -> FALSE }T
+T{ MAX-INT 0 1 WITHIN -> FALSE }T
+T{ MAX-INT 0 MAX-INT WITHIN -> FALSE }T
+T{ MAX-INT 1 MIN-INT WITHIN -> TRUE }T
+T{ MAX-INT 1 0 WITHIN -> TRUE }T
+T{ MAX-INT 1 1 WITHIN -> FALSE }T
+T{ MAX-INT 1 MAX-INT WITHIN -> FALSE }T
+T{ MAX-INT MAX-INT MIN-INT WITHIN -> TRUE }T
+T{ MAX-INT MAX-INT 0 WITHIN -> TRUE }T
+T{ MAX-INT MAX-INT 1 WITHIN -> TRUE }T
+T{ MAX-INT MAX-INT MAX-INT WITHIN -> FALSE }T
+
+\ -----------------------------------------------------------------------------
+TESTING UNUSED  (contributed by James Bowman & Peter Knaggs)
+
+VARIABLE UNUSED0
+T{ UNUSED DROP -> }T                  
+T{ ALIGN UNUSED UNUSED0 ! 0 , UNUSED CELL+ UNUSED0 @ = -> TRUE }T
+T{ UNUSED UNUSED0 ! 0 C, UNUSED CHAR+ UNUSED0 @ =
+         -> TRUE }T  \ aligned -> unaligned
+T{ UNUSED UNUSED0 ! 0 C, UNUSED CHAR+ UNUSED0 @ = -> TRUE }T  \ unaligned -> ?
+
+\ -----------------------------------------------------------------------------
+TESTING AGAIN   (contributed by James Bowman)
+
+T{ : AG0 701 BEGIN DUP 7 MOD 0= IF EXIT THEN 1+ AGAIN ; -> }T
+T{ AG0 -> 707 }T
+
+\ -----------------------------------------------------------------------------
+TESTING MARKER   (contributed by James Bowman)
+
+T{ : MA? BL WORD FIND NIP 0<> ; -> }T
+T{ MARKER MA0 -> }T
+T{ : MA1 111 ; -> }T
+T{ MARKER MA2 -> }T
+T{ : MA1 222 ; -> }T
+T{ MA? MA0 MA? MA1 MA? MA2 -> TRUE TRUE TRUE }T
+T{ MA1 MA2 MA1 -> 222 111 }T
+T{ MA? MA0 MA? MA1 MA? MA2 -> TRUE TRUE FALSE }T
+T{ MA0 -> }T
+T{ MA? MA0 MA? MA1 MA? MA2 -> FALSE FALSE FALSE }T
+
+\ -----------------------------------------------------------------------------
+TESTING ?DO
+
+: QD ?DO I LOOP ;
+T{ 789 789 QD -> }T
+T{ -9876 -9876 QD -> }T
+T{ 5 0 QD -> 0 1 2 3 4 }T
+
+: QD1 ?DO I 10 +LOOP ;
+T{ 50 1 QD1 -> 1 11 21 31 41 }T
+T{ 50 0 QD1 -> 0 10 20 30 40 }T
+
+: QD2 ?DO I 3 > IF LEAVE ELSE I THEN LOOP ;
+T{ 5 -1 QD2 -> -1 0 1 2 3 }T
+
+: QD3 ?DO I 1 +LOOP ;
+T{ 4  4 QD3 -> }T
+T{ 4  1 QD3 -> 1 2 3 }T
+T{ 2 -1 QD3 -> -1 0 1 }T
+
+: QD4 ?DO I -1 +LOOP ;
+T{  4 4 QD4 -> }T
+T{  1 4 QD4 -> 4 3 2 1 }T
+T{ -1 2 QD4 -> 2 1 0 -1 }T
+
+: QD5 ?DO I -10 +LOOP ;
+T{   1 50 QD5 -> 50 40 30 20 10 }T
+T{   0 50 QD5 -> 50 40 30 20 10 0 }T
+T{ -25 10 QD5 -> 10 0 -10 -20 }T
+
+VARIABLE ITERS
+VARIABLE INCRMNT
+
+: QD6 ( limit start increment -- )
+   INCRMNT !
+   0 ITERS !
+   ?DO
+      1 ITERS +!
+      I
+      ITERS @  6 = IF LEAVE THEN
+      INCRMNT @
+   +LOOP ITERS @
+;
+
+T{  4  4 -1 QD6 -> 0 }T
+T{  1  4 -1 QD6 -> 4 3 2 1 4 }T
+T{  4  1 -1 QD6 -> 1 0 -1 -2 -3 -4 6 }T
+T{  4  1  0 QD6 -> 1 1 1 1 1 1 6 }T
+T{  0  0  0 QD6 -> 0 }T
+T{  1  4  0 QD6 -> 4 4 4 4 4 4 6 }T
+T{  1  4  1 QD6 -> 4 5 6 7 8 9 6 }T
+T{  4  1  1 QD6 -> 1 2 3 3 }T
+T{  4  4  1 QD6 -> 0 }T
+T{  2 -1 -1 QD6 -> -1 -2 -3 -4 -5 -6 6 }T
+T{ -1  2 -1 QD6 -> 2 1 0 -1 4 }T
+T{  2 -1  0 QD6 -> -1 -1 -1 -1 -1 -1 6 }T
+T{ -1  2  0 QD6 -> 2 2 2 2 2 2 6 }T
+T{ -1  2  1 QD6 -> 2 3 4 5 6 7 6 }T
+T{  2 -1  1 QD6 -> -1 0 1 3 }T
+
+\ -----------------------------------------------------------------------------
+TESTING BUFFER:
+
+T{ 2 CELLS BUFFER: BUF:TEST -> }T
+T{ BUF:TEST DUP ALIGNED = -> TRUE }T
+T{ 111 BUF:TEST ! 222 BUF:TEST CELL+ ! -> }T
+T{ BUF:TEST @ BUF:TEST CELL+ @ -> 111 222 }T
+
+\ -----------------------------------------------------------------------------
+TESTING VALUE TO
+
+T{ 111 VALUE VAL1 -999 VALUE VAL2 -> }T
+T{ VAL1 -> 111 }T
+T{ VAL2 -> -999 }T
+T{ 222 TO VAL1 -> }T
+T{ VAL1 -> 222 }T
+T{ : VD1 VAL1 ; -> }T
+T{ VD1 -> 222 }T
+T{ : VD2 TO VAL2 ; -> }T
+T{ VAL2 -> -999 }T
+T{ -333 VD2 -> }T
+T{ VAL2 -> -333 }T
+T{ VAL1 -> 222 }T
+T{ 444 TO VAL1 -> }T
+T{ VD1 -> 444 }T
+T{ 123 VALUE VAL3 IMMEDIATE VAL3 -> 123 }T
+T{ : VD3 VAL3 LITERAL ; VD3 -> 123 }T
+
+\ -----------------------------------------------------------------------------
+TESTING CASE OF ENDOF ENDCASE
+
+: CS1 CASE 1 OF 111 ENDOF
+           2 OF 222 ENDOF
+           3 OF 333 ENDOF
+           >R 999 R>
+      ENDCASE
+;
+
+T{ 1 CS1 -> 111 }T
+T{ 2 CS1 -> 222 }T
+T{ 3 CS1 -> 333 }T
+T{ 4 CS1 -> 999 }T
+
+\ Nested CASE's
+
+: CS2 >R CASE -1 OF CASE R@ 1 OF 100 ENDOF
+                            2 OF 200 ENDOF
+                           >R -300 R>
+                    ENDCASE
+                 ENDOF
+              -2 OF CASE R@ 1 OF -99  ENDOF
+                            >R -199 R>
+                    ENDCASE
+                 ENDOF
+                 >R 299 R>
+         ENDCASE R> DROP
+;
+
+T{ -1 1 CS2 ->  100 }T
+T{ -1 2 CS2 ->  200 }T
+T{ -1 3 CS2 -> -300 }T
+T{ -2 1 CS2 -> -99  }T
+T{ -2 2 CS2 -> -199 }T
+T{  0 2 CS2 ->  299 }T
+
+\ Boolean short circuiting using CASE
+
+: CS3  ( N1 -- N2 )
+   CASE 1- FALSE OF 11 ENDOF
+        1- FALSE OF 22 ENDOF
+        1- FALSE OF 33 ENDOF
+        44 SWAP
+   ENDCASE
+;
+
+T{ 1 CS3 -> 11 }T
+T{ 2 CS3 -> 22 }T
+T{ 3 CS3 -> 33 }T
+T{ 9 CS3 -> 44 }T
+
+\ Empty CASE statements with/without default
+
+T{ : CS4 CASE ENDCASE ; 1 CS4 -> }T
+T{ : CS5 CASE 2 SWAP ENDCASE ; 1 CS5 -> 2 }T
+T{ : CS6 CASE 1 OF ENDOF 2 ENDCASE ; 1 CS6 -> }T
+T{ : CS7 CASE 3 OF ENDOF 2 ENDCASE ; 1 CS7 -> 1 }T
+
+\ -----------------------------------------------------------------------------
+TESTING :NONAME RECURSE
+
+VARIABLE NN1
+VARIABLE NN2
+:NONAME 1234 ; NN1 !
+:NONAME 9876 ; NN2 !
+T{ NN1 @ EXECUTE -> 1234 }T
+T{ NN2 @ EXECUTE -> 9876 }T
+
+T{ :NONAME ( n -- 0,1,..n ) DUP IF DUP >R 1- RECURSE R> THEN ;
+   CONSTANT RN1 -> }T
+T{ 0 RN1 EXECUTE -> 0 }T
+T{ 4 RN1 EXECUTE -> 0 1 2 3 4 }T
+
+:NONAME  ( n -- n1 )    \ Multiple RECURSEs in one definition
+   1- DUP
+   CASE 0 OF EXIT ENDOF
+        1 OF 11 SWAP RECURSE ENDOF
+        2 OF 22 SWAP RECURSE ENDOF
+        3 OF 33 SWAP RECURSE ENDOF
+        DROP ABS RECURSE EXIT
+   ENDCASE
+; CONSTANT RN2
+
+T{  1 RN2 EXECUTE -> 0 }T
+T{  2 RN2 EXECUTE -> 11 0 }T
+T{  4 RN2 EXECUTE -> 33 22 11 0 }T
+T{ 25 RN2 EXECUTE -> 33 22 11 0 }T
+
+\ -----------------------------------------------------------------------------
+TESTING C"
+
+T{ : CQ1 C" 123" ; -> }T
+T{ CQ1 COUNT EVALUATE -> 123 }T
+T{ : CQ2 C" " ; -> }T
+T{ CQ2 COUNT EVALUATE -> }T
+T{ : CQ3 C" 2345"COUNT EVALUATE ; CQ3 -> 2345 }T
+
+\ -----------------------------------------------------------------------------
+TESTING COMPILE,
+
+:NONAME DUP + ; CONSTANT DUP+
+T{ : Q DUP+ COMPILE, ; -> }T
+T{ : AS1 [ Q ] ; -> }T
+T{ 123 AS1 -> 246 }T
+
+\ -----------------------------------------------------------------------------
+\ Cannot automatically test SAVE-INPUT and RESTORE-INPUT from a console source
+
+TESTING SAVE-INPUT and RESTORE-INPUT with a string source
+
+VARIABLE SI_INC 0 SI_INC !
+
+: SI1
+   SI_INC @ >IN +!
+   15 SI_INC !
+;
+
+: S$ S" SAVE-INPUT SI1 RESTORE-INPUT 12345" ;
+
+T{ S$ EVALUATE SI_INC @ -> 0 2345 15 }T
+
+\ -----------------------------------------------------------------------------
+TESTING .(
+
+CR CR .( Output from .() 
+T{ CR .( You should see -9876: ) -9876 . -> }T
+T{ CR .( and again: ).( -9876)CR -> }T
+
+CR CR .( On the next 2 lines you should see First then Second messages:)
+T{ : DOTP  CR ." Second message via ." [CHAR] " EMIT    \ Check .( is immediate
+     [ CR ] .( First message via .( ) ; DOTP -> }T
+CR CR
+T{ : IMM? BL WORD FIND NIP ; IMM? .( -> 1 }T
+
+\ -----------------------------------------------------------------------------
+TESTING .R and U.R - has to handle different cell sizes
+
+\ Create some large integers just below/above MAX and Min INTs
+MAX-INT 73 79 */ CONSTANT LI1
+MIN-INT 71 73 */ CONSTANT LI2
+
+LI1 0 <# #S #> NIP CONSTANT LENLI1
+
+: (.R&U.R)  ( u1 u2 -- )  \ u1 <= string length, u2 is required indentation
+   TUCK + >R
+   LI1 OVER SPACES  . CR R@    LI1 SWAP  .R CR
+   LI2 OVER SPACES  . CR R@ 1+ LI2 SWAP  .R CR
+   LI1 OVER SPACES U. CR R@    LI1 SWAP U.R CR
+   LI2 SWAP SPACES U. CR R>    LI2 SWAP U.R CR
+;
+
+: .R&U.R  ( -- )
+   CR ." You should see lines duplicated:" CR
+   ." indented by 0 spaces" CR 0      0 (.R&U.R) CR
+   ." indented by 0 spaces" CR LENLI1 0 (.R&U.R) CR \ Just fits required width
+   ." indented by 5 spaces" CR LENLI1 5 (.R&U.R) CR
+;
+
+CR CR .( Output from .R and U.R)
+T{ .R&U.R -> }T
+
+\ -----------------------------------------------------------------------------
+TESTING PAD ERASE
+\ Must handle different size characters i.e. 1 CHARS >= 1 
+
+84 CONSTANT CHARS/PAD      \ Minimum size of PAD in chars
+CHARS/PAD CHARS CONSTANT AUS/PAD
+: CHECKPAD  ( caddr u ch -- f )  \ f = TRUE if u chars = ch
+   SWAP 0
+   ?DO
+      OVER I CHARS + C@ OVER <>
+      IF 2DROP UNLOOP FALSE EXIT THEN
+   LOOP  
+   2DROP TRUE
+;
+
+T{ PAD DROP -> }T
+T{ 0 INVERT PAD C! -> }T
+T{ PAD C@ CONSTANT MAXCHAR -> }T
+T{ PAD CHARS/PAD 2DUP MAXCHAR FILL MAXCHAR CHECKPAD -> TRUE }T
+T{ PAD CHARS/PAD 2DUP CHARS ERASE 0 CHECKPAD -> TRUE }T
+T{ PAD CHARS/PAD 2DUP MAXCHAR FILL PAD 0 ERASE MAXCHAR CHECKPAD -> TRUE }T
+T{ PAD 43 CHARS + 9 CHARS ERASE -> }T
+T{ PAD 43 MAXCHAR CHECKPAD -> TRUE }T
+T{ PAD 43 CHARS + 9 0 CHECKPAD -> TRUE }T
+T{ PAD 52 CHARS + CHARS/PAD 52 - MAXCHAR CHECKPAD -> TRUE }T
+
+\ Check that use of WORD and pictured numeric output do not corrupt PAD
+\ Minimum size of buffers for these are 33 chars and (2*n)+2 chars respectively
+\ where n is number of bits per cell
+
+PAD CHARS/PAD ERASE
+2 BASE !
+MAX-UINT MAX-UINT <# #S CHAR 1 DUP HOLD HOLD #> 2DROP
+DECIMAL
+BL WORD 12345678123456781234567812345678 DROP
+T{ PAD CHARS/PAD 0 CHECKPAD -> TRUE }T
+
+\ -----------------------------------------------------------------------------
+TESTING PARSE
+
+T{ CHAR | PARSE 1234| DUP ROT ROT EVALUATE -> 4 1234 }T
+T{ CHAR ^ PARSE  23 45 ^ DUP ROT ROT EVALUATE -> 7 23 45 }T
+: PA1 [CHAR] $ PARSE DUP >R PAD SWAP CHARS MOVE PAD R> ;
+T{ PA1 3456
+   DUP ROT ROT EVALUATE -> 4 3456 }T
+T{ CHAR A PARSE A SWAP DROP -> 0 }T
+T{ CHAR Z PARSE
+   SWAP DROP -> 0 }T
+T{ CHAR " PARSE 4567 "DUP ROT ROT EVALUATE -> 5 4567 }T
+ 
+\ -----------------------------------------------------------------------------
+TESTING PARSE-NAME  (Forth 2012)
+\ Adapted from the PARSE-NAME RfD tests
+
+T{ PARSE-NAME abcd  STR1  S= -> TRUE }T        \ No leading spaces
+T{ PARSE-NAME      abcde STR2 S= -> TRUE }T    \ Leading spaces
+
+\ Test empty parse area, new lines are necessary
+T{ PARSE-NAME
+  NIP -> 0 }T
+\ Empty parse area with spaces after PARSE-NAME
+T{ PARSE-NAME         
+  NIP -> 0 }T
+
+T{ : PARSE-NAME-TEST ( "name1" "name2" -- n )
+    PARSE-NAME PARSE-NAME S= ; -> }T
+T{ PARSE-NAME-TEST abcd abcd  -> TRUE }T
+T{ PARSE-NAME-TEST abcd   abcd  -> TRUE }T  \ Leading spaces
+T{ PARSE-NAME-TEST abcde abcdf -> FALSE }T
+T{ PARSE-NAME-TEST abcdf abcde -> FALSE }T
+T{ PARSE-NAME-TEST abcde abcde
+   -> TRUE }T         \ Parse to end of line
+T{ PARSE-NAME-TEST abcde           abcde         
+   -> TRUE }T         \ Leading and trailing spaces
+
+\ -----------------------------------------------------------------------------
+TESTING DEFER DEFER@ DEFER! IS ACTION-OF (Forth 2012)
+\ Adapted from the Forth 200X RfD tests
+
+T{ DEFER DEFER1 -> }T
+T{ : MY-DEFER DEFER ; -> }T
+T{ : IS-DEFER1 IS DEFER1 ; -> }T
+T{ : ACTION-DEFER1 ACTION-OF DEFER1 ; -> }T
+T{ : DEF! DEFER! ; -> }T
+T{ : DEF@ DEFER@ ; -> }T
+
+T{ ' * ' DEFER1 DEFER! -> }T
+T{ 2 3 DEFER1 -> 6 }T
+T{ ' DEFER1 DEFER@ -> ' * }T
+T{ ' DEFER1 DEF@ -> ' * }T
+T{ ACTION-OF DEFER1 -> ' * }T
+T{ ACTION-DEFER1 -> ' * }T
+T{ ' + IS DEFER1 -> }T
+T{ 1 2 DEFER1 -> 3 }T
+T{ ' DEFER1 DEFER@ -> ' + }T
+T{ ' DEFER1 DEF@ -> ' + }T
+T{ ACTION-OF DEFER1 -> ' + }T
+T{ ACTION-DEFER1 -> ' + }T
+T{ ' - IS-DEFER1 -> }T
+T{ 1 2 DEFER1 -> -1 }T
+T{ ' DEFER1 DEFER@ -> ' - }T
+T{ ' DEFER1 DEF@ -> ' - }T
+T{ ACTION-OF DEFER1 -> ' - }T
+T{ ACTION-DEFER1 -> ' - }T
+
+T{ MY-DEFER DEFER2 -> }T
+T{ ' DUP IS DEFER2 -> }T
+T{ 1 DEFER2 -> 1 1 }T
+
+\ -----------------------------------------------------------------------------
+TESTING HOLDS  (Forth 2012)
+
+: HTEST S" Testing HOLDS" ;
+: HTEST2 S" works" ;
+: HTEST3 S" Testing HOLDS works 123" ;
+T{ 0 0 <#  HTEST HOLDS #> HTEST S= -> TRUE }T
+T{ 123 0 <# #S BL HOLD HTEST2 HOLDS BL HOLD HTEST HOLDS #>
+   HTEST3 S= -> TRUE }T
+T{ : HLD HOLDS ; -> }T
+T{ 0 0 <#  HTEST HLD #> HTEST S= -> TRUE }T
+
+\ -----------------------------------------------------------------------------
+TESTING REFILL SOURCE-ID
+\ REFILL and SOURCE-ID from the user input device can't be tested from a file,
+\ can only be tested from a string via EVALUATE
+
+T{ : RF1  S" REFILL" EVALUATE ; RF1 -> FALSE }T
+T{ : SID1  S" SOURCE-ID" EVALUATE ; SID1 -> -1 }T
+
+\ ------------------------------------------------------------------------------
+TESTING S\"  (Forth 2012 compilation mode)
+\ Extended the Forth 200X RfD tests
+\ Note this tests the Core Ext definition of S\" which has unedfined
+\ interpretation semantics. S\" in interpretation mode is tested in the tests on
+\ the File-Access word set
+
+T{ : SSQ1 S\" abc" S" abc" S= ; -> }T  \ No escapes
+T{ SSQ1 -> TRUE }T
+T{ : SSQ2 S\" " ; SSQ2 SWAP DROP -> 0 }T    \ Empty string
+
+T{ : SSQ3 S\" \a\b\e\f\l\m\q\r\t\v\x0F0\x1Fa\xaBx\z\"\\" ; -> }T
+T{ SSQ3 SWAP DROP          ->  20 }T    \ String length
+T{ SSQ3 DROP            C@ ->   7 }T    \ \a   BEL  Bell
+T{ SSQ3 DROP  1 CHARS + C@ ->   8 }T    \ \b   BS   Backspace
+T{ SSQ3 DROP  2 CHARS + C@ ->  27 }T    \ \e   ESC  Escape
+T{ SSQ3 DROP  3 CHARS + C@ ->  12 }T    \ \f   FF   Form feed
+T{ SSQ3 DROP  4 CHARS + C@ ->  10 }T    \ \l   LF   Line feed
+T{ SSQ3 DROP  5 CHARS + C@ ->  13 }T    \ \m        CR of CR/LF pair
+T{ SSQ3 DROP  6 CHARS + C@ ->  10 }T    \           LF of CR/LF pair
+T{ SSQ3 DROP  7 CHARS + C@ ->  34 }T    \ \q   "    Double Quote
+T{ SSQ3 DROP  8 CHARS + C@ ->  13 }T    \ \r   CR   Carriage Return
+T{ SSQ3 DROP  9 CHARS + C@ ->   9 }T    \ \t   TAB  Horizontal Tab
+T{ SSQ3 DROP 10 CHARS + C@ ->  11 }T    \ \v   VT   Vertical Tab
+T{ SSQ3 DROP 11 CHARS + C@ ->  15 }T    \ \x0F      Given Char
+T{ SSQ3 DROP 12 CHARS + C@ ->  48 }T    \ 0    0    Digit follow on
+T{ SSQ3 DROP 13 CHARS + C@ ->  31 }T    \ \x1F      Given Char
+T{ SSQ3 DROP 14 CHARS + C@ ->  97 }T    \ a    a    Hex follow on
+T{ SSQ3 DROP 15 CHARS + C@ -> 171 }T    \ \xaB      Insensitive Given Char
+T{ SSQ3 DROP 16 CHARS + C@ -> 120 }T    \ x    x    Non hex follow on
+T{ SSQ3 DROP 17 CHARS + C@ ->   0 }T    \ \z   NUL  No Character
+T{ SSQ3 DROP 18 CHARS + C@ ->  34 }T    \ \"   "    Double Quote
+T{ SSQ3 DROP 19 CHARS + C@ ->  92 }T    \ \\   \    Back Slash
+
+\ The above does not test \n as this is a system dependent value.
+\ Check it displays a new line
+CR .( The next test should display:)
+CR .( One line...)
+CR .( another line)
+T{ : SSQ4 S\" \nOne line...\nanotherLine\n" TYPE ; SSQ4 -> }T
+
+\ Test bare escapable characters appear as themselves
+T{ : SSQ5 S\" abeflmnqrtvxz" S" abeflmnqrtvxz" S= ; SSQ5 -> TRUE }T
+
+T{ : SSQ6 S\" a\""2DROP 1111 ; SSQ6 -> 1111 }T \ Parsing behaviour
+
+T{ : SSQ7  S\" 111 : SSQ8 S\\\" 222\" EVALUATE ; SSQ8 333" EVALUATE ; -> }T
+T{ SSQ7 -> 111 222 333 }T
+T{ : SSQ9  S\" 11 : SSQ10 S\\\" \\x32\\x32\" EVALUATE ; SSQ10 33" EVALUATE ; -> }T
+T{ SSQ9 -> 11 22 33 }T
+
+\ -----------------------------------------------------------------------------
+CORE-EXT-ERRORS SET-ERROR-COUNT
+
+CR .( End of Core Extension word tests) CR
+
+

lib/forth/ans-tests/tester.fr

@@ -0,0 +1,66 @@
+\ From: John Hayes S1I
+\ Subject: tester.fr
+\ Date: Mon, 27 Nov 95 13:10:09 PST  
+
+\ (C) 1995 JOHNS HOPKINS UNIVERSITY / APPLIED PHYSICS LABORATORY
+\ MAY BE DISTRIBUTED FREELY AS LONG AS THIS COPYRIGHT NOTICE REMAINS.
+\ VERSION 1.2
+
+\ 24/11/2015 Replaced Core Ext word <> with = 0=
+\ 31/3/2015 Variable #ERRORS added and incremented for each error reported.
+\ 22/1/09 The words { and } have been changed to T{ and }T respectively to
+\ agree with the Forth 200X file ttester.fs. This avoids clashes with
+\ locals using { ... } and the FSL use of } 
+
+HEX
+
+\ SET THE FOLLOWING FLAG TO TRUE FOR MORE VERBOSE OUTPUT; THIS MAY
+\ ALLOW YOU TO TELL WHICH TEST CAUSED YOUR SYSTEM TO HANG.
+VARIABLE VERBOSE
+   FALSE VERBOSE !
+\   TRUE VERBOSE !
+
+: EMPTY-STACK   \ ( ... -- ) EMPTY STACK: HANDLES UNDERFLOWED STACK TOO.
+   DEPTH ?DUP IF DUP 0< IF NEGATE 0 DO 0 LOOP ELSE 0 DO DROP LOOP THEN THEN ;
+
+VARIABLE #ERRORS 0 #ERRORS !
+
+: ERROR      \ ( C-ADDR U -- ) DISPLAY AN ERROR MESSAGE FOLLOWED BY
+      \ THE LINE THAT HAD THE ERROR.
+   CR TYPE SOURCE TYPE       \ DISPLAY LINE CORRESPONDING TO ERROR
+   EMPTY-STACK               \ THROW AWAY EVERY THING ELSE
+   #ERRORS @ 1 + #ERRORS !
+\   QUIT  \ *** Uncomment this line to QUIT on an error
+;
+
+VARIABLE ACTUAL-DEPTH         \ STACK RECORD
+CREATE ACTUAL-RESULTS 20 CELLS ALLOT
+
+: T{      \ ( -- ) SYNTACTIC SUGAR.
+   ;
+
+: ->      \ ( ... -- ) RECORD DEPTH AND CONTENT OF STACK.
+   DEPTH DUP ACTUAL-DEPTH !      \ RECORD DEPTH
+   ?DUP IF            \ IF THERE IS SOMETHING ON STACK
+      0 DO ACTUAL-RESULTS I CELLS + ! LOOP \ SAVE THEM
+   THEN ;
+
+: }T      \ ( ... -- ) COMPARE STACK (EXPECTED) CONTENTS WITH SAVED
+      \ (ACTUAL) CONTENTS.
+   DEPTH ACTUAL-DEPTH @ = IF      \ IF DEPTHS MATCH
+      DEPTH ?DUP IF         \ IF THERE IS SOMETHING ON THE STACK
+         0  DO            \ FOR EACH STACK ITEM
+           ACTUAL-RESULTS I CELLS + @   \ COMPARE ACTUAL WITH EXPECTED
+           = 0= IF S" INCORRECT RESULT: " ERROR LEAVE THEN
+         LOOP
+      THEN
+   ELSE               \ DEPTH MISMATCH
+      S" WRONG NUMBER OF RESULTS: " ERROR
+   THEN ;
+
+: TESTING   \ ( -- ) TALKING COMMENT.
+  SOURCE VERBOSE @
+   IF DUP >R TYPE CR R> >IN !
+   ELSE >IN ! DROP [CHAR] * EMIT
+   THEN ;
+

lib/forth/conformance.sh

@@ -0,0 +1,170 @@
+#!/usr/bin/env bash
+# Run the Hayes/Gerry-Jackson Core conformance suite against our Forth
+# interpreter and emit scoreboard.json + scoreboard.md.
+#
+# Method:
+#   1. Preprocess lib/forth/ans-tests/core.fr — strip \ comments, ( ... )
+#      comments, and TESTING … metadata lines.
+#   2. Split into chunks ending at each `}T` so an error in one test
+#      chunk doesn't abort the run.
+#   3. Emit an SX file that exposes those chunks as a list.
+#   4. Run our Forth + hayes-runner under sx_server; record pass/fail/error.
+
+set -e
+FORTH_DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$FORTH_DIR/../.." && pwd)"
+SX_SERVER="${SX_SERVER:-/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe}"
+SOURCE="$FORTH_DIR/ans-tests/core.fr"
+OUT_JSON="$FORTH_DIR/scoreboard.json"
+OUT_MD="$FORTH_DIR/scoreboard.md"
+TMP="$(mktemp -d)"
+PREPROC="$TMP/preproc.forth"
+CHUNKS_SX="$TMP/chunks.sx"
+
+cd "$ROOT"
+
+# 1. preprocess
+awk '
+{
+  line = $0
+  # protect POSTPONE \ so the comment-strip below leaves the literal \ alone
+  gsub(/POSTPONE[ \t]+\\/, "POSTPONE @@BS@@", line)
+  # strip leading/embedded \ line comments (must be \ followed by space or EOL)
+  gsub(/(^|[ \t])\\([ \t].*|$)/, " ", line)
+  # strip ( ... ) block comments that sit on one line
+  gsub(/\([^)]*\)/, " ", line)
+  # strip TESTING … metadata lines (rest of line, incl. bare TESTING)
+  sub(/TESTING([ \t].*)?$/, " ", line)
+  # restore the protected backslash
+  gsub(/@@BS@@/, "\\", line)
+  print line
+}' "$SOURCE" > "$PREPROC"
+
+# 2 + 3: split into chunks at each `}T` and emit as a SX file
+#
+# Cap chunks via MAX_CHUNKS env (default 638 = full Hayes Core). Lower
+# it temporarily if later tests regress into an infinite loop while you
+# are iterating on primitives.
+MAX_CHUNKS="${MAX_CHUNKS:-638}"
+
+MAX_CHUNKS="$MAX_CHUNKS" python3 - "$PREPROC" "$CHUNKS_SX" <<'PY'
+import os, re, sys
+preproc_path, out_path = sys.argv[1], sys.argv[2]
+max_chunks = int(os.environ.get("MAX_CHUNKS", "590"))
+text = open(preproc_path).read()
+# keep the `}T` attached to the preceding chunk
+parts = re.split(r'(\}T)', text)
+chunks = []
+buf = ""
+for p in parts:
+    buf += p
+    if p == "}T":
+        s = buf.strip()
+        if s:
+            chunks.append(s)
+        buf = ""
+if buf.strip():
+    chunks.append(buf.strip())
+chunks = chunks[:max_chunks]
+
+def esc(s):
+    s = s.replace('\\', '\\\\').replace('"', '\\"')
+    s = s.replace('\r', ' ').replace('\n', ' ')
+    s = re.sub(r'\s+', ' ', s).strip()
+    return s
+
+with open(out_path, "w") as f:
+    f.write("(define hayes-chunks (list\n")
+    for c in chunks:
+        f.write('  "' + esc(c) + '"\n')
+    f.write("))\n\n")
+    f.write("(define\n")
+    f.write("  hayes-run-all\n")
+    f.write("  (fn\n")
+    f.write("    ()\n")
+    f.write("    (hayes-reset!)\n")
+    f.write("    (let ((s (hayes-boot)))\n")
+    f.write("      (for-each (fn (c) (hayes-run-chunk s c)) hayes-chunks))\n")
+    f.write("    (hayes-summary)))\n")
+PY
+
+# 4. run it
+OUT=$(printf '(epoch 1)\n(load "lib/forth/runtime.sx")\n(epoch 2)\n(load "lib/forth/reader.sx")\n(epoch 3)\n(load "lib/forth/interpreter.sx")\n(epoch 4)\n(load "lib/forth/compiler.sx")\n(epoch 5)\n(load "lib/forth/hayes-runner.sx")\n(epoch 6)\n(load "%s")\n(epoch 7)\n(eval "(hayes-run-all)")\n' "$CHUNKS_SX" \
+  | timeout 180 "$SX_SERVER" 2>&1)
+STATUS=$?
+
+SUMMARY=$(printf '%s\n' "$OUT" | awk '/^\{:pass / {print; exit}')
+PASS=$(printf '%s' "$SUMMARY" | sed -n 's/.*:pass \([0-9-]*\).*/\1/p')
+FAIL=$(printf '%s' "$SUMMARY" | sed -n 's/.*:fail \([0-9-]*\).*/\1/p')
+ERR=$(printf '%s' "$SUMMARY" | sed -n 's/.*:error \([0-9-]*\).*/\1/p')
+TOTAL=$(printf '%s' "$SUMMARY" | sed -n 's/.*:total \([0-9-]*\).*/\1/p')
+CHUNK_COUNT=$(grep -c '^  "' "$CHUNKS_SX" || echo 0)
+TOTAL_AVAILABLE=$(grep -c '}T' "$PREPROC" || echo 0)
+
+NOW="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+if [ -z "$PASS" ]; then
+  PASS=0; FAIL=0; ERR=0; TOTAL=0
+  NOTE="runner halted before completing (timeout or SX error)"
+else
+  NOTE="completed"
+fi
+
+PCT=0
+if [ "$TOTAL" -gt 0 ]; then
+  PCT=$((PASS * 100 / TOTAL))
+fi
+
+cat > "$OUT_JSON" <<JSON
+{
+  "source": "gerryjackson/forth2012-test-suite src/core.fr",
+  "generated_at": "$NOW",
+  "chunks_available": $TOTAL_AVAILABLE,
+  "chunks_fed": $CHUNK_COUNT,
+  "total": $TOTAL,
+  "pass": $PASS,
+  "fail": $FAIL,
+  "error": $ERR,
+  "percent": $PCT,
+  "note": "$NOTE"
+}
+JSON
+
+cat > "$OUT_MD" <<MD
+# Forth Hayes Core scoreboard
+
+| metric            | value |
+| ----------------- | ----: |
+| chunks available  | $TOTAL_AVAILABLE |
+| chunks fed        | $CHUNK_COUNT |
+| total             | $TOTAL |
+| pass              | $PASS |
+| fail              | $FAIL |
+| error             | $ERR |
+| percent           | ${PCT}% |
+
+- **Source**: \`gerryjackson/forth2012-test-suite\` \`src/core.fr\`
+- **Generated**: $NOW
+- **Note**: $NOTE
+
+A "chunk" is any preprocessed segment ending at a \`}T\` (every Hayes test
+is one chunk, plus the small declaration blocks between tests).
+The runner catches raised errors at chunk boundaries so one bad chunk
+does not abort the rest. \`error\` covers chunks that raised; \`fail\`
+covers tests whose \`->\` / \`}T\` comparison mismatched.
+
+### Chunk cap
+
+\`conformance.sh\` processes the first \`\$MAX_CHUNKS\` chunks (default
+**638**, i.e. the whole Hayes Core file). Lower the cap temporarily
+while iterating on primitives if a regression re-opens an infinite
+loop in later tests.
+MD
+
+echo "$SUMMARY"
+echo "Scoreboard: $OUT_JSON"
+echo "           $OUT_MD"
+
+if [ "$STATUS" -ne 0 ] && [ "$TOTAL" -eq 0 ]; then
+  exit 1
+fi

lib/forth/hayes-runner.sx

@@ -0,0 +1,158 @@
+;; Hayes conformance test runner.
+;; Installs T{ -> }T as Forth primitives that snapshot and compare dstack,
+;; plus stub TESTING / HEX / DECIMAL so the Hayes Core file can stream
+;; through the interpreter without halting on unsupported metadata words.
+
+(define hayes-pass 0)
+(define hayes-fail 0)
+(define hayes-error 0)
+(define hayes-start-depth 0)
+(define hayes-actual (list))
+(define hayes-actual-set false)
+(define hayes-failures (list))
+(define hayes-first-error "")
+(define hayes-error-hist (dict))
+
+(define
+  hayes-reset!
+  (fn
+    ()
+    (set! hayes-pass 0)
+    (set! hayes-fail 0)
+    (set! hayes-error 0)
+    (set! hayes-start-depth 0)
+    (set! hayes-actual (list))
+    (set! hayes-actual-set false)
+    (set! hayes-failures (list))
+    (set! hayes-first-error "")
+    (set! hayes-error-hist (dict))))
+
+(define
+  hayes-slice
+  (fn
+    (state base)
+    (let
+      ((n (- (forth-depth state) base)))
+      (if (<= n 0) (list) (take (get state "dstack") n)))))
+
+(define
+  hayes-truncate!
+  (fn
+    (state base)
+    (let
+      ((n (- (forth-depth state) base)))
+      (when (> n 0) (dict-set! state "dstack" (drop (get state "dstack") n))))))
+
+(define
+  hayes-install!
+  (fn
+    (state)
+    (forth-def-prim!
+      state
+      "T{"
+      (fn
+        (s)
+        (set! hayes-start-depth (forth-depth s))
+        (set! hayes-actual-set false)
+        (set! hayes-actual (list))))
+    (forth-def-prim!
+      state
+      "->"
+      (fn
+        (s)
+        (set! hayes-actual (hayes-slice s hayes-start-depth))
+        (set! hayes-actual-set true)
+        (hayes-truncate! s hayes-start-depth)))
+    (forth-def-prim!
+      state
+      "}T"
+      (fn
+        (s)
+        (let
+          ((expected (hayes-slice s hayes-start-depth)))
+          (hayes-truncate! s hayes-start-depth)
+          (if
+            (and hayes-actual-set (= expected hayes-actual))
+            (set! hayes-pass (+ hayes-pass 1))
+            (begin
+              (set! hayes-fail (+ hayes-fail 1))
+              (set!
+                hayes-failures
+                (concat
+                  hayes-failures
+                  (list
+                    (dict
+                      "kind"
+                      "fail"
+                      "expected"
+                      (str expected)
+                      "actual"
+                      (str hayes-actual))))))))))
+    (forth-def-prim! state "TESTING" (fn (s) nil))
+    ;; HEX/DECIMAL are real primitives now (runtime.sx) — no stub needed.
+    state))
+
+(define
+  hayes-boot
+  (fn () (let ((s (forth-boot))) (hayes-install! s) (hayes-reset!) s)))
+
+;; Run a single preprocessed chunk (string of Forth source) on the shared
+;; state. Catch any raised error and move on — the chunk boundary is a
+;; safe resume point.
+(define
+  hayes-bump-error-key!
+  (fn
+    (err)
+    (let
+      ((msg (str err)))
+      (let
+        ((space-idx (index-of msg " ")))
+        (let
+          ((key
+            (if
+              (> space-idx 0)
+              (substr msg 0 space-idx)
+              msg)))
+          (dict-set!
+            hayes-error-hist
+            key
+            (+ 1 (or (get hayes-error-hist key) 0))))))))
+
+(define
+  hayes-run-chunk
+  (fn
+    (state src)
+    (guard
+      (err
+        ((= 1 1)
+          (begin
+            (set! hayes-error (+ hayes-error 1))
+            (when
+              (= (len hayes-first-error) 0)
+              (set! hayes-first-error (str err)))
+            (hayes-bump-error-key! err)
+            (dict-set! state "dstack" (list))
+            (dict-set! state "rstack" (list))
+            (dict-set! state "compiling" false)
+            (dict-set! state "current-def" nil)
+            (dict-set! state "cstack" (list))
+            (dict-set! state "input" (list)))))
+      (forth-interpret state src))))
+
+(define
+  hayes-summary
+  (fn
+    ()
+    (dict
+      "pass"
+      hayes-pass
+      "fail"
+      hayes-fail
+      "error"
+      hayes-error
+      "total"
+      (+ (+ hayes-pass hayes-fail) hayes-error)
+      "first-error"
+      hayes-first-error
+      "error-hist"
+      hayes-error-hist)))

lib/forth/interpreter.sx

@@ -5,7 +5,39 @@
 
 (define
   forth-execute-word
-  (fn (state word) (let ((body (get word "body"))) (body state))))
+  (fn
+    (state word)
+    (dict-set! word "call-count" (+ 1 (or (get word "call-count") 0)))
+    (let ((body (get word "body"))) (body state))))
+
+(define
+  forth-hot-words
+  (fn
+    (state threshold)
+    (forth-hot-walk
+      (keys (get state "dict"))
+      (get state "dict")
+      threshold
+      (list))))
+
+(define
+  forth-hot-walk
+  (fn
+    (names dict threshold acc)
+    (if
+      (= (len names) 0)
+      acc
+      (let
+        ((n (first names)))
+        (let
+          ((w (get dict n)))
+          (let
+            ((c (or (get w "call-count") 0)))
+            (forth-hot-walk
+              (rest names)
+              dict
+              threshold
+              (if (>= c threshold) (cons (list n c) acc) acc))))))))
 
 (define
   forth-interpret-token
@@ -17,7 +49,7 @@
         (not (nil? w))
         (forth-execute-word state w)
         (let
-          ((n (forth-parse-number tok (get state "base"))))
+          ((n (forth-parse-number tok (get (get state "vars") "base"))))
           (if
             (not (nil? n))
             (forth-push state n)

lib/forth/runtime.sx

@@ -18,10 +18,122 @@
       (dict-set! s "output" "")
       (dict-set! s "compiling" false)
       (dict-set! s "current-def" nil)
-      (dict-set! s "base" 10)
       (dict-set! s "vars" (dict))
+      (dict-set! (get s "vars") "base" 10)
+      (dict-set! s "cstack" (list))
+      (dict-set! s "mem" (dict))
+      (dict-set! s "here" 0)
+      (dict-set! s "hold" (list))
+      (dict-set! s "files" (dict))
+      (dict-set! s "by-path" (dict))
+      (dict-set! s "next-fileid" 1)
       s)))
 
+(define
+  forth-mem-write!
+  (fn (state addr u) (dict-set! (get state "mem") (str addr) u)))
+
+(define
+  forth-mem-read
+  (fn
+    (state addr)
+    (or (get (get state "mem") (str addr)) 0)))
+
+(define
+  forth-alloc-bytes!
+  (fn
+    (state n)
+    (let
+      ((addr (get state "here")))
+      (dict-set! state "here" (+ addr n))
+      addr)))
+
+(define
+  forth-mem-write-string!
+  (fn
+    (state addr s)
+    (let
+      ((n (len s)))
+      (forth-mem-write-string-loop! state addr s 0 n))))
+
+(define
+  forth-mem-write-string-loop!
+  (fn
+    (state addr s i n)
+    (when
+      (< i n)
+      (begin
+        (forth-mem-write! state (+ addr i) (char-code (substr s i 1)))
+        (forth-mem-write-string-loop! state addr s (+ i 1) n)))))
+
+(define
+  forth-mem-read-string
+  (fn
+    (state addr n)
+    (forth-mem-read-string-loop state addr 0 n "")))
+
+(define
+  forth-mem-read-string-loop
+  (fn
+    (state addr i n acc)
+    (if
+      (>= i n)
+      acc
+      (forth-mem-read-string-loop
+        state
+        addr
+        (+ i 1)
+        n
+        (str acc (char-from-code (forth-mem-read state (+ addr i))))))))
+
+(define
+  forth-fill-loop
+  (fn
+    (state addr u char i)
+    (when
+      (< i u)
+      (begin
+        (forth-mem-write! state (+ addr i) char)
+        (forth-fill-loop state addr u char (+ i 1))))))
+
+(define
+  forth-cmove-loop
+  (fn
+    (state src dst u i)
+    (when
+      (< i u)
+      (begin
+        (forth-mem-write! state (+ dst i) (forth-mem-read state (+ src i)))
+        (forth-cmove-loop state src dst u (+ i 1))))))
+
+(define
+  forth-cmove-loop-desc
+  (fn
+    (state src dst u i)
+    (when
+      (>= i 0)
+      (begin
+        (forth-mem-write! state (+ dst i) (forth-mem-read state (+ src i)))
+        (forth-cmove-loop-desc state src dst u (- i 1))))))
+
+(define
+  forth-cpush
+  (fn (state v) (dict-set! state "cstack" (cons v (get state "cstack")))))
+
+(define
+  forth-cpop
+  (fn
+    (state)
+    (let
+      ((cs (get state "cstack")))
+      (if
+        (= (len cs) 0)
+        (forth-error state "control stack underflow")
+        (let
+          ((top (first cs)))
+          (dict-set! state "cstack" (rest cs))
+          top)))))
+
 (define
   forth-error
   (fn (state msg) (dict-set! state "error" msg) (raise msg)))
@@ -81,6 +193,12 @@
   forth-emit-str
   (fn (state s) (dict-set! state "output" (str (get state "output") s))))
 
+;; The body is always a plain SX lambda — primitives and colon-def
+;; bodies alike — which means the SX VM's JIT-on-first-call can lift
+;; the body directly into bytecode. We tag every word `:vm-eligible?
+;; true` so downstream JIT cooperation (a tracing layer, a hot-call
+;; counter) can pick out the JIT-friendly entries by metadata rather
+;; than by inspecting the body shape.
 (define
   forth-make-word
   (fn
@@ -90,6 +208,8 @@
       (dict-set! w "kind" kind)
       (dict-set! w "body" body)
       (dict-set! w "immediate?" immediate?)
+      (dict-set! w "vm-eligible?" true)
+      (dict-set! w "call-count" 0)
       w)))
 
 (define
@@ -99,7 +219,8 @@
     (dict-set!
       (get state "dict")
       (downcase name)
-      (forth-make-word "primitive" body false))))
+      (forth-make-word "primitive" body false))
+    (dict-set! state "last-defined" name)))
 
 (define
   forth-def-prim-imm!
@@ -108,7 +229,8 @@
     (dict-set!
       (get state "dict")
       (downcase name)
-      (forth-make-word "primitive" body true))))
+      (forth-make-word "primitive" body true))
+    (dict-set! state "last-defined" name)))
 
 (define
   forth-lookup
@@ -166,6 +288,220 @@
 
 (define forth-bits-width 32)
 
+;; Truncate a number to the Forth 32-bit signed range (two's-complement).
+;; Used by arithmetic primitives so wrap-around matches ANS semantics and
+;; loop idioms that rely on MSB becoming 0 after enough shifts terminate.
+(define
+  forth-clip
+  (fn
+    (n)
+    (forth-from-unsigned
+      (forth-to-unsigned n forth-bits-width)
+      forth-bits-width)))
+
+;; Double-cell helpers. Single = 32-bit signed, double = 64-bit signed
+;; represented on the data stack as (lo, hi) where hi is on top.
+;; Reassembly converts the low cell as unsigned and the high cell as
+;; signed (signed) or as unsigned (unsigned), then combines.
+(define forth-2pow32 (pow 2 32))
+(define forth-2pow64 (pow 2 64))
+
+(define
+  forth-double-from-cells-u
+  (fn
+    (lo hi)
+    (+ (forth-to-unsigned lo 32) (* (forth-to-unsigned hi 32) forth-2pow32))))
+
+(define
+  forth-double-from-cells-s
+  (fn (lo hi) (+ (forth-to-unsigned lo 32) (* hi forth-2pow32))))
+
+(define
+  forth-double-push-u
+  (fn
+    (state d)
+    (let
+      ((lo (mod d forth-2pow32)) (hi (floor (/ d forth-2pow32))))
+      (forth-push state (forth-from-unsigned lo 32))
+      (forth-push state (forth-from-unsigned hi 32)))))
+
+(define
+  forth-num-to-string-loop
+  (fn
+    (u base acc)
+    (if
+      (= u 0)
+      acc
+      (let
+        ((dig (mod u base)) (rest (floor (/ u base))))
+        (let
+          ((ch
+            (if
+              (< dig 10)
+              (char-from-code (+ 48 dig))
+              (char-from-code (+ 55 dig)))))
+          (forth-num-to-string-loop rest base (str ch acc)))))))
+
+(define
+  forth-num-to-string
+  (fn
+    (u base)
+    (if (= u 0) "0" (forth-num-to-string-loop u base ""))))
+
+(define
+  forth-spaces-str
+  (fn
+    (n)
+    (if (<= n 0) "" (str " " (forth-spaces-str (- n 1))))))
+
+(define
+  forth-join-hold
+  (fn
+    (parts)
+    (forth-join-hold-loop parts "")))
+
+(define
+  forth-join-hold-loop
+  (fn
+    (parts acc)
+    (if
+      (= (len parts) 0)
+      acc
+      (forth-join-hold-loop (rest parts) (str acc (first parts))))))
+
+(define
+  forth-pic-step
+  (fn
+    (state)
+    (let
+      ((hi (forth-pop state)) (lo (forth-pop state)))
+      (let
+        ((d (forth-double-from-cells-u lo hi))
+          (b (get (get state "vars") "base")))
+        (let
+          ((dig (mod d b)) (rest (floor (/ d b))))
+          (let
+            ((ch
+              (if
+                (< dig 10)
+                (char-from-code (+ 48 dig))
+                (char-from-code (+ 55 dig)))))
+            (dict-set! state "hold" (cons ch (get state "hold")))
+            (forth-double-push-u state rest)))))))
+
+(define
+  forth-compare-bytes-loop
+  (fn
+    (state a1 u1 a2 u2 i)
+    (cond
+      ((and (= i u1) (= i u2)) 0)
+      ((= i u1) -1)
+      ((= i u2) 1)
+      (else
+        (let
+          ((b1 (forth-mem-read state (+ a1 i)))
+            (b2 (forth-mem-read state (+ a2 i))))
+          (cond
+            ((< b1 b2) -1)
+            ((> b1 b2) 1)
+            (else (forth-compare-bytes-loop state a1 u1 a2 u2 (+ i 1)))))))))
+
+(define
+  forth-match-at
+  (fn
+    (state a1 start a2 u2 j)
+    (cond
+      ((= j u2) true)
+      ((not
+        (=
+          (forth-mem-read state (+ a1 (+ start j)))
+          (forth-mem-read state (+ a2 j))))
+        false)
+      (else (forth-match-at state a1 start a2 u2 (+ j 1))))))
+
+(define
+  forth-search-bytes
+  (fn
+    (state a1 u1 a2 u2 i)
+    (cond
+      ((= u2 0) 0)
+      ((> (+ i u2) u1) -1)
+      ((forth-match-at state a1 i a2 u2 0) i)
+      (else (forth-search-bytes state a1 u1 a2 u2 (+ i 1))))))
+
+(define
+  forth-digit-of-byte
+  (fn
+    (c base)
+    (let
+      ((v
+        (cond
+          ((and (>= c 48) (<= c 57)) (- c 48))
+          ((and (>= c 65) (<= c 90)) (- c 55))
+          ((and (>= c 97) (<= c 122)) (- c 87))
+          (else -1))))
+      (if (or (< v 0) (>= v base)) -1 v))))
+
+(define
+  forth-numparse-loop
+  (fn
+    (state addr u acc base)
+    (if
+      (= u 0)
+      (list acc addr u)
+      (let
+        ((c (forth-mem-read state addr)))
+        (let
+          ((dig (forth-digit-of-byte c base)))
+          (if
+            (< dig 0)
+            (list acc addr u)
+            (forth-numparse-loop
+              state
+              (+ addr 1)
+              (- u 1)
+              (+ (* acc base) dig)
+              base)))))))
+
+(define
+  forth-pic-S-loop
+  (fn
+    (state)
+    (forth-pic-step state)
+    (let
+      ((hi (forth-pop state)) (lo (forth-pop state)))
+      (if
+        (and (= lo 0) (= hi 0))
+        (begin (forth-push state 0) (forth-push state 0))
+        (begin
+          (forth-push state lo)
+          (forth-push state hi)
+          (forth-pic-S-loop state))))))
+
+(define
+  forth-double-push-s
+  (fn
+    (state d)
+    (if
+      (>= d 0)
+      (forth-double-push-u state d)
+      (let
+        ((q (- 0 d)))
+        (let
+          ((qlo (mod q forth-2pow32)) (qhi (floor (/ q forth-2pow32))))
+          (if
+            (= qlo 0)
+            (begin
+              (forth-push state 0)
+              (forth-push state (forth-from-unsigned (- forth-2pow32 qhi) 32)))
+            (begin
+              (forth-push
+                state
+                (forth-from-unsigned (- forth-2pow32 qlo) 32))
+              (forth-push
+                state
+                (forth-from-unsigned (- (- forth-2pow32 qhi) 1) 32)))))))))
+
 (define
   forth-to-unsigned
   (fn (n w) (let ((m (pow 2 w))) (mod (+ (mod n m) m) m))))
@@ -285,6 +621,19 @@
         (s)
         (let ((a (forth-peek s))) (when (not (= a 0)) (forth-push s a)))))
     (forth-def-prim! state "DEPTH" (fn (s) (forth-push s (forth-depth s))))
+    (forth-def-prim! state "SP@" (fn (s) (forth-push s (forth-depth s))))
+    (forth-def-prim!
+      state
+      "SP!"
+      (fn
+        (s)
+        (let
+          ((n (forth-pop s)))
+          (let
+            ((cur (forth-depth s)))
+            (when
+              (> cur n)
+              (dict-set! s "dstack" (drop (get s "dstack") (- cur n))))))))
     (forth-def-prim!
       state
       "PICK"
@@ -354,11 +703,17 @@
           (forth-push s d)
           (forth-push s a)
           (forth-push s b))))
-    (forth-def-prim! state "+" (forth-binop (fn (a b) (+ a b))))
-    (forth-def-prim! state "-" (forth-binop (fn (a b) (- a b))))
-    (forth-def-prim! state "*" (forth-binop (fn (a b) (* a b))))
-    (forth-def-prim! state "/" (forth-binop forth-div))
-    (forth-def-prim! state "MOD" (forth-binop forth-mod))
+    (forth-def-prim! state "+" (forth-binop (fn (a b) (forth-clip (+ a b)))))
+    (forth-def-prim! state "-" (forth-binop (fn (a b) (forth-clip (- a b)))))
+    (forth-def-prim! state "*" (forth-binop (fn (a b) (forth-clip (* a b)))))
+    (forth-def-prim!
+      state
+      "/"
+      (forth-binop (fn (a b) (forth-clip (forth-div a b)))))
+    (forth-def-prim!
+      state
+      "MOD"
+      (forth-binop (fn (a b) (forth-clip (forth-mod a b)))))
     (forth-def-prim!
       state
       "/MOD"
@@ -368,8 +723,8 @@
           ((b (forth-pop s)) (a (forth-pop s)))
           (forth-push s (forth-mod a b))
           (forth-push s (forth-div a b)))))
-    (forth-def-prim! state "NEGATE" (forth-unop (fn (a) (- 0 a))))
-    (forth-def-prim! state "ABS" (forth-unop abs))
+    (forth-def-prim! state "NEGATE" (forth-unop (fn (a) (forth-clip (- 0 a)))))
+    (forth-def-prim! state "ABS" (forth-unop (fn (a) (forth-clip (abs a)))))
     (forth-def-prim!
       state
       "MIN"
@@ -378,12 +733,15 @@
       state
       "MAX"
       (forth-binop (fn (a b) (if (> a b) a b))))
-    (forth-def-prim! state "1+" (forth-unop (fn (a) (+ a 1))))
-    (forth-def-prim! state "1-" (forth-unop (fn (a) (- a 1))))
-    (forth-def-prim! state "2+" (forth-unop (fn (a) (+ a 2))))
-    (forth-def-prim! state "2-" (forth-unop (fn (a) (- a 2))))
-    (forth-def-prim! state "2*" (forth-unop (fn (a) (* a 2))))
-    (forth-def-prim! state "2/" (forth-unop (fn (a) (floor (/ a 2)))))
+    (forth-def-prim! state "1+" (forth-unop (fn (a) (forth-clip (+ a 1)))))
+    (forth-def-prim! state "1-" (forth-unop (fn (a) (forth-clip (- a 1)))))
+    (forth-def-prim! state "2+" (forth-unop (fn (a) (forth-clip (+ a 2)))))
+    (forth-def-prim! state "2-" (forth-unop (fn (a) (forth-clip (- a 2)))))
+    (forth-def-prim! state "2*" (forth-unop (fn (a) (forth-clip (* a 2)))))
+    (forth-def-prim!
+      state
+      "2/"
+      (forth-unop (fn (a) (forth-clip (floor (/ a 2))))))
     (forth-def-prim! state "=" (forth-cmp (fn (a b) (= a b))))
     (forth-def-prim! state "<>" (forth-cmp (fn (a b) (not (= a b)))))
     (forth-def-prim! state "<" (forth-cmp (fn (a b) (< a b))))
@@ -398,6 +756,30 @@
     (forth-def-prim! state "OR" (forth-binop forth-bit-or))
     (forth-def-prim! state "XOR" (forth-binop forth-bit-xor))
     (forth-def-prim! state "INVERT" (forth-unop forth-bit-invert))
+    (forth-def-prim!
+      state
+      "LSHIFT"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (x (forth-pop s)))
+          (let
+            ((ux (forth-to-unsigned x forth-bits-width)))
+            (let
+              ((res (mod (* ux (pow 2 u)) (pow 2 forth-bits-width))))
+              (forth-push s (forth-from-unsigned res forth-bits-width)))))))
+    (forth-def-prim!
+      state
+      "RSHIFT"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (x (forth-pop s)))
+          (let
+            ((ux (forth-to-unsigned x forth-bits-width)))
+            (let
+              ((res (floor (/ ux (pow 2 u)))))
+              (forth-push s (forth-from-unsigned res forth-bits-width)))))))
     (forth-def-prim!
       state
       "."
@@ -416,7 +798,7 @@
     (forth-def-prim!
       state
       "EMIT"
-      (fn (s) (forth-emit-str s (code-char (forth-pop s)))))
+      (fn (s) (forth-emit-str s (char-from-code (forth-pop s)))))
     (forth-def-prim! state "CR" (fn (s) (forth-emit-str s "\n")))
     (forth-def-prim! state "SPACE" (fn (s) (forth-emit-str s " ")))
     (forth-def-prim!
@@ -430,4 +812,459 @@
             (> n 0)
             (for-each (fn (_) (forth-emit-str s " ")) (range 0 n))))))
     (forth-def-prim! state "BL" (fn (s) (forth-push s 32)))
+    (forth-def-prim!
+      state
+      "DECIMAL"
+      (fn (s) (dict-set! (get s "vars") "base" 10)))
+    (forth-def-prim!
+      state
+      "HEX"
+      (fn (s) (dict-set! (get s "vars") "base" 16)))
+    (forth-def-prim!
+      state
+      "OCTAL"
+      (fn (s) (dict-set! (get s "vars") "base" 8)))
+    (forth-def-prim! state "BASE" (fn (s) (forth-push s "base")))
+    (forth-def-prim! state "I" (fn (s) (forth-push s (forth-rpeek s))))
+    (forth-def-prim!
+      state
+      "J"
+      (fn (s) (forth-push s (nth (get s "rstack") 2))))
+    (forth-def-prim! state ">R" (fn (s) (forth-rpush s (forth-pop s))))
+    (forth-def-prim! state "R>" (fn (s) (forth-push s (forth-rpop s))))
+    (forth-def-prim! state "R@" (fn (s) (forth-push s (forth-rpeek s))))
+    (forth-def-prim!
+      state
+      "2>R"
+      (fn
+        (s)
+        (let
+          ((b (forth-pop s)) (a (forth-pop s)))
+          (forth-rpush s a)
+          (forth-rpush s b))))
+    (forth-def-prim!
+      state
+      "2R>"
+      (fn
+        (s)
+        (let
+          ((b (forth-rpop s)) (a (forth-rpop s)))
+          (forth-push s a)
+          (forth-push s b))))
+    (forth-def-prim!
+      state
+      "2R@"
+      (fn
+        (s)
+        (let
+          ((rs (get s "rstack")))
+          (when
+            (< (len rs) 2)
+            (forth-error s "return stack underflow"))
+          (forth-push s (nth rs 1))
+          (forth-push s (nth rs 0)))))
+    (forth-def-prim!
+      state
+      "C@"
+      (fn
+        (s)
+        (let ((addr (forth-pop s))) (forth-push s (forth-mem-read s addr)))))
+    (forth-def-prim!
+      state
+      "C!"
+      (fn
+        (s)
+        (let
+          ((addr (forth-pop s)) (v (forth-pop s)))
+          (forth-mem-write! s addr v))))
+    (forth-def-prim! state "CHAR+" (fn (s) (forth-push s (+ (forth-pop s) 1))))
+    (forth-def-prim! state "CHARS" (fn (s) nil))
+    (forth-def-prim!
+      state
+      "TYPE"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (addr (forth-pop s)))
+          (forth-emit-str s (forth-mem-read-string s addr u)))))
+    (forth-def-prim!
+      state
+      "COUNT"
+      (fn
+        (s)
+        (let
+          ((addr (forth-pop s)))
+          (let
+            ((u (forth-mem-read s addr)))
+            (forth-push s (+ addr 1))
+            (forth-push s u)))))
+    (forth-def-prim!
+      state
+      "FILL"
+      (fn
+        (s)
+        (let
+          ((char (forth-pop s)) (u (forth-pop s)) (addr (forth-pop s)))
+          (forth-fill-loop s addr u char 0))))
+    (forth-def-prim!
+      state
+      "BLANK"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (addr (forth-pop s)))
+          (forth-fill-loop s addr u 32 0))))
+    (forth-def-prim!
+      state
+      "CMOVE"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (dst (forth-pop s)) (src (forth-pop s)))
+          (forth-cmove-loop s src dst u 0))))
+    (forth-def-prim!
+      state
+      "CMOVE>"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (dst (forth-pop s)) (src (forth-pop s)))
+          (forth-cmove-loop-desc s src dst u (- u 1)))))
+    (forth-def-prim!
+      state
+      "MOVE"
+      (fn
+        (s)
+        (let
+          ((u (forth-pop s)) (dst (forth-pop s)) (src (forth-pop s)))
+          (if
+            (or (<= dst src) (>= dst (+ src u)))
+            (forth-cmove-loop s src dst u 0)
+            (forth-cmove-loop-desc s src dst u (- u 1))))))
+    (forth-def-prim!
+      state
+      "S>D"
+      (fn
+        (s)
+        (let
+          ((n (forth-pop s)))
+          (forth-push s n)
+          (forth-push s (if (< n 0) -1 0)))))
+    (forth-def-prim! state "D>S" (fn (s) (forth-pop s)))
+    (forth-def-prim!
+      state
+      "M*"
+      (fn
+        (s)
+        (let
+          ((b (forth-pop s)) (a (forth-pop s)))
+          (forth-double-push-s s (* a b)))))
+    (forth-def-prim!
+      state
+      "UM*"
+      (fn
+        (s)
+        (let
+          ((b (forth-pop s)) (a (forth-pop s)))
+          (forth-double-push-u
+            s
+            (* (forth-to-unsigned a 32) (forth-to-unsigned b 32))))))
+    (forth-def-prim!
+      state
+      "UM/MOD"
+      (fn
+        (s)
+        (let
+          ((u1 (forth-pop s)) (hi (forth-pop s)) (lo (forth-pop s)))
+          (let
+            ((d (forth-double-from-cells-u lo hi))
+              (divisor (forth-to-unsigned u1 32)))
+            (when (= divisor 0) (forth-error s "division by zero"))
+            (let
+              ((q (floor (/ d divisor))) (r (mod d divisor)))
+              (forth-push s (forth-from-unsigned r 32))
+              (forth-push s (forth-from-unsigned q 32)))))))
+    (forth-def-prim!
+      state
+      "FM/MOD"
+      (fn
+        (s)
+        (let
+          ((n (forth-pop s)) (hi (forth-pop s)) (lo (forth-pop s)))
+          (let
+            ((d (forth-double-from-cells-s lo hi)))
+            (when (= n 0) (forth-error s "division by zero"))
+            (let
+              ((q (floor (/ d n))))
+              (let
+                ((r (- d (* q n))))
+                (forth-push s (forth-clip r))
+                (forth-push s (forth-clip q))))))))
+    (forth-def-prim!
+      state
+      "SM/REM"
+      (fn
+        (s)
+        (let
+          ((n (forth-pop s)) (hi (forth-pop s)) (lo (forth-pop s)))
+          (let
+            ((d (forth-double-from-cells-s lo hi)))
+            (when (= n 0) (forth-error s "division by zero"))
+            (let
+              ((q (forth-trunc (/ d n))))
+              (let
+                ((r (- d (* q n))))
+                (forth-push s (forth-clip r))
+                (forth-push s (forth-clip q))))))))
+    (forth-def-prim!
+      state
+      "*/"
+      (fn
+        (s)
+        (let
+          ((n3 (forth-pop s)) (n2 (forth-pop s)) (n1 (forth-pop s)))
+          (when (= n3 0) (forth-error s "division by zero"))
+          (forth-push s (forth-clip (forth-trunc (/ (* n1 n2) n3)))))))
+    (forth-def-prim!
+      state
+      "*/MOD"
+      (fn
+        (s)
+        (let
+          ((n3 (forth-pop s)) (n2 (forth-pop s)) (n1 (forth-pop s)))
+          (when (= n3 0) (forth-error s "division by zero"))
+          (let
+            ((d (* n1 n2)))
+            (let
+              ((q (forth-trunc (/ d n3))))
+              (let
+                ((r (- d (* q n3))))
+                (forth-push s (forth-clip r))
+                (forth-push s (forth-clip q))))))))
+    (forth-def-prim!
+      state
+      "D+"
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (forth-double-push-s
+            s
+            (+
+              (forth-double-from-cells-s lo1 hi1)
+              (forth-double-from-cells-s lo2 hi2))))))
+    (forth-def-prim!
+      state
+      "D-"
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (forth-double-push-s
+            s
+            (-
+              (forth-double-from-cells-s lo1 hi1)
+              (forth-double-from-cells-s lo2 hi2))))))
+    (forth-def-prim!
+      state
+      "DNEGATE"
+      (fn
+        (s)
+        (let
+          ((hi (forth-pop s)) (lo (forth-pop s)))
+          (forth-double-push-s
+            s
+            (- 0 (forth-double-from-cells-s lo hi))))))
+    (forth-def-prim!
+      state
+      "DABS"
+      (fn
+        (s)
+        (let
+          ((hi (forth-pop s)) (lo (forth-pop s)))
+          (forth-double-push-s s (abs (forth-double-from-cells-s lo hi))))))
+    (forth-def-prim!
+      state
+      "D="
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (forth-push s (if (and (= lo1 lo2) (= hi1 hi2)) -1 0)))))
+    (forth-def-prim!
+      state
+      "D<"
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (forth-push
+            s
+            (if
+              (<
+                (forth-double-from-cells-s lo1 hi1)
+                (forth-double-from-cells-s lo2 hi2))
+              -1
+              0)))))
+    (forth-def-prim!
+      state
+      "D0="
+      (fn
+        (s)
+        (let
+          ((hi (forth-pop s)) (lo (forth-pop s)))
+          (forth-push s (if (and (= lo 0) (= hi 0)) -1 0)))))
+    (forth-def-prim!
+      state
+      "D0<"
+      (fn
+        (s)
+        (let
+          ((hi (forth-pop s)) (lo (forth-pop s)))
+          (forth-push s (if (< hi 0) -1 0)))))
+    (forth-def-prim!
+      state
+      "DMAX"
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (let
+            ((d1 (forth-double-from-cells-s lo1 hi1))
+              (d2 (forth-double-from-cells-s lo2 hi2)))
+            (forth-double-push-s s (if (> d1 d2) d1 d2))))))
+    (forth-def-prim!
+      state
+      "DMIN"
+      (fn
+        (s)
+        (let
+          ((hi2 (forth-pop s))
+            (lo2 (forth-pop s))
+            (hi1 (forth-pop s))
+            (lo1 (forth-pop s)))
+          (let
+            ((d1 (forth-double-from-cells-s lo1 hi1))
+              (d2 (forth-double-from-cells-s lo2 hi2)))
+            (forth-double-push-s s (if (< d1 d2) d1 d2))))))
+    (forth-def-prim! state "<#" (fn (s) (dict-set! s "hold" (list))))
+    (forth-def-prim!
+      state
+      "HOLD"
+      (fn
+        (s)
+        (let
+          ((c (forth-pop s)))
+          (dict-set!
+            s
+            "hold"
+            (cons (char-from-code c) (get s "hold"))))))
+    (forth-def-prim!
+      state
+      "SIGN"
+      (fn
+        (s)
+        (let
+          ((n (forth-pop s)))
+          (when
+            (< n 0)
+            (dict-set! s "hold" (cons "-" (get s "hold")))))))
+    (forth-def-prim!
+      state
+      "#"
+      (fn
+        (s)
+        (let
+          ((hi (forth-pop s)) (lo (forth-pop s)))
+          (let
+            ((d (forth-double-from-cells-u lo hi))
+              (b (get (get s "vars") "base")))
+            (let
+              ((dig (mod d b)) (rest (floor (/ d b))))
+              (let
+                ((ch
+                  (if
+                    (< dig 10)
+                    (char-from-code (+ 48 dig))
+                    (char-from-code (+ 55 dig)))))
+                (dict-set! s "hold" (cons ch (get s "hold")))
+                (forth-double-push-u s rest)))))))
+    (forth-def-prim!
+      state
+      "#S"
+      (fn
+        (s)
+        (forth-pic-S-loop s)))
+    (forth-def-prim!
+      state
+      "#>"
+      (fn
+        (s)
+        (forth-pop s)
+        (forth-pop s)
+        (let
+          ((str-out (forth-join-hold (get s "hold"))))
+          (let
+            ((addr (forth-alloc-bytes! s (len str-out))))
+            (forth-mem-write-string! s addr str-out)
+            (forth-push s addr)
+            (forth-push s (len str-out))))))
+    (forth-def-prim!
+      state
+      "U."
+      (fn
+        (s)
+        (let
+          ((u (forth-to-unsigned (forth-pop s) 32))
+            (b (get (get s "vars") "base")))
+          (forth-emit-str s (str (forth-num-to-string u b) " ")))))
+    (forth-def-prim!
+      state
+      "U.R"
+      (fn
+        (s)
+        (let
+          ((width (forth-pop s))
+            (u (forth-to-unsigned (forth-pop s) 32))
+            (b (get (get s "vars") "base")))
+          (let
+            ((digits (forth-num-to-string u b)))
+            (forth-emit-str
+              s
+              (forth-spaces-str (- width (len digits))))
+            (forth-emit-str s digits)))))
+    (forth-def-prim!
+      state
+      ".R"
+      (fn
+        (s)
+        (let
+          ((width (forth-pop s))
+            (n (forth-pop s))
+            (b (get (get s "vars") "base")))
+          (let
+            ((sign-prefix (if (< n 0) "-" ""))
+              (abs-digits
+                (forth-num-to-string (forth-to-unsigned (abs n) 32) b)))
+            (let
+              ((digits (str sign-prefix abs-digits)))
+              (forth-emit-str
+                s
+                (forth-spaces-str (- width (len digits))))
+              (forth-emit-str s digits))))))
     state))

lib/forth/scoreboard.json

@@ -0,0 +1,12 @@
+{
+  "source": "gerryjackson/forth2012-test-suite src/core.fr",
+  "generated_at": "2026-04-25T04:57:22Z",
+  "chunks_available": 638,
+  "chunks_fed": 638,
+  "total": 638,
+  "pass": 618,
+  "fail": 14,
+  "error": 6,
+  "percent": 96,
+  "note": "completed"
+}

lib/forth/scoreboard.md

@@ -0,0 +1,28 @@
+# Forth Hayes Core scoreboard
+
+| metric            | value |
+| ----------------- | ----: |
+| chunks available  | 638 |
+| chunks fed        | 638 |
+| total             | 638 |
+| pass              | 618 |
+| fail              | 14 |
+| error             | 6 |
+| percent           | 96% |
+
+- **Source**: `gerryjackson/forth2012-test-suite` `src/core.fr`
+- **Generated**: 2026-04-25T04:57:22Z
+- **Note**: completed
+
+A "chunk" is any preprocessed segment ending at a `}T` (every Hayes test
+is one chunk, plus the small declaration blocks between tests).
+The runner catches raised errors at chunk boundaries so one bad chunk
+does not abort the rest. `error` covers chunks that raised; `fail`
+covers tests whose `->` / `}T` comparison mismatched.
+
+### Chunk cap
+
+`conformance.sh` processes the first `$MAX_CHUNKS` chunks (default
+**638**, i.e. the whole Hayes Core file). Lower the cap temporarily
+while iterating on primitives if a regression re-opens an infinite
+loop in later tests.

lib/forth/test.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# lib/forth/test.sh — smoke-test the Forth runtime layer.
+
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)"
+
+SX_SERVER="${SX_SERVER:-hosts/ocaml/_build/default/bin/sx_server.exe}"
+if [ ! -x "$SX_SERVER" ]; then
+  SX_SERVER="/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe"
+fi
+if [ ! -x "$SX_SERVER" ]; then
+  echo "ERROR: sx_server.exe not found."
+  exit 1
+fi
+
+TMPFILE=$(mktemp); trap "rm -f $TMPFILE" EXIT
+
+cat > "$TMPFILE" << 'EPOCHS'
+(epoch 1)
+(load "lib/forth/runtime.sx")
+(epoch 2)
+(load "lib/forth/tests/runtime.sx")
+(epoch 3)
+(eval "(list forth-test-pass forth-test-fail)")
+EPOCHS
+
+OUTPUT=$(timeout 60 "$SX_SERVER" < "$TMPFILE" 2>/dev/null)
+
+LINE=$(echo "$OUTPUT" | awk '/^\(ok-len 3 / {getline; print; exit}')
+if [ -z "$LINE" ]; then
+  LINE=$(echo "$OUTPUT" | grep -E '^\(ok 3 \([0-9]+ [0-9]+\)\)' | tail -1 \
+          | sed -E 's/^\(ok 3 //; s/\)$//')
+fi
+if [ -z "$LINE" ]; then
+  echo "ERROR: could not extract summary"
+  echo "$OUTPUT" | tail -20
+  exit 1
+fi
+
+P=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\1/')
+F=$(echo "$LINE" | sed -E 's/^\(([0-9]+) ([0-9]+)\).*/\2/')
+TOTAL=$((P + F))
+
+if [ "$F" -eq 0 ]; then
+  echo "ok $P/$TOTAL lib/forth tests passed"
+else
+  echo "FAIL $P/$TOTAL passed, $F failed"
+  TMPFILE2=$(mktemp)
+  cat > "$TMPFILE2" << 'EPOCHS2'
+(epoch 1)
+(load "lib/forth/runtime.sx")
+(epoch 2)
+(load "lib/forth/tests/runtime.sx")
+(epoch 3)
+(eval "(map (fn (f) (list (get f :name) (get f :got) (get f :expected))) forth-test-fails)")
+EPOCHS2
+  FAILS=$(timeout 60 "$SX_SERVER" < "$TMPFILE2" 2>/dev/null | grep -E '^\(ok-len 3' -A1 | tail -1 || true)
+  echo "  Details: $FAILS"
+  rm -f "$TMPFILE2"
+fi
+
+[ "$F" -eq 0 ]

lib/forth/tests/runtime.sx

@@ -0,0 +1,201 @@
+;; lib/forth/tests/runtime.sx — Tests for lib/forth/runtime.sx
+
+(define forth-test-pass 0)
+(define forth-test-fail 0)
+(define forth-test-fails (list))
+
+(define
+  (forth-test name got expected)
+  (if
+    (= got expected)
+    (set! forth-test-pass (+ forth-test-pass 1))
+    (begin
+      (set! forth-test-fail (+ forth-test-fail 1))
+      (set! forth-test-fails (append forth-test-fails (list {:got got :expected expected :name name}))))))
+
+;; ---------------------------------------------------------------------------
+;; 1. Bitwise operations
+;; ---------------------------------------------------------------------------
+
+;; AND
+(forth-test "and 0b1100 0b1010" (forth-and 12 10) 8)
+(forth-test "and 0xFF 0x0F" (forth-and 255 15) 15)
+(forth-test "and 0 any" (forth-and 0 42) 0)
+
+;; OR
+(forth-test "or 0b1100 0b1010" (forth-or 12 10) 14)
+(forth-test "or 0 x" (forth-or 0 7) 7)
+
+;; XOR
+(forth-test "xor 0b1100 0b1010" (forth-xor 12 10) 6)
+(forth-test "xor x x" (forth-xor 42 42) 0)
+
+;; INVERT
+(forth-test "invert 0" (forth-invert 0) -1)
+(forth-test "invert -1" (forth-invert -1) 0)
+(forth-test "invert 1" (forth-invert 1) -2)
+
+;; LSHIFT RSHIFT
+(forth-test "lshift 1 3" (forth-lshift 1 3) 8)
+(forth-test "lshift 3 2" (forth-lshift 3 2) 12)
+(forth-test "rshift 8 3" (forth-rshift 8 3) 1)
+(forth-test "rshift 16 2" (forth-rshift 16 2) 4)
+
+;; 2* 2/
+(forth-test "2* 5" (forth-2* 5) 10)
+(forth-test "2/ 10" (forth-2/ 10) 5)
+(forth-test "2/ 7" (forth-2/ 7) 3)
+
+;; BIT-COUNT
+(forth-test "bit-count 0" (forth-bit-count 0) 0)
+(forth-test "bit-count 1" (forth-bit-count 1) 1)
+(forth-test "bit-count 7" (forth-bit-count 7) 3)
+(forth-test "bit-count 255" (forth-bit-count 255) 8)
+(forth-test "bit-count 256" (forth-bit-count 256) 1)
+
+;; INTEGER-LENGTH
+(forth-test "integer-length 0" (forth-integer-length 0) 0)
+(forth-test "integer-length 1" (forth-integer-length 1) 1)
+(forth-test "integer-length 4" (forth-integer-length 4) 3)
+(forth-test "integer-length 255" (forth-integer-length 255) 8)
+
+;; WITHIN
+(forth-test
+  "within 5 0 10"
+  (forth-within 5 0 10)
+  true)
+(forth-test
+  "within 0 0 10"
+  (forth-within 0 0 10)
+  true)
+(forth-test
+  "within 10 0 10"
+  (forth-within 10 0 10)
+  false)
+(forth-test
+  "within -1 0 10"
+  (forth-within -1 0 10)
+  false)
+
+;; Arithmetic ops
+(forth-test "negate 5" (forth-negate 5) -5)
+(forth-test "negate -3" (forth-negate -3) 3)
+(forth-test "abs -7" (forth-abs -7) 7)
+(forth-test "min 3 5" (forth-min 3 5) 3)
+(forth-test "max 3 5" (forth-max 3 5) 5)
+(forth-test "mod 7 3" (forth-mod 7 3) 1)
+(forth-test
+  "divmod 7 3"
+  (forth-divmod 7 3)
+  (list 1 2))
+(forth-test
+  "divmod 10 5"
+  (forth-divmod 10 5)
+  (list 0 2))
+
+;; ---------------------------------------------------------------------------
+;; 2. String buffer
+;; ---------------------------------------------------------------------------
+
+(define sb1 (forth-sb-new))
+(forth-test "sb? new" (forth-sb? sb1) true)
+(forth-test "sb? non-sb" (forth-sb? 42) false)
+(forth-test "sb value empty" (forth-sb-value sb1) "")
+(forth-test "sb length empty" (forth-sb-length sb1) 0)
+
+(forth-sb-type! sb1 "HELLO")
+(forth-test "sb type" (forth-sb-value sb1) "HELLO")
+(forth-test "sb length after type" (forth-sb-length sb1) 5)
+
+;; EMIT one char
+(define sb2 (forth-sb-new))
+(forth-sb-emit! sb2 (nth (string->list "A") 0))
+(forth-sb-emit! sb2 (nth (string->list "B") 0))
+(forth-sb-emit! sb2 (nth (string->list "C") 0))
+(forth-test "sb emit chars" (forth-sb-value sb2) "ABC")
+
+;; Emit integer
+(define sb3 (forth-sb-new))
+(forth-sb-type! sb3 "n=")
+(forth-sb-emit-int! sb3 42)
+(forth-test "sb emit-int" (forth-sb-value sb3) "n=42")
+
+(forth-sb-clear! sb1)
+(forth-test "sb clear" (forth-sb-value sb1) "")
+(forth-test "sb length after clear" (forth-sb-length sb1) 0)
+
+;; Build a word definition-style name
+(define sb4 (forth-sb-new))
+(forth-sb-type! sb4 ": ")
+(forth-sb-type! sb4 "SQUARE")
+(forth-sb-type! sb4 " DUP * ;")
+(forth-test "sb word def" (forth-sb-value sb4) ": SQUARE DUP * ;")
+
+;; ---------------------------------------------------------------------------
+;; 3. Memory / Bytevectors
+;; ---------------------------------------------------------------------------
+
+(define m1 (forth-mem-new 8))
+(forth-test "mem? yes" (forth-mem? m1) true)
+(forth-test "mem? no" (forth-mem? 42) false)
+(forth-test "mem size" (forth-mem-size m1) 8)
+(forth-test "mem cfetch zero" (forth-cfetch m1 0) 0)
+
+;; C! C@
+(forth-cstore m1 0 65)
+(forth-cstore m1 1 66)
+(forth-test "mem cstore/cfetch 0" (forth-cfetch m1 0) 65)
+(forth-test "mem cstore/cfetch 1" (forth-cfetch m1 1) 66)
+(forth-cstore m1 2 256)
+(forth-test
+  "mem cstore wraps 256→0"
+  (forth-cfetch m1 2)
+  0)
+(forth-cstore m1 2 257)
+(forth-test
+  "mem cstore wraps 257→1"
+  (forth-cfetch m1 2)
+  1)
+
+;; @ ! (32-bit LE cell)
+(define m2 (forth-mem-new 8))
+(forth-store m2 0 305419896)
+(forth-test "mem store/fetch" (forth-fetch m2 0) 305419896)
+(forth-store m2 4 1)
+(forth-test "mem fetch byte 4" (forth-cfetch m2 4) 1)
+(forth-test "mem fetch byte 5" (forth-cfetch m2 5) 0)
+
+;; FILL ERASE
+(define m3 (forth-mem-new 4))
+(forth-fill! m3 0 4 42)
+(forth-test
+  "mem fill"
+  (forth-mem->list m3 0 4)
+  (list 42 42 42 42))
+(forth-erase! m3 1 2)
+(forth-test
+  "mem erase middle"
+  (forth-mem->list m3 0 4)
+  (list 42 0 0 42))
+
+;; MOVE
+(define m4 (forth-mem-new 4))
+(forth-cstore m4 0 1)
+(forth-cstore m4 1 2)
+(forth-cstore m4 2 3)
+(define m5 (forth-mem-new 4))
+(forth-move! m4 0 m5 0 3)
+(forth-test
+  "mem move"
+  (forth-mem->list m5 0 3)
+  (list 1 2 3))
+
+;; mem->list
+(define m6 (forth-mem-new 3))
+(forth-cstore m6 0 10)
+(forth-cstore m6 1 20)
+(forth-cstore m6 2 30)
+(forth-test
+  "mem->list"
+  (forth-mem->list m6 0 3)
+  (list 10 20 30))

lib/forth/tests/test-phase3.sx

@@ -0,0 +1,239 @@
+;; Phase 3 — control flow (IF/ELSE/THEN, BEGIN/UNTIL/WHILE/REPEAT/AGAIN,
+;; DO/LOOP, return stack). Grows as each control construct lands.
+
+(define forth-p3-passed 0)
+(define forth-p3-failed 0)
+(define forth-p3-failures (list))
+
+(define
+  forth-p3-assert
+  (fn
+    (label expected actual)
+    (if
+      (= expected actual)
+      (set! forth-p3-passed (+ forth-p3-passed 1))
+      (begin
+        (set! forth-p3-failed (+ forth-p3-failed 1))
+        (set!
+          forth-p3-failures
+          (concat
+            forth-p3-failures
+            (list
+              (str label ": expected " (str expected) " got " (str actual)))))))))
+
+(define
+  forth-p3-check-stack
+  (fn
+    (label src expected)
+    (let ((r (forth-run src))) (forth-p3-assert label expected (nth r 2)))))
+
+(define
+  forth-p3-if-tests
+  (fn
+    ()
+    (forth-p3-check-stack
+      "IF taken (-1)"
+      ": Q -1 IF 10 THEN ; Q"
+      (list 10))
+    (forth-p3-check-stack
+      "IF not taken (0)"
+      ": Q 0 IF 10 THEN ; Q"
+      (list))
+    (forth-p3-check-stack
+      "IF with non-zero truthy"
+      ": Q 42 IF 10 THEN ; Q"
+      (list 10))
+    (forth-p3-check-stack
+      "IF ELSE — true branch"
+      ": Q -1 IF 10 ELSE 20 THEN ; Q"
+      (list 10))
+    (forth-p3-check-stack
+      "IF ELSE — false branch"
+      ": Q 0 IF 10 ELSE 20 THEN ; Q"
+      (list 20))
+    (forth-p3-check-stack
+      "IF consumes flag"
+      ": Q IF 1 ELSE 2 THEN ; 0 Q"
+      (list 2))
+    (forth-p3-check-stack
+      "absolute value via IF"
+      ": ABS2 DUP 0 < IF NEGATE THEN ; -7 ABS2"
+      (list 7))
+    (forth-p3-check-stack
+      "abs leaves positive alone"
+      ": ABS2 DUP 0 < IF NEGATE THEN ; 7 ABS2"
+      (list 7))
+    (forth-p3-check-stack
+      "sign: negative"
+      ": SIGN DUP 0 < IF DROP -1 ELSE DROP 1 THEN ; -3 SIGN"
+      (list -1))
+    (forth-p3-check-stack
+      "sign: positive"
+      ": SIGN DUP 0 < IF DROP -1 ELSE DROP 1 THEN ; 3 SIGN"
+      (list 1))
+    (forth-p3-check-stack
+      "nested IF (both true)"
+      ": Q 1 IF 1 IF 10 ELSE 20 THEN ELSE 30 THEN ; Q"
+      (list 10))
+    (forth-p3-check-stack
+      "nested IF (inner false)"
+      ": Q 1 IF 0 IF 10 ELSE 20 THEN ELSE 30 THEN ; Q"
+      (list 20))
+    (forth-p3-check-stack
+      "nested IF (outer false)"
+      ": Q 0 IF 0 IF 10 ELSE 20 THEN ELSE 30 THEN ; Q"
+      (list 30))
+    (forth-p3-check-stack
+      "IF before other ops"
+      ": Q 1 IF 5 ELSE 6 THEN 2 * ; Q"
+      (list 10))
+    (forth-p3-check-stack
+      "IF in chained def"
+      ": POS? 0 > ;
+       : DOUBLE-IF-POS DUP POS? IF 2 * THEN ;
+       3 DOUBLE-IF-POS"
+      (list 6))
+    (forth-p3-check-stack
+      "empty then branch"
+      ": Q 1 IF THEN 99 ; Q"
+      (list 99))
+    (forth-p3-check-stack
+      "empty else branch"
+      ": Q 0 IF 99 ELSE THEN ; Q"
+      (list))
+    (forth-p3-check-stack
+      "sequential IF blocks"
+      ": Q -1 IF 1 THEN -1 IF 2 THEN ; Q"
+      (list 1 2))))
+
+(define
+  forth-p3-loop-tests
+  (fn
+    ()
+    (forth-p3-check-stack
+      "BEGIN UNTIL (countdown to zero)"
+      ": CD BEGIN 1- DUP 0 = UNTIL ; 3 CD"
+      (list 0))
+    (forth-p3-check-stack
+      "BEGIN UNTIL — single pass (UNTIL true immediately)"
+      ": Q BEGIN -1 UNTIL 42 ; Q"
+      (list 42))
+    (forth-p3-check-stack
+      "BEGIN UNTIL — accumulate sum 1+2+3"
+      ": SUM3 0 3 BEGIN TUCK + SWAP 1- DUP 0 = UNTIL DROP ; SUM3"
+      (list 6))
+    (forth-p3-check-stack
+      "BEGIN WHILE REPEAT — triangular sum 5"
+      ": TRI 0 5 BEGIN DUP 0 > WHILE TUCK + SWAP 1- REPEAT DROP ; TRI"
+      (list 15))
+    (forth-p3-check-stack
+      "BEGIN WHILE REPEAT — zero iterations"
+      ": TRI 0 0 BEGIN DUP 0 > WHILE TUCK + SWAP 1- REPEAT DROP ; TRI"
+      (list 0))
+    (forth-p3-check-stack
+      "BEGIN WHILE REPEAT — one iteration"
+      ": TRI 0 1 BEGIN DUP 0 > WHILE TUCK + SWAP 1- REPEAT DROP ; TRI"
+      (list 1))
+    (forth-p3-check-stack
+      "nested BEGIN UNTIL"
+      ": INNER BEGIN 1- DUP 0 = UNTIL DROP ;
+       : OUTER BEGIN 3 INNER 1- DUP 0 = UNTIL ;
+       2 OUTER"
+      (list 0))
+    (forth-p3-check-stack
+      "BEGIN UNTIL after colon prefix"
+      ": TEN 10 ;
+       : CD TEN BEGIN 1- DUP 0 = UNTIL ;
+       CD"
+      (list 0))
+    (forth-p3-check-stack
+      "WHILE inside IF branch"
+      ": Q 1 IF 0 3 BEGIN DUP 0 > WHILE TUCK + SWAP 1- REPEAT DROP ELSE 99 THEN ; Q"
+      (list 6))))
+
+(define
+  forth-p3-do-tests
+  (fn
+    ()
+    (forth-p3-check-stack
+      "DO LOOP — simple sum 0..4"
+      ": SUM 0 5 0 DO I + LOOP ; SUM"
+      (list 10))
+    (forth-p3-check-stack
+      "DO LOOP — 10..14 sum using I"
+      ": SUM 0 15 10 DO I + LOOP ; SUM"
+      (list 60))
+    (forth-p3-check-stack
+      "DO LOOP — limit = start runs one pass"
+      ": SUM 0 5 5 DO I + LOOP ; SUM"
+      (list 5))
+    (forth-p3-check-stack
+      "DO LOOP — count iterations"
+      ": COUNT 0 4 0 DO 1+ LOOP ; COUNT"
+      (list 4))
+    (forth-p3-check-stack
+      "DO LOOP — nested, I inner / J outer"
+      ": MATRIX 0 3 0 DO 3 0 DO I J + + LOOP LOOP ; MATRIX"
+      (list 18))
+    (forth-p3-check-stack
+      "DO LOOP — I used in arithmetic"
+      ": DBL 0 5 1 DO I 2 * + LOOP ; DBL"
+      (list 20))
+    (forth-p3-check-stack
+      "+LOOP — count by 2"
+      ": Q 0 10 0 DO I + 2 +LOOP ; Q"
+      (list 20))
+    (forth-p3-check-stack
+      "+LOOP — count by 3"
+      ": Q 0 10 0 DO I + 3 +LOOP ; Q"
+      (list 18))
+    (forth-p3-check-stack
+      "+LOOP — negative step"
+      ": Q 0 0 10 DO I + -1 +LOOP ; Q"
+      (list 55))
+    (forth-p3-check-stack
+      "LEAVE — early exit at I=3"
+      ": Q 0 10 0 DO I 3 = IF LEAVE THEN I + LOOP ; Q"
+      (list 3))
+    (forth-p3-check-stack
+      "LEAVE — in nested loop exits only inner"
+      ": Q 0 3 0 DO 5 0 DO I 2 = IF LEAVE THEN I + LOOP LOOP ; Q"
+      (list 3))
+    (forth-p3-check-stack
+      "DO LOOP preserves outer stack"
+      ": Q 99 5 0 DO I + LOOP ; Q"
+      (list 109))
+    (forth-p3-check-stack
+      ">R R>"
+      ": Q 7 >R 11 R> ; Q"
+      (list 11 7))
+    (forth-p3-check-stack
+      ">R R@ R>"
+      ": Q 7 >R R@ R> ; Q"
+      (list 7 7))
+    (forth-p3-check-stack
+      "2>R 2R>"
+      ": Q 1 2 2>R 99 2R> ; Q"
+      (list 99 1 2))
+    (forth-p3-check-stack
+      "2>R 2R@ 2R>"
+      ": Q 3 4 2>R 2R@ 2R> ; Q"
+      (list 3 4 3 4))))
+
+(define
+  forth-p3-run-all
+  (fn
+    ()
+    (set! forth-p3-passed 0)
+    (set! forth-p3-failed 0)
+    (set! forth-p3-failures (list))
+    (forth-p3-if-tests)
+    (forth-p3-loop-tests)
+    (forth-p3-do-tests)
+    (dict
+      "passed"
+      forth-p3-passed
+      "failed"
+      forth-p3-failed
+      "failures"
+      forth-p3-failures)))

lib/forth/tests/test-phase4.sx

@@ -0,0 +1,268 @@
+;; Phase 4 — strings + more Core.
+;; Uses the byte-memory model on state ("mem" dict + "here" cursor).
+
+(define forth-p4-passed 0)
+(define forth-p4-failed 0)
+(define forth-p4-failures (list))
+
+(define
+  forth-p4-assert
+  (fn
+    (label expected actual)
+    (if
+      (= expected actual)
+      (set! forth-p4-passed (+ forth-p4-passed 1))
+      (begin
+        (set! forth-p4-failed (+ forth-p4-failed 1))
+        (set!
+          forth-p4-failures
+          (concat
+            forth-p4-failures
+            (list
+              (str label ": expected " (str expected) " got " (str actual)))))))))
+
+(define
+  forth-p4-check-output
+  (fn
+    (label src expected)
+    (let ((r (forth-run src))) (forth-p4-assert label expected (nth r 1)))))
+
+(define
+  forth-p4-check-stack-size
+  (fn
+    (label src expected-n)
+    (let
+      ((r (forth-run src)))
+      (forth-p4-assert label expected-n (len (nth r 2))))))
+
+(define
+  forth-p4-check-top
+  (fn
+    (label src expected)
+    (let
+      ((r (forth-run src)))
+      (let
+        ((stk (nth r 2)))
+        (forth-p4-assert label expected (nth stk (- (len stk) 1)))))))
+
+(define
+  forth-p4-check-typed
+  (fn
+    (label src expected)
+    (forth-p4-check-output label (str src " TYPE") expected)))
+
+(define
+  forth-p4-string-tests
+  (fn
+    ()
+    (forth-p4-check-typed
+      "S\" + TYPE — hello"
+      "S\" HELLO\""
+      "HELLO")
+    (forth-p4-check-typed
+      "S\" + TYPE — two words"
+      "S\" HELLO WORLD\""
+      "HELLO WORLD")
+    (forth-p4-check-typed
+      "S\" + TYPE — empty"
+      "S\" \""
+      "")
+    (forth-p4-check-typed
+      "S\" + TYPE — single char"
+      "S\" X\""
+      "X")
+    (forth-p4-check-stack-size
+      "S\" pushes (addr len)"
+      "S\" HI\""
+      2)
+    (forth-p4-check-top
+      "S\" length is correct"
+      "S\" HELLO\""
+      5)
+    (forth-p4-check-output
+      ".\" prints at interpret time"
+      ".\" HELLO\""
+      "HELLO")
+    (forth-p4-check-output
+      ".\" in colon def"
+      ": GREET .\" HI \" ; GREET GREET"
+      "HI HI ")))
+
+(define
+  forth-p4-count-tests
+  (fn
+    ()
+    (forth-p4-check-typed
+      "C\" + COUNT + TYPE"
+      "C\" ABC\" COUNT"
+      "ABC")
+    (forth-p4-check-typed
+      "C\" then COUNT leaves right len"
+      "C\" HI THERE\" COUNT"
+      "HI THERE")))
+
+(define
+  forth-p4-fill-tests
+  (fn
+    ()
+    (forth-p4-check-typed
+      "FILL overwrites prefix bytes"
+      "S\" ABCDE\" 2DUP DROP 3 65 FILL"
+      "AAADE")
+    (forth-p4-check-typed
+      "BLANK sets spaces"
+      "S\" XYZAB\" 2DUP DROP 3 BLANK"
+      "   AB")))
+
+(define
+  forth-p4-cmove-tests
+  (fn
+    ()
+    (forth-p4-check-output
+      "CMOVE copies HELLO forward"
+      ": MKH 72 0 C! 69 1 C! 76 2 C! 76 3 C! 79 4 C! ;
+       : T MKH 0 10 5 CMOVE 10 5 TYPE ; T"
+      "HELLO")
+    (forth-p4-check-output
+      "CMOVE> copies overlapping backward"
+      ": MKA 65 0 C! 66 1 C! 67 2 C! ;
+       : T MKA 0 1 2 CMOVE> 0 3 TYPE ; T"
+      "AAB")
+    (forth-p4-check-output
+      "MOVE picks direction for overlap"
+      ": MKA 65 0 C! 66 1 C! 67 2 C! ;
+       : T MKA 0 1 2 MOVE 0 3 TYPE ; T"
+      "AAB")))
+
+(define
+  forth-p4-charplus-tests
+  (fn
+    ()
+    (forth-p4-check-top
+      "CHAR+ increments"
+      "5 CHAR+"
+      6)))
+
+(define
+  forth-p4-char-tests
+  (fn
+    ()
+    (forth-p4-check-top "CHAR A -> 65" "CHAR A" 65)
+    (forth-p4-check-top "CHAR x -> 120" "CHAR x" 120)
+    (forth-p4-check-top "CHAR takes only first char" "CHAR HELLO" 72)
+    (forth-p4-check-top
+      "[CHAR] compiles literal"
+      ": AA [CHAR] A ; AA"
+      65)
+    (forth-p4-check-top
+      "[CHAR] reads past IMMEDIATE"
+      ": ZZ [CHAR] Z ; ZZ"
+      90)
+    (forth-p4-check-stack-size
+      "[CHAR] doesn't leak at compile time"
+      ": FOO [CHAR] A ; "
+      0)))
+
+(define
+  forth-p4-key-accept-tests
+  (fn
+    ()
+    (let
+      ((r (forth-run "1000 2 ACCEPT")))
+      (let ((stk (nth r 2))) (forth-p4-assert "ACCEPT empty buf -> 0" (list 0) stk)))))
+
+(define
+  forth-p4-shift-tests
+  (fn
+    ()
+    (forth-p4-check-top "1 0 LSHIFT" "1 0 LSHIFT" 1)
+    (forth-p4-check-top "1 1 LSHIFT" "1 1 LSHIFT" 2)
+    (forth-p4-check-top "1 2 LSHIFT" "1 2 LSHIFT" 4)
+    (forth-p4-check-top "1 15 LSHIFT" "1 15 LSHIFT" 32768)
+    (forth-p4-check-top "1 31 LSHIFT" "1 31 LSHIFT" -2147483648)
+    (forth-p4-check-top "1 0 RSHIFT" "1 0 RSHIFT" 1)
+    (forth-p4-check-top "1 1 RSHIFT" "1 1 RSHIFT" 0)
+    (forth-p4-check-top "2 1 RSHIFT" "2 1 RSHIFT" 1)
+    (forth-p4-check-top "4 2 RSHIFT" "4 2 RSHIFT" 1)
+    (forth-p4-check-top "-1 1 RSHIFT (logical, not arithmetic)" "-1 1 RSHIFT" 2147483647)
+    (forth-p4-check-top "MSB via 1S 1 RSHIFT INVERT" "0 INVERT 1 RSHIFT INVERT" -2147483648)))
+
+(define
+  forth-p4-sp-tests
+  (fn
+    ()
+    (forth-p4-check-top "SP@ returns depth (0)" "SP@" 0)
+    (forth-p4-check-top
+      "SP@ after pushes"
+      "1 2 3 SP@ SWAP DROP SWAP DROP SWAP DROP"
+      3)
+    (forth-p4-check-stack-size
+      "SP! truncates"
+      "1 2 3 4 5 2 SP!"
+      2)
+    (forth-p4-check-top
+      "SP! leaves base items intact"
+      "1 2 3 4 5 2 SP!"
+      2)))
+
+(define
+  forth-p4-base-tests
+  (fn
+    ()
+    (forth-p4-check-top
+      "BASE default is 10"
+      "BASE @"
+      10)
+    (forth-p4-check-top
+      "HEX switches base to 16"
+      "HEX BASE @"
+      16)
+    (forth-p4-check-top
+      "DECIMAL resets to 10"
+      "HEX DECIMAL BASE @"
+      10)
+    (forth-p4-check-top
+      "HEX parses 10 as 16"
+      "HEX 10"
+      16)
+    (forth-p4-check-top
+      "HEX parses FF as 255"
+      "HEX FF"
+      255)
+    (forth-p4-check-top
+      "DECIMAL parses 10 as 10"
+      "HEX DECIMAL 10"
+      10)
+    (forth-p4-check-top
+      "OCTAL parses 17 as 15"
+      "OCTAL 17"
+      15)
+    (forth-p4-check-top
+      "BASE @ ; 16 BASE ! ; BASE @"
+      "BASE @ 16 BASE ! BASE @ SWAP DROP"
+      16)))
+
+(define
+  forth-p4-run-all
+  (fn
+    ()
+    (set! forth-p4-passed 0)
+    (set! forth-p4-failed 0)
+    (set! forth-p4-failures (list))
+    (forth-p4-string-tests)
+    (forth-p4-count-tests)
+    (forth-p4-fill-tests)
+    (forth-p4-cmove-tests)
+    (forth-p4-charplus-tests)
+    (forth-p4-char-tests)
+    (forth-p4-key-accept-tests)
+    (forth-p4-base-tests)
+    (forth-p4-shift-tests)
+    (forth-p4-sp-tests)
+    (dict
+      "passed"
+      forth-p4-passed
+      "failed"
+      forth-p4-failed
+      "failures"
+      forth-p4-failures)))

lib/forth/tests/test-phase5.sx

@@ -0,0 +1,333 @@
+;; Phase 5 — Core Extension + memory primitives.
+
+(define forth-p5-passed 0)
+(define forth-p5-failed 0)
+(define forth-p5-failures (list))
+
+(define
+  forth-p5-assert
+  (fn
+    (label expected actual)
+    (if
+      (= expected actual)
+      (set! forth-p5-passed (+ forth-p5-passed 1))
+      (begin
+        (set! forth-p5-failed (+ forth-p5-failed 1))
+        (set!
+          forth-p5-failures
+          (concat
+            forth-p5-failures
+            (list
+              (str label ": expected " (str expected) " got " (str actual)))))))))
+
+(define
+  forth-p5-check-stack
+  (fn
+    (label src expected)
+    (let ((r (forth-run src))) (forth-p5-assert label expected (nth r 2)))))
+
+(define
+  forth-p5-check-top
+  (fn
+    (label src expected)
+    (let
+      ((r (forth-run src)))
+      (let
+        ((stk (nth r 2)))
+        (forth-p5-assert label expected (nth stk (- (len stk) 1)))))))
+
+(define
+  forth-p5-create-tests
+  (fn
+    ()
+    (forth-p5-check-top
+      "CREATE pushes HERE-at-creation"
+      "HERE CREATE FOO FOO ="
+      -1)
+    (forth-p5-check-top
+      "CREATE + ALLOT advances HERE"
+      "HERE 5 ALLOT HERE SWAP -"
+      5)
+    (forth-p5-check-top
+      "CREATE + , stores cell"
+      "CREATE FOO 42 , FOO @"
+      42)
+    (forth-p5-check-stack
+      "CREATE multiple ,"
+      "CREATE TBL 1 , 2 , 3 , TBL @ TBL CELL+ @ TBL CELL+ CELL+ @"
+      (list 1 2 3))
+    (forth-p5-check-top
+      "C, stores byte"
+      "CREATE B 65 C, 66 C, B C@"
+      65)))
+
+(define
+  forth-p5-unsigned-tests
+  (fn
+    ()
+    (forth-p5-check-top "1 2 U<" "1 2 U<" -1)
+    (forth-p5-check-top "2 1 U<" "2 1 U<" 0)
+    (forth-p5-check-top "0 1 U<" "0 1 U<" -1)
+    (forth-p5-check-top "-1 1 U< (since -1 unsigned is huge)" "-1 1 U<" 0)
+    (forth-p5-check-top "1 -1 U<" "1 -1 U<" -1)
+    (forth-p5-check-top "1 2 U>" "1 2 U>" 0)
+    (forth-p5-check-top "-1 1 U>" "-1 1 U>" -1)))
+
+(define
+  forth-p5-2bang-tests
+  (fn
+    ()
+    (forth-p5-check-stack
+      "2! / 2@"
+      "CREATE X 0 , 0 , 11 22 X 2! X 2@"
+      (list 11 22))))
+
+(define
+  forth-p5-mixed-tests
+  (fn
+    ()
+    (forth-p5-check-stack "S>D positive" "5 S>D" (list 5 0))
+    (forth-p5-check-stack "S>D negative" "-5 S>D" (list -5 -1))
+    (forth-p5-check-stack "S>D zero" "0 S>D" (list 0 0))
+    (forth-p5-check-top "D>S keeps low" "5 0 D>S" 5)
+    (forth-p5-check-stack "M* small positive" "3 4 M*" (list 12 0))
+    (forth-p5-check-stack "M* negative" "-3 4 M*" (list -12 -1))
+    (forth-p5-check-stack
+      "M* negative * negative"
+      "-3 -4 M*"
+      (list 12 0))
+    (forth-p5-check-stack "UM* small" "3 4 UM*" (list 12 0))
+    (forth-p5-check-stack
+      "UM/MOD: 100 0 / 5"
+      "100 0 5 UM/MOD"
+      (list 0 20))
+    (forth-p5-check-stack
+      "FM/MOD: -7 / 2 floored"
+      "-7 -1 2 FM/MOD"
+      (list 1 -4))
+    (forth-p5-check-stack
+      "SM/REM: -7 / 2 truncated"
+      "-7 -1 2 SM/REM"
+      (list -1 -3))
+    (forth-p5-check-top "*/ truncated" "7 11 13 */" 5)
+    (forth-p5-check-stack "*/MOD" "7 11 13 */MOD" (list 12 5))))
+
+(define
+  forth-p5-double-tests
+  (fn
+    ()
+    (forth-p5-check-stack "D+ small" "5 0 7 0 D+" (list 12 0))
+    (forth-p5-check-stack "D+ negative" "-5 -1 -3 -1 D+" (list -8 -1))
+    (forth-p5-check-stack "D- small" "10 0 3 0 D-" (list 7 0))
+    (forth-p5-check-stack "DNEGATE positive" "5 0 DNEGATE" (list -5 -1))
+    (forth-p5-check-stack "DNEGATE negative" "-5 -1 DNEGATE" (list 5 0))
+    (forth-p5-check-stack "DABS negative" "-7 -1 DABS" (list 7 0))
+    (forth-p5-check-stack "DABS positive" "7 0 DABS" (list 7 0))
+    (forth-p5-check-top "D= equal" "5 0 5 0 D=" -1)
+    (forth-p5-check-top "D= unequal lo" "5 0 7 0 D=" 0)
+    (forth-p5-check-top "D= unequal hi" "5 0 5 1 D=" 0)
+    (forth-p5-check-top "D< lt" "5 0 7 0 D<" -1)
+    (forth-p5-check-top "D< gt" "7 0 5 0 D<" 0)
+    (forth-p5-check-top "D0= zero" "0 0 D0=" -1)
+    (forth-p5-check-top "D0= nonzero" "5 0 D0=" 0)
+    (forth-p5-check-top "D0< neg" "-5 -1 D0<" -1)
+    (forth-p5-check-top "D0< pos" "5 0 D0<" 0)
+    (forth-p5-check-stack "DMAX" "5 0 7 0 DMAX" (list 7 0))
+    (forth-p5-check-stack "DMIN" "5 0 7 0 DMIN" (list 5 0))))
+
+(define
+  forth-p5-format-tests
+  (fn
+    ()
+    (forth-p4-check-output-passthrough
+      "U. prints with trailing space"
+      "123 U."
+      "123 ")
+    (forth-p4-check-output-passthrough
+      "<# #S #> TYPE — decimal"
+      "123 0 <# #S #> TYPE"
+      "123")
+    (forth-p4-check-output-passthrough
+      "<# #S #> TYPE — hex"
+      "255 HEX 0 <# #S #> TYPE"
+      "FF")
+    (forth-p4-check-output-passthrough
+      "<# # # #> partial"
+      "1234 0 <# # # #> TYPE"
+      "34")
+    (forth-p4-check-output-passthrough
+      "SIGN holds minus"
+      "<# -1 SIGN -1 SIGN 0 0 #> TYPE"
+      "--")
+    (forth-p4-check-output-passthrough
+      ".R right-justifies"
+      "42 5 .R"
+      "   42")
+    (forth-p4-check-output-passthrough
+      ".R negative"
+      "-42 5 .R"
+      "  -42")
+    (forth-p4-check-output-passthrough
+      "U.R"
+      "42 5 U.R"
+      "   42")
+    (forth-p4-check-output-passthrough
+      "HOLD char"
+      "<# 0 0 65 HOLD #> TYPE"
+      "A")))
+
+(define
+  forth-p5-dict-tests
+  (fn
+    ()
+    (forth-p5-check-top
+      "EXECUTE via tick"
+      ": INC 1+ ; 9 ' INC EXECUTE"
+      10)
+    (forth-p5-check-top
+      "['] inside def"
+      ": DUB 2* ; : APPLY ['] DUB EXECUTE ; 5 APPLY"
+      10)
+    (forth-p5-check-top
+      ">BODY of CREATE word"
+      "CREATE C 99 , ' C >BODY @"
+      99)
+    (forth-p5-check-stack
+      "WORD parses next token to counted-string"
+      ": A 5 ; BL WORD A COUNT TYPE"
+      (list))
+    (forth-p5-check-top
+      "FIND on known word -> non-zero"
+      ": A 5 ; BL WORD A FIND SWAP DROP"
+      -1)))
+
+(define
+  forth-p5-state-tests
+  (fn
+    ()
+    (forth-p5-check-top
+      "STATE @ in interpret mode"
+      "STATE @"
+      0)
+    (forth-p5-check-top
+      "STATE @ via IMMEDIATE inside compile"
+      ": GT8 STATE @ ; IMMEDIATE : T GT8 LITERAL ; T"
+      -1)
+    (forth-p5-check-top
+      "[ ] LITERAL captures"
+      ": SEVEN [ 7 ] LITERAL ; SEVEN"
+      7)
+    (forth-p5-check-top
+      "EVALUATE in interpret mode"
+      "S\" 5 7 +\" EVALUATE"
+      12)
+    (forth-p5-check-top
+      "EVALUATE inside def"
+      ": A 100 ; : B S\" A\" EVALUATE ; B"
+      100)))
+
+(define
+  forth-p5-misc-tests
+  (fn
+    ()
+    (forth-p5-check-top "WITHIN inclusive lower" "3 2 10 WITHIN" -1)
+    (forth-p5-check-top "WITHIN exclusive upper" "10 2 10 WITHIN" 0)
+    (forth-p5-check-top "WITHIN below range" "1 2 10 WITHIN" 0)
+    (forth-p5-check-top "WITHIN at lower" "2 2 10 WITHIN" -1)
+    (forth-p5-check-top
+      "EXIT leaves colon-def early"
+      ": F 5 EXIT 99 ; F"
+      5)
+    (forth-p5-check-stack
+      "EXIT in IF branch"
+      ": F 5 0 IF DROP 99 EXIT THEN ; F"
+      (list 5))
+    (forth-p5-check-top
+      "UNLOOP + EXIT in DO"
+      ": SUM 0 10 0 DO I 5 = IF I UNLOOP EXIT THEN LOOP ; SUM"
+      5)))
+
+(define
+  forth-p5-fa-tests
+  (fn
+    ()
+    (forth-p5-check-top
+      "R/O R/W W/O constants"
+      "R/O R/W W/O + +"
+      3)
+    (forth-p5-check-top
+      "CREATE-FILE returns ior=0"
+      "CREATE PAD 50 ALLOT PAD S\" /tmp/test.fxf\" ROT SWAP CMOVE S\" /tmp/test.fxf\" R/W CREATE-FILE SWAP DROP"
+      0)
+    (forth-p5-check-top
+      "WRITE-FILE then CLOSE"
+      "S\" /tmp/t2.fxf\" R/W CREATE-FILE DROP >R S\" HI\" R@ WRITE-FILE R> CLOSE-FILE +"
+      0)
+    (forth-p5-check-top
+      "OPEN-FILE on unknown path returns ior!=0"
+      "S\" /tmp/nope.fxf\" R/O OPEN-FILE SWAP DROP 0 ="
+      0)))
+
+(define
+  forth-p5-string-tests
+  (fn
+    ()
+    (forth-p5-check-top "COMPARE equal" "S\" ABC\" S\" ABC\" COMPARE" 0)
+    (forth-p5-check-top "COMPARE less" "S\" ABC\" S\" ABD\" COMPARE" -1)
+    (forth-p5-check-top "COMPARE greater" "S\" ABD\" S\" ABC\" COMPARE" 1)
+    (forth-p5-check-top
+      "COMPARE prefix less"
+      "S\" AB\" S\" ABC\" COMPARE"
+      -1)
+    (forth-p5-check-top
+      "COMPARE prefix greater"
+      "S\" ABC\" S\" AB\" COMPARE"
+      1)
+    (forth-p5-check-top
+      "SEARCH found flag"
+      "S\" HELLO WORLD\" S\" WORLD\" SEARCH"
+      -1)
+    (forth-p5-check-top
+      "SEARCH not found flag"
+      "S\" HELLO\" S\" XYZ\" SEARCH"
+      0)
+    (forth-p5-check-top
+      "SEARCH empty needle flag"
+      "S\" HELLO\" S\" \" SEARCH"
+      -1)
+    (forth-p5-check-top
+      "SLITERAL via [ S\" ... \" ]"
+      ": A [ S\" HI\" ] SLITERAL ; A SWAP DROP"
+      2)))
+
+(define
+  forth-p4-check-output-passthrough
+  (fn
+    (label src expected)
+    (let ((r (forth-run src))) (forth-p5-assert label expected (nth r 1)))))
+
+(define
+  forth-p5-run-all
+  (fn
+    ()
+    (set! forth-p5-passed 0)
+    (set! forth-p5-failed 0)
+    (set! forth-p5-failures (list))
+    (forth-p5-create-tests)
+    (forth-p5-unsigned-tests)
+    (forth-p5-2bang-tests)
+    (forth-p5-mixed-tests)
+    (forth-p5-double-tests)
+    (forth-p5-format-tests)
+    (forth-p5-dict-tests)
+    (forth-p5-state-tests)
+    (forth-p5-misc-tests)
+    (forth-p5-fa-tests)
+    (forth-p5-string-tests)
+    (dict
+      "passed"
+      forth-p5-passed
+      "failed"
+      forth-p5-failed
+      "failures"
+      forth-p5-failures)))

lib/haskell/runtime.sx

@@ -0,0 +1,507 @@
+;; lib/haskell/runtime.sx — Haskell-on-SX runtime layer
+;;
+;; Covers the Haskell primitives now reachable via SX spec:
+;;  1. Numeric type class helpers (Num / Integral / Fractional)
+;;  2. Rational numbers (dict-based: {:_rational true :num n :den d})
+;;  3. Lazy evaluation — hk-force for promises created by delay
+;;  4. Char utilities (Data.Char)
+;;  5. Data.Set wrappers
+;;  6. Data.List utilities
+;;  7. Maybe / Either ADTs
+;;  8. Tuples (lists, since list->vector unreliable in sx_server)
+;;  9. String helpers (words/lines/isPrefixOf/etc.)
+;; 10. Show helper
+
+;; ===========================================================================
+;; 1. Numeric type class helpers
+;; ===========================================================================
+
+(define hk-is-integer? integer?)
+(define hk-is-float? float?)
+(define hk-is-num? number?)
+
+;; fromIntegral — coerce integer to Float
+(define (hk-to-float x) (exact->inexact x))
+
+;; truncate / round toward zero
+(define hk-to-integer truncate)
+(define hk-from-integer (fn (n) n))
+
+;; Haskell div: floor division (rounds toward -inf)
+(define
+  (hk-div a b)
+  (let
+    ((q (quotient a b)) (r (remainder a b)))
+    (if
+      (and
+        (not (= r 0))
+        (or
+          (and (< a 0) (> b 0))
+          (and (> a 0) (< b 0))))
+      (- q 1)
+      q)))
+
+;; Haskell mod: result has same sign as divisor
+(define hk-mod modulo)
+
+;; Haskell rem: result has same sign as dividend
+(define hk-rem remainder)
+
+;; Haskell quot: truncation division
+(define hk-quot quotient)
+
+;; divMod and quotRem return pairs (lists)
+(define (hk-div-mod a b) (list (hk-div a b) (hk-mod a b)))
+(define (hk-quot-rem a b) (list (hk-quot a b) (hk-rem a b)))
+
+(define (hk-abs x) (if (< x 0) (- 0 x) x))
+(define
+  (hk-signum x)
+  (cond
+    ((> x 0) 1)
+    ((< x 0) -1)
+    (else 0)))
+
+(define hk-gcd gcd)
+(define hk-lcm lcm)
+
+(define (hk-even? n) (= (modulo n 2) 0))
+(define (hk-odd? n) (not (= (modulo n 2) 0)))
+
+;; ===========================================================================
+;; 2. Rational numbers (dict implementation — no built-in rational in sx_server)
+;; ===========================================================================
+
+(define
+  (hk-make-rational n d)
+  (let
+    ((g (gcd (hk-abs n) (hk-abs d))))
+    (if (< d 0) {:num (quotient (- 0 n) g) :den (quotient (- 0 d) g) :_rational true} {:num (quotient n g) :den (quotient d g) :_rational true})))
+
+(define
+  (hk-rational? x)
+  (and (dict? x) (not (= (get x :_rational) nil))))
+(define (hk-numerator r) (get r :num))
+(define (hk-denominator r) (get r :den))
+
+(define
+  (hk-rational-add r1 r2)
+  (hk-make-rational
+    (+
+      (* (hk-numerator r1) (hk-denominator r2))
+      (* (hk-numerator r2) (hk-denominator r1)))
+    (* (hk-denominator r1) (hk-denominator r2))))
+
+(define
+  (hk-rational-sub r1 r2)
+  (hk-make-rational
+    (-
+      (* (hk-numerator r1) (hk-denominator r2))
+      (* (hk-numerator r2) (hk-denominator r1)))
+    (* (hk-denominator r1) (hk-denominator r2))))
+
+(define
+  (hk-rational-mul r1 r2)
+  (hk-make-rational
+    (* (hk-numerator r1) (hk-numerator r2))
+    (* (hk-denominator r1) (hk-denominator r2))))
+
+(define
+  (hk-rational-div r1 r2)
+  (hk-make-rational
+    (* (hk-numerator r1) (hk-denominator r2))
+    (* (hk-denominator r1) (hk-numerator r2))))
+
+(define
+  (hk-rational-to-float r)
+  (exact->inexact (/ (hk-numerator r) (hk-denominator r))))
+
+(define (hk-show-rational r) (str (hk-numerator r) "%" (hk-denominator r)))
+
+;; ===========================================================================
+;; 3. Lazy evaluation — promises (created via SX delay)
+;; ===========================================================================
+
+(define
+  (hk-force p)
+  (if
+    (and (dict? p) (not (= (get p :_promise) nil)))
+    (if (get p :forced) (get p :value) ((get p :thunk)))
+    p))
+
+;; ===========================================================================
+;; 4. Char utilities (Data.Char)
+;; ===========================================================================
+
+(define hk-ord char->integer)
+(define hk-chr integer->char)
+
+;; Inline ASCII predicates — char-alphabetic?/char-numeric? unreliable in sx_server
+(define
+  (hk-is-alpha? c)
+  (let
+    ((n (char->integer c)))
+    (or
+      (and (>= n 65) (<= n 90))
+      (and (>= n 97) (<= n 122)))))
+
+(define
+  (hk-is-digit? c)
+  (let ((n (char->integer c))) (and (>= n 48) (<= n 57))))
+
+(define
+  (hk-is-alnum? c)
+  (let
+    ((n (char->integer c)))
+    (or
+      (and (>= n 48) (<= n 57))
+      (and (>= n 65) (<= n 90))
+      (and (>= n 97) (<= n 122)))))
+
+(define
+  (hk-is-upper? c)
+  (let ((n (char->integer c))) (and (>= n 65) (<= n 90))))
+
+(define
+  (hk-is-lower? c)
+  (let ((n (char->integer c))) (and (>= n 97) (<= n 122))))
+
+(define
+  (hk-is-space? c)
+  (let
+    ((n (char->integer c)))
+    (or
+      (= n 32)
+      (= n 9)
+      (= n 10)
+      (= n 13)
+      (= n 12)
+      (= n 11))))
+
+(define hk-to-upper char-upcase)
+(define hk-to-lower char-downcase)
+
+;; digitToInt: '0'-'9' → 0-9, 'a'-'f'/'A'-'F' → 10-15
+(define
+  (hk-digit-to-int c)
+  (let
+    ((n (char->integer c)))
+    (cond
+      ((and (>= n 48) (<= n 57)) (- n 48))
+      ((and (>= n 65) (<= n 70)) (- n 55))
+      ((and (>= n 97) (<= n 102)) (- n 87))
+      (else (error (str "hk-digit-to-int: not a hex digit: " c))))))
+
+;; intToDigit: 0-15 → char
+(define
+  (hk-int-to-digit n)
+  (cond
+    ((and (>= n 0) (<= n 9))
+      (integer->char (+ n 48)))
+    ((and (>= n 10) (<= n 15))
+      (integer->char (+ n 87)))
+    (else (error (str "hk-int-to-digit: out of range: " n)))))
+
+;; ===========================================================================
+;; 5. Data.Set wrappers
+;; ===========================================================================
+
+(define (hk-set-empty) (make-set))
+(define hk-set? set?)
+(define hk-set-member? set-member?)
+
+(define (hk-set-insert x s) (begin (set-add! s x) s))
+
+(define (hk-set-delete x s) (begin (set-remove! s x) s))
+
+(define hk-set-union set-union)
+(define hk-set-intersection set-intersection)
+(define hk-set-difference set-difference)
+(define hk-set-from-list list->set)
+(define hk-set-to-list set->list)
+(define (hk-set-null? s) (= (len (set->list s)) 0))
+(define (hk-set-size s) (len (set->list s)))
+
+(define (hk-set-singleton x) (let ((s (make-set))) (set-add! s x) s))
+
+;; ===========================================================================
+;; 6. Data.List utilities
+;; ===========================================================================
+
+(define hk-head first)
+(define hk-tail rest)
+(define (hk-null? lst) (= (len lst) 0))
+(define hk-length len)
+
+(define
+  (hk-take n lst)
+  (if
+    (or (= n 0) (= (len lst) 0))
+    (list)
+    (cons (first lst) (hk-take (- n 1) (rest lst)))))
+
+(define
+  (hk-drop n lst)
+  (if
+    (or (= n 0) (= (len lst) 0))
+    lst
+    (hk-drop (- n 1) (rest lst))))
+
+(define
+  (hk-take-while pred lst)
+  (if
+    (or (= (len lst) 0) (not (pred (first lst))))
+    (list)
+    (cons (first lst) (hk-take-while pred (rest lst)))))
+
+(define
+  (hk-drop-while pred lst)
+  (if
+    (or (= (len lst) 0) (not (pred (first lst))))
+    lst
+    (hk-drop-while pred (rest lst))))
+
+(define
+  (hk-zip a b)
+  (if
+    (or (= (len a) 0) (= (len b) 0))
+    (list)
+    (cons (list (first a) (first b)) (hk-zip (rest a) (rest b)))))
+
+(define
+  (hk-zip-with f a b)
+  (if
+    (or (= (len a) 0) (= (len b) 0))
+    (list)
+    (cons (f (first a) (first b)) (hk-zip-with f (rest a) (rest b)))))
+
+(define
+  (hk-unzip pairs)
+  (list
+    (map (fn (p) (first p)) pairs)
+    (map (fn (p) (nth p 1)) pairs)))
+
+(define
+  (hk-elem x lst)
+  (cond
+    ((= (len lst) 0) false)
+    ((= x (first lst)) true)
+    (else (hk-elem x (rest lst)))))
+
+(define (hk-not-elem x lst) (not (hk-elem x lst)))
+
+(define
+  (hk-nub lst)
+  (letrec
+    ((go (fn (seen acc items) (if (= (len items) 0) (reverse acc) (let ((h (first items)) (t (rest items))) (if (hk-elem h seen) (go seen acc t) (go (cons h seen) (cons h acc) t)))))))
+    (go (list) (list) lst)))
+
+(define (hk-sum lst) (reduce + 0 lst))
+(define (hk-product lst) (reduce * 1 lst))
+
+(define
+  (hk-maximum lst)
+  (reduce (fn (a b) (if (> a b) a b)) (first lst) (rest lst)))
+
+(define
+  (hk-minimum lst)
+  (reduce (fn (a b) (if (< a b) a b)) (first lst) (rest lst)))
+
+(define (hk-concat lsts) (reduce append (list) lsts))
+
+(define (hk-concat-map f lst) (hk-concat (map f lst)))
+
+(define hk-sort sort)
+
+(define
+  (hk-span pred lst)
+  (list (hk-take-while pred lst) (hk-drop-while pred lst)))
+
+(define (hk-break pred lst) (hk-span (fn (x) (not (pred x))) lst))
+
+(define
+  (hk-foldl f acc lst)
+  (if
+    (= (len lst) 0)
+    acc
+    (hk-foldl f (f acc (first lst)) (rest lst))))
+
+(define
+  (hk-foldr f z lst)
+  (if
+    (= (len lst) 0)
+    z
+    (f (first lst) (hk-foldr f z (rest lst)))))
+
+(define
+  (hk-scanl f acc lst)
+  (if
+    (= (len lst) 0)
+    (list acc)
+    (cons acc (hk-scanl f (f acc (first lst)) (rest lst)))))
+
+(define
+  (hk-replicate n x)
+  (if (= n 0) (list) (cons x (hk-replicate (- n 1) x))))
+
+(define
+  (hk-intersperse sep lst)
+  (if
+    (or (= (len lst) 0) (= (len lst) 1))
+    lst
+    (cons (first lst) (cons sep (hk-intersperse sep (rest lst))))))
+
+;; ===========================================================================
+;; 7. Maybe / Either ADTs
+;; ===========================================================================
+
+(define hk-nothing {:_maybe true :_tag "nothing"})
+(define (hk-just x) {:_maybe true :value x :_tag "just"})
+(define (hk-is-nothing? m) (= (get m :_tag) "nothing"))
+(define (hk-is-just? m) (= (get m :_tag) "just"))
+(define (hk-from-just m) (get m :value))
+(define (hk-from-maybe def m) (if (hk-is-nothing? m) def (hk-from-just m)))
+(define
+  (hk-maybe def f m)
+  (if (hk-is-nothing? m) def (f (hk-from-just m))))
+
+(define (hk-left x) {:value x :_either true :_tag "left"})
+(define (hk-right x) {:value x :_either true :_tag "right"})
+(define (hk-is-left? e) (= (get e :_tag) "left"))
+(define (hk-is-right? e) (= (get e :_tag) "right"))
+(define (hk-from-left e) (get e :value))
+(define (hk-from-right e) (get e :value))
+(define
+  (hk-either f g e)
+  (if (hk-is-left? e) (f (hk-from-left e)) (g (hk-from-right e))))
+
+;; ===========================================================================
+;; 8. Tuples (lists — list->vector unreliable in sx_server)
+;; ===========================================================================
+
+(define (hk-pair a b) (list a b))
+(define hk-fst first)
+(define (hk-snd t) (nth t 1))
+
+(define (hk-triple a b c) (list a b c))
+(define hk-fst3 first)
+(define (hk-snd3 t) (nth t 1))
+(define (hk-thd3 t) (nth t 2))
+
+(define (hk-curry f) (fn (a) (fn (b) (f a b))))
+(define (hk-uncurry f) (fn (p) (f (hk-fst p) (hk-snd p))))
+
+;; ===========================================================================
+;; 9. String helpers (Data.List / Data.Char for strings)
+;; ===========================================================================
+
+;; words: split on whitespace
+(define
+  (hk-words s)
+  (letrec
+    ((slen (len s))
+      (skip-ws
+        (fn
+          (i)
+          (if
+            (>= i slen)
+            (list)
+            (let
+              ((c (substring s i (+ i 1))))
+              (if
+                (or (= c " ") (= c "\t") (= c "\n"))
+                (skip-ws (+ i 1))
+                (collect-word i (+ i 1)))))))
+      (collect-word
+        (fn
+          (start i)
+          (if
+            (>= i slen)
+            (list (substring s start i))
+            (let
+              ((c (substring s i (+ i 1))))
+              (if
+                (or (= c " ") (= c "\t") (= c "\n"))
+                (cons (substring s start i) (skip-ws (+ i 1)))
+                (collect-word start (+ i 1))))))))
+    (skip-ws 0)))
+
+;; unwords: join with spaces
+(define
+  (hk-unwords lst)
+  (if
+    (= (len lst) 0)
+    ""
+    (reduce (fn (a b) (str a " " b)) (first lst) (rest lst))))
+
+;; lines: split on newline
+(define
+  (hk-lines s)
+  (letrec
+    ((slen (len s))
+      (go
+        (fn
+          (start i acc)
+          (if
+            (>= i slen)
+            (reverse (cons (substring s start i) acc))
+            (if
+              (= (substring s i (+ i 1)) "\n")
+              (go
+                (+ i 1)
+                (+ i 1)
+                (cons (substring s start i) acc))
+              (go start (+ i 1) acc))))))
+    (if (= slen 0) (list) (go 0 0 (list)))))
+
+;; unlines: join, each with trailing newline
+(define (hk-unlines lst) (reduce (fn (a b) (str a b "\n")) "" lst))
+
+;; isPrefixOf
+(define
+  (hk-is-prefix-of pre s)
+  (and (<= (len pre) (len s)) (= pre (substring s 0 (len pre)))))
+
+;; isSuffixOf
+(define
+  (hk-is-suffix-of suf s)
+  (let
+    ((sl (len suf)) (tl (len s)))
+    (and (<= sl tl) (= suf (substring s (- tl sl) tl)))))
+
+;; isInfixOf — linear scan
+(define
+  (hk-is-infix-of pat s)
+  (let
+    ((plen (len pat)) (slen (len s)))
+    (letrec
+      ((go (fn (i) (if (> (+ i plen) slen) false (if (= pat (substring s i (+ i plen))) true (go (+ i 1)))))))
+      (if (= plen 0) true (go 0)))))
+
+;; ===========================================================================
+;; 10. Show helper
+;; ===========================================================================
+
+(define
+  (hk-show x)
+  (cond
+    ((= x nil) "Nothing")
+    ((= x true) "True")
+    ((= x false) "False")
+    ((hk-rational? x) (hk-show-rational x))
+    ((integer? x) (str x))
+    ((float? x) (str x))
+    ((= (type-of x) "string") (str "\"" x "\""))
+    ((= (type-of x) "char") (str "'" (str x) "'"))
+    ((list? x)
+      (str
+        "["
+        (if
+          (= (len x) 0)
+          ""
+          (reduce
+            (fn (a b) (str a "," (hk-show b)))
+            (hk-show (first x))
+            (rest x)))
+        "]"))
+    (else (str x))))

lib/haskell/test.sh

@@ -46,6 +46,7 @@ for FILE in "${FILES[@]}"; do
   cat > "$TMPFILE" <<EPOCHS
 (epoch 1)
 (load "lib/haskell/tokenizer.sx")
+(load "lib/haskell/runtime.sx")
 (epoch 2)
 (load "$FILE")
 (epoch 3)
@@ -81,6 +82,7 @@ EPOCHS
     cat > "$TMPFILE2" <<EPOCHS
 (epoch 1)
 (load "lib/haskell/tokenizer.sx")
+(load "lib/haskell/runtime.sx")
 (epoch 2)
 (load "$FILE")
 (epoch 3)

lib/haskell/tests/runtime.sx

@@ -0,0 +1,451 @@
+;; lib/haskell/tests/runtime.sx — smoke-tests for lib/haskell/runtime.sx
+;;
+;; Uses the same hk-test framework as tests/parse.sx.
+;; Loaded by test.sh after: tokenizer.sx + runtime.sx are pre-loaded.
+
+;; ---------------------------------------------------------------------------
+;; Test framework boilerplate (mirrors parse.sx)
+;; ---------------------------------------------------------------------------
+
+(define hk-test-pass 0)
+(define hk-test-fail 0)
+(define hk-test-fails (list))
+
+(define
+  (hk-test name actual expected)
+  (if
+    (= actual expected)
+    (set! hk-test-pass (+ hk-test-pass 1))
+    (do
+      (set! hk-test-fail (+ hk-test-fail 1))
+      (append! hk-test-fails {:actual actual :expected expected :name name}))))
+
+;; ---------------------------------------------------------------------------
+;; 1. Numeric type class helpers
+;; ---------------------------------------------------------------------------
+
+(hk-test "is-integer? int" (hk-is-integer? 42) true)
+(hk-test "is-integer? float" (hk-is-integer? 1.5) false)
+(hk-test "is-float? float" (hk-is-float? 3.14) true)
+(hk-test "is-float? int" (hk-is-float? 3) false)
+(hk-test "is-num? int" (hk-is-num? 10) true)
+(hk-test "is-num? float" (hk-is-num? 1) true)
+
+(hk-test "to-float" (hk-to-float 5) 5)
+(hk-test "to-integer trunc" (hk-to-integer 3.7) 3)
+
+(hk-test "div pos pos" (hk-div 7 2) 3)
+(hk-test "div neg pos" (hk-div -7 2) -4)
+(hk-test "div pos neg" (hk-div 7 -2) -4)
+(hk-test "div neg neg" (hk-div -7 -2) 3)
+(hk-test "div exact" (hk-div 6 2) 3)
+
+(hk-test "mod pos pos" (hk-mod 10 3) 1)
+(hk-test "mod neg pos" (hk-mod -7 3) 2)
+(hk-test "rem pos pos" (hk-rem 10 3) 1)
+(hk-test "rem neg pos" (hk-rem -7 3) -1)
+
+(hk-test "abs pos" (hk-abs 5) 5)
+(hk-test "abs neg" (hk-abs -5) 5)
+(hk-test "signum pos" (hk-signum 42) 1)
+(hk-test "signum neg" (hk-signum -7) -1)
+(hk-test "signum zero" (hk-signum 0) 0)
+
+(hk-test "gcd" (hk-gcd 12 8) 4)
+(hk-test "lcm" (hk-lcm 4 6) 12)
+(hk-test "even?" (hk-even? 4) true)
+(hk-test "even? odd" (hk-even? 3) false)
+(hk-test "odd?" (hk-odd? 7) true)
+
+;; ---------------------------------------------------------------------------
+;; 2. Rational numbers
+;; ---------------------------------------------------------------------------
+
+(let
+  ((r (hk-make-rational 1 2)))
+  (do
+    (hk-test "rational?" (hk-rational? r) true)
+    (hk-test "numerator" (hk-numerator r) 1)
+    (hk-test "denominator" (hk-denominator r) 2)))
+
+(let
+  ((r (hk-make-rational 2 4)))
+  (do
+    (hk-test "rat normalise num" (hk-numerator r) 1)
+    (hk-test "rat normalise den" (hk-denominator r) 2)))
+
+(let
+  ((sum (hk-rational-add (hk-make-rational 1 2) (hk-make-rational 1 3))))
+  (do
+    (hk-test "rat-add num" (hk-numerator sum) 5)
+    (hk-test "rat-add den" (hk-denominator sum) 6)))
+
+(hk-test
+  "rat-to-float"
+  (hk-rational-to-float (hk-make-rational 1 2))
+  0.5)
+(hk-test "rational? int" (hk-rational? 42) false)
+
+;; ---------------------------------------------------------------------------
+;; 3. Lazy evaluation (promises via SX delay)
+;; ---------------------------------------------------------------------------
+
+(let
+  ((p (delay 42)))
+  (hk-test "force promise" (hk-force p) 42))
+
+(hk-test "force non-promise" (hk-force 99) 99)
+
+;; ---------------------------------------------------------------------------
+;; 4. Char utilities — compare via hk-ord to avoid = on char type
+;; ---------------------------------------------------------------------------
+
+(hk-test "ord A" (hk-ord (integer->char 65)) 65)
+(hk-test "chr 65" (hk-ord (hk-chr 65)) 65)
+(hk-test "is-alpha? A" (hk-is-alpha? (integer->char 65)) true)
+(hk-test "is-alpha? 0" (hk-is-alpha? (integer->char 48)) false)
+(hk-test "is-digit? 5" (hk-is-digit? (integer->char 53)) true)
+(hk-test "is-digit? A" (hk-is-digit? (integer->char 65)) false)
+(hk-test "is-upper? A" (hk-is-upper? (integer->char 65)) true)
+(hk-test "is-upper? a" (hk-is-upper? (integer->char 97)) false)
+(hk-test "is-lower? a" (hk-is-lower? (integer->char 97)) true)
+(hk-test "is-space? spc" (hk-is-space? (integer->char 32)) true)
+(hk-test "is-space? A" (hk-is-space? (integer->char 65)) false)
+(hk-test
+  "to-upper a"
+  (hk-ord (hk-to-upper (integer->char 97)))
+  65)
+(hk-test
+  "to-lower A"
+  (hk-ord (hk-to-lower (integer->char 65)))
+  97)
+(hk-test
+  "digit-to-int 0"
+  (hk-digit-to-int (integer->char 48))
+  0)
+(hk-test
+  "digit-to-int 9"
+  (hk-digit-to-int (integer->char 57))
+  9)
+(hk-test
+  "digit-to-int a"
+  (hk-digit-to-int (integer->char 97))
+  10)
+(hk-test
+  "digit-to-int F"
+  (hk-digit-to-int (integer->char 70))
+  15)
+(hk-test "int-to-digit 0" (hk-ord (hk-int-to-digit 0)) 48)
+(hk-test "int-to-digit 10" (hk-ord (hk-int-to-digit 10)) 97)
+
+;; ---------------------------------------------------------------------------
+;; 5. Data.Set
+;; ---------------------------------------------------------------------------
+
+(hk-test "set-empty is set?" (hk-set? (hk-set-empty)) true)
+(hk-test "set-null? empty" (hk-set-null? (hk-set-empty)) true)
+
+(let
+  ((s (hk-set-singleton 42)))
+  (do
+    (hk-test "singleton member" (hk-set-member? 42 s) true)
+    (hk-test "singleton size" (hk-set-size s) 1)))
+
+(let
+  ((s (hk-set-from-list (list 1 2 3))))
+  (do
+    (hk-test "from-list member" (hk-set-member? 2 s) true)
+    (hk-test "from-list absent" (hk-set-member? 9 s) false)
+    (hk-test "from-list size" (hk-set-size s) 3)))
+
+;; ---------------------------------------------------------------------------
+;; 6. Data.List
+;; ---------------------------------------------------------------------------
+
+(hk-test "head" (hk-head (list 1 2 3)) 1)
+(hk-test
+  "tail length"
+  (len (hk-tail (list 1 2 3)))
+  2)
+(hk-test "null? empty" (hk-null? (list)) true)
+(hk-test "null? non-empty" (hk-null? (list 1)) false)
+(hk-test
+  "length"
+  (hk-length (list 1 2 3))
+  3)
+
+(hk-test
+  "take 2"
+  (hk-take 2 (list 1 2 3))
+  (list 1 2))
+(hk-test "take 0" (hk-take 0 (list 1 2)) (list))
+(hk-test
+  "take overflow"
+  (hk-take 5 (list 1 2))
+  (list 1 2))
+(hk-test
+  "drop 1"
+  (hk-drop 1 (list 1 2 3))
+  (list 2 3))
+(hk-test
+  "drop 0"
+  (hk-drop 0 (list 1 2))
+  (list 1 2))
+
+(hk-test
+  "take-while"
+  (hk-take-while
+    (fn (x) (< x 3))
+    (list 1 2 3 4))
+  (list 1 2))
+(hk-test
+  "drop-while"
+  (hk-drop-while
+    (fn (x) (< x 3))
+    (list 1 2 3 4))
+  (list 3 4))
+
+(hk-test
+  "zip"
+  (hk-zip (list 1 2) (list 3 4))
+  (list (list 1 3) (list 2 4)))
+(hk-test
+  "zip uneven"
+  (hk-zip
+    (list 1 2 3)
+    (list 4 5))
+  (list (list 1 4) (list 2 5)))
+
+(hk-test
+  "zip-with +"
+  (hk-zip-with
+    +
+    (list 1 2 3)
+    (list 10 20 30))
+  (list 11 22 33))
+
+(hk-test
+  "unzip fst"
+  (first
+    (hk-unzip
+      (list (list 1 3) (list 2 4))))
+  (list 1 2))
+(hk-test
+  "unzip snd"
+  (nth
+    (hk-unzip
+      (list (list 1 3) (list 2 4)))
+    1)
+  (list 3 4))
+
+(hk-test
+  "elem hit"
+  (hk-elem 2 (list 1 2 3))
+  true)
+(hk-test
+  "elem miss"
+  (hk-elem 9 (list 1 2 3))
+  false)
+(hk-test
+  "not-elem"
+  (hk-not-elem 9 (list 1 2 3))
+  true)
+
+(hk-test
+  "nub"
+  (hk-nub (list 1 2 1 3 2))
+  (list 1 2 3))
+
+(hk-test
+  "sum"
+  (hk-sum (list 1 2 3 4))
+  10)
+(hk-test
+  "product"
+  (hk-product (list 1 2 3 4))
+  24)
+(hk-test
+  "maximum"
+  (hk-maximum (list 3 1 4 1 5))
+  5)
+(hk-test
+  "minimum"
+  (hk-minimum (list 3 1 4 1 5))
+  1)
+
+(hk-test
+  "concat"
+  (hk-concat
+    (list (list 1 2) (list 3 4)))
+  (list 1 2 3 4))
+(hk-test
+  "concat-map"
+  (hk-concat-map
+    (fn (x) (list x (* x x)))
+    (list 1 2 3))
+  (list 1 1 2 4 3 9))
+
+(hk-test
+  "sort"
+  (hk-sort (list 3 1 4 1 5))
+  (list 1 1 3 4 5))
+(hk-test
+  "replicate"
+  (hk-replicate 3 0)
+  (list 0 0 0))
+(hk-test "replicate 0" (hk-replicate 0 99) (list))
+
+(hk-test
+  "intersperse"
+  (hk-intersperse 0 (list 1 2 3))
+  (list 1 0 2 0 3))
+(hk-test
+  "intersperse 1"
+  (hk-intersperse 0 (list 1))
+  (list 1))
+(hk-test "intersperse empty" (hk-intersperse 0 (list)) (list))
+
+(hk-test
+  "span"
+  (hk-span
+    (fn (x) (< x 3))
+    (list 1 2 3 4))
+  (list (list 1 2) (list 3 4)))
+(hk-test
+  "break"
+  (hk-break
+    (fn (x) (>= x 3))
+    (list 1 2 3 4))
+  (list (list 1 2) (list 3 4)))
+
+(hk-test
+  "foldl"
+  (hk-foldl
+    (fn (a b) (- a b))
+    10
+    (list 1 2 3))
+  4)
+(hk-test
+  "foldr"
+  (hk-foldr cons (list) (list 1 2 3))
+  (list 1 2 3))
+
+(hk-test
+  "scanl"
+  (hk-scanl + 0 (list 1 2 3))
+  (list 0 1 3 6))
+
+;; ---------------------------------------------------------------------------
+;; 7. Maybe / Either
+;; ---------------------------------------------------------------------------
+
+(hk-test "nothing is-nothing?" (hk-is-nothing? hk-nothing) true)
+(hk-test "nothing is-just?" (hk-is-just? hk-nothing) false)
+(hk-test "just is-just?" (hk-is-just? (hk-just 42)) true)
+(hk-test "just is-nothing?" (hk-is-nothing? (hk-just 42)) false)
+(hk-test "from-just" (hk-from-just (hk-just 99)) 99)
+(hk-test
+  "from-maybe nothing"
+  (hk-from-maybe 0 hk-nothing)
+  0)
+(hk-test
+  "from-maybe just"
+  (hk-from-maybe 0 (hk-just 42))
+  42)
+(hk-test
+  "maybe nothing"
+  (hk-maybe 0 (fn (x) (* x 2)) hk-nothing)
+  0)
+(hk-test
+  "maybe just"
+  (hk-maybe 0 (fn (x) (* x 2)) (hk-just 5))
+  10)
+
+(hk-test "left is-left?" (hk-is-left? (hk-left "e")) true)
+(hk-test "right is-right?" (hk-is-right? (hk-right 42)) true)
+(hk-test "from-right" (hk-from-right (hk-right 7)) 7)
+(hk-test
+  "either left"
+  (hk-either (fn (x) (str "L" x)) (fn (x) (str "R" x)) (hk-left "err"))
+  "Lerr")
+(hk-test
+  "either right"
+  (hk-either
+    (fn (x) (str "L" x))
+    (fn (x) (str "R" x))
+    (hk-right 42))
+  "R42")
+
+;; ---------------------------------------------------------------------------
+;; 8. Tuples
+;; ---------------------------------------------------------------------------
+
+(hk-test "pair" (hk-pair 1 2) (list 1 2))
+(hk-test "fst" (hk-fst (hk-pair 3 4)) 3)
+(hk-test "snd" (hk-snd (hk-pair 3 4)) 4)
+(hk-test
+  "triple"
+  (hk-triple 1 2 3)
+  (list 1 2 3))
+(hk-test
+  "fst3"
+  (hk-fst3 (hk-triple 7 8 9))
+  7)
+(hk-test
+  "thd3"
+  (hk-thd3 (hk-triple 7 8 9))
+  9)
+
+(hk-test "curry" ((hk-curry +) 3 4) 7)
+(hk-test
+  "uncurry"
+  ((hk-uncurry (fn (a b) (* a b))) (list 3 4))
+  12)
+
+;; ---------------------------------------------------------------------------
+;; 9. String helpers
+;; ---------------------------------------------------------------------------
+
+(hk-test "words" (hk-words "hello world") (list "hello" "world"))
+(hk-test "words leading ws" (hk-words "  foo bar") (list "foo" "bar"))
+(hk-test "words empty" (hk-words "") (list))
+(hk-test "unwords" (hk-unwords (list "a" "b" "c")) "a b c")
+(hk-test "unwords single" (hk-unwords (list "x")) "x")
+
+(hk-test "lines" (hk-lines "a\nb\nc") (list "a" "b" "c"))
+(hk-test "lines single" (hk-lines "hello") (list "hello"))
+(hk-test "unlines" (hk-unlines (list "a" "b")) "a\nb\n")
+
+(hk-test "is-prefix-of yes" (hk-is-prefix-of "he" "hello") true)
+(hk-test "is-prefix-of no" (hk-is-prefix-of "wo" "hello") false)
+(hk-test "is-prefix-of eq" (hk-is-prefix-of "hi" "hi") true)
+(hk-test "is-prefix-of empty" (hk-is-prefix-of "" "hi") true)
+
+(hk-test "is-suffix-of yes" (hk-is-suffix-of "lo" "hello") true)
+(hk-test "is-suffix-of no" (hk-is-suffix-of "he" "hello") false)
+(hk-test "is-suffix-of empty" (hk-is-suffix-of "" "hi") true)
+
+(hk-test "is-infix-of yes" (hk-is-infix-of "ell" "hello") true)
+(hk-test "is-infix-of no" (hk-is-infix-of "xyz" "hello") false)
+(hk-test "is-infix-of empty" (hk-is-infix-of "" "hello") true)
+
+;; ---------------------------------------------------------------------------
+;; 10. Show
+;; ---------------------------------------------------------------------------
+
+(hk-test "show nil" (hk-show nil) "Nothing")
+(hk-test "show true" (hk-show true) "True")
+(hk-test "show false" (hk-show false) "False")
+(hk-test "show int" (hk-show 42) "42")
+(hk-test "show string" (hk-show "hi") "\"hi\"")
+(hk-test
+  "show list"
+  (hk-show (list 1 2 3))
+  "[1,2,3]")
+(hk-test "show empty list" (hk-show (list)) "[]")
+
+;; ---------------------------------------------------------------------------
+;; Summary (required by test.sh — last expression is the return value)
+;; ---------------------------------------------------------------------------
+
+(list hk-test-pass hk-test-fail)

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/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/runtime.sx

@@ -2032,7 +2032,15 @@
           (&rest args)
           (cond
             ((= (len args) 0) nil)
-            ((js-regex? (nth args 0)) (js-regex-stub-exec (nth args 0) s))
+            ((js-regex? (nth args 0))
+              (let
+                ((rx (nth args 0)))
+                (let
+                  ((impl (get __js_regex_platform__ "exec")))
+                  (if
+                    (js-undefined? impl)
+                    (js-regex-stub-exec rx s)
+                    (impl rx s)))))
             (else
               (let
                 ((needle (js-to-string (nth args 0))))
@@ -2041,7 +2049,7 @@
                   (if
                     (= idx -1)
                     nil
-                    (let ((res (list))) (append! res needle) res))))))))
+                    (let ((res (list))) (begin (append! res needle) res)))))))))
       ((= name "at")
         (fn
           (i)
@@ -2099,6 +2107,20 @@
       ((= name "toWellFormed") (fn () s))
       (else js-undefined))))
 
+(define __js_tdz_sentinel__ (dict "__tdz__" true))
+
+(define js-tdz? (fn (v) (and (dict? v) (dict-has? v "__tdz__"))))
+
+(define
+  js-tdz-check
+  (fn
+    (name val)
+    (if
+      (js-tdz? val)
+      (raise
+        (TypeError (str "Cannot access '" name "' before initialization")))
+      val)))
+
 (define
   js-string-slice
   (fn

lib/js/stdlib.sx

@@ -0,0 +1,239 @@
+;; lib/js/stdlib.sx — Phase 22 JS additions
+;;
+;; Adds to lib/js/runtime.sx (already loaded):
+;;   1. Bitwise binary ops (js-bitand/bitor/bitxor/lshift/rshift/urshift/bitnot)
+;;   2. Map class (arbitrary-key hash map via list of pairs)
+;;   3. Set class (uniqueness collection via SX make-set)
+;;   4. RegExp constructor (wraps js-regex-new already in runtime)
+;;   5. Wires Map / Set / RegExp into js-global
+
+;; ---------------------------------------------------------------------------
+;; 1. Bitwise binary ops
+;;    JS coerces operands to 32-bit signed int before applying the op.
+;;    Use truncate (not js-num-to-int) since integer / 0 crashes the evaluator.
+;; ---------------------------------------------------------------------------
+
+(define
+  (js-bitand a b)
+  (bitwise-and (truncate (js-to-number a)) (truncate (js-to-number b))))
+
+(define
+  (js-bitor a b)
+  (bitwise-or (truncate (js-to-number a)) (truncate (js-to-number b))))
+
+(define
+  (js-bitxor a b)
+  (bitwise-xor (truncate (js-to-number a)) (truncate (js-to-number b))))
+
+;; << : left-shift by (b mod 32) positions
+(define
+  (js-lshift a b)
+  (arithmetic-shift
+    (truncate (js-to-number a))
+    (modulo (truncate (js-to-number b)) 32)))
+
+;; >> : arithmetic right-shift (sign-extending)
+(define
+  (js-rshift a b)
+  (arithmetic-shift
+    (truncate (js-to-number a))
+    (- 0 (modulo (truncate (js-to-number b)) 32))))
+
+;; >>> : logical right-shift (zero-extending)
+;;   Convert to uint32 first, then divide by 2^n.
+(define
+  (js-urshift a b)
+  (let
+    ((u32 (modulo (truncate (js-to-number a)) 4294967296))
+      (n (modulo (truncate (js-to-number b)) 32)))
+    (quotient u32 (arithmetic-shift 1 n))))
+
+;; ~ : bitwise NOT — equivalent to -(n+1) in 32-bit signed arithmetic
+(define (js-bitnot a) (bitwise-not (truncate (js-to-number a))))
+
+;; ---------------------------------------------------------------------------
+;; 2. Map class
+;;    Stored as {:__js_map__ true :size N :_pairs (list (list key val) ...)}
+;;    Mutation via dict-set! on the underlying dict.
+;; ---------------------------------------------------------------------------
+
+(define
+  (js-map-new)
+  (let
+    ((m (dict)))
+    (dict-set! m "__js_map__" true)
+    (dict-set! m "size" 0)
+    (dict-set! m "_pairs" (list))
+    m))
+
+(define (js-map? v) (and (dict? v) (dict-has? v "__js_map__")))
+
+;; Linear scan for key using ===; returns index or -1
+(define
+  (js-map-find-idx pairs k)
+  (letrec
+    ((go (fn (ps i) (cond ((= (len ps) 0) -1) ((js-strict-eq (first (first ps)) k) i) (else (go (rest ps) (+ i 1)))))))
+    (go pairs 0)))
+
+(define
+  (js-map-get m k)
+  (letrec
+    ((go (fn (ps) (if (= (len ps) 0) js-undefined (if (js-strict-eq (first (first ps)) k) (nth (first ps) 1) (go (rest ps)))))))
+    (go (get m "_pairs"))))
+
+;; Replace element at index i in list
+(define
+  (js-list-set-nth lst i newval)
+  (letrec
+    ((go (fn (ps j) (if (= (len ps) 0) (list) (cons (if (= j i) newval (first ps)) (go (rest ps) (+ j 1)))))))
+    (go lst 0)))
+
+;; Remove element at index i from list
+(define
+  (js-list-remove-nth lst i)
+  (letrec
+    ((go (fn (ps j) (if (= (len ps) 0) (list) (if (= j i) (go (rest ps) (+ j 1)) (cons (first ps) (go (rest ps) (+ j 1))))))))
+    (go lst 0)))
+
+(define
+  (js-map-set! m k v)
+  (let
+    ((pairs (get m "_pairs")) (idx (js-map-find-idx (get m "_pairs") k)))
+    (if
+      (= idx -1)
+      (begin
+        (dict-set! m "_pairs" (append pairs (list (list k v))))
+        (dict-set! m "size" (+ (get m "size") 1)))
+      (dict-set! m "_pairs" (js-list-set-nth pairs idx (list k v)))))
+  m)
+
+(define
+  (js-map-has m k)
+  (not (= (js-map-find-idx (get m "_pairs") k) -1)))
+
+(define
+  (js-map-delete! m k)
+  (let
+    ((idx (js-map-find-idx (get m "_pairs") k)))
+    (when
+      (not (= idx -1))
+      (dict-set! m "_pairs" (js-list-remove-nth (get m "_pairs") idx))
+      (dict-set! m "size" (- (get m "size") 1))))
+  m)
+
+(define
+  (js-map-clear! m)
+  (dict-set! m "_pairs" (list))
+  (dict-set! m "size" 0)
+  m)
+
+(define (js-map-keys m) (map first (get m "_pairs")))
+(define
+  (js-map-vals m)
+  (map (fn (p) (nth p 1)) (get m "_pairs")))
+(define (js-map-entries m) (get m "_pairs"))
+
+(define
+  (js-map-for-each m cb)
+  (for-each
+    (fn (p) (cb (nth p 1) (first p) m))
+    (get m "_pairs"))
+  js-undefined)
+
+;; Map method dispatch (called from js-object-method-call in runtime)
+(define
+  (js-map-method m name args)
+  (cond
+    ((= name "set")
+      (js-map-set! m (nth args 0) (nth args 1)))
+    ((= name "get") (js-map-get m (nth args 0)))
+    ((= name "has") (js-map-has m (nth args 0)))
+    ((= name "delete") (js-map-delete! m (nth args 0)))
+    ((= name "clear") (js-map-clear! m))
+    ((= name "keys") (js-map-keys m))
+    ((= name "values") (js-map-vals m))
+    ((= name "entries") (js-map-entries m))
+    ((= name "forEach") (js-map-for-each m (nth args 0)))
+    ((= name "toString") "[object Map]")
+    (else js-undefined)))
+
+(define Map {:__callable__ (fn (&rest args) (let ((m (js-map-new))) (when (and (> (len args) 0) (list? (nth args 0))) (for-each (fn (entry) (js-map-set! m (nth entry 0) (nth entry 1))) (nth args 0))) m)) :prototype {:entries (fn (&rest a) (js-map-entries (js-this))) :delete (fn (&rest a) (js-map-delete! (js-this) (nth a 0))) :get (fn (&rest a) (js-map-get (js-this) (nth a 0))) :values (fn (&rest a) (js-map-vals (js-this))) :toString (fn () "[object Map]") :has (fn (&rest a) (js-map-has (js-this) (nth a 0))) :set (fn (&rest a) (js-map-set! (js-this) (nth a 0) (nth a 1))) :forEach (fn (&rest a) (js-map-for-each (js-this) (nth a 0))) :clear (fn (&rest a) (js-map-clear! (js-this))) :keys (fn (&rest a) (js-map-keys (js-this)))}})
+
+;; ---------------------------------------------------------------------------
+;; 3. Set class
+;;    {:__js_set__ true :size N :_set <sx-set>}
+;;    Note: set-member?/set-add!/set-remove! all take (set item) order.
+;; ---------------------------------------------------------------------------
+
+(define
+  (js-set-new)
+  (let
+    ((s (dict)))
+    (dict-set! s "__js_set__" true)
+    (dict-set! s "size" 0)
+    (dict-set! s "_set" (make-set))
+    s))
+
+(define (js-set? v) (and (dict? v) (dict-has? v "__js_set__")))
+
+(define
+  (js-set-add! s v)
+  (let
+    ((sx (get s "_set")))
+    (when
+      (not (set-member? sx v))
+      (set-add! sx v)
+      (dict-set! s "size" (+ (get s "size") 1))))
+  s)
+
+(define (js-set-has s v) (set-member? (get s "_set") v))
+
+(define
+  (js-set-delete! s v)
+  (let
+    ((sx (get s "_set")))
+    (when
+      (set-member? sx v)
+      (set-remove! sx v)
+      (dict-set! s "size" (- (get s "size") 1))))
+  s)
+
+(define
+  (js-set-clear! s)
+  (dict-set! s "_set" (make-set))
+  (dict-set! s "size" 0)
+  s)
+
+(define (js-set-vals s) (set->list (get s "_set")))
+
+(define
+  (js-set-for-each s cb)
+  (for-each (fn (v) (cb v v s)) (set->list (get s "_set")))
+  js-undefined)
+
+(define Set {:__callable__ (fn (&rest args) (let ((s (js-set-new))) (when (and (> (len args) 0) (list? (nth args 0))) (for-each (fn (v) (js-set-add! s v)) (nth args 0))) s)) :prototype {:entries (fn (&rest a) (map (fn (v) (list v v)) (js-set-vals (js-this)))) :delete (fn (&rest a) (js-set-delete! (js-this) (nth a 0))) :values (fn (&rest a) (js-set-vals (js-this))) :add (fn (&rest a) (js-set-add! (js-this) (nth a 0))) :toString (fn () "[object Set]") :has (fn (&rest a) (js-set-has (js-this) (nth a 0))) :forEach (fn (&rest a) (js-set-for-each (js-this) (nth a 0))) :clear (fn (&rest a) (js-set-clear! (js-this))) :keys (fn (&rest a) (js-set-vals (js-this)))}})
+
+;; ---------------------------------------------------------------------------
+;; 4. RegExp constructor — callable lambda wrapping js-regex-new
+;; ---------------------------------------------------------------------------
+
+(define
+  RegExp
+  (fn
+    (&rest args)
+    (cond
+      ((= (len args) 0) (js-regex-new "" ""))
+      ((= (len args) 1)
+        (js-regex-new (js-to-string (nth args 0)) ""))
+      (else
+        (js-regex-new
+          (js-to-string (nth args 0))
+          (js-to-string (nth args 1)))))))
+
+;; ---------------------------------------------------------------------------
+;; 5. Wire new globals into js-global
+;; ---------------------------------------------------------------------------
+
+(dict-set! js-global "Map" Map)
+(dict-set! js-global "Set" Set)
+(dict-set! js-global "RegExp" RegExp)

lib/js/test.sh

@@ -33,6 +33,10 @@ cat > "$TMPFILE" << 'EPOCHS'
 (load "lib/js/transpile.sx")
 (epoch 5)
 (load "lib/js/runtime.sx")
+(epoch 6)
+(load "lib/js/regex.sx")
+(epoch 7)
+(load "lib/js/stdlib.sx")
 
 ;; ── Phase 0: stubs still behave ─────────────────────────────────
 (epoch 10)
@@ -1323,6 +1327,166 @@ 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 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')\")")
+
+;; ── 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)")
+
+;; ── Phase 22: Bitwise ops ────────────────────────────────────────
+(epoch 6000)
+(eval "(js-bitand 5 3)")
+(epoch 6001)
+(eval "(js-bitor 5 3)")
+(epoch 6002)
+(eval "(js-bitxor 5 3)")
+(epoch 6003)
+(eval "(js-lshift 1 4)")
+(epoch 6004)
+(eval "(js-rshift 32 2)")
+(epoch 6005)
+(eval "(js-rshift -8 1)")
+(epoch 6006)
+(eval "(js-urshift 4294967292 2)")
+(epoch 6007)
+(eval "(js-bitnot 0)")
+
+;; ── Phase 22: Map ─────────────────────────────────────────────────
+(epoch 6010)
+(eval "(js-map? (js-map-new))")
+(epoch 6011)
+(eval "(get (js-map-set! (js-map-new) \"k\" 42) \"size\")")
+(epoch 6012)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"a\" 1) (js-map-get m \"a\"))")
+(epoch 6013)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"x\" 9) (js-map-has m \"x\"))")
+(epoch 6014)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"x\" 9) (js-map-has m \"y\"))")
+(epoch 6015)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"a\" 1) (js-map-set! m \"b\" 2) (get m \"size\"))")
+(epoch 6016)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"a\" 1) (js-map-delete! m \"a\") (get m \"size\"))")
+(epoch 6017)
+(eval "(let ((m (js-map-new))) (js-map-set! m \"a\" 1) (js-map-set! m \"a\" 99) (js-map-get m \"a\"))")
+
+;; ── Phase 22: Set ─────────────────────────────────────────────────
+(epoch 6020)
+(eval "(js-set? (js-set-new))")
+(epoch 6021)
+(eval "(let ((s (js-set-new))) (js-set-add! s 1) (js-set-has s 1))")
+(epoch 6022)
+(eval "(let ((s (js-set-new))) (js-set-add! s 1) (js-set-has s 2))")
+(epoch 6023)
+(eval "(let ((s (js-set-new))) (js-set-add! s 1) (js-set-add! s 1) (get s \"size\"))")
+(epoch 6024)
+(eval "(let ((s (js-set-new))) (js-set-add! s 1) (js-set-add! s 2) (get s \"size\"))")
+(epoch 6025)
+(eval "(let ((s (js-set-new))) (js-set-add! s 1) (js-set-delete! s 1) (get s \"size\"))")
+
+;; ── Phase 22: RegExp constructor ──────────────────────────────────
+(epoch 6030)
+(eval "(js-regex? (RegExp \"ab\" \"i\"))")
+(epoch 6031)
+(eval "(get (RegExp \"hello\" \"gi\") \"global\")")
+(epoch 6032)
+(eval "(get (RegExp \"foo\" \"i\") \"ignoreCase\")")
+
 EPOCHS
 
 
@@ -2042,6 +2206,81 @@ check 3503 "indexOf.call arrLike"          '1'
 check 3504 "filter.call arrLike"           '"2,3"'
 check 3505 "forEach.call arrLike sum"      '60'
 
+# ── 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'
+
+# ── 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'
+
+# ── Phase 22: Bitwise ops ─────────────────────────────────────────
+check 6000 "bitand 5&3"     '1'
+check 6001 "bitor 5|3"      '7'
+check 6002 "bitxor 5^3"     '6'
+check 6003 "lshift 1<<4"    '16'
+check 6004 "rshift 32>>2"   '8'
+check 6005 "rshift -8>>1"   '-4'
+check 6006 "urshift >>>"     '1073741823'
+check 6007 "bitnot ~0"      '-1'
+
+# ── Phase 22: Map ─────────────────────────────────────────────────
+check 6010 "map? new map"          'true'
+check 6011 "map set→size 1"        '1'
+check 6012 "map get existing"      '1'
+check 6013 "map has key yes"       'true'
+check 6014 "map has key no"        'false'
+check 6015 "map size 2 entries"    '2'
+check 6016 "map delete→size 0"     '0'
+check 6017 "map set overwrites"    '99'
+
+# ── Phase 22: Set ─────────────────────────────────────────────────
+check 6020 "set? new set"          'true'
+check 6021 "set has after add"     'true'
+check 6022 "set has absent"        'false'
+check 6023 "set dedup size"        '1'
+check 6024 "set size 2"            '2'
+check 6025 "set delete→size 0"     '0'
+
+# ── Phase 22: RegExp ──────────────────────────────────────────────
+check 6030 "RegExp? result"        'true'
+check 6031 "RegExp global flag"    'true'
+check 6032 "RegExp ignoreCase"     'true'
+
 TOTAL=$((PASS + FAIL))
 if [ $FAIL -eq 0 ]; then
   echo "✓ $PASS/$TOTAL JS-on-SX tests passed"

lib/js/test262-runner.py

@@ -798,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()

lib/js/transpile.sx

@@ -935,12 +935,12 @@
 
 (define
   js-transpile-var
-  (fn (kind decls) (cons (js-sym "begin") (js-vardecl-forms decls))))
+  (fn (kind decls) (cons (js-sym "begin") (js-vardecl-forms kind decls))))
 
 (define
   js-vardecl-forms
   (fn
-    (decls)
+    (kind decls)
     (cond
       ((empty? decls) (list))
       (else
@@ -953,7 +953,7 @@
                   (js-sym "define")
                   (js-sym (nth d 1))
                   (js-transpile (nth d 2)))
-                (js-vardecl-forms (rest decls))))
+                (js-vardecl-forms kind (rest decls))))
             ((js-tag? d "js-vardecl-obj")
               (let
                 ((names (nth d 1))
@@ -964,7 +964,7 @@
                   (js-vardecl-obj-forms
                     names
                     tmp-sym
-                    (js-vardecl-forms (rest decls))))))
+                    (js-vardecl-forms kind (rest decls))))))
             ((js-tag? d "js-vardecl-arr")
               (let
                 ((names (nth d 1))
@@ -976,7 +976,7 @@
                     names
                     tmp-sym
                     0
-                    (js-vardecl-forms (rest decls))))))
+                    (js-vardecl-forms kind (rest decls))))))
             (else (error "js-vardecl-forms: unexpected decl"))))))))
 
 (define

lib/lua/runtime.sx

@@ -123,7 +123,7 @@
               (fn
                 (i)
                 (if
-                  (has? a (str i))
+                  (not (= (get a (str i)) nil))
                   (begin (set! n i) (count-loop (+ i 1)))
                   n)))
             (count-loop 1))))
@@ -152,7 +152,9 @@
                   (cond
                     ((= (first f) "pos")
                       (begin
-                        (set! t (assoc t (str array-idx) (nth f 1)))
+                        (set!
+                          t
+                          (assoc t (str array-idx) (nth f 1)))
                         (set! array-idx (+ array-idx 1))))
                     ((= (first f) "kv")
                       (let
@@ -169,3 +171,108 @@
     (if (= t nil) nil (let ((v (get t (str k)))) (if (= v nil) nil v)))))
 
 (define lua-set! (fn (t k v) (assoc t (str k) v)))
+
+;; ---------------------------------------------------------------------------
+;; Helpers for stdlib
+;; ---------------------------------------------------------------------------
+
+;; Apply a char function to every character in a string
+(define (lua-str-map s fn) (list->string (map fn (string->list s))))
+
+;; Repeat string s n times
+(define
+  (lua-str-rep s n)
+  (letrec
+    ((go (fn (acc i) (if (= i 0) acc (go (str acc s) (- i 1))))))
+    (go "" n)))
+
+;; Force a promise created by delay
+(define
+  (lua-force p)
+  (if
+    (and (dict? p) (get p :_promise))
+    (if (get p :forced) (get p :value) ((get p :thunk)))
+    p))
+
+;; ---------------------------------------------------------------------------
+;; math — Lua math library
+;; ---------------------------------------------------------------------------
+
+(define math {:asin asin :floor floor :exp exp :huge 1e+308 :tan tan :sqrt sqrt :log log :abs abs :ceil ceil :sin sin :max (fn (a b) (if (> a b) a b)) :acos acos :min (fn (a b) (if (< a b) a b)) :cos cos :pi 3.14159 :atan atan})
+
+;; ---------------------------------------------------------------------------
+;; string — Lua string library
+;; ---------------------------------------------------------------------------
+
+(define
+  (lua-string-find s pat)
+  (let
+    ((m (regexp-match (make-regexp pat) s)))
+    (if (= m nil) nil (list (+ (get m :start) 1) (get m :end)))))
+
+(define
+  (lua-string-match s pat)
+  (let
+    ((m (regexp-match (make-regexp pat) s)))
+    (if
+      (= m nil)
+      nil
+      (let
+        ((groups (get m :groups)))
+        (if (= (len groups) 0) (get m :match) (first groups))))))
+
+(define
+  (lua-string-gmatch s pat)
+  (map (fn (m) (get m :match)) (regexp-match-all (make-regexp pat) s)))
+
+(define
+  (lua-string-gsub s pat repl)
+  (regexp-replace-all (make-regexp pat) s repl))
+
+(define string {:rep lua-str-rep :sub (fn (s i &rest j-args) (let ((slen (len s)) (j (if (= (len j-args) 0) -1 (first j-args)))) (let ((from (if (< i 0) (let ((r (+ slen i))) (if (< r 0) 0 r)) (- i 1))) (to (if (< j 0) (let ((r (+ slen j 1))) (if (< r 0) 0 r)) (if (> j slen) slen j)))) (if (> from to) "" (substring s from to))))) :len (fn (s) (len s)) :upper (fn (s) (lua-str-map s char-upcase)) :char (fn (&rest codes) (list->string (map (fn (c) (integer->char (truncate c))) codes))) :gmatch lua-string-gmatch :gsub lua-string-gsub :lower (fn (s) (lua-str-map s char-downcase)) :byte (fn (s &rest args) (char->integer (nth (string->list s) (- (if (= (len args) 0) 1 (first args)) 1)))) :match lua-string-match :find lua-string-find :reverse (fn (s) (list->string (reverse (string->list s))))})
+
+;; ---------------------------------------------------------------------------
+;; table — Lua table library
+;; ---------------------------------------------------------------------------
+
+(define
+  (lua-table-insert t v)
+  (assoc t (str (+ (lua-len t) 1)) v))
+
+(define
+  (lua-table-remove t &rest args)
+  (let
+    ((n (lua-len t))
+      (pos (if (= (len args) 0) (lua-len t) (first args))))
+    (letrec
+      ((slide (fn (t i) (if (< i n) (assoc (slide t (+ i 1)) (str i) (lua-get t (+ i 1))) (assoc t (str n) nil)))))
+      (slide t pos))))
+
+(define
+  (lua-table-concat t &rest args)
+  (let
+    ((sep (if (= (len args) 0) "" (first args)))
+      (n (lua-len t)))
+    (letrec
+      ((go (fn (acc i) (if (> i n) acc (go (str acc (if (= i 1) "" sep) (lua-to-string (lua-get t i))) (+ i 1))))))
+      (go "" 1))))
+
+(define
+  (lua-table-sort t)
+  (let
+    ((n (lua-len t)))
+    (letrec
+      ((collect (fn (i acc) (if (< i 1) acc (collect (- i 1) (cons (lua-get t i) acc)))))
+        (rebuild
+          (fn
+            (t i items)
+            (if
+              (= (len items) 0)
+              t
+              (rebuild
+                (assoc t (str i) (first items))
+                (+ i 1)
+                (rest items))))))
+      (rebuild t 1 (sort (collect n (list)))))))
+
+(define table {:sort lua-table-sort :concat lua-table-concat :insert lua-table-insert :remove lua-table-remove})

lib/lua/test.sh

@@ -633,6 +633,116 @@ check 482 "while i<5 count"                 '5'
 check 483 "repeat until i>=3"               '3'
 check 484 "for 1..100 sum"                  '5050'
 
+# ── Phase 3: stdlib — math, string, table ──────────────────────────────────
+
+cat >> "$TMPFILE" << 'EPOCHS2'
+
+;; ── math library ───────────────────────────────────────────────
+(epoch 500)
+(eval "(lua-eval-ast \"return math.abs(-7)\")")
+(epoch 501)
+(eval "(lua-eval-ast \"return math.floor(3.9)\")")
+(epoch 502)
+(eval "(lua-eval-ast \"return math.ceil(3.1)\")")
+(epoch 503)
+(eval "(lua-eval-ast \"return math.sqrt(9)\")")
+(epoch 504)
+(eval "(lua-eval-ast \"return math.sin(0)\")")
+(epoch 505)
+(eval "(lua-eval-ast \"return math.cos(0)\")")
+(epoch 506)
+(eval "(lua-eval-ast \"return math.max(3, 7)\")")
+(epoch 507)
+(eval "(lua-eval-ast \"return math.min(3, 7)\")")
+(epoch 508)
+(eval "(lua-eval-ast \"return math.pi > 3\")")
+(epoch 509)
+(eval "(lua-eval-ast \"return math.huge > 0\")")
+
+;; ── string library ─────────────────────────────────────────────
+(epoch 520)
+(eval "(lua-eval-ast \"return string.len(\\\"hello\\\")\")")
+(epoch 521)
+(eval "(lua-eval-ast \"return string.upper(\\\"hello\\\")\")")
+(epoch 522)
+(eval "(lua-eval-ast \"return string.lower(\\\"WORLD\\\")\")")
+(epoch 523)
+(eval "(lua-eval-ast \"return string.sub(\\\"hello\\\", 2, 4)\")")
+(epoch 524)
+(eval "(lua-eval-ast \"return string.rep(\\\"ab\\\", 3)\")")
+(epoch 525)
+(eval "(lua-eval-ast \"return string.reverse(\\\"hello\\\")\")")
+(epoch 526)
+(eval "(lua-eval-ast \"return string.byte(\\\"A\\\")\")")
+(epoch 527)
+(eval "(lua-eval-ast \"return string.char(72, 105)\")")
+(epoch 528)
+(eval "(lua-eval-ast \"return string.find(\\\"hello\\\", \\\"ll\\\")\")")
+(epoch 529)
+(eval "(lua-eval-ast \"return string.match(\\\"hello\\\", \\\"ell\\\")\")")
+(epoch 530)
+(eval "(lua-eval-ast \"return string.gsub(\\\"hello\\\", \\\"l\\\", \\\"r\\\")\")")
+
+;; ── table library ──────────────────────────────────────────────
+(epoch 540)
+(eval "(lua-eval-ast \"local t = {10, 20, 30} t = table.insert(t, 40) return t[4]\")")
+(epoch 541)
+(eval "(lua-eval-ast \"local t = {10, 20, 30} t = table.remove(t) return t[3]\")")
+(epoch 542)
+(eval "(lua-eval-ast \"local t = {\\\"a\\\", \\\"b\\\", \\\"c\\\"} return table.concat(t, \\\",\\\")\")")
+(epoch 543)
+(eval "(lua-eval-ast \"local t = {3, 1, 2} t = table.sort(t) return t[1]\")")
+(epoch 544)
+(eval "(lua-eval-ast \"local t = {3, 1, 2} t = table.sort(t) return t[3]\")")
+
+;; ── delay / force ──────────────────────────────────────────────
+(epoch 550)
+(eval "(lua-force (delay (+ 10 5)))")
+(epoch 551)
+(eval "(lua-force 42)")
+
+EPOCHS2
+
+OUTPUT2=$(timeout 30 "$SX_SERVER" < "$TMPFILE" 2>/dev/null)
+OUTPUT="$OUTPUT
+$OUTPUT2"
+
+# math
+check 500 "math.abs(-7)"         '7'
+check 501 "math.floor(3.9)"      '3'
+check 502 "math.ceil(3.1)"       '4'
+check 503 "math.sqrt(9)"         '3'
+check 504 "math.sin(0)"          '0'
+check 505 "math.cos(0)"          '1'
+check 506 "math.max(3,7)"        '7'
+check 507 "math.min(3,7)"        '3'
+check 508 "math.pi > 3"          'true'
+check 509 "math.huge > 0"        'true'
+
+# string
+check 520 "string.len"           '5'
+check 521 "string.upper"         '"HELLO"'
+check 522 "string.lower"         '"world"'
+check 523 "string.sub(2,4)"      '"ell"'
+check 524 "string.rep(ab,3)"     '"ababab"'
+check 525 "string.reverse"       '"olleh"'
+check 526 "string.byte(A)"       '65'
+check 527 "string.char(72,105)"  '"Hi"'
+check 528 "string.find ll"       '3'
+check 529 "string.match ell"     '"ell"'
+check 530 "string.gsub l->r"     '"herro"'
+
+# table
+check 540 "table.insert"         '40'
+check 541 "table.remove"         'nil'
+check 542 "table.concat ,"       '"a,b,c"'
+check 543 "table.sort [1]"       '1'
+check 544 "table.sort [3]"       '3'
+
+# delay/force
+check 550 "lua-force delay"      '15'
+check 551 "lua-force non-promise" '42'
+
 TOTAL=$((PASS + FAIL))
 if [ $FAIL -eq 0 ]; then
   echo "ok $PASS/$TOTAL Lua-on-SX tests passed"

lib/prolog/compiler.sx

@@ -1,176 +0,0 @@
-;; lib/prolog/compiler.sx — clause compiler: parse-AST clauses → SX closures
-;;
-;; Each compiled clause is a lambda (fn (goal trail db cut-box k) bool)
-;; that creates fresh vars, builds the instantiated head/body, and calls
-;; pl-unify! + pl-solve! directly — no AST walk at solve time.
-;;
-;; Usage:
-;;   (pl-db-load! db (pl-parse src))
-;;   (pl-compile-db! db)
-;;   ; pl-solve-user! in runtime.sx automatically prefers compiled clauses
-;;   (pl-solve-once! db goal trail)
-
-;; Collect unique variable names from a parse-AST clause into a dict.
-(define
-  pl-cmp-vars-into!
-  (fn
-    (ast seen)
-    (cond
-      ((not (list? ast)) nil)
-      ((empty? ast) nil)
-      ((= (first ast) "var")
-        (let
-          ((name (nth ast 1)))
-          (when
-            (and (not (= name "_")) (not (dict-has? seen name)))
-            (dict-set! seen name true))))
-      ((= (first ast) "compound")
-        (for-each (fn (a) (pl-cmp-vars-into! a seen)) (nth ast 2)))
-      ((= (first ast) "clause")
-        (begin
-          (pl-cmp-vars-into! (nth ast 1) seen)
-          (pl-cmp-vars-into! (nth ast 2) seen))))))
-
-;; Return list of unique var names in a clause (head + body, excluding _).
-(define
-  pl-cmp-collect-vars
-  (fn
-    (clause)
-    (let ((seen {})) (pl-cmp-vars-into! clause seen) (keys seen))))
-
-;; Create a fresh runtime var for each name in the list; return name->var dict.
-(define
-  pl-cmp-make-var-map
-  (fn
-    (var-names)
-    (let
-      ((m {}))
-      (for-each
-        (fn (name) (dict-set! m name (pl-mk-rt-var name)))
-        var-names)
-      m)))
-
-;; Instantiate a parse-AST term using a pre-built var-map.
-;; ("var" "_") always gets a fresh anonymous var.
-(define
-  pl-cmp-build-term
-  (fn
-    (ast var-map)
-    (cond
-      ((pl-var? ast) ast)
-      ((not (list? ast)) ast)
-      ((empty? ast) ast)
-      ((= (first ast) "var")
-        (let
-          ((name (nth ast 1)))
-          (if (= name "_") (pl-mk-rt-var "_") (dict-get var-map name))))
-      ((or (= (first ast) "atom") (= (first ast) "num") (= (first ast) "str"))
-        ast)
-      ((= (first ast) "compound")
-        (list
-          "compound"
-          (nth ast 1)
-          (map (fn (a) (pl-cmp-build-term a var-map)) (nth ast 2))))
-      ((= (first ast) "clause")
-        (list
-          "clause"
-          (pl-cmp-build-term (nth ast 1) var-map)
-          (pl-cmp-build-term (nth ast 2) var-map)))
-      (true ast))))
-
-;; Compile one parse-AST clause to a lambda.
-;; Pre-computes var names at compile time; creates fresh vars per call.
-(define
-  pl-compile-clause
-  (fn
-    (clause)
-    (let
-      ((var-names (pl-cmp-collect-vars clause))
-        (head-ast (nth clause 1))
-        (body-ast (nth clause 2)))
-      (fn
-        (goal trail db cut-box k)
-        (let
-          ((var-map (pl-cmp-make-var-map var-names)))
-          (let
-            ((fresh-head (pl-cmp-build-term head-ast var-map))
-              (fresh-body (pl-cmp-build-term body-ast var-map)))
-            (let
-              ((mark (pl-trail-mark trail)))
-              (if
-                (pl-unify! goal fresh-head trail)
-                (let
-                  ((r (pl-solve! db fresh-body trail cut-box k)))
-                  (if r true (begin (pl-trail-undo-to! trail mark) false)))
-                (begin (pl-trail-undo-to! trail mark) false)))))))))
-
-;; Try a list of compiled clause lambdas — same cut semantics as pl-try-clauses!.
-(define
-  pl-try-compiled-clauses!
-  (fn
-    (db
-      goal
-      trail
-      compiled-clauses
-      outer-cut-box
-      outer-was-cut
-      inner-cut-box
-      k)
-    (cond
-      ((empty? compiled-clauses) false)
-      (true
-        (let
-          ((r ((first compiled-clauses) goal trail db inner-cut-box k)))
-          (cond
-            (r true)
-            ((dict-get inner-cut-box :cut) false)
-            ((and (not outer-was-cut) (dict-get outer-cut-box :cut)) false)
-            (true
-              (pl-try-compiled-clauses!
-                db
-                goal
-                trail
-                (rest compiled-clauses)
-                outer-cut-box
-                outer-was-cut
-                inner-cut-box
-                k))))))))
-
-;; Compile all clauses in DB and store in :compiled table.
-;; After this call, pl-solve-user! will dispatch via compiled lambdas.
-;; Note: clauses assert!-ed after this call are not compiled.
-(define
-  pl-compile-db!
-  (fn
-    (db)
-    (let
-      ((src-table (dict-get db :clauses)) (compiled-table {}))
-      (for-each
-        (fn
-          (key)
-          (dict-set!
-            compiled-table
-            key
-            (map pl-compile-clause (dict-get src-table key))))
-        (keys src-table))
-      (dict-set! db :compiled compiled-table)
-      db)))
-
-;; Cross-validate: load src into both a plain and a compiled DB,
-;; run goal-str through each, return true iff solution counts match.
-;; Use this to keep the interpreter as the reference implementation.
-(define
-  pl-compiled-matches-interp?
-  (fn
-    (src goal-str)
-    (let
-      ((db-interp (pl-mk-db)) (db-comp (pl-mk-db)))
-      (pl-db-load! db-interp (pl-parse src))
-      (pl-db-load! db-comp (pl-parse src))
-      (pl-compile-db! db-comp)
-      (let
-        ((gi (pl-instantiate (pl-parse-goal goal-str) {}))
-          (gc (pl-instantiate (pl-parse-goal goal-str) {})))
-        (=
-          (pl-solve-count! db-interp gi (pl-mk-trail))
-          (pl-solve-count! db-comp gc (pl-mk-trail)))))))

lib/prolog/conformance.sh

@@ -1,129 +0,0 @@
-#!/usr/bin/env bash
-# Run every Prolog test suite via sx_server and refresh scoreboard.{json,md}.
-# Exit 0 if all green, 1 if any failures.
-set -euo pipefail
-
-HERE="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$(cd "$HERE/../.." && pwd)"
-SX="${SX_SERVER:-/root/rose-ash/hosts/ocaml/_build/default/bin/sx_server.exe}"
-
-if [[ ! -x "$SX" ]]; then
-  echo "sx_server not found at $SX (set SX_SERVER env to override)" >&2
-  exit 2
-fi
-
-cd "$ROOT"
-
-# name : test-file : runner-fn
-SUITES=(
-  "parse:lib/prolog/tests/parse.sx:pl-parse-tests-run!"
-  "unify:lib/prolog/tests/unify.sx:pl-unify-tests-run!"
-  "clausedb:lib/prolog/tests/clausedb.sx:pl-clausedb-tests-run!"
-  "solve:lib/prolog/tests/solve.sx:pl-solve-tests-run!"
-  "operators:lib/prolog/tests/operators.sx:pl-operators-tests-run!"
-  "dynamic:lib/prolog/tests/dynamic.sx:pl-dynamic-tests-run!"
-  "findall:lib/prolog/tests/findall.sx:pl-findall-tests-run!"
-  "term_inspect:lib/prolog/tests/term_inspect.sx:pl-term-inspect-tests-run!"
-  "append:lib/prolog/tests/programs/append.sx:pl-append-tests-run!"
-  "reverse:lib/prolog/tests/programs/reverse.sx:pl-reverse-tests-run!"
-  "member:lib/prolog/tests/programs/member.sx:pl-member-tests-run!"
-  "nqueens:lib/prolog/tests/programs/nqueens.sx:pl-nqueens-tests-run!"
-  "family:lib/prolog/tests/programs/family.sx:pl-family-tests-run!"
-  "atoms:lib/prolog/tests/atoms.sx:pl-atom-tests-run!"
-  "query_api:lib/prolog/tests/query_api.sx:pl-query-api-tests-run!"
-  "iso_predicates:lib/prolog/tests/iso_predicates.sx:pl-iso-predicates-tests-run!"
-  "meta_predicates:lib/prolog/tests/meta_predicates.sx:pl-meta-predicates-tests-run!"
-  "list_predicates:lib/prolog/tests/list_predicates.sx:pl-list-predicates-tests-run!"
-  "meta_call:lib/prolog/tests/meta_call.sx:pl-meta-call-tests-run!"
-  "set_predicates:lib/prolog/tests/set_predicates.sx:pl-set-predicates-tests-run!"
-  "char_predicates:lib/prolog/tests/char_predicates.sx:pl-char-predicates-tests-run!"
-  "io_predicates:lib/prolog/tests/io_predicates.sx:pl-io-predicates-tests-run!"
-  "assert_rules:lib/prolog/tests/assert_rules.sx:pl-assert-rules-tests-run!"
-  "string_agg:lib/prolog/tests/string_agg.sx:pl-string-agg-tests-run!"
-  "advanced:lib/prolog/tests/advanced.sx:pl-advanced-tests-run!"
-  "compiler:lib/prolog/tests/compiler.sx:pl-compiler-tests-run!"
-  "cross_validate:lib/prolog/tests/cross_validate.sx:pl-cross-validate-tests-run!"
-  "integration:lib/prolog/tests/integration.sx:pl-integration-tests-run!"
-  "hs_bridge:lib/prolog/tests/hs_bridge.sx:pl-hs-bridge-tests-run!"
-)
-
-SCRIPT='(epoch 1)
-(load "lib/prolog/tokenizer.sx")
-(load "lib/prolog/parser.sx")
-(load "lib/prolog/runtime.sx")
-(load "lib/prolog/query.sx")
-(load "lib/prolog/compiler.sx")
-(load "lib/prolog/hs-bridge.sx")'
-for entry in "${SUITES[@]}"; do
-  IFS=: read -r _ file _ <<< "$entry"
-  SCRIPT+=$'\n(load "'"$file"$'")'
-done
-for entry in "${SUITES[@]}"; do
-  IFS=: read -r _ _ fn <<< "$entry"
-  SCRIPT+=$'\n(eval "('"$fn"$')")'
-done
-
-OUTPUT="$(printf '%s\n' "$SCRIPT" | "$SX" 2>&1)"
-
-mapfile -t LINES < <(printf '%s\n' "$OUTPUT" | grep -E '^\{:failed')
-
-if [[ ${#LINES[@]} -ne ${#SUITES[@]} ]]; then
-  echo "Expected ${#SUITES[@]} suite results, got ${#LINES[@]}" >&2
-  echo "---- raw output ----" >&2
-  printf '%s\n' "$OUTPUT" >&2
-  exit 3
-fi
-
-TOTAL_PASS=0
-TOTAL_FAIL=0
-TOTAL=0
-JSON_SUITES=""
-MD_ROWS=""
-
-for i in "${!SUITES[@]}"; do
-  IFS=: read -r name _ _ <<< "${SUITES[$i]}"
-  line="${LINES[$i]}"
-  passed=$(grep -oE ':passed [0-9]+' <<< "$line" | grep -oE '[0-9]+')
-  total=$(grep -oE ':total [0-9]+' <<< "$line" | grep -oE '[0-9]+')
-  failed=$(grep -oE ':failed [0-9]+' <<< "$line" | grep -oE '[0-9]+')
-  TOTAL_PASS=$((TOTAL_PASS + passed))
-  TOTAL_FAIL=$((TOTAL_FAIL + failed))
-  TOTAL=$((TOTAL + total))
-  status="ok"
-  [[ "$failed" -gt 0 ]] && status="FAIL"
-  [[ -n "$JSON_SUITES" ]] && JSON_SUITES+=","
-  JSON_SUITES+="\"$name\":{\"passed\":$passed,\"total\":$total,\"failed\":$failed}"
-  MD_ROWS+="| $name | $passed | $total | $status |"$'\n'
-done
-
-WHEN="$(date -Iseconds 2>/dev/null || date)"
-
-cat > "$HERE/scoreboard.json" <<JSON
-{
-  "total_passed": $TOTAL_PASS,
-  "total_failed": $TOTAL_FAIL,
-  "total": $TOTAL,
-  "suites": {$JSON_SUITES},
-  "generated": "$WHEN"
-}
-JSON
-
-cat > "$HERE/scoreboard.md" <<MD
-# Prolog scoreboard
-
-**$TOTAL_PASS / $TOTAL passing** ($TOTAL_FAIL failure(s)).
-Generated $WHEN.
-
-| Suite | Passed | Total | Status |
-|-------|--------|-------|--------|
-$MD_ROWS
-Run \`bash lib/prolog/conformance.sh\` to refresh. Override the binary
-with \`SX_SERVER=path/to/sx_server.exe bash …\`.
-MD
-
-if [[ "$TOTAL_FAIL" -gt 0 ]]; then
-  echo "$TOTAL_FAIL failure(s) across $TOTAL tests" >&2
-  exit 1
-fi
-
-echo "All $TOTAL tests pass."

lib/prolog/hs-bridge.sx

@@ -1,72 +0,0 @@
-;; lib/prolog/hs-bridge.sx — Prolog↔Hyperscript bridge
-;;
-;; Creates SX functions backed by a Prolog DB, callable directly from
-;; Hyperscript DSL conditions.  No parser/compiler changes needed:
-;;   when allowed(user, action) then …
-;; compiles to (allowed user action) — a plain SX call.
-;;
-;; Setup:
-;;   (define pl-db (pl-load "role(alice,admin). permission(admin,edit). allowed(U,A) :- role(U,R), permission(R,A)."))
-;;   (define allowed (pl-hs-predicate/2 pl-db "allowed"))
-;;
-;; Requires tokenizer.sx, parser.sx, runtime.sx, query.sx loaded first.
-
-;; Test whether a ground Prolog goal succeeds against db.
-;; Returns true/false (not a solution dict).
-(define
-  pl-hs-query
-  (fn (db goal-str) (not (nil? (pl-query-one db goal-str)))))
-
-;; Build a Prolog goal string from a predicate name and arg list.
-;; SX values: strings/keywords (already strings in SX) pass through;
-;; numbers are stringified via str.
-(define
-  pl-hs-build-goal
-  (fn
-    (pred-name args)
-    (str pred-name "(" (join ", " (map (fn (a) (str a)) args)) ")")))
-
-;; Return a 1-arg SX function that succeeds iff pred(a) holds in db.
-(define
-  pl-hs-predicate/1
-  (fn
-    (db pred-name)
-    (fn (a) (pl-hs-query db (pl-hs-build-goal pred-name (list a))))))
-
-;; Return a 2-arg SX function that succeeds iff pred(a, b) holds in db.
-(define
-  pl-hs-predicate/2
-  (fn
-    (db pred-name)
-    (fn (a b) (pl-hs-query db (pl-hs-build-goal pred-name (list a b))))))
-
-;; Return a 3-arg SX function that succeeds iff pred(a, b, c) holds in db.
-(define
-  pl-hs-predicate/3
-  (fn
-    (db pred-name)
-    (fn (a b c) (pl-hs-query db (pl-hs-build-goal pred-name (list a b c))))))
-
-;; Install every predicate in install-list as a named def in the caller's
-;; environment.  install-list: list of (name arity) pairs.
-;; Returns a dict {name → fn} for the caller to destructure.
-(define
-  pl-hs-install
-  (fn
-    (db install-list)
-    (reduce
-      (fn
-        (acc entry)
-        (let
-          ((pred-name (first entry)) (arity (nth entry 1)))
-          (dict-set!
-            acc
-            pred-name
-            (cond
-              ((= arity 1) (pl-hs-predicate/1 db pred-name))
-              ((= arity 2) (pl-hs-predicate/2 db pred-name))
-              ((= arity 3) (pl-hs-predicate/3 db pred-name))
-              (true (fn (a b) false))))
-          acc))
-      {}
-      install-list)))

lib/prolog/parser.sx

@@ -1,20 +1,28 @@
 ;; lib/prolog/parser.sx — tokens → Prolog AST
 ;;
-;; Phase 4 grammar (with operator table):
+;; Phase 1 grammar (NO operator table yet):
 ;;   Program      := Clause* EOF
-;;   Clause       := Term[999] "." | Term[999] ":-" Term[1200] "."
-;;   Term[Pmax] uses precedence climbing on the operator table:
-;;     primary = Atom | Var | Number | String | Compound | List | "(" Term[1200] ")"
-;;     while next token is infix op `op` with prec(op) ≤ Pmax:
-;;       consume op; parse rhs at right-prec(op); fold into compound(op-name,[lhs,rhs])
+;;   Clause       := Term "." | Term ":-" Term "."
+;;   Term         := Atom | Var | Number | String | Compound | List
+;;   Compound     := atom "(" ArgList ")"
+;;   ArgList      := Term ("," Term)*
+;;   List         := "[" "]" | "[" Term ("," Term)* ("|" Term)? "]"
 ;;
-;; Op type → right-prec for op at precedence P:
-;;   xfx → P-1   strict-both
-;;   xfy → P     right-associative
-;;   yfx → P-1   left-associative
+;; Term AST shapes (all tagged lists for uniform dispatch):
+;;   ("atom"  name)            — atom
+;;   ("var"   name)            — variable template (parser-time only)
+;;   ("num"   value)           — integer or float
+;;   ("str"   value)           — string literal
+;;   ("compound" functor args) — compound term, args is list of term-ASTs
+;;   ("cut")                   — the cut atom !
 ;;
-;; AST shapes are unchanged — operators just become compound terms.
+;; A clause is (list "clause" head body). A fact is head with body = ("atom" "true").
+;;
+;; The empty list is (atom "[]"). Cons is compound "." with two args:
+;; [1, 2, 3]   → .(1, .(2, .(3, [])))
+;; [H|T]       → .(H, T)
 
+;; ── Parser state helpers ────────────────────────────────────────────
 (define
   pp-peek
   (fn
@@ -58,6 +66,7 @@
             (if (= (get t :value) nil) "" (get t :value))
             "'"))))))
 
+;; ── AST constructors ────────────────────────────────────────────────
 (define pl-mk-atom (fn (name) (list "atom" name)))
 (define pl-mk-var (fn (name) (list "var" name)))
 (define pl-mk-num (fn (n) (list "num" n)))
@@ -65,14 +74,18 @@
 (define pl-mk-compound (fn (f args) (list "compound" f args)))
 (define pl-mk-cut (fn () (list "cut")))
 
+;; Term tag extractors
 (define pl-term-tag (fn (t) (if (list? t) (first t) nil)))
 (define pl-term-val (fn (t) (nth t 1)))
 (define pl-compound-functor (fn (t) (nth t 1)))
 (define pl-compound-args (fn (t) (nth t 2)))
 
+;; Empty-list atom and cons helpers
 (define pl-nil-term (fn () (pl-mk-atom "[]")))
+
 (define pl-mk-cons (fn (h t) (pl-mk-compound "." (list h t))))
 
+;; Build cons list from a list of terms + optional tail
 (define
   pl-mk-list-term
   (fn
@@ -82,61 +95,9 @@
       tail
       (pl-mk-cons (first items) (pl-mk-list-term (rest items) tail)))))
 
-;; ── Operator table (Phase 4) ──────────────────────────────────────
-;; Each entry: (name precedence type). Type ∈ "xfx" "xfy" "yfx".
-(define
-  pl-op-table
-  (list
-    (list "," 1000 "xfy")
-    (list ";" 1100 "xfy")
-    (list "->" 1050 "xfy")
-    (list "=" 700 "xfx")
-    (list "\\=" 700 "xfx")
-    (list "is" 700 "xfx")
-    (list "<" 700 "xfx")
-    (list ">" 700 "xfx")
-    (list "=<" 700 "xfx")
-    (list ">=" 700 "xfx")
-    (list "+" 500 "yfx")
-    (list "-" 500 "yfx")
-    (list "*" 400 "yfx")
-    (list "/" 400 "yfx")
-    (list ":-" 1200 "xfx")
-    (list "mod" 400 "yfx")))
-
-(define
-  pl-op-find
-  (fn
-    (name table)
-    (cond
-      ((empty? table) nil)
-      ((= (first (first table)) name) (rest (first table)))
-      (true (pl-op-find name (rest table))))))
-
-(define pl-op-lookup (fn (name) (pl-op-find name pl-op-table)))
-
-;; Token → (name prec type) for known infix ops, else nil.
-(define
-  pl-token-op
-  (fn
-    (t)
-    (let
-      ((ty (get t :type)) (vv (get t :value)))
-      (cond
-        ((and (= ty "punct") (= vv ","))
-          (let
-            ((info (pl-op-lookup ",")))
-            (if (nil? info) nil (cons "," info))))
-        ((or (= ty "atom") (= ty "op"))
-          (let
-            ((info (pl-op-lookup vv)))
-            (if (nil? info) nil (cons vv info))))
-        (true nil)))))
-
 ;; ── Term parser ─────────────────────────────────────────────────────
-;; Primary term: atom, var, num, str, compound (atom + paren), list, cut, parens.
 (define
-  pp-parse-primary
+  pp-parse-term
   (fn
     (st)
     (let
@@ -150,12 +111,6 @@
           ((and (= ty "op") (= vv "!"))
             (do (pp-advance! st) (pl-mk-cut)))
           ((and (= ty "punct") (= vv "[")) (pp-parse-list st))
-          ((and (= ty "punct") (= vv "("))
-            (do
-              (pp-advance! st)
-              (let
-                ((inner (pp-parse-term-prec st 1200)))
-                (do (pp-expect! st "punct" ")") inner))))
           ((= ty "atom")
             (do
               (pp-advance! st)
@@ -178,51 +133,13 @@
                 (if (= vv nil) "" vv)
                 "'"))))))))
 
-;; Operator-aware term parser: precedence climbing.
-(define
-  pp-parse-term-prec
-  (fn
-    (st max-prec)
-    (let ((left (pp-parse-primary st))) (pp-parse-op-rhs st left max-prec))))
-
-(define
-  pp-parse-op-rhs
-  (fn
-    (st left max-prec)
-    (let
-      ((op-info (pl-token-op (pp-peek st))))
-      (cond
-        ((nil? op-info) left)
-        (true
-          (let
-            ((name (first op-info))
-              (prec (nth op-info 1))
-              (ty (nth op-info 2)))
-            (cond
-              ((> prec max-prec) left)
-              (true
-                (let
-                  ((right-prec (if (= ty "xfy") prec (- prec 1))))
-                  (do
-                    (pp-advance! st)
-                    (let
-                      ((right (pp-parse-term-prec st right-prec)))
-                      (pp-parse-op-rhs
-                        st
-                        (pl-mk-compound name (list left right))
-                        max-prec))))))))))))
-
-;; Backwards-compat alias.
-(define pp-parse-term (fn (st) (pp-parse-term-prec st 999)))
-
-;; Args inside parens: parse at prec 999 so comma-as-operator (1000)
-;; is not consumed; the explicit comma loop handles separation.
+;; Parse one or more comma-separated terms (arguments).
 (define
   pp-parse-arg-list
   (fn
     (st)
     (let
-      ((first-arg (pp-parse-term-prec st 999)) (args (list)))
+      ((first-arg (pp-parse-term st)) (args (list)))
       (do
         (append! args first-arg)
         (define
@@ -233,12 +150,12 @@
               (pp-at? st "punct" ",")
               (do
                 (pp-advance! st)
-                (append! args (pp-parse-term-prec st 999))
+                (append! args (pp-parse-term st))
                 (loop)))))
         (loop)
         args))))
 
-;; List literal.
+;; Parse a [ ... ] list literal. Consumes the "[".
 (define
   pp-parse-list
   (fn
@@ -251,7 +168,7 @@
         (let
           ((items (list)))
           (do
-            (append! items (pp-parse-term-prec st 999))
+            (append! items (pp-parse-term st))
             (define
               comma-loop
               (fn
@@ -260,17 +177,52 @@
                   (pp-at? st "punct" ",")
                   (do
                     (pp-advance! st)
-                    (append! items (pp-parse-term-prec st 999))
+                    (append! items (pp-parse-term st))
                     (comma-loop)))))
             (comma-loop)
             (let
-              ((tail (if (pp-at? st "punct" "|") (do (pp-advance! st) (pp-parse-term-prec st 999)) (pl-nil-term))))
+              ((tail (if (pp-at? st "punct" "|") (do (pp-advance! st) (pp-parse-term st)) (pl-nil-term))))
               (do (pp-expect! st "punct" "]") (pl-mk-list-term items tail)))))))))
 
 ;; ── Body parsing ────────────────────────────────────────────────────
-;; A body is a single term parsed at prec 1200 — operator parser folds
-;; `,`, `;`, `->` automatically into right-associative compounds.
-(define pp-parse-body (fn (st) (pp-parse-term-prec st 1200)))
+;; A clause body is a comma-separated list of goals. We flatten into a
+;; right-associative `,` compound: (A, B, C) → ','(A, ','(B, C))
+;; If only one goal, it's that goal directly.
+(define
+  pp-parse-body
+  (fn
+    (st)
+    (let
+      ((first-goal (pp-parse-term st)) (rest-goals (list)))
+      (do
+        (define
+          gloop
+          (fn
+            ()
+            (when
+              (pp-at? st "punct" ",")
+              (do
+                (pp-advance! st)
+                (append! rest-goals (pp-parse-term st))
+                (gloop)))))
+        (gloop)
+        (if
+          (= (len rest-goals) 0)
+          first-goal
+          (pp-build-conj first-goal rest-goals))))))
+
+(define
+  pp-build-conj
+  (fn
+    (first-goal rest-goals)
+    (if
+      (= (len rest-goals) 0)
+      first-goal
+      (pl-mk-compound
+        ","
+        (list
+          first-goal
+          (pp-build-conj (first rest-goals) (rest rest-goals)))))))
 
 ;; ── Clause parsing ──────────────────────────────────────────────────
 (define
@@ -278,11 +230,12 @@
   (fn
     (st)
     (let
-      ((head (pp-parse-term-prec st 999)))
+      ((head (pp-parse-term st)))
       (let
         ((body (if (pp-at? st "op" ":-") (do (pp-advance! st) (pp-parse-body st)) (pl-mk-atom "true"))))
         (do (pp-expect! st "punct" ".") (list "clause" head body))))))
 
+;; Parse an entire program — returns list of clauses.
 (define
   pl-parse-program
   (fn
@@ -300,9 +253,13 @@
         (ploop)
         clauses))))
 
+;; Parse a single query term (no trailing "."). Returns the term.
 (define
   pl-parse-query
   (fn (tokens) (let ((st {:idx 0 :tokens tokens})) (pp-parse-body st))))
 
+;; Convenience: source → clauses
 (define pl-parse (fn (src) (pl-parse-program (pl-tokenize src))))
+
+;; Convenience: source → query term
 (define pl-parse-goal (fn (src) (pl-parse-query (pl-tokenize src))))

lib/prolog/query.sx

@@ -1,114 +0,0 @@
-;; lib/prolog/query.sx — high-level Prolog query API for SX/Hyperscript callers.
-;;
-;; Requires tokenizer.sx, parser.sx, runtime.sx to be loaded first.
-;;
-;; Public API:
-;;   (pl-load source-str)                → db
-;;   (pl-query-all db query-str)         → list of solution dicts {var-name → term-string}
-;;   (pl-query-one db query-str)         → first solution dict or nil
-;;   (pl-query source-str query-str)     → list of solution dicts (convenience)
-
-;; Collect variable name strings from a parse-time AST (pre-instantiation).
-;; Returns list of unique strings, excluding anonymous "_".
-(define
-  pl-query-extract-vars
-  (fn
-    (ast)
-    (let
-      ((seen {}))
-      (let
-        ((collect!
-          (fn
-            (t)
-            (cond
-              ((not (list? t)) nil)
-              ((empty? t) nil)
-              ((= (first t) "var")
-                (if
-                  (not (= (nth t 1) "_"))
-                  (dict-set! seen (nth t 1) true)
-                  nil))
-              ((= (first t) "compound")
-                (for-each collect! (nth t 2)))
-              (true nil)))))
-        (collect! ast)
-        (keys seen)))))
-
-;; Build a solution dict from a var-env after a successful solve.
-;; Maps each variable name string to its formatted term value.
-(define
-  pl-query-solution-dict
-  (fn
-    (var-names var-env)
-    (let
-      ((d {}))
-      (for-each
-        (fn (name) (dict-set! d name (pl-format-term (dict-get var-env name))))
-        var-names)
-      d)))
-
-;; Parse source-str and load clauses into a fresh DB.
-;; Returns the DB for reuse across multiple queries.
-(define
-  pl-load
-  (fn
-    (source-str)
-    (let
-      ((db (pl-mk-db)))
-      (if
-        (and (string? source-str) (not (= source-str "")))
-        (pl-db-load! db (pl-parse source-str))
-        nil)
-      db)))
-
-;; Run query-str against db, returning a list of solution dicts.
-;; Each dict maps variable name strings to their formatted term values.
-;; Returns an empty list if no solutions.
-(define
-  pl-query-all
-  (fn
-    (db query-str)
-    (let
-      ((parsed (pl-parse (str "q_ :- " query-str "."))))
-      (let
-        ((body-ast (nth (first parsed) 2)))
-        (let
-          ((var-names (pl-query-extract-vars body-ast))
-           (var-env {}))
-          (let
-            ((goal (pl-instantiate body-ast var-env))
-             (trail (pl-mk-trail))
-             (solutions (list)))
-            (let
-              ((mark (pl-trail-mark trail)))
-              (pl-solve!
-                db
-                goal
-                trail
-                {:cut false}
-                (fn
-                  ()
-                  (begin
-                    (append!
-                      solutions
-                      (pl-query-solution-dict var-names var-env))
-                    false)))
-              (pl-trail-undo-to! trail mark)
-              solutions)))))))
-
-;; Return the first solution dict, or nil if no solutions.
-(define
-  pl-query-one
-  (fn
-    (db query-str)
-    (let
-      ((all (pl-query-all db query-str)))
-      (if (empty? all) nil (first all)))))
-
-;; Convenience: parse source-str, then run query-str against it.
-;; Returns a list of solution dicts. Creates a fresh DB each call.
-(define
-  pl-query
-  (fn
-    (source-str query-str)
-    (pl-query-all (pl-load source-str) query-str)))

lib/prolog/scoreboard.json

@@ -1,7 +0,0 @@
-{
-  "total_passed": 590,
-  "total_failed": 0,
-  "total": 590,
-  "suites": {"parse":{"passed":25,"total":25,"failed":0},"unify":{"passed":47,"total":47,"failed":0},"clausedb":{"passed":14,"total":14,"failed":0},"solve":{"passed":62,"total":62,"failed":0},"operators":{"passed":19,"total":19,"failed":0},"dynamic":{"passed":11,"total":11,"failed":0},"findall":{"passed":11,"total":11,"failed":0},"term_inspect":{"passed":14,"total":14,"failed":0},"append":{"passed":6,"total":6,"failed":0},"reverse":{"passed":6,"total":6,"failed":0},"member":{"passed":7,"total":7,"failed":0},"nqueens":{"passed":6,"total":6,"failed":0},"family":{"passed":10,"total":10,"failed":0},"atoms":{"passed":34,"total":34,"failed":0},"query_api":{"passed":16,"total":16,"failed":0},"iso_predicates":{"passed":29,"total":29,"failed":0},"meta_predicates":{"passed":25,"total":25,"failed":0},"list_predicates":{"passed":33,"total":33,"failed":0},"meta_call":{"passed":15,"total":15,"failed":0},"set_predicates":{"passed":15,"total":15,"failed":0},"char_predicates":{"passed":27,"total":27,"failed":0},"io_predicates":{"passed":24,"total":24,"failed":0},"assert_rules":{"passed":15,"total":15,"failed":0},"string_agg":{"passed":25,"total":25,"failed":0},"advanced":{"passed":21,"total":21,"failed":0},"compiler":{"passed":17,"total":17,"failed":0},"cross_validate":{"passed":17,"total":17,"failed":0},"integration":{"passed":20,"total":20,"failed":0},"hs_bridge":{"passed":19,"total":19,"failed":0}},
-  "generated": "2026-05-06T08:29:09+00:00"
-}

lib/prolog/scoreboard.md

@@ -1,39 +0,0 @@
-# Prolog scoreboard
-
-**590 / 590 passing** (0 failure(s)).
-Generated 2026-05-06T08:29:09+00:00.
-
-| Suite | Passed | Total | Status |
-|-------|--------|-------|--------|
-| parse | 25 | 25 | ok |
-| unify | 47 | 47 | ok |
-| clausedb | 14 | 14 | ok |
-| solve | 62 | 62 | ok |
-| operators | 19 | 19 | ok |
-| dynamic | 11 | 11 | ok |
-| findall | 11 | 11 | ok |
-| term_inspect | 14 | 14 | ok |
-| append | 6 | 6 | ok |
-| reverse | 6 | 6 | ok |
-| member | 7 | 7 | ok |
-| nqueens | 6 | 6 | ok |
-| family | 10 | 10 | ok |
-| atoms | 34 | 34 | ok |
-| query_api | 16 | 16 | ok |
-| iso_predicates | 29 | 29 | ok |
-| meta_predicates | 25 | 25 | ok |
-| list_predicates | 33 | 33 | ok |
-| meta_call | 15 | 15 | ok |
-| set_predicates | 15 | 15 | ok |
-| char_predicates | 27 | 27 | ok |
-| io_predicates | 24 | 24 | ok |
-| assert_rules | 15 | 15 | ok |
-| string_agg | 25 | 25 | ok |
-| advanced | 21 | 21 | ok |
-| compiler | 17 | 17 | ok |
-| cross_validate | 17 | 17 | ok |
-| integration | 20 | 20 | ok |
-| hs_bridge | 19 | 19 | ok |
-
-Run `bash lib/prolog/conformance.sh` to refresh. Override the binary
-with `SX_SERVER=path/to/sx_server.exe bash …`.

lib/prolog/tests/advanced.sx

@@ -1,254 +0,0 @@
-;; lib/prolog/tests/advanced.sx — predsort/3, term_variables/2, arith extensions
-
-(define pl-adv-test-count 0)
-(define pl-adv-test-pass 0)
-(define pl-adv-test-fail 0)
-(define pl-adv-test-failures (list))
-
-(define
-  pl-adv-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-adv-test-count (+ pl-adv-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-adv-test-pass (+ pl-adv-test-pass 1))
-        (begin
-          (set! pl-adv-test-fail (+ pl-adv-test-fail 1))
-          (append!
-            pl-adv-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-adv-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-adv-db (pl-mk-db))
-;; Load a numeric comparator for predsort tests
-(pl-db-load!
-  pl-adv-db
-  (pl-parse
-    "cmp_num(Order, X, Y) :- (X < Y -> Order = '<' ; (X > Y -> Order = '>' ; Order = '='))."))
-
-;; ── Arithmetic extensions ──────────────────────────────────────────
-
-(define pl-adv-arith-env-1 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is floor(3.7)" pl-adv-arith-env-1)
-  (pl-mk-trail))
-(pl-adv-test!
-  "floor(3.7) = 3"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-1 "X")))
-  3)
-
-(define pl-adv-arith-env-2 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is ceiling(3.2)" pl-adv-arith-env-2)
-  (pl-mk-trail))
-(pl-adv-test!
-  "ceiling(3.2) = 4"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-2 "X")))
-  4)
-
-(define pl-adv-arith-env-3 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is truncate(3.9)" pl-adv-arith-env-3)
-  (pl-mk-trail))
-(pl-adv-test!
-  "truncate(3.9) = 3"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-3 "X")))
-  3)
-
-(define pl-adv-arith-env-4 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is truncate(0 - 3.9)" pl-adv-arith-env-4)
-  (pl-mk-trail))
-(pl-adv-test!
-  "truncate(0-3.9) = -3"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-4 "X")))
-  -3)
-
-(define pl-adv-arith-env-5 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is round(3.5)" pl-adv-arith-env-5)
-  (pl-mk-trail))
-(pl-adv-test!
-  "round(3.5) = 4"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-5 "X")))
-  4)
-
-(define pl-adv-arith-env-6 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is sqrt(4.0)" pl-adv-arith-env-6)
-  (pl-mk-trail))
-(pl-adv-test!
-  "sqrt(4.0) = 2"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-6 "X")))
-  2)
-
-(define pl-adv-arith-env-7 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is sign(0 - 5)" pl-adv-arith-env-7)
-  (pl-mk-trail))
-(pl-adv-test!
-  "sign(0-5) = -1"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-7 "X")))
-  -1)
-
-(define pl-adv-arith-env-8 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is sign(0)" pl-adv-arith-env-8)
-  (pl-mk-trail))
-(pl-adv-test!
-  "sign(0) = 0"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-8 "X")))
-  0)
-
-(define pl-adv-arith-env-9 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is sign(3)" pl-adv-arith-env-9)
-  (pl-mk-trail))
-(pl-adv-test!
-  "sign(3) = 1"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-9 "X")))
-  1)
-
-(define pl-adv-arith-env-10 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is pow(2, 3)" pl-adv-arith-env-10)
-  (pl-mk-trail))
-(pl-adv-test!
-  "pow(2,3) = 8"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-10 "X")))
-  8)
-
-(define pl-adv-arith-env-11 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is floor(0 - 3.7)" pl-adv-arith-env-11)
-  (pl-mk-trail))
-(pl-adv-test!
-  "floor(0-3.7) = -4"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-11 "X")))
-  -4)
-
-(define pl-adv-arith-env-12 {:X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "X is ceiling(0 - 3.2)" pl-adv-arith-env-12)
-  (pl-mk-trail))
-(pl-adv-test!
-  "ceiling(0-3.2) = -3"
-  (pl-num-val (pl-walk-deep (dict-get pl-adv-arith-env-12 "X")))
-  -3)
-
-;; ── term_variables/2 ──────────────────────────────────────────────
-
-(define pl-adv-tv-env-1 {:Vs (pl-mk-rt-var "Vs")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "term_variables(hello, Vs)" pl-adv-tv-env-1)
-  (pl-mk-trail))
-(pl-adv-test!
-  "term_variables(hello,Vs) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-tv-env-1 "Vs")))
-  "[]")
-
-(define pl-adv-tv-env-2 {:Vs (pl-mk-rt-var "Vs")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "term_variables(f(a, g(b)), Vs)" pl-adv-tv-env-2)
-  (pl-mk-trail))
-(pl-adv-test!
-  "term_variables(f(a,g(b)),Vs) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-tv-env-2 "Vs")))
-  "[]")
-
-(define pl-adv-tv-env-3 {:Y (pl-mk-rt-var "Y") :Vs (pl-mk-rt-var "Vs") :X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "term_variables(f(X, Y), Vs)" pl-adv-tv-env-3)
-  (pl-mk-trail))
-(pl-adv-test!
-  "term_variables(f(X,Y),Vs) has 2 vars"
-  (pl-list-length (pl-walk-deep (dict-get pl-adv-tv-env-3 "Vs")))
-  2)
-
-(define pl-adv-tv-env-4 {:Vs (pl-mk-rt-var "Vs") :X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "term_variables(X, Vs)" pl-adv-tv-env-4)
-  (pl-mk-trail))
-(pl-adv-test!
-  "term_variables(X,Vs) has 1 var"
-  (pl-list-length (pl-walk-deep (dict-get pl-adv-tv-env-4 "Vs")))
-  1)
-
-(define pl-adv-tv-env-5 {:Y (pl-mk-rt-var "Y") :Vs (pl-mk-rt-var "Vs") :X (pl-mk-rt-var "X")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "term_variables(foo(X, Y, X), Vs)" pl-adv-tv-env-5)
-  (pl-mk-trail))
-(pl-adv-test!
-  "term_variables(foo(X,Y,X),Vs) deduplicates X -> 2 vars"
-  (pl-list-length (pl-walk-deep (dict-get pl-adv-tv-env-5 "Vs")))
-  2)
-
-;; ── predsort/3 ────────────────────────────────────────────────────
-
-(define pl-adv-ps-env-1 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "predsort(cmp_num, [], R)" pl-adv-ps-env-1)
-  (pl-mk-trail))
-(pl-adv-test!
-  "predsort([]) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-ps-env-1 "R")))
-  "[]")
-
-(define pl-adv-ps-env-2 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "predsort(cmp_num, [1], R)" pl-adv-ps-env-2)
-  (pl-mk-trail))
-(pl-adv-test!
-  "predsort([1]) -> [1]"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-ps-env-2 "R")))
-  ".(1, [])")
-
-(define pl-adv-ps-env-3 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "predsort(cmp_num, [3,1,2], R)" pl-adv-ps-env-3)
-  (pl-mk-trail))
-(pl-adv-test!
-  "predsort([3,1,2]) -> [1,2,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-ps-env-3 "R")))
-  ".(1, .(2, .(3, [])))")
-
-(define pl-adv-ps-env-4 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-adv-db
-  (pl-adv-goal "predsort(cmp_num, [3,1,2,1,3], R)" pl-adv-ps-env-4)
-  (pl-mk-trail))
-(pl-adv-test!
-  "predsort([3,1,2,1,3]) dedup -> [1,2,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-adv-ps-env-4 "R")))
-  ".(1, .(2, .(3, [])))")
-
-;; ── Runner ─────────────────────────────────────────────────────────
-
-(define pl-advanced-tests-run! (fn () {:failed pl-adv-test-fail :passed pl-adv-test-pass :total pl-adv-test-count :failures pl-adv-test-failures}))

lib/prolog/tests/assert_rules.sx

@@ -1,215 +0,0 @@
-;; lib/prolog/tests/assert_rules.sx — assert/assertz/asserta with rule terms (head :- body)
-;; Tests that :- is in the op table (prec 1200 xfx) and pl-build-clause handles rule form.
-
-(define pl-ar-test-count 0)
-(define pl-ar-test-pass 0)
-(define pl-ar-test-fail 0)
-(define pl-ar-test-failures (list))
-
-(define
-  pl-ar-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-ar-test-count (+ pl-ar-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-ar-test-pass (+ pl-ar-test-pass 1))
-        (begin
-          (set! pl-ar-test-fail (+ pl-ar-test-fail 1))
-          (append!
-            pl-ar-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-ar-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-;; ── DB1: assertz a simple rule then query ──────────────────────────
-(define pl-ar-db1 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db1
-  (pl-ar-goal "assertz((double(X, Y) :- Y is X * 2))" {})
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "assertz rule: double(3, Y) succeeds"
-  (pl-solve-once!
-    pl-ar-db1
-    (pl-ar-goal "double(3, Y)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-ar-env1 {})
-(pl-solve-once!
-  pl-ar-db1
-  (pl-ar-goal "double(3, Y)" pl-ar-env1)
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "assertz rule: double(3, Y) binds Y to 6"
-  (pl-num-val (pl-walk-deep (dict-get pl-ar-env1 "Y")))
-  6)
-
-(define pl-ar-env1b {})
-(pl-solve-once!
-  pl-ar-db1
-  (pl-ar-goal "double(10, Y)" pl-ar-env1b)
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "assertz rule: double(10, Y) yields 20"
-  (pl-num-val (pl-walk-deep (dict-get pl-ar-env1b "Y")))
-  20)
-
-;; ── DB2: assert a rule with multiple facts, count solutions ─────────
-(define pl-ar-db2 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db2
-  (pl-ar-goal "assert(fact(a))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db2
-  (pl-ar-goal "assert(fact(b))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db2
-  (pl-ar-goal "assertz((copy(X) :- fact(X)))" {})
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "rule copy/1 using fact/1: 2 solutions"
-  (pl-solve-count! pl-ar-db2 (pl-ar-goal "copy(X)" {}) (pl-mk-trail))
-  2)
-
-(define pl-ar-env2a {})
-(pl-solve-once! pl-ar-db2 (pl-ar-goal "copy(X)" pl-ar-env2a) (pl-mk-trail))
-
-(pl-ar-test!
-  "rule copy/1: first solution is a"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ar-env2a "X")))
-  "a")
-
-;; ── DB3: asserta rule is tried before existing clauses ─────────────
-(define pl-ar-db3 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db3
-  (pl-ar-goal "assert(ord(a))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db3
-  (pl-ar-goal "asserta((ord(b) :- true))" {})
-  (pl-mk-trail))
-
-(define pl-ar-env3 {})
-(pl-solve-once! pl-ar-db3 (pl-ar-goal "ord(X)" pl-ar-env3) (pl-mk-trail))
-
-(pl-ar-test!
-  "asserta rule ord(b) is tried before ord(a)"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ar-env3 "X")))
-  "b")
-
-(pl-ar-test!
-  "asserta: total solutions for ord/1 is 2"
-  (pl-solve-count! pl-ar-db3 (pl-ar-goal "ord(X)" {}) (pl-mk-trail))
-  2)
-
-;; ── DB4: rule with conjunction in body ─────────────────────────────
-(define pl-ar-db4 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db4
-  (pl-ar-goal "assert(num(1))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db4
-  (pl-ar-goal "assert(num(2))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db4
-  (pl-ar-goal "assertz((big(X) :- num(X), X > 1))" {})
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "conjunction in rule body: big(1) fails"
-  (pl-solve-once! pl-ar-db4 (pl-ar-goal "big(1)" {}) (pl-mk-trail))
-  false)
-
-(pl-ar-test!
-  "conjunction in rule body: big(2) succeeds"
-  (pl-solve-once! pl-ar-db4 (pl-ar-goal "big(2)" {}) (pl-mk-trail))
-  true)
-
-;; ── DB5: recursive rule ─────────────────────────────────────────────
-(define pl-ar-db5 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db5
-  (pl-ar-goal "assert((nat(0) :- true))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db5
-  (pl-ar-goal "assertz((nat(s(X)) :- nat(X)))" {})
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "recursive rule: nat(0) succeeds"
-  (pl-solve-once! pl-ar-db5 (pl-ar-goal "nat(0)" {}) (pl-mk-trail))
-  true)
-
-(pl-ar-test!
-  "recursive rule: nat(s(0)) succeeds"
-  (pl-solve-once!
-    pl-ar-db5
-    (pl-ar-goal "nat(s(0))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-ar-test!
-  "recursive rule: nat(s(s(0))) succeeds"
-  (pl-solve-once!
-    pl-ar-db5
-    (pl-ar-goal "nat(s(s(0)))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-ar-test!
-  "recursive rule: nat(bad) fails"
-  (pl-solve-once! pl-ar-db5 (pl-ar-goal "nat(bad)" {}) (pl-mk-trail))
-  false)
-
-;; ── DB6: rule with true body (explicit) ────────────────────────────
-(define pl-ar-db6 (pl-mk-db))
-
-(pl-solve-once!
-  pl-ar-db6
-  (pl-ar-goal "assertz((always(X) :- true))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-ar-db6
-  (pl-ar-goal "assert(always(extra))" {})
-  (pl-mk-trail))
-
-(pl-ar-test!
-  "rule body=true: always(foo) succeeds"
-  (pl-solve-once!
-    pl-ar-db6
-    (pl-ar-goal "always(foo)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-ar-test!
-  "rule body=true: always/1 has 2 clauses (1 rule + 1 fact)"
-  (pl-solve-count!
-    pl-ar-db6
-    (pl-ar-goal "always(X)" {})
-    (pl-mk-trail))
-  2)
-
-;; ── Runner ──────────────────────────────────────────────────────────
-(define pl-assert-rules-tests-run! (fn () {:failed pl-ar-test-fail :passed pl-ar-test-pass :total pl-ar-test-count :failures pl-ar-test-failures}))

lib/prolog/tests/atoms.sx

@@ -1,305 +0,0 @@
-;; lib/prolog/tests/atoms.sx — type predicates + string/atom built-ins
-
-(define pl-at-test-count 0)
-(define pl-at-test-pass 0)
-(define pl-at-test-fail 0)
-(define pl-at-test-failures (list))
-
-(define
-  pl-at-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-at-test-count (+ pl-at-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-at-test-pass (+ pl-at-test-pass 1))
-        (begin
-          (set! pl-at-test-fail (+ pl-at-test-fail 1))
-          (append!
-            pl-at-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-at-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-at-db (pl-mk-db))
-
-;; ── var/1 + nonvar/1 ──
-
-(pl-at-test!
-  "var(X) for unbound var"
-  (pl-solve-once! pl-at-db (pl-at-goal "var(X)" {}) (pl-mk-trail))
-  true)
-(pl-at-test!
-  "var(foo) fails"
-  (pl-solve-once! pl-at-db (pl-at-goal "var(foo)" {}) (pl-mk-trail))
-  false)
-(pl-at-test!
-  "nonvar(foo) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "nonvar(foo)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "nonvar(X) for unbound var fails"
-  (pl-solve-once! pl-at-db (pl-at-goal "nonvar(X)" {}) (pl-mk-trail))
-  false)
-
-;; ── atom/1 ──
-
-(pl-at-test!
-  "atom(foo) succeeds"
-  (pl-solve-once! pl-at-db (pl-at-goal "atom(foo)" {}) (pl-mk-trail))
-  true)
-(pl-at-test!
-  "atom([]) succeeds"
-  (pl-solve-once! pl-at-db (pl-at-goal "atom([])" {}) (pl-mk-trail))
-  true)
-(pl-at-test!
-  "atom(42) fails"
-  (pl-solve-once! pl-at-db (pl-at-goal "atom(42)" {}) (pl-mk-trail))
-  false)
-(pl-at-test!
-  "atom(f(x)) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atom(f(x))" {})
-    (pl-mk-trail))
-  false)
-
-;; ── number/1 + integer/1 ──
-
-(pl-at-test!
-  "number(42) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "number(42)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "number(foo) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "number(foo)" {})
-    (pl-mk-trail))
-  false)
-(pl-at-test!
-  "integer(7) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "integer(7)" {})
-    (pl-mk-trail))
-  true)
-
-;; ── compound/1 + callable/1 + atomic/1 ──
-
-(pl-at-test!
-  "compound(f(x)) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "compound(f(x))" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "compound(foo) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "compound(foo)" {})
-    (pl-mk-trail))
-  false)
-(pl-at-test!
-  "callable(foo) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "callable(foo)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "callable(f(x)) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "callable(f(x))" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "callable(42) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "callable(42)" {})
-    (pl-mk-trail))
-  false)
-(pl-at-test!
-  "atomic(foo) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atomic(foo)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "atomic(42) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atomic(42)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "atomic(f(x)) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atomic(f(x))" {})
-    (pl-mk-trail))
-  false)
-
-;; ── is_list/1 ──
-
-(pl-at-test!
-  "is_list([]) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "is_list([])" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "is_list([1,2,3]) succeeds"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "is_list([1,2,3])" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "is_list(foo) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "is_list(foo)" {})
-    (pl-mk-trail))
-  false)
-
-;; ── atom_length/2 ──
-
-(define pl-at-env-al {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "atom_length(hello, N)" pl-at-env-al)
-  (pl-mk-trail))
-(pl-at-test!
-  "atom_length(hello, N) -> N=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-at-env-al "N")))
-  5)
-(pl-at-test!
-  "atom_length empty atom"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atom_length('', 0)" {})
-    (pl-mk-trail))
-  true)
-
-;; ── atom_concat/3 ──
-
-(define pl-at-env-ac {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "atom_concat(foo, bar, X)" pl-at-env-ac)
-  (pl-mk-trail))
-(pl-at-test!
-  "atom_concat(foo, bar, X) -> X=foobar"
-  (pl-atom-name (pl-walk-deep (dict-get pl-at-env-ac "X")))
-  "foobar")
-
-(pl-at-test!
-  "atom_concat(foo, bar, foobar) check"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atom_concat(foo, bar, foobar)" {})
-    (pl-mk-trail))
-  true)
-(pl-at-test!
-  "atom_concat(foo, bar, foobaz) fails"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atom_concat(foo, bar, foobaz)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-at-env-ac2 {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "atom_concat(foo, Y, foobar)" pl-at-env-ac2)
-  (pl-mk-trail))
-(pl-at-test!
-  "atom_concat(foo, Y, foobar) -> Y=bar"
-  (pl-atom-name (pl-walk-deep (dict-get pl-at-env-ac2 "Y")))
-  "bar")
-
-;; ── atom_chars/2 ──
-
-(define pl-at-env-ach {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "atom_chars(cat, Cs)" pl-at-env-ach)
-  (pl-mk-trail))
-(pl-at-test!
-  "atom_chars(cat, Cs) -> Cs=[c,a,t]"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "atom_chars(cat, [c,a,t])" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-at-env-ach2 {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "atom_chars(A, [h,i])" pl-at-env-ach2)
-  (pl-mk-trail))
-(pl-at-test!
-  "atom_chars(A, [h,i]) -> A=hi"
-  (pl-atom-name (pl-walk-deep (dict-get pl-at-env-ach2 "A")))
-  "hi")
-
-;; ── char_code/2 ──
-
-(define pl-at-env-cc {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "char_code(a, N)" pl-at-env-cc)
-  (pl-mk-trail))
-(pl-at-test!
-  "char_code(a, N) -> N=97"
-  (pl-num-val (pl-walk-deep (dict-get pl-at-env-cc "N")))
-  97)
-
-(define pl-at-env-cc2 {})
-(pl-solve-once!
-  pl-at-db
-  (pl-at-goal "char_code(C, 65)" pl-at-env-cc2)
-  (pl-mk-trail))
-(pl-at-test!
-  "char_code(C, 65) -> C='A'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-at-env-cc2 "C")))
-  "A")
-
-;; ── number_codes/2 ──
-
-(pl-at-test!
-  "number_codes(42, [52,50])"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "number_codes(42, [52,50])" {})
-    (pl-mk-trail))
-  true)
-
-;; ── number_chars/2 ──
-
-(pl-at-test!
-  "number_chars(42, ['4','2'])"
-  (pl-solve-once!
-    pl-at-db
-    (pl-at-goal "number_chars(42, ['4','2'])" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-atom-tests-run! (fn () {:failed pl-at-test-fail :passed pl-at-test-pass :total pl-at-test-count :failures pl-at-test-failures}))

lib/prolog/tests/char_predicates.sx

@@ -1,290 +0,0 @@
-;; lib/prolog/tests/char_predicates.sx — char_type/2, upcase_atom/2, downcase_atom/2,
-;;   string_upper/2, string_lower/2
-
-(define pl-cp-test-count 0)
-(define pl-cp-test-pass 0)
-(define pl-cp-test-fail 0)
-(define pl-cp-test-failures (list))
-
-(define
-  pl-cp-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-cp-test-count (+ pl-cp-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-cp-test-pass (+ pl-cp-test-pass 1))
-        (begin
-          (set! pl-cp-test-fail (+ pl-cp-test-fail 1))
-          (append!
-            pl-cp-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-cp-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-cp-db (pl-mk-db))
-
-;; ─── char_type/2 — alpha ──────────────────────────────────────────
-
-(pl-cp-test!
-  "char_type(a, alpha) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, alpha)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type('1', alpha) fails"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type('1', alpha)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-cp-test!
-  "char_type('A', alpha) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type('A', alpha)" {})
-    (pl-mk-trail))
-  true)
-
-;; ─── char_type/2 — alnum ─────────────────────────────────────────
-
-(pl-cp-test!
-  "char_type('5', alnum) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type('5', alnum)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type(a, alnum) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, alnum)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type(' ', alnum) fails"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(' ', alnum)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── char_type/2 — digit ─────────────────────────────────────────
-
-(pl-cp-test!
-  "char_type('5', digit) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type('5', digit)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type(a, digit) fails"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, digit)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── char_type/2 — digit(Weight) ─────────────────────────────────
-
-(define pl-cp-env-dw {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "char_type('5', digit(N))" pl-cp-env-dw)
-  (pl-mk-trail))
-(pl-cp-test!
-  "char_type('5', digit(N)) -> N=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-cp-env-dw "N")))
-  5)
-
-(define pl-cp-env-dw0 {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "char_type('0', digit(N))" pl-cp-env-dw0)
-  (pl-mk-trail))
-(pl-cp-test!
-  "char_type('0', digit(N)) -> N=0"
-  (pl-num-val (pl-walk-deep (dict-get pl-cp-env-dw0 "N")))
-  0)
-
-;; ─── char_type/2 — space/white ───────────────────────────────────
-
-(pl-cp-test!
-  "char_type(' ', space) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(' ', space)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type(a, space) fails"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, space)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── char_type/2 — upper(Lower) ──────────────────────────────────
-
-(define pl-cp-env-ul {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "char_type('A', upper(L))" pl-cp-env-ul)
-  (pl-mk-trail))
-(pl-cp-test!
-  "char_type('A', upper(L)) -> L=a"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-ul "L")))
-  "a")
-
-(pl-cp-test!
-  "char_type(a, upper(L)) fails — not uppercase"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, upper(_))" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── char_type/2 — lower(Upper) ──────────────────────────────────
-
-(define pl-cp-env-lu {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "char_type(a, lower(U))" pl-cp-env-lu)
-  (pl-mk-trail))
-(pl-cp-test!
-  "char_type(a, lower(U)) -> U='A'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-lu "U")))
-  "A")
-
-;; ─── char_type/2 — ascii(Code) ───────────────────────────────────
-
-(define pl-cp-env-as {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "char_type(a, ascii(C))" pl-cp-env-as)
-  (pl-mk-trail))
-(pl-cp-test!
-  "char_type(a, ascii(C)) -> C=97"
-  (pl-num-val (pl-walk-deep (dict-get pl-cp-env-as "C")))
-  97)
-
-;; ─── char_type/2 — punct ─────────────────────────────────────────
-
-(pl-cp-test!
-  "char_type('.', punct) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type('.', punct)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "char_type(a, punct) fails"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "char_type(a, punct)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── upcase_atom/2 ───────────────────────────────────────────────
-
-(define pl-cp-env-ua {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "upcase_atom(hello, X)" pl-cp-env-ua)
-  (pl-mk-trail))
-(pl-cp-test!
-  "upcase_atom(hello, X) -> X='HELLO'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-ua "X")))
-  "HELLO")
-
-(pl-cp-test!
-  "upcase_atom(hello, 'HELLO') succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "upcase_atom(hello, 'HELLO')" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "upcase_atom('Hello World', 'HELLO WORLD') succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "upcase_atom('Hello World', 'HELLO WORLD')" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "upcase_atom('', '') succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "upcase_atom('', '')" {})
-    (pl-mk-trail))
-  true)
-
-;; ─── downcase_atom/2 ─────────────────────────────────────────────
-
-(define pl-cp-env-da {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "downcase_atom('HELLO', X)" pl-cp-env-da)
-  (pl-mk-trail))
-(pl-cp-test!
-  "downcase_atom('HELLO', X) -> X=hello"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-da "X")))
-  "hello")
-
-(pl-cp-test!
-  "downcase_atom('HELLO', hello) succeeds"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "downcase_atom('HELLO', hello)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-cp-test!
-  "downcase_atom(hello, hello) succeeds — already lowercase"
-  (pl-solve-once!
-    pl-cp-db
-    (pl-cp-goal "downcase_atom(hello, hello)" {})
-    (pl-mk-trail))
-  true)
-
-;; ─── string_upper/2 + string_lower/2 (aliases) ───────────────────
-
-(define pl-cp-env-su {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "string_upper(hello, X)" pl-cp-env-su)
-  (pl-mk-trail))
-(pl-cp-test!
-  "string_upper(hello, X) -> X='HELLO'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-su "X")))
-  "HELLO")
-
-(define pl-cp-env-sl {})
-(pl-solve-once!
-  pl-cp-db
-  (pl-cp-goal "string_lower('WORLD', X)" pl-cp-env-sl)
-  (pl-mk-trail))
-(pl-cp-test!
-  "string_lower('WORLD', X) -> X=world"
-  (pl-atom-name (pl-walk-deep (dict-get pl-cp-env-sl "X")))
-  "world")
-
-(define pl-char-predicates-tests-run! (fn () {:failed pl-cp-test-fail :passed pl-cp-test-pass :total pl-cp-test-count :failures pl-cp-test-failures}))

lib/prolog/tests/clausedb.sx

@@ -1,99 +0,0 @@
-;; lib/prolog/tests/clausedb.sx — Clause DB unit tests
-
-(define pl-db-test-count 0)
-(define pl-db-test-pass 0)
-(define pl-db-test-fail 0)
-(define pl-db-test-failures (list))
-
-(define
-  pl-db-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-db-test-count (+ pl-db-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-db-test-pass (+ pl-db-test-pass 1))
-        (begin
-          (set! pl-db-test-fail (+ pl-db-test-fail 1))
-          (append!
-            pl-db-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(pl-db-test!
-  "head-key atom arity 0"
-  (pl-head-key (nth (first (pl-parse "foo.")) 1))
-  "foo/0")
-
-(pl-db-test!
-  "head-key compound arity 2"
-  (pl-head-key (nth (first (pl-parse "bar(a, b).")) 1))
-  "bar/2")
-
-(pl-db-test!
-  "clause-key of :- clause"
-  (pl-clause-key (first (pl-parse "likes(mary, X) :- friendly(X).")))
-  "likes/2")
-
-(pl-db-test!
-  "empty db lookup returns empty list"
-  (len (pl-db-lookup (pl-mk-db) "parent/2"))
-  0)
-
-(define pl-db-t1 (pl-mk-db))
-(pl-db-load! pl-db-t1 (pl-parse "foo(a). foo(b). foo(c)."))
-
-(pl-db-test!
-  "three facts same functor"
-  (len (pl-db-lookup pl-db-t1 "foo/1"))
-  3)
-(pl-db-test!
-  "mismatching key returns empty"
-  (len (pl-db-lookup pl-db-t1 "foo/2"))
-  0)
-
-(pl-db-test!
-  "first clause has arg a"
-  (pl-atom-name
-    (first (pl-args (nth (first (pl-db-lookup pl-db-t1 "foo/1")) 1))))
-  "a")
-
-(pl-db-test!
-  "third clause has arg c"
-  (pl-atom-name
-    (first (pl-args (nth (nth (pl-db-lookup pl-db-t1 "foo/1") 2) 1))))
-  "c")
-
-(define pl-db-t2 (pl-mk-db))
-(pl-db-load! pl-db-t2 (pl-parse "foo. bar. foo. parent(a, b). parent(c, d)."))
-
-(pl-db-test!
-  "atom heads keyed as foo/0"
-  (len (pl-db-lookup pl-db-t2 "foo/0"))
-  2)
-(pl-db-test!
-  "atom heads keyed as bar/0"
-  (len (pl-db-lookup pl-db-t2 "bar/0"))
-  1)
-(pl-db-test!
-  "compound heads keyed as parent/2"
-  (len (pl-db-lookup pl-db-t2 "parent/2"))
-  2)
-
-(pl-db-test!
-  "lookup-goal extracts functor/arity"
-  (len
-    (pl-db-lookup-goal pl-db-t2 (nth (first (pl-parse "parent(X, Y).")) 1)))
-  2)
-
-(pl-db-test!
-  "lookup-goal on atom goal"
-  (len (pl-db-lookup-goal pl-db-t2 (nth (first (pl-parse "foo.")) 1)))
-  2)
-
-(pl-db-test!
-  "stored clause is clause form"
-  (first (first (pl-db-lookup pl-db-t2 "parent/2")))
-  "clause")
-
-(define pl-clausedb-tests-run! (fn () {:failed pl-db-test-fail :passed pl-db-test-pass :total pl-db-test-count :failures pl-db-test-failures}))

lib/prolog/tests/compiler.sx

@@ -1,185 +0,0 @@
-;; lib/prolog/tests/compiler.sx — compiled clause dispatch tests
-
-(define pl-cmp-test-count 0)
-(define pl-cmp-test-pass 0)
-(define pl-cmp-test-fail 0)
-(define pl-cmp-test-failures (list))
-
-(define
-  pl-cmp-test!
-  (fn
-    (name got expected)
-    (set! pl-cmp-test-count (+ pl-cmp-test-count 1))
-    (if
-      (= got expected)
-      (set! pl-cmp-test-pass (+ pl-cmp-test-pass 1))
-      (begin
-        (set! pl-cmp-test-fail (+ pl-cmp-test-fail 1))
-        (append! pl-cmp-test-failures name)))))
-
-;; Load src, compile, return DB.
-(define
-  pl-cmp-mk
-  (fn
-    (src)
-    (let
-      ((db (pl-mk-db)))
-      (pl-db-load! db (pl-parse src))
-      (pl-compile-db! db)
-      db)))
-
-;; Run goal string against compiled DB; return bool (instantiates vars).
-(define
-  pl-cmp-once
-  (fn
-    (db src)
-    (pl-solve-once!
-      db
-      (pl-instantiate (pl-parse-goal src) {})
-      (pl-mk-trail))))
-
-;; Count solutions for goal string against compiled DB.
-(define
-  pl-cmp-count
-  (fn
-    (db src)
-    (pl-solve-count!
-      db
-      (pl-instantiate (pl-parse-goal src) {})
-      (pl-mk-trail))))
-
-;; ── 1. Simple facts ──────────────────────────────────────────────
-
-(define pl-cmp-db1 (pl-cmp-mk "color(red). color(green). color(blue)."))
-
-(pl-cmp-test! "compiled fact hit" (pl-cmp-once pl-cmp-db1 "color(red)") true)
-(pl-cmp-test!
-  "compiled fact miss"
-  (pl-cmp-once pl-cmp-db1 "color(yellow)")
-  false)
-(pl-cmp-test! "compiled fact count" (pl-cmp-count pl-cmp-db1 "color(X)") 3)
-
-;; ── 2. Recursive rule: append ────────────────────────────────────
-
-(define
-  pl-cmp-db2
-  (pl-cmp-mk "append([], L, L). append([H|T], L, [H|R]) :- append(T, L, R)."))
-
-(pl-cmp-test!
-  "compiled append build"
-  (pl-cmp-once pl-cmp-db2 "append([1,2],[3],[1,2,3])")
-  true)
-(pl-cmp-test!
-  "compiled append fail"
-  (pl-cmp-once pl-cmp-db2 "append([1,2],[3],[1,2])")
-  false)
-(pl-cmp-test!
-  "compiled append split count"
-  (pl-cmp-count pl-cmp-db2 "append(X, Y, [a,b])")
-  3)
-
-;; ── 3. Cut ───────────────────────────────────────────────────────
-
-(define
-  pl-cmp-db3
-  (pl-cmp-mk "first(X, [X|_]) :- !. first(X, [_|T]) :- first(X, T)."))
-
-(pl-cmp-test!
-  "compiled cut: only one solution"
-  (pl-cmp-count pl-cmp-db3 "first(X, [a,b,c])")
-  1)
-
-(let
-  ((db pl-cmp-db3) (trail (pl-mk-trail)) (env {}))
-  (let
-    ((x (pl-mk-rt-var "X")))
-    (dict-set! env "X" x)
-    (pl-solve-once!
-      db
-      (pl-instantiate (pl-parse-goal "first(X, [a,b,c])") env)
-      trail)
-    (pl-cmp-test!
-      "compiled cut: correct binding"
-      (pl-atom-name (pl-walk x))
-      "a")))
-
-;; ── 4. member ────────────────────────────────────────────────────
-
-(define
-  pl-cmp-db4
-  (pl-cmp-mk "member(X, [X|_]). member(X, [_|T]) :- member(X, T)."))
-
-(pl-cmp-test!
-  "compiled member hit"
-  (pl-cmp-once pl-cmp-db4 "member(b, [a,b,c])")
-  true)
-(pl-cmp-test!
-  "compiled member miss"
-  (pl-cmp-once pl-cmp-db4 "member(d, [a,b,c])")
-  false)
-(pl-cmp-test!
-  "compiled member count"
-  (pl-cmp-count pl-cmp-db4 "member(X, [a,b,c])")
-  3)
-
-;; ── 5. Arithmetic in body ────────────────────────────────────────
-
-(define pl-cmp-db5 (pl-cmp-mk "double(X, Y) :- Y is X * 2."))
-
-(let
-  ((db pl-cmp-db5) (trail (pl-mk-trail)) (env {}))
-  (let
-    ((y (pl-mk-rt-var "Y")))
-    (dict-set! env "Y" y)
-    (pl-solve-once!
-      db
-      (pl-instantiate (pl-parse-goal "double(5, Y)") env)
-      trail)
-    (pl-cmp-test! "compiled arithmetic in body" (pl-num-val (pl-walk y)) 10)))
-
-;; ── 6. Transitive ancestor ───────────────────────────────────────
-
-(define
-  pl-cmp-db6
-  (pl-cmp-mk
-    (str
-      "parent(a,b). parent(b,c). parent(c,d)."
-      "ancestor(X,Y) :- parent(X,Y)."
-      "ancestor(X,Y) :- parent(X,Z), ancestor(Z,Y).")))
-
-(pl-cmp-test!
-  "compiled ancestor direct"
-  (pl-cmp-once pl-cmp-db6 "ancestor(a,b)")
-  true)
-(pl-cmp-test!
-  "compiled ancestor 3-step"
-  (pl-cmp-once pl-cmp-db6 "ancestor(a,d)")
-  true)
-(pl-cmp-test!
-  "compiled ancestor fail"
-  (pl-cmp-once pl-cmp-db6 "ancestor(d,a)")
-  false)
-
-;; ── 7. Fallback: uncompiled predicate calls compiled sub-predicate
-
-(define
-  pl-cmp-db7
-  (let
-    ((db (pl-mk-db)))
-    (pl-db-load! db (pl-parse "q(1). q(2)."))
-    (pl-compile-db! db)
-    (pl-db-load! db (pl-parse "r(X) :- q(X)."))
-    db))
-
-(pl-cmp-test!
-  "uncompiled predicate resolves"
-  (pl-cmp-once pl-cmp-db7 "r(1)")
-  true)
-(pl-cmp-test!
-  "uncompiled calls compiled sub-pred count"
-  (pl-cmp-count pl-cmp-db7 "r(X)")
-  2)
-
-;; ── Runner ───────────────────────────────────────────────────────
-
-(define pl-compiler-tests-run! (fn () {:failed pl-cmp-test-fail :passed pl-cmp-test-pass :total pl-cmp-test-count :failures pl-cmp-test-failures}))

lib/prolog/tests/cross_validate.sx

@@ -1,86 +0,0 @@
-;; lib/prolog/tests/cross_validate.sx
-;; Verifies that the compiled solver produces the same solution counts as the
-;; interpreter for each classic program + built-in exercise.
-;; Interpreter is the reference: if they disagree, the compiler is wrong.
-
-(define pl-xv-test-count 0)
-(define pl-xv-test-pass 0)
-(define pl-xv-test-fail 0)
-(define pl-xv-test-failures (list))
-
-(define
-  pl-xv-test!
-  (fn
-    (name got expected)
-    (set! pl-xv-test-count (+ pl-xv-test-count 1))
-    (if
-      (= got expected)
-      (set! pl-xv-test-pass (+ pl-xv-test-pass 1))
-      (begin
-        (set! pl-xv-test-fail (+ pl-xv-test-fail 1))
-        (append! pl-xv-test-failures name)))))
-
-;; Shorthand: assert compiled result matches interpreter.
-(define
-  pl-xv-match!
-  (fn
-    (name src goal)
-    (pl-xv-test! name (pl-compiled-matches-interp? src goal) true)))
-
-;; ── 1. append/3 ─────────────────────────────────────────────────
-
-(define
-  pl-xv-append
-  "append([], L, L). append([H|T], L, [H|R]) :- append(T, L, R).")
-
-(pl-xv-match! "append build 2+2" pl-xv-append "append([1,2],[3,4],X)")
-(pl-xv-match! "append split [a,b,c]" pl-xv-append "append(X, Y, [a,b,c])")
-(pl-xv-match! "append member-mode" pl-xv-append "append(_, [3], [1,2,3])")
-
-;; ── 2. member/2 ─────────────────────────────────────────────────
-
-(define pl-xv-member "member(X, [X|_]). member(X, [_|T]) :- member(X, T).")
-
-(pl-xv-match! "member check hit" pl-xv-member "member(b, [a,b,c])")
-(pl-xv-match! "member count" pl-xv-member "member(X, [a,b,c])")
-(pl-xv-match! "member empty" pl-xv-member "member(X, [])")
-
-;; ── 3. facts + transitive rules ─────────────────────────────────
-
-(define
-  pl-xv-ancestor
-  (str
-    "parent(a,b). parent(b,c). parent(c,d). parent(a,c)."
-    "ancestor(X,Y) :- parent(X,Y)."
-    "ancestor(X,Y) :- parent(X,Z), ancestor(Z,Y)."))
-
-(pl-xv-match! "ancestor direct" pl-xv-ancestor "ancestor(a,b)")
-(pl-xv-match! "ancestor transitive" pl-xv-ancestor "ancestor(a,d)")
-(pl-xv-match! "ancestor all from a" pl-xv-ancestor "ancestor(a,Y)")
-
-;; ── 4. cut semantics ────────────────────────────────────────────
-
-(define pl-xv-cut "first(X,[X|_]) :- !. first(X,[_|T]) :- first(X,T).")
-
-(pl-xv-match! "cut one solution" pl-xv-cut "first(X,[a,b,c])")
-(pl-xv-match! "cut empty list" pl-xv-cut "first(X,[])")
-
-;; ── 5. arithmetic ───────────────────────────────────────────────
-
-(define pl-xv-arith "sq(X,Y) :- Y is X * X. even(X) :- 0 is X mod 2.")
-
-(pl-xv-match! "sq(3,Y) count" pl-xv-arith "sq(3,Y)")
-(pl-xv-match! "sq(3,9) check" pl-xv-arith "sq(3,9)")
-(pl-xv-match! "even(4) check" pl-xv-arith "even(4)")
-(pl-xv-match! "even(3) check" pl-xv-arith "even(3)")
-
-;; ── 6. if-then-else ─────────────────────────────────────────────
-
-(define pl-xv-ite "classify(X, pos) :- X > 0, !. classify(_, nonpos).")
-
-(pl-xv-match! "classify positive" pl-xv-ite "classify(5, C)")
-(pl-xv-match! "classify zero" pl-xv-ite "classify(0, C)")
-
-;; ── Runner ───────────────────────────────────────────────────────
-
-(define pl-cross-validate-tests-run! (fn () {:failed pl-xv-test-fail :passed pl-xv-test-pass :total pl-xv-test-count :failures pl-xv-test-failures}))

lib/prolog/tests/dynamic.sx

@@ -1,158 +0,0 @@
-;; lib/prolog/tests/dynamic.sx — assert/asserta/assertz/retract.
-
-(define pl-dy-test-count 0)
-(define pl-dy-test-pass 0)
-(define pl-dy-test-fail 0)
-(define pl-dy-test-failures (list))
-
-(define
-  pl-dy-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-dy-test-count (+ pl-dy-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-dy-test-pass (+ pl-dy-test-pass 1))
-        (begin
-          (set! pl-dy-test-fail (+ pl-dy-test-fail 1))
-          (append!
-            pl-dy-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-dy-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-;; assertz then query
-(define pl-dy-db1 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db1
-  (pl-dy-goal "assertz(foo(1))" {})
-  (pl-mk-trail))
-(pl-dy-test!
-  "assertz(foo(1)) + foo(1)"
-  (pl-solve-once! pl-dy-db1 (pl-dy-goal "foo(1)" {}) (pl-mk-trail))
-  true)
-
-(pl-dy-test!
-  "after one assertz, foo/1 has 1 clause"
-  (pl-solve-count! pl-dy-db1 (pl-dy-goal "foo(X)" {}) (pl-mk-trail))
-  1)
-
-;; assertz appends — order preserved
-(define pl-dy-db2 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db2
-  (pl-dy-goal "assertz(p(1))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-dy-db2
-  (pl-dy-goal "assertz(p(2))" {})
-  (pl-mk-trail))
-(pl-dy-test!
-  "assertz twice — count 2"
-  (pl-solve-count! pl-dy-db2 (pl-dy-goal "p(X)" {}) (pl-mk-trail))
-  2)
-
-(define pl-dy-env-a {})
-(pl-solve-once! pl-dy-db2 (pl-dy-goal "p(X)" pl-dy-env-a) (pl-mk-trail))
-(pl-dy-test!
-  "assertz: first solution is the first asserted (1)"
-  (pl-num-val (pl-walk-deep (dict-get pl-dy-env-a "X")))
-  1)
-
-;; asserta prepends
-(define pl-dy-db3 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db3
-  (pl-dy-goal "assertz(p(1))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-dy-db3
-  (pl-dy-goal "asserta(p(99))" {})
-  (pl-mk-trail))
-(define pl-dy-env-b {})
-(pl-solve-once! pl-dy-db3 (pl-dy-goal "p(X)" pl-dy-env-b) (pl-mk-trail))
-(pl-dy-test!
-  "asserta: prepended clause is first solution"
-  (pl-num-val (pl-walk-deep (dict-get pl-dy-env-b "X")))
-  99)
-
-;; assert/1 = assertz/1
-(define pl-dy-db4 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db4
-  (pl-dy-goal "assert(g(7))" {})
-  (pl-mk-trail))
-(pl-dy-test!
-  "assert/1 alias"
-  (pl-solve-once! pl-dy-db4 (pl-dy-goal "g(7)" {}) (pl-mk-trail))
-  true)
-
-;; retract removes a fact
-(define pl-dy-db5 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db5
-  (pl-dy-goal "assertz(q(1))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-dy-db5
-  (pl-dy-goal "assertz(q(2))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-dy-db5
-  (pl-dy-goal "assertz(q(3))" {})
-  (pl-mk-trail))
-(pl-dy-test!
-  "before retract: 3 clauses"
-  (pl-solve-count! pl-dy-db5 (pl-dy-goal "q(X)" {}) (pl-mk-trail))
-  3)
-(pl-solve-once!
-  pl-dy-db5
-  (pl-dy-goal "retract(q(2))" {})
-  (pl-mk-trail))
-(pl-dy-test!
-  "after retract(q(2)): 2 clauses left"
-  (pl-solve-count! pl-dy-db5 (pl-dy-goal "q(X)" {}) (pl-mk-trail))
-  2)
-
-(define pl-dy-env-c {})
-(pl-solve-once! pl-dy-db5 (pl-dy-goal "q(X)" pl-dy-env-c) (pl-mk-trail))
-(pl-dy-test!
-  "after retract(q(2)): first remaining is 1"
-  (pl-num-val (pl-walk-deep (dict-get pl-dy-env-c "X")))
-  1)
-
-;; retract of non-existent
-(pl-dy-test!
-  "retract(missing(0)) on empty db fails"
-  (pl-solve-once!
-    (pl-mk-db)
-    (pl-dy-goal "retract(missing(0))" {})
-    (pl-mk-trail))
-  false)
-
-;; retract with unbound var matches first
-(define pl-dy-db6 (pl-mk-db))
-(pl-solve-once!
-  pl-dy-db6
-  (pl-dy-goal "assertz(r(11))" {})
-  (pl-mk-trail))
-(pl-solve-once!
-  pl-dy-db6
-  (pl-dy-goal "assertz(r(22))" {})
-  (pl-mk-trail))
-(define pl-dy-env-d {})
-(pl-solve-once!
-  pl-dy-db6
-  (pl-dy-goal "retract(r(X))" pl-dy-env-d)
-  (pl-mk-trail))
-(pl-dy-test!
-  "retract(r(X)) binds X to first match"
-  (pl-num-val (pl-walk-deep (dict-get pl-dy-env-d "X")))
-  11)
-
-(define pl-dynamic-tests-run! (fn () {:failed pl-dy-test-fail :passed pl-dy-test-pass :total pl-dy-test-count :failures pl-dy-test-failures}))

lib/prolog/tests/findall.sx

@@ -1,167 +0,0 @@
-;; lib/prolog/tests/findall.sx — findall/3, bagof/3, setof/3.
-
-(define pl-fb-test-count 0)
-(define pl-fb-test-pass 0)
-(define pl-fb-test-fail 0)
-(define pl-fb-test-failures (list))
-
-(define
-  pl-fb-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-fb-test-count (+ pl-fb-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-fb-test-pass (+ pl-fb-test-pass 1))
-        (begin
-          (set! pl-fb-test-fail (+ pl-fb-test-fail 1))
-          (append!
-            pl-fb-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-fb-term-to-sx
-  (fn
-    (t)
-    (cond
-      ((pl-num? t) (pl-num-val t))
-      ((pl-atom? t) (pl-atom-name t))
-      (true (list :complex)))))
-
-(define
-  pl-fb-list-walked
-  (fn
-    (w)
-    (cond
-      ((and (pl-atom? w) (= (pl-atom-name w) "[]")) (list))
-      ((and (pl-compound? w) (= (pl-fun w) ".") (= (len (pl-args w)) 2))
-        (cons
-          (pl-fb-term-to-sx (first (pl-args w)))
-          (pl-fb-list-walked (nth (pl-args w) 1))))
-      (true (list :not-list)))))
-
-(define pl-fb-list-to-sx (fn (t) (pl-fb-list-walked (pl-walk-deep t))))
-
-(define
-  pl-fb-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-fb-prog-src "member(X, [X|_]). member(X, [_|T]) :- member(X, T).")
-
-(define pl-fb-db (pl-mk-db))
-(pl-db-load! pl-fb-db (pl-parse pl-fb-prog-src))
-
-;; ── findall ──
-
-(define pl-fb-env-1 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "findall(X, member(X, [a, b, c]), L)" pl-fb-env-1)
-  (pl-mk-trail))
-(pl-fb-test!
-  "findall member [a, b, c]"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-1 "L"))
-  (list "a" "b" "c"))
-
-(define pl-fb-env-2 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "findall(X, (member(X, [1, 2, 3]), X >= 2), L)" pl-fb-env-2)
-  (pl-mk-trail))
-(pl-fb-test!
-  "findall with comparison filter"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-2 "L"))
-  (list 2 3))
-
-(define pl-fb-env-3 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "findall(X, fail, L)" pl-fb-env-3)
-  (pl-mk-trail))
-(pl-fb-test!
-  "findall on fail succeeds with empty list"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-3 "L"))
-  (list))
-
-(pl-fb-test!
-  "findall(X, fail, L) the goal succeeds"
-  (pl-solve-once!
-    pl-fb-db
-    (pl-fb-goal "findall(X, fail, L)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-fb-env-4 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal
-    "findall(p(X, Y), (member(X, [1, 2]), member(Y, [a, b])), L)"
-    pl-fb-env-4)
-  (pl-mk-trail))
-(pl-fb-test!
-  "findall over compound template — count = 4"
-  (len (pl-fb-list-to-sx (dict-get pl-fb-env-4 "L")))
-  4)
-
-;; ── bagof ──
-
-(pl-fb-test!
-  "bagof succeeds when results exist"
-  (pl-solve-once!
-    pl-fb-db
-    (pl-fb-goal "bagof(X, member(X, [1, 2, 3]), L)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-fb-test!
-  "bagof fails on empty"
-  (pl-solve-once!
-    pl-fb-db
-    (pl-fb-goal "bagof(X, fail, L)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-fb-env-5 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "bagof(X, member(X, [c, a, b]), L)" pl-fb-env-5)
-  (pl-mk-trail))
-(pl-fb-test!
-  "bagof preserves order"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-5 "L"))
-  (list "c" "a" "b"))
-
-;; ── setof ──
-
-(define pl-fb-env-6 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "setof(X, member(X, [c, a, b, a, c]), L)" pl-fb-env-6)
-  (pl-mk-trail))
-(pl-fb-test!
-  "setof sorts + dedupes atoms"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-6 "L"))
-  (list "a" "b" "c"))
-
-(pl-fb-test!
-  "setof fails on empty"
-  (pl-solve-once!
-    pl-fb-db
-    (pl-fb-goal "setof(X, fail, L)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-fb-env-7 {})
-(pl-solve-once!
-  pl-fb-db
-  (pl-fb-goal "setof(X, member(X, [3, 1, 2, 1, 3]), L)" pl-fb-env-7)
-  (pl-mk-trail))
-(pl-fb-test!
-  "setof sorts + dedupes nums"
-  (pl-fb-list-to-sx (dict-get pl-fb-env-7 "L"))
-  (list 1 2 3))
-
-(define pl-findall-tests-run! (fn () {:failed pl-fb-test-fail :passed pl-fb-test-pass :total pl-fb-test-count :failures pl-fb-test-failures}))

lib/prolog/tests/hs_bridge.sx

@@ -1,165 +0,0 @@
-;; lib/prolog/tests/hs_bridge.sx — tests for Prolog↔Hyperscript bridge
-;;
-;; Verifies pl-hs-query, pl-hs-predicate/N, and pl-hs-install.
-;; Also demonstrates the end-to-end DSL pattern:
-;;   (define allowed (pl-hs-predicate/2 db "allowed"))
-;;   → (allowed "alice" "edit") is what Hyperscript compiles
-;;     `when allowed(alice, edit)` to.
-
-(define pl-hsb-test-count 0)
-(define pl-hsb-test-pass 0)
-(define pl-hsb-test-fail 0)
-(define pl-hsb-test-failures (list))
-
-(define
-  pl-hsb-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-hsb-test-count (+ pl-hsb-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-hsb-test-pass (+ pl-hsb-test-pass 1))
-        (begin
-          (set! pl-hsb-test-fail (+ pl-hsb-test-fail 1))
-          (append!
-            pl-hsb-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-;; ── shared KB ──
-
-(define
-  pl-hsb-perm-src
-  "role(alice, admin). role(bob, editor). role(charlie, viewer). permission(admin, read). permission(admin, write). permission(admin, delete). permission(editor, read). permission(editor, write). permission(viewer, read). allowed(U, A) :- role(U, R), permission(R, A).")
-
-(define pl-hsb-db (pl-load pl-hsb-perm-src))
-
-;; ── pl-hs-query ──
-
-(pl-hsb-test!
-  "pl-hs-query: ground fact succeeds"
-  (pl-hs-query pl-hsb-db "role(alice, admin)")
-  true)
-
-(pl-hsb-test!
-  "pl-hs-query: absent fact fails"
-  (pl-hs-query pl-hsb-db "role(alice, viewer)")
-  false)
-
-(pl-hsb-test!
-  "pl-hs-query: rule derivation succeeds"
-  (pl-hs-query pl-hsb-db "allowed(alice, delete)")
-  true)
-
-(pl-hsb-test!
-  "pl-hs-query: rule derivation fails"
-  (pl-hs-query pl-hsb-db "allowed(charlie, delete)")
-  false)
-
-(pl-hsb-test!
-  "pl-hs-query: arithmetic goal"
-  (pl-hs-query pl-hsb-db "X is 3 + 4, X = 7")
-  true)
-
-;; ── pl-hs-predicate/2 ──
-
-(define pl-hsb-allowed (pl-hs-predicate/2 pl-hsb-db "allowed"))
-
-(pl-hsb-test!
-  "predicate/2: alice can read"
-  (pl-hsb-allowed "alice" "read")
-  true)
-
-(pl-hsb-test!
-  "predicate/2: alice can delete"
-  (pl-hsb-allowed "alice" "delete")
-  true)
-
-(pl-hsb-test!
-  "predicate/2: charlie cannot write"
-  (pl-hsb-allowed "charlie" "write")
-  false)
-
-(pl-hsb-test!
-  "predicate/2: bob can write"
-  (pl-hsb-allowed "bob" "write")
-  true)
-
-(pl-hsb-test!
-  "predicate/2: unknown user fails"
-  (pl-hsb-allowed "eve" "read")
-  false)
-
-;; ── DSL simulation ──
-;; Hyperscript compiles `when allowed(user, action) then …`
-;; to `(allowed user action)` — a direct SX function call.
-;; Here we verify that pattern works end-to-end.
-
-(define pl-hsb-user "alice")
-(define pl-hsb-action "write")
-
-(pl-hsb-test!
-  "DSL simulation: (allowed user action) true path"
-  (pl-hsb-allowed pl-hsb-user pl-hsb-action)
-  true)
-
-(define pl-hsb-user2 "charlie")
-
-(pl-hsb-test!
-  "DSL simulation: (allowed user action) false path"
-  (pl-hsb-allowed pl-hsb-user2 pl-hsb-action)
-  false)
-
-;; ── pl-hs-predicate/1 ──
-
-(define pl-hsb-viewer-src "color(red). color(green). color(blue).")
-(define pl-hsb-color-db (pl-load pl-hsb-viewer-src))
-(define pl-hsb-color? (pl-hs-predicate/1 pl-hsb-color-db "color"))
-
-(pl-hsb-test! "predicate/1: color(red) succeeds" (pl-hsb-color? "red") true)
-
-(pl-hsb-test!
-  "predicate/1: color(purple) fails"
-  (pl-hsb-color? "purple")
-  false)
-
-;; ── pl-hs-predicate/3 ──
-
-(define pl-hsb-3ary-src "between_vals(X, Lo, Hi) :- X >= Lo, X =< Hi.")
-(define pl-hsb-3ary-db (pl-load pl-hsb-3ary-src))
-(define pl-hsb-in-range? (pl-hs-predicate/3 pl-hsb-3ary-db "between_vals"))
-
-(pl-hsb-test!
-  "predicate/3: 5 in range [1,10]"
-  (pl-hsb-in-range? "5" "1" "10")
-  true)
-
-(pl-hsb-test!
-  "predicate/3: 15 not in range [1,10]"
-  (pl-hsb-in-range? "15" "1" "10")
-  false)
-
-;; ── pl-hs-install ──
-
-(define
-  pl-hsb-installed
-  (pl-hs-install
-    pl-hsb-db
-    (list (list "allowed" 2) (list "role" 2) (list "permission" 2))))
-
-(pl-hsb-test!
-  "pl-hs-install: returns dict with allowed key"
-  (not (nil? (dict-get pl-hsb-installed "allowed")))
-  true)
-
-(pl-hsb-test!
-  "pl-hs-install: installed allowed fn works"
-  ((dict-get pl-hsb-installed "allowed") "alice" "delete")
-  true)
-
-(pl-hsb-test!
-  "pl-hs-install: installed role fn works"
-  ((dict-get pl-hsb-installed "role") "bob" "editor")
-  true)
-
-(define pl-hs-bridge-tests-run! (fn () {:failed pl-hsb-test-fail :passed pl-hsb-test-pass :total pl-hsb-test-count :failures pl-hsb-test-failures}))

lib/prolog/tests/integration.sx

@@ -1,172 +0,0 @@
-;; lib/prolog/tests/integration.sx — end-to-end integration tests via pl-query-* API
-;;
-;; Tests the full source→parse→load→solve pipeline with real programs.
-;; Covers: permission system, graph reachability, quicksort, fibonacci, dynamic KB.
-
-(define pl-int-test-count 0)
-(define pl-int-test-pass 0)
-(define pl-int-test-fail 0)
-(define pl-int-test-failures (list))
-
-(define
-  pl-int-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-int-test-count (+ pl-int-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-int-test-pass (+ pl-int-test-pass 1))
-        (begin
-          (set! pl-int-test-fail (+ pl-int-test-fail 1))
-          (append!
-            pl-int-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-;; ── Permission system ──
-;; role/2 + permission/2 facts, allowed/2 rule
-
-(define
-  pl-int-perm-src
-  "role(alice, admin). role(bob, editor). role(charlie, viewer). permission(admin, read). permission(admin, write). permission(admin, delete). permission(editor, read). permission(editor, write). permission(viewer, read). allowed(U, A) :- role(U, R), permission(R, A).")
-
-(define pl-int-perm-db (pl-load pl-int-perm-src))
-
-(pl-int-test!
-  "alice can read"
-  (len (pl-query-all pl-int-perm-db "allowed(alice, read)"))
-  1)
-
-(pl-int-test!
-  "alice can delete"
-  (len (pl-query-all pl-int-perm-db "allowed(alice, delete)"))
-  1)
-
-(pl-int-test!
-  "charlie cannot write"
-  (len (pl-query-all pl-int-perm-db "allowed(charlie, write)"))
-  0)
-
-(pl-int-test!
-  "alice has 3 permissions"
-  (len (pl-query-all pl-int-perm-db "allowed(alice, A)"))
-  3)
-
-(pl-int-test!
-  "only one user can delete"
-  (len (pl-query-all pl-int-perm-db "allowed(U, delete)"))
-  1)
-
-(pl-int-test!
-  "the deleter is alice"
-  (dict-get (first (pl-query-all pl-int-perm-db "allowed(U, delete)")) "U")
-  "alice")
-
-;; ── Graph reachability ──
-;; Directed edges; path/2 transitive closure via two clauses
-
-(define
-  pl-int-graph-src
-  "edge(a, b). edge(b, c). edge(c, d). edge(b, d). path(X, Y) :- edge(X, Y). path(X, Y) :- edge(X, Z), path(Z, Y).")
-
-(define pl-int-graph-db (pl-load pl-int-graph-src))
-
-(pl-int-test!
-  "direct edge a→b is a path"
-  (len (pl-query-all pl-int-graph-db "path(a, b)"))
-  1)
-
-(pl-int-test!
-  "transitive path a→c"
-  (len (pl-query-all pl-int-graph-db "path(a, c)"))
-  1)
-
-(pl-int-test!
-  "no path d→a (no back-edges)"
-  (len (pl-query-all pl-int-graph-db "path(d, a)"))
-  0)
-
-(pl-int-test!
-  "4 derivations from a (b,c,d via two routes to d)"
-  (len (pl-query-all pl-int-graph-db "path(a, Y)"))
-  4)
-
-;; ── Quicksort ──
-;; Partition-and-recurse; uses its own append/3 to avoid DB pollution
-
-(define
-  pl-int-qs-src
-  "partition(_, [], [], []). partition(Piv, [H|T], [H|Less], Greater) :- H =< Piv, !, partition(Piv, T, Less, Greater). partition(Piv, [H|T], Less, [H|Greater]) :- partition(Piv, T, Less, Greater). append([], L, L). append([H|T], L, [H|R]) :- append(T, L, R). quicksort([], []). quicksort([H|T], Sorted) :- partition(H, T, Less, Greater), quicksort(Less, SL), quicksort(Greater, SG), append(SL, [H|SG], Sorted).")
-
-(define pl-int-qs-db (pl-load pl-int-qs-src))
-
-(pl-int-test!
-  "quicksort([]) = [] (ground check)"
-  (len (pl-query-all pl-int-qs-db "quicksort([], [])"))
-  1)
-
-(pl-int-test!
-  "quicksort([3,1,2]) = [1,2,3] (ground check)"
-  (len (pl-query-all pl-int-qs-db "quicksort([3,1,2], [1,2,3])"))
-  1)
-
-(pl-int-test!
-  "quicksort([5,3,1,4,2]) = [1,2,3,4,5] (ground check)"
-  (len (pl-query-all pl-int-qs-db "quicksort([5,3,1,4,2], [1,2,3,4,5])"))
-  1)
-
-(pl-int-test!
-  "quicksort([3,1,2], [3,1,2]) fails — unsorted order rejected"
-  (len (pl-query-all pl-int-qs-db "quicksort([3,1,2], [3,1,2])"))
-  0)
-
-;; ── Fibonacci ──
-;; Naive recursive; ground checks avoid list-format uncertainty
-
-(define
-  pl-int-fib-src
-  "fib(0, 0). fib(1, 1). fib(N, F) :- N > 1, N1 is N - 1, N2 is N - 2, fib(N1, F1), fib(N2, F2), F is F1 + F2.")
-
-(define pl-int-fib-db (pl-load pl-int-fib-src))
-
-(pl-int-test!
-  "fib(0, 0) succeeds"
-  (len (pl-query-all pl-int-fib-db "fib(0, 0)"))
-  1)
-
-(pl-int-test!
-  "fib(5, 5) succeeds"
-  (len (pl-query-all pl-int-fib-db "fib(5, 5)"))
-  1)
-
-(pl-int-test!
-  "fib(7, 13) succeeds"
-  (len (pl-query-all pl-int-fib-db "fib(7, 13)"))
-  1)
-
-;; ── Dynamic knowledge base ──
-;; Assert and retract facts; the DB dict is mutable so mutations persist
-
-(define pl-int-dyn-src "color(red). color(green). color(blue).")
-(define pl-int-dyn-db (pl-load pl-int-dyn-src))
-
-(pl-int-test!
-  "initial KB: 3 colors"
-  (len (pl-query-all pl-int-dyn-db "color(X)"))
-  3)
-
-(pl-int-test!
-  "after assert(color(yellow)): 4 colors"
-  (begin
-    (pl-query-all pl-int-dyn-db "assert(color(yellow))")
-    (len (pl-query-all pl-int-dyn-db "color(X)")))
-  4)
-
-(pl-int-test!
-  "after retract(color(red)): back to 3 colors"
-  (begin
-    (pl-query-all pl-int-dyn-db "retract(color(red))")
-    (len (pl-query-all pl-int-dyn-db "color(X)")))
-  3)
-
-(define pl-integration-tests-run! (fn () {:failed pl-int-test-fail :passed pl-int-test-pass :total pl-int-test-count :failures pl-int-test-failures}))

lib/prolog/tests/io_predicates.sx

@@ -1,326 +0,0 @@
-;; lib/prolog/tests/io_predicates.sx — term_to_atom/2, term_string/2,
-;;   with_output_to/2, writeln/1, format/1, format/2
-
-(define pl-io-test-count 0)
-(define pl-io-test-pass 0)
-(define pl-io-test-fail 0)
-(define pl-io-test-failures (list))
-
-(define
-  pl-io-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-io-test-count (+ pl-io-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-io-test-pass (+ pl-io-test-pass 1))
-        (begin
-          (set! pl-io-test-fail (+ pl-io-test-fail 1))
-          (append!
-            pl-io-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-io-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-io-db (pl-mk-db))
-
-;; helper: get output buffer after running a goal
-(define
-  pl-io-capture!
-  (fn
-    (goal)
-    (do
-      (pl-output-clear!)
-      (pl-solve-once! pl-io-db goal (pl-mk-trail))
-      pl-output-buffer)))
-
-;; ─── term_to_atom/2 — bound Term direction ─────────────────────────────────
-
-(pl-io-test!
-  "term_to_atom(foo(a,b), A) — compound"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_to_atom(foo(a,b), A)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "A"))))
-  "foo(a, b)")
-
-(pl-io-test!
-  "term_to_atom(hello, A) — atom"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_to_atom(hello, A)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "A"))))
-  "hello")
-
-(pl-io-test!
-  "term_to_atom(42, A) — number"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_to_atom(42, A)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "A"))))
-  "42")
-
-(pl-io-test!
-  "term_to_atom(foo(a,b), 'foo(a, b)') — succeeds when Atom matches"
-  (pl-solve-once!
-    pl-io-db
-    (pl-io-goal "term_to_atom(foo(a,b), 'foo(a, b)')" {})
-    (pl-mk-trail))
-  true)
-
-(pl-io-test!
-  "term_to_atom(hello, world) — fails on mismatch"
-  (pl-solve-once!
-    pl-io-db
-    (pl-io-goal "term_to_atom(hello, world)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── term_to_atom/2 — parse direction (Atom bound, Term unbound) ───────────
-
-(pl-io-test!
-  "term_to_atom(T, 'foo(a)') — parse direction gives compound"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_to_atom(T, 'foo(a)')" env)
-      (pl-mk-trail))
-    (let
-      ((t (pl-walk-deep (dict-get env "T"))))
-      (and (pl-compound? t) (= (pl-fun t) "foo"))))
-  true)
-
-(pl-io-test!
-  "term_to_atom(T, hello) — parse direction gives atom"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_to_atom(T, hello)" env)
-      (pl-mk-trail))
-    (let
-      ((t (pl-walk-deep (dict-get env "T"))))
-      (and (pl-atom? t) (= (pl-atom-name t) "hello"))))
-  true)
-
-;; ─── term_string/2 — alias ──────────────────────────────────────────────────
-
-(pl-io-test!
-  "term_string(bar(x), A) — same as term_to_atom"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_string(bar(x), A)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "A"))))
-  "bar(x)")
-
-(pl-io-test!
-  "term_string(42, A) — number to string"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "term_string(42, A)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "A"))))
-  "42")
-
-;; ─── writeln/1 ─────────────────────────────────────────────────────────────
-
-(pl-io-test!
-  "writeln(hello) writes 'hello\n'"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), writeln(hello))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "hello
-")
-
-(pl-io-test!
-  "writeln(42) writes '42\n'"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), writeln(42))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "42
-")
-
-;; ─── with_output_to/2 ──────────────────────────────────────────────────────
-
-(pl-io-test!
-  "with_output_to(atom(X), write(foo)) — captures write output"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), write(foo))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "foo")
-
-(pl-io-test!
-  "with_output_to(atom(X), (write(a), write(b))) — concat output"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), (write(a), write(b)))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "ab")
-
-(pl-io-test!
-  "with_output_to(atom(X), nl) — captures newline"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), nl)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "
-")
-
-(pl-io-test!
-  "with_output_to(atom(X), true) — captures empty string"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), true)" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "")
-
-(pl-io-test!
-  "with_output_to(string(X), write(hello)) — string sink works"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(string(X), write(hello))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "hello")
-
-(pl-io-test!
-  "with_output_to(atom(X), fail) — fails when goal fails"
-  (pl-solve-once!
-    pl-io-db
-    (pl-io-goal "with_output_to(atom(X), fail)" {})
-    (pl-mk-trail))
-  false)
-
-;; ─── format/1 ──────────────────────────────────────────────────────────────
-
-(pl-io-test!
-  "format('hello~n') — tilde-n becomes newline"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('hello~n'))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "hello
-")
-
-(pl-io-test!
-  "format('~~') — double tilde becomes single tilde"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('~~'))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "~")
-
-(pl-io-test!
-  "format('abc') — plain text passes through"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format(abc))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "abc")
-
-;; ─── format/2 ──────────────────────────────────────────────────────────────
-
-(pl-io-test!
-  "format('~w+~w', [1,2]) — two ~w args"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('~w+~w', [1,2]))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "1+2")
-
-(pl-io-test!
-  "format('hello ~a!', [world]) — ~a with atom arg"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('hello ~a!', [world]))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "hello world!")
-
-(pl-io-test!
-  "format('n=~d', [42]) — ~d with integer arg"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('n=~d', [42]))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "n=42")
-
-(pl-io-test!
-  "format('~w', [foo(a)]) — ~w with compound"
-  (let
-    ((env {}))
-    (pl-solve-once!
-      pl-io-db
-      (pl-io-goal "with_output_to(atom(X), format('~w', [foo(a)]))" env)
-      (pl-mk-trail))
-    (pl-atom-name (pl-walk-deep (dict-get env "X"))))
-  "foo(a)")
-
-(define
-  pl-io-predicates-tests-run!
-  (fn
-    ()
-    {:failed pl-io-test-fail
-      :passed pl-io-test-pass
-      :total pl-io-test-count
-      :failures pl-io-test-failures}))

lib/prolog/tests/iso_predicates.sx

@@ -1,320 +0,0 @@
-;; lib/prolog/tests/iso_predicates.sx — succ/2, plus/3, between/3, length/2, last/2, nth0/3, nth1/3, max/min arith
-
-(define pl-ip-test-count 0)
-(define pl-ip-test-pass 0)
-(define pl-ip-test-fail 0)
-(define pl-ip-test-failures (list))
-
-(define
-  pl-ip-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-ip-test-count (+ pl-ip-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-ip-test-pass (+ pl-ip-test-pass 1))
-        (begin
-          (set! pl-ip-test-fail (+ pl-ip-test-fail 1))
-          (append!
-            pl-ip-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-ip-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-ip-db (pl-mk-db))
-
-;; ── succ/2 ──
-
-(define pl-ip-env-s1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "succ(3, X)" pl-ip-env-s1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "succ(3, X) → X=4"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-s1 "X")))
-  4)
-
-(define pl-ip-env-s2 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "succ(0, X)" pl-ip-env-s2)
-  (pl-mk-trail))
-(pl-ip-test!
-  "succ(0, X) → X=1"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-s2 "X")))
-  1)
-
-(define pl-ip-env-s3 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "succ(X, 5)" pl-ip-env-s3)
-  (pl-mk-trail))
-(pl-ip-test!
-  "succ(X, 5) → X=4"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-s3 "X")))
-  4)
-
-(pl-ip-test!
-  "succ(X, 0) fails"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "succ(X, 0)" {})
-    (pl-mk-trail))
-  false)
-
-;; ── plus/3 ──
-
-(define pl-ip-env-p1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "plus(2, 3, X)" pl-ip-env-p1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "plus(2, 3, X) → X=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-p1 "X")))
-  5)
-
-(define pl-ip-env-p2 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "plus(2, X, 7)" pl-ip-env-p2)
-  (pl-mk-trail))
-(pl-ip-test!
-  "plus(2, X, 7) → X=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-p2 "X")))
-  5)
-
-(define pl-ip-env-p3 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "plus(X, 3, 7)" pl-ip-env-p3)
-  (pl-mk-trail))
-(pl-ip-test!
-  "plus(X, 3, 7) → X=4"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-p3 "X")))
-  4)
-
-(pl-ip-test!
-  "plus(0, 0, 0) succeeds"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "plus(0, 0, 0)" {})
-    (pl-mk-trail))
-  true)
-
-;; ── between/3 ──
-
-(pl-ip-test!
-  "between(1, 3, X): 3 solutions"
-  (pl-solve-count!
-    pl-ip-db
-    (pl-ip-goal "between(1, 3, X)" {})
-    (pl-mk-trail))
-  3)
-
-(pl-ip-test!
-  "between(1, 3, 2) succeeds"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "between(1, 3, 2)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-ip-test!
-  "between(1, 3, 5) fails"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "between(1, 3, 5)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-ip-test!
-  "between(5, 3, X): 0 solutions (empty range)"
-  (pl-solve-count!
-    pl-ip-db
-    (pl-ip-goal "between(5, 3, X)" {})
-    (pl-mk-trail))
-  0)
-
-(define pl-ip-env-b1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "between(1, 5, X)" pl-ip-env-b1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "between(1, 5, X): first solution X=1"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-b1 "X")))
-  1)
-
-(pl-ip-test!
-  "between + condition: between(1,5,X), X > 3 → 2 solutions"
-  (pl-solve-count!
-    pl-ip-db
-    (pl-ip-goal "between(1, 5, X), X > 3" {})
-    (pl-mk-trail))
-  2)
-
-;; ── length/2 ──
-
-(define pl-ip-env-l1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "length([1,2,3], N)" pl-ip-env-l1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "length([1,2,3], N) → N=3"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-l1 "N")))
-  3)
-
-(define pl-ip-env-l2 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "length([], N)" pl-ip-env-l2)
-  (pl-mk-trail))
-(pl-ip-test!
-  "length([], N) → N=0"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-l2 "N")))
-  0)
-
-(pl-ip-test!
-  "length([a,b], 2) check succeeds"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "length([a,b], 2)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-ip-env-l3 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "length(L, 3)" pl-ip-env-l3)
-  (pl-mk-trail))
-(pl-ip-test!
-  "length(L, 3): L is a list of length 3"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "length(L, 3), is_list(L)" pl-ip-env-l3)
-    (pl-mk-trail))
-  true)
-
-;; ── last/2 ──
-
-(define pl-ip-env-la1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "last([1,2,3], X)" pl-ip-env-la1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "last([1,2,3], X) → X=3"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-la1 "X")))
-  3)
-
-(define pl-ip-env-la2 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "last([a], X)" pl-ip-env-la2)
-  (pl-mk-trail))
-(pl-ip-test!
-  "last([a], X) → X=a"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ip-env-la2 "X")))
-  "a")
-
-(pl-ip-test!
-  "last([], X) fails"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "last([], X)" {})
-    (pl-mk-trail))
-  false)
-
-;; ── nth0/3 ──
-
-(define pl-ip-env-n0 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "nth0(0, [a,b,c], X)" pl-ip-env-n0)
-  (pl-mk-trail))
-(pl-ip-test!
-  "nth0(0, [a,b,c], X) → X=a"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ip-env-n0 "X")))
-  "a")
-
-(define pl-ip-env-n1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "nth0(2, [a,b,c], X)" pl-ip-env-n1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "nth0(2, [a,b,c], X) → X=c"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ip-env-n1 "X")))
-  "c")
-
-(pl-ip-test!
-  "nth0(5, [a,b,c], X) fails"
-  (pl-solve-once!
-    pl-ip-db
-    (pl-ip-goal "nth0(5, [a,b,c], X)" {})
-    (pl-mk-trail))
-  false)
-
-;; ── nth1/3 ──
-
-(define pl-ip-env-n1a {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "nth1(1, [a,b,c], X)" pl-ip-env-n1a)
-  (pl-mk-trail))
-(pl-ip-test!
-  "nth1(1, [a,b,c], X) → X=a"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ip-env-n1a "X")))
-  "a")
-
-(define pl-ip-env-n1b {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "nth1(3, [a,b,c], X)" pl-ip-env-n1b)
-  (pl-mk-trail))
-(pl-ip-test!
-  "nth1(3, [a,b,c], X) → X=c"
-  (pl-atom-name (pl-walk-deep (dict-get pl-ip-env-n1b "X")))
-  "c")
-
-;; ── max/min in arithmetic ──
-
-(define pl-ip-env-m1 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "X is max(3, 5)" pl-ip-env-m1)
-  (pl-mk-trail))
-(pl-ip-test!
-  "X is max(3, 5) → X=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-m1 "X")))
-  5)
-
-(define pl-ip-env-m2 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "X is min(3, 5)" pl-ip-env-m2)
-  (pl-mk-trail))
-(pl-ip-test!
-  "X is min(3, 5) → X=3"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-m2 "X")))
-  3)
-
-(define pl-ip-env-m3 {})
-(pl-solve-once!
-  pl-ip-db
-  (pl-ip-goal "X is max(7, 2) + min(1, 4)" pl-ip-env-m3)
-  (pl-mk-trail))
-(pl-ip-test!
-  "X is max(7,2) + min(1,4) → X=8"
-  (pl-num-val (pl-walk-deep (dict-get pl-ip-env-m3 "X")))
-  8)
-
-(define pl-iso-predicates-tests-run! (fn () {:failed pl-ip-test-fail :passed pl-ip-test-pass :total pl-ip-test-count :failures pl-ip-test-failures}))

lib/prolog/tests/list_predicates.sx

@@ -1,335 +0,0 @@
-;; lib/prolog/tests/list_predicates.sx — ==/2, \==/2, flatten/2, numlist/3,
-;;   atomic_list_concat/2,3, sum_list/2, max_list/2, min_list/2, delete/3
-
-(define pl-lp-test-count 0)
-(define pl-lp-test-pass 0)
-(define pl-lp-test-fail 0)
-(define pl-lp-test-failures (list))
-
-(define
-  pl-lp-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-lp-test-count (+ pl-lp-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-lp-test-pass (+ pl-lp-test-pass 1))
-        (begin
-          (set! pl-lp-test-fail (+ pl-lp-test-fail 1))
-          (append!
-            pl-lp-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-lp-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-lp-db (pl-mk-db))
-
-;; ── ==/2 ───────────────────────────────────────────────────────────
-
-(pl-lp-test!
-  "==(a, a) succeeds"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "==(a, a)" {}) (pl-mk-trail))
-  true)
-
-(pl-lp-test!
-  "==(a, b) fails"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "==(a, b)" {}) (pl-mk-trail))
-  false)
-
-(pl-lp-test!
-  "==(1, 1) succeeds"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "==(1, 1)" {}) (pl-mk-trail))
-  true)
-
-(pl-lp-test!
-  "==(1, 2) fails"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "==(1, 2)" {}) (pl-mk-trail))
-  false)
-
-(pl-lp-test!
-  "==(f(a,b), f(a,b)) succeeds"
-  (pl-solve-once!
-    pl-lp-db
-    (pl-lp-goal "==(f(a,b), f(a,b))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-lp-test!
-  "==(f(a,b), f(a,c)) fails"
-  (pl-solve-once!
-    pl-lp-db
-    (pl-lp-goal "==(f(a,b), f(a,c))" {})
-    (pl-mk-trail))
-  false)
-
-;; unbound var vs atom: fails (different tags)
-(pl-lp-test!
-  "==(X, a) fails (unbound var vs atom)"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "==(X, a)" {}) (pl-mk-trail))
-  false)
-
-;; two unbound vars with SAME name in same env share the same runtime var
-(define pl-lp-env-same-var {})
-(pl-lp-goal "==(X, X)" pl-lp-env-same-var)
-(pl-lp-test!
-  "==(X, X) succeeds (same runtime var)"
-  (pl-solve-once!
-    pl-lp-db
-    (pl-instantiate
-      (nth (first (pl-parse "g :- ==(X, X).")) 2)
-      pl-lp-env-same-var)
-    (pl-mk-trail))
-  true)
-
-;; ── \==/2 ──────────────────────────────────────────────────────────
-
-(pl-lp-test!
-  "\\==(a, b) succeeds"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "\\==(a, b)" {}) (pl-mk-trail))
-  true)
-
-(pl-lp-test!
-  "\\==(a, a) fails"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "\\==(a, a)" {}) (pl-mk-trail))
-  false)
-
-(pl-lp-test!
-  "\\==(X, a) succeeds (unbound var differs from atom)"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "\\==(X, a)" {}) (pl-mk-trail))
-  true)
-
-(pl-lp-test!
-  "\\==(1, 2) succeeds"
-  (pl-solve-once! pl-lp-db (pl-lp-goal "\\==(1, 2)" {}) (pl-mk-trail))
-  true)
-
-;; ── flatten/2 ──────────────────────────────────────────────────────
-
-(define pl-lp-env-fl1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "flatten([], F)" pl-lp-env-fl1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "flatten([], []) -> empty"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-fl1 "F")))
-  "[]")
-
-(define pl-lp-env-fl2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "flatten([1,2,3], F)" pl-lp-env-fl2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "flatten([1,2,3], F) -> [1,2,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-fl2 "F")))
-  ".(1, .(2, .(3, [])))")
-
-(define pl-lp-env-fl3 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "flatten([1,[2,[3]],4], F)" pl-lp-env-fl3)
-  (pl-mk-trail))
-(pl-lp-test!
-  "flatten([1,[2,[3]],4], F) -> [1,2,3,4]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-fl3 "F")))
-  ".(1, .(2, .(3, .(4, []))))")
-
-(define pl-lp-env-fl4 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "flatten([[a,b],[c]], F)" pl-lp-env-fl4)
-  (pl-mk-trail))
-(pl-lp-test!
-  "flatten([[a,b],[c]], F) -> [a,b,c]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-fl4 "F")))
-  ".(a, .(b, .(c, [])))")
-
-;; ── numlist/3 ──────────────────────────────────────────────────────
-
-(define pl-lp-env-nl1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "numlist(1, 5, L)" pl-lp-env-nl1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "numlist(1,5,L) -> [1,2,3,4,5]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-nl1 "L")))
-  ".(1, .(2, .(3, .(4, .(5, [])))))")
-
-(define pl-lp-env-nl2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "numlist(3, 3, L)" pl-lp-env-nl2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "numlist(3,3,L) -> [3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-nl2 "L")))
-  ".(3, [])")
-
-(pl-lp-test!
-  "numlist(5, 3, L) fails (Low > High)"
-  (pl-solve-once!
-    pl-lp-db
-    (pl-lp-goal "numlist(5, 3, L)" {})
-    (pl-mk-trail))
-  false)
-
-;; ── atomic_list_concat/2 ───────────────────────────────────────────
-
-(define pl-lp-env-alc1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "atomic_list_concat([a, b, c], R)" pl-lp-env-alc1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "atomic_list_concat([a,b,c], R) -> abc"
-  (pl-atom-name (pl-walk-deep (dict-get pl-lp-env-alc1 "R")))
-  "abc")
-
-(define pl-lp-env-alc2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "atomic_list_concat([hello, world], R)" pl-lp-env-alc2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "atomic_list_concat([hello,world], R) -> helloworld"
-  (pl-atom-name (pl-walk-deep (dict-get pl-lp-env-alc2 "R")))
-  "helloworld")
-
-;; ── atomic_list_concat/3 ───────────────────────────────────────────
-
-(define pl-lp-env-alcs1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "atomic_list_concat([a, b, c], '-', R)" pl-lp-env-alcs1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "atomic_list_concat([a,b,c], '-', R) -> a-b-c"
-  (pl-atom-name (pl-walk-deep (dict-get pl-lp-env-alcs1 "R")))
-  "a-b-c")
-
-(define pl-lp-env-alcs2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "atomic_list_concat([x], '-', R)" pl-lp-env-alcs2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "atomic_list_concat([x], '-', R) -> x (single element, no sep)"
-  (pl-atom-name (pl-walk-deep (dict-get pl-lp-env-alcs2 "R")))
-  "x")
-
-;; ── sum_list/2 ─────────────────────────────────────────────────────
-
-(define pl-lp-env-sl1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "sum_list([1,2,3], S)" pl-lp-env-sl1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "sum_list([1,2,3], S) -> 6"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-sl1 "S")))
-  6)
-
-(define pl-lp-env-sl2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "sum_list([10], S)" pl-lp-env-sl2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "sum_list([10], S) -> 10"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-sl2 "S")))
-  10)
-
-(define pl-lp-env-sl3 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "sum_list([], S)" pl-lp-env-sl3)
-  (pl-mk-trail))
-(pl-lp-test!
-  "sum_list([], S) -> 0"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-sl3 "S")))
-  0)
-
-;; ── max_list/2 ─────────────────────────────────────────────────────
-
-(define pl-lp-env-mx1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "max_list([3,1,4,1,5,9,2,6], M)" pl-lp-env-mx1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "max_list([3,1,4,1,5,9,2,6], M) -> 9"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-mx1 "M")))
-  9)
-
-(define pl-lp-env-mx2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "max_list([7], M)" pl-lp-env-mx2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "max_list([7], M) -> 7"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-mx2 "M")))
-  7)
-
-;; ── min_list/2 ─────────────────────────────────────────────────────
-
-(define pl-lp-env-mn1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "min_list([3,1,4,1,5,9,2,6], M)" pl-lp-env-mn1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "min_list([3,1,4,1,5,9,2,6], M) -> 1"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-mn1 "M")))
-  1)
-
-(define pl-lp-env-mn2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "min_list([5,2,8], M)" pl-lp-env-mn2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "min_list([5,2,8], M) -> 2"
-  (pl-num-val (pl-walk-deep (dict-get pl-lp-env-mn2 "M")))
-  2)
-
-;; ── delete/3 ───────────────────────────────────────────────────────
-
-(define pl-lp-env-del1 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "delete([1,2,3,2,1], 2, R)" pl-lp-env-del1)
-  (pl-mk-trail))
-(pl-lp-test!
-  "delete([1,2,3,2,1], 2, R) -> [1,3,1]"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-del1 "R")))
-  ".(1, .(3, .(1, [])))")
-
-(define pl-lp-env-del2 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "delete([a,b,c], d, R)" pl-lp-env-del2)
-  (pl-mk-trail))
-(pl-lp-test!
-  "delete([a,b,c], d, R) -> [a,b,c] (nothing deleted)"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-del2 "R")))
-  ".(a, .(b, .(c, [])))")
-
-(define pl-lp-env-del3 {})
-(pl-solve-once!
-  pl-lp-db
-  (pl-lp-goal "delete([], x, R)" pl-lp-env-del3)
-  (pl-mk-trail))
-(pl-lp-test!
-  "delete([], x, R) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-lp-env-del3 "R")))
-  "[]")
-
-(define pl-list-predicates-tests-run! (fn () {:failed pl-lp-test-fail :passed pl-lp-test-pass :total pl-lp-test-count :failures pl-lp-test-failures}))

lib/prolog/tests/meta_call.sx

@@ -1,197 +0,0 @@
-;; lib/prolog/tests/meta_call.sx — forall/2, maplist/2, maplist/3, include/3, exclude/3
-(define pl-mc-test-count 0)
-(define pl-mc-test-pass 0)
-(define pl-mc-test-fail 0)
-(define pl-mc-test-failures (list))
-
-(define
-  pl-mc-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-mc-test-count (+ pl-mc-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-mc-test-pass (+ pl-mc-test-pass 1))
-        (begin
-          (set! pl-mc-test-fail (+ pl-mc-test-fail 1))
-          (append!
-            pl-mc-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-mc-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define
-  pl-mc-term-to-sx
-  (fn
-    (t)
-    (cond
-      ((pl-num? t) (pl-num-val t))
-      ((pl-atom? t) (pl-atom-name t))
-      (else t))))
-
-(define
-  pl-mc-list-sx
-  (fn
-    (t)
-    (let
-      ((w (pl-walk-deep t)))
-      (cond
-        ((and (pl-atom? w) (= (pl-atom-name w) "[]")) (list))
-        ((and (pl-compound? w) (= (pl-fun w) "."))
-          (cons
-            (pl-mc-term-to-sx (first (pl-args w)))
-            (pl-mc-list-sx (nth (pl-args w) 1))))
-        (else (list :not-list))))))
-
-(define pl-mc-db (pl-mk-db))
-
-(pl-db-load!
-  pl-mc-db
-  (pl-parse "member(X, [X|_]). member(X, [_|T]) :- member(X, T)."))
-
-(pl-db-load! pl-mc-db (pl-parse "double(X, Y) :- Y is X * 2."))
-
-(pl-db-load! pl-mc-db (pl-parse "even(X) :- 0 is X mod 2."))
-
-;; -- forall/2 --
-
-(pl-mc-test!
-  "forall(member(X,[2,4,6]), 0 is X mod 2) — all even"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "forall(member(X,[2,4,6]), 0 is X mod 2)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mc-test!
-  "forall(member(X,[2,3,6]), 0 is X mod 2) — 3 is odd, fails"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "forall(member(X,[2,3,6]), 0 is X mod 2)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-mc-test!
-  "forall(member(_,[]), true) — vacuously true"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "forall(member(_,[]), true)" {})
-    (pl-mk-trail))
-  true)
-
-;; -- maplist/2 --
-
-(pl-mc-test!
-  "maplist(atom, [a,b,c]) — all atoms"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "maplist(atom, [a,b,c])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mc-test!
-  "maplist(atom, [a,1,c]) — 1 is not atom, fails"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "maplist(atom, [a,1,c])" {})
-    (pl-mk-trail))
-  false)
-
-(pl-mc-test!
-  "maplist(atom, []) — vacuously true"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "maplist(atom, [])" {})
-    (pl-mk-trail))
-  true)
-
-;; -- maplist/3 --
-
-(pl-mc-test!
-  "maplist(double, [1,2,3], [2,4,6]) — deterministic check"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "maplist(double, [1,2,3], [2,4,6])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mc-test!
-  "maplist(double, [1,2,3], [2,4,7]) — wrong result fails"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "maplist(double, [1,2,3], [2,4,7])" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-mc-env-ml3 {:L (pl-mk-rt-var "L")})
-(pl-solve-once!
-  pl-mc-db
-  (pl-mc-goal "maplist(double, [1,2,3], L)" pl-mc-env-ml3)
-  (pl-mk-trail))
-(pl-mc-test!
-  "maplist(double, [1,2,3], L) — L bound to [2,4,6]"
-  (pl-mc-list-sx (dict-get pl-mc-env-ml3 "L"))
-  (list 2 4 6))
-
-;; -- include/3 --
-
-(pl-mc-test!
-  "include(even, [1,2,3,4,5,6], [2,4,6])"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "include(even, [1,2,3,4,5,6], [2,4,6])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mc-test!
-  "include(even, [], [])"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "include(even, [], [])" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-mc-env-inc {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-mc-db
-  (pl-mc-goal "include(even, [1,2,3,4,5,6], R)" pl-mc-env-inc)
-  (pl-mk-trail))
-(pl-mc-test!
-  "include(even, [1,2,3,4,5,6], R) — R bound to [2,4,6]"
-  (pl-mc-list-sx (dict-get pl-mc-env-inc "R"))
-  (list 2 4 6))
-
-;; -- exclude/3 --
-
-(pl-mc-test!
-  "exclude(even, [1,2,3,4,5,6], [1,3,5])"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "exclude(even, [1,2,3,4,5,6], [1,3,5])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mc-test!
-  "exclude(even, [], [])"
-  (pl-solve-once!
-    pl-mc-db
-    (pl-mc-goal "exclude(even, [], [])" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-mc-env-exc {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-mc-db
-  (pl-mc-goal "exclude(even, [1,2,3,4,5,6], R)" pl-mc-env-exc)
-  (pl-mk-trail))
-(pl-mc-test!
-  "exclude(even, [1,2,3,4,5,6], R) — R bound to [1,3,5]"
-  (pl-mc-list-sx (dict-get pl-mc-env-exc "R"))
-  (list 1 3 5))
-
-(define pl-meta-call-tests-run! (fn () {:failed pl-mc-test-fail :passed pl-mc-test-pass :total pl-mc-test-count :failures pl-mc-test-failures}))

lib/prolog/tests/meta_predicates.sx

@@ -1,252 +0,0 @@
-;; lib/prolog/tests/meta_predicates.sx — \+/1, not/1, once/1, ignore/1, ground/1, sort/2, msort/2, atom_number/2, number_string/2
-
-(define pl-mp-test-count 0)
-(define pl-mp-test-pass 0)
-(define pl-mp-test-fail 0)
-(define pl-mp-test-failures (list))
-
-(define
-  pl-mp-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-mp-test-count (+ pl-mp-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-mp-test-pass (+ pl-mp-test-pass 1))
-        (begin
-          (set! pl-mp-test-fail (+ pl-mp-test-fail 1))
-          (append!
-            pl-mp-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-mp-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-mp-db (pl-mk-db))
-(pl-db-load!
-  pl-mp-db
-  (pl-parse "member(X, [X|_]). member(X, [_|T]) :- member(X, T)."))
-
-;; -- \+/1 --
-
-(pl-mp-test!
-  "\\+(fail) succeeds"
-  (pl-solve-once! pl-mp-db (pl-mp-goal "\\+(fail)" {}) (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "\\+(true) fails"
-  (pl-solve-once! pl-mp-db (pl-mp-goal "\\+(true)" {}) (pl-mk-trail))
-  false)
-
-(pl-mp-test!
-  "\\+(member(d, [a,b,c])) succeeds"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "\\+(member(d, [a,b,c]))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "\\+(member(a, [a,b,c])) fails"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "\\+(member(a, [a,b,c]))" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-mp-env-neg {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "\\+(X = 5)" pl-mp-env-neg)
-  (pl-mk-trail))
-(pl-mp-test!
-  "\\+(X=5) fails, X stays unbound (bindings undone)"
-  (nil? (pl-var-binding (dict-get pl-mp-env-neg "X")))
-  true)
-
-;; -- not/1 --
-
-(pl-mp-test!
-  "not(fail) succeeds"
-  (pl-solve-once! pl-mp-db (pl-mp-goal "not(fail)" {}) (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "not(true) fails"
-  (pl-solve-once! pl-mp-db (pl-mp-goal "not(true)" {}) (pl-mk-trail))
-  false)
-
-;; -- once/1 --
-
-(pl-mp-test!
-  "once(member(X,[1,2,3])) succeeds once"
-  (pl-solve-count!
-    pl-mp-db
-    (pl-mp-goal "once(member(X,[1,2,3]))" {})
-    (pl-mk-trail))
-  1)
-
-(define pl-mp-env-once {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "once(member(X,[1,2,3]))" pl-mp-env-once)
-  (pl-mk-trail))
-(pl-mp-test!
-  "once(member(X,[1,2,3])): X=1 (first solution)"
-  (pl-num-val (pl-walk-deep (dict-get pl-mp-env-once "X")))
-  1)
-
-(pl-mp-test!
-  "once(fail) fails"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "once(fail)" {})
-    (pl-mk-trail))
-  false)
-
-;; -- ignore/1 --
-
-(pl-mp-test!
-  "ignore(true) succeeds"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "ignore(true)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "ignore(fail) still succeeds"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "ignore(fail)" {})
-    (pl-mk-trail))
-  true)
-
-;; -- ground/1 --
-
-(pl-mp-test!
-  "ground(foo(1, a)) succeeds"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "ground(foo(1, a))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "ground(foo(X, a)) fails (X unbound)"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "ground(foo(X, a))" {})
-    (pl-mk-trail))
-  false)
-
-(pl-mp-test!
-  "ground(42) succeeds"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "ground(42)" {})
-    (pl-mk-trail))
-  true)
-
-;; -- sort/2 --
-
-(pl-mp-test!
-  "sort([b,a,c], [a,b,c])"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "sort([b,a,c], [a,b,c])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "sort([b,a,a,c], [a,b,c]) (removes duplicates)"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "sort([b,a,a,c], [a,b,c])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "sort([], [])"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "sort([], [])" {})
-    (pl-mk-trail))
-  true)
-
-;; -- msort/2 --
-
-(pl-mp-test!
-  "msort([b,a,a,c], [a,a,b,c]) (keeps duplicates)"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "msort([b,a,a,c], [a,a,b,c])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mp-test!
-  "msort([3,1,2,1], [1,1,2,3])"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "msort([3,1,2,1], [1,1,2,3])" {})
-    (pl-mk-trail))
-  true)
-
-;; -- atom_number/2 --
-
-(define pl-mp-env-an1 {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "atom_number('42', N)" pl-mp-env-an1)
-  (pl-mk-trail))
-(pl-mp-test!
-  "atom_number('42', N) -> N=42"
-  (pl-num-val (pl-walk-deep (dict-get pl-mp-env-an1 "N")))
-  42)
-
-(define pl-mp-env-an2 {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "atom_number(A, 7)" pl-mp-env-an2)
-  (pl-mk-trail))
-(pl-mp-test!
-  "atom_number(A, 7) -> A='7'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-mp-env-an2 "A")))
-  "7")
-
-(pl-mp-test!
-  "atom_number(foo, N) fails (not a number)"
-  (pl-solve-once!
-    pl-mp-db
-    (pl-mp-goal "atom_number(foo, N)" {})
-    (pl-mk-trail))
-  false)
-
-;; -- number_string/2 --
-
-(define pl-mp-env-ns1 {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "number_string(42, S)" pl-mp-env-ns1)
-  (pl-mk-trail))
-(pl-mp-test!
-  "number_string(42, S) -> S='42'"
-  (pl-atom-name (pl-walk-deep (dict-get pl-mp-env-ns1 "S")))
-  "42")
-
-(define pl-mp-env-ns2 {})
-(pl-solve-once!
-  pl-mp-db
-  (pl-mp-goal "number_string(N, '3.14')" pl-mp-env-ns2)
-  (pl-mk-trail))
-(pl-mp-test!
-  "number_string(N, '3.14') -> N=3.14"
-  (pl-num-val (pl-walk-deep (dict-get pl-mp-env-ns2 "N")))
-  3.14)
-
-(define pl-meta-predicates-tests-run! (fn () {:failed pl-mp-test-fail :passed pl-mp-test-pass :total pl-mp-test-count :failures pl-mp-test-failures}))

lib/prolog/tests/operators.sx

@@ -1,193 +0,0 @@
-;; lib/prolog/tests/operators.sx — operator-table parsing + comparison built-ins.
-
-(define pl-op-test-count 0)
-(define pl-op-test-pass 0)
-(define pl-op-test-fail 0)
-(define pl-op-test-failures (list))
-
-(define
-  pl-op-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-op-test-count (+ pl-op-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-op-test-pass (+ pl-op-test-pass 1))
-        (begin
-          (set! pl-op-test-fail (+ pl-op-test-fail 1))
-          (append!
-            pl-op-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define pl-op-empty-db (pl-mk-db))
-
-(define
-  pl-op-body
-  (fn (src) (nth (first (pl-parse (str "g :- " src "."))) 2)))
-
-(define pl-op-goal (fn (src env) (pl-instantiate (pl-op-body src) env)))
-
-;; ── parsing tests ──
-
-(pl-op-test!
-  "infix +"
-  (pl-op-body "a + b")
-  (list "compound" "+" (list (list "atom" "a") (list "atom" "b"))))
-
-(pl-op-test!
-  "infix * tighter than +"
-  (pl-op-body "a + b * c")
-  (list
-    "compound"
-    "+"
-    (list
-      (list "atom" "a")
-      (list "compound" "*" (list (list "atom" "b") (list "atom" "c"))))))
-
-(pl-op-test!
-  "parens override precedence"
-  (pl-op-body "(a + b) * c")
-  (list
-    "compound"
-    "*"
-    (list
-      (list "compound" "+" (list (list "atom" "a") (list "atom" "b")))
-      (list "atom" "c"))))
-
-(pl-op-test!
-  "+ is yfx (left-assoc)"
-  (pl-op-body "a + b + c")
-  (list
-    "compound"
-    "+"
-    (list
-      (list "compound" "+" (list (list "atom" "a") (list "atom" "b")))
-      (list "atom" "c"))))
-
-(pl-op-test!
-  "; is xfy (right-assoc)"
-  (pl-op-body "a ; b ; c")
-  (list
-    "compound"
-    ";"
-    (list
-      (list "atom" "a")
-      (list "compound" ";" (list (list "atom" "b") (list "atom" "c"))))))
-
-(pl-op-test!
-  "= folds at 700"
-  (pl-op-body "X = 5")
-  (list "compound" "=" (list (list "var" "X") (list "num" 5))))
-
-(pl-op-test!
-  "is + nests via 700>500>400"
-  (pl-op-body "X is 2 + 3 * 4")
-  (list
-    "compound"
-    "is"
-    (list
-      (list "var" "X")
-      (list
-        "compound"
-        "+"
-        (list
-          (list "num" 2)
-          (list "compound" "*" (list (list "num" 3) (list "num" 4))))))))
-
-(pl-op-test!
-  "< parses at 700"
-  (pl-op-body "2 < 3")
-  (list "compound" "<" (list (list "num" 2) (list "num" 3))))
-
-(pl-op-test!
-  "mod parses as yfx 400"
-  (pl-op-body "10 mod 3")
-  (list "compound" "mod" (list (list "num" 10) (list "num" 3))))
-
-(pl-op-test!
-  "comma in body folds right-assoc"
-  (pl-op-body "a, b, c")
-  (list
-    "compound"
-    ","
-    (list
-      (list "atom" "a")
-      (list "compound" "," (list (list "atom" "b") (list "atom" "c"))))))
-
-;; ── solver tests via infix ──
-
-(pl-op-test!
-  "X is 2 + 3 binds X = 5"
-  (let
-    ((env {}) (trail (pl-mk-trail)))
-    (begin
-      (pl-solve-once! pl-op-empty-db (pl-op-goal "X is 2 + 3" env) trail)
-      (pl-num-val (pl-walk-deep (dict-get env "X")))))
-  5)
-
-(pl-op-test!
-  "infix conjunction parses + solves"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "X = 5, X = 5" {})
-    (pl-mk-trail))
-  true)
-
-(pl-op-test!
-  "infix mismatch fails"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "X = 5, X = 6" {})
-    (pl-mk-trail))
-  false)
-
-(pl-op-test!
-  "infix disjunction picks left"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "true ; fail" {})
-    (pl-mk-trail))
-  true)
-
-(pl-op-test!
-  "2 < 5 succeeds"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "2 < 5" {})
-    (pl-mk-trail))
-  true)
-
-(pl-op-test!
-  "5 < 2 fails"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "5 < 2" {})
-    (pl-mk-trail))
-  false)
-
-(pl-op-test!
-  "5 >= 5 succeeds"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "5 >= 5" {})
-    (pl-mk-trail))
-  true)
-
-(pl-op-test!
-  "3 =< 5 succeeds"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "3 =< 5" {})
-    (pl-mk-trail))
-  true)
-
-(pl-op-test!
-  "infix < with arithmetic both sides"
-  (pl-solve-once!
-    pl-op-empty-db
-    (pl-op-goal "1 + 2 < 2 * 3" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-operators-tests-run! (fn () {:failed pl-op-test-fail :passed pl-op-test-pass :total pl-op-test-count :failures pl-op-test-failures}))

lib/prolog/tests/programs/append.pl

@@ -1,5 +0,0 @@
-%% append/3 — list concatenation, classic Prolog
-%% Two clauses: empty-prefix base case + recursive cons-prefix.
-%% Bidirectional — works in all modes: build, check, split.
-append([], L, L).
-append([H|T], L, [H|R]) :- append(T, L, R).

lib/prolog/tests/programs/append.sx

@@ -1,114 +0,0 @@
-;; lib/prolog/tests/programs/append.sx — append/3 test runner
-;;
-;; Mirrors the Prolog source in append.pl (embedded as a string here because
-;; the SX runtime has no file-read primitive yet).
-
-(define pl-ap-test-count 0)
-(define pl-ap-test-pass 0)
-(define pl-ap-test-fail 0)
-(define pl-ap-test-failures (list))
-
-(define
-  pl-ap-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-ap-test-count (+ pl-ap-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-ap-test-pass (+ pl-ap-test-pass 1))
-        (begin
-          (set! pl-ap-test-fail (+ pl-ap-test-fail 1))
-          (append!
-            pl-ap-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-ap-term-to-sx
-  (fn
-    (t)
-    (cond
-      ((pl-num? t) (pl-num-val t))
-      ((pl-atom? t) (pl-atom-name t))
-      (true (list :complex)))))
-
-(define
-  pl-ap-list-walked
-  (fn
-    (w)
-    (cond
-      ((and (pl-atom? w) (= (pl-atom-name w) "[]")) (list))
-      ((and (pl-compound? w) (= (pl-fun w) ".") (= (len (pl-args w)) 2))
-        (cons
-          (pl-ap-term-to-sx (first (pl-args w)))
-          (pl-ap-list-walked (nth (pl-args w) 1))))
-      (true (list :not-list)))))
-
-(define pl-ap-list-to-sx (fn (t) (pl-ap-list-walked (pl-walk-deep t))))
-
-(define
-  pl-ap-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define
-  pl-ap-prog-src
-  "append([], L, L). append([H|T], L, [H|R]) :- append(T, L, R).")
-
-(define pl-ap-db (pl-mk-db))
-
-(pl-db-load! pl-ap-db (pl-parse pl-ap-prog-src))
-
-(define pl-ap-env-1 {})
-(define pl-ap-goal-1 (pl-ap-goal "append([], [a, b], X)" pl-ap-env-1))
-(pl-solve-once! pl-ap-db pl-ap-goal-1 (pl-mk-trail))
-
-(pl-ap-test!
-  "append([], [a, b], X) → X = [a, b]"
-  (pl-ap-list-to-sx (dict-get pl-ap-env-1 "X"))
-  (list "a" "b"))
-
-(define pl-ap-env-2 {})
-(define pl-ap-goal-2 (pl-ap-goal "append([1, 2], [3, 4], X)" pl-ap-env-2))
-(pl-solve-once! pl-ap-db pl-ap-goal-2 (pl-mk-trail))
-
-(pl-ap-test!
-  "append([1, 2], [3, 4], X) → X = [1, 2, 3, 4]"
-  (pl-ap-list-to-sx (dict-get pl-ap-env-2 "X"))
-  (list 1 2 3 4))
-
-(pl-ap-test!
-  "append([1], [2, 3], [1, 2, 3]) succeeds"
-  (pl-solve-once!
-    pl-ap-db
-    (pl-ap-goal "append([1], [2, 3], [1, 2, 3])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-ap-test!
-  "append([1, 2], [3], [1, 2, 4]) fails"
-  (pl-solve-once!
-    pl-ap-db
-    (pl-ap-goal "append([1, 2], [3], [1, 2, 4])" {})
-    (pl-mk-trail))
-  false)
-
-(pl-ap-test!
-  "append(X, Y, [1, 2, 3]) backtracks 4 times"
-  (pl-solve-count!
-    pl-ap-db
-    (pl-ap-goal "append(X, Y, [1, 2, 3])" {})
-    (pl-mk-trail))
-  4)
-
-(define pl-ap-env-6 {})
-(define pl-ap-goal-6 (pl-ap-goal "append(X, [3], [1, 2, 3])" pl-ap-env-6))
-(pl-solve-once! pl-ap-db pl-ap-goal-6 (pl-mk-trail))
-
-(pl-ap-test!
-  "append(X, [3], [1, 2, 3]) deduces X = [1, 2]"
-  (pl-ap-list-to-sx (dict-get pl-ap-env-6 "X"))
-  (list 1 2))
-
-(define pl-append-tests-run! (fn () {:failed pl-ap-test-fail :passed pl-ap-test-pass :total pl-ap-test-count :failures pl-ap-test-failures}))

lib/prolog/tests/programs/family.pl

@@ -1,24 +0,0 @@
-%% family — facts + transitive ancestor + derived relations.
-%% Five-generation tree: tom -> bob -> {ann, pat} -> jim, plus tom's
-%% other child liz.
-
-parent(tom, bob).
-parent(tom, liz).
-parent(bob, ann).
-parent(bob, pat).
-parent(pat, jim).
-
-male(tom).
-male(bob).
-male(jim).
-male(pat).
-female(liz).
-female(ann).
-
-father(F, C) :- parent(F, C), male(F).
-mother(M, C) :- parent(M, C), female(M).
-
-ancestor(X, Y) :- parent(X, Y).
-ancestor(X, Y) :- parent(X, Z), ancestor(Z, Y).
-
-sibling(X, Y) :- parent(P, X), parent(P, Y), \=(X, Y).

lib/prolog/tests/programs/family.sx

@@ -1,116 +0,0 @@
-;; lib/prolog/tests/programs/family.sx — facts + ancestor + sibling relations.
-
-(define pl-fa-test-count 0)
-(define pl-fa-test-pass 0)
-(define pl-fa-test-fail 0)
-(define pl-fa-test-failures (list))
-
-(define
-  pl-fa-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-fa-test-count (+ pl-fa-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-fa-test-pass (+ pl-fa-test-pass 1))
-        (begin
-          (set! pl-fa-test-fail (+ pl-fa-test-fail 1))
-          (append!
-            pl-fa-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-fa-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define
-  pl-fa-prog-src
-  "parent(tom, bob). parent(tom, liz). parent(bob, ann). parent(bob, pat). parent(pat, jim). male(tom). male(bob). male(jim). male(pat). female(liz). female(ann). father(F, C) :- parent(F, C), male(F). mother(M, C) :- parent(M, C), female(M). ancestor(X, Y) :- parent(X, Y). ancestor(X, Y) :- parent(X, Z), ancestor(Z, Y). sibling(X, Y) :- parent(P, X), parent(P, Y), \\=(X, Y).")
-
-(define pl-fa-db (pl-mk-db))
-(pl-db-load! pl-fa-db (pl-parse pl-fa-prog-src))
-
-(pl-fa-test!
-  "parent(tom, bob) is a fact"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "parent(tom, bob)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-fa-test!
-  "parent(tom, ann) — not a direct parent"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "parent(tom, ann)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-fa-test!
-  "5 parent/2 facts in total"
-  (pl-solve-count!
-    pl-fa-db
-    (pl-fa-goal "parent(X, Y)" {})
-    (pl-mk-trail))
-  5)
-
-(pl-fa-test!
-  "ancestor(tom, jim) — three-step transitive"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "ancestor(tom, jim)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-fa-test!
-  "tom has 5 ancestors-of: bob, liz, ann, pat, jim"
-  (pl-solve-count!
-    pl-fa-db
-    (pl-fa-goal "ancestor(tom, X)" {})
-    (pl-mk-trail))
-  5)
-
-(pl-fa-test!
-  "father(bob, ann) succeeds"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "father(bob, ann)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-fa-test!
-  "father(liz, ann) fails (liz is female)"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "father(liz, ann)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-fa-test!
-  "mother(liz, X) fails (liz has no children)"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "mother(liz, X)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-fa-test!
-  "sibling(ann, pat) succeeds"
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "sibling(ann, pat)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-fa-test!
-  "sibling(ann, ann) fails by \\="
-  (pl-solve-once!
-    pl-fa-db
-    (pl-fa-goal "sibling(ann, ann)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-family-tests-run! (fn () {:failed pl-fa-test-fail :passed pl-fa-test-pass :total pl-fa-test-count :failures pl-fa-test-failures}))

lib/prolog/tests/programs/member.pl

@@ -1,4 +0,0 @@
-%% member/2 — list membership.
-%% Generates all solutions on backtracking when the element is unbound.
-member(X, [X|_]).
-member(X, [_|T]) :- member(X, T).

lib/prolog/tests/programs/member.sx

@@ -1,91 +0,0 @@
-;; lib/prolog/tests/programs/member.sx — member/2 generator.
-
-(define pl-mb-test-count 0)
-(define pl-mb-test-pass 0)
-(define pl-mb-test-fail 0)
-(define pl-mb-test-failures (list))
-
-(define
-  pl-mb-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-mb-test-count (+ pl-mb-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-mb-test-pass (+ pl-mb-test-pass 1))
-        (begin
-          (set! pl-mb-test-fail (+ pl-mb-test-fail 1))
-          (append!
-            pl-mb-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-mb-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-mb-prog-src "member(X, [X|_]). member(X, [_|T]) :- member(X, T).")
-
-(define pl-mb-db (pl-mk-db))
-(pl-db-load! pl-mb-db (pl-parse pl-mb-prog-src))
-
-(pl-mb-test!
-  "member(2, [1, 2, 3]) succeeds"
-  (pl-solve-once!
-    pl-mb-db
-    (pl-mb-goal "member(2, [1, 2, 3])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-mb-test!
-  "member(4, [1, 2, 3]) fails"
-  (pl-solve-once!
-    pl-mb-db
-    (pl-mb-goal "member(4, [1, 2, 3])" {})
-    (pl-mk-trail))
-  false)
-
-(pl-mb-test!
-  "member(X, []) fails"
-  (pl-solve-once!
-    pl-mb-db
-    (pl-mb-goal "member(X, [])" {})
-    (pl-mk-trail))
-  false)
-
-(pl-mb-test!
-  "member(X, [a, b, c]) generates 3 solutions"
-  (pl-solve-count!
-    pl-mb-db
-    (pl-mb-goal "member(X, [a, b, c])" {})
-    (pl-mk-trail))
-  3)
-
-(define pl-mb-env-1 {})
-(define pl-mb-goal-1 (pl-mb-goal "member(X, [11, 22, 33])" pl-mb-env-1))
-(pl-solve-once! pl-mb-db pl-mb-goal-1 (pl-mk-trail))
-
-(pl-mb-test!
-  "member(X, [11, 22, 33]) first solution X = 11"
-  (pl-num-val (pl-walk-deep (dict-get pl-mb-env-1 "X")))
-  11)
-
-(pl-mb-test!
-  "member(2, [1, 2, 3, 2, 1]) matches twice on backtrack"
-  (pl-solve-count!
-    pl-mb-db
-    (pl-mb-goal "member(2, [1, 2, 3, 2, 1])" {})
-    (pl-mk-trail))
-  2)
-
-(pl-mb-test!
-  "member with unbound list cell unifies"
-  (pl-solve-once!
-    pl-mb-db
-    (pl-mb-goal "member(a, [X, b, c])" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-member-tests-run! (fn () {:failed pl-mb-test-fail :passed pl-mb-test-pass :total pl-mb-test-count :failures pl-mb-test-failures}))

lib/prolog/tests/programs/nqueens.pl

@@ -1,27 +0,0 @@
-%% nqueens — permutation-and-test formulation.
-%% Caller passes the row list [1..N]; queens/2 finds N column placements
-%% s.t. no two queens attack on a diagonal. Same-column attacks are
-%% structurally impossible — Qs is a permutation, all distinct.
-%%
-%% No `>/2` `</2` `=</2` built-ins yet, so range/3 is omitted; tests pass
-%; the literal range list. Once the operator table lands and arithmetic
-%% comparison built-ins are in, range/3 can be added.
-queens(L, Qs) :- permute(L, Qs), safe(Qs).
-
-permute([], []).
-permute(L, [H|T]) :- select(H, L, R), permute(R, T).
-
-select(X, [X|T], T).
-select(X, [H|T], [H|R]) :- select(X, T, R).
-
-safe([]).
-safe([Q|Qs]) :- safe(Qs), no_attack(Q, Qs, 1).
-
-no_attack(_, [], _).
-no_attack(Q, [Q1|Qs], D) :-
-  is(D2, +(Q, D)),
-  \=(D2, Q1),
-  is(D3, -(Q, D)),
-  \=(D3, Q1),
-  is(D1, +(D, 1)),
-  no_attack(Q, Qs, D1).

lib/prolog/tests/programs/nqueens.sx

@@ -1,108 +0,0 @@
-;; lib/prolog/tests/programs/nqueens.sx — N-queens via permute + safe.
-
-(define pl-nq-test-count 0)
-(define pl-nq-test-pass 0)
-(define pl-nq-test-fail 0)
-(define pl-nq-test-failures (list))
-
-(define
-  pl-nq-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-nq-test-count (+ pl-nq-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-nq-test-pass (+ pl-nq-test-pass 1))
-        (begin
-          (set! pl-nq-test-fail (+ pl-nq-test-fail 1))
-          (append!
-            pl-nq-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-nq-term-to-sx
-  (fn
-    (t)
-    (cond
-      ((pl-num? t) (pl-num-val t))
-      ((pl-atom? t) (pl-atom-name t))
-      (true (list :complex)))))
-
-(define
-  pl-nq-list-walked
-  (fn
-    (w)
-    (cond
-      ((and (pl-atom? w) (= (pl-atom-name w) "[]")) (list))
-      ((and (pl-compound? w) (= (pl-fun w) ".") (= (len (pl-args w)) 2))
-        (cons
-          (pl-nq-term-to-sx (first (pl-args w)))
-          (pl-nq-list-walked (nth (pl-args w) 1))))
-      (true (list :not-list)))))
-
-(define pl-nq-list-to-sx (fn (t) (pl-nq-list-walked (pl-walk-deep t))))
-
-(define
-  pl-nq-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define
-  pl-nq-prog-src
-  "queens(L, Qs) :- permute(L, Qs), safe(Qs). permute([], []). permute(L, [H|T]) :- select(H, L, R), permute(R, T). select(X, [X|T], T). select(X, [H|T], [H|R]) :- select(X, T, R). safe([]). safe([Q|Qs]) :- safe(Qs), no_attack(Q, Qs, 1). no_attack(_, [], _). no_attack(Q, [Q1|Qs], D) :- is(D2, +(Q, D)), \\=(D2, Q1), is(D3, -(Q, D)), \\=(D3, Q1), is(D1, +(D, 1)), no_attack(Q, Qs, D1).")
-
-(define pl-nq-db (pl-mk-db))
-(pl-db-load! pl-nq-db (pl-parse pl-nq-prog-src))
-
-(pl-nq-test!
-  "queens([1], Qs) → 1 solution"
-  (pl-solve-count!
-    pl-nq-db
-    (pl-nq-goal "queens([1], Qs)" {})
-    (pl-mk-trail))
-  1)
-
-(pl-nq-test!
-  "queens([1, 2], Qs) → 0 solutions"
-  (pl-solve-count!
-    pl-nq-db
-    (pl-nq-goal "queens([1, 2], Qs)" {})
-    (pl-mk-trail))
-  0)
-
-(pl-nq-test!
-  "queens([1, 2, 3], Qs) → 0 solutions"
-  (pl-solve-count!
-    pl-nq-db
-    (pl-nq-goal "queens([1, 2, 3], Qs)" {})
-    (pl-mk-trail))
-  0)
-
-(pl-nq-test!
-  "queens([1, 2, 3, 4], Qs) → 2 solutions"
-  (pl-solve-count!
-    pl-nq-db
-    (pl-nq-goal "queens([1, 2, 3, 4], Qs)" {})
-    (pl-mk-trail))
-  2)
-
-(pl-nq-test!
-  "queens([1, 2, 3, 4, 5], Qs) → 10 solutions"
-  (pl-solve-count!
-    pl-nq-db
-    (pl-nq-goal "queens([1, 2, 3, 4, 5], Qs)" {})
-    (pl-mk-trail))
-  10)
-
-(define pl-nq-env-1 {})
-(define pl-nq-goal-1 (pl-nq-goal "queens([1, 2, 3, 4], Qs)" pl-nq-env-1))
-(pl-solve-once! pl-nq-db pl-nq-goal-1 (pl-mk-trail))
-
-(pl-nq-test!
-  "queens([1..4], Qs) first solution = [2, 4, 1, 3]"
-  (pl-nq-list-to-sx (dict-get pl-nq-env-1 "Qs"))
-  (list 2 4 1 3))
-
-(define pl-nqueens-tests-run! (fn () {:failed pl-nq-test-fail :passed pl-nq-test-pass :total pl-nq-test-count :failures pl-nq-test-failures}))

lib/prolog/tests/programs/reverse.pl

@@ -1,7 +0,0 @@
-%% reverse/2 — naive reverse via append/3.
-%% Quadratic — accumulates the reversed prefix one append per cons.
-reverse([], []).
-reverse([H|T], R) :- reverse(T, RT), append(RT, [H], R).
-
-append([], L, L).
-append([H|T], L, [H|R]) :- append(T, L, R).

lib/prolog/tests/programs/reverse.sx

@@ -1,113 +0,0 @@
-;; lib/prolog/tests/programs/reverse.sx — naive reverse/2 via append/3.
-;;
-;; Mirrors reverse.pl (embedded as a string here).
-
-(define pl-rv-test-count 0)
-(define pl-rv-test-pass 0)
-(define pl-rv-test-fail 0)
-(define pl-rv-test-failures (list))
-
-(define
-  pl-rv-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-rv-test-count (+ pl-rv-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-rv-test-pass (+ pl-rv-test-pass 1))
-        (begin
-          (set! pl-rv-test-fail (+ pl-rv-test-fail 1))
-          (append!
-            pl-rv-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-rv-term-to-sx
-  (fn
-    (t)
-    (cond
-      ((pl-num? t) (pl-num-val t))
-      ((pl-atom? t) (pl-atom-name t))
-      (true (list :complex)))))
-
-(define
-  pl-rv-list-walked
-  (fn
-    (w)
-    (cond
-      ((and (pl-atom? w) (= (pl-atom-name w) "[]")) (list))
-      ((and (pl-compound? w) (= (pl-fun w) ".") (= (len (pl-args w)) 2))
-        (cons
-          (pl-rv-term-to-sx (first (pl-args w)))
-          (pl-rv-list-walked (nth (pl-args w) 1))))
-      (true (list :not-list)))))
-
-(define pl-rv-list-to-sx (fn (t) (pl-rv-list-walked (pl-walk-deep t))))
-
-(define
-  pl-rv-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define
-  pl-rv-prog-src
-  "reverse([], []). reverse([H|T], R) :- reverse(T, RT), append(RT, [H], R). append([], L, L). append([H|T], L, [H|R]) :- append(T, L, R).")
-
-(define pl-rv-db (pl-mk-db))
-(pl-db-load! pl-rv-db (pl-parse pl-rv-prog-src))
-
-(define pl-rv-env-1 {})
-(define pl-rv-goal-1 (pl-rv-goal "reverse([], X)" pl-rv-env-1))
-(pl-solve-once! pl-rv-db pl-rv-goal-1 (pl-mk-trail))
-
-(pl-rv-test!
-  "reverse([], X) → X = []"
-  (pl-rv-list-to-sx (dict-get pl-rv-env-1 "X"))
-  (list))
-
-(define pl-rv-env-2 {})
-(define pl-rv-goal-2 (pl-rv-goal "reverse([1], X)" pl-rv-env-2))
-(pl-solve-once! pl-rv-db pl-rv-goal-2 (pl-mk-trail))
-
-(pl-rv-test!
-  "reverse([1], X) → X = [1]"
-  (pl-rv-list-to-sx (dict-get pl-rv-env-2 "X"))
-  (list 1))
-
-(define pl-rv-env-3 {})
-(define pl-rv-goal-3 (pl-rv-goal "reverse([1, 2, 3], X)" pl-rv-env-3))
-(pl-solve-once! pl-rv-db pl-rv-goal-3 (pl-mk-trail))
-
-(pl-rv-test!
-  "reverse([1, 2, 3], X) → X = [3, 2, 1]"
-  (pl-rv-list-to-sx (dict-get pl-rv-env-3 "X"))
-  (list 3 2 1))
-
-(define pl-rv-env-4 {})
-(define pl-rv-goal-4 (pl-rv-goal "reverse([a, b, c, d], X)" pl-rv-env-4))
-(pl-solve-once! pl-rv-db pl-rv-goal-4 (pl-mk-trail))
-
-(pl-rv-test!
-  "reverse([a, b, c, d], X) → X = [d, c, b, a]"
-  (pl-rv-list-to-sx (dict-get pl-rv-env-4 "X"))
-  (list "d" "c" "b" "a"))
-
-(pl-rv-test!
-  "reverse([1, 2, 3], [3, 2, 1]) succeeds"
-  (pl-solve-once!
-    pl-rv-db
-    (pl-rv-goal "reverse([1, 2, 3], [3, 2, 1])" {})
-    (pl-mk-trail))
-  true)
-
-(pl-rv-test!
-  "reverse([1, 2], [1, 2]) fails"
-  (pl-solve-once!
-    pl-rv-db
-    (pl-rv-goal "reverse([1, 2], [1, 2])" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-reverse-tests-run! (fn () {:failed pl-rv-test-fail :passed pl-rv-test-pass :total pl-rv-test-count :failures pl-rv-test-failures}))

lib/prolog/tests/query_api.sx

@@ -1,127 +0,0 @@
-;; lib/prolog/tests/query_api.sx — tests for pl-load/pl-query-all/pl-query-one/pl-query
-
-(define pl-qa-test-count 0)
-(define pl-qa-test-pass 0)
-(define pl-qa-test-fail 0)
-(define pl-qa-test-failures (list))
-
-(define
-  pl-qa-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-qa-test-count (+ pl-qa-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-qa-test-pass (+ pl-qa-test-pass 1))
-        (begin
-          (set! pl-qa-test-fail (+ pl-qa-test-fail 1))
-          (append!
-            pl-qa-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-qa-src
-  "parent(tom, bob). parent(tom, liz). parent(bob, ann). ancestor(X, Y) :- parent(X, Y). ancestor(X, Y) :- parent(X, Z), ancestor(Z, Y).")
-
-(define pl-qa-db (pl-load pl-qa-src))
-
-;; ── pl-load ──
-
-(pl-qa-test!
-  "pl-load returns a usable DB (pl-query-all non-nil)"
-  (not (nil? pl-qa-db))
-  true)
-
-;; ── pl-query-all: basic fact lookup ──
-
-(pl-qa-test!
-  "query-all parent(tom, X): 2 solutions"
-  (len (pl-query-all pl-qa-db "parent(tom, X)"))
-  2)
-
-(pl-qa-test!
-  "query-all parent(tom, X): first solution X=bob"
-  (dict-get (first (pl-query-all pl-qa-db "parent(tom, X)")) "X")
-  "bob")
-
-(pl-qa-test!
-  "query-all parent(tom, X): second solution X=liz"
-  (dict-get (nth (pl-query-all pl-qa-db "parent(tom, X)") 1) "X")
-  "liz")
-
-;; ── pl-query-all: no solutions ──
-
-(pl-qa-test!
-  "query-all no solutions returns empty list"
-  (pl-query-all pl-qa-db "parent(liz, X)")
-  (list))
-
-;; ── pl-query-all: boolean query (no vars) ──
-
-(pl-qa-test!
-  "boolean success: 1 solution (empty dict)"
-  (len (pl-query-all pl-qa-db "parent(tom, bob)"))
-  1)
-
-(pl-qa-test!
-  "boolean success: solution has no bindings"
-  (empty? (keys (first (pl-query-all pl-qa-db "parent(tom, bob)"))))
-  true)
-
-(pl-qa-test!
-  "boolean fail: 0 solutions"
-  (len (pl-query-all pl-qa-db "parent(bob, tom)"))
-  0)
-
-;; ── pl-query-all: multi-var ──
-
-(pl-qa-test!
-  "query-all parent(X, Y): 3 solutions total"
-  (len (pl-query-all pl-qa-db "parent(X, Y)"))
-  3)
-
-;; ── pl-query-all: rule-based (ancestor/2) ──
-
-(pl-qa-test!
-  "query-all ancestor(tom, X): 3 descendants (bob, liz, ann)"
-  (len (pl-query-all pl-qa-db "ancestor(tom, X)"))
-  3)
-
-;; ── pl-query-all: built-in in query ──
-
-(pl-qa-test!
-  "query with is/2 built-in"
-  (dict-get (first (pl-query-all pl-qa-db "X is 2 + 3")) "X")
-  "5")
-
-;; ── pl-query-one ──
-
-(pl-qa-test!
-  "query-one returns first solution"
-  (dict-get (pl-query-one pl-qa-db "parent(tom, X)") "X")
-  "bob")
-
-(pl-qa-test!
-  "query-one returns nil for no solutions"
-  (pl-query-one pl-qa-db "parent(liz, X)")
-  nil)
-
-;; ── pl-query convenience ──
-
-(pl-qa-test!
-  "pl-query convenience: count solutions"
-  (len (pl-query "likes(alice, bob). likes(alice, carol)." "likes(alice, X)"))
-  2)
-
-(pl-qa-test!
-  "pl-query convenience: first solution"
-  (dict-get (first (pl-query "likes(alice, bob). likes(alice, carol)." "likes(alice, X)")) "X")
-  "bob")
-
-(pl-qa-test!
-  "pl-query with empty source (built-ins only)"
-  (dict-get (first (pl-query "" "X is 6 * 7")) "X")
-  "42")
-
-(define pl-query-api-tests-run! (fn () {:failed pl-qa-test-fail :passed pl-qa-test-pass :total pl-qa-test-count :failures pl-qa-test-failures}))

lib/prolog/tests/set_predicates.sx

@@ -1,195 +0,0 @@
-;; lib/prolog/tests/set_predicates.sx — foldl/4, list_to_set/2, intersection/3, subtract/3, union/3
-
-(define pl-sp-test-count 0)
-(define pl-sp-test-pass 0)
-(define pl-sp-test-fail 0)
-(define pl-sp-test-failures (list))
-
-(define
-  pl-sp-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-sp-test-count (+ pl-sp-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-sp-test-pass (+ pl-sp-test-pass 1))
-        (begin
-          (set! pl-sp-test-fail (+ pl-sp-test-fail 1))
-          (append!
-            pl-sp-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-sp-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-;; DB with add/3 for foldl tests
-(define pl-sp-db (pl-mk-db))
-(pl-db-load! pl-sp-db (pl-parse "add(X, Acc, NAcc) :- NAcc is Acc + X."))
-
-;; ── foldl/4 ────────────────────────────────────────────────────────
-
-(define pl-sp-env-fl1 {:S (pl-mk-rt-var "S")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "foldl(add, [1,2,3,4], 0, S)" pl-sp-env-fl1)
-  (pl-mk-trail))
-(pl-sp-test!
-  "foldl(add,[1,2,3,4],0,S) -> S=10"
-  (pl-num-val (pl-walk-deep (dict-get pl-sp-env-fl1 "S")))
-  10)
-
-(define pl-sp-env-fl2 {:S (pl-mk-rt-var "S")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "foldl(add, [], 5, S)" pl-sp-env-fl2)
-  (pl-mk-trail))
-(pl-sp-test!
-  "foldl(add,[],5,S) -> S=5"
-  (pl-num-val (pl-walk-deep (dict-get pl-sp-env-fl2 "S")))
-  5)
-
-(define pl-sp-env-fl3 {:S (pl-mk-rt-var "S")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "foldl(add, [1,2,3], 0, S)" pl-sp-env-fl3)
-  (pl-mk-trail))
-(pl-sp-test!
-  "foldl(add,[1,2,3],0,S) -> S=6"
-  (pl-num-val (pl-walk-deep (dict-get pl-sp-env-fl3 "S")))
-  6)
-
-;; ── list_to_set/2 ──────────────────────────────────────────────────
-
-(define pl-sp-env-lts1 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "list_to_set([1,2,3,2,1], R)" pl-sp-env-lts1)
-  (pl-mk-trail))
-(pl-sp-test!
-  "list_to_set([1,2,3,2,1],R) -> [1,2,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-lts1 "R")))
-  ".(1, .(2, .(3, [])))")
-
-(define pl-sp-env-lts2 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "list_to_set([], R)" pl-sp-env-lts2)
-  (pl-mk-trail))
-(pl-sp-test!
-  "list_to_set([],R) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-lts2 "R")))
-  "[]")
-
-(define pl-sp-env-lts3 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "list_to_set([a,b,a,c], R)" pl-sp-env-lts3)
-  (pl-mk-trail))
-(pl-sp-test!
-  "list_to_set([a,b,a,c],R) -> [a,b,c]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-lts3 "R")))
-  ".(a, .(b, .(c, [])))")
-
-;; ── intersection/3 ─────────────────────────────────────────────────
-
-(define pl-sp-env-int1 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "intersection([1,2,3,4], [2,4,6], R)" pl-sp-env-int1)
-  (pl-mk-trail))
-(pl-sp-test!
-  "intersection([1,2,3,4],[2,4,6],R) -> [2,4]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-int1 "R")))
-  ".(2, .(4, []))")
-
-(define pl-sp-env-int2 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "intersection([1,2,3], [4,5,6], R)" pl-sp-env-int2)
-  (pl-mk-trail))
-(pl-sp-test!
-  "intersection([1,2,3],[4,5,6],R) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-int2 "R")))
-  "[]")
-
-(define pl-sp-env-int3 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "intersection([], [1,2,3], R)" pl-sp-env-int3)
-  (pl-mk-trail))
-(pl-sp-test!
-  "intersection([],[1,2,3],R) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-int3 "R")))
-  "[]")
-
-;; ── subtract/3 ─────────────────────────────────────────────────────
-
-(define pl-sp-env-sub1 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "subtract([1,2,3,4], [2,4], R)" pl-sp-env-sub1)
-  (pl-mk-trail))
-(pl-sp-test!
-  "subtract([1,2,3,4],[2,4],R) -> [1,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-sub1 "R")))
-  ".(1, .(3, []))")
-
-(define pl-sp-env-sub2 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "subtract([1,2,3], [], R)" pl-sp-env-sub2)
-  (pl-mk-trail))
-(pl-sp-test!
-  "subtract([1,2,3],[],R) -> [1,2,3]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-sub2 "R")))
-  ".(1, .(2, .(3, [])))")
-
-(define pl-sp-env-sub3 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "subtract([], [1,2], R)" pl-sp-env-sub3)
-  (pl-mk-trail))
-(pl-sp-test!
-  "subtract([],[1,2],R) -> []"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-sub3 "R")))
-  "[]")
-
-;; ── union/3 ────────────────────────────────────────────────────────
-
-(define pl-sp-env-uni1 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "union([1,2,3], [2,3,4], R)" pl-sp-env-uni1)
-  (pl-mk-trail))
-(pl-sp-test!
-  "union([1,2,3],[2,3,4],R) -> [1,2,3,4]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-uni1 "R")))
-  ".(1, .(2, .(3, .(4, []))))")
-
-(define pl-sp-env-uni2 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "union([], [1,2], R)" pl-sp-env-uni2)
-  (pl-mk-trail))
-(pl-sp-test!
-  "union([],[1,2],R) -> [1,2]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-uni2 "R")))
-  ".(1, .(2, []))")
-
-(define pl-sp-env-uni3 {:R (pl-mk-rt-var "R")})
-(pl-solve-once!
-  pl-sp-db
-  (pl-sp-goal "union([1,2], [], R)" pl-sp-env-uni3)
-  (pl-mk-trail))
-(pl-sp-test!
-  "union([1,2],[],R) -> [1,2]"
-  (pl-format-term (pl-walk-deep (dict-get pl-sp-env-uni3 "R")))
-  ".(1, .(2, []))")
-
-;; ── Runner ─────────────────────────────────────────────────────────
-
-(define pl-set-predicates-tests-run! (fn () {:failed pl-sp-test-fail :passed pl-sp-test-pass :total pl-sp-test-count :failures pl-sp-test-failures}))

lib/prolog/tests/solve.sx

@@ -1,618 +0,0 @@
-;; lib/prolog/tests/solve.sx — DFS solver unit tests
-
-(define pl-s-test-count 0)
-(define pl-s-test-pass 0)
-(define pl-s-test-fail 0)
-(define pl-s-test-failures (list))
-
-(define
-  pl-s-test!
-  (fn
-    (name got expected)
-    (begin
-      (set! pl-s-test-count (+ pl-s-test-count 1))
-      (if
-        (= got expected)
-        (set! pl-s-test-pass (+ pl-s-test-pass 1))
-        (begin
-          (set! pl-s-test-fail (+ pl-s-test-fail 1))
-          (append!
-            pl-s-test-failures
-            (str name "\n    expected: " expected "\n    got:      " got)))))))
-
-(define
-  pl-s-goal
-  (fn
-    (src env)
-    (pl-instantiate (nth (first (pl-parse (str "g :- " src "."))) 2) env)))
-
-(define pl-s-empty-db (pl-mk-db))
-
-(pl-s-test!
-  "true succeeds"
-  (pl-solve-once! pl-s-empty-db (pl-s-goal "true" {}) (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "fail fails"
-  (pl-solve-once! pl-s-empty-db (pl-s-goal "fail" {}) (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "= identical atoms"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(a, a)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "= different atoms"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(a, b)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "= var to atom"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(X, foo)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-s-env-bind {})
-(define pl-s-trail-bind (pl-mk-trail))
-(define pl-s-goal-bind (pl-s-goal "=(X, foo)" pl-s-env-bind))
-(pl-solve-once! pl-s-empty-db pl-s-goal-bind pl-s-trail-bind)
-
-(pl-s-test!
-  "X bound to foo after =(X, foo)"
-  (pl-atom-name (pl-walk-deep (dict-get pl-s-env-bind "X")))
-  "foo")
-
-(pl-s-test!
-  "true , true succeeds"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "true, true" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "true , fail fails"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "true, fail" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "consistent X bindings succeed"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(X, a), =(X, a)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "conflicting X bindings fail"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(X, a), =(X, b)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-s-db1 (pl-mk-db))
-(pl-db-load!
-  pl-s-db1
-  (pl-parse "parent(tom, bob). parent(bob, liz). parent(bob, ann)."))
-
-(pl-s-test!
-  "fact lookup hit"
-  (pl-solve-once!
-    pl-s-db1
-    (pl-s-goal "parent(tom, bob)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "fact lookup miss"
-  (pl-solve-once!
-    pl-s-db1
-    (pl-s-goal "parent(tom, liz)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "all parent solutions"
-  (pl-solve-count!
-    pl-s-db1
-    (pl-s-goal "parent(X, Y)" {})
-    (pl-mk-trail))
-  3)
-
-(pl-s-test!
-  "fixed first arg solutions"
-  (pl-solve-count!
-    pl-s-db1
-    (pl-s-goal "parent(bob, Y)" {})
-    (pl-mk-trail))
-  2)
-
-(define pl-s-db2 (pl-mk-db))
-(pl-db-load!
-  pl-s-db2
-  (pl-parse
-    "parent(tom, bob). parent(bob, ann). ancestor(X, Y) :- parent(X, Y). ancestor(X, Z) :- parent(X, Y), ancestor(Y, Z)."))
-
-(pl-s-test!
-  "rule direct ancestor"
-  (pl-solve-once!
-    pl-s-db2
-    (pl-s-goal "ancestor(tom, bob)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "rule transitive ancestor"
-  (pl-solve-once!
-    pl-s-db2
-    (pl-s-goal "ancestor(tom, ann)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "rule no path"
-  (pl-solve-once!
-    pl-s-db2
-    (pl-s-goal "ancestor(ann, tom)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-s-env-undo {})
-(define pl-s-trail-undo (pl-mk-trail))
-(define pl-s-goal-undo (pl-s-goal "=(X, a), fail" pl-s-env-undo))
-(pl-solve-once! pl-s-empty-db pl-s-goal-undo pl-s-trail-undo)
-
-(pl-s-test!
-  "trail undone after failure leaves X unbound"
-  (pl-var-bound? (dict-get pl-s-env-undo "X"))
-  false)
-
-(define pl-s-db-cut1 (pl-mk-db))
-
-(pl-db-load! pl-s-db-cut1 (pl-parse "g :- !. g :- true."))
-
-(pl-s-test!
-  "bare cut succeeds"
-  (pl-solve-once! pl-s-db-cut1 (pl-s-goal "g" {}) (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "cut commits to first matching clause"
-  (pl-solve-count! pl-s-db-cut1 (pl-s-goal "g" {}) (pl-mk-trail))
-  1)
-
-(define pl-s-db-cut2 (pl-mk-db))
-
-(pl-db-load! pl-s-db-cut2 (pl-parse "a(1). a(2). g(X) :- a(X), !."))
-
-(pl-s-test!
-  "cut commits to first a solution"
-  (pl-solve-count! pl-s-db-cut2 (pl-s-goal "g(X)" {}) (pl-mk-trail))
-  1)
-
-(define pl-s-db-cut3 (pl-mk-db))
-
-(pl-db-load!
-  pl-s-db-cut3
-  (pl-parse "a(1). a(2). g(X) :- a(X), !, fail. g(99)."))
-
-(pl-s-test!
-  "cut then fail blocks alt clauses"
-  (pl-solve-count! pl-s-db-cut3 (pl-s-goal "g(X)" {}) (pl-mk-trail))
-  0)
-
-(define pl-s-db-cut4 (pl-mk-db))
-
-(pl-db-load!
-  pl-s-db-cut4
-  (pl-parse "a(1). b(10). b(20). g(X, Y) :- a(X), !, b(Y)."))
-
-(pl-s-test!
-  "post-cut goal backtracks freely"
-  (pl-solve-count!
-    pl-s-db-cut4
-    (pl-s-goal "g(X, Y)" {})
-    (pl-mk-trail))
-  2)
-
-(define pl-s-db-cut5 (pl-mk-db))
-
-(pl-db-load!
-  pl-s-db-cut5
-  (pl-parse "r(1). r(2). q :- r(X), !. p :- q. p :- true."))
-
-(pl-s-test!
-  "inner cut does not commit outer predicate"
-  (pl-solve-count! pl-s-db-cut5 (pl-s-goal "p" {}) (pl-mk-trail))
-  2)
-
-(pl-s-test!
-  "\\= different atoms succeeds"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "\\=(a, b)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "\\= same atoms fails"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "\\=(a, a)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "\\= var-vs-atom would unify so fails"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "\\=(X, a)" {})
-    (pl-mk-trail))
-  false)
-
-(define pl-s-env-ne {})
-
-(define pl-s-trail-ne (pl-mk-trail))
-
-(define pl-s-goal-ne (pl-s-goal "\\=(X, a)" pl-s-env-ne))
-
-(pl-solve-once! pl-s-empty-db pl-s-goal-ne pl-s-trail-ne)
-
-(pl-s-test!
-  "\\= leaves no bindings"
-  (pl-var-bound? (dict-get pl-s-env-ne "X"))
-  false)
-
-(pl-s-test!
-  "; left succeeds"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal ";(true, fail)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "; right succeeds when left fails"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal ";(fail, true)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "; both fail"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal ";(fail, fail)" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "; both branches counted"
-  (pl-solve-count!
-    pl-s-empty-db
-    (pl-s-goal ";(true, true)" {})
-    (pl-mk-trail))
-  2)
-
-(define pl-s-db-call (pl-mk-db))
-
-(pl-db-load! pl-s-db-call (pl-parse "p(1). p(2)."))
-
-(pl-s-test!
-  "call(true) succeeds"
-  (pl-solve-once!
-    pl-s-db-call
-    (pl-s-goal "call(true)" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "call(p(X)) yields all solutions"
-  (pl-solve-count!
-    pl-s-db-call
-    (pl-s-goal "call(p(X))" {})
-    (pl-mk-trail))
-  2)
-
-(pl-s-test!
-  "call of bound goal var resolves"
-  (pl-solve-once!
-    pl-s-db-call
-    (pl-s-goal "=(G, true), call(G)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-s-db-ite (pl-mk-db))
-
-(pl-db-load! pl-s-db-ite (pl-parse "p(1). p(2). q(yes). q(no)."))
-
-(pl-s-test!
-  "if-then-else: cond true → then runs"
-  (pl-solve-once!
-    pl-s-db-ite
-    (pl-s-goal ";(->(true, =(X, ok)), =(X, fallback))" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-s-env-ite1 {})
-
-(pl-solve-once!
-  pl-s-db-ite
-  (pl-s-goal ";(->(true, =(X, ok)), =(X, fallback))" pl-s-env-ite1)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "if-then-else: cond true binds via then"
-  (pl-atom-name (pl-walk-deep (dict-get pl-s-env-ite1 "X")))
-  "ok")
-
-(pl-s-test!
-  "if-then-else: cond false → else"
-  (pl-solve-once!
-    pl-s-db-ite
-    (pl-s-goal ";(->(fail, =(X, ok)), =(X, fallback))" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-s-env-ite2 {})
-
-(pl-solve-once!
-  pl-s-db-ite
-  (pl-s-goal ";(->(fail, =(X, ok)), =(X, fallback))" pl-s-env-ite2)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "if-then-else: cond false binds via else"
-  (pl-atom-name (pl-walk-deep (dict-get pl-s-env-ite2 "X")))
-  "fallback")
-
-(pl-s-test!
-  "if-then-else: cond commits to first solution (count = 1)"
-  (pl-solve-count!
-    pl-s-db-ite
-    (pl-s-goal ";(->(p(X), =(Y, found)), =(Y, none))" {})
-    (pl-mk-trail))
-  1)
-
-(pl-s-test!
-  "if-then-else: then can backtrack"
-  (pl-solve-count!
-    pl-s-db-ite
-    (pl-s-goal ";(->(true, p(X)), =(X, none))" {})
-    (pl-mk-trail))
-  2)
-
-(pl-s-test!
-  "if-then-else: else can backtrack"
-  (pl-solve-count!
-    pl-s-db-ite
-    (pl-s-goal ";(->(fail, =(X, ignored)), p(X))" {})
-    (pl-mk-trail))
-  2)
-
-(pl-s-test!
-  "standalone -> with true cond succeeds"
-  (pl-solve-once!
-    pl-s-db-ite
-    (pl-s-goal "->(true, =(X, hi))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "standalone -> with false cond fails"
-  (pl-solve-once!
-    pl-s-db-ite
-    (pl-s-goal "->(fail, =(X, hi))" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "write(hello)"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "write(hello)" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "hello")
-
-(pl-s-test!
-  "nl outputs newline"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once! pl-s-empty-db (pl-s-goal "nl" {}) (pl-mk-trail))
-    pl-output-buffer)
-  "\n")
-
-(pl-s-test!
-  "write(42) outputs digits"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "write(42)" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "42")
-
-(pl-s-test!
-  "write(foo(a, b)) formats compound"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "write(foo(a, b))" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "foo(a, b)")
-
-(pl-s-test!
-  "write conjunction"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "write(a), write(b)" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "ab")
-
-(pl-s-test!
-  "write of bound var walks binding"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "=(X, hello), write(X)" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "hello")
-
-(pl-s-test!
-  "write then nl"
-  (begin
-    (pl-output-clear!)
-    (pl-solve-once!
-      pl-s-empty-db
-      (pl-s-goal "write(hi), nl" {})
-      (pl-mk-trail))
-    pl-output-buffer)
-  "hi\n")
-
-(define pl-s-env-arith1 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, 42)" pl-s-env-arith1)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, 42) binds X to 42"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith1 "X")))
-  42)
-
-(define pl-s-env-arith2 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, +(2, 3))" pl-s-env-arith2)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, +(2, 3)) binds X to 5"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith2 "X")))
-  5)
-
-(define pl-s-env-arith3 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, *(2, 3))" pl-s-env-arith3)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, *(2, 3)) binds X to 6"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith3 "X")))
-  6)
-
-(define pl-s-env-arith4 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, -(10, 3))" pl-s-env-arith4)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, -(10, 3)) binds X to 7"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith4 "X")))
-  7)
-
-(define pl-s-env-arith5 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, /(10, 2))" pl-s-env-arith5)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, /(10, 2)) binds X to 5"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith5 "X")))
-  5)
-
-(define pl-s-env-arith6 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, mod(10, 3))" pl-s-env-arith6)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, mod(10, 3)) binds X to 1"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith6 "X")))
-  1)
-
-(define pl-s-env-arith7 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, abs(-(0, 5)))" pl-s-env-arith7)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, abs(-(0, 5))) binds X to 5"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith7 "X")))
-  5)
-
-(define pl-s-env-arith8 {})
-
-(pl-solve-once!
-  pl-s-empty-db
-  (pl-s-goal "is(X, +(2, *(3, 4)))" pl-s-env-arith8)
-  (pl-mk-trail))
-
-(pl-s-test!
-  "is(X, +(2, *(3, 4))) binds X to 14 (nested)"
-  (pl-num-val (pl-walk-deep (dict-get pl-s-env-arith8 "X")))
-  14)
-
-(pl-s-test!
-  "is(5, +(2, 3)) succeeds (LHS num matches)"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "is(5, +(2, 3))" {})
-    (pl-mk-trail))
-  true)
-
-(pl-s-test!
-  "is(6, +(2, 3)) fails (LHS num mismatch)"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "is(6, +(2, 3))" {})
-    (pl-mk-trail))
-  false)
-
-(pl-s-test!
-  "is propagates bound vars on RHS"
-  (pl-solve-once!
-    pl-s-empty-db
-    (pl-s-goal "=(Y, 4), is(X, +(Y, 1)), =(X, 5)" {})
-    (pl-mk-trail))
-  true)
-
-(define pl-solve-tests-run! (fn () {:failed pl-s-test-fail :passed pl-s-test-pass :total pl-s-test-count :failures pl-s-test-failures}))