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_sync_button.py

@@ -185,6 +185,29 @@ def _overview_row() -> KbOverview | None:
         return db.get(KbOverview, 1)
 
 
+# The git fixture repo's directory name — the source name the import
+# records for it (the repo_name basename rule, phase 28).
+GIT_SOURCE_NAME = "homelab-notes"
+
+
+def _go_top(page: Page) -> None:
+    """Back to the top level (no-op when already there — the
+    breadcrumb is hidden at the top)."""
+    if not page.locator("#kb-crumb").is_hidden():
+        page.locator("#kb-crumb a.kb-crumb-link").first.click()
+
+
+def _expect_fixture_row(page: Page) -> None:
+    """The REAL clone was imported — the fixture path is listed. Phase
+    97: the catalog is the drill-down tree, so drill source → folder
+    ``notes`` first (the flat all-docs row is the same row, one level
+    deeper)."""
+    _go_top(page)
+    page.click(f'#folders-tbody a.folder-link:text-is("{GIT_SOURCE_NAME}")')
+    page.click('#folders-tbody a.folder-link:text-is("notes")')
+    expect(page.locator("#docs-tbody tr", has_text=FIXTURE_DOC)).to_have_count(1)
+
+
 def _wait_sync_done(page: Page, app_url: str, timeout_s: float = 60.0) -> dict[str, Any]:
     """Poll the (cookie-authenticated) status endpoint until the run
     reaches a terminal state — exactly what the UI's 2 s poll loop
@@ -244,8 +267,9 @@ def test_admin_sync_lifecycle(page: Page, app_url: str, db_ready: None) -> None:
     expect(page.locator("#sync-result")).to_have_text("1 added")
 
     # The REAL clone was imported: the fixture path is in the Sources
-    # table (the sentinel lives inside it).
-    expect(page.locator("#docs-tbody tr", has_text=FIXTURE_DOC)).to_have_count(1)
+    # table (the sentinel lives inside it) — via the drill-down tree
+    # (phase 97).
+    _expect_fixture_row(page)
 
     # Phase-31 regeneration ran (the import changed the KB): the single
     # kb_overview row is fresh and non-empty (DB check — truncated
@@ -264,8 +288,9 @@ def test_admin_sync_lifecycle(page: Page, app_url: str, db_ready: None) -> None:
     # Nothing re-embedded (sha256 delta) — the no-op run announces the
     # unchanged count instead of an empty live region.
     expect(page.locator("#sync-result")).to_have_text("0 added · 1 unchanged")
-    # The doc survived the prune re-import (its file is still in the repo).
-    expect(page.locator("#docs-tbody tr", has_text=FIXTURE_DOC)).to_have_count(1)
+    # The doc survived the prune re-import (its file is still in the
+    # repo) — via the drill-down tree (phase 97).
+    _expect_fixture_row(page)
 
 
 # --- 3. Concurrency: one sync at a time ------------------------------------