@runfusion/fusion 0.41.0 → 0.43.0

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

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/acp-runtime",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "exports": {
     ".": {

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

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

package/dist/plugins/fusion-plugin-compound-engineering/bundled.js

@@ -65,6 +65,30 @@ var COMPOUND_ENGINEERING_SKILLS = [
     skillFiles: ["skills/ce-compound/SKILL.md"],
     enabled: true,
     triggerPatterns: ["compound this", "document this learning", "capture this solution"]
+  },
+  {
+    skillId: "ce-commit",
+    name: "ce-commit",
+    description: "Create a git commit with a clear, value-communicating message following repo conventions.",
+    skillFiles: ["skills/ce-commit/SKILL.md"],
+    enabled: true,
+    triggerPatterns: ["commit", "commit this", "save my changes", "create a commit"]
+  },
+  {
+    skillId: "ce-commit-push-pr",
+    name: "ce-commit-push-pr",
+    description: "Commit, push, and open a PR with an adaptive, value-first description that scales with the change.",
+    skillFiles: ["skills/ce-commit-push-pr/SKILL.md"],
+    enabled: true,
+    triggerPatterns: ["commit and PR", "ship this", "create a PR", "open a pull request"]
+  },
+  {
+    skillId: "ce-resolve-pr-feedback",
+    name: "ce-resolve-pr-feedback",
+    description: "Resolve PR review feedback by evaluating validity and fixing issues in parallel.",
+    skillFiles: ["skills/ce-resolve-pr-feedback/SKILL.md"],
+    enabled: true,
+    triggerPatterns: ["resolve PR feedback", "address review comments", "fix review feedback"]
   }
 ];
 
@@ -138,6 +162,72 @@ function isPluginLocalPath(p) {
   return isAbsolute(p) && !GLOBAL_SKILL_DIR_PATTERN.test(resolve(p) + sep);
 }
 
