@deksden-com/dd-flow-cli 0.9.0-beta.14 → 0.9.0-beta.141

package/dist/services/work-registry.js

@@ -1,33 +1,173 @@
+import { bindLifecyclePacketAssignments, managedLifecycleCommand, prepareWorkStartAuthority, issueLifecycleInvocation, retireWorkPacketAuthorities } from "./lifecycle-invocations.js";
+import { bindStageWork, currentStageWorkIds, stageWorkIds, stageGraphScope } from "./stage-work-graph.js";
+import { PreparedRegisteredMemoryCompositionWorkResult } from "./memory-composition-work-custody.js";
+import { prepareMemoryReviewWorkInput } from "./memory-review-work-input.js";
+import { prepareExternalMemoryRepairCopyFromStage, restoreStartedMemoryRepairCopyFromStage, prepareMemoryRepairDispatchFromStage, prepareMemorySecondRepairDispatchFromStage, prepareMemorySecondRepairLaunchFromStage, restoreStartedMemorySecondRepairLaunchFromStage } from "./memory-review-handler.js";
+import { PreparedSecondMemoryRepairLaunch } from "./memory-second-repair-launch.js";
+import { PreparedRegisteredMemoryReviewWorkResult } from "./memory-review-work-custody.js";
+import { PreparedPublishedMemoryRepairWorkResult } from "./memory-repair-work-custody.js";
+import { prepareMemoryRepairWorkCompletion, publishMemoryRepairWorkCompletion } from "./memory-repair-work-completion.js";
+import { prepareRegisteredMemoryWorkResult } from "./memory-work-result-preparation.js";
+import { hybridDigest } from "./hybrid-contracts.js";
+import { memoryRepairExecutionIdentity } from "./memory-repair-physical-binding.js";
+import { prepareMemoryNativeReviewCopy } from "./memory-native-review-copy.js";
+import { readDescriptorStageInput } from "./descriptor-stage-coordinator.js";
+import { runtimeCommand } from "./runtime-command.js";
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { AppError } from "../shared/errors.js";
-import { findRecentMatchingHookEvent, claimStageStartHookEvent, claimWorkStartHookEvent, hookSessionIdentity, workStartMatchKey } from "./hooks.js";
+import { entityReferenceVariants, shortEntityReference } from "../shared/entity-references.js";
+import { resolveWorkReference } from "../storage/work-references.js";
+import { findRecentMatchingHookEvent, claimStageLifecycleHookEvent, claimStageStartHookEvent, claimWorkLifecycleHookEvent, claimWorkStartHookEvent, hookSessionIdentity, workStartMatchKey } from "./hooks.js";
 import { validateSchema } from "./schema-validation.js";
 import { resolveProjectRoot, resolveRunReferences } from "../storage/paths.js";
+import { prepareAgentOutputFile } from "../storage/agent-output.js";
 import { refreshRunSessionProjection } from "./run-projection.js";
-import { readCodeCheckProfile, runCodeChecks, workspaceFingerprint } from "./code-checks.js";
+import { assertSourceRepairEligible, ignoredWorkspacePaths, normalizeWorkspacePath, readCodeCheckProfile, runCodeChecks, validateCheckDeclaration, validateFailedCheckRetry, workspaceFingerprint } from "./code-checks.js";
 import { nextWorkId, nextWorkIds } from "./ids.js";
-import { appendFlowRunTimelineEvent } from "./runs.js";
+import { appendFlowRunTimelineEvent, publishRunProjections, assertRunBundleSqlAuthority, assertPreparedRunBundleSqlAuthority, readFlowRunExecutionBundle } from "./runs.js";
+import { resolveStageTransition, runtimeHarness } from "./execution-policy.js";
+import { appendAudit } from "./audit.js";
 import { flowCommand } from "./stage-pause.js";
 import { assertPortableArtifactRef } from "./portable-refs.js";
 import { publicSessionIdentity } from "./session-identity.js";
+import { activateRecoveryWork, assertRecoveryHookCurrent, assertRunMutationAllowed, assertWorkSettlementAllowed, recoveryGuard, recoveryPromptForWork, settleRecoveryWork } from "./run-recovery.js";
+import { runControlDirective } from "./run-control.js";
+import { prepareError, prepareJsonFile } from "../cli/input-preparation.js";
+import { lifecycleRetryInstruction } from "../harness-runtime/lib/delegation-instructions.mjs";
+import { acceptedDecisionPrecedence, loadExternalStageContext, renderRetainedStageContext, renderRunOperationalContext, runContextRelocations } from "./stage-context.js";
+import { reviewEnvironmentAllowed, reviewExecutionCopyHash, reviewSourceHash, reviewSourcePaths } from "./review-copy.js";
+import { latestRunVerificationMatrix, verificationMatrixInstruction, verificationMatrixContract } from "./verification-matrix.js";
 const workColumns = "work_id, project_id, run_id, parent_work_id, task, launch_policy, result_schema, payload_json, depends_on_json, status, result, created_at, started_at, updated_at, completed_at";
