phase: 163_pdf_strip_additive_selfheal

All gates verified. Final report:

**Phase 163 — final verification pass (all 5 tasks already complete; verification-only run)**

- Verified D1–D4 in code: `page_strip_mode` column + migration 0027, `DocContent` absent-never-null rule keyed off `page_count`; `_persist_pdf_pages` render → atomic tmp+`os.replace` writes → stale-tail-last + `strip_class` stamp; `_regate_pdf_strip` on both unchanged paths (mirror gate, heal, repair, fail-soft, one INFO line only when acting); viewer mode branch + Text/Pages toggle (Text default, `aria-pressed`, no innerHTML, lazy imgs).
- `uv run pytest --cov=app --cov-report=term-missing` → **3796 tests, exit 0, coverage 99%** (>90%)
- `uv run pytest tests/e2e/test_pdf_strip_additive_selfheal.py -v --no-cov` → **5 passed** in isolation
- `test_pdf_pages_in_sources + test_pictorial_pdf + test_garbage_pdf` → 10 passed; `test_document_viewer(_context) + test_image_documents` → 20 passed
- `uv run ruff check .` clean; `uv run pyright` → 0 errors; alembic **0027 downgrade→upgrade CLI round-trip clean** (+ integration pins)
- Completion criteria: additive view w/ toggle ✅ · primary DOM byte-identity ✅ · write-first order/mid-write-failure/atomic pins ✅ · heal + repair E2E ✅ · zero vision/LLM on fast path (mock-captured) ✅ · non-qualifying payload byte-identity ✅ · docs pass ✅
- **Documentation**: README.md + AGENTS.md reviewed in full — the phase's updates are accurate; all config-table defaults cross-checked against `app/config.py` (no drift), every page route, script, and E2E command referenced exists, every `.env.example` var documented — **verified consistent, no changes needed**.
- Notable: live `Letumdei` repair is owner-runtime post-deploy per D5 (next production Sync self-heals; no live changes made); the modified `.agents/screenshots/doc_modal_scrollbar_1280.png` is an E2E-regenerated artifact left for the pipeline commit.
- **Next pending phase:** `164_chat_error_honesty`

tests/unit/test_wide_column_css.py

@@ -13,12 +13,13 @@ without a browser:
 * NO ``@media (min-width: 1500px)`` block anywhere in the file — the
   phase-58 wide-desktop doubling is deleted in full (the token is
   72rem at every viewport);
-* the six reading-column selectors — ``.chat-shell``,
+* the reading-column selectors — ``.chat-shell``,
   ``.shared-shell``, ``.doc-md``, ``.doc-image`` (phase 122, task 04),
-  ``.doc-pages`` (phase 148, task 03 — the page strip), and
-  ``.doc-summary:has(+ .doc-md)`` — each capped with
-  ``max-width: var(--chat-column)`` and NOTHING else in the file uses
-  the token for a max-width (exactly six rules);
+  ``.doc-pages`` (phase 148, task 03 — the page strip),
+  ``.doc-view-toggle`` (phase 163, task 04 — the Text/Pages toggle
+  above the additive views), and ``.doc-summary:has(+ .doc-md)`` —
+  each capped with ``max-width: var(--chat-column)`` and NOTHING else
+  in the file uses the token for a max-width (exactly seven rules);
 * the flipped negative pin — ZERO literal ``max-width: 46rem`` rules
   remain (the phase-27/59/91 form-column caps are retired): the form
   shells (``.tuning-shell``, ``.theme-shell``, ``.doc-edit-shell``)
@@ -121,8 +122,10 @@ def test_the_reading_columns_use_the_token() -> None:
     task 04 — the viewer's image block rides the SAME reading column
     as its .doc-md sibling), .doc-pages (phase 148, task 03 — the
     viewer's page strip rides the SAME reading column in the shared
-    #doc-content slot) and .doc-summary:has(+ .doc-md) each cap with
-    max-width: var(--chat-column) — and exactly those six rules use
+    #doc-content slot), .doc-view-toggle (phase 163, task 04 — the
+    Text/Pages toggle sits above the additive views, aligned with
+    them) and .doc-summary:has(+ .doc-md) each cap with
+    max-width: var(--chat-column) — and exactly those seven rules use
     the token for a max-width (no other selector)."""
     css = _css()
     for selector in (
@@ -131,12 +134,13 @@ def test_the_reading_columns_use_the_token() -> None:
         ".doc-md",
         ".doc-image",
         ".doc-pages",
+        ".doc-view-toggle",
         ".doc-summary:has(+ .doc-md)",
     ):
         assert "max-width: var(--chat-column)" in _rule_block(css, selector), (
             f"{selector} must cap with max-width: var(--chat-column)"
         )
-    assert css.count("max-width: var(--chat-column)") == 6, (
+    assert css.count("max-width: var(--chat-column)") == 7, (
         "exactly the reading-column selectors use the token"
     )