feat: add model index routing

.claude/rules/wiki/cli.md

@@ -0,0 +1,16 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/cli/**"
+---
+
+Domain: cli. citty-based subcommand dispatch (serve/validate/export/index/version/update); `dict`/`graph`/`flow` are removal stubs; model-root discovery + interactive picker; port fallback + browser open on serve; self-update + version reporting
+
+Map:
+  - docs/wiki/cli.md
+Contracts:
+  - docs/spec/cli-and-outputs.md
+Designs:
+  - docs/design/cli-and-outputs.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/docs.md

@@ -0,0 +1,18 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "docs/design/**"
+  - "docs/guides/**"
+  - "docs/research/**"
+  - "docs/spec/**"
+  - "docs/glossary.md"
+---
+
+Domain: docs. Design docs, user guides, research notes, and implementation-contract specs — 76 markdown files plus `docs/glossary.md` across `docs/design/`, `docs/guides/`, `docs/research/`, `docs/spec/`
+
+Map:
+  - docs/wiki/docs.md
+Related:
+  - docs/wiki/feature-map.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/flow-view.md

@@ -0,0 +1,23 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/flow-view/**"
+---
+
+Domain: flow-view. ELK-driven DFD layout (5-band partitioning, orthogonal edge routing); pure coord helpers for polyline rendering; SVG renderer consumes ELK positions + edgeRoutes + search-token dimming
+
+Map:
+  - docs/wiki/flow-view.md
+Contracts:
+  - docs/spec/dfd-edge-hover-data.md
+  - docs/spec/dfd-overhaul.md
+  - docs/spec/graph-flow-search.md
+  - docs/spec/viewer-ux-polish.md
+Designs:
+  - docs/design/dfd-edge-hover-data.md
+  - docs/design/dfd-overhaul.md
+  - docs/design/graph-flow-search.md
+Research:
+  - docs/research/dfd-layout-and-leveling.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/flows.md

@@ -0,0 +1,27 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/flows/**"
+---
+
+Domain: flows. SSADM data flow diagrams: `parseFlows` (recursive sub-DFDs + canonical Yourdon leveling via `deriveLevels`), `validateFlows` (12 `flow.*` rules), `buildFlowLayoutKeys`, usage indexing; role-split node model
+
+Map:
+  - docs/wiki/flows.md
+Contracts:
+  - docs/spec/dfd-nesting-depth.md
+  - docs/spec/dfd-overhaul.md
+  - docs/spec/folder-model.md
+  - docs/spec/process-flows.md
+Designs:
+  - docs/design/dfd-nesting-depth.md
+  - docs/design/dfd-overhaul.md
+  - docs/design/folder-model.md
+  - docs/design/process-flows.md
+Guides:
+  - docs/guides/flows.md
+Research:
+  - docs/research/dfd-layout-and-leveling.md
+  - docs/research/ssadm-dfd-rules.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/frontend.md

@@ -0,0 +1,23 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/app/**"
+---
+
+Domain: frontend. React 19 unified SPA (Graph/Dictionary/Flows views); shell (`App.tsx`) owns state + composition; views own cy/SVG lifecycle; components/logic/hooks/dom layered underneath
+
+Map:
+  - docs/wiki/frontend.md
+Designs:
+  - docs/design/app-tsx-decomposition.md
+  - docs/design/branding.md
+  - docs/design/dd-spotlight-grid.md
+  - docs/design/dict-navigation.md
+  - docs/design/graph-flow-search.md
+  - docs/design/graph-position-persistence.md
+  - docs/design/key-inheritance-lineage.md
+  - docs/design/unified-app.md
+  - docs/design/viewer-ux-polish.md
+  - docs/design/wiki-entity-links.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/generators.md

@@ -0,0 +1,15 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/generators/**"
+---
+
+Domain: generators. Unified static HTML export via `generateApp` (single file — graph + dict + flows); sole static generator
+
+Map:
+  - docs/wiki/generators.md
+Guides:
+  - docs/guides/building-from-source.md
+  - docs/guides/commands.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/parser.md

@@ -0,0 +1,26 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/model/parse.ts"
+  - "src/model/wikilink.ts"
+  - "src/model/model-index.ts"
+---
+
+Domain: parser. `ignatius.yml` config loading → ParseResult: {model, globalErrors}; nodes, edges, cardinality + classification derivation; wiki-link inline rule + two-pass body rendering; `buildModelIndex` — 13 O(1) lookup maps built once per Model
+
+Map:
+  - docs/wiki/parser.md
+Contracts:
+  - docs/spec/bidirectional-predicates.md
+  - docs/spec/derive-classification.md
+  - docs/spec/folder-model.md
+  - docs/spec/wiki-entity-links.md
+Designs:
+  - docs/design/bidirectional-predicates.md
+  - docs/design/folder-model.md
+  - docs/design/wiki-entity-links.md
+Guides:
+  - docs/guides/folder-format.md
+  - docs/guides/predicates.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/router.md

@@ -0,0 +1,16 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/router/**"
+---
+
+Domain: router. Generates per-folder `index.md` routers with rolled-up SHA-256 digests, in-folder agent guidance (`AGENTS.md`, `CLAUDE.md` shim, `SKILL.md`), and a position-based `<ignatius-*>` region parser; backs `ignatius index` and `validate --index`
+
+Map:
+  - docs/wiki/router.md
+Contracts:
+  - docs/spec/model-index-routing.md
+Designs:
+  - docs/design/model-index-routing.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/scripts.md

@@ -0,0 +1,14 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "scripts/**"
+---
+
+Domain: scripts. Build helpers: stable-names.ts, convert-yaml-to-md.ts; perf/diagnostic tooling: probe.ts, screenshot.ts, gen-synthetic-model.ts, perf-harness.ts
+
+Map:
+  - docs/wiki/scripts.md
+Guides:
+  - docs/guides/building-from-source.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/server.md

@@ -0,0 +1,12 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/server/**"
+---
+
+Domain: server. Bun.serve with `/api/model` + `/api/flow` + `/events` SSE + fs.watch live-reload; `/dict` and `/flow` redirect to unified SPA hash routes; `/flow-dict` redirects to `/#view=dict`
+
+Map:
+  - docs/wiki/server.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/skill.md

@@ -0,0 +1,23 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "skills/ignatius-modeling/**"
+---
+
+Domain: skill. Project-scoped Claude Code skill: Q&A-driven entity/model/DFD authoring, convention-aware, writes files + verifies with `ignatius validate`
+
+Map:
+  - docs/wiki/skill.md
+Contracts:
+  - docs/spec/folder-model.md
+  - docs/spec/ignatius-modeling-skill.md
+  - docs/spec/noorm-flow-discovery.md
+Designs:
+  - docs/design/ignatius-modeling-skill.md
+  - docs/design/noorm-flow-discovery.md
+Guides:
+  - docs/guides/flows.md
+  - docs/guides/getting-started.md
+  - docs/guides/modeling-skill.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/theme.md

@@ -0,0 +1,18 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/theme/**"
+---
+
+Domain: theme. ThemeConfig + Branding types, default palettes, flow-kind colors, dark/light merging
+
+Map:
+  - docs/wiki/theme.md
+Contracts:
+  - docs/spec/branding.md
+Designs:
+  - docs/design/branding.md
+Guides:
+  - docs/guides/themes-and-branding.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

.claude/rules/wiki/validate.md

@@ -0,0 +1,16 @@
+---
+# generated by /refresh-wiki — do not hand-edit; regenerated every refresh
+paths:
+  - "src/model/validate.ts"
+---
+
+Domain: validate. Pure model validator: 33 RuleIds across 8 prefixes (parse/config/entity/body/edge/cluster/index/flow), two severity tiers (A=warn, B=omit); `validateIndex` reuses `buildRouters` to detect router drift
+
+Map:
+  - docs/wiki/validate.md
+Contracts:
+  - docs/spec/schema-lint-and-error-ux.md
+Designs:
+  - docs/design/schema-lint-and-error-ux.md
+
+Consult the map before changing behavior here. Behavior changes stale the pages above. Renames or removals stale mentions beyond them: grep the old name across docs/ before shipping.

README.md

@@ -55,8 +55,8 @@ Edit any file in the folder and the graph reloads in the browser without a refre
 | Guide | What it covers |
 |---|---|
 | [Getting started](docs/guides/getting-started.md) | Install, build from source, and serve your first model |
-| [Commands](docs/guides/commands.md) | `serve`, `export`, `validate`, and model discovery |
-| [The folder format](docs/guides/folder-format.md) | `ignatius.yml`, entity files, columns, relationships, groups |
+| [Commands](docs/guides/commands.md) | `serve`, `export`, `validate`, `index`, and model discovery |
+| [The folder format](docs/guides/folder-format.md) | `ignatius.yml`, entity files, columns, relationships, groups, generated routers |
 | [What gets derived](docs/guides/derivation.md) | Cardinality, classification, and subtype clusters |
 | [Bidirectional predicates](docs/guides/predicates.md) | Forward and reverse edge labels with hover-swap |
 | [Process flows](docs/guides/flows.md) | Data flow diagrams: processes, externals, stores, sub-DFDs |