feat(FN-3309): remove PI install references and documentation
Merges the final step for FN-3309, adding a changeset to document the removal of pi install references. The changeset is the only file changed, completing the feature work. Fusion-Task-Id: FN-3309
This commit is contained in:
@@ -50,24 +50,8 @@ npm install -g @runfusion/fusion
|
||||
fn dashboard # or: fusion dashboard
|
||||
```
|
||||
|
||||
As a [pi](https://github.com/badlogic/pi-mono) extension (bundled skill + `/fn` command):
|
||||
|
||||
```bash
|
||||
pi install npm:@runfusion/fusion
|
||||
```
|
||||
|
||||
If your local Pi install gets stale or broken, open Fusion dashboard **Settings → Pi Extensions** and use **Reinstall Fusion skill** to reinstall `npm:@runfusion/fusion` and refresh discovered extensions.
|
||||
|
||||
## Launch the dashboard
|
||||
|
||||
Inside a pi session:
|
||||
|
||||
```
|
||||
/fn # start on default port 4040
|
||||
/fn stop # stop it
|
||||
/fn 8080 # run on a custom port
|
||||
```
|
||||
|
||||
From a shell:
|
||||
|
||||
```bash
|
||||
@@ -145,7 +129,7 @@ This execution model is heavily based on [Taskplane](https://www.npmjs.com/packa
|
||||
| 🌳 **Worktree isolation** | Each task runs in its own branch and worktree. Parallel tasks. Zero conflicts. |
|
||||
| ⚡ **Smart merge** | Passing every gate? Fusion squash-merges and moves on. |
|
||||
| 🛰️ **Multi-node mesh** | Laptop, server, cloud, phone — all synced. Desktop, mobile, web. |
|
||||
| 🧩 **Any model** | Anthropic, OpenAI, Ollama — or anything pi-compatible. |
|
||||
| 🧩 **Any model** | Anthropic, OpenAI, Ollama, and more. |
|
||||
| 🏢 **Agent companies** | Import pre-built teams — 440+ agents across 16 companies. |
|
||||
| 📬 **Inter-agent messaging** | Built-in mailbox between agents. Delegate, clarify, coordinate. |
|
||||
| 🗺️ **Missions** | Hierarchical planning with autopilot and validation contracts. |
|
||||
@@ -169,13 +153,13 @@ Manage tasks without leaving the conversation:
|
||||
|
||||
> "Pause FN-012 — I want to add more context first"
|
||||
|
||||
The pi extension exposes tools to create tasks, check progress, attach files, and pause or resume automation.
|
||||
The Fusion extension exposes tools to create tasks, check progress, attach files, and pause or resume automation.
|
||||
|
||||
---
|
||||
|
||||
## Standalone CLI
|
||||
|
||||
Fusion also works as a standalone CLI outside of pi. See [STANDALONE.md](./STANDALONE.md) for installation and usage without the pi extension.
|
||||
See [STANDALONE.md](./STANDALONE.md) for additional installation and usage options.
|
||||
|
||||
## Optional provider: Factory AI via Droid CLI
|
||||
|
||||
|
||||
@@ -19,11 +19,11 @@ Fusion is an AI-orchestrated task board. You throw in rough ideas; AI specifies,
|
||||
**Missions** provide hierarchical planning above tasks:
|
||||
Mission → Milestone → Slice → Feature → Task
|
||||
|
||||
**Available tools:** Fusion registers tools via the pi extension (prefixed `fn_*`). No CLI commands or Bash needed — use the registered tools directly.
|
||||
**Available tools:** Fusion registers tools (prefixed `fn_*`). No CLI commands or Bash needed — use the registered tools directly.
|
||||
|
||||
**Naming boundary:** The published pi-extension skill surface uses `fn_*` tool names (for example `fn_task_create`, `fn_mission_create`). Engine runtime sessions also inject additional `fn_*` tools (for example `fn_review_spec`, `fn_review_step`, `fn_spawn_agent`) that are not user-invokable extension tools.
|
||||
**Naming boundary:** The published skill surface uses `fn_*` tool names (for example `fn_task_create`, `fn_mission_create`). Engine runtime sessions also inject additional `fn_*` tools (for example `fn_review_spec`, `fn_review_step`, `fn_spawn_agent`) that are not part of the published skill surface.
|
||||
|
||||
**Engine runtime tools:** Triage/executor/merger/heartbeat sessions include auto-injected engine tools that do not come from the pi extension registration list. See `references/engine-tools.md` for the canonical runtime-only catalog and usage boundaries.
|
||||
**Engine runtime tools:** Triage/executor/merger/heartbeat sessions include auto-injected engine tools that are not part of the published skill surface. See `references/engine-tools.md` for the canonical runtime-only catalog and usage boundaries.
|
||||
|
||||
**Tool categories:**
|
||||
<!-- BEGIN: tool-categories (auto-generated by scripts/sync-fusion-skill-tools.mjs — do not edit by hand) -->
|
||||
@@ -85,7 +85,7 @@ Use `fn_mission_create` for high-level objectives, then add milestones, slices,
|
||||
|
||||
<known_limitations>
|
||||
|
||||
These operations are **not available** via pi extension tools and require the dashboard or CLI:
|
||||
These operations are **not available** via extension tools and require the dashboard or CLI:
|
||||
|
||||
- **Moving tasks between columns** — No tool for column moves (handled by the AI engine)
|
||||
- **Workflow steps** — Creating/managing workflow step definitions requires the dashboard
|
||||
@@ -103,7 +103,7 @@ For these operations, guide the user to the dashboard (`/fn`) or CLI commands do
|
||||
|-----------|-------------|
|
||||
| references/cli-commands.md | Full CLI command reference |
|
||||
| references/task-structure.md | Task file structure and storage |
|
||||
| references/extension-tools.md | All pi extension tools with parameters |
|
||||
| references/extension-tools.md | All extension tools with parameters |
|
||||
| references/best-practices.md | Tips for effective Fusion usage |
|
||||
| references/fusion-capabilities.md | Complete feature catalog |
|
||||
| references/engine-tools.md | Engine session-scoped runtime tools (not extension-invokable) |
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
# Engine Session-Scoped Tools
|
||||
|
||||
These tools are **not** part of the pi extension's user-invokable `extension.ts` surface. They are injected by the engine at runtime for specific agent session types.
|
||||
These tools are **not** part of the user-invokable extension surface. They are injected by the engine at runtime for specific agent session types.
|
||||
|
||||
- Source files: `packages/engine/src/agent-tools.ts`, `triage.ts`, `executor.ts`, `merger.ts`, `agent-heartbeat.ts`
|
||||
- Availability: only when the engine creates a session for the matching agent role
|
||||
- Important: do not tell users to call these directly from the generic pi extension tool list
|
||||
- Important: do not tell users to call these directly from the generic extension tool list
|
||||
|
||||
## Shared runtime tools (`agent-tools.ts`)
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Fusion Pi Extension Tools
|
||||
# Fusion Extension Tools
|
||||
|
||||
All tools are registered via the pi extension. They are available in any pi agent session when the Fusion extension is installed.
|
||||
All tools are registered via the Fusion extension. They are available in any agent session when Fusion is configured.
|
||||
|
||||
> Naming contract: all externally exposed Fusion extension tools are `fn_*` (for example `fn_task_create`). Engine runtime sessions also inject additional `fn_*` tools (for example `fn_review_step`, `fn_spawn_agent`, `fn_task_document_write`) that are separate from this extension surface and documented in `engine-tools.md`.
|
||||
|
||||
@@ -364,7 +364,7 @@ Cancel a research run.
|
||||
|
||||
### /fn
|
||||
|
||||
Start or stop the Fusion dashboard from within a pi session.
|
||||
Start or stop the Fusion dashboard from within an agent session.
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
Fusion is an AI-orchestrated task board. Tasks flow through columns:
|
||||
Triage → Todo → In Progress → In Review → Done → Archived
|
||||
|
||||
## Pi Extension Tools (Available to Agents)
|
||||
## Extension Tools (Available to Agents)
|
||||
|
||||
All skill/extension tool invocations in this catalog use the public `fn_*` namespace. Engine runtime sessions also have additional runtime-only `fn_*` tools that are intentionally not listed here (see `references/engine-tools.md`).
|
||||
|
||||
|
||||
@@ -30,7 +30,7 @@
|
||||
## Key Takeaways for Fusion Skill
|
||||
|
||||
1. **Use router pattern** — Fusion has multiple distinct workflows (task management, lifecycle, specs, dashboard/CLI)
|
||||
2. **No `allowed-tools` needed** — Fusion tools are registered via pi extension, not Bash CLI
|
||||
2. **No `allowed-tools` needed** — Fusion tools are registered via the extension, not Bash CLI
|
||||
3. **Inline essential concepts** — Task columns, workflow overview in SKILL.md
|
||||
4. **Progressive disclosure** — SKILL.md routes to workflows, workflows reference detailed docs
|
||||
5. **Pure XML structure** — No markdown headings (#, ##, ###) in body
|
||||
|
||||
@@ -3,14 +3,14 @@
|
||||
</required_reading>
|
||||
|
||||
<objective>
|
||||
Guide the agent through using the Fusion dashboard and CLI for operations not available via pi extension tools.
|
||||
Guide the agent through using the Fusion dashboard and CLI for operations not available via extension tools.
|
||||
</objective>
|
||||
|
||||
<process>
|
||||
|
||||
**Starting the dashboard:**
|
||||
|
||||
Use the `/fn` command (registered by the pi extension):
|
||||
Use the `/fn` command (registered by the Fusion extension):
|
||||
- `/fn` or `/fn 4040` — Start dashboard + AI engine on specified port (default 4040)
|
||||
- `/fn stop` — Stop the dashboard
|
||||
- `/fn status` — Check if dashboard is running
|
||||
@@ -28,7 +28,7 @@ The dashboard provides:
|
||||
|
||||
**Operations that require CLI or dashboard:**
|
||||
|
||||
These cannot be done with pi extension tools:
|
||||
These cannot be done with extension tools:
|
||||
|
||||
| Operation | CLI Command | Dashboard |
|
||||
|-----------|-------------|-----------|
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
</required_reading>
|
||||
|
||||
<objective>
|
||||
Guide the agent through creating, viewing, and managing tasks on the Fusion board using pi extension tools.
|
||||
Guide the agent through creating, viewing, and managing tasks on the Fusion board using extension tools.
|
||||
|
||||
Use only the public `fn_*` extension tools in this workflow. Do not substitute internal engine runtime tools like `task_create`, `task_update`, `task_log`, or `task_done`.
|
||||
</objective>
|
||||
|
||||
@@ -708,7 +708,7 @@ export default function kbExtension(pi: ExtensionAPI) {
|
||||
await store.moveTask(params.id, 'todo');
|
||||
|
||||
// Log the retry action
|
||||
await store.logEntry(params.id, "Retry requested via Pi extension", "Task reset to todo for retry");
|
||||
await store.logEntry(params.id, "Retry requested via Fusion extension", "Task reset to todo for retry");
|
||||
|
||||
return {
|
||||
content: [{ type: "text", text: `Retried ${params.id} → todo (failure state cleared)` }],
|
||||
|
||||
Reference in New Issue
Block a user