Meaning Model

Construct worlds coarsely, then develop the parts that matter. The Meaning Model connects world records, concepts, descriptions, understanding, and story text in one addressed representation. Finer detail must respect an accepted account or revise it explicitly.

This repository brings together the theory, its compact grammar appendix, the Rust engine and MCP interface, and The Book of Conditions, a worked construction with a complete twelve-chapter manuscript.

See the changelog for release changes, upgrade notes, and unreleased work.

Three workflows in one server

One MCP server covers three kinds of work over the same engine and graph:

• Modeling. General-purpose, revisable world models of whatever you choose to model, such as a market, an institution or a technology, with an optional Jev estimator for cheap first estimates. See general-purpose modeling.
• Narration. The storytelling add-on writes fiction from a model, with an author model, whole-life character trends, scene review, alignment audits and deepening passes. See the storytelling add-on guide.
• Ideation. The alien add-on searches for solution mechanisms through invented worlds, following Ontology of the Alien, and curates them into a revisable map of idea families. See the alien add-on guide.

Modeling is always available; the two add-ons are opt-in with MEANING_MODEL_ADDONS. Each workflow keeps what it does as revisable, inspectable structure. None of them turns an estimate, a review or an idea into evidence.

The construction record

Version 0.5.0 bundles a browser viewer. Ask the connected assistant to “Open this model”; life_model_viewer_open returns a local link to the chosen model or graph revision. No separate viewer checkout or special run folder is required. It is a read-only snapshot; reopen after changes. The browser must run on the same computer as the MCP. See the viewer guide for supported views and access requirements.

Reading position is independent of world time: selecting a passage highlights its model links, while reading opens separately. Optional document spans stay attached to stable passage boundaries as text changes. Concepts, world events, author records and the telling can remain distinct while Understanding Nodes connect them freely; a connection does not make their clocks or authority identical.

The model and its Understanding Graph are the modeler's understanding, not a report about it: what is done and not recorded cannot be picked up by the next agent. Every Event that carries a Cut has a description of what happens in it, so its numbers mean something. Choices, ideas, predictions and voice decisions are recorded as Understanding Nodes linked to the events, Cuts and passages they concern, and outside reviews are recorded under their actual reviewers. life_model_outline shows the present state with its notes at a chosen depth, and life_construction_replay replays the whole development step by step, each note beside the records as they were when it was written. A model that continues someone else's story or model replays it first. life_construction_export and life_construction_import carry the whole history to another engine with the same hashes, so the worked examples can be replayed anywhere.

Choose the model your application needs

Model only what serves your purpose. Choose the processes, categories, relationships, and level of detail; use a supplied template, adapt its output, or author a model directly. A single process is a valid starting point. A browser, learning tool, or relationship application need not build the same account of a person, or a complete person model at all.