@sensigo/realm-cli 0.31.2 → 0.33.0

package/dist/commands/resume.js

@@ -1,19 +1,48 @@
 // resume command — removes a step from failed_steps so it can be re-executed.
+//
+// issue #279 (increment 1, PR-B): the write itself is now the core-owned pure `applyResume`
+// transform (design record §5) — this file's job narrows to the FOUR CLI refusals that must run
+// BEFORE it (structural aborted_at guard, a finalizer `--from` target, an unexpired drain lease,
+// and the three-way claim classification), then a single atomic `store.update()` of whatever
+// `applyResume` computed (its own version-CAS is the whole atomicity story — see that module's
+// doc). issue #281 rides here too: applyResume strips `abandoned_at` alongside `terminal_reason`.
 import { Command } from 'commander';
-import { WorkflowError } from '@sensigo/realm';
-import { RESUMABLE_PHASES, propagateSkips } from '@sensigo/realm';
 /**
- * Removes `stepName` from `failed_steps` so the DAG engine can re-evaluate its
- * eligibility on the next execute-step call.
+ * Removes `stepName` from `failed_steps` so the DAG engine can re-evaluate its eligibility on the
+ * next execute-step call — via the core `applyResume` transform (design record §5), after the
+ * four CLI refusals below all clear.
  *
  * @param runId         The run to resume.
  * @param stepName      The failed step to re-enable.
  * @param runStore      Store holding run records.
  * @param workflowStore Registrar for workflow definitions.
+ * @param opts          `force` overrides ONLY the claim_unknown_age refusal.
+ * @returns             The finalizers this resume voided (empty on the common no-pendings case).
  */
