specstocode 0.5.0

package/dist/index.js

@@ -0,0 +1,1763 @@
+#!/usr/bin/env node
+import {
+  setup
+} from "./chunk-55DTUCLY.js";
+import {
+  scope
+} from "./chunk-P4M7CVDK.js";
+import {
+  API_BASE,
+  getAuth,
+  requireAuth,
+  saveAuth
+} from "./chunk-CYA6I7NV.js";
+import {
+  storyContextPath,
+  writeStoryContext
+} from "./chunk-J22FYEMI.js";
+import {
+  createStories,
+  getContext,
+  listStories,
+  updateStories
+} from "./chunk-QKMZ2SBR.js";
+import {
+  ask,
+  closePrompt,
+  confirm,
+  pausePrompt
+} from "./chunk-WPVDURTJ.js";
+import {
+  hasConfig,
+  readConfig,
+  requireConfig,
+  writeConfig
+} from "./chunk-NAOZWXOF.js";
+
+// src/index.ts
+import { Command } from "commander";
+import { createRequire } from "module";
+
+// src/commands/init.ts
+import { writeFileSync, existsSync, readFileSync, appendFileSync } from "fs";
+import { join } from "path";
+import { createInterface } from "readline";
+
+// src/commands/login.ts
+import { exec } from "child_process";
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "${url}"` : `xdg-open "${url}"`;
+  exec(cmd);
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+async function login() {
+  const existing = getAuth();
+  if (existing) {
+    console.log("Already logged in. Run `npx specstocode logout` to switch accounts.");
+    return;
+  }
+  console.log("Logging in to specstocode...\n");
+  const res = await fetch(`${API_BASE}/api/cli/auth`, { method: "POST" });
+  if (!res.ok) {
+    console.error("Failed to start login flow. Try again.");
+    process.exit(1);
+  }
+  const { code } = await res.json();
+  const authUrl = `${API_BASE}/cli/auth?code=${code}`;
+  console.log("Opening browser to authorize...");
+  console.log(`If it doesn't open, visit: ${authUrl}
+`);
+  openBrowser(authUrl);
+  const maxAttempts = 60;
+  for (let i = 0; i < maxAttempts; i++) {
+    await sleep(3e3);
+    try {
+      const checkRes = await fetch(`${API_BASE}/api/cli/auth?code=${code}`);
+      if (!checkRes.ok) continue;
+      const data = await checkRes.json();
+      if (data.status === "approved" && data.token) {
+        saveAuth({ token: data.token, apiBase: API_BASE });
+        console.log("\u2705 Logged in to specstocode!\n");
+        console.log("You can now run: npx specstocode init");
+        return;
+      }
+      if (data.status === "expired") {
+        console.error("Login request expired. Run `npx specstocode login` to try again.");
+        process.exit(1);
+      }
+      process.stdout.write(".");
+    } catch {
+      process.stdout.write(".");
+    }
+  }
+  console.error("\nLogin timed out. Run `npx specstocode login` to try again.");
+  process.exit(1);
+}
+async function logout() {
+  const { existsSync: existsSync5, unlinkSync } = await import("fs");
+  const { join: join4 } = await import("path");
+  const { homedir } = await import("os");
+  const authFile = join4(homedir(), ".specstocode", "auth.json");
+  if (existsSync5(authFile)) {
+    unlinkSync(authFile);
+    console.log("Logged out.");
+  } else {
+    console.log("Not logged in.");
+  }
+}
+
+// src/commands/init.ts
+function ask2(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+async function pickFromList(rl, items, label, prompt) {
+  items.forEach((item, i) => {
+    console.log(`  ${i + 1}. ${label(item)}`);
+  });
+  while (true) {
+    const raw = await ask2(rl, `
+${prompt} [1-${items.length}]: `);
+    const n = parseInt(raw.trim(), 10);
+    if (n >= 1 && n <= items.length) return items[n - 1];
+    console.log(`  Please enter a number between 1 and ${items.length}.`);
+  }
+}
+function authHeaders(token) {
+  return { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
+}
+async function init(tokenArg) {
+  if (hasConfig()) {
+    console.log("Already initialized. Run `specstocode sync` to refresh.");
+    return;
+  }
+  if (tokenArg) {
+    await initWithSyncToken(tokenArg);
+    return;
+  }
+  let auth = getAuth();
+  if (!auth) {
+    console.log("You need to log in first.\n");
+    await login();
+    auth = getAuth();
+    if (!auth) {
+      console.error("Login failed.");
+      process.exit(1);
+    }
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log("\nFetching your projects...");
+    const projectsRes = await fetch(`${auth.apiBase}/api/cli/projects`, {
+      headers: authHeaders(auth.token)
+    });
+    if (!projectsRes.ok) {
+      console.error("Failed to fetch projects. Try `specstocode login` first.");
+      process.exit(1);
+    }
+    const { projects } = await projectsRes.json();
+    if (projects.length === 0) {
+      console.log("\nNo projects found. Create one at specstocode.com first.");
+      process.exit(0);
+    }
+    console.log("\nYour projects:\n");
+    const project = await pickFromList(rl, projects, (p) => p.name, "Select project");
+    console.log("\nFetching story maps...");
+    const mapsRes = await fetch(
+      `${auth.apiBase}/api/cli/projects/${project.id}/maps`,
+      { headers: authHeaders(auth.token) }
+    );
+    if (!mapsRes.ok) {
+      console.error("Failed to fetch story maps.");
+      process.exit(1);
+    }
+    const { maps } = await mapsRes.json();
+    if (maps.length === 0) {
+      console.log("\nNo story maps in this project. Create one at specstocode.com first.");
+      process.exit(0);
+    }
+    console.log(`
+Story maps in "${project.name}":
+`);
+    const map = await pickFromList(rl, maps, (m) => m.title, "Select story map");
+    const config = {
+      syncToken: map.syncToken,
+      apiBase: auth.apiBase,
+      mapTitle: map.title,
+      projectId: project.id,
+      mapId: map.id
+    };
+    console.log(`
+Connecting to "${map.title}"...`);
+    try {
+      const data = await listStories(config);
+      console.log(`\u2713 Connected to "${data.map.title}"`);
+      console.log(
+        `  ${data.summary.total} stories \u2014 ${data.summary.done} done, ${data.summary.todo} todo
+`
+      );
+    } catch {
+      console.error("Failed to validate connection. Please try again.");
+      process.exit(1);
+    }
+    writeConfig(config);
+    await setupFiles(config);
+    console.log("\n\u2705 Ready! Try: npx specstocode status");
+  } finally {
+    rl.close();
+  }
+}
+async function initWithSyncToken(syncToken) {
+  if (!syncToken.startsWith("pb_sync_") && !syncToken.startsWith("sc_sync_")) {
+    console.error("Invalid token. It should start with pb_sync_");
+    process.exit(1);
+  }
+  console.log("\nConnecting to specstocode...");
+  const config = { syncToken, apiBase: API_BASE };
+  try {
+    const data = await listStories(config);
+    console.log(`\u2713 Connected to "${data.map.title}"`);
+    console.log(
+      `  ${data.summary.total} stories \u2014 ${data.summary.done} done, ${data.summary.todo} todo
+`
+    );
+    writeConfig({ ...config, mapTitle: data.map.title });
+  } catch {
+    console.error("Failed to connect. Check your sync token.");
+    process.exit(1);
+  }
+  await setupFiles(config);
+  console.log("\n\u2705 Ready! Try: npx specstocode status");
+}
+async function setupFiles(config) {
+  try {
+    const md = await getContext(config);
+    writeFileSync(join(process.cwd(), "SPECSTOCODE.md"), md);
+    console.log("\u2713 Downloaded SPECSTOCODE.md");
+  } catch {
+    console.warn("\u26A0 Could not download SPECSTOCODE.md");
+  }
+  const gitignore = join(process.cwd(), ".gitignore");
+  if (existsSync(gitignore)) {
+    const content = readFileSync(gitignore, "utf-8");
+    if (!content.includes(".specstocode/")) {
+      appendFileSync(gitignore, "\n# specstocode\n.specstocode/\n");
+      console.log("\u2713 Added .specstocode/ to .gitignore");
+    }
+  }
+  const cwd = process.cwd();
+  if (existsSync(join(cwd, "CLAUDE.md"))) {
+    const claudeMd = readFileSync(join(cwd, "CLAUDE.md"), "utf-8");
+    if (!claudeMd.includes("SPECSTOCODE.md")) {
+      appendFileSync(
+        join(cwd, "CLAUDE.md"),
+        "\n\n# specstocode\nRead SPECSTOCODE.md for the product story map, personas, and backlog.\n"
+      );
+      console.log("\u2713 Added SPECSTOCODE.md reference to CLAUDE.md");
+    }
+  }
+  if (existsSync(join(cwd, ".cursorrules"))) {
+    const rules = readFileSync(join(cwd, ".cursorrules"), "utf-8");
+    if (!rules.includes("SPECSTOCODE.md")) {
+      appendFileSync(
+        join(cwd, ".cursorrules"),
+        "\n\nRead SPECSTOCODE.md for the product story map, personas, and backlog.\n"
+      );
+      console.log("\u2713 Added SPECSTOCODE.md reference to .cursorrules");
+    }
+  }
+}
+
+// src/commands/sync.ts
+import { writeFileSync as writeFileSync2, readdirSync, existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+async function sync() {
+  const config = requireConfig();
+  console.log("Syncing with specstocode...");
+  const [md, data] = await Promise.all([
+    getContext(config),
+    listStories(config)
+  ]);
+  writeFileSync2(join2(process.cwd(), "SPECSTOCODE.md"), md);
+  const { summary } = data;
+  const pct = summary.total > 0 ? Math.round(summary.done / summary.total * 100) : 0;
+  console.log(`\u2713 SPECSTOCODE.md updated  (${summary.done}/${summary.total} done, ${pct}%)`);
+  const contextDir = join2(process.cwd(), ".specstocode", "stories");
+  if (!existsSync2(contextDir)) return;
+  const localFiles = readdirSync(contextDir).filter((f) => f.endsWith(".md"));
+  if (localFiles.length === 0) return;
+  const storyMap = new Map(data.stories.map((s) => [s.id, s]));
+  let refreshed = 0;
+  let stale = 0;
+  for (const filename of localFiles) {
+    const storyId = filename.replace(".md", "");
+    const story = storyMap.get(storyId);
+    if (!story) {
+      stale++;
+      continue;
+    }
+    writeStoryContext(story);
+    refreshed++;
+  }
+  if (refreshed > 0 || stale > 0) {
+    console.log(`\u2713 .specstocode/stories/ refreshed (${refreshed} updated${stale > 0 ? `, ${stale} orphaned` : ""})`);
+    if (stale > 0) {
+      console.log(`  \u26A0  ${stale} context file(s) have no matching story \u2014 they may have been deleted in the UI.`);
+    }
+  }
+}
+
+// src/commands/status.ts
+async function status() {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const { summary } = data;
+  const pct = summary.total > 0 ? Math.round(summary.done / summary.total * 100) : 0;
+  const barLen = 20;
+  const filled = Math.round(pct / 100 * barLen);
+  const bar = "\u2588".repeat(filled) + "\u2591".repeat(barLen - filled);
+  console.log(`
+  ${data.map.title}`);
+  console.log(`  ${bar} ${pct}%
+`);
+  console.log(`  \u2705 Done:        ${summary.done}`);
+  console.log(`  \u{1F528} In progress: ${summary.in_progress}`);
+  console.log(`  \u2B1C Todo:        ${summary.todo}`);
+  console.log(`  \u2500\u2500 Total:       ${summary.total}
+`);
+  const byActivity = /* @__PURE__ */ new Map();
+  for (const s of data.stories) {
+    const cur = byActivity.get(s.activity) ?? { done: 0, total: 0 };
+    cur.total++;
+    if (s.status === "done") cur.done++;
+    byActivity.set(s.activity, cur);
+  }
+  for (const [activity, counts] of byActivity) {
+    const actPct = counts.total > 0 ? Math.round(counts.done / counts.total * 100) : 0;
+    console.log(`  ${activity}: ${counts.done}/${counts.total} (${actPct}%)`);
+  }
+  console.log();
+}
+
+// src/commands/stories.ts
+var STATUS_ICON = {
+  done: "\u2705",
+  in_progress: "\u{1F528}",
+  todo: "\u2B1C"
+};
+var STATUS_ALIASES = {
+  todo: "todo",
+  "in-progress": "in_progress",
+  in_progress: "in_progress",
+  wip: "in_progress",
+  done: "done"
+};
+async function stories(opts) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  let filtered = data.stories;
+  if (opts.status) {
+    const s = STATUS_ALIASES[opts.status.toLowerCase()];
+    if (!s) {
+      console.error(`Unknown status "${opts.status}". Use: todo, in-progress, done`);
+      process.exit(1);
+    }
+    filtered = filtered.filter((story) => story.status === s);
+  } else if (opts.filter) {
+    const f = opts.filter.toLowerCase();
+    const mappedStatus = STATUS_ALIASES[f];
+    if (mappedStatus) {
+      filtered = filtered.filter((s) => s.status === mappedStatus);
+    } else {
+      filtered = filtered.filter(
+        (s) => s.activity.toLowerCase().includes(f) || s.title.toLowerCase().includes(f)
+      );
+    }
+  }
+  if (filtered.length === 0) {
+    console.log("No stories found.");
+    return;
+  }
+  if (opts.kanban) {
+    kanbanView(filtered);
+  } else {
+    listView(filtered);
+  }
+}
+function listView(stories2) {
+  const byActivity = /* @__PURE__ */ new Map();
+  for (const s of stories2) {
+    const list = byActivity.get(s.activity) ?? [];
+    list.push(s);
+    byActivity.set(s.activity, list);
+  }
+  for (const [activity, actStories] of byActivity) {
+    const done2 = actStories.filter((s) => s.status === "done").length;
+    console.log(`
+  ${activity} (${done2}/${actStories.length})`);
+    for (const s of actStories) {
+      const icon = STATUS_ICON[s.status] ?? "\u2B1C";
+      const id = s.id.slice(0, 8);
+      console.log(`    ${icon} ${s.title.slice(0, 70)} (${id})`);
+    }
+  }
+  console.log();
+}
+function kanbanView(stories2) {
+  const termWidth = process.stdout.columns || 100;
+  const colW = Math.max(22, Math.floor((termWidth - 4) / 3));
+  const innerW = colW - 2;
+  const cols = [
+    { label: "TODO", stories: stories2.filter((s) => s.status === "todo") },
+    { label: "IN PROGRESS", stories: stories2.filter((s) => s.status === "in_progress") },
+    { label: "DONE", stories: stories2.filter((s) => s.status === "done") }
+  ];
+  const rule = (l, mid, r) => l + Array(3).fill("\u2500".repeat(colW)).join(mid) + r;
+  const cell = (text) => " " + text.slice(0, innerW).padEnd(innerW) + " ";
+  const emptyCell = () => " ".repeat(colW);
+  const row = (cells) => "\u2502" + cells.join("\u2502") + "\u2502";
+  console.log("\n" + rule("\u250C", "\u252C", "\u2510"));
+  console.log(
+    row(
+      cols.map((c) => cell(`${c.label} (${c.stories.length})`))
+    )
+  );
+  console.log(rule("\u251C", "\u253C", "\u2524"));
+  const maxRows = Math.max(...cols.map((c) => c.stories.length), 0);
+  for (let i = 0; i < maxRows; i++) {
+    console.log(
+      row(
+        cols.map((c) => {
+          const s = c.stories[i];
+          return s ? cell(s.title) : emptyCell();
+        })
+      )
+    );
+    console.log(
+      row(
+        cols.map((c) => {
+          const s = c.stories[i];
+          return s ? cell(`${s.activity} \xB7 ${s.priority}`) : emptyCell();
+        })
+      )
+    );
+    console.log(
+      row(
+        cols.map((c) => {
+          const s = c.stories[i];
+          return s ? cell(s.id.slice(0, 8)) : emptyCell();
+        })
+      )
+    );
+    if (i < maxRows - 1) {
+      console.log(row(cols.map(() => emptyCell())));
+    }
+  }
+  console.log(rule("\u2514", "\u2534", "\u2518") + "\n");
+}
+
+// src/commands/next.ts
+import { execSync } from "child_process";
+var PRIORITY_ORDER = { must: 0, should: 1, could: 2 };
+var EFFORT_ORDER = { S: 0, M: 1, L: 2, XL: 3 };
+async function next(opts = {}) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  if (!opts.skipWip) {
+    const inProgress = data.stories.filter((s2) => s2.status === "in_progress");
+    if (inProgress.length > 0) {
+      console.log(`
+  \u26A0\uFE0F  You have ${inProgress.length} story${inProgress.length > 1 ? " stories" : ""} in progress:
+`);
+      for (const s2 of inProgress) {
+        console.log(`    \u{1F528} ${s2.title}`);
+        console.log(`       ID: ${s2.id.slice(0, 8)} | Mark done: npx specstocode done ${s2.id.slice(0, 8)}`);
+      }
+      console.log(`
+  Finish those first, or run \`specstocode next --skip-wip\` to pick the next todo anyway.
+`);
+      return;
+    }
+  }
+  const todos = data.stories.filter((s2) => s2.status === "todo").sort((a, b) => {
+    if (a.release !== b.release) return a.release - b.release;
+    const pa = PRIORITY_ORDER[a.priority] ?? 9;
+    const pb = PRIORITY_ORDER[b.priority] ?? 9;
+    if (pa !== pb) return pa - pb;
+    return (EFFORT_ORDER[a.effort] ?? 9) - (EFFORT_ORDER[b.effort] ?? 9);
+  });
+  if (todos.length === 0) {
+    console.log("\n  \u{1F389} All stories are done! Ship it.\n");
+    return;
+  }
+  const s = todos[0];
+  try {
+    await updateStories(config, [{ id: s.id, status: "in_progress" }]);
+  } catch {
+  }
+  const contextPath = writeStoryContext(s);
+  const relPath = contextPath.replace(process.cwd() + "/", "");
+  const specUrl = `${config.apiBase}/storymapper/${data.map.id}?story=${s.id}`;
+  console.log(`
+  \u{1F528} Picked up:`);
+  console.log(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+  console.log(`  ${s.title}`);
+  console.log(`  Activity: ${s.activity}`);
+  console.log(`  Priority: ${s.priority} | Effort: ${s.effort} | Release: ${s.release}`);
+  if (s.acceptance_criteria.length > 0) {
+    console.log(`  Done when:`);
+    for (const ac of s.acceptance_criteria) {
+      console.log(`    - ${ac.text}`);
+    }
+  }
+  console.log(`
+  ID: ${s.id}`);
+  console.log(`  Context: ${relPath}`);
+  console.log(`  Spec:    ${specUrl}`);
+  console.log(`  Mark done: npx specstocode done ${s.id.slice(0, 8)}
+`);
+  if (opts.open) {
+    openBrowser2(specUrl);
+  }
+}
+function openBrowser2(url) {
+  try {
+    const platform = process.platform;
+    const cmd = platform === "darwin" ? `open "${url}"` : platform === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`;
+    execSync(cmd, { stdio: "ignore" });
+  } catch {
+  }
+}
+
+// src/commands/done.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+function extractImplementationContext(storyId) {
+  const path = storyContextPath(storyId);
+  if (!existsSync3(path)) return { summary: null, files: [] };
+  const content = readFileSync2(path, "utf-8");
+  const lines = content.split("\n");
+  const notesStart = lines.findIndex((l) => l.trim() === "## Implementation notes");
+  const decisionsStart = lines.findIndex((l) => l.trim() === "## Decisions");
+  const filesStart = lines.findIndex((l) => l.trim() === "## Relevant files");
+  let summaryLines = [];
+  if (notesStart !== -1) {
+    const end = decisionsStart !== -1 && decisionsStart > notesStart ? decisionsStart : filesStart !== -1 && filesStart > notesStart ? filesStart : lines.length;
+    summaryLines = lines.slice(notesStart + 1, end).filter((l) => l.trim() && !l.trim().startsWith("_Notes added via"));
+  }
+  let files = [];
+  if (filesStart !== -1) {
+    const end = lines.findIndex((l, i) => i > filesStart && l.startsWith("## "));
+    const fileLines = lines.slice(filesStart + 1, end === -1 ? void 0 : end);
+    files = fileLines.map((l) => l.replace(/^[-*]\s*/, "").trim()).filter((l) => l && !l.startsWith("_") && (l.includes("/") || l.includes(".")));
+  }
+  const summary = summaryLines.length > 0 ? summaryLines.join("\n").trim() : null;
+  return { summary, files };
+}
+async function done(idPrefix) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const match = data.stories.find((s) => s.id.startsWith(idPrefix));
+  if (!match) {
+    console.error(`No story found matching "${idPrefix}"`);
+    process.exit(1);
+  }
+  if (match.status === "done") {
+    console.log(`Already done: ${match.title}`);
+    return;
+  }
+  const { summary, files } = extractImplementationContext(match.id);
+  const update = { id: match.id, status: "done" };
+  if (summary) update.implementation_summary = summary;
+  if (files.length > 0) update.implemented_files = files;
+  await updateStories(config, [update]);
+  console.log(`\u2705 Done: ${match.title}`);
+  if (summary) console.log(`   \u21B3 Implementation summary posted to story map`);
+  if (files.length > 0) console.log(`   \u21B3 ${files.length} file(s) recorded`);
+}
+
+// src/commands/add.ts
+async function add(title, opts) {
+  const config = requireConfig();
+  const result = await createStories(config, [
+    {
+      title,
+      activity: opts.activity,
+      priority: opts.priority ?? "should",
+      effort: opts.effort ?? "M"
+    }
+  ]);
+  if (result.created > 0) {
+    const s = result.stories[0];
+    console.log(`\u2713 Created: ${s.title}`);
+    console.log(`  Activity: ${s.activity} | ID: ${s.id.slice(0, 8)}`);
+  } else {
+    console.error("Failed to create story.");
+  }
+}
+
+// src/lib/banner.ts
+import chalk from "chalk";
+var VERSION = "0.2.2";
+var brand = chalk.hex("#6366F1");
+var muted = chalk.dim;
+var white = chalk.white.bold;
+var PB_LOGO = `
+   ${brand("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+   ${brand("\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557")}   ${white("specstocode")}
+   ${brand("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D")}   ${muted("Specs \u2192 Code. Fast.")}
+   ${brand("\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557")}
+   ${brand("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551")}   ${muted(`v${VERSION}`)}
+   ${brand("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D")}
+`;
+function printBanner(subtitle) {
+  console.log(PB_LOGO);
+  if (subtitle) {
+    console.log(`   ${white(subtitle)}`);
+    console.log(`   ${muted("\u2500".repeat(subtitle.length))}
+`);
+  }
+}
+
+// src/commands/start.ts
+import ora from "ora";
+async function apiFetch(path, token, opts = {}) {
+  return fetch(`${API_BASE}${path}`, {
+    ...opts,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`,
+      ...opts.headers ?? {}
+    }
+  });
+}
+async function streamResponse(path, token, body, options) {
+  const res = await apiFetch(path, token, {
+    method: "POST",
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const err = await res.text();
+    throw new Error(`API error ${res.status}: ${err}`);
+  }
+  let full = "";
+  const reader = res.body?.getReader();
+  const decoder = new TextDecoder();
+  if (reader) {
+    while (true) {
+      const { done: done2, value } = await reader.read();
+      if (done2) break;
+      const chunk = decoder.decode(value, { stream: true });
+      if (!options?.silent) {
+        process.stdout.write(chunk);
+      }
+      full += chunk;
+    }
+  }
+  if (!options?.silent) {
+    console.log();
+  }
+  return full;
+}
+async function start() {
+  const auth = requireAuth();
+  const { token } = auth;
+  printBanner("Start a new project");
+  console.log("  Let's start with the problem you want to solve.\n");
+  const problem = await ask("  What problem are you trying to solve?\n  > ");
+  if (!problem || problem.length < 10) {
+    console.log("\n  Please describe the problem in more detail (at least 10 characters).");
+    closePrompt();
+    return;
+  }
+  pausePrompt();
+  const spinner = ora("  Thinking about your idea...").start();
+  let discoveryText;
+  try {
+    discoveryText = await streamResponse("/api/blueprint/discovery", token, {
+      idea: problem
+    }, { silent: true });
+  } catch (err) {
+    spinner.fail("  Failed to connect");
+    console.error(`  ${err.message}`);
+    console.error("  Make sure you're logged in: npx specstocode login");
+    closePrompt();
+    return;
+  }
+  spinner.succeed("  Got it \u2014 a few questions to sharpen the idea:\n");
+  const questions = discoveryText.split(/\d+\.\s+/).filter((q) => q.trim().length > 10).map((q) => q.trim().replace(/\n/g, " "));
+  const qa = [];
+  for (const q of questions.slice(0, 3)) {
+    console.log();
+    const answer = await ask(`  ${q}
+  > `);
+    if (answer) {
+      qa.push({ question: q, answer });
+    }
+  }
+  pausePrompt();
+  const pitchSpinner = ora("  Synthesising your pitch...").start();
+  const pitchRes = await apiFetch("/api/blueprint/synthesize-pitch", token, {
+    method: "POST",
+    body: JSON.stringify({ problem, qa })
+  });
+  if (!pitchRes.ok) {
+    pitchSpinner.fail("  Failed to synthesise pitch. Try again.");
+    closePrompt();
+    return;
+  }
+  const { pitch, target_user, names } = await pitchRes.json();
+  pitchSpinner.succeed("  Pitch ready!\n");
+  console.log(`  ${pitch}
+`);
+  console.log(`  Target user: ${target_user}
+`);
+  console.log("  Suggested names:");
+  for (let i = 0; i < names.length; i++) {
+    console.log(`    ${i + 1}. ${names[i]}`);
+  }
+  console.log(`    ${names.length + 1}. Type my own name`);
+  const nameChoice = await ask(`
+  Pick a name (1-${names.length + 1}): `);
+  const nameIdx = parseInt(nameChoice, 10) - 1;
+  let productName;
+  if (nameIdx >= 0 && nameIdx < names.length) {
+    productName = names[nameIdx];
+  } else {
+    productName = await ask("  Enter your product name: ");
+  }
+  if (!productName.trim()) {
+    productName = names[0] ?? "My Product";
+  }
+  console.log(`
+  Great \u2014 "${productName}" it is.
+`);
+  console.log("  Creating project...");
+  const createRes = await apiFetch("/api/blueprint/create", token, {
+    method: "POST",
+    body: JSON.stringify({
+      messages: [{ role: "user", content: problem }],
+      titleOverride: productName,
+      pitchOverride: pitch
+    })
+  });
+  if (!createRes.ok) {
+    const contentType = createRes.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+      const data = await createRes.json();
+      if (data.error === "PROJECT_LIMIT_REACHED") {
+        console.error("\n  Project limit reached. Upgrade to Pro at specstocode.com/pricing");
+      } else {
+        console.error(`
+  Failed to create project: ${data.error ?? "unknown error"}`);
+      }
+    } else {
+      console.error("\n  Failed to create project. Try logging in again: npx specstocode login");
+    }
+    closePrompt();
+    return;
+  }
+  const createContentType = createRes.headers.get("content-type") ?? "";
+  if (!createContentType.includes("application/json")) {
+    console.error("\n  Unexpected response from server. Try logging in again: npx specstocode login");
+    closePrompt();
+    return;
+  }
+  const { projectId } = await createRes.json();
+  console.log(`  \u2713 Project created (${projectId.slice(0, 8)})
+`);
+  const validated = await confirm(
+    `  Have you validated there is demand for ${productName}?`
+  );
+  if (validated) {
+    const howValidated = await ask("  How did you validate demand?\n  > ");
+    console.log(`
+  Noted${howValidated ? ": " + howValidated : "."}
+`);
+  } else {
+    const wantPublish = await confirm(
+      "  Want to publish on specstocode to get feedback and intent signals?"
+    );
+    if (wantPublish) {
+      console.log(`
+  Publishing "${productName}"...
+`);
+      console.log("  \u2500\u2500 Summary \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+      console.log(`  Name:    ${productName}`);
+      console.log(`  Pitch:   ${pitch}`);
+      console.log(`  Target:  ${target_user}`);
+      console.log(`  Problem: ${problem.slice(0, 100)}${problem.length > 100 ? "..." : ""}`);
+      console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+      const confirmPublish = await confirm("  Publish this to Explore?");
+      if (confirmPublish) {
+        const pubRes = await apiFetch(
+          `/api/projects/${projectId}/publish`,
+          token,
+          {
+            method: "POST",
+            body: JSON.stringify({
+              is_published: true,
+              tagline: pitch,
+              problem_statement: problem
+            })
+          }
+        );
+        if (pubRes.ok) {
+          const pubContentType = pubRes.headers.get("content-type") ?? "";
+          if (pubContentType.includes("application/json")) {
+            const pubData = await pubRes.json();
+            console.log(`  \u2713 Published! View at: ${API_BASE}/p/${pubData.public_slug ?? projectId}
+`);
+          } else {
+            console.log(`  \u2713 Published!
+`);
+          }
+        } else {
+          console.log("  \u26A0 Publishing failed \u2014 you can publish later from the UI.\n");
+        }
+      }
+    }
+  }
+  const readyToScope = await confirm(
+    `  Ready to start scoping out ${productName}?`
+  );
+  if (!readyToScope) {
+    console.log(`
+  No worries! When you're ready:
+    \u2022 Run: npx specstocode scope ${projectId}
+    \u2022 Or visit: ${API_BASE}
+
+  Your project is saved and waiting for you.
+    `);
+    closePrompt();
+    return;
+  }
+  const { scope: scope2 } = await import("./scope-BY5WSTPD.js");
+  await scope2(projectId);
+}
+
+// src/commands/propose.ts
+import { mkdirSync, writeFileSync as writeFileSync3, readFileSync as readFileSync3, existsSync as existsSync4 } from "fs";
+import { join as join3 } from "path";
+async function propose(changeName, opts = {}) {
+  requireAuth();
+  if (!hasConfig()) {
+    console.log("  Not connected to a project. Run `npx specstocode init` first.");
+    closePrompt();
+    return;
+  }
+  const config = requireConfig();
+  if (opts.from) {
+    await proposeFromFile(opts.from, config, changeName);
+    closePrompt();
+    return;
+  }
+  console.log("\n  \u{1F4CB} New change proposal\n");
+  console.log("  This will create stories in your story map and save a local spec.\n");
+  if (!changeName?.trim()) {
+    changeName = await ask("  Change name (kebab-case, e.g. add-dark-mode): ");
+  }
+  const slug = (changeName ?? "").toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+  if (!slug) {
+    console.log("  Change name required.");
+    closePrompt();
+    return;
+  }
+  const problem = await ask(
+    "\n  What problem does this solve?\n  > "
+  );
+  const solution = await ask(
+    "\n  What are you proposing to build?\n  > "
+  );
+  const activity = await ask(
+    "\n  Which activity does this belong to? (e.g. 'Onboarding', 'Core Flow')\n  > "
+  );
+  const priorityInput = await ask(
+    "\n  Priority \u2014 must / should / could [should]: "
+  );
+  const priority = ["must", "should", "could"].includes(priorityInput.trim()) ? priorityInput.trim() : "should";
+  console.log("\n  Now add stories for this change. Enter an empty title when done.\n");
+  const stories2 = [];
+  let storyNum = 1;
+  while (true) {
+    const title = await ask(`  Story ${storyNum} title (or press Enter to finish): `);
+    if (!title.trim()) break;
+    const effortInput = await ask(`  Effort for "${title}" \u2014 S / M / L / XL [M]: `);
+    const effort = ["S", "M", "L", "XL"].includes(effortInput.trim().toUpperCase()) ? effortInput.trim().toUpperCase() : "M";
+    console.log(`  Acceptance criteria for "${title}" (one per line, empty to finish):`);
+    const acs = [];
+    while (true) {
+      const ac = await ask(`    AC ${acs.length + 1}: `);
+      if (!ac.trim()) break;
+      acs.push(ac.trim());
+    }
+    stories2.push({ title: title.trim(), activity: activity.trim() || "General", priority, effort, acceptance_criteria: acs });
+    storyNum++;
+  }
+  if (stories2.length === 0) {
+    console.log("\n  No stories added. Proposal cancelled.");
+    closePrompt();
+    return;
+  }
+  console.log(`
+  Ready to create ${stories2.length} story/stories in your story map:
+`);
+  for (const s of stories2) {
+    console.log(`    [${s.priority.toUpperCase()}] ${s.title} (${s.effort})`);
+    for (const ac of s.acceptance_criteria) {
+      console.log(`      \u2022 ${ac}`);
+    }
+  }
+  const ok = await confirm("\n  Create these stories and save local proposal?");
+  if (!ok) {
+    console.log("  Cancelled.");
+    closePrompt();
+    return;
+  }
+  let created = [];
+  try {
+    const result = await createStories(config, stories2.map((s) => ({
+      title: s.title,
+      activity: s.activity,
+      priority: s.priority,
+      effort: s.effort,
+      acceptance_criteria: s.acceptance_criteria
+    })));
+    created = result.stories;
+    console.log(`
+  \u2713 Created ${result.created} stories in your story map`);
+  } catch (err) {
+    console.error(`
+  \u2717 Failed to create stories: ${err instanceof Error ? err.message : String(err)}`);
+    console.log("  Saving proposal locally anyway...");
+  }
+  const changesDir = join3(process.cwd(), "pb-changes", slug);
+  if (!existsSync4(changesDir)) mkdirSync(changesDir, { recursive: true });
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const proposalMd = [
+    `# Proposal: ${changeName}`,
+    ``,
+    `**Date:** ${date}`,
+    `**Status:** proposed`,
+    `**Priority:** ${priority}`,
+    ``,
+    `## Problem`,
+    ``,
+    problem,
+    ``,
+    `## Solution`,
+    ``,
+    solution,
+    ``,
+    `## Stories`,
+    ``,
+    ...stories2.map((s, i) => {
+      const storyId = created[i]?.id ?? null;
+      const idNote = storyId ? ` <!-- PB-${storyId} -->` : "";
+      const lines = [`### ${s.title}${idNote}`, ``, `**Activity:** ${s.activity} | **Priority:** ${s.priority} | **Effort:** ${s.effort}`, ``];
+      if (s.acceptance_criteria.length) {
+        lines.push(`**Acceptance criteria:**`, ``);
+        for (const ac of s.acceptance_criteria) lines.push(`- [ ] ${ac}`);
+        lines.push(``);
+      }
+      return lines.join("\n");
+    }),
+    `## Implementation notes`,
+    ``,
+    `_Add notes here as you build._`,
+    ``
+  ].join("\n");
+  writeFileSync3(join3(changesDir, "proposal.md"), proposalMd);
+  console.log(`  \u2713 Saved pb-changes/${slug}/proposal.md`);
+  const gitignorePath = join3(process.cwd(), ".gitignore");
+  if (existsSync4(gitignorePath)) {
+    const { readFileSync: readFileSync4, appendFileSync: appendFileSync2 } = await import("fs");
+    const gi = readFileSync4(gitignorePath, "utf-8");
+    if (!gi.includes("pb-changes")) {
+      appendFileSync2(gitignorePath, "\n# specstocode local change proposals\npb-changes/\n");
+    }
+  }
+  console.log(`
+  \u2705 Proposal "${changeName}" ready!
+
+  Stories created in your story map \u2014 view them at specstocode.com
+  Local spec saved at: pb-changes/${slug}/proposal.md
+
+  Next:
+    npx specstocode next           \u2014 pick up the first story
+    npx specstocode status         \u2014 see full progress
+    npx specstocode sync           \u2014 refresh SPECSTOCODE.md
+  `);
+  closePrompt();
+}
+function parseProposalFile(filePath) {
+  const raw = readFileSync3(filePath, "utf-8");
+  const lines = raw.split("\n");
+  let changeName = "";
+  let problem = "";
+  let solution = "";
+  let activity = "General";
+  let priority = "should";
+  const stories2 = [];
+  let currentStory = null;
+  for (const raw2 of lines) {
+    const line = raw2.trim();
+    if (line.startsWith("# ")) {
+      changeName = line.replace(/^#\s+/, "").replace(/^Proposal:\s*/i, "").trim();
+      continue;
+    }
+    if (line.startsWith("## ")) {
+      if (currentStory) stories2.push(currentStory);
+      currentStory = {
+        title: line.replace(/^##\s+/, "").trim(),
+        effort: "M",
+        acceptance_criteria: [],
+        activity,
+        priority
+      };
+      continue;
+    }
+    if (currentStory) {
+      const effortMatch = line.match(/^\*\*Effort:\*\*\s*([SMLXLxsml]+)/i);
+      if (effortMatch) {
+        const e = effortMatch[1].toUpperCase();
+        if (["S", "M", "L", "XL"].includes(e)) currentStory.effort = e;
+        continue;
+      }
+      const actMatch = line.match(/^\*\*Activity:\*\*\s*(.+)/i);
+      if (actMatch) {
+        currentStory.activity = actMatch[1].trim();
+        continue;
+      }
+      const priMatch = line.match(/^\*\*Priority:\*\*\s*(must|should|could)/i);
+      if (priMatch) {
+        currentStory.priority = priMatch[1].toLowerCase();
+        continue;
+      }
+      if (line.startsWith("- ")) {
+        currentStory.acceptance_criteria.push(line.slice(2).replace(/^\[ \]\s*/, "").trim());
+        continue;
+      }
+    } else {
+      const probMatch = line.match(/^\*\*Problem:\*\*\s*(.+)/i);
+      if (probMatch) {
+        problem = probMatch[1].trim();
+        continue;
+      }
+      const solMatch = line.match(/^\*\*Solution:\*\*\s*(.+)/i);
+      if (solMatch) {
+        solution = solMatch[1].trim();
+        continue;
+      }
+      const actMatch = line.match(/^\*\*Activity:\*\*\s*(.+)/i);
+      if (actMatch) {
+        activity = actMatch[1].trim();
+        continue;
+      }
+      const priMatch = line.match(/^\*\*Priority:\*\*\s*(must|should|could)/i);
+      if (priMatch) {
+        priority = priMatch[1].toLowerCase();
+        continue;
+      }
+    }
+  }
+  if (currentStory) stories2.push(currentStory);
+  return { changeName, problem, solution, activity, priority, stories: stories2 };
+}
+async function proposeFromFile(filePath, config, nameOverride) {
+  if (!existsSync4(filePath)) {
+    console.error(`
+  File not found: ${filePath}
+`);
+    process.exit(1);
+  }
+  const parsed = parseProposalFile(filePath);
+  const changeName = nameOverride?.trim() || parsed.changeName || filePath.replace(/.*\//, "").replace(/\.md$/, "");
+  const slug = changeName.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+  if (parsed.stories.length === 0) {
+    console.error("\n  No stories found in the file. Add ## headings for each story.\n");
+    process.exit(1);
+  }
+  console.log(`
+  \u{1F4CB} Proposing "${changeName}" from ${filePath}
+`);
+  for (const s of parsed.stories) {
+    console.log(`    [${s.priority.toUpperCase()}] ${s.title} (${s.effort}) \u2014 ${s.acceptance_criteria.length} ACs`);
+  }
+  let created = [];
+  try {
+    const result = await createStories(config, parsed.stories.map((s) => ({
+      title: s.title,
+      activity: s.activity,
+      priority: s.priority,
+      effort: s.effort,
+      acceptance_criteria: s.acceptance_criteria
+    })));
+    created = result.stories;
+    console.log(`
+  \u2713 Created ${result.created} stories in your story map`);
+  } catch (err) {
+    console.error(`
+  \u2717 Failed to create stories: ${err instanceof Error ? err.message : String(err)}`);
+    console.log("  Saving proposal locally anyway...");
+  }
+  const changesDir = join3(process.cwd(), "pb-changes", slug);
+  if (!existsSync4(changesDir)) mkdirSync(changesDir, { recursive: true });
+  const proposalMd = [
+    `# Proposal: ${changeName}`,
+    ``,
+    `**Date:** ${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}`,
+    `**Source:** ${filePath}`,
+    `**Status:** proposed`,
+    ``,
+    `## Problem`,
+    ``,
+    parsed.problem || "_See source file_",
+    ``,
+    `## Solution`,
+    ``,
+    parsed.solution || "_See source file_",
+    ``,
+    `## Stories`,
+    ``,
+    ...parsed.stories.map((s, i) => {
+      const storyId = created[i]?.id ?? null;
+      const idNote = storyId ? ` <!-- PB-${storyId} -->` : "";
+      const acLines = s.acceptance_criteria.map((ac) => `- [ ] ${ac}`);
+      return [
+        `### ${s.title}${idNote}`,
+        ``,
+        `**Activity:** ${s.activity} | **Priority:** ${s.priority} | **Effort:** ${s.effort}`,
+        ``,
+        ...acLines.length ? [`**Acceptance criteria:**`, ``, ...acLines, ``] : []
+      ].join("\n");
+    })
+  ].join("\n");
+  writeFileSync3(join3(changesDir, "proposal.md"), proposalMd);
+  console.log(`  \u2713 Saved pb-changes/${slug}/proposal.md`);
+  console.log(`
+  \u2705 Done! Run \`npx specstocode next\` to start building.
+`);
+}
+
+// src/commands/show.ts
+var STATUS_ICON2 = {
+  done: "\u2705",
+  in_progress: "\u{1F528}",
+  todo: "\u2B1C"
+};
+async function show(idPrefix) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const story = data.stories.find((s) => s.id.startsWith(idPrefix));
+  if (!story) {
+    console.error(`
+  No story found matching "${idPrefix}"
+  Run \`productbuilders stories\` to list IDs.
+`);
+    process.exit(1);
+  }
+  const statusIcon = STATUS_ICON2[story.status ?? "todo"] ?? "\u2B1C";
+  const specUrl = `${config.apiBase}/storymapper/${data.map.id}?story=${story.id}`;
+  console.log(`
+  ${statusIcon} ${story.title}`);
+  console.log(`  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
+  console.log(`  Activity : ${story.activity}`);
+  console.log(`  Type     : ${story.story_type ?? "user_story"}`);
+  console.log(`  Priority : ${story.priority}  |  Effort : ${story.effort}  |  Release : ${story.release}`);
+  console.log(`  ID       : ${story.id}`);
+  console.log(`  Spec     : ${specUrl}`);
+  if (story.as_a || story.i_want || story.so_that) {
+    console.log(`
+  User story`);
+    if (story.as_a) console.log(`    As a     : ${story.as_a}`);
+    if (story.i_want) console.log(`    I want   : ${story.i_want}`);
+    if (story.so_that) console.log(`    So that  : ${story.so_that}`);
+  }
+  if (story.acceptance_criteria.length > 0) {
+    console.log(`
+  Done when:`);
+    for (const ac of story.acceptance_criteria) {
+      const check = ac.done ? "\u2611" : "\u2610";
+      console.log(`    ${check} ${ac.text}`);
+    }
+  }
+  if (story.notes) {
+    console.log(`
+  Notes:`);
+    for (const line of story.notes.split("\n")) {
+      console.log(`    ${line}`);
+    }
+  }
+  if (story.evidence && story.evidence.length > 0) {
+    console.log(`
+  Evidence (${story.evidence.length}):`);
+    for (const ev of story.evidence) {
+      console.log(`    [${ev.type}] ${ev.content.slice(0, 80)}${ev.content.length > 80 ? "\u2026" : ""}${ev.source ? ` \u2014 ${ev.source}` : ""}`);
+    }
+  }
+  const contextPath = writeStoryContext(story);
+  const relPath = contextPath.replace(process.cwd() + "/", "");
+  console.log(`
+  Context  : ${relPath}`);
+  console.log(`  Mark done: npx productbuilders done ${story.id.slice(0, 8)}
+`);
+}
+
+// src/templates/index.ts
+var templates = {
+  saas: {
+    name: "SaaS Starter",
+    description: "Multi-tenant SaaS with auth, billing, and dashboards",
+    personas: [
+      { name: "Admin", role: "Account administrator who manages the team" },
+      { name: "User", role: "End user who uses the core product daily" }
+    ],
+    activities: [
+      { title: "Sign up & Onboard", steps: ["Registration", "Team setup", "First-run experience"] },
+      { title: "Core Workflow", steps: ["Dashboard", "Main feature", "Data management"] },
+      { title: "Team Management", steps: ["Invite members", "Roles & permissions"] },
+      { title: "Billing & Plans", steps: ["Plan selection", "Checkout", "Usage tracking"] },
+      { title: "Settings & Account", steps: ["Profile", "Notifications", "Integrations"] }
+    ],
+    stories: [
+      { title: "Sign up with email or OAuth", activity: "Sign up & Onboard", step: "Registration", priority: "must", effort: "M", release: 1 },
+      { title: "Email verification flow", activity: "Sign up & Onboard", step: "Registration", priority: "must", effort: "S", release: 1 },
+      { title: "Create workspace / tenant", activity: "Sign up & Onboard", step: "Team setup", priority: "must", effort: "M", release: 1 },
+      { title: "Onboarding wizard (3 steps)", activity: "Sign up & Onboard", step: "First-run experience", priority: "should", effort: "M", release: 1 },
+      { title: "Main dashboard with key metrics", activity: "Core Workflow", step: "Dashboard", priority: "must", effort: "L", release: 1 },
+      { title: "CRUD for primary resource", activity: "Core Workflow", step: "Main feature", priority: "must", effort: "L", release: 1 },
+      { title: "Search and filter", activity: "Core Workflow", step: "Data management", priority: "must", effort: "M", release: 1 },
+      { title: "Export data as CSV", activity: "Core Workflow", step: "Data management", priority: "should", effort: "S", release: 2 },
+      { title: "Invite team members by email", activity: "Team Management", step: "Invite members", priority: "must", effort: "M", release: 1 },
+      { title: "Role-based access control", activity: "Team Management", step: "Roles & permissions", priority: "must", effort: "L", release: 1 },
+      { title: "Stripe subscription checkout", activity: "Billing & Plans", step: "Checkout", priority: "must", effort: "L", release: 1 },
+      { title: "Free trial with upgrade prompt", activity: "Billing & Plans", step: "Plan selection", priority: "should", effort: "M", release: 1 },
+      { title: "Usage-based billing meter", activity: "Billing & Plans", step: "Usage tracking", priority: "could", effort: "L", release: 3 },
+      { title: "Edit profile and avatar", activity: "Settings & Account", step: "Profile", priority: "must", effort: "S", release: 1 },
+      { title: "Email notification preferences", activity: "Settings & Account", step: "Notifications", priority: "should", effort: "M", release: 2 },
+      { title: "Webhook integrations", activity: "Settings & Account", step: "Integrations", priority: "could", effort: "L", release: 3 }
+    ]
+  },
+  marketplace: {
+    name: "Marketplace",
+    description: "Two-sided marketplace connecting buyers and sellers",
+    personas: [
+      { name: "Buyer", role: "Person searching for and purchasing services/products" },
+      { name: "Seller", role: "Person listing and selling services/products" }
+    ],
+    activities: [
+      { title: "Discover", steps: ["Browse listings", "Search & filter", "View details"] },
+      { title: "List & Sell", steps: ["Create listing", "Manage inventory", "Pricing"] },
+      { title: "Transact", steps: ["Add to cart", "Checkout", "Payment processing"] },
+      { title: "Communicate", steps: ["Messaging", "Reviews & ratings"] },
+      { title: "Manage Account", steps: ["Profile", "Order history", "Payouts"] }
+    ],
+    stories: [
+      { title: "Browse listings with categories", activity: "Discover", step: "Browse listings", priority: "must", effort: "L", release: 1 },
+      { title: "Full-text search with filters", activity: "Discover", step: "Search & filter", priority: "must", effort: "L", release: 1 },
+      { title: "Listing detail page with images", activity: "Discover", step: "View details", priority: "must", effort: "M", release: 1 },
+      { title: "Create listing with photos and description", activity: "List & Sell", step: "Create listing", priority: "must", effort: "L", release: 1 },
+      { title: "Set pricing and availability", activity: "List & Sell", step: "Pricing", priority: "must", effort: "M", release: 1 },
+      { title: "Manage active listings", activity: "List & Sell", step: "Manage inventory", priority: "must", effort: "M", release: 1 },
+      { title: "Shopping cart", activity: "Transact", step: "Add to cart", priority: "must", effort: "M", release: 1 },
+      { title: "Stripe checkout flow", activity: "Transact", step: "Checkout", priority: "must", effort: "L", release: 1 },
+      { title: "Split payments (platform fee + seller payout)", activity: "Transact", step: "Payment processing", priority: "must", effort: "XL", release: 1 },
+      { title: "Buyer-seller messaging", activity: "Communicate", step: "Messaging", priority: "should", effort: "L", release: 2 },
+      { title: "Leave reviews and ratings", activity: "Communicate", step: "Reviews & ratings", priority: "should", effort: "M", release: 2 },
+      { title: "Seller payout dashboard", activity: "Manage Account", step: "Payouts", priority: "must", effort: "L", release: 1 },
+      { title: "Order history for buyers", activity: "Manage Account", step: "Order history", priority: "must", effort: "M", release: 1 }
+    ]
+  },
+  "mobile-app": {
+    name: "Mobile App",
+    description: "Consumer mobile app with auth, feed, and notifications",
+    personas: [
+      { name: "New User", role: "First-time user downloading the app" },
+      { name: "Power User", role: "Daily active user who has customized their experience" }
+    ],
+    activities: [
+      { title: "Onboard", steps: ["App store \u2192 first open", "Sign up", "Permissions"] },
+      { title: "Core Experience", steps: ["Feed / home", "Create content", "Interact"] },
+      { title: "Profile & Social", steps: ["View profile", "Follow / connect", "Notifications"] },
+      { title: "Settings", steps: ["Preferences", "Privacy", "Account"] }
+    ],
+    stories: [
+      { title: "App store listing and screenshots", activity: "Onboard", step: "App store \u2192 first open", priority: "must", effort: "M", release: 1 },
+      { title: "Social login (Apple, Google)", activity: "Onboard", step: "Sign up", priority: "must", effort: "M", release: 1 },
+      { title: "Push notification permission prompt", activity: "Onboard", step: "Permissions", priority: "must", effort: "S", release: 1 },
+      { title: "Main feed with pull-to-refresh", activity: "Core Experience", step: "Feed / home", priority: "must", effort: "L", release: 1 },
+      { title: "Create and publish content", activity: "Core Experience", step: "Create content", priority: "must", effort: "L", release: 1 },
+      { title: "Like, comment, share", activity: "Core Experience", step: "Interact", priority: "must", effort: "M", release: 1 },
+      { title: "User profile page", activity: "Profile & Social", step: "View profile", priority: "must", effort: "M", release: 1 },
+      { title: "Follow/unfollow users", activity: "Profile & Social", step: "Follow / connect", priority: "must", effort: "M", release: 1 },
+      { title: "Push notifications for interactions", activity: "Profile & Social", step: "Notifications", priority: "should", effort: "L", release: 2 },
+      { title: "Dark mode toggle", activity: "Settings", step: "Preferences", priority: "should", effort: "S", release: 2 },
+      { title: "Block and report users", activity: "Settings", step: "Privacy", priority: "must", effort: "M", release: 1 },
+      { title: "Delete account", activity: "Settings", step: "Account", priority: "must", effort: "S", release: 1 }
+    ]
+  },
+  "ai-tool": {
+    name: "AI Tool",
+    description: "AI-powered tool with prompt input, generation, and history",
+    personas: [
+      { name: "Creator", role: "Professional using AI to augment their workflow" }
+    ],
+    activities: [
+      { title: "Input & Configure", steps: ["Describe task", "Select model / options", "Upload context"] },
+      { title: "Generate", steps: ["Streaming output", "Edit & refine", "Regenerate"] },
+      { title: "Save & Share", steps: ["History", "Export", "Share link"] },
+      { title: "Account & Billing", steps: ["Usage dashboard", "Plan management", "API keys"] }
+    ],
+    stories: [
+      { title: "Natural language input with prompt templates", activity: "Input & Configure", step: "Describe task", priority: "must", effort: "M", release: 1 },
+      { title: "Model / style selector", activity: "Input & Configure", step: "Select model / options", priority: "should", effort: "M", release: 1 },
+      { title: "File upload for context (PDF, images)", activity: "Input & Configure", step: "Upload context", priority: "should", effort: "L", release: 2 },
+      { title: "Streaming AI response with progress", activity: "Generate", step: "Streaming output", priority: "must", effort: "L", release: 1 },
+      { title: "Inline editing of generated output", activity: "Generate", step: "Edit & refine", priority: "must", effort: "M", release: 1 },
+      { title: "Regenerate with tweaked parameters", activity: "Generate", step: "Regenerate", priority: "should", effort: "S", release: 1 },
+      { title: "Generation history with search", activity: "Save & Share", step: "History", priority: "must", effort: "M", release: 1 },
+      { title: "Export as markdown / PDF", activity: "Save & Share", step: "Export", priority: "should", effort: "M", release: 2 },
+      { title: "Shareable public link", activity: "Save & Share", step: "Share link", priority: "could", effort: "M", release: 2 },
+      { title: "Token usage dashboard", activity: "Account & Billing", step: "Usage dashboard", priority: "must", effort: "M", release: 1 },
+      { title: "Stripe subscription with usage limits", activity: "Account & Billing", step: "Plan management", priority: "must", effort: "L", release: 1 },
+      { title: "API key management for developers", activity: "Account & Billing", step: "API keys", priority: "could", effort: "M", release: 3 }
+    ]
+  }
+};
+
+// src/mcp/server.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var TOOLS = [
+  // ── Core tools (~5k tokens) ──────────────────────────────────────────────
+  {
+    name: "list_stories",
+    description: "List all stories from the specstocode story map with their status (todo/in_progress/done), priority, effort, and acceptance criteria.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        filter: {
+          type: "string",
+          description: "Optional filter: 'todo', 'in_progress', 'done', or a search term"
+        }
+      }
+    },
+    mode: "core"
+  },
+  {
+    name: "mark_done",
+    description: "Mark a story as done on the specstocode story map. Use the story ID from list_stories.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID (full UUID or prefix)" }
+      },
+      required: ["story_id"]
+    },
+    mode: "core"
+  },
+  {
+    name: "mark_in_progress",
+    description: "Mark a story as in progress on the specstocode story map.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID" }
+      },
+      required: ["story_id"]
+    },
+    mode: "core"
+  },
+  {
+    name: "get_status",
+    description: "Get a summary of story map progress \u2014 total stories, done, in progress, todo counts.",
+    inputSchema: { type: "object", properties: {} },
+    mode: "core"
+  },
+  {
+    name: "add_note",
+    description: "Add implementation notes to a story. Use this to record how something was built, gotchas, or context for future developers.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID" },
+        note: { type: "string", description: "Implementation note" }
+      },
+      required: ["story_id", "note"]
+    },
+    mode: "core"
+  },
+  // ── Standard tools (~10k tokens) ────────────────────────────────────────
+  {
+    name: "create_story",
+    description: "Create a new story on the specstocode story map. Use when you discover a new requirement during development.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string", description: "Story title" },
+        activity: { type: "string", description: "Activity name to add the story under" },
+        priority: { type: "string", enum: ["must", "should", "could"], description: "Priority level" },
+        effort: { type: "string", enum: ["S", "M", "L", "XL"], description: "Effort estimate" }
+      },
+      required: ["title"]
+    },
+    mode: "standard"
+  },
+  {
+    name: "get_context",
+    description: "Get the full SPECSTOCODE.md context \u2014 the product story map with all personas, stories, and acceptance criteria.",
+    inputSchema: { type: "object", properties: {} },
+    mode: "standard"
+  },
+  {
+    name: "log_decision",
+    description: "Log an architectural or product decision to the specstocode story map. Use this when you make a significant technical choice during development.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string", description: "Short decision title" },
+        description: { type: "string", description: "What was decided and why" },
+        category: {
+          type: "string",
+          enum: ["architecture", "product", "technical", "trade-off"],
+          description: "Decision category"
+        },
+        story_id: { type: "string", description: "Optional: link to a story ID" }
+      },
+      required: ["title", "description"]
+    },
+    mode: "standard"
+  },
+  // ── All tools (~15k tokens) ─────────────────────────────────────────────
+  {
+    name: "analyze_complexity",
+    description: "Analyze the complexity of stories using AI. Returns a 1-10 complexity score, reasoning, risks, and suggested effort for each story. Useful before starting work to identify hidden complexity.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional list of story IDs to analyze. If omitted, analyzes all non-done stories."
+        }
+      }
+    },
+    mode: "all"
+  },
+  {
+    name: "research",
+    description: "Research a topic using AI with your project context. Returns findings, recommendations, risks, and next steps. Use for architectural decisions, library choices, or technical questions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "What to research" }
+      },
+      required: ["query"]
+    },
+    mode: "all"
+  },
+  {
+    name: "import_prd",
+    description: "Parse a PRD or spec document into user stories. Returns structured stories with titles, activities, priorities, effort estimates, and acceptance criteria.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        prd: { type: "string", description: "The PRD or spec text to parse" },
+        format: { type: "string", description: "Document format: PRD, Markdown, text", enum: ["PRD", "Markdown", "text"] }
+      },
+      required: ["prd"]
+    },
+    mode: "all"
+  }
+];
+var MODE_LEVELS = { core: 0, standard: 1, all: 2 };
+function getToolsForMode(mode) {
+  const level = MODE_LEVELS[mode];
+  return TOOLS.filter((t) => MODE_LEVELS[t.mode] <= level);
+}
+async function startMcpServer(mode = "all") {
+  const config = requireConfig();
+  const toolMode = ["core", "standard", "all"].includes(mode) ? mode : "all";
+  const activeTools = getToolsForMode(toolMode);
+  const server = new Server(
+    { name: "specstocode", version: "0.2.0" },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: activeTools.map(({ mode: _m, ...rest }) => rest)
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (!activeTools.find((t) => t.name === name)) {
+      return {
+        content: [{
+          type: "text",
+          text: `Tool "${name}" is not available in "${toolMode}" mode. Use --mode standard or --mode all to enable it.`
+        }]
+      };
+    }
+    switch (name) {
+      case "list_stories": {
+        const data = await listStories(config);
+        let storyList = data.stories;
+        const filter = args?.filter ?? "";
+        if (filter) {
+          const f = filter.toLowerCase();
+          if (["todo", "in_progress", "done"].includes(f)) {
+            storyList = storyList.filter((s) => s.status === f);
+          } else {
+            storyList = storyList.filter(
+              (s) => s.title.toLowerCase().includes(f) || s.activity.toLowerCase().includes(f)
+            );
+          }
+        }
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ summary: data.summary, stories: storyList }, null, 2)
+          }]
+        };
+      }
+      case "mark_done":
+      case "mark_in_progress": {
+        const storyId = args?.story_id;
+        if (!storyId) return { content: [{ type: "text", text: "story_id is required" }] };
+        const data = await listStories(config);
+        const match = data.stories.find((s) => s.id.startsWith(storyId));
+        if (!match) return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
+        const newStatus = name === "mark_done" ? "done" : "in_progress";
+        await updateStories(config, [{ id: match.id, status: newStatus }]);
+        return {
+          content: [{ type: "text", text: `\u2713 ${match.title} \u2192 ${newStatus}` }]
+        };
+      }
+      case "create_story": {
+        const result = await createStories(config, [
+          {
+            title: args?.title,
+            activity: args?.activity,
+            priority: args?.priority,
+            effort: args?.effort
+          }
+        ]);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      }
+      case "get_context": {
+        const md = await getContext(config);
+        return { content: [{ type: "text", text: md }] };
+      }
+      case "get_status": {
+        const data = await listStories(config);
+        const { summary } = data;
+        const pct = summary.total > 0 ? Math.round(summary.done / summary.total * 100) : 0;
+        return {
+          content: [{
+            type: "text",
+            text: `${data.map.title}: ${summary.done}/${summary.total} done (${pct}%) \u2014 ${summary.in_progress} in progress, ${summary.todo} todo`
+          }]
+        };
+      }
+      case "log_decision": {
+        const res = await fetch(
+          `${config.apiBase}/api/sync/${config.syncToken}/decisions`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              title: args?.title,
+              description: args?.description,
+              category: args?.category ?? "technical",
+              story_id: args?.story_id
+            })
+          }
+        );
+        if (res.ok) {
+          return { content: [{ type: "text", text: `\u2713 Decision logged: ${args?.title}` }] };
+        }
+        return { content: [{ type: "text", text: "Failed to log decision" }] };
+      }
+      case "add_note": {
+        const storyId = args?.story_id;
+        const note = args?.note;
+        if (!storyId || !note) {
+          return { content: [{ type: "text", text: "story_id and note required" }] };
+        }
+        const data = await listStories(config);
+        const match = data.stories.find((s) => s.id.startsWith(storyId));
+        if (!match) {
+          return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
+        }
+        await fetch(`${config.apiBase}/api/sync/${config.syncToken}/stories`, {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ stories: [{ id: match.id, notes: note }] })
+        });
+        return { content: [{ type: "text", text: `\u2713 Note added to: ${match.title}` }] };
+      }
+      // ── New tools ─────────────────────────────────────────────────────────
+      case "analyze_complexity": {
+        const storyIds = args?.story_ids;
+        const body = {};
+        if (storyIds?.length) body.story_ids = storyIds;
+        else {
+          const data = await listStories(config);
+          body.story_ids = data.stories.filter((s) => s.status !== "done").map((s) => s.id);
+        }
+        const res = await fetch(
+          `${config.apiBase}/api/sync/${config.syncToken}/complexity`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body)
+          }
+        );
+        if (!res.ok) return { content: [{ type: "text", text: "Complexity analysis failed" }] };
+        const result = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "research": {
+        const query = args?.query;
+        if (!query) return { content: [{ type: "text", text: "query is required" }] };
+        const res = await fetch(
+          `${config.apiBase}/api/sync/${config.syncToken}/research`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ query })
+          }
+        );
+        if (!res.ok) return { content: [{ type: "text", text: "Research failed" }] };
+        const result = await res.json();
+        return { content: [{ type: "text", text: result.research }] };
+      }
+      case "import_prd": {
+        const prd = args?.prd;
+        if (!prd) return { content: [{ type: "text", text: "prd text is required" }] };
+        const res = await fetch(
+          `${config.apiBase}/api/sync/${config.syncToken}/import`,
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ prd, format: args?.format ?? "PRD" })
+          }
+        );
+        if (!res.ok) return { content: [{ type: "text", text: "PRD import failed" }] };
+        const result = await res.json();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      default:
+        return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
+    }
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+// src/commands/openclaw-register.ts
+import { execSync as execSync2 } from "child_process";
+async function openclawRegister() {
+  if (!hasConfig()) {
+    console.error("Not initialised. Run: npx specstocode init");
+    process.exit(1);
+  }
+  const config = readConfig();
+  const cwd = process.cwd();
+  const mapTitle = config?.mapTitle ?? "this project";
+  const registration = JSON.stringify({
+    command: "npx",
+    args: ["specstocode", "mcp"],
+    cwd
+  });
+  console.log(`
+Registering specstocode MCP with OpenClaw...`);
+  console.log(`  Project : ${mapTitle}`);
+  console.log(`  cwd     : ${cwd}
+`);
+  try {
+    execSync2(`openclaw mcp set specstocode '${registration}'`, {
+      stdio: "inherit"
+    });
+    console.log(`
+\u2705 Done. Any coding agent OpenClaw spawns from this project will have`);
+    console.log(`   access to list_stories, mark_done, add_note, create_story, and more.
+`);
+    console.log(`   To register a different project, cd into it and run this command again.
+`);
+  } catch (err) {
+    console.error("\n\u2717 Registration failed. Is OpenClaw installed and on your PATH?");
+    console.error("  You can register manually:\n");
+    console.error(`  openclaw mcp set specstocode '${registration}'
+`);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
+var program = new Command();
+program.name("specstocode").description("Write specs, map stories, ship with AI \u2014 from your terminal").version(version);
+program.command("login").description("Log in to specstocode (opens browser)").action(() => void login());
+program.command("logout").description("Log out of specstocode").action(() => void logout());
+program.command("start").description("Start a new project \u2014 guided flow from problem to pitch").action(() => void start());
+program.command("scope [projectId]").description("Scope a project \u2014 generate blueprint, story map, and mockup").action((id) => void scope(id));
+program.command("setup").description("Configure your AI tool (Claude Code / Cursor) with specstocode agent workflows").action(() => void setup());
+program.command("propose [name]").description("Propose a new change \u2014 creates stories in your map and saves a local spec").option("--from <file>", "Parse stories from a markdown proposal file instead of prompting").action((name, opts) => void propose(name, opts));
+program.command("templates [name]").description("Browse story map templates").action((name) => {
+  if (!name) {
+    console.log("\n  Available templates:\n");
+    for (const [key, tmpl] of Object.entries(templates)) {
+      console.log(`    ${key.padEnd(20)} ${tmpl.description}`);
+    }
+    console.log(`
+  Usage: npx specstocode templates <name>
+`);
+  } else {
+    const tmpl = templates[name];
+    if (!tmpl) {
+      console.error(`Unknown template: "${name}". Run \`npx specstocode templates\` to list.`);
+    } else {
+      console.log(`
+  ${tmpl.name}: ${tmpl.description}`);
+      console.log(`  ${tmpl.stories.length} stories, ${tmpl.activities.length} activities, ${tmpl.personas.length} personas
+`);
+      for (const act of tmpl.activities) {
+        console.log(`    ${act.title}: ${act.steps.join(" \u2192 ")}`);
+      }
+      console.log();
+    }
+  }
+});
+program.command("init [token]").description("Connect this project to a specstocode story map").action((token) => void init(token));
+program.command("sync").description("Refresh SPECSTOCODE.md from the live story map").action(() => void sync());
+program.command("status").description("Show story map progress").action(() => void status());
+program.command("stories").description("List all stories").option("-f, --filter <filter>", "Filter by status (todo/in-progress/done) or search term").option("-s, --status <status>", "Filter by exact status: todo, in-progress, wip, done").option("-k, --kanban", "View stories as a kanban board (todo | in-progress | done)").action((opts) => void stories(opts));
+program.command("next").description("Show the next highest-priority story to work on").option("-o, --open", "Open the spec page in your browser").option("--skip-wip", "Pick next todo even if stories are in progress").action((opts) => void next(opts));
+program.command("show <id>").description("Show the full spec for a story (accepts ID prefix)").action((id) => void show(id));
+program.command("done <id>").description("Mark a story as done (accepts ID prefix)").action((id) => void done(id));
+program.command("add <title>").description("Create a new story").option("-a, --activity <activity>", "Activity to add the story under").option("-p, --priority <priority>", "Priority: must, should, could", "should").option("-e, --effort <effort>", "Effort: S, M, L, XL", "M").action((title, opts) => void add(title, opts));
+program.command("decide [title]").description("Log an architectural or product decision").option("-d, --description <desc>", "Decision description").option("-c, --category <cat>", "Category: architecture, product, technical, trade-off", "technical").option("-s, --story <id>", "Link to a story ID").action((title, opts) => {
+  import("./log-GSWUQF6Z.js").then((m) => void m.logDecision(title, opts));
+});
+program.command("note <storyId> [note]").description("Add implementation notes to a story").action((storyId, note) => {
+  import("./log-GSWUQF6Z.js").then((m) => void m.logNote(storyId, note));
+});
+program.command("complexity [storyId]").description("Analyze story complexity with AI \u2014 scores, risks, effort estimates").action((id) => {
+  import("./complexity-TUS6F2UI.js").then((m) => void m.complexity(id));
+});
+program.command("research [query]").description("Research a topic with AI using your project context").action((query) => {
+  import("./research-UGNKVMZ5.js").then((m) => void m.research(query));
+});
+program.command("import [file]").description("Import a PRD or spec into your story map as stories").action((file) => {
+  import("./import-prd-HP66GKRA.js").then((m) => void m.importPrd(file));
+});
+program.command("mcp").description("Start MCP server for Claude Code / Cursor integration").option("-m, --mode <mode>", "Tool mode: core, standard, all", "all").action((opts) => void startMcpServer(opts.mode));
+program.command("openclaw-register").description("Register this project with OpenClaw MCP \u2014 gives spawned coding agents access to your story map").action(() => void openclawRegister());
+program.parse();