multi-agents-cli 1.0.68 → 1.0.69

package/lib/detect.js

@@ -0,0 +1,132 @@
+'use strict';
+
+const fs        = require('fs');
+const path      = require('path');
+const os        = require('os');
+const { execSync } = require('child_process');
+
+// ── Colors (inline — avoid circular dep with ui.js) ──────────────────────────
+
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const dim   = (s) => `\x1b[2m${s}\x1b[0m`;
+
+// ── IDE detection ─────────────────────────────────────────────────────────────
+
+const expandWinPath = (p) =>
+  p.replace('{LOCALAPPDATA}', process.env.LOCALAPPDATA || '')
+   .replace('{ProgramFiles}',  process.env.ProgramFiles  || 'C:\\Program Files');
+
+const buildIDEOptions = (IDE_CANDIDATES) => {
+  const platform = process.platform;
+
+  return IDE_CANDIDATES.map(ide => {
+    if (!ide.cmd) {
+      const noteStr = ide.note ? dim(`  (${ide.note})`) : '';
+      return { ...ide, detected: false, strategy: 'manual', label: `${ide.name}   ${dim('→')}${noteStr}` };
+    }
+
+    let detected = false;
+    let strategy = 'cli';
+
+    if (platform === 'darwin' && ide.mac) {
+      const system  = `/Applications/${ide.mac.app}.app`;
+      const user    = path.join(os.homedir(), 'Applications', `${ide.mac.app}.app`);
+      const toolbox = path.join(os.homedir(), 'Applications', 'JetBrains Toolbox', `${ide.mac.app}.app`);
+      detected = fs.existsSync(system) || fs.existsSync(user) || fs.existsSync(toolbox);
+      if (detected) strategy = 'mac-app';
+
+    } else if (platform === 'win32' && ide.win) {
+      try {
+        execSync(`where ${ide.cmd}`, { stdio: 'pipe' });
+        detected = true;
+        strategy = 'cli';
+      } catch {
+        const expanded = (ide.win.paths || []).map(expandWinPath);
+        detected = expanded.some(p => fs.existsSync(p));
+        if (detected) strategy = 'win-exe';
+      }
+
+    } else if (platform === 'linux' && ide.linux) {
+      try {
+        execSync(`which ${ide.cmd}`, { stdio: 'pipe' });
+        detected = true;
+        strategy = 'cli';
+      } catch {
+        detected = (ide.linux.paths || []).some(p => fs.existsSync(p));
+        if (detected) strategy = 'linux-path';
+      }
+    }
+
+    const statusStr = detected ? green('✓ detected') : dim('✗ not found');
+    const noteStr   = ide.note ? dim(`  (${ide.note})`) : '';
+    return { ...ide, detected, strategy, label: `${ide.name}   ${statusStr}${noteStr}` };
+  });
+};
+
+const verifyIDE = (ide) => {
+  const platform = process.platform;
+
+  if (ide.strategy === 'mac-app' && ide.mac) {
+    const appPath  = `/Applications/${ide.mac.app}.app`;
+    const userPath = path.join(os.homedir(), 'Applications', `${ide.mac.app}.app`);
+    if (!fs.existsSync(appPath) && !fs.existsSync(userPath)) return { ok: false };
+    try {
+      const version = execSync(
+        `defaults read "/Applications/${ide.mac.app}.app/Contents/Info.plist" CFBundleShortVersionString`,
+        { stdio: 'pipe', encoding: 'utf8' }
+      ).trim();
+      return { ok: true, version };
+    } catch {
+      return { ok: true, version: null };
+    }
+  }
+
+  try {
+    const cmd = ide.strategy === 'win-exe'
+      ? `"${(ide.win?.paths || []).map(expandWinPath).find(p => fs.existsSync(p))}"`
+      : ide.strategy === 'linux-path'
+        ? `"${(ide.linux?.paths || []).find(p => fs.existsSync(p))}"`
+        : `"${ide.cmd}"`;
+    const result  = execSync(`${cmd} --version`, { stdio: 'pipe', encoding: 'utf8' });
+    const version = result.split('\n')[0].trim();
+    return { ok: true, version };
+  } catch {
+    return { ok: false };
+  }
+};
+
+// ── Terminal detection ────────────────────────────────────────────────────────
+
+const detectTerminal = () => {
+  const platform = process.platform;
+
+  if (platform === 'darwin') {
+    const apps = [
+      { name: 'iTerm2',       cmd: 'iTerm2',   path: '/Applications/iTerm.app' },
+      { name: 'Warp',         cmd: 'Warp',     path: '/Applications/Warp.app' },
+      { name: 'Terminal.app', cmd: 'Terminal', path: '/System/Applications/Utilities/Terminal.app' },
+    ];
+    return apps.find(a => fs.existsSync(a.path)) || { name: 'Terminal.app', cmd: 'Terminal' };
+
+  } else if (platform === 'win32') {
+    const wtPath = (process.env.LOCALAPPDATA || '') + '\\Microsoft\\WindowsApps\\wt.exe';
+    if (fs.existsSync(wtPath)) return { name: 'Windows Terminal', cmd: 'wt' };
+    return { name: 'Command Prompt', cmd: 'cmd' };
+
+  } else {
+    const terms = ['gnome-terminal', 'konsole', 'xterm'];
+    for (const t of terms) {
+      try { execSync('which ' + t, { stdio: 'pipe' }); return { name: t, cmd: t }; } catch {}
+    }
+    return { name: 'xterm', cmd: 'xterm' };
+  }
+};
+
+// ── Exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  expandWinPath,
+  buildIDEOptions,
+  verifyIDE,
+  detectTerminal,
+};