-export async function resumeRun(runId, stepName, runStore, workflowStore) {
+export async function resumeRun(runId, stepName, runStore, workflowStore, opts = {}) {
+    const { WorkflowError, applyResume, RESUMABLE_PHASES, classifyClaim, DRAIN_LEASE_MAX, deriveRunPhase, } = await import('@sensigo/realm');
     const run = await runStore.get(runId);
-    if (!RESUMABLE_PHASES.has(run.run_phase)) {
+    // §5.1 — structural, phase-independent (RESUME_REFUSES_ABORTED pin): an aborted run is never
+    // resumable, checked directly against aborted_at rather than relying on RESUMABLE_PHASES
+    // excluding 'aborted' as a side effect. Checked FIRST and independently of the phase check below
+    // — deriveRunPhase(:34-42) always derives phase 'aborted' whenever aborted_at is set (the two
+    // can never diverge through any real store write today), so this ordering is what makes the
+    // explicit, by-name business rule ("abort ⇒ never resumable") the one that actually fires,
+    // rather than silently riding on RESUMABLE_PHASES's exclusion as an unstated implementation
+    // detail a future phase-set change could break.
+    if (run.aborted_at !== undefined) {
+        throw new WorkflowError(`Run ${runId} was aborted (step '${run.aborted_at.step_id}') — aborted runs are never ` +
+            `resumable.`, {
+            code: 'STATE_TRANSITION_DENIED',
+            category: 'STATE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
+    // issue #279 (increment 2, PR-C — D-3 leg iv): derive, never trust the persisted run_phase — a
+    // grandfathered terminal-with-stale-gate record (the #282 class) must be admitted here on its
+    // TRUE (derived) phase, not whatever was last persisted.
+    if (!RESUMABLE_PHASES.has(deriveRunPhase(run))) {
         throw new WorkflowError(`Run ${runId} is in phase '${run.run_phase}', which is not resumable.`, {
             code: 'STATE_TRANSITION_DENIED',
             category: 'STATE',
@@ -22,7 +51,8 @@ export async function resumeRun(runId, stepName, runStore, workflowStore) {
         });
     }
     const workflow = await workflowStore.get(run.workflow_id);
-    if (workflow.steps[stepName] === undefined) {
+    const targetStep = workflow.steps[stepName];
+    if (targetStep === undefined) {
         throw new WorkflowError(`Step '${stepName}' not found in workflow '${run.workflow_id}'.`, {
             code: 'STEP_NOT_FOUND',
             category: 'ENGINE',
@@ -30,6 +60,17 @@ export async function resumeRun(runId, stepName, runStore, workflowStore) {
             retryable: false,
         });
     }
+    // §5.2 — a finalizer `--from` target is refused (finalizers settle via the drain verb, not
+    // resume — resuming one would bypass the ledger's own lease/mark discipline entirely).
+    if (targetStep.execution === 'finalizer') {
+        throw new WorkflowError(`Step '${stepName}' is a finalizer — finalizers cannot be resumed via --from. Use ` +
+            `'realm run drain ${runId}' or '--void ${stepName}' instead.`, {
+            code: 'STATE_TRANSITION_DENIED',
+            category: 'STATE',
+            agentAction: 'report_to_user',
+            retryable: false,
+        });
+    }
     if (!run.failed_steps.includes(stepName)) {
         throw new WorkflowError(`Step '${stepName}' is not in failed_steps for run '${runId}'.`, {
             code: 'STATE_TRANSITION_DENIED',
@@ -38,43 +79,84 @@ export async function resumeRun(runId, stepName, runStore, workflowStore) {
             retryable: false,
         });
     }
-    // Re-enable the failed step AND make the run runnable again. Filtering failed_steps alone leaves
-    // the run terminal (terminal_state:true), so `realm agent --run-id` throws on it and the
-    // `while (!terminal_state)` drivers skip it. Mirror the test-harness reference: strip
-    // terminal_reason (destructure-and-omit to honour exactOptionalPropertyTypes), re-derive
-    // skipped_steps from scratch so steps skipped only because of this failure become eligible again,
-    // and reset terminal_state to false. update() recomputes run_phase → 'running'.
-    //
-    // #111 clean slate: `...rest` still carries the run's stale `skip_details` — it MUST be reset
-    // to `{}` alongside `skipped_steps: []`, or an orphaned detail would survive for a step that is
-    // now re-eligible (violating `Object.keys(skip_details) ⊆ skipped_steps` isn't the risk here —
-    // the risk is a STALE-but-still-valid-looking reason for a step that no longer has one).
-    // No handler/guard-abort detail is re-mintable by this propagateSkips-only recompute — that is
-    // fine and unreachable: resume is gated to failed/abandoned phases (RESUMABLE_PHASES), never
-    // the aborted phase a handler/guard abort produces.
-    const { terminal_reason: _terminalReason, ...rest } = run;
-    const failedSteps = rest.failed_steps.filter((s) => s !== stepName);
-    const { skipped: skippedSteps, details: skipDetails } = propagateSkips({ ...rest, failed_steps: failedSteps, skipped_steps: [], skip_details: {} }, workflow);
-    await runStore.update({
-        ...rest,
-        failed_steps: failedSteps,
-        skipped_steps: skippedSteps,
-        skip_details: skipDetails,
-        terminal_state: false,
-    });
+    const now = new Date();
+    // §5.3 — any pending finalizer ledger entry with an UNEXPIRED lease refuses: a drainer is
+    // executing RIGHT NOW. Bounded by the §3 clamp (DRAIN_LEASE_MAX) — the wait is short by
+    // construction, so there is deliberately NO --force bypass (final-gate F10a).
+    for (const [name, entry] of Object.entries(run.finalizer_ledger ?? {})) {
+        if (entry.status !== 'pending')
+            continue;
+        if (entry.lease_token === undefined || entry.lease_deadline === undefined)
+            continue;
+        if (new Date(entry.lease_deadline).getTime() <= now.getTime())
+            continue; // expired — not held
+        throw new WorkflowError(`Run ${runId} has an active drain lease on finalizer '${name}' (expires ` +
+            `${entry.lease_deadline}) — a drainer is executing NOW. Wait for the lease to expire ` +
+            `(bounded — leases are clamped to ${DRAIN_LEASE_MAX}s) and retry. Not force-bypassable.`, {
+            code: 'STATE_TRANSITION_DENIED',
+            category: 'STATE',
+            agentAction: 'report_to_user',
+            retryable: true,
+            details: { runId, finalizer: name, lease_deadline: entry.lease_deadline },
+        });
+    }
+    // §5.4 — claims: classifyClaim three-way. healthy ⇒ refuse (no override); claim_unknown_age ⇒
+    // refuse UNLESS --force; stale/absent ⇒ released inside applyResume, no refusal here.
+    for (const step of run.in_progress_steps) {
+        const claim = run.claims?.[step];
+        if (claim === undefined)
+            continue; // absent — released inside applyResume
+        const state = classifyClaim(claim, now);
+        if (state === 'healthy') {
+            throw new WorkflowError(`Step '${step}' has a HEALTHY claim (deadline ${claim.deadline}) — a live runner is ` +
+                `presumed on it. Resume refuses to disturb live work.`, {
+                code: 'STATE_TRANSITION_DENIED',
+                category: 'STATE',
+                agentAction: 'report_to_user',
+                retryable: true,
+                details: { runId, step },
+            });
+        }
+        if (state === 'claim_unknown_age' && opts.force !== true) {
+            throw new WorkflowError(`Step '${step}' has an unknown-age claim (no reliable deadline) — its liveness cannot ` +
+                `be verified. Re-run with --force to override (only after confirming the runner is ` +
+                `actually dead).`, {
+                code: 'STATE_TRANSITION_DENIED',
+                category: 'STATE',
+                agentAction: 'report_to_user',
+                retryable: false,
+                details: { runId, step },
+            });
+        }
+        // claim_stale, or claim_unknown_age with --force: falls through — applyResume releases it.
+    }
+    const { run: resumedRun, voided, disclosures } = applyResume(run, stepName, workflow);
+    await runStore.update(resumedRun);
+    return { voided, disclosures };
 }
 export const resumeCommand = new Command('resume')
     .description('Remove a step from failed_steps so it can be re-executed')
     .argument('<run-id>', 'ID of the run to resume')
     .requiredOption('--from <step>', 'Name of the failed step to re-enable')
+    .option('--force', 'Override the claim_unknown_age refusal ONLY (never a healthy claim or an unexpired drain lease)')
     .action(async (runId, opts) => {
     const { JsonFileStore, JsonWorkflowStore } = await import('@sensigo/realm');
     const runStore = new JsonFileStore();
     const workflowStore = new JsonWorkflowStore();
     try {
-        await resumeRun(runId, opts.from, runStore, workflowStore);
+        const { voided, disclosures } = await resumeRun(runId, opts.from, runStore, workflowStore, {
+            ...(opts.force !== undefined ? { force: opts.force } : {}),
+        });
         console.log(`Resumed run '${runId}': step '${opts.from}' re-enabled and run reset to 'running'.\n` +
             `Drive it with: realm agent --run-id ${runId}`);
+        for (const { disclosure } of voided) {
+            console.log(`  ⚠ ${disclosure}`);
+        }
+        // issue #279 (increment 2, PR-C — D-3 leg ii): a stripped zombie gate, printed AFTER the
+        // voided-finalizer lines (same `⚠` loop convention).
+        for (const disclosure of disclosures) {
+            console.log(`  ⚠ ${disclosure}`);
+        }
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : String(err));

package/dist/commands/resume.js.map

@@ -1 +1 @@
-{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"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"}

package/dist/commands-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands-registry.d.ts","sourceRoot":"","sources":["../src/commands-registry.ts"],"names":[],"mappings":"AA8BA,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,+BAQ5B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,WAAW,+BAevB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,+BAM5B,CAAC"}
+{"version":3,"file":"commands-registry.d.ts","sourceRoot":"","sources":["../src/commands-registry.ts"],"names":[],"mappings":"AA+BA,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,+BAQ5B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,WAAW,+BAgBvB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,+BAM5B,CAAC"}

package/dist/commands-registry.js

@@ -13,6 +13,7 @@ import { gcCommand } from './commands/gc.js';
 import { exportCommand } from './commands/export.js';
 import { reconcileCommand } from './commands/reconcile.js';
 import { attemptsCommand } from './commands/attempts.js';
+import { drainCommand } from './commands/drain.js';
 import { respondCommand } from './commands/respond.js';
 import { inspectCommand } from './commands/inspect.js';
 import { replayCommand } from './commands/replay.js';
@@ -53,6 +54,7 @@ export const runCommands = [
     exportCommand,
     reconcileCommand,
     attemptsCommand,
+    drainCommand,
 ];
 /** Top-level commands not nested under a subgroup. */
 export const topLevelCommands = [

package/dist/commands-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands-registry.js","sourceRoot":"","sources":["../src/commands-registry.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAC/E,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,eAAe;IACf,eAAe;IACf,YAAY;IACZ,UAAU;IACV,WAAW;IACX,cAAc;CACf,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,cAAc;IACd,aAAa;IACb,WAAW;IACX,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,YAAY;IACZ,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,eAAe;CAChB,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,aAAa;CACd,CAAC"}
+{"version":3,"file":"commands-registry.js","sourceRoot":"","sources":["../src/commands-registry.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAC/E,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,eAAe;IACf,eAAe;IACf,YAAY;IACZ,UAAU;IACV,WAAW;IACX,cAAc;CACf,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,cAAc;IACd,aAAa;IACb,WAAW;IACX,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,YAAY;IACZ,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,YAAY;CACb,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,aAAa;CACd,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@ import 'dotenv/config';
 import { Command } from 'commander';
 import { workflowCommands, runCommands, topLevelCommands } from './commands-registry.js';
 const program = new Command();
-program.name('realm').description('Realm workflow engine CLI').version('0.31.2');
+program.name('realm').description('Realm workflow engine CLI').version('0.33.0');
 // realm workflow — operations on workflow definitions
 const workflowCmd = new Command('workflow').description('Manage workflow definitions');
 for (const cmd of workflowCommands)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sensigo/realm-cli",
-  "version": "0.31.2",
+  "version": "0.33.0",
   "publishConfig": {
     "access": "public"
   },
@@ -61,9 +61,9 @@
     "vitest": "^4.1.0"
   },
   "dependencies": {
-    "@sensigo/realm": "^0.31.2",
-    "@sensigo/realm-mcp": "^0.31.2",
-    "@sensigo/realm-testing": "^0.31.2",
+    "@sensigo/realm": "^0.33.0",
+    "@sensigo/realm-mcp": "^0.33.0",
+    "@sensigo/realm-testing": "^0.33.0",
     "@modelcontextprotocol/sdk": "1.29.0",
     "chalk": "^5.0.0",
     "commander": "^15.0.0",