gsxdsm e46ea00ff5 FN-6827: add engine status banner ...

Add project-scoped engine connectivity remediation to the dashboard.

- Add engine status/start API helpers and server routes that can resume paused projects or start missing engines.
- Render a project banner with dashboard-only guidance, polling, disabled starting state, localized copy, and focused tests.
- Document the engine status banner behavior and add a changeset for the published CLI package.

Files changed:
 .changeset/fn-6827-engine-disconnected-banner.md   |   7 +
 docs/dashboard-guide.md                            |   8 +
 packages/dashboard/app/api/legacy.ts               |  20 +++
 .../app/components/EngineStatusBanner.css          |  87 +++++++++++
 .../app/components/EngineStatusBanner.tsx          |  62 ++++++++
 .../__tests__/EngineStatusBanner.test.tsx          | 145 +++++++++++++++++
 .../app/components/dashboard/DashboardBanners.tsx  |   3 +
 .../app/hooks/__tests__/useEngineStatus.test.ts    | 171 +++++++++++++++++++++
 packages/dashboard/app/hooks/useEngineStatus.ts    | 111 +++++++++++++
 packages/dashboard/src/__tests__/server.test.ts    | 129 ++++++++++++++++
 packages/dashboard/src/server.ts                   |  89 +++++++++++
 packages/i18n/locales/en/app.json                  |  10 ++
 packages/i18n/locales/es/app.json                  |  10 ++
 packages/i18n/locales/fr/app.json                  |  10 ++
 packages/i18n/locales/ko/app.json                  |  10 ++
 packages/i18n/locales/zh-CN/app.json               |  10 ++
 packages/i18n/locales/zh-TW/app.json               |  10 ++
 17 files changed, 892 insertions(+)

Fusion-Task-Id: FN-6827

Fusion-Task-Lineage: 56821ca3-04c8-4674-9400-3639f10e463d

2026-06-25 08:35:44 -07:00

..

createChatStreamHandlers.test.ts

FN-6632: preserve reattached chat stream chunks

2026-06-18 06:36:03 -07:00

modalPersistence.test.ts

feat(FN-1276): scope dashboard persistence by project

2026-04-08 10:39:38 -07:00

sseSplitIntegration.test.ts

test(dashboard): apply test-quality findings from focused re-review

2026-06-24 09:23:03 -07:00

sseTestHelpers.ts

test(dashboard): apply test-quality findings from focused re-review

2026-06-24 09:23:03 -07:00

useActivityLog.test.ts

chore: consolidate remaining tests into __tests__/ dirs and refactor mocks

2026-04-24 19:39:20 -07:00

useAgentLogs.resume-instrumentation.test.ts

feat(FN-5469): add useAgentLogs resume instrumentation and test coverage

2026-05-21 20:06:48 -07:00

useAgentLogs.test.ts

FN-6040: show loading indicators for task detail activity and agent logs

2026-06-08 13:32:58 -07:00

useAgents.test.ts

perf(dashboard): speed up startup and eliminate API request storms

2026-05-26 21:57:31 -07:00

useAgentsMapCache.test.ts

feat(FN-5202): add SWR caching for chat agents, skills, and models

2026-05-20 03:19:44 -07:00

useAiSessionSync.test.ts

feat(FN-1154): sync AI session state across browser tabs

2026-04-08 16:48:35 -07:00

useApprovalBanner.test.ts

test(dashboard): apply test-quality findings from focused re-review

2026-06-24 09:23:03 -07:00

useAppSettings.test.ts

FN-5936: fix auto-merge board stabilization on mobile

2026-06-03 13:20:17 -07:00

useArtifacts.test.ts

FN-6779: add artifacts gallery to Documents

2026-06-21 16:01:07 -07:00

useAuthOnboarding.test.ts

fix(onboarding): simplify first-run project setup

2026-06-22 05:20:22 -07:00

useAuthTokenRecovery.test.ts

test(dashboard): harden hook tests + drop dead App.tsx re-exports (code review)

2026-06-24 01:13:33 -07:00

useAutosizeTextarea.test.tsx

feat(FN-4712): complete Step 2 — extract autosize textarea hook

2026-05-15 22:24:12 -07:00

useBackgroundSessions.resume-instrumentation.test.ts

feat(FN-5416): instrument SSE stream resume events across PR checks, dev-se

2026-05-21 18:15:26 -07:00

useBackgroundSessions.test.ts

FN-6458: wire CLI session banner actions

2026-06-15 02:29:08 -07:00