-export function ensureWorkRegistry(context) { context.db.exec("SELECT 1 FROM works LIMIT 1"); context.db.exec("SELECT 1 FROM work_sessions LIMIT 1"); }
+export function ensureWorkRegistry(context) { context.db.get("SELECT 1 FROM works LIMIT 1"); context.db.get("SELECT 1 FROM work_sessions LIMIT 1"); }
+function ownsPhysicalWorkSession(context, projectId, owner, identity) {
+    if (identity.sessionId !== owner.session_id)
+        return false;
+    const binding = owner.hook_event_id ? context.db.get("SELECT daemon_id FROM hook_events WHERE project_id = ? AND event_key = ?", [projectId, owner.hook_event_id]) : undefined;
+    // Legacy non-daemon sessions remain usable. Once a physical daemon was
+    // captured, another process cannot inherit authority merely by resuming
+    // the same provider Session ID.
+    return !binding?.daemon_id || binding.daemon_id === identity.daemonId;
+}
+/**
+ * A Stage terminal command is allowed only from the Session that owns its
+ * running coordinator Work.  A hook receipt proves the caller; a WorkSession
+ * proves the owner.  Either fact alone is insufficient.
+ */
+export function assertStageLifecycleOwner(context, input) {
+    ensureWorkRegistry(context);
+    const projectRoot = resolveProjectRoot(input.projectRoot);
+    const project = context.db.get("SELECT id FROM projects WHERE root = ?", [projectRoot]);
+    if (!project)
+        throw new AppError("not_found", "Project is not registered", 1, { project_root: projectRoot });
+    requireRun(context, project.id, input.runId);
+    const runIndex = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [project.id, input.runId]).index_json);
+    const boundScope = assertRunBundleSqlAuthority(context, { projectId: project.id, runId: input.runId }, runIndex.execution_bundle)
+        ? stageGraphScope(context, project.id, input.runId, input.stage) : null;
+    if (boundScope && (runIndex.current_stage !== input.stage || !runIndex.stage_runs.some(stage => stage.stage === input.stage))) {
+        throw new AppError("trusted_session_binding_required", "Stage lifecycle command does not belong to the current frozen stage", 1, { run_id: input.runId, stage: input.stage, reason: "inactive_stage" });
+    }
+    const boundOwnerClause = boundScope ? `AND s.run_id = ? AND s.current_stage = ?
+    AND EXISTS (SELECT 1 FROM stage_work_memberships m WHERE m.project_id = w.project_id AND m.run_id = w.run_id
+      AND m.work_id = w.work_id AND m.stage = ? AND m.attempt = ? AND m.cycle = ?)` : "";
+    const scopedWork = input.workId ? requireWork(context, input.workId, { projectId: project.id, runId: input.runId }) : undefined;
+    let owner = context.db.get(`SELECT ws.id, ws.work_id, ws.session_id, ws.hook_event_id
+       FROM work_sessions ws
+       JOIN works w ON w.work_id = ws.work_id
+       JOIN sessions s ON s.project_id = w.project_id AND s.session_id = ws.session_id
+      WHERE w.project_id = ? AND w.run_id = ? AND ws.status = 'running'
+        AND w.status IN ('running', 'paused') AND (w.parent_work_id IS NULL OR s.current_stage = ?)
+        ${boundOwnerClause}
+        ${scopedWork ? "AND w.work_id = ?" : ""}
+      ORDER BY ws.created_at DESC LIMIT 1`, [project.id, input.runId, input.stage, ...(boundScope ? [input.runId, input.stage, input.stage, boundScope.attempt, boundScope.cycle] : []), ...(scopedWork ? [scopedWork.work_id] : [])]);
+    if (!owner && input.operation === "stage_finish" && ["code", "code-review"].includes(input.stage)) {
+        const row = context.db.get("SELECT run_root, index_json FROM runs WHERE project_id = ? AND id = ?", [project.id, input.runId]);
+        const index = row ? JSON.parse(row.index_json) : null;
+        const completed = index?.stage_runs.find(entry => entry.stage === input.stage && entry.status === "done");
+        if (row && completed && (index?.current_stage ?? index?.stage_runs.at(-1)?.stage) === input.stage)
+            owner = context.db.get("SELECT ws.id, ws.work_id, ws.session_id, ws.hook_event_id FROM work_sessions ws JOIN works w ON w.work_id = ws.work_id WHERE w.project_id = ? AND w.run_id = ? AND w.parent_work_id IS NULL AND w.status = 'completed' AND ws.status = 'completed' AND ws.result_path = ? ORDER BY ws.created_at DESC LIMIT 1", [project.id, input.runId, path.join(row.run_root, completed.dir, "stage-report.json")]);
+    }
+    if (!owner && input.operation === "stage_finish" && input.stage === "protocolize") {
+        const row = context.db.get("SELECT run_root, index_json FROM runs WHERE project_id = ? AND id = ?", [project.id, input.runId]);
+        const index = row ? JSON.parse(row.index_json) : null;
+        const completed = index?.stage_runs.find(entry => entry.stage === input.stage && entry.status === "done");
+        const root = row && completed ? path.join(row.run_root, completed.dir) : null;
+        const accepted = root && completed?.attempt && context.db.get("SELECT 1 FROM audit_events WHERE project_id = ? AND event_type = 'flow_run.stage_report' AND json_extract(payload_json, '$.run_id') = ? AND json_extract(payload_json, '$.stage') = ? AND json_extract(payload_json, '$.attempt') = ? AND json_extract(payload_json, '$.root') = ? LIMIT 1", [project.id, input.runId, input.stage, completed.attempt, root]);
+        if (accepted && completed?.data) {
+            owner = context.db.get(`SELECT ws.id, ws.work_id, ws.session_id, ws.hook_event_id FROM work_sessions ws
+           JOIN works w ON w.work_id = ws.work_id
+          WHERE w.project_id = ? AND w.run_id = ?
+            AND w.parent_work_id IS NULL AND ws.status = 'completed'
+            AND ws.result_path = ? ${scopedWork ? "AND w.work_id = ?" : ""}
+          ORDER BY ws.created_at DESC LIMIT 1`, scopedWork
+                ? [project.id, input.runId, path.join(root, completed.data), scopedWork.work_id]
+                : [project.id, input.runId, path.join(root, completed.data)]);
+        }
+    }
+    // Completed-stage replay branches above retain their historical receipts, but
+    // cannot borrow a Session or coordinator that has moved to another bound scope.
+    if (owner && boundScope && (!context.db.get("SELECT 1 FROM sessions WHERE project_id = ? AND session_id = ? AND run_id = ? AND current_stage = ?", [project.id, owner.session_id, input.runId, input.stage])
+        || !context.db.get("SELECT 1 FROM stage_work_memberships WHERE project_id = ? AND run_id = ? AND work_id = ? AND stage = ? AND attempt = ? AND cycle = ?", [project.id, input.runId, owner.work_id, input.stage, boundScope.attempt, boundScope.cycle])))
+        owner = undefined;
+    if (!owner)
+        throw new AppError("trusted_session_binding_required", "Stage lifecycle command has no running coordinator Work/Session binding", 1, { run_id: input.runId, stage: input.stage, ...(input.workId ? { work_id: input.workId } : {}) });
+    const identity = claimStageLifecycleHookEvent(context, {
+        projectId: project.id, ...(input.hookEventId ? { eventKey: input.hookEventId } : {}), operation: input.operation,
+        runId: input.runId, stage: input.stage, projectRoot, ...(input.operation === "stage_pause" ? { workId: owner.work_id } : {})
+    });
+    if (ownsPhysicalWorkSession(context, project.id, owner, identity))
+        return identity;
+    context.db.run("UPDATE hook_events SET status = 'rejected', claimed_at = ? WHERE id = ?", [context.now(), identity.hookEventId]);
+    const payload = { run_id: input.runId, stage: input.stage, work_id: owner.work_id, operation: input.operation, expected_session_id: owner.session_id, observed_session_id: identity.sessionId, hook_event_id: identity.hookEventId };
+    appendFlowRunTimelineEvent(context, project.id, input.runId, { type: "lifecycle_caller_mismatch", ...payload });
+    appendAudit(context, { projectId: project.id, eventType: "stage.lifecycle_caller_rejected", payload });
+    throw new AppError("lifecycle_caller_mismatch", "Stage lifecycle command was issued by a Session that does not own the running Work", 1, payload);
+}
+/** A Work terminal command belongs to the Session that started that Work.
+ * Controllers can still use their explicit non-agent operations; they cannot
+ * borrow a native worker's authority by naming its Work id. */
+export function assertWorkLifecycleOwner(context, input) {
+    ensureWorkRegistry(context);
+    const work = requireWork(context, input.workId);
+    const run = requireRun(context, work.project_id, work.run_id);
+    if (resolveProjectRoot(input.projectRoot) !== resolveProjectRoot(run.project_root))
+        throw new AppError("project_mismatch", "Work lifecycle project root does not match its RUN", 1, { work_id: work.work_id });
+    const owner = context.db.get("SELECT id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, completed_at FROM work_sessions WHERE work_id = ? AND status = 'running' ORDER BY created_at DESC LIMIT 1", [work.work_id]);
+    if (!owner)
+        throw new AppError("trusted_session_binding_required", "Work lifecycle command has no running Work/Session binding", 1, { work_id: work.work_id });
+    const identity = claimWorkLifecycleHookEvent(context, { projectId: work.project_id, ...(input.hookEventId ? { eventKey: input.hookEventId } : {}), operation: input.operation, workId: work.work_id, projectRoot: run.project_root });
+    if (ownsPhysicalWorkSession(context, work.project_id, owner, identity))
+        return identity;
+    context.db.run("UPDATE hook_events SET status = 'rejected', claimed_at = ? WHERE id = ?", [context.now(), identity.hookEventId]);
+    const payload = { run_id: work.run_id, work_id: work.work_id, operation: input.operation, expected_session_id: owner.session_id, observed_session_id: identity.sessionId, hook_event_id: identity.hookEventId };
+    appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_lifecycle_caller_mismatch", ...payload });
+    appendAudit(context, { projectId: work.project_id, eventType: "work.lifecycle_caller_rejected", payload });
+    throw new AppError("lifecycle_caller_mismatch", "Work lifecycle command was issued by a Session that does not own the running Work", 1, payload);
+}
 export function createChildWork(context, input) {
-    const parent = requireWork(context, input.parentWorkId);
-    if (parent.status !== "running")
-        throw new AppError("invalid_work_state", "Child Work requires a running parent", 2, { parent_work_id: parent.work_id, status: parent.status });
-    const id = nextWorkId(context, parent.project_id, input.slug);
-    const now = context.now();
-    context.db.run(`INSERT INTO works (${workColumns}) VALUES (?, ?, ?, ?, ?, ?, ?, ?, '[]', 'created', NULL, ?, NULL, ?, NULL)`, [id, parent.project_id, parent.run_id, parent.work_id, input.task, input.launchPolicy, input.resultSchema ?? null, input.payload ? JSON.stringify(input.payload) : null, now, now]);
-    refreshRunWorkProjection(context, parent.project_id, parent.run_id);
-    return requireWork(context, id);
+    return context.db.writeTransaction(() => {
+        const parent = requireWork(context, input.parentWorkId);
+        assertRunMutationAllowed(context, parent.project_id, parent.run_id);
+        if (parent.status !== "running")
+            throw new AppError("invalid_work_state", "Child Work requires a running parent", 2, { parent_work_id: parent.work_id, status: parent.status });
+        const id = nextWorkId(context, parent.project_id, input.slug);
+        const now = context.now();
+        context.db.run(`INSERT INTO works (${workColumns}) VALUES (?, ?, ?, ?, ?, ?, ?, ?, '[]', 'created', NULL, ?, NULL, ?, NULL)`, [id, parent.project_id, parent.run_id, parent.work_id, input.task, input.launchPolicy, input.resultSchema ?? null, input.payload ? JSON.stringify(input.payload) : null, now, now]);
+        if (input.stage)
+            bindStageWork(context, { projectId: parent.project_id, runId: parent.run_id, workId: id, stage: input.stage });
+        refreshRunWorkProjection(context, parent.project_id, parent.run_id);
+        return requireWork(context, id);
+    });
 }
 /** Validate a proposed batch before PLAN accepts it, without registering Work. */
 export function validateWorkBatchFile(file) {
-    const parsed = readJson(file);
-    if (!Array.isArray(parsed.works) || parsed.works.length === 0)
+    validateWorkBatch(prepareJsonFile(file, "work batch").value);
+}
+/** Validate an already prepared batch without reopening its source file. */
+export function validateWorkBatch(value) {
+    const parsed = value;
+    if (!parsed || !Array.isArray(parsed.works) || parsed.works.length === 0)
         throw new AppError("validation", "work batch requires non-empty works", 2);
     const items = parsed.works.map((item) => validateItem(item, true));
     const keys = new Set(items.map((item) => item.key));
@@ -43,18 +183,30 @@ export function validateWorkBatchFile(file) {
     assertNoCycles(items.map((item) => ({ id: item.key, dependencies: item.depends_on ?? [] })));
     assertNoParentCycles(items.filter((item) => Boolean(item.parent)).map((item) => ({ id: item.key, parent: item.parent })));
 }
-export function addWorkBatch(context, input) {
-    ensureWorkRegistry(context);
-    const parent = requireWork(context, input.parentWorkId);
-    if (parent.status !== "running")
-        throw new AppError("invalid_work_state", "Batch parent must be running", 2, { work_id: parent.work_id, status: parent.status });
-    const parsed = readJson(input.file);
-    if (!Array.isArray(parsed.works) || parsed.works.length === 0)
+export function prepareWorkBatch(context, input) {
+    validateBatchRequest(input);
+    if (input.file !== undefined && input.value !== undefined)
+        throw new AppError("usage", "Work batch accepts either file or value, not both", 2);
+    if (input.file === undefined && input.value === undefined)
+        throw new AppError("usage", "Work batch input is required", 2);
+    const parsed = (input.file !== undefined ? prepareJsonFile(input.file, "work batch").value : input.value);
+    if (!parsed || !Array.isArray(parsed.works) || parsed.works.length === 0)
         throw new AppError("validation", "work batch requires non-empty works", 2);
     const items = parsed.works.map((item) => validateItem(item));
     const keys = new Set(items.map((item) => item.key));
     if (keys.size !== items.length)
         throw new AppError("validation", "work batch keys must be unique", 2);
+    assertNoCycles(items.map(item => ({ id: item.key, dependencies: item.depends_on ?? [] })));
+    assertNoParentCycles(items.filter((item) => Boolean(item.parent)).map(item => ({ id: item.key, parent: item.parent })));
+    prepareBatchParent(context, input.parentWorkId, items);
+    return items;
+}
+function prepareBatchParent(context, parentWorkId, items) {
+    const keys = new Set(items.map(item => item.key));
+    const parent = requireWork(context, parentWorkId);
+    assertRunMutationAllowed(context, parent.project_id, parent.run_id);
+    if (parent.status !== "running")
+        throw new AppError("invalid_work_state", "Batch parent must be running", 2, { work_id: parent.work_id, status: parent.status });
     const existing = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ?`, [parent.project_id, parent.run_id]);
     const existingIds = new Set(existing.map((row) => row.work_id));
     for (const item of items)
@@ -64,9 +216,24 @@ export function addWorkBatch(context, input) {
     for (const item of items)
         if (item.parent && !keys.has(item.parent) && !existingIds.has(item.parent))
             throw new AppError("validation", "work parent is unknown", 2, { key: item.key, parent: item.parent });
-    const now = context.now();
-    context.db.exec("BEGIN IMMEDIATE");
-    try {
+    return parent;
+}
+export function addWorkBatch(context, input) {
+    validateBatchRequest(input);
+    const items = input.prepared ?? prepareWorkBatch(context, input);
+    return context.db.writeTransaction(() => {
+        // Only mutable authority/references are rechecked under the write lock.
+        // Caller bytes were read once, before admission, and are never reopened.
+        const parent = prepareBatchParent(context, input.parentWorkId, items);
+        const registration = input.requestKey ? batchRegistration(context, input, parent, items) : null;
+        if (registration?.prior) {
+            // The SQL commit may have succeeded while its prior projection failed.
+            // An unchanged index must still republish derived files on owned replay.
+            context.db.afterCommit(() => publishRunProjections(context, parent.project_id, parent.run_id));
+            scheduleObsoleteWorkProjectionCleanup(context, parent.project_id, parent.run_id);
+            return { ok: true, work_ids: registration.prior, replayed: true };
+        }
+        const now = context.now();
         const allocated = nextWorkIds(context, parent.project_id, items.map((item) => item.key));
         const ids = new Map(items.map((item, index) => [item.key, allocated[index]]));
         const resolve = (value) => ids.get(value) ?? value;
@@ -75,17 +242,126 @@ export function addWorkBatch(context, input) {
         assertNoParentCycles(proposed.map((item) => ({ id: item.id, parent: item.parentId })));
         for (const item of proposed)
             context.db.run(`INSERT INTO works (work_id, project_id, run_id, parent_work_id, task, launch_policy, result_schema, payload_json, depends_on_json, status, result, started_at, created_at, updated_at, completed_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'created', NULL, NULL, ?, ?, NULL)`, [item.id, parent.project_id, parent.run_id, item.parentId, item.task, item.launch_policy ?? "reuse_allowed", item.result_schema ?? null, item.payload ? JSON.stringify(item.payload) : null, JSON.stringify(item.dependencies), now, now]);
-        context.db.exec("COMMIT");
-        for (const item of proposed)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'created', NULL, NULL, ?, ?, NULL)`, [item.id, parent.project_id, parent.run_id, item.parentId, item.task, item.launch_policy ?? "reuse_allowed", item.result_schema ?? null,
+                registration ? JSON.stringify({ ...item.payload, _dd_flow_batch_request: { request_sha256: registration.requestSha256, batch_sha256: registration.batchSha256, item_key: item.key } })
+                    : item.payload ? JSON.stringify(item.payload) : null, JSON.stringify(item.dependencies), now, now]);
+        const run = context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [parent.project_id, parent.run_id]);
+        const stages = run ? (JSON.parse(run.index_json).stage_runs ?? []) : [];
+        const ownerStage = input.stage ?? [...stages].reverse().find(stage => stage.status === "running")?.stage;
+        for (const item of proposed) {
+            if (ownerStage)
+                bindStageWork(context, { projectId: parent.project_id, runId: parent.run_id, workId: item.id, stage: ownerStage, ...(input.cycle ? { cycle: input.cycle } : {}) });
             appendFlowRunTimelineEvent(context, parent.project_id, parent.run_id, { type: "work_materialized", work_id: item.id, parent_work_id: item.parentId, depends_on: item.dependencies, launch_policy: item.launch_policy ?? "reuse_allowed" });
+        }
         refreshRunWorkProjection(context, parent.project_id, parent.run_id);
-        return { ok: true, work_ids: Object.fromEntries(ids) };
+        const workIds = Object.fromEntries(ids);
+        if (registration)
+            appendAudit(context, { projectId: parent.project_id, eventType: "work.batch_registration", payload: {
+                    run_id: parent.run_id, scope: registration.scope, request_sha256: registration.requestSha256, batch_sha256: registration.batchSha256, work_ids: workIds,
+                    work_sha256: Object.fromEntries(proposed.map(item => [item.id, immutableBatchWorkDigest(requireWork(context, item.id))]))
+                } });
+        return { ok: true, work_ids: workIds, ...(registration ? { replayed: false } : {}) };
+    });
+}
+function immutableBatchWorkDigest(work) {
+    return hybridDigest({ work_id: work.work_id, project_id: work.project_id, run_id: work.run_id,
+        parent_work_id: work.parent_work_id, task: work.task, launch_policy: work.launch_policy,
+        result_schema: work.result_schema, payload: work.payload_json === null ? null : JSON.parse(work.payload_json),
+        depends_on: JSON.parse(work.depends_on_json) });
+}
+/** Independent allocation custody only: this does not attest Session settlement,
+ * semantic acceptance, or that the retained stage is still active. Historical
+ * receipts without immutable hashes remain replayable but cannot grant custody.
+ */
+export function readWorkBatchCustody(context, id) {
+    const work = requireWork(context, id);
+    try {
+        const marker = JSON.parse(work.payload_json ?? "null")?._dd_flow_batch_request;
+        if (!marker || typeof marker.request_sha256 !== "string" || typeof marker.batch_sha256 !== "string" || typeof marker.item_key !== "string")
+            throw new Error("Missing ownership marker");
+        const rows = context.db.all("SELECT payload_json FROM audit_events WHERE project_id = ? AND event_type = 'work.batch_registration' AND json_extract(payload_json, '$.request_sha256') = ?", [work.project_id, marker.request_sha256]);
+        if (rows.length !== 1 || Buffer.byteLength(rows[0].payload_json) > 1024 * 1024)
+            throw new Error("Missing or ambiguous receipt");
+        const receipt = JSON.parse(rows[0].payload_json);
+        const scope = receipt.scope;
+        if (!scope || scope.project_id !== work.project_id || scope.run_id !== work.run_id || receipt.run_id !== work.run_id
+            || typeof scope.stage !== "string" || typeof scope.attempt !== "string" || typeof scope.cycle !== "string"
+            || typeof scope.parent_work_id !== "string" || typeof scope.request_key !== "string"
+            || receipt.request_sha256 !== marker.request_sha256 || hybridDigest(scope) !== marker.request_sha256
+            || receipt.batch_sha256 !== marker.batch_sha256
+            || !Object.hasOwn(receipt.work_ids ?? {}, marker.item_key) || receipt.work_ids[marker.item_key] !== work.work_id
+            || !Object.hasOwn(receipt.work_sha256 ?? {}, work.work_id) || receipt.work_sha256[work.work_id] !== immutableBatchWorkDigest(work)
+            || !context.db.get("SELECT 1 FROM works WHERE project_id = ? AND run_id = ? AND work_id = ?", [work.project_id, work.run_id, scope.parent_work_id])
+            || !context.db.get("SELECT 1 FROM works WHERE project_id = ? AND run_id = ? AND work_id = ?", [work.project_id, work.run_id, work.parent_work_id])
+            || !context.db.get("SELECT 1 FROM stage_work_memberships WHERE project_id = ? AND run_id = ? AND work_id = ? AND stage = ? AND attempt = ? AND cycle = ?", [work.project_id, work.run_id, work.work_id, scope.stage, scope.attempt, scope.cycle]))
+            throw new Error("Changed allocation binding");
+        return { work_id: work.work_id, item_key: marker.item_key, scope: { ...scope },
+            work_ids: { ...receipt.work_ids },
+            request_sha256: marker.request_sha256, batch_sha256: marker.batch_sha256,
+            work_sha256: receipt.work_sha256[work.work_id] };
     }
-    catch (error) {
-        context.db.exec("ROLLBACK");
-        throw error;
+    catch {
+        throw new AppError("work_batch_custody_invalid", "Independent batch receipt cannot attest this Work allocation", 1, { work_id: work.work_id });
+    }
+}
+function validateBatchRequest(input) {
+    if (input.requestKey === undefined)
+        return;
+    if (typeof input.requestKey !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_.-]{0,95}$/.test(input.requestKey)
+        || typeof input.stage !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/.test(input.stage))
+        throw new AppError("work_batch_request_invalid", "Replayable batch requires a bounded request key and explicit stage", 2);
+}
+/** Optional request-owned registration for generic flows. Receipt and Work allocation
+ * commit in one writer transaction; mutable Work state may advance on replay, but
+ * immutable task/dependency/scope bytes may not be replaced or rediscovered.
+ */
+function batchRegistration(context, input, parent, items) {
+    const scope = stageGraphScope(context, parent.project_id, parent.run_id, input.stage);
+    const run = context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [parent.project_id, parent.run_id]);
+    const index = run ? JSON.parse(run.index_json) : null;
+    if (!index || index.current_stage !== input.stage || !index.stage_runs.some(stage => stage.stage === input.stage && stage.status === "running")
+        || input.cycle !== undefined && input.cycle !== scope.cycle
+        || index.execution_bundle && !stageWorkIds(context, parent.project_id, parent.run_id, input.stage).has(parent.work_id)) {
+        throw new AppError("work_batch_scope_invalid", "Batch registration does not belong to the active coordinator stage", 1);
+    }
+    if (items.some(item => item.payload && Object.hasOwn(item.payload, "_dd_flow_batch_request")))
+        throw new AppError("work_batch_request_invalid", "Batch ownership marker is CLI-owned", 2);
+    const requestScope = { ...scope, stage: input.stage, parent_work_id: parent.work_id, request_key: input.requestKey };
+    const requestSha256 = hybridDigest(requestScope);
+    const batchSha256 = hybridDigest(items);
+    const rows = context.db.all("SELECT payload_json FROM audit_events WHERE project_id = ? AND event_type = 'work.batch_registration' AND json_extract(payload_json, '$.request_sha256') = ?", [parent.project_id, requestSha256]);
+    const owned = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? AND json_extract(payload_json, '$._dd_flow_batch_request.request_sha256') = ?`, [parent.project_id, parent.run_id, requestSha256]);
+    const invalid = (code) => { throw new AppError(code, "Retained batch registration cannot authorize allocation or replay", 1); };
+    if (!rows.length) {
+        if (owned.length)
+            invalid("work_batch_receipt_missing");
+        return { requestSha256, batchSha256, scope: requestScope, prior: null };
     }
+    if (rows.length !== 1 || Buffer.byteLength(rows[0].payload_json, "utf8") > 1024 * 1024)
+        invalid("work_batch_receipt_invalid");
+    const receipt = JSON.parse(rows[0].payload_json);
+    if (receipt.run_id !== parent.run_id || hybridDigest(receipt.scope) !== requestSha256)
+        invalid("work_batch_receipt_invalid");
+    if (receipt.batch_sha256 !== batchSha256)
+        invalid("work_batch_request_conflict");
+    const ids = receipt.work_ids;
+    if (!ids || typeof ids !== "object" || Array.isArray(ids) || Object.keys(ids).length !== items.length
+        || new Set(Object.values(ids)).size !== items.length || owned.length !== items.length)
+        invalid("work_batch_receipt_invalid");
+    const resolve = (key) => Object.hasOwn(ids, key) ? ids[key] : key;
+    for (const item of items) {
+        if (!Object.hasOwn(ids, item.key))
+            invalid("work_batch_receipt_invalid");
+        const work = owned.find(row => row.work_id === ids[item.key]);
+        if (!work || work.parent_work_id !== (item.parent ? resolve(item.parent) : parent.work_id) || work.task !== item.task
+            || work.launch_policy !== (item.launch_policy ?? "reuse_allowed") || work.result_schema !== (item.result_schema ?? null)
+            || hybridDigest(JSON.parse(work.depends_on_json)) !== hybridDigest((item.depends_on ?? []).map(resolve))
+            || hybridDigest(JSON.parse(work.payload_json)) !== hybridDigest({ ...item.payload, _dd_flow_batch_request: { request_sha256: requestSha256, batch_sha256: batchSha256, item_key: item.key } })
+            || receipt.work_sha256 !== undefined && (!Object.hasOwn(receipt.work_sha256, work.work_id) || receipt.work_sha256[work.work_id] !== immutableBatchWorkDigest(work))
+            || !context.db.get("SELECT 1 FROM stage_work_memberships WHERE project_id = ? AND run_id = ? AND work_id = ? AND stage = ? AND attempt = ? AND cycle = ?", [parent.project_id, parent.run_id, work.work_id, input.stage, scope.attempt, scope.cycle]))
+            invalid("work_batch_receipt_invalid");
+    }
+    return { requestSha256, batchSha256, scope: requestScope, prior: ids };
 }
 export function listWorks(context, input) {
     ensureWorkRegistry(context);
@@ -105,19 +381,182 @@ export function listWorks(context, input) {
         where.push("status = ?");
         params.push(input.status);
     }
-    const rows = context.db.all(`SELECT ${workColumns} FROM works WHERE ${where.join(" AND ")} ORDER BY created_at, work_id`, params);
-    const ready = (work) => isReady(context, work);
+    const rows = context.db.all(`SELECT ${workColumns} FROM works WHERE ${where.join(" AND ")} ORDER BY created_at, work_id`, params).filter(work => !input.workIds || input.workIds.has(work.work_id));
+    const ready = (work) => (input.workIds || currentStageWorkIds(context, work.project_id, work.run_id))?.has(work.work_id) !== false && isReady(context, work);
     const filtered = input.ready ? rows.filter(ready) : rows;
     return { works: filtered.slice(0, input.limit ?? filtered.length).map((work) => {
             const isReadyNow = ready(work);
-            return { ...work, payload: parsePayload(work), payload_json: undefined, depends_on: parseDependencies(work), ready: isReadyNow, ...(isReadyNow ? { start_command: workStartCommand(context, work) } : {}), ...(input.includeResults ? {} : { result: undefined }) };
+            return { ...work, payload: parsePayload(work), payload_json: undefined, depends_on: parseDependencies(work), ready: isReadyNow, ...(isReadyNow ? { start_command: workStartCommand(context, work, { preview: true }) } : {}), ...(input.includeResults ? {} : { result: undefined }) };
         }) };
 }
 export function showWork(context, id) { const work = requireWork(context, id); const sessions = context.db.all("SELECT ws.id, ws.work_id, ws.session_id, ws.hook_event_id, ws.status, ws.prompt_path, ws.result_path, ws.created_at, ws.completed_at, s.harness AS harness_id, COALESCE(s.provider_session_id, s.session_id) AS native_session_id FROM work_sessions ws LEFT JOIN sessions s ON s.project_id = ? AND s.session_id = ws.session_id WHERE ws.work_id = ? ORDER BY ws.created_at", [work.project_id, work.work_id]); return { work: { ...work, short_id: shortWorkId(work.work_id), payload: parsePayload(work), payload_json: undefined, depends_on: parseDependencies(work), sessions: sessions.map(({ session_id, harness_id, native_session_id, ...session }) => ({ ...session, ...(harness_id && native_session_id ? { session: publicSessionIdentity({ harness: harness_id, provider_session_id: native_session_id, session_id }) } : {}) })) } }; }
+function receiptIntentPath(resultPath, sessionId) {
+    return `${resultPath}.pending-${crypto.createHash("sha256").update(sessionId).digest("hex")}`;
+}
+function receiptFileHash(file) {
+    return fs.existsSync(file) ? crypto.createHash("sha256").update(fs.readFileSync(file)).digest("hex") : null;
+}
+function sha256(contents) { return crypto.createHash("sha256").update(contents).digest("hex"); }
+function publishReceiptFile(file, contents) {
+    const temporary = `${file}.tmp-${crypto.randomUUID()}`;
+    try {
+        fs.writeFileSync(temporary, contents);
+        const descriptor = fs.openSync(temporary, "r");
+        try {
+            fs.fsyncSync(descriptor);
+        }
+        finally {
+            fs.closeSync(descriptor);
+        }
+        fs.renameSync(temporary, file);
+        const directory = fs.openSync(path.dirname(file), "r");
+        try {
+            fs.fsyncSync(directory);
+        }
+        finally {
+            fs.closeSync(directory);
+        }
+    }
+    finally {
+        fs.rmSync(temporary, { force: true });
+    }
+}
+/** Rebuild prompt/context projections from a committed Work-start receipt. */
+export function materializePendingWorkStarts(context, projectId, runId) {
+    const runHome = requireRunHome(requireRun(context, projectId, runId));
+    const rows = context.db.all("SELECT ws.id, ws.work_id, ws.prompt_path, ws.start_receipt_json, ws.start_publication_status FROM work_sessions ws JOIN works w ON w.work_id = ws.work_id WHERE w.project_id = ? AND w.run_id = ? AND ws.status = 'running' AND ws.start_receipt_json IS NOT NULL AND (ws.start_publication_status IS NULL OR ws.start_publication_status != 'published')", [projectId, runId]);
+    for (const row of rows) {
+        // The same coordinator Session can move on to a different stage packet.
+        // A start receipt is not authority to overwrite that later packet.
+        let receipt;
+        try {
+            receipt = JSON.parse(row.start_receipt_json);
+        }
+        catch {
+            throw new AppError("work_start_receipt_invalid", "Committed Work start receipt is not valid JSON", 1, { work_id: row.work_id });
+        }
+        const originalPromptPath = path.join(runHome, "works", row.work_id, ...(receipt.version === 2 || receipt.generation && receipt.generation > 0 ? ["starts", row.id] : []), "prompt.md");
+        if (path.resolve(row.prompt_path) !== path.resolve(originalPromptPath))
+            continue;
+        if (![1, 2].includes(Number(receipt.version)) || typeof receipt.prompt !== "string" || typeof receipt.context !== "string" || receipt.prompt_sha256 !== sha256(receipt.prompt) || receipt.context_sha256 !== sha256(receipt.context))
+            throw new AppError("work_start_receipt_invalid", "Committed Work start receipt does not match its retained bytes", 1, { work_id: row.work_id });
+        if (row.start_publication_status && context.db.writeTransaction(() => context.db.run("UPDATE work_sessions SET start_publication_status = 'publishing' WHERE id = ? AND status = 'running' AND prompt_path = ? AND start_receipt_json = ? AND start_publication_status IN ('pending','publishing')", [row.id, row.prompt_path, row.start_receipt_json]).changes) !== 1)
+            continue;
+        prepareAgentOutputFile(path.join(runHome, "works", row.work_id, "result-input.json"));
+        publishStartReceiptFile(row.prompt_path, receipt.prompt, String(receipt.prompt_sha256));
+        publishStartReceiptFile(path.join(path.dirname(row.prompt_path), "context.json"), receipt.context, String(receipt.context_sha256));
+        if (row.start_publication_status && context.db.writeTransaction(() => context.db.run("UPDATE work_sessions SET start_publication_status = 'published' WHERE id = ? AND status = 'running' AND prompt_path = ? AND start_receipt_json = ? AND start_publication_status = 'publishing'", [row.id, row.prompt_path, row.start_receipt_json]).changes) !== 1) {
+            const current = context.db.get("SELECT status, prompt_path, start_receipt_json, start_publication_status FROM work_sessions WHERE id = ?", [row.id]);
+            if (current?.status === "running" && current.prompt_path === row.prompt_path && current.start_receipt_json === row.start_receipt_json
+                && current.start_publication_status === "published" && receiptFileHash(row.prompt_path) === receipt.prompt_sha256
+                && receiptFileHash(path.join(path.dirname(row.prompt_path), "context.json")) === receipt.context_sha256)
+                continue;
+            throw new AppError("work_start_projection_conflict", "Work start binding changed during packet publication", 1, { work_id: row.work_id });
+        }
+    }
+}
+function publishStartReceiptFile(file, contents, expectedHash) {
+    const actual = receiptFileHash(file);
+    if (actual === expectedHash)
+        return;
+    if (actual !== null) {
+        throw new AppError("work_start_projection_conflict", "Work start packet differs from its committed receipt; preserve it for recovery", 1, { path: file, expected_sha256: expectedHash, actual_sha256: actual });
+    }
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const temporary = `${file}.tmp-${crypto.randomUUID()}`;
+    try {
+        fs.writeFileSync(temporary, contents, { flag: "wx" });
+        const descriptor = fs.openSync(temporary, "r");
+        try {
+            fs.fsyncSync(descriptor);
+        }
+        finally {
+            fs.closeSync(descriptor);
+        }
+        try {
+            fs.linkSync(temporary, file);
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            if (receiptFileHash(file) !== expectedHash) {
+                throw new AppError("work_start_projection_conflict", "Concurrent Work start publication differs from its committed receipt", 1, { path: file, expected_sha256: expectedHash, actual_sha256: receiptFileHash(file) });
+            }
+        }
+        const directory = fs.openSync(path.dirname(file), "r");
+        try {
+            fs.fsyncSync(directory);
+        }
+        finally {
+            fs.closeSync(directory);
+        }
+    }
+    finally {
+        fs.rmSync(temporary, { force: true });
+    }
+}
+/** Replay only a prepared publication whose exact receipt was committed in SQLite. */
+export function materializePendingWorkResults(context, projectId, runId, workId) {
+    const rows = context.db.all(`SELECT w.work_id, w.result, w.status, ws.id, ws.result_path, ws.result_receipt_json FROM works w JOIN work_sessions ws ON ws.work_id = w.work_id AND ws.status = w.status WHERE w.project_id = ? AND w.run_id = ? AND w.parent_work_id IS NOT NULL AND w.result IS NOT NULL AND w.status IN ('completed', 'failed', 'cancelled') AND ws.result_path IS NOT NULL AND (? IS NULL OR w.work_id = ?)`, [projectId, runId, workId ?? null, workId ?? null]);
+    for (const row of rows) {
+        const intentPath = receiptIntentPath(row.result_path, row.id);
+        const legacyIntent = fs.existsSync(intentPath) ? fs.readFileSync(intentPath, "utf8") : null;
+        if (!row.result_receipt_json && !legacyIntent)
+            continue;
+        const intent = JSON.parse(row.result_receipt_json ?? legacyIntent);
+        const digest = crypto.createHash("sha256").update(row.result).digest("hex");
+        if (intent.work_id !== row.work_id || intent.work_session_id !== row.id || intent.status !== row.status || intent.result_sha256 !== digest)
+            throw new AppError("work_result_publication_conflict", "Pending result publication does not identify the committed receipt", 1, { work_id: row.work_id, intent_path: intentPath });
+        if (legacyIntent && row.result_receipt_json && legacyIntent !== row.result_receipt_json)
+            throw new AppError("work_result_publication_conflict", "File intent differs from the committed result receipt", 1, { work_id: row.work_id, intent_path: intentPath });
+        const actual = receiptFileHash(row.result_path);
+        if (actual !== digest && actual !== intent.previous_sha256)
+            throw new AppError("work_result_artifact_drift", "Result changed after its publication was prepared; preserve it for diagnosis", 1, { work_id: row.work_id, actual_sha256: actual, expected_sha256: digest });
+        if (actual !== digest && fs.existsSync(row.result_path)) {
+            const previous = fs.readFileSync(row.result_path);
+            if (!previous.equals(Buffer.from(row.result))) {
+                const retained = `${row.result_path}.conflict-${crypto.createHash("sha256").update(previous).digest("hex")}`;
+                try {
+                    fs.writeFileSync(retained, previous, { flag: "wx", flush: true });
+                }
+                catch (error) {
+                    if (error.code !== "EEXIST" || !fs.readFileSync(retained).equals(previous))
+                        throw error;
+                }
+            }
+        }
+        if (actual !== digest)
+            publishReceiptFile(row.result_path, row.result);
+        if (legacyIntent)
+            fs.unlinkSync(intentPath);
+    }
+}
 export function mutateWorkDeps(context, input) {
+    if (input.action === "list") {
+        const { work, dependencies } = prepareWorkDeps(context, input);
+        return { work_id: work.work_id, depends_on: dependencies };
+    }
+    prepareWorkDeps(context, input);
+    return context.db.writeTransaction(() => {
+        const { work, dependencies } = prepareWorkDeps(context, input);
+        context.db.run("UPDATE works SET depends_on_json = ?, updated_at = ? WHERE work_id = ?", [JSON.stringify(dependencies), context.now(), work.work_id]);
+        refreshRunWorkProjection(context, work.project_id, work.run_id);
+        return { work_id: work.work_id, depends_on: dependencies };
+    });
+}
+export function prepareWorkDeps(context, input) {
+    if (!["list", "add", "remove", "clear"].includes(input.action) || (input.on !== undefined && (!Array.isArray(input.on) || input.on.some(id => typeof id !== "string" || !id.trim()))))
+        throw new AppError("usage", "Invalid Work dependency action or --on target", 2);
+    if (["add", "remove"].includes(input.action) && !input.on?.length)
+        throw new AppError("usage", "Dependency add/remove requires at least one --on target", 2);
+    if (["list", "clear"].includes(input.action) && input.on?.length)
+        throw new AppError("usage", "Dependency list/clear does not accept --on targets", 2);
+    if (input.action === "list") {
+        const work = requireWork(context, input.workId);
+        return { work, dependencies: parseDependencies(work) };
+    }
     const work = requireWork(context, input.workId);
-    if (input.action === "list")
-        return { work_id: work.work_id, depends_on: parseDependencies(work) };
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
     if (work.status !== "created")
         throw new AppError("invalid_work_state", "Dependencies change only while Work is created", 2);
     const dependencies = new Set(parseDependencies(work));
@@ -125,8 +564,8 @@ export function mutateWorkDeps(context, input) {
         dependencies.clear();
     for (const id of input.on ?? []) {
         const dependency = requireWork(context, id);
-        if (dependency.run_id !== work.run_id)
-            throw new AppError("validation", "Dependencies must stay in one RUN", 2);
+        if (dependency.project_id !== work.project_id || dependency.run_id !== work.run_id)
+            throw new AppError("validation", "Dependencies must stay in one project and RUN", 2);
         if (input.action === "add")
             dependencies.add(dependency.work_id);
         else
@@ -135,56 +574,124 @@ export function mutateWorkDeps(context, input) {
     if (dependencies.has(work.work_id))
         throw new AppError("validation", "Work cannot depend on itself", 2);
     assertNoCycles(context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ?`, [work.project_id, work.run_id]).map((row) => ({ id: row.work_id, dependencies: row.work_id === work.work_id ? [...dependencies] : parseDependencies(row) })));