package/lib/questions.js

@@ -0,0 +1,266 @@
+'use strict';
+
+const os = require('os');
+
+// ── Framework conventions ─────────────────────────────────────────────────────
+
+const FRAMEWORK_CONVENTIONS = {
+  client: {
+    'Next.js':    { root: 'client', typesDir: 'client/src/types',             importAlias: '@/types'      },
+    'Angular':    { root: 'client', typesDir: 'client/src/app/core/types',    importAlias: null           },
+    'Nuxt':       { root: 'client', typesDir: 'client/types',                 importAlias: '~/types'      },
+    'SvelteKit':  { root: 'client', typesDir: 'client/src/lib/types',         importAlias: '$lib/types'   },
+    'Vite+React': { root: 'client', typesDir: 'client/src/types',             importAlias: null           },
+    'Remix':      { root: 'client', typesDir: 'client/app/types',             importAlias: null           },
+  },
+  backend: {
+    'Express':    { root: 'backend', typesDir:   'backend/src/types',         routesDir:  'backend/src/routes'      },
+    'NestJS':     { root: 'backend', dtoDir:     'backend/src/dto',           entitiesDir:'backend/src/entities'    },
+    'Fastify':    { root: 'backend', typesDir:   'backend/src/types',         routesDir:  'backend/src/routes'      },
+    'FastAPI':    { root: 'backend', schemasDir: 'backend/app/schemas',       modelsDir:  'backend/app/models'      },
+    'Django':     { root: 'backend', schemasDir: 'backend/api/serializers',   modelsDir:  'backend/api/models'      },
+  },
+};
+
+// ── Client frameworks ─────────────────────────────────────────────────────────
+
+const CLIENT_FRAMEWORKS = [
+  { label: 'Next.js',       value: 'Next.js',    language: 'TypeScript', integratedBackend: true  },
+  { label: 'Angular',       value: 'Angular',    language: 'TypeScript', integratedBackend: false },
+  { label: 'Vue / Nuxt',    value: 'Nuxt',       language: 'TypeScript', integratedBackend: true  },
+  { label: 'SvelteKit',     value: 'SvelteKit',  language: 'TypeScript', integratedBackend: true  },
+  { label: 'Remix',         value: 'Remix',      language: 'TypeScript', integratedBackend: true  },
+  { label: 'Vite + React',  value: 'Vite+React', language: 'TypeScript', integratedBackend: false },
+];
+
+// ── Backend frameworks ────────────────────────────────────────────────────────
+
+const BACKEND_FRAMEWORKS = [
+  { label: 'NestJS',   value: 'NestJS',   language: 'TypeScript' },
+  { label: 'Express',  value: 'Express',  language: 'TypeScript' },
+  { label: 'Fastify',  value: 'Fastify',  language: 'TypeScript' },
+  { label: 'Django',   value: 'Django',   language: 'Python'     },
+  { label: 'FastAPI',  value: 'FastAPI',  language: 'Python'     },
+  { label: 'Laravel',  value: 'Laravel',  language: 'PHP'        },
+  { label: 'Rails',    value: 'Rails',    language: 'Ruby'       },
+];
+
+// ── Framework version registry ────────────────────────────────────────────────
+
+const FRAMEWORK_REGISTRY = {
+  'Next.js':    { registry: 'npm',  package: 'next'               },
+  'Angular':    { registry: 'npm',  package: '@angular/core'      },
+  'Nuxt':       { registry: 'npm',  package: 'nuxt'               },
+  'SvelteKit':  { registry: 'npm',  package: '@sveltejs/kit'      },
+  'Remix':      { registry: 'npm',  package: '@remix-run/react'   },
+  'Vite+React': { registry: 'npm',  package: 'vite'               },
+  'NestJS':     { registry: 'npm',  package: '@nestjs/core'       },
+  'Express':    { registry: 'npm',  package: 'express'            },
+  'Fastify':    { registry: 'npm',  package: 'fastify'            },
+  'FastAPI':    { registry: 'pypi', package: 'fastapi'            },
+  'Django':     { registry: 'pypi', package: 'django'             },
+  'Laravel':    { registry: 'npm',  package: null                 },
+  'Rails':      { registry: 'npm',  package: null                 },
+};
+
+const FRAMEWORK_VERSION_FALLBACK = {
+  'Next.js':    ['15', '14', '13'],
+  'Angular':    ['22', '21', '20'],
+  'Nuxt':       ['3',  '2',  null],
+  'SvelteKit':  ['2',  '1',  null],
+  'Remix':      ['2',  '1',  null],
+  'Vite+React': ['8',  '7',  '6'],
+  'NestJS':     ['11', '10', '9' ],
+  'Express':    ['5',  '4'],
+  'Fastify':    ['5',  '4',  null],
+  'FastAPI':    ['0.115', '0.111', '0.104'],
+  'Django':     ['5.1', '4.2', '3.2'],
+};
+
+const fetchLatestVersions = async (frameworkValue) => {
+  const entry = FRAMEWORK_REGISTRY[frameworkValue];
+  if (!entry || !entry.package) return null;
+
+  try {
+    const https = require('https');
+    const fetch = (url) => new Promise((resolve, reject) => {
+      const req = https.get(url, { timeout: 3000 }, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => resolve(data));
+      });
+      req.on('error', reject);
+      req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+    });
+
+    if (entry.registry === 'npm') {
+      const raw  = await fetch(`https://registry.npmjs.org/${entry.package}`);
+      const json = JSON.parse(raw);
+      const versions = Object.keys(json.versions || {})
+        .filter(v => /^\d+\.\d+\.\d+$/.test(v) && !v.includes('-'))
+        .map(v => parseInt(v.split('.')[0]))
+        .filter((v, i, arr) => arr.indexOf(v) === i)
+        .sort((a, b) => b - a)
+        .slice(0, 3);
+      return versions.length ? versions.map(String) : null;
+    }
+
+    if (entry.registry === 'pypi') {
+      const raw  = await fetch(`https://pypi.org/pypi/${entry.package}/json`);
+      const json = JSON.parse(raw);
+      const versions = Object.keys(json.releases || {})
+        .filter(v => /^\d+\.\d+(\.\d+)?$/.test(v))
+        .sort((a, b) => {
+          const [aMaj, aMin = 0] = a.split('.').map(Number);
+          const [bMaj, bMin = 0] = b.split('.').map(Number);
+          return bMaj !== aMaj ? bMaj - aMaj : bMin - aMin;
+        })
+        .map(v => v.split('.').slice(0, 2).join('.'))
+        .filter((v, i, arr) => arr.indexOf(v) === i)
+        .slice(0, 3);
+      return versions.length ? versions : null;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+};
+
+// ── Option maps ───────────────────────────────────────────────────────────────
+
+const STATE_OPTIONS = {
+  'Next.js':    ['Zustand', 'Redux Toolkit', 'Jotai', 'TanStack Query'],
+  'Vite+React': ['Zustand', 'Redux Toolkit', 'Jotai', 'TanStack Query'],
+  'Remix':      ['Zustand', 'Redux Toolkit', 'Jotai', 'TanStack Query'],
+  'Angular':    ['NgRx', 'Signals (built-in)', 'Akita'],
+  'Nuxt':       ['Pinia', 'Vuex'],
+  'SvelteKit':  ['Svelte stores (built-in)', 'Zustand'],
+};
+
+const UI_OPTIONS = {
+  'Next.js':    ['shadcn/ui', 'Radix UI', 'MUI', 'Chakra UI', 'Ant Design'],
+  'Vite+React': ['Radix UI', 'MUI', 'Chakra UI', 'Ant Design'],
+  'Remix':      ['shadcn/ui', 'Radix UI', 'MUI', 'Chakra UI', 'Ant Design'],
+  'Angular':    ['Angular Material', 'PrimeNG', 'Clarity'],
+  'Nuxt':       ['Vuetify', 'PrimeVue', 'Naive UI'],
+  'SvelteKit':  ['Skeleton', 'daisyUI', 'shadcn-svelte'],
+};
+
+const STYLING_OPTIONS = [
+  'Tailwind CSS',
+  'CSS Modules',
+  'Styled Components',
+  'SCSS / SASS',
+  'UnoCSS',
+];
+
+const DB_OPTIONS = ['PostgreSQL', 'MySQL', 'MongoDB', 'SQLite', 'Skip (agent will propose when needed)'];
+
+const ORM_OPTIONS_BY_DB = {
+  'PostgreSQL': ['Prisma', 'TypeORM', 'Drizzle', 'Sequelize', 'raw pg driver', 'Skip (agent will propose when needed)'],
+  'MySQL':      ['Prisma', 'TypeORM', 'Drizzle', 'Sequelize', 'raw mysql2 driver', 'Skip (agent will propose when needed)'],
+  'MongoDB':    ['Mongoose', 'Prisma', 'raw MongoDB driver', 'Skip (agent will propose when needed)'],
+  'SQLite':     ['Prisma', 'Drizzle', 'better-sqlite3', 'Skip (agent will propose when needed)'],
+};
+
+const ORM_OPTIONS = {
+  'NestJS':   ['TypeORM', 'Prisma', 'MikroORM', 'Drizzle'],
+  'Express':  ['Prisma', 'TypeORM', 'Drizzle', 'Sequelize'],
+  'Fastify':  ['Prisma', 'TypeORM', 'Drizzle'],
+  'Django':   ['Django ORM (built-in)', 'SQLAlchemy'],
+  'FastAPI':  ['SQLAlchemy', 'Tortoise ORM', 'Beanie (MongoDB)'],
+  'Laravel':  ['Eloquent (built-in)'],
+  'Rails':    ['Active Record (built-in)'],
+};
+
+const AUTH_OPTIONS = {
+  'NestJS':   ['Passport.js', 'JWT-only', 'OAuth2', 'Auth.js'],
+  'Express':  ['Passport.js', 'JWT-only', 'OAuth2'],
+  'Fastify':  ['fastify-jwt', 'Passport.js', 'OAuth2'],
+  'Django':   ['Django Auth (built-in)', 'DRF TokenAuth', 'OAuth2'],
+  'FastAPI':  ['JWT-only', 'OAuth2', 'FastAPI-Users'],
+  'Laravel':  ['Laravel Sanctum', 'Laravel Passport', 'JWT'],
+  'Rails':    ['Devise', 'JWT', 'OAuth2'],
+};
+
+// ── IDE candidates ────────────────────────────────────────────────────────────
+
+const IDE_CANDIDATES = [
+  {
+    cmd:   'code',
+    name:  'VS Code',
+    mac:   { app: 'Visual Studio Code', args: ['--new-window'] },
+    win:   { paths: ['{LOCALAPPDATA}\\Programs\\Microsoft VS Code\\Code.exe', '{ProgramFiles}\\Microsoft VS Code\\Code.exe'], args: ['--new-window'] },
+    linux: { paths: ['/snap/bin/code', '/usr/bin/code', '/usr/local/bin/code'], args: ['--new-window'] },
+  },
+  {
+    cmd:   'cursor',
+    name:  'Cursor',
+    mac:   { app: 'Cursor', args: ['--new-window'] },
+    win:   { paths: ['{LOCALAPPDATA}\\Programs\\cursor\\Cursor.exe'], args: ['--new-window'] },
+    linux: { paths: ['/usr/bin/cursor', '/opt/cursor/cursor'], args: ['--new-window'] },
+  },
+  {
+    cmd:   'webstorm',
+    name:  'WebStorm',
+    mac:   { app: 'WebStorm', toolboxApp: 'WebStorm', args: [] },
+    win:   { paths: [
+      '{LOCALAPPDATA}\\JetBrains\\Toolbox\\scripts\\webstorm.cmd',
+      '{LOCALAPPDATA}\\Programs\\WebStorm\\bin\\webstorm64.exe',
+    ], args: [] },
+    linux: { paths: [
+      `${os.homedir()}/.local/bin/webstorm`,
+      '/opt/webstorm/bin/webstorm.sh',
+      '/snap/webstorm/current/bin/webstorm.sh',
+    ], args: [] },
+  },
+  {
+    cmd:   'idea',
+    name:  'IntelliJ IDEA',
+    mac:   { app: 'IntelliJ IDEA', toolboxApp: 'IntelliJ IDEA', args: [] },
+    win:   { paths: [
+      '{LOCALAPPDATA}\\JetBrains\\Toolbox\\scripts\\idea.cmd',
+      '{LOCALAPPDATA}\\Programs\\IntelliJ IDEA Community Edition\\bin\\idea64.exe',
+      '{ProgramFiles}\\JetBrains\\IntelliJ IDEA\\bin\\idea64.exe',
+    ], args: [] },
+    linux: { paths: [
+      `${os.homedir()}/.local/bin/idea`,
+      '/opt/idea/bin/idea.sh',
+      '/snap/intellij-idea-community/current/bin/idea.sh',
+    ], args: [] },
+  },
+  {
+    cmd:   'zed',
+    name:  'Zed',
+    mac:   { app: 'Zed', args: [] },
+    win:   { paths: [], args: [] },
+    linux: { paths: ['/usr/bin/zed', `${os.homedir()}/.local/bin/zed`], args: [] },
+  },
+  {
+    cmd:   null,
+    name:  'Other / Manual',
+    note:  'prints worktree path, open it yourself',
+    mac:   null,
+    win:   null,
+    linux: null,
+  },
+];
+
+// ── Exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  FRAMEWORK_CONVENTIONS,
+  CLIENT_FRAMEWORKS,
+  BACKEND_FRAMEWORKS,
+  FRAMEWORK_REGISTRY,
+  FRAMEWORK_VERSION_FALLBACK,
+  fetchLatestVersions,
+  STATE_OPTIONS,
+  UI_OPTIONS,
+  STYLING_OPTIONS,
+  DB_OPTIONS,
+  ORM_OPTIONS_BY_DB,
+  ORM_OPTIONS,
+  AUTH_OPTIONS,
+  IDE_CANDIDATES,
+};

