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

1 files changed, 55 insertions, 0 deletions

diff --git a/tests/drivers/cli_help_test.py b/tests/drivers/cli_help_test.py
new file mode 100644
index 0000000..1b32fa4
--- /dev/null
+++ b/tests/drivers/cli_help_test.py
@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""bounded command-line help and option rejection contracts."""
+import argparse
+import os
+import subprocess
+from pathlib import Path
+
+parser = argparse.ArgumentParser()
+parser.add_argument('--group', choices=['binaries', 'scripts', 'js', 'all'], default='all')
+parser.add_argument('--bin-dir', default='bin')
+args = parser.parse_args()
+commands = []
+if args.group in ('binaries', 'all'):
+    commands += [[str(Path(args.bin_dir) / name)] for name in ['zy', 'zym', 'zclsp', 'zc0', 'mkgenome', 'genmap']]
+if args.group in ('scripts', 'all'):
+    commands += [['bash', name] for name in ['tinyvm.sh', 'src/tools/zcc', 'src/tools/automap.sh', 'src/tools/embed.sh', 'src/tools/mklsp.sh', 'src/tools/mklspwasm.sh', 'src/tools/mkvsix.sh', 'src/web/build.sh', 'src/baremetal/run.sh']]
+if args.group in ('js', 'all'):
+    commands += [['node', name] for name in ['src/js/tinyvm.js', 'src/js/extract_genome.js', 'src/js/extract_lsp.js']]
+
+def invoke(command, option):
+    # keep stdin open: help and rejected options must finish without reading it.
+    env = dict(os.environ, TINYVM_MEMORY_WORDS='invalid', TINYVM_MAX_MEMORY_WORDS='invalid')
+    child = subprocess.Popen([*command, option], stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, env=env)
+    try:
+        child.wait(timeout=3)
+        return child.returncode, child.stdout.read(), child.stderr.read()
+    finally:
+        if child.poll() is None:
+            child.kill()
+            child.wait()
+        child.stdin.close()
+        child.stdout.close()
+        child.stderr.close()
+
+failures = 0
+for command in commands:
+    try:
+        for option in ['--help', '-h']:
+            status, out, err = invoke(command, option)
+            assert status == 0 and b'usage:' in out.lower() and not err, (option, status, out[:200], err[:200])
+        status, out, err = invoke(command, '--unknown-option')
+        assert status > 0 and err and not out, (status, out[:200], err[:200])
+        print('ok   help and option rejection: ' + ' '.join(command))
+    except (AssertionError, subprocess.TimeoutExpired) as error:
+        failures += 1
+        print('FAIL ' + ' '.join(command) + ': ' + str(error))
+if args.group in ('binaries', 'all'):
+    source = b'int identity(int n) { return n; }\n'
+    for option in ['--format', '--annotate', '--types']:
+        result = subprocess.run([str(Path(args.bin_dir) / 'zclsp'), option], input=source, capture_output=True, timeout=10)
+        assert result.returncode == 0 and not result.stderr, (option, result.stdout, result.stderr)
+        if option != '--types':
+            assert b'identity' in result.stdout, (option, result.stdout)
+    print('ok   lsp source options remain available alongside help')
+raise SystemExit(bool(failures))