phase: 160_tool_budget_telemetry

All green. Final report:

**Phase 160 completion pass — verified (final verification; all 5 tasks already in `complete/`)**

- **Verified, no code defects found:** budget trailers (`TOOL_BUDGET_REMAINING/LAST/SPENT`), cap-path rejection + `ROUND_CAP_FALLBACK_ANSWER` + `ROUND_CAP_WRAPUP_INSTRUCTION`, `done.budget_exhausted` (ABSENT-when-false), `rounds=/cap_hit=` log fields, `agent_max_rounds=10` default, frontend Continue button + restore + shared-page exclusion, mock markers.
- **Tests/lint:** `uv run pytest` 153/153 green (EXIT 0); `uv run pytest --cov=app --cov-report=term-missing` TOTAL **99%** (>90%); `uv run ruff check .` clean; `uv run pyright` 0 errors/0 warnings.
- **Criteria:** ① decreasing trailer pinned by unit tests (9→…→spent) ✅ ② cap path ends readable, no tool lines after cap (E2E) ✅ ③ `budget_exhausted` true-only-on-cap, absent otherwise (integration) ✅ ④ Continue button → one fresh `continue` turn, fresh budget, record intact (E2E) ✅ ⑤ flag survives refresh; shared chat never renders it (`shared.js` has no `budget_exhausted` path) ✅ ⑥ `max_rounds=0` byte-identical single `tools=None` request; default still 10 ✅ ⑦ full suite/coverage/lint green ✅ ⑧ `test_tool_budget_telemetry.py` **7/7** in isolation; all 6 regression E2E suites green in isolation ✅ ⑨ commit + phase move = harness (I make no git history/index changes).
- **Docs:** README.md — fixed: the "Continue researching" button and cap behavior were undocumented (added a Chat-section paragraph + an Agent-tools-section paragraph, incl. the phase-71 recorded-revision note); env-var table, commands, and architecture all verified consistent otherwise. AGENTS.md — verified consistent, no changes needed.
- **Decisions:** no code changes required — phase was fully implemented; only README docs added. No live-infrastructure touched.
- **Next pending phase:** `161_reasoning_bubble`.

tests/unit/test_prompts_dates.py

@@ -259,7 +259,9 @@ def test_read_result_plain_carries_date_second_line(
     )
     asyncio.run(_run(llm, holder, _settings()))
     assert holder.read_docs == [doc] and holder.tool_calls == 1
-    content = llm.requests[1][0][3]["content"]
+    # Phase 160 (task 01): the budget-telemetry trailer rides the read
+    # result — the raw result is the RAW part (the trailer stripped).
+    content = llm.requests[1][0][3]["content"].removesuffix(agent._budget_note(9))
     lines = content.splitlines()
     assert lines[0] == "Document S/a.md:"  # byte-identical first line
     assert lines[1] == f"date: {DATE}"  # the D5 second line
@@ -291,7 +293,9 @@ def test_read_result_truncated_carries_date_then_marker_and_notice(
         + "\n"
         + READ_TRUNCATION_NOTICE.format(shown=cap, total=len(content_body))
     )
-    assert llm.requests[1][0][3]["content"] == expected
+    # Phase 160 (task 01): the trailer rides the truncated result too —
+    # the truncation contract (phase 95) is the RAW part.
+    assert llm.requests[1][0][3]["content"].startswith(expected)
     # The truncation still records on the holder (the ToolResultPiece
     # signal) — the date line adds nothing to the counters.
     assert holder.read_truncations == [("S/big.md", cap, len(content_body))]