@runfusion/fusion 0.53.1 → 0.54.0

package/dist/bin.js

@@ -1372,6 +1372,11 @@ var init_settings_schema = __esm({
       // coverage. Falls back to package/explicit command when no tests resolve.
       scopeVerificationToChangedFiles: true,
       ephemeralAgentsEnabled: true,
+      /*
+      FNXC:EphemeralAgentTaskCreation 2026-07-01-00:00:
+      Default-on so ephemeral task-worker agents keep the ability to open follow-up tasks via fn_task_create. Operators who want to confine task creation to humans/permanent agents flip this off.
+      */
+      ephemeralAgentsCanCreateTasks: true,
       agentProvisioning: {},
       sandboxProvisioning: {},
       defaultAgentPermissionPolicy: void 0,
@@ -51649,7 +51654,7 @@ function filterRepairOverlapIgnoredPaths(paths, ignorePaths) {
   if (ignorePaths.length === 0) return paths;
   return paths.filter((path10) => !ignorePaths.some((ignorePath) => repairIgnoredOverlapPath(path10, ignorePath)));
 }
-var serializeTaskAutoMerge, serializeTaskAutoMergeProvenance, TASK_COLUMN_DESCRIPTORS, TASK_COLUMN_DESCRIPTOR_BY_COLUMN, TASK_PERSIST_SQL_COLUMNS, TASK_UPSERT_SQL_ASSIGNMENTS, TASK_BRANCH_CONTEXT_METADATA_KEY, DEFAULT_TASK_ACTIVITY_LOG_ENTRY_LIMIT, DEFAULT_TASK_ACTIVITY_LOG_OUTCOME_LIMIT, taskActivityLogEntryLimit, taskActivityLogOutcomeLimit, ARCHIVE_AGENT_LOG_SNAPSHOT_LIMIT, ARCHIVE_AGENT_LOG_SNIPPET_LIMIT, RECONCILE_ORPHAN_TASK_DIR_MAX_AGE_MS, storeLog, coreLog, TaskHasDependentsError, TaskDeletedError, TombstonedTaskResurrectionError, TaskHasLineageChildrenError, InvalidFileScopeError, SELF_DEFEATING_OPERATION_VERBS, SelfDefeatingDependencyError, DependencyCycleError, MergeQueueTaskNotFoundError, MergeQueueInvalidColumnError, MergeQueueLeaseOwnershipError, InvalidMergeQueueLeaseDurationError, HandoffInvariantViolationError, TransitionRejectionError, WORKFLOW_MOVE_POLICY_TIMEOUT_MS, LEGACY_AUTO_MERGE_STAMP_MARKER_KEY, LEGACY_AUTO_MERGE_STAMP_MARKER_VERSION, TaskStore;
+var serializeTaskAutoMerge, serializeTaskAutoMergeProvenance, TASK_COLUMN_DESCRIPTORS, TASK_COLUMN_DESCRIPTOR_BY_COLUMN, TASK_PERSIST_SQL_COLUMNS, TASK_UPSERT_SQL_ASSIGNMENTS, TASK_BRANCH_CONTEXT_METADATA_KEY, DEFAULT_TASK_ACTIVITY_LOG_ENTRY_LIMIT, DEFAULT_TASK_ACTIVITY_LOG_OUTCOME_LIMIT, taskActivityLogEntryLimit, taskActivityLogOutcomeLimit, ARCHIVE_AGENT_LOG_SNAPSHOT_LIMIT, ARCHIVE_AGENT_LOG_SNIPPET_LIMIT, RECONCILE_ORPHAN_TASK_DIR_MAX_AGE_MS, storeLog, coreLog, TaskHasDependentsError, TaskSelfDeleteError, TaskDeletedError, TombstonedTaskResurrectionError, TaskHasLineageChildrenError, InvalidFileScopeError, SELF_DEFEATING_OPERATION_VERBS, SelfDefeatingDependencyError, DependencyCycleError, MergeQueueTaskNotFoundError, MergeQueueInvalidColumnError, MergeQueueLeaseOwnershipError, InvalidMergeQueueLeaseDurationError, HandoffInvariantViolationError, TransitionRejectionError, WORKFLOW_MOVE_POLICY_TIMEOUT_MS, LEGACY_AUTO_MERGE_STAMP_MARKER_KEY, LEGACY_AUTO_MERGE_STAMP_MARKER_VERSION, TaskStore;
 var init_store = __esm({
   "../core/src/store.ts"() {
     "use strict";
@@ -51901,6 +51906,15 @@ var init_store = __esm({
         this.dependentIds = dependentIds;
       }
     };
+    TaskSelfDeleteError = class extends Error {
+      taskId;
+      code = "TASK_SELF_DELETE";
+      constructor(taskId) {
+        super(`Task ${taskId} cannot delete itself`);
+        this.name = "TaskSelfDeleteError";
+        this.taskId = taskId;
+      }
+    };
     TaskDeletedError = class extends Error {
       constructor(taskId, deletedAt) {
         super(`Task ${taskId} is soft-deleted (deletedAt=${deletedAt}) and cannot be read or mutated`);
@@ -60175,6 +60189,9 @@ ${newTask.description}
        */
       async deleteTask(id, options) {
         const deletedTask = await this.withTaskLock(id, async () => {
+          if (options?.auditContext?.taskId === id) {
+            throw new TaskSelfDeleteError(id);
+          }
           this.flushAgentLogBuffer();
           const task = this.readTaskFromDb(id, { includeDeleted: true });
           if (!task) {
@@ -128528,6 +128545,17 @@ function createTaskCreateTool(store, provenance, options) {
     parameters: taskCreateParams,
     execute: async (_id, params) => {
       try {
+        if (options?.callerIsEphemeral) {
+          const settings = typeof store.getSettings === "function" ? await store.getSettings().catch(() => ({})) : {};
+          if (settings.ephemeralAgentsCanCreateTasks === false) {
+            const message = "Ephemeral task-worker agents are not allowed to create tasks (ephemeralAgentsCanCreateTasks is disabled for this project).";
+            return {
+              content: [{ type: "text", text: `ERROR: ${message}` }],
+              details: { error: message, rule: "ephemeral-agents-cannot-create-tasks" },
+              isError: true
+            };
+          }
+        }
         const workflowId = params.workflow_id?.trim() || void 0;
         const { task, wasDuplicate } = await createAgentTask(store, {
           description: params.description,
@@ -164412,25 +164440,91 @@ function buildReviewRequest(taskId, stepNumber, stepName, reviewType, promptCont
   );
   return parts.join("\n");
 }
-function extractVerdict(review) {
-  const jsonMatch = review.match(
-    /\{\s*"verdict"\s*:\s*"(APPROVE|REVISE|RETHINK)"\s*\}/i
+function proseSignalsClearApproval(rawOutput) {
+  const text = rawOutput.trim();
+  if (text.length === 0) return false;
+  const blockingSignal = new RegExp(
+    [
+      /\bREVIS(?:E|ED|ES|ING|ION|IONS)\b/,
+      /\bRETHINK\b/,
+      /\bREQUEST(?:ING|ED)?\s+(?:REVISION|CHANGES?)\b/,
+      /\bNEEDS?\s+(?:REVISION|CHANGES?|WORK|FIXE?S?)\b/,
+      /\bMUST\s+(?:BE\s+)?(?:FIX|CHANG|CORRECT|ADDRESS|RESOLV|UPDAT)\w*/,
+      /\bSHOULD\s+(?:BE\s+)?(?:FIX|CHANG|CORRECT|ADDRESS|RESOLV|UPDAT|REVIS)\w*/,
+      /\bPLEASE\s+(?:FIX|CHANG|CORRECT|ADDRESS|UPDAT|REVIS)\w*/,
+      /\bWANTS?\s+(?:\w+\s+){0,3}?(?:CHANG|FIX|CORRECT|ADDRESS|REVIS)\w*/,
+      /\bBEFORE\s+MERG\w*/,
+      /\bREJECT(?:ED|ING|S)?\b/,
+      /\bDISAPPROVE\b/
+    ].map((r) => r.source).join("|"),
+    "i"
   );
-  if (jsonMatch) {
-    reviewerLog.log(`Verdict extracted via JSON block: ${jsonMatch[1].toUpperCase()}`);
-    return jsonMatch[1].toUpperCase();
+  const negatedApproval = /\b(?:not|no|never|cannot|can['’]?t|don['’]?t|doesn['’]?t|won['’]?t|without)\s+approv/i;
+  if (blockingSignal.test(text) || negatedApproval.test(text)) return false;
+  const approvalSignal = /\b(?:approv(?:e|ed|es|ing|al)|approve[_\s]with[_\s]notes|looks?\s+good|lgtm|ship\s+it|no\s+(?:blocking\s+)?(?:issues|concerns|problems|objections)|passes?\s+(?:the\s+)?review|all\s+good|acceptable|good\s+to\s+(?:go|merge)|out\s+of\s+scope)\b/i;
+  return approvalSignal.test(text);
+}
+function extractJsonObjectCandidates(text) {
+  const out = [];
+  const starts = [];
+  let inString = false;
+  let escaped = false;
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text[i];
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (ch === "\\") escaped = true;
+      else if (ch === '"') inString = false;
+      continue;
+    }
+    if (ch === '"') inString = true;
+    else if (ch === "{") starts.push(i);
+    else if (ch === "}") {
+      const start = starts.pop();
+      if (start !== void 0 && starts.length === 0) out.push(text.slice(start, i + 1));
+    }
   }
+  return out;
+}
+function classifyReviewVerdictToken(raw) {
+  const v2 = raw.trim().toUpperCase();
+  if (v2.startsWith("APPROVE") || v2.startsWith("APPROVAL")) return "APPROVE";
+  if (v2.startsWith("REVISE") || v2.startsWith("REQUEST_REVISION") || v2.startsWith("REJECT")) return "REVISE";
+  if (v2.startsWith("RETHINK")) return "RETHINK";
+  return null;
+}
+function extractVerdict(review) {
   const headingMatch = review.match(
-    /^[>\s]*(?:###?\s*|[*_]{1,2})Verdict[:\s]*[*_]{0,2}\s*(APPROVE|REVISE|RETHINK)\b/im
+    /^[>\s]*(?:###?\s*|[*_]{1,2})Verdict[:\s]*[*_]{0,2}\s*([A-Za-z_]+)/im
   );
   if (headingMatch) {
-    return headingMatch[1].toUpperCase();
+    const classified = classifyReviewVerdictToken(headingMatch[1]);
+    if (classified) return classified;
   }
   const lineFallback = review.match(
-    /^[>\s]*(?:verdict|decision)\s*[-:]\s*(APPROVE|REVISE|RETHINK)\b/im
+    /^[>\s]*(?:verdict|decision)\s*[-:]\s*([A-Za-z_]+)/im
   );
   if (lineFallback) {
-    return lineFallback[1].toUpperCase();
+    const classified = classifyReviewVerdictToken(lineFallback[1]);
+    if (classified) return classified;
+  }
+  const jsonCandidates = extractJsonObjectCandidates(review);
+  for (let i = jsonCandidates.length - 1; i >= 0; i -= 1) {
+    try {
+      const parsed = JSON.parse(jsonCandidates[i]);
+      if (typeof parsed?.verdict === "string") {
+        const classified = classifyReviewVerdictToken(parsed.verdict);
+        if (classified) {
+          reviewerLog.log(`Verdict extracted via JSON payload: ${classified}`);
+          return classified;
+        }
+      }
+    } catch {
+    }
+  }
+  if (proseSignalsClearApproval(review)) {
+    reviewerLog.log(`Verdict extracted via lenient prose approval (${review.length} chars) \u2192 APPROVE`);
+    return "APPROVE";
   }
   reviewerLog.warn(`Could not extract verdict from review (${review.length} chars). Returning UNAVAILABLE.`);
   return "UNAVAILABLE";
@@ -173603,18 +173697,21 @@ function parseWorkflowStepVerdict(rawOutput) {
   for (const match of fencedMatches) {
     candidates.push(match[1].trim());
   }
-  const jsonObjectMatches = trimmed.match(/\{[\s\S]*\}/g);
-  if (jsonObjectMatches) {
-    candidates.push(...jsonObjectMatches.map((value) => value.trim()));
-  }
+  candidates.push(...extractJsonObjectCandidates(trimmed));
   for (let i = candidates.length - 1; i >= 0; i -= 1) {
     try {
       const parsed = JSON.parse(candidates[i]);
-      if (!parsed || typeof parsed.verdict !== "string" || !WORKFLOW_STEP_VERDICTS.has(parsed.verdict)) {
-        continue;
-      }
+      if (!parsed || typeof parsed.verdict !== "string") continue;
+      const token = parsed.verdict.trim().toUpperCase();
+      let verdict = null;
+      if (token.startsWith("APPROVE") || token.startsWith("APPROVAL")) {
+        verdict = token.includes("NOTE") ? "APPROVE_WITH_NOTES" : "APPROVE";
+      } else if (token.startsWith("REVISE") || token.startsWith("REQUEST_REVISION") || token.startsWith("REJECT")) {
+        verdict = "REVISE";
+      }
+      if (!verdict) continue;
       return {
-        verdict: parsed.verdict,
+        verdict,
         notes: typeof parsed.notes === "string" ? parsed.notes : ""
       };
     } catch {
@@ -173635,7 +173732,7 @@ function inferWorkflowStepVerdictFromProse(rawOutput) {
       notes: ""
     };
   }
-  if (/\b(approve|approved|looks good|no issues|out of scope)\b/i.test(trimmed)) {
+  if (proseSignalsClearApproval(trimmed)) {
     return { verdict: "APPROVE", notes: "" };
   }
   return null;
@@ -173882,6 +173979,11 @@ Please adjust your approach based on this feedback.`;
 function hasNonTerminalWorkflowSteps(task) {
   return task.steps.length > 0 && task.steps.some((step) => step.status !== "done" && step.status !== "skipped");
 }
+function clearTerminalWorkflowStepFailures(results) {
+  const current = results ?? [];
+  const kept = current.filter((result) => result.status !== "failed" && result.status !== "advisory_failure");
+  return kept.length === current.length ? current : kept;
+}
 function workflowStepResultPassed(task, workflowStepId) {
   const results = task?.workflowStepResults ?? [];
   return results.some(
@@ -173982,7 +174084,7 @@ function detectReviewHandoffIntent(commentText) {
   ];
   return handoffPhrases.some((phrase) => text.includes(phrase));
 }
-var execAsync32, AGENT_BROWSER_NAVIGATION_SKILL_ID, yieldEventLoop3, tokenCacheMetricsLog, OPTIONAL_STEP_REVISION_KEY_MARKER2, STEP_STATUSES, MAX_WORKFLOW_STEP_RETRIES, MAX_TASK_DONE_SESSION_RETRIES, MAX_TASK_DONE_REQUEUE_RETRIES, MAX_TRANSIENT_GRAPH_RESUME_RETRIES, TRANSIENT_GRAPH_RESUME_RETRY_BACKOFF_MS, COMPLETED_TASK_WATCHDOG_MS, WORKFLOW_RERUN_WATCHDOG_MS, LOOP_COMPACTION_TIMEOUT_MS, TASK_DONE_REFUSAL_SUFFIX, TRANSIENT_WORKTREE_TASK_JSON_ENOENT_PATTERN, DISSENT_PATTERNS, WORKFLOW_SCRIPT_OUTPUT_MAX_CHARS, NonRetryableWorktreeError, taskUpdateParams, taskAddDepParams, spawnAgentParams, FUSION_WORKFLOW_STEP_CONVENTIONS_PREAMBLE, WORKFLOW_STEP_VERDICTS, reviewStepParams, EXECUTOR_SYSTEM_PROMPT, TaskExecutor;
+var execAsync32, AGENT_BROWSER_NAVIGATION_SKILL_ID, yieldEventLoop3, tokenCacheMetricsLog, OPTIONAL_STEP_REVISION_KEY_MARKER2, STEP_STATUSES, MAX_WORKFLOW_STEP_RETRIES, MAX_TASK_DONE_SESSION_RETRIES, MAX_TASK_DONE_REQUEUE_RETRIES, MAX_TRANSIENT_GRAPH_RESUME_RETRIES, TRANSIENT_GRAPH_RESUME_RETRY_BACKOFF_MS, COMPLETED_TASK_WATCHDOG_MS, WORKFLOW_RERUN_WATCHDOG_MS, LOOP_COMPACTION_TIMEOUT_MS, TASK_DONE_REFUSAL_SUFFIX, TRANSIENT_WORKTREE_TASK_JSON_ENOENT_PATTERN, DISSENT_PATTERNS, WORKFLOW_SCRIPT_OUTPUT_MAX_CHARS, NonRetryableWorktreeError, taskUpdateParams, taskAddDepParams, spawnAgentParams, FUSION_WORKFLOW_STEP_CONVENTIONS_PREAMBLE, reviewStepParams, EXECUTOR_SYSTEM_PROMPT, TaskExecutor;
 var init_executor = __esm({
   "../engine/src/executor.ts"() {
     "use strict";
@@ -174142,7 +174244,6 @@ You are running as a Fusion autonomous workflow step \u2014 NOT an interactive C
 3. Dispatching a \`ce-<persona>\` subagent: do NOT use a raw \`Task ce-*(...)\` call. Instead, read the persona definition from \`$FUSION_CE_AGENTS_DIR/<persona>.md\`, strip its YAML frontmatter, and pass the remaining body as the \`systemPromptOverride\` argument to the \`fn_spawn_agent\` tool. Resolve the path strictly inside \`$FUSION_CE_AGENTS_DIR\` \u2014 reject any \`<persona>\` containing \`/\` or \`..\` (path traversal), and skip a def whose body is empty or implausibly large. If \`fn_spawn_agent\` is not available (a readonly step), do the persona's work inline yourself instead of spawning.
 
 `;
-    WORKFLOW_STEP_VERDICTS = /* @__PURE__ */ new Set(["APPROVE", "APPROVE_WITH_NOTES", "REVISE"]);
     reviewStepParams = Type6.Object({
       step: Type6.Number({ description: "Step number to review (0-indexed; matches the `### Step N:` numbers in PROMPT.md \u2014 Step 0 is Preflight)." }),
       type: Type6.Union(
@@ -175855,6 +175956,18 @@ The tool prevents your session from being killed by the inactivity watchdog duri
        *   this as a successful retry, since the original bounce may itself be
        *   stuck.
        */
+      /*
+      FNXC:ReviewLeniency 2026-07-02-02:10:
+      Clear prior terminal failure results (failed/advisory_failure — incl. optional gate nodes like code-review) so a retry starts clean. Call this ONLY once the task has left the mergeable in-review column (i.e. it is in `todo`): clearing while still in-review drops the merge blocker during the rerun-bounce window and could let a concurrent auto-merge sweep merge an empty-`steps` graph-native task with its gate failure unaddressed. `moveTask(in-review→todo)` already clears ALL results (applyReopenFieldClears), so this is chiefly for the in-progress→todo bounce path where the move does not. Passed/skipped/pending evidence is kept.
+      */
+      async clearTerminalStepFailuresForRetry(taskId) {
+        const live = await this.store.getTask(taskId).catch(() => null);
+        if (!live) return;
+        const cleared = clearTerminalWorkflowStepFailures(live.workflowStepResults);
+        if (cleared !== live.workflowStepResults) {
+          await this.store.updateTask(taskId, { workflowStepResults: cleared }, this.getRunContextFor(taskId));
+        }
+      }
       async performWorkflowRerunBounce(taskId, worktreePath, preserveResumeState = true) {
         const pauseLabel = await this.getExecutionPauseLabel();
         if (pauseLabel) {
@@ -175894,6 +176007,7 @@ The tool prevents your session from being killed by the inactivity watchdog duri
               executorLog.log(`${taskId}: workflow rerun parked in todo \u2014 ${pauseLabelAfterTodo} became active during bounce`);
               return "deferred-paused";
             }
+            await this.clearTerminalStepFailuresForRetry(taskId);
             await this.store.moveTask(taskId, "in-progress");
             return "bounced";
           }
@@ -175904,6 +176018,7 @@ The tool prevents your session from being killed by the inactivity watchdog duri
               executorLog.log(`${taskId}: workflow rerun parked in todo \u2014 ${pauseLabelBeforeResume} became active before resume`);
               return "deferred-paused";
             }
+            await this.clearTerminalStepFailuresForRetry(taskId);
             await this.store.moveTask(taskId, "in-progress");
             return "bounced";
           }
@@ -178821,9 +178936,10 @@ ${prompt}`;
         if (cfg.summaryTarget === "task" && typeof stepOutput === "string" && stepOutput.trim()) {
           contextPatch.summary = stepOutput.trim();
         }
-        const advisoryFailureValue = outcome.malformed ? "advisory_failure" : "failed";
+        const malformed = outcome.malformed === true;
+        const advisoryFailureValue = malformed ? "advisory_failure" : "failed";
         return {
-          outcome: outcome.success || !blocking ? "success" : "failure",
+          outcome: outcome.success || !blocking || malformed ? "success" : "failure",
           value: verdict ?? (outcome.success ? "passed" : advisoryFailureValue),
           ...Object.keys(contextPatch).length > 0 ? { contextPatch } : {}
         };
@@ -178988,6 +179104,29 @@ ${prompt}`;
         if (MERGE_REGION_KINDS.has(failedNode)) return true;
         return failedNode === "merge-manual-hold" || failedNode === "merge-retry";
       }
+      /*
+      FNXC:WorkflowRemediation 2026-07-01-23:40:
+      A live agent session surface for a task proves the work is still executing, independent of the persisted column/pause/status row that handleGraphFailure re-fetches. This mirrors clearPhantomExecutorBinding's `hasLiveSessionSurface` (FN-6736) but deliberately EXCLUDES `this.executing` and graph-routing membership: those are still set for the graph run that is currently ending (graphRouting is cleared in maybeExecuteWorkflowGraph's finally, AFTER handleGraphFailure returns), so including them would report every ending run as "still executing" and suppress all failures. Only a registered coding/step/CLI session surface means a SEPARATE, live agent is working the task.
+      */
+      hasLiveTaskSessionSurface(taskId) {
+        return this.activeSessions.has(taskId) || this.activeStepExecutors.has(taskId) || this.activeWorkflowStepSessions.has(taskId) || this.activeCliTaskSessions.has(taskId);
+      }
+      /*
+      FNXC:WorkflowRemediation 2026-07-01-23:40:
+      A `pre-merge-remediation` / `plan-replan` node (e.g. `code-review-remediation`) is a FIRE-AND-FORGET async scheduler, not a terminal work node: its job is to hand off an implementation fix (sendTaskBackForFix re-dispatches the coding session) and stop traversal. These nodes carry only a `success` rework edge back to their gate and NO `failure` out-edge, so when their schedule call cannot re-arm (missing rehydrated failureContext after a restart → `missing-remediation-context`, `remediation-not-scheduled`, or an exhausted rework budget) the failure bubbles out as the terminal graph outcome and handleGraphFailure would stamp `status:"failed"` — even while a previously-scheduled fix/reviewer session is still live. Classify these nodes so that terminal sink can preserve a still-executing task instead of flagging a spurious failure. Detection prefers the resolved IR `workflowAction` (covers custom workflows), with a node-id fallback for the built-in ids when the IR cannot be resolved.
+      */
+      async isRemediationGraphNode(taskId, failedNode) {
+        if (!failedNode) return false;
+        try {
+          const ir2 = await resolveWorkflowIrForTask(this.store, taskId);
+          const node = ir2?.nodes?.find((n) => n.id === failedNode);
+          const action = node?.config?.workflowAction;
+          if (action === "pre-merge-remediation" || action === "plan-replan") return true;
+          if (node) return false;
+        } catch {
+        }
+        return failedNode === "code-review-remediation" || failedNode === "browser-verification-remediation" || failedNode === "plan-replan";
+      }
       isTerminalMergeGraphFailureValue(value) {
         if (!value) return false;
         const normalized = value.toLowerCase();
@@ -179497,6 +179636,13 @@ ${prompt}`;
               return;
             }
           }
+          if (this.hasLiveTaskSessionSurface(task.id) && await this.isRemediationGraphNode(task.id, failedNode)) {
+            const benignMessage = `Workflow graph ended at remediation node '${failedNode ?? "unknown"}' while a live agent session is still executing \u2014 not flagging as failed; live session preserved`;
+            executorLog.warn(`${task.id}: ${benignMessage}`);
+            await this.store.logEntry(task.id, benignMessage, void 0, this.getRunContextFor(task.id));
+            await this.persistTokenUsage(task.id);
+            return;
+          }
           const message = `Workflow graph terminated with failure at node '${failedNode ?? "unknown"}'`;
           executorLog.warn(`${task.id}: ${message}`);
           await this.store.logEntry(task.id, message, void 0, this.getRunContextFor(task.id));
@@ -179530,6 +179676,7 @@ ${prompt}`;
             recoveryRehome: true
           });
         }
+        await this.clearTerminalStepFailuresForRetry(live.id);
         await this.persistTokenUsage(live.id);
         return true;
       }
@@ -179706,6 +179853,41 @@ ${prompt}`;
         executorLog.log(`${liveTask.id}: executor dispatch blocked by unmet dependencies: ${unmetDeps.join(", ")}`);
         return true;
       }
+      /*
+        FNXC:EphemeralAgents 2026-07-01-00:00:
+        `ephemeralAgentsEnabled: false` means "never spawn short-lived executor-FN-XXXX workers; only permanent agents run work" (see types.ts ephemeralAgentsEnabled). The legacy spawn refusal lives in EphemeralWorkerManager.onTaskStart (ephemeral-worker-manager.ts), but that runs as a fire-and-forget bookkeeping callback AFTER execution has already begun, so it cannot stop a run. The workflow-engine dispatch paths (maybeExecuteWorkflowGraph, workflowAuthoritativeDispatch, maybeDispatchWorkflowWorkEngine) execute tasks in-process without ever consulting the toggle. Any task that reaches execute() without a permanent assignment via a non-scheduler path (resume-after-restart, heartbeat re-entry, mission/autopilot, work-engine claim) therefore ran despite the operator disabling ephemeral agents.
+      
+        This guard is the executor's last line of defense, mirroring the scheduler cutover gate (scheduler.ts:2464) and the spawn refusal (ephemeral-worker-manager.ts:132). It runs once at the top of the outer dispatch — before all three workflow paths — so a single check covers every workflow dispatch entry point. A task explicitly assigned to a permanent (non-ephemeral) agent is exactly how ephemeral-off mode is meant to run, so those are allowed through; everything else is re-queued for the scheduler to auto-assign a permanent agent or hold.
+        */
+      async blockOuterDispatchWhenEphemeralDisabled(task) {
+        const settings = await this.store.getSettings();
+        if (settings.ephemeralAgentsEnabled !== false) return false;
+        const assignedId = task.assignedAgentId?.trim();
+        if (assignedId) {
+          if (!this.options.agentStore) return false;
+          const agent = await this.options.agentStore.getAgent(assignedId).catch(() => null);
+          if (agent && !isEphemeralAgent(agent)) return false;
+        }
+        const liveTask = await this.store.getTask(task.id).catch(() => null) ?? task;
+        if (liveTask.column !== "todo") {
+          await this.store.moveTask(liveTask.id, "todo", {
+            preserveProgress: true,
+            preserveWorktree: true,
+            preserveResumeState: true,
+            moveSource: "engine",
+            recoveryRehome: true
+          });
+        }
+        await this.store.updateTask(liveTask.id, { status: "queued" }, this.getRunContextFor(liveTask.id));
+        await this.store.logEntry(
+          liveTask.id,
+          "queued \u2014 ephemeral agents disabled; no permanent executor assigned",
+          "Executor pre-dispatch ephemeral gate blocked workflow/authoritative execution.",
+          this.getRunContextFor(liveTask.id)
+        );
+        executorLog.log(`${liveTask.id}: executor dispatch blocked \u2014 ephemeralAgentsEnabled=false and no permanent agent assigned`);
+        return true;
+      }
       async execute(task) {
         this.completionFinalizedTaskIds.delete(task.id);
         await this.clearStalePauseAbortBeforeDispatch(task);
@@ -179715,6 +179897,7 @@ ${prompt}`;
             return;
           }
           if (await this.blockOuterDispatchWhenDependenciesUnmet(task)) return;
+          if (await this.blockOuterDispatchWhenEphemeralDisabled(task)) return;
           const graphOwned = await this.maybeExecuteWorkflowGraph(task);
           if (graphOwned) return;
           const authoritativeOwned = await this.options.workflowAuthoritativeDispatch?.(task);
@@ -180580,7 +180763,7 @@ ${summary}`,
           const customTools = [
             this.createTaskUpdateTool(task.id, codeReviewVerdicts, sessionRef, stepCheckpoints, stuckDetector),
             this.createTaskLogTool(task.id),
-            this.createTaskCreateTool(),
+            this.createTaskCreateTool(!identityAgent || isEphemeralAgent(identityAgent)),
             this.createTaskAddDepTool(task.id),
             this.createTaskDoneTool(task.id, worktreePath, detail.prompt ?? "", codeReviewVerdicts, () => {
               taskDone = true;
@@ -182144,8 +182327,12 @@ ${summary}`,
       createTaskLogTool(taskId) {
         return createTaskLogTool(this.store, taskId);
       }
-      createTaskCreateTool() {
-        return createTaskCreateTool(this.store, { sourceType: "api" }, { rootDir: this.rootDir });
+      /*
+      FNXC:EphemeralAgentTaskCreation 2026-07-01-00:00:
+      A task-execution session is an ephemeral worker when no permanent identity agent governs it (default executor-FN-XXXX worker) or the governing agent is itself ephemeral. Pass that through so fn_task_create honors the project `ephemeralAgentsCanCreateTasks` toggle; permanent-agent sessions are never gated.
+      */
+      createTaskCreateTool(callerIsEphemeral) {
+        return createTaskCreateTool(this.store, { sourceType: "api" }, { rootDir: this.rootDir, callerIsEphemeral });
       }
       createTaskDocumentWriteTool(taskId) {
         return createTaskDocumentWriteTool(this.store, taskId);
@@ -184283,7 +184470,7 @@ Review the work done in this worktree and evaluate it against the criteria in yo
             if (parsed.malformed) {
               await this.store.logEntry(
                 task.id,
-                `[pre-merge] Workflow step '${workflowStep.name}' produced malformed output \u2014 blocking gate success`
+                `[pre-merge] Workflow step '${workflowStep.name}' produced malformed output (no parseable verdict) \u2014 recorded as non-blocking advisory`
               );
               if (workflowStep.requiresBrowser === true) {
                 await logBrowserVerificationActivity(`[browser-verification] finished browser verification for task ${task.id}: malformed output`);
@@ -184333,16 +184520,18 @@ Review the work done in this worktree and evaluate it against the criteria in yo
           }
         };
         const primaryOutcome = await runOnce(primaryProvider, primaryModelId, "primary");
-        if (!primaryOutcome.timedOut) return primaryOutcome;
+        const primaryMalformed = primaryOutcome.malformed === true;
+        if (!primaryOutcome.timedOut && !primaryMalformed) return primaryOutcome;
         if (!fallback2) {
-          executorLog.warn(`${task.id}: workflow step '${workflowStep.name}' timed out and no fallback model is configured`);
+          const reason = primaryOutcome.timedOut ? "timed out" : "produced malformed output";
+          executorLog.warn(`${task.id}: workflow step '${workflowStep.name}' ${reason} and no fallback model is configured`);
           await this.store.logEntry(
             task.id,
-            `Workflow step '${workflowStep.name}' timed out \u2014 no fallback model configured (set settings.validatorFallbackProvider/Id or fallbackProvider/Id)`
+            `Workflow step '${workflowStep.name}' ${reason} \u2014 no fallback model configured (set settings.validatorFallbackProvider/Id or fallbackProvider/Id)`
           );
           return primaryOutcome;
         }
-        executorLog.log(`${task.id}: retrying workflow step '${workflowStep.name}' with fallback ${fallback2.provider}/${fallback2.modelId} (label=${fallback2.label})`);
+        executorLog.log(`${task.id}: retrying workflow step '${workflowStep.name}' with fallback ${fallback2.provider}/${fallback2.modelId} (label=${fallback2.label}) after primary ${primaryOutcome.timedOut ? "timeout" : "malformed output"}`);
         return runOnce(fallback2.provider, fallback2.modelId, "fallback");
       }
       MAX_WORKTREE_RETRIES = 3;
@@ -238005,7 +238194,7 @@ var init_task_planner_chat_context = __esm({
     DEFAULT_STEP_LIMIT = 20;
     DEFAULT_DEPENDENCY_LIMIT = 20;
     TASK_PLANNER_CHAT_CONTEXT_PROMPT_GUIDANCE = `## Task Planner Chat Context
-You are answering in the task detail Chat tab for a single Fusion task. Use the bounded server-supplied context below to answer questions about current status, progress, dependencies, recent activity, source/review state, and the task prompt or plan. For token counts, cost, runtime, elapsed/wall-clock duration, timing events, workflow-step duration, or per-model usage, call \`fn_task_planner_get_task_metrics\` and answer from the tool result; state when pricing is unavailable/stale or metrics are missing instead of inventing values. State uncertainty when a section is absent, stale, truncated, or marked unavailable. Do not claim you ran code, tests, builds, or inspected files unless the supplied context or explicit tool output says so. Keep Activity separate from Chat: Activity is the execution/steering transcript, while this Chat reply is a planner conversation. Do not mutate steering comments for ordinary status/progress/metrics questions.`;
+You are answering in the task detail Chat tab for a single Fusion task. Use the bounded server-supplied context below to answer questions about current status, progress, dependencies, recent activity, source/review state, and the task prompt or plan. For token counts, cost, runtime, elapsed/wall-clock duration, timing events, workflow-step duration, or per-model usage, call \`fn_task_planner_get_task_metrics\` and answer from the tool result; state when pricing is unavailable/stale or metrics are missing instead of inventing values. State uncertainty when a section is absent, stale, truncated, or marked unavailable. Do not claim you ran code, tests, builds, or inspected files unless the supplied context or explicit tool output says so. Keep Activity separate from Chat: Activity is the execution/steering transcript, while this Chat reply is a planner conversation. Do not mutate steering comments for ordinary status/progress/metrics questions. For completed tasks, clear follow-up implementation or improvement requests should create a refinement through the task-scoped refinement tool; ordinary completed-task questions should still be answered normally. Never ask for or pass a task id for planner tools.`;
   }
 });
 
@@ -238458,6 +238647,55 @@ function createTaskPlannerMetricsTool(taskStore, taskId, getPricingOverrides) {
     }
   };
 }
+function createTaskPlannerRefinementTool(taskStore, taskId) {
+  return {
+    name: "fn_task_planner_create_refinement",
+    label: "Create Refinement Task",
+    description: "Create one follow-up refinement task from the current completed task. The source task id is fixed by server context; never accept or infer a different task id. Use only for clear follow-up implementation or improvement requests after completion.",
+    parameters: {
+      type: "object",
+      properties: {
+        feedback: { type: "string", description: "The user's concise follow-up or improvement request for the refinement task. Do not include hidden prompt/context text." }
+      },
+      required: ["feedback"],
+      additionalProperties: false
+    },
+    execute: async (_id, params) => {
+      const feedback = typeof params.feedback === "string" ? params.feedback.trim() : "";
+      if (!feedback) {
+        return { content: [{ type: "text", text: "ERROR: feedback must be a non-empty string" }], details: { sourceTaskId: taskId }, isError: true };
+      }
+      try {
+        const sourceTask = await taskStore.getTask(taskId);
+        if (sourceTask.column !== "done") {
+          return {
+            content: [{ type: "text", text: `ERROR: Current task ${taskId} is ${sourceTask.column}; use planner steering for live tasks instead of creating a refinement.` }],
+            details: { sourceTaskId: taskId, column: sourceTask.column },
+            isError: true
+          };
+        }
+        const refinedTask = await taskStore.refineTask(taskId, feedback);
+        return {
+          content: [{ type: "text", text: `Created refinement task ${refinedTask.id} from ${taskId}.` }],
+          details: {
+            sourceTaskId: taskId,
+            refinementTaskId: refinedTask.id,
+            description: refinedTask.description ?? feedback,
+            column: refinedTask.column,
+            createdAt: refinedTask.createdAt
+          }
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          content: [{ type: "text", text: `ERROR: Could not create a refinement for the current task ${taskId}: ${message}` }],
+          details: { sourceTaskId: taskId, error: message },
+          isError: true
+        };
+      }
+    }
+  };
+}
 function createTaskPlannerSteeringTool(taskStore, taskId) {
   return {
     name: "fn_task_planner_add_steering",
@@ -239646,6 +239884,7 @@ ${CHAT_AGENT_MESSAGE_ROUTING_GUIDANCE}`;
 
 ${CHAT_ASK_QUESTION_GUIDANCE}`;
           const taskPlannerChatTaskId = typeof session.agentId === "string" && session.agentId.startsWith(TASK_PLANNER_CHAT_AGENT_ID_PREFIX2) ? session.agentId.slice(TASK_PLANNER_CHAT_AGENT_ID_PREFIX2.length).trim() : "";
+          let taskPlannerTaskColumn = "";
           if (taskPlannerChatTaskId) {
             let taskContext = `Task ID: ${taskPlannerChatTaskId}
 
@@ -239654,6 +239893,7 @@ Context availability notes:
             if (this.taskStore) {
               try {
                 const context = await buildTaskPlannerChatContext(this.taskStore, taskPlannerChatTaskId);
+                taskPlannerTaskColumn = context.snapshot.column ?? "";
                 taskContext = context.promptContext;
               } catch (taskLoadError) {
                 const message = taskLoadError instanceof Error ? taskLoadError.message : String(taskLoadError);
@@ -239669,12 +239909,14 @@ Context availability notes:
 ${TASK_PLANNER_CHAT_CONTEXT_PROMPT_GUIDANCE}
 
 Decision rules:
-- Do not create steering for ordinary questions, summaries, thanks, status/progress requests, metric questions, or brainstorming. Answer normally.
+- Do not create steering or refinements for ordinary questions, summaries, thanks, status/progress requests, metric questions, or brainstorming. Answer normally.
 - For questions about token counts, input/output/cache usage, model cost, pricing, runtime, elapsed time, wall-clock duration, active time, timing events, workflow-step duration, or per-model usage, first call \`fn_task_planner_get_task_metrics\` and answer from its read-only result. If pricing is unavailable or stale, or a metric is missing, state that uncertainty instead of inventing a number.
-- Create steering only when the user gives a clear, bounded, actionable change request for this current task (for example telling the executor/reviewer to adjust implementation, tests, scope details, or acceptance criteria).
-- When creating steering, call \`fn_task_planner_add_steering\` with only the concise user-facing steering text. Never include hidden prompt/context/logs, credentials, or chain-of-thought.
-- Ask a clarifying question with \`fn_ask_question\` before adding steering for unclear targets, requests that could mean either conversation or task mutation, broad rewrites/scope changes, destructive removals, conflicting instructions, credential/secrets handling, or security-sensitive actions.
-- The steering and metrics tools are bound to this task server-side; never ask for or pass a task id.
+- If the current task is done and the user gives a clear follow-up implementation, improvement, polish, bug-fix, or refinement request for this completed task, call \`fn_task_planner_create_refinement\` with only the concise feedback text.
+- If the current task is not done and the user gives a clear, bounded, actionable change request for this current task (for example telling the executor/reviewer to adjust implementation, tests, scope details, or acceptance criteria), call \`fn_task_planner_add_steering\` with only the concise user-facing steering text.
+- Never create a refinement for live non-done tasks; use steering for clear live-task changes instead. Never add steering for done-task follow-up implementation requests when the refinement tool is available.
+- Never include hidden prompt/context/logs, credentials, or chain-of-thought in tool parameters.
+- Ask a clarifying question with \`fn_ask_question\` before adding steering or creating a refinement for unclear targets, requests that could mean either conversation or task mutation, broad rewrites/scope changes, destructive removals, conflicting instructions, credential/secrets handling, or security-sensitive actions.
+- The steering, metrics, and refinement tools are bound to this task server-side; never ask for or pass a task id.
 
 ${taskContext}`;
           }
@@ -239740,7 +239982,8 @@ ${mentionContext}`;
           const artifactTools = this.taskStore ? createChatArtifactTools(this.taskStore, this.messageStore) : [];
           const taskPlannerSteeringTools = this.taskStore && taskPlannerChatTaskId ? [createTaskPlannerSteeringTool(this.taskStore, taskPlannerChatTaskId)] : [];
           const taskPlannerMetricsTools = this.taskStore && taskPlannerChatTaskId ? [createTaskPlannerMetricsTool(this.taskStore, taskPlannerChatTaskId, () => this.getModelPricingOverrides())] : [];
-          const customTools = [createAskQuestionTool(), ...taskPlannerSteeringTools, ...taskPlannerMetricsTools, ...messagingTools, ...workflowTools, ...documentTools, ...artifactTools];
+          const taskPlannerRefinementTools = this.taskStore && taskPlannerChatTaskId && taskPlannerTaskColumn === "done" ? [createTaskPlannerRefinementTool(this.taskStore, taskPlannerChatTaskId)] : [];
+          const customTools = [createAskQuestionTool(), ...taskPlannerSteeringTools, ...taskPlannerMetricsTools, ...taskPlannerRefinementTools, ...messagingTools, ...workflowTools, ...documentTools, ...artifactTools];
           const sessionOptions = {
             cwd: this.rootDir,
             systemPrompt,
@@ -240259,8 +240502,8 @@ function registerChatRoutes(ctx, deps) {
         res.json({ session: session2 });
         return;
       }
-      if (task.column === "done" || task.column === "archived") {
-        throw badRequest(`Task ${task.id} is ${task.column}; planner chat can only be started while a task is live`);
+      if (task.column === "archived") {
+        throw badRequest(`Task ${task.id} is archived; planner chat cannot be started for archived tasks`);
       }
       const session = chatStore.createSession({
         agentId,
@@ -292908,7 +293151,7 @@ var init_src8 = __esm({
   }
 });
 
-// ../../plugins/fusion-plugin-paperclip-runtime/dist/paperclip-client.js
+// ../../plugins/fusion-plugin-paperclip-runtime/src/paperclip-client.ts
 function normalizeApiUrl(url2) {
   return url2.replace(/\/+$/, "");
 }
@@ -292936,19 +293179,18 @@ async function parseJsonBody(response) {
   try {
     return { value: JSON.parse(raw), raw };
   } catch {
-    throw new Error(`Paperclip API ${response.status} ${response.statusText}: invalid JSON response body`);
+    throw new Error(
+      `Paperclip API ${response.status} ${response.statusText}: invalid JSON response body`
+    );
   }
 }
 function toErrorMessage2(status, statusText, body, raw) {
   if (body && typeof body === "object") {
     const b2 = body;
-    if (typeof b2.error === "string")
-      return b2.error;
-    if (typeof b2.message === "string")
-      return b2.message;
+    if (typeof b2.error === "string") return b2.error;
+    if (typeof b2.message === "string") return b2.message;
   }
-  if (raw.trim() !== "")
-    return raw.slice(0, 200).trim();
+  if (raw.trim() !== "") return raw.slice(0, 200).trim();
   return `${status} ${statusText}`.trim();
 }
 async function request2(apiUrl, path10, options) {
@@ -292971,8 +293213,7 @@ async function request2(apiUrl, path10, options) {
   if (!response.ok) {
     const msg = toErrorMessage2(response.status, response.statusText, value, raw);
     const full = `Paperclip API ${response.status} (${method} ${path10}): ${msg}`;
-    if (response.status === 409)
-      throw new ConflictError(full);
+    if (response.status === 409) throw new ConflictError(full);
     throw new Error(full);
   }
   return value;
@@ -292982,7 +293223,9 @@ function getSettingString(settings, key) {
   return typeof v2 === "string" && v2.trim() !== "" ? v2.trim() : void 0;
 }
 function resolvePaperclipConfig(settings) {
-  const apiUrl = normalizeApiUrl(getSettingString(settings, "apiUrl") ?? process.env.PAPERCLIP_API_URL?.trim() ?? "http://localhost:3100");
+  const apiUrl = normalizeApiUrl(
+    getSettingString(settings, "apiUrl") ?? process.env.PAPERCLIP_API_URL?.trim() ?? "http://localhost:3100"
+  );
   const apiKey = getSettingString(settings, "apiKey") ?? (process.env.PAPERCLIP_API_KEY?.trim() || void 0);
   const agentId = getSettingString(settings, "agentId") ?? process.env.PAPERCLIP_AGENT_ID?.trim() ?? void 0;
   const companyId = getSettingString(settings, "companyId") ?? process.env.PAPERCLIP_COMPANY_ID?.trim() ?? void 0;
@@ -292994,9 +293237,18 @@ function resolvePaperclipConfig(settings) {
   const parentIssueId = getSettingString(settings, "parentIssueId") ?? process.env.PAPERCLIP_PARENT_ISSUE_ID?.trim() ?? void 0;
   const projectId = getSettingString(settings, "projectId") ?? process.env.PAPERCLIP_PROJECT_ID?.trim() ?? void 0;
   const goalId = getSettingString(settings, "goalId") ?? process.env.PAPERCLIP_GOAL_ID?.trim() ?? void 0;
-  const runTimeoutMs = parseInt(getSettingString(settings, "runTimeoutMs") ?? process.env.PAPERCLIP_RUN_TIMEOUT_MS ?? "600000", 10);
-  const pollIntervalMs = parseInt(getSettingString(settings, "pollIntervalMs") ?? process.env.PAPERCLIP_POLL_INTERVAL_MS ?? "500", 10);
-  const pollIntervalMaxMs = parseInt(getSettingString(settings, "pollIntervalMaxMs") ?? process.env.PAPERCLIP_POLL_INTERVAL_MAX_MS ?? "2000", 10);
+  const runTimeoutMs = parseInt(
+    getSettingString(settings, "runTimeoutMs") ?? process.env.PAPERCLIP_RUN_TIMEOUT_MS ?? "600000",
+    10
+  );
+  const pollIntervalMs = parseInt(
+    getSettingString(settings, "pollIntervalMs") ?? process.env.PAPERCLIP_POLL_INTERVAL_MS ?? "500",
+    10
+  );
+  const pollIntervalMaxMs = parseInt(
+    getSettingString(settings, "pollIntervalMaxMs") ?? process.env.PAPERCLIP_POLL_INTERVAL_MAX_MS ?? "2000",
+    10
+  );
   return {
     apiUrl,
     apiKey,
@@ -293089,25 +293341,20 @@ async function getRunEvents(apiUrl, apiKey, runId, afterSeq, limit = 100) {
     apiKey,
     query
   });
-  if (Array.isArray(result))
-    return result;
+  if (Array.isArray(result)) return result;
   const r = result;
-  if (Array.isArray(r.events))
-    return r.events;
+  if (Array.isArray(r.events)) return r.events;
   return [];
 }
 async function listCompanies(apiUrl, apiKey) {
   const raw = await request2(apiUrl, "/companies", { apiKey });
-  if (!Array.isArray(raw))
-    return [];
+  if (!Array.isArray(raw)) return [];
   const out = [];
   for (const entry of raw) {
-    if (!entry || typeof entry !== "object")
-      continue;
+    if (!entry || typeof entry !== "object") continue;
     const r = entry;
     const id = typeof r.id === "string" ? r.id : void 0;
-    if (!id)
-      continue;
+    if (!id) continue;
     const name = typeof r.name === "string" ? r.name : id;
     const urlKey = typeof r.urlKey === "string" ? r.urlKey : typeof r.slug === "string" ? r.slug : void 0;
     out.push({ id, name, urlKey });
@@ -293116,16 +293363,13 @@ async function listCompanies(apiUrl, apiKey) {
 }
 async function listCompanyAgents(apiUrl, apiKey, companyId) {
   const raw = await request2(apiUrl, `/companies/${companyId}/agents`, { apiKey });
-  if (!Array.isArray(raw))
-    return [];
+  if (!Array.isArray(raw)) return [];
   const out = [];
   for (const entry of raw) {
-    if (!entry || typeof entry !== "object")
-      continue;
+    if (!entry || typeof entry !== "object") continue;
     const r = entry;
     const id = typeof r.id === "string" ? r.id : void 0;
-    if (!id)
-      continue;
+    if (!id) continue;
     const name = typeof r.name === "string" ? r.name : id;
     const role = typeof r.role === "string" ? r.role : void 0;
     const cId = typeof r.companyId === "string" ? r.companyId : companyId;
@@ -293235,7 +293479,11 @@ async function mintAgentApiKeyViaCli(opts) {
     } catch (err) {
       const code = err.code;
       if (code === "ENOENT") {
-        reject2(new Error(`paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``));
+        reject2(
+          new Error(
+            `paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``
+          )
+        );
       } else {
         reject2(err instanceof Error ? err : new Error(String(err)));
       }
@@ -293256,22 +293504,24 @@ async function mintAgentApiKeyViaCli(opts) {
       const lines = chunk.toString("utf-8").split("\n");
       for (const line of lines) {
         const stripped = stripAnsi2(line).trim();
-        if (stripped)
-          stderrLines.push(stripped);
+        if (stripped) stderrLines.push(stripped);
       }
     });
     child.on("error", (err) => {
       clearTimeout(timer);
       if (err.code === "ENOENT") {
-        reject2(new Error(`paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``));
+        reject2(
+          new Error(
+            `paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``
+          )
+        );
       } else {
         reject2(err);
       }
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      if (killed)
-        return;
+      if (killed) return;
       const rawStdout = Buffer.concat(stdoutChunks).toString("utf-8");
       const cleanedStdout = stripAnsi2(rawStdout).trim();
       if (code !== 0) {
@@ -293283,20 +293533,30 @@ async function mintAgentApiKeyViaCli(opts) {
       }
       if (!cleanedStdout) {
         const hint = "run `paperclipai onboard` to authenticate the CLI";
-        reject2(new Error(`paperclipai agent local-cli produced no output \u2014 ${hint}`));
+        reject2(
+          new Error(`paperclipai agent local-cli produced no output \u2014 ${hint}`)
+        );
         return;
       }
       let parsed;
       try {
         parsed = JSON.parse(cleanedStdout);
       } catch {
-        reject2(new Error(`paperclipai agent local-cli returned non-JSON output: ${cleanedStdout.slice(0, 200)}`));
+        reject2(
+          new Error(
+            `paperclipai agent local-cli returned non-JSON output: ${cleanedStdout.slice(0, 200)}`
+          )
+        );
         return;
       }
       const r = parsed;
       const apiKey = (typeof r.apiKey === "string" ? r.apiKey : void 0) ?? (typeof r.api_key === "string" ? r.api_key : void 0) ?? (typeof r.token === "string" ? r.token : void 0);
       if (!apiKey) {
-        reject2(new Error(`paperclipai agent local-cli JSON missing apiKey/api_key/token field: ${cleanedStdout.slice(0, 200)}`));
+        reject2(
+          new Error(
+            `paperclipai agent local-cli JSON missing apiKey/api_key/token field: ${cleanedStdout.slice(0, 200)}`
+          )
+        );
         return;
       }
       const apiBase = (typeof r.apiBase === "string" ? r.apiBase : void 0) ?? (typeof r.api_base === "string" ? r.api_base : void 0);
@@ -293309,7 +293569,9 @@ async function mintAgentApiKeyViaCli(opts) {
 function remapSpawnError(err, bin) {
   const code = err?.code;
   if (code === "ENOENT") {
-    return new Error(`paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``);
+    return new Error(
+      `paperclipai binary not found at ${bin}; install via \`npm i -g paperclipai\``
+    );
   }
   return err instanceof Error ? err : new Error(String(err));
 }
@@ -293345,8 +293607,7 @@ async function spawnPaperclipCliJson(args, opts) {
       const lines = chunk.toString("utf-8").split("\n");
       for (const line of lines) {
         const stripped = stripAnsi2(line).trim();
-        if (stripped)
-          stderrLines.push(stripped);
+        if (stripped) stderrLines.push(stripped);
       }
     });
     child.on("error", (err) => {
@@ -293355,12 +293616,17 @@ async function spawnPaperclipCliJson(args, opts) {
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      if (killed)
-        return;
-      const cleaned = stripAnsi2(Buffer.concat(stdoutChunks).toString("utf-8")).trim();
+      if (killed) return;
+      const cleaned = stripAnsi2(
+        Buffer.concat(stdoutChunks).toString("utf-8")
+      ).trim();
       if (code !== 0) {
         const lastErr = stderrLines.filter(Boolean).pop() ?? "";
-        reject2(new Error(lastErr ? `${label} exited ${code}: ${lastErr}` : `${label} exited ${code}`));
+        reject2(
+          new Error(
+            lastErr ? `${label} exited ${code}: ${lastErr}` : `${label} exited ${code}`
+          )
+        );
         return;
       }
       if (!cleaned) {
@@ -293370,23 +293636,22 @@ async function spawnPaperclipCliJson(args, opts) {
       try {
         resolve75(JSON.parse(cleaned));
       } catch {
-        reject2(new Error(`${label} returned non-JSON output: ${cleaned.slice(0, 200)}`));
+        reject2(
+          new Error(`${label} returned non-JSON output: ${cleaned.slice(0, 200)}`)
+        );
       }
     });
   });
 }
 async function listCompaniesViaCli(opts) {
   const raw = await spawnPaperclipCliJson(["company", "list"], opts);
-  if (!Array.isArray(raw))
-    return [];
+  if (!Array.isArray(raw)) return [];
   const out = [];
   for (const entry of raw) {
-    if (!entry || typeof entry !== "object")
-      continue;
+    if (!entry || typeof entry !== "object") continue;
     const r = entry;
     const id = typeof r.id === "string" ? r.id : void 0;
-    if (!id)
-      continue;
+    if (!id) continue;
     const name = typeof r.name === "string" ? r.name : id;
     const urlKey = typeof r.urlKey === "string" ? r.urlKey : typeof r.slug === "string" ? r.slug : void 0;
     out.push({ id, name, urlKey });
@@ -293394,17 +293659,17 @@ async function listCompaniesViaCli(opts) {
   return out;
 }
 async function listCompanyAgentsViaCli(opts) {
-  const raw = await spawnPaperclipCliJson(["agent", "list", "--company-id", opts.companyId], opts);
-  if (!Array.isArray(raw))
-    return [];
+  const raw = await spawnPaperclipCliJson(
+    ["agent", "list", "--company-id", opts.companyId],
+    opts
+  );
+  if (!Array.isArray(raw)) return [];
   const out = [];
   for (const entry of raw) {
-    if (!entry || typeof entry !== "object")
-      continue;
+    if (!entry || typeof entry !== "object") continue;
     const r = entry;
     const id = typeof r.id === "string" ? r.id : void 0;
-    if (!id)
-      continue;
+    if (!id) continue;
     const name = typeof r.name === "string" ? r.name : id;
     const role = typeof r.role === "string" ? r.role : void 0;
     const cId = typeof r.companyId === "string" ? r.companyId : opts.companyId;
@@ -293416,40 +293681,49 @@ async function listCompanyAgentsViaCli(opts) {
 async function createIssueViaCli(opts) {
   const args = ["issue", "create", "--company-id", opts.companyId];
   args.push("--title", opts.body.title);
-  if (opts.body.description)
-    args.push("--description", opts.body.description);
-  if (opts.body.status)
-    args.push("--status", opts.body.status);
+  if (opts.body.description) args.push("--description", opts.body.description);
+  if (opts.body.status) args.push("--status", opts.body.status);
   if (opts.body.assigneeAgentId)
     args.push("--assignee-agent-id", opts.body.assigneeAgentId);
-  if (opts.body.parentId)
-    args.push("--parent-id", opts.body.parentId);
-  if (opts.body.projectId)
-    args.push("--project-id", opts.body.projectId);
-  if (opts.body.goalId)
-    args.push("--goal-id", opts.body.goalId);
+  if (opts.body.parentId) args.push("--parent-id", opts.body.parentId);
+  if (opts.body.projectId) args.push("--project-id", opts.body.projectId);
+  if (opts.body.goalId) args.push("--goal-id", opts.body.goalId);
   const raw = await spawnPaperclipCliJson(args, opts);
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    throw new Error(`paperclipai issue create returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`);
+    throw new Error(
+      `paperclipai issue create returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`
+    );
   }
   return raw;
 }
 async function getIssueViaCli(opts) {
-  const raw = await spawnPaperclipCliJson(["issue", "get", opts.issueId], opts);
+  const raw = await spawnPaperclipCliJson(
+    ["issue", "get", opts.issueId],
+    opts
+  );
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    throw new Error(`paperclipai issue get returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`);
+    throw new Error(
+      `paperclipai issue get returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`
+    );
   }
   return raw;
 }
 async function agentsMeViaCli(opts) {
-  const raw = await spawnPaperclipCliJson(["agent", "get", opts.agentId], opts);
+  const raw = await spawnPaperclipCliJson(
+    ["agent", "get", opts.agentId],
+    opts
+  );
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    throw new Error(`paperclipai agent get returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`);
+    throw new Error(
+      `paperclipai agent get returned unexpected payload: ${JSON.stringify(raw).slice(0, 200)}`
+    );
   }
   const id = typeof raw.id === "string" ? raw.id : void 0;
   const cId = typeof raw.companyId === "string" ? raw.companyId : void 0;
   if (!id || !cId) {
-    throw new Error("paperclipai agent get returned a response missing `id` or `companyId`");
+    throw new Error(
+      "paperclipai agent get returned a response missing `id` or `companyId`"
+    );
   }
   return {
     agentId: id,
@@ -293464,8 +293738,7 @@ async function probePaperclipViaCli(opts) {
   let apiUrl = "(via paperclipai CLI)";
   try {
     const disc = await discoverPaperclipCliConfig({ configPath: opts.cliConfigPath });
-    if (disc.ok)
-      apiUrl = disc.apiUrl;
+    if (disc.ok) apiUrl = disc.apiUrl;
   } catch {
   }
   try {
@@ -293482,7 +293755,7 @@ async function probePaperclipViaCli(opts) {
 }
 var ConflictError;
 var init_paperclip_client = __esm({
-  "../../plugins/fusion-plugin-paperclip-runtime/dist/paperclip-client.js"() {
+  "../../plugins/fusion-plugin-paperclip-runtime/src/paperclip-client.ts"() {
     "use strict";
     ConflictError = class extends Error {
       status = 409;
@@ -293494,7 +293767,7 @@ var init_paperclip_client = __esm({
   }
 });
 
-// ../../plugins/fusion-plugin-paperclip-runtime/dist/runtime-adapter.js
+// ../../plugins/fusion-plugin-paperclip-runtime/src/runtime-adapter.ts
 import { randomUUID as randomUUID36 } from "node:crypto";
 function sleep6(ms2) {
   return new Promise((resolve75) => setTimeout(resolve75, ms2));
@@ -293523,22 +293796,20 @@ function pickIssueId(issue2) {
   return issueId;
 }
 function normalizeMode3(mode) {
-  if (mode && VALID_MODES2.has(mode))
-    return mode;
+  if (mode && VALID_MODES2.has(mode)) return mode;
   return "rolling-issue";
 }
 function pickLatestVisibleComment(comments) {
   for (let i = comments.length - 1; i >= 0; i--) {
     const c = comments[i];
     const body = asString3(c.body)?.trim();
-    if (body)
-      return body;
+    if (body) return body;
   }
   return void 0;
 }
 var TERMINAL_RUN_STATUSES2, VALID_MODES2, PaperclipRuntimeAdapter;
 var init_runtime_adapter4 = __esm({
-  "../../plugins/fusion-plugin-paperclip-runtime/dist/runtime-adapter.js"() {
+  "../../plugins/fusion-plugin-paperclip-runtime/src/runtime-adapter.ts"() {
     "use strict";
     init_paperclip_client();
     TERMINAL_RUN_STATUSES2 = /* @__PURE__ */ new Set([
@@ -293558,7 +293829,9 @@ var init_runtime_adapter4 = __esm({
       config;
       logger;
       constructor(config2, logger3) {
-        const resolved = resolvePaperclipConfig(config2);
+        const resolved = resolvePaperclipConfig(
+          config2
+        );
         this.config = {
           ...resolved,
           mode: normalizeMode3(resolved.mode),
@@ -293574,13 +293847,17 @@ var init_runtime_adapter4 = __esm({
             configPath: this.config.cliConfigPath
           });
           if (!discovery.ok) {
-            throw new Error(`Paperclip CLI mode failed: ${discovery.reason} (Switch to API mode in settings if paperclipai isn't installed.)`);
+            throw new Error(
+              `Paperclip CLI mode failed: ${discovery.reason} (Switch to API mode in settings if paperclipai isn't installed.)`
+            );
           }
           effectiveApiUrl = discovery.apiUrl;
           if (!effectiveApiKey) {
             effectiveApiKey = discovery.apiKey;
           }
-          this.logger.info(`Paperclip CLI mode resolved apiUrl=${effectiveApiUrl} (deploymentMode=${discovery.deploymentMode ?? "unknown"})`);
+          this.logger.info(
+            `Paperclip CLI mode resolved apiUrl=${effectiveApiUrl} (deploymentMode=${discovery.deploymentMode ?? "unknown"})`
+          );
         }
         let agentId = this.config.agentId;
         let companyId = this.config.companyId;
@@ -293588,7 +293865,9 @@ var init_runtime_adapter4 = __esm({
           try {
             if (this.config.transport === "cli") {
               if (!agentId) {
-                throw new Error("agentId is required in Local CLI mode (paperclipai has no `agents/me` equivalent \u2014 pick an agent in settings)");
+                throw new Error(
+                  "agentId is required in Local CLI mode (paperclipai has no `agents/me` equivalent \u2014 pick an agent in settings)"
+                );
               }
               const me2 = await agentsMeViaCli({
                 agentId,
@@ -293603,11 +293882,15 @@ var init_runtime_adapter4 = __esm({
             }
           } catch (error2) {
             const reason = error2 instanceof Error ? error2.message : String(error2);
-            throw new Error(`Paperclip runtime could not derive agentId/companyId. Configure them explicitly or check the API key / CLI auth. Underlying error: ${reason}`);
+            throw new Error(
+              `Paperclip runtime could not derive agentId/companyId. Configure them explicitly or check the API key / CLI auth. Underlying error: ${reason}`
+            );
           }
         }
         if (!agentId || !companyId) {
-          throw new Error("Paperclip runtime is missing required config: agentId or companyId. Configure plugin settings (apiUrl, apiKey, agentId, companyId) or PAPERCLIP_* env vars.");
+          throw new Error(
+            "Paperclip runtime is missing required config: agentId or companyId. Configure plugin settings (apiUrl, apiKey, agentId, companyId) or PAPERCLIP_* env vars."
+          );
         }
         const session = {
           apiUrl: effectiveApiUrl,
@@ -293704,18 +293987,15 @@ var init_runtime_adapter4 = __esm({
             if (!finalText) {
               const comments = await getIssueComments(session.apiUrl, session.apiKey, issueId);
               const latest = pickLatestVisibleComment(comments);
-              if (latest)
-                finalText = latest;
+              if (latest) finalText = latest;
             }
           } catch (error2) {
             const reason = error2 instanceof Error ? error2.message : String(error2);
             this.logger.warn(`Paperclip post-run fetch failed: ${reason}`);
           }
         }
-        if (finalText)
-          session.onText?.(finalText);
-        if (stream.thinking)
-          session.onThinking?.(stream.thinking);
+        if (finalText) session.onText?.(finalText);
+        if (stream.thinking) session.onThinking?.(stream.thinking);
         const isError = stream.runStatus === "failed" || stream.runStatus === "timed_out";
         session.onToolEnd?.("paperclip.run", isError || stream.timedOutLocally, {
           runId,
@@ -293763,24 +294043,27 @@ var init_runtime_adapter4 = __esm({
         while (true) {
           let events = [];
           try {
-            events = await getRunEvents(session.apiUrl, session.apiKey, runId, afterSeq, 200);
+            events = await getRunEvents(
+              session.apiUrl,
+              session.apiKey,
+              runId,
+              afterSeq,
+              200
+            );
           } catch (error2) {
             const reason = error2 instanceof Error ? error2.message : String(error2);
             this.logger.warn(`Paperclip getRunEvents failed: ${reason}`);
           }
           for (const ev of events) {
-            if (typeof ev.seq === "number" && ev.seq > afterSeq)
-              afterSeq = ev.seq;
+            if (typeof ev.seq === "number" && ev.seq > afterSeq) afterSeq = ev.seq;
             const type = ev.type ?? "";
             const payload = ev.payload ?? {};
             if (type === "heartbeat.run.status") {
               const next = asString3(payload.status);
-              if (next)
-                runStatus = next;
+              if (next) runStatus = next;
             } else if (type === "heartbeat.run.log") {
               const chunk = asString3(payload.chunk) ?? "";
-              if (!chunk)
-                continue;
+              if (!chunk) continue;
               if (payload.stream === "stdout") {
                 textBuf += chunk;
                 session.onText?.(chunk);
@@ -293792,11 +294075,12 @@ var init_runtime_adapter4 = __esm({
               }
             }
           }
-          if (TERMINAL_RUN_STATUSES2.has(runStatus))
-            break;
+          if (TERMINAL_RUN_STATUSES2.has(runStatus)) break;
           if (Date.now() - startedAt > session.runTimeoutMs) {
             timedOutLocally = true;
-            this.logger.warn(`Paperclip run ${runId} exceeded local runTimeoutMs=${session.runTimeoutMs}; abandoning poll. Run continues server-side.`);
+            this.logger.warn(
+              `Paperclip run ${runId} exceeded local runTimeoutMs=${session.runTimeoutMs}; abandoning poll. Run continues server-side.`
+            );
             break;
           }
           await sleep6(interval);
@@ -293808,17 +294092,20 @@ var init_runtime_adapter4 = __esm({
   }
 });
 
-// ../../plugins/fusion-plugin-paperclip-runtime/dist/index.js
+// ../../plugins/fusion-plugin-paperclip-runtime/src/index.ts
 function getSettingsConfig(settings) {
   return resolvePaperclipConfig(settings ?? {});
 }
 async function paperclipRuntimeFactory(ctx) {
   const config2 = getSettingsConfig(ctx.settings);
-  return new PaperclipRuntimeAdapter(config2, ctx.logger);
+  return new PaperclipRuntimeAdapter(
+    config2,
+    ctx.logger
+  );
 }
 var paperclipRuntime, plugin4;
-var init_dist = __esm({
-  "../../plugins/fusion-plugin-paperclip-runtime/dist/index.js"() {
+var init_src9 = __esm({
+  "../../plugins/fusion-plugin-paperclip-runtime/src/index.ts"() {
     "use strict";
     init_src5();
     init_paperclip_client();
@@ -293863,7 +294150,9 @@ var init_dist = __esm({
             });
             if (status.available) {
               const ident = status.identity;
-              ctx.logger.info(ident ? `Paperclip reachable as ${ident.agentName} (${ident.role ?? "agent"}) at ${ident.companyName ?? ident.companyId}` : `Paperclip reachable at ${config2.apiUrl}`);
+              ctx.logger.info(
+                ident ? `Paperclip reachable as ${ident.agentName} (${ident.role ?? "agent"}) at ${ident.companyName ?? ident.companyId}` : `Paperclip reachable at ${config2.apiUrl}`
+              );
             } else {
               ctx.logger.warn(`Paperclip probe failed: ${status.reason ?? "unknown"}`);
             }
@@ -293953,7 +294242,7 @@ var init_runtime_provider_probes = __esm({
     init_src6();
     init_src7();
     init_src8();
-    init_dist();
+    init_src9();
   }
 });
 
@@ -302096,7 +302385,7 @@ var init_server = __esm({
 
 // ../../plugins/fusion-plugin-roadmap/src/index.ts
 var plugin5;
-var init_src9 = __esm({
+var init_src10 = __esm({
   "../../plugins/fusion-plugin-roadmap/src/index.ts"() {
     "use strict";
     init_src5();
@@ -302207,7 +302496,7 @@ var init_roadmap_routes3 = __esm({
   "../dashboard/src/roadmap-routes.ts"() {
     "use strict";
     init_src();
-    init_src9();
+    init_src10();
     init_project_store_resolver();
   }
 });
@@ -312368,7 +312657,7 @@ var init_plugins = __esm({
 });
 
 // ../dashboard/src/index.ts
-var init_src10 = __esm({
+var init_src11 = __esm({
   "../dashboard/src/index.ts"() {
     "use strict";
     init_server2();
@@ -314831,7 +315120,7 @@ var FUSION_LOGO_LINES, FUSION_LOGO_LARGE_LINES, FUSION_TAGLINE, FUSION_URL, FUSI
 var init_logo = __esm({
   "src/commands/dashboard-tui/logo.ts"() {
     "use strict";
-    init_src10();
+    init_src11();
     FUSION_LOGO_LINES = [
       "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557",
       "\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551",
@@ -321540,7 +321829,7 @@ var init_cli_catalogs = __esm({
 });
 
 // ../i18n/src/index.ts
-var init_src11 = __esm({
+var init_src12 = __esm({
   "../i18n/src/index.ts"() {
     "use strict";
     init_config();
@@ -321594,7 +321883,7 @@ var init_i18n = __esm({
   "src/i18n/index.ts"() {
     "use strict";
     init_src();
-    init_src11();
+    init_src12();
     initialized = false;
   }
 });
@@ -321879,7 +322168,7 @@ var DETACH_CHORD_BYTE, DETACH_CHORD_LABEL, ALT_SCREEN_ENTER, ALT_SCREEN_LEAVE, D
 var init_terminal_attach = __esm({
   "src/commands/dashboard-tui/terminal-attach.ts"() {
     "use strict";
-    init_src10();
+    init_src11();
     DETACH_CHORD_BYTE = 29;
     DETACH_CHORD_LABEL = "Ctrl-]";
     ALT_SCREEN_ENTER = "\x1B[?1049h";
@@ -325056,7 +325345,7 @@ var init_dashboard = __esm({
   "src/commands/dashboard.ts"() {
     "use strict";
     init_src();
-    init_src10();
+    init_src11();
     init_src4();
     init_task_lifecycle();
     init_port_prompt();
@@ -326333,7 +326622,7 @@ var init_serve = __esm({
   "src/commands/serve.ts"() {
     "use strict";
     init_src();
-    init_src10();
+    init_src11();
     init_src4();
     init_task_lifecycle();
     init_port_prompt();
@@ -327034,7 +327323,7 @@ var init_daemon = __esm({
   "src/commands/daemon.ts"() {
     "use strict";
     init_src();
-    init_src10();
+    init_src11();
     init_src4();
     init_task_lifecycle();
     init_port_prompt();
@@ -327235,7 +327524,7 @@ var init_desktop = __esm({
   "src/commands/desktop.ts"() {
     "use strict";
     init_src();
-    init_src10();
+    init_src11();
     init_src4();
     init_ensure_project_registered();
     require4 = createRequire10(import.meta.url);
@@ -327556,7 +327845,7 @@ var init_pr = __esm({
     init_src();
     init_gh_cli();
     init_src4();
-    init_src10();
+    init_src11();
     init_project_context();
   }
 });
@@ -329077,7 +329366,7 @@ var init_task = __esm({
     init_src();
     init_src4();
     init_planning();
-    init_src10();
+    init_src11();
     init_gh_cli();
     init_project_context();
     init_node();
@@ -330425,7 +330714,7 @@ var init_branch_group = __esm({
     "use strict";
     init_src();
     init_src4();
-    init_src10();
+    init_src11();
     init_project_context();
     init_task_lifecycle();
   }