phase: 118_summary_seed_context

**Phase 118 final verification pass — complete.** All criteria verified; 4 pre-existing defects found and fixed.

- **Verified:** summary-seed wiring (`select_suggested` top-5 no-floor → summary blocks, no full text in HIGH prompt), all-doc markdown summaries + NULL backfill (`summary_backfilled`, no `sources_meta` bump), `read` adds full text with `read_docs`-only dedupe, `done.sources` = suggested+read / durable record = suggested+related+read + `suggested=N` log line (seen live in E2E), byte-locked PERSONA/LOW/TOOLS_SECTION, battery gate PASS recorded in `TOOL_CALLING_TESTING.md` §10 (turbo 2026-09-16: 1/2/4 GREEN, cond-3 reported 9/10 per A7, contract 21/21, caps 0).
- **Defects fixed (all pre-existing, none phase-118):** ① `ChatMessage` schema missing the phase-113 `related` key → `extra="forbid"` 422'd every done-time auto-save of grounded turns with a related tier, leaving `message_count=1` (root cause of `test_share_chat` 3F; browser-level instrumentation proved the PUT 422) — added the field + unit/integration pins; ② `test_theme_semantic_completion` pins stale vs phase-117 debox (border/chip removed) — re-targeted to assert border/chip *absence*; ③ `test_header_consistency` `<26`px pin red on 26.125px native date-input line — bound relaxed to `<34` (wrap-detection intent kept); ④ `test_navbar_refresh` bor.chat.v1 key set updated for `related`.
- **Test/lint/coverage:** `uv run pytest --cov=app --cov-report=term-missing` → **2506 passed, app/ 99%** (>90%); `uv run ruff check . && uv run pyright` → clean, 0 errors.
- **E2E:** new story suite in isolation → **2 passed**; full 103-suite matrix sweep (each isolated) → **all 103 green** after the fixes; `test_share_chat` 4 passed, `test_theme_semantic_completion` 8 passed, `test_header_consistency` 3 passed, `test_navbar_refresh` 7 passed.
- **Deviations:** none from LOCKED decisions. Note: orphaned diagnostic uvicorn processes briefly made E2E sessions exercise stale code — killed and re-verified; a sweep-regenerated tracked screenshot was restored. No commits made (harness commits).
- **Completion criteria:** all 7 ✅ (commit/phase-move is the harness's step).
- **Next pending phase:** none — `todo/` holds only this phase's overview pending the harness move.

tests/integration/test_import_docs_overview.py

@@ -30,8 +30,10 @@ ends with the folder-summary stats —
 (this fixture's 2-doc source holds exactly ONE qualifying subtree: the
 source root) or ``folder_summaries=skipped`` otherwise — so the line
 pinned here gains that token, and a KB-changing run burns exactly ONE
-extra ``lite`` call (the source-root folder summary, markdown files
-never get a document summary).
+extra ``lite`` call beyond the phase-118 document summaries (the
+source-root folder summary; markdown files get document summaries too
+since phase 118, A2 — so this 2-doc markdown source burns TWO doc-summary
+calls on a fresh import).
 """
 from __future__ import annotations
 
@@ -97,7 +99,8 @@ def _run_main(
 
 @pytest.fixture()
 def src(tmp_path: Path) -> Path:
-    """A source dir with two markdown docs (md → no summary chat calls)."""
+    """A source dir with two markdown docs (phase 118, A2: both get
+    document summaries — two extra ``chat`` calls over pre-118)."""
     root = tmp_path / "MyDocs"
     root.mkdir()
     (root / "alpha.md").write_text("# Alpha\n\nFirst document.\n", encoding="utf-8")
@@ -164,16 +167,18 @@ def test_changed_import_writes_overview_row(
         "overview=updated sources_version=1 folder_summaries=1/0/0"
     )
     assert _version(db) == 1  # phase 53: a changed import bumps exactly once
-    # Exactly two lite calls — the overview + the source-root folder
-    # summary (markdown files never get a document summary, so nothing
-    # else may touch ``chat``).
-    assert len(llm.chat_calls) == 2
-    by_role = {m["role"]: m["content"] for m in llm.chat_calls[0]}
+    # Exactly four lite calls — the two phase-118 document summaries
+    # (markdown included) + the overview + the source-root folder summary
+    # (nothing else may touch ``chat``).
+    assert len(llm.chat_calls) == 4
+    by_role = {m["role"]: m["content"] for m in llm.chat_calls[2]}
     assert "KB_OVERVIEW_MODE" in by_role["system"]
-    # One line per doc: source — path — title (no summary for markdown).
-    assert "MyDocs — alpha.md — Alpha" in by_role["user"]
-    assert "MyDocs — beta.md — Beta" in by_role["user"]
-    by_role = {m["role"]: m["content"] for m in llm.chat_calls[1]}
+    # One line per doc: source — path — title — first summary line
+    # (phase 118: the markdown docs are summarized too — the fake's
+    # deterministic digest for each).
+    assert "MyDocs — alpha.md — Alpha — Summary of #" in by_role["user"]
+    assert "MyDocs — beta.md — Beta — Summary of #" in by_role["user"]
+    by_role = {m["role"]: m["content"] for m in llm.chat_calls[3]}
     assert "FOLDER_SUMMARY_MODE" in by_role["system"]
     assert by_role["user"].splitlines()[0] == "Folder: MyDocs"
     # The model's outline lands in the single row.
@@ -197,17 +202,19 @@ def test_unchanged_reimport_does_not_call_lite(
     assert out.rstrip().endswith(
         "overview=updated sources_version=1 folder_summaries=1/0/0"
     )
-    assert len(llm.chat_calls) == 2  # overview + source-root folder summary
+    # 2 doc summaries (phase 118) + overview + source-root folder summary.
+    assert len(llm.chat_calls) == 4
     assert _row(db) is not None
 
-    # Same hashes → no KB change → no lite call, previous outline kept.
+    # Same hashes → no KB change → no lite call, previous outline kept —
+    # and nothing to backfill (both summaries are already stored).
     rc, out = _run_main(monkeypatch, llm, ["--source", str(src)], capsys)
     assert rc == 0
     assert "unchanged=2" in out
     assert out.rstrip().endswith(
         "overview=skipped sources_version=skipped folder_summaries=skipped"
     )
-    assert len(llm.chat_calls) == 2  # no new lite call
+    assert len(llm.chat_calls) == 4  # no new lite call
     row = _row(db)
     assert row is not None and row.content == "Summary of MyDocs"
     assert _version(db) == 1  # phase 53: an unchanged re-run never bumps
@@ -241,7 +248,10 @@ def test_lite_failure_is_fail_soft(
     assert out.rstrip().endswith(
         "overview=failed sources_version=2 folder_summaries=0/1/0"
     )
-    assert len(bad.chat_calls) == 2  # the (failed) attempts were made
+    # The three (failed) attempts: the changed doc's summary (phase 118),
+    # the overview, and the folder summary — the unchanged, already-
+    # summarized doc burns no backfill.
+    assert len(bad.chat_calls) == 3
     row = _row(db)
     assert row is not None
     assert row.content == previous_content  # previous row untouched
@@ -262,7 +272,7 @@ def test_limit_run_skips_overview(
     assert out.rstrip().endswith(
         "overview=updated sources_version=1 folder_summaries=1/0/0"
     )
-    assert len(llm.chat_calls) == 2
+    assert len(llm.chat_calls) == 4  # 2 doc summaries + overview + folder
 
     # An incomplete walk must not rewrite the outline (mirrors the
     # --prune-with---limit guard) — and must not advance the version.
@@ -273,7 +283,9 @@ def test_limit_run_skips_overview(
     assert out.rstrip().endswith(
         "overview=skipped sources_version=skipped folder_summaries=skipped"
     )
-    assert len(llm.chat_calls) == 2  # --limit never burns a lite call
+    # --limit walks only alpha.md: its changed summary is the sole new
+    # lite call; the overview + folder gates skip under --limit.
+    assert len(llm.chat_calls) == 5
     row = _row(db)
     assert row is not None and row.content == "Summary of MyDocs"
     assert _version(db) == 1  # phase 53: --limit debug runs never bump
@@ -323,6 +335,7 @@ def test_prune_only_run_bumps_sources_version(
 
     # Delete one file; a --prune run drops exactly it: no add/update,
     # but pruned=1 → the version still bumps while the overview skips.
+    assert len(llm.chat_calls) == 4  # 2 doc summaries + overview + folder
     (src / "alpha.md").unlink()
     rc, out = _run_main(monkeypatch, llm, ["--source", str(src), "--prune"], capsys)
     assert rc == 0