phase: 151_pdf_image_extraction

The 149/150 CSS changes touch the sources-page sync UI visible behind the modal, so the regenerated screenshot is the accurate record of the current UI (house convention — the suite rewrites it each run; it was re-committed in phases 144/145/148 the same way). I'll keep it in the working tree.

All verification is complete. Final state:

**Phase 151 — final verification pass: complete, project 100% green.**

- **Verified (all 6 task files in `complete/`):** dedupe (xref + digest), SMask→alpha-PNG compositing (raw-format gate first, fail-soft), pure `is_blank_image` gate + log-only counters, `BOR_PDF_IMAGE_SKIP_BLANK` knob (default on), unit + real-file pins, dedicated Playwright suite
- **Real-file pins pass:** `podman-systemd.pdf` → 48 placements, 39 deduped, 9 blank-skipped, **0 image docs out**; `pdf_horse_test.pdf` → masked JPEG composited to alpha PNG, kept; `players_handbook.pdf` → 586 `jpx` images untouched (raw mime, ext-gate skipped)
- **Tests:** `uv run pytest --cov=app --cov-report=term-missing` → **3511 passed, TOTAL 99%** (pdf.py 100%, importer.py 99%, config.py 100%); dedicated E2E `tests/e2e/test_pdf_image_extraction.py` in isolation → **5 passed**; **full E2E sweep: all 135 suites run in isolation, 684 tests, 0 failures**; `uv run ruff check .` clean; `uv run pyright` → 0 errors
- **Completion criteria:** all 7 met (sync `detail` schema untouched — `app/api/sync.py`/`app/schemas.py` unmodified; counters in the shared `import_sources` → `summary.log()` path; commit left to the harness per instructions)
- **Docs:** README.md and AGENTS.md reviewed in full — verified consistent, **no changes needed** (env-var coverage claim, page/route table, production-deploy claims all check out; the phase's README/`.env.example` additions match the code). Note: PLAN.md §7.1's 46rem chat column is superseded by phase 100 (AGENTS.md rule 5 states this correctly; PLAN.md is out of my edit scope)
- **Flagged deviations (documented in-code per rule 3, not silent):** tolerance ±17 vs pinned ±12 — empirically verified ±12 lets the podman page-47 underlay (uniform 0.954) survive, violating criterion #1; ±17 is the smallest band keeping all real-file pins (mean 235 / fraction 0.98 unchanged); gate measures the base stream, not the premultiplied composite (which darkens transparent regions and would miss the underlays)
- **Next pending phase:** `152_sync_progress_image_pass`

tests/unit/test_importer.py

@@ -990,9 +990,12 @@ def test_import_summary_log_line_includes_summary_counters(
     phase-106 date-refresh counter, the phase-122 ``images_failed``
     counter, the phase-137 ``image_context_backfilled`` counter (next
     to ``images_failed``), the phase-133 ``pdfs_screenshotted``
-    counter, and the phase-140 ``pdfs_pictorial`` /
-    ``pdf_pictorial_pages`` counters (next to ``pdfs_screenshotted``)
-    sit after ``dates_updated``, before ``formats``."""
+    counter, the phase-140 ``pdfs_pictorial`` /
+    ``pdf_pictorial_pages`` counters (next to ``pdfs_screenshotted``),
+    and the phase-151 ``pdf_images_deduped`` / ``pdf_images_blank_skipped``
+    counters (the parser's per-PDF drop counts, next to
+    ``pdf_pictorial_pages``) sit after ``dates_updated``, before
+    ``formats``."""
     s = ImportSummary()
     s.files, s.added, s.chunks, s.embed_batches = 3, 3, 5, 4
     s.summaries, s.summary_errors = 2, 1
@@ -1003,6 +1006,8 @@ def test_import_summary_log_line_includes_summary_counters(
     s.pdfs_screenshotted = 1
     s.pdfs_pictorial = 2
     s.pdf_pictorial_pages = 5
+    s.pdf_images_deduped = 3
+    s.pdf_images_blank_skipped = 1
     s.formats = {"md": 1, "yaml": 2}
     with caplog.at_level(logging.INFO, logger="app.importer"):
         s.log()
@@ -1012,6 +1017,7 @@ def test_import_summary_log_line_includes_summary_counters(
         "chunks=5 embed_batches=4 summaries=2 summary_errors=1 summary_backfilled=1 "
         "dates_updated=0 images_failed=0 image_context_backfilled=2 "
         "pdfs_screenshotted=1 pdfs_pictorial=2 pdf_pictorial_pages=5 "
+        "pdf_images_deduped=3 pdf_images_blank_skipped=1 "
         "formats=yaml:2,md:1"
     )