phase: 187_sync_peak_memory_line

**Phase 187 — final verification pass: all criteria met, repo 100% green.**

Verified (all four tasks already in `complete/`)
- `app/core/memory.py`: `rss_mb` / `rss_peak_mb` / `cgroup_peak_mb` / `fmt_mb`, pure stdlib, never-raise, **100%** coverage, 24 branch tests.
- Lifecycle lines append-only: `sync: started … rss_mb=`, all three terminals `… rss_mb= rss_peak_mb=` (failed = sanitized one-liner beside the surviving `logger.exception`), `import: summary … rss_mb=`; prefixes byte-identical.
- `GET /api/sync/status`: additive `rss_mb`/`rss_peak_mb` (`int|null`), keyed off the ONE `_sample_rss` (run start, phase transitions, forced terminals, 5 s-throttled hook), `peak >= current` invariant, anonymous 403.
- `sources.js` `fmtSyncPeakClause`: ` · peak <N> MB` trailing the counts line / "Sync cancelled", nothing when null, no new control/live region.

Gates (exact commands)
- `uv run pytest --cov=app --cov-report=term-missing` → **4570 passed**, TOTAL **99%**, `app/api/sync.py` **100%**, `app/core/memory.py` **100%**
- `uv run ruff check .` → clean · `uv run pyright` → **0 errors**
- `uv run pytest tests/e2e/test_sync_peak_memory_visible.py -v --no-cov` → **5 passed in isolation** (ran twice)
- All 27 touched E2E families re-run **in isolation**, all green (progress_box 8, cancel 3, status_freshness 4, summary_visibility 3, sync_button 3, session_reset 4, git_freeze 2, git_log_stream_dates 5, PDF/image suites, …)

Completion criteria: every checkbox ✅ except the commit + phase-dir move, which belong to the harness.

Documentation
- README reviewed in full (pages, commands, config tables cross-checked against `app/config.py` — 85 env rows, all defaults match; phase-187 ops section, greps, process-vs-cgroup caveat): consistent, no changes needed.
- `AGENTS.md`: **fixed one pre-existing inconsistency** — rule 6 claimed the no-CDN test covers "the index page"; it actually parametrizes 10 pages (all but `/doc-edit.html`).

Notable
- Two failures early in the pass were self-inflicted by running the E2E module concurrently with the full suite on the shared Postgres (TRUNCATE deadlock + one order-dependent `test_overview` flake); both vanish under the documented serial isolation — no code defect, no change made.
- **PLAN §9 still needs the owner's reconciliation** (phase 187 adds the sync memory fields + two status keys; PLAN is never agent-edited — AGENTS rule 10 carries the spec). `TODO.md` holds an unrelated owner note, left untouched.

Next pending phase: `188_chunks_hnsw_index`.

tests/e2e/test_sync_image_progress.py

@@ -141,6 +141,7 @@ from e2e.conftest import (
     USE_REAL_LLM,
     _wait_http,
 )
+from e2e.sync_helpers import counts_line
 
 REPO = Path(__file__).resolve().parents[2]
 
@@ -710,13 +711,15 @@ def test_label_advances_through_the_image_span(
         if snap["box"] != last:
             seen.append(snap["box"])
             last = snap["box"]
-        if snap["box"] == SETTLE_TEXT:
+        if counts_line(SETTLE_TEXT).fullmatch(snap["box"]):
             break
         time.sleep(0.2)
 
     # --- the settle (the UI's 2 s poll renders the terminal at most one
     # tick after it lands; the endpoint is the source of truth) ---
-    assert last == SETTLE_TEXT, f"the run never settled to the counts line: {seen[-5:]}"
+    assert counts_line(SETTLE_TEXT).fullmatch(str(last)), (
+        f"the run never settled to the counts line: {seen[-5:]}"
+    )
     terminal = _wait_terminal(app_url)
     # The counts line's ground truth: the PDF + its 4 embedded-image
     # docs — one file, 5 added.
@@ -806,7 +809,7 @@ def test_label_advances_through_the_image_span(
     # surface): the image part is not in it, not in the title, not in
     # the aria (the settle restores the ship aria value).
     box = page.locator("#sync-progress-text").inner_text()
-    assert box == SETTLE_TEXT, box
+    assert counts_line(SETTLE_TEXT).fullmatch(box), box
     assert "· image" not in box and "· image" not in (btn.get_attribute("title") or "")
     assert btn.get_attribute("aria-label") == "Sync sources", btn.get_attribute("aria-label")
     expect(page.locator("#sync-error-banner")).to_be_hidden()
@@ -869,7 +872,7 @@ def test_mid_run_reload_re_attaches_with_image_position(
     # terminal clears the position, test 1 pins the endpoint half),
     # the terminal label, the parts cleared + empty.
     expect(page.locator("#sync-progress-text")).to_have_text(
-        SETTLE_TEXT, timeout=SETTLE_TIMEOUT_MS
+        counts_line(SETTLE_TEXT), timeout=SETTLE_TIMEOUT_MS
     )
     expect(page.locator("#sync-label")).to_have_text(SYNCED_LABEL, timeout=30_000)
     btn = page.locator("#sync-btn")