agentxchain 2.67.0 → 2.69.0

package/package.json

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

package/src/commands/events.js

@@ -61,7 +61,16 @@ function printEvent(evt) {
   const runId = evt.run_id ? evt.run_id.slice(0, 12) : '—';
   const phase = evt.phase || '—';
   const turnInfo = evt.turn?.role_id ? ` [${evt.turn.role_id}]` : '';
-  console.log(`${chalk.dim(ts)}  ${type}  ${chalk.cyan(runId)}  ${phase}${turnInfo}`);
+  const rejectionDetail = evt.event_type === 'turn_rejected' && evt.payload?.reason
+    ? ` — ${evt.payload.reason}${evt.payload.failed_stage ? ` (${evt.payload.failed_stage})` : ''}`
+    : '';
+  const phaseTransitionDetail = evt.event_type === 'phase_entered' && evt.payload?.from && evt.payload?.to
+    ? ` ${evt.payload.from} → ${evt.payload.to}${evt.payload.trigger ? ` (${evt.payload.trigger})` : ''}`
+    : '';
+  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}${rejectionDetail}${phaseTransitionDetail}${gateFailedDetail}`);
 }
 
 function colorEventType(type) {
@@ -77,6 +86,7 @@ function colorEventType(type) {
     escalation_resolved: chalk.green,
     gate_pending: chalk.yellow,
     gate_approved: chalk.green,
+    gate_failed: chalk.red,
   };
   const colorFn = colors[type] || chalk.white;
   return colorFn(pad(type, 22));

package/src/lib/governed-state.js

@@ -2853,6 +2853,7 @@ function _acceptGovernedTurnLocked(root, config, opts) {
         });
 
         if (gateResult.action === 'advance') {
+          const prevPhase = updatedState.phase;
           updatedState.phase = gateResult.next_phase;
           updatedState.phase_entered_at = now;
           updatedState.last_gate_failure = null;
@@ -2861,6 +2862,18 @@ function _acceptGovernedTurnLocked(root, config, opts) {
             [gateResult.gate_id || 'no_gate']: 'passed',
           };
           updatedState.queued_phase_transition = null;
+          emitRunEvent(root, 'phase_entered', {
+            run_id: updatedState.run_id,
+            phase: updatedState.phase,
+            status: updatedState.status,
+            turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
+            payload: {
+              from: prevPhase,
+              to: gateResult.next_phase,
+              gate_id: gateResult.gate_id || 'no_gate',
+              trigger: 'auto',
+            },
+          });
         } else if (gateResult.action === 'awaiting_human_approval') {
           // Evaluate approval policy — may auto-approve
           const approvalResult = evaluateApprovalPolicy({
@@ -2871,6 +2884,7 @@ function _acceptGovernedTurnLocked(root, config, opts) {
           });
 
           if (approvalResult.action === 'auto_approve') {
+            const prevPhase = updatedState.phase;
             updatedState.phase = gateResult.next_phase;
             updatedState.phase_entered_at = now;
             updatedState.last_gate_failure = null;
@@ -2890,6 +2904,18 @@ function _acceptGovernedTurnLocked(root, config, opts) {
               gate_id: gateResult.gate_id,
               timestamp: now,
             });
+            emitRunEvent(root, 'phase_entered', {
+              run_id: updatedState.run_id,
+              phase: updatedState.phase,
+              status: updatedState.status,
+              turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
+              payload: {
+                from: prevPhase,
+                to: gateResult.next_phase,
+                gate_id: gateResult.gate_id || 'no_gate',
+                trigger: 'auto_approved',
+              },
+            });
           } else {
             updatedState.status = 'paused';
             updatedState.blocked_on = `human_approval:${gateResult.gate_id}`;
@@ -2926,6 +2952,18 @@ function _acceptGovernedTurnLocked(root, config, opts) {
             type: 'gate_failure',
             ...gateFailure,
           });
+          emitRunEvent(root, 'gate_failed', {
+            run_id: updatedState.run_id,
+            phase: updatedState.phase,
+            status: updatedState.status,
+            turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
+            payload: {
+              gate_id: gateResult.gate_id || 'no_gate',
+              from_phase: state.phase,
+              to_phase: gateResult.transition_request || state.queued_phase_transition?.to || null,
+              reasons: gateFailure.reasons || [],
+            },
+          });
         } else if (state.queued_phase_transition) {
           updatedState.queued_phase_transition = null;
         }
@@ -3331,7 +3369,13 @@ export function rejectGovernedTurn(root, config, validationResult, reasonOrOptio
       phase: updatedState.phase,
       status: updatedState.status,
       turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
-      payload: { attempt: currentAttempt, retrying: true },
+      payload: {
+        attempt: currentAttempt,
+        retrying: true,
+        reason: rejectionContext.reason,
+        failed_stage: rejectionContext.failed_stage,
+        ...(rejectionContext.validation_errors?.length ? { validation_errors: rejectionContext.validation_errors } : {}),
+      },
     });
     return {
       ok: true,
@@ -3398,7 +3442,14 @@ export function rejectGovernedTurn(root, config, validationResult, reasonOrOptio
     phase: updatedState.phase,
     status: 'blocked',
     turn: { turn_id: currentTurn.turn_id, role_id: currentTurn.assigned_role },
-    payload: { attempt: currentAttempt, retrying: false, escalated: true },
+    payload: {
+      attempt: currentAttempt,
+      retrying: false,
+      escalated: true,
+      reason: rejectionContext.reason,
+      failed_stage: rejectionContext.failed_stage,
+      ...(rejectionContext.validation_errors?.length ? { validation_errors: rejectionContext.validation_errors } : {}),
+    },
   });
   emitRunEvent(root, 'run_blocked', {
     run_id: updatedState.run_id,
@@ -3527,7 +3578,12 @@ export function approvePhaseTransition(root, config) {
     run_id: updatedState.run_id,
     phase: updatedState.phase,
     status: 'active',
-    payload: { from: transition.from },
+    payload: {
+      from: transition.from,
+      to: transition.to,
+      gate_id: transition.gate || 'no_gate',
+      trigger: 'human_approved',
+    },
   });
 
   // Session checkpoint — non-fatal

package/src/lib/run-events.js

@@ -23,6 +23,7 @@ export const VALID_RUN_EVENTS = [
   'escalation_resolved',
   'gate_pending',
   'gate_approved',
+  'gate_failed',
   'budget_exceeded_warn',
 ];