create-battle-plan 1.4.2 → 1.4.4

package/bin/cli.js

@@ -71,6 +71,14 @@ function ask(question) {
   });
 }
 
+async function askRequired(question, errorMsg) {
+  while (true) {
+    const answer = await ask(question);
+    if (answer) return answer;
+    console.log(`${YELLOW}   ${errorMsg}${RESET}`);
+  }
+}
+
 // ── Interactive folder picker (raw mode) ─────────────────
 
 function getDirs(dir) {
@@ -310,8 +318,10 @@ async function main() {
   initReadline();
 
   // Question 1: Project description (one sentence — used for context, not the folder name)
-  const projectName = await ask(`${DIM}[1/7]${RESET} ${BOLD}What's your project in one sentence?${RESET}\n> `);
-  if (!projectName) { console.log('Project name is required.'); process.exit(1); }
+  const projectName = await askRequired(
+    `${DIM}[1/7]${RESET} ${BOLD}What's your project in one sentence?${RESET}\n> `,
+    'A one-sentence description is required — even rough is fine. Try again:'
+  );
   console.log('');
 
   // Question 2: Short name (the actual folder slug). Default = cwd basename when sensible.
@@ -338,20 +348,21 @@ async function main() {
   );
   console.log('');
 
-  // Question 4: Metrics
+  // Question 4: Metrics (optional — leave blank for journal-style projects)
   const metricsRaw = await ask(
-    `${DIM}[4/7]${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> `
+    `${DIM}[4/7]${RESET} ${BOLD}Any metrics to track?${RESET} ${DIM}(comma-separated, e.g., "outreach sent, calls booked, LOIs signed" — or press enter to skip)${RESET}\n> `
   );
-  if (!metricsRaw) { console.log('At least one metric is required.'); process.exit(1); }
-  const metrics = metricsRaw.split(',').map((m) => m.trim()).filter(Boolean);
+  const metrics = metricsRaw
+    ? metricsRaw.split(',').map((m) => m.trim()).filter(Boolean)
+    : [];
   console.log('');
 
   // Question 5: Domains
   const suggested = suggestDomains(projectName);
-  const domainsRaw = await ask(
-    `${DIM}[5/7]${RESET} ${BOLD}What domains does your work cover?${RESET} ${DIM}(comma-separated)\nSuggested based on your project: ${suggested}${RESET}\n> `
+  const domainsRaw = await askRequired(
+    `${DIM}[5/7]${RESET} ${BOLD}What domains does your work cover?${RESET} ${DIM}(comma-separated)\nSuggested based on your project: ${suggested}${RESET}\n> `,
+    `At least one domain is required — try the suggestions (${suggested}) or any topic area. Try again:`
   );
-  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('');
 
@@ -444,7 +455,11 @@ _Start adding content here._
 
   console.log(`${DIM}   + docs/ (${domains.length} domain${domains.length > 1 ? 's' : ''})${RESET}`);
 
-  // Create metrics.yml
+  // Create metrics.yml — file always exists so scripts have a target, even if no
+  // metrics were declared (journal-style projects). The LLM can add metrics later.
+  const metricsBody = metrics.length
+    ? metrics.map((m) => `${metricKey(m)}: 0`).join('\n') + '\n'
+    : '# No metrics declared yet. Add them as `key: value` below when ready.\n';
   const metricsContent = [
     `# metrics.yml — project-wide metrics registry for ${projectName}`,
     '# The LLM updates this file FIRST in any cascade, before touching docs.',
@@ -452,16 +467,33 @@ _Start adding content here._
     '',
     `last_updated: ${today}`,
     '',
-    ...metrics.map((m) => `${metricKey(m)}: 0`),
-    '',
+    metricsBody,
   ].join('\n');
   fs.writeFileSync(path.join(targetDir, 'metrics.yml'), metricsContent);
-  console.log(`${DIM}   + metrics.yml (${metrics.length} metric${metrics.length > 1 ? 's' : ''})${RESET}`);
+  console.log(
+    `${DIM}   + metrics.yml (${metrics.length === 0 ? 'no metrics yet' : `${metrics.length} metric${metrics.length > 1 ? 's' : ''}`})${RESET}`
+  );
+
+  // Create battle plan — conditionally include Key Metrics section
+  const metricsSection = metrics.length
+    ? `## Key Metrics
+
+| Metric | Target | Current |
+|--------|--------|---------|
+${metrics.map((m) => `| ${m} | _set target_ | **0** (→ metrics.yml#${metricKey(m)}) |`).join('\n')}
 
-  // Create battle plan
-  const metricsTable = metrics
-    .map((m) => `| ${m} | _set target_ | **0** (→ metrics.yml#${metricKey(m)}) |`)
-    .join('\n');
+---
+
+`
+    : '';
+
+  const tldr = metrics.length
+    ? `${projectName} — just initialized. Time horizon: ${horizon || 'not set'}. All metrics at 0. First priority: fill in the battle plan with real tasks and targets.`
+    : `${projectName} — just initialized. Time horizon: ${horizon || 'not set'}. No metrics tracked yet (journal-style project). First priority: fill in the battle plan with real tasks.`;
+
+  const firstPriority = metrics.length
+    ? '- [ ] Set targets for each metric\n- [ ] Fill in this week\'s tasks\n- [ ] Record any existing conversations in external-insights.md'
+    : '- [ ] Fill in this week\'s tasks\n- [ ] Record any existing conversations in external-insights.md';
 
   fs.writeFileSync(
     path.join(targetDir, 'docs', 'battle-plan.md'),
@@ -472,7 +504,7 @@ _Start adding content here._
 **Role:** source-of-truth
 **Compression:** chronological
 
-**TL;DR:** ${projectName} — just initialized. Time horizon: ${horizon || 'not set'}. All metrics at 0. First priority: fill in the battle plan with real tasks and targets.
+**TL;DR:** ${tldr}
 
 ---
 
@@ -485,19 +517,9 @@ _Start adding content here._
 
 ---
 
-## Key Metrics
-
-| Metric | Target | Current |
-|--------|--------|---------|
-${metricsTable}
-
----
-
-## Today's Priorities
+${metricsSection}## Today's Priorities
 
-- [ ] Set targets for each metric
-- [ ] Fill in this week's tasks
-- [ ] Record any existing conversations in external-insights.md
+${firstPriority}
 
 ---
 

package/package.json

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