ducoterra e0f11e7aa8 phase: 126_pdf_support ...

All gates verified green — no code changes were needed on this pass. Final report:

## Phase 126 — PDF support: final verification pass

**Verified (all tasks 01–05 already complete in working tree):**
- `pymupdf` dep in `pyproject.toml`/`uv.lock`; `.env.example` documents the `pdf` token
- `app/rag/pdf.py` (text + image extraction, MIME mapping), page-aware `_chunk_pdf`, importer `_index_pdf_file` + embedded-image pass, archives covered via extension walk

**Test / lint / coverage results:**
- `uv run pytest` → 2997 passed
- `uv run pytest tests/e2e/test_pdf_support.py -v --no-cov` (isolation) → 6 passed
- `uv run pytest --cov=app --cov-report=term-missing` → TOTAL **99%** (>90% gate), 2997 passed
- `uv run ruff check . && uv run pyright` → clean (0 errors)

**Completion criteria:**
1. PDF → doc with text/chunks/embedding/summary — ✅ (integration + E2E Sources-page tests)
2. `BOR_IMAGES=true`: embedded images → standalone image docs — ✅ (integration + E2E chat-chip test)
3. `BOR_IMAGES=false`: images skipped, text indexed — ✅ (both suites)
4. PDF renders as extracted text in viewer — ✅ (E2E)
5. Test/coverage/lint gates — ✅ (above)
6. Commit + phase move — harness handles (per protocol, no `git` on this pass)

**Decisions:** none new; inline `[Embedded image: …]` placeholders were a documented task-04 deviation (simplified spec wins) — not a defect. No defects found; repo left functional with changes in the working tree.

**Next pending phase:** none — `todo/` is empty once 126 is moved.

2026-09-27 09:36:40 -04:00

..

conftest.py

phase: 106_document_dates

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

test_agent_tools_dates.py

phase: 110_fix_sse_db_pool_exhaustion

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

test_agent_tools.py

phase: 110_fix_sse_db_pool_exhaustion

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

test_api.py

phase: 122_image_documents

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

test_auth_api.py

phase: 122_image_documents

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

test_caching_revalidation.py

phase: 91_admin_theme_tab

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

test_chat_api.py

phase: 125_image_anchor_context

2026-09-27 05:53:12 -04:00

test_chat_concurrency.py

phase: 110_fix_sse_db_pool_exhaustion

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

test_chat_db_sessions.py

phase: 110_fix_sse_db_pool_exhaustion

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

test_chats_api.py

phase: 124_image_chips_and_answers

2026-09-26 17:06:09 -04:00

test_containerfile_assets.py

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

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

test_doc_drafts_api.py

phase: 115_doc_draft_discard

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

test_docs_api_dates.py

phase: 106_document_dates

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

test_docs_api.py

phase: 125_image_anchor_context

2026-09-27 05:53:12 -04:00

test_document_content.py

phase: 122_image_documents

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

test_git_file_dates.py

phase: 107_git_full_history_dates

2026-09-13 23:21:39 -04:00

test_git_sources_api.py

phase: 121_git_source_tokens

2026-09-24 20:51:39 -04:00

test_git_sources_upload.py

phase: 90_upload_no_scan

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

test_import_docs_git.py

phase: 107_git_full_history_dates

2026-09-13 23:21:39 -04:00

test_import_docs_overview.py

phase: 118_summary_seed_context

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

test_import_extensionless.py

phase: 118_summary_seed_context

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

test_import_extensions_env.py

phase: 118_summary_seed_context

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

test_import_quadlet_jinja.py

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

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

test_importer_dates.py

phase: 106_document_dates

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

test_importer_e2e.py

phase: 118_summary_seed_context

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

test_importer_ignore.py

phase: 118_summary_seed_context

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

test_importer_include_hidden.py

phase: 118_summary_seed_context

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

test_importer.py

phase: 126_pdf_support

2026-09-27 09:36:40 -04:00

test_kb_overview_api.py

phase: 119_name_signal_read_chips

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

test_migration_0002.py

feat(rag): hybrid FTS+vector retrieval and multi-format ingestion — name-your-tool questions find the right document

2026-08-22 01:27:02 -04:00

test_migration_0004.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_migration_0005.py

feat(sources): admin page to add and remove git sources (TODO.md L4)

2026-08-26 18:42:28 -04:00

test_migration_0006.py

feat(sources): admin page to add and remove git sources (TODO.md L4)

2026-08-26 18:42:28 -04:00

test_migration_0007.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_migration_0008.py

feat(chat): save and view chat history — admin-only saved_chats, History page, open-a-chat return

2026-08-29 21:22:25 -04:00

test_migration_0009.py

feat(chat): share a chat by link — anonymous read-only /shared/<token> page, share/unshare

2026-08-30 01:34:44 -04:00

test_migration_0010.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_migration_0011.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_migration_0012.py

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

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

test_migration_0014.py

phase: 91_admin_theme_tab

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

test_migration_0016.py

phase: 93_theme_semantic_completion

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

test_migration_0017.py

phase: 94_ls_tree_drilldown

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

test_migration_0018.py

phase: 97_kb_tree_catalog

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

test_migration_0019.py

phase: 105_hidden_folders_toggle

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

test_migration_0020.py

phase: 106_document_dates

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

test_migration_0021.py

phase: 121_git_source_tokens

2026-09-24 20:51:39 -04:00

test_migration_0022.py

phase: 122_image_documents

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

test_migration_0023.py

phase: 125_image_anchor_context

2026-09-27 05:53:12 -04:00

test_name_hit_lexical.py

phase: 119_name_signal_read_chips

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

test_recency_boost.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_source_removal_api.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_steering_api.py

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

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

test_suggestions_api.py

phase: 103_suggestions_session_openers

2026-09-12 16:37:50 -04:00

test_sync_api.py

phase: 107_git_full_history_dates

2026-09-13 23:21:39 -04:00

test_sync_folder_summaries.py

phase: 118_summary_seed_context

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

test_tokens_api.py

phase: 101_tokens_page_overhaul

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

test_ui_settings_api.py

phase: 122_image_documents

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