create-battle-plan 1.0.1 → 1.1.1

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,24 +337,23 @@ 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);
   }
 
@@ -346,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'
   );
 
@@ -373,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(', ')}`);
@@ -396,47 +586,27 @@ ${peopleSections}
   }
   console.log('');
 
-  cascadeDiagram(domains, metrics);
+  cascadeDiagram(domains);
 
   console.log(`${DIM}   ─────────────────────────────${RESET}`);
   console.log('');
-  console.log(`${CYAN}${BOLD}   Next steps:${RESET}`);
+  console.log(`${CYAN}${BOLD}   To start your first session,${RESET}`);
+  console.log(`${CYAN}${BOLD}   copy and paste this into your terminal:${RESET}`);
   console.log('');
-  console.log(`   ${BOLD}cd ${path.relative(process.cwd(), targetDir)}${RESET}`);
-  console.log(`   ${BOLD}claude${RESET}`);
+  const relPath = path.relative(process.cwd(), targetDir) || '.';
+  console.log(`${DIM}   ┌─────────────────────────────────────────┐${RESET}`);
+  console.log(`${DIM}   │${RESET}  ${BOLD}cd ${relPath} && claude${RESET}${DIM}${' '.repeat(Math.max(0, 37 - relPath.length - 12))}│${RESET}`);
+  console.log(`${DIM}   └─────────────────────────────────────────┘${RESET}`);
   console.log('');
-  console.log(`   Then type ${GREEN}${BOLD}/good-morning${RESET} to start`);
-  console.log(`   your first session.`);
+  console.log(`   Once Claude is running, type ${GREEN}${BOLD}/good-morning${RESET}`);
+  console.log(`   to start your first session. Claude will`);
+  console.log(`   introduce itself, explain how everything`);
+  console.log(`   works, and help you set your first targets.`);
   console.log('');
-  console.log(`${DIM}   Claude already knows your project, metrics,`);
-  console.log(`   and team. Just dump context into the chat —`);
-  console.log(`   call transcripts, research, meeting notes,`);
-  console.log(`   replies — it'll cascade into the right docs.${RESET}`);
-  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.1",
+  "version": "1.1.1",
   "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/.claude/commands/good-morning.md

@@ -4,32 +4,65 @@ description: Morning standup — status briefing, metrics snapshot, and today's
 
 # Morning Standup
 
-Run these steps in order. Be concise — the user wants a briefing, not an essay.
+Run these steps in order.
 
 ## Step 0: First-Run Welcome (one time only)
 
-Check if `.battle-plan-onboarding.json` exists. If it does, this is the user's FIRST session after running `npx create-battle-plan`. Do the following:
+Check if `.battle-plan-onboarding.json` exists in the repo root. If it does, this is the user's **FIRST session** after running `npx create-battle-plan`. This is a special moment — the user just installed this and wants to understand what they've got. Make them feel like their project is in good hands.
 
