agentxchain 2.154.10 → 2.155.0

package/bin/agentxchain.js

@@ -759,6 +759,7 @@ program
   .option('--poll-seconds <n>', 'Seconds between idle-detection cycles in continuous mode (default: 30)', parseInt)
   .option('--triage-approval <mode>', 'Triage policy for vision-derived intents: auto or human (default: config or auto)')
   .option('--max-idle-cycles <n>', 'Stop after N consecutive idle cycles with no derivable work (default: 3)', parseInt)
+  .option('--on-idle <mode>', 'Continuous idle policy: exit, perpetual, or human_review (default: config or exit)')
   .option('--session-budget <usd>', 'Cumulative session-level budget cap in USD for continuous mode', parseFloat)
   .option('--auto-retry-on-ghost', 'Enable bounded automatic retry for continuous-mode startup ghost turns')
   .option('--no-auto-retry-on-ghost', 'Disable bounded automatic retry for continuous-mode startup ghost turns')

package/package.json

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

package/src/commands/init.js

@@ -12,6 +12,29 @@ import { buildGovernedPlanningArtifacts, interpolateTemplateContent } from '../l
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = join(__dirname, '../templates');
 
+const PM_IDLE_EXPANSION_PROMPT = `# Idle-Expansion Charter
+
+You are running in IDLE-EXPANSION mode. The continuous loop found no directly derivable work after the configured idle threshold. Your task is to decide the next governed product increment from the configured sources, or to declare the product vision exhausted.
+
+Read these sources in order:
+
+1. \`.planning/VISION.md\` (read-only; never modify)
+2. \`.planning/ROADMAP.md\`
+3. \`.planning/SYSTEM_SPEC.md\`
+4. \`.agentxchain/intake/\`
+5. \`.planning/acceptance-matrix.md\` when present
+
+You must emit exactly one structured \`idle_expansion_result\` in the turn result:
+
+1. \`kind: "new_intake_intent"\`
+   Produce one concrete intake intent with \`title\`, \`priority\`, \`template\`, \`charter\`, \`acceptance_contract\`, and \`vision_traceability\`. The intent must cite at least one existing \`VISION.md\` heading or goal it advances. Do not invent work outside the human-owned vision.
+
+2. \`kind: "vision_exhausted"\`
+   Classify every top-level \`VISION.md\` heading as \`complete\`, \`deferred\`, or \`out_of_scope\`, with a reason for each. Use this only when no next governed product increment can be justified from the configured sources.
+
+Do not modify \`.planning/VISION.md\`. If you cannot cite \`VISION.md\` for a proposed intent, return \`vision_exhausted\` or a deferred classification instead of expanding scope.
+`;
+
 const DEFAULT_AGENTS = {
   pm: {
     name: 'Product Manager',
@@ -906,6 +929,7 @@ export function scaffoldGoverned(dir, projectName, projectId, templateId = 'gene
     const prompt = appendPromptOverride(basePrompt, template.prompt_overrides?.[roleId]);
     writeFileSync(join(dir, '.agentxchain', 'prompts', `${roleId}.md`), prompt);
   }
+  writeFileSync(join(dir, '.agentxchain', 'prompts', 'pm-idle-expansion.md'), PM_IDLE_EXPANSION_PROMPT);
 
   // Planning artifacts
   for (const artifact of buildGovernedPlanningArtifacts({

package/src/commands/run.js

@@ -258,6 +258,7 @@ export async function executeGovernedRun(context, opts = {}) {
     // ── Track first-call for --role override ────────────────────────────────
     let firstSelectRole = true;
     let qaMissingCredentialsFallback = null;
+    const acceptedTurnResults = [];
 
     // ── Callbacks ───────────────────────────────────────────────────────────
     const callbacks = {
@@ -573,7 +574,15 @@ export async function executeGovernedRun(context, opts = {}) {
       return approved;
     },
 
-    async afterAccept({ turn }) {
+    async afterAccept({ turn, acceptResult }) {
+      if (acceptResult) {
+        acceptedTurnResults.push({
+          turn_id: turn.turn_id,
+          accepted: acceptResult.accepted || null,
+          turn_result: acceptResult.validation?.turnResult || null,
+          state: acceptResult.state || null,
+        });
+      }
       if (!autoCheckpoint) {
         return { ok: true };
       }
@@ -688,7 +697,10 @@ export async function executeGovernedRun(context, opts = {}) {
     const successReasons = new Set(['completed', 'gate_held', 'caller_stopped', 'max_turns_reached']);
     return {
       exitCode: result.ok || successReasons.has(result.stop_reason) ? 0 : 1,
-      result,
+      result: {
+        ...result,
+        accepted_turn_results: acceptedTurnResults,
+      },
       skipped: false,
       skipReason: null,
       provenance: provenance || null,

package/src/commands/schedule.js

@@ -21,8 +21,8 @@ import {
   advanceContinuousRunOnce,
   resolveContinuousOptions,
 } from '../lib/continuous-run.js';
-import { resolveVisionPath } from '../lib/vision-reader.js';
-import { existsSync } from 'node:fs';
+import { captureVisionHeadingsSnapshot, computeVisionContentSha, resolveVisionPath } from '../lib/vision-reader.js';
+import { existsSync, readFileSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 
 function loadScheduleContext() {
@@ -349,7 +349,7 @@ async function runDueSchedules(context, opts = {}) {
 // ---------------------------------------------------------------------------
 
 function isSessionTerminal(session) {
-  return ['completed', 'idle_exit', 'failed', 'stopped'].includes(session?.status);
+  return ['completed', 'idle_exit', 'failed', 'stopped', 'vision_exhausted', 'vision_expansion_exhausted'].includes(session?.status);
 }
 
 function getContinuousEnabledScheduleIds(config) {
@@ -393,7 +393,7 @@ export function selectContinuousScheduleEntry(root, config, opts = {}) {
   return { id: dueEntry.id, schedule: config.schedules[dueEntry.id], due: dueEntry.due };
 }
 
-function createScheduleOwnedSession(schedule, scheduleId) {
+function createScheduleOwnedSession(schedule, scheduleId, snapshotOpts = {}) {
   return {
     session_id: `cont-${randomUUID().slice(0, 8)}`,
     started_at: new Date().toISOString(),
@@ -410,6 +410,10 @@ function createScheduleOwnedSession(schedule, scheduleId) {
     per_session_max_usd: schedule.continuous.per_session_max_usd || null,
     cumulative_spent_usd: 0,
     budget_exhausted: false,
+    vision_headings_snapshot: snapshotOpts.visionHeadingsSnapshot || null,
+    vision_sha_at_snapshot: snapshotOpts.visionShaAtSnapshot || null,
+    expansion_iteration: 0,
+    _vision_stale_warned_shas: [],
   };
 }
 
@@ -453,7 +457,11 @@ async function advanceScheduleContinuousSession(context, entry, opts = {}) {
       return { ok: false, action: 'failed', reason: `VISION.md not found at ${absVision}` };
     }
 
-    session = createScheduleOwnedSession(schedule, scheduleId);
+    const visionContent = readFileSync(absVision, 'utf8');
+    session = createScheduleOwnedSession(schedule, scheduleId, {
+      visionHeadingsSnapshot: captureVisionHeadingsSnapshot(visionContent),
+      visionShaAtSnapshot: computeVisionContentSha(visionContent),
+    });
     writeContinuousSession(root, session);
     log(chalk.cyan(`Started schedule-owned continuous session: ${session.session_id} (schedule: ${scheduleId})`));
 
@@ -467,13 +475,17 @@ async function advanceScheduleContinuousSession(context, entry, opts = {}) {
   }
 
   // Build contOpts from schedule continuous config
-  const contOpts = {
-    visionPath: contConfig.vision_path,
-    maxRuns: contConfig.max_runs,
-    maxIdleCycles: contConfig.max_idle_cycles,
-    triageApproval: contConfig.triage_approval,
-    perSessionMaxUsd: contConfig.per_session_max_usd || null,
-  };
+  const contOpts = resolveContinuousOptions({ continuous: true }, {
+    ...config,
+    run_loop: {
+      ...(config.run_loop || {}),
+      continuous: {
+        ...(config.run_loop?.continuous || {}),
+        ...contConfig,
+        enabled: true,
+      },
+    },
+  });
 
   // Advance one step
   const step = await advanceContinuousRunOnce(context, session, contOpts, executeGovernedRun, log);
@@ -484,9 +496,14 @@ async function advanceScheduleContinuousSession(context, entry, opts = {}) {
     idle_exit: 'continuous_idle_exit',
     failed: 'continuous_failed',
     blocked: 'continuous_blocked',
+    vision_exhausted: 'continuous_vision_exhausted',
+    vision_expansion_exhausted: 'continuous_vision_expansion_exhausted',
     running: 'continuous_running',
   };
   let schedStatus = statusMap[step.status] || 'continuous_running';
+  if (step.action === 'idle_expansion_dispatched') {
+    schedStatus = 'continuous_running';
+  }
   if (step.action === 'session_budget_exhausted') {
     schedStatus = 'continuous_session_budget_exhausted';
   }