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/unit/test_frontend_sync_upload.py

@@ -285,7 +285,7 @@ def test_tick_decision_tree_order_and_branches() -> None:
         'syncResult.textContent = ""',
         "hideSyncError()",
         'emitSyncStatus({ state: "idle" })',
-        "loadDocs()",
+        "loadTree()",  # phase 97: the catalog load is the tree fetch
     ):
         assert line in up_ok, f"the upload-success settle must carry {line!r}"
     assert "fmtSyncResult" not in up_ok, "no upload counts in #sync-result (A3)"
@@ -300,7 +300,7 @@ def test_tick_decision_tree_order_and_branches() -> None:
         'emitSyncStatus({ state: "idle" })',
     ):
         assert line in up_fail, f"the upload-failed settle must carry {line!r}"
-    assert "loadDocs()" not in up_fail, "no KB change on a failed upload"
+    assert "loadTree()" not in up_fail, "no KB change on a failed upload"
     assert "showSyncError" not in up_fail, "no banner on this page (A3)"
     assert "applySyncFailure" not in up_fail and "showSyncModal" not in up_fail
     # 7. both idle: the unchanged idle settle.
@@ -333,7 +333,7 @@ def test_reattach_adopts_a_running_upload_only() -> None:
     upload run re-attaches (running state, upload kind — phase 90: no
     live file, the label stays bare "Importing…" — the synthetic
     running frame, the poll starts); a terminal upload is a no-op —
-    the fall-through is the plain idle settle (the boot-time loadDocs()
+    the fall-through is the plain idle settle (the boot-time loadTree()
     already shows the current catalog)."""
     body = _fn(_js(), "initSyncButton")
     assert "await fetchIsAdmin()" in body, "admin-only (no extra fetch)"
@@ -370,7 +370,7 @@ def test_section_header_documents_the_two_job_contract() -> None:
     header = js[marker : js.find("const syncBtn")]
     assert "Phase 64 (task 04)" in header
     assert "/api/git-sources/upload/status" in header, "the second job's endpoint"
-    assert "loadDocs" in header, "the A3 catalog refresh"
+    assert "loadTree" in header, "the A3 catalog refresh (phase 97 rename)"
     assert "A3" in header and "A4" in header