@runfusion/fusion 0.1.1 → 0.1.3

package/dist/pi-claude-cli/src/types.ts

@@ -0,0 +1,87 @@
+// Wire protocol types for Claude CLI stream-json NDJSON communication
+
+// NDJSON message types from Claude CLI stdout
+
+export interface ClaudeStreamEventMessage {
+  type: "stream_event";
+  event: ClaudeApiEvent;
+  /** Present on sub-agent stream events; null/undefined for top-level events. */
+  parent_tool_use_id?: string | null;
+}
+
+export interface ClaudeResultMessage {
+  type: "result";
+  subtype: "success" | "error";
+  result?: string;
+  error?: string;
+  session_id?: string;
+}
+
+export interface ClaudeSystemMessage {
+  type: "system";
+  subtype: string;
+  session_id?: string;
+  tools?: unknown[];
+}
+
+export interface ClaudeControlRequest {
+  type: "control_request";
+  request_id: string;
+  request: {
+    subtype: "can_use_tool";
+    tool_name: string;
+    input: Record<string, unknown>;
+  };
+}
+
+export type NdjsonMessage =
+  | ClaudeStreamEventMessage
+  | ClaudeResultMessage
+  | ClaudeSystemMessage
+  | ClaudeControlRequest;
+
+// Claude API event types (inside stream_event wrapper)
+
+export interface ClaudeApiEvent {
+  type: string; // message_start, content_block_start, content_block_delta, content_block_stop, message_delta, message_stop
+  index?: number;
+  message?: {
+    id?: string;
+    type?: string;
+    role?: string;
+    content?: unknown[];
+    model?: string;
+    usage?: ClaudeUsage;
+  };
+  content_block?: {
+    type: string; // "text", "tool_use", "thinking"
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: string;
+  };
+  delta?: {
+    type?: string; // "text_delta", "input_json_delta", "thinking_delta", "signature_delta"
+    text?: string;
+    partial_json?: string;
+    thinking?: string;
+    signature?: string;
+    stop_reason?: string;
+  };
+  usage?: ClaudeUsage;
+}
+
+export interface ClaudeUsage {
+  input_tokens?: number;
+  output_tokens?: number;
+  cache_read_input_tokens?: number;
+  cache_creation_input_tokens?: number;
+}
+
+// Content block tracking during stream processing
+
+export interface TrackedContentBlock {
+  type: "text" | "thinking";
+  text: string;
+  index: number; // Claude's content_block index
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfusion/fusion",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "license": "MIT",
   "description": "Fusion CLI: HTTP API server, daemon, dashboard launcher, and task tooling for the Fusion AI coding agent.",
   "homepage": "https://github.com/Runfusion/Fusion#readme",
@@ -33,12 +33,13 @@
     "dist/**/*.d.ts.map",
     "dist/**/*.js.map",
     "dist/client/**",
+    "dist/pi-claude-cli/**",
     "skill/**",
     "README.md"
   ],
   "dependencies": {
-    "@mariozechner/pi-ai": "^0.62.0",
-    "@mariozechner/pi-coding-agent": "^0.62.0",
+    "@mariozechner/pi-ai": "^0.70.0",
+    "@mariozechner/pi-coding-agent": "^0.70.0",
     "express": "^5.1.0",
     "ioredis": "^5.6.0",
     "multer": "^2.1.1"
@@ -46,7 +47,7 @@
   "peerDependencies": {
     "@mariozechner/pi-ai": "*",
     "@mariozechner/pi-coding-agent": "*",
-    "@sinclair/typebox": "*"
+    "typebox": "*"
   },
   "peerDependenciesMeta": {
     "@mariozechner/pi-ai": {
@@ -55,12 +56,12 @@
     "@mariozechner/pi-coding-agent": {
       "optional": true
     },
-    "@sinclair/typebox": {
+    "typebox": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@sinclair/typebox": "^0.34.0",
+    "typebox": "^1.0.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.1.0",
     "tsup": "^8.5.1",
@@ -68,9 +69,10 @@
     "typescript": "^5.7.0",
     "vitest": "^3.1.0",
     "yaml": "^2.8.3",
-    "@fusion/core": "0.1.0",
     "@fusion/dashboard": "0.1.0",
-    "@fusion/engine": "0.1.0"
+    "@fusion/engine": "0.1.0",
+    "@fusion/pi-claude-cli": "0.3.1",
+    "@fusion/core": "0.1.0"
   },
   "repository": {
     "type": "git",
@@ -82,6 +84,7 @@
     "build:exe": "bun run build.ts",
     "build:exe:all": "bun run build.ts --all",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run --silent=passed-only --reporter=dot"
+    "test": "vitest run --silent=passed-only --reporter=dot",
+    "test:build-exe": "FUSION_TEST_BUILD_EXE=1 vitest run --config vitest.build-exe.config.ts --silent=passed-only --reporter=dot"
   }
 }

package/skill/fusion/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: fusion
-description: AI-orchestrated task board (Fusion/kb) interface. Use when working with the Fusion task management system, creating or managing tasks, understanding task workflows, organizing work into missions, or interfacing with the kb dashboard. Triggers on "create a task", "list tasks", "show board", "plan a mission", "check task status", "import issues", or any Fusion/kb interaction.
+description: AI-orchestrated task board (Fusion) interface. Use when working with the Fusion task management system, creating or managing tasks, understanding task workflows, organizing work into missions, or interfacing with the Fusion dashboard. Triggers on "create a task", "list tasks", "show board", "plan a mission", "check task status", "import issues", or any Fusion interaction.
 ---
 
 <essential_principles>
 
-Fusion (kb) is an AI-orchestrated task board. You throw in rough ideas; AI specifies, executes, reviews, and delivers them.
+Fusion is an AI-orchestrated task board. You throw in rough ideas; AI specifies, executes, reviews, and delivers them.
 
 **Task lifecycle:** Triage → Todo → In Progress → In Review → Done → Archived
 
@@ -21,6 +21,8 @@ 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.
 
+**Naming boundary:** The published skill surface always uses `fn_*` tool names (for example `fn_task_create`, `fn_mission_create`). Internal engine runtime tools like `task_create`, `task_update`, `task_log`, and `task_done` are intentionally unprefixed and not part of this skill.
+
 **Tool categories:**
 - **Task tools** — `fn_task_create`, `fn_task_update`, `fn_task_list`, `fn_task_show`, `fn_task_attach`, `fn_task_pause`, `fn_task_unpause`, `fn_task_retry`, `fn_task_duplicate`, `fn_task_refine`, `fn_task_archive`, `fn_task_unarchive`, `fn_task_delete`, `fn_task_plan`
 - **GitHub tools** — `fn_task_import_github`, `fn_task_import_github_issue`, `fn_task_browse_github_issues`
@@ -59,7 +61,7 @@ Use `fn_task_create` with a descriptive message. Include the problem AND desired
 Use `fn_task_list` to see all tasks grouped by column. Use `column` param to filter.
 
 **Show task details:**
-Use `fn_task_show` with the task ID (e.g., KB-001) to see steps, progress, and log.
+Use `fn_task_show` with the task ID (e.g., FN-001) to see steps, progress, and log.
 
 **Plan complex work:**
 Use `fn_task_plan` for AI-guided planning that interviews you before creating the task.
@@ -82,7 +84,7 @@ These operations are **not available** via pi extension tools and require the da
 - **Moving tasks between columns** — No tool for column moves (handled by the AI engine)
 - **Workflow steps** — Creating/managing workflow step definitions requires the dashboard
 - **Settings** — Changing settings requires the dashboard or `fn settings set` CLI command
-- **Steering comments** — Adding steering comments to guide task execution requires CLI (`fn task steer`)
+- **Task comments** — Adding comments or steering guidance requires CLI (`fn task comment`, `fn task steer`) or the dashboard comments tab
 - **Merge operations** — Merging completed tasks requires CLI (`fn task merge`) or auto-merge
 
 For these operations, guide the user to the dashboard (`/fn`) or CLI commands documented in workflows/dashboard-cli.md.

package/skill/fusion/references/cli-commands.md

@@ -17,27 +17,27 @@ fn dashboard --dev                        # Web UI only (no AI engine)
 ```bash
 fn task create "description"              # Create task → triage
 fn task create "desc" --attach file.png   # Create with attachment
-fn task create "desc" --depends KB-001    # Create with dependency
+fn task create "desc" --depends FN-001    # Create with dependency
 fn task plan "description"                # AI-guided planning mode
 fn task list                              # List all tasks by column
-fn task show KB-001                       # Show task details + steps + log
-fn task move KB-001 todo                  # Move task to column
-fn task merge KB-001                      # Merge in-review task to main
-fn task duplicate KB-001                  # Copy task to triage
-fn task refine KB-001 --feedback "..."    # Create follow-up task
-fn task archive KB-001                    # Move done → archived
-fn task unarchive KB-001                  # Move archived → done
-fn task delete KB-001 [--force]           # Permanently delete
-fn task retry KB-001                      # Retry failed task → todo
-fn task comment KB-001 "text"             # Add general comment
-fn task comments KB-001                   # List task comments
-fn task steer KB-001 "guidance"           # Add steering comment for AI
-fn task pause KB-001                      # Pause automation
-fn task unpause KB-001                    # Resume automation
-fn task logs KB-001                       # View agent execution logs
-fn task logs KB-001 --follow              # Stream logs in real-time
-fn task logs KB-001 --limit 50            # Limit log lines
-fn task logs KB-001 --type tool           # Filter by log type
+fn task show FN-001                       # Show task details + steps + log
+fn task move FN-001 todo                  # Move task to column
+fn task merge FN-001                      # Merge in-review task to main
+fn task duplicate FN-001                  # Copy task to triage
+fn task refine FN-001 --feedback "..."    # Create follow-up task
+fn task archive FN-001                    # Move done → archived
+fn task unarchive FN-001                  # Move archived → done
+fn task delete FN-001 [--force]           # Permanently delete
+fn task retry FN-001                      # Retry failed task → todo
+fn task comment FN-001 "text"             # Add general comment
+fn task comments FN-001                   # List task comments
+fn task steer FN-001 "guidance"           # Add steering comment for AI
+fn task pause FN-001                      # Pause automation
+fn task unpause FN-001                    # Resume automation
+fn task logs FN-001                       # View agent execution logs
+fn task logs FN-001 --follow              # Stream logs in real-time
+fn task logs FN-001 --limit 50            # Limit log lines
+fn task logs FN-001 --type tool           # Filter by log type
 ```
 
 ## Mission Management
@@ -57,9 +57,9 @@ fn task import owner/repo                  # Import all open issues
 fn task import owner/repo --interactive    # Select issues interactively
 fn task import owner/repo --limit 10       # Limit import count
 fn task import owner/repo --labels bug     # Filter by labels
-fn task pr-create KB-001                   # Create GitHub PR
-fn task pr-create KB-001 --title "Fix"     # PR with custom title
-fn task pr-create KB-001 --base main       # PR targeting specific base
+fn task pr-create FN-001                   # Create GitHub PR
+fn task pr-create FN-001 --title "Fix"     # PR with custom title
+fn task pr-create FN-001 --base main       # PR targeting specific base
 ```
 
 ## Git Operations

package/skill/fusion/references/extension-tools.md

@@ -2,6 +2,8 @@
 
 All tools are registered via the pi extension. They are available in any pi agent session when the Fusion extension is installed.
 
+> Naming contract: all externally exposed Fusion extension tools are `fn_*` (for example `fn_task_create`). Internal engine/executor runtime tools (`task_create`, `task_update`, `task_log`, `task_done`, etc.) are separate and intentionally out of scope for this skill surface.
+
 ## Task Tools
 
 ### fn_task_create
@@ -239,7 +241,7 @@ Activate a pending slice for implementation.
 
 ### fn_feature_link_task
 
-Link a feature to a kb task. Updates feature status to triaged.
+Link a feature to a Fusion task. Updates feature status to triaged.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|

package/skill/fusion/references/fusion-capabilities.md

@@ -2,17 +2,19 @@
 
 ## Overview
 
-Fusion (kb) is an AI-orchestrated task board. Tasks flow through columns:
+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)
 
+All skill/extension tool invocations in this catalog use the public `fn_*` namespace. Engine runtime tools (for example `task_create`, `task_update`, `task_log`, `task_done`) are internal and intentionally not listed here.
+
 | Tool | Purpose |
 |------|---------|
 | `fn_task_create` | Create a new task in triage |
 | `fn_task_update` | Update task title, description, or dependencies |
 | `fn_task_list` | List all tasks grouped by column |
-| `fn_task_show` | Show full task details, steps, log |
+| `fn_task_show` | Show full task details, steps, and log preview |
 | `fn_task_attach` | Attach a file to a task |
 | `fn_task_pause` | Pause automation for a task |
 | `fn_task_unpause` | Resume automation for a task |
@@ -42,54 +44,44 @@ Triage → Todo → In Progress → In Review → Done → Archived
 
 ## CLI Commands (fn)
 
-### Dashboard
+### Dashboard and Node Runtime
 - `fn dashboard` — Start web UI + AI engine
 - `fn dashboard --paused` — Start with automation paused
 - `fn dashboard --dev` — Start web UI only (no AI engine)
+- `fn serve` — Start headless node mode (API + engine, no UI)
+- `fn daemon` — Start daemon mode with auth
 
 ### Task Management
 - `fn task create "description"` — Create a new task
 - `fn task plan "description"` — AI-guided planning mode
 - `fn task list` — List all tasks
-- `fn task show KB-001` — Show task details
-- `fn task move KB-001 todo` — Move task to a column
-- `fn task merge KB-001` — Merge an in-review task
-- `fn task duplicate KB-001` — Duplicate a task
-- `fn task refine KB-001 --feedback "..."` — Create refinement task
-- `fn task archive/unarchive KB-001` — Archive/restore tasks
-- `fn task delete KB-001` — Delete a task
-- `fn task retry KB-001` — Retry a failed task
-- `fn task comment KB-001 "..."` — Add a task comment
-- `fn task steer KB-001 "..."` — Add steering comment
-- `fn task pause/unpause KB-001` — Control automation
-- `fn task logs KB-001` — View task agent logs
-
-### GitHub Integration
+- `fn task show FN-001` — Show task details
+- `fn task move FN-001 todo` — Move task to a column
+- `fn task merge FN-001` — Merge an in-review task
+- `fn task duplicate FN-001` — Duplicate a task
+- `fn task refine FN-001 --feedback "..."` — Create refinement task
+- `fn task archive FN-001` / `fn task unarchive FN-001` — Archive/restore tasks
+- `fn task delete FN-001` — Delete a task
+- `fn task retry FN-001` — Retry a failed task
+- `fn task comment FN-001 "..."` — Add a task comment
+- `fn task steer FN-001 "..."` — Add steering comment
+- `fn task pause FN-001` / `fn task unpause FN-001` — Control automation
+- `fn task logs FN-001` — View task agent logs
+
+### GitHub, Skills, and Settings
 - `fn task import owner/repo` — Batch import issues
-- `fn task import owner/repo -i` — Interactive import
-- `fn task pr-create KB-001` — Create PR for task
-
-### Git Commands
-- `fn git status/fetch/pull/push` — Git operations
-
-### Settings
-- `fn settings` — Show current settings
-- `fn settings set key value` — Update a setting
-
-## AI Engine Components
-
-1. **TriageProcessor** — Auto-specifications for tasks in triage column
-2. **Scheduler** — Dependency resolution, concurrency management
-3. **TaskExecutor** — Creates worktrees, executes tasks with coding tools
+- `fn task pr-create FN-001` — Create PR for task
+- `fn skills search "react"` — Search skill registry
+- `fn skills install owner/repo --skill <name>` — Install a skill
+- `fn settings` / `fn settings set key value` — View/update settings
 
 ## Task Storage Structure
 
 ```
-.kb/
-├── kb.db                    # SQLite database (WAL mode)
-├── config.json              # Board config
+.fusion/
+├── fusion.db                # SQLite database (WAL mode)
 └── tasks/
-    └── KB-001/
+    └── FN-001/
         ├── PROMPT.md        # Task specification
         ├── agent.log        # Execution logs
         └── attachments/     # File attachments
@@ -106,7 +98,7 @@ Triage → Todo → In Progress → In Review → Done → Archived
 - Workflow step manager
 - Scheduled tasks (automations)
 - GitHub import modal
-- Theme system (8+ themes, dark/light/system)
+- Theme system with dark/light support and color themes
 
 ## Key Settings
 
@@ -116,6 +108,6 @@ Triage → Todo → In Progress → In Review → Done → Archived
 | `maxTriageConcurrent` | 2 | Concurrent triage/specification agents. Falls back to `maxConcurrent` when undefined. |
 | `autoMerge` | true | Auto-merge completed tasks |
 | `requirePlanApproval` | false | Manual approval for specs |
-| `prCompletionMode` | direct | Completion: direct/pr-first |
+| `prCompletionMode` | direct | Completion mode: direct/pr-first |
 | `taskStuckTimeoutMs` | — | Stuck task detection timeout |
 | `recycleWorktrees` | false | Pool and reuse worktrees |

package/skill/fusion/references/task-structure.md

@@ -12,7 +12,7 @@ Fusion uses a hybrid storage architecture: structured metadata in SQLite, large
 ├── fusion.db                # SQLite database (WAL mode)
 ├── config.json              # Board config + workflow steps
 └── tasks/
-    └── KB-001/
+    └── FN-001/
         ├── PROMPT.md        # Task specification (generated by triage AI)
         ├── agent.log        # Execution logs from the AI agent
         └── attachments/     # File attachments
@@ -26,7 +26,7 @@ Key fields stored in the `tasks` table:
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | Task ID (e.g., KB-001) |
+| `id` | string | Task ID (e.g., FN-001) |
 | `title` | string? | Short title (optional, can be auto-generated) |
 | `description` | string | Full task description |
 | `column` | string | Current column: triage/todo/in-progress/in-review/done/archived |
@@ -56,7 +56,7 @@ Key fields stored in the `tasks` table:
 The AI triage agent generates this file with the following structure:
 
 ```markdown
-# Task: KB-001 — Task Title
+# Task: FN-001 — Task Title
 
 **Created:** 2026-03-31
 **Size:** M
@@ -69,7 +69,7 @@ What the task should accomplish.
 
 ## Dependencies
 
-- KB-040 — Prerequisite task description
+- FN-040 — Prerequisite task description
 
 ## Context to Read First
 

package/skill/fusion/workflows/dashboard-cli.md

@@ -32,11 +32,11 @@ These cannot be done with pi extension tools:
 
 | Operation | CLI Command | Dashboard |
 |-----------|-------------|-----------|
-| Move task to column | `fn task move KB-001 todo` | Drag card between columns |
-| Merge completed task | `fn task merge KB-001` | Click merge in task detail |
-| Add steering comment | `fn task steer KB-001 "Use TypeScript"` | Comments tab in task detail |
-| Add general comment | `fn task comment KB-001 "Looks good"` | Comments tab in task detail |
-| View agent logs | `fn task logs KB-001 --follow` | Agent log tab in task detail |
+| Move task to column | `fn task move FN-001 todo` | Drag card between columns |
+| Merge completed task | `fn task merge FN-001` | Click merge in task detail |
+| Add steering comment | `fn task steer FN-001 "Use TypeScript"` | Comments tab in task detail |
+| Add general comment | `fn task comment FN-001 "Looks good"` | Comments tab in task detail |
+| View agent logs | `fn task logs FN-001 --follow` | Agent log tab in task detail |
 | Change settings | `fn settings set maxConcurrent 4` | Settings modal |
 | Create workflow steps | — | Workflow Steps button in header |
 | Git operations | `fn git status/fetch/pull/push` | Git manager panel |
@@ -60,7 +60,7 @@ Key settings (configure via dashboard Settings or `fn settings set`):
 
 When `prCompletionMode` is set to "pr-first":
 - Completed tasks create a GitHub PR instead of direct-merging
-- Use `fn task pr-create KB-001` to manually create a PR for any in-review task
+- Use `fn task pr-create FN-001` to manually create a PR for any in-review task
 - PRs can be reviewed and merged through the normal GitHub workflow
 
 **Backup operations:**

package/skill/fusion/workflows/specifications.md

@@ -5,6 +5,8 @@
 
 <objective>
 Guide the agent through creating well-specified tasks and organizing work using the mission hierarchy for complex multi-phase projects.
+
+All tool examples in this workflow intentionally use the public `fn_*` extension namespace.
 </objective>
 
 <process>
@@ -92,11 +94,11 @@ For large-scale projects spanning multiple tasks, use the mission hierarchy:
    fn_slice_activate({ id: "SL-001" })
    ```
 
-6. **Link features to tasks** — Connect features to kb tasks
+6. **Link features to tasks** — Connect features to Fusion tasks
    ```
    fn_task_create({ description: "Create user model with email, password hash, and timestamps" })
-   # → Created KB-101
-   fn_feature_link_task({ featureId: "F-001", taskId: "KB-101" })
+   # → Created FN-101
+   fn_feature_link_task({ featureId: "F-001", taskId: "FN-101" })
    ```
 
 **Mission status flows automatically:**

package/skill/fusion/workflows/task-lifecycle.md

@@ -87,7 +87,7 @@ The AI triage agent sets the review level based on task complexity and risk asse
 **Interpreting `fn_task_show` output:**
 
 ```
-KB-042: Fix login validation
+FN-042: Fix login validation
 Column: In Progress · Size: M · Review: 2
 
 Steps (2/5):

package/skill/fusion/workflows/task-management.md

@@ -5,6 +5,8 @@
 
 <objective>
 Guide the agent through creating, viewing, and managing tasks on the Fusion board using pi 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>
 
 <process>
@@ -27,7 +29,7 @@ Example:
 ```
 fn_task_create({
   description: "The login form doesn't validate email format before submission. Add client-side email validation that shows an inline error message when the email is invalid. Use the existing form validation pattern from the signup form.",
-  depends: ["KB-042"]
+  depends: ["FN-042"]
 })
 ```