engineering/lumbda
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

www/: static docroot for lumbda.com

Browse source 
Minimal, monospace, readable. Works as a drop-in docroot for
any static server (nginx, caddy, python -m http.server, etc.).
Light/dark mode via prefers-color-scheme. No JS, no fonts, no
third-party anything.

Files:
  www/index.html    landing page (tagline, get-it, four-tier
                    table, portal summary, EML proof blurb,
                    license, whitepaper CTA)
  www/style.css     ~150 lines, CSS vars for theming
  www/robots.txt    allow everything
  www/404.html      referenced by servers that support custom
                    error pages
  www/whitepaper.pdf -> ../whitepaper/lumbda-whitepaper.pdf
                    (symlink — one source of truth, rebuilds
                    via `make whitepaper` auto-propagate)

Smoke-tested with python3 -m http.server: 200 on /,
Content-Type: application/pdf for /whitepaper.pdf,
Content-Length matches the current 2.67 MB PDF,
/robots.txt serves, /nonexistent returns 404.

No new build step — docroot is pure static files the existing
whitepaper target already produces. A web server configured
with docroot=www/ and fallback 404.html has a working lumbda.com
today.
This commit is contained in:
russell@unturf.com 2026-04-19 11:21:56 -04:00
parent 8064dfd646
commit e2a74832ef
5 changed files with 268 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

21
www/404.html Normal file
View file

@ -0,0 +1,21 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>404 &mdash; Lumbda</title>
<link rel="stylesheet" href="/style.css">
</head>
<body>
<header>
<h1>404</h1>
<p class="tagline">that path resolved to nil</p>
</header>
<main>
<p>(<code>lookup</code> returned <code>VAL_FALSE</code>. Try the <a href="/">home page</a> or read the <a href="/whitepaper.pdf">whitepaper</a>.)</p>
</main>
<footer>
<p><a href="/">lumbda</a> &middot; <a href="https://unturf.com">unturf.com</a></p>
</footer>
</body>
</html>

89
www/index.html Normal file
View file

@ -0,0 +1,89 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Lumbda — feedback is the primitive</title>
<meta name="description" content="Lumbda is a Lisp/Scheme-derived language with four execution backends (Python, Python bytecode VM, C + x86_64 JIT, pure x86_64 assembly), full first-class continuations, portal-based state migration, and a formally verified universality proof.">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header>
<h1>Lumbda</h1>
<p class="tagline">feedback is the primitive</p>
</header>
<main>
<section id="what">
<p class="lead">
Lumbda is a Lisp/Scheme-derived language with four independently implemented execution backends sharing one surface syntax and one test suite. A Python tree-walker with an optional bytecode VM, a C implementation that adds an x86_64 JIT, and a pure x86_64 assembly interpreter (~6,600 lines of GNU assembler, ~23 KB stripped, zero external dependencies). Every backend runs the same <code>.lsp</code> source byte-identically, with full first-class continuations, exact rationals, records, and hygienic macros.
</p>
</section>
<section id="quick">
<h2>Get it</h2>
<pre><code>git clone https://git.unturf.com/engineering/unturf/lumbda.git
cd lumbda
make test-all</code></pre>
<p>Run a program in any tier:</p>
<pre><code>python3 lumbda.py --fast examples/fibonacci.lsp
./c/lumbda examples/fibonacci.lsp
./asm/lumbda &lt; examples/fibonacci.lsp</code></pre>
</section>
<section id="tiers">
<h2>Four tiers, one language</h2>
<table>
<thead><tr><th>Tier</th><th>Lines</th><th>Binary</th><th>What it&rsquo;s for</th></tr></thead>
<tbody>
<tr><td>Python interpreter + bytecode VM</td><td>3,743</td><td>&mdash;</td><td>REPL hackability, debugging, reference</td></tr>
<tr><td>C tree-walker + bytecode VM</td><td>9,164</td><td>~215 KB</td><td>deep recursion, production workloads</td></tr>
<tr><td>C + x86_64 JIT</td><td>+patches</td><td>~215 KB</td><td>7&ndash;10&times; faster than CPython on recursive workloads</td></tr>
<tr><td>Pure x86_64 assembly</td><td>6,645</td><td>~23 KB</td><td>zero-dependency boot, auditability, embedded</td></tr>
<tr><td>Assembly + naive mark-sweep GC + meta-GC arena</td><td>(same source, <code>GC_NAIVE=1</code>)</td><td>~27 KB</td><td>bounded memory without manual arena discipline</td></tr>
</tbody>
</table>
</section>
<section id="portal">
<h2>Portal: feedback across time</h2>
<p>A continuation is feedback within a process. A portal is feedback across processes. Same primitive, different scope: capture machine state, serialize it, reload it elsewhere, resume. Lumbda ships three portal formats with different trade-offs:</p>
<ul>
<li><strong>S-expression portal</strong> &mdash; Scheme source as the wire protocol. 16 of 16 producer&times;consumer cells green across Python, C, asm no-GC, and asm GC.</li>
<li><strong>JSON portal</strong> &mdash; graph-aware, preserves closures and live continuations (Python, C).</li>
<li><strong>Binary heap dump</strong> &mdash; asm only. 1.5 ms save+resume between two processes.</li>
</ul>
</section>
<section id="proof">
<h2>The EML universality proof</h2>
<p>A single operator <code>eml(x, y) = exp(x) &minus; ln(y)</code> with the constant 1 generates all elementary functions: <code>exp</code>, <code>ln</code>, arithmetic, negation, complex-plane access, trigonometry. Verified numerically in Python, verified in Lumbda&rsquo;s own bytecode, proven formally in Lean 4 with zero <code>sorry</code>. Lumbda&rsquo;s native symbolic-rewrite checker runs the five theorems in 46 ms cold or 7 ms cached &mdash; roughly 16&times; faster than Lean&rsquo;s cold rebuild on the same hardware.</p>
</section>
<section id="doc">
<h2>Read the whitepaper</h2>
<p>Full language reference, tier-by-tier architecture, benchmarks, the meta-GC design, and the universality proof.</p>
<p><a class="cta" href="whitepaper.pdf">Lumbda whitepaper (PDF, ~2.7 MB)</a></p>
</section>
<section id="license">
<h2>License</h2>
<p>AGPL-3.0-only. Public domain for whitepapers, proofs, and disclosures through <a href="https://undefect.com">undefect.com</a>. Companion to <a href="https://unturf.com">unturf.com</a>&rsquo;s permacomputer project.</p>
</section>
</main>
<footer>
<p>
<a href="https://git.unturf.com/engineering/unturf/lumbda">source</a>
&middot;
<a href="whitepaper.pdf">whitepaper</a>
&middot;
<a href="https://unturf.com">unturf.com</a>
</p>
</footer>
</body>
</html>

