agentxchain 0.1.1 → 0.2.0

package/src/commands/init.js

@@ -1,9 +1,13 @@
-import { writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join, resolve } from 'path';
+import { writeFileSync, readFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { CONFIG_FILE, LOCK_FILE, STATE_FILE } from '../lib/config.js';
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(__dirname, '../templates');
+
 const DEFAULT_AGENTS = {
   pm: {
     name: 'Product Manager',
@@ -24,54 +28,93 @@ const DEFAULT_AGENTS = {
 };
 
 function slugify(name) {
-  return name
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-|-$/g, '');
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+}
+
+function loadTemplates() {
+  const templates = [];
+  try {
+    const files = readdirSync(TEMPLATES_DIR).filter(f => f.endsWith('.json'));
+    for (const file of files) {
+      const raw = readFileSync(join(TEMPLATES_DIR, file), 'utf8');
+      const tmpl = JSON.parse(raw);
+      templates.push({ id: file.replace('.json', ''), ...tmpl });
+    }
+  } catch {}
+  return templates;
 }
 
 export async function initCommand(opts) {
-  let project, agents, folderName;
+  let project, agents, folderName, rules;
 
   if (opts.yes) {
     project = 'My AgentXchain project';
     agents = DEFAULT_AGENTS;
     folderName = slugify(project);
+    rules = { max_consecutive_claims: 2, require_message: true, compress_after_words: 5000 };
   } else {
-    const nameAnswer = await inquirer.prompt([{
-      type: 'input',
-      name: 'project',
-      message: 'Project name:',
-      default: 'My AgentXchain project'
-    }]);
-
-    project = nameAnswer.project;
-    folderName = slugify(project);
-
-    const folderAnswer = await inquirer.prompt([{
-      type: 'input',
-      name: 'folder',
-      message: 'Folder name:',
-      default: folderName
-    }]);
-
-    folderName = folderAnswer.folder;
-
-    const agentAnswer = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'useDefaults',
-      message: 'Use default agents (pm, dev, qa, ux)?',
-      default: true
+    const templates = loadTemplates();
+
+    // Template selection
+    const templateChoices = [
+      { name: `${chalk.cyan('Custom')} — define your own agents`, value: 'custom' },
+      { name: `${chalk.cyan('Default')} — PM, Dev, QA, UX (4 agents)`, value: 'default' },
+      ...templates.map(t => ({
+        name: `${chalk.cyan(t.label)} — ${t.description} (${Object.keys(t.agents).length} agents)`,
+        value: t.id
+      }))
+    ];
+
+    const { template } = await inquirer.prompt([{
+      type: 'list',
+      name: 'template',
+      message: 'Choose a team template:',
+      choices: templateChoices
     }]);
 
-    if (agentAnswer.useDefaults) {
+    if (template !== 'custom' && template !== 'default') {
+      const tmpl = templates.find(t => t.id === template);
+      agents = tmpl.agents;
+      rules = tmpl.rules || {};
+      const { projectName } = await inquirer.prompt([{
+        type: 'input',
+        name: 'projectName',
+        message: 'Project name:',
+        default: tmpl.project
+      }]);
+      project = projectName;
+    } else if (template === 'default') {
       agents = DEFAULT_AGENTS;
+      rules = { max_consecutive_claims: 2, require_message: true, compress_after_words: 5000 };
+      const { projectName } = await inquirer.prompt([{
+        type: 'input',
+        name: 'projectName',
+        message: 'Project name:',
+        default: 'My AgentXchain project'
+      }]);
+      project = projectName;
     } else {
+      const { projectName } = await inquirer.prompt([{
+        type: 'input',
+        name: 'projectName',
+        message: 'Project name:',
+        default: 'My AgentXchain project'
+      }]);
+      project = projectName;
       agents = {};
+      rules = { max_consecutive_claims: 2, require_message: true, compress_after_words: 5000 };
       let adding = true;
       while (adding) {
         const agent = await inquirer.prompt([
-          { type: 'input', name: 'id', message: 'Agent ID (lowercase, no spaces):' },
+          {
+            type: 'input', name: 'id', message: 'Agent ID (lowercase, no spaces):',
+            validate: v => {
+              if (!v.match(/^[a-z0-9-]+$/)) return 'Lowercase letters, numbers, hyphens only.';
+              if (v === 'human' || v === 'system') return `"${v}" is reserved.`;
+              if (agents[v]) return `"${v}" already added.`;
+              return true;
+            }
+          },
           { type: 'input', name: 'name', message: 'Display name:' },
           { type: 'input', name: 'mandate', message: 'Mandate (what this agent does):' },
           { type: 'confirm', name: 'more', message: 'Add another agent?', default: true }
@@ -80,72 +123,81 @@ export async function initCommand(opts) {
         adding = agent.more;
       }
     }
+
+    folderName = slugify(project);
+    const { folder } = await inquirer.prompt([{
+      type: 'input',
+      name: 'folder',
+      message: 'Folder name:',
+      default: folderName
+    }]);
+    folderName = folder;
   }
 
   const dir = resolve(process.cwd(), folderName);
 
-  if (existsSync(dir)) {
-    if (existsSync(join(dir, CONFIG_FILE))) {
-      if (!opts.yes) {
-        const { overwrite } = await inquirer.prompt([{
-          type: 'confirm',
-          name: 'overwrite',
-          message: `${folderName}/ already has an agentxchain.json. Overwrite?`,
-          default: false
-        }]);
-        if (!overwrite) {
-          console.log(chalk.yellow('  Aborted.'));
-          return;
-        }
+  if (existsSync(dir) && existsSync(join(dir, CONFIG_FILE))) {
+    if (!opts.yes) {
+      const { overwrite } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'overwrite',
+        message: `${folderName}/ already has agentxchain.json. Overwrite?`,
+        default: false
+      }]);
+      if (!overwrite) {
+        console.log(chalk.yellow('  Aborted.'));
+        return;
       }
     }
-  } else {
-    mkdirSync(dir, { recursive: true });
   }
 
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
   const config = {
     version: 3,
     project,
     agents,
     log: 'log.md',
+    state_file: 'state.md',
+    history_file: 'history.jsonl',
     rules: {
-      max_consecutive_claims: 2,
-      require_message: true,
-      compress_after_words: 5000
+      max_consecutive_claims: rules.max_consecutive_claims || 2,
+      require_message: rules.require_message !== false,
+      compress_after_words: rules.compress_after_words || 5000,
+      ttl_minutes: rules.ttl_minutes || 10,
+      watch_interval_ms: rules.watch_interval_ms || 5000,
+      ...(rules.verify_command ? { verify_command: rules.verify_command } : {})
     }
   };
 
-  const lock = {
-    holder: null,
-    last_released_by: null,
-    turn_number: 0,
-    claimed_at: null
-  };
-
-  const state = {
-    phase: 'discovery',
-    blocked: false,
-    blocked_on: null,
-    project
-  };
+  const lock = { holder: null, last_released_by: null, turn_number: 0, claimed_at: null };
+  const state = { phase: 'discovery', blocked: false, blocked_on: null, project };
 
   writeFileSync(join(dir, CONFIG_FILE), JSON.stringify(config, null, 2) + '\n');
   writeFileSync(join(dir, LOCK_FILE), JSON.stringify(lock, null, 2) + '\n');
-  writeFileSync(join(dir, STATE_FILE), JSON.stringify(state, null, 2) + '\n');
-  writeFileSync(join(dir, config.log), `# ${project} — Agent Log\n\n## COMPRESSED CONTEXT\n\n(No compressed context yet.)\n\n## MESSAGE LOG\n\n(Agents append messages below this line.)\n`);
+  writeFileSync(join(dir, 'state.json'), JSON.stringify(state, null, 2) + '\n');
+  writeFileSync(join(dir, 'state.md'), `# ${project} — Current State\n\n## Architecture\n\n(Agents update this each turn with current decisions.)\n\n## Active Work\n\n(What's in progress right now.)\n\n## Open Issues\n\n(Bugs, blockers, risks.)\n\n## Next Steps\n\n(What should happen next.)\n`);
+  writeFileSync(join(dir, 'history.jsonl'), '');
+  writeFileSync(join(dir, 'log.md'), `# ${project} — Agent Log\n\n## COMPRESSED CONTEXT\n\n(No compressed context yet.)\n\n## MESSAGE LOG\n\n(Agents append messages below this line.)\n`);
   writeFileSync(join(dir, 'HUMAN_TASKS.md'), '# Human Tasks\n\n(Agents append tasks here when they need human action.)\n');
 
+  const agentCount = Object.keys(agents).length;
   console.log('');
   console.log(chalk.green(`  ✓ Created ${chalk.bold(folderName)}/`));
   console.log('');
-  console.log(`    ${chalk.dim('├──')} ${CONFIG_FILE}`);
-  console.log(`    ${chalk.dim('├──')} ${LOCK_FILE}`);
-  console.log(`    ${chalk.dim('├──')} ${STATE_FILE}`);
-  console.log(`    ${chalk.dim('├──')} ${config.log}`);
+  console.log(`    ${chalk.dim('├──')} agentxchain.json  ${chalk.dim(`(${agentCount} agents)`)}`);
+  console.log(`    ${chalk.dim('├──')} lock.json`);
+  console.log(`    ${chalk.dim('├──')} state.json`);
+  console.log(`    ${chalk.dim('├──')} state.md`);
+  console.log(`    ${chalk.dim('├──')} history.jsonl`);
+  console.log(`    ${chalk.dim('├──')} log.md`);
   console.log(`    ${chalk.dim('└──')} HUMAN_TASKS.md`);
   console.log('');
   console.log(`  ${chalk.dim('Agents:')} ${Object.keys(agents).join(', ')}`);
   console.log('');
-  console.log(`  ${chalk.cyan('Next:')} ${chalk.bold(`cd ${folderName}`)} && ${chalk.bold('agentxchain start')}`);
+  console.log(`  ${chalk.cyan('Next:')}`);
+  console.log(`    ${chalk.bold(`cd ${folderName}`)}`);
+  console.log(`    ${chalk.bold('agentxchain watch')}    ${chalk.dim('# start the referee')}`);
+  console.log(`    ${chalk.bold('agentxchain start')}    ${chalk.dim('# launch agents in your IDE')}`);
   console.log('');
 }

package/src/commands/status.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import { loadConfig, loadLock, loadState } from '../lib/config.js';
+import { getAgentStatus, loadSession } from '../adapters/cursor.js';
 
 export async function statusCommand(opts) {
   const result = loadConfig();
@@ -19,10 +20,9 @@ export async function statusCommand(opts) {
 
   console.log('');
   console.log(chalk.bold('  AgentXchain Status'));
-  console.log(chalk.dim('  ' + '─'.repeat(40)));
+  console.log(chalk.dim('  ' + '─'.repeat(44)));
   console.log('');
 
-  // Project
   console.log(`  ${chalk.dim('Project:')}  ${config.project}`);
   console.log(`  ${chalk.dim('Phase:')}    ${state ? formatPhase(state.phase) : chalk.dim('unknown')}`);
   if (state?.blocked) {
@@ -32,45 +32,83 @@ export async function statusCommand(opts) {
 
   // Lock
   if (lock) {
-    if (lock.holder) {
+    if (lock.holder === 'human') {
+      console.log(`  ${chalk.dim('Lock:')}     ${chalk.magenta('HUMAN')} — you hold the lock`);
+    } else if (lock.holder) {
       const agentName = config.agents[lock.holder]?.name || lock.holder;
       console.log(`  ${chalk.dim('Lock:')}     ${chalk.yellow('CLAIMED')} by ${chalk.bold(lock.holder)} (${agentName})`);
       if (lock.claimed_at) {
-        const ago = timeSince(lock.claimed_at);
-        console.log(`  ${chalk.dim('Claimed:')}  ${ago} ago`);
+        console.log(`  ${chalk.dim('Claimed:')}  ${timeSince(lock.claimed_at)} ago`);
       }
     } else {
       console.log(`  ${chalk.dim('Lock:')}     ${chalk.green('FREE')} — any agent can claim`);
     }
     console.log(`  ${chalk.dim('Turn:')}     ${lock.turn_number}`);
     if (lock.last_released_by) {
-      const lastName = config.agents[lock.last_released_by]?.name || lock.last_released_by;
-      console.log(`  ${chalk.dim('Last:')}     ${lock.last_released_by} (${lastName})`);
+      console.log(`  ${chalk.dim('Last:')}     ${lock.last_released_by}`);
     }
   }
   console.log('');
 
+  // Cursor session info
+  const session = loadSession(root);
+  const apiKey = process.env.CURSOR_API_KEY;
+  const hasCursor = session?.ide === 'cursor' && session?.launched?.length > 0;
+
+  if (hasCursor) {
+    console.log(`  ${chalk.dim('Cursor:')}   ${chalk.cyan('Active session')} (${session.launched.length} agents)`);
+    console.log(`  ${chalk.dim('Started:')}  ${session.started_at}`);
+    if (session.repo) console.log(`  ${chalk.dim('Repo:')}     ${session.repo}`);
+    console.log('');
+  }
+
   // Agents
   console.log(`  ${chalk.dim('Agents:')}   ${Object.keys(config.agents).length}`);
+
   for (const [id, agent] of Object.entries(config.agents)) {
     const isHolder = lock?.holder === id;
     const marker = isHolder ? chalk.yellow('●') : chalk.dim('○');
     const label = isHolder ? chalk.bold(id) : id;
-    console.log(`    ${marker} ${label} — ${agent.name}`);
+
+    let cursorStatus = '';
+    if (hasCursor && apiKey) {
+      const cloudAgent = session.launched.find(a => a.id === id);
+      if (cloudAgent) {
+        try {
+          const statusData = await getAgentStatus(apiKey, cloudAgent.cloudId);
+          if (statusData?.status) {
+            cursorStatus = ` ${formatCursorStatus(statusData.status)}`;
+          }
+        } catch {
+          cursorStatus = chalk.dim(' [API error]');
+        }
+      }
+    }
+
+    console.log(`    ${marker} ${label} — ${agent.name}${cursorStatus}`);
+  }
+
+  if (lock?.holder === 'human') {
+    console.log(`    ${chalk.magenta('●')} ${chalk.bold('human')} — You`);
   }
+
   console.log('');
 }
 
 function formatPhase(phase) {
-  const colors = {
-    discovery: chalk.blue,
-    build: chalk.green,
-    qa: chalk.yellow,
-    deploy: chalk.magenta,
-    blocked: chalk.red
+  const colors = { discovery: chalk.blue, build: chalk.green, qa: chalk.yellow, deploy: chalk.magenta, blocked: chalk.red };
+  return (colors[phase] || chalk.white)(phase);
+}
+
+function formatCursorStatus(status) {
+  const map = {
+    CREATING: chalk.dim('[creating]'),
+    RUNNING: chalk.cyan('[running]'),
+    FINISHED: chalk.green('[finished]'),
+    STOPPED: chalk.yellow('[stopped]'),
+    ERRORED: chalk.red('[errored]'),
   };
-  const fn = colors[phase] || chalk.white;
-  return fn(phase);
+  return map[status] || chalk.dim(`[${status}]`);
 }
 
 function timeSince(iso) {

package/src/commands/stop.js

@@ -2,85 +2,69 @@ import { readFileSync, existsSync, unlinkSync } from 'fs';
 import { join } from 'path';
 import chalk from 'chalk';
 import { loadConfig } from '../lib/config.js';
+import { deleteAgent, stopAgent, loadSession } from '../adapters/cursor.js';
 
 const SESSION_FILE = '.agentxchain-session.json';
 
 export async function stopCommand() {
   const result = loadConfig();
-  if (!result) {
-    console.log(chalk.red('No agentxchain.json found.'));
-    process.exit(1);
-  }
+  if (!result) { console.log(chalk.red('  No agentxchain.json found.')); process.exit(1); }
 
   const { root } = result;
-  const sessionPath = join(root, SESSION_FILE);
+  const session = loadSession(root);
 
-  if (!existsSync(sessionPath)) {
-    console.log(chalk.yellow('  No active session found (.agentxchain-session.json missing).'));
-    console.log(chalk.dim('  If agents are running, stop them manually in the IDE.'));
+  if (!session) {
+    console.log(chalk.yellow('  No active session found.'));
+    console.log(chalk.dim('  If agents are running, stop them manually.'));
     return;
   }
 
-  const session = JSON.parse(readFileSync(sessionPath, 'utf8'));
   console.log('');
   console.log(chalk.bold(`  Stopping ${session.launched.length} agents (${session.ide})`));
   console.log('');
 
-  switch (session.ide) {
-    case 'cursor':
-      await stopCursorAgents(session);
-      break;
-    case 'claude-code':
-      stopClaudeCodeAgents(session);
-      break;
-    default:
-      console.log(chalk.yellow(`  IDE "${session.ide}" — manual stop required.`));
-  }
-
-  unlinkSync(sessionPath);
-  console.log('');
-  console.log(chalk.dim('  Session file removed.'));
-  console.log(chalk.green('  All agents stopped.'));
-  console.log('');
-}
-
-async function stopCursorAgents(session) {
-  const apiKey = process.env.CURSOR_API_KEY;
-
-  for (const agent of session.launched) {
-    if (agent.cloudId && apiKey) {
-      try {
-        const res = await fetch(`https://api.cursor.com/v0/agents/${agent.cloudId}`, {
-          method: 'DELETE',
-          headers: { 'Authorization': `Basic ${btoa(apiKey + ':')}` }
-        });
-        if (res.ok) {
-          console.log(chalk.green(`  ✓ Stopped ${agent.id} (cloud ID: ${agent.cloudId})`));
-        } else {
-          console.log(chalk.yellow(`  ⚠ Could not stop ${agent.id}: ${res.status}`));
+  if (session.ide === 'cursor') {
+    const apiKey = process.env.CURSOR_API_KEY;
+    if (!apiKey) {
+      console.log(chalk.yellow('  CURSOR_API_KEY not set. Cannot stop agents via API.'));
+      console.log(chalk.dim('  Stop them manually at cursor.com/agents'));
+    } else {
+      for (const agent of session.launched) {
+        try {
+          const deleted = await deleteAgent(apiKey, agent.cloudId);
+          if (deleted) {
+            console.log(chalk.green(`  ✓ Deleted ${chalk.bold(agent.id)} (${agent.cloudId})`));
+          } else {
+            console.log(chalk.yellow(`  ⚠ Could not delete ${agent.id} — may already be gone`));
+          }
+        } catch (err) {
+          console.log(chalk.red(`  ✗ ${agent.id}: ${err.message}`));
         }
-      } catch (err) {
-        console.log(chalk.red(`  ✗ Error stopping ${agent.id}: ${err.message}`));
       }
-    } else {
-      console.log(chalk.dim(`  ${agent.id} — no cloud ID or API key; stop manually in Cursor.`));
     }
-  }
-}
-
-function stopClaudeCodeAgents(session) {
-  for (const agent of session.launched) {
-    if (agent.pid) {
-      try {
-        process.kill(agent.pid, 'SIGTERM');
-        console.log(chalk.green(`  ✓ Sent SIGTERM to ${agent.id} (PID: ${agent.pid})`));
-      } catch (err) {
-        if (err.code === 'ESRCH') {
-          console.log(chalk.dim(`  ${agent.id} (PID: ${agent.pid}) — already stopped.`));
-        } else {
-          console.log(chalk.red(`  ✗ Error stopping ${agent.id}: ${err.message}`));
+  } else if (session.ide === 'claude-code') {
+    for (const agent of session.launched) {
+      if (agent.pid) {
+        try {
+          process.kill(agent.pid, 'SIGTERM');
+          console.log(chalk.green(`  ✓ Sent SIGTERM to ${agent.id} (PID: ${agent.pid})`));
+        } catch (err) {
+          if (err.code === 'ESRCH') {
+            console.log(chalk.dim(`  ${agent.id} (PID: ${agent.pid}) — already stopped`));
+          } else {
+            console.log(chalk.red(`  ✗ ${agent.id}: ${err.message}`));
+          }
         }
       }
     }
   }
+
+  // Remove session file
+  const sessionPath = join(root, SESSION_FILE);
+  if (existsSync(sessionPath)) unlinkSync(sessionPath);
+
+  console.log('');
+  console.log(chalk.dim('  Session file removed.'));
+  console.log(chalk.green('  All agents stopped.'));
+  console.log('');
 }

package/src/commands/update.js

@@ -0,0 +1,42 @@
+import { execSync } from 'child_process';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+
+export async function updateCommand() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf8'));
+  const currentVersion = pkg.version;
+
+  console.log('');
+  console.log(`  ${chalk.dim('Current version:')} ${currentVersion}`);
+  console.log(`  ${chalk.dim('Checking npm for latest...')}`);
+
+  try {
+    const latest = execSync('npm view agentxchain version', { encoding: 'utf8' }).trim();
+
+    if (latest === currentVersion) {
+      console.log(chalk.green(`  ✓ Already on the latest version (${currentVersion}).`));
+      console.log('');
+      return;
+    }
+
+    console.log(`  ${chalk.dim('Latest version:')}  ${chalk.cyan(latest)}`);
+    console.log('');
+    console.log(`  Updating...`);
+
+    execSync('npm install -g agentxchain@latest', { stdio: 'inherit' });
+
+    console.log('');
+    console.log(chalk.green(`  ✓ Updated to ${latest}`));
+    console.log('');
+  } catch (err) {
+    console.log('');
+    console.log(chalk.yellow('  Could not auto-update. Run manually:'));
+    console.log(`    ${chalk.bold('npm install -g agentxchain@latest')}`);
+    console.log('');
+    console.log(chalk.dim(`  Error: ${err.message}`));
+    console.log('');
+  }
+}