agentxchain 2.58.0 → 2.60.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, run `agentxchain config --set project.goal "Build an API change planner for release teams"` 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/bin/agentxchain.js

@@ -192,7 +192,7 @@ program
   .description('View or edit project configuration')
   .option('--add-agent', 'Add a new agent interactively')
   .option('--remove-agent <id>', 'Remove an agent by ID')
-  .option('--set <key_value>', 'Set a config value (e.g. --set "rules.max_consecutive_claims 3")')
+  .option('--set <path_and_value...>', 'Set a config value (e.g. --set project.goal "Build a governed CLI")')
   .option('-j, --json', 'Output config as JSON')
   .action(configCommand);
 

package/package.json

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

package/src/commands/config.js

@@ -2,31 +2,43 @@ import { readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import { loadConfig, CONFIG_FILE } from '../lib/config.js';
+import { loadProjectContext, CONFIG_FILE } from '../lib/config.js';
 import { validateConfigSchema } from '../lib/schema.js';
+import { validateV4Config } from '../lib/normalized-config.js';
 
 export async function configCommand(opts) {
-  const result = loadConfig();
-  if (!result) {
+  const context = loadProjectContext();
+  if (!context) {
     console.log(chalk.red('  No agentxchain.json found. Run `agentxchain init` first.'));
     process.exit(1);
   }
 
-  const { root, config } = result;
+  const { root, rawConfig, version } = context;
+  const config = rawConfig;
   const configPath = join(root, CONFIG_FILE);
 
+  if (version === 4 && opts.addAgent) {
+    printLegacyOnlyMutationError('--add-agent');
+    return;
+  }
+
   if (opts.addAgent) {
     await addAgent(config, configPath);
     return;
   }
 
+  if (version === 4 && opts.removeAgent) {
+    printLegacyOnlyMutationError('--remove-agent');
+    return;
+  }
+
   if (opts.removeAgent) {
     removeAgent(config, configPath, opts.removeAgent);
     return;
   }
 
   if (opts.set) {
-    setSetting(config, configPath, opts.set);
+    setSetting(config, configPath, opts.set, { version, root });
     return;
   }
 
@@ -35,10 +47,15 @@ export async function configCommand(opts) {
     return;
   }
 
-  printConfig(config);
+  if (version === 4) {
+    printGovernedConfig(config);
+    return;
+  }
+
+  printLegacyConfig(config);
 }
 
-function printConfig(config) {
+function printLegacyConfig(config) {
   console.log('');
   console.log(chalk.bold('  AgentXchain Config'));
   console.log(chalk.dim('  ' + '─'.repeat(40)));
@@ -69,6 +86,32 @@ function printConfig(config) {
   console.log('');
 }
 
+function printGovernedConfig(config) {
+  console.log('');
+  console.log(chalk.bold('  AgentXchain Governed Config'));
+  console.log(chalk.dim('  ' + '─'.repeat(40)));
+  console.log('');
+  console.log(`  ${chalk.dim('Project:')}   ${config.project?.name || '(unknown)'}`);
+  console.log(`  ${chalk.dim('Project ID:')} ${config.project?.id || '(unknown)'}`);
+  console.log(`  ${chalk.dim('Goal:')}      ${config.project?.goal || '(not set)'}`);
+  console.log(`  ${chalk.dim('Template:')}  ${config.template || 'generic'}`);
+  console.log(`  ${chalk.dim('Roles:')}     ${Object.keys(config.roles || {}).length}`);
+  console.log(`  ${chalk.dim('Runtimes:')}  ${Object.keys(config.runtimes || {}).length}`);
+  console.log('');
+  console.log(chalk.dim('  Commands:'));
+  console.log(`    ${chalk.bold('agentxchain config --set project.goal "Build a ..."')}  Set mission context without hand-editing JSON`);
+  console.log(`    ${chalk.bold('agentxchain config --set roles.qa.runtime manual-qa')}  Switch a governed role runtime`);
+  console.log(`    ${chalk.bold('agentxchain config --json')}                             Output raw config`);
+  console.log('');
+}
+
+function printLegacyOnlyMutationError(flag) {
+  console.log(chalk.red(`  ${flag} is legacy-only.`));
+  console.log(chalk.dim('  Governed repos use roles and runtimes instead of legacy v3 agents.'));
+  console.log(chalk.dim('  Use `agentxchain config --set <path> <value>` for governed config changes.'));
+  process.exit(1);
+}
+
 async function addAgent(config, configPath) {
   const answers = await inquirer.prompt([
     {
@@ -117,16 +160,15 @@ function removeAgent(config, configPath, id) {
   console.log('');
 }
 
-function setSetting(config, configPath, keyValPair) {
-  const parts = keyValPair.split(/\s+/);
-  if (parts.length < 2) {
+function setSetting(config, configPath, keyValPair, context) {
+  const parsed = parseSetInput(keyValPair);
+  if (!parsed) {
     console.log(chalk.red('  Usage: agentxchain config --set <key> <value>'));
-    console.log(chalk.dim('  Example: agentxchain config --set rules.max_consecutive_claims 3'));
+    console.log(chalk.dim('  Example: agentxchain config --set project.goal "Build a governed CLI"'));
     process.exit(1);
   }
 
-  const key = parts[0];
-  const rawVal = parts.slice(1).join(' ');
+  const { key, rawVal } = parsed;
   const segments = key.split('.');
   const forbiddenKeys = new Set(['__proto__', 'prototype', 'constructor']);
 
@@ -152,7 +194,7 @@ function setSetting(config, configPath, keyValPair) {
   else if (!isNaN(rawVal) && rawVal !== '') val = Number(rawVal);
 
   target[lastKey] = val;
-  const validation = validateConfigSchema(config);
+  const validation = validateEditedConfig(config, context);
   if (!validation.ok) {
     target[lastKey] = oldVal;
     if (oldVal === undefined) {
@@ -168,3 +210,34 @@ function setSetting(config, configPath, keyValPair) {
   if (oldVal !== undefined) console.log(chalk.dim(`    (was: ${oldVal})`));
   console.log('');
 }
+
+function parseSetInput(input) {
+  if (Array.isArray(input)) {
+    if (input.length >= 2) {
+      return { key: input[0], rawVal: input.slice(1).join(' ') };
+    }
+    if (input.length === 1 && typeof input[0] === 'string') {
+      const parts = input[0].trim().split(/\s+/);
+      if (parts.length >= 2) {
+        return { key: parts[0], rawVal: parts.slice(1).join(' ') };
+      }
+    }
+    return null;
+  }
+
+  if (typeof input === 'string') {
+    const parts = input.trim().split(/\s+/);
+    if (parts.length >= 2) {
+      return { key: parts[0], rawVal: parts.slice(1).join(' ') };
+    }
+  }
+
+  return null;
+}
+
+function validateEditedConfig(config, context) {
+  if (context.version === 4) {
+    return validateV4Config(config, context.root);
+  }
+  return validateConfigSchema(config);
+}

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/init.js

@@ -978,7 +978,8 @@ async function initGoverned(opts) {
   console.log('');
   if (!config?.project?.goal) {
     console.log(`  ${chalk.dim('Tip:')} Add a project goal to guide agent context:`);
-    console.log(`    ${chalk.bold('agentxchain init --governed --goal "Build a ..."')} ${chalk.dim('# or set project.goal in agentxchain.json')}`);
+    console.log(`    ${chalk.bold('agentxchain init --governed --goal "Build a ..."')} ${chalk.dim('# preferred during scaffold')}`);
+    console.log(`    ${chalk.bold('agentxchain config --set project.goal "Build a ..."')} ${chalk.dim('# add it later without hand-editing JSON')}`);
     console.log('');
   }
   console.log(`  ${chalk.dim('Guide:')} https://agentxchain.dev/docs/getting-started`);