2
www/robots.txt Normal file
View file

@ -0,0 +1,2 @@
User-agent: *
Allow: /

155
www/style.css Normal file
View file

@ -0,0 +1,155 @@
/* lumbda.com — minimal, monospace, readable */
:root {
--fg: #1a1a1a;
--bg: #fafaf7;
--muted: #666;
--accent: #0b5394;
--rule: #d4d4d0;
--code-bg: #f0ede4;
}
@media (prefers-color-scheme: dark) {
:root {
--fg: #e8e6e0;
--bg: #161613;
--muted: #9a9892;
--accent: #6fa8dc;
--rule: #3a3a36;
--code-bg: #22221f;
}
}
* { box-sizing: border-box; }
html {
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "DejaVu Sans Mono", monospace;
font-size: 15px;
line-height: 1.55;
color: var(--fg);
background: var(--bg);
}
body {
max-width: 720px;
margin: 0 auto;
padding: 2.5rem 1.25rem 4rem;
}
header {
border-bottom: 1px solid var(--rule);
padding-bottom: 1.5rem;
margin-bottom: 2rem;
}
header h1 {
font-size: 2.4rem;
margin: 0;
letter-spacing: -0.02em;
}
.tagline {
color: var(--muted);
margin: 0.25rem 0 0;
font-size: 1rem;
}
main h2 {
font-size: 1.15rem;
margin-top: 2.5rem;
margin-bottom: 0.75rem;
border-bottom: 1px solid var(--rule);
padding-bottom: 0.25rem;
}
.lead {
font-size: 1.05rem;
line-height: 1.65;
}
p { margin: 0.75em 0; }
a {
color: var(--accent);
text-decoration: underline;
text-decoration-thickness: 1px;
text-underline-offset: 2px;
}
a:hover { text-decoration-thickness: 2px; }
code {
background: var(--code-bg);
padding: 1px 4px;
border-radius: 2px;
font-size: 0.92em;
}
pre {
background: var(--code-bg);
padding: 0.75rem 1rem;
overflow-x: auto;
border-left: 3px solid var(--accent);
font-size: 0.9rem;
line-height: 1.45;
}
pre code {
background: transparent;
padding: 0;
border-radius: 0;
font-size: inherit;
}
table {
border-collapse: collapse;
width: 100%;
margin: 1rem 0;
font-size: 0.9rem;
}
th, td {
text-align: left;
padding: 0.45rem 0.6rem;
border-bottom: 1px solid var(--rule);
vertical-align: top;
}
th {
font-weight: 600;
color: var(--muted);
border-bottom: 2px solid var(--rule);
}
tbody tr:last-child td { border-bottom: none; }
ul {
padding-left: 1.25rem;
}
li { margin: 0.25rem 0; }
.cta {
display: inline-block;
margin-top: 0.5rem;
padding: 0.5rem 0.9rem;
border: 1px solid var(--accent);
text-decoration: none;
font-weight: 600;
}
.cta:hover {
background: var(--accent);
color: var(--bg);
}
footer {
margin-top: 4rem;
padding-top: 1.5rem;
border-top: 1px solid var(--rule);
color: var(--muted);
font-size: 0.9rem;
text-align: center;
}
footer a { color: var(--muted); }

1
www/whitepaper.pdf Symbolic link
View file

@ -0,0 +1 @@
../whitepaper/lumbda-whitepaper.pdf