intentdocs 0.8.0

package/dist/index.js

@@ -0,0 +1,2821 @@
+#!/usr/bin/env node
+import {
+  captureCli,
+  setup,
+  shutdownCliAnalytics,
+  sync
+} from "./chunk-IKF3ZLHK.js";
+import {
+  scope
+} from "./chunk-4OWPN2RE.js";
+import {
+  criterionPriority,
+  criterionStatusLabel,
+  findBlockingMusts,
+  storyContextPath,
+  writeStoryContext
+} from "./chunk-6FGYJ3W2.js";
+import {
+  ask,
+  closePrompt,
+  confirm,
+  pausePrompt
+} from "./chunk-WPVDURTJ.js";
+import {
+  UPGRADE_MESSAGE_PLAIN,
+  isPlanGated
+} from "./chunk-ITQUQYWB.js";
+import {
+  apiFetch,
+  apiUrl,
+  createStories,
+  getContext,
+  listStories,
+  raiseBlocker,
+  reportCriteria,
+  updateStories,
+  uploadScreenshot
+} from "./chunk-6XKB6RTU.js";
+import {
+  hasConfig,
+  readConfig,
+  requireConfig,
+  writeConfig
+} from "./chunk-ICOMMHKG.js";
+import {
+  API_BASE,
+  getAuth,
+  requireAuth,
+  saveAuth
+} from "./chunk-PCNDP5SX.js";
+
+// src/index.ts
+import { Command } from "commander";
+import { createRequire as createRequire2 } from "module";
+
+// src/commands/init.ts
+import { writeFileSync, existsSync, readFileSync, appendFileSync, statSync } 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 `intent logout` to switch accounts.");
+    return;
+  }
+  console.log("Logging in to intentdocs...\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,
+          ...data.userId && { userId: data.userId },
+          ...data.posthogKey && { posthogKey: data.posthogKey },
+          ...data.posthogHost && { posthogHost: data.posthogHost }
+        });
+        console.log("\u2705 Logged in to intentdocs!\n");
+        console.log("You can now run: intent init");
+        console.log(
+          "Optional: add your Anthropic API key to unlock AI features on any plan \u2014 intent keys set"
+        );
+        return;
+      }
+      if (data.status === "expired") {
+        console.error("Login request expired. Run `intent login` to try again.");
+        process.exit(1);
+      }
+      process.stdout.write(".");
+    } catch {
+      process.stdout.write(".");
+    }
+  }
+  console.error("\nLogin timed out. Run `intent login` to try again.");
+  process.exit(1);
+}
+async function logout() {
+  const { existsSync: existsSync5, unlinkSync } = await import("fs");
+  const { join: join5 } = await import("path");
+  const { homedir } = await import("os");
+  const authFile = join5(homedir(), ".intent", "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" };
+}
+function detectStack(cwd) {
+  try {
+    if (existsSync(join(cwd, "package.json"))) {
+      const raw = readFileSync(join(cwd, "package.json"), "utf-8");
+      const pkg = JSON.parse(raw);
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (deps["next"]) return "Next.js (React, TypeScript)";
+      if (deps["remix"] || deps["@remix-run/react"]) return "Remix (React, TypeScript)";
+      if (deps["react"]) return "React (TypeScript, Vite)";
+      if (deps["vue"]) return "Vue 3 (TypeScript, Vite)";
+      if (deps["svelte"] || deps["@sveltejs/kit"]) return "SvelteKit (TypeScript)";
+      if (deps["fastify"]) return "Node.js (Fastify, TypeScript)";
+      if (deps["express"]) return "Node.js (Express, TypeScript)";
+      return "Node.js (TypeScript)";
+    }
+    if (existsSync(join(cwd, "pyproject.toml")) || existsSync(join(cwd, "requirements.txt"))) {
+      const hasFastapi = existsSync(join(cwd, "pyproject.toml")) && readFileSync(join(cwd, "pyproject.toml"), "utf-8").includes("fastapi");
+      return hasFastapi ? "Python (FastAPI)" : "Python";
+    }
+    if (existsSync(join(cwd, "Cargo.toml"))) return "Rust";
+    if (existsSync(join(cwd, "go.mod"))) return "Go";
+    if (existsSync(join(cwd, "pubspec.yaml"))) return "Flutter (Dart)";
+  } catch {
+  }
+  return "";
+}
+async function init(tokenArg) {
+  if (hasConfig()) {
+    console.log("Already initialized. Run `intent 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 });
+  const initStart = Date.now();
+  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 `intent login` first.");
+      process.exit(1);
+    }
+    const { projects } = await projectsRes.json();
+    if (projects.length === 0) {
+      console.log("\nNo projects found. Create one at intentdocs.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, appUrl } = await mapsRes.json();
+    if (maps.length === 0) {
+      console.log("\nNo story maps in this project. Create one at intentdocs.com first.");
+      process.exit(0);
+    }
+    console.log(`
+Story maps in "${project.name}":
+`);
+    const map2 = await pickFromList(rl, maps, (m) => m.title, "Select story map");
+    const config = {
+      syncToken: map2.syncToken,
+      apiBase: auth.apiBase,
+      mapTitle: map2.title,
+      projectId: project.id,
+      mapId: map2.id,
+      ...appUrl && { appUrl }
+    };
+    console.log(`
+Connecting to "${map2.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);
+    await setupStack(rl);
+    const specPath = join(process.cwd(), "INTENT.md");
+    const claudeMdBytes = existsSync(specPath) ? statSync(specPath).size : 0;
+    captureCli(
+      "harness_initialized",
+      {
+        sections_generated: 0,
+        claude_md_bytes: claudeMdBytes,
+        duration_ms: Date.now() - initStart
+      },
+      { project: project.id }
+    );
+    console.log(`
+  \u2705 Ready! Next steps:
+
+    intent status         \u2014 see your story map
+    intent next           \u2014 pick up the first story
+    intent setup          \u2014 configure Claude Code / Cursor slash commands
+    intent propose        \u2014 plan a new feature from the terminal
+    `);
+  } finally {
+    rl.close();
+    await shutdownCliAnalytics();
+  }
+}
+async function setupStack(rl) {
+  const cwd = process.cwd();
+  const archPath = join(cwd, "ARCHITECTURE.md");
+  if (existsSync(archPath)) return;
+  const detected = detectStack(cwd);
+  let stack;
+  if (detected) {
+    console.log(`
+  Detected stack: ${detected}`);
+    const confirm2 = await ask2(rl, `  Is this correct? (press Enter to confirm, or type your stack): `);
+    stack = confirm2.trim() || detected;
+  } else {
+    console.log("\n  No stack detected automatically.");
+    stack = await ask2(rl, "  Describe your tech stack (e.g. 'Next.js, Supabase, TypeScript'): ");
+    if (!stack.trim()) stack = "Not specified";
+  }
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const archContent = `# Architecture
+
+Your AI coding agent reads this before implementing features.
+Keep it up to date \u2014 it's how the agent knows how your system is built.
+
+## Stack
+
+${stack}
+
+## Decisions
+
+| Date | Decision | Rationale |
+|------|----------|-----------|
+| ${today} | Project initialised with intentdocs | Story-map-driven development |
+
+## Patterns
+
+_Document recurring patterns as you establish them._
+
+## Trade-offs
+
+_Record trade-offs and why._
+
+## Key files
+
+_Add important files and what they do as you build._
+`;
+  writeFileSync(archPath, archContent);
+  console.log(`  \u2713 Created ARCHITECTURE.md with your stack (edit it as you build)`);
+}
+async function initWithSyncToken(syncToken) {
+  if (!syncToken.startsWith("intent_sync_") && !syncToken.startsWith("pb_sync_") && !syncToken.startsWith("sc_sync_")) {
+    console.error("Invalid token. It should start with intent_sync_");
+    process.exit(1);
+  }
+  console.log("\nConnecting to intentdocs...");
+  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);
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    await setupFiles(config);
+    await setupStack(rl);
+  } finally {
+    rl.close();
+  }
+  console.log("\n\u2705 Ready! Try: intent status");
+}
+async function setupFiles(config) {
+  try {
+    const md = await getContext(config);
+    writeFileSync(join(process.cwd(), "INTENT.md"), md);
+    console.log("\u2713 Downloaded INTENT.md");
+  } catch {
+    console.warn("\u26A0 Could not download INTENT.md");
+  }
+  const gitignore = join(process.cwd(), ".gitignore");
+  if (existsSync(gitignore)) {
+    const content = readFileSync(gitignore, "utf-8");
+    if (!content.includes(".intent/")) {
+      appendFileSync(gitignore, "\n# intentdocs\n.intent/\n");
+      console.log("\u2713 Added .intent/ to .gitignore");
+    }
+  }
+  const cwd = process.cwd();
+  if (existsSync(join(cwd, "CLAUDE.md"))) {
+    const claudeMd = readFileSync(join(cwd, "CLAUDE.md"), "utf-8");
+    if (!claudeMd.includes("INTENT.md")) {
+      appendFileSync(
+        join(cwd, "CLAUDE.md"),
+        "\n\n# intentdocs\nRead INTENT.md for the product story map, personas, and backlog.\n"
+      );
+      console.log("\u2713 Added INTENT.md reference to CLAUDE.md");
+    }
+  }
+  if (existsSync(join(cwd, ".cursorrules"))) {
+    const rules = readFileSync(join(cwd, ".cursorrules"), "utf-8");
+    if (!rules.includes("INTENT.md")) {
+      appendFileSync(
+        join(cwd, ".cursorrules"),
+        "\n\nRead INTENT.md for the product story map, personas, and backlog.\n"
+      );
+      console.log("\u2713 Added INTENT.md reference to .cursorrules");
+    }
+  }
+}
+
+// src/commands/status.ts
+function timeAgo(iso) {
+  const diff = Date.now() - new Date(iso).getTime();
+  const mins = Math.floor(diff / 6e4);
+  if (mins < 2) return "just now";
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  return `${days}d ago`;
+}
+async function status() {
+  const config = requireConfig();
+  const [storiesData, activityRes] = await Promise.allSettled([
+    listStories(config),
+    apiFetch(config, "/activity")
+  ]);
+  if (storiesData.status === "rejected") throw storiesData.reason;
+  const data = storiesData.value;
+  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}%)`);
+  }
+  if (activityRes.status === "fulfilled" && activityRes.value.ok) {
+    const { activity } = await activityRes.value.json();
+    if (activity.length > 0) {
+      console.log("\n  Recent activity:");
+      for (const event of activity.slice(0, 5)) {
+        console.log(`    \xB7 ${event.summary}  (${timeAgo(event.created_at)})`);
+      }
+    }
+  }
+  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";
+import { writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/lib/verification-suggestions.ts
+function needsVerificationSuggestion(ac) {
+  return !(ac.verification?.method === "executable" && Boolean(ac.verification.command));
+}
+function buildVerificationSuggestionPrompt(title, userStory, criteria) {
+  const list = criteria.map((ac, i) => `${i + 1}. ${ac.text}${ac.verification ? ` (current method: ${ac.verification.method})` : ""}`).join("\n");
+  return `You are wiring up automatic verification for a user story's acceptance criteria.
+
+Story: ${title}
+${userStory ? `User story: ${userStory}
+` : ""}
+For each criterion below, decide whether it can be verified by running a real shell command (a test, a script, curl against a running server, a build check, etc). Bias toward "yes" whenever anything runnable applies \u2014 that's a stronger signal than a human/agent opinion.
+
+Criteria:
+${list}
+
+Return ONLY a JSON array, one entry per criterion in order, no markdown fences, no commentary:
+[
+  { "index": 1, "executable": true, "command": "npm test -- onboarding-redirect", "expected": "exit 0, all tests pass" },
+  { "index": 2, "executable": false, "reason": "requires eyeballing the rendered layout" }
+]`;
+}
+function parseVerificationSuggestions(raw) {
+  const cleaned = raw.replace(/```json\s*/g, "").replace(/```/g, "").trim();
+  let parsed;
+  try {
+    parsed = JSON.parse(cleaned);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  return parsed.filter((item) => {
+    if (typeof item !== "object" || item === null) return false;
+    const o = item;
+    if (typeof o.index !== "number" || typeof o.executable !== "boolean") return false;
+    if (o.executable) return typeof o.command === "string" && o.command.length > 0;
+    return true;
+  });
+}
+
+// src/commands/next.ts
+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);
+  let s;
+  if (opts.storyId) {
+    const match = data.stories.find((st) => st.id === opts.storyId || st.id.startsWith(opts.storyId));
+    if (!match) {
+      console.log(`
+  \u274C No story found matching ID: ${opts.storyId}
+`);
+      return;
+    }
+    s = match;
+  } else {
+    if (!opts.skipWip) {
+      const inProgress = data.stories.filter((st) => st.status === "in_progress");
+      if (inProgress.length > 0) {
+        console.log(`
+  \u26A0\uFE0F  You have ${inProgress.length} story${inProgress.length > 1 ? " stories" : ""} in progress:
+`);
+        for (const ip of inProgress) {
+          console.log(`    \u{1F528} ${ip.title}`);
+          console.log(`       ID: ${ip.id.slice(0, 8)} | Mark done: intent done ${ip.id.slice(0, 8)}`);
+        }
+        console.log(`
+  Finish those first, or run \`intent next --skip-wip\` to pick the next todo anyway.
+`);
+        return;
+      }
+    }
+    const doneIds = new Set(
+      data.stories.filter((st) => st.status === "done").map((st) => st.id)
+    );
+    const todos = data.stories.filter((st) => st.status === "todo").filter((st) => {
+      if (!st.depends_on?.length) return true;
+      return st.depends_on.every((depId) => doneIds.has(depId));
+    }).sort((a, b) => {
+      const aSeq = a.build_sequence ?? Infinity;
+      const bSeq = b.build_sequence ?? Infinity;
+      if (aSeq !== bSeq) return aSeq - bSeq;
+      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) {
+      const allTodos = data.stories.filter((st) => st.status === "todo");
+      if (allTodos.length > 0) {
+        console.log(`
+  \u{1F512} ${allTodos.length} stories remain but all have unfinished dependencies.`);
+        console.log(`  Finish in-progress stories first, then run \`intent next\` again.
+`);
+      } else {
+        console.log("\n  \u{1F389} All stories are done! Ship it.\n");
+      }
+      return;
+    }
+    s = todos[0];
+  }
+  const specUrl = `${config.apiBase}/storymapper/${data.map.id}?story=${s.id}`;
+  const hasPlan = s.implementation_plan?.status === "ready" && s.implementation_plan.markdown;
+  console.log(`
+  \u{1F4CB} Next 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}${s.build_sequence ? ` | Build step: ${s.build_sequence}` : ""}`);
+  if (s.acceptance_criteria.length > 0) {
+    console.log(`  Done when:`);
+    for (const ac of s.acceptance_criteria) {
+      console.log(`    \u2713 ${ac.text}`);
+    }
+  }
+  console.log(`
+  ID:   ${s.id}`);
+  console.log(`  Spec: ${specUrl}`);
+  if (hasPlan) {
+    console.log(`  Plan: \u2705 Implementation plan available`);
+  }
+  console.log(`
+  Start building: intent implement ${s.id.slice(0, 8)}
+`);
+  if (opts.open) {
+    openBrowser2(specUrl);
+  }
+  await shutdownCliAnalytics();
+}
+async function generateVerificationSuggestions(story, contextPath) {
+  const acs = story.acceptance_criteria;
+  const candidates = acs.filter(needsVerificationSuggestion);
+  if (acs.length === 0) {
+    console.log(`  \u26A0\uFE0F  No acceptance criteria \u2014 nothing to suggest verification for.
+`);
+    return;
+  }
+  if (candidates.length === 0) {
+    console.log(`  \u2713 Every criterion already has an executable command.
+`);
+    return;
+  }
+  const apiKey = process.env.ANTHROPIC_API_KEY;
+  if (!apiKey) {
+    console.log(`  \u26A0\uFE0F  ANTHROPIC_API_KEY not set \u2014 skipping verification suggestions.
+`);
+    return;
+  }
+  console.log(`  Suggesting verification commands for ${candidates.length} criteri${candidates.length !== 1 ? "a" : "on"}\u2026`);
+  const prompt = buildVerificationSuggestionPrompt(story.title, story.user_story, candidates);
+  let raw;
+  try {
+    const res = await fetch("https://api.anthropic.com/v1/messages", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey,
+        "anthropic-version": "2023-06-01"
+      },
+      body: JSON.stringify({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 1024,
+        messages: [{ role: "user", content: prompt }]
+      })
+    });
+    if (!res.ok) {
+      console.log(`  \u26A0\uFE0F  Anthropic API error (${res.status}) \u2014 suggestion generation skipped.
+`);
+      return;
+    }
+    const json = await res.json();
+    raw = json.content.find((c) => c.type === "text")?.text ?? "";
+  } catch {
+    console.log(`  \u26A0\uFE0F  Network error \u2014 suggestion generation skipped.
+`);
+    return;
+  }
+  const suggestions = parseVerificationSuggestions(raw);
+  if (suggestions.length === 0) {
+    console.log(`  \u26A0\uFE0F  Couldn't parse a usable response from Anthropic \u2014 suggestion generation skipped.
+`);
+    return;
+  }
+  const lines = [`# Suggested verification commands: ${story.title}`, ``, `_Generated by \`intent next --stub\` \u2014 copy into the criterion's command field, or run \`intent check\` once wired up._`, ``];
+  console.log();
+  for (const suggestion of suggestions) {
+    const ac = candidates[suggestion.index - 1];
+    if (!ac) continue;
+    if (suggestion.executable && suggestion.command) {
+      console.log(`  \u2192 ${ac.text}`);
+      console.log(`    command: ${suggestion.command}${suggestion.expected ? `  (expect: ${suggestion.expected})` : ""}`);
+      lines.push(`- **${ac.text}**`, `  - command: \`${suggestion.command}\``, ...suggestion.expected ? [`  - expected: ${suggestion.expected}`] : [], ``);
+    } else {
+      console.log(`  \u2192 ${ac.text}`);
+      console.log(`    not executable${suggestion.reason ? `: ${suggestion.reason}` : ""}`);
+      lines.push(`- **${ac.text}**`, `  - not executable${suggestion.reason ? `: ${suggestion.reason}` : ""}`, ``);
+    }
+  }
+  const suggestionsPath = contextPath.replace(/\.md$/, ".checks.md");
+  writeFileSync2(suggestionsPath, lines.join("\n"));
+  const relPath = suggestionsPath.replace(join2(process.cwd(), "/"), "");
+  console.log(`
+  \u2713 Suggestions written: ${relPath}
+`);
+}
+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/implement.ts
+async function implement(storyId, opts = {}) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const match = data.stories.find(
+    (st) => st.id === storyId || st.id.startsWith(storyId)
+  );
+  if (!match) {
+    console.log(`
+  \u274C No story found matching ID: ${storyId}
+`);
+    return;
+  }
+  const s = match;
+  const specUrl = `${config.apiBase}/storymapper/${data.map.id}?story=${s.id}`;
+  if (s.status === "done") {
+    console.log(`
+  \u2705 "${s.title}" is already done.
+`);
+    return;
+  }
+  if (s.status === "in_progress") {
+    console.log(`
+  \u{1F528} "${s.title}" is already in progress.`);
+    console.log(`     Mark done: intent done ${s.id.slice(0, 8)}
+`);
+    return;
+  }
+  const doneIds = new Set(
+    data.stories.filter((st) => st.status === "done").map((st) => st.id)
+  );
+  if (s.depends_on?.length) {
+    const blocked = s.depends_on.filter((depId) => !doneIds.has(depId));
+    if (blocked.length > 0) {
+      console.log(`
+  \u{1F512} "${s.title}" is blocked by ${blocked.length} unfinished dependenc${blocked.length > 1 ? "ies" : "y"}:`);
+      for (const depId of blocked) {
+        const dep = data.stories.find((st) => st.id === depId);
+        console.log(`     - ${dep ? dep.title : depId.slice(0, 8)} (${dep?.status ?? "unknown"})`);
+      }
+      console.log(`
+  Finish those first.
+`);
+      return;
+    }
+  }
+  if (s.effort === "XL") {
+    const acCount = s.acceptance_criteria.length;
+    console.log(`
+  \u250C\u2500 High complexity story \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\u2510`);
+    console.log(`  \u2502                                                       \u2502`);
+    console.log(`  \u2502  This story is sized XL \u2014 it may benefit from        \u2502`);
+    console.log(`  \u2502  breaking it into smaller pieces before starting.     \u2502`);
+    console.log(`  \u2502                                                       \u2502`);
+    if (acCount === 0) {
+      console.log(`  \u2502  \u26A0\uFE0F  No acceptance criteria defined \u2014 the agent       \u2502`);
+      console.log(`  \u2502     won't know what "done" looks like.               \u2502`);
+    } else {
+      console.log(`  \u2502  \u2713  ${acCount} acceptance criteri${acCount !== 1 ? "a" : "on"} defined.                    \u2502`);
+    }
+    console.log(`  \u2502                                                       \u2502`);
+    console.log(`  \u2502  Consider:                                            \u2502`);
+    console.log(`  \u2502    intent sync --context   refresh CLAUDE.md first      \u2502`);
+    console.log(`  \u2514\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\u2500\u2500\u2500\u2518
+`);
+    const proceed = await confirm("  Assign this story and mark in progress?");
+    if (!proceed) {
+      console.log(`
+  Skipped.
+`);
+      closePrompt();
+      return;
+    }
+  }
+  if (s.acceptance_criteria.length === 0) {
+    console.log(`
+  \u26A0\uFE0F  No acceptance criteria defined for this story.
+
+  Your AI agent won't know what "done" looks like \u2014 it will
+  have to guess, which leads to incomplete or misaligned work.
+
+  Add acceptance criteria before starting:
+    \u2192 ${specUrl}
+`);
+  }
+  try {
+    await updateStories(config, [{ id: s.id, status: "in_progress", cancelled_at: null }]);
+  } catch {
+  }
+  const contextPath = writeStoryContext(s);
+  const relPath = contextPath.replace(process.cwd() + "/", "");
+  const effortToComplexity = (e) => e === "XL" || e === "L" ? "high" : e === "M" ? "med" : "low";
+  captureCli(
+    "story_started",
+    {
+      story_id: s.id,
+      complexity: effortToComplexity(s.effort),
+      has_eval_stub: false,
+      context_loaded: true
+    },
+    { project: config.projectId }
+  );
+  console.log(`
+  \u{1F528} Picked up: ${s.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`);
+  console.log(`  Activity: ${s.activity}`);
+  console.log(`  Priority: ${s.priority} | Effort: ${s.effort} | Release: ${s.release}${s.build_sequence ? ` | Build step: ${s.build_sequence}` : ""}`);
+  console.log(`  Context: ${relPath}`);
+  console.log(`  Spec:    ${specUrl}`);
+  console.log(`  Mark done: intent done ${s.id.slice(0, 8)}
+`);
+  if (opts.stub) {
+    await generateVerificationSuggestions(s, contextPath);
+  }
+  await shutdownCliAnalytics();
+}
+
+// src/commands/done.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+
+// src/lib/screenshot.ts
+import { createRequire } from "module";
+import { pathToFileURL } from "url";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { extname, join as join3 } from "path";
+var MAX_BYTES = 5 * 1024 * 1024;
+var EXT_MIME = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp"
+};
+async function loadPlaywright() {
+  try {
+    const req = createRequire(join3(process.cwd(), "package.json"));
+    const resolved = req.resolve("playwright");
+    return await import(pathToFileURL(resolved).href);
+  } catch {
+    return null;
+  }
+}
+function readScreenshotFile(path) {
+  if (!existsSync2(path)) {
+    console.error(`  Screenshot file not found: ${path}`);
+    return null;
+  }
+  const ext = extname(path).toLowerCase();
+  const mimeType = EXT_MIME[ext];
+  if (!mimeType) {
+    console.error(`  Unsupported screenshot type "${ext}" \u2014 use .png, .jpg, or .webp`);
+    return null;
+  }
+  const buffer = readFileSync2(path);
+  if (buffer.length > MAX_BYTES) {
+    console.error(`  Screenshot too large (${(buffer.length / 1024 / 1024).toFixed(1)}MB, max 5MB)`);
+    return null;
+  }
+  return { buffer, mimeType, filename: `screenshot${ext}` };
+}
+async function captureScreenshot(appUrl) {
+  const playwright = await loadPlaywright();
+  if (!playwright) {
+    console.log(
+      "  \u21B3 Screenshot skipped: playwright not found. Run `npm i -D playwright` in this project to enable auto-capture, or pass --screenshot <path>."
+    );
+    return null;
+  }
+  let browser = null;
+  try {
+    browser = await playwright.chromium.launch({ headless: true });
+    const page = await browser.newPage();
+    await page.goto(appUrl, { timeout: 1e4, waitUntil: "load" });
+    const buffer = await page.screenshot({ type: "png" });
+    if (buffer.length > MAX_BYTES) {
+      console.log("  \u21B3 Screenshot skipped: capture exceeded the 5MB limit.");
+      return null;
+    }
+    return { buffer, mimeType: "image/png", filename: "screenshot.png" };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "capture failed";
+    console.log(`  \u21B3 Screenshot skipped: ${message}`);
+    return null;
+  } finally {
+    await browser?.close().catch(() => void 0);
+  }
+}
+
+// src/commands/done.ts
+function extractImplementationContext(storyId) {
+  const path = storyContextPath(storyId);
+  if (!existsSync3(path)) return { summary: null, files: [] };
+  const content = readFileSync3(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 passesCriteriaGuard(story) {
+  if (story.acceptance_criteria.length === 0) return { proceed: true, forced: false };
+  console.log();
+  console.log("  Acceptance criteria:");
+  for (const ac of story.acceptance_criteria) {
+    console.log(`    [${criterionPriority(ac)}] [${criterionStatusLabel(ac)}] ${ac.text}`);
+  }
+  const blocking = findBlockingMusts(story.acceptance_criteria);
+  if (blocking.length === 0) return { proceed: true, forced: false };
+  console.log();
+  console.log(`  ${blocking.length} 'must' criterion/criteria still failing or unreported:`);
+  for (const ac of blocking) {
+    console.log(`    - [${criterionStatusLabel(ac)}] ${ac.text}`);
+  }
+  console.log();
+  const proceed = await confirm("  Mark done anyway?");
+  return { proceed, forced: proceed };
+}
+async function done(idPrefix, opts = {}) {
+  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 guard = await passesCriteriaGuard(match);
+  if (!guard.proceed) {
+    closePrompt();
+    return;
+  }
+  const { summary, files } = extractImplementationContext(match.id);
+  const captured = opts.screenshot ? readScreenshotFile(opts.screenshot) : config.appUrl ? await captureScreenshot(config.appUrl) : null;
+  let screenshotUrl;
+  if (captured) {
+    const uploaded = await uploadScreenshot(config, match.id, captured);
+    if (uploaded) {
+      screenshotUrl = uploaded.url;
+    } else {
+      console.error("  Failed to upload screenshot (continuing without it).");
+    }
+  }
+  const update = { id: match.id, status: "done" };
+  if (guard.forced) update.forced = true;
+  if (summary) update.implementation_summary = summary;
+  if (files.length > 0) update.implemented_files = files;
+  if (screenshotUrl) update.screenshot_url = screenshotUrl;
+  const result = await updateStories(config, [update]);
+  const effortToComplexity = (e) => e === "XL" || e === "L" ? "high" : e === "M" ? "med" : "low";
+  captureCli(
+    "story_shipped",
+    {
+      story_id: match.id,
+      complexity: effortToComplexity(match.effort),
+      context_loaded: summary !== null,
+      acceptance_criteria_count: match.acceptance_criteria.length,
+      eval_stub_generated: false,
+      cycle_time_hours: 0
+    },
+    { project: config.projectId }
+  );
+  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`);
+  if (screenshotUrl) console.log(`   \u21B3 Screenshot attached`);
+  for (const release of result.completedReleases ?? []) {
+    console.log();
+    console.log(`\u{1F680} Release shipped: ${release.label} (${release.storyCount} stories)`);
+  }
+  console.log();
+  const wantsDecision = await confirm("  Log a decision or lesson from this story?");
+  if (wantsDecision) {
+    const title = await ask("  Decision title: ");
+    const description = await ask("  What was decided / learned: ");
+    if (title.trim() && description.trim()) {
+      const res = await apiFetch(config, "/decisions", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          title: title.trim(),
+          description: description.trim(),
+          category: "technical",
+          story_id: match.id
+        })
+      });
+      if (res.ok) {
+        console.log(`  \u2713 Decision logged: "${title.trim()}"`);
+        captureCli(
+          "decision_logged",
+          {
+            trigger: "stc_done",
+            story_id: match.id,
+            has_lesson: description.trim().length > 0
+          },
+          { project: config.projectId }
+        );
+      } else {
+        console.error("  Failed to log decision.");
+      }
+    }
+  }
+  apiFetch(config, "/activity", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      event_type: "story_done",
+      summary: `Marked done: ${match.title}`,
+      metadata: { story_id: match.id, ...screenshotUrl ? { screenshot_url: screenshotUrl } : {} },
+      source: "cli"
+    })
+  }).catch(() => void 0);
+  await shutdownCliAnalytics();
+  closePrompt();
+}
+
+// src/commands/stop.ts
+async function stop(storyId) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const match = data.stories.find(
+    (st) => st.id === storyId || st.id.startsWith(storyId)
+  );
+  if (!match) {
+    console.log(`
+  \u274C No story found matching ID: ${storyId}
+`);
+    return;
+  }
+  if (match.status !== "in_progress") {
+    console.log(`
+  \u26A0\uFE0F  "${match.title}" is not in progress (status: ${match.status}).
+`);
+    return;
+  }
+  await updateStories(config, [
+    { id: match.id, status: "todo", cancelled_at: (/* @__PURE__ */ new Date()).toISOString() }
+  ]);
+  console.log(`
+  \u{1F6D1} Stopped: ${match.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`);
+  console.log(`  Status reset to todo. Any agent working on this story`);
+  console.log(`  will detect the cancellation and stop.
+`);
+  await shutdownCliAnalytics();
+}
+
+// src/lib/run-criterion.ts
+import { execSync as execSync2 } from "child_process";
+var MAX_DETAIL_LENGTH = 1e3;
+var DEFAULT_TIMEOUT_MS = 3e4;
+function truncate(text) {
+  const trimmed = text.trim();
+  return trimmed.length > MAX_DETAIL_LENGTH ? `${trimmed.slice(0, MAX_DETAIL_LENGTH)}
+\u2026 (truncated)` : trimmed;
+}
+function runExecutableCriterion(command, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  try {
+    const output2 = execSync2(command, {
+      encoding: "utf-8",
+      timeout: timeoutMs,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    return { status: "pass", detail: truncate(output2) || "exit 0" };
+  } catch (err) {
+    const e = err;
+    const combined = [e.stdout, e.stderr].filter(Boolean).map(String).join("\n").trim();
+    const reason = e.signal === "SIGTERM" ? `timed out after ${timeoutMs}ms` : `exit ${e.status ?? "unknown"}`;
+    return { status: "fail", detail: truncate(combined || reason || e.message || "unknown error") };
+  }
+}
+
+// src/commands/check.ts
+var METHOD_LABELS = {
+  executable: "executable",
+  agent_self_check: "self-check",
+  visual_render: "visual",
+  founder_confirm: "founder"
+};
+function methodLabel(ac) {
+  return ac.verification ? METHOD_LABELS[ac.verification.method] ?? ac.verification.method : "founder";
+}
+function isRunnable(ac) {
+  return ac.verification?.method === "executable" && Boolean(ac.verification.command);
+}
+function resolveStory(stories2, idPrefix) {
+  if (idPrefix) {
+    const story = stories2.find((s) => s.id.startsWith(idPrefix));
+    return story ? { story } : { error: `No story found matching "${idPrefix}"` };
+  }
+  const inProgress = stories2.filter((s) => s.status === "in_progress");
+  if (inProgress.length === 1) return { story: inProgress[0] };
+  return {
+    error: inProgress.length === 0 ? "No story in progress. Specify one: intent check <idPrefix>" : `${inProgress.length} stories in progress \u2014 specify one: intent check <idPrefix>`
+  };
+}
+async function check(idPrefix, opts = {}) {
+  const config = requireConfig();
+  const data = await listStories(config);
+  const { story, error } = resolveStory(data.stories, idPrefix);
+  if (!story) {
+    console.error(error);
+    process.exitCode = 1;
+    return;
+  }
+  if (story.acceptance_criteria.length === 0) {
+    console.log(`
+  ${story.title} has no acceptance criteria.
+`);
+    return;
+  }
+  console.log(`
+  Checking: ${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`);
+  const toReport = [];
+  let anyFail = false;
+  for (const ac of story.acceptance_criteria) {
+    const priority = criterionPriority(ac);
+    const method = methodLabel(ac);
+    if (isRunnable(ac)) {
+      const result = runExecutableCriterion(ac.verification.command);
+      if (result.status === "fail") anyFail = true;
+      const icon = result.status === "pass" ? "\u2705" : "\u274C";
+      console.log(`  ${icon} [${priority}][${method}] ${ac.text}`);
+      if (result.status === "fail") {
+        console.log(`       ${result.detail.split("\n")[0]}`);
+      }
+      toReport.push({ criterion_id: ac.id, status: result.status, detail: result.detail, reported_by: "human" });
+    } else {
+      console.log(`  \u2B1C [${priority}][${method}] ${ac.text} \u2014 manual`);
+    }
+  }
+  console.log();
+  if (opts.report) {
+    if (toReport.length === 0) {
+      console.log(`  No executable results to report.
+`);
+    } else {
+      await reportCriteria(config, story.id, toReport);
+      console.log(`  \u2713 Reported ${toReport.length} result(s) to the story map.
+`);
+    }
+  }
+  if (anyFail) process.exitCode = 1;
+}
+
+// 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("intentdocs")}
+   ${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 apiFetch2(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 apiFetch2(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: intent 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 apiFetch2("/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 apiFetch2("/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 intentdocs.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: intent 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: intent 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 intentdocs 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 apiFetch2(
+          `/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: intent scope ${projectId}
+    \u2022 Or visit: ${API_BASE}
+
+  Your project is saved and waiting for you.
+    `);
+    closePrompt();
+    return;
+  }
+  const { scope: scope2 } = await import("./scope-OGKQ472D.js");
+  await scope2(projectId);
+}
+
+// src/commands/propose.ts
+import { mkdirSync, writeFileSync as writeFileSync3, readFileSync as readFileSync4, existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
+async function propose(changeName, opts = {}) {
+  requireAuth();
+  if (!hasConfig()) {
+    console.log("  Not connected to a project. Run `intent 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 = join4(process.cwd(), "intent-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 ? ` <!-- INTENT-${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(join4(changesDir, "proposal.md"), proposalMd);
+  console.log(`  \u2713 Saved intent-changes/${slug}/proposal.md`);
+  const gitignorePath = join4(process.cwd(), ".gitignore");
+  if (existsSync4(gitignorePath)) {
+    const { readFileSync: readFileSync5, appendFileSync: appendFileSync2 } = await import("fs");
+    const gi = readFileSync5(gitignorePath, "utf-8");
+    if (!gi.includes("intent-changes")) {
+      appendFileSync2(gitignorePath, "\n# intentdocs local change proposals\nstc-changes/\n");
+    }
+  }
+  console.log(`
+  \u2705 Proposal "${changeName}" ready!
+
+  Stories created in your story map \u2014 view them at intentdocs.com
+  Local spec saved at: intent-changes/${slug}/proposal.md
+
+  Next:
+    intent next           \u2014 pick up the first story
+    intent status         \u2014 see full progress
+    intent sync           \u2014 refresh INTENT.md
+  `);
+  closePrompt();
+}
+function parseProposalFile(filePath) {
+  const raw = readFileSync4(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 = join4(process.cwd(), "intent-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 ? ` <!-- INTENT-${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(join4(changesDir, "proposal.md"), proposalMd);
+  console.log(`  \u2713 Saved intent-changes/${slug}/proposal.md`);
+  console.log(`
+  \u2705 Done! Run \`intent 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 \`intent 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 check2 = ac.done ? "\u2611" : "\u2610";
+      console.log(`    ${check2} ${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: intent done ${story.id.slice(0, 8)}
+`);
+}
+
+// src/commands/example.ts
+import * as readline from "readline/promises";
+import { stdin as input, stdout as output } from "process";
+async function example() {
+  const config = requireConfig();
+  const rl = readline.createInterface({ input, output });
+  console.log("\n  Add a reference pattern (few-shot example)\n");
+  try {
+    const title = (await rl.question("  Title: ")).trim();
+    if (!title) {
+      console.error("  \u2717 Title is required.");
+      process.exit(1);
+    }
+    const description = (await rl.question("  Description (optional): ")).trim();
+    const LANGUAGES = ["typescript", "javascript", "python", "bash", "sql", "other"];
+    console.log(`
+  Language options: ${LANGUAGES.join(", ")}`);
+    const langInput = (await rl.question("  Language [typescript]: ")).trim().toLowerCase();
+    const language = LANGUAGES.includes(langInput) ? langInput : "typescript";
+    console.log("\n  Before code (paste, then press Enter twice to finish):");
+    const beforeCode = await readMultiline(rl);
+    console.log("\n  After code (paste, then press Enter twice to finish):");
+    const afterCode = await readMultiline(rl);
+    rl.close();
+    const res = await apiFetch(config, "/examples", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        title,
+        description: description || void 0,
+        language,
+        before_code: beforeCode || void 0,
+        after_code: afterCode || void 0
+      })
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      console.error(`
+  \u2717 Failed to save example (${res.status}): ${body}`);
+      process.exit(1);
+    }
+    const data = await res.json();
+    console.log(`
+  \u2713 Example saved: "${data.title}"
+`);
+    console.log("  Run `intent sync --context` to regenerate your CLAUDE.md with this pattern.\n");
+  } catch {
+    rl.close();
+    throw new Error("Aborted");
+  }
+}
+async function readMultiline(rl) {
+  const lines = [];
+  let emptyCount = 0;
+  while (emptyCount < 1) {
+    const line = await rl.question("");
+    if (line === "") {
+      emptyCount++;
+    } else {
+      emptyCount = 0;
+      lines.push(line);
+    }
+  }
+  return lines.join("\n");
+}
+
+// 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,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+var TOOLS = [
+  // ── Core tools (~5k tokens) ──────────────────────────────────────────────
+  {
+    name: "list_stories",
+    description: "List all stories from the intentdocs 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 intentdocs story map. Use the story ID from list_stories. If any 'must' acceptance criterion is failing or has never been reported via report_criteria, this returns that list instead of completing \u2014 fix and re-check, or pass force:true to override.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID (full UUID or prefix)" },
+        force: {
+          type: "boolean",
+          description: "Mark done even if must criteria are failing or unreported"
+        }
+      },
+      required: ["story_id"]
+    },
+    mode: "core"
+  },
+  {
+    name: "report_criteria",
+    description: "Report pass/fail/blocked results for one or more acceptance criteria on a story, after implementing and evaluating each one. This is the acceptance-criteria loop's feedback channel \u2014 results flow back to the story map so criteria flip green there.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID (full UUID or prefix)" },
+        results: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              criterion_id: { type: "string", description: "The criterion ID from list_stories" },
+              status: { type: "string", enum: ["pass", "fail", "blocked"] },
+              detail: { type: "string", description: "What you observed \u2014 the evidence for this result" },
+              attempt: {
+                type: "number",
+                description: "Which attempt this is, if retrying a failing must criterion"
+              }
+            },
+            required: ["criterion_id", "status"]
+          }
+        }
+      },
+      required: ["story_id", "results"]
+    },
+    mode: "core"
+  },
+  {
+    name: "raise_blocker",
+    description: "Raise a blocker on a story when a 'must' criterion keeps failing after repeated fix attempts (3 strikes). Surfaces the single decision the founder needs to make. Stop implementing this story once you call this \u2014 do not call mark_done afterward.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        story_id: { type: "string", description: "The story ID (full UUID or prefix)" },
+        criterion_id: { type: "string", description: "Optional: the specific criterion that's blocked" },
+        summary: { type: "string", description: "Short summary of the blocker" },
+        attempting: { type: "string", description: "What you were trying to do" },
+        failing: { type: "string", description: "What's failing and why" },
+        decision_needed: { type: "string", description: "The single decision the founder needs to make" },
+        attempts: { type: "number", description: "How many fix attempts were made" }
+      },
+      required: ["story_id", "summary", "attempting", "failing", "decision_needed"]
+    },
+    mode: "core"
+  },
+  {
+    name: "mark_in_progress",
+    description: "Mark a story as in progress on the intentdocs 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 intentdocs 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 INTENT.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 intentdocs 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 handleToolCall(name, args, config) {
+  const guardExempt = /* @__PURE__ */ new Set(["list_stories", "get_status"]);
+  if (!guardExempt.has(name)) {
+    const storyId = args?.story_id;
+    if (storyId) {
+      const data = await listStories(config);
+      const match = data.stories.find((s) => s.id.startsWith(storyId));
+      if (match?.cancelled_at) {
+        return {
+          content: [{
+            type: "text",
+            text: `\u{1F6D1} Development of "${match.title}" was cancelled at ${match.cancelled_at}. Stop all work on this story immediately. Do not make any more changes.`
+          }]
+        };
+      }
+    }
+  }
+  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_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}"` }] };
+      await updateStories(config, [{ id: match.id, status: "in_progress" }]);
+      return {
+        content: [{ type: "text", text: `\u2713 ${match.title} \u2192 in_progress` }]
+      };
+    }
+    case "mark_done": {
+      const storyId = args?.story_id;
+      if (!storyId) return { content: [{ type: "text", text: "story_id is required" }] };
+      const force = args?.force === true;
+      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 blocking = findBlockingMusts(match.acceptance_criteria);
+      if (!force && blocking.length > 0) {
+        const list = blocking.map((ac) => `  - [${ac.last_result ? ac.last_result.status : "unreported"}] ${ac.text}`).join("\n");
+        return {
+          content: [{
+            type: "text",
+            text: `Can't mark done \u2014 ${blocking.length} 'must' criterion/criteria still failing or unreported:
+${list}
+
+Fix and call report_criteria, or call mark_done again with force:true to override.`
+          }]
+        };
+      }
+      const forced = force && blocking.length > 0;
+      await updateStories(config, [{ id: match.id, status: "done", ...forced ? { forced: true } : {} }]);
+      return {
+        content: [{ type: "text", text: `\u2713 ${match.title} \u2192 done` }]
+      };
+    }
+    case "report_criteria": {
+      const storyId = args?.story_id;
+      const results = args?.results;
+      if (!storyId || !results?.length) {
+        return { content: [{ type: "text", text: "story_id and results are 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 result = await reportCriteria(
+        config,
+        match.id,
+        results
+      );
+      const passCount = results.filter((r) => r.status === "pass").length;
+      const failCount = results.filter((r) => r.status !== "pass").length;
+      const unmatchedNote = result.unmatched.length ? ` (${result.unmatched.length} criterion_id(s) not found on this story: ${result.unmatched.join(", ")})` : "";
+      return {
+        content: [{
+          type: "text",
+          text: `\u2713 Reported ${passCount + failCount} result(s) for ${match.title}: ${passCount} passed, ${failCount} not passed${unmatchedNote}`
+        }]
+      };
+    }
+    case "raise_blocker": {
+      const storyId = args?.story_id;
+      const summary = args?.summary;
+      const attempting = args?.attempting;
+      const failing = args?.failing;
+      const decisionNeeded = args?.decision_needed;
+      if (!storyId || !summary || !attempting || !failing || !decisionNeeded) {
+        return {
+          content: [{
+            type: "text",
+            text: "story_id, summary, attempting, failing, and decision_needed are 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 raiseBlocker(config, {
+        story_id: match.id,
+        criterion_id: args?.criterion_id,
+        summary,
+        attempting,
+        failing,
+        decision_needed: decisionNeeded,
+        attempts: args?.attempts
+      });
+      return {
+        content: [{
+          type: "text",
+          text: `\u{1F6A7} Blocker raised on ${match.title}: ${summary}
+Decision needed: ${decisionNeeded}`
+        }]
+      };
+    }
+    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;
+      let text = `${data.map.title}: ${summary.done}/${summary.total} done (${pct}%) \u2014 ${summary.in_progress} in progress, ${summary.todo} todo`;
+      const cancelled = data.stories.filter((s) => s.cancelled_at);
+      if (cancelled.length > 0) {
+        text += `
+
+\u{1F6D1} CANCELLED STORIES (stop all work on these):
+` + cancelled.map((s) => `  - "${s.title}" (${s.id.slice(0, 8)}) cancelled at ${s.cancelled_at}`).join("\n");
+      }
+      return {
+        content: [{ type: "text", text }]
+      };
+    }
+    case "log_decision": {
+      const res = await apiFetch(config, "/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 apiFetch(config, "/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(apiUrl(config, "/complexity"), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      if (!res.ok) {
+        if (isPlanGated(res.status)) {
+          return { content: [{ type: "text", text: UPGRADE_MESSAGE_PLAIN }] };
+        }
+        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(apiUrl(config, "/research"), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ query })
+      });
+      if (!res.ok) {
+        if (isPlanGated(res.status)) {
+          return { content: [{ type: "text", text: UPGRADE_MESSAGE_PLAIN }] };
+        }
+        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(apiUrl(config, "/import"), {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ prd, format: args?.format ?? "PRD" })
+      });
+      if (!res.ok) {
+        if (isPlanGated(res.status)) {
+          return { content: [{ type: "text", text: UPGRADE_MESSAGE_PLAIN }] };
+        }
+        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}` }] };
+  }
+}
+var RESOURCES = [
+  {
+    uri: "intentdocs://project/storymap",
+    name: "Story Map",
+    description: "Full story map with personas, activities, stories, and acceptance criteria",
+    mimeType: "text/markdown"
+  },
+  {
+    uri: "intentdocs://project/stories",
+    name: "Stories",
+    description: "All stories with status, priority, effort, and acceptance criteria",
+    mimeType: "application/json"
+  },
+  {
+    uri: "intentdocs://project/status",
+    name: "Project Status",
+    description: "Progress summary \u2014 done/in-progress/todo counts",
+    mimeType: "application/json"
+  },
+  {
+    uri: "intentdocs://project/decisions",
+    name: "Decisions",
+    description: "Architectural and product decisions logged during development",
+    mimeType: "application/json"
+  },
+  {
+    uri: "intentdocs://project/data-model",
+    name: "Data Model",
+    description: "Data model and schema definitions from the spec",
+    mimeType: "application/json"
+  },
+  {
+    uri: "intentdocs://project/build-order",
+    name: "Build Order",
+    description: "Recommended story implementation order based on dependencies",
+    mimeType: "application/json"
+  }
+];
+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: "intentdocs", version: "0.2.0" },
+    { capabilities: { tools: {}, resources: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: activeTools.map(({ mode: _m, ...rest }) => rest)
+  }));
+  server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: RESOURCES.map(({ uri, name, description, mimeType }) => ({
+      uri,
+      name,
+      description,
+      mimeType
+    }))
+  }));
+  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    try {
+      if (uri === "intentdocs://project/storymap") {
+        const text = await getContext(config);
+        return {
+          contents: [{ uri, mimeType: "text/markdown", text }]
+        };
+      }
+      if (uri === "intentdocs://project/stories") {
+        const data = await listStories(config);
+        const text = JSON.stringify({ summary: data.summary, stories: data.stories }, null, 2);
+        return {
+          contents: [{ uri, mimeType: "application/json", text }]
+        };
+      }
+      if (uri === "intentdocs://project/status") {
+        const data = await listStories(config);
+        const { summary, map: map2 } = data;
+        const pct = summary.total > 0 ? Math.round(summary.done / summary.total * 100) : 0;
+        const text = JSON.stringify(
+          {
+            map_title: map2.title,
+            progress: `${summary.done}/${summary.total} done (${pct}%)`,
+            done: summary.done,
+            in_progress: summary.in_progress,
+            todo: summary.todo,
+            total: summary.total
+          },
+          null,
+          2
+        );
+        return {
+          contents: [{ uri, mimeType: "application/json", text }]
+        };
+      }
+      if (uri === "intentdocs://project/decisions") {
+        const res = await fetch(apiUrl(config, "/decisions"));
+        if (!res.ok) {
+          const text2 = JSON.stringify({ note: "Failed to fetch decisions" });
+          return { contents: [{ uri, mimeType: "application/json", text: text2 }] };
+        }
+        const data = await res.json();
+        const text = JSON.stringify(data, null, 2);
+        return {
+          contents: [{ uri, mimeType: "application/json", text }]
+        };
+      }
+      if (uri === "intentdocs://project/data-model") {
+        const res = await fetch(apiUrl(config, "/data-model"));
+        let data;
+        if (res.status === 404) {
+          data = { note: "No data model defined yet. Run the interview or add one via the web UI." };
+        } else if (res.ok) {
+          data = await res.json();
+        } else {
+          data = { note: "Failed to fetch data model" };
+        }
+        const text = JSON.stringify(data, null, 2);
+        return {
+          contents: [{ uri, mimeType: "application/json", text }]
+        };
+      }
+      if (uri === "intentdocs://project/build-order") {
+        const res = await fetch(apiUrl(config, "/build-order"));
+        let data;
+        if (res.status === 404) {
+          data = { note: "No build order defined yet." };
+        } else if (res.ok) {
+          data = await res.json();
+        } else {
+          data = { note: "Failed to fetch build order" };
+        }
+        const text = JSON.stringify(data, null, 2);
+        return {
+          contents: [{ uri, mimeType: "application/json", text }]
+        };
+      }
+      return {
+        contents: [{ uri, mimeType: "text/plain", text: `Unknown resource: ${uri}` }]
+      };
+    } catch (error) {
+      const text = JSON.stringify({
+        error: error instanceof Error ? error.message : "Unknown error reading resource"
+      });
+      return {
+        contents: [{ uri, mimeType: "application/json", text }]
+      };
+    }
+  });
+  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.`
+        }]
+      };
+    }
+    return handleToolCall(name, args, config);
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+// src/commands/openclaw-register.ts
+import { execSync as execSync3 } from "child_process";
+async function openclawRegister() {
+  if (!hasConfig()) {
+    console.error("Not initialised. Run: intent init");
+    process.exit(1);
+  }
+  const config = readConfig();
+  const cwd = process.cwd();
+  const mapTitle = config?.mapTitle ?? "this project";
+  const registration = JSON.stringify({
+    command: "npx",
+    args: ["intentdocs", "mcp"],
+    cwd
+  });
+  console.log(`
+Registering intentdocs MCP with OpenClaw...`);
+  console.log(`  Project : ${mapTitle}`);
+  console.log(`  cwd     : ${cwd}
+`);
+  try {
+    execSync3(`openclaw mcp set intentdocs '${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 intentdocs '${registration}'
+`);
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+var require2 = createRequire2(import.meta.url);
+var { version } = require2("../package.json");
+var program = new Command();
+program.name("intent").description("Write specs, map stories, ship with AI \u2014 from your terminal").version(version);
+program.command("login").description("Log in to intentdocs (opens browser)").action(() => void login());
+program.command("logout").description("Log out of intentdocs").action(() => void logout());
+var keys = program.command("keys").description("Manage your Anthropic API key \u2014 unlock AI features on any plan");
+keys.command("set [key]").description("Save your Anthropic API key (prompts if omitted)").action((key) => {
+  import("./keys-EDWET3WG.js").then((m) => void m.keysSet(key));
+});
+keys.command("status").description("Show whether a key is set (masked)").action(() => {
+  import("./keys-EDWET3WG.js").then((m) => void m.keysStatus());
+});
+keys.command("remove").description("Remove your stored key").action(() => {
+  import("./keys-EDWET3WG.js").then((m) => void m.keysRemove());
+});
+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 intentdocs 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: intent templates <name>
+`);
+  } else {
+    const tmpl = templates[name];
+    if (!tmpl) {
+      console.error(`Unknown template: "${name}". Run \`intent 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 intentdocs story map").action((token) => void init(token));
+program.command("sync").description("Refresh INTENT.md from the live story map").option("--context", "Refresh only the CLAUDE.md/AGENTS.md context file (not stories)").action((opts) => void sync(opts));
+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", "Show next todo even if stories are in progress").option("--story-id <id>", "Show a specific story by ID").action((opts) => void next(opts));
+program.command("implement <id>").description("Pick up a story and mark it in-progress").option("--stub", "Suggest verification commands for acceptance criteria (requires ANTHROPIC_API_KEY)").action((id, opts) => void implement(id, opts));
+program.command("check [idPrefix]").description("Run executable acceptance criteria locally and print pass/fail (defaults to the in-progress story)").option("--report", "Report results back to the story map (reported_by: human)").action((idPrefix, opts) => void check(idPrefix, 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)").option("--screenshot <path>", "Attach a screenshot of the product from an image file").action((id, opts) => void done(id, opts));
+program.command("stop <id>").description("Stop development of an in-progress story (resets to todo, signals agents to stop)").action((id) => void stop(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-TT2UCJP7.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-TT2UCJP7.js").then((m) => void m.logNote(storyId, note));
+});
+program.command("example").description("Add a few-shot reference pattern (before/after code) to the project").action(() => void example());
+program.command("complexity [storyId]").description("Analyze story complexity with AI \u2014 scores, risks, effort estimates").action((id) => {
+  import("./complexity-NSSYVT54.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-6SXJ37TI.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-CKV3R67G.js").then((m) => void m.importPrd(file));
+});
+var map = program.command("map").description("Import or extract story maps from codebases");
+map.command("extract").description("Output a prompt for your coding agent to extract a story map from an existing codebase").action(() => {
+  import("./map-extract-I3AACTGL.js").then((m) => void m.mapExtract());
+});
+map.command("import <file>").description("Import a storymap.json file generated by your coding agent").option("--yes", "Skip confirmation prompt").action((file, opts) => {
+  import("./map-import-IYUMRASO.js").then((m) => void m.mapImport(file, opts));
+});
+map.command("schema").description("Print the JSON Schema for storymap.json").action(() => {
+  import("./map-schema-JVL3O2TJ.js").then((m) => void m.mapSchema());
+});
+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();