phase: 194_sync_pending_count

**Phase 194 — final verification pass: all green.**

**Verified (all 5 tasks already complete; nothing re-implemented needed)**
- `app/rag/importer.py`: `_prescan_pending` + `_pending_hash_stmt` (scalar `documents.file_hash`, own session, ONE `asyncio.to_thread` span, REPLACES the stats pre-walk), `on_scan_progress`, `progress` pair = pending position, `0` branch = byte-identical phase-193 walk.
- `app/config.py`/`settings_catalog.py`/`.env.example`: `sync_pending_count=1` + validator; `app/api/sync.py`: `"scan"` phase, `scan_done`/`scan_total` (additive after `files_total`, kept at every terminal), forced/throttled RSS split; `frontend/assets/sources.js`: `fmtSyncPhaseLabel` scan branch first-arm, `fmtSyncLabel` untouched.

**Tests / lint / coverage (exact commands)**
- `uv run pytest --cov=app --cov-report=term-missing` → **4835 passed**, `app/` 99% (7240 stmts / 16 miss), exit 0
- `uv run pytest tests/e2e/test_sync_pending_count.py -v --no-cov` → **8 passed in 150.81s** (phase suite, isolated)
- 14 sync-lineage E2E suites, one pytest process each (`test_sync_remaining_count`, `…_chunk_progress`, `…_progress_box`, `…_peak_memory_visible`, `…_label_mobile`, `…_upload_progress`, `test_archive_upload_sources`, `…_image_progress`, `…_summary_visibility`, `…_status_freshness`, `test_smoke`, `test_fast_path_deferred_content`, `test_sync_session_reset`, `test_sync_git_freeze`) → **all exit 0**
- `uv run ruff check .` → All checks passed; `uv run pyright` → **0 errors**

**Completion criteria** — all met: `N remaining` = predicted change set (E2E arms 1/2/5, first import counts the walk, no-change → no count part); `scan` phase visible + flips to `import`, scan pair reset/kept at terminals (`test_sync_scan_phase.py`); `BOR_SYNC_PENDING_COUNT=0` walk semantics ("7 remaining" arm) + **negative refuses startup naming the field (verified live by importing `app.main`)**; pre-scan off-loop + cancel lands `cancelled` (integration pins); CLI/upload byte-identical (unedited pins green); payload additive (`_PRE_187_STATUS_KEYS | _MEMORY_KEYS | _SCAN_KEYS`); suite green, coverage >90%, lint/types clean.

**Documentation** — 3 fixes: README sync "States" bullet had an **unclosed parenthesis** (pre-existing, 193/194) and the scan-label "total is 0" clause was ambiguous about a `=0` run (it still counts the walk once the import starts); **AGENTS.md rule 17 had a stray `)`** (pre-existing from phase 191). Also verified consistency both directions for all 87 settings ↔ README ↔ `.env.example` ↔ settings catalog, the pages table ↔ `app/main.py` routes, no stale `BOR_` names, and README/AGENTS claims through phase 194.

**Notes/deviations** — no live-infra changes (prod sync knob ships default-on, no deployment touched); no git index/history commands run (all changes left in the working tree for the harness); commit criterion left to the harness as instructed.

**Next pending phase:** none — `.agents/phases/todo/` holds only `194_sync_pending_count`, which is now ready to move to `complete/`.

tests/unit/test_settings_catalog.py

@@ -253,6 +253,29 @@ def test_sync_session_bound_field_types() -> None:
     assert Settings.model_fields["sync_prune_batch"].default == 500
 
 
+def test_sync_pending_count_row_is_a_plain_live_overridable_row() -> None:
+    """Phase 194 (task 01, D2): the pre-scan switch sits in ``Import &
+    sources`` beside the other two sync-run knobs with the ``Sync pending
+    count`` label and is plain — not ``secret`` (an int), not
+    ``restart_required`` (the importer reads ``llm.settings`` once per run, so
+    a saved override applies to the NEXT sync), overridable (the overlay is
+    generic over ``int`` fields). ``1`` is the shipped default — the pending
+    count is the FIX the owner asked for, so it ships on and the phase-193
+    walk position is the ``0`` rollback; a negative value fails startup, not
+    the panel."""
+    meta = CATALOG["sync_pending_count"]
+    assert meta.group == "Import & sources"
+    assert meta.label == "Sync pending count"
+    assert meta.secret is False
+    assert meta.restart_required is False
+    assert meta.overridable is True
+    assert "sync_pending_count" not in SECRETS
+    assert "sync_pending_count" not in RESTART_REQUIRED
+    assert "sync_pending_count" not in NON_OVERRIDABLE
+    assert Settings.model_fields["sync_pending_count"].annotation is int
+    assert Settings.model_fields["sync_pending_count"].default == 1
+
+
 def test_source_name_hit_bonus_row_is_a_plain_live_overridable_row() -> None:
     """Phase 191 (task 04, D3): the second selection-bonus row sits in
     ``Retrieval & honesty`` (right beside ``name_hit_bonus`` — the two