Gunnar

nordisk/nornir

.nornir/book.toml

# Doc-book manifest — the curated section order for `nornir docs book`.
#
# Doctrine: docs/book.pdf MIRRORS the source. The front matter (README/CHANGELOG)
# and the sections below are the authoritative, source-derived body. Every
# `.nornir/*.md` NOT named here falls through automatically to the back-matter
# `Tankegångar` appendix (working notes / musings — explicitly non-authoritative).
#
# To promote a note into the curated body, add its filename to a section — but
# only if it still mirrors what the code actually does. When in doubt, leave it
# out: it stays in Tankegångar, nothing is lost.
#
# NOTE: the release docs moved to dwarves/.nornir (release orchestration migrated,
# doctrine L5a). Formerly-listed release-*/completeness-gate/aut5-surface-coverage-gate/
# incremental-republish entries now live in the dwarves doc-book, not here.

[[section]]
title = "Design & Architecture"
files = [
  "design.md",
  "architecture-wiring.md",
  "warehouse.md",
  "warehouse-schema.md",
  "mimir-datastructure-manual.md",
  "data-root.md",
  "timetravel-graph.md",
  "job-engine.md",
  "clone-event-stream.md",
  "data-submit-rpcs.md",
  "deep-scan-pipeline.md",
  "freshness.md",
  "live-run-warehouse.md",
  "metro-warehouse-read-and-emitter.md",
  "self-emitters.md",
  "cli-command-contract.md",
  "nornir-error-codes.md",
  "cli-client-modes.md",
  "cli-command-map.md",
  "mode-matrix.md",
  "docs-generation.md",
  "generator-backends.md",
  "vector.md",
  "vector-cpu-simd.md",
  "vector-ragnar-reuse.md",
  "embedder-selection.md",
  "scip-resolved-knowledge.md",
  "mimir-analyze-duplicates.md",
  "test-matrix.md",
  "test-history.md",
  "test-bench-chains.md",
  "coverage-maven.md",
  "funnel-intake.md",
  "funnel-decompose.md",
  "funnel-cards.md",
  "bakeoff.md",
  "bakeoff-judge.md",
  "autonom.md",
]

[[section]]
title = "Viz — the time-travel visualizer"
files = [
  "viz-modes.md",
  "viz-architecture-tab.md",
  "viz-remote-rpcs.md",
  "viz-introspection.md",
  "viz-functional-matrix.md",
  "viz-action-trail.md",
  "viz-operation-buttons.md",
  "viz-md-matrix.md",
  "viz-preflight.md",
  "arch-tab-live.md",
  "top-bar-component.md",
  "bench-live-pane.md",
  "test-matrix-always-visible.md",
  "theming-and-facett-migration.md",
]

[[section]]
title = "Operations & Setup"
files = [
  "running-as-a-server.md",
  "creating-a-workspace.md",
  "workspace-add.md",
  "workspace-autopopulate.md",
  "local-llm-setup.md",
  "vector-rocm.md",
  "howto-remote-collaborator.md",
  "howto-viz-operations.md",
  "mcp-tools.md",
  "mcp-relay-client.md",
  "mcp-from-claude-code.md",
]

# The "<repo> for idiots" guide: worked examples (which MUST be tested when
# inserted — they mirror real behavior) plus the reasoning and explanations
# behind them. Onboarding, not reference.
[[section]]
title = "nornir for idiots"
files = [
  "nornir-for-dummies.md",
  "autonom-for-idiots.md",
  "cli-thin-client-for-idiots.md",
  "bench-vs-test-for-idiots.md",
  "mcp-second-agent-for-idiots.md",
]