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

@@ -568,7 +568,12 @@ def test_upload_toast_then_navigate_away(
     # page).
     page.goto(app_url + SOURCES_URL)
 
-    # Phase 90 A1: the upload indexed NOTHING — the catalog is empty…
+    # Phase 90 A1: the upload indexed NOTHING — the catalog shows the
+    # registered source with 0 documents (phase 97: the source row IS
+    # the load-settled signal; the file table stays hidden/empty)…
+    row = page.locator("#folders-tbody tr", has_text=UPLOAD_NAME)
+    expect(row).to_have_count(1, timeout=30_000)
+    expect(row.locator("td:nth-child(2)")).to_have_text("0")
     expect(page.locator("#docs-tbody tr")).to_have_count(0)
     # …and the sync button settles idle with no error UI (the
     # sub-second upload run is over by the time this page's 2 s poll
@@ -623,6 +628,11 @@ def test_upload_toast_then_navigate_away(
     expect(btn).to_be_enabled()
     expect(btn).not_to_have_attribute("aria-busy")
     expect(page.locator("#sync-result")).to_have_text(f"{N_FILES} added")
+    # Phase 97: the catalog is the drill-down tree — drill source →
+    # folder `docs` before the per-level row asserts (the flat total
+    # no longer exists in one tbody).
+    page.click(f'#folders-tbody a.folder-link:text-is("{UPLOAD_NAME}")')
+    page.click('#folders-tbody a.folder-link:text-is("docs")')
     expect(page.locator("#docs-tbody tr")).to_have_count(N_FILES, timeout=30_000)
     expect(page.locator("#docs-tbody tr", has_text="docs/00.md")).to_have_count(1)
     expect(page.locator("#docs-tbody tr", has_text="docs/24.md")).to_have_count(1)
@@ -738,7 +748,17 @@ def test_sync_live_file_label(
 
     btn = page.locator("#sync-btn")
     expect(btn).to_be_visible(timeout=30_000)
-    expect(page.locator("#sync-label")).to_have_text("Sync sources")
+    # The button is retry-ready at boot: idle ("Sync sources") — or the
+    # RE-ATTACHED terminal from a prior test's sync (the module app is
+    # shared, its in-memory sync state survives the test boundary, and
+    # the phase-32 boot re-attach renders the last result — "Synced
+    # HH:MM" after test 1's successful run). Either way the button is
+    # enabled and a click starts THIS test's run (the assertions below
+    # are the run's own).
+    expect(page.locator("#sync-label")).to_have_text(
+        re.compile(r"^(Sync sources|Synced \d{1,2}:\d{2})$")
+    )
+    expect(btn).to_be_enabled()
 
     recorder = _TickRecorder(app_url, "/api/sync/status")
     recorder.start()
@@ -778,6 +798,11 @@ def test_sync_live_file_label(
     expect(btn).to_be_enabled()
     expect(btn).not_to_have_attribute("aria-busy")
     expect(page.locator("#sync-result")).to_have_text(f"{N_FILES} added")
+    # Phase 97: the catalog is the drill-down tree — drill source →
+    # folder `notes` before the per-level row asserts (the flat total
+    # no longer exists in one tbody).
+    page.click(f'#folders-tbody a.folder-link:text-is("{SYNC_SOURCE_DIR}")')
+    page.click('#folders-tbody a.folder-link:text-is("notes")')
     expect(page.locator("#docs-tbody tr")).to_have_count(N_FILES, timeout=30_000)
     expect(page.locator("#docs-tbody tr", has_text="notes/00.md")).to_have_count(1)
     expect(page.locator("#docs-tbody tr", has_text=SYNC_SOURCE_DIR)).to_have_count(N_FILES)