-    context.db.run("UPDATE works SET depends_on_json = ?, updated_at = ? WHERE work_id = ?", [JSON.stringify([...dependencies]), context.now(), work.work_id]);
-    refreshRunWorkProjection(context, work.project_id, work.run_id);
-    return { work_id: work.work_id, depends_on: [...dependencies] };
+    if (parsePayload(work)?._dd_flow_batch_request && hybridDigest([...dependencies]) !== hybridDigest(parseDependencies(work)))
+        throw new AppError("validation", "This Work belongs to a registered batch: use its registered graph; dependencies are declared during allocation", 2, { phase: "prepare", effect: "no_effect", recoverable: true, work_id: work.work_id, depends_on: parseDependencies(work) });
+    return { work, dependencies: [...dependencies] };
+}
+export function prepareWorkDelete(context, id) {
+    const work = requireWork(context, id);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
+    if (work.status !== "created" || work.started_at || context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? LIMIT 1", [work.work_id]) || context.db.get("SELECT 1 FROM works WHERE depends_on_json LIKE ? LIMIT 1", [`%${work.work_id}%`]))
+        throw new AppError("invalid_work_state", "Only an unstarted unreferenced Work may be deleted", 2);
+    return work;
 }
-export function deleteWork(context, id) { const work = requireWork(context, id); const canonical = work.work_id; if (work.status !== "created" || work.started_at || context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? LIMIT 1", [canonical]) || context.db.get("SELECT 1 FROM works WHERE depends_on_json LIKE ? LIMIT 1", [`%${canonical}%`]))
-    throw new AppError("invalid_work_state", "Only an unstarted unreferenced Work may be deleted", 2); context.db.run("DELETE FROM works WHERE work_id = ?", [canonical]); refreshRunWorkProjection(context, work.project_id, work.run_id); return { ok: true, deleted: canonical }; }
-export function shortWorkId(id) { return /^WRK-\d{3,}(?:-|$)/.exec(id)?.[0]?.replace(/-$/, "") ?? id; }
+export function deleteWork(context, id) {
+    prepareWorkDelete(context, id);
+    return context.db.writeTransaction(() => { const work = prepareWorkDelete(context, id); context.db.run("DELETE FROM works WHERE work_id = ?", [work.work_id]); refreshRunWorkProjection(context, work.project_id, work.run_id); return { ok: true, deleted: work.work_id }; });
+}
+export function shortWorkId(id) { return shortEntityReference(id); }
 /**
  * Return the engine-bound command, never a PATH-dependent `dd-flow` token.
  * Fan-out workers run in independently spawned harnesses where the adapter's
  * PATH is not inherited; using the shared lifecycle command keeps them on the
  * same captured runtime as their parent stage.
  */
-export function workStartCommand(context, work) { const run = requireRun(context, work.project_id, work.run_id); return `${flowCommand(context)} work start ${work.work_id} --project-root ${JSON.stringify(run.project_root)} --json`; }
-export function startWork(context, id, input) {
+function rawWorkStartCommand(context, work) {
+    const run = requireRun(context, work.project_id, work.run_id), recovery = recoveryGuard(context, work.project_id, work.run_id);
+    return runtimeCommand(context, ["work", "start", shortWorkId(work.work_id), "--project-root", run.project_root, ...(recovery ? ["--recovery-id", recovery.recovery_id] : []), "--json"]);
+}
+export function workStartCommand(context, work, options = {}) {
+    const command = rawWorkStartCommand(context, work);
+    // Graph/readiness projections do not choose the future executor's scope.
+    if (options.preview)
+        return command;
+    const retained = context.db.get("SELECT status,current_start_invocation_id FROM works WHERE work_id = ?", [work.work_id]);
+    if (retained?.current_start_invocation_id) {
+        const prepared = prepareWorkStartAuthority(context, command, retained.current_start_invocation_id);
+        return managedLifecycleCommand({ ...context, env: { ...context.env, DD_FLOW_INVOCATION_SCOPE: JSON.stringify(prepared.scope) } }, `${command} --invocation-id ${retained.current_start_invocation_id}`);
+    }
+    // Legacy terminal/running Work is historical, never a fresh dispatch.
+    if (retained?.status !== "created")
+        return managedLifecycleCommand(context, command);
+    const prepared = prepareWorkStartAuthority(context, command);
+    if (!prepared)
+        return command;
+    if (!context.db.writable || context.env.DD_FLOW_INVOCATION_READONLY === "1")
+        throw new AppError("invocation_command_unprepared", "Work start authority has not been prepared", 1);
+    const id = context.db.writeTransaction(() => {
+        assertRunMutationAllowed(context, work.project_id, work.run_id, prepared.scope.generation);
+        const current = context.db.get("SELECT status,current_start_invocation_id FROM works WHERE work_id = ?", [work.work_id]);
+        if (current?.current_start_invocation_id)
+            return current.current_start_invocation_id;
+        if (current?.status !== "created")
+            throw new AppError("work_retry_conflict", "Work changed before start issuance", 1);
+        const issued = issueLifecycleInvocation(context, prepared.command, prepared.scope);
+        context.db.run("UPDATE works SET current_start_invocation_id = ? WHERE work_id = ?", [issued.id, work.work_id]);
+        return issued.id;
+    });
+    return managedLifecycleCommand(context, `${command} --invocation-id ${id}`);
+}
+export function assertWorkLaunchReady(context, id) {
     ensureWorkRegistry(context);
     const work = requireWork(context, id);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
     if (work.status !== "created")
         throw new AppError("invalid_work_state", "Work is not created", 2, { work_id: id, status: work.status });
     if (!isReady(context, work)) {
         const blockers = readinessBlockers(context, work);
-        const ready = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? AND status = 'created' ORDER BY created_at, work_id`, [work.project_id, work.run_id]).filter((candidate) => isReady(context, candidate)).map((candidate) => ({ work_id: candidate.work_id, start_command: workStartCommand(context, candidate) }));
+        const ready = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? AND status = 'created' ORDER BY created_at, work_id`, [work.project_id, work.run_id]).filter((candidate) => currentStageWorkIds(context, candidate.project_id, candidate.run_id)?.has(candidate.work_id) !== false && isReady(context, candidate)).map((candidate) => ({ work_id: candidate.work_id, start_command: workStartCommand(context, candidate, { preview: true }) }));
         throw new AppError("work_not_ready", "Work cannot start until dependencies complete and overlapping planned coordination areas are free", 2, { work_id: id, blockers, ready });
     }
     const run = requireRun(context, work.project_id, work.run_id);
+    const wave = registeredMemoryRepairWave(context, work, run);
+    if (wave) {
+        const launched = context.db.get("SELECT 1 FROM sqlite_master WHERE type='table' AND name='work_launches'")
+            && context.db.get("SELECT 1 FROM work_launches WHERE work_id=?", [work.work_id]);
+        if (launched)
+            prepareMemoryRepairStartOwner(context, work, run, wave);
+        else
+            (wave === 1 ? prepareMemoryRepairDispatchFromStage : prepareMemorySecondRepairDispatchFromStage)(context, { projectRoot: run.project_root, runId: work.run_id, workId: work.work_id });
+    }
+    if (parsePayload(work)?.read_only === true)
+        assertSharedReviewInput(context, work, requireRun(context, work.project_id, work.run_id));
+    return work;
+}
+export function startWork(context, id, input) {
+    if (input.hookEventId && !context.env.DD_FLOW_CURRENT_INVOCATION) {
+        const retainedWork = requireWork(context, id);
+        const retainedRun = requireRun(context, retainedWork.project_id, retainedWork.run_id);
+        if (input.projectRoot && resolveProjectRoot(input.projectRoot) !== resolveProjectRoot(retainedRun.project_root))
+            throw new AppError("project_mismatch", "Work start belongs to another project", 1);
+        const reply = recoverCommittedWorkStart(context, null, input.hookEventId, recoveryGuard(context, retainedWork.project_id, retainedWork.run_id)?.generation ?? 0, retainedWork.work_id);
+        if (reply)
+            return reply;
+    }
+    const work = assertWorkLaunchReady(context, id);
+    const run = requireRun(context, work.project_id, work.run_id);
     if (input.projectRoot && resolveProjectRoot(input.projectRoot) !== resolveProjectRoot(run.project_root))
         throw new AppError("project_mismatch", "work start project root does not match its RUN", 1, { work_id: id });
-    let hookEventId = input.hookEventId;
-    if (!hookEventId) {
-        try {
-            hookEventId = findRecentMatchingHookEvent(context, { projectId: work.project_id, matchKey: workStartMatchKey(shortWorkId(work.work_id), run.project_root), errorCode: "trusted_session_binding_required", operation: "work start" }).eventKey;
-        }
-        catch {
-            hookEventId = findRecentMatchingHookEvent(context, { projectId: work.project_id, matchKey: workStartMatchKey(work.work_id, run.project_root), errorCode: "trusted_session_binding_required", operation: "work start" }).eventKey;
-        }
-    }
-    const identity = claimWorkStartHookEvent(context, { projectId: work.project_id, eventKey: hookEventId, workId: work.work_id, projectRoot: run.project_root });
-    const started = startBoundWork(context, work, run, identity, hookEventId);
-    appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_started", work_id: work.work_id, session_id: identity.sessionId, agent_id: identity.agentId });
+    const recoveryId = recoveryGuard(context, work.project_id, work.run_id)?.recovery_id;
+    if (input.recoveryId !== recoveryId)
+        throw new AppError("run_recovery_generation_stale", "Work launch must use the exact current recovery packet", 1, { work_id: id, recovery_id: recoveryId ?? null });
+    const hookEventId = input.hookEventId ?? findRecentMatchingHookEvent(context, { projectId: work.project_id, matchKey: entityReferenceVariants(work.work_id).map((reference) => workStartMatchKey(reference, run.project_root, recoveryId)), errorCode: "trusted_session_binding_required", operation: "work start" }).eventKey;
+    const eventKey = hookEventId;
+    const started = startBoundWork(context, work, run, () => claimWorkStartHookEvent(context, { projectId: work.project_id, eventKey, workId: work.work_id, projectRoot: run.project_root, ...(recoveryId ? { recoveryId } : {}) }), eventKey);
+    appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_started", work_id: work.work_id, work_session_id: started.work_session_id });
     return started;
 }
 /** Binds the already-running coordinator of a stage to its trusted hook Session. */
 export function bindRunningWorkSession(context, input) {
     const work = requireWork(context, input.workId);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
     if (work.status !== "running")
         throw new AppError("invalid_work_state", "Stage coordinator Work must be running", 1, { work_id: work.work_id, status: work.status });
     const run = requireRun(context, work.project_id, work.run_id);
     const identity = hookSessionIdentity(context, work.project_id, input.hookEventId);
+    assertRecoveryHookCurrent(context, work.project_id, work.run_id, identity);
     const active = context.db.get("SELECT id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, completed_at FROM work_sessions WHERE work_id = ? AND status = 'running' ORDER BY created_at DESC LIMIT 1", [work.work_id]);
     if (active) {
+        if (active.session_id === identity.sessionId && !ownsPhysicalWorkSession(context, work.project_id, active, identity))
+            throw new AppError("handoff_session_mismatch", "The active Work belongs to another physical daemon", 1, { work_id: work.work_id });
         if (active.session_id !== identity.sessionId) {
             // A frozen `new_session` policy may transfer the same coordinator Work
             // only to its next stage. Repeating the same stage from another Session
@@ -193,20 +700,14 @@ export function bindRunningWorkSession(context, input) {
                 throw new AppError("handoff_session_mismatch", "The active Work is already bound to a different Session", 1, { work_id: work.work_id });
             const now = context.now();
             const id = `WS-${crypto.randomUUID()}`;
-            context.db.exec("BEGIN IMMEDIATE");
-            try {
+            context.db.writeTransaction(() => {
                 context.db.run("UPDATE work_sessions SET status = 'completed', completed_at = ?, updated_at = ? WHERE id = ?", [now, now, active.id]);
                 const stillRunning = context.db.get("SELECT 1 FROM work_sessions WHERE session_id = ? AND status = 'running' LIMIT 1", [active.session_id]);
                 if (!stillRunning)
                     context.db.run("UPDATE sessions SET status = 'idle', updated_at = ? WHERE project_id = ? AND session_id = ?", [now, work.project_id, active.session_id]);
                 bindSession(context, work, run, identity, now);
                 context.db.run("INSERT INTO work_sessions (id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, updated_at, completed_at) VALUES (?, ?, ?, ?, 'running', ?, ?, ?, ?, NULL)", [id, work.work_id, identity.sessionId, input.hookEventId, input.promptPath, input.resultPath ?? null, now, now]);
-                context.db.exec("COMMIT");
-            }
-            catch (error) {
-                context.db.exec("ROLLBACK");
-                throw error;
-            }
+            });
             refreshRunWorkProjection(context, work.project_id, work.run_id);
             return { work_session_id: id, session_id: identity.sessionId, handed_off: true };
         }
@@ -215,167 +716,866 @@ export function bindRunningWorkSession(context, input) {
     }
     const now = context.now();
     const id = `WS-${crypto.randomUUID()}`;
-    context.db.exec("BEGIN IMMEDIATE");
-    try {
+    context.db.writeTransaction(() => {
         bindSession(context, work, run, identity, now);
         context.db.run("INSERT INTO work_sessions (id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, updated_at, completed_at) VALUES (?, ?, ?, ?, 'running', ?, ?, ?, ?, NULL)", [id, work.work_id, identity.sessionId, input.hookEventId, input.promptPath, input.resultPath ?? null, now, now]);
-        context.db.exec("COMMIT");
-    }
-    catch (error) {
-        context.db.exec("ROLLBACK");
-        throw error;
-    }
+    });
     refreshRunWorkProjection(context, work.project_id, work.run_id);
     return { work_session_id: id, session_id: identity.sessionId };
 }
+function preparedCoordinatorRoute(context, work, input, snapshot) {
+    const bound = assertRunBundleSqlAuthority(context, { projectId: work.project_id, runId: work.run_id }, snapshot.execution_bundle);
+    const admitted = context.stageBindingBundle;
+    if (admitted && !bound)
+        throw new AppError("run_bundle_anchor_invalid", "Prepared coordinator bundle lost its RUN anchor", 1);
+    if (bound && (!admitted || admitted.stage !== input.stage || admitted.contextSha256 !== input.contextSha256))
+        throw new AppError("frozen_stage_binding_required", "Coordinator binding requires its prepared frozen stage bundle", 1);
+    if (bound) {
+        // The request-local bundle was admitted before coordinator dispatch. The
+        // independently retained RUN authority fences it again without compiling
+        // descriptor schemas under this (possibly caller-owned) SQL writer.
+        assertPreparedRunBundleSqlAuthority(context, { projectId: work.project_id, runId: work.run_id }, admitted.bundle);
+        if (admitted.bundle.descriptor.descriptor.id === "mb-init") {
+            const retained = readDescriptorStageInput(context, { projectId: work.project_id, runId: work.run_id, stage: input.stage }, admitted.bundle);
+            const payload = retained.input.payload_base64;
+            if (typeof payload !== "string")
+                throw new AppError("stage_context_binding_invalid", "Memory Stage context has no retained payload", 1);
+            const bytes = Buffer.from(payload, "base64");
+            if (bytes.toString("base64") !== payload || (bytes.length ? sha256(bytes) !== input.contextSha256 : input.contextSha256 !== undefined))
+                throw new AppError("stage_context_binding_invalid", "Coordinator context checksum differs from retained Memory Stage bytes", 1);
+        }
+        const currentStage = snapshot.current_stage ?? (admitted.bundle.descriptor.descriptor.id === "sdlc" ? snapshot.stage_runs.at(-1)?.stage : undefined);
+        if (currentStage !== input.stage || !snapshot.stage_runs.some(stage => stage.stage === input.stage && stage.status === "running")
+            || !context.db.get("SELECT 1 FROM works WHERE project_id = ? AND run_id = ? AND work_id = ?", [work.project_id, work.run_id, work.work_id])
+            || !stageWorkIds(context, work.project_id, work.run_id, input.stage).has(work.work_id))
+            throw new AppError("stage_work_scope_invalid", "Coordinator does not belong to the active frozen stage", 1);
+    }
+    return bound ? admitted.bundle.execution.stage(input.stage) : null;
+}
 /** A stage coordinator is launched by `stage start`, not by an invented nested `work start`. */
 export function bindStageCoordinatorWork(context, input) {
     const work = requireWork(context, input.workId);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
     const run = requireRun(context, work.project_id, work.run_id);
-    claimStageStartHookEvent(context, { projectId: work.project_id, eventKey: input.hookEventId, runId: work.run_id, stage: input.stage, projectRoot: run.project_root, ...(input.contextSha256 ? { contextSha256: input.contextSha256 } : {}) });
     const snapshot = JSON.parse((context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id])?.index_json) ?? "{}");
-    const binding = bindRunningWorkSession(context, { ...input, allowStageHandoff: snapshot.execution_profile?.settings?.stage_session_mode === "new_session" });
-    context.db.run("UPDATE sessions SET current_stage = ?, updated_at = ? WHERE project_id = ? AND session_id = ?", [input.stage, context.now(), work.project_id, binding.session_id]);
-    refreshRunSessionProjection(context, work.project_id, work.run_id);
-    return binding;
+    const frozenRoute = preparedCoordinatorRoute(context, work, input, snapshot), bound = frozenRoute !== null;
+    const bind = () => {
+        assertRunMutationAllowed(context, work.project_id, work.run_id);
+        if (bound)
+            preparedCoordinatorRoute(context, work, input, JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json));
+        const profile = snapshot.execution_profile;
+        if (!bound && profile && input.contextSha256) {
+            const file = path.join(path.dirname(input.promptPath), "stage-context.json");
+            if (!fs.existsSync(file) || sha256(fs.readFileSync(file, "utf8")) !== input.contextSha256)
+                throw new AppError("context_checksum_mismatch", "Retained Stage context changed before coordinator binding", 2);
+            const item = { path: path.relative(requireRunHome(run), file), sha256: input.contextSha256 };
+            const prior = profile.stage_context_inputs?.[input.stage];
+            if (prior && JSON.stringify(prior) !== JSON.stringify(item))
+                throw new AppError("stage_context_replacement", "Stage already has a different accepted context", 2);
+            profile.stage_context_inputs = { ...profile.stage_context_inputs, [input.stage]: item };
+            context.db.run("UPDATE runs SET index_json = ? WHERE id = ? AND project_id = ?", [JSON.stringify(snapshot), run.id, work.project_id]);
+        }
+        // A stage may settle its Session while the RUN's root Work remains running.
+        // Completion must not erase the frozen handoff policy for the next stage.
+        const previous = context.db.get(`SELECT ws.id, ws.status, ws.session_id, ws.hook_event_id, s.current_stage, ws.result_path FROM work_sessions ws JOIN sessions s ON s.project_id = ? AND s.session_id = ws.session_id WHERE ws.work_id = ? AND ${bound ? "ws.status IN ('running', 'completed')" : "ws.status = 'running'"} ORDER BY ws.created_at DESC, ws.rowid DESC LIMIT 1`, [work.project_id, work.work_id]);
+        let sessionMode = frozenRoute?.session_mode ?? profile?.settings.stage_session_mode ?? "same_session";
+        if (!bound && profile?.settings.execution) {
+            if (!profile.agent_profiles)
+                throw new AppError("execution_profile_not_frozen", "Stage handoff requires frozen RUN profiles", 1);
+            sessionMode = resolveStageTransition({ ddFlowHome: context.ddFlowHome, policy: profile.settings.execution, profiles: profile.agent_profiles, projectRoot: run.project_root, workspaceRoot: run.workspace_root, ...(previous?.current_stage ? { fromStage: previous.current_stage } : {}), stage: input.stage, stageSessionMode: sessionMode, mergeMode: profile.settings.merge_mode }).session_mode;
+        }
+        const identity = hookSessionIdentity(context, work.project_id, input.hookEventId);
+        if (frozenRoute && runtimeHarness(frozenRoute.profile) !== identity.harness)
+            throw new AppError("stage_profile_mismatch", "Coordinator hook belongs to another frozen harness route", 1);
+        if (bound && previous && sessionMode === "same_session" && !ownsPhysicalWorkSession(context, work.project_id, previous, identity)) {
+            // Boundary recovery intentionally retains the terminal WorkSession. Only
+            // its explicitly accepted current-generation replacement may change daemon.
+            const guard = recoveryGuard(context, work.project_id, work.run_id);
+            const recoveredOwner = previous.status === "completed" && previous.session_id === identity.sessionId && guard?.status === "recovered" && context.db.get(`SELECT b.recovery_id FROM run_recovery_bindings b JOIN hook_events h ON h.project_id = ? AND h.event_key = b.hook_event_key AND h.status = 'claimed' AND h.daemon_id = b.daemon_id AND h.session_id = b.session_id WHERE b.recovery_id = ? AND b.status = 'accepted' AND b.work_id = ? AND b.prior_work_session_id = ? AND b.session_id = ? AND b.harness = ? AND b.provider_session_id = ? AND b.daemon_id = ?`, [work.project_id, guard.recovery_id, work.work_id, previous.id, identity.sessionId, identity.harness, identity.providerSessionId, identity.daemonId ?? null]);
+            if (!recoveredOwner)
+                throw new AppError("handoff_session_mismatch", "Frozen same-session handoff must retain the preceding coordinator's physical Session", 1, { stage: input.stage });
+        }
+        if (frozenRoute?.session_mode === "new_session")
+            assertFreshCoordinatorSession(context, work, input.stage, identity);
+        if (previous && sessionMode === "new_session" && previous.session_id === identity.sessionId
+            && (previous.current_stage && previous.current_stage !== input.stage || bound && path.resolve(previous.result_path ?? "") !== path.resolve(input.resultPath ?? "")))
+            throw new AppError("stage_handoff_required", "This stage requires a fresh coordinator Session under its frozen execution policy", 1, { from_stage: previous.current_stage, stage: input.stage });
+        claimStageStartHookEvent(context, { projectId: work.project_id, eventKey: input.hookEventId, runId: work.run_id, stage: input.stage, projectRoot: run.project_root, ...(input.contextSha256 ? { contextSha256: input.contextSha256 } : {}) });
+        const binding = bindRunningWorkSession(context, { ...input, allowStageHandoff: sessionMode === "new_session" });
+        context.db.run("UPDATE sessions SET current_stage = ?, updated_at = ? WHERE project_id = ? AND session_id = ?", [input.stage, context.now(), work.project_id, binding.session_id]);
+        if (frozenRoute)
+            appendAudit(context, { projectId: work.project_id, eventType: "stage.coordinator_binding", payload: {
+                    run_id: work.run_id, scope: { ...stageGraphScope(context, work.project_id, work.run_id, input.stage), stage: input.stage },
+                    work_id: work.work_id, work_session_id: binding.work_session_id, session_id: identity.sessionId,
+                    harness: identity.harness, provider_session_id: identity.providerSessionId,
+                    execution_sha256: context.stageBindingBundle.bundle.execution.sha256,
+                    profile_id: frozenRoute.profile.id, profile_sha256: hybridDigest(frozenRoute.profile), session_mode: frozenRoute.session_mode,
+                    ...(input.contextSha256 ? { context_sha256: input.contextSha256 } : {})
+                } });
+        refreshRunSessionProjection(context, work.project_id, work.run_id);
+        return binding;
+    };
+    return bound ? context.db.writeTransaction(bind, "stage.bindFrozenCoordinator") : bind();
+}
+function assertFreshCoordinatorSession(context, work, stage, identity) {
+    const prior = context.db.get("SELECT 1 FROM audit_events WHERE project_id = ? AND event_type = 'stage.coordinator_binding' AND json_extract(payload_json, '$.run_id') = ? AND json_extract(payload_json, '$.harness') = ? AND json_extract(payload_json, '$.provider_session_id') = ? AND json_extract(payload_json, '$.scope.stage') <> ? LIMIT 1", [work.project_id, work.run_id, identity.harness, identity.providerSessionId, stage]);
+    const current = context.db.get("SELECT current_stage FROM sessions WHERE project_id = ? AND session_id = ? AND run_id = ?", [work.project_id, identity.sessionId, work.run_id]);
+    if (prior || current?.current_stage && current.current_stage !== stage)
+        throw new AppError("stage_handoff_required", "Frozen stage requires a coordinator Session not used by another stage", 1, { stage });
 }
 /** Starts a created coordinator Work from its trusted `stage start` event. */
 export function startStageCoordinatorWork(context, input) {
     const work = requireWork(context, input.workId);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
     if (work.status !== "created")
         throw new AppError("invalid_work_state", "Stage coordinator Work is not created", 2, { work_id: work.work_id, status: work.status });
     const run = requireRun(context, work.project_id, work.run_id);
     if (input.projectRoot && resolveProjectRoot(input.projectRoot) !== resolveProjectRoot(run.project_root))
         throw new AppError("project_mismatch", "stage coordinator project root does not match its RUN", 1, { work_id: work.work_id });
-    const identity = claimStageStartHookEvent(context, { projectId: work.project_id, eventKey: input.hookEventId, runId: work.run_id, stage: input.stage, projectRoot: run.project_root, ...(input.contextSha256 ? { contextSha256: input.contextSha256 } : {}) });
-    const binding = startBoundWork(context, work, run, identity, input.hookEventId);
-    const sessionId = String(binding.session_binding.session_id ?? "");
-    context.db.run("UPDATE sessions SET current_stage = ?, updated_at = ? WHERE project_id = ? AND session_id = ?", [input.stage, context.now(), work.project_id, sessionId]);
+    const snapshot = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json);
+    const frozenRoute = preparedCoordinatorRoute(context, work, input, snapshot);
+    const binding = startBoundWork(context, work, run, () => {
+        if (frozenRoute) {
+            const current = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json);
+            preparedCoordinatorRoute(context, work, input, current);
+            const identity = hookSessionIdentity(context, work.project_id, input.hookEventId);
+            if (identity.harness !== runtimeHarness(frozenRoute.profile))
+                throw new AppError("stage_profile_mismatch", "Coordinator hook belongs to another frozen harness route", 1);
+            if (frozenRoute.session_mode === "new_session")
+                assertFreshCoordinatorSession(context, work, input.stage, identity);
+        }
+        return claimStageStartHookEvent(context, { projectId: work.project_id, eventKey: input.hookEventId, runId: work.run_id, stage: input.stage, projectRoot: run.project_root, ...(input.contextSha256 ? { contextSha256: input.contextSha256 } : {}) });
+    }, input.hookEventId, input.stage);
     refreshRunSessionProjection(context, work.project_id, work.run_id);
     return binding;
 }