useBadgeWebSocket.test.ts

feat(FN-4370): complete Step 3 — retain badge snapshots across unsubscribes

2026-05-13 15:05:05 -07:00

useBatchBadgeFetch.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useBlockerFanout.test.ts

FN-6569: make auto-merge retry cap configurable

2026-06-17 04:51:31 -07:00

useBoardScrollRestore.test.ts

test(dashboard): harden hook tests + drop dead App.tsx re-exports (code review)

2026-06-24 01:13:33 -07:00

useBoardWorkflows.test.ts

fix(dashboard): resizers, overlaps, dock pop-out, dedup refactors, live tweaks

2026-06-22 04:18:35 -07:00

useBranchTaskFilters.test.ts

refactor(dashboard): extract useBranchTaskFilters hook from App.tsx

2026-06-23 19:52:52 -07:00

useCapacityRiskBanner.test.ts

test(dashboard): harden hook tests + drop dead App.tsx re-exports (code review)

2026-06-24 01:13:33 -07:00

useChat.test.ts

FN-6632: preserve reattached chat stream chunks

2026-06-18 06:36:03 -07:00

useChatRooms.cache.test.ts

feat(FN-5388): add warm room cache hydration with open diagnostics

2026-05-20 20:27:11 -07:00

useChatRooms.resume-instrumentation.test.ts

feat(FN-5389): add resume event instrumentation with SSE, hooks, and diagno

2026-05-20 19:58:49 -07:00

useChatRooms.test.ts

FN-6442: rescue dashboard hook tests from skiplist

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

useChatUnread.test.ts

feat(FN-4661): complete Step 1 — add useChatUnread hook

2026-05-15 15:19:56 -07:00

useChatUnreadBadge.test.ts

test(dashboard): apply test-quality findings from focused re-review

2026-06-24 09:23:03 -07:00

useConfirm.test.ts

feat(FN-5475): add allow-resurrection control to task delete flow

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

useCurrentProject.test.ts

feat(FN-4924): apply cache ttl hydration across dashboard hooks

2026-05-17 11:33:56 -07:00

useDashboardHealth.test.ts

test(dashboard): apply test-quality findings from focused re-review

2026-06-24 09:23:03 -07:00

useDeepLink.test.ts

feat(FN-5583): handle notification deep links in useDeepLink hook

2026-05-24 00:11:08 -07:00

useDevServer.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useDevServerLogs.resume-instrumentation.test.ts

feat(FN-5416): instrument SSE stream resume events across PR checks, dev-se

2026-05-21 18:15:26 -07:00

useDevServerLogs.test.ts

feat(FN-2170): add dev-server preview detection and log viewer flow

2026-04-20 15:37:32 -07:00

useDiscoveredSkillsCache.test.ts

feat(FN-5202): add SWR caching for chat agents, skills, and models

2026-05-20 03:19:44 -07:00

useDockerProvisioning.test.ts

feat(FN-3110): add docker provisioning service, API routes, and status UI c

2026-05-03 14:10:11 -07:00

useDockerTargets.test.ts

feat(FN-3109): add Docker connectivity service and target selector UI

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

useDocuments.test.ts

FN-6076: align dashboard tests with updated labels and mocks

2026-06-09 07:24:39 -07:00

useEngineStatus.test.ts

FN-6827: add engine status banner

2026-06-25 08:35:44 -07:00

useEvals.test.ts

Fix tests

2026-05-19 23:04:12 -07:00

useExecutorStats.test.ts

FN-6933: show stopped engine state in footer

2026-06-23 00:45:00 -07:00

useFavorites.test.ts

feat(FN-5202): add SWR caching for chat agents, skills, and models

2026-05-20 03:19:44 -07:00

useFileBrowser.test.ts

fix(dashboard): ensure file/import API calls are project-scoped in tests

2026-04-12 21:40:34 -07:00

useFileEditor.test.ts

fix(dashboard): ensure file/import API calls are project-scoped in tests

2026-04-12 21:40:34 -07:00

useFileMention.test.ts

feat(FN-5218): add hash mentions to chat composers and popups

2026-05-20 04:12:40 -07:00

useFlashOnIncrease.test.ts

chore: consolidate test files into __tests__/ dirs and clean stray engine artifacts

2026-04-24 19:39:20 -07:00

useGitHubStarPrompt.test.ts

FN-5967: add first-task GitHub star prompt

2026-06-03 22:35:28 -07:00

useInsights.test.ts

Fix tests

2026-05-19 23:04:12 -07:00

useIssueMention.test.ts

fix(FN-4735): address useIssueMention selection spacing

2026-05-16 09:21:06 -07:00

useLanguage.test.ts

feat(i18n): add Korean locale + localized READMEs with language switcher

2026-06-03 17:33:16 -07:00

useLiveTranscript.test.ts

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

2026-04-14 11:29:16 -07:00

useMailboxUnread.test.ts

refactor(dashboard): extract useMailboxUnread + useApprovalBanner hooks

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

useMainPanelTaskDetail.test.ts

refactor(dashboard): extract task-detail, board-scroll, popped-out hooks

2026-06-23 21:09:36 -07:00

useManagedDockerNodes.resume-instrumentation.test.ts

feat(FN-5415): wire visibility resume emissions in board hooks and add test

2026-05-21 16:09:53 -07:00

useManagedDockerNodes.test.ts

feat(FN-3112): tokenize NodesView border-radius and motion styles

2026-05-04 06:12:12 -07:00

useMemoryBackendStatus.test.ts

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

2026-04-25 18:22:37 -07:00

useMemoryData.test.ts

feat(FN-2848): add manual memory dream API trigger

2026-04-28 14:25:55 -07:00

useMergeAdvanceNotice.test.ts

feat(FN-5475): add allow-resurrection control to task delete flow

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

useMeshState.resume-instrumentation.test.ts

feat(FN-5415): wire visibility resume emissions in board hooks and add test

2026-05-21 16:09:53 -07:00

useMeshState.test.ts

feat(FN-3955): align mesh state hook contract with topology consumers

2026-05-10 18:04:43 -07:00

useMobileKeyboard.test.ts

FN-6362: reset mobile keyboard restore metrics

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

useMobileScrollLock.test.ts

FN-6364: reset iOS mobile viewport on restore

2026-06-13 10:29:24 -07:00

useModalManager.test.ts

FN-6914: preserve quick-add drafts for planning

2026-06-22 18:03:53 -07:00

useModalResizePersist.test.tsx

FN-6377: make tablet modals touch-resizable

2026-06-13 11:46:53 -07:00

useModelsCache.test.ts

feat(FN-5202): add SWR caching for chat agents, skills, and models

2026-05-20 03:19:44 -07:00

useMultiAgentLogs.test.ts

feat(FN-1629): add pagination to agent logs

2026-04-15 02:53:06 -07:00

useNavigationHistory.test.ts

FN-6167: fix stale mobile modal navigation history

2026-06-09 22:44:30 -07:00

useNodeProxy.test.ts

feat(FN-1232): add remote node mesh dashboard integration

2026-04-09 13:01:19 -07:00

useNodes.resume-instrumentation.test.ts

feat(FN-5415): wire visibility resume emissions in board hooks and add test

2026-05-21 16:09:53 -07:00

useNodes.test.ts

FN-6197: suppress tab-resume fetch errors in dashboard

2026-06-10 09:21:48 -07:00

useNodeSettingsSync.test.ts

FN-6208: sync workflow settings across nodes

2026-06-11 09:21:23 -07:00

useOverlayDismiss.test.tsx

feat(FN-5482): suppress touch-synthesized mouse events on overlay dismiss

2026-05-23 02:06:11 -07:00

usePluginDashboardViews.test.ts

feat(FN-3091): add plugin view remount routing test coverage

2026-05-07 08:49:18 -07:00

usePluginUiContributions.test.ts

feat(FN-3564): isolate plugin loader test state to prevent cross-test conta

2026-05-06 02:14:05 -07:00

usePluginUiSlots.test.ts

feat(FN-1925): add plugin UI slot infrastructure

2026-04-16 10:04:44 -07:00

usePoppedOutTasks.test.ts

refactor(dashboard): extract task-detail, board-scroll, popped-out hooks

2026-06-23 21:09:36 -07:00

usePrChecksStream.resume-instrumentation.test.ts

feat(FN-5416): instrument SSE stream resume events across PR checks, dev-se

2026-05-21 18:15:26 -07:00

usePrChecksStream.test.ts

feat(FN-4760): complete Step 3 — add PR checks polling hook

2026-05-17 08:49:51 -07:00

usePreviewEmbed.test.ts

feat(FN-2173): add auto-fallback flow for dev server preview

2026-04-20 22:10:07 -07:00

useProjectActions.test.ts

feat(FN-1733): add dedicated pause/resume APIs for projects

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

