russell@unturf.com
f7352b51b0
Historical internal name "uncommonlisp" retired in favor of the
public name "lumbda" ahead of lumbda.com going live. Scope of
this commit:
Source files renamed:
uncommonlisp.py -> lumbda.py
asm/uncommonlisp.s -> asm/lumbda.s
c/uncommonlisp.h -> c/lumbda.h
whitepaper/uncommonlisp-whitepaper -> whitepaper/lumbda-whitepaper (.rst + .pdf)
Binaries renamed (tracked ones; c/ was always gitignored):
asm/uncommonlisp, asm/uncommonlisp-gc, asm/uncommonlisp.o,
asm/uncommonlisp-gc.o -> asm/lumbda(-gc)(.o)
c/.gitignore -> ignores lumbda
Internal string updates (sed pass ordered longest-first):
asm/uncommonlisp -> asm/lumbda
c/uncommonlisp -> c/lumbda
uncommonlisp.py -> lumbda.py
UNCOMMONLISP_BIN -> LUMBDA_BIN (asm/test.sh env var)
"uncommonlisp> " -> "lumbda> " (asm REPL prompt baked into binary)
UNCOMMONLISP -> LUMBDA (macros, comments)
uncommonlisp -> lumbda (prose)
Binary portal magic updated:
"ULPORTAL" -> "LUMBDAB1" # "Lumbda Binary v1"
Old portal files are not backward-compatible — this is a deliberate
break since it's the rename moment. S-expression portals already
carry their own ";; lumbda-portal v1" header and remain cleanly
versioned.
WHITEPAPER.pdf / WHITEPAPER.rst symlinks repointed to the renamed
files. Makefile's whitepaper target targets lumbda-whitepaper.pdf.
Not changed (intentional, separate phases):
- Filesystem directory /home/fox/git/uncommonlisp itself
(fox renames locally and the gitlab repo URL in a follow-up)
- tests.py hardcoded cwd=/home/fox/git/uncommonlisp
(matches the current on-disk location; will flip when the
directory rename ships)
- Git history (immutable; old commits still say uncommonlisp,
which is correct — that's what they were)
Verified:
137 asm no-GC + 137 asm GC + 571 Python + 83 C + 189 shared
functional tests all pass under the new names.
bench-gc-http (2000 req): all 4 cells behave as expected
(cells 1/2 flat, 3 leaks, 4 bounded at 1 chunk).
Python REPL, C REPL, asm REPL all start cleanly.
71 lines
2.6 KiB
Text
71 lines
2.6 KiB
Text
// C implementation architecture
|
|
// "A diagram is worth 10,000 words." — russell@unturf.com
|
|
digraph c_arch {
|
|
rankdir=TB
|
|
node [shape=box, style=filled, fontname="Helvetica"]
|
|
edge [fontname="Helvetica", fontsize=10]
|
|
|
|
subgraph cluster_input {
|
|
label="Input"
|
|
style=dashed
|
|
source [label=".lsp source" fillcolor="#e8f4fd"]
|
|
cli [label="CLI flags\n-e --fast --jit" fillcolor="#e8f4fd"]
|
|
}
|
|
|
|
subgraph cluster_frontend {
|
|
label="Frontend (reader.c)"
|
|
style=rounded
|
|
color="#666666"
|
|
tokenizer [label="Tokenizer\nregex-free\nchar-by-char" fillcolor="#fff3cd"]
|
|
parser [label="Parser\nrecursive descent\n→ Pair/Value AST" fillcolor="#fff3cd"]
|
|
}
|
|
|
|
subgraph cluster_types {
|
|
label="Types (types.c, lumbda.h)"
|
|
style=rounded
|
|
color="#666666"
|
|
nanbox [label="NaN-Boxing\n64-bit doubles\ntype tags in NaN payload\nzero-alloc numbers" fillcolor="#e2d5f1"]
|
|
intern [label="Symbol Interning\nhash table" fillcolor="#e2d5f1"]
|
|
pairs [label="Cons Cells\n16 bytes (car+cdr)" fillcolor="#e2d5f1"]
|
|
envs [label="Environment\nhash-map bindings\nparent chain + global shortcut" fillcolor="#e2d5f1"]
|
|
}
|
|
|
|
subgraph cluster_eval {
|
|
label="Three Execution Tiers"
|
|
style=rounded
|
|
color="#666666"
|
|
|
|
interp [label="Tree-Walker\nleval()\nTCO via while loop\nall special forms" fillcolor="#d4edda"]
|
|
bytecode [label="Bytecode VM\ncompile → execute\nsuperinstructions\nSELF_TAIL_CALL" fillcolor="#cce5ff"]
|
|
jit [label="x86_64 JIT\nmmap(PROT_EXEC)\nnative machine code\nif/cond/let/named-let\ncar/cdr/cons\n10-24x faster than CPython" fillcolor="#ff6b6b" fontcolor=white]
|
|
}
|
|
|
|
subgraph cluster_jit_detail {
|
|
label="JIT Pipeline (jit.c)"
|
|
style=rounded
|
|
color="#cc0000"
|
|
analyze [label="AST Analysis\ncan_jit_proc()" fillcolor="#ffcccc"]
|
|
emit [label="x86_64 Emission\nmov/add/sub/cmp\ncall/ret/jmp" fillcolor="#ffcccc"]
|
|
mmap [label="mmap()\nPROT_READ|WRITE|EXEC\nfunction pointer" fillcolor="#ffcccc"]
|
|
}
|
|
|
|
source -> tokenizer
|
|
cli -> tokenizer
|
|
tokenizer -> parser
|
|
parser -> interp [label="default"]
|
|
parser -> bytecode [label="--fast"]
|
|
parser -> analyze [label="--jit"]
|
|
analyze -> emit [label="jittable"]
|
|
analyze -> interp [label="fallback" style=dashed]
|
|
emit -> mmap
|
|
mmap -> jit [label="JitFunc"]
|
|
interp -> envs
|
|
bytecode -> envs
|
|
jit -> nanbox [label="unbox/rebox"]
|
|
envs -> nanbox
|
|
nanbox -> intern
|
|
nanbox -> pairs
|
|
|
|
{rank=same; interp; bytecode; jit}
|
|
{rank=same; analyze; emit; mmap}
|
|
}
|