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

@@ -16,6 +16,11 @@ DB isolation: the fixture's source name (``extension_kb``) is
 distinctive — the suite never asserts on absolute row counts and
 deletes the rows it creates in a ``finally`` (other suites' documents
 stay untouched in the shared E2E database).
+
+Phase 97 adaptation: the catalog is the DRILL-DOWN TREE — the rows
+live at their folder levels (``extension_kb`` → ``homelab`` →
+``scripts`` / ``notes``); the drill is the only change, the asserted
+rows/links/modal are unchanged.
 """
 from __future__ import annotations
 
@@ -86,6 +91,20 @@ def _delete_source_rows() -> None:
         db.commit()
 
 
+def _drill(page: Page, *names: str) -> None:
+    """Drill one level at a time (phase 97 — client-side, no fetch,
+    no URL change): each name is the EXACT text of the source/folder
+    link at the current level."""
+    for name in names:
+        page.click(f'#folders-tbody a.folder-link:text-is("{name}")')
+
+
+def _go_top(page: Page) -> None:
+    """Back to the top level: the breadcrumb's top-level link (call
+    between drills only — the breadcrumb is hidden at the top)."""
+    page.locator("#kb-crumb a.kb-crumb-link").first.click()
+
+
 @pytest.fixture(autouse=True)
 def extension_kb(mock_llm: int, db_ready: None) -> Iterator[ImportSummary]:
     """Seed the fixture with the NOVEL scope (``md,sh``) for one test
@@ -110,14 +129,27 @@ def test_admin_sources_lists_the_novel_extension(
     login(page, app_url)  # phase 16: the catalog is admin-only
     # The novel .sh document is listed; the path cell carries the full
     # path (the column is ellipsized — the title attribute is the pin).
+    # Phase 97: the rows live at their folder levels — drill source →
+    # homelab → scripts first.
+    _drill(page, SOURCE, "homelab", "scripts")
     row = page.locator("#docs-tbody tr", has_text=SH_REL)
     expect(row).to_have_count(1)
     link = row.locator("td:nth-child(2) a.doc-link")
     expect(link).to_have_count(1)
     expect(link).to_have_attribute("title", SH_REL)
-    # The markdown control doc is listed too (never asserted by count —
-    # other suites' documents may share the shared E2E database).
+    # The markdown control doc is listed too (its OWN level — never
+    # asserted by count: other suites' documents may share the shared
+    # E2E database).
+    _go_top(page)
+    _drill(page, SOURCE, "homelab", "notes")
     expect(page.locator("#docs-tbody tr", has_text=MD_REL)).to_have_count(1)
+    # Back to the .sh row's level — the modal asserts below click its
+    # path link.
+    _go_top(page)
+    _drill(page, SOURCE, "homelab", "scripts")
+    link = page.locator("#docs-tbody tr", has_text=SH_REL).locator(
+        "td:nth-child(2) a.doc-link"
+    )
 
     # Format badge: the row's path link opens the same-page modal and
     # its meta row shows the .sh format (house assertion style —