fusion

Files

gsxdsm 74dacd0758 FN-9188: respect externally managed updates

Managed deployments can now suppress self-update offers while unsupported installs receive actionable guidance.

- Add an install-level environment policy for externally managed updates across CLI, server, and dashboard surfaces.
- Detect missing npm shell failures and replace raw stderr with deployment-aware remediation.
- Document managed-update behavior and add regression coverage for checks, installs, automation, and UI actions.

Files changed:
 .changeset/fn-9188-managed-updates.md              |  7 +++
 docs/architecture.md                               |  6 +--
 docs/cli-reference.md                              |  2 +-
 docs/dashboard-guide.md                            |  2 +-
 docs/settings-reference.md                         |  4 +-
 packages/cli/src/__tests__/update-cache.test.ts    | 11 ++++-
 .../update-command-externally-managed.test.ts      | 39 +++++++++++++++
 packages/cli/src/commands/update.ts                | 42 +++++++++++-----
 packages/cli/src/update-cache.ts                   |  3 +-
 .../core/src/__tests__/update-management.test.ts   | 15 ++++++
 packages/core/src/config/update-management.ts      | 21 ++++++++
 packages/core/src/index.gate.ts                    |  5 ++
 packages/core/src/index.ts                         |  5 ++
 packages/dashboard/app/api/client/health.ts        |  3 ++
 .../dashboard/app/components/SettingsModal.tsx     |  4 ++
 .../__tests__/SettingsModal.general.test.tsx       | 20 ++++++++
 .../__tests__/UpdateAvailableBanner.test.tsx       | 26 ++++++++++
 .../components/__tests__/settings-mobile.test.tsx  | 24 +++++++++-
 .../__tests__/SystemControlsArea.test.tsx          | 20 ++++++++
 .../command-center/areas/SystemControlsArea.tsx    |  6 +++
 .../app/hooks/__tests__/useUpdateCheck.test.ts     |  1 +
 packages/dashboard/app/hooks/useUpdateCheck.ts     |  3 +-
 .../dashboard/src/__tests__/auto-update.test.ts    | 10 ++++
 .../dashboard/src/__tests__/update-check.test.ts   | 56 ++++++++++++++++++++++
 packages/dashboard/src/auto-update.ts              |  9 +++-
 .../__tests__/register-update-check-routes.test.ts | 24 +++++++++-
 .../src/routes/register-update-check-routes.ts     | 47 +++++++++++++++++-
 packages/dashboard/src/update-check.ts             | 50 ++++++++++++++++---
 28 files changed, 433 insertions(+), 32 deletions(-)

Fusion-Task-Id: FN-9188

Fusion-Task-Lineage: 60b114b9-8bf7-434f-9d26-0c954aea45ba

Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>

2026-08-21 10:18:45 -07:00

helpers

