@runfusion/fusion 0.28.1 → 0.30.0

package/dist/pi-claude-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion/pi-claude-cli",
-  "version": "0.28.1",
+  "version": "0.30.0",
   "description": "Fusion vendored fork: pi coding-agent extension that routes LLM calls through the Claude Code CLI. Forked from rchern/pi-claude-cli (MIT). See UPSTREAM.md.",
   "license": "MIT",
   "private": true,

package/dist/plugins/fusion-plugin-cli-printing-press/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cli-printing-press",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "CLI Printing Press plugin package for Fusion",
   "private": true,

package/dist/plugins/fusion-plugin-cli-printing-press/src/__tests__/registration.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { validatePluginManifest } from "@fusion/core";
-import plugin from "../index.js";
+import plugin, { CLI_PRINTING_PRESS_WORKFLOW_STEPS } from "../index.js";
 import { ensureCliPressSchema } from "../store/cli-press-store.js";
 import { makeFakeRegistry } from "./fixtures/registry.js";
 
@@ -18,10 +18,27 @@ describe("plugin registration contracts", () => {
       expect(plugin.routes?.some((route) => route.path === "/drafts")).toBe(true);
       expect(plugin.dashboardViews?.map((view) => view.viewId)).toEqual(["wizard", "manage"]);
       expect(typeof plugin.executorRuntimeEnv).toBe("function");
-      // FN-4150/FN-3768 track future workflow step template contributions.
-      expect(plugin.workflowStepTemplates).toBeUndefined();
+      expect(plugin.workflowSteps?.length).toBeGreaterThan(0);
     } finally {
       h.cleanup();
     }
   });
+
+  it("contributes script-mode workflow step templates", () => {
+    expect(plugin.workflowSteps?.length).toBeGreaterThan(0);
+    expect(plugin.workflowSteps).toEqual(CLI_PRINTING_PRESS_WORKFLOW_STEPS);
+
+    for (const step of plugin.workflowSteps ?? []) {
+      expect(step.stepId).toMatch(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+    }
+
+    expect(
+      plugin.workflowSteps?.some((step) => step.mode === "script" && step.phase === "pre-merge"),
+    ).toBe(true);
+
+    expect(plugin.manifest.workflowSteps?.map((step) => step.stepId)).toEqual(
+      plugin.workflowSteps?.map((step) => step.stepId),
+    );
+    expect(validatePluginManifest(plugin.manifest).valid).toBe(true);
+  });
 });

package/dist/plugins/fusion-plugin-cli-printing-press/src/__tests__/workflow-integration.test.ts

@@ -1,22 +1,117 @@
-import { describe, expect, it } from "vitest";
+import { exec } from "node:child_process";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { afterEach, describe, expect, it } from "vitest";
+import { TaskStore, type WorkflowStepTemplate } from "@fusion/core";
 import plugin from "../index.js";
 import { installExecMock } from "./fixtures/exec-mock.js";
 
