agentxchain 2.54.0 → 2.56.0

package/bin/agentxchain.js

@@ -128,6 +128,7 @@ program
   .option('--template <id>', 'Governed scaffold template: generic, api-service, cli-tool, library, web-app, enterprise-app')
   .option('--dev-command <parts...>', 'Governed local-dev command parts. Include {prompt} for argv prompt delivery.')
   .option('--dev-prompt-transport <mode>', 'Governed local-dev prompt transport: argv, stdin, dispatch_bundle_only')
+  .option('--goal <text>', 'Project goal — persisted in config and rendered in every dispatch bundle')
   .option('--schema-version <version>', 'Schema version (3 for legacy, or use --governed for current)')
   .action(initCommand);
 

package/dashboard/components/run-history.js

@@ -68,6 +68,14 @@ function truncateId(id, len = 12) {
   return id.length > len ? id.slice(0, len) + '…' : id;
 }
 
+function isInheritable(entry) {
+  const snap = entry?.inheritance_snapshot;
+  if (!snap) return false;
+  const hasDecisions = Array.isArray(snap.recent_decisions) && snap.recent_decisions.length > 0;
+  const hasTurns = Array.isArray(snap.recent_accepted_turns) && snap.recent_accepted_turns.length > 0;
+  return hasDecisions || hasTurns;
+}
+
 function renderRow(entry, index) {
   const rowClass = entry.status === 'blocked'
     ? ' style="border-left:3px solid var(--yellow)"'
@@ -83,10 +91,15 @@ function renderRow(entry, index) {
     ? `<div class="blocked-hint" style="font-size:0.85em;color:var(--yellow);margin-top:2px">${esc(typeof entry.blocked_reason === 'string' ? entry.blocked_reason : entry.blocked_reason?.detail || entry.blocked_reason?.category || '')}</div>`
     : '';
 
+  const ctxIndicator = isInheritable(entry)
+    ? `<span title="Has inheritance snapshot — usable by child runs" style="color:var(--green)">✓</span>`
+    : `<span style="color:var(--text-dim)">—</span>`;
+
   return `<tr${rowClass}>
     <td style="color:var(--text-dim)">${index + 1}</td>
     <td class="mono" title="${esc(entry.run_id)}">${esc(truncateId(entry.run_id))}</td>
     <td>${statusBadge(entry.status)}${blockedInfo}</td>
+    <td>${ctxIndicator}</td>
     <td>${phases}</td>
     <td>${entry.total_turns ?? '—'}</td>
     <td>${formatCost(entry.total_cost_usd)}</td>
@@ -125,6 +138,7 @@ export function render({ runHistory }) {
           <th>#</th>
           <th>Run ID</th>
           <th>Status</th>
+          <th>Ctx</th>
           <th>Phases</th>
           <th>Turns</th>
           <th>Cost</th>

package/package.json

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

package/src/commands/demo.js

@@ -19,7 +19,7 @@ function makeConfig() {
   return {
     schema_version: 4,
     protocol_mode: 'governed',
-    project: { id: 'agentxchain-demo', name: 'AgentXchain Demo', default_branch: 'main' },
+    project: { id: 'agentxchain-demo', name: 'AgentXchain Demo', goal: 'Build an auth token rotation service with expiry, graceful rollover, and audit logging', default_branch: 'main' },
     roles: {
       pm: {
         title: 'Product Manager',

package/src/commands/history.js

@@ -7,7 +7,7 @@
 import { resolve } from 'path';
 import { existsSync, readFileSync } from 'fs';
 import chalk from 'chalk';
-import { queryRunHistory, queryRunLineage } from '../lib/run-history.js';
+import { queryRunHistory, queryRunLineage, isInheritable } from '../lib/run-history.js';
 import { getRunTriggerLabel, summarizeRunProvenance } from '../lib/run-provenance.js';
 
 /**
@@ -46,11 +46,12 @@ export async function historyCommand(opts) {
       const turns = `${entry.total_turns || 0} turns`;
       const cost = entry.total_cost_usd != null ? `$${entry.total_cost_usd.toFixed(2)}` : '';
       const trigger = getRunTriggerLabel(entry.provenance);
+      const ctxMarker = isInheritable(entry) ? ' [ctx]' : '';
       const parentNote = entry.provenance?.parent_run_id
         ? ` from ${entry.provenance.parent_run_id.slice(0, 12)}`
         : '';
       const prefix = i === 0 ? '  ' : '  └─ ';
-      console.log(`${prefix}${runId}  ${status}  ${pad(phases, 20)}  ${pad(turns, 10)}  ${pad(cost, 8)}  (${trigger}${parentNote})`);
+      console.log(`${prefix}${runId}  ${status}  ${pad(phases, 20)}  ${pad(turns, 10)}  ${pad(cost, 8)}  (${trigger}${parentNote})${ctxMarker}`);
     });
     return;
   }
@@ -63,7 +64,8 @@ export async function historyCommand(opts) {
   });
 
   if (opts.json) {
-    console.log(JSON.stringify(entries, null, 2));
+    const enriched = entries.map(e => ({ ...e, inheritable: isInheritable(e) }));
+    console.log(JSON.stringify(enriched, null, 2));
     return;
   }
 
@@ -81,6 +83,7 @@ export async function historyCommand(opts) {
     pad('Run ID', 14),
     pad('Status', 11),
     pad('Trigger', 14),
+    pad('Ctx', 4),
     pad('Phases', 8),
     pad('Turns', 6),
     pad('Cost', 10),
@@ -96,6 +99,7 @@ export async function historyCommand(opts) {
     const runId = (entry.run_id || '—').slice(0, 12);
     const status = formatStatus(entry.status);
     const trigger = getRunTriggerLabel(entry.provenance);
+    const ctx = isInheritable(entry) ? '✓' : '—';
     const phases = String(entry.phases_completed?.length || 0);
     const turns = String(entry.total_turns || 0);
     const cost = entry.total_cost_usd != null
@@ -113,6 +117,7 @@ export async function historyCommand(opts) {
       pad(runId, 14),
       pad(status, 11),
       pad(trigger, 14),
+      pad(ctx, 4),
       pad(phases, 8),
       pad(turns, 6),
       pad(cost, 10),

package/src/commands/init.js

@@ -656,12 +656,14 @@ export function scaffoldGoverned(dir, projectName, projectId, templateId = 'gene
         .filter(Boolean)
     )].map((gateId) => [gateId, 'pending'])
   );
+  const projectGoal = runtimeOptions.goal;
   const config = {
     schema_version: '1.0',
     template: template.id,
     project: {
       id: projectId,
       name: projectName,
+      ...(typeof projectGoal === 'string' && projectGoal.trim() ? { goal: projectGoal.trim() } : {}),
       default_branch: 'main'
     },
     roles,

package/src/commands/status.js

@@ -89,6 +89,7 @@ function renderGovernedStatus(context, opts) {
       version,
       protocol_mode: config.protocol_mode,
       template: config.template || 'generic',
+      project_goal: config.project?.goal || null,
       config,
       state,
       provenance: state?.provenance || null,
@@ -106,6 +107,9 @@ function renderGovernedStatus(context, opts) {
   console.log('');
 
   console.log(`  ${chalk.dim('Project:')}  ${config.project.name}`);
+  if (config.project.goal) {
+    console.log(`  ${chalk.dim('Goal:')}     ${config.project.goal}`);
+  }
   console.log(`  ${chalk.dim('Protocol:')} ${chalk.cyan(`governed (v${version})`)}`);
   console.log(`  ${chalk.dim('Template:')} ${config.template || 'generic'}`);
   console.log(`  ${chalk.dim('Phase:')}    ${state?.phase ? formatGovernedPhase(state.phase) : chalk.dim('unknown')}`);

package/src/lib/dispatch-bundle.js

@@ -512,6 +512,15 @@ function renderContext(state, config, root, turn, role) {
   }
   lines.push('');
 
+  // Project goal (when set in agentxchain.json)
+  const projectGoal = config?.project?.goal;
+  if (typeof projectGoal === 'string' && projectGoal.trim()) {
+    lines.push('## Project Goal');
+    lines.push('');
+    lines.push(projectGoal.trim());
+    lines.push('');
+  }
+
   // Inherited context from parent run (when --inherit-context was used)
   if (state.inherited_context) {
     // First turn gets the full rendering; subsequent turns get compact

package/src/lib/export.js

@@ -295,11 +295,13 @@ export function buildRunExport(startDir = process.cwd()) {
       project: {
         id: config.project.id,
         name: config.project.name,
+        goal: config.project.goal || null,
         template: config.template || 'generic',
         protocol_mode: config.protocol_mode,
         schema_version: version,
       },
       summary: {
+        project_goal: config.project.goal || null,
         run_id: state?.run_id || null,
         status: state?.status || null,
         phase: state?.phase || null,

package/src/lib/normalized-config.js

@@ -340,6 +340,16 @@ export function validateV4Config(data, projectRoot) {
   } else {
     if (typeof data.project.id !== 'string' || !data.project.id.trim()) errors.push('project.id must be a non-empty string');
     if (typeof data.project.name !== 'string' || !data.project.name.trim()) errors.push('project.name must be a non-empty string');
+    // Optional project.goal field
+    if (data.project.goal !== undefined && data.project.goal !== null) {
+      if (typeof data.project.goal !== 'string') {
+        errors.push('project.goal must be a string');
+      } else if (!data.project.goal.trim()) {
+        errors.push('project.goal must be a non-empty string when provided');
+      } else if (data.project.goal.trim().length > 500) {
+        errors.push('project.goal must be 500 characters or fewer');
+      }
+    }
   }
 
   // Roles
@@ -968,6 +978,7 @@ export function normalizeV4(raw) {
     project: {
       id: raw.project?.id || 'unknown',
       name: raw.project?.name || 'Unknown',
+      ...(typeof raw.project?.goal === 'string' && raw.project.goal.trim() ? { goal: raw.project.goal.trim() } : {}),
       default_branch: raw.project?.default_branch || 'main',
     },
     roles,

package/src/lib/report.js

@@ -630,6 +630,7 @@ function buildRunSubject(artifact) {
     project: {
       id: artifact.project?.id || null,
       name: artifact.project?.name || null,
+      goal: artifact.project?.goal || null,
       template: artifact.project?.template || 'generic',
       protocol_mode: artifact.project?.protocol_mode || null,
       schema_version: artifact.project?.schema_version || null,
@@ -876,6 +877,7 @@ export function formatGovernanceReportText(report) {
       `Export kind: ${report.export_kind}`,
       'Verification: PASS',
       `Project: ${project.name || 'unknown'} (${project.id || 'unknown'})`,
+      ...(project.goal ? [`Goal: ${project.goal}`] : []),
       `Template: ${project.template}`,
       `Protocol: ${project.protocol_mode || 'unknown'} (config schema ${project.schema_version || 'unknown'})`,
       `Run: ${run.run_id || 'none'}`,
@@ -1285,6 +1287,7 @@ export function formatGovernanceReportMarkdown(report) {
       `- Export kind: \`${report.export_kind}\``,
       '- Verification: `pass`',
       `- Project: ${project.name || 'unknown'} (\`${project.id || 'unknown'}\`)`,
+      ...(project.goal ? [`- Goal: ${project.goal}`] : []),
       `- Template: \`${project.template}\``,
       `- Protocol: \`${project.protocol_mode || 'unknown'}\` (config schema \`${project.schema_version || 'unknown'}\`)`,
       `- Run: \`${run.run_id || 'none'}\``,

package/src/lib/run-history.js

@@ -249,6 +249,21 @@ export function validateParentRun(root, runId) {
   return { ok: true, entry };
 }
 
+/**
+ * Check whether a run-history entry has a usable inheritance snapshot
+ * (at least one decision or one accepted turn available for child runs).
+ *
+ * @param {object} entry - a run-history record
+ * @returns {boolean}
+ */
+export function isInheritable(entry) {
+  const snap = entry?.inheritance_snapshot;
+  if (!snap) return false;
+  const hasDecisions = Array.isArray(snap.recent_decisions) && snap.recent_decisions.length > 0;
+  const hasTurns = Array.isArray(snap.recent_accepted_turns) && snap.recent_accepted_turns.length > 0;
+  return hasDecisions || hasTurns;
+}
+
 /**
  * Get the path to the run-history file.
  */