From 1c53304d03414890af0da7432d1aea87e754a14a Mon Sep 17 00:00:00 2001
From: Moon Flower <moonflower@elhenney.local>
Date: Wed, 14 Oct 2026 08:29:46 +0330
Subject: feat: grow memory limits, add icon/actor libraries, overhaul LSP
 diagnostics

Compiler and VM
- make every memory map limit dynamic and adjustable at both build time and
  runtime, including compiler tables, stacks, and every execution region
- reserve and grow tables, operand and return stacks, frame segments, and
  image-building output without relocating live code or globals
- rename i/o and string helpers consistently (puts -> put_s, putn -> put_n,
  scat -> cat_s) across compiler, runtime, examples, tests, and docs
- recast and consume values assigned to globals from inside functions
- allow fixed and const together, add typed closure returns (fn:t(...)),
  multi-include syntax (include rt, run, core;), and recurse type inference
- never infer string literals as word, anywhere, as argument, variable, or
  return type
- draft docs/BORROW.md: a borrow checker less intrusive than Rust's but more
  intelligent

LSP and editor integration
- require explicit includes and give every toolchain area its own namespace
  (rt, lsp, run, core)
- hover for built-in types, inferred types, values known at hover time, array
  and pointer lifetime/size, library names in include statements, and inferred
  lifetimes with explanations
- honor /* */ comments as documentation for variables and arguments, and stop
  misattributing section headers or trailing comments as variable hints
- stream diagnostics and cancel stale requests on change
- jump to definition and references, including cross-file
- quick fixes with automatic library import, and namespace completion

Hints and diagnostics
- render hints as blue squigglies by default, with hints on/small/off per file
- suppress magic-number hints via a preceding /* */ comment, and say so
- warn on unused arguments; allow multiple _ discards in parameters, pattern
  matching, and tagged enums, warning if a _ is actually used
- rewrite hint and comment prose in professional compiler-doc register

Libraries
- add icon.zc: run-time self-modification, find/replace syntax, type and block
  edits, and step-through inspection of locals and globals
- add actor.zc: async actors with Actor<I,O>, implicit this, spawn/recv/send,
  injected into the compiler machinery at include time rather than built in

Tooling and docs
- reorganize sources, tests, and designs into subdirectories
- unify windows entry points in tinyvm.bat and add a matching tinyvm.sh
- add --help across the toolchain
- polish the learning guide, stdlib docs, and design notes

Tests
- add accept, reject, and regression coverage across the compiler, LSP,
- runtime, icon, actors, threads, formatting, and the toolchain contracts,
  plus fuzzers and property tests
---
 src/runtime/run.zc | 41 ++++++++++++++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 9 deletions(-)

(limited to 'src/runtime/run.zc')

diff --git a/src/runtime/run.zc b/src/runtime/run.zc
index 60193a7..a8f82e2 100644
--- a/src/runtime/run.zc
+++ b/src/runtime/run.zc
@@ -1,27 +1,50 @@
+namespace run;
+include rt;
+
 // run-only image: the runtime, a collector root set, and start. there is no
 // resident compiler and none of its tables. put this between rt.zc and a
-// program that defines main, and compile with zc0 (the program has to stay in
-// the stage-0 subset: no types, no quote, no parse words).
+// program that defines main. zc0 accepts the bootstrap subset; build.zc uses
+// the self-hosted compiler for typed programs and library receiver methods.
 //
 //   cat build/run/rt.zc src/runtime/run.zc examples/hello.zc | ./zc0 >build/run/genome.h
 
 // the program's entry point, written by the program (see start).
+namespace;
 int main();
+namespace run;
+include rt;
 
 // the collector's roots: the code and globals, the program's frames and the
 // operand stack. the collector marks from these before it frees anything.
 int gc_roots() {
-	markrange(0, CODE_END);
-	markrange(GORG, GORG[6]);
-	gc_frames();
-	markrange(dsp(), data_top);
+	rt.markrange(0, rt.CODE_END);
+	rt.markrange(rt.GORG, rt.GORG[6]);
+	rt.gc_frames();
+	rt.markrange(rt.dsp(), rt.data_top);
+	return 0;
+}
+
+// install enhancement descriptors from the image's symbol table before any
+// runtime arithmetic uses their opcodes. kind 6 is an enhancement record.
+int install_enhancements() {
+	word p = rt.GORG[5], name;
+	while (*p) {
+		if (p[0] == 6 && rt.install(p[2] >> 8) < 0) {
+			rt.put_s("run: cannot install image enhancement\n");
+			rt.syscall(rt.SYS_EXIT, 2, 0, 0);
+		}
+		name = p + 3;
+		while (*name) name++;
+		p = name + 1;
+	}
 	return 0;
 }
 
-// the first code a run-only image executes: it sets up the heap, runs main and halts.
+// the first code a run-only image executes: initialize the runtime, run main and halt.
 int start() {
-	heap_init();
+	install_enhancements();
+	rt.heap_init();
 	main();
-	halt();
+	rt.halt();
 	return 0;
 }
-- 
cgit v1.2.3