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, 58 insertions, 0 deletions

diff --git a/tests/drivers/tools_contract_test.py b/tests/drivers/tools_contract_test.py
new file mode 100644
index 0000000..df02b2b
--- /dev/null
+++ b/tests/drivers/tools_contract_test.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+"""bounded accept/reject tests for standalone build tools and generated images."""
+import argparse
+import re
+import struct
+import subprocess
+import tempfile
+from pathlib import Path
+
+parser = argparse.ArgumentParser()
+parser.add_argument('--group', choices=['image', 'map', 'runners'], default='image')
+args = parser.parse_args()
+
+def command(argv, data=None):
+    r = subprocess.run(argv, input=data, capture_output=True, timeout=15)
+    assert r.returncode >= 0, (argv, r.returncode, r.stderr)
+    return r
+
+if args.group == 'image':
+    source = Path('src/core/genome.h').read_text()
+    body = source.split('{', 1)[1].split('}', 1)[0]
+    words = [int(x) for x in re.findall(r'-?\d+', body)]
+    pack = lambda xs: b''.join(struct.pack('<q', x) for x in xs)
+    good = command(['bin/mkgenome'], pack(words))
+    assert good.returncode == 0 and f'#define GLEN {len(words)}'.encode() in good.stdout
+    for data in [b'', b'x', pack(words[:6]), pack(words) + b'x']:
+        r = command(['bin/mkgenome'], data)
+        assert r.returncode != 0 and b'incomplete' in r.stderr
+    for index in range(3):
+        changed = words[:]; changed[index] ^= 2
+        r = command(['bin/mkgenome'], pack(changed))
+        assert r.returncode != 0 and b'not a genome' in r.stderr
+    print('ok   mkgenome roundtrip, truncation, alignment and map-header mutation contracts')
+elif args.group == 'map':
+    for preset in ['default', 'small', 'run', 'lsp', 'fixed']:
+        with tempfile.TemporaryDirectory(prefix='tinyvm preset ') as directory:
+            r = command(['bin/genmap', '--preset', preset, '-o', directory])
+            assert r.returncode == 0, (preset, r.stderr)
+            assert (Path(directory) / 'memmap.h').is_file()
+    assert command(['bin/genmap', '--preset', 'default', '--check']).returncode == 0
+    for options in [['--words', '-1'], ['--heap', '0'], ['--data', '0'], ['--symbols', '-1'], ['--total', '999999999999999999999'], ['--preset', 'imaginary']]:
+        r = command(['bin/genmap', *options, '--check'])
+        assert r.returncode != 0, options
+    with tempfile.TemporaryDirectory(prefix='tinyvm map ') as directory:
+        r = command(['bin/genmap', '--preset', 'small', '--locals', '32', '--symbols', '64', '-o', directory])
+        assert r.returncode == 0, r.stderr
+        for name in ['memmap.h', 'rt.zc', 'compiler.zc', 'map.txt']:
+            assert (Path(directory) / name).is_file(), name
+    print('ok   genmap presets, invalid capacities and generated paths containing spaces')
+else:
+    r = command(['bash', '-n', 'tinyvm.sh'])
+    assert r.returncode == 0, r.stderr
+    for script in ['src/tools/automap.sh', 'src/tools/mklsp.sh', 'src/tools/mklspwasm.sh', 'src/tools/mkvsix.sh', 'src/tools/embed.sh']:
+        assert command(['bash', '-n', script]).returncode == 0
+    assert command(['bash', 'tinyvm.sh', 'imaginary-command']).returncode != 0
+    assert Path('tinyvm.bat').is_file()
+    assert not list(Path('.').glob('run*.bat')), 'windows run files must be consolidated'
+    print('ok   runner and build script syntax; unsupported commands fail explicitly')