agentxchain 2.112.0 → 2.113.0

package/bin/agentxchain.js

@@ -122,7 +122,7 @@ import { eventsCommand } from '../src/commands/events.js';
 import { connectorCheckCommand } from '../src/commands/connector.js';
 import { scheduleDaemonCommand, scheduleListCommand, scheduleRunDueCommand, scheduleStatusCommand } from '../src/commands/schedule.js';
 import { chainLatestCommand, chainListCommand, chainShowCommand } from '../src/commands/chain.js';
-import { missionAttachChainCommand, missionListCommand, missionShowCommand, missionStartCommand } from '../src/commands/mission.js';
+import { missionAttachChainCommand, missionListCommand, missionPlanApproveCommand, missionPlanCommand, missionPlanLaunchCommand, missionPlanListCommand, missionPlanShowCommand, missionShowCommand, missionStartCommand } from '../src/commands/mission.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -457,6 +457,53 @@ missionCmd
   .option('-d, --dir <path>', 'Project directory')
   .action(missionAttachChainCommand);
 
+const missionPlanCmd = missionCmd
+  .command('plan [mission_id]')
+  .description('Generate a decomposition plan for a mission (default: latest mission)')
+  .option('--constraint <text>', 'Add a constraint to the planner (repeatable)', collectOption, [])
+  .option('--role-hint <role>', 'Hint available roles to the planner (repeatable)', collectOption, [])
+  .option('-j, --json', 'Output as JSON')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(missionPlanCommand);
+
+missionPlanCmd
+  .command('show [plan_id]')
+  .description('Show a decomposition plan (default: latest plan)')
+  .option('-m, --mission <mission_id>', 'Explicit mission ID')
+  .option('-j, --json', 'Output as JSON')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(missionPlanShowCommand);
+
+missionPlanCmd
+  .command('approve [plan_id]')
+  .description('Approve a decomposition plan (default: latest plan)')
+  .option('-m, --mission <mission_id>', 'Explicit mission ID')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(missionPlanApproveCommand);
+
+missionPlanCmd
+  .command('launch [plan_id]')
+  .description('Launch a workstream from an approved plan (default: latest plan)')
+  .requiredOption('-w, --workstream <id>', 'Workstream ID to launch')
+  .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')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(missionPlanLaunchCommand);
+
+missionPlanCmd
+  .command('list')
+  .description('List all plans for a mission')
+  .option('-m, --mission <mission_id>', 'Explicit mission ID')
+  .option('-l, --limit <n>', 'Max plans to show (default: 20)')
+  .option('-j, --json', 'Output as JSON')
+  .option('-d, --dir <path>', 'Project directory')
+  .action(missionPlanListCommand);
+
+function collectOption(value, previous) {
+  return previous.concat([value]);
+}
+
 program
   .command('validate')
   .description('Validate project protocol artifacts')

package/dashboard/app.js

