@runfusion/fusion 0.39.0 → 0.41.0

package/dist/plugins/fusion-plugin-compound-engineering/manifest.json

@@ -0,0 +1,56 @@
+{
+  "id": "fusion-plugin-compound-engineering",
+  "name": "Compound Engineering",
+  "version": "0.1.0",
+  "description": "A dedicated dashboard surface for compound-engineering artifacts and interactive ce-* sessions.",
+  "author": "Fusion Team",
+  "fusionVersion": ">=0.1.0",
+  "dashboardViews": [
+    {
+      "viewId": "compound-engineering",
+      "label": "Compound Engineering",
+      "componentPath": "./dashboard-view",
+      "icon": "Sparkles",
+      "placement": "primary",
+      "order": 36
+    }
+  ],
+  "settingsSchema": {
+    "defaultProvider": {
+      "type": "string",
+      "label": "Default Session Provider",
+      "description": "Model provider used for CE interactive sessions (for example anthropic). Leave blank to use the host default.",
+      "group": "Sessions",
+      "defaultValue": ""
+    },
+    "defaultModelId": {
+      "type": "string",
+      "label": "Default Session Model",
+      "description": "Model ID within the provider used for CE interactive sessions. Leave blank to use the host default.",
+      "group": "Sessions",
+      "defaultValue": ""
+    },
+    "enabledStages": {
+      "type": "array",
+      "itemType": "string",
+      "label": "Enabled Stages",
+      "description": "Stage IDs that may be launched from the Compound Engineering view (for example strategy, ideate, brainstorm, plan, work).",
+      "group": "Sessions",
+      "defaultValue": ["strategy", "ideate", "brainstorm", "plan", "work"]
+    },
+    "reconcileOnHooks": {
+      "type": "boolean",
+      "label": "Reconcile on Board Changes",
+      "description": "Run the board→pipeline reconcile sweep automatically after task move/complete hooks. Disable to only reconcile on demand.",
+      "group": "Sync",
+      "defaultValue": true
+    },
+    "reconcileIntervalMinutes": {
+      "type": "number",
+      "label": "Reconcile Cadence (minutes)",
+      "description": "Cadence hint for how often an on-demand refresh surface sweeps the reconciler. Not a continuous poll loop.",
+      "group": "Sync",
+      "defaultValue": 15
+    }
+  }
+}

package/dist/plugins/fusion-plugin-compound-engineering/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@fusion-plugin-examples/compound-engineering",
+  "version": "0.1.3",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./bundled.js"
+    }
+  },
+  "private": true
+}

package/dist/plugins/fusion-plugin-cursor-runtime/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-cursor-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cursor-runtime",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-dependency-graph/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-dependency-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/dependency-graph",
-  "version": "0.1.31",
+  "version": "0.1.34",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-droid-runtime/bundled.js

@@ -129072,6 +129072,11 @@ var init_openai_responses = __esm({
 });
 
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-droid-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/droid-runtime",
-  "version": "0.1.26",
+  "version": "0.1.29",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-hermes-runtime/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-hermes-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/hermes-runtime",
-  "version": "0.2.50",
+  "version": "0.2.53",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-openclaw-runtime/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-openclaw-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/openclaw-runtime",
-  "version": "0.2.50",
+  "version": "0.2.53",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-paperclip-runtime/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-paperclip-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/paperclip-runtime",
-  "version": "0.2.50",
+  "version": "0.2.53",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-reports/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/reports",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "type": "module",
   "description": "Reports plugin for Fusion",
   "private": true,
@@ -37,6 +37,6 @@
     "@types/react": "^19.0.0",
     "@types/node": "^25.5.2",
     "typescript": "^5.7.0",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.0"
   }
 }

package/dist/plugins/fusion-plugin-reports/src/__tests__/review-panel.test.ts

