FN-8915: document agent activity API contract
Publish an inspectable contract for durable agent-activity history and pagination.
- Define the route wire shape, cursor semantics, retention, and SSE recovery behavior.
- Add PostgreSQL and dashboard coverage for documented pagination and truncation guarantees.
- Link architecture and diagnostics guidance to the canonical contract and validate its prerequisite lineage.
Files changed:
.changeset/fn-8864-agent-activity-events.md | 2 +-
AGENTS.md | 1 +
docs/agent-activity-contract.md | 94 ++++++++++++++++++++++
docs/architecture.md | 2 +-
docs/diagnostics.md | 2 +-
.../agent-activity-cursor-contract.pg.test.ts | 90 +++++++++++++++++++++
.../src/__tests__/agent-activity-route.test.ts | 10 +++
.../src/__tests__/sse-agent-activity.test.ts | 12 ++-
scripts/check-fn-8864-ancestry.sh | 35 ++++++++
9 files changed, 244 insertions(+), 4 deletions(-)
Fusion-Task-Id: FN-8915
Fusion-Task-Lineage: da3f8c96-3b58-4e6d-a413-c51bdd643f26
Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>
6bd8004ba1