-/** Stage entry points call this only after their own trusted hook claim. */
-export function startBoundWork(context, work, run, identity, hookEventId) {
-    if (work.status !== "created")
-        throw new AppError("invalid_work_state", "Work is not created", 2, { work_id: work.work_id, status: work.status });
-    const now = context.now();
-    const linkId = `WS-${crypto.randomUUID()}`;
+/** Claim, command authority and binding commit together; only packet projection follows. */
+export function startBoundWork(context, work, run, claimIdentity, hookEventId, stage) {
+    const repairWave = registeredMemoryRepairWave(context, work, run);
+    const generation = assertRunMutationAllowed(context, work.project_id, work.run_id);
     const directory = path.join(requireRunHome(run), "works", work.work_id);
-    fs.mkdirSync(directory, { recursive: true });
-    const promptPath = path.join(directory, "prompt.md");
-    const resultPath = path.join(directory, "result.json");
-    const contextPath = path.join(directory, "context.json");
-    const dependencyResults = parseDependencies(work).map((dependency) => context.db.get("SELECT work_id, result FROM works WHERE work_id = ?", [dependency])).filter(Boolean);
-    const prompt = renderWorkerPrompt(context, work, run, dependencyResults);
-    const payload = parsePayload(work);
-    const readOnly = payload?.read_only === true;
-    const workContext = { schema_id: "dd-flow/work-context@1", run_id: work.run_id, work_id: work.work_id, parent_work_id: work.parent_work_id, project_root: run.project_root, workspace_root: run.workspace_root, run_root: requireRunHome(run), depends_on: parseDependencies(work), launch_policy: work.launch_policy, result_schema: work.result_schema, read_only: readOnly, ...(readOnly ? { workspace_fingerprint: workspaceFingerprint(run.workspace_root) } : {}) };
-    const token = crypto.randomUUID();
-    const promptCandidate = `${promptPath}.${token}.tmp`;
-    const contextCandidate = `${contextPath}.${token}.tmp`;
-    fs.writeFileSync(promptCandidate, prompt);
-    fs.writeFileSync(contextCandidate, `${JSON.stringify(workContext, null, 2)}\n`);
-    context.db.exec("BEGIN IMMEDIATE");
+    const linkId = `WS-${crypto.randomUUID()}`;
+    // Recovery can reopen the same Work without retiring its historical packet.
+    // Give each new-generation start its own immutable publication destination.
+    const packetDirectory = path.join(directory, "starts", linkId);
+    const promptPath = path.join(packetDirectory, "prompt.md"), resultPath = path.join(directory, "result.json");
+    // The first reviewer freezes shared inputs in the same transaction as its claim.
+    const readOnly = parsePayload(work)?.read_only === true;
+    const repairPreparationContext = { ...context, env: { ...context.env, DD_FLOW_MEMORY_REPAIR_HOOK_EVENT: hookEventId } };
+    const preparedRepairCopy = repairWave ? prepareMemoryRepairStartOwner(repairPreparationContext, work, run, repairWave) : null;
+    const preparedMemoryReview = readOnly && parsePayload(work)?.kind === "memory-review"
+        ? prepareMemoryReviewWorkInput(context, work, run, generation) : null;
+    const nativeReviewCopy = preparedMemoryReview?.bundle.execution.work("review").delegation.mode === "native"
+        ? prepareMemoryNativeReviewCopy(context, work.work_id, false, preparedMemoryReview) : null;
+    const workerRun = preparedRepairCopy ? { ...run, workspace_root: preparedRepairCopy.root() }
+        : nativeReviewCopy ? { ...run, workspace_root: nativeReviewCopy.root } : readOnly && context.env.DD_FLOW_READ_ONLY_WORKSPACE
+            ? { ...run, workspace_root: path.resolve(context.env.DD_FLOW_READ_ONLY_WORKSPACE) } : run;
+    const preparedReviewInput = preparedMemoryReview?.input ?? (readOnly ? assertSharedReviewInput(context, work, run, generation) : null);
+    const reviewPaths = preparedReviewInput?.run_inputs.filter(item => item.root === "workspace").map(item => item.path) ?? [];
+    const preparedCopy = nativeReviewCopy ?? (readOnly && context.env.DD_FLOW_READ_ONLY_WORKSPACE ? prepareBoundReviewCopy(context, work, run, context.env.DD_FLOW_READ_ONLY_WORKSPACE, reviewPaths) : null);
+    const fingerprint = readOnly ? preparedReviewInput?.source_sha256 ?? preparedReviewInput?.workspace_fingerprint ?? legacyReviewFingerprint(work, run) ?? workspaceFingerprint(run.workspace_root) : undefined;
+    const preparedDependencies = parseDependencies(work).map(dependency => context.db.get("SELECT work_id, result FROM works WHERE work_id = ?", [dependency])).filter(Boolean);
+    const preparedRecovery = recoveryPromptForWork(context, work.work_id);
+    const retryPending = fs.existsSync(path.join(directory, ".retry.json"));
+    const finishMarker = `DD_FLOW_FINISH_${crypto.randomUUID()}`;
+    const failMarker = `DD_FLOW_FAIL_${crypto.randomUUID()}`;
+    const workspaceView = preparedCopy ? { work_id: work.work_id, from: run.workspace_root, to: reviewInputPath(requireRunHome(run), preparedCopy.copy.root), source_sha256: preparedCopy.copy.source_sha256, copy_sha256: preparedCopy.copy.sha256 } : undefined;
+    let promptTemplate = renderWorkerPrompt(context, work, workerRun, preparedDependencies, { finish: finishMarker, fail: failMarker }, workspaceView, preparedReviewInput ?? undefined);
+    if (preparedRecovery)
+        promptTemplate = `${recoveryPrompt(preparedRecovery)}\n\n${promptTemplate}`;
+    let binding;
     try {
-        bindSession(context, work, run, identity, now);
-        if (work.parent_work_id && work.launch_policy === "reuse_allowed")
-            context.db.run("UPDATE work_sessions SET status = 'completed', completed_at = ?, updated_at = ? WHERE session_id = ? AND status = 'running' AND work_id <> ?", [now, now, identity.sessionId, work.work_id]);
-        const claimed = context.db.run("UPDATE works SET status = 'running', started_at = ?, updated_at = ? WHERE work_id = ? AND status = 'created'", [now, now, work.work_id]);
-        if (claimed.changes !== 1)
-            throw new AppError("conflict", "Work was claimed concurrently", 1, { work_id: work.work_id });
-        context.db.run(`INSERT INTO work_sessions (id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, updated_at, completed_at) VALUES (?, ?, ?, ?, 'running', ?, ?, ?, ?, NULL)`, [linkId, work.work_id, identity.sessionId, hookEventId, promptPath, resultPath, now, now]);
-        fs.renameSync(promptCandidate, promptPath);
-        fs.renameSync(contextCandidate, contextPath);
-        context.db.exec("COMMIT");
+        binding = context.db.writeTransaction(() => {
+            const current = requireWork(context, work.work_id);
+            assertRunMutationAllowed(context, current.project_id, current.run_id, generation);
+            if (current.status !== "created")
+                throw new AppError("conflict", "Work was claimed concurrently", 1, { work_id: current.work_id, status: current.status });
+            if (Object.keys(current).some(key => current[key] !== work[key]))
+                throw new AppError("work_not_ready", "Work inputs changed while preparing its start packet", 2, { work_id: current.work_id });
+            preparedMemoryReview?.assertCustody(context);
+            if (!isReady(context, current))
+                throw new AppError("work_not_ready", "Work dependencies are not ready", 2, { work_id: current.work_id, blockers: readinessBlockers(context, current) });
+            if (retryPending)
+                throw new AppError("work_retry_incomplete", "Complete the interrupted Work retry before starting its next attempt", 1, { work_id: work.work_id });
+            const claimedIdentity = claimIdentity();
+            const nativeReviewExecution = nativeReviewCopy ? memoryRepairExecutionIdentity(context, { projectId: current.project_id, runId: current.run_id,
+                workId: current.work_id, eventKey: hookEventId, root: nativeReviewCopy.root }) : null;
+            const identity = preparedRepairCopy ? memoryRepairExecutionIdentity(context, { projectId: current.project_id,
+                runId: current.run_id, workId: current.work_id, eventKey: hookEventId, root: preparedRepairCopy.root() }).identity
+                : nativeReviewExecution?.identity ?? claimedIdentity;
+            if (identity.hookEventId !== claimedIdentity.hookEventId || identity.sessionId !== claimedIdentity.sessionId)
+                throw new AppError("memory_repair_native_binding_invalid", "Repair execution proof differs from the claimed Hook", 1, { effect: "no_effect" });
+            assertRecoveryHookCurrent(context, current.project_id, current.run_id, identity);
+            if (PreparedSecondMemoryRepairLaunch.isPrepared(preparedRepairCopy))
+                preparedRepairCopy.assertClaimIdentity(context, hookEventId, identity);
+            else
+                preparedRepairCopy?.assertClaimIdentity(context, identity);
+            if (readOnly && !context.env.DD_FLOW_READ_ONLY_WORKSPACE
+                && context.db.get("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'work_launches'")
+                && context.db.get("SELECT 1 FROM work_launches WHERE work_id = ? AND status IN ('launching','start_requested')", [current.work_id]))
+                throw new AppError("read_only_workspace_unbound", "External reviewer did not inherit its qualified execution workspace", 1, { work_id: current.work_id });
+            if (nativeReviewCopy) {
+                nativeReviewCopy.assertCustody(context);
+                const worker = nativeReviewCopy.route.worker;
+                if (identity.harness !== runtimeHarness(worker) || identity.model !== worker.model
+                    || identity.provider && identity.provider !== worker.provider)
+                    throw new AppError("read_only_workspace_unbound", "Native review Hook differs from the frozen worker profile", 1, { effect: "no_effect" });
+            }
+            else if (preparedCopy && 'providerSessionId' in preparedCopy) {
+                const launch = context.db.get("SELECT provider_session_id, profile_json FROM work_launches WHERE work_id = ? AND status IN ('launching','start_requested')", [current.work_id]);
+                if (!launch || launch.provider_session_id !== identity.providerSessionId || launch.provider_session_id !== preparedCopy.providerSessionId || launch.profile_json !== preparedCopy.profileJson)
+                    throw new AppError("read_only_workspace_unbound", "Read-only execution copy belongs to another physical Session or launch revision", 1, { work_id: current.work_id });
+            }
+            const reviewInput = preparedReviewInput;
+            const reviewCopy = preparedCopy?.copy ?? null;
+            if (reviewInput)
+                assertReviewSiblingBaseline(context, current, reviewInput, generation);
+            const dependencyResults = parseDependencies(current).map(dependency => context.db.get("SELECT work_id, result FROM works WHERE work_id = ?", [dependency])).filter(Boolean);
+            const recovery = recoveryPromptForWork(context, current.work_id);
+            if (JSON.stringify(dependencyResults) !== JSON.stringify(preparedDependencies) || JSON.stringify(recovery) !== JSON.stringify(preparedRecovery))
+                throw new AppError("work_not_ready", "Work dependencies or recovery segment changed while preparing its packet", 2, { work_id: current.work_id });
+            const assignments = new Set();
+            const currentStart = context.db.get("SELECT current_start_invocation_id FROM works WHERE work_id = ?", [work.work_id])?.current_start_invocation_id;
+            if (currentStart && context.env.DD_FLOW_CURRENT_INVOCATION && currentStart !== context.env.DD_FLOW_CURRENT_INVOCATION)
+                throw new AppError("work_generation_stale", "Work start authority belongs to an earlier attempt", 1, { work_id: work.work_id });
+            const commands = workerLifecycleCommands({ ...context, captureLifecycleAssignment: (id) => assignments.add(id) }, current, workerRun, true);
+            const prompt = promptTemplate.replace(finishMarker, commands.finish).replace(failMarker, commands.fail);
+            bindLifecyclePacketAssignments(context, prompt, assignments);
+            const workContext = { schema_id: "dd-flow/work-context@1", run_id: current.run_id, work_id: current.work_id, parent_work_id: current.parent_work_id, project_root: run.project_root, workspace_root: workerRun.workspace_root, run_root: requireRunHome(run), depends_on: parseDependencies(current), launch_policy: current.launch_policy, result_schema: current.result_schema, read_only: readOnly, ...(preparedRepairCopy ? { memory_repair_input: preparedRepairCopy.input() } : {}), ...(recovery ? { recovery } : {}), ...(readOnly ? { workspace_fingerprint: fingerprint, ...(reviewInput ? { review_input: reviewInput } : {}), ...(reviewCopy ? { review_copy: reviewCopy } : {}) } : {}) };
+            const contextBytes = `${JSON.stringify(workContext, null, 2)}\n`;
+            const response = { ok: true, work_id: current.work_id, work_session_id: linkId, worker_prompt_markdown: prompt, prompt_path: promptPath, ...(recovery ? { recovery } : {}), session_binding: { source: "PreToolUse", session: { harness_id: identity.harness, session_id: identity.nativeSessionId } } };
+            const receipt = JSON.stringify({ version: 2, prompt, context: contextBytes, prompt_sha256: sha256(prompt), context_sha256: sha256(contextBytes), response, response_sha256: sha256(JSON.stringify(response)), generation, invocation_id: context.env.DD_FLOW_CURRENT_INVOCATION ?? null });
+            const now = context.now();
+            bindSession(context, current, run, identity, now);
+            if (current.parent_work_id && current.launch_policy === "reuse_allowed")
+                context.db.run("UPDATE work_sessions SET status = 'completed', completed_at = ?, updated_at = ? WHERE session_id = ? AND status = 'running' AND work_id <> ?", [now, now, identity.sessionId, current.work_id]);
+            if (context.db.run("UPDATE works SET status = 'running', started_at = COALESCE(started_at, ?), updated_at = ? WHERE work_id = ? AND status = 'created'", [now, now, current.work_id]).changes !== 1)
+                throw new AppError("conflict", "Work was claimed concurrently", 1, { work_id: current.work_id });
+            context.db.run("INSERT INTO work_sessions (id, work_id, session_id, hook_event_id, status, prompt_path, result_path, start_receipt_json, start_publication_status, created_at, updated_at, completed_at) VALUES (?, ?, ?, ?, 'running', ?, ?, ?, 'pending', ?, ?, NULL)", [linkId, current.work_id, identity.sessionId, hookEventId, promptPath, resultPath, receipt, now, now]);
+            preparedRepairCopy?.recordStart(context, linkId);
+            if (nativeReviewCopy)
+                appendAudit(context, { projectId: current.project_id, eventType: "memory.native_review_binding", payload: {
+                        run_id: current.run_id, work_id: current.work_id, work_session_id: linkId, hook_event_key: hookEventId,
+                        session_id: identity.sessionId, provider_session_id: identity.providerSessionId, invocation_id: nativeReviewExecution?.invocationId ?? null,
+                        copy: nativeReviewCopy.copy
+                    } });
+            if (stage)
+                context.db.run("UPDATE sessions SET current_stage = ?, updated_at = ? WHERE project_id = ? AND session_id = ?", [stage, now, current.project_id, identity.sessionId]);
+            if (stage && context.stageBindingBundle) {
+                const route = context.stageBindingBundle.bundle.execution.stage(stage);
+                appendAudit(context, { projectId: current.project_id, eventType: "stage.coordinator_binding", payload: {
+                        run_id: current.run_id, scope: { ...stageGraphScope(context, current.project_id, current.run_id, stage), stage },
+                        work_id: current.work_id, work_session_id: linkId, session_id: identity.sessionId,
+                        harness: identity.harness, provider_session_id: identity.providerSessionId,
+                        execution_sha256: context.stageBindingBundle.bundle.execution.sha256,
+                        profile_id: route.profile.id, profile_sha256: hybridDigest(route.profile), session_mode: route.session_mode,
+                        ...(context.stageBindingBundle.contextSha256 ? { context_sha256: context.stageBindingBundle.contextSha256 } : {})
+                    } });
+            }
+            if (recovery)
+                activateRecoveryWork(context, current.work_id);
+            return response;
+        });
     }
     catch (error) {
-        context.db.exec("ROLLBACK");
-        fs.rmSync(promptCandidate, { force: true });
-        fs.rmSync(contextCandidate, { force: true });
+        // This transaction publishes only SQL authority, never files or provider calls.
+        if (error instanceof AppError && error.code === "storage_write_failed" && error.details.transaction_rolled_back === true)
+            error.details.effect = "no_effect";
+        if (error instanceof AppError && error.details.effect === "no_effect" && !context.env.DD_FLOW_CURRENT_INVOCATION) {
+            let retry = false;
+            try {
+                retry = context.db.writeTransaction(() => {
+                    if (context.db.get("SELECT 1 FROM hook_events WHERE project_id = ? AND json_extract(outcome_json, '$.work_id') = ? AND json_extract(outcome_json, '$.generation') = ? AND json_extract(outcome_json, '$.storage_retry') = 1", [work.project_id, work.work_id, generation]))
+                        return false;
+                    return context.db.run("UPDATE hook_events SET outcome_json = ? WHERE project_id = ? AND event_key = ? AND status = 'observed' AND outcome_json IS NULL", [JSON.stringify({ work_id: work.work_id, run_id: work.run_id, generation, effect: "no_effect", disposition: "retrying", storage_retry: 1, deadline: Date.now() + 60000 }), work.project_id, hookEventId]).changes === 1;
+                });
+            }
+            catch (persistence) {
+                error.details.retry_persistence_error = String(persistence);
+            }
+            if (retry)
+                return startBoundWork(context, work, run, claimIdentity, hookEventId, stage);
+        }
         throw error;
     }
-    refreshRunWorkProjection(context, work.project_id, work.run_id);
-    return { ok: true, work_id: work.work_id, work_session_id: linkId, worker_prompt_markdown: prompt, prompt_path: promptPath, session_binding: { source: "PreToolUse", session: { harness_id: identity.harness, session_id: identity.nativeSessionId } } };
+    try {
+        preparedRepairCopy?.revalidateCommittedStart(context, linkId);
+        if (readOnly) {
+            const committedWork = requireWork(context, work.work_id);
+            assertSharedReviewInput(context, committedWork, run, generation);
+            const link = context.db.get("SELECT id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, completed_at FROM work_sessions WHERE id = ?", [linkId]);
+            assertReviewCopyUnchanged(context, committedWork, run, link);
+        }
+        materializePendingWorkStarts(context, work.project_id, work.run_id);
+        refreshRunWorkProjection(context, work.project_id, work.run_id);
+    }
+    catch (error) {
+        if (error instanceof AppError) {
+            error.details.effect = "committed";
+            throw error;
+        }
+        throw new AppError("work_start_publication_failed", error instanceof Error ? error.message : String(error), 1, { effect: "committed", work_id: work.work_id, hook_event_id: hookEventId, cause: { code: error?.code ?? null } });
+    }
+    return binding;
+}
+/** Read the exact committed reply, never bind another Session or regenerate a packet. */
+export function recoverCommittedWorkStart(context, invocationId, eventKey, generation, workId) {
+    const row = context.db.get("SELECT ws.start_receipt_json, w.project_id, w.run_id, w.work_id, ws.id AS work_session_id, w.result_schema, w.payload_json FROM work_sessions ws JOIN works w ON w.work_id = ws.work_id WHERE ws.start_receipt_json IS NOT NULL AND ws.hook_event_id = ? AND json_extract(ws.start_receipt_json, '$.invocation_id') IS ? AND (? IS NULL OR w.work_id = ?)", [eventKey, invocationId, workId ?? null, workId ?? null]);
+    if (!row)
+        return undefined;
+    // Replay restores registered physical start custody, never prelaunch admission.
+    memoryRepairWave(row);
+    const retainedRun = requireRun(context, row.project_id, row.run_id);
+    const repairWave = registeredMemoryRepairWave(context, row, retainedRun);
+    const receipt = JSON.parse(row.start_receipt_json);
+    if (receipt.generation !== generation || !receipt.response || receipt.response_sha256 !== sha256(JSON.stringify(receipt.response)))
+        throw new AppError("work_start_receipt_invalid", "Committed reply identity or checksum differs", 1, { invocation_id: invocationId });
+    assertRunMutationAllowed(context, row.project_id, row.run_id, generation);
+    if (repairWave) {
+        let workspaceRoot;
+        try {
+            if (typeof receipt.context !== "string" || Buffer.byteLength(receipt.context) > 16 * 1024 * 1024)
+                throw new Error("Invalid retained context");
+            const input = JSON.parse(receipt.context);
+            if (typeof input.workspace_root !== "string")
+                throw new Error("Missing retained workspace");
+            workspaceRoot = input.workspace_root;
+        }
+        catch {
+            throw new AppError("work_start_receipt_invalid", "Committed repair context is unavailable", 1, { effect: "no_effect" });
+        }
+        const scope = { projectRoot: retainedRun.project_root, runId: row.run_id, workId: row.work_id, workspaceRoot, workSessionId: row.work_session_id };
+        const owner = repairWave === 1 ? restoreStartedMemoryRepairCopyFromStage(context, scope)
+            : restoreStartedMemorySecondRepairLaunchFromStage(context, scope);
+        if (owner.root() !== workspaceRoot)
+            throw new AppError("work_start_receipt_invalid", "Retained repair workspace differs from its physical start", 1, { effect: "no_effect" });
+        owner.revalidateCommittedStart(context, row.work_session_id);
+    }
+    materializePendingWorkStarts(context, row.project_id, row.run_id);
+    return receipt.response;
+}
+/** Root coordinators have no worker checks: settle them inside the stage transaction. */
+export function finishStageCoordinatorWork(context, id, result) {
+    const work = requireWork(context, id);
+    if (work.parent_work_id !== null || codePacket(work) || parsePayload(work)?.read_only)
+        throw new AppError("invalid_work_state", "Stage settlement requires a root coordinator", 2);
+    const run = requireRun(context, work.project_id, work.run_id);
+    const link = context.db.get("SELECT * FROM work_sessions WHERE work_id = ? AND status = 'running' ORDER BY created_at DESC LIMIT 1", [id]);
+    if (!link)
+        throw new AppError("runtime_missing", "Coordinator has no open Work/Session link", 1);
+    validateWorkResult(work, result, run.project_root, run.workspace_root, requireRunHome(run), run.id, link.result_path);
+    finishFanInWork(context, id, result);
+    context.db.run("UPDATE sessions SET status = 'idle', updated_at = ? WHERE project_id = ? AND session_id = ? AND NOT EXISTS (SELECT 1 FROM work_sessions WHERE session_id = ? AND status = 'running')", [context.now(), work.project_id, link.session_id, link.session_id]);
+    settleRecoveryWork(context, id, "completed");
+}
+export async function finishWork(context, id, result, progress, retry) {
+    const work = requireWork(context, id);
+    if (work.result_schema === "dd-flow/memory-repair-work-result@1") {
+        if (retry)
+            throw new AppError("usage", "Memory repair completion uses retained publication recovery, not code-check retry", 2, { effect: "no_effect" });
+        prepareWorkSettlement(context, id, "completed", result);
+        const published = publishMemoryRepairWorkCompletion(context, work, result);
+        try {
+            return await finishPublishedMemoryRepairWork(context, published);
+        }
+        catch (error) {
+            throw new AppError("memory_repair_completion_pending", "Repair publication completed but Work settlement requires reconciliation", 1, { effect: error instanceof AppError && error.details.effect === "unknown" ? "unknown" : "partial",
+                run_id: work.run_id, work_id: work.work_id, result_sha256: published.sha256,
+                cause: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    const prepared = prepareRegisteredMemoryWorkResult(context, work, result);
+    return settle(context, id, "completed", result, progress, retry, prepared ?? undefined);
+}
+/** Controller-selected registration/result preparation, never an agent-provided binding. */
+export function finishRegisteredMemoryCompositionWork(context, prepared) {
+    if (!(prepared instanceof PreparedRegisteredMemoryCompositionWorkResult))
+        throw new AppError("memory_work_result_preparation_required", "Memory Work completion requires admitted registered output", 1);
+    return settle(context, prepared.workId, "completed", prepared.bytes().toString("utf8"), undefined, undefined, prepared);
+}
+export function finishRegisteredMemoryReviewWork(context, prepared) {
+    if (!(prepared instanceof PreparedRegisteredMemoryReviewWorkResult))
+        throw new AppError("memory_work_result_preparation_required", "Memory reviewer completion requires registered input and independent Session proof", 1);
+    return settle(context, prepared.workId, "completed", prepared.bytes().toString("utf8"), undefined, undefined, prepared);
+}
+export function finishPublishedMemoryRepairWork(context, prepared) {
+    if (!PreparedPublishedMemoryRepairWorkResult.isPrepared(prepared))
+        throw new AppError("memory_work_result_preparation_required", "Repair completion requires independently published registered output", 1, { effect: "no_effect" });
+    return settle(context, prepared.workId, "completed", prepared.bytes().toString("utf8"), undefined, undefined, prepared);
 }
-export function finishWork(context, id, result, progress) { return settle(context, id, "completed", result, progress); }
 /** Structured fan-in closes a parent after its Session was handed to a child. */
-export function finishFanInWork(context, id, result) { const work = requireWork(context, id); if (work.status !== "running")
-    throw new AppError("invalid_work_state", "Fan-in Work is not running", 2, { work_id: work.work_id, status: work.status }); if (context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? AND status IN ('created','running','paused') LIMIT 1", [work.work_id]))
-    throw new AppError("active_child_work", "Fan-in Work still has active children", 2, { work_id: work.work_id }); const now = context.now(); context.db.run("UPDATE works SET status = 'completed', result = ?, completed_at = ?, updated_at = ? WHERE work_id = ?", [result, now, now, work.work_id]); context.db.run("UPDATE work_sessions SET status = 'completed', completed_at = COALESCE(completed_at, ?), updated_at = ? WHERE work_id = ? AND status = 'running'", [now, now, work.work_id]); refreshRunWorkProjection(context, work.project_id, work.run_id); appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_completed", work_id: work.work_id, fan_in: true }); return { ok: true, work_id: work.work_id, status: "completed", fan_in: true }; }
+export function finishFanInWork(context, id, result) {
+    const work = requireWork(context, id);
+    assertMemoryRepairWritePrepared(work);
+    if (["dd-flow/memory-composition-work-result@1", "dd-flow/memory-review-work-result@1"].includes(work.result_schema ?? ""))
+        throw new AppError("memory_work_result_preparation_required", "Memory Work cannot bypass registered result settlement through fan-in", 1);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
+    if (work.status !== "running")
+        throw new AppError("invalid_work_state", "Fan-in Work is not running", 2, { work_id: work.work_id, status: work.status });
+    if (context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? AND status IN ('created','running','paused') LIMIT 1", [work.work_id]))
+        throw new AppError("active_child_work", "Fan-in Work still has active children", 2, { work_id: work.work_id });
+    const now = context.now();
+    context.db.run("UPDATE works SET status = 'completed', result = ?, completed_at = ?, updated_at = ? WHERE work_id = ?", [result, now, now, work.work_id]);
+    context.db.run("UPDATE work_sessions SET status = 'completed', completed_at = COALESCE(completed_at, ?), updated_at = ? WHERE work_id = ? AND status = 'running'", [now, now, work.work_id]);
+    refreshRunWorkProjection(context, work.project_id, work.run_id);
+    appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_completed", work_id: work.work_id, fan_in: true });
+    return { ok: true, work_id: work.work_id, status: "completed", fan_in: true };
+}
 export function failWork(context, id, reason) { return settle(context, id, "failed", reason); }
 export function cancelWork(context, id, reason) { return settle(context, id, "cancelled", reason); }
-export function retryWork(context, id, reason) { const work = requireWork(context, id); id = work.work_id; if (work.status !== "failed")
-    throw new AppError("invalid_work_state", "Only failed Work may be retried", 2); const run = requireRun(context, work.project_id, work.run_id); const directory = path.join(requireRunHome(run), "works", id); const attempts = path.join(directory, "attempts"); const number = fs.existsSync(attempts) ? fs.readdirSync(attempts).filter((entry) => /^ATT-\d{3}$/.test(entry)).length + 1 : 1; const archive = path.join(attempts, `ATT-${String(number).padStart(3, "0")}`); fs.mkdirSync(archive, { recursive: true }); for (const file of ["prompt.md", "result.json", "context.json"]) {
-    const source = path.join(directory, file);
-    if (fs.existsSync(source))
-        fs.renameSync(source, path.join(archive, file));
-} context.db.run("UPDATE works SET status = 'created', result = NULL, started_at = NULL, completed_at = NULL, updated_at = ? WHERE work_id = ?", [context.now(), id]); refreshRunWorkProjection(context, work.project_id, work.run_id); return { ok: true, work_id: id, archived_attempt: path.relative(requireRunHome(run), archive).split(path.sep).join("/"), reason }; }
-async function settle(context, id, status, result, progress) {
+export function prepareWorkSettlement(context, id, status, result) {
+    if (status !== "completed" && (typeof result !== "string" || !result.trim()))
+        throw new AppError("usage", "Work settlement requires a nonempty --reason", 2);
     const work = requireWork(context, id);
-    id = work.work_id;
+    assertMemoryRepairTerminalFailureAllowed(context, work, status);
+    assertWorkSettlementAllowed(context, work.project_id, work.run_id, work.work_id);
     if (work.status !== "running" && !(status === "cancelled" && work.status === "created"))
         throw new AppError("invalid_work_state", "Work is not running", 2, { status: work.status });
-    if (status === "completed" && context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? AND status IN ('created', 'running', 'paused') LIMIT 1", [id]))
-        throw new AppError("active_child_work", "Work cannot complete while a child Work is active", 2, { work_id: id });
+    if (status === "completed" && context.db.get("SELECT 1 FROM works WHERE parent_work_id = ? AND status IN ('created', 'running', 'paused') LIMIT 1", [work.work_id]))
+        throw new AppError("active_child_work", "Work cannot complete while a child Work is active", 2, { work_id: work.work_id });
     const run = requireRun(context, work.project_id, work.run_id);
-    const link = context.db.get("SELECT id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, completed_at FROM work_sessions WHERE work_id = ? AND status = 'running' ORDER BY created_at DESC LIMIT 1", [id]);
+    const link = context.db.get("SELECT id, work_id, session_id, hook_event_id, status, prompt_path, result_path, created_at, completed_at FROM work_sessions WHERE work_id = ? AND status = 'running' ORDER BY created_at DESC LIMIT 1", [work.work_id]);
     if (work.status === "running" && !link)
-        throw new AppError("runtime_missing", "Running Work has no open Work/Session link", 1, { work_id: id });
+        throw new AppError("runtime_missing", "Running Work has no open Work/Session link", 1, { work_id: work.work_id });
+    const startPublication = link ? context.db.get("SELECT start_publication_status FROM work_sessions WHERE id = ?", [link.id])?.start_publication_status : null;
+    if (startPublication && startPublication !== "published")
+        throw new AppError("work_start_publication_pending", "Finish publishing this Work's committed start packet before settlement", 1, { work_id: work.work_id, effect: "no_effect" });
+    return { work, run, link };
+}
+export function prepareWorkRetry(context, id, reason) {
+    if (typeof reason !== "string" || !reason.trim())
+        throw new AppError("usage", "Work retry requires a nonempty --reason", 2);
+    const work = requireWork(context, id);
+    assertRunMutationAllowed(context, work.project_id, work.run_id);
+    const run = requireRun(context, work.project_id, work.run_id);
+    const directory = path.join(requireRunHome(run), "works", work.work_id);
+    const journal = path.join(directory, ".retry.json");
+    let pending = null;
+    if (fs.existsSync(journal)) {
+        let value;
+        try {
+            value = JSON.parse(fs.readFileSync(journal, "utf8"));
+        }
+        catch (error) {
+            if (!(error instanceof SyntaxError))
+                throw error;
+            throw new AppError("work_retry_invalid", "Retry journal is not valid JSON", 1);
+        }
+        const item = value;
+        if (!item || typeof item !== "object" || item.work_id !== work.work_id || typeof item.archive !== "string" || !/^ATT-\d{3,}$/.test(item.archive) || !Array.isArray(item.entries) || item.entries.some(file => !["prompt.md", "result.json", "context.json", "result-input.json"].includes(file)) || new Set(item.entries).size !== item.entries.length || !(item.result_sha256 === null || typeof item.result_sha256 === "string" && /^[a-f0-9]{64}$/.test(item.result_sha256)))
+            throw new AppError("work_retry_invalid", "Retry journal does not identify this Work", 1);
+        pending = item;
+    }
+    if (work.status !== "failed" && !(pending && work.status === "created"))
+        throw new AppError("invalid_work_state", "Only failed Work may be retried", 2);
+    const attempts = path.join(directory, "attempts");
+    let number = 1;
+    while (fs.existsSync(path.join(attempts, `ATT-${String(number).padStart(3, "0")}`)))
+        number += 1;
+    const prepared = pending ?? { work_id: work.work_id, archive: `ATT-${String(number).padStart(3, "0")}`, entries: ["prompt.md", "result.json", "context.json", "result-input.json"].filter(file => fs.existsSync(path.join(directory, file))), result_sha256: work.result === null ? null : crypto.createHash("sha256").update(work.result).digest("hex") };
+    const archive = path.join(attempts, prepared.archive);
+    if (work.status === "failed") {
+        if (prepared.result_sha256 !== (work.result === null ? null : crypto.createHash("sha256").update(work.result).digest("hex")))
+            throw new AppError("work_retry_conflict", "Failed Work receipt changed during retry", 1);
+        const receipt = path.join(archive, "accepted-receipt.json");
+        if (fs.existsSync(receipt) && fs.readFileSync(receipt, "utf8") !== JSON.stringify({ work_id: work.work_id, status: work.status, result: work.result, result_sha256: prepared.result_sha256 }))
+            throw new AppError("work_retry_conflict", "Archived receipt differs from failed Work", 1);
+        for (const file of prepared.entries) {
+            const source = path.join(directory, file), target = path.join(archive, file);
+            if (fs.existsSync(source) && fs.existsSync(target))
+                throw new AppError("archive_conflict", "Both live and archived Work artifact exist; preserve both", 1, { source, target });
+            if (!fs.existsSync(source) && !fs.existsSync(target))
+                throw new AppError("archive_artifact_missing", "Work artifact is absent from both retry locations", 1, { source, target });
+        }
+    }
+    return { work, run, directory, journal, pending, prepared, archive };
+}
+export function retryWork(context, id, reason) {
+    const pending = requireWork(context, id);
+    // A committed failed result must be published (or diagnosed) before its
+    // live path can be archived for the next attempt.
+    materializePendingWorkResults(context, pending.project_id, pending.run_id, pending.work_id);
+    const { work, run, directory, journal, pending: retainedJournal, prepared, archive } = prepareWorkRetry(context, id, reason);
+    const previousStart = context.db.get("SELECT current_start_invocation_id FROM works WHERE work_id = ?", [id])?.current_start_invocation_id;
+    const startAuthority = work.status === "failed" ? prepareWorkStartAuthority(context, rawWorkStartCommand(context, work), previousStart) : null;
+    if (work.status === "failed") {
+        // The durable journal and archive are projections of the failed SQL
+        // receipt. They must finish before the short transaction opens a new
+        // attempt; a crash at any point is replayed from the same journal.
+        if (!retainedJournal)
+            publishStartReceiptFile(journal, JSON.stringify(prepared), sha256(JSON.stringify(prepared)));
+        fs.mkdirSync(archive, { recursive: true });
+        const receipt = path.join(archive, "accepted-receipt.json");
+        const receiptBytes = JSON.stringify({ work_id: work.work_id, status: work.status, result: work.result, result_sha256: prepared.result_sha256 });
+        publishStartReceiptFile(receipt, receiptBytes, sha256(receiptBytes));
+        for (const file of prepared.entries) {
+            const source = path.join(directory, file), target = path.join(archive, file);
+            if (fs.existsSync(source)) {
+                if (fs.existsSync(target))
+                    throw new AppError("archive_conflict", "Both live and archived Work artifact exist; preserve both", 1, { source, target });
+                fs.renameSync(source, target);
+            }
+            else if (!fs.existsSync(target))
+                throw new AppError("archive_artifact_missing", "Work artifact is absent from both retry locations", 1, { source, target });
+        }
+        for (const folder of [archive, directory]) {
+            const descriptor = fs.openSync(folder, "r");
+            try {
+                fs.fsyncSync(descriptor);
+            }
+            finally {
+                fs.closeSync(descriptor);
+            }
+        }
+        context.db.writeTransaction(() => {
+            const current = requireWork(context, work.work_id);
+            assertRunMutationAllowed(context, current.project_id, current.run_id, startAuthority?.scope.generation);
+            if (current.status !== "failed" || current.result !== work.result || current.updated_at !== work.updated_at)
+                throw new AppError("work_retry_conflict", "Failed Work receipt changed during retry", 1);
+            retireWorkPacketAuthorities(context, work.work_id);
+            for (const column of ["prompt_path", "result_path"]) {
+                const file = column === "prompt_path" ? "prompt.md" : "result.json";
+                context.db.run(`UPDATE work_sessions SET ${column} = ? WHERE work_id = ? AND ${column} = ?`, [path.join(archive, file), work.work_id, path.join(directory, file)]);
+            }
+            if (context.db.run("UPDATE works SET status = 'created', result = NULL, started_at = NULL, completed_at = NULL, updated_at = ? WHERE work_id = ? AND status = 'failed'", [context.now(), work.work_id]).changes !== 1)
+                throw new AppError("work_retry_conflict", "Failed Work changed during retry", 1);
+            const startId = startAuthority ? issueLifecycleInvocation(context, startAuthority.command, startAuthority.scope).id : null;
+            context.db.run("UPDATE works SET current_start_invocation_id = ? WHERE work_id = ?", [startId, work.work_id]);
+        });
+    }
+    fs.rmSync(journal, { force: true });
+    refreshRunWorkProjection(context, work.project_id, work.run_id);
+    return { ok: true, work_id: work.work_id, archived_attempt: path.relative(requireRunHome(run), archive).split(path.sep).join("/"), reason };
+}
+export function reviewSourceInputs(context, workId) {
+    const work = requireWork(context, workId);
+    const input = assertSharedReviewInput(context, work, requireRun(context, work.project_id, work.run_id));
+    return input?.run_inputs.filter(item => item.root === "workspace").map(item => item.path) ?? [];
+}
+function reviewInputPath(root, relative) {
+    const resolved = path.resolve(root, relative);
+    const inside = path.relative(root, resolved);
+    if (!relative || path.isAbsolute(relative) || inside === ".." || inside.startsWith(`..${path.sep}`))
+        throw new AppError("review_input_invalid", "Review input path escapes its declared root", 1, { path: relative });
+    if (fs.existsSync(resolved)) {
+        const canonicalInside = path.relative(fs.realpathSync(root), fs.realpathSync(resolved));
+        if (canonicalInside === ".." || canonicalInside.startsWith(`..${path.sep}`))
+            throw new AppError("review_input_invalid", "Review input symlink escapes its declared root", 1, { path: relative });
+    }
+    return resolved;
+}
+function prepareBoundReviewCopy(context, work, run, requested, reviewPaths) {
+    const launch = context.db.get("SELECT provider_session_id, profile_json FROM work_launches WHERE work_id = ? AND status IN ('launching','start_requested')", [work.work_id]);
+    const metadata = launch ? JSON.parse(launch.profile_json) : null;
+    const copy = metadata?.review_copy;
+    if (!copy?.root || !copy.sha256 || !copy.source_sha256 || !launch?.provider_session_id)
+        throw new AppError("read_only_workspace_unbound", "Read-only execution copy has no matching trusted launch", 1, { work_id: work.work_id });
+    const expected = reviewInputPath(requireRunHome(run), copy.root);
+    if (path.resolve(requested) !== expected)
+        throw new AppError("read_only_workspace_unbound", "Read-only execution path differs from the trusted launch", 1, { work_id: work.work_id });
+    const base = reviewWorkspaceBase(context, work);
+    if (reviewSourceHash(run.workspace_root, reviewPaths, base) !== copy.source_sha256)
+        throw new AppError("read_only_input_changed", "Authoritative review workspace changed after the execution copy was made", 2, { work_id: work.work_id });
+    const actual = reviewExecutionCopyHash(expected, run.workspace_root, true, reviewPaths, base);
+    if (actual !== copy.sha256)
+        throw new AppError("read_only_input_changed", "Read-only execution copy changed before Work start", 2, { work_id: work.work_id, expected: copy.sha256, current: actual });
+    return { copy: { root: copy.root, sha256: copy.sha256, source_sha256: copy.source_sha256 }, providerSessionId: launch.provider_session_id, profileJson: launch.profile_json };
+}
+function assertReviewCopyUnchanged(context, work, run, link) {
+    if (!link)
+        return;
+    const row = context.db.get("SELECT start_receipt_json FROM work_sessions WHERE id = ?", [link.id]);
+    const external = context.db.get("SELECT 1 FROM sqlite_schema WHERE type = 'table' AND name = 'work_launches'")
+        ? context.db.get("SELECT 1 FROM work_launches WHERE work_id = ? LIMIT 1", [work.work_id]) : null;
+    if (!row?.start_receipt_json) {
+        if (external)
+            throw new AppError("read_only_workspace_unbound", "External review has no committed start receipt", 1, { work_id: work.work_id });
+        return;
+    }
+    let copy;
+    let reviewPaths = [];
+    try {
+        const receipt = JSON.parse(row.start_receipt_json);
+        const retained = receipt.context ? JSON.parse(receipt.context) : null;
+        copy = retained?.review_copy;
+        reviewPaths = retained?.review_input?.run_inputs.filter(item => item.root === "workspace").map(item => item.path) ?? [];
+    }
+    catch {
+        throw new AppError("read_only_workspace_unbound", "Review start receipt is malformed", 1, { work_id: work.work_id });
+    }
+    if (!copy) {
+        if (external)
+            throw new AppError("read_only_workspace_unbound", "External review start receipt has no copy binding", 1, { work_id: work.work_id });
+        return;
+    }
+    if (!copy.root || !copy.sha256)
+        throw new AppError("read_only_workspace_unbound", "Review copy receipt is incomplete", 1, { work_id: work.work_id });
+    const base = reviewWorkspaceBase(context, work);
+    const actual = reviewExecutionCopyHash(reviewInputPath(requireRunHome(run), copy.root), run.workspace_root, true, reviewPaths, base);
+    if (actual !== copy.sha256)
+        throw new AppError("read_only_input_changed", "Read-only execution copy changed during review", 2, { work_id: work.work_id, expected: copy.sha256, current: actual });
+    if (copy.source_sha256 && reviewSourceHash(run.workspace_root, reviewPaths, base) !== copy.source_sha256)
+        throw new AppError("read_only_input_changed", "Authoritative review workspace changed during review", 2, { work_id: work.work_id });
+}
+function reviewWorkspaceBase(context, work) {
+    const row = context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]);
+    const base = row && JSON.parse(row.index_json).workspace?.base;
+    return base && base !== "unknown" ? base : "HEAD";
+}
+function legacyReviewFingerprint(work, run) {
+    const kind = parsePayload(work)?.kind;
+    const relative = kind === "code-review" ? "06-code-review/review-context.json" : kind === "plan-review" ? "04-plan-review/work-context.json" : null;
+    if (!relative || !work.parent_work_id)
+        return null;
+    const file = path.join(requireRunHome(run), relative);
+    if (!fs.existsSync(file))
+        return null;
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    return value.read_only_input?.version !== 2 && value.read_only_input?.parent_work_id === work.parent_work_id && typeof value.read_only_input.fingerprint === "string" ? value.read_only_input.fingerprint : null;
+}
+function assertSharedReviewInput(context, work, run, generation = recoveryGuard(context, work.project_id, work.run_id)?.generation ?? 0) {
+    const payload = parsePayload(work), kind = payload?.kind;
+    if (kind === "memory-review") {
+        const input = prepareMemoryReviewWorkInput(context, work, run, generation).input;
+        assertReviewSiblingBaseline(context, work, input, generation);
+        return input;
+    }
+    const relative = kind === "code-review" ? "06-code-review/review-context.json" : kind === "plan-review" ? "04-plan-review/work-context.json" : null;
+    if (!relative || !work.parent_work_id)
+        return null;
+    const home = requireRunHome(run), file = path.join(home, relative);
+    if (!fs.existsSync(file))
+        throw new AppError("review_input_missing", "The review stage context is missing", 1, { work_id: work.work_id, file: relative });
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    if (value.read_only_input?.parent_work_id !== work.parent_work_id)
+        throw new AppError("review_input_invalid", "Reviewer belongs to a different review group", 1, { work_id: work.work_id, parent_work_id: work.parent_work_id });
+    const index = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json);
+    const stage = (name) => index.stage_runs?.find(item => item.stage === name);
+    if (value.read_only_input.version !== 2 && value.read_only_input.version !== 3) {
+        if (stage(kind === "plan-review" ? "plan" : "code")?.data_sha256)
+            throw new AppError("review_input_contract_missing", "A new review run cannot downgrade its input contract", 1, { work_id: work.work_id });
+        return null; // Historical receipts retain their original fingerprint contract.
+    }
+    const expected = new Map();
+    const add = (root, relativePath, sha) => {
+        if (!/^[a-f0-9]{64}$/.test(sha))
+            throw new AppError("review_input_invalid", "Review input lacks an accepted checksum", 1, { path: relativePath });
+        reviewInputPath(root === "run" ? home : run.workspace_root, relativePath);
+        const key = `${root}:${relativePath}`;
+        if (expected.has(key) && expected.get(key) !== sha)
+            throw new AppError("review_input_invalid", "Review input has conflicting accepted checksums", 1, { path: relativePath });
+        expected.set(key, sha);
+    };
+    const frozenProfile = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json).execution_profile;
+    const operational = frozenProfile?.operational_contract;
+    if (operational)
+        add("run", operational.path, operational.sha256);
+    if (operational?.policy_source)
+        add("run", operational.policy_source.path, operational.policy_source.sha256);
+    const stageContexts = frozenProfile?.stage_context_inputs ?? {};
+    for (const item of Object.values(stageContexts))
+        add("run", item.path, item.sha256);
+    const stageReport = (name, relativePath) => {
+        const sha = stage(name)?.data_sha256;
+        if (!sha)
+            throw new AppError("review_input_contract_missing", "Accepted stage report has no committed checksum", 1, { stage: name });
+        add("run", relativePath, sha);
+        const reportFile = reviewInputPath(home, relativePath);
+        if (!fs.existsSync(reportFile) || sha256(fs.readFileSync(reportFile, "utf8")) !== sha)
+            throw new AppError("read_only_input_changed", "Accepted stage report changed before or during review", 2, { path: relativePath, expected: sha });
+        return JSON.parse(fs.readFileSync(reportFile, "utf8"));
+    };
+    if (kind === "plan-review") {
+        const accepted = stageReport("plan", "03-plan/stage-report.json").semantic;
+        if (!accepted?.plan_checksums?.length || !accepted.aspect_map_checksums?.length || !accepted.batch_checksum)
+            throw new AppError("review_input_contract_missing", "Accepted PLAN lacks exact review input checksums", 1);
+        for (const item of accepted.plan_checksums)
+            add("workspace", item.path, item.sha256);
+        for (const item of accepted.aspect_map_checksums)
+            add("run", item.path, item.sha256);
+        add("run", "03-plan/code-work-batch.json", accepted.batch_checksum);
+        if (value.system?.batch_checksum !== accepted.batch_checksum)
+            throw new AppError("read_only_input_changed", "PLAN-REVIEW batch differs from accepted PLAN", 2);
+        const planSet = accepted.plan_checksums.map(item => ({ protocol_id: path.basename(path.dirname(item.path)), path: item.path, sha256: item.sha256 })).sort((a, b) => a.protocol_id.localeCompare(b.protocol_id));
+        if (value.system?.plan_checksum !== sha256(JSON.stringify(planSet)))
+            throw new AppError("read_only_input_changed", "PLAN-REVIEW plan revision differs from accepted PLAN", 2);
+    }
+    else {
+        stageReport("code", "05-code/stage-report.json");
+        if (value.code_report_sha256 !== stage("code")?.data_sha256 || !stage("code-review")?.input_sha256 || !value.review_batch_sha256 || !Array.isArray(value.aspect_map_checksums) || !value.aspect_map_checksums.length
+            || sha256(JSON.stringify({ batch: value.review_batch_sha256, aspect_maps: value.aspect_map_checksums })) !== stage("code-review")?.input_sha256)
+            throw new AppError("review_input_contract_missing", "CODE-REVIEW inputs are not bound to their accepted stage", 1);
+        add("run", "06-code-review/review-work-batch.json", value.review_batch_sha256);
+        for (const item of value.aspect_map_checksums)
+            add("run", item.path, item.sha256);
+        if (value.cycle !== payload?.review_cycle)
+            throw new AppError("review_input_invalid", "CODE-REVIEW cycle differs from its Work", 1);
+    }
+    const matrix = latestRunVerificationMatrix(context, work.project_id, work.run_id, String(kind), "input");
+    const marked = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json).verification_matrix_contract === verificationMatrixContract;
+    if (marked && !matrix)
+        throw new AppError("review_input_contract_missing", "Marked reviewer Stage lacks its immutable matrix baseline", 1, { stage: kind });
+    if (matrix) {
+        add("run", matrix.metadata.json.path, matrix.metadata.json.sha256);
+        add("run", matrix.metadata.markdown.path, matrix.metadata.markdown.sha256);
+        for (const source of matrix.matrix.sources.filter(source => ["specify", "protocolize", "protocolize_report"].includes(source.role)))
+            add(source.root, source.path, source.sha256);
+    }
+    for (const item of value.reviewer_inputs ?? [])
+        add("workspace", item.path, item.sha256);
+    const runInputs = [...expected].map(([key, sha]) => { const [root, ...parts] = key.split(":"); return { root: root, path: parts.join(":"), sha256: sha }; }).sort((a, b) => `${a.root}:${a.path}`.localeCompare(`${b.root}:${b.path}`));
+    for (const item of runInputs) {
+        const target = reviewInputPath(item.root === "run" ? home : run.workspace_root, item.path);
+        const actual = fs.existsSync(target) ? sha256(fs.readFileSync(target, "utf8")) : null;
+        if (actual !== item.sha256)
+            throw new AppError("read_only_input_changed", "Accepted review input changed", 2, { work_id: work.work_id, root: item.root, path: item.path, expected: item.sha256, current: actual });
+    }
+    const reviewPaths = runInputs.filter(item => item.root === "workspace").map(item => item.path);
+    if (value.read_only_input.version === 3)
+        for (const relative of reviewPaths) {
+            if (!reviewEnvironmentAllowed(relative))
+                throw new AppError("review_input_invalid", "Required review input is excluded from external review", 1, { path: relative });
+        }
+    const base = index.workspace?.base && index.workspace.base !== "unknown" ? index.workspace.base : "HEAD";
+    const selectedPaths = value.read_only_input.version === 3 ? reviewSourcePaths(run.workspace_root, reviewPaths, base) : null;
+    if (selectedPaths && reviewPaths.some(relative => !selectedPaths.includes(relative)))
+        throw new AppError("review_input_invalid", "Required review input is excluded from external review", 1, { work_id: work.work_id });
+    const selectedSource = value.read_only_input.version === 3 ? reviewSourceHash(run.workspace_root, reviewPaths, base) : null;
+    const current = { schema_id: value.read_only_input.version === 3 ? "dd-flow/review-input@3" : "dd-flow/review-input@2", parent_work_id: work.parent_work_id, kind: String(kind), cycle: kind === "code-review" ? String(payload?.review_cycle) : "initial", generation, workspace_fingerprint: selectedSource ?? workspaceFingerprint(run.workspace_root), ...(selectedSource ? { source_policy: "review-inputs@1", source_sha256: selectedSource } : {}), run_inputs: runInputs };
+    assertReviewSiblingBaseline(context, work, current, generation);
+    return current;
+}
+function assertReviewSiblingBaseline(context, work, current, generation) {
+    const committed = context.db.all("SELECT ws.start_receipt_json FROM work_sessions ws JOIN works w ON w.work_id = ws.work_id WHERE w.project_id = ? AND w.run_id = ? AND w.parent_work_id = ? AND json_extract(w.payload_json, '$.kind') = ? AND ws.start_receipt_json IS NOT NULL ORDER BY ws.created_at, ws.id", [work.project_id, work.run_id, work.parent_work_id, current.kind]);
+    for (const row of committed) {
+        const receipt = JSON.parse(row.start_receipt_json);
+        if (!receipt.context)
+            continue;
+        const prior = JSON.parse(receipt.context).review_input;
+        if (!prior || prior.cycle !== current.cycle)
+            continue;
+        // Recovery changes the execution owner, not the review revision. A
+        // completed sibling from an older generation still pins this review cycle.
+        if (prior.schema_id !== current.schema_id || JSON.stringify({ ...prior, generation }) !== JSON.stringify(current))
+            throw new AppError("read_only_input_changed", "Reviewer inputs differ from the first committed review start", 2, { work_id: work.work_id, baseline: prior, current });
+        break;
+    }
+}
+async function settle(context, id, status, result, progress, retry, memoryResult) {
+    const { work, run, link } = prepareWorkSettlement(context, id, status, result);
+    id = work.work_id;
     let receipts = [];
     let coordinationDrift = [];
-    if (status === "completed") {
-        if (parsePayload(work)?.read_only === true) {
+    const assertReadOnlyInput = () => {
+        if (status === "completed" && parsePayload(work)?.read_only === true) {
+            assertReviewCopyUnchanged(context, work, run, link);
+            const shared = assertSharedReviewInput(context, work, run);
+            if (shared)
+                return;
+            const legacy = legacyReviewFingerprint(work, run);
+            // The final reviewer commits the shared input boundary under the writer
+            // reservation. Concurrent finishes cannot both skip this verification.
+            if (legacy && context.db.get("SELECT 1 FROM works WHERE project_id = ? AND run_id = ? AND parent_work_id = ? AND work_id <> ? AND status IN ('created','running','paused') AND json_extract(payload_json, '$.read_only') = 1 AND json_extract(payload_json, '$.kind') = ? LIMIT 1", [work.project_id, work.run_id, work.parent_work_id, work.work_id, parsePayload(work)?.kind]))
+                return;
             const contextFile = link ? path.join(path.dirname(link.prompt_path), "context.json") : "";
-            const baseline = contextFile && fs.existsSync(contextFile) ? JSON.parse(fs.readFileSync(contextFile, "utf8")).workspace_fingerprint : null;
+            const baseline = legacy ?? (contextFile && fs.existsSync(contextFile) ? JSON.parse(fs.readFileSync(contextFile, "utf8")).workspace_fingerprint : null);
             const current = workspaceFingerprint(run.workspace_root);
             if (typeof baseline !== "string" || baseline !== current)
-                throw new AppError("read_only_work_mutated_workspace", "Read-only Work changed the accepted workspace", 2, { work_id: work.work_id, baseline, current });
+                throw new AppError("read_only_input_changed", "The workspace changed during read-only Work; its review input is stale (the writer is unknown)", 2, { work_id: work.work_id, baseline, current });
+        }
+    };
+    if (status === "completed") {
+        if (!PreparedPublishedMemoryRepairWorkResult.isPrepared(memoryResult))
+            assertMemoryRepairWritePrepared(work);
+        if (["dd-flow/memory-composition-work-result@1", "dd-flow/memory-review-work-result@1", "dd-flow/memory-repair-work-result@1"].includes(work.result_schema ?? "")) {
+            const correctOwner = work.result_schema === "dd-flow/memory-composition-work-result@1"
+                ? memoryResult instanceof PreparedRegisteredMemoryCompositionWorkResult
+                : work.result_schema === "dd-flow/memory-review-work-result@1" ? memoryResult instanceof PreparedRegisteredMemoryReviewWorkResult
+                    : PreparedPublishedMemoryRepairWorkResult.isPrepared(memoryResult);
+            if (!correctOwner || !memoryResult || memoryResult.workId !== work.work_id || !link)
+                throw new AppError("memory_work_result_preparation_required", "Memory Work completion requires admitted registered output", 1);
+            memoryResult.revalidate(context);
+            memoryResult.assertSettlementScope(context, link.session_id, link.id);
+        }
+        else {
+            if (memoryResult)
+                throw new AppError("memory_work_result_preparation_required", "Prepared memory output cannot settle another Work schema", 1);
+            validateWorkResult(work, result, run.project_root, run.workspace_root, requireRunHome(run), run.id, link?.result_path ?? null);
         }
-        validateWorkResult(work, result, run.project_root, run.workspace_root, requireRunHome(run), run.id, link?.result_path ?? null);
         const packet = codePacket(work);
         if (packet) {
             // CODE packets are projected from a PLAN that already validated this
             // profile. Check it even when the Work has only raw focused checks, so a
             // worker cannot complete after downgrading the frozen project contract.
             readCodeCheckProfile(run.workspace_root);
+            // A provider promises aliases even when their execution belongs to a
+            // later aggregate gate. Validate materialization, without running them.
+            for (const check of packet.provides_checks)
+                validateCheckDeclaration(run.workspace_root, check);
             coordinationDrift = plannedAreaDrift(packet, result);
             const artifactDir = path.relative(requireRunHome(run), path.dirname(link.result_path));
-            receipts = await runCodeChecks(context, { projectId: work.project_id, runId: work.run_id, runHome: requireRunHome(run), workspaceRoot: run.workspace_root, workId: work.work_id, artifactDir, scope: "work", checks: packet.checks.filter((check) => check.run_at === "work"), ...(progress ? { progress } : {}) });
+            const requiredChecks = packet.repair?.verification_check_refs?.length
+                ? uniqueChecks([...packet.checks.filter((check) => check.run_at === "work"), ...packet.repair.verification_check_refs])
+                : packet.checks.filter((check) => check.run_at === "work");
+            if (retry)
+                validateFailedCheckRetry(context, { projectId: work.project_id, runId: work.run_id, receiptId: retry.receiptId, declarations: requiredChecks, reason: retry.reason });
+            receipts = await runCodeChecks(context, { projectId: work.project_id, runId: work.run_id, runHome: requireRunHome(run), workspaceRoot: run.workspace_root, workId: work.work_id, artifactDir, scope: "work", checks: requiredChecks, ...(retry ? { retryReceiptId: retry.receiptId, retryReason: retry.reason } : {}), ...(progress ? { progress } : {}) });
             const failed = receipts.filter((receipt) => receipt.status !== "passed");
+            if (failed.length)
+                assertSourceRepairEligible(failed);
             if (failed.length)
                 throw new AppError("work_checks_failed", "Work remains running because required checks failed", 2, { work_id: id, failures: failed, all_receipts: receipts });
         }
     }
+    // Shared-input and workspace fingerprint checks read files and may traverse
+    // the project tree. Keep them before the SQLite writer reservation.
+    assertReadOnlyInput();
+    const resultReceipt = link?.result_path && work.parent_work_id !== null
+        ? JSON.stringify({ work_id: work.work_id, work_session_id: link.id, status, result_sha256: sha256(result), previous_sha256: receiptFileHash(link.result_path) })
+        : null;
     const now = context.now();
-    context.db.exec("BEGIN IMMEDIATE");
-    try {
-        context.db.run("UPDATE works SET status = ?, result = ?, completed_at = ?, updated_at = ? WHERE work_id = ?", [status, result, now, now, id]);
+    context.db.writeTransaction(() => {
+        assertWorkSettlementAllowed(context, work.project_id, work.run_id, work.work_id);
+        assertMemoryRepairTerminalFailureAllowed(context, requireWork(context, work.work_id), status);
+        if (memoryResult)
+            memoryResult.recordSettlement(context, link.session_id, link.id);
+        if (link && !context.db.get("SELECT 1 FROM work_sessions WHERE id = ? AND status = 'running'", [link.id]))
+            throw new AppError("work_generation_stale", "Work Session was interrupted or superseded while checks ran", 1, { work_id: id });
+        if (link && context.db.get("SELECT start_publication_status FROM work_sessions WHERE id = ?", [link.id])?.start_publication_status && !context.db.get("SELECT 1 FROM work_sessions WHERE id = ? AND start_publication_status = 'published'", [link.id]))
+            throw new AppError("work_start_publication_pending", "Finish publishing this Work's committed start packet before settlement", 1, { work_id: id, effect: "no_effect" });
+        if (context.db.run("UPDATE works SET status = ?, result = ?, completed_at = ?, updated_at = ? WHERE work_id = ? AND status = ? AND updated_at = ?", [status, result, now, now, id, work.status, work.updated_at]).changes !== 1)
+            throw new AppError("work_generation_stale", "Work changed while its result and review inputs were prepared", 1, { work_id: id });
         if (link) {
-            if (link.result_path && work.parent_work_id !== null)
-                fs.writeFileSync(link.result_path, result);
-            context.db.run("UPDATE work_sessions SET status = ?, completed_at = ?, updated_at = ? WHERE id = ?", [status, now, now, link.id]);
+            if (context.db.run("UPDATE work_sessions SET status = ?, result_receipt_json = ?, completed_at = ?, updated_at = ? WHERE id = ? AND work_id = ? AND session_id = ? AND status = 'running'", [status, resultReceipt, now, now, link.id, work.work_id, link.session_id]).changes !== 1)
+                throw new AppError("work_generation_stale", "Work Session changed or refused settlement while its result was committed", 1, { work_id: id });
             const stillRunning = context.db.get("SELECT 1 FROM work_sessions WHERE session_id = ? AND status = 'running' LIMIT 1", [link.session_id]);
             if (!stillRunning)
                 context.db.run("UPDATE sessions SET status = 'idle', updated_at = ? WHERE project_id = ? AND session_id = ?", [now, work.project_id, link.session_id]);
         }
-        context.db.exec("COMMIT");
-    }
-    catch (error) {
-        context.db.exec("ROLLBACK");
-        throw error;
-    }
+    });
+    materializePendingWorkResults(context, work.project_id, work.run_id);
+    settleRecoveryWork(context, work.work_id, status);
     refreshRunWorkProjection(context, work.project_id, work.run_id);
-    const newlyReady = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? AND status = 'created' ORDER BY created_at, work_id`, [work.project_id, work.run_id]).filter((candidate) => isReady(context, candidate)).map((candidate) => ({ work_id: candidate.work_id, start_command: workStartCommand(context, candidate) }));
+    const control = runControlDirective(context, work.project_id, work.run_id);
+    const newlyReady = control ? [] : context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? AND status = 'created' ORDER BY created_at, work_id`, [work.project_id, work.run_id]).filter((candidate) => isReady(context, candidate)).map((candidate) => ({ work_id: candidate.work_id, launch_policy: candidate.launch_policy, start_command: workStartCommand(context, candidate, { preview: true }) }));
     appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: `work_${status}`, work_id: work.work_id, session_id: link?.session_id ?? null, ...(coordinationDrift.length ? { coordination_drift: coordinationDrift } : {}) });
-    for (const ready of newlyReady)
-        appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_dependency_unblocked", work_id: ready.work_id, completed_dependency: work.work_id });
-    return { ok: true, work_id: id, status, checks: receipts, coordination: { planned_write_areas: codePacket(work)?.planned_write_areas ?? [], drift: coordinationDrift }, newly_ready: newlyReady, graph: codeWorkGraph(context, work.project_id, work.run_id), usage: { status: "provisional", reason: "final usage is controller-owned" } };
+    if (status === "completed")
+        for (const ready of newlyReady) {
+            const candidate = requireWork(context, ready.work_id);
+            if (parseDependencies(candidate).includes(work.work_id))
+                appendFlowRunTimelineEvent(context, work.project_id, work.run_id, { type: "work_dependency_unblocked", work_id: ready.work_id, completed_dependency: work.work_id });
+        }
+    return { ok: true, ...(control ? { control } : {}), work_id: id, status, checks: receipts, coordination: { planned_write_areas: codePacket(work)?.planned_write_areas ?? [], drift: coordinationDrift }, newly_ready: newlyReady, graph: codeWorkGraph(context, work.project_id, work.run_id), usage: { status: "provisional", reason: "final usage is controller-owned" } };
 }
+function recoveryPrompt(recovery) { return ["<recovery_identity>", `- recovery_id: ${recovery.recoveryId}`, `- execution_generation: ${recovery.generation}`, "This Work was interrupted and is now an authorized recovery segment of the same assignment.", "</recovery_identity>", "", "<recovery_instructions>", `Read the retained pre-interruption evidence at ${recovery.evidencePath}.`, "Before changing files or rerunning a command, inspect the workspace, receipts, logs, and partial artifacts. Do not assume the last command succeeded or failed merely because its reply was lost.", "Preserve accepted work. Do not repeat completed Work, create undeclared Work, alter the original requirements, or edit dd-flow runtime state/evidence.", "Observe an existing check or finish instead of duplicating it. Retry only through an exact runtime retry command after establishing that its prior outcome permits it.", "Record the concrete unresolved operation rather than guessing if an external effect cannot be reconciled.", "</recovery_instructions>"].join("\n"); }
 function plannedAreaDrift(packet, result) {
     const changed = JSON.parse(result).changed_paths;
     if (!Array.isArray(changed) || packet.planned_write_areas.length === 0)
         return [];
-    return changed.filter((item) => typeof item === "string" && !packet.planned_write_areas.some((area) => item === area || item.startsWith(`${area}/`)));
+    return changed.filter((item) => typeof item === "string" && !packet.planned_write_areas.some((area) => {
+        const normalized = area.replace(/[\\/]+$/, "");
+        return item === normalized || item.startsWith(`${normalized}/`);
+    }));
 }
 function bindSession(context, work, run, identity, now) {
     const priorWorkSession = context.db.get("SELECT session_id FROM work_sessions WHERE work_id = ? ORDER BY created_at DESC LIMIT 1", [work.work_id])?.session_id ?? null;
@@ -385,17 +1585,31 @@ function bindSession(context, work, run, identity, now) {
     // Work ancestry and provider-tree containment are different relations. An
     // isolated worker is logically a child Work but physically a provider root.
     const parentSession = inferredParentSession ?? identity.parentSessionId;
+    // Stored provider ancestry uses internal keys, just like hook_events.
+    // Resolve native IDs only when rendering diagnostics; changing storage here
+    // breaks existing bindings and usage ancestry joins.
     const providerParentSession = identity.parentSessionId;
+    const identityDetails = (sessionKey = identity.sessionId, parentKey = parentSession) => ({
+        internal_session_key: sessionKey,
+        native_session_id: sessionKey === identity.sessionId ? identity.nativeSessionId : context.db.get("SELECT provider_session_id FROM sessions WHERE project_id = ? AND session_id = ?", [work.project_id, sessionKey])?.provider_session_id ?? null,
+        internal_parent_session_key: parentKey,
+        native_parent_session_id: parentKey ? context.db.get("SELECT provider_session_id FROM sessions WHERE project_id = ? AND session_id = ?", [work.project_id, parentKey])?.provider_session_id ?? null : null,
+        harness: identity.harness
+    });
     if (work.parent_work_id && !parentSession)
         throw new AppError("parent_session_required", "Child Work requires a confirmed parent Work/Session link", 1, { work_id: work.work_id, parent_work_id: work.parent_work_id });
+    if (work.launch_policy === "fresh_agent_required" && inferredParentSession && identity.parentSessionId && identity.parentSessionId !== inferredParentSession)
+        throw new AppError("native_work_parent_mismatch", "Fresh native Work must be started by a direct child of its assigned parent Session", 1, { work_id: work.work_id, effect: "no_effect", ...identityDetails(), observed_provider_parent_session_key: identity.parentSessionId });
     if (work.launch_policy === "fresh_agent_required" && (identity.sessionId === parentSession || context.db.get("SELECT 1 FROM work_sessions ws JOIN works w ON w.work_id = ws.work_id WHERE w.project_id = ? AND w.run_id = ? AND ws.session_id = ? LIMIT 1", [work.project_id, work.run_id, identity.sessionId])))
-        throw new AppError("fresh_session_required", "This Work requires a fresh Session in this RUN", 1, { work_id: work.work_id, session_id: identity.sessionId });
+        throw new AppError("fresh_session_required", "This Work requires a fresh Session in this RUN", 1, { work_id: work.work_id, effect: "no_effect", recoverable: true, handoff_required: true, ...identityDetails() });
     const existing = context.db.get("SELECT session_id, parent_session_id, provider_parent_session_id FROM sessions WHERE project_id = ? AND session_id = ?", [work.project_id, identity.sessionId]);
-    if (existing && existing.parent_session_id && parentSession && existing.parent_session_id !== parentSession)
-        throw new AppError("session_parent_conflict", "Observed Session already has a different immutable parent", 1, { session_id: identity.sessionId });
+    // A reuse-allowed Work can follow another Work in this same Session. Its
+    // Work predecessor is not a new physical/logical parent of the Session.
+    if (existing && existing.parent_session_id && parentSession && parentSession !== identity.sessionId && existing.parent_session_id !== parentSession)
+        throw new AppError("session_parent_conflict", "Observed Session already has a different immutable parent", 1, { work_id: work.work_id, ...identityDetails(existing.session_id, existing.parent_session_id), conflicting_internal_parent_session_key: parentSession });
     if (existing?.provider_parent_session_id && providerParentSession && existing.provider_parent_session_id !== providerParentSession)
-        throw new AppError("provider_session_parent_conflict", "Observed provider Session already has a different immutable provider parent", 1, { session_id: identity.sessionId });
-    context.db.run(`INSERT INTO sessions (session_id, project_id, harness, provider_session_id, provider_parent_session_id, agent_id, parent_session_id, provider, model, reasoning, mode, agent_type, project_root, flow_kind, status, run_id, protocol_id, worker_id, workspace_path, continuation_policy, current_stage, next_action, last_action_hash, continuation_count, stop_reason, transcript_path, cwd, metadata_json, coverage_units_json, created_at, updated_at, stopped_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'vnext', 'active', ?, NULL, ?, ?, 'go_router', 'work', NULL, NULL, 0, NULL, ?, ?, '{}', '[]', ?, ?, NULL) ON CONFLICT(session_id, project_id) DO UPDATE SET harness = excluded.harness, provider_session_id = COALESCE(excluded.provider_session_id, provider_session_id), provider_parent_session_id = COALESCE(excluded.provider_parent_session_id, provider_parent_session_id), agent_id = COALESCE(excluded.agent_id, agent_id), parent_session_id = COALESCE(excluded.parent_session_id, parent_session_id), provider = COALESCE(excluded.provider, provider), model = COALESCE(excluded.model, model), reasoning = COALESCE(excluded.reasoning, reasoning), mode = COALESCE(excluded.mode, mode), agent_type = COALESCE(excluded.agent_type, agent_type), flow_kind = excluded.flow_kind, run_id = excluded.run_id, worker_id = excluded.worker_id, workspace_path = excluded.workspace_path, transcript_path = COALESCE(excluded.transcript_path, transcript_path), cwd = excluded.cwd, updated_at = excluded.updated_at`, [identity.sessionId, work.project_id, identity.harness, identity.providerSessionId, providerParentSession, identity.agentId, existing?.parent_session_id ?? (parentSession === identity.sessionId ? null : parentSession), identity.provider, identity.model, identity.reasoning, identity.mode, identity.agentType, run.project_root, work.run_id, work.work_id, run.workspace_root, identity.transcriptPath, run.workspace_root, now, now]);
+        throw new AppError("provider_session_parent_conflict", "Observed provider Session already has a different immutable provider parent", 1, { work_id: work.work_id, ...identityDetails(existing.session_id, existing.parent_session_id), conflicting_internal_provider_parent_session_key: providerParentSession, conflicting_native_parent_session_id: context.db.get("SELECT provider_session_id FROM sessions WHERE project_id = ? AND session_id = ?", [work.project_id, providerParentSession])?.provider_session_id ?? null });
+    context.db.run(`INSERT INTO sessions (session_id, project_id, harness, provider_session_id, provider_parent_session_id, agent_id, parent_session_id, provider, model, reasoning, mode, agent_type, project_root, flow_kind, status, run_id, protocol_id, worker_id, workspace_path, continuation_policy, current_stage, next_action, last_action_hash, continuation_count, stop_reason, transcript_path, cwd, metadata_json, coverage_units_json, created_at, updated_at, stopped_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'vnext', 'active', ?, NULL, ?, ?, 'go_router', 'work', NULL, NULL, 0, NULL, ?, ?, '{}', '[]', ?, ?, NULL) ON CONFLICT(session_id, project_id) DO UPDATE SET harness = excluded.harness, provider_session_id = COALESCE(excluded.provider_session_id, provider_session_id), provider_parent_session_id = COALESCE(excluded.provider_parent_session_id, provider_parent_session_id), agent_id = COALESCE(excluded.agent_id, agent_id), parent_session_id = COALESCE(excluded.parent_session_id, parent_session_id), provider = COALESCE(excluded.provider, provider), model = COALESCE(excluded.model, model), reasoning = COALESCE(excluded.reasoning, reasoning), mode = COALESCE(excluded.mode, mode), agent_type = COALESCE(excluded.agent_type, agent_type), flow_kind = excluded.flow_kind, run_id = excluded.run_id, worker_id = excluded.worker_id, workspace_path = excluded.workspace_path, transcript_path = COALESCE(excluded.transcript_path, transcript_path), cwd = COALESCE(excluded.cwd, sessions.cwd), updated_at = excluded.updated_at`, [identity.sessionId, work.project_id, identity.harness, identity.providerSessionId, providerParentSession, identity.agentId, existing?.parent_session_id ?? (parentSession === identity.sessionId ? null : parentSession), identity.provider, identity.model, identity.reasoning, identity.mode, identity.agentType, run.project_root, work.run_id, work.work_id, run.workspace_root, identity.transcriptPath, identity.cwd, now, now]);
     reactivateBoundSession(context, work.project_id, identity.sessionId, now);
 }
 /** Register the trusted physical Session before a paused Work moves to it. */
@@ -408,9 +1622,37 @@ export function bindSessionForResume(context, workId, identity, now) {
 function reactivateBoundSession(context, projectId, sessionId, now) {
     context.db.run("UPDATE sessions SET status = 'active', stop_reason = NULL, stopped_at = NULL, updated_at = ? WHERE project_id = ? AND session_id = ?", [now, projectId, sessionId]);
 }
+export function workResultByteLimit(context, id) {
+    const schema = requireWork(context, id).result_schema;
+    return ["dd-flow/memory-composition-work-result@1", "dd-flow/memory-review-work-result@1", "dd-flow/memory-repair-work-result@1"].includes(schema ?? "") ? 1024 * 1024 : undefined;
+}
+export function prepareWorkResult(context, id, result) {
+    try {
+        const { work, run, link } = prepareWorkSettlement(context, id, "completed", result);
+        if (work.result_schema === "dd-flow/memory-repair-work-result@1") {
+            prepareMemoryRepairWorkCompletion(context, work, result);
+            return;
+        }
+        const memoryResult = prepareRegisteredMemoryWorkResult(context, work, result);
+        if (memoryResult) {
+            if (!link)
+                throw new AppError("memory_work_result_preparation_required", "Memory Work completion requires an active Work Session", 1);
+            memoryResult.revalidate(context);
+            memoryResult.assertSettlementScope(context, link.session_id, link.id);
+            return;
+        }
+        validateWorkResult(work, result, run.project_root, run.workspace_root, requireRunHome(run), run.id, link?.result_path ?? null);
+    }
+    catch (error) {
+        prepareError(error, { work_id: id, input_sha256: sha256(result) });
+    }
+}
 function validateWorkResult(work, result, projectRoot, workspaceRoot, runHome, runId, resultPath) {
+    assertMemoryRepairWritePrepared(work);
     if (!work.result_schema)
         return;
+    if (["dd-flow/memory-composition-work-result@1", "dd-flow/memory-review-work-result@1"].includes(work.result_schema ?? ""))
+        throw new AppError("memory_work_result_preparation_required", "Memory Work completion requires admitted registered output, not a mutable schema lookup", 1);
     if (!resultPath)
         throw new AppError("runtime_missing", "Work result path is unavailable", 1, { work_id: work.work_id });
     let parsed;
@@ -420,14 +1662,7 @@ function validateWorkResult(work, result, projectRoot, workspaceRoot, runHome, r
     catch {
         throw new AppError("validation", "Work result must be JSON for its declared result schema", 2, { work_id: work.work_id, result_schema: work.result_schema });
     }
-    const candidate = `${resultPath}.candidate-${process.pid}`;
-    fs.writeFileSync(candidate, result);
-    try {
-        validateSchema({ schemaName: work.result_schema.replace(/^dd-flow\//, "").replace(/@\d+$/, ""), file: candidate, projectRoot, runId, runRoot: runHome });
-    }
-    finally {
-        fs.rmSync(candidate, { force: true });
-    }
+    validateSchema({ schemaName: work.result_schema.replace(/^dd-flow\//, "").replace(/@\d+$/, ""), file: resultPath, data: parsed, projectRoot, runId, runRoot: runHome });
     if (work.result_schema === "dd-flow/code-work-result@3")
         validateCodeWorkResult(work, parsed, workspaceRoot, runHome, runId);
     if (work.result_schema === "dd-flow/code-review-result@1")
@@ -435,8 +1670,79 @@ function validateWorkResult(work, result, projectRoot, workspaceRoot, runHome, r
     if (work.result_schema === "dd-flow/plan-review-result@1")
         validatePlanReviewResult(work, parsed, { workspaceRoot, runHome, runId });
 }
+/** Allocation is not write admission. Registered repairs must not reach a
+ * provider, claim a Session or use generic mutable-schema settlement before
+ * their private writer baseline/delta owner is integrated. The memory handler
+ * group stays unregistered during that implementation; no permissive fallback.
+ */
+function assertMemoryRepairWritePrepared(work) {
+    const payload = parsePayload(work);
+    if (work.result_schema === "dd-flow/memory-repair-work-result@1" || payload?.kind === "memory-repair" || payload?.memory_repair) {
+        throw new AppError("memory_repair_write_preparation_required", "Repair execution requires registered writer baseline and bounded delta custody", 1, { effect: "no_effect" });
+    }
+}
+/** Recognizing packet metadata never grants launch or claim authority. Every
+ * supported wave must subsequently acquire its actual private owner. */
+/** Intent presence is a conservative denial, never publication authority.
+ * Fail/cancel must not discard the physical WorkSession required to reconcile
+ * an independently reserved repair. Recheck inside the settlement writer. */
+function assertMemoryRepairTerminalFailureAllowed(context, work, status) {
+    if (status === "completed")
+        return;
+    const payload = parsePayload(work);
+    if (work.result_schema !== "dd-flow/memory-repair-work-result@1" && payload?.kind !== "memory-repair" && !payload?.memory_repair)
+        return;
+    if (context.db.get("SELECT 1 FROM audit_events WHERE project_id=? AND event_type='memory.repair_publication_intent' AND json_extract(payload_json,'$.run_id')=? AND json_extract(payload_json,'$.work_id')=? LIMIT 1", [work.project_id, work.run_id, work.work_id])) {
+        throw new AppError("memory_repair_completion_pending", "Reconcile the retained repair publication before terminal failure or cancellation", 1, { effect: "no_effect", run_id: work.run_id, work_id: work.work_id,
+            next_action: "Preserve the running physical WorkSession and exact publication bytes; reconcile through the controller." });
+    }
+}
+function memoryRepairWave(work) {
+    const payload = parsePayload(work);
+    if (work.result_schema !== "dd-flow/memory-repair-work-result@1" && payload?.kind !== "memory-repair" && !payload?.memory_repair)
+        return null;
+    const wave = payload?.memory_repair?.wave;
+    if (work.result_schema !== "dd-flow/memory-repair-work-result@1" || payload?.kind !== "memory-repair" || payload.read_only !== false || wave !== 1 && wave !== 2)
+        assertMemoryRepairWritePrepared(work);
+    return wave;
+}
+function registeredMemoryRepairWave(context, work, run) {
+    const wave = memoryRepairWave(work);
+    if (!wave)
+        return null;
+    const bundle = readFlowRunExecutionBundle(context, { projectRoot: run.project_root, runId: work.run_id });
+    if (bundle?.descriptor.descriptor.id !== "mb-init")
+        assertMemoryRepairWritePrepared(work);
+    return wave;
+}
+function prepareMemoryRepairStartOwner(context, work, run, wave) {
+    // A native child owns no external adapter environment. Its independently
+    // observed Hook CWD is still only a candidate: the copy/route owner below
+    // must admit it before any claim or filesystem projection.
+    const hookKey = context.env.DD_FLOW_MEMORY_REPAIR_HOOK_EVENT;
+    const retained = readFlowRunExecutionBundle(context, { projectRoot: run.project_root, runId: work.run_id });
+    const selectedWork = requireWork(context, work.work_id);
+    const override = parsePayload(selectedWork)?.execution_override;
+    const native = retained?.execution.work("review", override?.agent_profile_id).delegation.mode === "native";
+    const scope = { projectRoot: run.project_root, runId: work.run_id, workId: work.work_id };
+    const workspaceRoot = context.env.DD_FLOW_MEMORY_REPAIR_WORKSPACE ?? (native && hookKey
+        ? (wave === 1 ? prepareMemoryRepairDispatchFromStage : prepareMemorySecondRepairDispatchFromStage)(context, scope).copy_root : null) ?? "";
+    const input = { projectRoot: run.project_root, runId: work.run_id, workId: work.work_id, workspaceRoot };
+    const owner = wave === 1 ? prepareExternalMemoryRepairCopyFromStage(context, input) : prepareMemorySecondRepairLaunchFromStage(context, input);
+    if (owner.root() !== workspaceRoot)
+        throw new AppError("memory_repair_workspace_unbound", "Repair start must inherit its exact independently prepared private copy", 1, { effect: "no_effect" });
+    // The second-wave factory already verifies the private copy and shared
+    // sources before returning; no mutation occurs between that and this return.
+    if (wave === 1)
+        owner.revalidate(context);
+    return owner;
+}
 function validateCodeWorkResult(work, value, projectRoot, runHome, runId) {
     const result = value;
+    const changedPaths = (result.changed_paths ?? []).map((item) => normalizeWorkspacePath(projectRoot, item));
+    const ignored = ignoredWorkspacePaths(projectRoot, changedPaths);
+    if (ignored.length)
+        throw new AppError("environment_repair_not_product_change", "CODE Work must record ignored environment repair separately, not as a product changed_path", 2, { work_id: work.work_id, paths: ignored });
     if ((result.deviations?.length ?? 0) > 0 || (result.blockers?.length ?? 0) > 0)
         throw new AppError("work_contract_incomplete", "CODE Work cannot complete with unresolved deviations or blockers; fail the Work and report the contract mismatch", 2, { work_id: work.work_id, deviations: result.deviations ?? [], blockers: result.blockers ?? [] });
     const packet = codePacket(work);
@@ -455,7 +1761,7 @@ function validateCodeWorkResult(work, value, projectRoot, runHome, runId) {
             assertPortableArtifactRef(ref, { workspaceRoot: projectRoot, runHome, runId });
     }
     const documentUpdates = (packet.document_updates ?? []);
-    const changed = new Set(result.changed_paths ?? []);
+    const changed = new Set(changedPaths);
     const missingDocuments = documentUpdates.map((entry) => entry.path).filter((entry) => !changed.has(entry));
     if (missingDocuments.length)
         throw new AppError("document_update_missing", "CODE Work did not materialize every document update assigned by PLAN", 2, { work_id: work.work_id, missing_paths: missingDocuments });
@@ -466,7 +1772,7 @@ function validateCodeWorkResult(work, value, projectRoot, runHome, runId) {
     const assigned = packet.repair?.review_findings?.map((finding) => finding.finding_ref) ?? [];
     validateReviewResolutions(work.work_id, assigned, result.resolutions ?? []);
     if (assigned.length) {
-        if ((result.changed_paths?.length ?? 0) === 0)
+        if (changedPaths.length === 0)
             throw new AppError("review_repair_no_change", "Review repair must materialize a project change; a no-op cannot resolve a finding", 2, { work_id: work.work_id, findings: assigned });
         for (const resolution of result.resolutions ?? [])
             for (const ref of resolution.evidence_refs ?? [])
@@ -481,23 +1787,125 @@ export function validateReviewResolutions(workId, assigned, resolutions) {
     if (missing.length || unexpected.length || duplicate)
         throw new AppError("review_repair_incomplete", "Review repair must include exactly one resolution for each assigned finding reference", 2, { work_id: workId, missing, unexpected, duplicate });
 }
-function renderWorkerPrompt(context, work, run, dependencies) {
+function renderWorkerPrompt(context, work, run, dependencies, commands, workspaceView, reviewInput) {
+    const payload = parsePayload(work);
+    const runIndex = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id=? AND id=?", [work.project_id, work.run_id]).index_json);
+    if (runIndex.execution_bundle?.flow_id === "mb-init" && (payload?.memory_composition || payload?.kind === "memory-review" || payload?.kind === "memory-repair")) {
+        assertRunBundleSqlAuthority(context, { projectId: work.project_id, runId: work.run_id }, runIndex.execution_bundle);
+        // Memory Work owns a descriptor packet, not a missing SDLC SPECIFY or PLAN.
+        // Reviewer assignment custody is admitted before rendering and rechecked
+        // by the Work claim writer; composition settlement owns its output proof.
+        const packet = payload.memory_review ?? payload.memory_repair ?? payload.memory_composition;
+        const reviewPacket = payload.kind === "memory-review" ? packet : null;
+        if (reviewPacket && !reviewInput)
+            throw new AppError("memory_review_input_invalid", "Reviewer prompt requires independently prepared wave inputs", 1);
+        return ["<memory_work_packet>", JSON.stringify(packet, null, 2), "</memory_work_packet>", "",
+            ...(payload.memory_composition ? ["<code_check_profile_contract>",
+                "The existing CLI contract for .memory-bank/spec/engineering/code-check-profile.json is dd-flow/code-check-profile@6 (or an existing @7 runner-evidence profile). The installed project-check-profiles@1 schema is a different contract, not a prerequisite for authoring this file.",
+                "This is a shape template, not an assignment or permission to execute checks. Author this file only when your registered task requires it and its path is inside your exact write_scopes. Preserve valid existing @6/@7 bindings; do not downgrade an existing profile or invent runner-evidence contracts.",
+                "```json", JSON.stringify({ schema_id: "dd-flow/code-check-profile@6",
+                    aliases: { "@check/project-tests": "<observed explicitly requested command>" }, require_alias_for: {},
+                    mandatory_by_gate: { readiness: ["@check/project-tests"] } }, null, 2), "```",
+                "aliases maps @check/name to an actual observed, explicitly requested command; replace the placeholder before submission. require_alias_for maps guarded raw command prefixes to an existing alias and may be empty. mandatory_by_gate maps work/code/readiness/merge/release to arrays of defined aliases; explicitly requested init checks belong at readiness. Optional inputs_by_alias maps defined aliases to existing workspace-relative files/directories used by that command. Do not copy example paths, invent commands, edit package scripts, install dependencies, grant network access or select deployment checks. Profile authoring does not run checks or prove a passed receipt; VERIFY executes the selected readiness checks.",
+                "</code_check_profile_contract>", ""] : []),
+            ...(reviewPacket ? ["<frozen_review_criteria>", Buffer.from(reviewPacket.instruction.base64, "base64").toString("utf8"), "</frozen_review_criteria>", "",
+                "<registered_review_inputs>", JSON.stringify(reviewInput?.run_inputs, null, 2),
+                "Workspace references resolve inside workspace_root, including the isolated copy; RUN references resolve inside run_home. These are accepted input bytes, not permission to mutate them.", "</registered_review_inputs>", ""] : []),
+            renderWorkerPromptBody(context, work, run, dependencies, commands)].join("\n");
+    }
+    const profile = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [work.project_id, work.run_id]).index_json).execution_profile;
+    const operational = profile?.operational_contract ? renderRunOperationalContext(requireRunHome(run), profile.operational_contract.sha256, profile.operational_contract.path) : "";
+    const kind = parsePayload(work)?.kind;
+    const contextStage = codePacket(work) ? "code" : typeof kind === "string" ? kind : null;
+    const contextInput = contextStage ? profile?.stage_context_inputs?.[contextStage] : null;
+    const contextFile = contextInput ? path.join(requireRunHome(run), contextInput.path) : null;
+    const relocationReceipts = runContextRelocations(context, work.project_id, work.run_id);
+    const retainedContext = contextFile ? renderRetainedStageContext({ loaded: loadExternalStageContext({ file: contextFile, expectedSha256: contextInput.sha256, stage: contextStage }), receipts: relocationReceipts, ...(workspaceView ? { workspaceView } : {}) }) : "";
+    const body = `${operational}\n\n${retainedContext}${renderWorkerPromptBody(context, work, run, dependencies, commands)}`;
+    const matrixStage = kind === "plan-review" || kind === "code-review" ? kind : codePacket(work) ? "code" : null;
+    const matrix = matrixStage ? latestRunVerificationMatrix(context, work.project_id, work.run_id, matrixStage, kind === "plan-review" || kind === "code-review" ? "input" : undefined) : null;
+    const sources = matrix?.matrix.sources.filter(source => ["specify", "protocolize", "protocolize_report"].includes(source.role)) ?? [];
+    return ["<accepted_decision_precedence>", `Read ${path.join(requireRunHome(run), "01-specify", "specify.json")} and later accepted RUN decisions relevant to this Work.`, ...sources.map(source => `Accepted ${source.role}: ${path.join(source.root === "run" ? requireRunHome(run) : run.workspace_root, source.path)} (sha256 ${source.sha256}). PROTOCOLIZE includes the effective amendments; preserve SPECIFY non-goals.`), acceptedDecisionPrecedence, "</accepted_decision_precedence>", "", body, verificationMatrixInstruction(matrix?.metadata ?? null, requireRunHome(run), `assigned Work ${work.work_id}`)].join("\n");
+}
+function workerLifecycleCommands(context, work, run, freshWorkAttempt = false) {
+    const resultInputPath = path.join(requireRunHome(run), "works", work.work_id, "result-input.json");
+    return {
+        finish: managedLifecycleCommand(context, runtimeCommand(context, ["work", "finish", work.work_id, "--result-file", resultInputPath, "--project-root", run.project_root, "--json", "--progress-jsonl"]), { freshWorkAttempt }),
+        fail: managedLifecycleCommand(context, runtimeCommand(context, ["work", "fail", shortWorkId(work.work_id), "--reason", "receipt path + exact external or semantic blocker", "--project-root", run.project_root, "--json"]), { freshWorkAttempt })
+    };
+}
+function renderWorkerPromptBody(context, work, run, dependencies, commands) {
     const command = flowCommand(context);
     const packet = codePacket(work);
+    const readOnly = parsePayload(work)?.read_only === true;
+    const resultInputPath = path.join(requireRunHome(run), "works", work.work_id, "result-input.json");
+    const lifecycleCommands = commands ?? workerLifecycleCommands(context, work, run);
+    const finishWorkCommand = lifecycleCommands.finish;
+    const failWorkCommand = lifecycleCommands.fail;
     const mergeWork = parsePayload(work)?.kind === "merge";
-    const writeBoundary = mergeWork
-        ? ["MERGE does not own product-code repair. Use only the stage packet's merge apply command; resolve only paths that Git reports as unmerged. Do not edit integration code, tests, documentation or configuration to make a gate pass.", "RUN artifacts are read-only evidence: refer to them with run:// URIs and let dd-flow persist your submitted result."]
-        : [`HARD RULE: project source reads and writes must remain under ${run.workspace_root}.`, "Do not write through project_root, outside workspace_root, into another RUN, or into Git/worktree control data. Do not create, switch, merge or delete branches/worktrees.", "RUN artifacts are read-only evidence: refer to them with run:// URIs and let dd-flow persist your submitted result. Accepted requirements, non-goals and stop_conditions are semantic hard boundaries. planned_write_areas is not."];
-    const completionRepair = mergeWork
-        ? ["A failed integration check is evidence for a source-repair cycle, not permission to repair the integration workspace. Follow the exact merge repair command returned by dd-flow."]
-        : ["Read the failed receipt and its stdout/stderr. Fix project-owned source, migration, test, formatting, or configuration errors in this same Work, then call Finish again. Do not invent a cause that does not appear in the retained output."];
+    const repairPacket = parsePayload(work)?.kind === "memory-repair" ? parsePayload(work)?.memory_repair : null;
+    const writeBoundary = readOnly
+        ? [`Review inputs under workspace_root (${run.workspace_root}) and run_home are read-only. Use workspace_root for Work start and project evidence reads. Finish/Fail use explicit owned paths and may run from RUN home. Do not edit project source, PLAN, aspect maps, CODE evidence, or another Work's files.`, "Do not write inside workspace_root, including an isolated review copy. Write only this Work's declared result-input.json and explicitly assigned Work-owned evidence paths under run_home. Report changed or inaccessible review inputs as a blocker; do not repair them."]
+        : repairPacket
+            ? [`Work only inside the registered private workspace_root (${run.workspace_root}). Edit only these exact MB paths: ${JSON.stringify(repairPacket.write_paths)}. This is a hard allowlist, not a coordination hint.`,
+                "Do not write through project_root or shared checkout paths. Do not edit canonical dd-flow/mbb, environment files, Git/worktree data, non-MB source, another Work or any other RUN. Do not install tools, commit, merge, or publish your changes; the CLI owns publication and integration.",
+                "Workspace evidence resolves inside this private copy. RUN evidence is read-only. Write only this Work's result-input.json and assigned Work-owned evidence under run_home; neither a result JSON nor a private edit proves accepted publication or finding closure."]
+            : mergeWork
+                ? ["MERGE does not own product-code repair. Use only the stage packet's merge apply command; resolve only paths that Git reports as unmerged. Do not edit integration code, tests, documentation or configuration to make a gate pass.", "RUN artifacts are read-only evidence: refer to them with run:// URIs and let dd-flow persist your submitted result."]
+                : [`HARD RULE: project source reads and writes must remain under ${run.workspace_root}.`, "Do not write through project_root, outside workspace_root, into another RUN, or into Git/worktree control data. Do not create, switch, merge or delete branches/worktrees.", "RUN artifacts are read-only evidence: refer to them with run:// URIs and let dd-flow persist your submitted result. Accepted requirements, non-goals and stop_conditions are semantic hard boundaries. planned_write_areas is not."];
+    const completionRepair = readOnly
+        ? ["If Finish reports input drift or an infrastructure failure, report the exact receipt and stop. Do not change the reviewed files to make the check pass."]
+        : repairPacket
+            ? ["On input drift, custody loss or publication/infrastructure failure, retain the exact receipt and stop. Do not edit shared files, reconstruct authority, change unassigned paths, or retry by starting another Session. A needed path outside write_paths is an assignment conflict, not permission to widen the repair."]
+            : mergeWork
+                ? ["A failed integration check is evidence for a source-repair cycle, not permission to repair the integration workspace. Follow the exact merge repair command returned by dd-flow."]
+                : ["Read the failed receipt and its stdout/stderr. Fix project-owned source, migration, test, formatting, or configuration errors in this same Work, then use the returned retry_command with your result. Internal invocation IDs are runtime-owned; do not copy or invent them. Do not invent a cause that does not appear in the retained output."];
     const codeContext = packet ? ["<semantic_spine>", JSON.stringify(packet.semantic_spine, null, 2), "</semantic_spine>", "", ...(packet.repair ? ["<repair_context>", JSON.stringify(packet.repair, null, 2), "Read the failed receipt and its linked stdout/stderr before editing. Preserve the accepted origin context and fix only the evidenced failure.", "</repair_context>", ""] : []), "<accepted_requirements>", JSON.stringify(packet.requirements, null, 2), "</accepted_requirements>", "", "<write_boundary_invariant>", "For a mutation guarded by membership, ownership, authorization or parent lifecycle state, preserve that predicate in the write statement or make guard and write one explicit transaction with the needed lock. A prior read may diagnose an error but never proves a later write remains allowed. Apply this to create, update, delete and parent-state mutations.", "</write_boundary_invariant>", "", "<acceptance_context>", "The criteria below are end-to-end context. Complete this Work's semantic contribution and declared checks; another ordered Work may own a different acceptance surface.", JSON.stringify(packet.acceptance, null, 2), "</acceptance_context>", "", "<required_read>", "These are mandatory starting sources, not a read allowlist. Read any additional project files needed to implement the Work correctly.", ...packet.required_read.map((item) => `- ${resolveRunReferences(item, work.run_id, requireRunHome(run))}`), "</required_read>", "", "<discovery_boundary>", "These are likely discovery areas, not a hard boundary. Expand project-local investigation when required and report material additions.", ...packet.discovery_boundary.map((item) => `- ${item}`), "</discovery_boundary>", "", "<planned_write_areas>", "SOFT COORDINATION HINT ONLY. These paths help the coordinator avoid concurrent collisions. They do not grant or deny write permission and do not limit the files needed for this Work. You may create or change any project file under workspace_root that is necessary and in semantic scope; report every actual changed path.", ...(packet.planned_write_areas.length ? packet.planned_write_areas.map((item) => `- ${item}`) : ["- none predicted; derive the necessary files from the task"]), "</planned_write_areas>", "", ...(packet.provides_checks.length ? ["<provided_checks>", ...packet.provides_checks.map((item) => `- ${item.id}: materialize ${item.command}${item.definition ? ` as ${item.definition}` : ""}; it is not usable until this Work finishes.`), "Update the declared project command or alias before Work finish. The CLI verifies materialization at Work finish. Execution occurs at its declared run_at gate, not necessarily in this Work.", "</provided_checks>", ""] : []), "<verification>", ...packet.checks.map((item) => `- ${item.id} at ${item.run_at}: ${item.command} — ${item.purpose}`), "The CLI executes work-scoped checks and retains their receipts. Report semantic evidence only; do not rerun declared checks manually.", "</verification>", "", "<stop_conditions>", ...packet.stop_conditions.map((item) => `- ${item}`), "</stop_conditions>", ""] : [];
     if (packet)
         codeContext.push("<document_updates>", JSON.stringify(packet.document_updates, null, 2), "Materialize every listed update. dd-flow verifies the resulting file against its PLAN-time baseline.", "</document_updates>", "", "<completion_contract>", "Successful completion requires empty deviations and blockers and every assigned document update in changed_paths. A necessary path outside planned_write_areas is normal coordination drift, not a blocker; include it in changed_paths and continue.", "</completion_contract>", "");
-    return ["<work>", `- work_id: ${work.work_id}`, `- run_id: ${work.run_id}`, `- project_root: ${run.project_root}`, `- workspace_root: ${run.workspace_root}`, `- run_home: ${requireRunHome(run)}`, "</work>", "", "<hard_write_boundary>", ...writeBoundary, "</hard_write_boundary>", "", ...codeContext, "<dependency_results>", JSON.stringify(dependencies.filter(Boolean), null, 2), "</dependency_results>", "", "<task>", resolveRunReferences(work.task, work.run_id, requireRunHome(run)), "</task>", "", ...(work.result_schema ? ["<result_contract>", `Return JSON matching \`${work.result_schema}\`.`, ...resultSchemaGuidance(work, run.id), "Do not create result.json yourself. Send the JSON to dd-flow on stdin; it atomically validates and stores the canonical receipt.", "</result_contract>", ""] : []), "<completion>", "Work finish runs only declared run_at=work checks. Stage finish owns readiness/code/merge gates; successful Work completion does not mean those gates have passed. A failed receipt means only that the check failed; it is not proof of an engine, harness, dependency, or environment blocker.", ...completionRepair, "Use Fail only for a concrete external blocker after deterministic bootstrap or a contradiction with an accepted requirement/non-goal. Never fail merely because a necessary project path was absent from planned_write_areas.", "Finish may run for several minutes. Preserve the shell tool's process/session handle and poll that same invocation until it exits; progress arrives as JSONL on stderr. Never reissue Finish merely because final stdout has not arrived.", `Finish as one standalone command, piping your JSON object to stdin: ${command} work finish ${work.work_id} --result-stdin --project-root ${JSON.stringify(run.project_root)} --json --progress-jsonl`, `Fail only for an evidenced external or semantic-contract blocker: ${command} work fail ${work.work_id} --reason "receipt path + exact external or semantic blocker" --project-root ${JSON.stringify(run.project_root)} --json`, "</completion>", ""].join("\n");
+    if (packet)
+        codeContext.push("<temporary_services>", "Prefer the declared check launcher: it already owns check resources. If the planned scenario genuinely requires an interactive HTTP service, use the managed supervisor below. This is a template: replace the project service command, port names and readiness path from the plan/project instructions; do not invent a fixed port.", `${command} runtime process start --run ${run.id} --project-root ${JSON.stringify(run.project_root)} --command '<project-service-command>' --ports api --ready-port api --ready-path /health --json --progress-jsonl`, "The service receives DD_FLOW_PORT_API (and equivalent variables for all declared names). The command stays running as its supervisor. Retain its tool handle; wait for the service ready event and read its service.json receipt. Pass those exact ports and the same project environment to reset/seed, API and browser operations.", "A ready receipt proves service readiness only. Record the scenario outcome and real evidence separately. After the scenario, execute the exact stop_command from that receipt, then wait for the supervisor to exit. Never use pkill/killall or stop a sibling's process. If cleanup fails, retain the process id and report the failure; do not claim the resource is free.", "</temporary_services>", "");
+    return ["<work>", `- work_id: ${work.work_id}`, `- run_id: ${work.run_id}`, `- project_root: ${run.project_root}`, `- workspace_root: ${run.workspace_root}`, `- run_home: ${requireRunHome(run)}`, "</work>", "", "<cli_context>", `- Work commands use the short ID ${shortWorkId(work.work_id)}; dd-flow binds it to this RUN.`, `- @project = ${run.project_root}`, `- @workspace = ${run.workspace_root}`, `- @run = ${requireRunHome(run)}`, "- @ aliases are accepted only by declared dd-flow path parameters. Copy the quoted alias literally; do not add backslashes. Shell tools such as cat and rg require ordinary paths relative to cwd or absolute paths.", "- Lifecycle invocation IDs are internal runtime authority and are intentionally omitted from commands.", "</cli_context>", "", "<hard_write_boundary>", ...writeBoundary, "</hard_write_boundary>", "", ...codeContext, "<dependency_results>", JSON.stringify(dependencies.filter(Boolean), null, 2), "</dependency_results>", "", "<task>", resolveRunReferences(work.task, work.run_id, requireRunHome(run)), "</task>", "", ...(work.result_schema ? ["<result_contract>", `Return JSON matching \`${work.result_schema}\`.`, ...resultSchemaGuidance(work, run.id), `Write the completed JSON to ${resultInputPath}. This is an attempt input, not the canonical result.json receipt. dd-flow validates the file and atomically stores the canonical receipt.`, "</result_contract>", ""] : []), "<completion>", repairPacket ? "Repair Finish validates and publishes the exact private delta before Work settlement. Independent re-review, correction checks and Stage/RUN acceptance remain separate obligations." : packet?.repair?.verification_check_refs?.length ? "Work finish runs its normal work-scoped checks plus the listed causal repair checks. Their original run_at remains an aggregate obligation; this is the additional proof required before accepting this repair." : "Work finish runs only declared run_at=work checks. Stage finish owns readiness/code/merge gates; successful Work completion does not mean those gates have passed.", "A failed receipt means only that the check failed; it is not proof of an engine, harness, dependency, or environment blocker.", ...completionRepair, ...(repairPacket ? [] : [lifecycleRetryInstruction]), repairPacket ? "Use Fail for an evidenced external blocker or assignment conflict, including any required edit outside the exact write_paths allowlist. Never expand that allowlist or edit the shared checkout." : "Use Fail only for a concrete external blocker after deterministic bootstrap or a contradiction with an accepted requirement/non-goal. Never fail merely because a necessary project path was absent from planned_write_areas.", "Finish may run for several minutes. Preserve the shell tool's process/session handle and poll that same invocation until it exits; progress arrives as JSONL on stderr. Never reissue Finish merely because final stdout has not arrived.", `First write only the result JSON to ${resultInputPath}. Then run this standalone command:\n${finishWorkCommand}`, `Fail only for an evidenced external or semantic-contract blocker: ${failWorkCommand}`, "</completion>", ""].join("\n");
 }
 export function resultSchemaGuidance(work, runId) {
     const schema = work.result_schema;
+    if (schema === "dd-flow/memory-composition-work-result@1") {
+        const packet = parsePayload(work)?.memory_composition;
+        if (!packet || typeof packet.packet_sha256 !== "string" || !Array.isArray(packet.unit_ids) || !packet.unit_ids.length
+            || packet.unit_ids.some(id => typeof id !== "string" || !id) || !Array.isArray(packet.write_scopes) || !packet.write_scopes.length
+            || packet.write_scopes.some(scope => !scope || !["workspace", "run"].includes(scope.root) || typeof scope.path !== "string" || !scope.path))
+            throw new AppError("memory_composition_input_invalid", "Composition result guidance requires its registered assignment", 1);
+        const { packet_sha256 } = packet;
+        const scope = packet.write_scopes[0];
+        return ["This is a shape template, not a completed result. Return only JSON with the fields shown; do not add agent metadata, evidence, findings or changed_paths. Keep the assigned run_id, work_id and packet_sha256 unchanged and include every assigned unit exactly once.",
+            `Exact write_scopes: ${JSON.stringify(packet.write_scopes)}. Each unit needs a summary and nonempty artifacts with exactly root, path and sha256. Artifact root is workspace or run; path is relative to that root and must name an actual regular output file within an assigned write_scope. Compute sha256 from its current bytes. Replace the example path when it names a directory, and replace the zero hash; never invent output hashes or cite the old bootstrap template as current output.`,
+            "Use accepted only after completing the assigned documents. For an evidenced blocker, retain the evidence and use the assigned Fail command, not a blocked result with Finish. Work settlement does not accept Stage/RUN or independent review.",
+            "```json", JSON.stringify({ schema_id: schema, run_id: runId, work_id: work.work_id, packet_sha256, outcome: "accepted", summary: "Describe the actual completed documents.",
+                units: packet.unit_ids.map(id => ({ id, summary: "Describe this unit's actual output.", artifacts: [{ root: scope.root, path: scope.path === "." ? "replace-with-assigned-output.md" : scope.path, sha256: "0".repeat(64) }] })) }, null, 2), "```"];
+    }
+    if (schema === "dd-flow/memory-repair-work-result@1") {
+        const packet = parsePayload(work)?.memory_repair;
+        if (!packet || typeof packet.packet_sha256 !== "string" || !Array.isArray(packet.write_paths) || !Array.isArray(packet.findings))
+            throw new AppError("memory_repair_input_invalid", "Repair guidance requires its registered packet", 1);
+        return ["This is a shape template, not a completed repair. Return only JSON matching the frozen schema. Use accepted only with a nonempty exact physical create/update/delete delta and one causal resolution for every assigned finding. Only registered write_paths may change. before_sha256 comes from the original registered start view; after_sha256 comes from the actual private output bytes; null means absent or deleted. Never invent hashes, paths, findings, source refs or completion.",
+            `Assigned finding ids: ${JSON.stringify(packet.findings.map(finding => finding.id))}. Exact write_paths: ${JSON.stringify(packet.write_paths)}.`,
+            "Each resolution needs finding_id, summary, nonempty delta_paths and nonempty evidence with exact root/path/sha256. A surviving changed output must be cited with its after hash. A deletion-only resolution needs registered retained RUN evidence. Unchanged evidence must match registered input hashes. Accepted does not claim independent re-review or closure.",
+            "Use blocked only when the MB copy is unchanged and changes/resolutions are empty. If a blocker occurs after edits, preserve the private partial outcome and use Fail; do not conceal those edits as a clean blocked result or mutate shared files.",
+            "Repair completion is publication, not the generic CODE check/retry path. Submit only an accepted private result to the assigned managed work finish command. The CLI independently verifies your bounded UTF-8 result (maximum 1 MiB), exact original start/delta and current publication custody, reserves or restores publication, applies its finite retained plan, then settles Work. Do not run memory repair publication-* commands manually or use --retry-check. Successful Work settlement does not close findings, accept independent re-review, or finish Stage/RUN.",
+            "For a clean blocked result, retain its evidence and use the assigned managed Fail command with the concrete reason; do not submit blocked to Finish. Before any publication attempt, an evidenced blocker after private edits also uses Fail while preserving those private bytes. Once Finish reports partial, unknown, memory_repair_publication_pending or memory_repair_completion_pending, do not use Fail, replace result bytes, reissue Finish, or start another Session: retain the exact operation/WorkSession/receipt and await controller reconciliation. A pending publication is not a new semantic blocker.",
+            "Poll the original Finish tool handle until terminal. A missing reply, timeout or observation failure is not permission to repeat the command. Resume only through the controller's exact retained-invocation recovery assignment; never invent invocation IDs, adopt today's shared bytes as a new baseline, or treat generic check-retry guidance as repair-publication recovery.",
+            "```json", JSON.stringify({ schema_id: schema, run_id: runId, work_id: work.work_id, packet_sha256: packet.packet_sha256,
+                wave: packet.wave, outcome: "blocked", summary: "Replace with the concrete evidenced outcome.", changes: [], resolutions: [] }, null, 2), "```"];
+    }
+    if (schema === "dd-flow/memory-review-work-result@1") {
+        const packet = parsePayload(work)?.memory_review;
+        if (!packet?.unit || typeof packet.unit.id !== "string" || typeof packet.packet_sha256 !== "string")
+            throw new AppError("memory_review_input_invalid", "Reviewer result guidance requires its registered assignment", 1);
+        return ["The template below is not a completed review. Replace the summary with an evidence-backed assessment and choose accepted, needs_repair or blocked. Populate assessment evidence with nonempty exact root/path/sha256 references from the registered wave inputs, including an assigned unit output and, when present, an assigned baseline source; project sources use the registered workspace alias. Findings require the assigned unit_id, a concrete problem, minor/major/critical severity and nonempty exact registered references. A material finding cannot accompany accepted. Choose needs_repair only when reporting a major or critical finding. Do not claim another unit or invent references.",
+            "```json", JSON.stringify({ schema_id: schema, run_id: runId, work_id: work.work_id,
+                packet_sha256: packet.packet_sha256, unit_id: packet.unit.id, wave: packet.wave,
+                outcome: "accepted", summary: "Replace with the actual independent assessment.", evidence: [], findings: [] }, null, 2), "```"];
+    }
     const refs = `Evidence refs for project source are relative to workspace_root; RUN evidence uses run://${runId}/path/to/artifact.`;
     if (schema === "dd-flow/code-work-result@3") {
         const packet = codePacket(work);
@@ -514,11 +1922,17 @@ export function resultSchemaGuidance(work, runId) {
             "Each evidence entry has exactly obligation_ref (one assigned ref) and refs (nonempty list of existing evidence paths). Each resolution has finding_ref, summary and nonempty evidence_refs. Do not invent file names or finding ids."];
     }
     if (schema === "dd-flow/code-review-result@1") {
-        return [refs, "Assess every assigned aspect exactly once. Number findings locally inside this reviewer Work as FIND-001, FIND-002, ...; dd-flow adds the Work id to form the canonical reference.", "This is a shape template: replace labels with assigned ids and observed verdicts, fill evidence_refs using existing files from the task packet, and remove findings when none exist. Report only material, direct-evidence findings; taste and cosmetics are not findings:", "```json", JSON.stringify({ schema_id: schema, verdict: "pass | findings | blocked", summary: "Concise evidence-backed conclusion.", aspects: [{ aspect_id: "assigned_aspect_id", verdict: "pass | findings | blocked", summary: "Conclusion.", evidence_refs: [] }], findings: [{ finding_id: "FIND-001", aspect_id: "assigned_aspect_id", priority: "p0 | p1 | p2 | p3", problem: "Violated obligation or rule.", impact: "Concrete risk or failure.", required_outcome: "Smallest observable result that closes the defect.", evidence_refs: ["path/to/file"], obligation_refs: ["R-001 | AC-001 | policy ref"] }] }, null, 2), "```"];
+        const aspect = { aspect_id: "assigned_aspect_id", verdict: "pass", summary: "Conclusion.", evidence_refs: ["path/to/evidence"] };
+        const clean = { schema_id: schema, verdict: "pass", summary: "Concise evidence-backed conclusion.", aspects: [aspect], findings: [] };
+        const mixed = { ...clean, verdict: "findings", aspects: [aspect, { ...aspect, aspect_id: "another_assigned_aspect_id", verdict: "findings" }], findings: [{ finding_id: "FIND-001", aspect_id: "another_assigned_aspect_id", priority: "p1", problem: "Describe the evidenced defect.", impact: "Describe its material impact.", required_outcome: "Describe the required correction.", evidence_refs: ["path/to/evidence"], obligation_refs: ["assigned_obligation_ref"] }] };
+        return [refs, "Assess every assigned aspect exactly once. Number findings locally inside this reviewer Work as FIND-001, FIND-002, ...; dd-flow adds the Work id to form the canonical reference.", "Examples below show no findings and mixed aspect outcomes, not completed results. Replace placeholder ids and paths with assigned aspects, obligations and existing evidence. Choose verdict pass, findings or blocked. Keep findings: [] when none exist. Report only material, direct-evidence defects, not taste or cosmetics.", "```json", JSON.stringify(clean, null, 2), "```", "```json", JSON.stringify(mixed, null, 2), "```"];
     }
     if (schema !== "dd-flow/plan-review-result@1")
         return [];
-    return [refs, "This is a shape template: replace labels with assigned ids and observed verdicts, fill evidence_refs using existing files from the task packet, and remove findings when none exist. Do not add fields. Number findings locally inside this reviewer Work as FIND-001, FIND-002, ...; dd-flow adds the Work id when the coordinator classifies them:", "```json", JSON.stringify({ schema_id: schema, plan_revision: 1, overall_verdict: "pass | watch | needs_changes | blocked", summary: "Concise evidence-backed conclusion.", aspects: [{ aspect_id: "assigned_aspect_id", verdict: "pass | watch | needs_changes | blocked", summary: "Conclusion for this aspect.", evidence_refs: [], findings: [{ finding_id: "FIND-001", severity: "high | medium | low | info", summary: "Problem, if any.", evidence_refs: ["path/to/file"] }] }] }, null, 2), "```"];
+    const aspect = { aspect_id: "assigned_aspect_id", verdict: "pass", summary: "Conclusion for this aspect.", evidence_refs: ["path/to/evidence"], findings: [] };
+    const clean = { schema_id: schema, plan_revision: 1, overall_verdict: "pass", summary: "Concise evidence-backed conclusion.", aspects: [aspect] };
+    const mixed = { ...clean, overall_verdict: "needs_changes", aspects: [aspect, { ...aspect, aspect_id: "another_assigned_aspect_id", verdict: "needs_changes", findings: [{ finding_id: "FIND-001", severity: "high", summary: "Describe the evidenced defect.", evidence_refs: ["path/to/evidence"] }] }] };
+    return [refs, "Examples below show no findings and mixed aspect outcomes, not completed results. Assess each assigned aspect once, replace placeholder ids, plan_revision and paths with packet values and existing evidence. Choose verdict pass, watch, needs_changes or blocked. Keep findings: [] when an aspect has no findings. Do not add fields. Number findings locally as FIND-001, FIND-002, ...; dd-flow adds the Work id when the coordinator classifies them.", "```json", JSON.stringify(clean, null, 2), "```", "```json", JSON.stringify(mixed, null, 2), "```"];
 }
 export function validateCodeReviewResultIdentity(work, value) {
     const group = codeReviewGroup(work);
@@ -547,6 +1961,7 @@ export function validateCodeReviewResultIdentity(work, value) {
 function validateCodeReviewResult(work, value, input) {
     validateCodeReviewResultIdentity(work, value);
     const result = value;
+    assertReviewAspectEvidence(work, result.aspects ?? [], "CODE");
     const findings = result.findings ?? [];
     // A reviewer is a child Work and cannot pause its coordinator-owned Stage.
     // Its structured blocked result is evidence for the coordinator, which then
@@ -576,6 +1991,7 @@ export function validatePlanReviewResult(work, value, input) {
     const unexpected = ids.filter((id) => !expected.has(id));
     if (new Set(ids).size !== ids.length || missing.length || unexpected.length)
         throw new AppError("review_evidence_invalid", "PLAN reviewer result must assess every assigned aspect exactly once", 2, { work_id: work.work_id, group: group.key, missing, unexpected });
+    assertReviewAspectEvidence(work, aspects, "PLAN");
     const findingIds = aspects.flatMap((aspect) => aspect.findings ?? []).map((finding) => finding.finding_id ?? "");
     const invalid = findingIds.filter((id) => !/^FIND-\d{3}$/.test(id));
     if (new Set(findingIds).size !== findingIds.length || invalid.length)
@@ -590,6 +2006,11 @@ export function validatePlanReviewResult(work, value, input) {
         assertPortableArtifactRef(ref, input);
     }
 }
+function assertReviewAspectEvidence(work, aspects, stage) {
+    const missing = aspects.filter((aspect) => !Array.isArray(aspect.evidence_refs) || aspect.evidence_refs.length === 0).map((aspect) => aspect.aspect_id ?? "");
+    if (missing.length)
+        throw new AppError("review_evidence_invalid", `${stage} reviewer result requires non-empty evidence_refs for every assigned aspect`, 2, { work_id: work.work_id, missing_aspects: missing });
+}
 function codeReviewGroup(work) {
     const payload = parsePayload(work);
     const group = payload?.group;
@@ -600,10 +2021,14 @@ function codeReviewGroup(work) {
         ? { key: value.key, aspect_ids: value.aspect_ids }
         : null;
 }
-function requireWork(context, id) { ensureWorkRegistry(context); const exact = context.db.get(`SELECT ${workColumns} FROM works WHERE work_id = ?`, [id]); if (exact)
-    return exact; if (!/^WRK-\d{3,}$/.test(id))
-    throw new AppError("not_found", "Work is not registered", 1, { work_id: id }); const matches = context.db.all(`SELECT ${workColumns} FROM works WHERE work_id LIKE ? ORDER BY work_id`, [`${id}-%`]); if (matches.length !== 1)
-    throw new AppError(matches.length ? "ambiguous_work_alias" : "not_found", matches.length ? "Short Work alias is ambiguous" : "Work is not registered", 1, { work_id: id, matches: matches.map((work) => work.work_id) }); return matches[0]; }
+function requireWork(context, id, explicitScope) {
+    ensureWorkRegistry(context);
+    const configured = context.env.DD_FLOW_INVOCATION_SCOPE;
+    const scope = configured ? JSON.parse(configured) : undefined;
+    const projectId = explicitScope?.projectId ?? (scope?.projectRoot ? context.db.get("SELECT id FROM projects WHERE root = ?", [scope.projectRoot])?.id : undefined);
+    const runId = explicitScope?.runId ?? scope?.runId;
+    return resolveWorkReference(context, id, { projectId, runId });
+}
 function requireRun(context, projectId, runId) { const run = context.db.get("SELECT r.id, r.run_root, r.workspace_root, p.root AS project_root FROM runs r JOIN projects p ON p.id = r.project_id WHERE r.project_id = ? AND r.id = ?", [projectId, runId]); if (!run?.run_root)
     throw new AppError("runtime_missing", "RUN artifact root is unavailable", 1, { run_id: runId }); return run; }
 function requireRunHome(run) { if (!run.run_root)
@@ -645,18 +2070,20 @@ function validateItem(value, requireExecutionContext = false) { if (!value || ty
     throw new AppError("validation", "result_schema must be a non-empty schema id", 2); const payload = code ? item : (item.payload && typeof item.payload === "object" && !Array.isArray(item.payload) ? item.payload : undefined); return { key: item.key, task: item.task, ...(Array.isArray(item.depends_on) ? { depends_on: item.depends_on } : {}), ...(typeof item.parent === "string" ? { parent: item.parent } : {}), ...(typeof item.launch_policy === "string" ? { launch_policy: item.launch_policy } : {}), ...(typeof item.result_schema === "string" ? { result_schema: item.result_schema } : {}), ...(payload ? { payload } : {}) }; }
 function allowsEmptyRepairChecks(item) { const repair = item.repair; if (!repair || typeof repair !== "object" || Array.isArray(repair))
     return false; const value = repair; return typeof value.check_receipt_id === "string" || (Array.isArray(value.review_findings) && value.review_findings.some((finding) => typeof finding === "object" && finding !== null && Array.isArray(finding.check_refs) && finding.check_refs.some((ref) => typeof ref === "string"))) || (Array.isArray(value.semantic_unresolved) && value.semantic_unresolved.some((item) => typeof item === "string")); }
-function readJson(file) { try {
-    return JSON.parse(fs.readFileSync(path.resolve(file), "utf8"));
+export function refreshRunWorkProjection(context, projectId, runId) {
+    refreshRunSessionProjection(context, projectId, runId);
+    scheduleObsoleteWorkProjectionCleanup(context, projectId, runId);
 }
-catch (error) {
-    throw new AppError("validation", `Invalid JSON file: ${String(error)}`, 2, { file });
-} }
-export function refreshRunWorkProjection(context, projectId, runId) { refreshRunSessionProjection(context, projectId, runId); const run = context.db.get("SELECT run_root FROM runs WHERE project_id = ? AND id = ?", [projectId, runId]); if (run?.run_root) {
-    const obsolete = path.join(run.run_root, "work.json");
-    if (fs.existsSync(obsolete))
-        fs.rmSync(obsolete);
-} }
-export function codeWorkGraph(context, projectId, runId) { const works = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? ORDER BY created_at, work_id`, [projectId, runId]).filter((work) => Boolean(codePacket(work))); const ready = works.filter((work) => isReady(context, work)); return { total: works.length, created: works.filter((work) => work.status === "created").length, running: works.filter((work) => work.status === "running").length, completed: works.filter((work) => work.status === "completed").length, failed: works.filter((work) => work.status === "failed").length, ready: ready.map((work) => ({ work_id: work.work_id, task: work.task, start_command: workStartCommand(context, work) })), blocked: works.filter((work) => work.status === "created" && !ready.includes(work)).map((work) => ({ work_id: work.work_id, depends_on: parseDependencies(work) })) }; }
+function scheduleObsoleteWorkProjectionCleanup(context, projectId, runId) {
+    const run = context.db.get("SELECT run_root FROM runs WHERE project_id = ? AND id = ?", [projectId, runId]);
+    if (run?.run_root) {
+        const obsolete = path.join(run.run_root, "work.json");
+        // A failed allocation/settlement must not remove a pre-existing projection.
+        // Like publication, filesystem cleanup belongs after the outer SQL commit.
+        context.db.afterCommit(() => fs.rmSync(obsolete, { force: true }));
+    }
+}
+export function codeWorkGraph(context, projectId, runId) { const index = JSON.parse(context.db.get("SELECT index_json FROM runs WHERE project_id = ? AND id = ?", [projectId, runId])?.index_json ?? "{}"); const active = index.stage_runs?.some(item => item.stage === "code-review" && item.status === "running") ? "code-review" : "code"; const members = index.stage_runs?.length ? stageWorkIds(context, projectId, runId, active) : null; const works = context.db.all(`SELECT ${workColumns} FROM works WHERE project_id = ? AND run_id = ? ORDER BY created_at, work_id`, [projectId, runId]).filter((work) => Boolean(codePacket(work)) && (!members || members.has(work.work_id))); const ready = works.filter((work) => isReady(context, work)); return { total: works.length, created: works.filter((work) => work.status === "created").length, running: works.filter((work) => work.status === "running").length, completed: works.filter((work) => work.status === "completed").length, failed: works.filter((work) => work.status === "failed").length, ready: ready.map((work) => ({ work_id: work.work_id, task: work.task, launch_policy: work.launch_policy, start_command: workStartCommand(context, work, { preview: true }) })), blocked: works.filter((work) => work.status === "created" && !ready.includes(work)).map((work) => ({ work_id: work.work_id, depends_on: parseDependencies(work) })) }; }
 function parsePayload(work) { if (!work.payload_json)
     return null; try {
     const value = JSON.parse(work.payload_json);
@@ -665,6 +2092,7 @@ function parsePayload(work) { if (!work.payload_json)
 catch {
     return null;
 } }
+function uniqueChecks(checks) { return checks.filter((check, index) => checks.findIndex((candidate) => candidate.id === check.id) === index); }
 function codePacket(work) { const value = parsePayload(work); if (value?.schema_id !== "dd-flow/code-work-packet@5")
     return null; return value; }
 function assertNoCycles(nodes) { const local = new Map(nodes.map((node) => [node.id, node.dependencies.filter((dependency) => nodes.some((candidate) => candidate.id === dependency))])); const active = new Set(); const done = new Set(); const visit = (id) => { if (active.has(id))