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/`.
phase: 193_sync_remaining_count
2026-10-20 06:36:21 -04:00 · 2026-10-19 17:30:03 -04:00 · 2026-10-19 12:19:51 -04:00 · 2026-10-19 06:13:32 -04:00
190 changed files with 34346 additions and 439 deletions
@@ -0,0 +1,70 @@
 # Phase 194 — "N remaining" counts the files that will actually change
 **Source:** owner report 2026-10-19 — "I just synced the prod brain of reese and it said '1216 remaining' when it only had like 10 files to sync" (the prod KB holds ~10,000 importable files; that run changed ~10).
 **Story:** n/a (owner directive — phase 193's confirmed assumption A1 proved wrong in production)
 **Depends on:** `193_sync_remaining_count` (complete) — builds on the phase-64/98/128/129/152/179/184/185/187 sync lineage.
 ## Evidence (diagnosed from the code, read this not the chat)
 1. **The phase-193 label counts the WALK, not the WORK.** `frontend/assets/sources.js` `fmtSyncLabel` renders `N remaining` with `N = files_total − files_done` (the arithmetic is fine). But `app/rag/importer.py`'s pre-walk (L949–962) sets `total` to the COMBINED COUNT OF EVERY IMPORTABLE FILE across all sources (the 10,000), and the per-file hook (L1034–1039) reports `done = summary.files` (the 1-based position across ALL files walked). The fast path (phase 147/185) skips re-embedding for the unchanged 9,990 but still COUNTS them. Prod: "1216 remaining" = "8,784 files left to walk", while the actual work was ~10 files. Phase 193's E2E suite passed because its fixture KB was a FRESH import where walk == work — the incremental case the owner just hit was never pinned.
 2. **The change signal already exists per file.** `_file_hash` (L704–724 — the sha256 of the RAW bytes, streamed in 1 MiB chunks) compared against `documents.file_hash` (nullable `String(64)`, no index — looked up through the unique `(source, path)` constraint, `app/models.py` L119/L138–142) is EXACTLY the fast path's change predicate: stored NULL (no row, or a pre-phase row) or `!= digest` ⇔ the file will be re-indexed (added/updated). A pre-scan reusing that predicate predicts the change set with the SAME semantics the processing loop then applies — pre-phase NULL rows are predicted changed AND actually re-indexed (stamped) by the loop, so the prediction never lies about the stored-hash contract.
 3. **The pre-scan must be OFF the loop.** A 10,000-file hash+SELECT span run inline would park the single uvicorn loop for seconds — the exact phase-179 defect class pinned by `tests/integration/test_sync_git_freeze.py` (the 3 s git stub froze the 2 s status poll) and `tests/e2e/test_sync_git_freeze.py`. The git span moved to `asyncio.to_thread` (phase 179); the pre-scan does the same (the worker runs to completion on cancel; the run stops at the next phase-134 boundary — the `CancelledError` clause in `_run_sync`, L178–190 contract).
 4. **Only the UI sync pays anything.** `import_sources` has exactly two callers: `app/api/sync.py` (the UI sync — the ONLY one that passes `progress`) and `scripts/import_docs.py` L407 (the CLI — no `progress`). Uploads have no file-level progress at all (phase 90 A2 — `app/api/git_sources.py` L59; their label renders bare, the `test_archive_upload_sources.py` pins). Gating the pre-scan on `progress is not None` (the phase-64 skip rule) keeps every non-UI caller byte-identical.
 5. **The count is a prediction, and the drift edges are bounded.** The pre-scan runs seconds before the processing loop reaches a given file. A predicted file that turns out unchanged (reverted mid-run) still advances the count (it was predicted — `total` counted it) so the count reaches 0; a file changed AFTER the scan is indexed for real but does not advance the count, and the phase-193 `total − done > 0` guard hides the excess (never negative, never a stale "0 remaining"). The terminal `counts_line` ("N added · M updated …") stays the exact surface — untouched.
 ## Design (shared by all tasks — the executor reads this, not the chat)
 - **D1 — the pre-scan (task 01).** `import_sources` gains ONE optional callback `on_scan_progress: Callable[[int, int], None] | None = None` (the 1-based scan position + the importable total — the "only when provided", "hooks only assign fields", no-try/except contract of its three siblings). While `progress is not None` AND `llm.settings.sync_pending_count` is truthy (read ONCE before the source loop, the phase-184 read-once discipline — `0` = rollback to the phase-193 walk-position semantics, negative value refuses startup loudly, the house kill-switch pattern):
  - the EXISTING stats-only pre-walk is REPLACED (not augmented — no third walk) by ONE `asyncio.to_thread` span that, per root with the EXACT `iter_importable_files` rules of the processing loop (same `ignore` / `include_hidden` / `image_extension_set` / images-toggle gating): (a) takes the per-root file list and its length (the scan total — the same number the old pre-walk computed), then (b) per file: `_file_hash(path)` (the existing streamed helper) + ONE scalar `SELECT documents.file_hash WHERE source = :s AND path = :p` (the only column — NO entity load, NO `defer`/`load_only` row, no session retention, one light metadata read per file; phase 184/185 compliant: it is not a whole-entity `select(Document)`, it defers nothing because it loads no row, and the processing loop's `_doc_row_stmt` fast-path row load stays the only ROW load) → `pending = {(source, rel)}` for every file whose stored hash is NULL or `!= digest`;
  - `on_scan_progress(position, total)` fires per file (the scan position for the UI's "Scanning… (n/total)" label — called from the worker thread; field assignments are GIL-atomic, the phase-179 off-loop contract), and `files_total` becomes `len(pending)` while the per-file `progress` call's `done` becomes the 1-based POSITION IN THE PENDING SET (it advances for every predicted file, whether or not it turns out changed at processing time — the count and its denominator stay on the SAME set so the arithmetic never runs away);
  - `summary.files` (the `import: summary … files=` log count — every file the loop processed, append-only log discipline) is UNTOUCHED; the `sync: done/cancelled/failed … files_done=… files_total=…` lines keep their EXACT shape, now carrying the pending counts (the module docstring names the semantic shift);
  - the processing loop's FRESH per-file `_file_hash` is KEPT (the double hash is deliberate: the pre-scan's digest is the prediction, the loop's is the truth — a file edited between the two is still detected and re-indexed; the second read is page-cached — the cost the owner accepted, A3);
  - `on_scan_progress` is called only when provided; `progress=None` callers (the CLI) skip the pre-scan entirely — byte-identical behavior (the phase-64 skip rule, extended);
  - the degenerate empty KB: the scan total is 0, no callback fires, the run's `phase` stays `"scan"` until the first `progress` call (which there is none) or the next transition/terminal — the UI renders bare "Scanning…" (the `total === 0` guard → no count part) and the terminal clears the phase; documented, pinned in the task-05 arm;
  - docstrings: the module `progress` paragraph (the `done`/`total` semantic shift), the new `on_scan_progress` paragraph, the `to_thread`/cancel/cost paragraphs, the `sync_pending_count` gating clause.
 - **D2 — the kill switch (task 01).** `app/config.py` gains `sync_pending_count: int = 1` (`BOR_SYNC_PENDING_COUNT`): `1` (default) = the pre-scan pending-count semantics; `0` = the phase-193 WALK-position semantics (the stats pre-walk + `done = summary.files` — the full rollback the owner gets if the cost ever bites); a negative value refuses startup with the field named (the `agent_max_rounds` house pattern). `.env.example` + README settings documentation. The switch is read ONCE per run (the phase-184 discipline — a mid-run settings save cannot change the semantics between two files of the same walk).
 - **D3 — the phase machine + status (task 02).** `SyncStatus.phase` gains `"scan"` (additive — the machine: the model-check + clone/pull prelude reports `null`, then `"scan"` (set immediately before `import_sources`, REPLACING today's `= "import"`), `"import"` (flipped by the FIRST `progress` call while `phase == "scan"` — the flip point is the existing per-file hook, so no extra callback), `"overview"`, `"summaries"` — the no-gap summaries skip still keeps the run in `"import"`). The flip + the pre-`import_sources` set are phase transitions, so each gets the phase-187 FORCED `_sample_rss()` (the per-file `_scan_hook` calls the UNFORCED throttled sample, the progress-hook convention — one `/proc` read per 5 s, never one per file). `SyncStatus` gains `scan_done` / `scan_total` (`int`, default 0; reset with the run; KEPT at every terminal — the phase-64 keep-final-values convention, beside the final file counts). The status payload gains the same two keys ADDITIVELY (placed after `files_total`; every pre-existing key keeps its name, type, position, and meaning — the phase-187 additive-only discipline). `current_file` stays `null` during the scan (the scan names no file). Docstrings: the module phase-machine paragraph (L188–200 region), the `SyncStatus` class paragraph (the phase-64/98/187 clauses gain the scan clause), the `GET /api/sync/status` docstring field paragraph.
 - **D4 — the UI scan label (task 03).** `fmtSyncPhaseLabel` (the phase-aware wrapper — `frontend/assets/sources.js`) gains ONE explicit `"scan"` branch in its decision tree: main text `Scanning…` (no file — `current_file` is null in the phase, the branch must not read it), count part `(n/total)` rendered in the SAME count slot the import phase's `N remaining` uses (`n = scan_done`, `total = scan_total`; the `total === 0` guard → no count part, the phase-64 contract); the caller passes the scan pair through the existing call sites that already forward the summaries/chunk/image parts (the `phase` value selects which pair the wrapper consumes — the summaries-branch pattern). The `null` prelude + `"import"` fallback clause now covers ONLY those two. `fmtSyncLabel`'s `N remaining` arithmetic is BYTE-IDENTICAL (the phase-193 pins stay unedited — the server-side semantic change flows through the SAME builder unchanged). The A4 untruncated placement (button title + `#sync-progress`) is untouched — `Scanning… (n/total)` rides it automatically; the phase-187 `· peak N MB` trailing clause still lands on the `#sync-progress` counts line while the scan label is visible. The docstring's decision-tree paragraph (L157–167 region) is updated. The walk position surviving as `(n/total)` is HONEST for a scan — it is labeled "Scanning", never "Syncing" (the owner's objection, TODO L6, was the sync count wearing the total's shape).
 - **D5 — the pinned suites move (task 04).** See the task for the definitive list (the count-frame pins retarget to the pending-set semantics where the fixture KB is NOT fresh; the fresh-fixture pins (chunk progress, label mobile, upload) stay unedited; the phase-184/185/179 integration pins get the pre-scan's statements distinguished or are verified unaffected).
 ## ASSUMPTIONS (owner-confirmed 2026-10-19, questionnaire)
 - **A1:** `N remaining` counts down the pre-scan's PREDICTED change set (`files_total = len(pending)`, `files_done` = the 1-based position in it); the count advances on the prediction set (a predicted-then-unchanged file still advances it — the count reaches 0; a post-scan change is indexed but uncounted — the phase-193 guard hides the excess). First-time imports (empty DB) count the full walk exactly as phase 193 did; a no-change run shows no count part.
 - **A2:** the pre-scan is a NEW VISIBLE `"scan"` phase — `Scanning… (n/total)` before the `import` phase; the scan's walk position is the only surviving `n/m` shape, and it is labeled a scan.
 - **A3:** the cost is accepted: one extra full read + sha256 + one scalar metadata SELECT per importable file per run (the second read is page-cached; the span is off-loop via `to_thread`, the phase-179 rule). The rollback knob `BOR_SYNC_PENDING_COUNT=0` restores the phase-193 walk-position semantics; the CLI and the upload job pay nothing.
 ## Context
 - `app/rag/importer.py` — `import_sources` (L756+, the pre-walk L949–962, the per-file `progress` call L1034–1039), `_file_hash` (L704–724), `_doc_row_stmt` (L725+), the module docstring's progress/chunk/image hook paragraphs.
 - `app/api/sync.py` — the module docstring (the phase-179/134/98 paragraphs, L100–200 region), `SyncStatus` (L308+), `GET /api/sync/status` (L495+, the payload dict L548+), `_run_sync` (L651+, the reset block, the `_hook`/`_scan_hook`/`_chunk_hook`/`_image_hook` closures L815–860 region, the `_status.phase = "import"` set L880, the terminal log lines L1112/L1133).
 - `app/config.py` — the `BOR_SYNC_*` settings block + validators (the `agent_max_rounds` kill-switch pattern); `.env.example`.
 - `app/models.py` — `Document` (L117+, the unique `(source, path)`, the `file_hash` column contract L128–142).
 - `frontend/assets/sources.js` — `fmtSyncPhaseLabel` (L157–167 docstring, the decision tree), `fmtSyncLabel` (L1043–1071 — UNTOUCHED), the status call sites (L1121–1127, L1449–1458, L1621–1652), `setSyncLabel`/A4 (UNTOUCHED).
 - `scripts/import_docs.py` L407 (the CLI caller — `progress` absent — the byte-identity pin), `app/api/git_sources.py` L59 (the upload's no-file-progress contract — UNTOUCHED).
 - Pinned suites: `tests/e2e/test_sync_remaining_count.py` (phase 193's own — the count-frame pins + the status key-set pin), `tests/e2e/test_sync_chunk_progress.py`, `test_sync_label_mobile.py`, `test_sync_upload_progress.py`, `test_archive_upload_sources.py` (the upload's "no `N remaining`" pins), `tests/integration/test_import_fast_path_columns.py` (phase 185 — the per-file SELECT pins), `test_import_session_retention.py` (phase 184), `test_sync_git_freeze.py` (phase 179 — the loop-freeze pin), `test_sync_session_reset.py`, `test_fast_path_deferred_content.py`, `test_sync_summary_visibility.py`, `test_sync_image_progress.py`, `test_sync_progress_box.py`, `test_sync_status_freshness.py`, `test_sync_peak_memory_visible.py`, `test_smoke.py`.
 ## Tasks
 1. `01_prescan_importer.md` — the importer's pre-scan (the D1 spec) + the `BOR_SYNC_PENDING_COUNT` kill switch (the D2 spec) + the unit/integration pins.
 2. `02_sync_phase_status.md` — the `"scan"` phase + `scan_done`/`scan_total` status fields + the additive payload + the docstrings (the D3 spec) + the integration pins.
 3. `03_ui_scan_label.md` — the `fmtSyncPhaseLabel` scan branch (the D4 spec) + the JS marker pins.
 4. `04_retarget_pinned_suites.md` — the pinned-suite retarget (the D5 list); the full suite green.
 5. `05_e2e_and_gates.md` — the phase's own E2E suite (the pending-count-down through the real UI), the full gates, the docs pass, the atomic commit.
 ## Testing & Quality
 - **Unit (marker pins):** the pre-scan gate (the `progress is not None` + `sync_pending_count` read-once), the scalar SELECT's column shape (no entity load), the `pending` predicate (NULL / mismatch / match), the `done`-as-pending-position contract, the kill-switch value handling (1 / 0 / negative).
 - **Integration:** the pending set on fresh / unchanged / changed / pre-phase-NULL fixtures; the off-loop pin (the delayed pre-scan span keeps the loop responsive — the phase-179 pattern); the cancel-during-prescan terminal; the phase-184/185/179 pins retargeted or verified; the phase machine sequence (null → scan → import → … → terminal null) + the kept scan counts + the forced/throttled RSS samples.
 - **E2E (regression, task 04):** the retargeted pins green; the fresh-fixture + upload pins green UNEDITED.
 - **E2E (phase, AGENTS rule 4, task 05):** `tests/e2e/test_sync_pending_count.py`, run in isolation — the first-sync arm, the INCREMENTAL arm (the owner's prod case: K of N changed, the count holds at `K remaining` while the walk moves over unchanged files, hidden at the final predicted file, terminal `K updated`), the no-change arm (no count part), the kill-switch arm (`0` → the phase-193 walk semantics), the empty-KB arm, the peak-clause-on-scan-line pin.
 - **Coverage:** **>90%** on `app/` (`uv run pytest --cov=app --cov-report=term-missing`).
 - **Lint/types:** `uv run ruff check . && uv run pyright`.
 ## Documentation & Consistency
 - Final pass reviews `README.md` and `AGENTS.md` in their entirety against the post-phase app and fixes every inconsistency found, pre-existing ones included.
 - `README.md`: the sync section's running-label clause gains the `scan` phase + the pending-count semantics (the phase-193 `N remaining` example becomes the predicted-change-set one) and the `BOR_SYNC_PENDING_COUNT` setting (the `.env.example` entry is part of task 01); `AGENTS.md` — verify whether any clause names the running count part (phase 193 verified it does not — if still absent, do NOT add; the `BOR_SYNC_PENDING_COUNT` setting row joins the settings documentation wherever the README/AGENTS settings table lives).
 ## Completion Criteria
 - [ ] `N remaining` counts down the pre-scan's predicted change set (`files_total = len(pending)`, `files_done` = the pending position) on a progress caller; a first-time import counts the full walk (A1's degenerate parity); a no-change run shows no count part — the E2E arms a/b/c.
 - [ ] the `scan` phase is visible (`Scanning… (n/total)`, the position climbs, the `total === 0` guard) and flips to `import` on the first progress call; `scan_done`/`scan_total` reset with the run and survive the terminals — the E2E arms a/e + the integration phase-machine pin.
 - [ ] `BOR_SYNC_PENDING_COUNT=0` restores the phase-193 walk-position semantics byte-for-byte (the E2E kill-switch arm + the marker pins); a negative value refuses startup with the field named.
 - [ ] the pre-scan span never parks the loop (the off-loop pin); a cancel during it lands the `cancelled` terminal (the phase-134 contract); the CLI and the upload job are byte-identical (the unedited pins).
 - [ ] the chunk / image / summaries parts, the `fmtSyncLabel` arithmetic, the terminal `counts_line`, `summary.files` and every pre-existing log line are byte-identical (the unedited pins green); the status payload is additive-only (the key-set pin).
 - [ ] test suite green, coverage >90%; `uv run ruff check . && uv run pyright` clean; README + AGENTS consistent (the final pass).
 - [ ] one atomic Conventional Commits commit with `--no-gpg-sign`.
@@ -0,0 +1,48 @@
 # Task 01 — The importer's pre-scan + the `BOR_SYNC_PENDING_COUNT` kill switch (D1/D2)
 **Phase:** `194_sync_pending_count` · **Source:** owner report 2026-10-19 — "1216 remaining" on a ~10,000-file KB with ~10 changed files.
 **Story:** n/a
 ## Objective
 The server-side core: `import_sources` predicts the run's change set BEFORE the walk (the pre-scan, D1) so the `progress` hook's `done`/`total` are the PENDING position (the files that will actually be re-indexed), with the `BOR_SYNC_PENDING_COUNT` kill switch (D2) — `0` restoring the phase-193 walk-position semantics byte-for-byte, negative refusing startup.
 ## Work
 1. `app/config.py` — `sync_pending_count: int = 1` (env `BOR_SYNC_PENDING_COUNT`), the house pattern next to `sync_session_reset_files` (phase 184) / `agent_max_rounds`: `1` = the pre-scan pending-count semantics (default), `0` = the phase-193 walk-position rollback (the stats pre-walk + `done = summary.files`), a NEGATIVE value refuses startup loudly with the field named (the validator). `.env.example` — the entry, documented like the other `BOR_SYNC_*` rows.
 2. `app/rag/importer.py` — `import_sources`:
   - the signature gains `on_scan_progress: Callable[[int, int], None] | None = None` (the 1-based scan position + the importable total — the "only when provided", "the hooks only assign fields", no-try/except contract of `progress` / `on_chunk_progress` / `on_image_progress`);
   - read `llm.settings.sync_pending_count` ONCE before the source loop (the phase-184 read-once discipline — a mid-run settings save cannot flip the semantics between two files of the same walk);
   - the GATE: `progress is not None` AND the switch truthy → the PRE-SCAN; `progress is None` (the CLI, `scripts/import_docs.py` L407) → skipped entirely (the phase-64 skip rule, extended — byte-identical); the switch `0` on a progress caller → the EXISTING stats-only pre-walk runs and `done = summary.files` (the phase-193 rollback, byte-for-byte);
   - the pre-scan REPLACES the existing stats-only pre-walk (L949–962) — no third walk: ONE `asyncio.to_thread` span (the phase-179 off-loop rule — a 10,000-file hash+SELECT span must not park the single uvicorn loop; the span's worker runs to completion on cancel, the phase-134 contract) that, per root with the EXACT `iter_importable_files` rules of the processing loop (the same `ignore` / `include_hidden` / `image_extension_set` / images-toggle gating — the L930–962 region's rules, byte-identical): (a) the per-root file list + length (the scan total — the same number the old pre-walk computed), then (b) per file: `_file_hash(path)` (the existing streamed 1 MiB-chunk helper, L704–724) + ONE scalar `SELECT documents.file_hash WHERE source = :s AND path = :p` (the ONLY column — NO entity load, NO `defer`/`load_only` row, nothing lands in the session's `identity_map`, no retention — phase 184/185 compliant: it is not a whole-entity `select(Document)` and it defers nothing because it loads no row; the processing loop's `_doc_row_stmt` stays the ONLY row load) → `pending = {(source, rel)}` where stored is NULL (no row, or a pre-phase row) or `!= digest` — the SAME predicate the fast path applies at processing time, so the prediction is consistent with the stored-hash contract (a pre-phase NULL row is predicted changed AND actually re-indexed + stamped by the loop);
   - `on_scan_progress(position_1based, total)` fires per file from inside the worker span (the call is a plain field-assignment closure — GIL-atomic; document the thread-safety clause in the docstring);
   - `files_total` = `len(pending)` (the `progress` hook's denominator); the per-file `progress(source, rel, done, total)` call's `done` becomes the 1-based POSITION IN THE PENDING SET — it advances for every file in `pending` (whether or not the file turns out changed at processing time — count and denominator stay on the SAME set so the arithmetic never runs away; a file NOT in `pending` does not advance it — the label holds at `K remaining` while the walk moves over the unchanged `N − K`);
   - the processing loop's FRESH per-file `_file_hash` stays (the double hash is deliberate: the pre-scan's digest is the prediction, the loop's is the truth — a file edited between the two is still detected; the second read is page-cached — the cost the owner accepted, A3);
   - `summary.files` (the `import: summary … files=` count — every file the loop processed) is UNTOUCHED; the prune post-pass, the date refresh, the phase-184 `expunge_all` cadence, the `seen` set: all UNTOUCHED (the pre-scan builds `pending`, not `seen` — the loop keeps building `seen` exactly as today);
   - the degenerate empty KB: scan total 0, no callback fires, `pending` empty, `files_total` 0 (the phase-64 `total === 0` no-count-part contract);
   - docstrings: the module `progress` paragraph (the `done`/`total` semantic shift + the drift edges — a predicted-then-unchanged file still advances the count so it reaches 0; a post-scan change is indexed but uncounted and the UI's `total − done > 0` guard hides the excess), the new `on_scan_progress` paragraph (the "only when provided" rule, the worker-thread call, the no-try/except contract), the `to_thread`/cancel/cost paragraph (the phase-179/134 clause + the double-hash + the page-cache note + the kill-switch gate), the `sync_pending_count` read-once clause.
 3. `tests/unit/` — the marker pins (the importer pin-module convention, the phase-184/185 pin style):
   - the gate: `progress is None` → no pre-scan (the callback never fires, no scalar statement — a mocked-callback pin); the switch `0` on a progress caller → the stats pre-walk path (a source marker pin: the old pre-walk code is the `0` branch);
   - the scalar SELECT shape: a captured statement names EXACTLY `documents.file_hash` (column-list pin, the phase-185 style — no other column, no entity);
   - the `pending` predicate: fresh (no rows → all pending), unchanged (hash match → not pending), changed (mismatch → pending), pre-phase NULL row (→ pending), an ignore-rule file (→ never in the walk, never pending);
   - the `done`-as-pending-position: a 3-file fixture (2 predicted, 1 not) → the `progress` calls' `done` sequence is the pending position (the non-predicted file reports the previous position; `total = 2`);
   - the switch values: `1`/`0`/negative (the validator names the field on the negative value).
 4. `tests/integration/` —
   - the pending set through a real `import_sources` call (a `file://`-style temp source dir, the house fixture convention): fresh / unchanged / one-changed fixtures assert the `progress` hook's `done`/`total` pairs AND the terminal `summary.added`/`summary.updated` (the parity pin: the prediction's size equals the terminal's `added + updated` on a stable KB);
   - NO entity hydration: `len(session.identity_map) == 0` immediately after the pre-scan span (the `progress` + `on_scan_progress` caller, before any processing-loop row load);
   - OFF-LOOP (the phase-179 pattern, `test_sync_git_freeze.py` style): a monkeypatched `_file_hash` that blocks ~3 s over a small multi-file fixture → a loop-side heartbeat (a coroutine timing `asyncio.sleep(0)` / a probe task) stays responsive through the pre-scan span;
   - CANCEL: a cancel registered before the (delayed) pre-scan → the worker runs to completion, the run lands the `cancelled` terminal (the phase-134 contract, `test_sync_git_freeze.py`'s cancel-during-clone pattern).
 5. Verify: `uv run pytest tests/unit tests/integration -v` green; `uv run ruff check . && uv run pyright` clean.
 ## Testing & Quality
 - Unit: the marker pins above (the gate, the scalar shape, the predicate, the `done` contract, the switch values).
 - Integration: the pending-set parity, the no-hydration pin, the off-loop pin, the cancel pin.
 - Coverage: **>90%** on this task's new/modified code (the whole gate — `uv run pytest --cov=app --cov-report=term-missing` at the phase's final pass).
 ## Completion Criteria
 - [ ] the pre-scan runs on a progress caller with the switch truthy, is skipped for `progress=None` callers, and the `0` switch runs the phase-193 walk-position path (the marker pins).
 - [ ] the scalar SELECT's column list is exactly `[documents.file_hash]` with no entity hydration (the integration pins).
 - [ ] `done`/`total` are the pending position on a stable KB (the parity pin: `files_total == summary.added + summary.updated`).
 - [ ] the pre-scan span never parks the loop; a cancel during it lands `cancelled` (the integration pins).
 - [ ] `summary.files`, `seen`, the prune, the date refresh and every log line are byte-identical (the unedited pins green).
 - [ ] `BOR_SYNC_PENDING_COUNT` in `.env.example` + the config validator (negative refuses startup with the field named).
 - [ ] full test suite **100% passing**; README/AGENTS: the setting is documented (the phase's final pass re-checks both project-wide).
 - [ ] no behavior change in completed work (the CLI, the upload job, the switch-`0` path).
@@ -0,0 +1,43 @@
 # Task 02 — The `"scan"` phase + `scan_done` / `scan_total` (D3)
 **Phase:** `194_sync_pending_count` · **Source:** owner-confirmed A2 — the pre-scan is a visible phase.
 **Story:** n/a
 ## Objective
 The status half of D1: `SyncStatus` carries the scan phase (`"scan"`) and the scan position (`scan_done` / `scan_total`), the `GET /api/sync/status` payload gains the two keys ADDITIVELY, and every docstring names the new machine stage — the phase-187 forced/throttled sampling discipline extended to the scan transition.
 ## Work
 1. `app/api/sync.py` — `SyncStatus`:
   - `phase: Literal["scan", "import", "overview", "summaries"] | None = None` (additive value — the machine: prelude `null` → `"scan"` (set immediately before `import_sources`, REPLACING today's `_status.phase = "import"` at L880) → `"import"` (flipped by the FIRST `progress` call while `phase == "scan"` — the flip lives in the existing `_hook` closure: `if _status.phase == "scan": _status.phase = "import"`) → `"overview"` → `"summaries"`; the no-gap summaries skip still keeps the run in `"import"`);
   - `scan_done: int = 0` / `scan_total: int = 0` (placed after `files_total` — reset with the run in the `_run_sync` reset block L664–679 region, kept at EVERY terminal like the file counts — the phase-64 keep-final-values convention);
   - the class docstring: the phase-64 paragraph (the `files_done`/`files_total` clause now names the pending-set semantics — "the hook's pending position (phase 194: the pre-scan's predicted change set)"), the phase-98 paragraph (the machine gains the `"scan"` stage), a new phase-194 paragraph (the scan fields, the reset/keep convention, the `null` `current_file` during the scan, the empty-KB degenerate clause — the phase stays `"scan"` until the next transition/terminal, the UI renders bare "Scanning…").
 2. `app/api/sync.py` — `_run_sync`:
   - the reset block: `scan_done = 0` / `scan_total = 0` with the run;
   - the pre-`import_sources` point (L880): `_status.phase = "scan"` + the phase-187 FORCED `_sample_rss()` (a phase transition — the forced-sample convention, replacing the current `= "import"` set + forced sample);
   - a new `_scan_hook(scan: int, total: int)` closure passed as `on_scan_progress`: sets `scan_done` / `scan_total` + calls the UNFORCED `_sample_rss()` (the per-file throttled convention — one `/proc` read per 5 s, never one per file, LOCKED A4's throttle discipline);
   - the `_hook` (progress) closure: the flip clause (above) + a FORCED `_sample_rss()` on the flip (the scan→import transition is a phase transition);
   - the `import_sources` call (L881–893): `on_scan_progress=_scan_hook` added;
   - the terminal paths (`sync: done/cancelled by user/failed` — L1112/L1133 region): UNTOUCHED in shape (the `files_done=… files_total=…` fields keep their names — now carrying the pending counts; the scan fields keep their final values beside them — the keep-final convention);
   - the module docstring: the phase-machine paragraph (L188–200 region — the `"scan"` stage + the flip point), the phase-64 progress paragraph (L100–115 region — the `files_done`/`files_total` semantic shift), the phase-187 sampler paragraph (the scan transition's forced sample + the per-file scan hook's throttled sample), the cancel paragraph (a cancel during the pre-scan span: the `to_thread` worker runs to completion, the run stops at the next boundary — the phase-134/179 contract, the `CancelledError` clause's two paths unchanged).
 3. `app/api/sync.py` — `GET /api/sync/status`:
   - the payload dict: `"scan_done"` / `"scan_total"` added after `"files_total"` (ADDITIVE ONLY — every pre-existing key keeps its name, type, and position; the phase-187 additive-only discipline);
   - the endpoint docstring: the new fields' paragraph (the scan position — 0/0 before the scan starts and in terminal states the final values are kept; `current_file` null during the scan).
 4. `tests/integration/` —
   - the PHASE MACHINE sequence (a real app, a small git-source fixture with one changed file): a held first status GET (the prelude — `phase: null`, `scan_*: 0/0`) → a `phase: "scan"` frame with `scan_total` set and `scan_done` climbing (≥2 distinct positions on a multi-file fixture) → a `phase: "import"` frame (the flip — `files_total` = the predicted count) → the terminal (`phase: null`, the scan counts KEPT beside the final file counts — the keep-final pin);
   - the PAYLOAD key-set pin: the phase-193 key set + `scan_done` / `scan_total` (the additive pin — every pre-existing key byte-identical in name/type);
   - the FORCED samples: a forced `_sample_rss` at the pre-`import_sources` set (the `"scan"` transition) and at the flip (the `"import"` transition) — the phase-187 sampling-pin pattern (`test_sync_peak_memory_visible.py` convention);
   - the DEGENERATE empty-KB run: the phase reports `"scan"` (no `on_scan_progress` fires — `scan_*` 0/0), never `"import"` (no progress call), the terminal clears the phase (the pin names the D1 degenerate clause);
   - the CANCEL-during-scan terminal (a delayed pre-scan, the task-01 cancel pin's app-side twin): `state: "cancelled"`, the phase cleared, the scan counts kept.
 5. Verify: `uv run pytest tests/integration -v` green; `uv run ruff check . && uv run pyright` clean.
 ## Testing & Quality
 - Integration: the phase-machine sequence, the payload key-set, the forced/throttled samples, the degenerate + cancel terminals.
 - Coverage: **>90%** on this task's new/modified code.
 ## Completion Criteria
 - [ ] the machine is `null → "scan" → "import" → "overview" → "summaries"` with the flip on the first progress call (the integration sequence pin).
 - [ ] `scan_done` / `scan_total` reset with the run, are kept at every terminal, and are additive-only in the payload (the pins).
 - [ ] the phase-187 sampling discipline holds (forced at the scan + import transitions, throttled per-file in `_scan_hook`) (the pins).
 - [ ] every pre-existing log line, payload key and terminal behavior is byte-identical (the unedited pins green).
 - [ ] full test suite **100% passing**; no user-visible doc changes this task (the phase's final pass reviews README/AGENTS).
 - [ ] no behavior change in completed work.
@@ -0,0 +1,35 @@
 # Task 03 — The `fmtSyncPhaseLabel` scan branch (D4)
 **Phase:** `194_sync_pending_count` · **Source:** owner-confirmed A2 — the visible `Scanning… (n/total)` label.
 **Story:** n/a
 ## Objective
 The UI half of D1/D3: `fmtSyncPhaseLabel` (the phase-aware wrapper) gains ONE explicit `"scan"` branch — `Scanning…` + the `(n/total)` count part in the SAME count slot the import phase's `N remaining` uses — while `fmtSyncLabel`'s arithmetic stays BYTE-IDENTICAL and the A4 untruncated placement + the phase-187 peak clause flow through untouched.
 ## Work
 1. `frontend/assets/sources.js` — `fmtSyncPhaseLabel` (the decision tree + its docstring, L157–167 region):
   - the new `"scan"` branch: main text `Scanning…` (NO file — `current_file` is null in the phase; the branch must not read it), count part `(n/total)` with `n = scan_done`, `total = scan_total` — rendered in the SAME count slot (the `{ main, count }` part shape the import phase's `N remaining` uses, so `setSyncLabel`'s hidden-toggle + the A4 untruncated placement — button title + `#sync-progress` — carry `Scanning… (n/total)` automatically); the `total === 0` guard → NO count part (the phase-64 contract, the empty-KB clause — bare "Scanning…");
   - the wrapper consumes the scan pair the way it already consumes the summaries pair (`summaries_done` / `summaries_total` / `current_summary` — the `phase` value selects which pair the branch reads); the status call sites (L1121–1127, L1449–1458, L1621–1652 region) forward `scan_done` / `scan_total` alongside the existing fields (the small caller pass-through — the summaries-forwarding pattern);
   - the `null` prelude + `"import"` fallback clause now covers ONLY those two (the docstring's decision-tree paragraph updated: the new branch is named, the fallback narrowed, the phase-193 `N remaining` clause kept);
   - the walk position surviving as `(n/total)` is HONEST for a scan — it is labeled "Scanning", never "Syncing" (TODO L6's objection was the sync count wearing the total's shape — the docstring says so);
   - `fmtSyncLabel` (L1043–1071): UNTOUCHED (the `N remaining` arithmetic + its guards are byte-identical — the phase-193 pins stay unedited); the chunk / image parts, `setSyncLabel`, the terminal `counts_line`: UNTOUCHED;
   - the phase-187 peak clause (`· peak N MB` on the `#sync-progress` counts line — `fmtSyncPeakClause`): UNTOUCHED (it lands on the scan label's line while the scan is visible — no new element, no new live region).
 2. `tests/unit/` — the JS marker pins (the sources-JS pin-module convention, the phase-193 marker style):
   - the `"scan"` branch marker (the `Scanning…` main + the `phase === "scan"` selection in the decision tree);
   - the `(n/total)` shape marker (the exact template over `scan_done` / `scan_total` — the source marker asserts the expression);
   - the `total === 0` guard marker (no count part before the scan knows the total);
   - the caller pass-through marker (the call sites forward the scan pair);
   - the UNTOUCHED markers: `fmtSyncLabel`'s `N remaining` expression (the phase-193 pin — byte-identical), the chunk / image / summaries part builders, `setSyncLabel`, the `counts_line` helper.
 3. Verify: `uv run pytest tests/unit -v` green; `uv run ruff check . && uv run pyright` clean.
 ## Testing & Quality
 - Unit: the marker pins above (the branch, the shape, the guard, the pass-through, the untouched set).
 - E2E: task 04 (the retargeted pins) + task 05 (the phase arms — the scan label through the real UI).
 - Coverage: **>90%** on `app/` (the task is frontend — the app-side gate stays green at the phase's final pass).
 ## Completion Criteria
 - [ ] the `"scan"` branch renders `Scanning…` + `(n/total)` in the count slot with the `total === 0` guard (the marker pins).
 - [ ] `fmtSyncLabel`'s `N remaining` arithmetic is byte-identical (the unedited phase-193 pins green).
 - [ ] the A4 untruncated placement + the phase-187 peak clause are untouched (the unedited pins green).
 - [ ] full test suite **100% passing**; no user-visible doc changes this task (the phase's final pass reviews README/AGENTS).
 - [ ] no behavior change in completed work (the prelude / import / overview / summaries labels byte-identical).
@@ -0,0 +1,38 @@
 # Task 04 — The pinned suites move (D5)
 **Phase:** `194_sync_pending_count` · **Source:** the D5 retarget list.
 **Story:** n/a
 ## Objective
 Every existing pin that asserts the phase-193 WALK-position semantics (or the pre-phase statement counts the pre-scan now disturbs) is retargeted to the pending-set semantics — and every pin that is unaffected by the change (fresh-fixture count pins, the upload's bare-label pins, the terminal-line pins) is verified green UNEDITED. The full suite ends green.
 ## Work
 The definitive list (per suite: decide from the fixture's KB state — a FRESH-DB fixture has pending == walk, so its count pins survive unedited; a RE-SYNC fixture's walk-position pins retarget):
 1. `tests/e2e/test_sync_remaining_count.py` (phase 193's own suite — the primary retarget):
   - the docstring's `files_done` / `files_total` clause (the "the 1-based …" wording, L15–16 region) retargets to the PENDING-set semantics (the pre-scan's predicted change set; the phase-193 walk wording moves to the kill-switch history note);
   - the status key-set pin (the "the phase-64 key set" clause) moves to the phase-64 set + `scan_done` / `scan_total` (the additive pin);
   - the arm's phase-sequence pins: the prelude → `import` sequence gains the `"scan"` stage (a `phase: "scan"` frame with `scan_total` set before the first `files_total`-bearing frame — the D3 machine); the pre-scan's label frames (`Scanning… (n/total)`) are pinned where the arm's held-first-GET / pre-first-file region stands;
   - the count frames: on the suite's FRESH-DB fixture, pending == walk — the `1 … N−1` frames and the "hidden at the final file" pin survive (the phase-193 "Notable" deviation note retargets to the pending-position wording); ADD the re-sync arm if the suite's fixture allows it (a second sync of the same repo: no count part — `files_total = 0`, the phase-193 A1 exception now driven by the empty pending set) — otherwise the re-sync pin lives in the task-05 suite;
   - the upload arm (arm c): UNEDITED (the upload status endpoint gains no scan fields — phase 90 A2 stands).
 2. `tests/integration/test_import_fast_path_columns.py` (phase 185 — the per-file SELECT pins): inspect the invocation. If it calls `import_sources` WITHOUT `progress` → the pre-scan never runs → verify green UNEDITED. If WITH `progress` → retarget the "exactly one document-wide `SELECT` per unchanged file" pin to distinguish the pre-scan's scalar statement (column list exactly `[documents.file_hash]` — the task-01 shape pin) from the fast-path ROW statement (content deferred — the phase-185 pin intact); the "one PK follow-up for the backfill" pin is UNTOUCHED either way (the pre-scan's scalar is a `(source, path)`-keyed statement, not a PK follow-up).
 3. `tests/integration/test_import_session_retention.py` (phase 184 — the bounded/unbounded retention pins): the pre-scan hydrates NO entities (the task-01 no-hydration pin) → the retention bound is UNCHANGED; verify green (if the test's fixture invokes with `progress`, confirm the worker-thread scalar statements disturb no retention assertion — the scalar loads no row).
 4. `tests/integration/test_sync_git_freeze.py` (phase 179 — the loop-freeze pins): the pre-scan span is itself off-loop (the task-01 off-loop pin lives in its own module, the phase-179 pattern) — verify this suite's git-span pins stay green; if its measurement window now overlaps the pre-scan, extend it with the pre-scan heartbeat (the loop must stay responsive through BOTH off-loop spans).
 5. `tests/e2e/test_sync_chunk_progress.py` (the `Syncing… chunkprog/big.md 1 remaining · chunk n/m` pins): the fixture is a fresh-DB import → pending == walk → verify green UNEDITED (the `1 remaining` part reads identically — the pending denominator equals the walk denominator on a fresh KB).
 6. `tests/e2e/test_sync_label_mobile.py` (the `IMPORT_FULL_RE` pin + the label docstring): inspect the fixture's KB state — fresh-DB → verify green UNEDITED; any re-sync walk-position pin retargets (the count part absent on a no-change re-sync).
 7. `tests/e2e/test_sync_upload_progress.py` + `tests/e2e/test_archive_upload_sources.py` (the upload's "no `N remaining` count" pins — phase 90 A2): the upload job has no pre-scan and no scan fields → verify green UNEDITED.
 8. `tests/e2e/test_sync_session_reset.py`, `tests/e2e/test_fast_path_deferred_content.py`, `tests/e2e/test_sync_summary_visibility.py`, `tests/e2e/test_sync_image_progress.py`, `tests/e2e/test_sync_progress_box.py`, `tests/e2e/test_sync_status_freshness.py`, `tests/e2e/test_sync_peak_memory_visible.py`, `tests/e2e/test_smoke.py` — the sync-lineage sweep: run each in isolation (`--no-cov`), verify green; a pin that breaks on the new `"scan"` stage of the phase sequence or on the pre-scan's seconds (e.g. a freshness window that now spans the scan span) retargets minimally (the window/sequence pin names the scan stage — never the arithmetic).
 9. `AGENTS.md` / `README.md` are NOT edited this task (the phase's final pass owns the docs — task 05).
 10. Verify: `uv run pytest -v` (unit + integration) green; the ISOLATED `--no-cov` sweep of items 1–8 green (the phase-193 14-suite convention, extended by this phase's suite in task 05); `uv run ruff check . && uv run pyright` clean.
 ## Testing & Quality
 - The retargeted pins (the pending-set wording, the key-set pin, the phase-sequence pins).
 - The verified-unedited pins (fresh-fixture count pins, the upload's bare-label pins, the terminal `counts_line` pins, the phase-184/185/179 pins).
 - Coverage: **>90%** on `app/` (the gate stays green — this task edits tests + docstrings).
 ## Completion Criteria
 - [ ] the retargeted list above is settled: every broken pin retargeted with the reason in its docstring, every unaffected pin green UNEDITED (the sweep).
 - [ ] `tests/e2e/test_sync_remaining_count.py` pins the new machine (the `"scan"` stage + the key-set + the pending-position wording) and its fresh-fixture count frames survive.
 - [ ] the terminal `counts_line` pins, the chunk / image / summaries pins and the upload pins are green UNEDITED.
 - [ ] full test suite **100% passing** (unit + integration + the isolated E2E sweep).
 - [ ] no behavior change in completed work (only test files + their docstrings move).
@@ -0,0 +1,42 @@
 # Task 05 — The phase's E2E suite + gates + docs + commit
 **Phase:** `194_sync_pending_count` · **Source:** AGENTS rule 4 — "One Story, One Phase" (the owner-directive phase's own suite).
 **Story:** n/a
 ## Objective
 The owner-visible proof through the real UI: the count counts down the PREDICTED change set (the owner's prod case — K of N changed), the scan phase is visible and honest, the kill switch rolls back to phase 193, and the no-change / first-sync / empty-KB edges behave per D1 — then the full gates, the docs pass, and the atomic commit.
 ## Work
 1. `tests/e2e/test_sync_pending_count.py` (NEW — run in isolation: `uv run pytest tests/e2e/test_sync_pending_count.py -v --no-cov`):
   - the house fixture convention (the phase-193/107 suite shape): a real git repo over the `file://` transport, the mock-LLM proxy with the house per-request delay, a unique E2E port pair (check the existing allocations in the sibling suites — the one-suite-at-a-time rule makes collisions harmless, but pick a free pair anyway), a `file://`-repo N = 8 importable files (keep the suite under ~2 min; ≥2 multi-chunk files so the chunk part coexists, the phase-129 convention);
   - the module app: the default `BOR_SYNC_PENDING_COUNT` (1); a second module app for the kill-switch arm (`BOR_SYNC_PENDING_COUNT=0`) — the phase-184 two-module-app convention;
   - **arm a — the first sync (fresh KB):** the phase sequence `null` → `"scan"` (the label `Scanning… (n/8)` — the position climbs: pin ≥2 distinct `scan_done` values at `scan_total = 8`; `current_file` null in the phase) → `"import"` (the count part `N remaining` with `files_total = 8` — pending == walk on a fresh KB, the phase-193 parity: the frames count down, hidden at the final file) → the terminal (`phase: null`, `scan_done = scan_total = 8` KEPT beside `files_done = 8`, the `sync: done` counts line `8 added`);
   - **arm b — the incremental sync (the owner's prod case — the phase's heart):** modify K = 2 of the 8 (the fixture's changed-set), re-sync: the scan phase climbs `(n/8)` (the full walk is scanned), then the import: the count part reads `2 remaining` and HOLDS while `current_file` moves over UNCHANGED files (pin: ≥2 consecutive unchanged-file frames at `2 remaining` — the count does not advance on them), advances to `1 remaining` on the first predicted file, HIDES on the final predicted file (the phase-193 A1 edge — the main part names it), terminal `2 updated`;
   - **arm c — the no-change re-sync:** the scan completes, the import renders BARE `Syncing… <file>` (NO count part — `files_total = 0`, the phase-64 guard), the terminal `0 added · 0 updated` (the `counts_line` byte-identical shape, the phase-64 pin);
   - **arm d — the kill switch:** the second module app (`BOR_SYNC_PENDING_COUNT=0`), arm b's fixture: NO `"scan"` phase (the machine is `null` → `import` — the phase-193 machine), the count part counts down the WALK (`8 remaining` → hidden at the final file — the phase-193 semantics, the rollback pin), the terminal `2 updated`;
   - **arm e — the empty KB:** a repo with zero importable files: `phase: "scan"` with `scan_*` 0/0 (bare `Scanning…` — the `total === 0` guard, NO count part), never `phase: "import"`, the terminal clears the phase (the D1 degenerate pin);
   - **the phase-187 peak clause** (the `· peak N MB` / `fmtSyncPeakClause` trailing text on the `#sync-progress` counts line) is visible while the scan label is showing (the clause lands on the scan line — no new element, the phase-187 pin);
   - **the upload arm:** a background upload run renders its bare label with NO file and NO count part (the phase-90 A2 pin — the `test_archive_upload_sources.py` convention; the upload status endpoint carries no scan fields);
   - the `#sync-progress` A4 untruncated placement (the button `title` + `#sync-progress` text equal the full `Scanning… (n/total)` label, the phase-64 A4 pin).
 2. The full gates (the phase's final pass — run in order, all green before the commit):
   - `uv run pytest -q --cov=app --cov-report=term-missing` → exit 0, coverage **>90%** on `app/`;
   - `uv run pytest tests/e2e/test_sync_pending_count.py -v --no-cov` → all arms pass in ISOLATION;
   - the isolated `--no-cov` sweep of the sync-lineage suites (task 04's list + this suite): `test_sync_remaining_count`, `test_sync_label_mobile`, `test_sync_chunk_progress`, `test_sync_image_progress`, `test_sync_progress_box`, `test_sync_summary_visibility`, `test_archive_upload_sources`, `test_sync_upload_progress`, `test_sync_status_freshness`, `test_sync_peak_memory_visible`, `test_sync_session_reset`, `test_fast_path_deferred_content`, `test_sync_git_freeze`, `test_smoke`;
   - `uv run ruff check . && uv run pyright` clean.
 3. The documentation & consistency pass (AGENTS rule + the phase's D-docs clause):
   - `README.md` in full: the sync section's running-label clause — the phase-193 `N remaining` example becomes the PREDICTED-change-set one (the `scan` phase + `Scanning… (n/total)` + `N remaining` over the pending set + the no-change/first-sync/empty-KB edges + the `BOR_SYNC_PENDING_COUNT` setting: `1` default, `0` = the phase-193 walk-position rollback, negative = startup refusal); the `.env.example` entry was added in task 01 — verify it is documented here too; every pre-existing inconsistency found in the full review is fixed (the phase-193 docs-pass convention);
   - `AGENTS.md` in full: verify whether any clause names the running count part (phase 193 verified one does NOT — if still absent, do NOT add one; if one exists, it gains the pending-set wording + the kill switch); the `BOR_SYNC_PENDING_COUNT` row joins wherever the settings documentation lives.
 4. The atomic commit (AGENTS rule 8): ONE Conventional Commit, `--no-gpg-sign`, the phase directory moved `todo/` → `complete/` in the SAME commit (the house convention — the phase-193 commit shape: the `phase: 194_sync_pending_count` message with the verified-evidence block). Suggested subject: `feat(sync): count down the sync's predicted change set (pre-scan)`.
 ## Testing & Quality
 - E2E: this suite, isolated (the six arms + the peak-clause + the A4 + the upload pins).
 - Gates: the full suite + coverage >90% + the 15-suite sweep + lint/types (above).
 - Docs: README + AGENTS reviewed in full, every inconsistency fixed.
 ## Completion Criteria
 - [ ] arm b proves the owner's prod case through the real UI (the count holds at `2 remaining` over the unchanged files, hides at the final predicted file, terminal `2 updated`).
 - [ ] arms a/c/d/e pin the first-sync parity, the no-change no-count edge, the kill-switch rollback and the empty-KB degenerate.
 - [ ] the peak clause + the A4 placement pins hold on the scan label.
 - [ ] all gates green (above) — full suite 100%, coverage >90%, the sweep, lint/types.
 - [ ] README + AGENTS accurate and consistent with the whole project (the final pass).
 - [ ] ONE atomic Conventional Commit with `--no-gpg-sign`, the phase directory in `complete/`.
@@ -0,0 +1,10 @@
 All gates re-verified against a stable tree. Report:
 **Verified (all 6 tasks in `complete/`; this was the final pass)**
 - `SourceLabel`+alembic `0030` (dev DB `alembic current` = `0030 (head)`, table present, 0 rows); admin-only `GET/PUT/DELETE /api/source-labels` (`require_admin` router-wide, `resolve_source_name`, partial-update caps/404s); Sources-page "Names, labels and tags" card (read-only derived-name `<code>`, per-row `saveInFlight`, 404 note that survives the settle, chips reuse `.git-source-hidden-count`); `question_name_hits` D2 rule; ONE `all_labels` read per turn in `chat.py` feeding both the `source_name_hit` flag and the prompt surfaces; `source_name_hit_bonus=0.005` in `_selection_order`; ` name=`/` label=` in `build_high_prompt` + `build_overview_prompt(names=…)`.
 - **Completion criteria:** E2E `tests/e2e/test_source_name_labels.py` ✅ 7 passed (arms a–e: editor all kinds, control/named question, rename-never-breaks-identity, 404 note, reset) · full suite ✅ · coverage ✅ · README/AGENTS ✅ · phase dir in `complete/` ✅ · commit left to the harness.
 - **Gates:** `uv run pytest --cov=app --cov-report=term-missing` → **exit 0, TOTAL 7160 stmts / 16 missed = 99%** (>90%) · `uv run pytest tests/e2e/test_source_name_labels.py -v --no-cov` → **7 passed, exit 0** · regression E2E isolated, exit 0: `test_document_viewer`, `test_admin_auth`, `test_api_tokens`, `test_git_sources_admin`, `test_kb_tree`, `test_local_directory_sources` · `uv run ruff check .` → All checks passed · `uv run pyright` → 0 errors.
 - **Battery (task 04 criterion):** `uv run python -m scripts.eval_retrieval --from-file tests/fixtures/retrieval_battery.txt` at default vs `BOR_SOURCE_NAME_HIT_BONUS=0` → **`diff` empty (line-for-line identical)**, matching the recorded arms (dev KB is empty, so every question deflects; the observable boost is unit/E2E-pinned).
 - **Documentation:** README — fixed the `/git-sources.html` rows (nav label is **Sources**) and cross-linked the phase-191 card from that section; full audit otherwise clean: all 86 `BOR_*` settings documented with defaults matching `app/config.py`, 0 broken file/dir references and 0 broken anchors in README+AGENTS, AGENTS rule 17 re-checked line-by-line against the code.
 - **Notable / deviations:** (1) a **concurrent pipeline process** (`phased-execution/progress.mjs` for `191_…_00_phase`) was mutating this same working tree mid-pass — it rewrote `tests/e2e/test_source_name_labels.py` (11→7 tests), `frontend/assets/git-sources.js`, `tests/unit/test_source_labels_editor_ui.py` and `AGENTS.md` at 05:27; every gate above was (re-)run after those edits with the tree no source file newer than the green full run. (2) The task-06 report/phase text claims regression suites `test_chat_token_gate.py`, `test_git_sources_page.py`, `test_rag_browser.py` are green — **those files have never existed in git history** (those runs exit 4); I ran the real equivalents listed above instead (phase files are not mine to edit). (3) **No live changes**: the VM DB already has `source_labels` (0 rows) but the deployed app predates this uncommitted code, so deploying `/api/source-labels` to the live service is the owner's post-commit step, not part of this phase's criteria.
 - **Next pending phase:** none — `191_source_name_labels_tags` is the only entry in `.agents/phases/todo/`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 65%]
 ........................................................................ [ 66%]
 ........................................................................ [ 68%]
 ........................................................................ [ 69%]
 ........................................................................ [ 71%]
 ........................................................................ [ 72%]
 ........................................................................ [ 74%]
 ........................................................................ [ 75%]
 ........................................................................ [ 77%]
 ........................................................................ [ 78%]
 ........................................................................ [ 80%]
 ........................................................................ [ 81%]
 ........................................................................ [ 83%]
 ........................................................................ [ 84%]
 ........................................................................ [ 86%]
 ........................................................................ [ 87%]
 ........................................................................ [ 89%]
 ........................................................................ [ 90%]
 ........................................................................ [ 92%]
 ........................................................................ [ 93%]
 ........................................................................ [ 95%]
 ........................................................................ [ 96%]
 ........................................................................ [ 98%]
 ........................................................................ [ 99%]
 ...........                                                              [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  298      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7160     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,18 @@
 Task 01 complete. Report:
 **Implemented**
 - `app/models.py`: new `SourceLabel` model (D1 spec: `source` String(120) PK, `display_name`/`label` plain-Text nullable, `tags` JSONB NOT NULL default `'[]'`, `updated_at` now()/onupdate) + module docstring table entry; alias-only contract documented.
 - `alembic/versions/0030_source_labels.py` (rev `0030` ← `0029`): additive CREATE TABLE, no backfill, `DROP TABLE` downgrade; verified up/down/up on the dev DB.
 - `app/rag/source_labels.py`: `SourceLabelView`, `get_label`/`label_for`/`all_labels`, `set_label` (upsert, `_UNSET`-sentinel partial-update — omitted untouched, explicit `None` clears; flush-only), `delete_label`, `normalize_tags` (trim/drop-empties, ≤10 / ≤32 ValueErrors, first-case case-insensitive de-dupe), `question_name_hits` (D2: reused `name_hit_tokens` + `_normalize_name`, 4-char floor on both sides, no digit rule), `question_name_hit_sources` (one query).
 - **Defect fix (pre-existing latent)**: `test_chunks_hnsw_index.py::test_invalid_index_is_dropped_and_rebuilt` stamped below head without dropping later migrations' tables — once 0030 landed, every following `upgrade(head)` died on `source_labels already exists` (221 cascade errors). Now genuinely `downgrade("0029")` before the stamp; consistent with AGENTS rule 16.
 **Gates** (all green)
 - `uv run pytest --cov=app --cov-report=term-missing` → **4667 passed**, TOTAL **99%**, `app/rag/source_labels.py` **100%**; dev DB left at `0030 (head)`.
 - `tests/unit/test_source_labels.py` 31 pins (D2 every branch, partial-update shape, tag guards) + `tests/integration/test_migration_0030.py` 6 pins (column contract, no-backfill, PK/NOT-NULL, A13 round-trip) pass.
 - `uv run ruff check .` clean; `uv run pyright` clean; `tests/e2e/test_smoke.py` 3 passed; `alembic upgrade head`/`downgrade 0029`/re-upgrade clean.
 **Docs**: no doc impact (pure data layer — README/AGENTS updates are task 06's per the phase plan; AGENTS rule 16's schema-move convention remains accurate).
 **Decisions**: `normalize_tags` count-guard runs before the de-dupe (11 typed = rejected, documented); whitespace-tag strictness is left to the task-02 API boundary per the task text.
 **Next pending task**: `191_source_name_labels_tags/02_source_labels_api.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,147 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 20%]
 ........................................................................ [ 21%]
 ........................................................................ [ 23%]
 ........................................................................ [ 24%]
 ........................................................................ [ 26%]
 ........................................................................ [ 27%]
 ........................................................................ [ 29%]
 ........................................................................ [ 30%]
 ........................................................................ [ 32%]
 ........................................................................ [ 33%]
 ........................................................................ [ 35%]
 ........................................................................ [ 37%]
 ........................................................................ [ 38%]
 ........................................................................ [ 40%]
 ........................................................................ [ 41%]
 ........................................................................ [ 43%]
 ........................................................................ [ 44%]
 ........................................................................ [ 46%]
 ........................................................................ [ 47%]
 ........................................................................ [ 49%]
 ........................................................................ [ 50%]
 ........................................................................ [ 52%]
 ........................................................................ [ 53%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 74%]
 ........................................................................ [ 75%]
 ........................................................................ [ 77%]
 ........................................................................ [ 78%]
 ........................................................................ [ 80%]
 ........................................................................ [ 81%]
 ........................................................................ [ 83%]
 ........................................................................ [ 84%]
 ........................................................................ [ 86%]
 ........................................................................ [ 87%]
 ........................................................................ [ 89%]
 ........................................................................ [ 91%]
 ........................................................................ [ 92%]
 ........................................................................ [ 94%]
 ........................................................................ [ 95%]
 ........................................................................ [ 97%]
 ........................................................................ [ 98%]
 ...........................................................              [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  292      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    325      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      105      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               78      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               162      0   100%
 app/rag/retriever.py             259      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   549      0   100%
 --------------------------------------------------
 TOTAL                           7035     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,19 @@
 Everything is green. Final report:
 **Implemented (phase 191 task 02)**
 - `app/schemas.py` — `SourceLabelOut` / `SourceLabelList` / `SourceLabelUpdate` (`extra="forbid"`, trim-*before*-cap validators, `_Tag` item cap = the house `_Chip` item-cap convention).
 - `app/api/source_labels.py` (NEW) — admin-gated router: catalogue `GET` (`effective_sources` names via `resolve_source_name` — git + local + the env fallback — ∪ `SELECT DISTINCT documents.source`, de-duped, sorted, ONE `all_labels` read), `PUT` (404 arm first → `normalize_tags` `ValueError`→422 → `set_label` from `model_fields_set`: omitted keeps / `null` clears / value sets, router commits), `DELETE` (404 when no row; 200 body = the entry's cleared state).
 - `app/main.py` — registered in the admin-router block; `scripts/api_payload_audit.py` — the new endpoint in the byte audit.
 - `tests/integration/test_source_labels_api.py` (NEW, 26 tests): 403 gate for anonymous AND token users, the git+local+upload union (sorted, no dupes, env-only arm, exactly 3 SELECTs and no `documents.content` read), round trip, partial-update shape, every cap as the framework's 422 with the row byte-identical, both 404 arms, the `ValueError`→422 funnel, and the D1 "a rename writes nothing but the label row" arm.
 **Gates** — `uv run pytest` → **4693 passed**; `uv run pytest --cov=app --cov-report=term-missing` → TOTAL **99%**, `app/api/source_labels.py` **100%**, `app/schemas.py` **100%**; `uv run ruff check .` → clean; `uv run pyright` → **0 errors**; E2E sanity in isolation: `tests/e2e/test_smoke.py`, `tests/e2e/test_git_sources_admin.py` pass.
 **Docs** — README gains "Source names, labels and tags (phase 191)" (route table + the alias-only contract); AGENTS.md gains rule 17 (alias-never-identity, reuse `resolve_source_name`, 404/no-partial-write, the pin file).
 **Decisions / deviations**
 - Router uses the house prefix split (`prefix="/source-labels"` + include `prefix="/api"`) — wire paths are exactly D5's.
 - `DELETE` answers 200 with the cleared `SourceLabelOut` (the task's "200"; body mirrors phase-168 `DELETE /api/admin/settings/{key}` returning the reset item).
 - A whitespace-only/empty tag is the framework's 422 (trim runs before `min_length`), as this task's pins require; `normalize_tags` keeps its drop-empties contract for helper callers, still owns the case-insensitive de-dupe, and its `ValueError`→422 belt is pinned by substituting a raising normalizer.
 - The GET lists *sources* (registry ∪ indexed documents), not orphan label rows; `DELETE` never consults the registry, so an orphan row stays clearable (documented in the route docstring).
 **Next pending task:** `191_source_name_labels_tags/03_source_labels_ui.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,149 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 23%]
 ........................................................................ [ 24%]
 ........................................................................ [ 26%]
 ........................................................................ [ 27%]
 ........................................................................ [ 29%]
 ........................................................................ [ 30%]
 ........................................................................ [ 32%]
 ........................................................................ [ 33%]
 ........................................................................ [ 35%]
 ........................................................................ [ 36%]
 ........................................................................ [ 38%]
 ........................................................................ [ 39%]
 ........................................................................ [ 41%]
 ........................................................................ [ 42%]
 ........................................................................ [ 44%]
 ........................................................................ [ 46%]
 ........................................................................ [ 47%]
 ........................................................................ [ 49%]
 ........................................................................ [ 50%]
 ........................................................................ [ 52%]
 ........................................................................ [ 53%]
 ........................................................................ [ 55%]
 ........................................................................ [ 56%]
 ........................................................................ [ 58%]
 ........................................................................ [ 59%]
 ........................................................................ [ 61%]
 ........................................................................ [ 62%]
 ........................................................................ [ 64%]
 ........................................................................ [ 65%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 92%]
 ........................................................................ [ 93%]
 ........................................................................ [ 95%]
 ........................................................................ [ 96%]
 ........................................................................ [ 98%]
 ........................................................................ [ 99%]
 .............                                                            [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  292      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    325      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               78      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               162      0   100%
 app/rag/retriever.py             259      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7116     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,15 @@
 **Implemented (phase 191 task 03 — the per-source name/label/tags editor, D6)**
 - `frontend/index.html`: new **Names, labels and tags** card inside the admin-gated `#git-sources-content` — bounded `.table-wrap` table (sticky header), `role="alert"` load-error line, empty state, and ONE shared `<template id="source-label-row-template">`: read-only mono identity `<code>` + Name ≤120 / Label ≤200 / Tags ≤32 fields (real `<label for>`) + Save/Reset + `role="status"` save-state line.
 - `frontend/assets/git-sources.js`: `loadLabels` → `renderLabelRows` → `makeLabelRow` (template clone + per-clone id/`aria-controls` rewrite); row list comes from `GET /api/source-labels` (so git, local **and** upload/document-only sources all get a row); token input (Enter/comma adds a chip, Backspace drops the last, ≤10×≤32, case-insensitive de-dupe); per-row dirty paint (`.is-dirty` + "unsaved changes"); per-row `saveInFlight` guard; Save `PUT` / Reset `DELETE` re-read the row **from the response** (no second GET), 404 → "That source no longer exists…", `finally` never leaves "Saving…"; collapsing discards the draft; refreshed at boot / view-refresh / add / remove / finished upload; anonymous never fetches it. Existing sync/upload/git-row flows untouched.
 - `frontend/assets/styles.css`: new block, palette variables only; `.source-label-state` + `.source-label-tag` **joined** the phase-89 tag rule (no bespoke tag-input CSS); `.source-labels-empty` shares `.git-sources-empty`; 44px floors.
 - New `tests/unit/test_source_labels_editor_ui.py` (25 marker pins: markup, alias contract, load/save/reset/404 note, token rules, clone, CSS reuse, no-hex).
 - Fixed two stale selector-list pins (phase-105/135) broken by the joined tag rule; docs: README sources section now documents the editor; AGENTS.md rule 17 gains the UI clause.
 **Gates** — `uv run pytest --cov=app --cov-report=term-missing` → **4718 passed**, `TOTAL 99%`; `uv run ruff check .` → **All checks passed**; `uv run pyright` → **0 errors**. E2E in isolation (`--no-cov`): smoke 3, git_sources_admin 6, git_sources_card_rhythm 4, source_ignore_paths 6, hidden_folders_toggle 6, archive_upload_sources 5, git_source_branch 4, git_source_tokens 4 — **all pass**. Behavior verified in a real browser with a temporary 5-scenario Playwright scratch suite (3 source kinds render, chip typing + save→DB + reset→DB, reload persistence, no horizontal overflow at 375px, anonymous fetches nothing) — scratch file deleted; dev DB left clean.
 **Notable decisions / deviations**
 - Row list = the `GET /api/source-labels` catalogue (per the task), rendered as its own table card rather than a column of `#git-sources-table`, so a source with documents but no registry row is still nameable.
 - The task's "phase-89 token input" precedent does not exist as a chip widget (phase 89 ships a one-path-per-line textarea), so the tags widget's *behavior* is new while its *styling* reuses the house tag rule + the `.ignore-editor-token` field box; no new hue, no CDN.
 - Kept the phase-77 `() => loadSources()` refresh listener verbatim (pinned) and added a second `bor:view-refresh` listener for the label list — an unrelated table reload (ignore-paths/hidden saves) therefore never wipes a half-typed name draft.
 **Next pending task:** `191_source_name_labels_tags/04_source_name_boost.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,149 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 32%]
 ........................................................................ [ 33%]
 ........................................................................ [ 35%]
 ........................................................................ [ 36%]
 ........................................................................ [ 38%]
 ........................................................................ [ 39%]
 ........................................................................ [ 41%]
 ........................................................................ [ 42%]
 ........................................................................ [ 44%]
 ........................................................................ [ 45%]
 ........................................................................ [ 47%]
 ........................................................................ [ 48%]
 ........................................................................ [ 50%]
 ........................................................................ [ 51%]
 ........................................................................ [ 53%]
 ........................................................................ [ 54%]
 ........................................................................ [ 56%]
 ........................................................................ [ 57%]
 ........................................................................ [ 59%]
 ........................................................................ [ 61%]
 ........................................................................ [ 62%]
 ........................................................................ [ 64%]
 ........................................................................ [ 65%]
 ........................................................................ [ 67%]
 ........................................................................ [ 68%]
 ........................................................................ [ 70%]
 ........................................................................ [ 71%]
 ........................................................................ [ 73%]
 ........................................................................ [ 74%]
 ........................................................................ [ 76%]
 ........................................................................ [ 77%]
 ........................................................................ [ 79%]
 ........................................................................ [ 80%]
 ........................................................................ [ 82%]
 ........................................................................ [ 83%]
 ........................................................................ [ 85%]
 ........................................................................ [ 86%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ......................................                                   [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  292      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    325      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               78      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               162      0   100%
 app/rag/retriever.py             259      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7116     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,19 @@
 **Task 04 complete — all gates green.**
 **Implemented (D2/D3 source-name selection boost):**
 - `app/config.py` — `source_name_hit_bonus: float = 0.005` knob + `>= 0` validator (`"source_name_hit_bonus must be >= 0 (0 = off)"`); env `BOR_SOURCE_NAME_HIT_BONUS`.
 - `app/core/settings_catalog.py` — "Source name hit bonus" row in *Retrieval & honesty*, flags mirrored from `name_hit_bonus` (plain, live, overridable).
 - `app/rag/retriever.py` — `RetrievedChunk.source_name_hit: bool = False`; `fuse` OR-merges it on the double-hit; `_selection_order(chunks, bonus, source_bonus=0.0)` gains `any_source_hit`, the second `+ source_bonus` term, and the extended re-sort condition (neither bonus active → no re-sort, byte-identical); `weak_hit_titles` / `select_suggested` / `select_related` gain `source_bonus: float | None = None` pulled from settings.
 - `app/api/chat.py` — ONE `question_name_hit_sources(step_db, question)` read per turn after `retrieve`, before the first selection call; flag loop over the retrieved chunks (no per-chunk query); per-turn log line untouched.
 - Battery record written to `.agents/reports/191_source_name_labels_tags/191_source_name_labels_tags__04_source_name_boost.battery.md` (task/phase files are harness-owned, so the three-run record lives in the reports dir): baseline vs `bonus=0` vs default-0.005 (no label rows) → **all three outputs line-for-line identical** (`diff` exit 0).
 **Tests/lint/coverage:**
 - 8 new `test_retriever.py` pins (kill-switch byte-identity, inert-without-hits, equal-fused lift, bounded +0.010 two-bonus, three helpers' settings defaults + both kill arms, 3 `fuse` pins); phase-119 untouched-fields pin extended; 2 `test_config.py` pins; 1 catalogue-completeness row pin.
 - `uv run pytest --cov=app --cov-report=term-missing` → **4729 passed**, `app/` coverage **99%** (>90%).
 - `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors.
 **Docs:** README — phase-191 section gains the "name focuses retrieval" paragraph + `BOR_SOURCE_NAME_HIT_BONUS` settings-table row; `.env.example` gains the knob; `AGENTS.md` rule 17 gains the task-04 boost clause (per the phase's docs note).
 **Notes:** battery app is the empty dev KB (0 docs → all deflects) — the byte-identity claim holds there; the observable-boost evidence is the unit pins + the task-06 E2E arm, per the task's testing mandate. No separate integration module (task explicitly defers the flag-loop arm to task 06; chat.py stays at 99%).
 **Next pending task:** `191_source_name_labels_tags/05_prompt_surfacing.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,149 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 35%]
 ........................................................................ [ 36%]
 ........................................................................ [ 38%]
 ........................................................................ [ 39%]
 ........................................................................ [ 41%]
 ........................................................................ [ 42%]
 ........................................................................ [ 44%]
 ........................................................................ [ 45%]
 ........................................................................ [ 47%]
 ........................................................................ [ 48%]
 ........................................................................ [ 50%]
 ........................................................................ [ 51%]
 ........................................................................ [ 53%]
 ........................................................................ [ 54%]
 ........................................................................ [ 56%]
 ........................................................................ [ 57%]
 ........................................................................ [ 59%]
 ........................................................................ [ 60%]
 ........................................................................ [ 62%]
 ........................................................................ [ 63%]
 ........................................................................ [ 65%]
 ........................................................................ [ 66%]
 ........................................................................ [ 68%]
 ........................................................................ [ 70%]
 ........................................................................ [ 71%]
 ........................................................................ [ 73%]
 ........................................................................ [ 74%]
 ........................................................................ [ 76%]
 ........................................................................ [ 77%]
 ........................................................................ [ 79%]
 ........................................................................ [ 80%]
 ........................................................................ [ 82%]
 ........................................................................ [ 83%]
 ........................................................................ [ 85%]
 ........................................................................ [ 86%]
 ........................................................................ [ 88%]
 ........................................................................ [ 89%]
 ........................................................................ [ 91%]
 ........................................................................ [ 92%]
 ........................................................................ [ 94%]
 ........................................................................ [ 95%]
 ........................................................................ [ 97%]
 ........................................................................ [ 98%]
 .................................................                        [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  297      2    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               78      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               162      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7139     17    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,17 @@
 # Phase 191 task 04 — retrieval battery record (the phase-119 convention)
 Command (all three arms): `uv run python -m scripts.eval_retrieval --from-file tests/fixtures/retrieval_battery.txt`
 Run against the battery app = the dev Postgres (`brain-of-reese_db_1`) with **0 documents / 0 chunks / 0 `source_labels` rows** — every question deflects (`best_cosine=0.0000 fts_hits=0 -> LOW`). That is the state the task's no-row baseline names: with no label rows the D2 rule can produce no hit, so all three arms must — and do — agree line-for-line.
 | Arm | Setting | Output | Result |
 | --- | --- | --- | --- |
 | (a) baseline (pre-change) | shipped defaults | `/tmp/battery191/baseline.txt` (29 lines) | reference |
 | (b) post-change kill switch | `BOR_SOURCE_NAME_HIT_BONUS=0` | `/tmp/battery191/post_bonus0.txt` | `diff (a) (b)` = **line-for-line identical** |
 | (c) post-change default | `source_name_hit_bonus = 0.005` (no label rows exist) | `/tmp/battery191/post_default.txt` | `diff (a) (c)` = **line-for-line identical** |
 The observable-boost evidence therefore lives in the unit pins (the
 kill-switch byte-identity, the bounded two-bonus application, the fuse
 OR-merge and the three settings-default helpers in
 `tests/unit/test_retriever.py`), and the named-source surfacing arm lands
 with the task-06 E2E suite (`tests/e2e/test_source_name_labels.py`),
 which runs its own seeded app fixture.
@@ -0,0 +1,20 @@
 **Task 05 (`191_source_name_labels_tags/05_prompt_surfacing.md`) — done**
 **Implemented**
 - `app/rag/prompts.py`: `build_high_prompt(..., names: Mapping[str, SourceLabelView] | None = None)`; the `<document>` head gains additive ` name="…"` (right after `source="…"`) then ` label="…"`, locked order `source→name?→label?→path→title→date`; new `_attr` escaper; unset field adds NOTHING.
 - `app/rag/overview.py`: `build_overview_prompt(..., names: Mapping[str, str] | None = None)` swaps the display name into the lite model's INPUT line only; `regenerate_overview` performs ONE `all_labels` read (after the zero-doc gate) and derives the name map from those views — stored row + `Sources:` tail stay derived-name.
 - `app/api/chat.py`: task-04 call site refactored to the shared `labels = all_labels(step_db)` (pure `question_name_hits` inlined, flag loop unchanged) and `plan_turn(names=labels)` → `build_high_prompt(names=…)`; `question_name_hit_sources` no longer runs in a turn. `retriever.py`/`source_labels.py` docstrings aligned.
 - Tests: 12 pins in `tests/unit/test_prompts.py` (kill pins None/{}/no-entry, attribute-order, label-only, escaping, per-source scoping, LOW-prompt clean), 12 in `tests/unit/test_overview.py` (kill pins, line swap, cap, `regenerate_*` display-name/inventory/single-read + marker pins), 5 in `tests/unit/test_chat_gate.py` (plan_turn names/kill/LOW + chat.py one-read marker pin + an endpoint pin that the ONE read sets both the boost flag and the prompt attributes).
 **Gates**
 - `uv run pytest --cov=app --cov-report=term-missing` → **4762 passed**, TOTAL 99% (`prompts.py`/`overview.py`/`source_labels.py` 100%, `chat.py` 99% — only the pre-existing 503-cap line).
 - `uv run ruff check .` → clean; `uv run pyright` → 0 errors.
 - Sanity E2E (unaffected-by-design check): `uv run pytest tests/e2e/test_chat_rag.py tests/e2e/test_kb_overview.py tests/e2e/test_name_signal_read_chips.py --no-cov` → 11 passed.
 **Docs**: README — new "The name reaches the model, too." paragraph in the phase-191 section; AGENTS.md rule 17 — task-04 clause corrected to the ONE `all_labels` read and extended with the task-05 surfacing contract.
 **Decisions / deviations**
 - Phase-file D4 sketched `display_name (label) — path` prose; task 05 (the executable spec) specifies the additive `name=`/`label=` attributes — implemented per task 05.
 - Verified L934: the block writer never escaped `source`/`path`/`title`, so there was no shared helper. Added `_attr` (`&`,`<`,`>`,`"`) applied ONLY to the two new owner-supplied values — escaping the identity attributes would have broken the "label-less block byte-identical" criterion. Single quotes deliberately kept (`Reese's` stays readable).
 **Next pending task**: `191_source_name_labels_tags/06_e2e_and_gates.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 65%]
 ........................................................................ [ 66%]
 ........................................................................ [ 68%]
 ........................................................................ [ 69%]
 ........................................................................ [ 71%]
 ........................................................................ [ 72%]
 ........................................................................ [ 74%]
 ........................................................................ [ 75%]
 ........................................................................ [ 77%]
 ........................................................................ [ 78%]
 ........................................................................ [ 80%]
 ........................................................................ [ 81%]
 ........................................................................ [ 83%]
 ........................................................................ [ 84%]
 ........................................................................ [ 86%]
 ........................................................................ [ 87%]
 ........................................................................ [ 89%]
 ........................................................................ [ 90%]
 ........................................................................ [ 92%]
 ........................................................................ [ 93%]
 ........................................................................ [ 95%]
 ........................................................................ [ 96%]
 ........................................................................ [ 98%]
 ........................................................................ [ 99%]
 ..........                                                               [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  298      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7160     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,17 @@
 **Task 06 (`191_source_name_labels_tags/06_e2e.md`) — done**
 **Added** `tests/e2e/test_source_name_labels.py` (7 tests, own module app on port 8208). Fixture registers + indexes **all three source kinds** through the real APIs — a real `git init` repo cloned by the sync over `file://` (`forgecore`), a local dir (`homelab`), a tar.gz through `/api/git-sources/upload` (`notesdrop`) — with a token-controlled corpus whose target (`forgecore/notes/b6.md`) is pinned by the app's own retrieval at setup as rank 6 (out of the top-5 seed) and rank 1 once its source is named.
 - (a) editor saves Name/Label/Tags on a git, local **and** upload row → per-row "saved", reload re-populates, identity cell stays the read-only derived `<code>`;
 - (b) control turn: target in the "Nearby docs" row, no `<document>` block for it; after saving "the git server"/"self-hosted forge"/tags the **same** question seeds it with the wire-exact `<document source="forgecore" name="the git server" label="self-hosted forge" path="notes/b6.md"` (mock `/v1/e2e/captured`), and a name-free question with the same row saved holds the pre-phase tier;
 - (c) alias vs identity: content API + viewer + KB tree stay DERIVED, `source=the git server` → 404, nearby-doc href derived;
 - (d) vanished source → the named 404 note, gone from the catalogue on reload, orphan PUT 404; (e) Reset clears fields and the tier reverts.
 **Defect found and fixed (task 03's UI):** `frontend/assets/git-sources.js` — the save's `finally` called `updateLabelRowUI`, whose dirty hint repainted the failure note in the same tick, so "That source no longer exists — reload the page." was never readable. The paint now returns before the hint on an `.is-error` line; a new `clearLabelError` drops the note on the next edit only. Pinned by `test_a_failed_saves_note_survives_the_dirty_paint` + the E2E.
 **Gates**: `pytest --cov=app` → **4763 passed, TOTAL 99%**; `tests/e2e/test_source_name_labels.py -v --no-cov` → **7 passed** in isolation; regressions green unedited (name_signal_read_chips, admin_settings_panel, local_directory_sources, kb_tree, git_sources_admin, source_ignore_paths, archive_upload_sources → 51 tests); `ruff check .` clean, `pyright` 0 errors.
 **Docs**: README — the failure note now documented as staying until an edit/collapse; AGENTS.md rule 17 — the error-note-survival contract and the new E2E suite named as a pinner of the alias contract.
 **Deviations**: no commit and no `todo/`→`complete/` move (harness-managed per my operating instructions; working tree left staged-ready). The 404 arm uses a never-synced throwaway git row it deletes itself, so no other source's documents are touched.
 **Next pending task**: none in `191_source_name_labels_tags/` — the phase is complete pending the harness commit.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 65%]
 ........................................................................ [ 66%]
 ........................................................................ [ 68%]
 ........................................................................ [ 69%]
 ........................................................................ [ 71%]
 ........................................................................ [ 72%]
 ........................................................................ [ 74%]
 ........................................................................ [ 75%]
 ........................................................................ [ 77%]
 ........................................................................ [ 78%]
 ........................................................................ [ 80%]
 ........................................................................ [ 81%]
 ........................................................................ [ 83%]
 ........................................................................ [ 84%]
 ........................................................................ [ 86%]
 ........................................................................ [ 87%]
 ........................................................................ [ 89%]
 ........................................................................ [ 90%]
 ........................................................................ [ 92%]
 ........................................................................ [ 93%]
 ........................................................................ [ 95%]
 ........................................................................ [ 96%]
 ........................................................................ [ 98%]
 ........................................................................ [ 99%]
 ...........                                                              [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  298      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 494      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   576      0   100%
 --------------------------------------------------
 TOTAL                           7160     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1 @@
 All 4 tasks are complete. This is the final verification pass. Let me review the reports and completions.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,12 @@
 Phase 192 — final verification pass complete.
 - **Verified (all 4 tasks already complete):** additive `verbatim_block` SSE frame (`VerbatimBlockPiece` → `ChatVerbatimBlockEvent` → chat dispatch, after the round's `tool`/`tool_result`, before the next round); `hydrateVerbatimNow` matched-only mid-turn pass + app.js branch; `dropPlacedTwin` per-locator done/restore dedupe; the dedicated E2E suite.
 - **Root cause of the rejected attempt:** my own concurrent background `pytest` run deadlocked the harness validation run on the shared Postgres (`psycopg.errors.DeadlockDetected`). No code defect — re-ran every gate **exclusively**.
 - `uv run pytest -q --cov=app --cov-report=term-missing` → **exit 0**, `TOTAL 7181 16 99%` (>90%)
 - `uv run pytest tests/e2e/test_verbatim_inline_midturn.py --no-cov` → **6 passed** (isolated)
 - `uv run pytest tests/e2e/test_verbatim_show_text.py tests/e2e/test_chat_history.py --no-cov` → **18 passed** (`test_chat_history.py` byte-unedited; the phase-182 suite's "no eighth type" pin was tightened, not loosened, to seven + `verbatim_block` with frame-order asserts)
 - `uv run ruff check .` → All checks passed (exit 0) · `uv run pyright` → **0 errors**
 - **Completion criteria:** single frame per success + zero per refusal ✅ · `BOR_ANSWER_TEXT=0` wire byte-identical (integration spelled baseline + E2E App B) ✅ · fence hydrates in place / unfenced lands at the call moment, before `done` ✅ · append+fence → 1 panel, two ranges → 2 panels ✅ · restore 1 panel/locator, `done.answer_text` + record key + `verbatim_blocks=N` unchanged ✅ · suite green, coverage 99%, lint/types clean ✅ · no-show_text turn byte-identical ✅ · commit → left to the harness (no git index/history commands run).
 - **Docs:** README reviewed line-by-line (2399 lines) + AGENTS.md in full; mechanically verified all 86 `BOR_*` settings, every `.env.example` var, table defaults, internal anchors (0 broken), ports 8123/8901, tree depth 1–8, pagination 25/1–100, 17 palette colors, `0029`/`0030` migrations, and every cited test file. Fixed 1 inconsistency: the verbatim "Parity" bullet claimed the live turn/reload/shared page share "the same three globals" — now names the settle-path trio and states that `hydrateVerbatimNow` is the ONE chat-only addition (a shared page has no stream).
 - **Notable:** `run_agent`'s four repeated piece unions were collapsed into the ONE exported `AgentPiece` alias, so a future piece type is spelled in one place; `test_frontend_edit_message.py`'s `runTurn` byte-pin was regenerated, not weakened.
 - **Next pending phase:** `193_sync_remaining_count`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ......................................                                   [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,19 @@
 All gates green. Report:
 **Implemented (task 01 — the additive `verbatim_block` SSE frame, A1)**
 - `app/rag/agent.py`: new frozen `@dataclass VerbatimBlockPiece` (`block: VerbatimBlock`); the round loop snapshots `shown_before = len(holder.shown_texts)` before `_execute_tool` and yields one piece per appended block, AFTER the round's `tool`/`tool_result` pieces and BEFORE the next model round (success-only — every refusal returns before the `shown_texts.append`); module + `run_agent` docstrings carry the emission-order contract.
 - Named the widened generator union once as `type AgentPiece = StreamPiece | ToolCallPiece | RetryPiece | ToolResultPiece | VerbatimBlockPiece` (task text spelled it literally; the alias keeps `run_agent`, the chat pump and 6 test harnesses on one spelling — the literal widening broke E501/pyright in 19 annotation sites).
 - `app/schemas.py`: `ChatVerbatimBlockEvent` right after `ChatToolResultEvent` — `type: Literal["verbatim_block"]` + the exact `VerbatimBlockRef` field set/caps, no `model_config` (sibling convention mirrored).
 - `app/api/chat.py`: the `VerbatimBlockPiece` dispatch branch after the `ToolResultPiece` branch; done-frame `answer_text` and the `verbatim_blocks=N` log line untouched.
 - Tests: 10 unit cases in `tests/unit/test_agent.py` (piece shape, success position + holder-object identity, order after a truncation piece, 5 refusal params, already-shown dedupe, kill switch), 2 in `tests/unit/test_schemas.py` (wire shape + a field/caps drift pin against `VerbatimBlockRef`), 2 in `tests/integration/test_chat_api.py` (`verbatim_block` between `tool` and `delta`/`done` with the exact key set + same block still on `done`, `verbatim_blocks=1`; kill-switch frame sequence byte-identical to the spelled-out pre-phase baseline).
 **Gates** — `uv run pytest --cov=app --cov-report=term-missing` → 4777 tests, exit 0, TOTAL 99% (chat.py 99%, agent.py 99%, schemas.py 100%); `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors. E2E in isolation `--no-cov`: `test_verbatim_show_text.py` 13 passed, `test_chat_history.py` + `test_answer_images.py` 10 passed, `test_source_name_labels.py` 7 passed.
 **Docs** — README verbatim section: new "The panel lands while the answer streams" bullet, the `done`-frame bullet's now-false "no eighth SSE event type" corrected, `BOR_ANSWER_TEXT` row notes no frame is sent; AGENTS.md rule 5 phase-182 clause + rule 10 `verbatim_blocks=N` clause updated.
 **Deviations / notes**
 - `tests/e2e/test_verbatim_show_text.py` pinned "SSE type set stays inside the pre-phase seven (no eighth type)" — invalidated by this phase's design; updated to "the seven + `verbatim_block`" and extended with the mid-turn ordering pin (that suite is otherwise green unedited).
 - `PLAN.md` §2 A15 / §4 still list seven event types and "no eighth SSE event type"; PLAN.md is out of my edit scope — flag for the phase-04 docs pass / owner revision note.
 - No live-infra work in this task; all changes left unstaged for the harness.
 **Next pending task:** `192_verbatim_inline_midturn/02_midturn_hydration_and_append.md` (`hydrateVerbatimNow` + the `app.js` `verbatim_block` branch).
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 .........................                                                [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,19 @@
 All gates green. Report:
 **Implemented (task 02 — mid-turn landing, A2)**
 - `frontend/assets/verbatim.js`: new `hydrateVerbatimNow(root, block, opts)` — walks the done path's pending set (`.verbatim-pending[data-bor-locator]`), matches through the ONE `matchVerbatimBlock` rule with a one-block list, replaces ONLY matched nodes with `buildVerbatimPanel`, leaves every unmatched fence `.verbatim-pending`, returns the settle count, total (no `try`) via `isVerbatimBlock` + root guards.
 - `frontend/assets/app.js`: the `ev.type === "verbatim_block"` branch beside `tool_result` — hydrate in place, `if (n === 0) appendUnlocatedVerbatim(wrap, [ev], VERBATIM_LINK_OPTS)`; no client-side kill-switch gate (server-only). No import line existed/changed: `verbatim.js` is a classic script whose top-level functions are globals (task text's "import site" = the existing global call sites).
 - **Pulled forward phase design A3** (`verbatimPlacedKey` + `dropPlacedTwin`, called from `hydrateVerbatim`): without it, a mid-turn-appended block that the model fences in a later round painted TWO panels and the phase-182 E2E suite (`test_verbatim_show_text.py`, 5 tests) went red — the "one locator, one panel" rule (per canonical locator, `.msg`-bounded, pending/unresolved never a placement) was the only way to leave the repo green.
 - Pins in `tests/unit/test_frontend_verbatim_blocks.py`: marker pins (`hydrateVerbatimNow` matched-only contract, never-throw, the app.js zero-match-append shape + asserted absence of any client gate, the twin-scan shape) plus 4 new node-driven behavioural tests on a minimal DOM (in-place settle + untouched sibling fence, server-extent fallback, malformed/no-match/null-root arms, mid-turn panel survives the done pass, one-locator-one-panel across passes incl. two ranges → two panels).
 - `tests/unit/test_frontend_edit_message.py`: regenerated `PINNED_RUN_TURN` to the sanctioned phase-192 branch (verified the old pin == HEAD `runTurn` first) + docstring clause; `verbatimPlacedKey` now the single key derivation shared with `appendUnlocatedVerbatim`.
 **Gates** — `uv run pytest --cov=app --cov-report=term-missing` → **4784 passed**, TOTAL **99%**; `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors; E2E in isolation `--no-cov`: `test_verbatim_show_text.py` + `test_chat_history.py` + `test_answer_images.py` + `test_share_chat.py` + `test_chat_persistence.py` → 31 passed (the phase-182 suite green again, unedited assertions).
 **Docs** — README verbatim section: the client half of the mid-turn landing (in-place vs answer-position, twin dropped, one locator one panel, no client flag); AGENTS.md rule 5 phase-182 clause extended with the mid-turn matched-only contract + the per-locator twin scan, re-tagged "phase 182 task 07, phase 192 tasks 01–02".
 **Decisions / deviations**
 - Task 02's checkbox "hydrateVerbatim untouched" is unsatisfiable together with a green suite (the duplicate is structural); resolved by implementing A3 exactly as the phase overview specifies. **Task 03 should verify/extend, not re-implement** — remaining there: the restore/shared-parity pin and its own marker set.
 - Side effect, documented + pinned: a fence the model repeats for the SAME locator now shows one panel (at the last fence) instead of two.
 - No live-infra work; all changes left unstaged for the harness.
 **Next pending task:** `192_verbatim_inline_midturn/03_done_and_restore_dedupe.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ................................                                         [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,18 @@
 **Task 03 complete — all gates green.**
 Implemented (task 03, A3/A4):
 - `frontend/assets/verbatim.js`: `hydrateVerbatim`'s twin-scan host is now `root.closest(".msg") || root` — a missing `.msg` wrap narrows the scan to the root instead of switching the per-locator dedupe off (`dropPlacedTwin` itself, `appendUnlocatedVerbatim`, `settleVerbatimPlaceholders` and the task-02 functions untouched).
 - `tests/unit/test_frontend_verbatim_blocks.py`: new `_doc`/`_flow` docstring-pin helpers + `bareFence` DOM fixture; pins `test_the_twin_dedupe_docstring_keeps_the_per_locator_clause` (per-locator-not-per-identity + two-ranges-stay + in-text-wins prose), `test_the_twin_scan_bounds_to_the_msg_wrap_or_the_root`, node arms `test_the_twin_scan_bounds_to_the_message_it_hydrates` (bare-bubble dedupe, two ranges stay two, a sibling message is out of bounds) and `test_a_stored_record_restores_one_panel_per_locator` (restore/shared parity behaviour).
 - `tests/integration/test_chat_api.py`: `test_done_frame_and_log_line_unchanged_by_midturn_frames` — two `show_text` rounds → two `verbatim_block` frames each inside its own round, `done.answer_text` byte-equal to the phase-182 resolution spelled from the row (new `_BACKUPS`/`_doc_title` helpers), done key set unchanged, and the ONE log line reads `verbatim_blocks=2` (never 4 — mid-turn frames counted nowhere).
 - `tests/unit/test_schemas.py`: `test_chat_verbatim_block_event_dump_keys_are_the_client_contract` (dump key set == `VerbatimBlockRef` keys + `type`, client-guard keys present, ref round-trip).
 - Verified the A3 code and several pins already existed from task 02; I closed only the genuine gaps (fallback, docstring pin, bound arms, the named integration/log pin, the schema key-set pin) rather than duplicating, and confirmed `app.js` restore lines and `shared.js` are untouched (`git diff`: app.js +24 lines = the new branch only).
 Gates (exact commands):
 - `uv run pytest --cov=app --cov-report=term-missing` → **4790 passed**, `TOTAL 7181 16 99%` (>90%)
 - `uv run pytest tests/unit/test_frontend_verbatim_blocks.py tests/integration/test_chat_api.py -v --no-cov` → **124 passed**
 - `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors
 - `uv run pytest tests/e2e/test_verbatim_show_text.py --no-cov` → 13 passed; `tests/e2e/test_chat_history.py` → 5 passed
 Docs: `README.md` verbatim section now states the dedupe's bound (`.msg` wrap, root fallback, never crosses into the next answer); `AGENTS.md` rule 5 `dropPlacedTwin` clause gained the bound and the attribution is now "phase 192 tasks 01–03".
 Next pending task: `.agents/phases/todo/192_verbatim_inline_midturn/04_e2e_and_gates.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ......................................                                   [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,28 @@
 **Task 04 complete — all gates green.**
 Added (`tests/e2e/test_verbatim_inline_midturn.py`, NEW — 6 tests, module docstring names TODO.md:6 and the LOCKED-A4 unchanged-contract clause; ports 8209/8210, the phase-182 module-app/KB/cleanup conventions):
 | Test | Arm | Pins |
 |---|---|---|
 | `test_midturn_panel_lands_before_the_answer_streams` | (a) | panel in the DOM **before `done`** (in-page `MutationObserver` witness: `doneSeen=false`, `sentinelInDom=false`, pill `"Stop"`, `forLocator=1`), below the intro the model wrote pre-call, server caption/gutter/body/badge, clipboard == the server string, band order bubble → verbatim → `.msg-meta`, `done` adds nothing (count 1), frame order `delta* → tool → verbatim_block → delta* → done` with each delta segment byte-equal to the mock's text |
 | `test_midturn_fence_hydrates_in_place_not_at_the_answer_tail` | (b) | placeholder exists first → `hydrateVerbatimNow` settles it **in place** mid-turn (inside `.bubble`, nothing appended), one panel after `done`, intro < panel < sentinel, no model bytes |
 | `test_midturn_append_and_a_later_fence_leave_one_panel` | (c) | mid-turn append at the answer position, `done` re-homes it onto the same-locator fence and drops the twin — exactly ONE panel at the fence |
 | `test_two_ranges_of_one_file_land_two_panels` | (d) | `tool → block → tool → block`, two panels in call order, own captions/gutter starts, `done.answer_text` = both |
 | `test_kill_switch_off_ships_the_pre_phase_wire` | (e) | App B: `Unknown tool.` refusal, **no** `verbatim_block`, no `answer_text`, tool frame an exact dict, delta bytes == App A's answer bytes, zero panels/placeholders witnessed |
 | `test_restore_repaints_one_panel_for_the_midturn_locator` | (f) | record `answer_text` unchanged, reload + server-record path (localStorage cleared) → ONE panel, caption/bytes/badge/gutter, no turn re-run |
 Mock (`tests/e2e/mock_llm.py`, additive): the `MIDTURN_TRIGGER` flow + `MIDTURN_*` constants and answer strings, `MIDTURN_GAP_S` silence between the frame and the answer's first delta, arm markers, the two-range stateless branch, the module-docstring bullet. Phase-182's pins and every other flow untouched.
 Docs: `README.md` — the mid-turn landing clause (already carried tasks 01–03) re-wrapped; `AGENTS.md` rule 5 attribution now `phase 192 tasks 01–04` and names `tests/e2e/test_verbatim_inline_midturn.py` as the owner-visible pin. `.agents/PLAN.md` needed no correction (it never claimed `done` was the only landing point).
 Gates (exact commands):
 - `uv run pytest -q --cov=app --cov-report=term-missing` → **4790 passed, exit 0**, `TOTAL 7181 16 99%` (>90%)
 - `uv run pytest tests/e2e/test_verbatim_inline_midturn.py -v --no-cov` → **6 passed**, exit 0 (isolated)
 - `uv run pytest tests/e2e/test_verbatim_show_text.py tests/e2e/test_chat_history.py -v --no-cov` → **18 passed**, exit 0 (unedited)
 - `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors
 Notes / deviations:
 1. Arm (a)'s literal "ABOVE the final sentinel delta" cannot hold as sibling order — an unfenced block has no fence to return to, so `appendUnlocatedVerbatim` parks it at the phase-182 answer band (below the answer text, above the chips). The suite pins the stronger mid-turn claim (the sentinel did not exist when the panel landed) and asserts the literal between-the-two position in the fenced arms (b)/(c), where intro < panel < sentinel inside the bubble. Documented in the test docstring.
 2. Two mock corrections the arms needed (documented in place): `show_text`'s `path` argument must be the COMBINED `source/path` (a bare path is the phase-72 refusal), and a round-1 fence must be padded with a blank line, because the client concatenates rounds with no separator — an unpadded closing ` ``` ` glues to the next round's first word and stops being a fence.
 3. Owner-visible observation, NOT changed (out of task scope): when the fence is written *before* the call, the next `delta` re-renders the bubble from `acc` (which still holds the fence), so the node returns to `.verbatim-pending` until `done` settles it again. Both ends are asserted and the interim is the honest phase-182 state (never the model's bytes); making the per-delta renderer preserve hydrated panels would remove the interim and deserves its own phase/task.
 4. Left to the harness (no index/history-mutating commands run): moving `todo/192_verbatim_inline_midturn/04_e2e.md` → `complete/` and the single atomic `--no-gpg-sign` commit.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ......................................                                   [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,11 @@
 **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/`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ........................................                                 [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,16 @@
 **Task 01 complete — `fmtSyncLabel` count part is now `N remaining` (D1).**
 **Implemented**
 - `frontend/assets/sources.js` — `fmtSyncLabel` count: `total > 0 && total - done > 0 ? `${total - done} remaining` : ""` (pre-walk `total > 0` guard kept, hidden at `N == 0`, plain integer, upload shares via the one builder); `fmtSyncLabel` + `fmtSyncPhaseLabel` docstrings updated to the count-down shape (lineage kept; summaries `(n/m)`, `· chunk n/m`, `· image n/m`, terminal `counts_line`, `setSyncLabel`/`#sync-progress` and the server/payload untouched).
 - `tests/unit/test_frontend_sync_upload.py` — new marker pins `test_fmt_sync_label_count_part_is_the_n_remaining_part` (exact expression, both guards, no-separator, docstring clauses incl. the hidden-at-final-file edge + upload sharing) and `test_remaining_part_leaves_the_other_parts_byte_identical` (chunk/image/summaries builders + `fmtSyncResult` unchanged); retargeted the `(2/3)` contract/harness pins to `1 remaining`; node harness gained the `import-final` row (count part behaviorally hidden at N == 0) wired into the chunk/image/box/Cancel loops; module docstring + `_doc_above` helper added.
 - `README.md` — sync running-label description: "Syncing… <file> (n/m)" → "Syncing… <file> N remaining" with the N = total − done / hidden-at-final-file / upload-sharing clause. `AGENTS.md`: verified no clause names the count part — no change (per phase doc note).
 **Gates (all green)**
 - `uv run pytest tests/unit/test_frontend_sync_upload.py` → pass (incl. node harness)
 - `uv run pytest --cov=app --cov-report=term-missing` → **4792 passed**, `app/` coverage **99%** (>90%)
 - `uv run ruff check .` → clean; `uv run pyright` → clean
 **Decisions / deviations**
 - E2E running-label count pins (`test_sync_label_mobile.py`, `test_sync_upload_progress.py`, `test_sync_chunk_progress.py`, `test_sync_image_progress.py`, `test_sync_progress_box.py`) are deliberately left for **task 02** ("the pinned suites move"), per phase 193 D2 — the project's default suite (`testpaths`: unit+integration) is 100% green.
 **Next pending task:** `193_sync_remaining_count/02_update_pinned_e2e.md`
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ........................................                                 [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,22 @@
 **Task 02 complete — every running-label count pin now asserts `N remaining`.**
 **Implemented (test-only + doc hygiene)**
 - `tests/e2e/test_sync_label_mobile.py`: `IMPORT_COUNT_RE`/`IMPORT_FULL_RE` + both in-browser JS regexes → `[1-3] remaining` (4-file fixture; `files_done` is the importer's **1-based current file**, so N = 4−done ∈ {3,2,1} and the last file renders no part — the phase doc's "`done = i − 1`" arithmetic was wrong); `IMPORT_MAIN_RE` untouched.
 - `tests/e2e/test_sync_upload_progress.py`: the 4 box/title count regexes → `(?: [0-9]+ remaining)?` (optional — see deviations).
 - `tests/e2e/test_sync_chunk_progress.py`: JS `count.textContent`, `countText`, the composed A4 string → `1 remaining` (big.md = file 1 of 2).
 - `tests/e2e/test_sync_progress_box.py`: the 3 JS waits + 2 Python asserts → `2 remaining` (long file = file 1 of 3).
 - `tests/e2e/test_sync_image_progress.py`: the single-file fixture's `(1/1)` pin became the **hidden-at-final-file** arm (`no running label carries " remaining"` + the live-file label still pinned).
 - Phase-193 lineage sentence added to each retargeted module docstring; stale `(n/m)` prose fixed in `test_archive_upload_sources.py`, `test_sync_status_freshness.py`, `test_upload_no_scan.py`, `tests/unit/test_sync_button.py`, `tests/unit/test_frontend_sync_upload.py`.
 - **Untouched and green**: the `· chunk n/m` / `· image n/m` parts, the summaries `(n/3)` folder position, and every `counts_line` terminal pin (`git_freeze`, `session_reset`, `fast_path_deferred_content`).
 - Pin list closed: the remaining hits of the phase's grep are bare `"Syncing…"` asserts and the owner's quoted reports.
 **Gates**
 - `uv run pytest` → **4792 passed**; `uv run pytest --cov=app --cov-report=term-missing` → **99%** (>90%).
 - `uv run ruff check .` → All checks passed; `uv run pyright` → 0 errors.
 - E2E (`--no-cov`, isolated): `test_sync_label_mobile.py + test_sync_upload_progress.py` 8 passed (the task's combined command); `test_sync_progress_box.py` 8; `test_sync_chunk_progress.py + test_sync_image_progress.py` 4; `+ test_sync_summary_visibility.py` 7; `test_sync_git_freeze.py` 2; `test_archive_upload_sources.py + test_sync_session_reset.py` 9; `test_fast_path_deferred_content.py + test_sync_button.py + test_sync_peak_memory_visible.py` 11; `test_sync_status_freshness.py + test_upload_no_scan.py` in the summary batch.
 **Docs**: README's sync running-label paragraph — removed the stray `— and —` the task-01 edit left and re-flowed the wrap; AGENTS.md has no count-part clause (no doc impact for it; task 03 re-verifies).
 **Deviations**: (1) the phase's D2 range `[1-4] remaining` is impossible — `files_done` includes the in-flight file, so the count-bearing frames are `[1-3]` (kept **mandatory** where the pin's whole point is "the count is in the text"); (2) the upload suite's 25-file box/title pins make the part **optional**, because its 2 s poll can land exactly on the final file where A1 hides the part — the pattern still rejects a pre-phase `(n/m)` tail.
 **Next pending task**: `.agents/phases/todo/193_sync_remaining_count/03_e2e.md`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ........................................                                 [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,15 @@
 **Task 03 complete — phase 193's own E2E suite is green in isolation; all gates green.**
 **Implemented**
 - `tests/e2e/test_sync_remaining_count.py` (NEW): a real `file://` git fixture (5 docs, first + last multi-chunk) + the slow-LLM proxy, with a MutationObserver that records EVERY value the one label writer lands (`#sync-progress-text`, button `title`/`aria-label`, `.sync-label-count` visibility). Arms: **(a)** the count-down — grammar `^Syncing… <file> [1-4] remaining(?: · chunk n/m)?$`, rendered `N`s strictly decreasing 4→3→2→1, never 0/≥total, chunk part coexisting (its `m` = the file's real `chunk_document` count), NO count part once the final file is named and never returning, the overview + summaries `(n/m)` phases intact, the terminal `counts_line("5 added")` byte-identical, plus the cross-layer invariant that every rendered `N` equals `files_total − files_done` of the untouched payload; **(c)** the pre-walk `phase:null`/`files_total:0` → bare `Syncing…` and the hidden-at-final edge, pinned on served bodies of the endpoint's unchanged key set; **(b)** the upload arm through the same builder (`Importing <file> N remaining`, hidden at its final file).
 - Docs pass: the stale `(n/m)` running-label examples became `N remaining` in `frontend/assets/sources.js` (5 header/comment sites), `frontend/assets/styles.css`, `frontend/index.html`, `frontend/assets/git-sources.js`. `README.md` already carried the phase-193 label (task 01); `AGENTS.md` has no clause naming the running count part — unchanged.
 **Gates (final state)** `uv run pytest --cov=app --cov-report=term-missing` → exit 0, `app/` **99%**; `tests/e2e/test_sync_remaining_count.py -v --no-cov` → 3 passed in isolation (twice); regression `test_sync_label_mobile + test_sync_upload_progress + test_sync_chunk_progress + test_sync_summary_visibility` → 13 passed; `ruff check .` clean; `pyright` 0 errors.
 **Decisions / deviations**
 1. A2's upload arm is not observable live: since phase 90 the upload status answers `null/0/0` for the whole run (asserted against the live endpoint inside that test), so the shared *shape* is pinned through a served status body (the house `page.route` pattern) — the client's `total > 0` / `total − done > 0` guards are what is under test, the server stays untouched.
 2. The upload frame can never carry `· chunk n/m` (that branch receives no status object — phase 129/152), so the coexistence pin sits in the sync arms and the upload test asserts the frame stays chunk-free.
 3. Count-bearing frames are `1 … N−1` (`files_done` is the 1-based in-flight file) — task 02's finding, kept here.
 4. No git commands run and the phase directory was not moved, per the harness instruction — commit + `todo/ → complete/` left to the harness.
 **Next task:** none pending in `193_sync_remaining_count` (03 is its last).
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  3%]
 ........................................................................ [  4%]
 ........................................................................ [  6%]
 ........................................................................ [  7%]
 ........................................................................ [  9%]
 ........................................................................ [ 10%]
 ........................................................................ [ 12%]
 ........................................................................ [ 13%]
 ........................................................................ [ 15%]
 ........................................................................ [ 16%]
 ........................................................................ [ 18%]
 ........................................................................ [ 19%]
 ........................................................................ [ 21%]
 ........................................................................ [ 22%]
 ........................................................................ [ 24%]
 ........................................................................ [ 25%]
 ........................................................................ [ 27%]
 ........................................................................ [ 28%]
 ........................................................................ [ 30%]
 ........................................................................ [ 31%]
 ........................................................................ [ 33%]
 ........................................................................ [ 34%]
 ........................................................................ [ 36%]
 ........................................................................ [ 37%]
 ........................................................................ [ 39%]
 ........................................................................ [ 40%]
 ........................................................................ [ 42%]
 ........................................................................ [ 43%]
 ........................................................................ [ 45%]
 ........................................................................ [ 46%]
 ........................................................................ [ 48%]
 ........................................................................ [ 49%]
 ........................................................................ [ 51%]
 ........................................................................ [ 52%]
 ........................................................................ [ 54%]
 ........................................................................ [ 55%]
 ........................................................................ [ 57%]
 ........................................................................ [ 58%]
 ........................................................................ [ 60%]
 ........................................................................ [ 61%]
 ........................................................................ [ 63%]
 ........................................................................ [ 64%]
 ........................................................................ [ 66%]
 ........................................................................ [ 67%]
 ........................................................................ [ 69%]
 ........................................................................ [ 70%]
 ........................................................................ [ 72%]
 ........................................................................ [ 73%]
 ........................................................................ [ 75%]
 ........................................................................ [ 76%]
 ........................................................................ [ 78%]
 ........................................................................ [ 79%]
 ........................................................................ [ 81%]
 ........................................................................ [ 82%]
 ........................................................................ [ 84%]
 ........................................................................ [ 85%]
 ........................................................................ [ 87%]
 ........................................................................ [ 88%]
 ........................................................................ [ 90%]
 ........................................................................ [ 91%]
 ........................................................................ [ 93%]
 ........................................................................ [ 94%]
 ........................................................................ [ 96%]
 ........................................................................ [ 97%]
 ........................................................................ [ 99%]
 ........................................                                 [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    332      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              865      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7181     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,19 @@
 **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/`.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,151 @@
 ........................................................................ [  1%]
 ........................................................................ [  2%]
 ........................................................................ [  4%]
 ........................................................................ [  5%]
 ........................................................................ [  7%]
 ........................................................................ [  8%]
 ........................................................................ [ 10%]
 ........................................................................ [ 11%]
 ........................................................................ [ 13%]
 ........................................................................ [ 14%]
 ........................................................................ [ 16%]
 ........................................................................ [ 17%]
 ........................................................................ [ 19%]
 ........................................................................ [ 20%]
 ........................................................................ [ 22%]
 ........................................................................ [ 23%]
 ........................................................................ [ 25%]
 ........................................................................ [ 26%]
 ........................................................................ [ 28%]
 ........................................................................ [ 29%]
 ........................................................................ [ 31%]
 ........................................................................ [ 32%]
 ........................................................................ [ 34%]
 ........................................................................ [ 35%]
 ........................................................................ [ 37%]
 ........................................................................ [ 38%]
 ........................................................................ [ 40%]
 ........................................................................ [ 41%]
 ........................................................................ [ 43%]
 ........................................................................ [ 44%]
 ........................................................................ [ 46%]
 ........................................................................ [ 47%]
 ........................................................................ [ 49%]
 ........................................................................ [ 50%]
 ........................................................................ [ 52%]
 ........................................................................ [ 53%]
 ........................................................................ [ 55%]
 ........................................................................ [ 56%]
 ........................................................................ [ 58%]
 ........................................................................ [ 59%]
 ........................................................................ [ 61%]
 ........................................................................ [ 62%]
 ........................................................................ [ 64%]
 ........................................................................ [ 65%]
 ........................................................................ [ 67%]
 ........................................................................ [ 68%]
 ........................................................................ [ 69%]
 ........................................................................ [ 71%]
 ........................................................................ [ 72%]
 ........................................................................ [ 74%]
 ........................................................................ [ 75%]
 ........................................................................ [ 77%]
 ........................................................................ [ 78%]
 ........................................................................ [ 80%]
 ........................................................................ [ 81%]
 ........................................................................ [ 83%]
 ........................................................................ [ 84%]
 ........................................................................ [ 86%]
 ........................................................................ [ 87%]
 ........................................................................ [ 89%]
 ........................................................................ [ 90%]
 ........................................................................ [ 92%]
 ........................................................................ [ 93%]
 ........................................................................ [ 95%]
 ........................................................................ [ 96%]
 ........................................................................ [ 98%]
 ........................................................................ [ 99%]
 ...........                                                              [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  242      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    339      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              906      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7240     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
@@ -0,0 +1,14 @@
 Task 01 is complete and green.
 **Server-side (phase 194 task 01)**
 - `app/config.py` — `sync_pending_count: int = 1` (`BOR_SYNC_PENDING_COUNT`), negative refuses startup naming the field; `app/core/settings_catalog.py` — the `Import & sources` row.
 - `app/rag/importer.py` — new `_pending_hash_stmt` (scalar `SELECT documents.file_hash`, `(source, path)` predicate, no entity/identity-map load) and `_prescan_pending` (per-file `_file_hash` + one scalar read → `{(source, rel): 1-based pending position}`, its own session, `on_scan_progress` per file). `import_sources` gained `on_scan_progress`, reads the switch **once** before the loop, and REPLACES the phase-64 stats pre-walk with ONE `asyncio.to_thread` pre-scan; `progress` now reports the pending position (holds across unchanged files), `0` runs the byte-identical phase-193 walk-position branch, `progress=None` pays nothing. `summary.files`, `seen`, prune, date refresh, log lines untouched.
 - Docs: `.env.example`, `README.md` (label semantics + a phase-194 bounds bullet + the settings table), `AGENTS.md` (new rule 18).
 **Tests**
 - New: `tests/unit/test_sync_pending_count.py` (13 — gate both ways, read-once + `to_thread` markers, exactly-`file_hash` projection, 4 predicate states + ignore parity, unreadable arm, scan-hook per root/empty/worker-thread, `done` position, CLI byte-identity) and `tests/integration/test_sync_pending_count.py` (7 — fresh/unchanged/incremental parity `total == added+updated`, 2-file count-down, one-column + `identity_map == 0`, off-loop heartbeat + thread identity, cancel-at-the-await).
 - Retargeted the two phase-64/129 pair pins in `tests/unit/test_importer.py`; extended `test_config.py` / `test_settings_catalog.py`.
 **Gates**: `ruff check .` clean · `pyright` 0 errors · `pytest --cov=app` **exit 0**, app coverage **99 %** (importer 99 %) · 20 sync/progress E2E suites + smoke green.
 **Deferred by design**: the `scan` status phase / `Scanning…` label (tasks 02–03), the phase's E2E file (task 05). Task 04's pinned suites needed **no** retargeting — they run fresh-import fixtures where the walk *is* the work. Nothing committed (per instructions), no task files touched.
@@ -0,0 +1 @@
 ok
@@ -0,0 +1,150 @@
 ........................................................................ [  1%]
 ........................................................................ [  2%]
 ........................................................................ [  4%]
 ........................................................................ [  5%]
 ........................................................................ [  7%]
 ........................................................................ [  8%]
 ........................................................................ [ 10%]
 ........................................................................ [ 11%]
 ........................................................................ [ 13%]
 ........................................................................ [ 14%]
 ........................................................................ [ 16%]
 ........................................................................ [ 17%]
 ........................................................................ [ 19%]
 ........................................................................ [ 20%]
 ........................................................................ [ 22%]
 ........................................................................ [ 23%]
 ........................................................................ [ 25%]
 ........................................................................ [ 26%]
 ........................................................................ [ 28%]
 ........................................................................ [ 29%]
 ........................................................................ [ 31%]
 ........................................................................ [ 32%]
 ........................................................................ [ 34%]
 ........................................................................ [ 35%]
 ........................................................................ [ 37%]
 ........................................................................ [ 38%]
 ........................................................................ [ 40%]
 ........................................................................ [ 41%]
 ........................................................................ [ 43%]
 ........................................................................ [ 44%]
 ........................................................................ [ 46%]
 ........................................................................ [ 47%]
 ........................................................................ [ 49%]
 ........................................................................ [ 50%]
 ........................................................................ [ 52%]
 ........................................................................ [ 53%]
 ........................................................................ [ 55%]
 ........................................................................ [ 56%]
 ........................................................................ [ 58%]
 ........................................................................ [ 59%]
 ........................................................................ [ 61%]
 ........................................................................ [ 62%]
 ........................................................................ [ 64%]
 ........................................................................ [ 65%]
 ........................................................................ [ 67%]
 ........................................................................ [ 68%]
 ........................................................................ [ 70%]
 ........................................................................ [ 71%]
 ........................................................................ [ 73%]
 ........................................................................ [ 74%]
 ........................................................................ [ 76%]
 ........................................................................ [ 77%]
 ........................................................................ [ 79%]
 ........................................................................ [ 80%]
 ........................................................................ [ 82%]
 ........................................................................ [ 83%]
 ........................................................................ [ 85%]
 ........................................................................ [ 86%]
 ........................................................................ [ 88%]
 ........................................................................ [ 89%]
 ........................................................................ [ 91%]
 ........................................................................ [ 92%]
 ........................................................................ [ 94%]
 ........................................................................ [ 95%]
 ........................................................................ [ 97%]
 ........................................................................ [ 98%]
 ...............................................................          [100%]
 =============================== warnings summary ===============================
 .venv/lib/python3.13/site-packages/fastapi/testclient.py:1
  /var/home/ducoterra/Projects/Personal/brain_of_reese/.venv/lib/python3.13/site-packages/fastapi/testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa
 -- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
 ================================ tests coverage ================================
 _______________ coverage: platform linux, python 3.13.13-final-0 _______________
 Name                           Stmts   Miss  Cover
 --------------------------------------------------
 app/__init__.py                    1      0   100%
 app/api/__init__.py                0      0   100%
 app/api/admin_settings.py        114      0   100%
 app/api/auth.py                   52      0   100%
 app/api/chat.py                  301      1    99%
 app/api/chat_images.py            52      0   100%
 app/api/chats.py                 111      0   100%
 app/api/config.py                 13      0   100%
 app/api/doc_drafts.py             99      0   100%
 app/api/docs.py                  239      1    99%
 app/api/git_sources.py           259      0   100%
 app/api/health.py                 10      0   100%
 app/api/source_labels.py          52      0   100%
 app/api/steering.py               42      0   100%
 app/api/suggestions.py            33      0   100%
 app/api/sync.py                  231      0   100%
 app/api/tokens.py                 40      0   100%
 app/api/ui_settings.py            39      0   100%
 app/config.py                    339      0   100%
 app/core/__init__.py               0      0   100%
 app/core/auth.py                  45      0   100%
 app/core/caching.py              124      0   100%
 app/core/compression.py           59      0   100%
 app/core/debugging.py             29      2    93%
 app/core/docs_push.py             43      0   100%
 app/core/errors.py                 5      0   100%
 app/core/http_cache.py            22      0   100%
 app/core/logging.py               13      0   100%
 app/core/memory.py                32      0   100%
 app/core/rate_limit.py            44      0   100%
 app/core/response_budget.py       63      0   100%
 app/core/security_headers.py      20      0   100%
 app/core/settings_catalog.py      18      0   100%
 app/core/settings_migrate.py      32      0   100%
 app/core/settings_overlay.py     117      0   100%
 app/core/theming.py               45      0   100%
 app/core/tokens.py                44      0   100%
 app/db.py                         22      0   100%
 app/main.py                      107      0   100%
 app/models.py                    148      0   100%
 app/rag/__init__.py                0      0   100%
 app/rag/agent.py                 501      1    99%
 app/rag/archive_upload.py        134      0   100%
 app/rag/chunker.py               220      4    98%
 app/rag/doc_dates.py              18      0   100%
 app/rag/folder_summaries.py      134      0   100%
 app/rag/git_sources.py            77      0   100%
 app/rag/importer.py              906      3    99%
 app/rag/llm.py                   253      1    99%
 app/rag/md_images.py              63      0   100%
 app/rag/overview.py               82      0   100%
 app/rag/pdf.py                   192      0   100%
 app/rag/prompts.py               178      0   100%
 app/rag/retriever.py             270      3    99%
 app/rag/scaffolding.py            55      0   100%
 app/rag/source_labels.py          87      0   100%
 app/rag/source_removal.py         41      0   100%
 app/rag/sources_meta.py           16      0   100%
 app/rag/suggestions.py            27      0   100%
 app/rag/summarizer.py             58      0   100%
 app/rag/svg_text.py              111      0   100%
 app/rag/verbatim.py              160      0   100%
 app/schemas.py                   587      0   100%
 --------------------------------------------------
 TOTAL                           7229     16    99%
 coverage gate: app/ 99% (>90%) OK
 All checks passed!
 0 errors, 0 warnings, 0 informations
 WARNING: there is a new pyright version available (v1.1.411 -> v1.1.414).
 Please install the new version or set PYRIGHT_PYTHON_FORCE_VERSION to `latest`
 validation OK
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
ducoterra	a45f744604	phase: 194_sync_pending_count Build and Push Containers / build-and-push-app (push) Successful in 2m5s Details Build and Push Containers / build-and-push-db (push) Successful in 13s Details 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/`.	2026-10-20 06:36:21 -04:00
ducoterra	ae080ac7f3	phase: 193_sync_remaining_count Build and Push Containers / build-and-push-app (push) Successful in 2m3s Details Build and Push Containers / build-and-push-db (push) Successful in 16s Details 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/`.	2026-10-19 17:30:03 -04:00
ducoterra	fb17d15fbe	phase: 192_verbatim_inline_midturn Build and Push Containers / build-and-push-app (push) Successful in 1m56s Details Build and Push Containers / build-and-push-db (push) Successful in 14s Details Phase 192 — final verification pass complete. - Verified (all 4 tasks already complete): additive `verbatim_block` SSE frame (`VerbatimBlockPiece` → `ChatVerbatimBlockEvent` → chat dispatch, after the round's `tool`/`tool_result`, before the next round); `hydrateVerbatimNow` matched-only mid-turn pass + app.js branch; `dropPlacedTwin` per-locator done/restore dedupe; the dedicated E2E suite. - Root cause of the rejected attempt: my own concurrent background `pytest` run deadlocked the harness validation run on the shared Postgres (`psycopg.errors.DeadlockDetected`). No code defect — re-ran every gate exclusively. - `uv run pytest -q --cov=app --cov-report=term-missing` → exit 0, `TOTAL 7181 16 99%` (>90%) - `uv run pytest tests/e2e/test_verbatim_inline_midturn.py --no-cov` → 6 passed (isolated) - `uv run pytest tests/e2e/test_verbatim_show_text.py tests/e2e/test_chat_history.py --no-cov` → 18 passed (`test_chat_history.py` byte-unedited; the phase-182 suite's "no eighth type" pin was tightened, not loosened, to seven + `verbatim_block` with frame-order asserts) - `uv run ruff check .` → All checks passed (exit 0) · `uv run pyright` → 0 errors - Completion criteria: single frame per success + zero per refusal ✅ · `BOR_ANSWER_TEXT=0` wire byte-identical (integration spelled baseline + E2E App B) ✅ · fence hydrates in place / unfenced lands at the call moment, before `done` ✅ · append+fence → 1 panel, two ranges → 2 panels ✅ · restore 1 panel/locator, `done.answer_text` + record key + `verbatim_blocks=N` unchanged ✅ · suite green, coverage 99%, lint/types clean ✅ · no-show_text turn byte-identical ✅ · commit → left to the harness (no git index/history commands run). - Docs: README reviewed line-by-line (2399 lines) + AGENTS.md in full; mechanically verified all 86 `BOR_` settings, every `.env.example` var, table defaults, internal anchors (0 broken), ports 8123/8901, tree depth 1–8, pagination 25/1–100, 17 palette colors, `0029`/`0030` migrations, and every cited test file. Fixed 1 inconsistency: the verbatim "Parity" bullet claimed the live turn/reload/shared page share "the same three globals" — now names the settle-path trio and states that `hydrateVerbatimNow` is the ONE chat-only addition (a shared page has no stream). - Notable:* `run_agent`'s four repeated piece unions were collapsed into the ONE exported `AgentPiece` alias, so a future piece type is spelled in one place; `test_frontend_edit_message.py`'s `runTurn` byte-pin was regenerated, not weakened. - Next pending phase: `193_sync_remaining_count`.	2026-10-19 12:19:51 -04:00
ducoterra	4f20c256d7	phase: 191_source_name_labels_tags Build and Push Containers / build-and-push-app (push) Successful in 7m24s Details Build and Push Containers / build-and-push-db (push) Successful in 36s Details All gates re-verified against a stable tree. Report: Verified (all 6 tasks in `complete/`; this was the final pass) - `SourceLabel`+alembic `0030` (dev DB `alembic current` = `0030 (head)`, table present, 0 rows); admin-only `GET/PUT/DELETE /api/source-labels` (`require_admin` router-wide, `resolve_source_name`, partial-update caps/404s); Sources-page "Names, labels and tags" card (read-only derived-name `<code>`, per-row `saveInFlight`, 404 note that survives the settle, chips reuse `.git-source-hidden-count`); `question_name_hits` D2 rule; ONE `all_labels` read per turn in `chat.py` feeding both the `source_name_hit` flag and the prompt surfaces; `source_name_hit_bonus=0.005` in `_selection_order`; ` name=`/` label=` in `build_high_prompt` + `build_overview_prompt(names=…)`. - Completion criteria: E2E `tests/e2e/test_source_name_labels.py` ✅ 7 passed (arms a–e: editor all kinds, control/named question, rename-never-breaks-identity, 404 note, reset) · full suite ✅ · coverage ✅ · README/AGENTS ✅ · phase dir in `complete/` ✅ · commit left to the harness. - Gates: `uv run pytest --cov=app --cov-report=term-missing` → exit 0, TOTAL 7160 stmts / 16 missed = 99% (>90%) · `uv run pytest tests/e2e/test_source_name_labels.py -v --no-cov` → 7 passed, exit 0 · regression E2E isolated, exit 0: `test_document_viewer`, `test_admin_auth`, `test_api_tokens`, `test_git_sources_admin`, `test_kb_tree`, `test_local_directory_sources` · `uv run ruff check .` → All checks passed · `uv run pyright` → 0 errors. - Battery (task 04 criterion): `uv run python -m scripts.eval_retrieval --from-file tests/fixtures/retrieval_battery.txt` at default vs `BOR_SOURCE_NAME_HIT_BONUS=0` → `diff` empty (line-for-line identical), matching the recorded arms (dev KB is empty, so every question deflects; the observable boost is unit/E2E-pinned). - Documentation: README — fixed the `/git-sources.html` rows (nav label is Sources) and cross-linked the phase-191 card from that section; full audit otherwise clean: all 86 `BOR_` settings documented with defaults matching `app/config.py`, 0 broken file/dir references and 0 broken anchors in README+AGENTS, AGENTS rule 17 re-checked line-by-line against the code. - Notable / deviations:* (1) a concurrent pipeline process (`phased-execution/progress.mjs` for `191_…_00_phase`) was mutating this same working tree mid-pass — it rewrote `tests/e2e/test_source_name_labels.py` (11→7 tests), `frontend/assets/git-sources.js`, `tests/unit/test_source_labels_editor_ui.py` and `AGENTS.md` at 05:27; every gate above was (re-)run after those edits with the tree no source file newer than the green full run. (2) The task-06 report/phase text claims regression suites `test_chat_token_gate.py`, `test_git_sources_page.py`, `test_rag_browser.py` are green — those files have never existed in git history (those runs exit 4); I ran the real equivalents listed above instead (phase files are not mine to edit). (3) No live changes: the VM DB already has `source_labels` (0 rows) but the deployed app predates this uncommitted code, so deploying `/api/source-labels` to the live service is the owner's post-commit step, not part of this phase's criteria. - Next pending phase: none — `191_source_name_labels_tags` is the only entry in `.agents/phases/todo/`.	2026-10-19 06:13:32 -04:00
		`@@ -0,0 +1 @@`
							`All 4 tasks are complete. This is the final verification pass. Let me review the reports and completions.`