agentxchain 2.14.0 → 2.15.0

package/README.md

@@ -100,10 +100,10 @@ For initiatives spanning multiple governed repos, use the coordinator to add cro
 npx agentxchain init --governed --template api-service --dir repos/backend -y
 npx agentxchain init --governed --template web-app --dir repos/frontend -y
 agentxchain multi init
-agentxchain multi step --repo backend --role pm
+agentxchain multi step --json
 ```
 
-See the [multi-repo quickstart](https://agentxchain.dev/docs/quickstart#multi-repo-cold-start) for the full cold-start walkthrough.
+If the coordinator enters `blocked`, fix the cause and run `agentxchain multi resume` before continuing with `multi step` or `multi approve-gate`. See the [multi-repo quickstart](https://agentxchain.dev/docs/quickstart#multi-repo-cold-start) for the full cold-start walkthrough.
 
 ### Migrate a legacy project
 
@@ -132,7 +132,10 @@ agentxchain step
 | `template validate` | Prove the template registry, workflow-kit scaffold contract, and planning artifact completeness (`--json` exposes a `workflow_kit` block) |
 | `verify protocol` | Run the shipped protocol conformance suite against a target implementation |
 | `dashboard` | Open the local governance dashboard in your browser for repo-local runs or multi-repo coordinator initiatives, including pending gate approvals |
-| `plugin install|list|remove` | Install, inspect, or remove governed hook plugins backed by `agentxchain-plugin.json` manifests |
+| `multi init\|status\|step\|resume\|approve-gate\|resync` | Run the multi-repo coordinator lifecycle, including blocked-state recovery via `multi resume` |
+| `intake record\|triage\|approve\|plan\|start\|scan\|resolve` | Continuous-delivery intake: turn delivery signals into governed work items |
+| `intake handoff` | Bridge a planned intake intent to a coordinator workstream for multi-repo execution |
+| `plugin install\|list\|remove` | Install, inspect, or remove governed hook plugins backed by `agentxchain-plugin.json` manifests |
 
 ### Shared utilities
 
@@ -197,6 +200,7 @@ TALK.md
 
 - `manual`: implemented
 - `local_cli`: implemented
+- `mcp`: implemented for stdio and streamable HTTP tool-contract dispatch
 - `api_proxy`: implemented for synchronous review-only turns and stages a provider-backed result during `step`
 
 ## Legacy IDE Mode

package/bin/agentxchain.js

@@ -88,6 +88,7 @@ import {
   multiInitCommand,
   multiStatusCommand,
   multiStepCommand,
+  multiResumeCommand,
   multiApproveGateCommand,
   multiResyncCommand,
 } from '../src/commands/multi.js';
@@ -96,6 +97,7 @@ import { intakeTriageCommand } from '../src/commands/intake-triage.js';
 import { intakeApproveCommand } from '../src/commands/intake-approve.js';
 import { intakePlanCommand } from '../src/commands/intake-plan.js';
 import { intakeStartCommand } from '../src/commands/intake-start.js';
+import { intakeHandoffCommand } from '../src/commands/intake-handoff.js';
 import { intakeScanCommand } from '../src/commands/intake-scan.js';
 import { intakeResolveCommand } from '../src/commands/intake-resolve.js';
 import { intakeStatusCommand } from '../src/commands/intake-status.js';
@@ -415,6 +417,12 @@ multiCmd
   .option('-j, --json', 'Output as JSON')
   .action(multiStepCommand);
 
+multiCmd
+  .command('resume')
+  .description('Clear a blocked coordinator state after operator recovery')
+  .option('-j, --json', 'Output as JSON')
+  .action(multiResumeCommand);
+
 multiCmd
   .command('approve-gate')
   .description('Approve a pending phase transition or completion gate')
@@ -449,7 +457,7 @@ intakeCmd
 intakeCmd
   .command('triage')
   .description('Triage a detected intent — set priority, template, charter, and acceptance')
-  .requiredOption('--intent <id>', 'Intent ID to triage')
+  .option('--intent <id>', 'Intent ID to triage')
   .option('--priority <level>', 'Priority level (p0, p1, p2, p3)')
   .option('--template <id>', 'Governed template (generic, api-service, cli-tool, library, web-app)')
   .option('--charter <text>', 'Delivery charter text')
@@ -486,10 +494,19 @@ intakeCmd
   .option('-j, --json', 'Output as JSON')
   .action(intakeStartCommand);
 
+intakeCmd
+  .command('handoff')
+  .description('Hand off a planned intent to a coordinator workstream')
+  .option('--intent <id>', 'Intent ID to hand off')
+  .option('--coordinator-root <path>', 'Path to the coordinator workspace root')
+  .option('--workstream <id>', 'Coordinator workstream ID')
+  .option('-j, --json', 'Output as JSON')
+  .action(intakeHandoffCommand);
+
 intakeCmd
   .command('scan')
   .description('Scan a structured source snapshot into intake events')
-  .requiredOption('--source <id>', 'Source type: ci_failure, git_ref_change, schedule')
+  .option('--source <id>', 'Source type: ci_failure, git_ref_change, schedule')
   .option('--file <path>', 'Path to snapshot JSON file')
   .option('--stdin', 'Read snapshot from stdin')
   .option('-j, --json', 'Output as JSON')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {

package/scripts/release-downstream-truth.sh

@@ -47,7 +47,7 @@ if [[ -z "$TARGET_VERSION" ]]; then
 fi
 
 PACKAGE_NAME="$(node -e "console.log(JSON.parse(require('fs').readFileSync('package.json', 'utf8')).name)")"
-HOMEBREW_FORMULA="${REPO_ROOT}/cli/homebrew/agentxchain.rb"
+CANONICAL_HOMEBREW_FORMULA_URL="${AGENTXCHAIN_DOWNSTREAM_FORMULA_URL:-https://raw.githubusercontent.com/shivamtiwari93/homebrew-tap/main/Formula/agentxchain.rb}"
 
 PASS=0
 FAIL=0
@@ -57,7 +57,7 @@ fail() { FAIL=$((FAIL + 1)); echo "  FAIL: $1"; }
 
 echo "AgentXchain v${TARGET_VERSION} Downstream Release Truth"
 echo "====================================="
-echo "Checks downstream surfaces after publish: GitHub release, Homebrew tap."
+echo "Checks downstream surfaces after publish: GitHub release, canonical Homebrew tap."
 echo ""
 
 # --- Check 1: GitHub Release ---
@@ -85,38 +85,39 @@ else
 fi
 
 # --- Get registry tarball URL and compute SHA ---
-echo "[2/3] Homebrew tap SHA matches registry tarball"
+echo "[2/3] Canonical Homebrew tap SHA matches registry tarball"
 REGISTRY_TARBALL_URL="$(npm view "${PACKAGE_NAME}@${TARGET_VERSION}" dist.tarball 2>/dev/null || true)"
+FORMULA_CONTENT="$(curl -fsSL "$CANONICAL_HOMEBREW_FORMULA_URL" 2>/dev/null || true)"
 if [[ -z "$REGISTRY_TARBALL_URL" ]]; then
   fail "cannot fetch registry tarball URL for ${PACKAGE_NAME}@${TARGET_VERSION}"
+elif [[ -z "$FORMULA_CONTENT" ]]; then
+  fail "cannot fetch canonical Homebrew formula from ${CANONICAL_HOMEBREW_FORMULA_URL}"
 else
   REGISTRY_SHA="$(curl -sL "$REGISTRY_TARBALL_URL" | shasum -a 256 | awk '{print $1}')"
   if [[ -z "$REGISTRY_SHA" ]]; then
     fail "cannot compute SHA256 of registry tarball"
-  elif [[ ! -f "$HOMEBREW_FORMULA" ]]; then
-    fail "Homebrew formula not found at ${HOMEBREW_FORMULA}"
   else
-    FORMULA_SHA="$(grep -E '^\s*sha256\s+"' "$HOMEBREW_FORMULA" | sed 's/.*sha256 *"\([a-f0-9]*\)".*/\1/')"
+    FORMULA_SHA="$(printf '%s\n' "$FORMULA_CONTENT" | grep -E '^\s*sha256\s+"' | sed 's/.*sha256 *"\([a-f0-9]*\)".*/\1/')"
     if [[ "$REGISTRY_SHA" == "$FORMULA_SHA" ]]; then
-      pass "Homebrew formula SHA256 matches registry tarball (${REGISTRY_SHA:0:16}...)"
+      pass "canonical Homebrew formula SHA256 matches registry tarball (${REGISTRY_SHA:0:16}...)"
     else
-      fail "Homebrew formula SHA256 mismatch: formula=${FORMULA_SHA:0:16}... registry=${REGISTRY_SHA:0:16}..."
+      fail "canonical Homebrew formula SHA256 mismatch: formula=${FORMULA_SHA:0:16}... registry=${REGISTRY_SHA:0:16}..."
     fi
   fi
 fi
 
 # --- Check 3: Homebrew tap URL matches registry tarball URL ---
-echo "[3/3] Homebrew tap URL matches registry tarball"
+echo "[3/3] Canonical Homebrew tap URL matches registry tarball"
 if [[ -z "$REGISTRY_TARBALL_URL" ]]; then
   fail "cannot verify URL — registry tarball URL unavailable"
-elif [[ ! -f "$HOMEBREW_FORMULA" ]]; then
-  fail "Homebrew formula not found at ${HOMEBREW_FORMULA}"
+elif [[ -z "$FORMULA_CONTENT" ]]; then
+  fail "cannot verify URL — canonical Homebrew formula unavailable"
 else
-  FORMULA_URL="$(grep -E '^\s*url\s+"' "$HOMEBREW_FORMULA" | sed 's/.*url *"\([^"]*\)".*/\1/')"
+  FORMULA_URL="$(printf '%s\n' "$FORMULA_CONTENT" | grep -E '^\s*url\s+"' | sed 's/.*url *"\([^"]*\)".*/\1/')"
   if [[ "$FORMULA_URL" == "$REGISTRY_TARBALL_URL" ]]; then
-    pass "Homebrew formula URL matches registry tarball"
+    pass "canonical Homebrew formula URL matches registry tarball"
   else
-    fail "Homebrew formula URL mismatch: formula=${FORMULA_URL} registry=${REGISTRY_TARBALL_URL}"
+    fail "canonical Homebrew formula URL mismatch: formula=${FORMULA_URL} registry=${REGISTRY_TARBALL_URL}"
   fi
 fi
 

package/src/commands/intake-approve.js

@@ -1,17 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { approveIntent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeApproveCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.intent) {
     const msg = '--intent <id> is required';

package/src/commands/intake-handoff.js

@@ -0,0 +1,58 @@
+import chalk from 'chalk';
+import { handoffIntent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
+
+export async function intakeHandoffCommand(opts) {
+  const root = requireIntakeWorkspaceOrExit(opts);
+
+  if (!opts.intent) {
+    const msg = '--intent <id> is required';
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
+    } else {
+      console.log(chalk.red(msg));
+    }
+    process.exit(1);
+  }
+
+  if (!opts.coordinatorRoot) {
+    const msg = '--coordinator-root <path> is required';
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
+    } else {
+      console.log(chalk.red(msg));
+    }
+    process.exit(1);
+  }
+
+  if (!opts.workstream) {
+    const msg = '--workstream <id> is required';
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
+    } else {
+      console.log(chalk.red(msg));
+    }
+    process.exit(1);
+  }
+
+  const result = handoffIntent(root, opts.intent, {
+    coordinatorRoot: opts.coordinatorRoot,
+    workstreamId: opts.workstream,
+  });
+
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else if (result.ok) {
+    console.log('');
+    console.log(chalk.green(`  Handed off intent ${result.intent.intent_id}`));
+    console.log(`  Workstream: ${result.intent.target_workstream.workstream_id}`);
+    console.log(`  Super Run:  ${result.super_run_id}`);
+    console.log(`  Handoff:    ${result.handoff_path}`);
+    console.log(chalk.dim('  Status:     planned → executing (coordinator-managed)'));
+    console.log('');
+  } else {
+    console.log(chalk.red(`  ${result.error}`));
+  }
+
+  process.exit(result.exitCode);
+}

package/src/commands/intake-plan.js

@@ -1,18 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { planIntent } from '../lib/intake.js';
-import { basename } from 'node:path';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakePlanCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.intent) {
     const msg = '--intent <id> is required';

package/src/commands/intake-record.js

@@ -1,19 +1,11 @@
 import chalk from 'chalk';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { findProjectRoot } from '../lib/config.js';
 import { recordEvent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeRecordCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   let payload;
   try {

package/src/commands/intake-resolve.js

@@ -1,17 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { resolveIntent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeResolveCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.intent) {
     const msg = '--intent <id> is required';

package/src/commands/intake-scan.js

@@ -1,19 +1,11 @@
 import chalk from 'chalk';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { findProjectRoot } from '../lib/config.js';
 import { scanSource, SCAN_SOURCES } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeScanCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.source) {
     const msg = `--source is required. Supported scan sources: ${SCAN_SOURCES.join(', ')}`;

package/src/commands/intake-start.js

@@ -1,17 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { startIntent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeStartCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.intent) {
     const msg = '--intent <id> is required';

package/src/commands/intake-status.js

@@ -1,17 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { intakeStatus } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeStatusCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   const result = intakeStatus(root, opts.intent || null);
 
@@ -72,6 +64,10 @@ function printIntentDetail(intent, event) {
   console.log(`  ${chalk.dim('Charter:')}   ${intent.charter || '—'}`);
   console.log(`  ${chalk.dim('Created:')}   ${intent.created_at}`);
   console.log(`  ${chalk.dim('Updated:')}   ${intent.updated_at}`);
+  if (intent.target_workstream) {
+    console.log(`  ${chalk.dim('Workstream:')} ${intent.target_workstream.workstream_id}`);
+    console.log(`  ${chalk.dim('Super Run:')}  ${intent.target_workstream.super_run_id}`);
+  }
 
   if (intent.acceptance_contract && intent.acceptance_contract.length > 0) {
     console.log('');

package/src/commands/intake-triage.js

@@ -1,17 +1,9 @@
 import chalk from 'chalk';
-import { findProjectRoot } from '../lib/config.js';
 import { triageIntent } from '../lib/intake.js';
+import { requireIntakeWorkspaceOrExit } from './intake-workspace.js';
 
 export async function intakeTriageCommand(opts) {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    if (opts.json) {
-      console.log(JSON.stringify({ ok: false, error: 'agentxchain.json not found' }, null, 2));
-    } else {
-      console.log(chalk.red('agentxchain.json not found'));
-    }
-    process.exit(2);
-  }
+  const root = requireIntakeWorkspaceOrExit(opts);
 
   if (!opts.intent) {
     const msg = '--intent <id> is required';

package/src/commands/intake-workspace.js

@@ -0,0 +1,58 @@
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'node:fs';
+import { join, parse as pathParse, resolve } from 'node:path';
+import { findProjectRoot } from '../lib/config.js';
+import { COORDINATOR_CONFIG_FILE } from '../lib/coordinator-config.js';
+
+function findCoordinatorWorkspaceRoot(startDir = process.cwd()) {
+  let dir = resolve(startDir);
+  const { root: fsRoot } = pathParse(dir);
+
+  while (true) {
+    if (existsSync(join(dir, COORDINATOR_CONFIG_FILE))) {
+      return dir;
+    }
+    if (dir === fsRoot) {
+      return null;
+    }
+    dir = join(dir, '..');
+  }
+}
+
+function listCoordinatorChildRepos(coordinatorRoot) {
+  const configPath = join(coordinatorRoot, COORDINATOR_CONFIG_FILE);
+  if (!existsSync(configPath)) {
+    return [];
+  }
+
+  try {
+    const raw = JSON.parse(readFileSync(configPath, 'utf8'));
+    return Object.keys(raw?.repos || {});
+  } catch {
+    return [];
+  }
+}
+
+export function requireIntakeWorkspaceOrExit(opts, startDir = process.cwd()) {
+  const projectRoot = findProjectRoot(startDir);
+  if (projectRoot) {
+    return projectRoot;
+  }
+
+  const coordinatorRoot = findCoordinatorWorkspaceRoot(startDir);
+  const childRepos = coordinatorRoot ? listCoordinatorChildRepos(coordinatorRoot) : [];
+  const repoHint = childRepos.length > 0
+    ? ` Available child repos: ${childRepos.join(', ')}.`
+    : '';
+  const error = coordinatorRoot
+    ? `intake commands are repo-local only. Found coordinator workspace at ${coordinatorRoot} (${COORDINATOR_CONFIG_FILE}). Run intake inside a child governed repo (agentxchain.json).${repoHint} Then use \`agentxchain multi step\` for cross-repo coordination.`
+    : 'agentxchain.json not found';
+
+  if (opts.json) {
+    console.log(JSON.stringify({ ok: false, error }, null, 2));
+  } else {
+    console.log(chalk.red(error));
+  }
+
+  process.exit(2);
+}

