phase: 141_read_range_dedupe_fix

All gates green and verified. Final report:

**Phase 141 final verification pass — complete**

- **Verified (tasks 01–04 already in `complete/`):** `AgentHolder.read_coverage` span recording (all 4 read outcomes, refusals record nothing); coverage dedupe matrix (range read of uncovered lines proceeds, fully-covered re-read → `ALREADY_IN_CONTEXT` with a now-true claim, partial plain re-read → `REREAD_PARTIAL` naming merged spans, `REREAD_TRUNCATED` retired, fast path retired per task 02); `TOOLS_SECTION` re-read sentence re-cut to coverage-true form (prompt lock re-pinned); owner-scenario integration repro (pure + truncated variants) and mock `read two ranges` flow + dedicated E2E — all match the task specs exactly; no code defects found.
- **Tests/lint/coverage:** `uv run pytest --cov=app --cov-report=term-missing` → exit 0, TOTAL 99% (5498 stmts, `app/rag/agent.py` 99%) — run twice, both green; `uv run pytest tests/e2e/test_read_range_dedupe.py -v --no-cov` → 2 passed in isolation; `uv run ruff check . && uv run pyright` → All checks passed / 0 errors.
- **Completion criteria:** (1) two different ranges both reach the model, re-covered re-read refused truthfully — ✅ (integration + E2E); (2) partial plain re-read gets the `offset`/`limit` teaching, false claim gone both directions — ✅; (3) plain-read + phase-131 result shapes byte-identical, existing pins pass unchanged — ✅; (4) all gate commands green, >90% — ✅; (5) no behavior change in completed phases (grep/ls, truncation notice, `read_docs`/`read_truncations` signals) — ✅ (whole project suite green).
- **Documentation:** README.md — fixed pre-existing phase-140 gap: `BOR_PDF_PICTORIAL` / `BOR_PDF_PICTORIAL_MIN_CHARS` were in `.env.example`/Settings but undocumented (README claims every `.env.example` var is covered); added the pictorial-PDF-pass bullet to the PDF section + two config-reference rows. AGENTS.md — verified consistent (rules, quick-ref commands, phase refs all check out) — no changes needed.
- **Notable:** overview's "fast path survives for holder-state rows" note is superseded by task 02's authoritative decision (every dedupe row resolves — "full" needs the true line count); implementation follows task 02. No phase files touched; changes left in the working tree for the harness commit.
- **Next pending phase:** `142_kb_overview_freshness`.

tests/unit/test_prompts.py

@@ -339,23 +339,39 @@ def test_tools_section_phase118_summary_seed_read_clause() -> None:
     """Phase 118 (task 04, A6): the ``read`` clause is rewritten for
     the summary-seed mode — the ``<documents>`` section holds
     SUMMARIES (a suggested document's full text is not in the prompt
-    until ``read`` adds it); do not re-read an already-read document
-    (answer from the text already in the prompt); if the user asks to
+    until ``read`` adds it); do not re-read a document already read
+    IN FULL (answer from the text already in the prompt); a PARTIAL
+    document (a range read, or a truncated read — re-pinned phase
+    141, task 02: the re-read sentence is the coverage-true form —
+    read the other parts with ``offset``/``limit``, the document is
+    not complete in the context until read all); if the user asks to
     open or read a suggested document, ``read`` it. The phase-72 "do
     not call ``read`` for a ``<documents>`` document" copy is retired.
     The ``ls`` clause (phase 94 drill-down contract), the ``grep``
     clause, and the discipline rules stay byte-identical — the
     prompt lock's prefix/suffix anchors survive (see
     ``test_prompt_lock``)."""
-    # The new summary-seed copy (pinned byte-for-byte).
+    # The summary-seed copy (pinned byte-for-byte — the phase-141
+    # coverage-true re-read sentence re-pins the pre-phase-141 line;
+    # the section's other bytes are unchanged).
     assert (
         "The <documents> section holds SUMMARIES — the full text of a "
         "suggested document is not in your prompt until you `read` it. "
-        "Do not re-read a document you have already read — its full "
-        "text is already in your prompt; answer directly from it. If "
-        "the user asks you to open or read a suggested document, "
-        "`read` it — that is the point of the section."
+        "Do not re-read a document you have already read in full — "
+        "its full text is in your prompt, answer from it. If you have "
+        "read only part of a document (a range read, or a truncated "
+        "read), read the other parts with `offset` and `limit` — the "
+        "document is not complete in your context until you have read "
+        "it all. If the user asks you to open or read a suggested "
+        "document, `read` it — that is the point of the section."
     ) in TOOLS_SECTION
+    # The retired pre-phase-141 re-read copy is gone (it claimed the
+    # FULL text for a document that may be only partially in the
+    # context — the owner's stuck-turn bug).
+    assert (
+        "Do not re-read a document you have already read — its full "
+        "text is already in your prompt; answer directly from it"
+    ) not in TOOLS_SECTION
     # The read identity handoff now also names the <documents> summary
     # blocks (the combined identity is shown there), keeping the
     # "including the source name" contract.