gsxdsm 6bd8004ba1 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>

2026-08-09 15:58:54 -07:00

..

__tests__

FN-8898: document inert prerebase settings

2026-08-09 06:01:02 -07:00

lib

FN-8898: document inert prerebase settings

2026-08-09 06:01:02 -07:00

assert-engine-slow-nonempty.mjs

test: close dashboard curated-gate and engine-slow coverage holes; add inventory harness

2026-06-03 17:36:35 -07:00

audit-branch-cross-contamination.mjs

fix(scripts): the contamination audit scanned four legacy lanes and claimed it had (#3005)

2026-07-31 00:27:41 -07:00

audit-squash-merge.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

audit-squash-merge.mjs

feat(FN-4067): add squash audit gate to merger with integration tests

2026-05-12 07:47:11 -07:00

audit-task-id-collisions.mjs

feat: migrate storage from SQLite to PostgreSQL (#1793)

2026-07-13 19:07:58 -07:00

backfill-fn-4441-transition-evidence.mjs

fix(FN-7952): require PostgreSQL in CLI and desktop (#2110)

2026-07-14 23:18:55 -07:00

boot-smoke.mjs

fix(core): Windows embedded Postgres — no local user account, UTF-8 clusters, diagnosable boot errors

2026-07-17 22:45:57 -07:00

build-engine-core-gate-bundle.mjs

FN-7669: pre-bundle @fusion/core gate-safe barrel to cut engine-core gate import-phase cost

2026-07-08 04:24:30 -07:00

build-workspace.mjs

perf: speed up local pnpm build and cap stacked verifications (#2134)

2026-07-15 08:44:11 -07:00

cache-stats.mjs

fix(FN-7952): require PostgreSQL in CLI and desktop (#2110)

2026-07-14 23:18:55 -07:00

check-capacity-pool-id.mjs

fix(core): bind the in-transaction capacity gate — one shared pool-id convention (NOT user-visible yet — see R2) (#2488)

2026-07-27 21:09:51 -07:00

check-changeset-format.mjs

feat(changelog): U2 — changeset format linter + CI wiring

2026-06-23 23:30:32 -07:00

check-file-line-count.mjs

FN-7050: repair route and executor line ceilings

2026-06-25 23:34:08 -07:00

check-fn-8864-ancestry.sh

FN-8915: document agent activity API contract

2026-08-09 15:58:54 -07:00

check-fnxc-future-dates.mjs

FN-8640: add FNXC stamp anomaly advisory

2026-07-31 19:03:08 -07:00

check-inert-flag-seams.mjs

FN-8770: consolidate task display sorting

2026-08-03 16:15:12 -07:00

check-inert-sync-lane-conversions.mjs

FN-8656: resolve scheduler lanes for renamed holds

2026-07-31 22:19:32 -07:00

check-lane-wiring.mjs

fix(gate): the FNXC stamp gate never validated the hour, so 25:30 passed (#2995)

2026-07-31 00:03:02 -07:00

check-mock-completeness.mjs

fix: dashboard lucide/CSS/SettingsModal/mcp-helper fixes + expand mock-completeness guard to dashboard (round 11) (#2049)

2026-07-13 07:10:14 -07:00

check-move-target-literals.mjs

FN-8657: extract move-target literal counter

2026-07-31 21:34:25 -07:00

check-no-cwd-relative-dashboard-test-reads.mjs

FN-8585: fix dashboard composer test source reads

2026-07-25 06:22:23 -07:00

check-no-getdatabase.mjs

FN-8103: enforce PostgreSQL-only production data access

2026-07-16 10:13:49 -07:00

check-no-kill-4040.mjs

test: guard tests from killing the live dashboard port

2026-05-23 19:51:36 -07:00

check-no-node-only-core-imports-in-dashboard.mjs

FN-8368: enforce browser-safe dashboard core imports

2026-07-19 14:08:51 -07:00

check-no-nohup.mjs

Harden PostgreSQL migration foundation (#2088)

2026-07-14 08:16:42 -07:00

check-no-test-timeout-appeasement.mjs

FN-6434: block Vitest timeout appeasement

2026-06-14 15:29:35 -07:00

check-pi-versions-pinned.mjs

fix(desktop): pin complete Pi runtime closure (#2439)

2026-07-26 07:34:50 -07:00

check-plugin-interop-drift.mjs

gate: compare mirrored INTERFACES too, and delete the dead prop that found (#3034)

2026-07-31 01:43:58 -07:00

check-prerebase-inert.mjs

FN-8898: document inert prerebase settings

2026-08-09 06:01:02 -07:00

check-quarantine-ledger.mjs

FN-7912: add quarantine-ledger deadline visibility check

2026-07-12 21:21:10 -07:00

check-routes-modular.mjs

FN-8365: enforce dashboard route registrar mount order

2026-07-19 15:53:07 -07:00

check-sql-column-literals.mjs

fix(gate): the SQL-literal check WROTE to the tree it was checking — last of three (#3292)

2026-07-31 18:52:12 -07:00

check-test-inventory.mjs

FN-6445: reject quality skip-list overlaps

2026-06-14 15:29:35 -07:00

check-test-isolation.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

check-test-isolation.mjs

test: quarantine slow and flaky test lanes

2026-06-13 19:22:00 -07:00

ci-distill-release-notes.mjs

fix(i18n): restore Chinese roadmap duplicate labels (#2358)

2026-07-20 00:18:53 -07:00

ci-test-shard.mjs

FN-8559: refresh test timing snapshots

2026-07-24 06:21:53 -07:00

dev-hmr.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

dev-hmr.mjs

feat: restart the development engine on source changes (#3329)

2026-08-04 08:57:30 -07:00

dev-prebuild-client.mjs

fix(FN-7779): rebuild changed plugins on pnpm dev + warn on stale plugin dist

2026-07-10 13:26:23 -07:00

dev-with-memory-lib.mjs

feat: restart the development engine on source changes (#3329)

2026-08-04 08:57:30 -07:00

dev-with-memory.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

dev-with-memory.mjs

feat: restart the development engine on source changes (#3329)

2026-08-04 08:57:30 -07:00

ensure-test-artifacts.mjs

Build Compound Engineering plugin dist before its tests

2026-06-19 20:47:32 -07:00

ios-acceptance.mjs

FN-6667: add real iOS Safari acceptance harness

2026-06-18 16:47:09 -07:00

lifecycle-column-census.mjs

FN-8721: reconcile census, delegation routing, and archive repair

2026-08-01 16:57:49 -07:00

line-count-baseline.json

refactor: package code organization wave 15 (#2394)

2026-07-23 00:01:24 -07:00

mobile-run-android.sh

fix(mobile): resolve Android status-bar overlap via safe-area plugin

2026-06-16 18:03:41 -07:00

reconcile-fn-3909-identity.mjs

fix(FN-7952): require PostgreSQL in CLI and desktop (#2110)

2026-07-14 23:18:55 -07:00

reconcile-leaked-soft-deletes.mjs

fix(scripts): the soft-delete reconciler wrote a literal archived into boards that do not have one (#2999)

2026-07-30 23:59:54 -07:00

reconcile-task-state-consistency.mjs

fix(scripts): four FNXC stamps carried hour 26, and main has been red on them (#3010)

2026-07-31 00:36:21 -07:00

recover-stale-blocked-by.mjs

fix(gate): the FNXC stamp gate never validated the hour, so 25:30 passed (#2995)

2026-07-31 00:03:02 -07:00

reimport-tasks.mjs

feat: migrate storage from SQLite to PostgreSQL (#1793)

2026-07-13 19:07:58 -07:00

release.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

release.mjs

fix: restore plugin SDK and Todo packaging

2026-08-03 12:16:32 -07:00

restore-merge-sha-fn-3878.mjs

fix(FN-7952): require PostgreSQL in CLI and desktop (#2110)

2026-07-14 23:18:55 -07:00

run-ci-distill.mjs

feat(changelog): U5 — CI workflow distillation integration

2026-06-24 19:25:44 -07:00

run-script-tests.mjs

fix(FN-5048): address PR feedback on test verification

2026-06-21 10:53:08 -07:00

run-static-gate-checks.mjs

FN-8783: parallelize static merge-gate validators

2026-08-04 09:21:07 -07:00

sign-linux.sh

feat(FN-5605): add linux gpg signing for release artifacts

2026-05-27 21:31:12 -07:00

sign-macos.sh

feat(KB-142): fix CLI native module packaging with lazy loading

2026-03-30 23:56:01 -07:00

sign-windows.ps1

feat(HAI-080): add code signing for macOS and Windows release binaries

2026-03-26 01:03:16 -04:00

spotlight-exclude-fusion-paths.sh

perf: speed up local pnpm build and cap stacked verifications (#2134)

2026-07-15 08:44:11 -07:00

start-local.mjs

fix(FN-7952): require PostgreSQL in CLI and desktop (#2110)

2026-07-14 23:18:55 -07:00

sync-fusion-skill-tools.cmd

feat(FN-2690): add Windows cmd wrappers for script entrypoints

2026-04-27 08:21:48 -07:00

sync-fusion-skill-tools.mjs

FN-7274: document workflow tools in Fusion skill

2026-06-30 08:04:12 -07:00

sync-workspace-version.mjs

fix(FN-XXX): sync workspace version on release

2026-04-29 08:15:38 -07:00

test-changed.mjs

fix: isolate test-mode database access

2026-07-19 00:10:02 -07:00

test-feedback-baseline.mjs

FN-7463: refresh test feedback baseline docs

2026-07-03 07:47:03 -07:00

test-timings.json

fix(ci): prune six phantom paths from the shard-timing snapshot, red on main since their features died (#3040)

2026-07-31 02:05:51 -07:00

test-value-audit.mjs

chore: add test value audit (deletion-candidate evidence base)

2026-06-25 17:04:30 -07:00

test-velocity-baseline.mjs

FN-8559: refresh test timing snapshots

2026-07-24 06:21:53 -07:00

test-velocity-history.json

FN-8772: refresh W32 test-velocity baseline

2026-08-03 20:18:28 -07:00

test-with-lock.mjs

feat(FN-3234): refactor test-changed script and add workflow tests

2026-05-03 05:47:11 -07:00

verify-desktop-linux-pg-packaging.mjs

fix(desktop): assert Linux AppImage embeds Postgres packaging (#2131)

2026-07-15 14:41:05 -07:00

verify-fast.mjs

FN-8506: run static checks in verify:fast

2026-07-22 18:26:33 -07:00

verify-windows-elevated-restricted.mjs

fix(core): Windows embedded Postgres — no local user account, UTF-8 clusters, diagnosable boot errors

2026-07-17 22:45:57 -07:00

verify-windows-encoding-recovery.mjs

fix(core): auto-repair empty non-UTF-8 embedded Postgres clusters on boot (#2286)

2026-07-17 23:18:40 -07:00

workflow-reliability-release-check.mjs

FN-6694: add workflow reliability release-check harness

2026-06-19 05:13:39 -07:00