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

@@ -51,9 +51,11 @@ Phase 77 task 02 (the other data views join the refresh): RAG
 (``tuning.js``) each listen for ``bor:view-refresh`` on their root and
 re-run their existing load (armed only in the admin branch, after the
 whoami gate — the same gate guard as History). ``sources.js``'s
-``loadDocs`` clears the tbody's rows at the TOP (before the fetch —
-the History pattern), so a refresh from a populated list into an empty
-result leaves no ghost rows. The Chat view (``app.js``) does NOT
+catalog load is re-entrant: the phase-97 ``loadTree`` (one fetch of
+``GET /api/docs/tree``) renders through ``renderLevel``, which clears
+BOTH row containers at the top before filling them, so a refresh from
+a populated level into a sparser (or empty) one leaves no ghost rows. The Chat
+view (``app.js``) does NOT
 listen — the negative pin: the in-flight SSE stream and the local
 conversation must survive every switch (the phase-76 contract), so
 the exclusion is a contract, not an oversight.
@@ -559,25 +561,34 @@ def _pin_refresh_listener(js: str, gate: str, listener_call: str, name: str) ->
 
 
 def test_rag_view_refetches_on_reshow() -> None:
-    """Phase 77 task 02: the RAG (knowledge base) view re-fetches on a
-    user-initiated re-show — sources.js listens and re-runs
-    ``loadDocs()``. ``loadDocs`` is now re-entrant: the tbody's rows
-    are cleared at the TOP, before the fetch (the History pattern from
-    task 01), so a refresh from a populated list into an empty result
-    replaces the list instead of leaving ghost rows."""
+    """Phase 77 task 02 (+ phase 97 task 04): the RAG (knowledge base)
+    view re-fetches on a user-initiated re-show — sources.js listens
+    and re-runs ``loadTree()`` (the phase-97 catalog load: ONE fetch of
+    ``GET /api/docs/tree``). The load is race-tokened (phase 79) and
+    the RE-ENTRANT render — ``renderLevel`` clears BOTH row containers
+    at the TOP before filling them (the History pattern from task 01,
+    extended to the folders table) — so a refresh from a populated
+    level into a sparser (or empty) result replaces the rows instead
+    of leaving ghost rows."""
     js = _asset("sources.js")
     _pin_refresh_listener(
-        js, "const admin = await fetchIsAdmin();", "() => loadDocs()", "sources.js"
+        js, "const admin = await fetchIsAdmin();", "() => loadTree()", "sources.js"
     )
-    load = js.find("async function loadDocs()")
-    assert load != -1, "loadDocs must exist"
+    load = js.find("async function loadTree()")
+    assert load != -1, "loadTree must exist"
     body = js[load : js.find("\n  }", load)]
-    clear_i = body.find("tbody.replaceChildren()")
-    fetch_i = body.find('fetch("/api/docs")')
-    assert 0 <= clear_i < fetch_i, (
-        "the row clearing must precede the fetch (a populated → empty refresh "
-        "must not leave ghost rows)"
-    )
+    assert 'fetch("/api/docs/tree")' in body, "the load must fetch the tree endpoint"
+    assert "++loadSeq" in body, "the race token stays (phase 79)"
+    render = js.find("function renderLevel()")
+    assert render != -1, "renderLevel must exist"
+    render_body = js[render : js.find("\n  }", render)]
+    for container in ("foldersTbody", "tbody"):
+        clear_i = render_body.find(f"{container}.replaceChildren()")
+        append_i = render_body.find(f"{container}.appendChild")
+        assert 0 <= clear_i < append_i, (
+            f"{container}: the clear must precede the fill (a populated → "
+            "sparser refresh must not leave ghost rows)"
+        )
 
 
 def test_git_sources_view_refetches_on_reshow() -> None: