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

package/dist/child-process-worker.js

@@ -2145,6 +2145,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,
@@ -68718,20 +68720,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 };
   }));
@@ -97109,8 +97123,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);
@@ -101253,6 +101267,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 limit = 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: limit, returnedRowCount: 0, totalRowCount: 0, hasMore: false };
+  const filter = 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(filter),
+    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(filter).orderBy(desc(project_exports.tasks.updatedAt), desc(project_exports.tasks.id)).limit(limit).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: limit, returnedRowCount, totalRowCount, hasMore: offset + returnedRowCount < totalRowCount };
+}
 var LEGACY_REVIEW_LANES5, LEGACY_ARCHIVE_LANES2;
 var init_reads = __esm({
   "../core/src/task-store/reads.ts"() {
@@ -101275,6 +101320,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();
@@ -103381,6 +103427,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);
       }
@@ -104107,8 +104156,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);
@@ -133246,6 +133295,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 title = task.title?.trim();
+  const heading = title ? `## Recommendations from ${task.id} \u2014 ${title}` : `## 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 (error2) {
+    noticeLog2.warn(
+      `Operator recommendation notice failed for ${task.id}: ${error2 instanceof Error ? error2.message : String(error2)}`
+    );
+    return false;
+  }
+}
+var noticeLog2, mailboxes2;
+var init_task_recommendation_notice = __esm({
+  "../core/src/task-recommendation-notice.ts"() {
+    "use strict";
+    init_logger2();
+    init_types();
+    noticeLog2 = createLogger2("task-recommendation-notice");
+    mailboxes2 = /* @__PURE__ */ new WeakMap();
+  }
+});
+
 // ../core/src/session-identity-registry.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { resolve as resolve23 } from "node:path";
@@ -134095,6 +134215,8 @@ __export(src_exports, {
   buildTaskDeleteNoticeContent: () => buildTaskDeleteNoticeContent,
   buildTaskDeleteNoticeIdempotencyKey: () => buildTaskDeleteNoticeIdempotencyKey,
   buildTaskLineageTrailer: () => buildTaskLineageTrailer,
+  buildTaskRecommendationNoticeContent: () => buildTaskRecommendationNoticeContent,
+  buildTaskRecommendationNoticeIdempotencyKey: () => buildTaskRecommendationNoticeIdempotencyKey,
   buildToolOutputTruncationMarker: () => buildToolOutputTruncationMarker,
   buildTriageHeartbeatGuidance: () => buildTriageHeartbeatGuidance,
   buildTriageMemoryInstructions: () => buildTriageMemoryInstructions,
@@ -134425,6 +134547,7 @@ __export(src_exports, {
   getTaskMergeBlocker: () => getTaskMergeBlocker,
   getTaskMoveDisposer: () => getTaskMoveDisposer,
   getTaskPriorityRank: () => getTaskPriorityRank,
+  getTaskRecommendationNoticeMailbox: () => getTaskRecommendationNoticeMailbox,
   getTemplatesForRole: () => getTemplatesForRole,
   getTotalAgentActiveMs: () => getTotalAgentActiveMs,
   getTrait: () => getTrait,
@@ -134675,6 +134798,7 @@ __export(src_exports, {
   normalizeWorkflowPromptOverrides: () => normalizeWorkflowPromptOverrides,
   normalizeWorkflowReviewFindings: () => normalizeWorkflowReviewFindings,
   notifyOperatorOfNonOperatorDelete: () => notifyOperatorOfNonOperatorDelete,
+  notifyOperatorOfTaskRecommendations: () => notifyOperatorOfTaskRecommendations,
   overseerAdviceSeverityRank: () => overseerAdviceSeverityRank,
   parseAgentManifest: () => parseAgentManifest,
   parseCompanyArchive: () => parseCompanyArchive,
@@ -134784,6 +134908,7 @@ __export(src_exports, {
   registerStepParser: () => registerStepParser,
   registerTaskDeleteNoticeMailbox: () => registerTaskDeleteNoticeMailbox,
   registerTaskMoveDisposer: () => registerTaskMoveDisposer,
+  registerTaskRecommendationNoticeMailbox: () => registerTaskRecommendationNoticeMailbox,
   registerTraitHookImpl: () => registerTraitHookImpl,
   rekeyFallbackProjectPartition: () => rekeyFallbackProjectPartition,
   releaseEmbeddedRuntimeLease: () => releaseEmbeddedRuntimeLease,
@@ -135411,6 +135536,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();
@@ -138781,7 +138907,7 @@ ${getErrorStderr(error2) ?? ""}`;
 });
 
 // ../engine/src/worktree/secrets-env-writer.ts
-import { createHash as createHash20 } from "node:crypto";
+import { createHash as createHash21 } from "node:crypto";
 import { execFile as execFile7 } from "node:child_process";
 import { promises as fs5 } from "node:fs";
 import path2 from "node:path";
@@ -138790,7 +138916,7 @@ function isValidFilename(filename) {
   return !!filename && !filename.includes("/") && !filename.includes("\\") && !filename.includes("..") && !filename.includes("\0") && filename !== FINGERPRINT_FILE;
 }
 function sha2562(content) {
-  return createHash20("sha256").update(Buffer.from(content, "utf8")).digest("hex");
+  return createHash21("sha256").update(Buffer.from(content, "utf8")).digest("hex");
 }
 function quote(value) {
   return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t")}"`;
@@ -141453,11 +141579,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 = {
@@ -141473,6 +141599,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 };
@@ -141512,7 +141641,7 @@ var init_plan_review_continuation = __esm({
 });
 
 // ../engine/src/execution/hold-release.ts
-import { createHash as createHash21 } from "node:crypto";
+import { createHash as createHash22 } from "node:crypto";
 import { readFile as readFile33 } from "node:fs/promises";
 function findColumn2(ir2, columnId) {
   if (ir2.version !== "v2") return void 0;
@@ -141550,9 +141679,9 @@ async function checkAndRecordUnplannedExecutionBlock(store, task, ir2) {
       promptContent = "";
     }
   }
-  const promptMarker = promptContent.length > 0 ? createHash21("sha256").update(promptContent).digest("hex") : "missing";
+  const promptMarker = promptContent.length > 0 ? createHash22("sha256").update(promptContent).digest("hex") : "missing";
   const dependencies = [...task.dependencies ?? []].sort();
-  const episode = createHash21("sha256").update(JSON.stringify({
+  const episode = createHash22("sha256").update(JSON.stringify({
     planReviewNode,
     promptMarker,
     dependencies,
@@ -144593,7 +144722,7 @@ var init_scheduler = __esm({
 });
 
 // ../engine/src/agents/agent-logger.ts
-import { createHash as createHash22 } from "node:crypto";
+import { createHash as createHash23 } from "node:crypto";
 function truncateToolResultDetail(value) {
   if (value.length <= TOOL_RESULT_DETAIL_LIMIT) return value;
   return `${value.slice(0, TOOL_RESULT_DETAIL_LIMIT)}${TOOL_RESULT_DETAIL_TRUNCATION_NOTICE}`;
@@ -144682,7 +144811,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 = createHash22("sha256").update(json2).digest("hex").slice(0, STRUCTURED_ARG_HASH_HEX_LEN);
+    const hash3 = createHash23("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}`;
@@ -149126,7 +149255,7 @@ var init_gating_classifications = __esm({
 });
 
 // ../engine/src/agents/agent-action-gate.ts
-import { createHash as createHash23 } from "node:crypto";
+import { createHash as createHash24 } from "node:crypto";
 function getExemptTools() {
   if (!_exemptTools) {
     _exemptTools = new Set(DEFAULT_EXEMPT_TOOLS);
@@ -149160,7 +149289,7 @@ function evaluateAgentActionGate(params) {
   if (params.toolName === "bash") {
     const command = extractShellCommand(args);
     const git7 = classifyGitCommand(command);
-    resourceId = command ? `cmd:${createHash23("sha256").update(command).digest("hex").slice(0, 16)}` : void 0;
+    resourceId = command ? `cmd:${createHash24("sha256").update(command).digest("hex").slice(0, 16)}` : void 0;
     if (git7?.write) {
       category = "git_write";
       operation = git7.operation;
@@ -177682,7 +177811,7 @@ var init_code_node_runner = __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 existsSync52 } from "node:fs";
-import { createHash as createHash24, randomUUID as randomUUID46 } from "node:crypto";
+import { createHash as createHash25, randomUUID as randomUUID46 } 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 resolve37, sep as sep10 } from "node:path";
 import { Type as Type2 } from "@earendil-works/pi-ai";
@@ -177726,7 +177855,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) {
@@ -187841,7 +187970,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 existsSync54, readFileSync as readFileSync17, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join68 } from "node:path";
 import { promisify as promisify35 } from "node:util";
@@ -187868,7 +187997,7 @@ function computeLockfileHash(rootDir) {
     const p2 = join68(rootDir, name2);
     if (existsSync54(p2)) {
       try {
-        return createHash26("sha256").update(readFileSync17(p2)).digest("hex");
+        return createHash27("sha256").update(readFileSync17(p2)).digest("hex");
       } catch {
         return null;
       }
@@ -190405,7 +190534,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(value) {
@@ -190528,7 +190657,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 "";
   }
@@ -191514,7 +191643,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 existsSync57, readFileSync as readFileSync20, 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 join72, resolve as resolve43 } from "node:path";
 import { hostname as hostname2 } from "node:os";
 import { Type as Type4 } from "typebox";
@@ -191762,7 +191891,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 "";
   }
@@ -200649,7 +200778,7 @@ import { promisify as promisify79 } from "node:util";
 // ../engine/src/runtimes/in-process-runtime.ts
 init_src2();
 init_scheduler();
-import { createHash as createHash31 } from "node:crypto";
+import { createHash as createHash32 } from "node:crypto";
 import { EventEmitter as EventEmitter27 } from "node:events";
 
 // ../engine/src/executor/public-reexports.ts
@@ -203376,7 +203505,7 @@ init_agent_tools();
 init_agent_logger();
 init_agent_usage_telemetry();
 import { Type as Type3 } from "@earendil-works/pi-ai";
-import { createHash as createHash25 } from "node:crypto";
+import { createHash as createHash26 } from "node:crypto";
 
 // ../engine/src/agents/approval-mail.ts
 init_src2();
@@ -205004,7 +205133,7 @@ function truncatePrompt(text2, maxChars) {
 ... (truncated, ${text2.length} chars)`;
 }
 function shortContentHash(value) {
-  return createHash25("sha256").update(value).digest("hex").slice(0, 8);
+  return createHash26("sha256").update(value).digest("hex").slice(0, 8);
 }
 function buildIdentitySnapshot(args) {
   const { agent, resolvedInstructions, workspaceMemory } = args;
@@ -233492,6 +233621,34 @@ init_effective_settings();
 init_run_audit();
 init_logger();
 init_lifecycle_columns();
+
+// ../engine/src/executor/completion-recommendation-notice.ts
+init_src2();
+var pendingNotices = /* @__PURE__ */ new Set();
+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((error2) => {
+    args.log?.warn(
+      `Failed to dispatch recommendation mailbox notice for ${args.taskId}: ${error2 instanceof Error ? error2.message : String(error2)}`
+    );
+  }).finally(() => {
+    pendingNotices.delete(pending);
+  });
+}
+
+// ../engine/src/executor/create-task-done-tool.ts
 function createTaskDoneTool(deps, taskId, worktreePath, promptContent, codeReviewVerdicts, onDone, audit) {
   const store = deps.store;
   return {
@@ -233826,6 +233983,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)) {
@@ -245658,6 +245825,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 (error2) {
     await restoreNoCommitsExpected();
@@ -250871,7 +251048,7 @@ init_notifier();
 
 // ../engine/src/healing/stuck-task-detector.ts
 init_logger();
-import { createHash as createHash29 } from "node:crypto";
+import { createHash as createHash30 } from "node:crypto";
 var stuckLog = createLogger("stuck-detector");
 var LOOP_ACTIVITY_THRESHOLD = 60;
 var LOOP_IGNORED_STEP_MIN = 10;
@@ -250882,7 +251059,7 @@ var TOOL_DETAIL_HASH_HEX_LEN = 16;
 var NO_PROGRESS_CHURN_THRESHOLD = 25;
 var VERIFICATION_DEADLINE_GRACE_MS = 5e3;
 function hashToolDetail(detail) {
-  return createHash29("sha256").update(detail).digest("hex").slice(0, TOOL_DETAIL_HASH_HEX_LEN);
+  return createHash30("sha256").update(detail).digest("hex").slice(0, TOOL_DETAIL_HASH_HEX_LEN);
 }
 function buildToolFingerprint(toolName, toolDetail) {
   const name2 = toolName.trim().toLowerCase() || "tool";
@@ -253632,7 +253809,7 @@ var MissionAutopilot = class {
 // ../engine/src/missions/mission-execution-loop.ts
 init_src2();
 import { EventEmitter as EventEmitter26 } from "node:events";
-import { createHash as createHash30 } from "node:crypto";
+import { createHash as createHash31 } from "node:crypto";
 
 // ../engine/src/missions/mission-verification.ts
 init_sandbox();
@@ -253704,7 +253881,7 @@ var MAX_VALIDATION_RESPONSE_BYTES = 256 * 1024;
 var MAX_VALIDATION_JSON_CANDIDATES = 8;
 var VALIDATION_FAILURE_BUDGET_PER_FINGERPRINT = 3;
 function fingerprintMissionValidationInput(landedSha, provider, modelId, systemPrompt, userPrompt) {
-  return createHash30("sha256").update(Buffer.from(JSON.stringify(["mission-validation-input-v1", landedSha, provider, modelId, systemPrompt, userPrompt]), "utf8")).digest("hex");
+  return createHash31("sha256").update(Buffer.from(JSON.stringify(["mission-validation-input-v1", landedSha, provider, modelId, systemPrompt, userPrompt]), "utf8")).digest("hex");
 }
 var MissionExecutionLoop = class extends EventEmitter26 {
   running = false;
@@ -257420,7 +257597,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
@@ -257439,6 +257616,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);
@@ -259013,11 +259191,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 sleep7 = deps.sleep ?? ((ms2) => new Promise((resolve47) => setTimeout(resolve47, 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 result = await deps.seed(live, ir2);
+      if (result.seeded) {
+        deps.kick();
+        return;
+      }
+      if (result.reason && QUIET_PARK_REASONS.has(result.reason)) {
+        deps.log(`Plan Review handoff for ${deps.taskId} not armed (${result.reason})`);
+        return;
+      }
+      failure = result.reason ?? "not-seeded";
+    } catch (error2) {
+      failure = error2 instanceof Error ? error2.message : String(error2);
+    }
+    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 sleep7(RETRY_DELAYS_MS2[attempt]);
+  }
 }
 async function drainDuePlanningContinuations(deps) {
   const items = await deps.listDue();
@@ -259154,7 +259367,7 @@ function stableNotificationJson(value) {
   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",
@@ -259266,6 +259479,8 @@ var InProcessRuntime = class extends EventEmitter27 {
   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;
   /**
@@ -259324,7 +259539,8 @@ var InProcessRuntime = class extends EventEmitter27 {
         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;
@@ -259383,6 +259599,10 @@ var InProcessRuntime = class extends EventEmitter27 {
         this.taskStore,
         this.messageStore
       );
+      this.unregisterTaskRecommendationNoticeMailbox = registerTaskRecommendationNoticeMailbox2(
+        this.taskStore,
+        this.messageStore
+      );
       await yieldEventLoop4();
       const pluginLayer = this.taskStore.getAsyncLayer();
       if (!pluginLayer) {
@@ -259874,9 +260094,19 @@ var InProcessRuntime = class extends EventEmitter27 {
               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((error2) => {
               runtimeLog.error(`Failed to start Todo plan review for ${t.id}:`, error2);
             });
@@ -260164,6 +260394,8 @@ var InProcessRuntime = class extends EventEmitter27 {
     this.backendShutdown = void 0;
     this.unregisterTaskDeleteNoticeMailbox?.();
     this.unregisterTaskDeleteNoticeMailbox = void 0;
+    this.unregisterTaskRecommendationNoticeMailbox?.();
+    this.unregisterTaskRecommendationNoticeMailbox = void 0;
     let stopError;
     try {
       if (this.workflowContinuationTimer) {