package/lib/steps.js

@@ -0,0 +1,89 @@
+'use strict';
+
+// ── Sentinel values ───────────────────────────────────────────────────────────
+
+const BACK     = Symbol('BACK');
+const CONTINUE = Symbol('CONTINUE');
+const RESTART  = Symbol('RESTART');
+
+// ── Step machine ──────────────────────────────────────────────────────────────
+
+class StepMachine {
+  constructor() {
+    this.history      = []; // [{ stepIndex, stepName, answer }]
+    this.inBackNav    = false;
+    this.resumeIndex  = null; // step index where back-nav started
+  }
+
+  // Push a completed step answer onto the history stack
+  push(stepIndex, stepName, answer) {
+    // Replace if already exists (user went back and re-answered)
+    const existing = this.history.findIndex(h => h.stepIndex === stepIndex);
+    if (existing > -1) {
+      this.history[existing] = { stepIndex, stepName, answer };
+    } else {
+      this.history.push({ stepIndex, stepName, answer });
+    }
+  }
+
+  // Pop the last step from history (go back)
+  pop() {
+    return this.history.pop() || null;
+  }
+
+  // Get the answer for a given step index (for pre-filling on back-nav)
+  getAnswer(stepIndex) {
+    const entry = this.history.find(h => h.stepIndex === stepIndex);
+    return entry ? entry.answer : null;
+  }
+
+  // Current step count (1-based, for display)
+  get stepCount() {
+    return this.history.length + 1;
+  }
+
+  // Build the navigation options to append to a step's choices
+  // stepIndex: current step (1-based)
+  // isFirstStep: true if this is step 2 (first real choice after project name)
+  navOptions(stepIndex, isFirstStep = false) {
+    const opts = [];
+
+    if (!isFirstStep) {
+      opts.push({ label: '← Back to previous step', value: BACK });
+    }
+
+    if (this.inBackNav) {
+      const resumeName = this.history[this.resumeIndex]?.stepName || `step ${this.resumeIndex + 1}`;
+      opts.push({ label: `→ Continue flow (resume from ${resumeName} - no changes applied)`, value: CONTINUE });
+    }
+
+    opts.push({ label: '← Restart configuration', value: RESTART });
+
+    return opts;
+  }
+
+  // Enter back-nav mode — record where the user first pressed Back
+  enterBackNav(currentStepIndex) {
+    if (!this.inBackNav) {
+      this.inBackNav   = true;
+      this.resumeIndex = currentStepIndex;
+    }
+  }
+
+  // Exit back-nav mode
+  exitBackNav() {
+    this.inBackNav   = false;
+    this.resumeIndex = null;
+  }
+
+  // Reset everything
+  reset() {
+    this.history     = [];
+    this.inBackNav   = false;
+    this.resumeIndex = null;
+  }
+}
+
+// ── Exports ───────────────────────────────────────────────────────────────────
+
+module.exports = { StepMachine, BACK, CONTINUE, RESTART };

