phase: 175_history_pagination

All criteria verified. This pass found no defects — the phase was fully implemented by prior task runs, and every gate is green.

**Phase 175 final verification pass — report**

- Verified tasks 01–03 implementation in-tree: `list_chats` `?limit=` (25, 1–100) / `?offset=` + `func.count` `total`; `SavedChatList.total` required; `#history-pager` below `#history-table-wrap` (hidden default, aria-labels, aria-hidden SVGs); `history.js` `PAGE_SIZE=25`/offset state, parameterized fetch, `updatePager`, refresh-keeps-current-page; CSS pill union + ≤640px block. No code changes were needed.
- Full suite: `uv run pytest --cov=app --cov-report=term-missing` → **exit 0, TOTAL 99%** (>90% gate).
- `uv run ruff check .` → all checks passed; `uv run pyright` → 0 errors, 0 warnings.
- Phase E2E in isolation: `uv run pytest tests/e2e/test_history_pagination.py -v --no-cov` → **9 passed** (page 1-of-2 / 2-of-2 walk, replace-not-append, refresh-on-page-2, delete-to-empty + single-page hide, anonymous no-fetch, 375px mobile, a11y/no-CDN).
- Regression set, each in isolation: test_chat_history 5✓, test_history_page_width 5✓, test_share_chat 4✓, test_stale_saved_chats 3✓, test_history_copy 1✓; integration `test_chats_api.py` green (incl. updated `test_list_empty` two-key pin and all five new pagination pins).
- Completion criteria: all nine boxes satisfied (API slice/422/honest-total pins ✓; E2E walk + status lines ✓; refresh/delete/hide ✓; anonymous gate ✓; mobile ✓; gates ✓; E2E + regression ✓; docs ✓; commit/phase-move is the harness's).
- Documentation: README.md reviewed in full — the saved-chats section already carries the `?limit=`/`?offset=`/`total` contract from this phase; all 31 `.env.example` vars documented; AGENTS.md verified accurate. **Consistent — no changes needed.**
- Deviations: none. No defects found in previously completed work.
- Next pending phase: none — 175 is the only entry in `todo/`.

tests/unit/test_history_page.py

@@ -325,14 +325,17 @@ def test_anonymous_boot_makes_no_chats_request() -> None:
     zero extra), hides the table, shows the gate, and RETURNS — no
     ``/api/chats`` request on the wire (the router 403s anonymous; the
     story E2E pins the request log). Only the admin path reaches
-    ``loadChats()``. The single ``fetch("/api/chats")`` in the file
-    lives in loadChats."""
+    ``loadChats(pageOffset)``. The single list fetch in the file —
+    phase 175's parameterized form (``fetch("/api/chats?limit=" +
+    PAGE_SIZE + "&offset=" + pageOffset)``) — lives in loadChats."""
     js = _js()
-    assert js.count('fetch("/api/chats")') == 1, (
+    assert js.count('fetch("/api/chats?limit="') == 1, (
         "exactly ONE list fetch — the anonymous path must never add one"
     )
     load = _fn(js, "loadChats")
-    assert 'fetch("/api/chats")' in load, "the list fetch lives in loadChats"
+    assert (
+        'fetch("/api/chats?limit=" + PAGE_SIZE + "&offset=" + pageOffset)' in load
+    ), "the parameterized list fetch lives in loadChats (phase 175)"
 
     # Phase 76 (task 03): the view module never boots the shell's
     # header — no CALL to the header boot (a docstring may name it;
@@ -359,10 +362,11 @@ def test_anonymous_boot_makes_no_chats_request() -> None:
     assert "fetch(" not in branch, "the anonymous branch must not fetch anything"
     assert "tableWrap.hidden = true" in branch
     assert "gateEl.hidden = false" in branch
-    # The admin path: the gate hides, then the list loads.
+    # The admin path: the gate hides, then the list loads on page 1
+    # (phase 175: the view opens on page 1 — offset 0).
     after = js[js.find("return;", gate_i):]
     assert "gateEl.hidden = true" in after
-    assert "loadChats();" in after
+    assert "loadChats(0);" in after
 
 
 def test_admin_load_renders_rows_or_empty_state() -> None: