From 5b1c4acb67b884213c681616ba5b4334eeab3422 Mon Sep 17 00:00:00 2001
From: Fusion <noreply@runfusion.ai>
Date: Mon, 4 May 2026 23:46:51 -0700
Subject: [PATCH] feat(FN-3418): merge branch updates for dashboard, agent, and
 node workflows

- Add missing dashboard view sections and mobile/header UX refinements across dashboard surfaces
- Enable heartbeat tool mode, paused-agent deletion support, and expanded agent/skill management flows
- Add docker/node provisioning and shell onboarding improvements with updated API and architecture documentation
- Improve reliability and coverage for SQLite/WAL handling, research/insight stores, and related CLI/core tests
- Add Claude OAuth credential interop, workflow-step/README/docs updates, and required changesets

Fusion-Task-Id: FN-3418
---
 docs/dashboard-guide.md | 88 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)

diff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.md
index a09d2a29e..aac71437f 100644
--- a/docs/dashboard-guide.md
+++ b/docs/dashboard-guide.md
@@ -148,6 +148,94 @@ Memory view provides a multi-file editor for project and daily memory files.
 
 ![Memory view](./screenshots/memory-view.png)
 
+## Agents View
+
+Agents view is the control surface for runtime agents and team structure.
+
+Navigation:
+- Desktop: primary view toggle (**Agents**)
+- Mobile: bottom nav tab (**Agents**)
+
+Features:
+- Browse agents with role/state filters and health/status indicators
+- Start/pause agents and trigger runs
+- Open agent detail for config, logs, token stats, and org relationships
+- Optional planning-style onboarding/import flows when enabled in settings
+
+For full agent lifecycle behavior and heartbeat/runtime config, see [Agents guide](./agents.md).
+
+## Roadmaps View
+
+Roadmaps view manages roadmap hierarchies (roadmaps, milestones, features) and planning handoff exports.
+
+> Available when `experimentalFeatures.roadmap` is enabled.
+> Hidden when a plugin replaces Roadmaps navigation.
+
+Navigation:
+- Desktop: **Header → More views → Roadmaps**
+- Mobile: **More** sheet (or promoted to a top tab when eligible based on mobile nav slot rules)
+
+Features:
+- Create/edit/reorder roadmap milestones and features
+- Inline editing and drag/drop organization
+- Export planning handoff payloads for mission/task planning workflows
+
+For mission planning context and handoff structure, see [Missions guide](./missions.md).
+
+## Insights View
+
+Insights view surfaces categorized project insights and lets you turn findings into work.
+
+> Available when `experimentalFeatures.insights` is enabled.
+
+Navigation:
+- Desktop: **Header → More views → Insights**
+- Mobile: **More** sheet → **Insights**
+
+Features:
+- Category-based insight browser with run metadata
+- Manual insight generation and refresh actions
+- Dismiss stale insights and create triage tasks from selected findings
+
+## Dev Server View
+
+Dev Server view manages detected dev server commands, preview URLs, and live logs for local development.
+
+> Available when `experimentalFeatures.devServerView` is enabled.
+
+Navigation:
+- Desktop: **Header → More views → Dev Server**
+- Mobile: **More** sheet → **Dev Server**
+
+Features:
+- Detect/start/stop/restart dev server commands per project
+- Embedded preview with fallback to external open
+- Live log stream with load-more history
+
+For module-level behavior and API surfaces, see [Dev Server modules](./dev-server-modules.md).
+
+## Plugin Manager
+
+Plugin management lives in **Settings → Plugins → Fusion Plugins**.
+
+Features:
+- Install bundled or path-based Fusion plugins
+- Enable/disable, reload, uninstall, and inspect plugin state
+- Edit plugin settings with live lifecycle updates
+
+For plugin-related settings and experimental toggles, see [Settings reference](./settings-reference.md).
+
+## Pi Extensions Manager
+
+Pi extension management lives in **Settings → Plugins → Pi Extensions**.
+
+Features:
+- Install/remove Pi package sources
+- Reinstall the Fusion Pi package
+- Enable/disable discovered Pi extensions and manage extension/skill/prompt/theme paths
+
+For related global/project configuration behavior, see [Settings reference](./settings-reference.md).
+
 ## Task Detail Modal
 
 Inspect task definition, logs, comments, documents, workflow outcomes, model overrides, and task routing from a single modal.