agentxchain 2.65.0 → 2.67.0

package/package.json

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

package/src/commands/accept-turn.js

@@ -167,7 +167,10 @@ export async function acceptTurnCommand(opts = {}) {
     console.log(`  ${chalk.dim('Cost:')}     $${formatUsd(accepted.cost.usd)}`);
   }
   if (accepted?.verification_replay) {
-    console.log(`  ${chalk.dim('Replay:')}   ${accepted.verification_replay.overall} (${accepted.verification_replay.matched_commands}/${accepted.verification_replay.replayed_commands})`);
+    const verifiedAt = accepted.verification_replay.verified_at
+      ? ` at ${accepted.verification_replay.verified_at}`
+      : '';
+    console.log(`  ${chalk.dim('Replay:')}   ${accepted.verification_replay.overall} (${accepted.verification_replay.matched_commands}/${accepted.verification_replay.replayed_commands})${verifiedAt}`);
   }
   if (result.budget_warning) {
     console.log(`  ${chalk.yellow('Budget warning:')} ${result.budget_warning}`);

package/src/commands/status.js

@@ -141,7 +141,16 @@ function renderGovernedStatus(context, opts) {
       const statusLabel = turn.status === 'conflicted'
         ? chalk.red('conflicted')
         : turn.status;
-      console.log(`    ${marker} ${turn.turn_id} — ${chalk.bold(turn.assigned_role)} (${statusLabel}) [attempt ${turn.attempt}]`);
+      let elapsedTag = '';
+      if (turn.started_at) {
+        const elMs = Date.now() - new Date(turn.started_at).getTime();
+        if (elMs >= 0) {
+          const s = Math.floor(elMs / 1000);
+          const m = Math.floor(s / 60);
+          elapsedTag = m > 0 ? ` — ${m}m ${s % 60}s` : ` — ${s}s`;
+        }
+      }
+      console.log(`    ${marker} ${turn.turn_id} — ${chalk.bold(turn.assigned_role)} (${statusLabel}) [attempt ${turn.attempt}]${elapsedTag}`);
       if (turn.status === 'conflicted' && turn.conflict_state) {
         const cs = turn.conflict_state;
         const files = cs.conflict_error?.conflicting_files || [];
@@ -161,6 +170,16 @@ function renderGovernedStatus(context, opts) {
     console.log(`  ${chalk.dim('Role:')}     ${chalk.bold(singleActiveTurn.assigned_role)} (${singleActiveTurn.status})`);
     console.log(`  ${chalk.dim('Runtime:')}  ${singleActiveTurn.runtime_id}`);
     console.log(`  ${chalk.dim('Attempt:')}  ${singleActiveTurn.attempt}`);
+    if (singleActiveTurn.started_at) {
+      const elapsedMs = Date.now() - new Date(singleActiveTurn.started_at).getTime();
+      if (elapsedMs >= 0) {
+        const secs = Math.floor(elapsedMs / 1000);
+        const mins = Math.floor(secs / 60);
+        const remainSecs = secs % 60;
+        const elapsed = mins > 0 ? `${mins}m ${remainSecs}s` : `${remainSecs}s`;
+        console.log(`  ${chalk.dim('Elapsed:')}  ${elapsed}`);
+      }
+    }
     if (singleActiveTurn.status === 'conflicted' && singleActiveTurn.conflict_state) {
       const cs = singleActiveTurn.conflict_state;
       const files = cs.conflict_error?.conflicting_files || [];

package/src/commands/step.js

@@ -1024,7 +1024,10 @@ function printAcceptSummary(result) {
     console.log(`  ${chalk.dim('Cost:')}     $${(accepted.cost.usd || 0).toFixed(2)}`);
   }
   if (accepted?.verification_replay) {
-    console.log(`  ${chalk.dim('Replay:')}   ${accepted.verification_replay.overall} (${accepted.verification_replay.matched_commands}/${accepted.verification_replay.replayed_commands})`);
+    const verifiedAt = accepted.verification_replay.verified_at
+      ? ` at ${accepted.verification_replay.verified_at}`
+      : '';
+    console.log(`  ${chalk.dim('Replay:')}   ${accepted.verification_replay.overall} (${accepted.verification_replay.matched_commands}/${accepted.verification_replay.replayed_commands})${verifiedAt}`);
   }
   console.log('');
 

package/src/commands/turn.js

@@ -119,6 +119,7 @@ function buildArtifactIndex(root, turnId) {
 }
 
 function buildTurnPayload(turnId, turn, state, artifacts, assignment) {
+  const elapsedMs = getElapsedMs(turn.started_at);
   return {
     turn_id: turnId,
     run_id: state.run_id || assignment?.run_id || null,
@@ -127,6 +128,8 @@ function buildTurnPayload(turnId, turn, state, artifacts, assignment) {
     runtime: turn.runtime_id,
     status: turn.status,
     attempt: turn.attempt,
+    started_at: turn.started_at || null,
+    elapsed_ms: elapsedMs,
     dispatch_dir: getDispatchTurnDir(turnId),
     staging_result_path: assignment?.staging_result_path || null,
     active_turn_count: getActiveTurnCount(state),
@@ -140,6 +143,7 @@ function buildTurnPayload(turnId, turn, state, artifacts, assignment) {
 }
 
 function printTurnSummary(turnId, turn, state, artifacts, assignment) {
+  const elapsedMs = getElapsedMs(turn.started_at);
   console.log('');
   console.log(chalk.bold(`  Turn: ${chalk.cyan(turnId)}`));
   console.log(chalk.dim('  ' + '─'.repeat(44)));
@@ -149,6 +153,12 @@ function printTurnSummary(turnId, turn, state, artifacts, assignment) {
   console.log(`  ${chalk.dim('Runtime:')}  ${turn.runtime_id}`);
   console.log(`  ${chalk.dim('Status:')}   ${turn.status}`);
   console.log(`  ${chalk.dim('Attempt:')}  ${turn.attempt}`);
+  if (turn.started_at) {
+    console.log(`  ${chalk.dim('Started:')}  ${turn.started_at}`);
+  }
+  if (elapsedMs != null) {
+    console.log(`  ${chalk.dim('Elapsed:')}  ${formatElapsed(elapsedMs)}`);
+  }
   console.log(`  ${chalk.dim('Dispatch:')} ${getDispatchTurnDir(turnId)}`);
   if (assignment?.staging_result_path) {
     console.log(`  ${chalk.dim('Staging:')}  ${assignment.staging_result_path}`);
@@ -208,3 +218,22 @@ function readJsonArtifact(absPath) {
     return null;
   }
 }
+
+function getElapsedMs(startedAt) {
+  if (typeof startedAt !== 'string') {
+    return null;
+  }
+  const started = Date.parse(startedAt);
+  if (!Number.isFinite(started)) {
+    return null;
+  }
+  const elapsed = Date.now() - started;
+  return elapsed >= 0 ? elapsed : null;
+}
+
+function formatElapsed(ms) {
+  const totalSeconds = Math.floor(ms / 1000);
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}

package/src/lib/context-compressor.js

@@ -15,6 +15,9 @@ import { renderContextSections } from './context-section-parser.js';
 const COMPRESSION_STEPS = [
   { id: 'budget', action: 'drop' },
   { id: 'phase_gate_status', action: 'drop' },
+  { id: 'decision_history', action: 'drop' },
+  { id: 'workflow_artifacts', action: 'drop' },
+  { id: 'last_turn_verification', action: 'drop' },
   { id: 'gate_required_files', action: 'drop' },
   { id: 'last_turn_objections', action: 'drop' },
   { id: 'last_turn_decisions', action: 'drop' },

package/src/lib/context-section-parser.js

@@ -3,11 +3,14 @@ const CONTEXT_TITLE = '# Execution Context';
 const SECTION_DEFINITIONS = [
   { id: 'current_state', header: 'Current State', required: true },
   { id: 'budget', header: null, required: false },
+  { id: 'project_goal', header: 'Project Goal', required: true },
+  { id: 'inherited_run_context', header: 'Inherited Run Context', required: true },
   { id: 'last_turn_header', header: 'Last Accepted Turn', required: true },
   { id: 'last_turn_summary', header: null, required: false },
   { id: 'last_turn_decisions', header: null, required: false },
   { id: 'last_turn_objections', header: null, required: false },
   { id: 'last_turn_verification', header: null, required: false },
+  { id: 'decision_history', header: 'Decision History', required: false },
   { id: 'blockers', header: 'Blockers', required: true },
   { id: 'escalation', header: 'Escalation', required: true },
   { id: 'workflow_artifacts', header: 'Workflow Artifacts', required: false },
@@ -79,6 +82,8 @@ export function renderContextSections(sections) {
     sectionMap.get('budget')?.content,
   ]);
 
+  appendTopLevelSection(lines, 'Project Goal', [sectionMap.get('project_goal')?.content]);
+  appendTopLevelSection(lines, 'Inherited Run Context', [sectionMap.get('inherited_run_context')?.content]);
   appendTopLevelSection(lines, 'Last Accepted Turn', [
     sectionMap.get('last_turn_header')?.content,
     sectionMap.get('last_turn_summary')?.content,
@@ -87,6 +92,7 @@ export function renderContextSections(sections) {
     sectionMap.get('last_turn_verification')?.content,
   ]);
 
+  appendTopLevelSection(lines, 'Decision History', [sectionMap.get('decision_history')?.content]);
   appendTopLevelSection(lines, 'Blockers', [sectionMap.get('blockers')?.content]);
   appendTopLevelSection(lines, 'Escalation', [sectionMap.get('escalation')?.content]);
   appendTopLevelSection(lines, 'Workflow Artifacts', [sectionMap.get('workflow_artifacts')?.content]);

package/src/lib/dispatch-bundle.js

@@ -30,6 +30,8 @@ import {
 } from './turn-paths.js';
 
 const HISTORY_PATH = '.agentxchain/history.jsonl';
+const LEDGER_PATH = '.agentxchain/decision-ledger.jsonl';
+const DECISION_HISTORY_MAX_ENTRIES = 50;
 const FILE_PREVIEW_MAX_FILES = 5;
 const FILE_PREVIEW_MAX_LINES = 120;
 const PROPOSAL_SUMMARY_MAX_LINES = 80;
@@ -691,6 +693,12 @@ function renderContext(state, config, root, turn, role) {
     }
   }
 
+  // Cumulative decision history from the decision ledger
+  const decisionHistoryLines = renderDecisionHistory(root, warnings);
+  if (decisionHistoryLines.length > 0) {
+    lines.push(...decisionHistoryLines);
+  }
+
   // Blockers / escalation
   if (state.blocked_on) {
     lines.push('## Blockers');
@@ -1102,6 +1110,68 @@ function writeDispatchIndex(root, state, warningsByTurn = {}) {
   );
 }
 
+/**
+ * Read agent-authored decisions from the decision ledger and render as a
+ * markdown section for CONTEXT.md.
+ *
+ * Returns an array of markdown lines (including the ## header) or an empty
+ * array when there are no agent-authored decisions.
+ */
+function renderDecisionHistory(root, warnings = []) {
+  const ledgerPath = join(root, LEDGER_PATH);
+  if (!existsSync(ledgerPath)) return [];
+
+  let content;
+  try {
+    content = readFileSync(ledgerPath, 'utf8').trim();
+  } catch (err) {
+    warnings.push(`Failed to read ${LEDGER_PATH}: ${err.message}`);
+    return [];
+  }
+  if (!content) return [];
+
+  // Parse all lines, skip malformed ones
+  const rawLines = content.split('\n');
+  const agentDecisions = [];
+  for (const line of rawLines) {
+    if (!line.trim()) continue;
+    try {
+      const entry = JSON.parse(line);
+      // Agent-authored decisions have an `id` field; system entries do not
+      if (entry.id) {
+        agentDecisions.push(entry);
+      }
+    } catch {
+      warnings.push(`Skipped malformed decision-ledger line`);
+    }
+  }
+
+  if (agentDecisions.length === 0) return [];
+
+  const totalCount = agentDecisions.length;
+  const displayed = totalCount > DECISION_HISTORY_MAX_ENTRIES
+    ? agentDecisions.slice(totalCount - DECISION_HISTORY_MAX_ENTRIES)
+    : agentDecisions;
+
+  const lines = [];
+  lines.push('## Decision History');
+  lines.push('');
+  lines.push('| ID | Phase | Role | Statement |');
+  lines.push('|----|-------|------|-----------|');
+  for (const d of displayed) {
+    // Escape pipes in statement to avoid breaking the table
+    const stmt = (d.statement || '').replace(/\|/g, '\\|').replace(/\n/g, ' ');
+    lines.push(`| ${d.id} | ${d.phase || ''} | ${d.role || ''} | ${stmt} |`);
+  }
+  if (totalCount > DECISION_HISTORY_MAX_ENTRIES) {
+    lines.push('');
+    lines.push(`_Showing ${DECISION_HISTORY_MAX_ENTRIES} of ${totalCount} decisions. Full ledger at ${LEDGER_PATH}._`);
+  }
+  lines.push('');
+
+  return lines;
+}
+
 function readLastHistoryEntry(root, warnings = []) {
   const historyPath = join(root, HISTORY_PATH);
   if (!existsSync(historyPath)) return null;

package/src/lib/governed-state.js

@@ -2590,7 +2590,9 @@ function _acceptGovernedTurnLocked(root, config, opts) {
     accepted_sequence: acceptedSequence,
     concurrent_with: Array.isArray(currentTurn.concurrent_with) ? currentTurn.concurrent_with : [],
     cost: turnResult.cost || {},
+    ...(currentTurn.started_at ? { started_at: currentTurn.started_at } : {}),
     accepted_at: now,
+    ...(currentTurn.started_at ? { duration_ms: Math.max(0, new Date(now).getTime() - new Date(currentTurn.started_at).getTime()) } : {}),
   };
   const nextHistoryEntries = [...historyEntries, historyEntry];
   // Build ledger entries for the journal
@@ -3081,11 +3083,17 @@ function _acceptGovernedTurnLocked(root, config, opts) {
   }
 
   // Emit turn_accepted event to local log.
+  const turnAcceptedPayload = {};
+  if (currentTurn.started_at) {
+    turnAcceptedPayload.started_at = currentTurn.started_at;
+    turnAcceptedPayload.duration_ms = Math.max(0, new Date(now).getTime() - new Date(currentTurn.started_at).getTime());
+  }
   emitRunEvent(root, 'turn_accepted', {
     run_id: updatedState.run_id,
     phase: updatedState.phase,
     status: updatedState.status,
     turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
+    payload: turnAcceptedPayload,
   });
 
   if (updatedState.status === 'blocked') {

package/src/lib/report.js

@@ -66,6 +66,25 @@ function formatUsd(value) {
   return typeof value === 'number' ? `$${value.toFixed(2)}` : 'n/a';
 }
 
+function formatDurationCompact(ms) {
+  if (typeof ms !== 'number' || !Number.isFinite(ms) || ms < 0) return null;
+  if (ms < 1000) return `${ms}ms`;
+  const secs = Math.floor(ms / 1000);
+  if (secs < 60) return `${secs}s`;
+  const mins = Math.floor(secs / 60);
+  const remainSecs = secs % 60;
+  if (mins < 60) return `${mins}m ${remainSecs}s`;
+  const hrs = Math.floor(mins / 60);
+  const remainMins = mins % 60;
+  return `${hrs}h ${remainMins}m`;
+}
+
+function formatTurnTimelineTime(turn) {
+  const acceptedAt = turn.accepted_at || 'n/a';
+  const duration = formatDurationCompact(turn.duration_ms);
+  return duration ? `${acceptedAt} (${duration})` : acceptedAt;
+}
+
 function formatStatusCounts(statusCounts) {
   const entries = Object.entries(statusCounts || {}).sort(([left], [right]) => left.localeCompare(right, 'en'));
   if (entries.length === 0) return 'none';
@@ -99,6 +118,8 @@ function extractHistoryTimeline(artifact) {
       decisions: Array.isArray(e.decisions) ? e.decisions.map((d) => d?.id || d).filter(Boolean) : [],
       objections: Array.isArray(e.objections) ? e.objections.map((o) => o?.id || o).filter(Boolean) : [],
       cost_usd: typeof e.cost?.total_usd === 'number' ? e.cost.total_usd : null,
+      started_at: e.started_at || null,
+      duration_ms: typeof e.duration_ms === 'number' ? e.duration_ms : null,
       accepted_at: e.accepted_at || null,
     }));
 }
@@ -943,7 +964,7 @@ export function formatGovernanceReportText(report) {
         const cost = t.cost_usd != null ? formatUsd(t.cost_usd) : 'n/a';
         const phase = t.phase_transition ? `${t.phase || '?'} -> ${t.phase_transition}` : (t.phase || '?');
         const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling-attributed)` : '';
-        lines.push(`  ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count}${siblingNote} | cost: ${cost} | ${t.accepted_at || 'n/a'}`);
+        lines.push(`  ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count}${siblingNote} | cost: ${cost} | ${formatTurnTimelineTime(t)}`);
       }
     }
 
@@ -1353,7 +1374,7 @@ export function formatGovernanceReportMarkdown(report) {
         const phase = t.phase_transition ? `${t.phase || '?'} → ${t.phase_transition}` : (t.phase || '?');
         const summary = (t.summary || '(no summary)').replace(/\|/g, '\\|');
         const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling)` : '';
-        lines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${t.accepted_at || 'n/a'} |`);
+        lines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${formatTurnTimelineTime(t).replace(/\|/g, '\\|')} |`);
       }
     }
 
@@ -1611,7 +1632,7 @@ export function formatGovernanceReportMarkdown(report) {
         const phase = t.phase_transition ? `${t.phase || '?'} → ${t.phase_transition}` : (t.phase || '?');
         const summary = (t.summary || '(no summary)').replace(/\|/g, '\\|');
         const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling)` : '';
-        repoLines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${t.accepted_at || 'n/a'} |`);
+        repoLines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${formatTurnTimelineTime(t).replace(/\|/g, '\\|')} |`);
       }
     }
     if (repo.decisions && repo.decisions.length > 0) {

package/src/lib/verification-replay.js

@@ -3,11 +3,13 @@ import { spawnSync } from 'node:child_process';
 export const DEFAULT_VERIFICATION_REPLAY_TIMEOUT_MS = 30_000;
 
 export function replayVerificationMachineEvidence({ root, verification, timeoutMs = DEFAULT_VERIFICATION_REPLAY_TIMEOUT_MS }) {
+  const verifiedAt = new Date().toISOString();
   const machineEvidence = Array.isArray(verification?.machine_evidence)
     ? verification.machine_evidence
     : [];
 
   const payload = {
+    verified_at: verifiedAt,
     timeout_ms: timeoutMs,
     overall: 'not_reproducible',
     replayed_commands: 0,
@@ -59,6 +61,7 @@ export function summarizeVerificationReplay(payload) {
   }
 
   return {
+    verified_at: payload.verified_at || null,
     overall: payload.overall,
     replayed_commands: payload.replayed_commands || 0,
     matched_commands: payload.matched_commands || 0,