agentxchain 2.155.51 → 2.155.53

package/package.json

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

package/src/lib/dispatch-bundle.js

@@ -523,6 +523,7 @@ function renderPrompt(role, roleId, turn, state, config, root) {
   if (phaseNames.length > 0) {
     lines.push(`- \`phase_transition_request\`: set to a **phase name** when gate requirements are met, or \`null\`. Valid phases: ${phaseNames.map((p) => `\`"${p}"\``).join(', ')}`);
     lines.push('- **Do NOT use exit gate names** (e.g., `planning_signoff`, `implementation_complete`, `qa_ship_verdict`) as `phase_transition_request` values — those are gate identifiers, not phase names');
+    lines.push('- **Do NOT skip ahead to later phases**. Use only the immediate next phase named below for the current phase.');
   } else {
     lines.push('- `phase_transition_request`: set to next phase name when gate requirements are met, or `null`');
   }

package/src/lib/governed-state.js

@@ -4758,7 +4758,7 @@ function _acceptGovernedTurnLocked(root, config, opts) {
   // early — the agent didn't do the work required for the transition.
   if (turnResult.phase_transition_request && !isIdleExpansionNewIntakeProposal) {
     const preGateResult = evaluatePhaseExit({
-      state,
+      state: { ...state, history: historyEntries },
       config,
       acceptedTurn: turnResult,
       root,

package/src/lib/turn-result-validator.js

@@ -1390,6 +1390,9 @@ export function normalizeTurnResult(tr, config, context = {}) {
     if (allowedNextRoles.length === 0) return null;
     return allowedNextRoles.find((role) => role !== assignedRole) || allowedNextRoles[0] || null;
   };
+  const nextPhaseEntryRole = nextPhase && routing?.[nextPhase]?.entry_role
+    ? routing[nextPhase].entry_role
+    : null;
 
   // ── Rule 0: infer missing status only when intent is unambiguous ──────
   if (!('status' in normalized)) {
@@ -1537,6 +1540,54 @@ export function normalizeTurnResult(tr, config, context = {}) {
   }
 
   // ── Rule 5: correct invalid or non-forward lifecycle requests ─────────
+  if (
+    isKnownPhase &&
+    !isTerminalPhase &&
+    !isReviewOnly &&
+    normalized.status === 'completed' &&
+    typeof normalized.phase_transition_request === 'string' &&
+    !normalized.run_completion_request
+  ) {
+    const requested = normalized.phase_transition_request;
+    const requestedIndex = phaseNames.indexOf(requested);
+    const skipsImmediateNextPhase = requestedIndex > currentPhaseIndex + 1;
+
+    if (skipsImmediateNextPhase && nextPhase) {
+      normalized.phase_transition_request = nextPhase;
+      corrections.push(
+        `phase_transition_request: corrected skip-forward "${requested}" to immediate next phase "${nextPhase}"`
+      );
+      normalizationEvents.push({
+        field: 'phase_transition_request',
+        original_value: requested,
+        normalized_value: nextPhase,
+        rationale: 'skip_forward_phase_corrected_to_next_phase',
+      });
+
+      const proposedRoleIsStalePhase = normalized.proposed_next_role === requested;
+      const proposedRoleIsRoutingIllegal = typeof normalized.proposed_next_role === 'string'
+        && normalized.proposed_next_role !== 'human'
+        && allowedNextRoles.length > 0
+        && !allowedNextRoles.includes(normalized.proposed_next_role);
+      if (
+        nextPhaseEntryRole &&
+        allowedNextRoles.includes(nextPhaseEntryRole) &&
+        (proposedRoleIsStalePhase || proposedRoleIsRoutingIllegal)
+      ) {
+        corrections.push(
+          `proposed_next_role: corrected "${normalized.proposed_next_role}" to entry role "${nextPhaseEntryRole}" for corrected phase "${nextPhase}"`
+        );
+        normalizationEvents.push({
+          field: 'proposed_next_role',
+          original_value: normalized.proposed_next_role,
+          normalized_value: nextPhaseEntryRole,
+          rationale: 'aligned_to_corrected_phase_entry_role',
+        });
+        normalized.proposed_next_role = nextPhaseEntryRole;
+      }
+    }
+  }
+
   if (
     isKnownPhase &&
     isReviewOnly &&