agentxchain 2.12.0 → 2.13.0

package/README.md

@@ -91,6 +91,19 @@ agentxchain approve-completion
 
 Default governed scaffolding configures QA as `api_proxy` with `ANTHROPIC_API_KEY`. For a provider-free walkthrough, switch the QA runtime to `manual` before the QA step. If you override the dev runtime, either include `{prompt}` for argv delivery or set `--dev-prompt-transport` explicitly.
 
+### Multi-repo coordination
+
+For initiatives spanning multiple governed repos, use the coordinator to add cross-repo sequencing and shared gates:
+
+```bash
+npx agentxchain init --governed --template api-service --dir repos/backend -y
+npx agentxchain init --governed --template web-app --dir repos/frontend -y
+agentxchain multi init
+agentxchain multi step --repo backend --role pm
+```
+
+See the [multi-repo quickstart](https://agentxchain.dev/docs/quickstart#multi-repo-cold-start) for the full cold-start walkthrough.
+
 ### Migrate a legacy project
 
 ```bash

package/package.json

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

package/src/lib/coordinator-recovery.js

@@ -66,6 +66,16 @@ function readRepoLocalHistory(repoPath) {
   }
 }
 
+function isAcceptedRepoHistoryEntry(entry) {
+  if (!entry || typeof entry !== 'object') {
+    return false;
+  }
+
+  // Real governed history records the turn outcome in `status` and acceptance
+  // via `accepted_at`. Older coordinator fixtures used `status: "accepted"`.
+  return Boolean(entry.accepted_at) || entry.status === 'accepted';
+}
+
 // ── Divergence Detection ────────────────────────────────────────────────────
 
 /**
@@ -166,7 +176,7 @@ export function detectDivergence(workspacePath, state, config) {
       // Read repo-local history to determine what happened
       const repoHistory = readRepoLocalHistory(repo.resolved_path);
       const turnAccepted = repoHistory.some(
-        e => e?.turn_id === dispatch.repo_turn_id && e?.status === 'accepted'
+        e => e?.turn_id === dispatch.repo_turn_id && isAcceptedRepoHistoryEntry(e)
       );
       const turnRejected = repoHistory.some(
         e => e?.turn_id === dispatch.repo_turn_id && e?.status === 'rejected'
@@ -279,7 +289,7 @@ export function resyncFromRepoAuthority(workspacePath, state, config) {
 
     const repoHistory = readRepoLocalHistory(repo.resolved_path);
     const acceptedEntry = repoHistory.find(
-      e => e?.turn_id === dispatch.repo_turn_id && e?.status === 'accepted'
+      e => e?.turn_id === dispatch.repo_turn_id && isAcceptedRepoHistoryEntry(e)
     );
 
     if (acceptedEntry) {

package/src/lib/reference-conformance-adapter.js

@@ -1,7 +1,7 @@
 import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync, unlinkSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { tmpdir } from 'node:os';
-import { evaluatePhaseExit } from './gate-evaluator.js';
+import { evaluatePhaseExit, evaluateRunCompletion } from './gate-evaluator.js';
 import {
   approvePhaseTransition,
   approveRunCompletion,
@@ -708,6 +708,51 @@ function executeFixtureOperation(workspace, fixture) {
       };
     }
 
+    case 'evaluate_run_completion': {
+      const state = readJson(join(root, '.agentxchain', 'state.json'));
+      const acceptedTurn = {
+        run_completion_request: fixture.setup.turn_result?.run_completion_request ?? true,
+        verification: fixture.setup.turn_result?.verification || { status: 'pass' },
+      };
+      const result = evaluateRunCompletion({
+        state,
+        config: fixtureConfig,
+        acceptedTurn,
+        root,
+      });
+
+      if (result.action === 'awaiting_human_approval') {
+        return {
+          result: 'success',
+          action: result.action,
+          new_status: 'paused',
+          pending_run_completion: {
+            phase: state.phase,
+            gate: result.gate_id,
+          },
+        };
+      }
+
+      if (result.action === 'complete') {
+        return {
+          result: 'success',
+          action: result.action,
+          new_status: 'completed',
+        };
+      }
+
+      return {
+        result: 'success',
+        action: result.action,
+        state_unchanged: true,
+        reason: result.missing_files.length > 0
+          ? 'requires_files predicate failed'
+          : result.missing_verification
+            ? 'requires_verification_pass predicate failed'
+            : (result.reasons[0] || null),
+      };
+    }
+
     case 'append_decision': {
       const ledgerPath = join(root, '.agentxchain', 'decision-ledger.jsonl');
       const existingLedger = readJsonl(ledgerPath);