Prologue · Buenos Aires, 1945
In a story by Jorge Luis Borges, a man goes down to a cellar and finds, under the nineteenth step, a point a few centimetres wide that holds the whole universe. Every place at once, seen from every angle, and nothing blurred into anything else.
«todos los lugares del orbe, vistos desde todos los ángulos» — J. L. Borges, El Aleph
Aleph took its name, and the names of its parts, from that cellar and from another story of his, about a world invented by a secret society of encyclopaedists. Each part does in code what the place does in the fiction.
I · Aleph
The point that holds the whole program.
Borges could only list what he saw, one thing after another. An agent opening an Aleph file sees it all at once:
the one permission the program asks for, written once at the top; every example it promises to satisfy, and whether it does; every node by its name, from n0 onward; every function that calls every other; the error a missing line would raise and the exact node to fix; the same program as the interpreter runs it and as the machine runs it, byte for byte. And nothing confused with anything else.
One canonical form per program. The formatter refuses any other, so two agents writing the same function write the same file.
$ aleph fmt add.aph
fn add a:i64 b:i64 -> i64
ex add 2 3 = 5
let s + a b
s
Out of order, the same function is rejected with F001 not in canonical form, and the diagnostic carries the canonical text to paste back.