+const execAsync = promisify(exec);
+
+async function makeTaskStore() {
+  const rootDir = await mkdtemp(join(tmpdir(), "fn-4150-cli-printing-press-"));
+  const globalDir = await mkdtemp(join(tmpdir(), "fn-4150-cli-printing-press-global-"));
+  const store = new TaskStore(rootDir, globalDir, { inMemoryDb: true });
+  await store.init();
+  return { store, rootDir, globalDir };
+}
+
+async function cleanupTaskStore(ctx: Awaited<ReturnType<typeof makeTaskStore>>) {
+  ctx.store.stopWatching();
+  ctx.store.close();
+  await rm(ctx.rootDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 50 });
+  await rm(ctx.globalDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 50 });
+}
+
+function injectPluginTemplates(store: TaskStore): void {
+  const templates: Array<{ pluginId: string; template: WorkflowStepTemplate }> = (plugin.workflowSteps ?? []).map((template) => ({
+    pluginId: plugin.manifest.id,
+    template: {
+      id: `plugin:${plugin.manifest.id}:${template.stepId}`,
+      name: template.name,
+      description: template.description,
+      prompt: template.prompt ?? "",
+      mode: template.mode,
+      phase: template.phase,
+      scriptName: template.scriptName,
+      toolMode: template.toolMode,
+      defaultOn: template.defaultOn,
+      modelProvider: template.modelProvider,
+      modelId: template.modelId,
+      enabled: template.enabled,
+      category: "Plugin",
+      icon: "puzzle",
+    },
+  }));
+  store.setPluginWorkflowStepTemplates(templates);
+}
+
+async function runScriptStepFromSettings(store: TaskStore, scriptName: string): Promise<{ stdout: string; stderr: string }> {
+  const settings = await store.getSettings();
+  const command = settings.scripts?.[scriptName];
+  if (!command) {
+    throw new Error(`Missing script command for ${scriptName}`);
+  }
+  return execAsync(command, { timeout: 20_000, maxBuffer: 5 * 1024 * 1024 });
+}
+
 describe("workflow integration contracts", () => {
-  // FN-4150/FN-3768 track future workflow-step template + runWorkflowSteps coverage.
+  const stores: Array<Awaited<ReturnType<typeof makeTaskStore>>> = [];
+
+  afterEach(async () => {
+    while (stores.length > 0) {
+      const ctx = stores.pop();
+      if (ctx) {
+        await cleanupTaskStore(ctx);
+      }
+    }
+  });
+
   it("guards against execSync usage in workflow-oriented execution fixtures", () => {
     const execMock = installExecMock();
     execMock.assertExecSyncUnused();
     expect(typeof plugin.manifest.id).toBe("string");
   });
 
-  it("does not currently contribute plugin workflow step templates", () => {
-    expect(plugin.workflowStepTemplates).toBeUndefined();
+  it("materializes plugin script-mode workflow step through TaskStore", async () => {
+    const ctx = await makeTaskStore();
+    stores.push(ctx);
+    injectPluginTemplates(ctx.store);
+
+    const step = await ctx.store.getWorkflowStep("plugin:fusion-plugin-cli-printing-press:run-service-cli");
+    expect(step).toMatchObject({
+      id: "plugin:fusion-plugin-cli-printing-press:run-service-cli",
+      mode: "script",
+      phase: "pre-merge",
+      scriptName: "cli-printing-press:run-service-cli",
+    });
   });
 
-  it("exposes no plugin workflow step IDs to runWorkflowSteps today", () => {
-    const workflowStepTemplates = plugin.workflowStepTemplates ?? [];
-    expect(workflowStepTemplates).toEqual([]);
-    expect(workflowStepTemplates.some((template) => template.id.startsWith("plugin:"))).toBe(false);
+  it("runs a plugin script-mode step end-to-end via TaskStore plus project scripts", async () => {
+    const execMock = installExecMock();
+    execMock.setNextResult({ stdout: "ok\n", stderr: "", code: 0 });
+
+    const ctx = await makeTaskStore();
+    stores.push(ctx);
+    injectPluginTemplates(ctx.store);
+
+    await ctx.store.updateSettings({
+      scripts: {
+        "cli-printing-press:run-service-cli": "echo ok",
+      },
+    });
+
+    const step = await ctx.store.getWorkflowStep("plugin:fusion-plugin-cli-printing-press:run-service-cli");
+    expect(step).toMatchObject({
+      mode: "script",
+      scriptName: "cli-printing-press:run-service-cli",
+      phase: "pre-merge",
+    });
+
+    const result = await runScriptStepFromSettings(ctx.store, step!.scriptName!);
+    expect(result.stdout).toContain("ok");
+    execMock.assertExecSyncUnused();
   });
 });

package/dist/plugins/fusion-plugin-cli-printing-press/src/__tests__/workflow-steps-verdict-contract.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { CLI_PRINTING_PRESS_WORKFLOW_STEPS } from "../workflow-steps.js";
+
+describe("cli-printing-press workflow step verdict contract", () => {
+  it("exports a non-empty workflow step contribution list", () => {
+    expect(CLI_PRINTING_PRESS_WORKFLOW_STEPS.length).toBeGreaterThan(0);
+  });
+
+  it("requires script-mode steps to declare a non-empty scriptName", () => {
+    const scriptSteps = CLI_PRINTING_PRESS_WORKFLOW_STEPS.filter((step) => step.mode === "script");
+    expect(scriptSteps.length).toBeGreaterThan(0);
+
+    for (const step of scriptSteps) {
+      expect(step.scriptName?.trim().length ?? 0).toBeGreaterThan(0);
+    }
+  });
+
+  const promptSteps = CLI_PRINTING_PRESS_WORKFLOW_STEPS.filter((step) => step.mode === "prompt");
+
+  // Prompt-mode slice may be empty today; invariant activates automatically when prompt entries are added.
+  if (promptSteps.length === 0) {
+    it("has no prompt-mode steps today; invariant guard is dormant", () => {
+      expect(promptSteps).toHaveLength(0);
+    });
+  }
+
+  it.each(promptSteps.map((step) => [step.stepId, step] as const))(
+    "enforces structured verdict prompt contract for %s",
+    (_stepId, step) => {
+      expect(typeof step.prompt).toBe("string");
+      expect(step.prompt?.trim().length ?? 0).toBeGreaterThan(0);
+
+      const prompt = step.prompt ?? "";
+      expect(prompt).toMatch(/\{\s*"verdict"\s*:\s*"APPROVE\|APPROVE_WITH_NOTES\|REVISE"\s*,\s*"notes"\s*:/);
+      expect(prompt).not.toContain('"verdict":"PASS"');
+      expect(prompt).not.toContain('"verdict":"FAIL"');
+      expect(prompt).not.toContain("task_done(");
+      expect(prompt).not.toContain("task_log(");
+      expect(prompt).toMatch(/out of scope|Diff Scope/i);
+    },
+  );
+});

package/dist/plugins/fusion-plugin-cli-printing-press/src/index.ts

@@ -2,6 +2,7 @@ import { definePlugin } from "@fusion/plugin-sdk";
 import { createCliPrintingPressRoutes } from "./routes/wizard-routes.js";
 import { buildExecutorRuntimeEnv } from "./runtime/executor-runtime-env.js";
 import { createCliPressStore, ensureCliPressSchema } from "./store/cli-press-store.js";
+import { CLI_PRINTING_PRESS_WORKFLOW_STEPS } from "./workflow-steps.js";
 
 const storeByDb = new WeakMap<object, ReturnType<typeof createCliPressStore>>();
 
@@ -20,6 +21,7 @@ const plugin = definePlugin({
     name: "CLI Printing Press",
     version: "0.1.0",
     description: "Guided wizard for drafting external service CLI definitions",
+    workflowSteps: CLI_PRINTING_PRESS_WORKFLOW_STEPS.map((step) => ({ stepId: step.stepId, name: step.name })),
   },
   state: "installed",
   hooks: {
@@ -30,6 +32,7 @@ const plugin = definePlugin({
     const store = getStore(ctx.taskStore as { getDatabase: () => object });
     return buildExecutorRuntimeEnv(store, taskCtx, ctx);
   },
+  workflowSteps: CLI_PRINTING_PRESS_WORKFLOW_STEPS,
   dashboardViews: [
     {
       viewId: "wizard",
@@ -55,4 +58,5 @@ export { CliPrintingPressWizardView } from "./dashboard-view.js";
 export { CliPrintingPressManageView } from "./manage-view.js";
 export { CliPrintingPressTestRunner } from "./run/TestRunnerPanel.js";
 export { createCliPressStore, ensureCliPressSchema } from "./store/cli-press-store.js";
+export { CLI_PRINTING_PRESS_WORKFLOW_STEPS } from "./workflow-steps.js";
 export * from "./store/cli-press-types.js";

package/dist/plugins/fusion-plugin-cli-printing-press/src/workflow-steps.ts

@@ -0,0 +1,14 @@
+import type { PluginWorkflowStepContribution } from "@fusion/plugin-sdk";
+
+export const CLI_PRINTING_PRESS_WORKFLOW_STEPS: PluginWorkflowStepContribution[] = [
+  {
+    stepId: "run-service-cli",
+    name: "Run Service CLI",
+    description: "Run generated service CLI checks before merge using the task project script map.",
+    mode: "script",
+    phase: "pre-merge",
+    scriptName: "cli-printing-press:run-service-cli",
+    enabled: true,
+    defaultOn: false,
+  },
+];

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/reports",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "Reports plugin for Fusion",
   "private": true,

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

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/roadmap",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "WhatsApp Web (Baileys) chat bridge for Fusion agents",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfusion/fusion",
-  "version": "0.28.1",
+  "version": "0.30.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",

package/skill/fusion/SKILL.md

@@ -29,11 +29,11 @@ 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_delete`, `fn_milestone_add`, `fn_slice_add`, `fn_feature_add`, `fn_slice_activate`, `fn_feature_link_task`
+- **Mission tools** — `fn_mission_create`, `fn_mission_list`, `fn_mission_show`, `fn_mission_delete`, `fn_milestone_add`, `fn_slice_add`, `fn_feature_add`, `fn_slice_activate`, `fn_feature_link_task`, `fn_feature_update`
 - **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`
 - **Insight tools** — `fn_insight_list`, `fn_insight_show`, `fn_insight_run_list`, `fn_insight_run_show`
-- **Other tools** — `fn_web_fetch`, `fn_research_run`, `fn_research_list`, `fn_research_get`, `fn_research_cancel`, `fn_research_retry`
+- **Other tools** — `fn_web_fetch`, `fn_research_run`, `fn_research_list`, `fn_research_get`, `fn_research_cancel`, `fn_research_retry`, `fn_experiment_finalize`
 <!-- END: tool-categories -->
 - **Dashboard** — Use `/fn` command to start/stop the dashboard
 

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

@@ -248,6 +248,17 @@ Link a feature to a fn task for implementation. Updates the feature status to 't
 | `featureId` | string | ✓ | Feature ID to link (e.g., F-001) |
 | `taskId` | string | ✓ | Task ID to link to (e.g., FN-001) |
 
+### fn_feature_update
+
+Update an existing feature's title, description, or acceptance criteria. Partial patches leave untouched fields intact.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | ✓ | Feature ID to update (e.g., F-001) |
+| `title` | string | — | Updated feature title |
+| `description` | string | — | Updated feature description |
+| `acceptanceCriteria` | string | — | Updated acceptance criteria for completing the feature |
+
 ## Agent Tools
 
 ### fn_agent_stop
@@ -407,7 +418,7 @@ Lightweight URL fetch (no JS rendering). Use agent-browser skill for JS-heavy pa
 
 ### fn_research_run
 
-Start a bounded research run and optionally wait for findings.
+Cited-research pipeline: create a bounded search/fetch/synthesis run (not an autonomous experiment loop) and optionally wait for completion.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -417,7 +428,7 @@ Start a bounded research run and optionally wait for findings.
 
 ### fn_research_list
 
-List recent research runs.
+Cited-research pipeline: list recent search/fetch/synthesis runs (not experiment-loop sessions).
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -426,7 +437,7 @@ List recent research runs.
 
 ### fn_research_get
 
-Get one research run and structured findings.
+Cited-research pipeline: get one run with structured findings and citations (not experiment-loop state).
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -434,7 +445,7 @@ Get one research run and structured findings.
 
 ### fn_research_cancel
 
-Cancel an in-flight research run. Terminal runs return INVALID_TRANSITION.
+Cited-research pipeline: cancel an in-flight run; terminal runs return INVALID_TRANSITION (does not control experiment loops).
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -442,12 +453,24 @@ Cancel an in-flight research run. Terminal runs return INVALID_TRANSITION.
 
 ### fn_research_retry
 
-Retry a failed research run when lifecycle marks it retryable.
+Cited-research pipeline: retry a failed run when lifecycle marks it retryable (not an autonomous experiment loop retry).
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `id` | string | ✓ | Research run ID |
 
+### fn_experiment_finalize
+
+Group kept experiment runs into reviewable branches and finalize the session. Use dryRun=true to preview the plan without touching git.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | ✓ | Experiment session ID |
+| `integrationBranch` | string | — | Integration branch to compute merge-base against (default: main) |
+| `dryRun` | boolean | — | Preview plan only; do not create branches |
+| `planOverride` | unknown | — | Optional plan override payload |
+| `summary` | string | — | Optional finalize summary |
+
 <!-- END: extension-tools -->
 ## Dashboard Command
 

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

@@ -30,11 +30,12 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
 | `fn_task_browse_github_issues` | List open GitHub issues from a repository to browse before importing. Returns issue numbers, titles, and URLs for selection. Use with fn_task_import_github_issue to import specific issues by number. |
 | `fn_task_plan` | Create a task via AI-guided planning mode — interactive conversation to refine your idea into a well-specified task. |
 | `fn_web_fetch` | Lightweight URL fetch (no JS rendering). Use agent-browser skill for JS-heavy pages. URL to fetch (http/https) Optional extraction hint for downstream summarization Timeout in milliseconds (default: 30000) Max bytes to return (default: 512000) |
-| `fn_research_run` | Start a bounded research run and optionally wait for findings. |
-| `fn_research_list` | List recent research runs. |
-| `fn_research_get` | Get one research run and structured findings. |
-| `fn_research_cancel` | Cancel an in-flight research run. Terminal runs return INVALID_TRANSITION. |
-| `fn_research_retry` | Retry a failed research run when lifecycle marks it retryable. |
+| `fn_research_run` | Cited-research pipeline: create a bounded search/fetch/synthesis run (not an autonomous experiment loop) and optionally wait for completion. |
+| `fn_research_list` | Cited-research pipeline: list recent search/fetch/synthesis runs (not experiment-loop sessions). |
+| `fn_research_get` | Cited-research pipeline: get one run with structured findings and citations (not experiment-loop state). |
+| `fn_research_cancel` | Cited-research pipeline: cancel an in-flight run; terminal runs return INVALID_TRANSITION (does not control experiment loops). |
+| `fn_research_retry` | Cited-research pipeline: retry a failed run when lifecycle marks it retryable (not an autonomous experiment loop retry). |
+| `fn_experiment_finalize` | Group kept experiment runs into reviewable branches and finalize the session. Use dryRun=true to preview the plan without touching git. |
 | `fn_insight_list` | List persisted project insights with optional category/status filters. |
 | `fn_insight_show` | Show a single persisted insight by ID. |
 | `fn_insight_run_list` | List recent insight-generation runs with optional status/trigger filters. |
@@ -48,6 +49,7 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
 | `fn_feature_add` | Add a feature to a slice. Features are deliverables that can be linked to tasks. |
 | `fn_slice_activate` | Activate a pending slice for implementation. Sets status to 'active' and enables task linking for its features. |
 | `fn_feature_link_task` | Link a feature to a fn task for implementation. Updates the feature status to 'triaged' and associates it with the task. |
+| `fn_feature_update` | Update an existing feature's title, description, or acceptance criteria. Partial patches leave untouched fields intact. |
 | `fn_agent_stop` | Stop a running agent — pauses its execution. Transitions the agent from running/active to paused state. |
 | `fn_agent_start` | Start a stopped agent — resumes its execution. Transitions the agent from paused to active state. |
 | `fn_agent_create` | Create a new non-ephemeral agent. |