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

package/dist/extension.js

@@ -2067,6 +2067,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,
@@ -68640,20 +68642,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 };
   }));
@@ -97031,8 +97045,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);
@@ -101175,6 +101189,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"() {
@@ -101197,6 +101242,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();
@@ -103303,6 +103349,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);
       }
@@ -104029,8 +104078,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);
@@ -133168,6 +133217,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 (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 resolve23 } from "node:path";
@@ -134017,6 +134137,8 @@ __export(src_exports, {
   buildTaskDeleteNoticeContent: () => buildTaskDeleteNoticeContent,
   buildTaskDeleteNoticeIdempotencyKey: () => buildTaskDeleteNoticeIdempotencyKey,
   buildTaskLineageTrailer: () => buildTaskLineageTrailer,
+  buildTaskRecommendationNoticeContent: () => buildTaskRecommendationNoticeContent,
+  buildTaskRecommendationNoticeIdempotencyKey: () => buildTaskRecommendationNoticeIdempotencyKey,
   buildToolOutputTruncationMarker: () => buildToolOutputTruncationMarker,
   buildTriageHeartbeatGuidance: () => buildTriageHeartbeatGuidance,
   buildTriageMemoryInstructions: () => buildTriageMemoryInstructions,
@@ -134347,6 +134469,7 @@ __export(src_exports, {
   getTaskMergeBlocker: () => getTaskMergeBlocker,
   getTaskMoveDisposer: () => getTaskMoveDisposer,
   getTaskPriorityRank: () => getTaskPriorityRank,
+  getTaskRecommendationNoticeMailbox: () => getTaskRecommendationNoticeMailbox,
   getTemplatesForRole: () => getTemplatesForRole,
   getTotalAgentActiveMs: () => getTotalAgentActiveMs,
   getTrait: () => getTrait,
@@ -134597,6 +134720,7 @@ __export(src_exports, {
   normalizeWorkflowPromptOverrides: () => normalizeWorkflowPromptOverrides,
   normalizeWorkflowReviewFindings: () => normalizeWorkflowReviewFindings,
   notifyOperatorOfNonOperatorDelete: () => notifyOperatorOfNonOperatorDelete,
+  notifyOperatorOfTaskRecommendations: () => notifyOperatorOfTaskRecommendations,
   overseerAdviceSeverityRank: () => overseerAdviceSeverityRank,
   parseAgentManifest: () => parseAgentManifest,
   parseCompanyArchive: () => parseCompanyArchive,
@@ -134706,6 +134830,7 @@ __export(src_exports, {
   registerStepParser: () => registerStepParser,
   registerTaskDeleteNoticeMailbox: () => registerTaskDeleteNoticeMailbox,
   registerTaskMoveDisposer: () => registerTaskMoveDisposer,
+  registerTaskRecommendationNoticeMailbox: () => registerTaskRecommendationNoticeMailbox,
   registerTraitHookImpl: () => registerTraitHookImpl,
   rekeyFallbackProjectPartition: () => rekeyFallbackProjectPartition,
   releaseEmbeddedRuntimeLease: () => releaseEmbeddedRuntimeLease,
@@ -135333,6 +135458,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();
@@ -135424,7 +135550,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(value) {
   if (value.length <= TOOL_RESULT_DETAIL_LIMIT) return value;
   return `${value.slice(0, TOOL_RESULT_DETAIL_LIMIT)}${TOOL_RESULT_DETAIL_TRUNCATION_NOTICE}`;
@@ -135513,7 +135639,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}`;
@@ -136293,7 +136419,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);
@@ -136345,7 +136471,7 @@ function evaluateAgentActionGate(params) {
   if (params.toolName === "bash") {
     const command = extractShellCommand(args);
     const git7 = classifyGitCommand(command);
-    resourceId = command ? `cmd:${createHash21("sha256").update(command).digest("hex").slice(0, 16)}` : void 0;
+    resourceId = command ? `cmd:${createHash22("sha256").update(command).digest("hex").slice(0, 16)}` : void 0;
     if (git7?.write) {
       category = "git_write";
       operation = git7.operation;
@@ -139877,11 +140003,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 = {
@@ -139897,6 +140023,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 };
@@ -139911,7 +140040,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) {
@@ -139949,7 +140078,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;
@@ -139987,9 +140116,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,
@@ -170109,7 +170238,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";
@@ -170118,7 +170247,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(value) {
   return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t")}"`;
@@ -178525,7 +178654,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 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";
@@ -178569,7 +178698,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) {
@@ -190146,7 +190275,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";
@@ -190301,7 +190430,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;
@@ -198190,7 +198319,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 existsSync55, readFileSync as readFileSync17, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join69 } from "node:path";
 import { promisify as promisify35 } from "node:util";
@@ -198217,7 +198346,7 @@ function computeLockfileHash(rootDir) {
     const p2 = join69(rootDir, name2);
     if (existsSync55(p2)) {
       try {
-        return createHash26("sha256").update(readFileSync17(p2)).digest("hex");
+        return createHash27("sha256").update(readFileSync17(p2)).digest("hex");
       } catch {
         return null;
       }
@@ -200759,7 +200888,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) {
@@ -200882,7 +201011,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 "";
   }
@@ -201868,7 +201997,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 existsSync58, 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 join73, resolve as resolve43 } from "node:path";
 import { hostname as hostname2 } from "node:os";
 import { Type as Type4 } from "typebox";
@@ -202116,7 +202245,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 "";
   }
@@ -224539,7 +224668,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
@@ -224558,6 +224687,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);
@@ -240129,6 +240259,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) {
@@ -240465,6 +240627,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)) {
@@ -240503,6 +240675,7 @@ var init_create_task_done_tool = __esm({
     init_completion_predicates();
     init_task_done_refusal_handler();
     init_validate_completion_recommendations();
+    init_completion_recommendation_notice();
   }
 });
 
@@ -251829,6 +252002,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();
@@ -251887,6 +252070,7 @@ var init_plan_review_no_op = __esm({
     init_src2();
     init_logger3();
     init_lifecycle_columns();
+    init_completion_recommendation_notice();
   }
 });
 
@@ -255395,14 +255579,14 @@ ${stdout.trim()}`);
 
 // ../engine/src/missions/mission-execution-loop.ts
 import { EventEmitter as EventEmitter25 } 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(value) {
   return `'${value.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({
@@ -266941,9 +267125,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";
@@ -270521,7 +270705,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 EventEmitter26 } from "node:events";
 import { setImmediate as setImmediateCb4 } from "node:timers";
 function createDiscoveryPluginLoaderOptions(scopedStore) {
@@ -270612,11 +270796,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 sleep9 = deps.sleep ?? ((ms2) => new Promise((resolve60) => setTimeout(resolve60, 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 sleep9(RETRY_DELAYS_MS2[attempt]);
+  }
 }
 async function drainDuePlanningContinuations(deps) {
   const items = await deps.listDue();
@@ -270751,7 +270970,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",
@@ -270906,6 +271125,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;
       /**
@@ -270964,7 +271185,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;
@@ -271023,6 +271245,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) {
@@ -271514,9 +271740,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);
                 });
@@ -271804,6 +272040,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) {
@@ -279597,9 +279835,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);
@@ -308333,7 +308571,7 @@ var init_types5 = __esm({
 });
 
 // ../dashboard/src/stt/model-manager.ts
-import { createHash as createHash33, randomUUID as randomUUID57 } from "node:crypto";
+import { createHash as createHash34, randomUUID as randomUUID57 } from "node:crypto";
 import { mkdir as mkdir33, open as open4, readFile as readFile53, readdir as readdir13, rename as rename12, rm as rm20, stat as stat14, writeFile as writeFile35 } from "node:fs/promises";
 import { join as join109, relative as relative23, resolve as resolve57, sep as sep17 } from "node:path";
 function parseSafeTarListing(listing) {
@@ -308422,7 +308660,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 = createHash33("sha256");
+        const hash3 = createHash34("sha256");
         let bytes = 0;
         for await (const chunk of response.body) {
           if (!current(g2, signal)) return state;