@openrig/cli 0.5.9 → 0.5.11

package/daemon/dist/domain/workflow-human-destination.js

@@ -0,0 +1,40 @@
+import { loadHumanRegistry, resolveRegisteredHumanAddress } from "./gateway/human-registry.js";
+import { SettingsStore } from "./user-settings/settings-store.js";
+export class WorkflowHumanDestinationError extends Error {
+    details;
+    code = "workflow_human_destination_unavailable";
+    constructor(details, message) {
+        super(message);
+        this.details = details;
+        this.name = "WorkflowHumanDestinationError";
+    }
+}
+/** The existing operator selection, resolved afresh only when a human is needed. */
+export function resolveWorkflowHumanDestination(configured = () => new SettingsStore().resolveOne("workspace.operator_seat_name").value, registry = loadHumanRegistry) {
+    let selected;
+    let loaded;
+    try {
+        selected = configured();
+        loaded = registry();
+    }
+    catch (error) {
+        throw new WorkflowHumanDestinationError({ state: "unavailable" }, `Workflow human selection is unavailable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!loaded.ok) {
+        throw new WorkflowHumanDestinationError({ state: "registry-unavailable" }, loaded.error);
+    }
+    const addresses = loaded.entities.map((human) => human.address);
+    if (typeof selected === "string" && selected.trim()) {
+        const address = resolveRegisteredHumanAddress(selected.trim(), loaded.entities);
+        if (address)
+            return address;
+        throw new WorkflowHumanDestinationError({ state: "unregistered", selected, addresses }, "workspace.operator_seat_name does not select a registered human. Inspect rig gateway human list --json and select the intended registered address.");
+    }
+    if (addresses.length === 1)
+        return addresses[0];
+    throw new WorkflowHumanDestinationError({ state: addresses.length ? "ambiguous" : "missing", addresses }, "Workflow human fallback needs one registered human. Inspect rig gateway human list --json; when several exist, explicitly select workspace.operator_seat_name. No human destination was invented.");
+}
+export function workflowHumanDestination(selection = resolveWorkflowHumanDestination) {
+    return typeof selection === "function" ? selection() : selection;
+}
+//# sourceMappingURL=workflow-human-destination.js.map

package/daemon/dist/domain/workflow-human-destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-human-destination.js","sourceRoot":"","sources":["../../src/domain/workflow-human-destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6BAA6B,EAAmB,MAAM,6BAA6B,CAAC;AAChH,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAE1B;IADnB,IAAI,GAAG,wCAAwC,CAAC;IACzD,YAA4B,OAAkD,EAAE,OAAe;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,YAAO,GAAP,OAAO,CAA2C;QAE5E,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,UAAU,+BAA+B,CAC7C,aAA4B,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,KAAK,EACtG,WAA6B,iBAAiB;IAE9C,IAAI,QAAiB,CAAC;IACtB,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,6BAA6B,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,EAC9D,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,6BAA6B,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,6BAA6B,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChF,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,MAAM,IAAI,6BAA6B,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,EACpF,oJAAoJ,CAAC,CAAC;IAC1J,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAE,CAAC;IACjD,MAAM,IAAI,6BAA6B,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EACtG,mMAAmM,CAAC,CAAC;AACzM,CAAC;AAID,MAAM,UAAU,wBAAwB,CAAC,YAAsC,+BAA+B;IAC5G,OAAO,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC"}

package/daemon/dist/domain/workflow-projector.d.ts

@@ -6,7 +6,32 @@ import type { WorkflowSpecCache } from "./workflow-spec-cache.js";
 import type { WorkflowStepTrailLog } from "./workflow-step-trail-log.js";
 import type { WorkflowExitKind, WorkflowInstance, WorkflowSpec, WorkflowStepSpec } from "./workflow-types.js";
 import { type RoleResolutionContext } from "./workflow-role-context.js";
+import { type WorkflowHumanDestination } from "./workflow-human-destination.js";
 import type { WatchdogJobsRepository } from "./watchdog-jobs-repository.js";
+/** One occurrence-bound action, shared by packet bodies and authored wait wakes. */
+export declare function renderWorkflowProjectCommand(input: {
+    instanceId: string;
+    packetId: string;
+    ownerSession: string;
+    step?: Pick<WorkflowStepSpec, "acceptance">;
+}): string;
+/** Refreshes guidance when a packet is recreated (route/resume) instead of
+ * carrying a stale packet id or owner forward in copied body text. */
+export declare function withWorkflowContinuation(input: {
+    body: string;
+    contextRefs?: string[];
+    instanceId: string;
+    packetId: string;
+    ownerSession: string;
+    step?: Pick<WorkflowStepSpec, "acceptance">;
+}): string;
+export declare function workflowWaitWakeMessage(input: {
+    spec: WorkflowSpec;
+    instance: WorkflowInstance;
+    step: WorkflowStepSpec;
+    packetId: string;
+    ownerSession: string;
+}): string;
 /**
  * OPR.0.4.6.WF2 FR-2: canonical-session → node runtime column lookup
  * (the harness-pin reconciliation source). Latest session row wins
@@ -79,7 +104,7 @@ export declare class WorkflowProjector {
      *  (the validateRig precedent — the projector never reads config
      *  itself). hostDefault is read LIVE per exception (dial flips apply
      *  to future items only). Absent = engine defaults (orchestrator-
-     *  first chain with the human@host never-lost fallback). */
+     *  first chain with registered-human selection). */
     private readonly exceptionDial?;
     constructor(db: Database.Database, eventBus: EventBus, queueRepo: QueueRepository, instanceStore: WorkflowInstanceStore, trailLog: WorkflowStepTrailLog, specCache: WorkflowSpecCache, now?: () => Date, 
     /** OPR.0.4.6.WF1 FR-3: optional — arms/disarms packet or legacy-instance keepalives in-txn. */
@@ -88,10 +113,10 @@ export declare class WorkflowProjector {
      *  (the validateRig precedent — the projector never reads config
      *  itself). hostDefault is read LIVE per exception (dial flips apply
      *  to future items only). Absent = engine defaults (orchestrator-
-     *  first chain with the human@host never-lost fallback). */
+     *  first chain with registered-human selection). */
     exceptionDial?: {
         hostDefault: () => "orchestrator" | "human_only" | null;
-        humanFallbackSeat: string;
+        humanFallbackSeat: WorkflowHumanDestination;
     } | undefined);
     private nodeRuntimeOf;
     /**

package/daemon/dist/domain/workflow-projector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-projector.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-projector.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAIpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAM5E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUnF;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,gBAAgB,CAAC;IAChC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iGAAiG;IACjG,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAClC;;;;gEAI4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAdd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,eAAe,EAC1B,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,GAAG,GAAE,MAAM,IAAuB;IACnD,+FAA+F;IAC9E,gBAAgB,CAAC,EAAE,sBAAsB,YAAA;IAC1D;;;;gEAI4D;IAC3C,aAAa,CAAC,EAAE;QAC/B,WAAW,EAAE,MAAM,cAAc,GAAG,YAAY,GAAG,IAAI,CAAC;QACxD,iBAAiB,EAAE,MAAM,CAAC;KAC3B,YAAA;IAGH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA2sBpD,sBAAsB;CA4PrC;AA8FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,gBAAgB,EAC7B,YAAY,CAAC,EAAE,gBAAgB,GAC9B,gBAAgB,GAAG,IAAI,CAgBzB;AAwDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,gBAAgB,EACtB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI;AAC9C;;;4DAG4D;AAC5D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,GAAG,IAAI,CAuCf;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,gBAAgB,EACtB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAC5C,IAAI,CAUN;AAiFD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC;IAC/B;;;;;yEAKqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI;AAC7C;;;gEAGgE;AAChE,OAAO,CAAC,EAAE,qBAAqB,GAC9B,iBAAiB,CA+GnB"}
+{"version":3,"file":"workflow-projector.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-projector.ts"],"names":[],"mappings":"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"}

package/daemon/dist/domain/workflow-projector.js

@@ -24,9 +24,50 @@ import { isHumanSeatSession } from "./human-route-enforcer.js";
 import { selectRoleSeat } from "./workflow-role-resolver.js";
 import { roleResolutionContext, tryResolveRoleByCapability, } from "./workflow-role-context.js";
 import { classifyFailedInstance, classifyGateTrip, workflowExceptionTags } from "./workflow-exception.js";
-import { newQitemId } from "./queue-repository.js";
+import { newQitemId, QueueRepositoryError } from "./queue-repository.js";
 import { resolveExceptionRoute } from "./workflow-exception-router.js";
+import { workflowHumanDestination } from "./workflow-human-destination.js";
 import { disarmWorkflowKeepalive, ensureWorkflowKeepaliveArmed, } from "./workflow-keepalive-arming.js";
+import { requiredLifecycleSteps } from "./lifecycle-obligations.js";
+import { shellQuote } from "../adapters/shell-quote.js";
+const WORKFLOW_CONTEXT_SHORTCUT = "Context: this workflow packet is a shortcut, not the whole story; inspect additional project, mission, and receipt evidence before choosing an authored exit.";
+/** One occurrence-bound action, shared by packet bodies and authored wait wakes. */
+export function renderWorkflowProjectCommand(input) {
+    const base = `rig workflow project --instance ${input.instanceId} --current-packet ${input.packetId} --exit <handoff|waiting|done|failed> --actor-session ${input.ownerSession}`;
+    const acceptance = input.step?.acceptance;
+    if (!acceptance)
+        return base;
+    const verdict = acceptance.verdicts.length === 1
+        ? acceptance.verdicts[0]
+        : `<${acceptance.verdicts.join("|")}>`;
+    return `${base} --acceptance-candidate ${shellQuote(acceptance.candidate)} --acceptance-verdict ${shellQuote(verdict)} --acceptance-evidence-ref ${shellQuote(acceptance.evidence_ref)}`;
+}
+/** Refreshes guidance when a packet is recreated (route/resume) instead of
+ * carrying a stale packet id or owner forward in copied body text. */
+export function withWorkflowContinuation(input) {
+    const lines = input.body
+        .split("\n")
+        .filter((line) => !line.startsWith("Continuation: ") && line !== WORKFLOW_CONTEXT_SHORTCUT && !(input.contextRefs && line.startsWith("Context reference: ")));
+    while (lines.at(-1) === "")
+        lines.pop();
+    return [
+        ...lines,
+        "",
+        ...(input.contextRefs ?? []).map((ref) => `Context reference: ${ref}`),
+        `Continuation: ${renderWorkflowProjectCommand(input)}`,
+        WORKFLOW_CONTEXT_SHORTCUT,
+    ].join("\n");
+}
+export function workflowWaitWakeMessage(input) {
+    return [
+        `Workflow wait re-presentation (blocker progress or reminder): ${input.spec.id}@${input.spec.version} instance ${input.instance.instanceId} step ${input.step.id}.`,
+        `You still own the same frontier packet ${input.packetId}. Read it and inspect current evidence before choosing an authored exit.`,
+        ...(input.step.objective ? [`Objective: ${input.step.objective}`] : []),
+        ...(input.spec.context_refs ?? []).map((ref) => `Context reference: ${ref}`),
+        `Continuation: ${renderWorkflowProjectCommand({ ...input, instanceId: input.instance.instanceId })}`,
+        WORKFLOW_CONTEXT_SHORTCUT,
+    ].join("\n");
+}
 /**
  * OPR.0.4.6.WF2 FR-2: canonical-session → node runtime column lookup
  * (the harness-pin reconciliation source). Latest session row wins
@@ -70,7 +111,7 @@ export class WorkflowProjector {
      *  (the validateRig precedent — the projector never reads config
      *  itself). hostDefault is read LIVE per exception (dial flips apply
      *  to future items only). Absent = engine defaults (orchestrator-
-     *  first chain with the human@host never-lost fallback). */
+     *  first chain with registered-human selection). */
     exceptionDial) {
         this.db = db;
         this.eventBus = eventBus;
@@ -137,6 +178,15 @@ export class WorkflowProjector {
                 allowedExits: currentStep.allowed_exits,
             });
         }
+        // Project profile receipts are agent-authored references. Presence is mechanical;
+        // the daemon neither reads the referenced prose nor decides its substance.
+        if (requiredLifecycleSteps(instance.lifecycleBinding).includes(currentStep.id) &&
+            (input.exit === "done" || input.exit === "handoff")) {
+            const receipt = input.closureEvidence?.evidence_ref;
+            if (typeof receipt !== "string" || receipt.trim() === "") {
+                throw new WorkflowProjectorError("lifecycle_receipt_required", `Boundary step "${currentStep.id}" needs an agent-judged receipt. Supply --evidence-ref; a terminal queue row is not acceptance.`, { stepId: currentStep.id, instanceId: instance.instanceId });
+            }
+        }
         validateAcceptance(currentStep, input, instance);
         // A declared dependency graph opts into the S06 packet-addressed
         // executor. Legacy specs keep the mature serial scribe below exactly.
@@ -144,7 +194,14 @@ export class WorkflowProjector {
             if (!packetBinding) {
                 throw new WorkflowProjectorError("frontier_binding_indeterminate", `workflow instance ${instance.instanceId} has a dependency graph but frontier packet ${input.currentPacketId} has no unique step binding; refusing to infer from current_step_id`, { instanceId: instance.instanceId, currentPacketId: input.currentPacketId });
             }
-            return this.projectDependencyGraph({ input, instance, spec, currentStep, packetBinding });
+            return this.projectDependencyGraph({
+                input,
+                instance,
+                spec,
+                currentStep,
+                packetBinding,
+                currentOwnerSession: currentPacket.destinationSession,
+            });
         }
         // Determine next step (one-hop default; multi-hop is graduation).
         // OPR.0.4.6.WF2 FR-1: the recorded exit participates — a MAPPED exit
@@ -164,8 +221,7 @@ export class WorkflowProjector {
         // the same transactional scribe).
         const willRoute = branchRouted || input.exit === "handoff";
         // FR-5 (G3): the waiting-replay ABSORPTION check. `waiting`
-        // deliberately KEEPS the closed packet on the frontier (the
-        // keepalive wakes the parked owner off it), so a replayed waiting
+        // deliberately KEEPS the closed packet on the frontier, so a replayed waiting
         // project passes the frontier guard — before this slice it
         // double-wrote the trail. Absorption closes the hole under the
         // guard-ratified FULL CLOSURE-INTENT IDENTITY (G-WF1-1): the replay
@@ -307,6 +363,20 @@ export class WorkflowProjector {
                 handedOffTo: closure.handedOffTo,
                 blockedOn: closure.blockedOn,
                 transitionNote: closure.transitionNote,
+                wakeMaxSeconds: effectiveExit === "waiting" && !routes ? currentStep.re_present_max_seconds : undefined,
+                wakeProgressEvidence: input.closureEvidence,
+                wakeAfterSeconds: effectiveExit === "waiting" && !routes
+                    ? currentStep.re_present_after_seconds
+                    : undefined,
+                wakeMessage: effectiveExit === "waiting" && !routes && currentStep.re_present_after_seconds !== undefined
+                    ? workflowWaitWakeMessage({
+                        spec,
+                        instance,
+                        step: currentStep,
+                        packetId: input.currentPacketId,
+                        ownerSession: currentPacket.destinationSession,
+                    })
+                    : undefined,
             });
             registerEvent(queueUpdate.persistedEvent);
             // 3. If this close routes (structural handoff OR branch-mapped
@@ -345,21 +415,21 @@ export class WorkflowProjector {
                 // PREALLOCATED so occurrence:<gatePacketId> exists at create
                 // (identity queryable from birth — arch cell-2). Handler-role
                 // gates stay negative (deterministic handoffs, not exceptions).
-                const gateQitemId = gateCompile ? newQitemId() : undefined;
-                const gateException = gateCompile && gateQitemId
+                const nextPacketId = newQitemId();
+                const gateException = gateCompile
                     ? classifyGateTrip({
                         workflowName: instance.workflowName,
                         instanceId: instance.instanceId,
                         gatedStepId: nextStep.id,
                         gateKind: gateCompile.kind,
-                        gatePacketId: gateQitemId,
+                        gatePacketId: nextPacketId,
                         parkOn: gateCompile.parkOn,
                     })
                     : null;
                 // P34 (site :466, the ROUTES branch) — the stage call follows the create
                 // immediately below; see the seam assert at the end of this transaction.
                 createdNext = this.queueRepo.createWithinTransaction({
-                    qitemId: gateQitemId,
+                    qitemId: nextPacketId,
                     sourceSession: input.actorSession,
                     destinationSession: resolvedNextOwner,
                     body: workflowHandoffBody({
@@ -370,6 +440,8 @@ export class WorkflowProjector {
                         actorSession: input.actorSession,
                         resultNote: effectiveResultNote,
                         gate: gateCompile,
+                        packetId: nextPacketId,
+                        ownerSession: resolvedNextOwner,
                     }),
                     priority: "routine",
                     tier: gateCompile?.tier ?? "mode2",
@@ -526,13 +598,13 @@ export class WorkflowProjector {
             // txn. A handoff ensures the per-instance job is armed (idempotent
             // — also heals pre-WF-1 instances on their first post-upgrade
             // hop); a terminal status disarms it (no orphaned watchdog
-            // noise). Waiting keeps the job armed — the keepalive wakes the
-            // parked owner. Plain INSERT/UPDATE, verified txn-composable.
+            // noise). Waiting keeps the deadline-gated job armed but quiet while
+            // blocked; an authored re-presentation rule uses the separate one-shot
+            // park timer above. Plain INSERT/UPDATE, verified txn-composable.
             if (this.watchdogJobsRepo) {
                 if (routes && resolvedNextOwner) {
-                    // Any route arms the keepalive for the new owner — including a
-                    // gate park (waiting keeps the job armed; it wakes the parked
-                    // gate target exactly like any parked owner).
+                    // Any route arms the keepalive for the new owner — including a gate
+                    // park, whose delivery attention is handled by the queue wake intent.
                     ensureWorkflowKeepaliveArmed(this.watchdogJobsRepo, {
                         instanceId: instance.instanceId,
                         targetSession: resolvedNextOwner,
@@ -596,13 +668,13 @@ export class WorkflowProjector {
                         // FAC-1 (arch Q3 — routing uniformity, bounded): declared
                         // preferred_targets stay the override; a bound instance's
                         // orchestrator-role dial position falls through to a
-                        // NON-THROWING capability pick on the bound rig (null →
-                        // the router's human@host never-lost fallback — exception
-                        // routing never fails a close). Fresh decision per episode;
-                        // not a replay concern.
+                        // capability pick on the bound rig (evidenced no-match →
+                        // registered-human selection, with an explicit error if no
+                        // human can be selected). Evidence-read failures propagate
+                        // and roll back the close. Fresh decision per episode.
                         resolveRoleTarget: (role) => spec.roles?.[role]?.preferred_targets?.[0] ??
                             tryResolveRoleByCapability(roleCtx, role),
-                        humanFallbackSeat: this.exceptionDial?.humanFallbackSeat ?? "human@host",
+                        humanFallbackSeat: this.exceptionDial?.humanFallbackSeat,
                     });
                     const evidenceRef = `rig workflow trace ${instance.instanceId}`;
                     const itemBody = `WORKFLOW EXCEPTION (${exception.identity.exceptionClass})\n` +
@@ -627,16 +699,13 @@ export class WorkflowProjector {
                     try {
                         createdException = createExceptionItem(route.destinationSession, route.tier);
                     }
-                    catch {
-                        // THE NEVER-LOST WRITE-GATE FALLBACK: a routed destination the
-                        // queue's destination gate rejects (e.g. a spec-declared
-                        // target that is not a live session) must not lose the
-                        // exception OR fail the close — re-route human@host (always
-                        // validates: the destination gate special-cases human seats)
-                        // with the human-routed tier. Any failure of THIS create is a
-                        // real storage error and propagates: the whole close rolls
-                        // back rather than committing an item-less failure.
-                        createdException = createExceptionItem(this.exceptionDial?.humanFallbackSeat ?? "human@host", "human-gate");
+                    catch (error) {
+                        if (!(error instanceof QueueRepositoryError) || error.code !== "unknown_destination_rig" || route.humanRouted)
+                            throw error;
+                        // Only an unavailable agent rig invokes human selection. Other
+                        // admission/storage failures propagate unchanged and roll back the
+                        // close, retaining the failure+attention-item atomic contract.
+                        createdException = createExceptionItem(workflowHumanDestination(this.exceptionDial?.humanFallbackSeat), "human-gate");
                     }
                     registerEvent(createdException.persistedEvent);
                     exceptionItemPostCommit = {
@@ -694,7 +763,7 @@ export class WorkflowProjector {
         };
     }
     async projectDependencyGraph(args) {
-        const { input, instance, spec, currentStep, packetBinding } = args;
+        const { input, instance, spec, currentStep, packetBinding, currentOwnerSession } = args;
         if (input.exit === "waiting" && instance.status === "waiting" && matchesStoredWaitingDecision(instance, input, currentStep.id, this.trailLog)) {
             return {
                 instance,
@@ -783,7 +852,7 @@ export class WorkflowProjector {
                 if (!owner) {
                     throw new WorkflowProjectorError("next_owner_unresolved", `cannot resolve next owner for dependency step "${step.id}"`, { instanceId: instance.instanceId, stepId: step.id });
                 }
-                return { step, gate, owner };
+                return { step, gate, owner, packetId: newQitemId() };
             });
             const closureOwner = ownerPlans.length === 1 ? ownerPlans[0].owner : null;
             const closure = effectiveExit === "handoff" && ownerPlans.length !== 1
@@ -804,6 +873,20 @@ export class WorkflowProjector {
                 handedOffTo: closure.handedOffTo,
                 blockedOn: closure.blockedOn,
                 transitionNote: closure.transitionNote,
+                wakeMaxSeconds: effectiveExit === "waiting" && ownerPlans.length === 0 ? currentStep.re_present_max_seconds : undefined,
+                wakeProgressEvidence: input.closureEvidence,
+                wakeAfterSeconds: effectiveExit === "waiting" && ownerPlans.length === 0
+                    ? currentStep.re_present_after_seconds
+                    : undefined,
+                wakeMessage: effectiveExit === "waiting" && ownerPlans.length === 0 && currentStep.re_present_after_seconds !== undefined
+                    ? workflowWaitWakeMessage({
+                        spec,
+                        instance,
+                        step: currentStep,
+                        packetId: input.currentPacketId,
+                        ownerSession: currentOwnerSession,
+                    })
+                    : undefined,
             });
             addEvent(updated.persistedEvent);
             if (effectiveExit !== "waiting") {
@@ -814,9 +897,20 @@ export class WorkflowProjector {
             }
             for (const plan of ownerPlans) {
                 const created = this.queueRepo.createWithinTransaction({
+                    qitemId: plan.packetId,
                     sourceSession: input.actorSession,
                     destinationSession: plan.owner,
-                    body: workflowHandoffBody({ spec, instance, currentStep, nextStep: plan.step, actorSession: input.actorSession, resultNote: effectiveResultNote, gate: plan.gate }),
+                    body: workflowHandoffBody({
+                        spec,
+                        instance,
+                        currentStep,
+                        nextStep: plan.step,
+                        actorSession: input.actorSession,
+                        resultNote: effectiveResultNote,
+                        gate: plan.gate,
+                        packetId: plan.packetId,
+                        ownerSession: plan.owner,
+                    }),
                     priority: "routine",
                     tier: plan.gate?.tier ?? "mode2",
                     tags: ["workflow", plan.gate ? "gate" : "handoff", `workflow:${spec.id}`, `instance:${instance.instanceId}`, `step:${plan.step.id}`],
@@ -1333,7 +1427,14 @@ function workflowHandoffBody(input) {
     if (input.resultNote) {
         lines.push("", `Prior step note: ${input.resultNote}`);
     }
-    return lines.join("\n");
+    return withWorkflowContinuation({
+        body: lines.join("\n"),
+        contextRefs: input.spec.context_refs,
+        instanceId: input.instance.instanceId,
+        packetId: input.packetId,
+        ownerSession: input.ownerSession,
+        step: input.nextStep,
+    });
 }
 function validateAcceptance(step, input, instance) {
     if (!step.acceptance || input.exit === "waiting")