create-battle-plan 1.0.0 → 1.1.0

package/bin/cli.js

@@ -3,31 +3,16 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const os = require('os');
 
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
-});
-
-function ask(question) {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => resolve(answer.trim()));
-  });
-}
+// ── Helpers ──────────────────────────────────────────────
 
 function slugify(text) {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-|-$/g, '');
+  return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
 }
 
 function metricKey(text) {
-  return text
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '_')
-    .replace(/^_|_$/g, '');
+  return text.trim().toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '');
 }
 
 function capitalize(text) {
@@ -47,13 +32,210 @@ function copyDir(src, dest) {
   }
 }
 
+function shortPath(p) {
+  const home = os.homedir();
+  if (p === home) return '~';
+  if (p.startsWith(home + '/')) return '~/' + p.slice(home.length + 1);
+  return p;
+}
+
+// ── Colors ───────────────────────────────────────────────
+
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[2m';
 const GREEN = '\x1b[32m';
 const CYAN = '\x1b[36m';
 const YELLOW = '\x1b[33m';
 const WHITE = '\x1b[37m';
+const INVERSE = '\x1b[7m';
 const RESET = '\x1b[0m';
+const CLEAR_LINE = '\x1b[2K';
+const HIDE_CURSOR = '\x1b[?25l';
+const SHOW_CURSOR = '\x1b[?25h';
+
+// ── Simple question (readline) ───────────────────────────
+
+let rl;
+
+function initReadline() {
+  rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+
+function closeReadline() {
+  if (rl) { rl.close(); rl = null; }
+}
+
+function ask(question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+// ── Interactive folder picker (raw mode) ─────────────────
+
+function getDirs(dir) {
+  try {
+    return fs.readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
+      .map((e) => e.name)
+      .sort((a, b) => a.localeCompare(b, undefined, { sensitivity: 'base' }));
+  } catch {
+    return [];
+  }
+}
+
+function pickFolder(projectSlug) {
+  return new Promise((resolve) => {
+    // Pause readline so we can use raw mode
+    closeReadline();
+
+    let cwd = process.cwd();
+    let selected = 0;
+    let mode = 'browse'; // 'browse' or 'input'
+    let inputBuffer = '';
+
+    function getOptions() {
+      const dirs = getDirs(cwd);
+      const options = [];
+      options.push({ label: `${GREEN}+ Create new folder here${RESET}`, action: 'create' });
+      options.push({ label: `${CYAN}» Install here as ${BOLD}${projectSlug}/${RESET}`, action: 'here' });
+      if (path.dirname(cwd) !== cwd) {
+        options.push({ label: `${DIM}../${RESET}  ${DIM}(up)${RESET}`, action: 'up' });
+      }
+      for (const d of dirs) {
+        options.push({ label: `  ${d}/`, action: 'enter', dir: d });
+      }
+      return options;
+    }
+
+    function render() {
+      const options = getOptions();
+      const display = shortPath(cwd);
+
+      // Move cursor up to clear previous render
+      let output = '';
+
+      if (mode === 'input') {
+        output += `${CLEAR_LINE}\r${DIM}[6/6]${RESET} ${BOLD}Folder name:${RESET} ${inputBuffer}\x1b[K`;
+        process.stdout.write(output);
+        return;
+      }
+
+      output += `\x1b[H\x1b[2J`; // clear screen
+      output += `\n`;
+      output += `${DIM}[6/6]${RESET} ${BOLD}Where do you want to install it?${RESET}\n`;
+      output += `${DIM}      ${display}${RESET}\n`;
+      output += `\n`;
+      output += `${DIM}      ↑↓ navigate · enter select · q cancel${RESET}\n`;
+      output += `\n`;
+
+      for (let i = 0; i < options.length; i++) {
+        if (i === selected) {
+          output += `  ${INVERSE} › ${options[i].label} ${RESET}\n`;
+        } else {
+          output += `    ${options[i].label}\n`;
+        }
+      }
+
+      process.stdout.write(output);
+    }
+
+    function handleBrowseKey(key) {
+      const options = getOptions();
+
+      if (key === '\x1b[A' || key === 'k') {
+        // Up
+        selected = Math.max(0, selected - 1);
+        render();
+      } else if (key === '\x1b[B' || key === 'j') {
+        // Down
+        selected = Math.min(options.length - 1, selected + 1);
+        render();
+      } else if (key === '\r' || key === '\n') {
+        // Enter
+        const opt = options[selected];
+        if (opt.action === 'create') {
+          mode = 'input';
+          inputBuffer = projectSlug;
+          process.stdout.write(`\x1b[H\x1b[2J`);
+          process.stdout.write(`\n`);
+          process.stdout.write(`${DIM}[6/6]${RESET} ${BOLD}Folder name:${RESET} ${inputBuffer}`);
+        } else if (opt.action === 'here') {
+          finish(path.join(cwd, projectSlug));
+        } else if (opt.action === 'up') {
+          cwd = path.dirname(cwd);
+          selected = 0;
+          render();
+        } else if (opt.action === 'enter') {
+          cwd = path.join(cwd, opt.dir);
+          selected = 0;
+          render();
+        }
+      } else if (key === 'q' || key === '\x03') {
+        // q or ctrl-c
+        cleanup();
+        process.stdout.write(SHOW_CURSOR);
+        process.exit(0);
+      }
+    }
+
+    function handleInputKey(key) {
+      if (key === '\r' || key === '\n') {
+        // Confirm
+        if (inputBuffer.length > 0) {
+          finish(path.join(cwd, inputBuffer));
+        }
+      } else if (key === '\x7f' || key === '\b') {
+        // Backspace
+        inputBuffer = inputBuffer.slice(0, -1);
+        process.stdout.write(`\r${CLEAR_LINE}`);
+        process.stdout.write(`${DIM}[6/6]${RESET} ${BOLD}Folder name:${RESET} ${inputBuffer}`);
+      } else if (key === '\x1b' || key === '\x03') {
+        // Escape or ctrl-c → back to browse
+        mode = 'browse';
+        render();
+      } else if (key.length === 1 && key.charCodeAt(0) >= 32) {
+        inputBuffer += key;
+        process.stdout.write(key);
+      }
+    }
+
+    function cleanup() {
+      process.stdin.setRawMode(false);
+      process.stdin.removeListener('data', onData);
+      process.stdout.write(SHOW_CURSOR);
+    }
+
+    function finish(dir) {
+      cleanup();
+      process.stdout.write(`\x1b[H\x1b[2J`);
+      console.log('');
+      console.log(`${DIM}[6/6]${RESET} ${BOLD}Location:${RESET} ${shortPath(dir)}`);
+      console.log('');
+      resolve(dir);
+    }
+
+    function onData(data) {
+      const key = data.toString();
+
+      // Handle multi-byte escape sequences
+      if (mode === 'browse') {
+        handleBrowseKey(key);
+      } else {
+        handleInputKey(key);
+      }
+    }
+
+    process.stdout.write(HIDE_CURSOR);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', onData);
+
+    render();
+  });
+}
+
+// ── Banner & Diagram ─────────────────────────────────────
 
 function banner() {
   console.log('');
@@ -72,10 +254,9 @@ function banner() {
   console.log('');
 }
 
-function cascadeDiagram(domains, metrics) {
+function cascadeDiagram(domains) {
   const domainStr = domains.slice(0, 3).join('  ');
   const dots = domains.length > 3 ? '  ...' : '';
-  const metricStr = metrics.slice(0, 3).map((m) => metricKey(m)).join(', ');
 
   console.log(`${DIM}   Your cascade:${RESET}`);
   console.log('');
@@ -91,15 +272,34 @@ function cascadeDiagram(domains, metrics) {
   console.log('');
 }
 
+// ── Domain suggestions ───────────────────────────────────
+
+function suggestDomains(desc) {
+  const d = desc.toLowerCase();
+  const s = [];
+  if (/market|customer|user|audience|segment|icp/.test(d)) s.push('market');
+  if (/valid|test|hypothes|experiment|interview/.test(d)) s.push('validation');
+  if (/strat|position|compete|pricing|business/.test(d)) s.push('strategy');
+  if (/research|learn|study|paper|domain/.test(d)) s.push('research');
+  if (/content|write|blog|newsletter|social/.test(d)) s.push('content');
+  if (/logist|ops|supply|shipping|fulfil/.test(d)) s.push('logistics');
+  if (/product|feature|build|ship|release/.test(d)) s.push('product');
+  if (/sales|outreach|pipeline|deal|close/.test(d)) s.push('sales');
+  if (/fund|invest|pitch|raise|capital/.test(d)) s.push('fundraising');
+  if (s.length === 0) s.push('market', 'validation', 'strategy', 'research');
+  return s.join(', ');
+}
+
+// ── Main ─────────────────────────────────────────────────
+
 async function main() {
   banner();
 
+  initReadline();
+
   // Question 1: Project name
   const projectName = await ask(`${DIM}[1/6]${RESET} ${BOLD}What's your project in one sentence?${RESET}\n> `);
-  if (!projectName) {
-    console.log('Project name is required.');
-    process.exit(1);
-  }
+  if (!projectName) { console.log('Project name is required.'); process.exit(1); }
   console.log('');
 
   // Question 2: Time horizon
@@ -112,22 +312,16 @@ async function main() {
   const metricsRaw = await ask(
     `${DIM}[3/6]${RESET} ${BOLD}What are the 3-5 key metrics you want to track?${RESET} ${DIM}(comma-separated, e.g., "outreach sent, calls booked, LOIs signed")${RESET}\n> `
   );
-  if (!metricsRaw) {
-    console.log('At least one metric is required.');
-    process.exit(1);
-  }
+  if (!metricsRaw) { console.log('At least one metric is required.'); process.exit(1); }
   const metrics = metricsRaw.split(',').map((m) => m.trim()).filter(Boolean);
   console.log('');
 
   // Question 4: Domains
-  const suggestedDomains = suggestDomains(projectName);
+  const suggested = suggestDomains(projectName);
   const domainsRaw = await ask(
-    `${DIM}[4/6]${RESET} ${BOLD}What domains does your work cover?${RESET} ${DIM}(comma-separated)\nSuggested based on your project: ${suggestedDomains}${RESET}\n> `
+    `${DIM}[4/6]${RESET} ${BOLD}What domains does your work cover?${RESET} ${DIM}(comma-separated)\nSuggested based on your project: ${suggested}${RESET}\n> `
   );
-  if (!domainsRaw) {
-    console.log('At least one domain is required.');
-    process.exit(1);
-  }
+  if (!domainsRaw) { console.log('At least one domain is required.'); process.exit(1); }
   const domains = domainsRaw.split(',').map((d) => d.trim().toLowerCase()).filter(Boolean);
   console.log('');
 
@@ -143,30 +337,37 @@ async function main() {
     : [];
   console.log('');
 
-  // Question 6: Where to install
-  const defaultDir = `./${slugify(projectName) || 'my-battle-plan'}`;
-  const dirAnswer = await ask(
-    `${DIM}[6/6]${RESET} ${BOLD}Where do you want to install it?${RESET} ${DIM}(default: ${defaultDir})${RESET}\n> `
-  );
-  const targetDir = path.resolve(dirAnswer || defaultDir);
-  console.log('');
+  // Question 6: Interactive folder picker
+  const projectSlug = slugify(projectName) || 'my-battle-plan';
+  const targetDir = await pickFolder(projectSlug);
+
+  // Re-init readline for any future questions
+  initReadline();
+  closeReadline();
 
-  rl.close();
+  // ── Scaffold ─────────────────────────────────────────
 
-  // --- Scaffold ---
   console.log(`${DIM}   ─────────────────────────────${RESET}`);
   console.log('');
   console.log(`${CYAN}   Scaffolding...${RESET}`);
   console.log('');
 
   if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
-    console.log(`${YELLOW}Warning: ${targetDir} already exists and is not empty.${RESET}`);
+    console.log(`${YELLOW}   Warning: ${shortPath(targetDir)} already exists and is not empty.${RESET}`);
     process.exit(1);
   }
 
   // Copy template
   const templateDir = path.join(__dirname, '..', 'template');
   copyDir(templateDir, targetDir);
+
+  // npm strips .gitignore from packages, so we ship it as 'gitignore' and rename
+  const gitignoreSrc = path.join(targetDir, 'gitignore');
+  const gitignoreDest = path.join(targetDir, '.gitignore');
+  if (fs.existsSync(gitignoreSrc) && !fs.existsSync(gitignoreDest)) {
+    fs.renameSync(gitignoreSrc, gitignoreDest);
+  }
+
   console.log(`${DIM}   + CLAUDE.md (system prompt)${RESET}`);
   console.log(`${DIM}   + tools/ (verification scripts)${RESET}`);
   console.log(`${DIM}   + .claude/commands/ (slash commands)${RESET}`);
@@ -338,16 +539,8 @@ ${peopleSections}
   fs.writeFileSync(
     path.join(targetDir, '.battle-plan-onboarding.json'),
     JSON.stringify(
-      {
-        project_name: projectName,
-        horizon,
-        metrics,
-        domains,
-        people,
-        installed_at: today,
-      },
-      null,
-      2
+      { project_name: projectName, horizon, metrics, domains, people, installed_at: today },
+      null, 2
     ) + '\n'
   );
 
@@ -365,21 +558,26 @@ ${peopleSections}
     execSync('git commit -m "Initial battle plan scaffold"', {
       cwd: targetDir,
       stdio: 'pipe',
-      env: { ...process.env, GIT_AUTHOR_NAME: 'Battle Plan', GIT_AUTHOR_EMAIL: 'noreply@battleplan.dev', GIT_COMMITTER_NAME: 'Battle Plan', GIT_COMMITTER_EMAIL: 'noreply@battleplan.dev' },
+      env: {
+        ...process.env,
+        GIT_AUTHOR_NAME: 'Battle Plan', GIT_AUTHOR_EMAIL: 'noreply@battleplan.dev',
+        GIT_COMMITTER_NAME: 'Battle Plan', GIT_COMMITTER_EMAIL: 'noreply@battleplan.dev',
+      },
     });
     console.log(`${DIM}   + git repo initialized${RESET}`);
   } catch {
     // git not available or failed — not critical
   }
 
-  // --- Done ---
+  // ── Done ───────────────────────────────────────────
+
   console.log('');
   console.log(`${DIM}   ─────────────────────────────${RESET}`);
   console.log('');
   console.log(`${GREEN}${BOLD}   Ready.${RESET}`);
   console.log('');
   console.log(`${BOLD}   Project:${RESET}  ${projectName}`);
-  console.log(`${BOLD}   Location:${RESET} ${targetDir}`);
+  console.log(`${BOLD}   Location:${RESET} ${shortPath(targetDir)}`);
   console.log(`${BOLD}   Horizon:${RESET}  ${horizon || 'not set'}`);
   console.log(`${BOLD}   Metrics:${RESET}  ${metrics.join(', ')}`);
   console.log(`${BOLD}   Domains:${RESET}  ${domains.join(', ')}`);
@@ -388,13 +586,13 @@ ${peopleSections}
   }
   console.log('');
 
-  cascadeDiagram(domains, metrics);
+  cascadeDiagram(domains);
 
   console.log(`${DIM}   ─────────────────────────────${RESET}`);
   console.log('');
   console.log(`${CYAN}${BOLD}   Next steps:${RESET}`);
   console.log('');
-  console.log(`   ${BOLD}cd ${path.relative(process.cwd(), targetDir)}${RESET}`);
+  console.log(`   ${BOLD}cd ${path.relative(process.cwd(), targetDir) || '.'}${RESET}`);
   console.log(`   ${BOLD}claude${RESET}`);
   console.log('');
   console.log(`   Then type ${GREEN}${BOLD}/good-morning${RESET} to start`);
@@ -407,28 +605,8 @@ ${peopleSections}
   console.log('');
 }
 
-function suggestDomains(projectDescription) {
-  const desc = projectDescription.toLowerCase();
-  const suggestions = [];
-
-  if (/market|customer|user|audience|segment|icp/.test(desc)) suggestions.push('market');
-  if (/valid|test|hypothes|experiment|interview/.test(desc)) suggestions.push('validation');
-  if (/strat|position|compete|pricing|business/.test(desc)) suggestions.push('strategy');
-  if (/research|learn|study|paper|domain/.test(desc)) suggestions.push('research');
-  if (/content|write|blog|newsletter|social/.test(desc)) suggestions.push('content');
-  if (/logist|ops|supply|shipping|fulfil/.test(desc)) suggestions.push('logistics');
-  if (/product|feature|build|ship|release/.test(desc)) suggestions.push('product');
-  if (/sales|outreach|pipeline|deal|close/.test(desc)) suggestions.push('sales');
-  if (/fund|invest|pitch|raise|capital/.test(desc)) suggestions.push('fundraising');
-
-  if (suggestions.length === 0) {
-    suggestions.push('market', 'validation', 'strategy', 'research');
-  }
-
-  return suggestions.join(', ');
-}
-
 main().catch((err) => {
+  process.stdout.write(SHOW_CURSOR);
   console.error(err);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-battle-plan",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Scaffold a Battle Plan project — a markdown-based context system for LLM-powered project management",
   "bin": {
     "create-battle-plan": "./bin/cli.js"

package/template/gitignore

@@ -0,0 +1,4 @@
+.cascaderc
+.battle-plan-onboarding.json
+.battle-plan-onboarding-done.json
+node_modules/