ducoterra eebc824636 phase: 162_search_recall_small_sources ...

**Phase 162 — final verification pass (all tasks already complete; verified + docs pass)**

- Verified: `_fold` (NFKD+casefold, stdlib) inside `_normalize_name` — `BESTÅ`→`besta` question side, `BÅsta.md`→`basta` path side; A2 match classes/ranking/caps/bonus untouched; FTS/cosine/A8 untouched.
- Verified: `grep_document` folds both sides via the imported `_fold` (no second copy); regex-teaching lines byte-identical; 3 copy sites updated.
- Verified: `regenerate_overview` appends the deterministic `Sources: <name> (<k> doc|docs)` tail (happy path only; zero-doc + `LLMError` rows byte-identical; `build_overview_prompt`/`load_kb_overview`/`build_kb_section` untouched).
- Verified: `TOOLS_SECTION` grep sentence updated + D4 search-discipline sentence present **verbatim**, immediately after the grep sentence; `PERSONA`/LOW pins byte-identical (`test_prompt_lock.py`).
- Measured evidence (in `.agents/reports/162_…/task04_prefix_evidence_and_battery.md` + re-measured every run by `test_under_rank_is_measured_not_assumed`): pre-fix tokens `['build','best']` → IKEA doc rank 6 (outside top-5); post-fix `['build','besta']` → suggested #1, cosine unchanged 0.382.
- `uv run pytest tests/e2e/test_search_recall_small_sources.py -v --no-cov` → **7 passed** (isolated); neighbours `test_kb_overview{,_freshness} test_name_signal_read_chips test_grep_regex_teaching test_harness_aligned_tools test_agent_document_tools test_tool_call_compact` → **24 passed**.
- `uv run pytest --cov=app --cov-report=term-missing` → **3756 passed**, app coverage **99%** (>90%).
- `uv run ruff check .` → All checks passed; `uv run pyright` → **0 errors**.
- Completion criteria: fold both ways ✅ · `Sources:` tail ✅ · TOOLS_SECTION + D4 verbatim + re-cut pins ✅ · E2E green/battery recorded/full suite/coverage/lint ✅ · docs pass ✅ · commit + dir move = harness.
- Battery: 5 phase-119 questions byte-identical to the phase-119 record (GATE PASS); the 2 Besta questions **skipped loudly** — verified the 2026-09-05 replica dump has zero `ikea` matches (`grep -c -i ikea data/bor_live_kb_replica.dump.sql` = 0); rank gate stays with the owner's live KB.
- Docs fixed: README — overview-tail doc + `BOR_KB_OVERVIEW_MAX_CHARS` tail-cut constraint, the phase-162 search-discipline paragraph, per-phase (not per-story) E2E wording, new "Retrieval regression battery" section; AGENTS.md — rule 4 per-phase wording + battery command in Quick reference. (The overview's expected "AGENTS.md §6 tool table" does not exist in this repo — the grep contract line lives in README's tool table, already updated.)
- Deviations (recorded, not assumed): `_fold` adds `casefold` (required for the pinned `ß → ss`); `①` NFKD-decomposes to `1` (the overview's parenthetical was wrong) and is excluded by `NAME_TOKEN_MIN_LEN`; pre-fix evidence lives in the reports dir because task files are read-only for this pass.
- Owner follow-up A6 (runtime, not code): add the Tuning-tab steering note "IKEA's BESTÅ assembly PDF is a live source — search it as `BESTÅ` or `AA-1272068`".
- Next pending phase: none — 162 is the only entry in `todo/` (harness moves it to `complete/`).

2026-10-07 01:42:01 -04:00

..

__init__.py

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

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

auth_helpers.py

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

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

conftest.py

phase: 140_pictorial_pdf_pages

2026-09-30 19:16:35 -04:00

mock_llm.py

phase: 161_reasoning_bubble

2026-10-06 06:36:09 -04:00

slow_llm.py

feat(sources): real-time file progress for sync and upload — background upload with success toast

2026-09-01 23:51:43 -04:00

test_admin_auth.py

phase: 97_kb_tree_catalog

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

test_admin_theme_tab.py

phase: 93_theme_semantic_completion

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

test_agent_document_tools.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_agent_unlimited_tools.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_answer_images.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_api_tokens.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_archive_upload_sources.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_asset_cache_revalidation.py

fix(web): never 304 a rewritten page — pages drop conditional validators, assets keep them

2026-08-31 01:35:28 -04:00

test_background_no_motion.py

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

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

test_big_read_progress.py

phase: 106_document_dates

2026-09-13 19:28:05 -04:00

test_bottom_chat_actions.py

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

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

test_cache_busting.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_answer_clusters.py

phase: 130_chat_answer_clusters

2026-09-28 07:49:37 -04:00

test_chat_chip_cap.py

phase: 157_chat_chip_cap

2026-10-04 22:18:31 -04:00

test_chat_db_pool.py

phase: 110_fix_sse_db_pool_exhaustion

2026-09-14 15:55:13 -04:00

test_chat_history.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_chat_image_questions.py

phase: 123_chat_image_questions

2026-09-25 05:19:18 -04:00

test_chat_persistence.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_chat_rag.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_chat_save_payload_limits.py

phase: 83_chat_save_payload_limits

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

test_chip_sizing_question_cap.py

phase: 157_chat_chip_cap

2026-10-04 22:18:31 -04:00

test_configurable_brand.py

phase: 122_image_documents

2026-09-25 01:54:23 -04:00

test_dark_tech_theme.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_document_back_navigation.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_document_dates.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_document_summaries.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_document_viewer_context.py

phase: 153_document_viewer_context

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

test_document_viewer.py

phase: 153_document_viewer_context

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

test_edit_and_resend.py

phase: 159_edit_and_resend_message

2026-10-05 19:07:33 -04:00

test_edit_summaries.py

phase: 97_kb_tree_catalog

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

test_embed_question_length.py

phase: 114_embed_question_length

2026-09-15 04:16:55 -04:00

test_extensionless_import.py

phase: 102_extensionless_filenames

2026-09-12 15:56:43 -04:00

test_failed_turn_retry.py

phase: 120_failed_turn_retry

2026-09-24 18:50:36 -04:00

test_folder_summary_voice.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_force_push_resync.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_garbage_pdf.py

phase: 151_pdf_image_extraction

2026-10-02 07:16:08 -04:00

test_git_source_branch.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_git_source_dates.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_git_source_links.py

phase: 145_git_source_links

2026-10-01 11:13:43 -04:00

test_git_source_tokens.py

phase: 135_git_source_branch

2026-09-28 21:15:03 -04:00

test_git_sources_admin.py

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

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

test_global_tuning.py

phase: 97_kb_tree_catalog

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

test_grep_regex_teaching.py

phase: 106_document_dates

2026-09-13 19:28:05 -04:00

test_harness_aligned_tools.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_header_consistency.py

phase: 118_summary_seed_context

2026-09-16 06:57:49 -04:00

test_hidden_folders_toggle.py

phase: 105_hidden_folders_toggle

2026-09-12 21:26:30 -04:00

test_hidden_tab_stream.py

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

2026-09-08 09:37:33 -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_width.py

phase: 97_kb_tree_catalog

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

test_history_wire_check.py

phase: 108_history_wire_check

2026-09-13 23:57:54 -04:00

test_honest_deflection.py

phase: 112_honesty_gate_weak_hits

2026-09-15 00:37:38 -04:00

test_image_anchor_context.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_image_documents.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_image_upload_feedback.py

phase: 132_image_upload_feedback

2026-09-28 13:45:31 -04:00

test_import_documents.py

phase: 97_kb_tree_catalog

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

test_import_extensions_env.py

phase: 97_kb_tree_catalog

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

test_incremental_folder_summaries.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_kb_overview_freshness.py

phase: 162_search_recall_small_sources

2026-10-07 01:42:01 -04:00

test_kb_overview.py

phase: 162_search_recall_small_sources

2026-10-07 01:42:01 -04:00

test_kb_tree_nav.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_kb_tree.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_llm_history.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_llm_retry.py

phase: 120_failed_turn_retry

2026-09-24 18:50:36 -04:00

test_loading_feedback.py

phase: 111_chat_banner_retry

2026-09-14 23:07:56 -04:00

test_local_directory_sources.py

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

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

test_long_answers.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_ls_tree_drilldown.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_markdown_blockquotes.py

phase: 138_markdown_blockquotes

2026-09-30 10:49:40 -04:00

test_markdown_tables.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_mobile_chat_hamburger_boot.py

phase: 88_mobile_chat_hamburger_boot

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

test_mobile_hamburger_nav.py

phase: 85_mobile_menu_gate_overlap

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

test_mobile_keyboard_focus.py

phase: 143_mobile_keyboard_after_answer

2026-10-01 07:03:15 -04:00

test_modal_back_button.py

phase: 144_modal_back_button

2026-10-01 08:49:50 -04:00

test_name_signal_read_chips.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_nav_consistency.py

phase: 97_kb_tree_catalog

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

test_nav_rename_sources.py

phase: 93_theme_semantic_completion

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

test_nav_switch_keeps_stream.py

phase: 97_kb_tree_catalog

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

test_navbar_refresh.py

phase: 160_tool_budget_telemetry

2026-10-06 01:42:44 -04:00

test_no_reply_autoscroll.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_oneshot_llm_retry.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_pdf_image_context.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_pdf_image_extraction.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_pdf_pages_in_sources.py

phase: 148_pdf_pages_in_sources

2026-10-01 16:58:01 -04:00

test_pdf_support.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_pictorial_pdf.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_pinned_composer.py

phase: 104_chip_sizing_question_cap

2026-09-12 19:45:00 -04:00

test_quadlet_jinja_import.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_read_line_ranges.py

phase: 131_read_line_ranges

2026-09-28 11:49:55 -04:00

test_read_range_dedupe.py

phase: 141_read_range_dedupe_fix

2026-10-01 01:27:46 -04:00

test_read_range_tool_lines.py

phase: 139_read_range_tool_lines

2026-09-30 12:55:23 -04:00

test_read_truncation_cap.py

phase: 139_read_range_tool_lines

2026-09-30 12:55:23 -04:00

test_reasoning_bubble.py

fix(rag): stop the per-run blocks from folding — the container is the one disclosure

2026-10-06 14:44:41 -04:00

test_response_to_docs.py

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

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

test_responsive_polish.py

phase: 130_chat_answer_clusters

2026-09-28 07:49:37 -04:00

test_retrieval_quality.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_retry_answer.py

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

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

test_save_doc_session.py

phase: 115_doc_draft_discard

2026-09-15 05:35:05 -04:00

test_save_share_ux.py

phase: 100_page_width_consistency

2026-09-12 13:37:19 -04:00

test_search_recall_small_sources.py

phase: 162_search_recall_small_sources

2026-10-07 01:42:01 -04:00

test_search_tool_scope.py

phase: 146_search_tool_scope

2026-10-01 12:48:04 -04:00

test_search_tool.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_security_headers.py

phase: 123_chat_image_questions

2026-09-25 05:19:18 -04:00

test_share_chat.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_shared_header.py

phase: 97_kb_tree_catalog

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

test_smoke.py

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

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

test_source_chip_quality.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_source_ignore_paths.py

phase: 89_source_ignore_paths

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

test_source_removal_cleanup.py

phase: 90_upload_no_scan

2026-09-09 14:08:18 -04:00

test_sources_midstream_bug.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_stale_saved_chats.py

feat(chat): save by default + share anonymously — auto-saved chats, guest-facing Share, success toast, action row

2026-08-31 05:20:25 -04:00

test_stale_ui_copy.py

phase: 93_theme_semantic_completion

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

test_steering.py

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

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

test_sticky_navbar.py

phase: 100_page_width_consistency

2026-09-12 13:37:19 -04:00

test_stop_generation.py

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

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

test_suggestion_chips.py

phase: 104_chip_sizing_question_cap

2026-09-12 19:45:00 -04:00

test_summary_in_viewer.py

phase: 118_summary_seed_context

2026-09-16 06:57:49 -04:00

test_summary_seed_context.py

phase: 119_name_signal_read_chips

2026-09-16 15:50:48 -04:00

test_sync_button.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_cancel.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_changed_only.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_chunk_progress.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_image_progress.py

phase: 152_sync_progress_image_pass

2026-10-03 01:52:41 -04:00

test_sync_label_mobile.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_model_down.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_progress_box.py

phase: 150_drop_sync_result

2026-10-02 02:35:03 -04:00

test_sync_status_freshness.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_sync_summary_visibility.py

phase: 155_folder_summary_voice

2026-10-04 16:32:50 -04:00

test_sync_upload_progress.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_table_ux_polish.py

phase: 156_table_ux_polish

2026-10-04 20:46:57 -04:00

test_theme_save_and_coverage.py

phase: 93_theme_semantic_completion

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

test_theme_semantic_completion.py

phase: 118_summary_seed_context

2026-09-16 06:57:49 -04:00

test_thinking_display.py

fix(rag): stop the per-run blocks from folding — the container is the one disclosure

2026-10-06 14:44:41 -04:00

test_thinking_scroll.py

fix(rag): stop the per-run blocks from folding — the container is the one disclosure

2026-10-06 14:44:41 -04:00

test_thinking_timeline.py

fix(rag): stop the per-run blocks from folding — the container is the one disclosure

2026-10-06 14:44:41 -04:00

test_toggle_after_nav.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_page.py

phase: 101_tokens_page_overhaul

2026-09-12 15:16:02 -04:00

test_tool_budget_telemetry.py

phase: 160_tool_budget_telemetry

2026-10-06 01:42:44 -04:00

test_tool_call_compact.py

fix(rag): stop the per-run blocks from folding — the container is the one disclosure

2026-10-06 14:44:41 -04:00

test_tool_path_teaching.py

phase: 106_document_dates

2026-09-13 19:28:05 -04:00

test_tool_scaffolding_guardrails.py

phase: 120_failed_turn_retry

2026-09-24 18:50:36 -04:00

test_tuning_nav_link.py

refactor(agents): migrate .agent/ planning tree to .agents/

2026-09-05 10:57:07 -04:00

test_tuning_toggle_flash.py

refactor(agents): migrate .agent/ planning tree to .agents/

2026-09-05 10:57:07 -04:00

test_turn_progress_loader.py

phase: 158_thinking_timeline

2026-10-05 02:52:55 -04:00

test_ui_customization.py

phase: 122_image_documents

2026-09-25 01:54:23 -04:00

test_upload_no_scan.py

phase: 154_sync_status_freshness

2026-10-04 14:24:33 -04:00

test_wide_desktop_column.py

phase: 100_page_width_consistency

2026-09-12 13:37:19 -04:00