multi-agents-cli 1.0.57 → 1.0.58

package/core/workflow/agent.js

@@ -169,6 +169,51 @@ const openIDE = (worktreePath) => {
   }
 };
 
+
+// ── Open new OS terminal with Claude Code CLI ─────────────────────────────────
+
+const openTerminal = (worktreePath) => {
+  try {
+    if (process.platform === 'darwin') {
+      execSync(`osascript -e 'tell app "Terminal" to do script "cd \\"${worktreePath}\\" && claude"'`, { stdio: 'pipe' });
+    } else if (process.platform === 'win32') {
+      execSync(`start cmd /k "cd /d "${worktreePath}" && claude"`, { stdio: 'pipe' });
+    } else {
+      execSync(`gnome-terminal -- bash -c "cd '${worktreePath}' && claude; exec bash" &`, { stdio: 'pipe' });
+    }
+    return true;
+  } catch { return false; }
+};
+
+
+// ── Workspace tree display ────────────────────────────────────────────────────
+
+const displayWorkspaceTree = (worktreeName, worktreePath, project, agent, framework) => {
+  const fwFile = framework ? framework.toLowerCase().replace(/[^a-z0-9]/g, '-') + '.md' : null;
+  console.log(`\n  ${bold('Your workspace is ready:')}\n`);
+  console.log(`  worktrees/`);
+  console.log(`  ${dim('└──')} ${cyan(worktreeName + '/')}   ${dim('<- scope (' + project + ') - agent (' + agent + ') - timestamp')}`);
+  console.log(`  ${dim('    |-- TASK.md')}                ${dim('<- read this first, contains your task')}`);
+  console.log(`  ${dim('    |-- .claude-scope')}          ${dim('<- scope identity (' + project + ' / ' + agent + ')')}`);
+  console.log(`  ${dim('    |-- scope.json')}             ${dim('<- enforcement policy reference')}`);
+  console.log(`  ${dim('    |-- package.json')}           ${dim('<- run npm run complete when done')}`);
+  console.log(`  ${dim('    |-- ' + project + '/')}                  ${dim('<- your work goes here')}`);
+  console.log(`  ${dim('    |   |-- CLAUDE.md')}          ${dim('<- ' + project + '-specific rules and stack config')}`);
+  console.log(`  ${dim('    |-- .agents/')}`);
+  console.log(`  ${dim('    |   |-- ' + project + '/')}`);
+  console.log(`  ${dim('    |       |-- ' + agent + '.md')}          ${dim('<- agent instructions, loaded by Claude Code')}`);
+  if (fwFile) {
+    console.log(`  ${dim('    |-- .frameworks/')}`);
+    console.log(`  ${dim('    |   |-- ' + project + '/')}`);
+    console.log(`  ${dim('    |       |-- ' + fwFile)}      ${dim('<- framework scaffold conventions')}`);
+  }
+  console.log(`  ${dim('    |-- .workflow/')}             ${dim('<- workflow scripts (do not edit)')}`);
+  console.log(`  ${dim('        |-- agent.js')}`);
+  console.log(`  ${dim('        |-- complete.js')}`);
+  console.log(`  ${dim('        |-- guards.js')}`);
+  console.log('');
+};
+
 // ── Agent map ─────────────────────────────────────────────────────────────────
 
 const AGENTS = {
@@ -1344,6 +1389,84 @@ ${excludedUrls}
     }
   }
 
