A data structure that maps whatever world it's shown — real or fiction. The memory under the holodeck.
A pattern buffer that never degrades.
One append-only log of perspective-scoped, time-indexed assertions about entities; every other structure — current state, space, knowledge, history, the rendered world — is a disposable projection over it. Fiction simulation and real-world tracking are the same machine under one policy switch.
A player places a pipe in a drawer in session 12 of a D&D campaign. Two hundred sessions pass without a mention. At retirement, the player opens the drawer — and the pipe is there, exactly as placed, with the original moment's full history behind it. No maintenance was ever performed. In this architecture, silence is persistence: state is folded from the log, never re-inferred and never kept alive by mention. The world remembers so the model doesn't have to.
Status: pre-1.0; substrate validated, ingestion fidelity is the open front. The engine passes its 96-test invariant suite, and the chapter test (ingest a complete noir mystery, delete the prose, interrogate the store against a hand-authored answer key) has been graded across three full runs. The substrate's invariants held in all of them — sealed containers stayed sealed, contradictions were flagged and never merged, knowledge frames never leaked, the two-time-axis fold answered late-revealed history correctly. Each run also surfaced exactly one engine refinement at the fold (a working assumption outholding evidence; a wrong inference outholding authored canon), each fixed, tested, and generalized the same day — that progression is now the evidence-rank rule. A registry-first ingestion pipeline (whole-document scaffold → parallel compact-grammar extraction → audited single commit) replaced serial prompt-iterated extraction after measurement showed prose contracts fragment differently every round; identity and key fragmentation died as failure classes, and pass-0 registry quality is where the remaining extraction failures concentrate. Run 4, with its checkable predictions, is in flight. Not yet installable from PyPI; the shipped example world with a zero-API-key query tour lands once a verified run stamps it.
A storage and retrieval substrate that lets a language model maintain a complete, queryable, durable model of a world — places, objects, people, relationships, histories, and unknowns — such that any state question is answered by a deterministic query, never by re-reading prose; the world accretes and is re-enterable; and the same engine serves authored fiction (a holodeck, a campaign, a mystery) and real-world tracking (a household, a job site, a vehicle), differing only in resolution policy and provenance discipline.
The buffer holds the pattern; materialization is re-entry; degradation is the failure we exist to prevent; the arch is how the operator steps outside the world to inspect it; and where nothing has been established, you don't get invented detail — you see the grid.
- docs/WHITEPAPER.md — the canonical, comprehensive design reference. Principles, primitives, durability, frames, provenance, thunks, reference resolution, ingestion discipline, identity, the operation algebra, projection, both modes, embedding hazards, evaluation, and the decision record. Start here.
- docs/LEXICON.md — the working vocabulary and its naming discipline.
- docs/ADOPTION.md — for agents (and humans) integrating the library: exact signatures, typed outcomes, the three-seam recipe, MUST/NEVER rules.
- docs/reference/assertion-world-model-original.md — the framework-agnostic design document this project was founded on, preserved verbatim for lineage.
Recover and commit the Last Honest Meter eval seed (the chapter test's ground truth).Done — v1-final,evals/last_honest_meter/.Engine spike:Done —PatternBuffer+ derived indexes + classifier + projector + resolver +refer()tier 1.src/patternbuffer/.The chapter test, runs 1–3+ run 4 (in flight): substrate validated; registry-first ingestion (INGEST-V2) landed; pass-0 registry quality is the open score lever. Receipts:evals/results/.- The shipped example world:
examples/anchor/— a bible-verified noir mystery as a queryable database, with a zero-API-key scripted tour ("where was the memory core during the assembly?"). Stamps from the first verified run. - The messy-dialogue micro-eval (the honest bridge from fiction ingestion to tracking-mode ingestion).
- The porcelain API (
ingest/snapshot/ask— three verbs, a complete host integration), then host integration (adapter pattern — intended primary host: Kernos; first live host: Construct, an interactive-fiction engine playing worlds on the frozen porcelain today —pattern→constructloads it →holonovel). - The interactive-fiction milestone (thunk stability across sessions, frame-scoped NPCs, multi-path mystery, clocks, loop closure).
- The MCP wrapper — the framework-agnostic claim proven by demonstration: the same five verbs served to non-Python hosts. Far field: the first host's V2 roadmap publicly assigns branch-worlds simulation and its curiosity loop to this engine — the two roadmaps meet in the middle.
MIT