package/src/commands/multi.js

@@ -5,6 +5,7 @@
  *   multi init         — bootstrap a multi-repo coordinator run
  *   multi status       — show coordinator status and repo-run snapshots
  *   multi step         — reconcile repo truth, then dispatch or request the next coordinator gate
+ *   multi resume       — clear coordinator blocked state after operator recovery
  *   multi approve-gate — approve a pending phase transition or completion gate
  *   multi resync       — detect divergence and rebuild coordinator state from repo authority
  */
@@ -26,7 +27,11 @@ import {
   requestCoordinatorCompletion,
   requestPhaseTransition,
 } from '../lib/coordinator-gates.js';
-import { detectDivergence, resyncFromRepoAuthority } from '../lib/coordinator-recovery.js';
+import {
+  detectDivergence,
+  resyncFromRepoAuthority,
+  resumeCoordinatorFromBlockedState,
+} from '../lib/coordinator-recovery.js';
 import {
   fireCoordinatorHook,
   buildAssignmentPayload,
@@ -154,7 +159,7 @@ export async function multiStepCommand(options) {
     // Fire on_escalation hook (advisory — cannot block, only notifies)
     fireEscalationHook(workspacePath, configResult.config, state, state.blocked_reason || 'unknown reason');
     console.error(`Coordinator is blocked: ${state.blocked_reason || 'unknown reason'}`);
-    console.error('Resolve the blocked state before stepping.');
+    console.error('Resolve the blocked state, then run `agentxchain multi resume` before stepping again.');
     process.exitCode = 1;
     return;
   }
@@ -362,6 +367,57 @@ function maybeRequestCoordinatorGate(workspacePath, state, config) {
   return { ok: false, type: 'run_completion', blockers: completionEvaluation.blockers };
 }
 
+// ── multi resume ───────────────────────────────────────────────────────────
+
+export async function multiResumeCommand(options) {
+  const workspacePath = process.cwd();
+  const configResult = loadCoordinatorConfig(workspacePath);
+
+  if (!configResult.ok) {
+    console.error('Coordinator config error:');
+    for (const err of configResult.errors || []) {
+      console.error(`  - ${typeof err === 'string' ? err : err.message || JSON.stringify(err)}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+
+  const state = loadCoordinatorState(workspacePath);
+  if (!state) {
+    console.error('No coordinator state found. Run `agentxchain multi init` first.');
+    process.exitCode = 1;
+    return;
+  }
+
+  const result = resumeCoordinatorFromBlockedState(workspacePath, state, configResult.config);
+
+  if (!result.ok) {
+    console.error(result.error || 'Coordinator recovery failed.');
+    process.exitCode = 1;
+    return;
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      ok: true,
+      previous_status: 'blocked',
+      resumed_status: result.resumed_status,
+      blocked_reason: result.blocked_reason,
+      pending_gate: result.state?.pending_gate || null,
+      resync: result.resync,
+    }, null, 2));
+    return;
+  }
+
+  console.log(`Coordinator resumed: ${result.resumed_status}`);
+  console.log(`Previous block: ${result.blocked_reason}`);
+  if (result.resumed_status === 'paused' && result.state?.pending_gate) {
+    console.log(`Next action: agentxchain multi approve-gate (${result.state.pending_gate.gate})`);
+  } else {
+    console.log('Next action: agentxchain multi step');
+  }
+}
+
 // ── multi approve-gate ─────────────────────────────────────────────────────
 
 export async function multiApproveGateCommand(options) {