agentxchain 2.116.0 → 2.118.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.118.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {

package/scripts/render-github-release-body.mjs

@@ -70,7 +70,7 @@ function extractAggregateEvidenceLine(text) {
     return best;
   }, null);
 
-  return aggregate.line.replace(/\*\*/g, '').replace(/`/g, '').trim();
+  return aggregate.line.replace(/\*\*/g, '').replace(/`/g, '').replace(/,/g, '').trim();
 }
 
 function getPreviousVersionTag(repoRoot, version) {

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'));