1# The documentation23These documents describe the repository as it stands. History, where it is4needed, is a pointer rather than a chapter: the pre-rewrite tree is archived5on the `golden-reference` tag (mirrored at `archive/golden-reference`), the6calls the rewrite made are dated records under [`decisions/`](decisions/), and7the behavioral differences accepted against the archived reference are8[decision 18](decisions/0018-divergences-from-the-reference.md).910Read in this order to learn the system: [`format.md`](format.md) is the centre,11[`authoring.md`](authoring.md) is how a volume comes to be,12[`app.md`](app.md) is what serves it,13[`render-seam.md`](render-seam.md) and [`analysis.md`](analysis.md) are what14pictures it, and [`decisions/`](decisions/) is why any of it is shaped this way.1516## The documents1718| Document | What it is |19|---|---|20| [`format.md`](format.md) | Normative native schema-bundle spec: semantic graph, typed blocks, compatibility, release ordering, validation, and install. |21| [`format-v3.md`](format-v3.md) | Historical specification for the retired document-shaped format; current readers do not install it. |22| [`authoring.md`](authoring.md) | The single-manifest authoring contract: plan, capture, observe, assemble, compile, publish, and workbench handoff. |23| [`semconv/REGISTRY.md`](semconv/REGISTRY.md) | The attribute vocabulary, generated from `spec/registry.yaml`; `spec/gen`'s own test holds the committed copy up to date. |24| [`generate.md`](generate.md) | Historical generate pipeline retained for fixture migration and corpus tests. |25| [`enrich.md`](enrich.md) | Historical enrichment pipeline plus the current maturity score. |26| [`analysis.md`](analysis.md) | The cell-system contract: the eighteen methods, coordinates and continuity, the `Ground` descriptor, the plan order, the style tokens. §9 is the "add a third system" checklist. |27| [`app.md`](app.md) | The hypermedia application: routes, the session record, regions and partials, the state island, the hostenv contract and the three-host story. |28| [`render-seam.md`](render-seam.md) | The brief for rewriting `render/` blind: the scene description, the standing set, the chart, the globe, the diagnostics duty. §10.1 names what the document does not carry. |29| [`workbench.md`](workbench.md) | The operator's surface: its pages, its operations, the operation runner as a consumable library, and the safety properties. |30| [`snapshots.md`](snapshots.md) | The reusable scheduled-build workflow a city runs over its own data, and the one-time setup it needs. |31| [`testing.md`](testing.md) | The whole test surface: `make test`, `make test-e2e`, `make corpus-smoke`, what tests are made of, where they live, and the bar for a new one. |32| [`releasing.md`](releasing.md) | Native macOS, Linux, and Windows packaging, signing inputs, file associations, and the draft-first publication transaction. |33| [`stamps.md`](stamps.md) | What a build stamp is a promise of, why it cannot be recomputed from a bundle, and what is enforced instead. |34| [`logging.md`](logging.md) | The one event stream: levels, the shared attribute keys, handler and flag conventions for the CLI and the browser. |35| [`decisions/`](decisions/) | Dated records of the calls that shaped all of the above, each with its context and consequences. |