phase: 193_sync_remaining_count

**Phase 193 — final verification pass: all gates green.**

- **Verified (all 3 tasks already complete in `complete/193_sync_remaining_count/`):** `fmtSyncLabel`'s count part is `total > 0 && total - done > 0 ? \`${total - done} remaining\` : ""` (plain int, hidden at `N==0`, `total===0` → no part); docstrings updated; chunk/image/summaries parts + `counts_line` terminal + `app/` byte-untouched (`git diff --stat`: no `app/` files).
- **Completion criteria:** `N remaining` shape + marker pins ✅ · upload shares the builder (E2E upload arm) ✅ · chunk/image/summaries pins green ✅ · terminal `counts_line` green unedited + A4 title/`#sync-progress` pin ✅ · suite green, coverage 99% ✅ · lint/types clean ✅ · commit + `todo/→complete/` left to the harness (no git index/history commands run).
- `uv run pytest -q --cov=app --cov-report=term-missing` → **exit 0**, junit: **4792 tests, 0 failures/errors/skipped**, `TOTAL 7181 16 → 99%` (>90%)
- `uv run pytest tests/e2e/test_sync_remaining_count.py -v --no-cov` → **3 passed** (isolated, 53 s)
- Isolated `--no-cov` sweep of the 14 sync-lineage suites (label_mobile, upload_progress, chunk_progress, image_progress, progress_box, summary_visibility, archive_upload_sources, status_freshness, upload_no_scan, peak_memory_visible, session_reset, fast_path_deferred_content, git_freeze, smoke) → **14/14 exit 0**
- `uv run ruff check .` → All checks passed · `uv run pyright` → **0 errors**
- **Docs:** README.md reviewed in full (all 2408 lines) + AGENTS.md. Fixed 2 inconsistencies: the sync running-label clause claimed the upload label shows the count — now states it shares the ONE builder/shape but reports no counts since phase 90 (renders bare); phase-190's "the other ~72 rows" → "the other 83 rows of the panel's 86-row catalogue" (mechanically: 86 CATALOG rows, 84 overridable). `N remaining` already in the sync paragraph; task-01's `(n/m)` examples gone. AGENTS.md verified consistent (no clause names the running count part → unchanged per the phase's "do not add if absent"). Mechanically re-verified: all 86 `BOR_*` settings documented + defaults match, `.env.example` 88 vars covered, 0 broken README anchors, all cited file paths exist, 17 palette colors, migrations head `0030`, pages/shell routes, ports 8123/8901, E2E port allocations (new suite's 8211/8914 unique).
- **Notable:** task 02's documented deviation stands — `files_done` is the importer's 1-based *current* file, so the phase doc's `[1-4]` range is unreachable; count-bearing frames are `1 … N−1` (pinned). Pre-existing, untouched: `E2E_APP_PORT_TOOLBUDGET`/`SAVEDOC` both 8129 and `SYNCUP`/`SYCNCEL` both 8133 — harmless under the one-suite-at-a-time rule.
- **Next pending phase:** none — `193_sync_remaining_count` is the last entry in `.agents/phases/todo/`.

tests/e2e/test_sync_image_progress.py

@@ -92,7 +92,9 @@ Test → observable mapping (Playwright Mapping Rule):
    first ``· image `` label — the two positions are distinct) and
    every image-span label carries the chunk part WITH IT (the last
    chunk position persists through the file's image span —
-   "… (1/1) · chunk 19/20 · image 3/4"), its total == the file's
+   "Syncing… imgpass/imgpass.pdf · chunk 19/20 · image 3/4" — no
+   ``N remaining`` part, phase 193 hides it on this final file), its
+   total == the file's
    TRUE chunk count; (c) the button ``title`` + ``aria-label`` carry
    the SAME full string as the box on every running sample (A4 —
    asserted per sample, atomically); (d) at settle the box shows the
@@ -109,6 +111,13 @@ Test → observable mapping (Playwright Mapping Rule):
    running sync re-enters with the WHOLE status, phase 98) renders
    the CURRENT image position with the A4 title/aria — then the run
    settles to the counts line.
+
+Phase 193 (task 02) moves the running file-count part to the distance
+to the end — ``N remaining``, ``N = files_total - files_done`` — and
+this fixture makes that edge VISIBLE rather than pinned away: its ONE
+file is also its FINAL file (``N == 0``), so the import span renders NO
+count part at all (the main part names the last file). The ``· chunk`` /
+``· image`` positions and the terminal counts line are byte-identical.
 """
 from __future__ import annotations
 
@@ -169,8 +178,9 @@ SLOW_DELAY_S = "1.5"
 #: The local source — the temp directory's basename (``kind=local`` →
 #: the directory's basename is the source name, phase 38).
 SOURCE = "imgpass"
-#: The single fixture file (the source is one file — the count part
-#: reads "(1/1)" throughout the import phase).
+#: The single fixture file (the source is one file, so phase 193 hides
+#: the count part for the whole import span — N = total - done = 0 on
+#: the only file there is).
 PDF_NAME = "imgpass.pdf"
 N_FILES = 1
 
@@ -739,8 +749,14 @@ def test_label_advances_through_the_image_span(
     # sampled) ---
     assert any(t == "Syncing…" for t in seen), f"no bare prelude label: {seen[:6]}"
     import_labels = [t for t in seen if t.startswith("Syncing… ")]
-    assert any(f"({N_FILES}/{N_FILES})" in t for t in import_labels), (
-        f"no file count part: {import_labels[:6]}"
+    assert any(f"Syncing… {SOURCE}/{PDF_NAME}" in t for t in import_labels), (
+        f"no live-file label: {import_labels[:6]}"
+    )
+    # Phase 193 (A1): the count part counts DOWN and hides at the FINAL
+    # file — this fixture's one file IS its final file (N = 0), so no
+    # running label carries it (the pre-phase "(1/1)" is gone).
+    assert all(" remaining" not in t for t in import_labels), (
+        f"the final file must render no count part: {import_labels[:6]}"
     )
 
     # --- the chunk part appeared EARLIER in the run (the two
@@ -783,8 +799,9 @@ def test_label_advances_through_the_image_span(
     ns = [n for n, _ in positions]
     assert ns == sorted(ns), f"the climb is backwards somewhere: {positions}"
     assert N_IMAGES in ns, f"the climb never reached the total: {positions}"
-    # The two positions COEXIST (distinct and both may show — "… (1/1)
-    # · chunk 19/20 · image 3/4"): every image-span label carries the
+    # The two positions COEXIST (distinct and both may show —
+    # "Syncing… imgpass/imgpass.pdf · chunk 19/20 · image 3/4", with no
+    # `N remaining` part on this single-file run — phase 193): every image-span label carries the
     # chunk part with it (the last chunk position persists through the
     # file's image span — the per-file reset + the phase transitions
     # clear it, not the end of the chunk span).