root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(FN-2997): merge fusion/fn-2997-2

Browse Source 
Merges the FN-2997 research CLI feature (275-line `research` command with routing, error handling, and docs), a droid CLI provider card for onboarding, a consolidated mock helpers module shared across CLI/dashboard/engine, the SSE architecture reference documentation, and the droid CLI probe module

Fusion-Task-Id: FN-2997
This commit is contained in:
Fusion
2026-05-01 06:18:21 -07:00
committed by gsxdsm
parent bdf5e84981
commit cf0ea341a1
9 changed files with 675 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/cli-reference.md
View File

@@ -48,6 +48,35 @@ During fresh initialization, Fusion also installs the bundled `fusion` skill int
---
## `fn research`
Manage persisted research runs from the CLI.
```bash
fn research create --query "Compare sqlite WAL vs rollback journal"
fn research create --query "Rust async runtime trade-offs" --wait --max-wait-ms 120000
fn research list --status failed --limit 20
fn research show RR-001
fn research export RR-001 --format json --output ./artifacts/research-RR-001.json
fn research cancel RR-001
fn research retry RR-001 --json
```
| Subcommand | Description |
|---|---|
| `fn research create --query <text> [--wait] [--max-wait-ms <ms>] [--json]` | Create a run and optionally wait for completion. |
| `fn research list \| ls [--status <status>] [--limit <n>] [--json]` | List recent runs (statuses: `pending`, `running`, `completed`, `failed`, `cancelled`). |
| `fn research show <run-id> [--json]` | Show one run with timestamps, summary, and error details. |
| `fn research export <run-id> [--format <json\|markdown\|pdf>] [--output <path>] [--json]` | Export run results and persist an export record. |
| `fn research cancel <run-id> [--json]` | Request cancellation for an active run. |
| `fn research retry <run-id> [--json]` | Create a new retry run from a failed/cancelled run. |
Disabled/setup behavior mirrors dashboard and agent surfaces:
- Feature disabled → `feature-disabled` error (enable research in settings)
- Provider unconfigured → `provider-unavailable` error (configure credentials/provider)
---
## `fn dashboard`
Start the web dashboard (default port `4040`, bound to `127.0.0.1`).