agentxchain 2.116.0 → 2.117.0

package/README.md

@@ -202,7 +202,7 @@ Partial coordinator artifacts are first-class here too: `audit` and `report` kee
 | `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 |
-| `schedule list\|run-due\|daemon\|status` | Run repo-local lights-out scheduling: inspect schedules, execute due runs, poll in a local daemon loop, or check daemon heartbeat |
+| `schedule list\|run-due\|daemon\|status` | Run repo-local lights-out scheduling: inspect schedules, execute due runs, poll in a local daemon loop, continue explicitly unblocked schedule-owned runs, or check daemon heartbeat |
 | `plugin install\|list\|remove` | Install, inspect, or remove governed hook plugins under `.agentxchain/plugins/` |
 | `plugin list-available` | List bundled built-in plugins installable by short name |
 | `export [--output <path>]` | Export the portable raw governed/coordinator artifact for continuity or offline review |

package/bin/agentxchain.js

@@ -67,6 +67,8 @@ import { rebindCommand } from '../src/commands/rebind.js';
 import { branchCommand } from '../src/commands/branch.js';
 import { migrateCommand } from '../src/commands/migrate.js';
 import { resumeCommand } from '../src/commands/resume.js';
+import { unblockCommand } from '../src/commands/unblock.js';
+import { injectCommand } from '../src/commands/inject.js';
 import { escalateCommand } from '../src/commands/escalate.js';
 import { acceptTurnCommand } from '../src/commands/accept-turn.js';
 import { rejectTurnCommand } from '../src/commands/reject-turn.js';
@@ -600,6 +602,23 @@ program
   .option('--turn <id>', 'Target a specific retained turn when multiple exist')
   .action(resumeCommand);
 
+program
+  .command('unblock <escalation-id>')
+  .description('Resolve the current human escalation record and continue the governed run')
+  .action(unblockCommand);
+
+program
+  .command('inject <description>')
+  .description('Inject a priority work item into the intake queue (composed record + triage + approve)')
+  .option('--priority <level>', 'Priority level (p0, p1, p2, p3)', 'p0')
+  .option('--template <id>', 'Governed template (generic, api-service, cli-tool, library, web-app, enterprise-app)', 'generic')
+  .option('--charter <text>', 'Delivery charter (defaults to description)')
+  .option('--acceptance <text>', 'Comma-separated acceptance criteria')
+  .option('--approver <name>', 'Approver identity', 'human')
+  .option('--no-approve', 'Stop at triaged state instead of auto-approving')
+  .option('-j, --json', 'Output as JSON')
+  .action(injectCommand);
+
 program
   .command('escalate')
   .description('Raise an operator escalation and block the governed run intentionally')
@@ -652,6 +671,11 @@ program
   .option('--chain-on <statuses>', 'Comma-separated terminal statuses that trigger chaining (default: completed)')
   .option('--chain-cooldown <seconds>', 'Seconds to wait between chained runs (default: 5)', parseInt)
   .option('--mission <mission_id>', 'Bind chained runs to a mission (use "latest" for most recent mission)')
+  .option('--continuous', 'Enable continuous vision-driven loop: derive work from VISION.md and run until satisfied')
+  .option('--vision <path>', 'Path to VISION.md (project-relative or absolute, default: .planning/VISION.md)')
+  .option('--max-runs <n>', 'Maximum consecutive governed runs in continuous mode (default: 100)', parseInt)
+  .option('--poll-seconds <n>', 'Seconds between idle-detection cycles in continuous mode (default: 30)', parseInt)
+  .option('--max-idle-cycles <n>', 'Stop after N consecutive idle cycles with no derivable work (default: 3)', parseInt)
   .action(runCommand);
 
 program

package/package.json

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

package/src/commands/events.js

@@ -73,7 +73,12 @@ function printEvent(evt) {
   const gateFailedDetail = evt.event_type === 'gate_failed' && evt.payload?.from_phase
     ? ` ${evt.payload.from_phase} → ${evt.payload.to_phase || '?'}${evt.payload.reasons?.length ? ` — ${evt.payload.reasons[0]}` : ''}${evt.payload.gate_id ? ` (${evt.payload.gate_id})` : ''}`
     : '';
-  console.log(`${chalk.dim(ts)}  ${type}  ${chalk.cyan(runId)}  ${phase}${turnInfo}${conflictDetail}${rejectionDetail}${phaseTransitionDetail}${gateFailedDetail}`);
+  const humanEscalationDetail = evt.event_type === 'human_escalation_raised' && evt.payload?.escalation_id
+    ? ` ${evt.payload.escalation_id} [${evt.payload.type || '?'}]${evt.payload.service ? ` (${evt.payload.service})` : ''}`
+    : evt.event_type === 'human_escalation_resolved' && evt.payload?.escalation_id
+      ? ` ${evt.payload.escalation_id} via ${evt.payload.resolved_via || '?'}`
+      : '';
+  console.log(`${chalk.dim(ts)}  ${type}  ${chalk.cyan(runId)}  ${phase}${turnInfo}${conflictDetail}${rejectionDetail}${phaseTransitionDetail}${gateFailedDetail}${humanEscalationDetail}`);
 }
 
 function formatConflictDetail(evt) {
@@ -115,6 +120,8 @@ function colorEventType(type) {
     phase_entered: chalk.magenta,
     escalation_raised: chalk.red.bold,
     escalation_resolved: chalk.green,
+    human_escalation_raised: chalk.red.bold,
+    human_escalation_resolved: chalk.green,
     gate_pending: chalk.yellow,
     gate_approved: chalk.green,
     gate_failed: chalk.red,

package/src/commands/inject.js

@@ -0,0 +1,81 @@
+import chalk from 'chalk';
+import { loadProjectContext } from '../lib/config.js';
+import { injectIntent } from '../lib/intake.js';
+
+export async function injectCommand(description, opts) {
+  const context = loadProjectContext();
+  if (!context) {
+    console.log(chalk.red('No agentxchain.json found. Run `agentxchain init` first.'));
+    process.exit(1);
+  }
+
+  const { root, config } = context;
+
+  if (config.protocol_mode !== 'governed') {
+    console.log(chalk.red('The inject command is only available for governed projects.'));
+    process.exit(1);
+  }
+
+  if (!description || !String(description).trim()) {
+    console.log(chalk.red('A description is required. Example: agentxchain inject "Fix the sidebar ordering"'));
+    process.exit(1);
+  }
+
+  const result = injectIntent(root, String(description).trim(), {
+    priority: opts.priority,
+    template: opts.template,
+    charter: opts.charter,
+    acceptance: opts.acceptance,
+    approver: opts.approver,
+    noApprove: opts.approve === false,
+  });
+
+  if (!result.ok) {
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: false, error: result.error }, null, 2));
+    } else {
+      console.log(chalk.red(result.error));
+    }
+    process.exit(result.exitCode || 1);
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify({
+      ok: true,
+      intent_id: result.intent.intent_id,
+      event_id: result.event.event_id,
+      status: result.intent.status,
+      priority: result.intent.priority,
+      deduplicated: result.deduplicated,
+      preemption_marker: result.preemption_marker,
+    }, null, 2));
+    return;
+  }
+
+  console.log('');
+  if (result.deduplicated) {
+    console.log(chalk.yellow('  ⚠ Duplicate injection — existing intent returned'));
+    console.log(chalk.dim(`  Intent: ${result.intent?.intent_id || 'unknown'}`));
+    console.log(chalk.dim(`  Status: ${result.intent?.status || 'unknown'}`));
+    console.log('');
+    return;
+  }
+
+  const priority = result.intent.priority || 'p0';
+  const priorityColor = priority === 'p0' ? chalk.red.bold : priority === 'p1' ? chalk.yellow.bold : chalk.dim;
+
+  console.log(chalk.green.bold('  Injected'));
+  console.log(chalk.dim(`  Intent:   ${result.intent.intent_id}`));
+  console.log(`  Priority: ${priorityColor(priority)}`);
+  console.log(chalk.dim(`  Status:   ${result.intent.status}`));
+  console.log(chalk.dim(`  Charter:  ${result.intent.charter || description}`));
+
+  if (result.preemption_marker) {
+    console.log('');
+    console.log(chalk.red.bold('  ⚡ Preemption marker written'));
+    console.log(chalk.dim('  The current run will yield after the active turn completes.'));
+    console.log(chalk.dim('  The scheduler/continuous loop will pick up this intent next.'));
+  }
+
+  console.log('');
+}

package/src/commands/resume.js

@@ -77,6 +77,8 @@ export async function resumeCommand(opts) {
   // §47: active + turns present → reject (resume assigns new turns, not re-dispatches)
   const activeCount = getActiveTurnCount(state);
   const activeTurns = getActiveTurns(state);
+  const resumeVia = opts?._via || 'resume';
+  const turnResumeVia = opts?._via || 'resume --turn';
 
   if (state.status === 'active' && activeCount > 0) {
     if (activeCount === 1) {
@@ -135,7 +137,7 @@ export async function resumeCommand(opts) {
       console.log(`  Attempt: ${retainedTurn.attempt}`);
       console.log('');
 
-      const reactivated = reactivateGovernedRun(root, state, { via: 'resume --turn', notificationConfig: config });
+      const reactivated = reactivateGovernedRun(root, state, { via: turnResumeVia, notificationConfig: config });
       if (!reactivated.ok) {
         console.log(chalk.red(`Failed to reactivate run: ${reactivated.error}`));
         process.exit(1);
@@ -195,7 +197,7 @@ export async function resumeCommand(opts) {
     console.log(`  Attempt: ${retainedTurn.attempt}`);
     console.log('');
 
-    const reactivated = reactivateGovernedRun(root, state, { via: 'resume --turn', notificationConfig: config });
+    const reactivated = reactivateGovernedRun(root, state, { via: turnResumeVia, notificationConfig: config });
     if (!reactivated.ok) {
       console.log(chalk.red(`Failed to reactivate blocked run: ${reactivated.error}`));
       process.exit(1);
@@ -234,7 +236,7 @@ export async function resumeCommand(opts) {
 
   // §47: paused + run_id exists → resume same run
   if (state.status === 'blocked' && state.run_id) {
-    const reactivated = reactivateGovernedRun(root, state, { via: 'resume', notificationConfig: config });
+    const reactivated = reactivateGovernedRun(root, state, { via: resumeVia, notificationConfig: config });
     if (!reactivated.ok) {
       console.log(chalk.red(`Failed to reactivate blocked run: ${reactivated.error}`));
       process.exit(1);
@@ -245,7 +247,7 @@ export async function resumeCommand(opts) {
 
   // §47: paused + run_id exists → resume same run
   if (state.status === 'paused' && state.run_id) {
-    const reactivated = reactivateGovernedRun(root, state, { via: 'resume', notificationConfig: config });
+    const reactivated = reactivateGovernedRun(root, state, { via: resumeVia, notificationConfig: config });
     if (!reactivated.ok) {
       console.log(chalk.red(`Failed to reactivate run: ${reactivated.error}`));
       process.exit(1);

package/src/commands/run.js

@@ -45,6 +45,7 @@ import {
   getTurnStagingResultPath,
 } from '../lib/turn-paths.js';
 import { resolveChainOptions, executeChainedRun } from '../lib/run-chain.js';
+import { resolveContinuousOptions, executeContinuousRun } from '../lib/continuous-run.js';
 
 export async function runCommand(opts) {
   const context = loadProjectContext();
@@ -53,6 +54,18 @@ export async function runCommand(opts) {
     process.exit(1);
   }
 
+  // Continuous vision-driven mode
+  const contOpts = resolveContinuousOptions(opts, context.config);
+  if (contOpts.enabled) {
+    console.log(chalk.cyan.bold('agentxchain run --continuous'));
+    console.log(chalk.dim(`  Vision: ${contOpts.visionPath}`));
+    console.log(chalk.dim(`  Max runs: ${contOpts.maxRuns}, Poll: ${contOpts.pollSeconds}s, Idle limit: ${contOpts.maxIdleCycles}`));
+    console.log(chalk.dim(`  Triage approval: ${contOpts.triageApproval}`));
+    console.log('');
+    const { exitCode } = await executeContinuousRun(context, contOpts, executeGovernedRun);
+    process.exit(exitCode);
+  }
+
   const chainOpts = resolveChainOptions(opts, context.config);
   if (chainOpts.enabled) {
     console.log(chalk.cyan.bold('agentxchain run --chain'));

package/src/commands/schedule.js

@@ -6,12 +6,14 @@ import {
   listSchedules,
   updateScheduleState,
   evaluateScheduleLaunchEligibility,
+  findContinuableScheduleRun,
   readDaemonState,
   writeDaemonState,
   updateDaemonHeartbeat,
   createDaemonState,
   evaluateDaemonStatus,
 } from '../lib/run-schedule.js';
+import { consumePreemptionMarker } from '../lib/intake.js';
 import { executeGovernedRun } from './run.js';
 
 function loadScheduleContext() {
@@ -86,7 +88,136 @@ function buildScheduleProvenance(entry) {
   };
 }
 
+function buildScheduleExecutionResult(entryId, execution, fallbackState, action = 'ran') {
+  const state = execution.result?.state || fallbackState || null;
+  return {
+    id: entryId,
+    action,
+    run_id: state?.run_id || null,
+    stop_reason: execution.result?.stop_reason || null,
+    exit_code: execution.exitCode,
+  };
+}
+
+function recordScheduleExecution(context, entryId, execution, fallbackState, nowIso, action = 'ran') {
+  const state = execution.result?.state || fallbackState || null;
+  const runId = state?.run_id || null;
+  const startedAt = state?.created_at || nowIso;
+
+  updateScheduleState(context.root, context.config, entryId, (record) => ({
+    ...record,
+    last_started_at: startedAt,
+    last_finished_at: new Date().toISOString(),
+    last_run_id: runId,
+    last_status: execution.result?.stop_reason || (execution.exitCode === 0 ? 'completed' : 'launch_failed'),
+    last_skip_at: null,
+    last_skip_reason: null,
+  }));
+
+  return buildScheduleExecutionResult(entryId, execution, fallbackState, action);
+}
+
+function consumeScheduledPriorityPreemption(context, scheduleId, schedule, execution, fallbackState, at) {
+  const scheduleResult = recordScheduleExecution(
+    context,
+    scheduleId,
+    execution,
+    fallbackState,
+    at || new Date().toISOString(),
+    'preempted',
+  );
+  const consumed = consumePreemptionMarker(context.root, {
+    role: schedule.initial_role || undefined,
+  });
+
+  if (!consumed.ok) {
+    return {
+      ok: false,
+      exitCode: 1,
+      result: {
+        ...scheduleResult,
+        action: 'preemption_failed',
+        error: consumed.error,
+        injected_intent_id: execution.result?.preempted_by || null,
+      },
+    };
+  }
+
+  return {
+    ok: true,
+    exitCode: 0,
+    result: {
+      ...scheduleResult,
+      action: 'preempted',
+      injected_intent_id: consumed.intent_id,
+      injected_turn_id: consumed.turn_id,
+      injected_role: consumed.role,
+    },
+  };
+}
+
+async function continueActiveScheduledRun(context, opts = {}) {
+  const continuation = findContinuableScheduleRun(context.root, context.config, {
+    scheduleId: opts.schedule || null,
+  });
+  if (!continuation.ok) {
+    return { matched: false, reason: continuation.reason };
+  }
+
+  const { schedule_id: scheduleId, schedule, state } = continuation;
+
+  if (!opts.json) {
+    console.log(chalk.cyan(`Continuing active scheduled run: ${scheduleId}`));
+  }
+
+  const execution = await executeGovernedRun(context, {
+    maxTurns: schedule.max_turns,
+    autoApprove: schedule.auto_approve !== false,
+    report: true,
+    log: opts.json ? () => {} : console.log,
+  });
+
+  if (execution.result?.stop_reason === 'priority_preempted') {
+    const promoted = consumeScheduledPriorityPreemption(context, scheduleId, schedule, execution, state, opts.at);
+    return {
+      matched: true,
+      ok: promoted.ok,
+      exitCode: promoted.exitCode,
+      result: promoted.result,
+    };
+  }
+
+  const blocked = execution.result?.stop_reason === 'blocked';
+  const action = blocked && opts.tolerateBlockedRun ? 'blocked' : 'continued';
+  const result = recordScheduleExecution(context, scheduleId, execution, state, opts.at || new Date().toISOString(), action);
+
+  if (execution.exitCode !== 0 && !(opts.tolerateBlockedRun && blocked)) {
+    return {
+      matched: true,
+      ok: false,
+      exitCode: execution.exitCode,
+      result,
+    };
+  }
+
+  return {
+    matched: true,
+    ok: true,
+    exitCode: 0,
+    result,
+  };
+}
+
 async function runDueSchedules(context, opts = {}) {
+  if (opts.continueActiveScheduleRuns) {
+    const continuation = await continueActiveScheduledRun(context, opts);
+    if (continuation.matched) {
+      return continuation.ok
+        ? { ok: true, exitCode: continuation.exitCode, results: [continuation.result] }
+        : { ok: false, exitCode: continuation.exitCode, results: [continuation.result], error: 'Scheduled run failed' };
+    }
+  }
+
   const resolved = resolveScheduleEntries(context, opts.schedule, opts.at);
   if (!resolved.ok) {
     return { ok: false, exitCode: 1, error: resolved.error, results: [] };
@@ -150,26 +281,29 @@ async function runDueSchedules(context, opts = {}) {
       continue;
     }
 
-    const runId = execution.result?.state?.run_id || null;
-    const startedAt = execution.result?.state?.created_at || nowIso;
-    updateScheduleState(context.root, context.config, entry.id, (record) => ({
-      ...record,
-      last_started_at: startedAt,
-      last_finished_at: new Date().toISOString(),
-      last_run_id: runId,
-      last_status: execution.result?.stop_reason || (execution.exitCode === 0 ? 'completed' : 'launch_failed'),
-      last_skip_at: null,
-      last_skip_reason: null,
-    }));
-    results.push({
-      id: entry.id,
-      action: 'ran',
-      run_id: runId,
-      stop_reason: execution.result?.stop_reason || null,
-      exit_code: execution.exitCode,
-    });
+    if (execution.result?.stop_reason === 'priority_preempted') {
+      const promoted = consumeScheduledPriorityPreemption(context, entry.id, entry, execution, execution.result?.state || null, nowIso);
+      results.push(promoted.result);
+      if (!promoted.ok) {
+        return { ok: false, exitCode: promoted.exitCode, results };
+      }
+      continue;
+    }
+
+    const blocked = execution.result?.stop_reason === 'blocked';
+    results.push(recordScheduleExecution(
+      context,
+      entry.id,
+      execution,
+      execution.result?.state || null,
+      nowIso,
+      blocked && opts.tolerateBlockedRun ? 'blocked' : 'ran',
+    ));
 
     if (execution.exitCode !== 0) {
+      if (opts.tolerateBlockedRun && blocked) {
+        continue;
+      }
       return { ok: false, exitCode: execution.exitCode, results };
     }
   }
@@ -214,6 +348,14 @@ export async function scheduleRunDueCommand(opts) {
     for (const entry of result.results) {
       if (entry.action === 'ran') {
         console.log(chalk.green(`Schedule ran: ${entry.id} (${entry.run_id || 'no run id'})`));
+      } else if (entry.action === 'continued') {
+        console.log(chalk.green(`Schedule continued: ${entry.id} (${entry.run_id || 'no run id'})`));
+      } else if (entry.action === 'preempted') {
+        console.log(chalk.yellow(`Schedule preempted by injected priority: ${entry.id} (${entry.injected_intent_id || 'unknown intent'})`));
+      } else if (entry.action === 'preemption_failed') {
+        console.log(chalk.red(`Schedule preemption failed: ${entry.id} (${entry.error || 'unknown error'})`));
+      } else if (entry.action === 'blocked') {
+        console.log(chalk.yellow(`Schedule waiting on unblock: ${entry.id}`));
       } else if (entry.action === 'skipped') {
         console.log(chalk.yellow(`Schedule skipped: ${entry.id} (${entry.reason})`));
       } else if (entry.action === 'not_due') {
@@ -338,7 +480,11 @@ export async function scheduleDaemonCommand(opts) {
   while (true) {
     cycle += 1;
     daemonState.last_cycle_started_at = new Date().toISOString();
-    const result = await runDueSchedules(context, opts);
+    const result = await runDueSchedules(context, {
+      ...opts,
+      continueActiveScheduleRuns: true,
+      tolerateBlockedRun: true,
+    });
 
     updateDaemonHeartbeat(context.root, daemonState, result);
 

package/src/commands/status.js

@@ -19,7 +19,10 @@ import { summarizeRunProvenance } from '../lib/run-provenance.js';
 import { readRecentRunEventSummary } from '../lib/recent-event-summary.js';
 import { deriveConflictedTurnResolutionActions } from '../lib/conflict-actions.js';
 import { summarizeLatestGateActionAttempt } from '../lib/gate-actions.js';
+import { findCurrentHumanEscalation } from '../lib/human-escalations.js';
 import { getDashboardPid, getDashboardSession } from './dashboard.js';
+import { readPreemptionMarker } from '../lib/intake.js';
+import { readContinuousSession } from '../lib/continuous-run.js';
 
 export async function statusCommand(opts) {
   const context = loadStatusContext();
@@ -127,6 +130,9 @@ function renderGovernedStatus(context, opts) {
   const repoDecisionSummary = summarizeRepoDecisions(readRepoDecisions(root), config);
 
   const workflowKitArtifacts = deriveWorkflowKitArtifacts(root, config, state);
+  const humanEscalation = findCurrentHumanEscalation(root, state);
+  const preemptionMarker = readPreemptionMarker(root);
+  const continuousSession = readContinuousSession(root);
   const gateActionAttempt = state?.pending_phase_transition
     ? summarizeLatestGateActionAttempt(root, 'phase_transition', state.pending_phase_transition.gate)
     : state?.pending_run_completion
@@ -162,6 +168,9 @@ function renderGovernedStatus(context, opts) {
       next_actions: nextActions,
       connector_health: connectorHealth,
       recent_event_summary: recentEventSummary,
+      human_escalation: humanEscalation,
+      preemption_marker: preemptionMarker,
+      continuous_session: continuousSession,
       gate_action_attempt: gateActionAttempt,
       workflow_kit_artifacts: workflowKitArtifacts,
       dashboard_session: dashboardSessionObj,
@@ -174,6 +183,39 @@ function renderGovernedStatus(context, opts) {
   console.log(chalk.dim('  ' + '─'.repeat(44)));
   console.log('');
 
+  // Priority injection banner — above all other status
+  if (preemptionMarker) {
+    console.log(chalk.red.bold('  ⚡ Priority injection pending'));
+    console.log(chalk.dim(`  Intent:      ${preemptionMarker.intent_id}`));
+    console.log(`  Priority:    ${chalk.red.bold(preemptionMarker.priority)}`);
+    if (preemptionMarker.description) {
+      console.log(chalk.dim(`  Description: ${preemptionMarker.description}`));
+    }
+    if (preemptionMarker.injected_at) {
+      console.log(chalk.dim(`  Injected at: ${preemptionMarker.injected_at}`));
+    }
+    console.log(chalk.dim('  Effect:      Will preempt current workstream after this turn completes'));
+    console.log(chalk.dim('  ' + '─'.repeat(44)));
+    console.log('');
+  }
+
+  // Continuous session banner
+  if (continuousSession) {
+    console.log(chalk.cyan.bold('  🔄 Continuous Vision-Driven Session'));
+    console.log(chalk.dim(`  Session:     ${continuousSession.session_id}`));
+    console.log(chalk.dim(`  Vision:      ${continuousSession.vision_path}`));
+    console.log(`  Status:      ${chalk.cyan(continuousSession.status || 'unknown')}`);
+    console.log(`  Runs:        ${continuousSession.runs_completed || 0}/${continuousSession.max_runs || '?'}`);
+    if (continuousSession.current_vision_objective) {
+      console.log(`  Objective:   ${chalk.yellow(continuousSession.current_vision_objective)}`);
+    }
+    if (continuousSession.idle_cycles > 0) {
+      console.log(chalk.dim(`  Idle cycles: ${continuousSession.idle_cycles}/${continuousSession.max_idle_cycles}`));
+    }
+    console.log(chalk.dim('  ' + '─'.repeat(44)));
+    console.log('');
+  }
+
   console.log(`  ${chalk.dim('Project:')}  ${config.project.name}`);
   if (config.project.goal) {
     console.log(`  ${chalk.dim('Goal:')}     ${config.project.goal}`);
@@ -325,6 +367,16 @@ function renderGovernedStatus(context, opts) {
     }
   }
 
+  if (humanEscalation) {
+    console.log('');
+    console.log(`  ${chalk.dim('Human task:')} ${chalk.yellow(humanEscalation.escalation_id)}${humanEscalation.service ? ` (${humanEscalation.service})` : ''}`);
+    console.log(`  ${chalk.dim('Type:')}     ${humanEscalation.type}`);
+    console.log(`  ${chalk.dim('Unblock:')}  ${chalk.cyan(humanEscalation.resolution_command)}`);
+    if (humanEscalation.action) {
+      console.log(`  ${chalk.dim('Task:')}     ${humanEscalation.action}`);
+    }
+  }
+
   if (runtimeGuidance.length > 0) {
     console.log('');
     console.log(`  ${chalk.dim('Runtime guidance:')}`);

package/src/commands/unblock.js

@@ -0,0 +1,67 @@
+import chalk from 'chalk';
+import { loadProjectContext, loadProjectState } from '../lib/config.js';
+import { findCurrentHumanEscalation, getOpenHumanEscalation } from '../lib/human-escalations.js';
+import { resumeCommand } from './resume.js';
+
+export async function unblockCommand(escalationId) {
+  const context = loadProjectContext();
+  if (!context) {
+    console.log(chalk.red('No agentxchain.json found. Run `agentxchain init` first.'));
+    process.exit(1);
+  }
+
+  const { root, config } = context;
+
+  if (config.protocol_mode !== 'governed') {
+    console.log(chalk.red('The unblock command is only available for governed projects.'));
+    process.exit(1);
+  }
+
+  if (!escalationId || !String(escalationId).trim()) {
+    console.log(chalk.red('An escalation id is required. Example: agentxchain unblock hesc_1234'));
+    process.exit(1);
+  }
+
+  const state = loadProjectState(root, config);
+  if (!state) {
+    console.log(chalk.red('No governed state.json found. Run `agentxchain init --governed` first.'));
+    process.exit(1);
+  }
+
+  if (state.status !== 'blocked') {
+    console.log(chalk.red(`Cannot unblock run: status is "${state.status}", expected "blocked".`));
+    process.exit(1);
+  }
+
+  const requested = getOpenHumanEscalation(root, escalationId);
+  if (!requested) {
+    console.log(chalk.red(`No open human escalation found for ${escalationId}.`));
+    process.exit(1);
+  }
+
+  const current = findCurrentHumanEscalation(root, state);
+  if (!current) {
+    console.log(chalk.red('The current blocked run does not have a linked human escalation record.'));
+    process.exit(1);
+  }
+
+  if (current.escalation_id !== requested.escalation_id) {
+    console.log(chalk.red(`Escalation ${escalationId} is not the current blocker for this run.`));
+    console.log(chalk.dim(`Current blocker: ${current.escalation_id}`));
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(chalk.green(`  Unblocking ${requested.escalation_id}`));
+  console.log(chalk.dim(`  Type: ${requested.type}${requested.service ? ` (${requested.service})` : ''}`));
+  if (requested.detail) {
+    console.log(chalk.dim(`  Detail: ${requested.detail}`));
+  }
+  console.log(chalk.dim('  Continuing governed execution...'));
+  console.log('');
+
+  await resumeCommand({
+    _via: 'operator_unblock',
+    turn: requested.turn_id || undefined,
+  });
+}