@runfusion/fusion 0.76.0-beta.2 → 0.76.0-beta.3

package/dist/bin.js

@@ -2184,6 +2184,8 @@ var init_settings_schema = __esm({
     DEFAULT_PROJECT_SETTINGS = {
       // FNXC:TaskRecommendations 2026-08-08-05:02: completion follows-ups stay bounded by default; 0 disables writing them.
       maxRecommendationsPerTask: 3,
+      // FNXC:TaskRecommendations 2026-08-13-03:56: surface completed-task proposals by default; operators can suppress the notice without suppressing capture.
+      recommendationMailboxNoticeEnabled: true,
       globalPause: false,
       globalPauseReason: void 0,
       defaultWorkflowId: void 0,
@@ -68757,20 +68759,32 @@ async function replaceActiveTaskWorkflowContinuation(layer, input) {
     return upsertWorkflowWorkItem(layer, input, tx);
   }));
 }
-async function seedStrandedPlanReviewContinuation(layer, input) {
+async function seedStrandedPlanReviewContinuation(layer, input, options = {}) {
   return layer.transactionImmediate(async (tx) => withTaskWorkflowSerialization(tx, layer.projectId, input.taskId, async () => {
     const active2 = await tx.select({ id: project_exports.workflowWorkItems.id }).from(project_exports.workflowWorkItems).where(and(
       projectScopeFor(project_exports.workflowWorkItems.projectId, layer.projectId),
       eq(project_exports.workflowWorkItems.taskId, input.taskId),
       inArray(project_exports.workflowWorkItems.state, [...ACTIVE_WORKFLOW_WORK_ITEM_STATES])
     ));
-    if (active2.length > 0) return { seeded: false, reason: "active-continuation" };
+    const blocking = options.retirePredecessorId ? active2.filter((row) => row.id !== options.retirePredecessorId) : active2;
+    if (blocking.length > 0) return { seeded: false, reason: "active-continuation" };
     const taskRows = await tx.select({ workflowStepResults: project_exports.tasks.workflowStepResults }).from(project_exports.tasks).where(and(
       projectScopeFor(project_exports.tasks.projectId, layer.projectId),
       eq(project_exports.tasks.id, input.taskId)
     )).limit(1);
     const results = taskRows[0]?.workflowStepResults;
     if (results?.some(isPlanReviewSatisfied)) return { seeded: false, reason: "plan-review-passed" };
+    if (options.retirePredecessorId) {
+      const predRows = await tx.select().from(project_exports.workflowWorkItems).where(and(
+        projectScopeFor(project_exports.workflowWorkItems.projectId, layer.projectId),
+        eq(project_exports.workflowWorkItems.id, options.retirePredecessorId),
+        eq(project_exports.workflowWorkItems.taskId, input.taskId)
+      )).limit(1);
+      const pred = predRows[0];
+      if (pred && !isTerminalWorkflowWorkItemState(normalizeWorkflowWorkItemState(pred.state))) {
+        await transitionWorkflowWorkItem(layer, pred.id, "succeeded", { leaseOwner: null, leaseExpiresAt: null, lastError: null }, tx);
+      }
+    }
     const item = await upsertWorkflowWorkItem(layer, input, tx);
     return { seeded: true, workItemId: item.id };
   }));
@@ -97148,8 +97162,8 @@ async function upsertWorkflowWorkItemImpl(store, input, tx) {
 async function replaceActiveTaskWorkflowContinuationImpl(store, input) {
   return replaceActiveTaskWorkflowContinuation(store.asyncLayer, input);
 }
-async function seedStrandedPlanReviewContinuationImpl(store, input) {
-  return seedStrandedPlanReviewContinuation(store.asyncLayer, input);
+async function seedStrandedPlanReviewContinuationImpl(store, input, options = {}) {
+  return seedStrandedPlanReviewContinuation(store.asyncLayer, input, options);
 }
 async function transitionWorkflowWorkItemImpl(store, id, state, patch = {}, tx) {
   return transitionWorkflowWorkItem(store.asyncLayer, id, state, patch, tx);
@@ -101292,6 +101306,37 @@ async function getTaskVerificationRequestAsyncImpl(store, taskId) {
   const row = rows[0];
   return row ? { taskId: row.taskId, requestId: row.requestId, status: row.status, profile: row.profile, command: row.command, scope: row.scope, requestedBy: row.requestedBy, requestedAt: row.requestedAt, ...row.startedAt ? { startedAt: row.startedAt } : {}, ...row.completedAt ? { completedAt: row.completedAt } : {}, ...row.result ? { result: row.result } : {}, ...row.rejectionReason ? { rejectionReason: row.rejectionReason } : {} } : null;
 }
+async function listTaskRecommendationsImpl(store, options) {
+  const layer = store.asyncLayer;
+  const completeColumns = options?.completeColumns ?? await resolveProjectColumnsForRoles(store, ["complete"]);
+  const rawLimit = options?.limit;
+  const rawOffset = options?.offset;
+  const limit2 = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(200, Math.max(1, Math.trunc(rawLimit))) : 50;
+  const offset = typeof rawOffset === "number" && Number.isFinite(rawOffset) ? Math.max(0, Math.trunc(rawOffset)) : 0;
+  const columns = [...completeColumns];
+  if (columns.length === 0) return { items: [], rowOffset: offset, rowLimit: limit2, returnedRowCount: 0, totalRowCount: 0, hasMore: false };
+  const filter2 = and(
+    taskProjectScope(layer),
+    isNull(project_exports.tasks.deletedAt),
+    inArray(project_exports.tasks.column, columns),
+    isNotNull(project_exports.tasks.recommendations),
+    sql`jsonb_array_length(${project_exports.tasks.recommendations}) > 0`
+  );
+  const [countRows, rows] = await Promise.all([
+    layer.db.select({ count: sql`count(*)` }).from(project_exports.tasks).where(filter2),
+    layer.db.select({ id: project_exports.tasks.id, title: project_exports.tasks.title, column: project_exports.tasks.column, updatedAt: project_exports.tasks.updatedAt, recommendations: project_exports.tasks.recommendations }).from(project_exports.tasks).where(filter2).orderBy(desc(project_exports.tasks.updatedAt), desc(project_exports.tasks.id)).limit(limit2).offset(offset)
+  ]);
+  const items = [];
+  for (const row of rows) {
+    if (!Array.isArray(row.recommendations) || row.recommendations.length === 0) continue;
+    for (const recommendation of row.recommendations) {
+      items.push({ taskId: row.id, taskTitle: row.title ?? void 0, taskColumn: row.column, updatedAt: row.updatedAt, recommendation });
+    }
+  }
+  const totalRowCount = Number(countRows[0]?.count ?? 0);
+  const returnedRowCount = rows.length;
+  return { items, rowOffset: offset, rowLimit: limit2, returnedRowCount, totalRowCount, hasMore: offset + returnedRowCount < totalRowCount };
+}
 var LEGACY_REVIEW_LANES5, LEGACY_ARCHIVE_LANES2;
 var init_reads = __esm({
   "../core/src/task-store/reads.ts"() {
@@ -101314,6 +101359,7 @@ var init_reads = __esm({
     init_retry_summary();
     init_errors3();
     init_project_lane_vocabulary();
+    init_data_layer();
     init_async_persistence();
     init_async_search();
     init_async_archive_db();
@@ -103420,6 +103466,9 @@ var init_store = __esm({
       async clearWorkflowRunStepInstancesAsync(taskId, keepRunId) {
         return clearWorkflowRunStepInstancesAsyncImpl(this, taskId, keepRunId);
       }
+      async listTaskRecommendations(options) {
+        return listTaskRecommendationsImpl(this, options);
+      }
       async listTasksForGithubTrackingReconcile(options) {
         return listTasksForGithubTrackingReconcileImpl(this, options);
       }
@@ -104146,8 +104195,8 @@ var init_store = __esm({
       async replaceActiveTaskWorkflowContinuation(input) {
         return replaceActiveTaskWorkflowContinuationImpl(this, input);
       }
-      async seedStrandedPlanReviewContinuation(input) {
-        return seedStrandedPlanReviewContinuationImpl(this, input);
+      async seedStrandedPlanReviewContinuation(input, options = {}) {
+        return seedStrandedPlanReviewContinuationImpl(this, input, options);
       }
       async transitionWorkflowWorkItem(id, state, patch = {}, tx) {
         return transitionWorkflowWorkItemImpl(this, id, state, patch, tx);
@@ -133285,6 +133334,77 @@ var init_task_timing = __esm({
   }
 });
 
+// ../core/src/task-recommendation-notice.ts
+import { createHash as createHash20 } from "node:crypto";
+function registerTaskRecommendationNoticeMailbox(store, mailbox) {
+  mailboxes2.set(store, mailbox);
+  return () => {
+    if (mailboxes2.get(store) === mailbox) mailboxes2.delete(store);
+  };
+}
+function getTaskRecommendationNoticeMailbox(store) {
+  return mailboxes2.get(store);
+}
+function buildTaskRecommendationNoticeContent(task, recommendations) {
+  const title2 = task.title?.trim();
+  const heading = title2 ? `## Recommendations from ${task.id} \u2014 ${title2}` : `## Recommendations from ${task.id}`;
+  return [
+    heading,
+    "",
+    "These are optional, non-blocking out-of-scope proposals that were **not** executed.",
+    "",
+    ...recommendations.map((recommendation) => `- **${recommendation.title}** \u2014 \`${recommendation.category}\`: ${recommendation.description}`),
+    "",
+    `Open ${task.id}'s **Recommendations** tab to review them. **Create task** files one through normal guarded intake.`
+  ].join("\n");
+}
+function buildTaskRecommendationNoticeIdempotencyKey(taskId, recommendations) {
+  const ids = recommendations.map(({ id }) => id).sort().join("\n");
+  const digest = createHash20("sha256").update(ids, "utf8").digest("hex").slice(0, 16);
+  return `task-recommendation-notice:${taskId}:${digest}`;
+}
+async function notifyOperatorOfTaskRecommendations(store, task, recommendations, settings) {
+  try {
+    if (settings.recommendationMailboxNoticeEnabled === false || !recommendations?.length) return false;
+    const mailbox = mailboxes2.get(store);
+    if (!mailbox) return false;
+    await mailbox.sendMessageOnce(
+      {
+        fromId: "system",
+        fromType: "system",
+        toId: DASHBOARD_USER_ID,
+        toType: "user",
+        type: "system",
+        content: buildTaskRecommendationNoticeContent(task, recommendations),
+        metadata: {
+          kind: "task-recommendation-notice",
+          taskId: task.id,
+          recommendationCount: recommendations.length,
+          recommendationIds: recommendations.map(({ id }) => id),
+          categories: recommendations.map(({ category }) => category)
+        }
+      },
+      buildTaskRecommendationNoticeIdempotencyKey(task.id, recommendations)
+    );
+    return true;
+  } catch (error3) {
+    noticeLog2.warn(
+      `Operator recommendation notice failed for ${task.id}: ${error3 instanceof Error ? error3.message : String(error3)}`
+    );
+    return false;
+  }
+}
+var noticeLog2, mailboxes2;
+var init_task_recommendation_notice = __esm({
+  "../core/src/task-recommendation-notice.ts"() {
+    "use strict";
+    init_logger();
+    init_types();
+    noticeLog2 = createLogger("task-recommendation-notice");
+    mailboxes2 = /* @__PURE__ */ new WeakMap();
+  }
+});
+
 // ../core/src/session-identity-registry.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { resolve as resolve24 } from "node:path";
@@ -134134,6 +134254,8 @@ __export(src_exports, {
   buildTaskDeleteNoticeContent: () => buildTaskDeleteNoticeContent,
   buildTaskDeleteNoticeIdempotencyKey: () => buildTaskDeleteNoticeIdempotencyKey,
   buildTaskLineageTrailer: () => buildTaskLineageTrailer,
+  buildTaskRecommendationNoticeContent: () => buildTaskRecommendationNoticeContent,
+  buildTaskRecommendationNoticeIdempotencyKey: () => buildTaskRecommendationNoticeIdempotencyKey,
   buildToolOutputTruncationMarker: () => buildToolOutputTruncationMarker,
   buildTriageHeartbeatGuidance: () => buildTriageHeartbeatGuidance,
   buildTriageMemoryInstructions: () => buildTriageMemoryInstructions,
@@ -134464,6 +134586,7 @@ __export(src_exports, {
   getTaskMergeBlocker: () => getTaskMergeBlocker,
   getTaskMoveDisposer: () => getTaskMoveDisposer,
   getTaskPriorityRank: () => getTaskPriorityRank,
+  getTaskRecommendationNoticeMailbox: () => getTaskRecommendationNoticeMailbox,
   getTemplatesForRole: () => getTemplatesForRole,
   getTotalAgentActiveMs: () => getTotalAgentActiveMs,
   getTrait: () => getTrait,
@@ -134714,6 +134837,7 @@ __export(src_exports, {
   normalizeWorkflowPromptOverrides: () => normalizeWorkflowPromptOverrides,
   normalizeWorkflowReviewFindings: () => normalizeWorkflowReviewFindings,
   notifyOperatorOfNonOperatorDelete: () => notifyOperatorOfNonOperatorDelete,
+  notifyOperatorOfTaskRecommendations: () => notifyOperatorOfTaskRecommendations,
   overseerAdviceSeverityRank: () => overseerAdviceSeverityRank,
   parseAgentManifest: () => parseAgentManifest,
   parseCompanyArchive: () => parseCompanyArchive,
@@ -134823,6 +134947,7 @@ __export(src_exports, {
   registerStepParser: () => registerStepParser,
   registerTaskDeleteNoticeMailbox: () => registerTaskDeleteNoticeMailbox,
   registerTaskMoveDisposer: () => registerTaskMoveDisposer,
+  registerTaskRecommendationNoticeMailbox: () => registerTaskRecommendationNoticeMailbox,
   registerTraitHookImpl: () => registerTraitHookImpl,
   rekeyFallbackProjectPartition: () => rekeyFallbackProjectPartition,
   releaseEmbeddedRuntimeLease: () => releaseEmbeddedRuntimeLease,
@@ -135450,6 +135575,7 @@ var init_src2 = __esm({
     init_task_document_concurrency();
     init_task_delete_attribution();
     init_task_delete_notice();
+    init_task_recommendation_notice();
     init_session_identity_registry();
     init_task_lifecycle_event_retention();
     init_task_lifecycle_consumer_identity();
@@ -136287,7 +136413,7 @@ var init_logger3 = __esm({
 });
 
 // ../engine/src/agents/agent-logger.ts
-import { createHash as createHash20 } from "node:crypto";
+import { createHash as createHash21 } from "node:crypto";
 function truncateToolResultDetail(value2) {
   if (value2.length <= TOOL_RESULT_DETAIL_LIMIT) return value2;
   return `${value2.slice(0, TOOL_RESULT_DETAIL_LIMIT)}${TOOL_RESULT_DETAIL_TRUNCATION_NOTICE}`;
@@ -136376,7 +136502,7 @@ function summarizeToolArgs(name2, args) {
     const json2 = JSON.stringify(args);
     if (!json2 || json2 === "{}" || json2 === "[]") return void 0;
     if (json2.length <= STRUCTURED_ARG_SUMMARY_MAX) return json2;
-    const hash3 = createHash20("sha256").update(json2).digest("hex").slice(0, STRUCTURED_ARG_HASH_HEX_LEN);
+    const hash3 = createHash21("sha256").update(json2).digest("hex").slice(0, STRUCTURED_ARG_HASH_HEX_LEN);
     const suffix = `\u2026#${hash3}`;
     const keep = Math.max(0, STRUCTURED_ARG_SUMMARY_MAX - suffix.length);
     return `${json2.slice(0, keep)}${suffix}`;
@@ -137156,7 +137282,7 @@ var init_gating_classifications = __esm({
 });
 
 // ../engine/src/agents/agent-action-gate.ts
-import { createHash as createHash21 } from "node:crypto";
+import { createHash as createHash22 } from "node:crypto";
 function getExemptTools() {
   if (!_exemptTools) {
     _exemptTools = new Set(DEFAULT_EXEMPT_TOOLS);
@@ -137208,7 +137334,7 @@ function evaluateAgentActionGate(params) {
   if (params.toolName === "bash") {
     const command2 = extractShellCommand(args);
     const git7 = classifyGitCommand(command2);
-    resourceId = command2 ? `cmd:${createHash21("sha256").update(command2).digest("hex").slice(0, 16)}` : void 0;
+    resourceId = command2 ? `cmd:${createHash22("sha256").update(command2).digest("hex").slice(0, 16)}` : void 0;
     if (git7?.write) {
       category = "git_write";
       operation = git7.operation;
@@ -140740,11 +140866,11 @@ var init_planning_handoff_recovery = __esm({
 // ../engine/src/plan-review-continuation.ts
 async function seedPreReleasePlanReviewContinuation(store, task, ir2, options = {}) {
   const node = resolvePreReleasePlanReviewNode(ir2);
-  if (!node || node.column !== task.column) return { seeded: false };
+  if (!node || node.column !== task.column) return { seeded: false, reason: "no-pre-release-plan-review" };
   if (isTaskBlockedOnApproval(task)) return { seeded: false, reason: "awaiting-approval" };
   if (task.paused === true || task.userPaused === true) return { seeded: false, reason: "paused" };
   const items = await store.listWorkflowWorkItemsForTask(task.id);
-  const active2 = items.filter((item2) => ACTIVE_WORKFLOW_WORK_ITEM_STATES.includes(item2.state));
+  const active2 = items.filter((item2) => ACTIVE_WORKFLOW_WORK_ITEM_STATES.includes(item2.state) && item2.id !== options.retirePredecessorId);
   if (active2.length > 0) return { seeded: false, reason: "active-continuation" };
   const continuationSequence = items.length;
   const input = {
@@ -140760,6 +140886,9 @@ async function seedPreReleasePlanReviewContinuation(store, task, ir2, options =
     targetColumn: task.column,
     irHash: computeWorkflowIrPin(ir2, node.id).irHash
   };
+  if (options.retirePredecessorId) {
+    return store.seedStrandedPlanReviewContinuation(input, { retirePredecessorId: options.retirePredecessorId });
+  }
   if (options.atomic) return store.seedStrandedPlanReviewContinuation(input);
   const item = await store.replaceActiveTaskWorkflowContinuation(input);
   return { seeded: true, workItemId: item.id };
@@ -140774,7 +140903,7 @@ async function resumeApprovedPlanReviewHandoff(store, task, ir2) {
   if (seeded.seeded) return { resumed: true, reason: "seeded", workItemId: seeded.workItemId };
   return {
     resumed: false,
-    reason: seeded.reason ?? "not-plan-in-place"
+    reason: seeded.reason === void 0 || seeded.reason === "no-pre-release-plan-review" ? "not-plan-in-place" : seeded.reason
   };
 }
 function evaluateStrandedHoldContinuation(input) {
@@ -140812,7 +140941,7 @@ var init_plan_review_continuation = __esm({
 });
 
 // ../engine/src/execution/hold-release.ts
-import { createHash as createHash22 } from "node:crypto";
+import { createHash as createHash23 } from "node:crypto";
 import { readFile as readFile31 } from "node:fs/promises";
 function findColumn2(ir2, columnId) {
   if (ir2.version !== "v2") return void 0;
@@ -140850,9 +140979,9 @@ async function checkAndRecordUnplannedExecutionBlock(store, task, ir2) {
       promptContent = "";
     }
   }
-  const promptMarker = promptContent.length > 0 ? createHash22("sha256").update(promptContent).digest("hex") : "missing";
+  const promptMarker = promptContent.length > 0 ? createHash23("sha256").update(promptContent).digest("hex") : "missing";
   const dependencies = [...task.dependencies ?? []].sort();
-  const episode = createHash22("sha256").update(JSON.stringify({
+  const episode = createHash23("sha256").update(JSON.stringify({
     planReviewNode,
     promptMarker,
     dependencies,
@@ -170972,7 +171101,7 @@ ${getErrorStderr(error3) ?? ""}`;
 });
 
 // ../engine/src/worktree/secrets-env-writer.ts
-import { createHash as createHash23 } from "node:crypto";
+import { createHash as createHash24 } from "node:crypto";
 import { execFile as execFile8 } from "node:child_process";
 import { promises as fs6 } from "node:fs";
 import path2 from "node:path";
@@ -170981,7 +171110,7 @@ function isValidFilename(filename) {
   return !!filename && !filename.includes("/") && !filename.includes("\\") && !filename.includes("..") && !filename.includes("\0") && filename !== FINGERPRINT_FILE;
 }
 function sha2562(content) {
-  return createHash23("sha256").update(Buffer.from(content, "utf8")).digest("hex");
+  return createHash24("sha256").update(Buffer.from(content, "utf8")).digest("hex");
 }
 function quote(value2) {
   return `"${value2.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t")}"`;
@@ -179388,7 +179517,7 @@ var init_mission_feature_sync = __esm({
 // ../engine/src/agent-tools.ts
 import { appendFile as appendFile3, mkdir as mkdir28, readFile as readFile38, readdir as readdir11, realpath as realpath2, stat as stat11, writeFile as writeFile26 } from "node:fs/promises";
 import { existsSync as existsSync53 } from "node:fs";
-import { createHash as createHash24, randomUUID as randomUUID47 } from "node:crypto";
+import { createHash as createHash25, randomUUID as randomUUID47 } from "node:crypto";
 import { tmpdir as tmpdir5 } from "node:os";
 import { extname as extname4, isAbsolute as isAbsolute14, join as join66, relative as relative14, resolve as resolve38, sep as sep10 } from "node:path";
 import { Type as Type2 } from "@earendil-works/pi-ai";
@@ -179432,7 +179561,7 @@ async function readAgentMemoryWorkspaceLongTerm(rootDir, agentId) {
   }
 }
 function qmdAgentMemoryCollectionName2(rootDir, agentId) {
-  const hash3 = createHash24("sha1").update(`${rootDir}:${agentId}`).digest("hex").slice(0, 12);
+  const hash3 = createHash25("sha1").update(`${rootDir}:${agentId}`).digest("hex").slice(0, 12);
   return `fusion-agent-memory-${sanitizeAgentMemoryId(agentId).toLowerCase()}-${hash3}`;
 }
 function buildQmdAgentMemoryCollectionAddArgs(rootDir, agentId) {
@@ -191009,7 +191138,7 @@ var init_agent_heartbeat_error_recovery = __esm({
 
 // ../engine/src/agent-heartbeat.ts
 import { Type as Type3 } from "@earendil-works/pi-ai";
-import { createHash as createHash25 } from "node:crypto";
+import { createHash as createHash26 } from "node:crypto";
 async function resolveHeartbeatReboundColumn(taskStore, taskId) {
   try {
     return resolveReboundTarget(await resolveWorkflowIrForTask(taskStore, taskId)) ?? "todo";
@@ -191164,7 +191293,7 @@ function truncatePrompt(text3, maxChars) {
 ... (truncated, ${text3.length} chars)`;
 }
 function shortContentHash(value2) {
-  return createHash25("sha256").update(value2).digest("hex").slice(0, 8);
+  return createHash26("sha256").update(value2).digest("hex").slice(0, 8);
 }
 function buildIdentitySnapshot(args) {
   const { agent, resolvedInstructions, workspaceMemory } = args;
@@ -199053,7 +199182,7 @@ var init_verification_utils = __esm({
 
 // ../engine/src/merge/merge-dependency-sync.ts
 import { exec as exec25 } from "node:child_process";
-import { createHash as createHash26 } from "node:crypto";
+import { createHash as createHash27 } from "node:crypto";
 import { existsSync as existsSync56, readFileSync as readFileSync18, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join69 } from "node:path";
 import { promisify as promisify35 } from "node:util";
@@ -199080,7 +199209,7 @@ function computeLockfileHash(rootDir) {
     const p2 = join69(rootDir, name2);
     if (existsSync56(p2)) {
       try {
-        return createHash26("sha256").update(readFileSync18(p2)).digest("hex");
+        return createHash27("sha256").update(readFileSync18(p2)).digest("hex");
       } catch {
         return null;
       }
@@ -201622,7 +201751,7 @@ var init_mesh_lease_manager = __esm({
 });
 
 // ../engine/src/merge/merger-integration-worktree.ts
-import { createHash as createHash27 } from "node:crypto";
+import { createHash as createHash28 } from "node:crypto";
 import { exec as exec31, execFile as execFile22 } from "node:child_process";
 import { promisify as promisify45 } from "node:util";
 function quoteAutostashArg(value2) {
@@ -201745,7 +201874,7 @@ async function gitDirtyFingerprintLocal(rootDir) {
       )
     ]);
     if (!diffOut && !statusOut) return "";
-    return createHash27("sha256").update(diffOut).update("\0").update(statusOut).digest("hex");
+    return createHash28("sha256").update(diffOut).update("\0").update(statusOut).digest("hex");
   } catch {
     return "";
   }
@@ -202731,7 +202860,7 @@ import { execSync as execSync5, exec as exec33 } from "node:child_process";
 import * as childProcess4 from "node:child_process";
 import { promisify as promisify48 } from "node:util";
 import { existsSync as existsSync59, readFileSync as readFileSync21, writeFileSync as writeFileSync8, unlinkSync as unlinkSync3, renameSync as renameSync4 } from "node:fs";
-import { createHash as createHash28 } from "node:crypto";
+import { createHash as createHash29 } from "node:crypto";
 import { join as join73, resolve as resolve44 } from "node:path";
 import { hostname as hostname2 } from "node:os";
 import { Type as Type4 } from "typebox";
@@ -202979,7 +203108,7 @@ async function gitDirtyFingerprint(rootDir) {
       )
     ]);
     if (!diffOut && !statusOut) return "";
-    return createHash28("sha256").update(diffOut).update("\0").update(statusOut).digest("hex");
+    return createHash29("sha256").update(diffOut).update("\0").update(statusOut).digest("hex");
   } catch {
     return "";
   }
@@ -225402,7 +225531,7 @@ You are ${assignedAgent.name}${assignedAgent.title?.trim() ? `, ${assignedAgent.
                 }
                 return;
               }
-              const duplicateReport = { outcome: "parked" };
+              const duplicateReport = { outcome: "parked", planningWorkItemId };
               if (await this.tryFinalizeExplicitDuplicateMarker(task, written, settings, {
                 isReplan,
                 feedback
@@ -225421,6 +225550,7 @@ You are ${assignedAgent.name}${assignedAgent.title?.trim() ? `, ${assignedAgent.
                 isReplan,
                 feedback
               });
+              finalizeReport.planningWorkItemId = planningWorkItemId;
               this.options.onSpecifyComplete?.(task, finalizeReport);
             } finally {
               this.activeSessions.delete(task.id);
@@ -240992,6 +241122,38 @@ var init_execution_block_classifier = __esm({
   }
 });
 
+// ../engine/src/executor/completion-recommendation-notice.ts
+function dispatchAcceptedCompletionRecommendationNotice(args) {
+  if (!args.recommendations?.length) return;
+  const pending = (async () => {
+    const settings = args.settings ?? await args.store.getSettings();
+    const task = await args.store.getTask(args.taskId);
+    if (!task || task.deletedAt) return;
+    await notifyOperatorOfTaskRecommendations(
+      args.store,
+      { id: args.taskId, title: args.taskTitle ?? task.title },
+      args.recommendations,
+      settings
+    );
+  })();
+  pendingNotices.add(pending);
+  void pending.catch((error3) => {
+    args.log?.warn(
+      `Failed to dispatch recommendation mailbox notice for ${args.taskId}: ${error3 instanceof Error ? error3.message : String(error3)}`
+    );
+  }).finally(() => {
+    pendingNotices.delete(pending);
+  });
+}
+var pendingNotices;
+var init_completion_recommendation_notice = __esm({
+  "../engine/src/executor/completion-recommendation-notice.ts"() {
+    "use strict";
+    init_src2();
+    pendingNotices = /* @__PURE__ */ new Set();
+  }
+});
+
 // ../engine/src/executor/create-task-done-tool.ts
 import { Type as Type9 } from "@earendil-works/pi-ai";
 function createTaskDoneTool(deps, taskId, worktreePath, promptContent, codeReviewVerdicts, onDone, audit) {
@@ -241328,6 +241490,16 @@ ${rerunSuffix}`
         bulkCompletionRefusalAt: null
       });
       await store.logEntry(taskId, "Task marked done by agent", void 0, deps.getRunContextFor(taskId));
+      if (completionRecommendations !== void 0) {
+        dispatchAcceptedCompletionRecommendationNotice({
+          store,
+          taskId,
+          taskTitle: task.title,
+          recommendations: completionRecommendations,
+          settings,
+          log: executorLog
+        });
+      }
       const latestTask = await store.getTask(taskId);
       let latestColumn = latestTask.column;
       if (latestColumn === await resolveReboundColumnFor(store, taskId)) {
@@ -241366,6 +241538,7 @@ var init_create_task_done_tool = __esm({
     init_completion_predicates();
     init_task_done_refusal_handler();
     init_validate_completion_recommendations();
+    init_completion_recommendation_notice();
   }
 });
 
@@ -252692,6 +252865,16 @@ ${rerunSuffix}` });
     if (latestColumn === await resolveWipTargetForTask(deps.store, task.id) && !hardPauseActive && beforeWatchdog && !beforeWatchdog.deletedAt && !(rejectIfPaused && (beforeWatchdog.paused || beforeWatchdog.userPaused))) {
       deps.scheduleCompletedTaskWatchdog(task.id, "fn_task_done");
     }
+    if (recommendations !== void 0) {
+      dispatchAcceptedCompletionRecommendationNotice({
+        store: deps.store,
+        taskId: task.id,
+        taskTitle: task.title,
+        recommendations,
+        settings,
+        log: executorLog
+      });
+    }
     return { completed: true, hardPauseActive };
   } catch (error3) {
     await restoreNoCommitsExpected();
@@ -252750,6 +252933,7 @@ var init_plan_review_no_op = __esm({
     init_src2();
     init_logger3();
     init_lifecycle_columns();
+    init_completion_recommendation_notice();
   }
 });
 
@@ -256258,14 +256442,14 @@ ${stdout.trim()}`);
 
 // ../engine/src/missions/mission-execution-loop.ts
 import { EventEmitter as EventEmitter26 } from "node:events";
-import { createHash as createHash29 } from "node:crypto";
+import { createHash as createHash30 } from "node:crypto";
 import { exec as exec56 } from "node:child_process";
 import { promisify as promisify74 } from "node:util";
 function quoteShellArg7(value2) {
   return `'${value2.replace(/'/g, `'\\''`)}'`;
 }
 function fingerprintMissionValidationInput(landedSha, provider, modelId, systemPrompt, userPrompt) {
-  return createHash29("sha256").update(Buffer.from(JSON.stringify(["mission-validation-input-v1", landedSha, provider, modelId, systemPrompt, userPrompt]), "utf8")).digest("hex");
+  return createHash30("sha256").update(Buffer.from(JSON.stringify(["mission-validation-input-v1", landedSha, provider, modelId, systemPrompt, userPrompt]), "utf8")).digest("hex");
 }
 var execAsync53, loopLog, VALIDATION_TIMEOUT_MS, MAX_VALIDATION_RESPONSE_BYTES, MAX_VALIDATION_JSON_CANDIDATES, VALIDATION_FAILURE_BUDGET_PER_FINGERPRINT, MissionExecutionLoop;
 var init_mission_execution_loop = __esm({
@@ -267804,9 +267988,9 @@ var init_routine_scheduler = __esm({
 });
 
 // ../engine/src/healing/stuck-task-detector.ts
-import { createHash as createHash30 } from "node:crypto";
+import { createHash as createHash31 } from "node:crypto";
 function hashToolDetail(detail) {
-  return createHash30("sha256").update(detail).digest("hex").slice(0, TOOL_DETAIL_HASH_HEX_LEN);
+  return createHash31("sha256").update(detail).digest("hex").slice(0, TOOL_DETAIL_HASH_HEX_LEN);
 }
 function buildToolFingerprint(toolName, toolDetail) {
   const name2 = toolName.trim().toLowerCase() || "tool";
@@ -271384,7 +271568,7 @@ var init_node_dispatch_validation = __esm({
 });
 
 // ../engine/src/runtimes/in-process-runtime.ts
-import { createHash as createHash31 } from "node:crypto";
+import { createHash as createHash32 } from "node:crypto";
 import { EventEmitter as EventEmitter27 } from "node:events";
 import { setImmediate as setImmediateCb4 } from "node:timers";
 function createDiscoveryPluginLoaderOptions(scopedStore) {
@@ -271475,11 +271659,46 @@ async function reactToSpecificationComplete(deps) {
     return;
   }
   deps.log(`Specified ${deps.taskId} \u2192 todo`);
-  const live = await deps.getTask(deps.taskId);
-  if (!live || live.paused || live.userPaused) return;
-  const ir2 = await deps.resolveIr(live.id);
-  await deps.seed(live, ir2);
-  deps.kick();
+  const sleep10 = deps.sleep ?? ((ms2) => new Promise((resolve110) => setTimeout(resolve110, ms2)));
+  const QUIET_PARK_REASONS = /* @__PURE__ */ new Set([
+    "no-pre-release-plan-review",
+    "awaiting-approval",
+    "paused",
+    "plan-review-passed"
+  ]);
+  const RETRY_DELAYS_MS2 = [1e3, 5e3];
+  for (let attempt = 0; ; attempt++) {
+    let failure = null;
+    try {
+      const live = await deps.getTask(deps.taskId);
+      if (!live || live.paused || live.userPaused) return;
+      if (live.status === "needs-replan") {
+        deps.log(`Plan Review handoff for ${deps.taskId} not armed (needs-replan)`);
+        return;
+      }
+      const ir2 = await deps.resolveIr(live.id);
+      const result2 = await deps.seed(live, ir2);
+      if (result2.seeded) {
+        deps.kick();
+        return;
+      }
+      if (result2.reason && QUIET_PARK_REASONS.has(result2.reason)) {
+        deps.log(`Plan Review handoff for ${deps.taskId} not armed (${result2.reason})`);
+        return;
+      }
+      failure = result2.reason ?? "not-seeded";
+    } catch (error3) {
+      failure = error3 instanceof Error ? error3.message : String(error3);
+    }
+    if (attempt >= RETRY_DELAYS_MS2.length) {
+      deps.warn(
+        `Plan Review handoff for ${deps.taskId} failed after ${attempt + 1} attempts (${failure}) \u2014 stranded-continuation self-healing will recover it`
+      );
+      return;
+    }
+    deps.warn(`Plan Review handoff for ${deps.taskId} did not seed (${failure}) \u2014 retrying`);
+    await sleep10(RETRY_DELAYS_MS2[attempt]);
+  }
 }
 async function drainDuePlanningContinuations(deps) {
   const items = await deps.listDue();
@@ -271614,7 +271833,7 @@ function stableNotificationJson(value2) {
   return `{${fields.join(",")}}`;
 }
 function buildCliAgentNotificationDedupeKey(input) {
-  const notificationFingerprint = createHash31("sha256").update(stableNotificationJson(input.info.notification ?? null)).digest("hex").slice(0, 16);
+  const notificationFingerprint = createHash32("sha256").update(stableNotificationJson(input.info.notification ?? null)).digest("hex").slice(0, 16);
   const waitingEpoch = input.session?.updatedAt ?? "unknown-waiting-epoch";
   return [
     "cli-agent",
@@ -271769,6 +271988,8 @@ var init_in_process_runtime = __esm({
       messageStore;
       /** FNXC:TaskDeleteNotice 2026-07-26-16:10: identity-guarded teardown for the delete-notice mailbox seam. */
       unregisterTaskDeleteNoticeMailbox;
+      /** FNXC:TaskRecommendations 2026-08-13-03:56: identity-guarded teardown for the store-scoped recommendation notice seam. */
+      unregisterTaskRecommendationNoticeMailbox;
       chatStore;
       detachAgentLinkSync;
       /**
@@ -271827,7 +272048,8 @@ var init_in_process_runtime = __esm({
             createTaskStoreForBackend: createTaskStoreForBackend2,
             buildConsumerId: buildConsumerId2,
             createProjectScopedPluginMcpProvider: createProjectScopedPluginMcpProvider2,
-            registerTaskDeleteNoticeMailbox: registerTaskDeleteNoticeMailbox2
+            registerTaskDeleteNoticeMailbox: registerTaskDeleteNoticeMailbox2,
+            registerTaskRecommendationNoticeMailbox: registerTaskRecommendationNoticeMailbox2
           } = await Promise.resolve().then(() => (init_src2(), src_exports));
           if (this.config.externalTaskStore) {
             this.taskStore = this.config.externalTaskStore;
@@ -271886,6 +272108,10 @@ var init_in_process_runtime = __esm({
             this.taskStore,
             this.messageStore
           );
+          this.unregisterTaskRecommendationNoticeMailbox = registerTaskRecommendationNoticeMailbox2(
+            this.taskStore,
+            this.messageStore
+          );
           await yieldEventLoop4();
           const pluginLayer = this.taskStore.getAsyncLayer();
           if (!pluginLayer) {
@@ -272377,9 +272603,19 @@ var init_in_process_runtime = __esm({
                   outcome: report2.outcome,
                   getTask: (id) => Promise.resolve(this.taskStore.getTask(id)),
                   resolveIr: (id) => resolveWorkflowIrForTask(this.taskStore, id),
-                  seed: (task, ir2) => seedPreReleasePlanReviewContinuation(this.taskStore, task, ir2),
+                  /*
+                  FNXC:PlanningHandoffAtomicity 2026-08-13-03:49:
+                  The report carries the planning session's own durable work item id so the
+                  seeder can retire that exact predecessor row atomically with the successor
+                  install. Without it the seeder raced triage's finally-block terminal
+                  transition and bailed on its own caller (529 stranded cards in 18 days).
+                  */
+                  seed: (task, ir2) => seedPreReleasePlanReviewContinuation(this.taskStore, task, ir2, {
+                    retirePredecessorId: report2.planningWorkItemId
+                  }),
                   kick: () => this.kickWorkflowContinuationProcessor(),
-                  log: (message) => runtimeLog.log(message)
+                  log: (message) => runtimeLog.log(message),
+                  warn: (message) => runtimeLog.warn(message)
                 }).catch((error3) => {
                   runtimeLog.error(`Failed to start Todo plan review for ${t.id}:`, error3);
                 });
@@ -272667,6 +272903,8 @@ var init_in_process_runtime = __esm({
         this.backendShutdown = void 0;
         this.unregisterTaskDeleteNoticeMailbox?.();
         this.unregisterTaskDeleteNoticeMailbox = void 0;
+        this.unregisterTaskRecommendationNoticeMailbox?.();
+        this.unregisterTaskRecommendationNoticeMailbox = void 0;
         let stopError;
         try {
           if (this.workflowContinuationTimer) {
@@ -280460,9 +280698,9 @@ import { access as access10, unlink as unlink11, writeFile as writeFile33 } from
 import net2 from "node:net";
 import { platform as platform3, tmpdir as tmpdir12 } from "node:os";
 import { join as join91 } from "node:path";
-import { createHash as createHash32 } from "node:crypto";
+import { createHash as createHash33 } from "node:crypto";
 function projectHash(projectId2) {
-  return createHash32("sha1").update(projectId2).digest("hex").slice(0, 16);
+  return createHash33("sha1").update(projectId2).digest("hex").slice(0, 16);
 }
 function computeEngineSocketPath(projectId2) {
   const hash3 = projectHash(projectId2);
@@ -300272,9 +300510,9 @@ __export(import_translate_service_exports, {
   selectEligibleItems: () => selectEligibleItems,
   translateImportItems: () => translateImportItems
 });
-import { createHash as createHash33 } from "node:crypto";
+import { createHash as createHash34 } from "node:crypto";
 function hashSourceContent(title2, body) {
-  return createHash33("sha256").update(`${title2}\0${body}`).digest("hex");
+  return createHash34("sha256").update(`${title2}\0${body}`).digest("hex");
 }
 function resolveTargetLocale(settingsLocale, requestLocale, globalLanguage) {
   if (isLocale(settingsLocale)) return settingsLocale;
@@ -307276,7 +307514,7 @@ var init_auth_middleware = __esm({
 });
 
 // ../dashboard/src/routes/register-task-workflow-routes.ts
-import { createHash as createHash34 } from "node:crypto";
+import { createHash as createHash35 } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { readFile as readFile53, stat as stat13 } from "node:fs/promises";
 import { join as join96 } from "node:path";
@@ -307682,7 +307920,7 @@ function buildWorkflowReviewItemId(task, result2, findingId, resolution) {
     findingId,
     resolution
   });
-  return `workflow-review-${createHash34("sha256").update(identity).digest("hex").slice(0, 24)}`;
+  return `workflow-review-${createHash35("sha256").update(identity).digest("hex").slice(0, 24)}`;
 }
 async function buildWorkflowReviewItems(task, store) {
   const declaredTopLevelReviewResultSources = await getDeclaredTopLevelReviewResultSources(task, store);
@@ -308131,6 +308369,32 @@ function registerTaskWorkflowRoutes(ctx, deps) {
       rethrowAsApiError8(err);
     }
   });
+  router.get("/tasks/recommendations", async (req, res) => {
+    try {
+      const { store: scopedStore } = await getProjectContext2(req);
+      const parsePageNumber = (value2, name2) => {
+        if (value2 === void 0) return void 0;
+        if (typeof value2 !== "string" || value2.trim() === "" || !Number.isInteger(Number(value2)) || Number(value2) < 0) {
+          throw badRequest(`${name2} must be a non-negative integer`);
+        }
+        return Number(value2);
+      };
+      const requestedLimit = parsePageNumber(req.query.limit, "limit");
+      const offset = parsePageNumber(req.query.offset, "offset");
+      if (requestedLimit === 0) throw badRequest("limit must be a positive integer");
+      const limit2 = requestedLimit === void 0 ? void 0 : Math.min(200, requestedLimit);
+      let completeColumns;
+      try {
+        completeColumns = await resolveProjectColumnsForRoles(scopedStore, ["complete"]);
+      } catch {
+        completeColumns = /* @__PURE__ */ new Set(["done"]);
+      }
+      res.json(await scopedStore.listTaskRecommendations({ completeColumns, limit: limit2, offset }));
+    } catch (err) {
+      if (err instanceof ApiError) throw err;
+      rethrowAsApiError8(err);
+    }
+  });
   router.post("/tasks/duplicate-check", async (req, res) => {
     try {
       const { store: scopedStore } = await getProjectContext2(req);
@@ -357318,8 +357582,8 @@ var init_register_settings_sync_routes = __esm({
             exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
             version: 1
           };
-          const { createHash: createHash38 } = await import("node:crypto");
-          const checksum = createHash38("sha256").update(JSON.stringify(payloadWithoutChecksum)).digest("hex");
+          const { createHash: createHash39 } = await import("node:crypto");
+          const checksum = createHash39("sha256").update(JSON.stringify(payloadWithoutChecksum)).digest("hex");
           const localPeerInfo = await central.getLocalPeerInfo();
           await fetchFromRemoteNode(node, "/api/settings/sync-receive", {
             method: "POST",
@@ -357390,7 +357654,7 @@ var init_register_settings_sync_routes = __esm({
             });
             return;
           }
-          const { createHash: createHash38 } = await import("node:crypto");
+          const { createHash: createHash39 } = await import("node:crypto");
           const exportedAt = (/* @__PURE__ */ new Date()).toISOString();
           const payloadWithoutChecksum = {
             global: remoteSettings.global,
@@ -357399,7 +357663,7 @@ var init_register_settings_sync_routes = __esm({
             exportedAt,
             version: 1
           };
-          const checksum = createHash38("sha256").update(JSON.stringify(payloadWithoutChecksum)).digest("hex");
+          const checksum = createHash39("sha256").update(JSON.stringify(payloadWithoutChecksum)).digest("hex");
           const result2 = await central.applyRemoteSettings({
             ...payloadWithoutChecksum,
             checksum
@@ -384153,7 +384417,7 @@ var init_report_scrub = __esm({
 });
 
 // ../dashboard/src/report-pipeline.ts
-import { createHash as createHash35 } from "node:crypto";
+import { createHash as createHash36 } from "node:crypto";
 function resolveReportMode(actionType, settings) {
   return settings.reportModeByAction?.[actionType] ?? settings.reportMode ?? "draft-review";
 }
@@ -384269,7 +384533,7 @@ async function embedScreenshot(args) {
   try {
     const extension = EXT_BY_MIME[attachment.mimeType];
     if (!extension) return args.report;
-    const safeId2 = createHash35("sha256").update(`${args.report.sessionToken ?? ""}:${attachment.artifactId}`).digest("hex").slice(0, 32);
+    const safeId2 = createHash36("sha256").update(`${args.report.sessionToken ?? ""}:${attachment.artifactId}`).digest("hex").slice(0, 32);
     const path14 = `.fusion-reports/${safeId2}/screenshot.${extension}`;
     const uploaded = await args.client.uploadImageAsset({ owner: args.owner, repo: args.repo, path: path14, contentBase64: Buffer.from(attachment.bytes).toString("base64"), message: "chore: add Fusion report screenshot", mimeType: attachment.mimeType });
     const alt = markdownEscapeImageAlt(scrubReportText(attachment.filename, args.scrubContext) || "Report screenshot");
@@ -387383,7 +387647,7 @@ var init_types6 = __esm({
 });
 
 // ../dashboard/src/stt/model-manager.ts
-import { createHash as createHash36, randomUUID as randomUUID68 } from "node:crypto";
+import { createHash as createHash37, randomUUID as randomUUID68 } from "node:crypto";
 import { mkdir as mkdir40, open as open4, readFile as readFile63, readdir as readdir16, rename as rename12, rm as rm24, stat as stat18, writeFile as writeFile39 } from "node:fs/promises";
 import { join as join125, relative as relative26, resolve as resolve75, sep as sep20 } from "node:path";
 function parseSafeTarListing(listing) {
@@ -387472,7 +387736,7 @@ function createVoiceModelManager(options = {}) {
         if (!response.ok || !response.body) throw Object.assign(new Error("download failed"), { voiceReason: "network" });
         if (!current(g2, signal)) return state;
         const total = Number(response.headers.get("content-length")) || void 0;
-        const hash3 = createHash36("sha256");
+        const hash3 = createHash37("sha256");
         let bytes = 0;
         for await (const chunk of response.body) {
           if (!current(g2, signal)) return state;
@@ -402718,7 +402982,7 @@ var init_extension = __esm({
 });
 
 // src/commands/task-lifecycle.ts
-import { createHash as createHash37 } from "node:crypto";
+import { createHash as createHash38 } from "node:crypto";
 import { exec as exec63 } from "node:child_process";
 import * as childProcess5 from "node:child_process";
 import { mkdir as mkdir43, realpath as realpath7, rm as rm25 } from "node:fs/promises";
@@ -402891,7 +403155,7 @@ async function refreshAutomatedPrHead(input) {
     await mkdir43(refreshWorktreesDir, { recursive: true });
     temporary = join135(
       refreshWorktreesDir,
-      `pr-refresh-${createHash37("sha256").update(input.headBranch).digest("hex").slice(0, 16)}`
+      `pr-refresh-${createHash38("sha256").update(input.headBranch).digest("hex").slice(0, 16)}`
     );
     const reservationDir = join135(root, ".fusion", "pr-refresh-reservations");
     await mkdir43(reservationDir, { recursive: true });