+// ../../plugins/fusion-plugin-compound-engineering/src/agent-installation.ts
+import { cpSync as cpSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2 } from "node:fs";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2, resolve as resolve2, sep as sep2 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+function resolveBundledAgentsRoot() {
+  const here = fileURLToPath2(import.meta.url);
+  const dir = dirname2(here);
+  const local = resolve2(dir, "agents");
+  if (existsSync2(local)) return local;
+  return resolve2(dir, "..", "src", "agents");
+}
+function resolveDefaultAgentsInstallTargetRoot() {
+  const here = fileURLToPath2(import.meta.url);
+  return resolve2(dirname2(here), "..", ".fusion-ce-agents");
+}
+var GLOBAL_AGENT_DIR_PATTERN = /[\\/]\.(claude|codex|gemini)[\\/]agents([\\/]|$)/;
+function assertPluginLocalAgentsTarget(targetRoot) {
+  const normalized = resolve2(targetRoot);
+  if (GLOBAL_AGENT_DIR_PATTERN.test(normalized + sep2)) {
+    throw new Error(
+      `Refusing to install Compound Engineering agents into a global client agents directory: ${normalized}. Install target MUST be plugin-local (never <home>/.claude|.codex|.gemini/agents).`
+    );
+  }
+}
+function assertValidAgentSource(agentId, sourceFile) {
+  if (!existsSync2(sourceFile)) {
+    throw new Error(`Bundled agent def missing for '${agentId}': ${sourceFile}`);
+  }
+  const content = readFileSync2(sourceFile, "utf-8");
+  if (!/^---[\s\S]*?\bname\s*:\s*\S/m.test(content)) {
+    throw new Error(`Bundled agent def '${agentId}' at ${sourceFile} is missing a frontmatter 'name:' field`);
+  }
+}
+function installBundledCeAgents(options = {}) {
+  const targetRoot = options.targetRoot ? resolve2(options.targetRoot) : resolveDefaultAgentsInstallTargetRoot();
+  assertPluginLocalAgentsTarget(targetRoot);
+  const sourceRoot = options.sourceRoot ? resolve2(options.sourceRoot) : resolveBundledAgentsRoot();
+  const sourceFiles = existsSync2(sourceRoot) ? readdirSync(sourceRoot).filter((f) => f.endsWith(".md")) : [];
+  const results = sourceFiles.map((file) => {
+    const agentId = file.replace(/\.md$/, "");
+    const sourceFile = join2(sourceRoot, file);
+    const targetFile = join2(targetRoot, file);
+    try {
+      assertValidAgentSource(agentId, sourceFile);
+      if (existsSync2(targetFile)) {
+        return { agentId, sourceFile, targetFile, outcome: "skipped", reason: "existing install preserved" };
+      }
+      mkdirSync2(targetRoot, { recursive: true });
+      cpSync2(sourceFile, targetFile);
+      return { agentId, sourceFile, targetFile, outcome: "installed" };
+    } catch (error) {
+      return {
+        agentId,
+        sourceFile,
+        targetFile,
+        outcome: "error",
+        reason: error instanceof Error ? error.message : String(error)
+      };
+    }
+  });
+  return { targetRoot, results };
+}
+function isPluginLocalAgentsPath(p) {
+  return isAbsolute2(p) && !GLOBAL_AGENT_DIR_PATTERN.test(resolve2(p) + sep2);
+}
+
 // ../../plugins/fusion-plugin-compound-engineering/src/schema.ts
 function ensureCeSchema(db) {
   db.exec(`
@@ -216,8 +306,8 @@ function ensureCeSchema(db) {
 }
 
 // ../../plugins/fusion-plugin-compound-engineering/src/session/orchestrator.ts
-import { mkdirSync as mkdirSync2, writeFileSync } from "node:fs";
-import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2 } from "node:path";
+import { mkdirSync as mkdirSync3, writeFileSync } from "node:fs";
+import { dirname as dirname3, isAbsolute as isAbsolute3, join as join3 } from "node:path";
 
 // ../../plugins/fusion-plugin-compound-engineering/src/sync/pipeline-store.ts
 import { randomUUID } from "node:crypto";
@@ -755,6 +845,7 @@ var MAX_ACTIVITY_TURNS = 200;
 var MAX_ACTIVITY_TURN_CHARS = 16e3;
 var MAX_PERSISTED_ACTIVITY_TURNS = 50;
 var MAX_PERSISTED_ACTIVITY_TURN_CHARS = 4e3;
+var INTERACTIVE_AI_UNAVAILABLE_MESSAGE = "Session cannot be continued in this process: interactive AI sessions are unavailable (no factory on this context). Resume from a route context with the engine loaded.";
 var CE_EVENTS = {
   turn: "compound-engineering:session-turn",
   question: "compound-engineering:session-question",
@@ -1000,8 +1091,36 @@ var CeOrchestrator = class {
       );
     }
     const live = this.live.get(sessionId);
+    if (!live && !this.factory) {
+      throw new Error(INTERACTIVE_AI_UNAVAILABLE_MESSAGE);
+    }
+    const turn = this.runAnswerTurn(session, questionId, response);
+    if (opts.detach) {
+      if (!live) {
+        this.store.update(sessionId, { status: "active", error: null });
+      }
+      void turn;
+      return { session: this.requireSession(sessionId) };
+    }
+    return turn;
+  }
+  async runAnswerTurn(session, questionId, response) {
+    const sessionId = session.id;
+    let live = this.live.get(sessionId);
     if (!live) {
-      throw new Error(`Session ${sessionId} has no live handle in this process; call resume() first.`);
+      try {
+        await this.rehydrate(session);
+        live = this.live.get(sessionId);
+        if (!live) {
+          throw new Error(`Session ${sessionId} could not be rehydrated with a live handle.`);
+        }
+      } catch (err) {
+        const interrupted = this.interruptSession(sessionId, err);
+        return {
+          session: interrupted,
+          event: { type: "error", data: { message: interrupted.error ?? "interrupted", cause: err } }
+        };
+      }
     }
     this.store.appendHistory(sessionId, {
       role: "user",
@@ -1009,12 +1128,7 @@ var CeOrchestrator = class {
       at: (/* @__PURE__ */ new Date()).toISOString()
     });
     this.store.update(sessionId, { status: "active", currentQuestion: null });
-    const turn = this.runTurn(sessionId, () => live.answer(questionId, response), live);
-    if (opts.detach) {
-      void turn;
-      return { session: this.requireSession(sessionId) };
-    }
-    return turn;
+    return this.runTurn(sessionId, () => live.answer(questionId, response), live);
   }
   /**
    * Resume an `awaiting_input`, `interrupted`, or `error` session — and, crucially,
@@ -1051,7 +1165,7 @@ var CeOrchestrator = class {
     if (!this.factory) {
       const next = this.store.update(sessionId, {
         status: "interrupted",
-        error: "Session cannot be continued in this process: interactive AI sessions are unavailable (no factory on this context). Resume from a route context with the engine loaded."
+        error: INTERACTIVE_AI_UNAVAILABLE_MESSAGE
       }) ?? session;
       return { session: next };
     }
@@ -1128,6 +1242,22 @@ var CeOrchestrator = class {
   getState(sessionId) {
     return this.store.get(sessionId);
   }
+  /**
+   * Cancel a session: stop any live in-process handle but keep the persisted row
+   * for inspection/resume by marking it `interrupted`. Unlike discard(), cancel
+   * preserves the conversation and progress; discard stops the handle AND deletes
+   * the row. Terminal sessions are idempotent no-ops.
+   */
+  cancel(sessionId) {
+    const session = this.store.get(sessionId);
+    if (!session) return void 0;
+    if (session.status === "completed" || session.status === "error" || session.status === "interrupted") {
+      return session;
+    }
+    const interrupted = this.interruptSession(sessionId, new Error("Cancelled by user"));
+    this.disposeLive(sessionId);
+    return interrupted;
+  }
   /**
    * Discard a session: dispose any live in-process handle (so an in-flight
    * agent doesn't keep running unobserved) and delete the persisted row.
@@ -1288,9 +1418,9 @@ var CeOrchestrator = class {
     const stage = getStage(session.stage);
     const location = stage?.artifactLocation ?? `docs/ce/${session.stage}/`;
     const content = this.extractArtifactContent(data);
-    const target = location.endsWith("/") ? join2(location, `${session.stage}-${session.id}.md`) : location;
-    const abs = isAbsolute2(target) ? target : join2(this.projectRoot, target);
-    mkdirSync2(dirname2(abs), { recursive: true });
+    const target = location.endsWith("/") ? join3(location, `${session.stage}-${session.id}.md`) : location;
+    const abs = isAbsolute3(target) ? target : join3(this.projectRoot, target);
+    mkdirSync3(dirname3(abs), { recursive: true });
     writeFileSync(abs, content, "utf-8");
     return abs;
   }
@@ -1322,6 +1452,35 @@ var CeOrchestrator = class {
   }
 };
 
+// ../../plugins/fusion-plugin-compound-engineering/src/session/session-recovery.ts
+var DEFAULT_RECOVERY_SCAN_TTL_MS = 12e4;
+var lastRecoveryScanAt = /* @__PURE__ */ new WeakMap();
+function recoverStaleSessionsForContext(ctx, options) {
+  const key = ctx.taskStore;
+  const now = options.now ?? Date.now();
+  const ttlMs = options.ttlMs ?? DEFAULT_RECOVERY_SCAN_TTL_MS;
+  if (!options.force) {
+    const last = lastRecoveryScanAt.get(key) ?? 0;
+    if (now - last < ttlMs) return [];
+  }
+  lastRecoveryScanAt.set(key, now);
+  try {
+    const recovered = getCeSessionStore(ctx).recoverStaleSessions(now);
+    if (recovered.length > 0) {
+      ctx.logger.info(`Compound Engineering recovered stale session(s) during ${options.reason}: ${recovered.join(", ")}`);
+      if (options.emitEvent) {
+        ctx.emitEvent("compound-engineering:sessions-recovered", { sessionIds: recovered, reason: options.reason });
+      }
+    }
+    return recovered;
+  } catch (err) {
+    ctx.logger.warn(
+      `Compound Engineering stale-session recovery skipped during ${options.reason}: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return [];
+  }
+}
+
 // ../../plugins/fusion-plugin-compound-engineering/src/routes/route-helpers.ts
 function asString2(v) {
   return typeof v === "string" && v.length > 0 ? v : void 0;
@@ -1401,12 +1560,24 @@ function createSessionRoutes() {
         }
       }
     },