@@ -83,9 +83,9 @@ describe("runReviewPanel", () => {
       if (systemPrompt.includes("Operations")) {
         return {
           session: {
-            prompt: vi.fn(async () => new Promise(() => {})),
+            prompt: vi.fn(async () => new Promise<void>(() => {})),
             state: { messages: [] },
-            dispose: vi.fn(),
+            dispose: vi.fn<() => void>(),
           },
         };
       }
@@ -93,7 +93,7 @@ describe("runReviewPanel", () => {
         session: {
           prompt: vi.fn(async () => {}),
           state: { messages: [{ role: "assistant", content: JSON.stringify({ verdict: "approve", summary: "ok", highlights: [], lowlights: [], suggestions: [] }) }] },
-          dispose: vi.fn(),
+          dispose: vi.fn<() => void>(),
         },
       };
     });

package/dist/plugins/fusion-plugin-reports/src/index.ts

@@ -16,7 +16,6 @@ import {
 } from "./settings.js";
 import type { ReportCadence, ReportCreateInput } from "./store/report-types.js";
 import { ReportStore } from "./store/report-store.js";
-export { ReportsDashboardView } from "./dashboard-view.js";
 
 const plugin = definePlugin({
   manifest: {

package/dist/plugins/fusion-plugin-roadmap/bundled.js

@@ -1,4 +1,9 @@
 // ../plugin-sdk/src/index.ts
+import {
+  WORKFLOW_EXTENSION_SCHEMA_VERSION,
+  workflowExtensionRegistryId,
+  createBoardActionServices
+} from "@fusion/core";
 function definePlugin(plugin2) {
   return plugin2;
 }

package/dist/plugins/fusion-plugin-roadmap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/roadmap",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "type": "module",
   "exports": {
     ".": {

package/dist/plugins/fusion-plugin-whatsapp-chat/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/whatsapp-chat",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "type": "module",
   "description": "WhatsApp Web (Baileys) chat bridge for Fusion agents",
   "keywords": [
@@ -29,6 +29,6 @@
   "devDependencies": {
     "@types/node": "^25.5.2",
     "typescript": "^5.7.0",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.0"
   }
 }

package/dist/routine-store-GIJ6MXWY.js

@@ -0,0 +1,10 @@
+import {
+  RoutineStore
+} from "./chunk-LYZVU6UV.js";
+import "./chunk-RXMQ5OMY.js";
+import "./chunk-BHM3UYWS.js";
+import "./chunk-AWKNRUOR.js";
+import "./chunk-4VNS5WPM.js";
+export {
+  RoutineStore
+};

package/dist/routine-store-HTVC2PUQ.js

@@ -0,0 +1,10 @@
+import {
+  RoutineStore
+} from "./chunk-6JDLN7IL.js";
+import "./chunk-RXMQ5OMY.js";
+import "./chunk-MCUG2Z7M.js";
+import "./chunk-GUV4QQT3.js";
+import "./chunk-4VNS5WPM.js";
+export {
+  RoutineStore
+};

package/dist/routine-store-KGHZBPDF.js

@@ -0,0 +1,10 @@
+import {
+  RoutineStore
+} from "./chunk-UXR5XZFZ.js";
+import "./chunk-RXMQ5OMY.js";
+import "./chunk-BMUXDSBF.js";
+import "./chunk-5RGECGQL.js";
+import "./chunk-4VNS5WPM.js";
+export {
+  RoutineStore
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfusion/fusion",
-  "version": "0.39.0",
+  "version": "0.41.0",
   "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",
@@ -12,8 +12,8 @@
     "pi-package"
   ],
   "bin": {
-    "fn": "./dist/bin.js",
-    "fusion": "./dist/bin.js"
+    "fn": "./bin.mjs",
+    "fusion": "./bin.mjs"
   },
   "pi": {
     "extensions": [
@@ -28,6 +28,7 @@
     "access": "public"
   },
   "files": [
+    "bin.mjs",
     "dist/**/*.js",
     "dist/**/*.d.ts",
     "dist/**/*.d.ts.map",
@@ -40,17 +41,20 @@
     "README.md"
   ],
   "dependencies": {
-    "@earendil-works/pi-ai": "^0.77.0",
-    "@earendil-works/pi-coding-agent": "^0.77.0",
+    "@earendil-works/pi-ai": "^0.79.1",
+    "@earendil-works/pi-coding-agent": "^0.79.1",
     "dockerode": "^4.0.12",
     "express": "^5.1.0",
-    "ink": "^6.8.0",
+    "i18next": "^26.3.1",
+    "ink": "^7.0.5",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "ioredis": "^5.6.0",
     "multer": "^2.1.1",
     "node-pty": "npm:@homebridge/node-pty-prebuilt-multiarch@^0.13.1",
-    "react": "^19.0.0"
+    "react": "^19.2.0",
+    "react-i18next": "^17.0.8",
+    "ws": "^8.18.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
@@ -70,8 +74,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@types/react": "^19.0.0",
-    "@vitest/coverage-v8": "^3.1.0",
+    "@types/react": "^19.2.0",
+    "@types/ws": "^8.5.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "cross-env": "^7.0.0",
     "esbuild": "^0.25.12",
     "ink-testing-library": "^4.0.0",
@@ -79,13 +84,21 @@
     "tsx": "^4.19.0",
     "typebox": "^1.0.0",
     "typescript": "^5.7.0",
-    "vitest": "^3.1.0",
+    "vitest": "^4.1.0",
     "yaml": "^2.8.3"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/Runfusion/Fusion"
   },
+  "exports": {
+    "./plugin-sdk": {
+      "types": "./dist/plugin-sdk/index.d.ts",
+      "import": "./dist/plugin-sdk/index.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "dev": "tsx src/bin.ts",
     "prebuild": "node ../../scripts/sync-fusion-skill-tools.mjs",
@@ -94,6 +107,7 @@
     "build:exe:all": "bun run build.ts --all",
     "typecheck": "tsc --noEmit",
     "test": "vitest run --silent=passed-only --reporter=dot",
+    "test:ci-shape": "vitest run src/__tests__/ci-workflow.test.ts --silent=passed-only --reporter=dot",
     "test:slow-cli": "cross-env FUSION_TEST_SLOW_CLI=1 vitest run src/commands/__tests__/agent-export.test.ts --silent=passed-only --reporter=dot",
     "test:extension-integration": "cross-env FUSION_TEST_EXTENSION_INTEGRATION=1 vitest run src/__tests__/extension-integration.test.ts --silent=passed-only --reporter=dot",
     "test:build-exe": "cross-env FUSION_TEST_BUILD_EXE=1 vitest run --config vitest.build-exe.config.ts --silent=passed-only --reporter=dot",

package/skill/fusion/SKILL.md

@@ -29,7 +29,7 @@ Mission → Milestone → Slice → Feature → Task
 <!-- BEGIN: tool-categories (auto-generated by scripts/sync-fusion-skill-tools.mjs — do not edit by hand) -->
 - **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`
-- **Mission tools** — `fn_mission_create`, `fn_mission_list`, `fn_mission_show`, `fn_mission_backfill_assertions`, `fn_mission_delete`, `fn_mission_update`, `fn_milestone_add`, `fn_slice_add`, `fn_feature_add`, `fn_feature_delete`, `fn_slice_delete`, `fn_milestone_delete`, `fn_slice_activate`, `fn_feature_link_task`, `fn_feature_update`, `fn_milestone_update`
+- **Mission tools** — `fn_mission_create`, `fn_mission_list`, `fn_mission_show`, `fn_mission_list_goals`, `fn_mission_link_goal`, `fn_mission_unlink_goal`, `fn_mission_backfill_assertions`, `fn_mission_delete`, `fn_mission_update`, `fn_milestone_add`, `fn_slice_add`, `fn_feature_add`, `fn_feature_delete`, `fn_slice_delete`, `fn_milestone_delete`, `fn_slice_activate`, `fn_feature_link_task`, `fn_feature_update`, `fn_milestone_update`
 - **Goal tools** — `fn_goal_list`, `fn_goal_create`, `fn_goal_archive`, `fn_goal_show`
 - **Agent tools** — `fn_agent_stop`, `fn_agent_start`, `fn_agent_create`, `fn_agent_delete`, `fn_list_agents`, `fn_delegate_task`, `fn_agent_show`, `fn_agent_org_chart`
 - **Skills tools** — `fn_skills_search`, `fn_skills_install`

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

@@ -11,10 +11,27 @@ These tools are **not** part of the user-invokable extension surface. They are i
 
 | Tool | Agent Types | Purpose | Parameters |
 |---|---|---|---|
-| `fn_task_create` | triage, executor, heartbeat | Create a follow-up task from within an agent run | `description` (string), `dependencies?` (string[]), `priority?` (`low` \| `normal` \| `high` \| `urgent`) |
+| `fn_task_create` | triage, executor, heartbeat | Create a follow-up task from within an agent run | `description` (string), `dependencies?` (string[]), `priority?` (`low` \| `normal` \| `high` \| `urgent`), `workflow_id?` (string) |
 | `fn_task_log` | executor, heartbeat | Write significant task log entries | `message` (string), `outcome?` (string) |
 | `fn_task_document_write` | triage, executor, heartbeat | Save/update a named task document revision | `key` (string), `content` (string), `author?` (string) |
 | `fn_task_document_read` | triage, executor, heartbeat | Read one task document or list all | `key?` (string) |
+| `fn_goal_list` | triage, executor, heartbeat | List goals with concise citation-ready snippets and active-goal warning details | `status?` (`active` \| `archived` \| `all`) |
+| `fn_goal_show` | triage, executor, heartbeat | Show one goal's full detail on demand, including the full description body | `id` (string) |
+| `fn_workflow_list` | executor | List the project's custom workflows (read-only built-ins plus user definitions) | none |
+| `fn_workflow_get` | executor | Fetch one workflow definition by id — name, description, builtin flag, and the full IR (nodes/edges/columns/artifacts/fields/settings) as JSON | `workflow_id` (string) |
+| `fn_workflow_select` | executor | Assign a custom workflow to a task (defaults to the current task) | `workflow_id` (string), `task_id?` (string) |
+| `fn_workflow_create` | executor | Create a custom workflow definition from a graph IR (validated server-side). v2 IR supports step-inversion constructs: `parse-steps`, `foreach` (mode/isolation/concurrency/maxReworkCycles), `step-execute`, `step-review`, `code` nodes, `rework` edges, plus `artifacts`, custom `fields`, and typed `settings` declarations | `name` (string), `description?` (string), `ir` (object), `layout?` (object) |
+| `fn_workflow_update` | executor | Update a custom workflow definition's name/description/ir/layout (built-ins cannot be edited; same step-inversion IR constructs as create; editing `fields` orphans rather than destroys existing task values; editing `settings` declarations drops orphaned setting values on resolution) | `workflow_id` (string), `name?` (string), `description?` (string), `ir?` (object), `layout?` (object), `rehome_to?` (string) |
+| `fn_workflow_delete` | executor | Delete a custom workflow definition (built-ins cannot be deleted); selecting tasks are re-homed to the default workflow's entry column | `workflow_id` (string) |
+| `fn_workflow_settings` | executor | Read/write a workflow's per-`(workflow, project)` setting **values** (`get` returns `{stored, effective, orphaned}`; `set` writes `values` and returns `{stored, effective, orphaned}`, with `null` clearing an override — including any stored value for an orphaned key). Validated against the named workflow's declared settings; built-in **values** are writable though built-in **declarations** are not; invalid values return a typed rejection list and persist nothing | `action` (`get` \| `set`), `workflow_id` (string), `values?` (object keyed by setting id) |
+| `fn_workflow_list` | executor, chat, planning | List the project's custom workflows (read-only built-ins plus user definitions) | none |
+| `fn_workflow_get` | executor, chat, planning | Fetch one workflow definition by id — name, description, builtin flag, and the full IR (nodes/edges/columns/artifacts/fields) as JSON | `workflow_id` (string) |
+| `fn_workflow_select` | executor, chat, planning | Assign a custom workflow to a task (defaults to the current task) | `workflow_id` (string), `task_id?` (string) |
+| `fn_workflow_create` | executor, chat, planning | Create a custom workflow definition from a graph IR (validated server-side). v2 IR supports step-inversion constructs: `parse-steps`, `foreach` (mode/isolation/concurrency/maxReworkCycles), `step-execute`, `step-review`, `code` nodes, `rework` edges, plus `artifacts` and custom `fields` declarations | `name` (string), `description?` (string), `ir` (object), `layout?` (object) |
+| `fn_workflow_update` | executor, chat, planning | Update a custom workflow definition's name/description/ir/layout (built-ins cannot be edited; same step-inversion IR constructs as create; editing `fields` orphans rather than destroys existing task values) | `workflow_id` (string), `name?` (string), `description?` (string), `ir?` (object), `layout?` (object), `rehome_to?` (string) |
+| `fn_workflow_delete` | executor, chat, planning | Delete a custom workflow definition (built-ins cannot be deleted); selecting tasks are re-homed to the default workflow's entry column | `workflow_id` (string) |
+| `fn_task_promote` | executor | Promote a held task out of a manual-release hold column (defaults to the current task) | `task_id?` (string) |
+| `fn_trait_list` | executor, chat, planning | List the registered column trait catalog (built-in and plugin traits) | none |
 | `fn_memory_search` | triage, executor, heartbeat | Search project memory plus per-agent layered memory snippets | `query` (string), `limit?` (number) |
 | `fn_memory_get` | triage, executor, heartbeat | Read a bounded memory file window (including bounded per-agent layered paths) | `path` (string), `startLine?` (number), `lineCount?` (number) |
 | `fn_memory_append` | executor, heartbeat (when writable backend enabled) | Append memory notes with explicit scope: `scope="agent"` for private operating context, `scope="project"` for workspace-wide durable knowledge | `scope?` (`project` \| `agent`), `layer` (`long-term` \| `daily`), `content` (string) |
@@ -27,7 +44,7 @@ These tools are **not** part of the user-invokable extension surface. They are i
 | `fn_update_identity` | heartbeat | Update the current agent's own `soul`, `instructionsText`, or `memory` fields | `soul?` (string), `instructionsText?` (string), `memory?` (string) |
 | `fn_reflect_on_performance` | executor, heartbeat (when reflection service enabled) | Generate reflection insights from prior runs | `focus_area?` (string) |
 | `fn_list_agents` | triage, executor, heartbeat | List agents (optionally filtered) | `role?` (string), `state?` (string), `includeEphemeral?` (boolean) |
-| `fn_delegate_task` | triage, executor, heartbeat | Create and assign a new task to a specific agent | `agent_id` (string), `description` (string), `dependencies?` (string[]), `override?` (boolean) |
+| `fn_delegate_task` | triage, executor, heartbeat | Create and assign a new task to a specific agent | `agent_id` (string), `description` (string), `dependencies?` (string[]), `workflow_id?` (string), `override?` (boolean) |
 | `fn_get_agent_config` | executor, heartbeat | Read full config for a direct-report agent | `agent_id` (string) |
 | `fn_update_agent_config` | executor, heartbeat | Update config fields for a direct-report, non-ephemeral agent | `agent_id` (string), optional: `soul`, `instructions_text`, `instructions_path`, `heartbeat_procedure_path`, `heartbeat_interval_ms`, `heartbeat_timeout_ms`, `max_concurrent_runs`, `message_response_mode` |
 | `fn_agent_create` | executor, heartbeat | Create a non-ephemeral direct-report agent | `name` (string), `role` (string), optional: `soul`, `instructions_text`, `instructions_path`, `reportsTo`, `heartbeat_interval_ms`, `heartbeat_timeout_ms`, `max_concurrent_runs`, `message_response_mode` |
@@ -51,7 +68,7 @@ Note: step-session execution (`step-session-executor.ts`) reuses executor coordi
 
 | Tool | Purpose | Parameters |
 |---|---|---|
-| `fn_task_update` | Update a spec step status (`pending`/`in-progress`/`done`/`skipped`) | `step` (number), `status` (enum) |
+| `fn_task_update` | Update a spec step status (`pending`/`in-progress`/`done`/`skipped`), task dependencies, and/or workflow-defined custom field values | `step?` (number, 1-indexed), `status?` (enum), `dependencies?` (string[]), `custom_fields?` (object keyed by field id; validated against the workflow field schema, `null` clears a field) |
 | `fn_task_add_dep` | Add a dependency to current task (confirmation-gated) | `task_id` (string), `confirm?` (boolean) |
 | `fn_task_done` | Mark task complete and optionally store summary | `summary?` (string) |
 | `fn_review_step` | Spawn step plan/code reviewer | `step` (number), `type` (`plan` \| `code`), `step_name` (string), `baseline?` (string) |
@@ -68,3 +85,62 @@ Note: step-session execution (`step-session-executor.ts`) reuses executor coordi
 | Tool | Purpose | Parameters |
 |---|---|---|
 | `fn_heartbeat_done` | Signal end of heartbeat run with optional summary | `summary?` (string) |
+
+## Workflow settings: declarations vs. values
+
+Workflow settings split into two surfaces (the same split as custom task fields, one level up):
+
+- **Declarations** (the typed schema) live in the workflow IR's `settings` array and are authored with `fn_workflow_create` / `fn_workflow_update`. Built-in workflow declarations cannot be edited (the store's built-in guard rejects the IR edit with a `WorkflowIrError`/built-in error surfaced through the tool result).
+- **Values** (the per-`(workflow, project)` data) are read/written with `fn_workflow_settings`. Built-in workflow **values** are writable so each project can tune `builtin:coding` differently.
+
+Declare a setting (custom workflow):
+
+```jsonc
+// fn_workflow_create
+{
+  "name": "QA",
+  "ir": {
+    "version": "v2",
+    "name": "QA",
+    "columns": [{ "id": "intake", "name": "Intake", "traits": [] }],
+    "nodes": [],
+    "edges": [],
+    "settings": [
+      { "id": "reviewHandoffPolicy", "name": "Review handoff", "type": "enum",
+        "default": "disabled",
+        "options": [
+          { "value": "disabled", "label": "Disabled" },
+          { "value": "always", "label": "Always" }
+        ] }
+    ]
+  }
+}
+```
+
+Write a value (built-in workflow VALUE — accepted even though built-in declarations are read-only):
+
+```jsonc
+// fn_workflow_settings
+{ "action": "set", "workflow_id": "builtin:coding",
+  "values": { "workflowStepTimeoutMs": 600000, "reviewHandoffPolicy": "always" } }
+```
+
+An invalid value (e.g. an enum violation) is rejected with a typed list and persists nothing:
+
+```jsonc
+// returns isError:true with details.rejections:
+// [{ "code": "enum-violation", "settingId": "reviewHandoffPolicy", "message": "..." }]
+```
+
+Read values — `effective` is what the engine actually consumes (declaration defaults filled in, orphaned values dropped); `stored` is the raw override map; `orphaned` lists stored entries with no current declaration (or a value that no longer validates). `set` returns the same `{stored, effective, orphaned}` shape:
+
+```jsonc
+// fn_workflow_settings
+{ "action": "get", "workflow_id": "builtin:coding" }
+// → { "workflowId": "builtin:coding",
+//     "stored":    { "workflowStepTimeoutMs": 600000 },
+//     "effective": { "workflowStepTimeoutMs": 600000, "reviewHandoffPolicy": "disabled", ... },
+//     "orphaned":  [] }
+```
+
+Patching a key to `null` clears any stored value for it — including a value left behind under an orphaned key — so `set` doubles as the way to drop orphans. To see the full declaration catalog (every setting id, type, and default) call `fn_workflow_get` on `builtin:coding`, whose IR `settings` array is the canonical catalog.

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

@@ -10,7 +10,7 @@ All tools are registered via the Fusion extension. They are available in any age
 
 ### fn_task_create
 
-Create a new task on the Fusion task board. The task enters the planning column where the AI planning agent will plan it into a full prompt with steps, file scope, and acceptance criteria.
+Create a new task on the Fusion task board. The task enters the planning column where the AI planning agent will plan it into a full prompt with steps, file scope, and acceptance criteria. Optionally pass workflow_id to select a workflow at creation time; use fn_workflow_list to discover valid IDs.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -18,10 +18,11 @@ Create a new task on the Fusion task board. The task enters the planning column
 | `depends` | array | — | Task IDs this depends on (e.g. ['FN-001', 'FN-002']) |
 | `agentId` | string | — | Agent ID to assign this task to (e.g. 'agent-abc123') |
 | `priority` | string(enum) | — | Task priority (low, normal, high, urgent) |
+| `workflow_id` | string | — | Workflow ID to select for the new task (e.g. 'WF-003' or 'builtin:coding'). |
 
 ### fn_task_update
 
-Update fields on an existing task. Supports modifying the title, description, dependencies, assigned agent, and priority after task creation.
+Update fields on an existing task. Supports modifying the title, description, dependencies, assigned agent, priority, and workflow_id after task creation. Set workflow_id to a workflow ID to select it, or null to clear the workflow selection.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -32,6 +33,7 @@ Update fields on an existing task. Supports modifying the title, description, de
 | `agentId` | union | — | Agent ID to assign this task to, or null to clear (e.g. 'agent-abc123') |
 | `nodeId` | union | — | Node ID override for this task, or null to clear |
 | `priority` | string(enum) | — | Task priority (low, normal, high, urgent) |
+| `workflow_id` | union | — | Workflow ID to select for this task (e.g. 'WF-003' or 'builtin:coding'), |
 
 ### fn_task_list
 
@@ -196,6 +198,32 @@ Show mission details with full hierarchy: milestones → slices → features.
 |-----------|------|----------|-------------|
 | `id` | string | ✓ | Mission ID (e.g., M-001) |
 
+### fn_mission_list_goals
+
+List goals linked to a mission.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `missionId` | string | ✓ | Mission ID (e.g., M-001) |
+
+### fn_mission_link_goal
+
+Link a goal to a mission.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `missionId` | string | ✓ | Mission ID (e.g., M-001) |
+| `goalId` | string | ✓ | Goal ID (e.g., G-001) |
+
+### fn_mission_unlink_goal
+
+Unlink a goal from a mission.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `missionId` | string | ✓ | Mission ID (e.g., M-001) |
+| `goalId` | string | ✓ | Goal ID (e.g., G-001) |
+
 ### fn_mission_backfill_assertions
 
 Backfill mission assertions by deriving and linking one store-managed assertion for each feature without linked assertions. Supports dry-run mode.
@@ -412,13 +440,14 @@ List all available agents in the system. Shows each agent's name, role, state, p
 
 ### fn_delegate_task
 
-Create a new task and assign it to a specific agent for execution. The task goes to 'todo' and will be picked up by the target agent on their next heartbeat cycle. Use fn_list_agents first to find available agents and their capabilities.
+Create a new task and assign it to a specific agent for execution. The task goes to 'todo' and will be picked up by the target agent on their next heartbeat cycle. Use fn_list_agents first to find available agents and their capabilities. Optionally pass workflow_id to select a workflow at creation time; use fn_workflow_list to discover valid IDs.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `agent_id` | string | ✓ | The agent ID to delegate work to |
 | `description` | string | ✓ | What needs to be done |
 | `dependencies` | array | — | Task IDs this new task depends on (e.g. [\"KB-001\"] |
+| `workflow_id` | string | — | Workflow ID to select for the new task (e.g. 'WF-003' or 'builtin:coding'). |
 | `override` | boolean | — | Set true to bypass executor-role assignment policy |
 
 ### fn_agent_show