[indykish]

Summary

Bring the preserved companion docs into line with merged agentsfleet PR #784. Explain conversation summaries, model limits, confirmed spending and report timing in plain language. Add the four newly served API operations to navigation.

Both saved stashes contained the same final files; this branch consolidates them once. Already merged login fixes remain in the base.

Test Coverage

No executable paths changed; coverage percentages are not applicable. No tests were added.

Guides → Conversation context / Fleet budgets
Changelog → context guide / spending section
API reference → billing reports / runner checkpoints

The existing documentation validator ran 25 tests successfully. Tests ran: docs-verify count unavailable in the receipt; the captured runner output reports 25.

Pre-Landing Review

Parent and native adversarial reviews completed. Fixed the missing required activity_type query parameter and explained matching report filters, cutoff and pagination. The final pass found no remaining issues.

Gate edits: none detected (0 listed, 0 read; patterns: RH-1,RH-3,RH-4,RH-12,RH-13,RH-14,RH-15,RH-16; unlisted idioms: none).

Outside review: disabled by the existing setting; no external-model coverage claimed.

Exploratory QA

Not applicable to this prose and API-navigation change. Build, link and public OpenAPI checks passed; these checks do not prove live product behavior.

Design Review

No frontend code changed; design review skipped.

Eval Results

No model prompts changed; evals skipped.

Greptile Review

Greptile's completed app check for 6742d51 reports 4 files reviewed, 0 comments added. No formal GitHub review object was posted. All pages of reviews, line comments, summaries and threads were checked twice after completion, with no findings or unresolved threads.

Scope Drift

Scope Check: CLEAN. Four documentation/navigation files only.

Plan Completion

Plan completion audit: not run (no plan is bound to this branch and no docs/designs/ file matches). Fix: add "Plan: " to the PR body, or run /autoplan.

Verification Results

Canonical orly gate verify: passed. All 25 tests, documentation language checks, public-main API comparison, Mintlify build and link checks passed. Mintlify emitted a YAML categorization warning while reporting successful build and link results.

Session notes

No product implementation or CI configuration changed. Existing runtime limits, summary limitations, private setup labels and historical billing constraints are retained. No version source exists in this docs repository.

Babysit result: lint, Gitleaks and Greptile passed on 6742d51; Mintlify PR deployment was skipped. Two consecutive complete polls found no new feedback or unresolved threads. No review fixes or rule changes were needed after publication. Merge and local cleanup are authorized by the owner.

Documentation

Status: current. The required billing API correction is resolved; no further documentation corrections remain in this candidate. This read-only audit changed no files.

Audited four selected working-tree changes against base d12ed662ddeecc18a954f2a91b7cd2a0288e2d60. Re-read the repaired billing page in full and reused unchanged related-documentation and product-source checks from attempt1. Startup directly echoed SESSION_KIND: spawned. Branch, HEAD, index and all four selected content hashes match candidate2.

Documentation health:

• billing/budgets.mdx — Current: explicitly requires activity_type=runtime|setup, preserves report filters and cutoff, and explains pagination.
• concepts/context-lifecycle.mdx — Current: compaction behavior, defaults, preservation, billing and visible status text match merged product source.
• changelog.mdx — Current: the new entry matches the shipped changes; history remains preserved.
• docs.json — Current: all four added operations exist in product OpenAPI.
• README.md, CONTRIBUTING.md, AGENTS.md and relevant related pages — Current for this release; unchanged audit evidence reused.
• ARCHITECTURE.md, CHANGELOG.md, TODOS.md — Skipped: absent; the site uses changelog.mdx.

Coverage:

Changed surface	Reference	How-to	Tutorial	Explanation
Conversation compaction	Runtime option table	Existing setup/run guides	No dedicated tutorial	Context lifecycle page
Billing reports and activity charges	Generated OpenAPI and corrected budgets page	Spending review and API guidance	No dedicated tutorial	Settlement, filters and report timing
Runner checkpoint GET/PUT	Generated OpenAPI navigation	None	None	User-visible context lifecycle

Coverage debt: runner checkpoint operations retain reference-only coverage, a common gap. No zero-coverage surface was found. All 33 non-fragment site pages remain navigable through docs.json; two reusable snippets were inventoried separately. No relevant authored templates were found.

Diagram drift: none found in the published documentation.

Completed validation evidence: /private/tmp/docs-context-billing-verify-2.log records 25 passing tests, clean documentation and public-main API checks, successful Mintlify build and link checks, and final docs-verify exit=0. The log includes a Mintlify YAML categorization warning alongside successful results. Verification was run by the parent and inspected by this child.

Test plan

• mise exec bun@1.4.3 -- bun run orly gate verify: 25 tests; documentation, API comparison, build and links passed.
• git diff --check: passed.
• Gitleaks staged scan: no leaks found.

Generated with OpenAI Codex.