gsxdsm 71e2aec5b7 FN-5663: add goal-citation audit trail to agent reasoning ...

Record goal citation evidence so agent reasoning can be traced end-to-end.

- add core goal citation types, extraction helper, persistence schema, and store APIs for citation create/list workflows
- add CLI support and tests for goal citation flows, including command wiring and regression coverage
- update docs and add a published changeset for @runfusion/fusion describing the new audit-trail capability

Files changed:
 .changeset/fn-5663-goal-citation-audit-trail.md    |  10 +
 docs/agents.md                                     |  15 ++
 docs/cli-reference.md                              |   6 +-
 packages/cli/src/__tests__/bin.test.ts             |   2 +
 .../cli/src/__tests__/goals-citations-cli.test.ts  |  82 ++++++++
 packages/cli/src/bin.ts                            |  19 +-
 packages/cli/src/commands/goals.ts                 |  43 +++++
 packages/core/src/__tests__/db-migrate.test.ts     |  10 +-
 packages/core/src/__tests__/db.test.ts             |  34 ++--
 .../src/__tests__/goal-citation-extractor.test.ts  |  56 ++++++
 .../src/__tests__/goal-citations-store.test.ts     | 175 +++++++++++++++++
 packages/core/src/__tests__/goals-schema.test.ts   |   2 +-
 packages/core/src/__tests__/insight-store.test.ts  |  10 +-
 packages/core/src/__tests__/mission-store.test.ts  |   2 +-
 packages/core/src/__tests__/run-audit.test.ts      |   2 +-
 packages/core/src/__tests__/secrets-schema.test.ts |   6 +-
 .../core/src/__tests__/store-merge-queue.test.ts   |   2 +-
 packages/core/src/__tests__/task-documents.test.ts |   2 +-
 packages/core/src/db.ts                            |  51 ++++-
 packages/core/src/goal-citation-extractor.ts       |  56 ++++++
 packages/core/src/index.ts                         |  13 ++
 packages/core/src/store.ts                         | 210 ++++++++++++++++++++-
 packages/core/src/types.ts                         |  51 ++++-
 .../src/store/__tests__/roadmap-store.test.ts      |   4 +-
 24 files changed, 817 insertions(+), 46 deletions(-)

Fusion-Task-Id: FN-5663

Fusion-Task-Lineage: 720f2c4b-4363-464a-a76f-472ec6aca136

2026-05-29 08:25:38 -07:00

..

bin-pr-router.test.ts

test(FN-4993): add AI parity and pr router coverage

2026-05-18 05:57:43 -07:00

bin.test.ts

FN-5663: add goal-citation audit trail to agent reasoning

2026-05-29 08:25:38 -07:00

build-exe-cross.test.ts

feat(FN-5611): strip react devtools from bun compile builds

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

build-exe.test.ts

feat(FN-5611): strip react devtools from bun compile builds

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

bundle-output-helpers.test.ts

feat(FN-3170): harden plugin bundling contract and fix verification regress

2026-05-10 06:14:19 -07:00

bundle-output-helpers.ts

feat(FN-3170): harden plugin bundling contract and fix verification regress

2026-05-10 06:14:19 -07:00

bundle-output.test.ts

feat(FN-3994): fix bundle-output test path reference to remain compatible w

2026-05-11 08:32:52 -07:00

ci-workflow.test.ts

test(core): force deterministic fs.watch failure with NUL-byte path

2026-05-28 10:46:21 -07:00

dev-with-memory-lib.test.ts

fix(FN-000): address startup review feedback

2026-05-11 13:36:51 +02:00

docker.test.ts

feat(FN-3411): document docker provisioning endpoints

2026-05-04 22:17:10 -07:00

docs-readme-index.test.ts

fix(FN-3433): restore workspace llama-cpp docs index integrity

2026-05-04 23:59:52 -07:00

experiment-finalize.test.ts

feat(FN-4460): complete Step 2 — route CLI finalize via task store accessor

2026-05-14 04:42:32 -07:00

extension-agent-provisioning.test.ts

feat(FN-3791): add agent provisioning approval guards and policy enforcemen

2026-05-10 23:36:10 -07:00

extension-experiment-finalize.test.ts

test(FN-4904): cover worktree-root lookup in extension tools

2026-05-17 10:45:41 -07:00

extension-fn-secret-get.test.ts

test(FN-4867): complete Step 3 — strengthen fn_secret_get scope coverage

2026-05-17 18:46:42 -07:00

extension-format-task-line.test.ts

test(FN-5115): complete Step 6 — add formatTaskLine regression coverage

2026-05-19 06:51:26 -07:00

extension-github-tracking.test.ts

test(FN-5102): expand agent-surface github tracking regressions

2026-05-18 23:50:00 -07:00

extension-goal-tools.test.ts

FN-5652: add goal retrieval tool for agent execution

2026-05-29 07:13:23 -07:00

extension-insights.test.ts

feat(FN-3450): add mesh task create replication across nodes

2026-05-07 00:05:34 -07:00

extension-integration.test.ts

feat(FN-4074): add priority option to task creation in engine and extension

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

extension-task-tools.test.ts

fix(FN-5168): stabilize cli worktree root test timeout

2026-05-19 16:15:25 -07:00

extension-web-fetch.test.ts

feat(FN-4649): complete Step 7 — run verification and fix test regressions

2026-05-15 21:08:05 -07:00

extension.test.ts

feat(FN-5584): merge fusion/fn-5584

2026-05-25 15:27:06 -07:00

goals-citations-cli.test.ts

FN-5663: add goal-citation audit trail to agent reasoning

2026-05-29 08:25:38 -07:00

goals-commands.test.ts

Recovery: re-land fn goals CLI + pi tools onto main

2026-05-28 19:44:15 -07:00

package-config.test.ts

feat(FN-5552): narrow push outcome union in useMergeAdvanceNotice

2026-05-23 09:00:02 -07:00

plugin-scaffold.test.ts

feat(FN-1114): merge fusion/fn-1114 (auto-resolved)

2026-04-09 19:04:12 -07:00

project-context.test.ts

fix(FN-XXXX): avoid inheriting unregistered parent projects

2026-05-01 23:35:44 -07:00

project-resolver.test.ts

feat(FN-5411): add project identity recovery and identity-aware startup rea

2026-05-23 04:18:55 -07:00

research-extension-tools.test.ts

feat(FN-3901): add builtin research web-search provider as default

2026-05-09 19:41:09 -07:00

root-test-command.test.ts

test(FN-5033): update CLI shard planner expectations

2026-05-18 06:39:52 -07:00

setup-test-isolation.ts

feat(FN-3593): add test isolation CI enforcement, fix stuck-requeue race, a

2026-05-06 09:43:51 -07:00

skill-sync.test.ts

feat(FN-2569): sync fusion skill docs with runtime tools

2026-04-25 20:07:49 -07:00

task-delete-allow-resurrection.test.ts

feat(FN-5233): add tombstone recreate guard and allow-resurrection delete f

2026-05-23 17:07:14 -07:00

task-plan.test.ts

feat(FN-5060): complete Step 7 — testing and verification

2026-05-18 22:47:51 -07:00

task-steer.test.ts

feat(FN-5060): complete Step 7 — testing and verification

2026-05-18 22:47:51 -07:00

update-cache.test.ts

fix(FN-4812): stabilize hoisted update-cache test fixture

2026-05-16 19:16:48 -07:00

version.test.ts

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

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

vitest-workspace-resolution.test.ts

test(FN-4786): stabilize cli tmp-dir tests for workspace runs

2026-05-16 18:40:04 -07:00