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

2026-09-11 22:48:02 -04:00

..

__init__.py

phase: 82_security_headers

2026-09-07 23:54:41 -04:00

test_agent.py

phase: 95_read_truncation_cap

2026-09-11 03:42:51 -04:00

test_api_tokens_model.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_archive_upload.py

feat(sources): upload tarball/zipfile archives as sources — unpack, scan, and replace in place

2026-08-28 15:57:59 -04:00

test_auth.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_background_no_motion.py

phase: 92_theme_save_and_coverage

2026-09-10 00:23:08 -04:00

test_big_read_progress.py

fix(chat): render typing-indicator elapsed hint as horizontal text

2026-09-08 10:03:10 -04:00

test_caching.py

phase: 92_theme_save_and_coverage

2026-09-10 00:23:08 -04:00

test_chat_cancel.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_chat_gate.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_chat_persistence.py

phase: 92_theme_save_and_coverage

2026-09-10 00:23:08 -04:00

test_chunker.py

feat(import): index quadlet unit files and jinja templates (A9 revision)

2026-08-28 07:02:24 -04:00

test_config.py

phase: 95_read_truncation_cap

2026-09-11 03:42:51 -04:00

test_db.py

feat: scaffold Brain of Reese — FastAPI RAG chat over Postgres 17 + pgvector

2026-08-21 13:42:21 -04:00

test_debugging.py

feat: scaffold Brain of Reese — FastAPI RAG chat over Postgres 17 + pgvector

2026-08-21 13:42:21 -04:00

test_doc_edit_screen.py

feat(docs): save chat answers as docs — edit screen, commit + push to the .env docs branch

2026-09-01 03:52:03 -04:00

test_docs_push.py

feat(docs): save chat answers as docs — edit screen, commit + push to the .env docs branch

2026-09-01 03:52:03 -04:00

test_document_viewer.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_error_sanitization.py

phase: 84_docs_push_error_sanitization

2026-09-08 01:11:45 -04:00

test_folder_summaries.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_frontend_brand.py

phase: 91_admin_theme_tab

2026-09-09 17:22:24 -04:00

test_frontend_feedback.py

phase: 92_theme_save_and_coverage

2026-09-10 00:23:08 -04:00

test_frontend_hidden_tab.py

fix(chat): raise pre-token guard from 120 s to 300 s

2026-09-08 09:37:33 -04:00

test_frontend_router.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_frontend_scroll.py

feat(chat): retry the last answer — redo-in-place Retry button on the latest brain bubble

2026-08-29 18:32:15 -04:00

test_frontend_sync_upload.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_frontend_tool_states.py

feat(agent): align the document tools with the harness-trained shape — ls, read(path), grep(pattern, path?)

2026-09-03 11:17:47 -04:00

test_gate_header_stacking.py

phase: 85_mobile_menu_gate_overlap

2026-09-08 01:56:37 -04:00

test_git_sources.py

feat(admin): local directory sources — kind/path on git_sources, combined sync + import, page form + badges

2026-08-27 01:04:16 -04:00

test_git_sync.py

feat(docs): save chat answers as docs — edit screen, commit + push to the .env docs branch

2026-09-01 03:52:03 -04:00

test_hamburger_nav.py

fix(ui): bind the shared header controls on explicit init, not at module import

2026-09-08 22:31:45 -04:00

test_header_bindings_once_per_document.py

fix(ui): bind the shared header controls on explicit init, not at module import

2026-09-08 22:31:45 -04:00

test_history_copy.py

fix(chat): keep in-flight answers alive across in-app view switches

2026-09-06 06:31:31 -04:00

test_history_page.py

fix(chat): keep in-flight answers alive across in-app view switches

2026-09-06 06:31:31 -04:00

test_history.py

feat(rag): pass chat history with prior thinking to the LLM

2026-09-05 16:04:40 -04:00

test_importer_ignore.py

phase: 89_source_ignore_paths

2026-09-09 01:45:42 -04:00

test_importer.py

phase: 89_source_ignore_paths

2026-09-09 01:45:42 -04:00

test_kb_tree_builder.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_kb_tree_ui.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_llm_client.py

phase: 96_oneshot_resilience

2026-09-11 13:16:20 -04:00

test_llm_probe.py

feat(rag): agent document tools — list/read tools with env-tuned budgets, SSE tool events + "calling tool" UI

2026-08-26 22:39:14 -04:00

test_llm_stream_teardown.py

feat(agent): align the document tools with the harness-trained shape — ls, read(path), grep(pattern, path?)

2026-09-03 11:17:47 -04:00

test_main.py

perf(ui): cache busting — HTML no-cache + versioned asset URLs (?v=) with immutable 1y asset caching

2026-08-25 22:42:10 -04:00

test_markdown_tables.py

feat(chat): render markdown tables in answers, viewer, and thinking

2026-08-28 03:35:50 -04:00

test_mobile_chat_hamburger_boot.py

fix(ui): bind the shared header controls on explicit init, not at module import

2026-09-08 22:31:45 -04:00

test_mock_tool_flow.py