fix: resolve all full-suite failures + add structural mock-completeness gate check (round 10) (#2040 )

2026-07-12 23:29:06 -07:00

bin-chat-args.test.ts

fix(cli-tests): align CLI suite with inbox-mail help, beta versions, and planning-session store

2026-07-23 22:35:12 -07:00

bin-pr-router.test.ts

refactor: domain folder layout (types, API, core, engine) (#2398 )

2026-08-03 00:20:53 -07:00

bin-targets.test.ts

FN-5916: fix CLI bin targets for pnpm install

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

bin-update-args.test.ts

FN-8452: reject invalid update flags and announce beta releases

2026-07-21 10:30:19 -07:00

bin.test.ts

FN-8576: add global quiet flag to CLI

2026-07-25 00:54:46 -07:00

build-exe-cross.test.ts

FN-7568: rename CLI release binary assets to fn-cli-<platform>

2026-07-05 11:31:45 -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

FN-8097: harden CLI package-lane test builds

2026-07-16 09:14:15 -07:00

bundle-output-helpers.ts

FN-8097: harden CLI package-lane test builds

2026-07-16 09:14:15 -07:00

ci-workflow.test.ts

FN-8954: preserve CLI liveness during startup

2026-08-11 04:20:33 -07:00

cli-active-count-lanes.test.ts

refactor: one definition of "which columns are review" — three copies deleted onto core's resolver (#2751 )

2026-07-30 08:28:32 -07:00

cli-exit-code.test.ts

FN-8954: preserve CLI liveness during startup

2026-08-11 04:20:33 -07:00

cli-quiet-mode.test.ts

FN-8576: add global quiet flag to CLI

2026-07-25 00:54:46 -07:00

cli-quiet-prompt-surfaces.test.ts

FN-8576: add global quiet flag to CLI

2026-07-25 00:54:46 -07:00

cli-version.test.ts

FN-8985: centralize CLI version resolution

2026-08-11 01:51:22 -07:00

complete-target-renamed-lane.test.ts

the third census-invisible class: 51 hardcoded moveTask destinations, measured — and duplicates never archived on a renamed board (#2808 )

2026-07-30 12:25:00 -07:00

dashboard-default-workflow-fallback.test.ts

fix(cli): the TUI board fell back to the LEGACY workflow — it rendered a triage lane the default no longer has (#3178 )

2026-07-31 08:13:57 -07:00

dashboard-mission-store-backend-guard.test.ts

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

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

dev-with-memory-lib.test.ts

feat: pnpm dev --isolated runs against its own database and project

2026-08-19 21:14:31 -07:00

docker.test.ts

feat(FN-3411): document docker provisioning endpoints

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

docs-readme-index.test.ts

FN-7247: document current workflow behavior

2026-06-29 19:46:23 -07:00

docs-screenshot-links.test.ts

test(cli): add isInReviewMissingWorktreeSessionStartFailure mock + update docs screenshot list

2026-07-11 18:06:45 -07:00

experiment-finalize.test.ts

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

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

extension-agent-provisioning.test.ts

test: green full-suite CI after main drift (#2229 )

2026-07-16 16:01:29 -07:00

extension-agent-set-instructions.test.ts

FN-8097: harden CLI package-lane test builds

2026-07-16 09:14:15 -07:00

extension-agent-update.test.ts

FN-8764: route workflow stages through durable role agents

2026-08-07 01:36:34 -07:00

extension-experiment-finalize.test.ts

fix(ci): restore clean-main CLI and lifecycle gates (#3420 )

2026-08-11 10:57:36 -10: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-gitlab-tracking.test.ts

FN-8948: reconcile mission state from task ground truth

2026-08-10 20:32:26 -07:00

extension-goal-tools-audit.test.ts

FN-8225: migrate goal-tool tests to shared PostgreSQL harness

2026-07-17 11:18:50 -07:00

extension-goal-tools.test.ts

FN-8225: migrate goal-tool tests to shared PostgreSQL harness

2026-07-17 11:18:50 -07:00

extension-insights.test.ts

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

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

extension-integration.test.ts

FN-8100: restore PostgreSQL task delegation collision coverage

2026-07-16 09:24:56 -07:00

extension-manager-eval-tools.test.ts

FN-9016: add manager evaluation tools

2026-08-12 15:51:22 -07:00

extension-mission-goal-tools.test.ts

FN-8271: restore quarantined CLI tests under shard load

2026-07-18 07:48:45 -07:00

extension-node-override-renamed-wip.test.ts

test(cli): pin the node-override error contract on a renamed board, which is what #3019 actually changed (#3024 )

2026-07-31 01:06:09 -07:00

extension-permission-gates.test.ts

FN-8971: add mission blocked-status clearing tool

2026-08-11 01:45:08 -07:00

extension-task-archive-live-guard.test.ts

FN-9055: guard archive disposal of live workspace worktrees

2026-08-15 00:35:12 -07:00

extension-task-tools.test.ts

fix: persist manual task pauses (#2536 )

2026-07-29 00:04:28 -07:00

extension-tool-timeout.test.ts

FN-8140: reuse host TaskStore across extension loads

2026-07-16 14:01:59 -07:00

extension-web-fetch.test.ts

FN-8948: reconcile mission state from task ground truth

2026-08-10 20:32:26 -07:00

extension-workflow-tools.test.ts

test(cli): four suites broke on mocks that predate the PG cutover and U11 (12 red → 0) (#2702 )

2026-07-30 04:10:06 -07:00

extension-workspace-worktree-root.test.ts

FN-9162: Group workspace worktrees under configurable roots

2026-08-19 19:46:35 -07:00

extension.test.ts

feat(missions): done-credit via reverse lineage, feature re-point/unlink tools, and live unlink SSE (#3491 )

2026-08-19 21:01:56 -07:00

external-proof-point-runbook-install.test.ts

FN-6474: clarify plugin tarball install docs

2026-06-16 15:08:24 -07:00

goal-store-resolution.test.ts

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

2026-07-13 19:07:58 -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

knowledge-graph-bundle-shape.test.ts

FN-8921: add deterministic knowledge graph tooling

2026-08-10 06:15:17 -07:00

knowledge-graph-command.test.ts

FN-8921: add deterministic knowledge graph tooling

2026-08-10 06:15:17 -07:00

lockstep-cli-quarantine.test.ts

FN-8223: enforce full CLI quarantine ledger lockstep

2026-07-17 11:43:46 -07:00

package-config.test.ts

FN-9007: upgrade Pi runtime to 0.84.1

2026-08-12 14:07:30 -07:00

pg-extension-harness.ts

test: bind a project partition in the PG harness for built-in agent provisioning

2026-08-07 17:33:56 -07:00

pi-claude-cli-publish-resolve.smoke.test.ts

FN-8413: add ACP SDK to published CLI dependencies

2026-07-19 21:40:57 -07:00

plugin-dev.test.ts

FN-6367: fix constructible CLI test mocks

2026-06-13 09:14:02 -07:00

plugin-pack-shape.test.ts

FN-7060: sanitize bundled plugin manifests

2026-06-26 10:18:04 -07:00

plugin-publish.test.ts

FN-7913: add fn plugin publish --dry-run preflight command

2026-07-12 21:27:38 -07:00

plugin-scaffold-caret-fallback.test.ts

FN-8985: centralize CLI version resolution

2026-08-11 01:51:22 -07:00

plugin-scaffold.test.ts

fix(cli-tests): align CLI suite with inbox-mail help, beta versions, and planning-session store

2026-07-23 22:35:12 -07:00

plugin-sdk-core-runtime-shim.test.ts

FN-9100: fix staged Cursor core imports in CLI builds

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

plugin-sdk-export.test.ts

fix: restore plugin SDK and Todo packaging

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

pr-automerge-cleanup.test.ts

test(cli): fix stale project-context/desktop/core mocks + version pin + engine-tools doc (shard 3)

2026-07-10 23:21:37 -07:00

pr-command.test.ts

test(cli): fix stale project-context/desktop/core mocks + version pin + engine-tools doc (shard 3)

2026-07-10 23:21:37 -07:00

pr-create-review-lane-resolved.test.ts

fix(tests): new CLI red from #2775 — the test pinned a decision its own PR superseded (#2801 )

2026-07-30 11:25:46 -07:00

pr-merge-review-lane.test.ts

fix(cli): PR merges silently never ran on a renamed board — the blocker was asked about in-review (#2976 )

2026-07-30 22:46:19 -07:00

project-context-lifecycle.test.ts

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

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

project-context.test.ts

FN-8077: stabilize quarantined test timing

2026-07-16 06:20:20 -07:00

project-resolver.test.ts

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

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

research-extension-tools.test.ts

fix: remove fn_research_* from the host pi extension

2026-07-15 11:25:55 -07:00

root-test-command.test.ts

Address PR review feedback (#1453 )

2026-06-05 13:58:34 -07:00

serve-daemon-token.test.ts

fix(security): make the approval and permission gates actually enforce (#2457 )

2026-07-30 21:50:37 -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

staged-plugin-core-imports.test.ts

fix(ci): correct future FNXC stamps (#3440 )

2026-08-15 17:16:05 -07:00

startup-phase.test.ts

feat: faster dashboard and serve startup (#2132 )

2026-07-15 14:01:08 -07:00

task-command-github-import-tracking.test.ts

FN-9167: clear interrupted manual merge status

2026-08-19 20:17:42 -07:00

task-command-gitlab-import.test.ts

test: green full-suite CI after main drift (#2229 )

2026-07-16 16:01:29 -07:00

task-delete-allow-resurrection.test.ts

fix(security): make the approval and permission gates actually enforce (#2457 )

2026-07-30 21:50:37 -07:00

task-lineage-unlink.test.ts

FN-075: allow explicit dependency reference removal on task delete

2026-08-21 04:32:53 +00:00

task-list-board-columns.test.ts

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

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

task-list-terminal-glyph-lanes.test.ts

test(cli): pin the board glyph's terminal-lane resolve (extract seam + pin) (#3238 )

2026-07-31 13:34:03 -07:00

task-plan.test.ts

fix(dashboard,cli): un-dead-end deleted plan tasks; harden fn task plan per review

2026-07-23 20:19:18 -07:00

task-retry-renamed-review.pg.test.ts

fix(cli): fn task retry now CRASHES on a renamed board — #2728 converted the classifier and left the target (#2752 )

2026-07-30 06:51:25 -07:00

task-retry.test.ts

FN-8102: fix CLI package-lane test scaffolding

2026-07-16 08:58:13 -07:00

task-steer.test.ts

FN-8097: harden CLI package-lane test builds

2026-07-16 09:14:15 -07:00

update-cache.test.ts

FN-9188: respect externally managed updates

2026-08-21 10:18:45 -07:00

update-command-externally-managed.test.ts

FN-9188: respect externally managed updates

2026-08-21 10:18:45 -07:00

vitest-cross-package-mock-scope.test.ts

FN-8977: unify CLI Vitest mock resolution

2026-08-10 22:12:15 -07:00

vitest-workspace-resolution.test.ts

FN-8268: resolve Claude runtime aliases in Vitest

2026-07-18 02:15:09 -07:00

workflow-docs-current.test.ts

fix(cli-tests): align CLI suite with inbox-mail help, beta versions, and planning-session store

2026-07-23 22:35:12 -07:00