@@ -37,7 +37,7 @@ const VIEWS = {
   'cross-repo': { fetch: ['coordinatorState', 'coordinatorHistory'], render: renderCrossRepo },
   blockers: { fetch: ['coordinatorBlockers'], render: renderBlockers },
   artifacts: { fetch: ['workflowKitArtifacts'], render: renderArtifacts },
-  mission: { fetch: ['missions'], render: renderMission },
+  mission: { fetch: ['missions', 'plans'], render: renderMission },
   chain: { fetch: ['chainReports'], render: renderChain },
   'run-history': { fetch: ['runHistory'], render: renderRunHistory },
   timeouts: { fetch: ['timeouts'], render: renderTimeouts },
@@ -63,6 +63,7 @@ const API_MAP = {
   coordinatorRepoStatusRows: '/api/coordinator/repo-status',
   workflowKitArtifacts: '/api/workflow-kit-artifacts',
   missions: '/api/missions',
+  plans: '/api/plans',
   chainReports: '/api/chain-reports',
   connectors: '/api/connectors',
   runHistory: '/api/run-history',

package/dashboard/components/mission.js

@@ -132,7 +132,178 @@ function renderRecentMissions(missions) {
   return html;
 }
 
-export function render({ missions }) {
+function formatPlanStatus(status) {
+  switch (status) {
+    case 'proposed':
+      return badge('proposed', '#38bdf8');
+    case 'approved':
+      return badge('approved', 'var(--green)');
+    case 'superseded':
+      return badge('superseded', 'var(--text-dim)');
+    case 'needs_attention':
+      return badge('needs attention', 'var(--yellow)');
+    default:
+      return badge(status || 'unknown', 'var(--text-dim)');
+  }
+}
+
+function formatLaunchStatus(status) {
+  switch (status) {
+    case 'ready':
+      return badge('ready', 'var(--green)');
+    case 'blocked':
+      return badge('blocked', 'var(--red)');
+    case 'launched':
+      return badge('launched', '#38bdf8');
+    case 'completed':
+      return badge('completed', 'var(--green)');
+    case 'needs_attention':
+      return badge('needs attention', 'var(--yellow)');
+    default:
+      return badge(status || 'unknown', 'var(--text-dim)');
+  }
+}
+
+function renderLatestPlan(plan) {
+  if (!plan) {
+    return `<div class="section"><h3>Latest Plan</h3><p class="section-subtitle">No decomposition plan found. Run <code>agentxchain mission plan &lt;mission_id&gt;</code> to generate one.</p></div>`;
+  }
+
+  const workstreams = Array.isArray(plan.workstreams) ? plan.workstreams : [];
+  const launchRecords = Array.isArray(plan.launch_records) ? plan.launch_records : [];
+  const statusCounts = plan.workstream_status_counts || {};
+
+  let html = `<div class="section"><h3>Latest Plan</h3><dl class="detail-list">`;
+  html += `<dt>Plan ID</dt><dd class="mono" title="${esc(plan.plan_id || '')}">${esc(truncateId(plan.plan_id, 30))}</dd>`;
+  html += `<dt>Status</dt><dd>${formatPlanStatus(plan.status)}</dd>`;
+  html += `<dt>Mission</dt><dd class="mono">${esc(plan.mission_id || '—')}</dd>`;
+  html += `<dt>Created</dt><dd>${formatDate(plan.created_at)}</dd>`;
+  if (plan.approved_at) {
+    html += `<dt>Approved</dt><dd>${formatDate(plan.approved_at)}</dd>`;
+  }
+  html += `<dt>Workstreams</dt><dd>${plan.workstream_count || 0}</dd>`;
+  html += `<dt>Launched</dt><dd>${plan.launch_record_count || 0}</dd>`;
+  if (Object.keys(statusCounts).length > 0) {
+    const countsStr = Object.entries(statusCounts).map(([k, v]) => `${k}: ${v}`).join(', ');
+    html += `<dt>Status Breakdown</dt><dd>${esc(countsStr)}</dd>`;
+  }
+  if (plan.supersedes_plan_id) {
+    html += `<dt>Supersedes</dt><dd class="mono">${esc(truncateId(plan.supersedes_plan_id, 30))}</dd>`;
+  }
+  html += `</dl></div>`;
+
+  // Workstreams table
+  if (workstreams.length > 0) {
+    html += `<div class="section"><h3>Workstreams</h3>
+      <table class="data-table">
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Status</th>
+            <th>Roles</th>
+            <th>Phases</th>
+            <th>Dependencies</th>
+          </tr>
+        </thead>
+        <tbody>`;
+
+    workstreams.forEach((ws, index) => {
+      const roles = Array.isArray(ws.roles) ? ws.roles.join(', ') : '—';
+      const phases = Array.isArray(ws.phases) ? ws.phases.join(', ') : '—';
+      const deps = Array.isArray(ws.depends_on) && ws.depends_on.length > 0 ? ws.depends_on.join(', ') : 'none';
+
+      html += `<tr>
+        <td style="color:var(--text-dim)">${index + 1}</td>
+        <td class="mono">${esc(ws.workstream_id || '—')}</td>
+        <td>${esc(ws.title || '—')}</td>
+        <td>${formatLaunchStatus(ws.launch_status)}</td>
+        <td>${esc(roles)}</td>
+        <td>${esc(phases)}</td>
+        <td class="mono">${esc(deps)}</td>
+      </tr>`;
+    });
+
+    html += '</tbody></table></div>';
+  }
+
+  // Launch records table
+  if (launchRecords.length > 0) {
+    html += `<div class="section"><h3>Launch Records</h3>
+      <table class="data-table">
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>Workstream</th>
+            <th>Chain ID</th>
+            <th>Status</th>
+            <th>Terminal</th>
+            <th>Launched</th>
+            <th>Completed</th>
+          </tr>
+        </thead>
+        <tbody>`;
+
+    launchRecords.forEach((lr, index) => {
+      html += `<tr>
+        <td style="color:var(--text-dim)">${index + 1}</td>
+        <td class="mono">${esc(lr.workstream_id || '—')}</td>
+        <td class="mono" title="${esc(lr.chain_id || '')}">${esc(truncateId(lr.chain_id))}</td>
+        <td>${formatLaunchStatus(lr.status)}</td>
+        <td>${esc(lr.terminal_reason || '—')}</td>
+        <td>${formatDate(lr.launched_at)}</td>
+        <td>${formatDate(lr.completed_at)}</td>
+      </tr>`;
+    });
+
+    html += '</tbody></table></div>';
+  }
+
+  return html;
+}
+
+function renderRecentPlans(plans) {
+  if (!Array.isArray(plans) || plans.length <= 1) {
+    return '';
+  }
+
+  // Skip the first (latest) since it's rendered in detail above
+  const olderPlans = plans.slice(1);
+  if (olderPlans.length === 0) return '';
+
+  let html = `<div class="section"><h3>Previous Plans</h3>
+    <table class="data-table">
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Plan ID</th>
+          <th>Mission</th>
+          <th>Status</th>
+          <th>Workstreams</th>
+          <th>Launched</th>
+          <th>Created</th>
+        </tr>
+      </thead>
+      <tbody>`;
+
+  olderPlans.forEach((plan, index) => {
+    html += `<tr>
+      <td style="color:var(--text-dim)">${index + 1}</td>
+      <td class="mono" title="${esc(plan.plan_id || '')}">${esc(truncateId(plan.plan_id, 20))}</td>
+      <td class="mono">${esc(truncateId(plan.mission_id, 18))}</td>
+      <td>${formatPlanStatus(plan.status)}</td>
+      <td>${plan.workstream_count || 0}</td>
+      <td>${plan.launch_record_count || 0}</td>
+      <td>${formatDate(plan.created_at)}</td>
+    </tr>`;
+  });
+
+  html += '</tbody></table></div>';
+  return html;
+}
+
+export function render({ missions, plans }) {
   if (!missions || typeof missions !== 'object') {
     return `<div class="placeholder"><h2>Mission</h2><p>No mission data available. Create a mission and bind a chain to populate this view.</p></div>`;
   }
@@ -171,6 +342,14 @@ export function render({ missions }) {
   }
 
   html += renderAttachedChains(latest);
+
+  // Plan visibility
+  const planData = plans && typeof plans === 'object' ? plans : null;
+  const latestPlan = planData?.latest || null;
+  const allPlans = Array.isArray(planData?.plans) ? planData.plans : [];
+  html += renderLatestPlan(latestPlan);
+  html += renderRecentPlans(allPlans);
+
   html += renderRecentMissions(missionList);
   html += '</div>';
   return html;

package/package.json

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