phase: 94_ls_tree_drilldown

2026-09-11 00:59:35 -04:00

test_models.py

phase: 93_theme_semantic_completion

2026-09-10 16:43:08 -04:00

test_overview.py

feat(rag): lite-generated KB overview in the system prompt — stored single row, regenerated on import, <knowledge_base> section in HIGH+LOW prompts

2026-08-25 20:22:51 -04:00

test_page_head_panel.py

phase: 93_theme_semantic_completion

2026-09-10 16:43:08 -04:00

test_pinned_composer.py

feat(web): move the chat action cluster to the pinned bottom and align the button sets

2026-09-02 01:08:18 -04:00

test_prompts.py

phase: 95_read_truncation_cap

2026-09-11 03:42:51 -04:00

test_rate_limit.py

phase: 81_login_rate_limit

2026-09-07 23:08:46 -04:00

test_read_truncation_frontend.py

phase: 95_read_truncation_cap

2026-09-11 03:42:51 -04:00

test_remove_confirm_modal.py

fix(chat): keep in-flight answers alive across in-app view switches

2026-09-06 06:31:31 -04:00

test_retriever.py

finally getting accurate answers

2026-09-05 10:26:39 -04:00

test_save_as_doc_button.py

phase: 91_admin_theme_tab

2026-09-09 17:22:24 -04:00

test_save_chat_ui.py

phase: 92_theme_save_and_coverage

2026-09-10 00:23:08 -04:00

test_scaffolding_filter.py

feat(agent): strip raw tool-scaffolding from streamed answers — deterministic filter with one bounded recovery

2026-09-03 13:39:15 -04:00

test_schemas.py

phase: 95_read_truncation_cap

2026-09-11 03:42:51 -04:00

test_security_headers.py

phase: 91_admin_theme_tab

2026-09-09 17:22:24 -04:00

test_shared_header.py

fix(ui): bind the shared header controls on explicit init, not at module import

2026-09-08 22:31:45 -04:00

test_shared_page.py

fix(ui): bind the shared header controls on explicit init, not at module import

2026-09-08 22:31:45 -04:00

test_source_ignore_paths.py

phase: 89_source_ignore_paths

2026-09-09 01:45:42 -04:00

test_source_removal.py

feat(sources): removing a source deletes its files and index entries behind a confirmation modal

2026-09-02 15:55:33 -04:00

test_sources_meta.py

feat(chat): invalidate saved chats on sources sync — versioned stamps, stale marker, Regenerate against the new index

2026-08-30 23:39:15 -04:00

test_sources_midstream.py

feat(chat): retry the last answer — redo-in-place Retry button on the latest brain bubble

2026-08-29 18:32:15 -04:00

test_sse_events.py

feat(agent): align the document tools with the harness-trained shape — ls, read(path), grep(pattern, path?)

2026-09-03 11:17:47 -04:00

test_stale_ui_copy.py

fix(chat): keep in-flight answers alive across in-app view switches

2026-09-06 06:31:31 -04:00

test_steering_prompts.py

feat(rag): steering notes — tune how Brain answers, stored in Postgres and injected into every system prompt

2026-08-22 16:44:42 -04:00

test_steering_toggle_removal.py

fix(chat): keep in-flight answers alive across in-app view switches

2026-09-06 06:31:31 -04:00

test_steering.py

feat(rag): global tuning manager — /tuning.html + PUT /api/steering/{id}: create, edit, list, delete steering notes without a chat

2026-08-25 13:46:32 -04:00

test_sticky_header.py

fix(web): keep the navbar stuck to the top — drop the body height cap on the sticky range

2026-09-01 04:20:26 -04:00

test_summarizer.py

feat(rag): lite-model document summaries — non-markdown docs summarized at import, summary chunk retrieves and resolves to the full source doc

2026-08-25 17:48:37 -04:00

test_summary_edit_ui.py

feat(kb): edit + re-embed document summaries from the viewer (admin)

2026-08-31 23:52:22 -04:00

test_sync_button.py

phase: 97_kb_tree_catalog

2026-09-11 22:48:02 -04:00

test_sync_model_probe.py

feat(sync): fail fast with a modal when a model is unavailable

2026-08-27 23:44:35 -04:00

test_table_wrap_stacking.py

phase: 86_history_page_width

2026-09-08 02:38:45 -04:00

test_theme_frontend.py

phase: 93_theme_semantic_completion

2026-09-10 16:43:08 -04:00

test_theming.py

phase: 93_theme_semantic_completion

2026-09-10 16:43:08 -04:00

test_thinking_scroll.py

fix(chat): stop the submit up-hop and keep the thinking pin alive across paragraph breaks

2026-08-28 17:10:02 -04:00

test_token_gate.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_tokens.py

feat: phases 77–80 — navbar view refresh, static background, API tokens, history suggestion chips

2026-09-07 12:39:01 -04:00

test_ui_settings.py

phase: 93_theme_semantic_completion

2026-09-10 16:43:08 -04:00

test_wide_column_css.py

phase: 91_admin_theme_tab

2026-09-09 17:22:24 -04:00