+    {
+      method: "POST",
+      path: "/sessions/:id/cancel",
+      description: "Cancel an in-flight CE session (stops the agent, keeps the row as interrupted).",
+      handler: async (req, ctx) => {
+        const id = req.params.id;
+        const session = getOrchestrator(ctx).cancel(id);
+        if (!session) return { status: 404, body: { error: `Session ${id} not found` } };
+        return { status: 200, body: { session } };
+      }
+    },
     {
       method: "GET",
       path: "/sessions/:id",
       description: "Get current session state, including in-flight working output (liveActivity).",
       handler: async (req, ctx) => {
         const id = req.params.id;
+        recoverStaleSessionsForContext(ctx, { reason: "route" });
         const session = getCeSessionStore(ctx).get(id);
         if (!session) return { status: 404, body: { error: `Session ${id} not found` } };
         const liveActivity = getOrchestrator(ctx).getLiveActivity(id);
@@ -1421,6 +1592,7 @@ function createSessionRoutes() {
       path: "/sessions",
       description: "List CE sessions (optionally filtered by status/stage).",
       handler: async (req, ctx) => {
+        recoverStaleSessionsForContext(ctx, { reason: "route" });
         const query = req.query ?? {};
         const status = asCeSessionStatus(typeof query.status === "string" ? query.status : void 0);
         const stage = typeof query.stage === "string" ? query.stage : void 0;
@@ -1456,8 +1628,8 @@ function createSessionRoutes() {
 }
 
 // ../../plugins/fusion-plugin-compound-engineering/src/artifacts/discovery.ts
-import { accessSync, constants, readdirSync, readFileSync as readFileSync2, statSync } from "node:fs";
-import { isAbsolute as isAbsolute3, join as join3, relative, sep as sep2 } from "node:path";
+import { accessSync, constants, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "node:fs";
+import { isAbsolute as isAbsolute4, join as join4, relative, sep as sep3 } from "node:path";
 var CONVENTIONAL_LOCATIONS = [
   { stage: "strategy", label: "Strategy", path: "STRATEGY.md", kind: "file" },
   { stage: "ideation", label: "Ideation", path: "docs/ideation", kind: "directory" },
@@ -1468,13 +1640,13 @@ var CONVENTIONAL_LOCATIONS = [
 ];
 var MAX_ARTIFACT_BYTES = 2e6;
 function toPosix(p) {
-  return p.split(sep2).join("/");
+  return p.split(sep3).join("/");
 }
 function isWithin(root, locationAbs, candidate) {
   const relToLocation = relative(locationAbs, candidate);
-  if (relToLocation.startsWith("..") || isAbsolute3(relToLocation)) return false;
+  if (relToLocation.startsWith("..") || isAbsolute4(relToLocation)) return false;
   const relToRoot = relative(root, candidate);
-  if (relToRoot.startsWith("..") || isAbsolute3(relToRoot)) return false;
+  if (relToRoot.startsWith("..") || isAbsolute4(relToRoot)) return false;
   return true;
 }
 function makeId(stage, relPath) {
@@ -1522,7 +1694,7 @@ function sortEntries(entries) {
   });
 }
 function discoverLocation(root, loc) {
-  const locationAbs = join3(root, loc.path);
+  const locationAbs = join4(root, loc.path);
   const entries = [];
   let present = false;
   let st;
@@ -1558,7 +1730,7 @@ function discoverLocation(root, loc) {
       );
       return { stage: loc.stage, label: loc.label, present, entries: sortEntries(entries) };
     }
-    names = readdirSync(locationAbs);
+    names = readdirSync2(locationAbs);
   } catch (err) {
     entries.push(makeError(loc.stage, toPosix(loc.path), err instanceof Error ? err.message : String(err)));
     return { stage: loc.stage, label: loc.label, present, entries: sortEntries(entries) };
@@ -1566,8 +1738,8 @@ function discoverLocation(root, loc) {
   for (const childName of names) {
     if (childName.startsWith(".")) continue;
     if (!childName.toLowerCase().endsWith(".md")) continue;
-    const abs = join3(locationAbs, childName);
-    const relPath = toPosix(join3(loc.path, childName));
+    const abs = join4(locationAbs, childName);
+    const relPath = toPosix(join4(loc.path, childName));
     let childStat;
     try {
       childStat = statSync(abs);
@@ -1600,8 +1772,8 @@ function readArtifactById(projectRoot, id) {
   const relPath = id.slice(sepIdx + 1);
   const loc = CONVENTIONAL_LOCATIONS.find((l) => l.stage === stage);
   if (!loc) return void 0;
-  const locationAbs = join3(projectRoot, loc.path);
-  const abs = join3(projectRoot, relPath);
+  const locationAbs = join4(projectRoot, loc.path);
+  const abs = join4(projectRoot, relPath);
   if (loc.kind === "file") {
     if (toPosix(relPath) !== toPosix(loc.path)) return void 0;
   } else if (!isWithin(projectRoot, locationAbs, abs)) {
@@ -1609,7 +1781,7 @@ function readArtifactById(projectRoot, id) {
   }
   if (loc.kind === "directory") {
     const rel = relative(locationAbs, abs);
-    if (rel.includes(sep2) || rel.startsWith("..") || !rel.toLowerCase().endsWith(".md")) {
+    if (rel.includes(sep3) || rel.startsWith("..") || !rel.toLowerCase().endsWith(".md")) {
       return void 0;
     }
   }
@@ -1627,7 +1799,7 @@ function readArtifactById(projectRoot, id) {
     return { error: err instanceof Error ? err.message : String(err) };
   }
   try {
-    content = readFileSync2(abs, "utf8");
+    content = readFileSync3(abs, "utf8");
   } catch (err) {
     return { error: err instanceof Error ? err.message : String(err) };
   }
@@ -1939,8 +2111,42 @@ var plugin = definePlugin({
         const message = error instanceof Error ? error.message : String(error);
         ctx.logger.error(`Compound Engineering skill install failed: ${message}`);
       }
+      try {
+        const { targetRoot, results } = installBundledCeAgents();
+        const installed = results.filter((r) => r.outcome === "installed").length;
+        const errored = results.filter((r) => r.outcome === "error");
+        if (errored.length > 0) {
+          ctx.logger.warn(
+            `Compound Engineering: ${errored.length} agent def(s) failed to install: ${errored.map((e) => `${e.agentId} (${e.reason})`).join(", ")}`
+          );
+        }
+        ctx.logger.info(
+          `Compound Engineering agent personas ready \u2014 installed=${installed} target=${targetRoot}`
+        );
+        ctx.emitEvent("compound-engineering:agents-installed", { targetRoot, results });
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ctx.logger.error(`Compound Engineering agent install failed: ${message}`);
+      }
+      recoverStaleSessionsForContext(ctx, { reason: "load", force: true, emitEvent: true });
     }
   },
+  // Expose the plugin-local ce-* persona-definition directory to executor /
+  // workflow-step sessions via FUSION_CE_AGENTS_DIR. The CE skills read a persona
+  // def from here and pass its body to fn_spawn_agent's systemPromptOverride —
+  // the lightweight subagent path (no plugin agent-contribution channel exists).
+  // Defs are installed in onLoad.
+  executorRuntimeEnv: () => ({
+    env: {
+      FUSION_CE_AGENTS_DIR: resolveDefaultAgentsInstallTargetRoot(),
+      // Step sessions run with cwd=projectRoot, so a CE skill can't reach its
+      // bundled scripts via a relative `scripts/...` path. Expose the installed
+      // skills root so skill docs can invoke scripts by absolute path
+      // (`"$FUSION_CE_SKILLS_DIR/<skill-id>/scripts/<name>"`).
+      FUSION_CE_SKILLS_DIR: resolveDefaultInstallTargetRoot()
+    },
+    description: "compound-engineering ce-* persona definitions and bundled skills directories"
+  }),
   routes: [...createSessionRoutes(), ...createArtifactRoutes()],
   dashboardViews: [
     {
@@ -1973,12 +2179,16 @@ export {
   getReconcileIntervalMinutes,
   getReconcileOnHooks,
   getStage,
+  installBundledCeAgents,
   installBundledCeSkills,
+  isPluginLocalAgentsPath,
   isPluginLocalPath,
   listStages,
   reconcileCePipelines,
   registerStage,
+  resolveBundledAgentsRoot,
   resolveBundledSkillsRoot,
+  resolveDefaultAgentsInstallTargetRoot,
   resolveDefaultInstallTargetRoot,
   settingsSchema
 };

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

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/compound-engineering",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "exports": {
     ".": {

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

@@ -1,6 +1,6 @@
 {
   "name": "@fusion-plugin-examples/cursor-runtime",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "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.34",
+  "version": "0.1.36",
   "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.29",
+  "version": "0.1.31",
   "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.53",
+  "version": "0.2.55",
   "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.53",
+  "version": "0.2.55",
   "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.53",
+  "version": "0.2.55",
   "type": "module",
   "exports": {
     ".": {

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runfusion/fusion",
-  "version": "0.41.0",
+  "version": "0.43.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",
@@ -57,17 +57,9 @@
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
     "typebox": "*"
   },
   "peerDependenciesMeta": {
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
     "typebox": {
       "optional": true
     }
@@ -108,6 +100,7 @@
     "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:docs-index": "vitest run src/__tests__/docs-readme-index.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/references/extension-tools.md

@@ -104,15 +104,15 @@ Request a refinement of a completed or in-review task. Creates a new follow-up t
 
 ### fn_task_archive
 
-Archive a done task (move from done → archived). Archived tasks are preserved for historical reference but moved out of the main board view.
+Archive a task from any live column (move to archived). Archived tasks are preserved for historical reference but moved out of the main board view.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `id` | string | ✓ | Task ID to archive (e.g. FN-001). Must be in 'done' column. |
+| `id` | string | ✓ | Task ID to archive from any live column (e.g. FN-001). |
 
 ### fn_task_unarchive
 
-Unarchive an archived task (move from archived → done). Restores the task to the done column.
+Unarchive an archived task (move from archived → its restore column). Restores to the pre-archive column when available, with active execution columns downgraded to todo.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|

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

@@ -22,8 +22,8 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
 | `fn_task_retry` | Retry a failed task — clears the error state. Non-review failures move to todo; in-review execution failures move to todo preserving progress; in-review merge failures stay in-place for auto-merge retry. |
 | `fn_task_duplicate` | Duplicate an existing task, creating a fresh copy in planning. Copies the title and description but resets all execution state. The AI planning agent will replan the new task. |
 | `fn_task_refine` | Request a refinement of a completed or in-review task. Creates a new follow-up task in planning that references the original task as a dependency. Use this when a done or in-review task needs additional work, improvements, or follow-up changes. |
-| `fn_task_archive` | Archive a done task (move from done → archived). Archived tasks are preserved for historical reference but moved out of the main board view. |
-| `fn_task_unarchive` | Unarchive an archived task (move from archived → done). Restores the task to the done column. |
+| `fn_task_archive` | Archive a task from any live column (move to archived). Archived tasks are preserved for historical reference but moved out of the main board view. |
+| `fn_task_unarchive` | Unarchive an archived task (move from archived → its restore column). Restores to the pre-archive column when available, with active execution columns downgraded to todo. |
 | `fn_task_delete` | Soft-delete a task from active Fusion board views. The task row and artifacts are preserved; optional allowResurrection marks the ID for intentional recreation. |
 | `fn_task_import_github` | Import GitHub issues as Fusion tasks. Fetches open issues from a repository and creates tasks in the planning column. Each task includes the issue title and body with a link to the source issue. |
 | `fn_task_import_github_issue` | Import a specific GitHub issue as a Fusion task. Fetches the issue by number and creates a single task in the planning column with the issue title and body. |