docs

INDEX.md

@@ -103,15 +103,30 @@ ctrl/                     control plane / operational scripts
        └─ interleave_cht_frames.py   whisperx JSON + cht frames/index.json → enhanced.txt
 ui/                       local browser UIs (Vue 3 + Vite), shared framework
   ├─ framework/           ✅ shared component/renderer library + design tokens
-  ├─ meetus-app/          ✅ review meeting runs (was ui/app/)
-  └─ doocus-app/          ✅ browse extracted docs + build packages (Gemini/NotebookLM)
+  ├─ meetus-app/          ✅ review meeting runs (video · transcript · frames; @review source)
+  └─ doocus-app/          ✅ browse tree · search · package; embeds the meetus review
+doocus-data/ meetus-data/ ✅ managed collection roots (gitignored): <root>/<source>/
+docs/graphs/              📄 architecture diagram (.dot → .svg, `make graphs`)
 def/                      📄 design/decision notes, in order (the feature history)
-README.md                 📄 manual for process_meeting.py
+README.md                 📄 project overview (meetus + doocus) + architecture diagram
 INDEX.md                  📄 this file
 MARIAN.md                 📄 genesis brainstorm (explains why the deprecated OCR path exists)
 local-run.sh              📄 personal scratch invocations (gitignored)
 ```
 
+## Collections & UIs
+
+- **Managed roots** (gitignored): `doocus-data/<source>/` (docs) and
+  `meetus-data/<source>/` (meetings), each `<root>/<source>/` mirroring the source.
+  `process_tree.py --only {all|docs|meetings}` scopes a collection.
+- **doocus-app** discovers both roots (`DOOCUS_DATA` overrides, comma-separated),
+  **merges collections that share `index.json.root`** into one source, searches the
+  cached text, and can **scan a folder** (runs `process_tree` via `uv`) from the UI.
+- **meetus-app** is a thin shell over `@review` (`ui/meetus-app/src/components/ReviewBody.vue`),
+  the review composition doocus embeds — meetus stays the single source.
+- **Diagram**: `docs/graphs/architecture.dot` → `docs/graphs/architecture.svg`
+  (`make graphs`; needs system graphviz). Both committed.
+
 ## Notes
 
 - **Default flow** uses `--embed-images` (frames referenced for the LLM to read) +