package/lib/summary.js

@@ -0,0 +1,140 @@
+'use strict';
+
+const fs           = require('fs');
+const path         = require('path');
+const { spawn }    = require('child_process');
+
+// ── Colors (inline — avoid circular dep) ─────────────────────────────────────
+
+const bold   = (s) => `\x1b[1m${s}\x1b[0m`;
+const green  = (s) => `\x1b[32m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const dim    = (s) => `\x1b[2m${s}\x1b[0m`;
+const cyan   = (s) => `\x1b[36m${s}\x1b[0m`;
+const separator = () => console.log(`\n\x1b[2m${'─'.repeat(60)}\x1b[0m`);
+
+// ── Trajectory details ────────────────────────────────────────────────────────
+
+const TRAJECTORY_DETAILS = {
+  '1': {
+    label: 'Multi-Agent Driven Orchestration',
+    full: [
+      'Every task must start with npm run agent.',
+      'Agent sessions load only task-relevant context, enabling reliable',
+      'chaining, predictable behavior, and efficient token usage.',
+      '',
+      '⚠ If you commit directly to main yourself, you bypass the framework',
+      '  and break task tracking for any active agent branches.',
+      '',
+      'Benefits',
+      '· Scoped context per task',
+      '· Predictable token consumption',
+      '· Lower cost than maintaining large, persistent sessions',
+      '· Better isolation between parallel work streams',
+    ],
+    next: 'launch',
+  },
+  '2': {
+    label: 'Shared Orchestration',
+    full: [
+      'You and agents work in the same codebase, each with clearly',
+      'defined ownership. File boundaries must be established before',
+      'work begins and remain fixed throughout the task.',
+      'Agents excel when scope is well-defined;',
+      'you excel when requirements are evolving.',
+      '',
+      'Use agents for',
+      '· Multi-file features',
+      '· Structured implementation work',
+      '· Domain-specific tasks',
+      '· Changes expected to exceed ~200 lines',
+      '',
+      'Handle manually',
+      '· Targeted bug fixes',
+      '· Configuration changes',
+      '· Small refactors',
+      '· Single-file edits under ~50 lines',
+      '',
+      '⚠ Avoid overlapping file ownership. Working on the same files',
+      '  as an active agent will create merge conflicts when merged.',
+      '⚠ If you are spending time repeatedly clarifying scope, stop',
+      '  and do the task yourself. The coordination cost often',
+      '  exceeds the implementation cost.',
+      '',
+      'Benefits',
+      '· Maximum agent efficiency for well-defined work',
+      '· Human flexibility where requirements change',
+      '· Scales well across large projects',
+      '· Most adaptable workflow — requires the most discipline',
+    ],
+    next: 'launch',
+  },
+};
+
+// ── Render trajectory lines ───────────────────────────────────────────────────
+
+const renderTrajectoryLines = (lines) => {
+  const HEADERS = ['Benefits', 'Best for', 'Use agents for', 'Handle manually'];
+  lines.forEach(l => {
+    if (!l)                        { console.log(''); return; }
+    if (l.startsWith('⚠'))        console.log(`  ${yellow(l)}`);
+    else if (HEADERS.includes(l)) console.log(`\n  ${bold(l)}`);
+    else if (l.startsWith('·'))   console.log(`  ${l}`);
+    else                          console.log(`  ${dim(l)}`);
+  });
+};
+
+// ── Init summary output ───────────────────────────────────────────────────────
+
+const printInitSummary = ({ projectName, config, selectedLabel, ROOT, rl }) => {
+  const bt = config.backend?.type;
+
+  separator();
+  console.log(`\n${bold(green('  Project initialized successfully!'))}\n`);
+
+  console.log(`  ${dim('Project')}   : ${bold(projectName)}`);
+  console.log(`  ${dim('Client')}    : ${config.client.framework} / ${config.client.language}${config.client.uiLibrary ? ' / ' + config.client.uiLibrary : ''}`);
+  if (bt === 'separate') {
+    console.log(`  ${dim('Backend')}   : ${config.backend.framework} / ${config.backend.language}${config.backend.orm ? ' / ' + config.backend.orm : ''}`);
+  } else {
+    console.log(`  ${dim('Backend')}   : integrated (API routes / SSR)`);
+  }
+  console.log(`  ${dim('Workflow')}  : ${selectedLabel}\n`);
+
+  console.log(`  ${dim('Files generated:')}`);
+  console.log(`  ${green('+')} CLAUDE.md, client/CLAUDE.md${bt === 'separate' ? ', backend/CLAUDE.md' : ''}`);
+  console.log(`  ${green('+')} BUILD_STATE.md, TASKS_HISTORY.md, CONTRACTS.md`);
+  console.log(`  ${green('+')} CLOUD_STATE.md, shared/wiring.config.json`);
+  console.log(`  ${green('+')} .scaffold/.config.json, .scaffold/scope-policy.json`);
+  console.log(`  ${green('+')} .agents/, .frameworks/, .workflow/\n`);
+
+  console.log(`  ${dim('Git:')}`);
+  console.log(`  ${green('+')} Repository initialized on main`);
+  console.log(`  ${green('+')} Pre-commit hook installed (direct main commits blocked)`);
+  console.log(`  ${green('+')} Initial commit created\n`);
+
+  console.log(`  ${dim('Agents available:')}`);
+  console.log(`  ${dim('client')}  : UI, LOGIC, FORMS, ROUTING, ACCESSIBILITY, TESTING`);
+  if (bt === 'separate') {
+    console.log(`  ${dim('backend')} : INIT, API, AUTH, DB, LOGIC, EVENTS, JOBS, TESTING`);
+  }
+  console.log(`  ${dim('shared')}  : CLOUD, SECURITY\n`);
+
+  console.log(`  ${dim('Starting your first agent session...\n')}`);
+  separator();
+  console.log('');
+  rl.close();
+
+  const agentProc = spawn('npm', ['run', 'agent'], { cwd: ROOT, stdio: 'inherit' });
+  agentProc.on('error', (err) => {
+    console.error('  Could not start agent:', err.message);
+  });
+};
+
+// ── Exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  TRAJECTORY_DETAILS,
+  renderTrajectoryLines,
+  printInitSummary,
+};