gsxdsm fab8a62b55 FN-5977: expose goal retrieval tools across engine agents ...

Make goal lookup tools available and citable throughout engine-driven agent sessions.

- add shared engine goal list/show tools with concise list snippets, full detail lookup, and retrieval audit coverage
- expose fn_goal_list and fn_goal_show in executor, heartbeat, and triage tool surfaces and classify them as readonly coordination-exempt tools
- extend CLI and engine regression coverage, refresh tool reference docs, and add a published changeset for the CLI package

Files changed:
 .changeset/FN-5977-goal-retrieval-engine-tools.md  |   7 +
 packages/cli/skill/fusion/references/engine-tools.md    |   2 +
 packages/cli/src/__tests__/extension-goal-tools-audit.test.ts   |   8 +-
 packages/cli/src/__tests__/extension-goal-tools.test.ts | 118 +++++++++++-
 packages/cli/src/__tests__/goal-store-resolution.test.ts    |   2 +-
 packages/cli/src/extension.ts                      |  38 +++-
 packages/engine/src/__tests__/agent-tools-goal.test.ts  | 213 +++++++++++++++++++++
 packages/engine/src/__tests__/gating-classifications.test.ts   |   4 +
 packages/engine/src/__tests__/heartbeat-executor.test.ts       |  22 ++-
 packages/engine/src/__tests__/heartbeat-session-prompt.test.ts |   8 +-
 packages/engine/src/agent-heartbeat.ts             |   4 +-
 packages/engine/src/agent-tools.ts                 | 180 ++++++++++++++++-
 packages/engine/src/executor.ts                    |   8 +
 packages/engine/src/gating-classifications.ts      |   2 +
 packages/engine/src/triage.ts                      |  26 ++-
 15 files changed, 600 insertions(+), 42 deletions(-)

Fusion-Task-Id: FN-5977

Fusion-Task-Lineage: 46f7e777-da4d-4e9c-b014-329a5cb1e3da

2026-06-07 18:51:46 -07:00

..

bin-pr-router.test.ts

feat(pr): fn pr CLI commands, retire fn task pr-create (U8)

2026-06-05 22:28:50 -07:00

bin-targets.test.ts

FN-5916: fix CLI bin targets for pnpm install

2026-06-02 21:54:14 -07:00

bin.test.ts

Address PR review feedback (#1461)

2026-06-06 00:09:53 -07:00

build-exe-cross.test.ts

fix(build): pin @types/node workspace-wide; make build-exe tests opt-in

2026-05-30 08:39:38 -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(acp): bundle into CLI, on-demand install, S1 safety + evidence (U8)

2026-06-03 09:25:56 -07:00

ci-workflow.test.ts

refactor(ci): thin PR gate to lint/typecheck/build/gate; demote full suite to non-blocking push-to-main workflow

2026-06-05 09:02:36 -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-audit.test.ts

FN-5977: expose goal retrieval tools across engine agents

2026-06-07 18:51:46 -07:00

extension-goal-tools.test.ts

FN-5977: expose goal retrieval tools across engine agents

2026-06-07 18:51:46 -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-mission-goal-tools.test.ts

FN-5958: add mission goal linking to create and update flows

2026-06-03 22:31:23 -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

FN-5937: clear deadlock auto-pause on retry

2026-06-03 15:32:29 -07:00

goal-store-resolution.test.ts

FN-5977: expose goal retrieval tools across engine agents

2026-06-07 18:51:46 -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

refactor(ci): thin PR gate to lint/typecheck/build/gate; demote full suite to non-blocking push-to-main workflow

2026-06-05 09:02:36 -07:00

plugin-dev.test.ts

FN-5844: add plugin dev loop and external authoring docs

2026-06-01 19:40:28 -07:00

plugin-pack-shape.test.ts

FN-5844: add plugin dev loop and external authoring docs

2026-06-01 19:40:28 -07:00

plugin-scaffold.test.ts

FN-5844: add plugin dev loop and external authoring docs

2026-06-01 19:40:28 -07:00

plugin-sdk-export.test.ts

FN-5842: publish plugin SDK subpath export

2026-06-01 16:09:35 -07:00

pr-command.test.ts

Address PR review feedback (#1461)

2026-06-06 00:09:53 -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

Address PR review feedback (#1453)

2026-06-05 13:58:34 -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

fix(ci): schema-version literal, CLI core-mock spreads, plugin-sdk type-only exports, restore pruned i18n keys

2026-06-04 03:38:05 -07:00

task-retry.test.ts

FN-5937: clear deadlock auto-pause on retry

2026-06-03 15:32:29 -07:00

task-steer.test.ts

fix(ci): schema-version literal, CLI core-mock spreads, plugin-sdk type-only exports, restore pruned i18n keys

2026-06-04 03:38:05 -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