feat(FN-1837): merge fusion/fn-1837
This commit is contained in:
gsxdsm
@@ -10,30 +10,59 @@ Fusion is an AI-orchestrated task board that turns ideas into reviewed, merged c
|
||||
|
||||
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:
|
||||
For a full walkthrough (installation, onboarding, first task, and daily workflow basics):
|
||||
|
||||
➡️ **[Getting Started](./getting-started.md)**
|
||||
|
||||
## Documentation Index
|
||||
|
||||
| Guide | What it covers |
|
||||
### Getting Started
|
||||
| Guide | Description |
|
||||
|---|---|
|
||||
| [Getting Started](./getting-started.md) | Installation, first-run onboarding, first task, and daily workflow basics. |
|
||||
| [Architecture](./architecture.md) | System architecture, package layout, storage model, and engine execution flow. |
|
||||
| [Memory Plugin Contract](./memory-plugin-contract.md) | Pluggable memory backend architecture, interface contract, and migration strategy. |
|
||||
| [CLI Reference](./cli-reference.md) | Complete `fn` command reference with subcommands, flags, and examples. |
|
||||
| [Dashboard Guide](./dashboard-guide.md) | Detailed guide to board/list views, terminal, git manager, files, planning, and UI tools. |
|
||||
| [Task Management](./task-management.md) | Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration. |
|
||||
| [Missions](./missions.md) | Mission hierarchy, planning flow, activation, progress tracking, and autopilot behavior. |
|
||||
| [Agents](./agents.md) | Agent management, presets, prompts, heartbeat behavior, spawning, and mailbox workflows. |
|
||||
| [Workflow Steps](./workflow-steps.md) | Reusable quality gates, templates, pre/post-merge phases, and workflow execution results. |
|
||||
| [Settings Reference](./settings-reference.md) | Global and project settings, defaults, API endpoints, and model selection hierarchy. |
|
||||
| [Multi-Project](./multi-project.md) | Central registry architecture, project management, isolation modes, and migration paths. |
|
||||
| [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. |
|
||||
| [Dashboard Load Performance](./performance/dashboard-load.md) | SQLite index analysis and optimization for dashboard boot path queries. |
|
||||
| [Contributing](./contributing.md) | Local development setup, testing, release flow, and contributor conventions. |
|
||||
| [Code Signing Setup](./CODE_SIGNING.md) | macOS and Windows code signing configuration for release binaries. |
|
||||
| [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 |
|
||||
|
||||
### Task & Project Management
|
||||
| Guide | Description |
|
||||
|---|---|
|
||||
| [Task Management](./task-management.md) | Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration |
|
||||
| [Missions](./missions.md) | Mission hierarchy, planning flow, activation, progress tracking, and autopilot behavior |
|
||||
| [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 |
|
||||
| [Storage](./storage.md) | Storage architecture, migration, archive system, and SQLite schema |
|
||||
| [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 |
|
||||
| [Test Audit Report](./test-audit-report.md) | Test coverage and effectiveness audit with recommendations |
|
||||
| [Dashboard Load Performance](./performance/dashboard-load.md) | SQLite index analysis and optimization for dashboard boot path queries |
|
||||
|
||||
## External Resources
|
||||
|
||||
|
||||
@@ -65,8 +65,8 @@ At a high level, Fusion is split into:
|
||||
| `@gsxdsm/fusion` | **Published** | CLI binary (`fn`) + Pi extension | `packages/cli/src/bin.ts`, `commands/*`, `project-resolver.ts`, `extension.ts` |
|
||||
| `@fusion/desktop` | Private | Electron shell around Fusion dashboard/client | `packages/desktop/src/main.ts`, `ipc.ts`, `preload.ts`, `scripts/build.ts` |
|
||||
| `@fusion/tui` | Private | Ink-based terminal package with ScreenRouter and tab navigation | `packages/tui/src/index.tsx`, `packages/tui/src/components/screen-router.tsx` |
|
||||
|
||||
> Note: The workspace also contains `@fusion/mobile` (`packages/mobile`), which packages dashboard assets for Capacitor targets.
|
||||
| `@fusion/mobile` | Private | Capacitor + PWA mobile packaging of dashboard assets | `packages/mobile/capacitor.config.ts`, `packages/mobile/src/*` |
|
||||
| `@fusion/plugin-sdk` | Private | Plugin SDK for building Fusion extensions | `packages/plugin-sdk/src/*` |
|
||||
|
||||
---
|
||||
|
||||
@@ -126,7 +126,7 @@ Concrete references:
|
||||
- **Database adapter**: `packages/core/src/db.ts`
|
||||
- SQLite (`node:sqlite`) with WAL mode + foreign keys
|
||||
- JSON helpers: `toJson`, `toJsonNullable`, `fromJson`
|
||||
- Tables: `tasks`, `config`, `activityLog`, `archivedTasks`, `automations`, `agents`, `agentHeartbeats`, mission hierarchy tables, `__meta`
|
||||
- Tables: `tasks`, `config`, `activityLog`, `archivedTasks`, `automations`, `agents`, `agentHeartbeats`, `agentRatings`, `ai_sessions`, `workflow_steps`, `messages`, `plugins`, `routines`, `runAuditEvents`, mission hierarchy tables (`missions`, `milestones`, `slices`, `mission_features`, `mission_events`), roadmap tables (`roadmaps`, `roadmap_milestones`, `roadmap_features`), `__meta`
|
||||
- **Standalone roadmap contracts**: `packages/core/src/roadmap-types.ts`, `roadmap-ordering.ts`, `roadmap-store.ts`
|
||||
- Roadmap-first entity types (`Roadmap`, `RoadmapMilestone`, `RoadmapFeature`)
|
||||
- Pure ordering helpers for contiguous 0-based milestone/feature order and deterministic cross-milestone feature moves
|
||||
|
||||
@@ -33,6 +33,9 @@ pnpm build
|
||||
| `@fusion/dashboard` | Express API + React UI |
|
||||
| `@fusion/engine` | Scheduling, triage, execution, merge orchestration |
|
||||
| `@fusion/tui` | Ink-based terminal UI components |
|
||||
| `@fusion/desktop` | Electron shell around Fusion dashboard/client |
|
||||
| `@fusion/mobile` | Capacitor + PWA mobile packaging |
|
||||
| `@fusion/plugin-sdk` | Plugin SDK for building Fusion extensions |
|
||||
| `@gsxdsm/fusion` | Published CLI + pi extension |
|
||||
|
||||
## Development Workflow
|
||||
|
||||
Reference in New Issue
Block a user