phase: 97_kb_tree_catalog

All completion criteria verified — everything is green, no defects found. Final report:

## Phase 97 final verification pass — ALL GREEN

**Verified (no code changes needed):**
- `GET /api/docs/tree` (admin), `build_kb_tree` pure builder, `PATCH /api/folders/summary`, migration 0018 (`manually_edited`, head confirmed), generator skip/keep + `kept_manual` stat, RAG tree UI + edit affordance in `sources.js`/`index.html`/`styles.css`
- `tests/e2e/test_kb_tree.py`: 8 passed — top level, drill source/folder, edit round-trip, clear, manual-desc-survives-sync, reload fallback, anonymous gate
- Integration: tree shape/order/403/empty/indexed-only + PATCH update/create/root/clear/404/403/no-LLM + stat-walk equivalence (in `test_docs_api.py`); 3-field `folder_summaries=` import token preserved

**Gates (exact commands):**
- `uv run pytest --cov=app --cov-report=term-missing` → **2053 passed**, TOTAL coverage **99%** (>90% ✓)
- `uv run ruff check . && uv run pyright` → **All checks passed / 0 errors**
- `uv run pytest tests/e2e/test_kb_tree.py -v --no-cov` → **8 passed** in isolation
- 30 story/RAG-view E2E suites run **one per process**: all passed, incl. `test_ls_tree_drilldown` (agent `ls` byte-identical ✓), `test_import_documents`, `test_edit_summaries`, `test_admin_auth`, `test_kb_overview`

**Completion criteria:** tree view ✓ · edit round-trip + clear ✓ · manual persists/clear resets ✓ · `ls` unchanged ✓ · pytest/coverage/lint ✓ · E2E isolation ✓ · commit — left to harness per protocol (working tree untouched, `git add/commit` not run)

**Deviations:** none. **Next pending phase:** none — `todo/` contains only 97 (96 already committed).

tests/e2e/test_navbar_refresh.py

@@ -109,7 +109,10 @@ TITLE_E = "Phase77 popstate E"
 # pollers hit OTHER paths and only run while a job is in flight).
 DATA_VIEWS: tuple[tuple[str, str, str], ...] = (
     ("#nav-history", "/history.html", "/api/chats"),
-    ("#nav-sources", "/sources.html", "/api/docs"),
+    # Phase 97: the RAG view's list endpoint is the drill-down tree
+    # (GET /api/docs/tree — the flat /api/docs is the unchanged API
+    # surface, no longer the view's fetch).
+    ("#nav-sources", "/sources.html", "/api/docs/tree"),
     ("#nav-git-sources", "/git-sources.html", "/api/git-sources"),
     ("#nav-tuning", "/tuning.html", "/api/steering"),
 )
@@ -568,10 +571,11 @@ def test_stream_survival_control(page: Page, app_url: str, mock_llm: int, db_rea
     assert page.evaluate("() => window.__shell_boot") == "phase77", (
         "a real navigation would have wiped the window sentinel"
     )
-    # The RAG view actually showed (the fixture docs' rows are listed)
-    # and the chat view is hidden (the stream fills it in the
-    # background — that persistence IS the phase-76 fix).
-    expect(page.locator("#docs-tbody tr").first).to_be_visible(timeout=15_000)
+    # The RAG view actually showed (the source rows are listed — phase
+    # 97: the top level lists the sources; the file table is per-level
+    # and hidden at the top) and the chat view is hidden (the stream
+    # fills it in the background — that persistence IS the phase-76 fix).
+    expect(page.locator("#folders-tbody tr").first).to_be_visible(timeout=15_000)
     expect(page.locator("#view-chat")).to_be_hidden()
 
     # Stay on RAG while the stream keeps running, then return to Chat.