agentxchain 2.114.0 → 2.115.0

package/bin/agentxchain.js

@@ -491,6 +491,7 @@ missionPlanCmd
   .description('Launch workstream(s) from an approved plan (default: latest plan)')
   .option('-w, --workstream <id>', 'Workstream ID to launch (mutually exclusive with --all-ready)')
   .option('--all-ready', 'Launch all ready workstreams sequentially (mutually exclusive with --workstream)')
+  .option('--retry', 'Retry a failed workstream (requires --workstream, only for needs_attention status)')
   .option('-m, --mission <mission_id>', 'Explicit mission ID')
   .option('--auto-approve', 'Auto-approve run gates while executing the launched workstream')
   .option('-j, --json', 'Output as JSON')

package/package.json

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

package/src/commands/mission.js

@@ -18,6 +18,7 @@ import {
   getReadyWorkstreams,
   getWorkstreamStatusSummary,
   launchWorkstream,
+  retryWorkstream,
   markWorkstreamOutcome,
   loadAllPlans,
   loadLatestPlan,
@@ -423,6 +424,16 @@ export async function missionPlanLaunchCommand(planTarget, opts) {
     process.exit(1);
   }
 
+  if (opts.retry && !opts.workstream) {
+    console.error(chalk.red('--retry requires --workstream <id>. Specify which failed workstream to retry.'));
+    process.exit(1);
+  }
+
+  if (opts.retry && opts.allReady) {
+    console.error(chalk.red('--retry and --all-ready are mutually exclusive. Retry targets a specific workstream.'));
+    process.exit(1);
+  }
+
   if (!opts.allReady && !opts.workstream) {
     console.error(chalk.red('--workstream <id> or --all-ready is required. Specify which workstream(s) to launch.'));
     process.exit(1);
@@ -457,7 +468,9 @@ export async function missionPlanLaunchCommand(planTarget, opts) {
     process.exit(1);
   }
 
-  const launch = launchWorkstream(root, mission.mission_id, plan.plan_id, opts.workstream);
+  const launch = opts.retry
+    ? retryWorkstream(root, mission.mission_id, plan.plan_id, opts.workstream)
+    : launchWorkstream(root, mission.mission_id, plan.plan_id, opts.workstream);
   if (!launch.ok) {
     console.error(chalk.red(launch.error));
     process.exit(1);
@@ -949,6 +962,8 @@ function renderMissionPlanError(error) {
 }
 
 function renderMissionSnapshot(snapshot) {
+  const latestPlan = snapshot.latest_plan || null;
+
   console.log(chalk.bold(`Mission: ${snapshot.mission_id}`));
   console.log('');
   console.log(`  Title:                 ${snapshot.title || '—'}`);
@@ -967,10 +982,19 @@ function renderMissionSnapshot(snapshot) {
     console.log(`  Missing chains:        ${snapshot.missing_chain_ids.join(', ')}`);
   }
 
+  if (latestPlan) {
+    console.log('');
+    console.log(chalk.bold('  Latest plan:'));
+    console.log(`    Plan ID:             ${latestPlan.plan_id || '—'}`);
+    console.log(`    Status:              ${formatPlanStatus(latestPlan.status)}`);
+    console.log(`    Completion:          ${latestPlan.completion_percentage}% (${latestPlan.completed_count}/${latestPlan.workstream_count} completed)`);
+    console.log(`    Workstream summary:  ready ${latestPlan.ready_count}, blocked ${latestPlan.blocked_count}, launched ${latestPlan.launched_count}, completed ${latestPlan.completed_count}, needs_attention ${latestPlan.needs_attention_count}`);
+  }
+
   if (!snapshot.chains || snapshot.chains.length === 0) {
     console.log('');
     console.log(chalk.dim('  No chains attached.'));
-    console.log(chalk.dim('  Use `agentxchain mission attach-chain latest` after a chained run.'));
+    console.log(chalk.dim('  Use `agentxchain run --chain --mission latest` for new work, or `agentxchain mission attach-chain latest` to repair an unbound chain.'));
     return;
   }
 

package/src/lib/dashboard/plan-reader.js

@@ -5,9 +5,7 @@
  * Plans are advisory repo-local artifacts; this reader is not protocol-normative.
  */
 
-import { existsSync, readdirSync } from 'fs';
-import { join } from 'path';
-import { loadAllPlans, loadLatestPlan } from '../mission-plans.js';
+import { buildPlanProgressSummary, loadAllPlans } from '../mission-plans.js';
 import { loadAllMissionArtifacts } from '../missions.js';
 
 /**
@@ -65,28 +63,12 @@ export function readPlanSnapshot(workspacePath, { limit, missionId } = {}) {
  * Build a dashboard-ready summary for a single plan.
  */
 function buildPlanSummary(plan) {
+  const summary = buildPlanProgressSummary(plan);
   const workstreams = Array.isArray(plan.workstreams) ? plan.workstreams : [];
   const launchRecords = Array.isArray(plan.launch_records) ? plan.launch_records : [];
 
-  const statusCounts = {};
-  for (const ws of workstreams) {
-    const status = ws.launch_status || 'unknown';
-    statusCounts[status] = (statusCounts[status] || 0) + 1;
-  }
-
   return {
-    plan_id: plan.plan_id,
-    mission_id: plan.mission_id,
-    status: plan.status,
-    created_at: plan.created_at,
-    updated_at: plan.updated_at,
-    approved_at: plan.approved_at || null,
-    supersedes_plan_id: plan.supersedes_plan_id || null,
-    superseded_by_plan_id: plan.superseded_by_plan_id || null,
-    input_goal: plan.input?.goal || null,
-    workstream_count: workstreams.length,
-    launch_record_count: launchRecords.length,
-    workstream_status_counts: statusCounts,
+    ...summary,
     workstreams: workstreams.map((ws) => ({
       workstream_id: ws.workstream_id,
       title: ws.title,

package/src/lib/mission-plans.js

@@ -306,6 +306,38 @@ export function loadPlan(root, missionId, planId) {
   return plans.find((p) => p.plan_id === planId) || null;
 }
 
+export function buildPlanProgressSummary(plan) {
+  if (!plan || typeof plan !== 'object') return null;
+
+  const workstreams = Array.isArray(plan.workstreams) ? plan.workstreams : [];
+  const launchRecords = Array.isArray(plan.launch_records) ? plan.launch_records : [];
+  const workstreamStatusCounts = getWorkstreamStatusSummary(plan);
+  const completedCount = workstreamStatusCounts.completed || 0;
+
+  return {
+    plan_id: plan.plan_id,
+    mission_id: plan.mission_id,
+    status: plan.status,
+    created_at: plan.created_at,
+    updated_at: plan.updated_at,
+    approved_at: plan.approved_at || null,
+    supersedes_plan_id: plan.supersedes_plan_id || null,
+    superseded_by_plan_id: plan.superseded_by_plan_id || null,
+    input_goal: plan.input?.goal || null,
+    workstream_count: workstreams.length,
+    launch_record_count: launchRecords.length,
+    workstream_status_counts: workstreamStatusCounts,
+    ready_count: workstreamStatusCounts.ready || 0,
+    blocked_count: workstreamStatusCounts.blocked || 0,
+    launched_count: workstreamStatusCounts.launched || 0,
+    completed_count: completedCount,
+    needs_attention_count: workstreamStatusCounts.needs_attention || 0,
+    completion_percentage: workstreams.length === 0
+      ? 0
+      : Math.round((completedCount / workstreams.length) * 100),
+  };
+}
+
 // ── Workstream launch ───────────────────────────────────────────────────────
 
 export function didChainFinishSuccessfully(chainReport) {
@@ -443,6 +475,12 @@ export function markWorkstreamOutcome(root, missionId, planId, workstreamId, { t
         }
       }
     }
+
+    // Auto-complete plan when all workstreams are completed
+    const allCompleted = plan.workstreams.every((w) => w.launch_status === 'completed');
+    if (allCompleted) {
+      plan.status = 'completed';
+    }
   } else {
     ws.launch_status = 'needs_attention';
     plan.status = 'needs_attention';
@@ -454,6 +492,62 @@ export function markWorkstreamOutcome(root, missionId, planId, workstreamId, { t
   return { ok: true, plan, workstream: ws };
 }
 
+/**
+ * Retry a failed workstream by resetting its status and creating a new launch record.
+ *
+ * Only workstreams with launch_status === 'needs_attention' can be retried.
+ * The old launch record is preserved for audit. A new launch record with a new
+ * chain_id is created. If the plan was in 'needs_attention' status, it returns
+ * to 'approved' since the retry represents a new attempt.
+ *
+ * @returns {{ ok: boolean, plan?: object, workstream?: object, chainId?: string, launchRecord?: object, error?: string }}
+ */
+export function retryWorkstream(root, missionId, planId, workstreamId, options = {}) {
+  const plan = loadPlan(root, missionId, planId);
+  if (!plan) {
+    return { ok: false, error: `Plan not found: ${planId}` };
+  }
+
+  const ws = plan.workstreams.find((w) => w.workstream_id === workstreamId);
+  if (!ws) {
+    return { ok: false, error: `Workstream not found: ${workstreamId}` };
+  }
+
+  if (ws.launch_status !== 'needs_attention') {
+    return {
+      ok: false,
+      error: `Workstream ${workstreamId} cannot be retried (status: "${ws.launch_status}"). Only "needs_attention" workstreams can be retried.`,
+    };
+  }
+
+  // Generate new chain ID for the retry
+  const chainId = options.chainId || `chain-${randomUUID().slice(0, 8)}`;
+  const now = new Date().toISOString();
+  const launchRecord = {
+    workstream_id: workstreamId,
+    chain_id: chainId,
+    launched_at: now,
+    status: 'launched',
+    retry: true,
+  };
+
+  if (!Array.isArray(plan.launch_records)) {
+    plan.launch_records = [];
+  }
+  plan.launch_records.push(launchRecord);
+  ws.launch_status = 'launched';
+
+  // Restore plan status from needs_attention to approved (retry in progress)
+  if (plan.status === 'needs_attention') {
+    plan.status = 'approved';
+  }
+
+  plan.updated_at = now;
+  writePlanArtifact(root, missionId, plan);
+
+  return { ok: true, plan, workstream: ws, chainId, launchRecord };
+}
+
 // ── Batch launch helpers ───────────────────────────────────────────────────
 
 /**

package/src/lib/missions.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { loadAllChainReports, loadChainReport, loadLatestChainReport } from './chain-reports.js';
+import { buildPlanProgressSummary, loadLatestPlan } from './mission-plans.js';
 import { getActiveRepoDecisions } from './repo-decisions.js';
 
 const MISSION_ATTENTION_TERMINALS = new Set(['operator_abort', 'parent_validation_failed']);
@@ -139,6 +140,7 @@ export function buildMissionSnapshot(root, missionArtifact) {
   const totalRuns = chains.reduce((sum, chain) => sum + (chain.runs?.length || 0), 0);
   const totalTurns = chains.reduce((sum, chain) => sum + (chain.total_turns || 0), 0);
   const latestChain = chains[0] || null;
+  const latestPlan = loadLatestPlan(root, missionArtifact.mission_id);
   const activeRepoDecisions = getActiveRepoDecisions(root);
 
   return {
@@ -151,6 +153,7 @@ export function buildMissionSnapshot(root, missionArtifact) {
     total_turns: totalTurns,
     latest_chain_id: latestChain?.chain_id || null,
     latest_terminal_reason: latestChain?.terminal_reason || null,
+    latest_plan: buildPlanProgressSummary(latestPlan),
     active_repo_decisions_count: activeRepoDecisions.length,
     chains,
   };