1c4a3f4e4d
- Update AGENTS.md with authoritative run lifecycle semantics documentation - Add API-level regression test for repeated manual run prevention - Update run lifecycle tests to match corrected behavior - Refactor AgentStore to use structured run records as the authoritative source for run state - Improve run status queries with better filtering and ordering
Fusion Documentation
Fusion is an AI-orchestrated task board that turns ideas into reviewed, merged code using a structured workflow: triage → todo → in-progress → in-review → done.
Quick Start
Install Fusion globally, run fn dashboard, then create your first task from the board or CLI.
For a full walkthrough (installation, onboarding, first task, and lifecycle), start here:
Documentation Index
| Guide | What it covers |
|---|---|
| Getting Started | Installation, first-run onboarding, first task, and daily workflow basics. |
| Architecture | System architecture, package layout, storage model, and engine execution flow. |
| Memory Plugin Contract | Pluggable memory backend architecture, interface contract, and migration strategy. |
| CLI Reference | Complete fn command reference with subcommands, flags, and examples. |
| Dashboard Guide | Detailed guide to board/list views, terminal, git manager, files, planning, and UI tools. |
| Task Management | Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration. |
| Missions | Mission hierarchy, planning flow, activation, progress tracking, and autopilot behavior. |
| Agents | Agent management, presets, prompts, heartbeat behavior, spawning, and mailbox workflows. |
| Workflow Steps | Reusable quality gates, templates, pre/post-merge phases, and workflow execution results. |
| Settings Reference | Global and project settings, defaults, API endpoints, and model selection hierarchy. |
| Multi-Project | Central registry architecture, project management, isolation modes, and migration paths. |
| UX Audit Report | Comprehensive UX audit with prioritized recommendations for dashboard improvements. |
| Codebase Improvement Audit | Evidence-based technical debt and reliability gap audit with prioritized recommendations. |
| Contributing | Local development setup, testing, release flow, and contributor conventions. |
| Code Signing Setup | macOS and Windows code signing configuration for release binaries. |
External Resources
- GitHub repository: https://github.com/gsxdsm/fusion
- npm package: https://www.npmjs.com/package/@gsxdsm/fusion
- pi agent framework: https://github.com/badlogic/pi-mono
Suggested Reading Paths
- New user: Getting Started → Dashboard Guide → Task Management
- Power user / automation owner: Settings Reference → Workflow Steps → Agents
- Maintainer / contributor: Architecture → Multi-Project → Contributing