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).

app/models.py

@@ -478,6 +478,17 @@ class FolderSummary(Base):
       ``lite`` model wrote at sync time (``FOLDER_SUMMARY_MODE``,
       ``app.rag.folder_summaries`` — change-gated and fail-soft like
       the KB overview: an old summary is better than none).
+    * ``manually_edited`` — ``true`` only while the description is the
+      OWNER'S words (phase 97, task 01): set ONLY by
+      ``PATCH /api/folders/summary`` (phase 97, task 03) — the
+      generator never sets it. The sync-time generator (``app.rag.
+      folder_summaries``) SKIPS a manual row on regeneration (no
+      ``lite`` burn on owner text — counted ``kept_manual``) and never
+      prunes it (owner content persists until cleared — even for a
+      folder below the 2-document minimum); an owner correction is
+      never silently rewritten (the phase-97 ``00_phase.md`` decision).
+      Clearing the description deletes the row — the next KB-changing
+      sync regenerates an AI description (the reset path).
 
     Chat turns only READ these rows (the agent's ``ls`` output, phase
     94 task 03) — generation happens at sync time only (task 02).
@@ -493,6 +504,14 @@ class FolderSummary(Base):
     #: The lite-written 1–3 sentence description — never empty (the
     #: generator validates before storing, ``app.rag.folder_summaries``).
     summary: Mapped[str] = mapped_column(Text)
+    #: Owner-edited flag (phase 97, task 01): ``true`` only while the
+    #: description is the owner's words — set ONLY by
+    #: ``PATCH /api/folders/summary`` (phase 97, task 03); the
+    #: generator skips a manual row on regeneration and never prunes
+    #: it (the class docstring's two rules).
+    manually_edited: Mapped[bool] = mapped_column(
+        Boolean, nullable=False, server_default=text("false")
+    )
     #: Fresh UTC stamp on every upsert (the ``kb_overview.updated_at``
     #: precedent; the generator always sets it explicitly).
     updated_at: Mapped[datetime] = mapped_column(