agentxchain 2.85.0 → 2.87.0

package/package.json

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

package/src/commands/init.js

@@ -117,6 +117,7 @@ const DEFAULT_GOVERNED_LOCAL_DEV_RUNTIME = Object.freeze({
 
 const GOVERNED_RUNTIMES = {
   'manual-pm': { type: 'manual' },
+  'manual-dev': { type: 'manual' },
   'local-dev': DEFAULT_GOVERNED_LOCAL_DEV_RUNTIME,
   'api-qa': { type: 'api_proxy', provider: 'anthropic', model: 'claude-sonnet-4-6', auth_env: 'ANTHROPIC_API_KEY' },
   'manual-qa': { type: 'manual' },
@@ -615,15 +616,23 @@ function cloneJsonCompatible(value) {
   return value == null ? value : JSON.parse(JSON.stringify(value));
 }
 
-function buildScaffoldConfigFromTemplate(template, localDevRuntime, workflowKitConfig) {
+function buildScaffoldConfigFromTemplate(template, localDevRuntime, workflowKitConfig, runtimeOptions = {}) {
   const blueprint = template.scaffold_blueprint || null;
   const roles = cloneJsonCompatible(blueprint?.roles || GOVERNED_ROLES);
   const runtimes = cloneJsonCompatible(blueprint?.runtimes || GOVERNED_RUNTIMES);
+  const explicitLocalDevRequested = Boolean(
+    (Array.isArray(runtimeOptions.devCommand) && runtimeOptions.devCommand.length > 0)
+    || (typeof runtimeOptions.devPromptTransport === 'string' && runtimeOptions.devPromptTransport.trim())
+  );
 
-  if (!blueprint || Object.values(roles).some((role) => role?.runtime === 'local-dev')) {
+  if (!blueprint || Object.values(roles).some((role) => role?.runtime === 'local-dev') || explicitLocalDevRequested) {
     runtimes['local-dev'] = localDevRuntime;
   }
 
+  if (explicitLocalDevRequested && roles?.dev?.runtime === 'manual-dev') {
+    roles.dev.runtime = 'local-dev';
+  }
+
   const routing = cloneJsonCompatible(blueprint?.routing || GOVERNED_ROUTING);
   const gates = cloneJsonCompatible(blueprint?.gates || GOVERNED_GATES);
   const effectiveWorkflowKitConfig = workflowKitConfig || cloneJsonCompatible(blueprint?.workflow_kit || null);
@@ -713,7 +722,7 @@ function buildPlanningSummaryLines(template, workflowKitConfig) {
 export function scaffoldGoverned(dir, projectName, projectId, templateId = 'generic', runtimeOptions = {}, workflowKitConfig = null) {
   const template = loadGovernedTemplate(templateId);
   const { runtime: localDevRuntime } = resolveGovernedLocalDevRuntime(runtimeOptions);
-  const scaffoldConfig = buildScaffoldConfigFromTemplate(template, localDevRuntime, workflowKitConfig);
+  const scaffoldConfig = buildScaffoldConfigFromTemplate(template, localDevRuntime, workflowKitConfig, runtimeOptions);
   const { roles, runtimes, routing, gates, policies, prompts, workflowKitConfig: effectiveWorkflowKitConfig } = scaffoldConfig;
   const scaffoldWorkflowKitConfig = effectiveWorkflowKitConfig
     ? normalizeWorkflowKit(effectiveWorkflowKitConfig, Object.keys(routing))
@@ -920,6 +929,12 @@ async function initGoverned(opts) {
   selectedTemplate = loadGovernedTemplate(templateId);
 
   if (opts.yes) {
+    // Auto-detect in-place scaffolding: if cwd is a git repo without agentxchain.json,
+    // scaffold here instead of creating a subdirectory. First-time users who already
+    // ran `mkdir my-project && cd my-project && git init` should not get a nested folder.
+    if (!explicitDir && existsSync(join(process.cwd(), '.git')) && !existsSync(join(process.cwd(), CONFIG_FILE))) {
+      explicitDir = '.';
+    }
     projectName = explicitDir
       ? inferProjectNameFromTarget(explicitDir, 'My AgentXchain Project')
       : 'My AgentXchain Project';
@@ -1027,6 +1042,9 @@ async function initGoverned(opts) {
       }
     }
     console.log('');
+  } else if (Object.entries(config.roles).every(([, role]) => allRuntimes[role.runtime]?.type === 'manual')) {
+    console.log(`  ${chalk.green('Ready:')} manual-only scaffold (${chalk.bold('no API keys')} and ${chalk.bold('no local coding CLI')} required).`);
+    console.log('');
   }
 
   console.log(`  ${chalk.cyan('Next:')}`);

package/src/templates/governed/generic.json

@@ -4,6 +4,40 @@
   "description": "Default governed scaffold with the baseline planning artifacts and no project-type-specific guidance.",
   "version": "1",
   "protocol_compatibility": ["1.0", "1.1"],
+  "scaffold_blueprint": {
+    "roles": {
+      "pm": {
+        "title": "Product Manager",
+        "mandate": "Protect user value, scope clarity, and acceptance criteria.",
+        "write_authority": "review_only",
+        "runtime": "manual-pm"
+      },
+      "dev": {
+        "title": "Developer",
+        "mandate": "Implement approved work safely and verify behavior.",
+        "write_authority": "authoritative",
+        "runtime": "manual-dev"
+      },
+      "qa": {
+        "title": "QA",
+        "mandate": "Challenge correctness, acceptance coverage, and ship readiness.",
+        "write_authority": "review_only",
+        "runtime": "manual-qa"
+      },
+      "eng_director": {
+        "title": "Engineering Director",
+        "mandate": "Resolve tactical deadlocks and enforce technical coherence.",
+        "write_authority": "review_only",
+        "runtime": "manual-director"
+      }
+    },
+    "runtimes": {
+      "manual-pm": { "type": "manual" },
+      "manual-dev": { "type": "manual" },
+      "manual-qa": { "type": "manual" },
+      "manual-director": { "type": "manual" }
+    }
+  },
   "planning_artifacts": [],
   "prompt_overrides": {},
   "acceptance_hints": []