2dd38a6182
The merge normalizes button utility classes in AgentsView, swapping 12 lines of CSS class references for their standardized counterparts for consistency and maintainability. Fusion-Task-Id: FN-3448
89 lines
6.1 KiB
Markdown
89 lines
6.1 KiB
Markdown
# Fusion Documentation
|
|
|
|
[← Back to repository root](../README.md)
|
|
|
|
Fusion is an AI-orchestrated task board that turns ideas into reviewed, merged code using a structured workflow: **planning → todo → in-progress → in-review → done**.
|
|
|
|
|
|
|
|
## Quick Start
|
|
|
|
Start the local dashboard with `pnpm dev dashboard`, then create your first task from the board or CLI.
|
|
|
|
For a full walkthrough (installation, onboarding, first task, and daily workflow basics):
|
|
|
|
➡️ **[Getting Started](./getting-started.md)**
|
|
|
|
## Documentation Index
|
|
|
|
### Getting Started
|
|
| Guide | Description |
|
|
|---|---|
|
|
| [Getting Started](./getting-started.md) | Installation, first-run, first task, and daily workflow basics |
|
|
| [Dashboard Guide](./dashboard-guide.md) | Board/list views, terminal, git manager, files, planning, and UI tools |
|
|
| [CLI Reference](./cli-reference.md) | Complete `fn` command reference with subcommands, flags, and examples |
|
|
| [Remote Access](./remote-access.md) | Operator runbook for Tailscale/Cloudflare setup, tokenized login links, security caveats, and troubleshooting |
|
|
|
|
### Task & Project Management
|
|
| Guide | Description |
|
|
|---|---|
|
|
| [Task Management](./task-management.md) | Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration |
|
|
| [Todo View](./todo-view.md) | Canonical guide for the experimental Todo View, including enablement, usage, API routes, and storage |
|
|
| [Missions](./missions.md) | Mission hierarchy, planning flow, activation, progress tracking, and autopilot behavior |
|
|
| [Research](./research.md) | Research runs, provider setup, dashboard/CLI usage, findings, exports, and task integration |
|
|
| [Workflow Steps](./workflow-steps.md) | Reusable quality gates, templates, pre/post-merge phases, and workflow execution results |
|
|
| [Multi-Project](./multi-project.md) | Central registry architecture, project management, isolation modes, and migration paths |
|
|
|
|
### Configuration & Agents
|
|
| Guide | Description |
|
|
|---|---|
|
|
| [Settings Reference](./settings-reference.md) | Global and project settings, defaults, API endpoints, and model selection hierarchy |
|
|
| [Agents](./agents.md) | Agent management, presets, prompts, heartbeat behavior, spawning, and mailbox workflows |
|
|
|
|
### Architecture & Development
|
|
| Guide | Description |
|
|
|---|---|
|
|
| [Architecture](./architecture.md) | System architecture, package layout, storage model, and engine execution flow |
|
|
| [Dashboard Real-Time](./dashboard-realtime.md) | Canonical event-stream architecture contract (shared `/api/events` bus + dedicated stream boundaries), with project/node scoping, reconnect/cleanup behavior, and realtime pitfalls |
|
|
| [Storage](./storage.md) | Storage architecture, migration, archive system, and SQLite schema |
|
|
| [Dev Server Module Audit](./dev-server-modules.md) | Analysis of parallel dashboard dev-server module families, production wiring, and consolidation guidance |
|
|
| [Beads and Dolt Evaluation for Fusion Node Sync](./beads-dolt-sync-evaluation.md) | Evaluation of Beads and Dolt for node sync, with a recommendation for Fusion-native sync design |
|
|
| [Shared Mesh Replication Protocol](./shared-mesh-protocol.md) | Canonical multi-leader replication/write-coordination contract (versioning, quorum, leases/fencing, queue/replay, reconciliation, and degraded-read semantics) |
|
|
| [Contributing](./contributing.md) | Local development setup, testing, release flow, and contributor conventions |
|
|
| [Docker](./docker.md) | Container builds, deployment, and persistence configuration |
|
|
| [Code Signing](./CODE_SIGNING.md) | macOS and Windows code signing configuration for release binaries |
|
|
| [Mobile](../MOBILE.md) | Capacitor/PWA mobile development setup and workflow |
|
|
|
|
### Plugin Development
|
|
| Guide | Description |
|
|
|---|---|
|
|
| [Plugin Authoring](./PLUGIN_AUTHORING.md) | Creating Fusion plugins with the plugin system |
|
|
| [Memory Plugin Contract](./memory-plugin-contract.md) | Pluggable memory backend architecture, interface contract, and migration strategy |
|
|
|
|
### Audit Reports
|
|
| Report | Description |
|
|
|---|---|
|
|
| [UX Audit Report](./ux-audit-report.md) | Comprehensive UX audit with prioritized recommendations for dashboard improvements |
|
|
| [Codebase Improvement Audit](./codebase-improvement-audit.md) | Evidence-based technical debt and reliability gap audit with prioritized recommendations |
|
|
| [Gap Analysis](./gap-analysis.md) | System completeness analysis comparing Fusion to Paperclip feature set |
|
|
| [Agent Sandbox Research](./agent-sandboxing-research.md) | Research on agent isolation, capability enforcement, and sandboxing approaches |
|
|
| [Agent Gap Analysis](./agent-paperclip-gap-analysis.md) | Gap analysis for agent Paperclip integration |
|
|
| [pi-autoresearch Analysis for Fusion Port](./research/pi-autoresearch-analysis.md) | Upstream architecture/license analysis and Fusion integration mapping for autoresearch capabilities |
|
|
| [Research Hardening Preflight Baseline](./research/research-hardening-preflight.md) | Verified research subsystem baseline, lifecycle contracts, and hardening pressure points |
|
|
| [Test Audit Report](./test-audit-report.md) | Test coverage and effectiveness audit with recommendations |
|
|
| [Skipped Test Inventory](./skipped-test-inventory.md) | Current intentional test-skip inventory and reconciliation status for older skip follow-ups |
|
|
| [Dev Server Module Boundary Audit](./dev-server-module-boundary-audit.md) | Boundary/ownership audit for parallel `dev-server-*` vs `devserver-*` dashboard modules and FN-2212 prioritization guidance |
|
|
| [Dashboard Load Performance](./performance/dashboard-load.md) | SQLite index analysis and optimization for dashboard boot path queries |
|
|
|
|
## External Resources
|
|
|
|
- GitHub repository: https://github.com/Runfusion/Fusion
|
|
- npm package: https://www.npmjs.com/package/@runfusion/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
|