agentxchain 2.55.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.55.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/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'}\``,