{
  "markdown": "# The Meaning Model\n\n**Construct worlds coarsely, then develop the parts that matter.** The Meaning\nModel connects world records, concepts, descriptions, understanding, and story\ntext in one addressed representation. Finer detail must respect an accepted\naccount or revise it explicitly.\n\nThis repository brings together the theory, its compact grammar appendix, the\nRust engine and MCP interface, and *The Book of Conditions*, a worked\nconstruction with a complete twelve-chapter manuscript.\n\nSee the [changelog](CHANGELOG.md) for release changes, upgrade notes, and\nunreleased work.\n\n## Read first\n\n- [Meaning Model paper](output/pdf/meaning-model.pdf) - the argument, grammar,\n  construction method, examples, and numerical portrait.\n- [Grammar appendix](output/pdf/meaning-model-grammar.pdf) - a focused reference\n  to the same rules, not a separate theory or additional set of requirements.\n- [The Book of Conditions](output/pdf/the-book-of-conditions.pdf)\n  - the completed story; [Markdown and model sources](examples/book-of-conditions/README.md)\n  are also included.\n\nThe six world-record forms are Concept, Thing, Event, Binding, Cut, and\nRealization. A Cut divides one declared unit among exclusive sibling answers\nand an explicit remainder; its weights sum to one. Ordinary process links are\nunweighted. Dates, money, counts, and physical measurements keep their external\nunits. Understanding Nodes and Document Nodes share the address space without\nacquiring the authority of accepted world facts.\n\n## Try it\n\nThe smallest demonstration requires only Node.js:\n\n```sh\nnode --test examples/refinement-trial/example.test.mjs\n```\n\nIt shows a refinement that fits its parent, a locally valid refinement that\ncontradicts the parent, and an explicit revision. The example is synthetic,\nnot evidence that the full implementation or learning proposal is complete.\n\nFor the Rust engine and MCP tools, install Rust/Cargo, Node.js 22.18 or newer,\nand npm, then run:\n\n```sh\nmake install\nmake build\nmake test\n```\n\nFor a native example, run `node examples/progressive-authoring/run.mjs` after\nbuilding. [Progressive authoring in Rust](examples/progressive-authoring/README.md)\nopens a Cut after accepted history, rejects incompatible detail, completes a\npartial temporal contract, and explicitly revises and continues the same world.\n\nStart the MCP server after building:\n\n```sh\ncd mcp-server\nnpm start\n```\n\nSee the [MCP guide](mcp-server/README.md), [engine guide](rust-engine/README.md),\nand [modeling protocol](docs/MODELING_PROTOCOL.md). Existing `life-sim` command,\nschema, resource, and binary identifiers are retained for compatibility with\nsaved artifacts. They do not identify a second engine.\n\nThe package name is\n[`@emergent-wisdom/meaning-model-mcp`](https://www.npmjs.com/package/@emergent-wisdom/meaning-model-mcp).\nIts official MCP Registry identity is `io.github.emergent-wisdom/meaning-model`,\ndescribed by [`server.json`](server.json). Registry-based clients must supply\nthe path to an explicitly installed or built engine. Install the engine matching\nthe package version. `meaning-model-mcp --install-engine` explicitly downloads\nand verifies that version's published release engine. Alternatively, use\n`meaning-model-mcp --build-engine` to build the included Rust source.\nNeither npm installation nor normal server startup downloads or builds an\nengine. To prepare a local npm tarball, run `make npm-package`. See the\n[package installation guide](mcp-server/NPM-README.md). Creating a tarball does\nnot publish it or establish ownership of the npm scope.\n\n## What is demonstrated\n\nThe Book is a bounded example of model-assisted authorship: macro accounts,\ncomplete lives, local Cuts, event descriptions, linked construction rationales,\nand prose were developed and revised together. Its accepted sources can be\nimported into Rust and the manuscript rendered from document nodes. That\nretrospective import is not a recovered transaction log of the original\nauthoring process.\n\nThe engine implements typed records, immutable revisions, persistence,\ncandidate acceptance, normalized Cuts, and bounded narrative graph operations.\nOptional temporal Cut contracts check explicit answer projections and duration\nmixtures, including whether partial detail leaves a feasible remainder.\nAn accepted world can move to its direct next model revision after time has\nadvanced, with an explicit refinement or revision, a compare-and-swap check,\nand an immutable receipt preserving both heads. Portable narrative training\nand project checkpoint exports across that revision boundary remain unsupported;\nthe session database retains the complete history.\nIt does **not** implement every contract in the paper. The\n[implementation boundary](docs/IMPLEMENTATION.md) distinguishes implemented\nchecks, authoring conventions, and missing behavior. The preregistered matched\ncomparison and independent read-back study remain prospective. Neither a\npassing validator nor an authored numerical portrait establishes historical\ntruth, psychological validity, or an advantage over ordinary writing.\n\n## Repository map\n\n| Path | Contents |\n| --- | --- |\n| `paper/` | Paper and appendix sources, shared style, figures, bibliography |\n| `rust-engine/` | Shared Rust implementation, optional numerical simulation capabilities, tests and examples |\n| `mcp-server/` | MCP interface to that engine |\n| `profiles/` | Reusable authoring conventions, not mandatory human categories |\n| `docs/` | Operational documentation and implementation limits |\n| `examples/refinement-trial/` | Small standalone construction example |\n| `examples/progressive-authoring/` | Native temporal refinement, explicit revision, and continued world history |\n| `examples/book-of-conditions/` | Accepted Book, model sources, rationale nodes, and reproducible export |\n| `output/pdf/` | Ready-to-read paper, grammar appendix, and Book PDFs |\n\nMeaning Model owns the representation and joint construction method. The\nseparate **Life Simulation** project studies process-history generation,\ninference, learning, and their empirical evaluation. It consumes this engine;\nit does not maintain a second implementation. A digest-bound copy of its paper\nis included only as a companion MCP reading resource under\n`docs/companions/life-simulation/`.\n\n## Build the documents\n\nWith `latexmk` and a LaTeX installation containing the imported packages:\n\n```sh\nmake paper\nmake grammar\nmake book\n```\n\nTo check the code, examples, resources, and documents together:\n\n```sh\nmake check\n```\n\n## Release packaging\n\n`make release` checks and builds the package, then exports an allowlisted clean\ndirectory beneath `build/`. The export includes the three PDFs and their\nsources, but not `.git`, build caches, private planning, review transcripts,\nor earlier constructions.\n\nSee the [release guide](docs/RELEASE.md) for packaging and provenance details.\nExporting files does not push to GitHub or publish a package.\n\n## License and citation\n\nOriginal code is [MIT licensed](LICENSE). Original papers, documentation,\nauthored model data, and the Book are [CC BY 4.0](LICENSE-CONTENT).\n[NOTICE](NOTICE) preserves the boundary for third-party material.\n[CITATION.cff](CITATION.cff) identifies the author and preferred paper citation;\nthe repository URL is recorded there, and a DOI will be added when assigned.\n",
  "bytes": 7342,
  "sha": "7009aa091649137bc74dc44f407b2338b8864589bd8509ca2a78661191ba45e9",
  "repo_slug": "emergent-wisdom/meaning-model",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_emergent_wisdom_meaning_model_5a65ab2b/readme"
}