agentxchain 2.65.0 → 2.66.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.65.0",
+  "version": "2.66.1",
   "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/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/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/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,