chore: initialize POM 2 repo (docs guards green; release gates recorded NOT RUN pending install)

2026-08-19 10:31:00 +02:00
commit 7ffd00b5c5
111 changed files with 12522 additions and 0 deletions
--- a/docs/VAULT.md
+++ b/docs/VAULT.md
@@ -0,0 +1,101 @@
+---
+title: Generated Project Vault Shape
+description: The canonical directory structure and content types created by bootstrapProject
+---
+
+# Generated Project Vault Shape
+
+Created by `src/persistence.ts:226-239` (`bootstrapProject`). This is the *project* knowledge base, not the extension wiki.
+
+## Top-level directories
+
+```
+<project-root>/
+├── 00_admin/                 # Canonical state, manifests, ledgers, checksums
+│   ├── project_state.json    # Active POM state (source of truth)
+│   ├── artifact_manifest.json
+│   ├── artifact_events.jsonl
+│   ├── SHA256SUMS.txt
+│   ├── validation/           # Gate reports (stage-N-scope-stamp.json)
+│   ├── hive/                 # Hive mission records
+│   └── swarms/               # Optional Swarm DAG definitions
+├── 01_planning/              # Stage 0-3 outputs
+│   ├── brief.md
+│   ├── genre.md
+│   ├── voice.md
+│   └── story_store.md
+├── 02_story_bible/           # Stage 4 outputs
+│   ├── canon.md
+│   ├── cast.md
+│   ├── world.md
+│   ├── timeline.md
+│   ├── continuity.md
+│   └── visual_bible/
+├── 03_manuscript/            # Stage 5-7 outputs
+│   ├── outline.md
+│   ├── scenes/
+│   └── chapters/
+├── 04_images/                # Visual assets
+│   ├── references/
+│   ├── generated/
+│   ├── briefs/
+│   └── approvals/
+├── 05_research/              # Source notes and rights
+│   ├── sources.md
+│   ├── notes.md
+│   ├── fact_invention.md
+│   └── rights.md
+├── 06_ledgers/               # Decisions, revisions, continuity, quality, validation
+│   ├── decisions.jsonl
+│   ├── assumptions.jsonl
+│   ├── revisions.jsonl
+│   ├── continuity.jsonl
+│   ├── quality.jsonl
+│   └── validation.jsonl
+├── 07_exports/               # Checkpoint and final archives
+│   ├── <slug>-checkpoint-<stamp>.zip
+│   ├── <slug>-final-<stamp>.zip
+│   └── <base>.verification.json
+├── content/                  # Obsidian/Quartz knowledge projection
+│   ├── index.md
+│   ├── canon/
+│   ├── cast/
+│   ├── timeline/
+│   ├── manuscript/
+│   └── research/
+└── .omp/                     # Host and POM project configuration
+    ├── config.yml            # OMP host settings (theme, task concurrency, etc.)
+    ├── pom.json              # POM project settings
+    └── prompts/              # Project-local prompt overrides
+```
+
+## Vault content conventions
+
+| Directory | Format | Purpose |
+|---|---|---|
+| `content/` | Markdown + YAML frontmatter + wikilinks | Human-navigable knowledge projection |
+| `00_admin/` | JSON/JSONL | Machine-readable canonical state and evidence |
+| `01_planning`–`05_research` | Markdown | Author-facing creative artifacts |
+| `06_ledgers` | JSONL | Append-only decision/revision/continuity logs |
+| `07_exports` | ZIP + JSON | Verified delivery archives with sidecars |
+| `.omp/` | YAML/JSON | Project-scoped configuration |
+
+## Quartz compatibility
+
+- `content/` is a valid Quartz 5 content vault
+- Frontmatter uses `title`, `tags`, `aliases`, `date`, `modified`
+- Wikilinks use `[[page]]` and `[[page|alias]]` syntax
+- Callouts use `> [!note]`, `> [!warning]`, `> [!important]`
+- Maps of content via `dataview` or manual index pages
+- `quartz.config.ts` for the project is generated from `config/config.yml` template
+
+## Source of truth hierarchy
+
+1. Project filesystem (`00_admin/project_state.json`, artifact files, ledgers)
+2. `content/` vault (navigable projection, derived from #1)
+3. OMP session state (append-only, never canonical)
+4. Memory (Mnemopi) — ephemeral, never canonical
+
+## Regeneration
+
+The vault is **not** regenerated from source on every change. It is incrementally updated by `src/persistence.ts` when artifacts are registered or state changes. To fully rebuild: `rm -rf content && /pom vault` (re-projects from canonical state).