-1. Read `.battle-plan-onboarding.json` to get their project context
-2. **Welcome them by reflecting what they told the installer** — project name, horizon, metrics, domains, people. Show them you already have full context. Make them feel like they're picking up mid-conversation, not starting from scratch.
-3. **Explain what Battle Plan is and how it works**, briefly:
-   - "Battle Plan keeps your project context in markdown files that stay in sync. When you tell me something new — a call, a reply, a metric change — I update a chain of docs in a fixed order so nothing gets dropped."
-   - Mention the cascade: metrics.yml → battle plan → source docs → verification
-   - Mention: "Just dump context into the chat. Call transcripts, research, meeting notes, replies — I'll cascade it into the right docs."
-4. **Explain the commands:**
-   - `/good-morning` — start each session with a status briefing (what you're running now)
-   - `/wrap-up` — end each session cleanly: status review, cascade, metrics report, commit
-   - `/distill` — compress docs when they get too long for me to read efficiently
-5. **Explain metrics:** "Your metrics live in `metrics.yml`. Every number in every doc traces back to that file. Scripts verify they stay in sync. You never have to worry about stale numbers."
-6. **Explain what to do next:** "Set targets for your metrics in the battle plan, then start working. Tell me about any calls, research, or updates and I'll keep everything current."
-7. Rename `.battle-plan-onboarding.json` to `.battle-plan-onboarding-done.json` so this welcome doesn't repeat.
+**Read `.battle-plan-onboarding.json`** to get their project context. Then write a warm, personal welcome that covers ALL of the following. This should feel like a knowledgeable co-pilot introducing itself, not a product manual.
 
-Then proceed to the normal standup flow below (Steps 1-4).
+### Part 1: Personal welcome (reflect their project back to them)
+
+Greet them warmly. Show them you already know their project by name, their time horizon, their metrics, their domains, and their people. Reference these specifics naturally — don't just list them. The user should feel like they're continuing a conversation, not configuring a tool.
+
+Example tone: "Welcome to your battle plan for [project]. You've got [horizon] and you're tracking [metrics] — I've got all of that loaded and ready to go."
+
+### Part 2: What this is (the big picture)
+
+Explain what they now have, in plain language:
+
+- **This is your project's memory.** Every conversation, decision, metric, and insight lives here in markdown files. When you close this chat and come back tomorrow — or next week — I read these files and pick up exactly where we left off. Nothing gets lost between sessions.
+- **You don't organize anything.** When you tell me something new — a call you had, research you found, a number that changed, a reply you got — I update the right files in the right order automatically. That's called the cascade.
+- **The cascade works like this:** new info flows into `metrics.yml` first (if a number changed), then into your battle plan (the operating doc that tracks where you are), then into the source docs for each domain. At the end, a verification script checks that everything is consistent.
+- **Think of it as dumping context.** You can paste a full call transcript, a messy list of notes, a forwarded email, a research summary — anything. You don't need to format it or tell me where it goes. Just dump it in and I'll cascade it to the right places.
+
+### Part 3: How to use it day to day
+
+Explain the rhythm:
+
+- **Start each session** with `/good-morning` (what you just ran). I'll brief you on where you stand — metrics, priorities, what's stuck, what's next. Think of it as a daily standup with your AI co-pilot.
+- **During the day**, just talk to me. Tell me what happened, paste in notes, ask me to update things. Every piece of new info triggers the cascade automatically.
+- **End each session** with `/wrap-up`. I'll review the day, show you what changed, sync everything, and offer to commit. This is how you close out clean without forgetting to log something.
+- **When docs get long**, run `/distill`. Over time, your daily logs and conversation journals will grow. `/distill` compresses older content into a thorough summary and archives the raw text — nothing is ever deleted, but I can read the docs faster.
+
+### Part 4: How metrics work
+
+- Your key metrics live in `metrics.yml` — it's the single numeric source of truth for the whole project.
+- Every number that appears in any doc traces back to that file via source annotations. When a metric changes, the cascade propagates the new value everywhere it's referenced.
+- Shell scripts verify the numbers stay in sync. You'll never have a stale "42" in one doc when the real number is "47" in another.
+- Right now all your metrics are at zero. One of the first things we'll do is set targets.
+
+### Part 5: What to do right now
+
+Transition into action:
+
+- "Let's start by getting some real data into the system. Here's what I'd suggest..."
+- Prompt them to set targets for their metrics
+- Ask if there's any existing context they already have — calls they've had, research they've done, decisions they've already made. Anything they can tell you now will make the battle plan immediately useful.
+
+### After the welcome
+
+Rename `.battle-plan-onboarding.json` to `.battle-plan-onboarding-done.json` so this welcome doesn't repeat.
+
+Then show a **compact metrics table** (all zeros, no targets yet) and transition into the onboarding questions naturally. Don't run the full standup format (Steps 1-4 below) on the first run — there's nothing to report yet. Instead, go straight to helping them populate the battle plan.
 
 ---
 
 ## Step 1: Gather State (parallel reads)
 
+*Skip this on first run (Step 0 handles it). On all subsequent runs, start here.*
+
 Read all of these in parallel:
 - `metrics.yml` — current numbers
 - `docs/battle-plan.md` — TL;DR + latest day log (find today or the most recent day entry)
@@ -71,4 +104,6 @@ After the user answers:
 
 ## Tone
 
-Direct, no fluff. Think military briefing, not newsletter.
+On first run: warm, confident, thorough. The user should feel like they just hired a great project manager who already read the brief.
+
+On subsequent runs: direct, no fluff. Think military briefing, not newsletter.