agentxchain 2.57.0 → 2.59.0

package/README.md

@@ -63,15 +63,19 @@ Duplicate execution remains intentional for the current 36-file slice until a la
 ### Governed workflow
 
 ```bash
-agentxchain init --governed --dir my-agentxchain-project -y
+agentxchain init --governed --goal "Build an API change planner for release teams" --dir my-agentxchain-project -y
 cd my-agentxchain-project
 git init
+agentxchain template validate
+agentxchain doctor
 git add -A
 git commit -m "initial governed scaffold"
 agentxchain status
 agentxchain step --role pm
 ```
 
+If you skipped `--goal` during scaffold, set `project.goal` in `agentxchain.json` before the first governed turn instead of re-running init in place.
+
 The default governed dev runtime is `claude --print --dangerously-skip-permissions` with stdin prompt delivery. The non-interactive governed path needs write access, so do not pretend bare `claude --print` is sufficient for unattended implementation turns. If your local coding agent uses a different launch contract, set it during scaffold creation:
 
 ```bash

package/dashboard/components/run-history.js

@@ -68,6 +68,13 @@ function truncateId(id, len = 12) {
   return id.length > len ? id.slice(0, len) + '…' : id;
 }
 
+function truncateHeadline(headline, len = 40) {
+  if (!headline) return '—';
+  const normalized = String(headline).replace(/\s+/g, ' ').trim();
+  if (normalized.length <= len) return normalized;
+  return normalized.slice(0, len - 1) + '…';
+}
+
 function isInheritable(entry) {
   const snap = entry?.inheritance_snapshot;
   if (!snap) return false;
@@ -105,6 +112,7 @@ function renderRow(entry, index) {
     <td>${formatCost(entry.total_cost_usd)}</td>
     <td>${formatDuration(entry.duration_ms)}</td>
     <td>${formatDate(entry.recorded_at || entry.completed_at)}</td>
+    <td title="${esc(entry.retrospective?.headline || '')}">${esc(truncateHeadline(entry.retrospective?.headline))}</td>
   </tr>`;
 }
 
@@ -144,6 +152,7 @@ export function render({ runHistory }) {
           <th>Cost</th>
           <th>Duration</th>
           <th>Date</th>
+          <th>Headline</th>
         </tr>
       </thead>
       <tbody>`;

package/package.json

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

package/src/commands/demo.js

@@ -604,9 +604,13 @@ All acceptance criteria met. OBJ-002 (clock skew) noted for follow-up. OBJ-003 (
       console.log('');
       console.log(chalk.dim('  ─'.repeat(26)));
       console.log('');
-      console.log(`  ${chalk.bold('Try it for real:')}  agentxchain init --governed`);
-      console.log(`  ${chalk.bold('Step by step:')}    https://agentxchain.dev/docs/getting-started`);
-      console.log(`  ${chalk.bold('Read more:')}       https://agentxchain.dev/docs/quickstart`);
+      console.log(`  ${chalk.bold('Next steps:')}`);
+      console.log('');
+      console.log(`  ${chalk.dim('1.')} ${chalk.bold('Scaffold')}     agentxchain init --governed --goal "Your project mission"`);
+      console.log(`  ${chalk.dim('2.')} ${chalk.bold('Verify')}       agentxchain doctor`);
+      console.log(`  ${chalk.dim('3.')} ${chalk.bold('First turn')}   agentxchain run`);
+      console.log('');
+      console.log(`  ${chalk.bold('Docs:')}           https://agentxchain.dev/docs/quickstart`);
       console.log('');
     }
 

package/src/commands/history.js

@@ -50,8 +50,11 @@ export async function historyCommand(opts) {
       const parentNote = entry.provenance?.parent_run_id
         ? ` from ${entry.provenance.parent_run_id.slice(0, 12)}`
         : '';
+      const headline = entry.retrospective?.headline
+        ? `  ${formatHeadline(entry.retrospective.headline)}`
+        : '';
       const prefix = i === 0 ? '  ' : '  └─ ';
-      console.log(`${prefix}${runId}  ${status}  ${pad(phases, 20)}  ${pad(turns, 10)}  ${pad(cost, 8)}  (${trigger}${parentNote})${ctxMarker}`);
+      console.log(`${prefix}${runId}  ${status}  ${pad(phases, 20)}  ${pad(turns, 10)}  ${pad(cost, 8)}  (${trigger}${parentNote})${ctxMarker}${headline}`);
     });
     return;
   }
@@ -89,6 +92,7 @@ export async function historyCommand(opts) {
     pad('Cost', 10),
     pad('Duration', 10),
     pad('Date', 20),
+    pad('Headline', 42),
   ].join(' ');
 
   console.log(chalk.bold(header));
@@ -111,6 +115,7 @@ export async function historyCommand(opts) {
     const date = entry.recorded_at
       ? new Date(entry.recorded_at).toLocaleString()
       : '—';
+    const headline = formatHeadline(entry.retrospective?.headline);
 
     console.log([
       pad(idx, 4),
@@ -123,6 +128,7 @@ export async function historyCommand(opts) {
       pad(cost, 10),
       pad(duration, 10),
       pad(date, 20),
+      pad(headline, 42),
     ].join(' '));
   });
 
@@ -163,3 +169,10 @@ function formatDuration(ms) {
   const remainMins = mins % 60;
   return `${hrs}h ${remainMins}m`;
 }
+
+function formatHeadline(headline) {
+  if (!headline) return '—';
+  const normalized = String(headline).replace(/\s+/g, ' ').trim();
+  if (normalized.length <= 40) return normalized;
+  return `${normalized.slice(0, 39)}…`;
+}