useProjectBookmarks.test.ts

feat(dashboard): scrollable, autocomplete, bookmarkable project selector

2026-06-07 02:26:00 +07:00

useProjectFileBrowser.test.ts

feat(KB-175): move file browser to header with workspace support

2026-03-31 01:26:57 -07:00

useProjectFileEditor.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useProjectHealth.test.ts

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

2026-04-14 09:29:08 -07:00

useProjectMarkdownFiles.test.ts

feat(FN-2315): add hidden markdown toggle for project documents

2026-04-24 08:55:02 -07:00

useProjects.resume-instrumentation.test.ts

feat(FN-5415): wire visibility resume emissions in board hooks and add test

2026-05-21 16:09:53 -07:00

useProjects.test.ts

FN-6197: suppress tab-resume fetch errors in dashboard

2026-06-10 09:21:48 -07:00

useRemoteNodeData.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useRemoteNodeEvents.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useResearch.resume-instrumentation.test.ts

feat(FN-5416): instrument SSE stream resume events across PR checks, dev-se

2026-05-21 18:15:26 -07:00

useResearch.test.ts

Fix tests

2026-05-19 23:04:12 -07:00

useScopedDismissFlag.test.ts

refactor(dashboard): extract useDashboardHealth, useAuthTokenRecovery, useScopedDismissFlag

2026-06-23 20:03:44 -07:00

useSelectionComment.test.ts

FN-6528: add selection comments for new tasks

2026-06-17 03:29:39 -07:00

useSessionFiles.test.ts

feat(FN-1544): add viewport-gated loading and lightweight memo comparison

2026-04-10 10:44:48 -07:00

useSetupReadiness.test.ts

feat(FN-2189): include gh CLI auth in setup readiness

2026-04-20 10:16:13 -07:00

useShellConnection.test.tsx

feat(FN-3403): add shell multi-profile support with connection manager onbo

2026-05-07 18:35:45 -07:00

useShellContext.test.ts

feat(FN-3406): add shell context hook plumbing for dashboard

2026-05-07 23:21:05 -07:00

useStashOrphanCount.test.ts

test(dashboard): harden hook tests + drop dead App.tsx re-exports (code review)

2026-06-24 01:13:33 -07:00

useTaskDiffStats.test.ts

FN-6442: rescue dashboard hook tests from skiplist

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

useTaskHandlers.test.ts

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

2026-04-29 17:23:22 -07:00

useTasks.resume-instrumentation.test.ts

feat(FN-5389): add resume event instrumentation with SSE, hooks, and diagno

2026-05-20 19:58:49 -07:00

useTasks.stale-trace.test.ts

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

2026-05-17 19:11:59 -07:00

useTasks.test.ts

test(FN-5135): cover search-refresh deletedAt edge path

2026-05-19 08:13:07 -07:00

useTerminal.test.ts

FN-6116: clear terminal event buffers after subscriber delivery

2026-06-09 12:57:21 -07:00

useTerminalSessions.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useTheme.test.ts

fix(dashboard): polish app chrome and workflow defaults

2026-06-22 18:21:06 -07:00

useToast.test.tsx

chore: consolidate test files into __tests__/ dirs and clean stray engine artifacts

2026-04-24 19:39:20 -07:00

useTodoLists.test.ts

test(dashboard): clear localStorage in useTodoLists beforeEach

2026-05-19 19:03:10 -07:00

useUpdateCheck.test.ts

feat(FN-2663): add cached update-check setting, APIs, and banner

2026-04-27 01:40:07 -07:00

useUsageData.test.ts

FN-5886: show empty usage state after empty fetch

2026-06-02 09:24:42 -07:00

useViewportMode.test.ts

FN-6213: prevent keyboard from forcing mobile layout

2026-06-11 19:37:25 -07:00

useViewState.test.ts

fix(onboarding): simplify first-run project setup

2026-06-22 05:20:22 -07:00

useWorkspaceFileBrowser.test.ts

fix: project-scope terminal, file browser, agent execution, and heartbeat monitor

2026-04-12 18:38:26 -07:00

useWorkspaceFileEditor.test.ts

fix(dashboard): clear all 661 test-file type errors

2026-04-27 19:59:52 -07:00

useWorkspaces.test.ts

fix(FN-1952): recover routines schedules merge

2026-04-16 23:07:40 -07:00

visibilitySuspension.test.ts

FN-6197: suppress tab-resume fetch errors in dashboard

2026-06-10 09:21:48 -07:00