+  // ── Session start selection ──────────────────────────────────────────────────
+
+  separator();
+  console.log(`\n${bold('  Workspace is set up and ready.')}\n`);
+
+  const sessionIdx = await arrowSelect('How would you like to start the session?', [
+    { label: `${green('→')} IDE + new terminal ${dim('(Claude Code CLI)')}  ${dim('← recommended')}` },
+    { label: `${green('→')} IDE only` },
+    { label: `${green('→')} Claude Code CLI only ${dim('(new terminal)')}` },
+    { label: `${dim('?')} I\'ll continue from here, where do I start?` },
+  ], rl);
+
+  if (sessionIdx === 0) {
+    const openedIDE = openIDE(worktreePath);
+    if (openedIDE) console.log(`  ${green('✓')} ${openedIDE} opened`);
+    else console.log(`  ${yellow('!')} Could not open IDE - open manually at: ${dim(worktreePath)}`);
+    const termOpened = openTerminal(worktreePath);
+    if (termOpened) console.log(`  ${green('✓')} New terminal opened with Claude Code CLI`);
+    else console.log(`  ${yellow('!')} Could not open terminal - run ${cyan('claude')} manually in: ${dim(worktreePath)}`);
+    separator();
+    console.log(`\n  ${dim('When the agent is done, run:')} ${cyan('npm run complete')}\n`);
+
+  } else if (sessionIdx === 1) {
+    const openedIDE = openIDE(worktreePath);
+    if (openedIDE) console.log(`  ${green('✓')} ${openedIDE} opened`);
+    else console.log(`  ${yellow('!')} Could not open IDE - open manually at: ${dim(worktreePath)}`);
+    separator();
+    console.log(`\n  ${dim('Open a NEW Claude Code session and type')} ${cyan('go')} ${dim('to start.')}\n`);
+    console.log(`  ${dim('When done, run:')} ${cyan('npm run complete')}\n`);
+
+  } else if (sessionIdx === 2) {
+    const termOpened = openTerminal(worktreePath);
+    if (termOpened) console.log(`  ${green('✓')} New terminal opened with Claude Code CLI`);
+    else console.log(`  ${yellow('!')} Could not open terminal - run ${cyan('claude')} manually in: ${dim(worktreePath)}`);
+    separator();
+    console.log(`\n  ${dim('When the agent is done, run:')} ${cyan('npm run complete')}\n`);
+
+  } else {
+    separator();
+    const subIdx = await arrowSelect('What would you like to view?', [
+      { label: 'View instructions' },
+      { label: 'View folder structure' },
+      { label: 'View available agents' },
+    ], rl);
+
+    if (subIdx === 0) {
+      separator();
+      console.log(`\n  ${bold('How to start your agent session:')}\n`);
+      console.log(`  ${bold('1.')} Open your IDE at:`);
+      console.log(`     ${cyan(worktreePath)}\n`);
+      console.log(`  ${bold('2.')} Open a NEW Claude Code session and type ${cyan('go')} to start`);
+      console.log(dim('     Do NOT reuse a previous session.\n'));
+      console.log(`  ${bold('3.')} Let the agent run autonomously\n`);
+      console.log(`  ${bold('4.')} When done, run: ${cyan('npm run complete')} to merge into main\n`);
+
+    } else if (subIdx === 1) {
+      const framework = config.client?.framework || config.backend?.framework || '';
+      displayWorkspaceTree(worktreeName, worktreePath, project, agent, framework);
+
+    } else {
+      const allAgents = AGENTS[project] || [];
+      const completed = buildEntries.filter(e => e.scope === project && e.status === 'COMPLETED').map(e => e.agent);
+      separator();
+      console.log(`\n  ${bold('Available agents for ' + project + ':')}\n`);
+      allAgents.forEach(a => {
+        const done    = completed.includes(a);
+        const current = a === agent;
+        const icon    = current ? cyan('→') : done ? green('✓') : dim('·');
+        const label   = current ? bold(cyan(a)) : done ? dim(a + ' (completed)') : a;
+        console.log(`  ${icon}  ${label}`);
+      });
+      console.log('');
+    }
+  }
+
+  separator();
+  console.log('');
+  rl.close();
   // ── Ready to open workspace? ──────────────────────────────────────────────────
 
   separator();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-agents-cli",
-  "version": "1.0.57",
+  "version": "1.0.58",
   "description": "Multi-agent workflow orchestration for Claude Code — isolated git worktrees, structured state tracking, autonomous task chaining",
   "keywords": [
     "claude-code",