intentdocs 0.8.0 → 0.10.0

package/dist/index.js

@@ -1,53 +1,74 @@
 #!/usr/bin/env node
 import {
-  captureCli,
+  UPGRADE_MESSAGE_PLAIN,
+  isPlanGated
+} from "./chunk-UR73WX5I.js";
+import {
+  ci
+} from "./chunk-IDNUBI2P.js";
+import {
   setup,
-  shutdownCliAnalytics,
   sync
-} from "./chunk-IKF3ZLHK.js";
+} from "./chunk-EEKEF2FD.js";
+import {
+  captureCli,
+  shutdownCliAnalytics
+} from "./chunk-HEHHSSUM.js";
 import {
   scope
-} from "./chunk-4OWPN2RE.js";
+} from "./chunk-5USVG4DW.js";
 import {
   criterionPriority,
   criterionStatusLabel,
   findBlockingMusts,
+  formatDesignRefLine,
   storyContextPath,
   writeStoryContext
-} from "./chunk-6FGYJ3W2.js";
+} from "./chunk-NFIXRIHM.js";
 import {
-  ask,
-  closePrompt,
-  confirm,
-  pausePrompt
-} from "./chunk-WPVDURTJ.js";
-import {
-  UPGRADE_MESSAGE_PLAIN,
-  isPlanGated
-} from "./chunk-ITQUQYWB.js";
+  matchesStoryRef,
+  storyRef
+} from "./chunk-LQTPZL2Y.js";
 import {
+  amendDecision,
   apiFetch,
   apiUrl,
   createStories,
   getContext,
+  listDecisions,
   listStories,
   raiseBlocker,
   reportCriteria,
+  retractDecision,
+  syncHeaders,
   updateStories,
   uploadScreenshot
-} from "./chunk-6XKB6RTU.js";
+} from "./chunk-YUW3W43S.js";
 import {
   hasConfig,
   readConfig,
   requireConfig,
   writeConfig
-} from "./chunk-ICOMMHKG.js";
+} from "./chunk-UF535HZL.js";
+import {
+  ask,
+  closePrompt,
+  confirm,
+  isInteractive,
+  pausePrompt
+} from "./chunk-WRRUCCVZ.js";
 import {
-  API_BASE,
+  authenticatedFetch,
+  bindingLabel,
+  clearAuth,
   getAuth,
-  requireAuth,
-  saveAuth
-} from "./chunk-PCNDP5SX.js";
+  requireValidAuth,
+  saveAuth,
+  validateAuth
+} from "./chunk-LXQXJULN.js";
+import {
+  API_BASE
+} from "./chunk-UYTVTYNB.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -60,6 +81,27 @@ import { createInterface } from "readline";
 
 // src/commands/login.ts
 import { exec } from "child_process";
+function finishLogin(data) {
+  saveAuth({
+    token: data.token,
+    apiBase: API_BASE,
+    ...data.userId && { userId: data.userId },
+    binding: data.binding ?? null,
+    ...data.posthogKey && { posthogKey: data.posthogKey },
+    ...data.posthogHost && { posthogHost: data.posthogHost }
+  });
+  console.log(`
+
+\u2705 Logged in as ${data.userId ?? "unknown user"} \u2014 token ${bindingLabel(data.binding)}
+`);
+  if (data.binding?.approvalStatus === "pending") {
+    console.log("An admin has been asked to approve it. Until they do, this token reads your personal projects only.\n");
+  }
+  console.log("You can now run: intentdocs init");
+  console.log(
+    "Optional: add your Anthropic API key to unlock AI features on any plan \u2014 intentdocs keys set"
+  );
+}
 function openBrowser(url) {
   const cmd = process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "${url}"` : `xdg-open "${url}"`;
   exec(cmd);
@@ -70,8 +112,24 @@ function sleep(ms) {
 async function login() {
   const existing = getAuth();
   if (existing) {
-    console.log("Already logged in. Run `intent logout` to switch accounts.");
-    return;
+    const result = await validateAuth();
+    if (result.valid) {
+      console.log(`Already logged in (user: ${result.userId}). Run \`intentdocs logout\` to switch accounts.`);
+      return;
+    }
+    switch (result.reason) {
+      case "revoked":
+        console.log("Your stored token has been revoked. Starting a fresh login...\n");
+        break;
+      case "not_found":
+        console.log("Your stored token is no longer valid. Starting a fresh login...\n");
+        break;
+      case "network_error":
+        console.error("Could not reach intentdocs.com to verify your token. Check your internet connection and try again.");
+        process.exit(1);
+        break;
+    }
+    clearAuth();
   }
   console.log("Logging in to intentdocs...\n");
   const res = await fetch(`${API_BASE}/api/cli/auth`, { method: "POST" });
@@ -85,38 +143,83 @@ async function login() {
   console.log(`If it doesn't open, visit: ${authUrl}
 `);
   openBrowser(authUrl);
-  const maxAttempts = 60;
-  for (let i = 0; i < maxAttempts; i++) {
-    await sleep(3e3);
+  const POLL_INTERVAL_MS = 3e3;
+  const INITIAL_TIMEOUT_S = 300;
+  const EXTEND_TIMEOUT_S = 120;
+  let totalWaitedS = 0;
+  let phase = "initial";
+  let timeoutS = INITIAL_TIMEOUT_S;
+  while (totalWaitedS < timeoutS) {
+    const elapsed = totalWaitedS;
+    const minutesLeft = Math.ceil((timeoutS - elapsed) / 60);
+    if (elapsed === 0) {
+      process.stdout.write("Waiting for browser approval...");
+    } else if (elapsed % 30 === 0) {
+      process.stdout.write(`
+  Still waiting for approval (${minutesLeft}m remaining)...`);
+    } else {
+      process.stdout.write(".");
+    }
+    await sleep(POLL_INTERVAL_MS);
+    totalWaitedS += POLL_INTERVAL_MS / 1e3;
     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"
-        );
+        finishLogin(data);
         return;
       }
       if (data.status === "expired") {
-        console.error("Login request expired. Run `intent login` to try again.");
+        console.error("\n\nThe server-side login request expired. Run `intentdocs login` to start a new one.");
         process.exit(1);
       }
-      process.stdout.write(".");
     } catch {
-      process.stdout.write(".");
     }
   }
-  console.error("\nLogin timed out. Run `intent login` to try again.");
+  if (phase === "initial") {
+    console.log("\n\nThe initial wait has ended. The browser approval hasn't come through yet.");
+    console.log("This can happen if you needed to create an account or got distracted.\n");
+    const rl = await import("readline");
+    const iface = rl.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise(
+      (resolve) => iface.question("Keep waiting? (y/n): ", resolve)
+    );
+    iface.close();
+    if (answer.trim().toLowerCase().startsWith("y")) {
+      phase = "extended";
+      timeoutS = totalWaitedS + EXTEND_TIMEOUT_S;
+      console.log(`
+Waiting ${EXTEND_TIMEOUT_S / 60} more minutes...`);
+      while (totalWaitedS < timeoutS) {
+        const minutesLeft = Math.ceil((timeoutS - totalWaitedS) / 60);
+        if (Math.floor(totalWaitedS) % 30 === 0 && totalWaitedS > INITIAL_TIMEOUT_S) {
+          process.stdout.write(`
+  Still waiting (${minutesLeft}m remaining)...`);
+        } else {
+          process.stdout.write(".");
+        }
+        await sleep(POLL_INTERVAL_MS);
+        totalWaitedS += POLL_INTERVAL_MS / 1e3;
+        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) {
+            finishLogin(data);
+            return;
+          }
+          if (data.status === "expired") {
+            console.error("\n\nThe server-side login request expired. Run `intentdocs login` to start a new one.");
+            process.exit(1);
+          }
+        } catch {
+        }
+      }
+    }
+  }
+  console.error("\n\nLogin timed out. Run `intentdocs login` to try again.");
+  console.error("If the browser page is still open, complete it and re-run the command \u2014 your approval will still work within 10 minutes.\n");
   process.exit(1);
 }
 async function logout() {
@@ -133,6 +236,7 @@ async function logout() {
 }
 
 // src/commands/init.ts
+var INTENTDOCS_CLAUDE_BLOCK = "\n\n# intentdocs\nRead INTENT.md for the product story map, personas, and backlog.\nWhen you call `save_tests`, pass the `file` and the `full_name` (the full test name, describe blocks included) for every test, so CI can report each test's result back to its story.\nWhen you open a pull request for a story, pass its URL to `intent done` or `complete_story`; intentdocs stamps the PR with a 'Spec \u2192 Code via intentdocs.com' footer linking back to the story when GitHub is connected. If it is not, end the PR body with:\n---\nSpec \u2192 Code via [intentdocs.com](https://intentdocs.com?utm_source=github&utm_medium=pr-footer) \xB7 [story <story-id>](<story-url>)\n";
 function ask2(rl, question) {
   return new Promise((resolve) => rl.question(question, resolve));
 }
@@ -148,9 +252,6 @@ ${prompt} [1-${items.length}]: `);
     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"))) {
@@ -179,12 +280,12 @@ function detectStack(cwd) {
 }
 async function init(tokenArg) {
   if (hasConfig()) {
-    console.log("Already initialized. Run `intent sync` to refresh.");
+    console.log("Already initialized. Run `intentdocs sync` to refresh.");
     return;
   }
   if (tokenArg) {
-    await initWithSyncToken(tokenArg);
-    return;
+    console.error("Sync tokens have been retired \u2014 `intentdocs init` no longer takes one. Run `intentdocs login`, then `intentdocs init` and pick the project and map.");
+    process.exit(1);
   }
   let auth = getAuth();
   if (!auth) {
@@ -200,24 +301,23 @@ async function init(tokenArg) {
   const initStart = Date.now();
   try {
     console.log("\nFetching your projects...");
-    const projectsRes = await fetch(`${auth.apiBase}/api/cli/projects`, {
-      headers: authHeaders(auth.token)
-    });
+    const projectsRes = await authenticatedFetch("/api/cli/projects");
     if (!projectsRes.ok) {
-      console.error("Failed to fetch projects. Try `intent login` first.");
+      console.error("Failed to fetch projects. The server returned an error \u2014 try again or check intentdocs.com for status.");
       process.exit(1);
     }
-    const { projects } = await projectsRes.json();
+    const { projects, workspace: whereIAm } = await projectsRes.json();
     if (projects.length === 0) {
       console.log("\nNo projects found. Create one at intentdocs.com first.");
       process.exit(0);
     }
+    if (whereIAm) console.log(`
+${whereIAm}`);
     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) }
+    const mapsRes = await authenticatedFetch(
+      `/api/cli/projects/${project.id}/maps`
     );
     if (!mapsRes.ok) {
       console.error("Failed to fetch story maps.");
@@ -233,15 +333,15 @@ 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,
+      workspace: project.workspace ? { orgId: project.workspace.orgId, name: project.workspace.name } : { orgId: null, name: null },
       ...appUrl && { appUrl }
     };
     console.log(`
-Connecting to "${map2.title}"...`);
+Connecting to "${map2.title}"${project.workspace ? ` in ${project.workspace.name ?? "its workspace"}` : ""}...`);
     try {
       const data = await listStories(config);
       console.log(`\u2713 Connected to "${data.map.title}"`);
@@ -273,8 +373,16 @@ Connecting to "${map2.title}"...`);
     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 ci             \u2014 report your tests' results from CI to each story
     intent propose        \u2014 plan a new feature from the terminal
     `);
+    const setUpCi = await ask2(rl, "  Set up CI test reporting now? It creates a key and adds the workflow. (y/N): ");
+    if (/^y(es)?$/i.test(setUpCi.trim())) {
+      const { ci: ci2 } = await import("./ci-LBOCMRKZ.js");
+      await ci2();
+    } else {
+      console.log("  You can run `intent ci` any time to turn it on.\n");
+    }
   } finally {
     rl.close();
     await shutdownCliAnalytics();
@@ -327,34 +435,6 @@ _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);
@@ -375,10 +455,7 @@ async function setupFiles(config) {
   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"
-      );
+      appendFileSync(join(cwd, "CLAUDE.md"), INTENTDOCS_CLAUDE_BLOCK);
       console.log("\u2713 Added INTENT.md reference to CLAUDE.md");
     }
   }
@@ -508,7 +585,7 @@ function listView(stories2) {
   ${activity} (${done2}/${actStories.length})`);
     for (const s of actStories) {
       const icon = STATUS_ICON[s.status] ?? "\u2B1C";
-      const id = s.id.slice(0, 8);
+      const id = storyRef(s);
       console.log(`    ${icon} ${s.title.slice(0, 70)} (${id})`);
     }
   }
@@ -556,7 +633,7 @@ function kanbanView(stories2) {
       row(
         cols.map((c) => {
           const s = c.stories[i];
-          return s ? cell(s.id.slice(0, 8)) : emptyCell();
+          return s ? cell(storyRef(s)) : emptyCell();
         })
       )
     );
@@ -615,18 +692,32 @@ function parseVerificationSuggestions(raw) {
 // src/commands/next.ts
 var PRIORITY_ORDER = { must: 0, should: 1, could: 2 };
 var EFFORT_ORDER = { S: 0, M: 1, L: 2, XL: 3 };
+function unsequencedRefusal(story, apiBase, mapId) {
+  const planUrl = `${apiBase}/storymapper/${mapId}?phase=plan&story=${story.id}`;
+  return `
+  \u{1F512} "${story.title}" is unsequenced \u2014 it hasn't been ordered on the Plan view yet.
+
+  Agents only build stories you've deliberately sequenced. Drag it into the
+  plan (or set its build order) here, then retry:
+  \u2192 ${planUrl}
+`;
+}
 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));
+    const match = data.stories.find((st) => matchesStoryRef(st, opts.storyId));
     if (!match) {
       console.log(`
   \u274C No story found matching ID: ${opts.storyId}
 `);
       return;
     }
+    if (match.build_sequence == null) {
+      console.log(unsequencedRefusal(match, config.apiBase, data.map.id));
+      return;
+    }
     s = match;
   } else {
     if (!opts.skipWip) {
@@ -640,7 +731,7 @@ async function next(opts = {}) {
           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.
+  Finish those first, or run \`intentdocs next --skip-wip\` to pick the next todo anyway.
 `);
         return;
       }
@@ -648,12 +739,13 @@ async function next(opts = {}) {
     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) => {
+    const allTodos = data.stories.filter((st) => st.status === "todo");
+    const todos = allTodos.filter((st) => st.build_sequence != null).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;
+      const aSeq = a.build_sequence;
+      const bSeq = b.build_sequence;
       if (aSeq !== bSeq) return aSeq - bSeq;
       if (a.release !== b.release) return a.release - b.release;
       const pa = PRIORITY_ORDER[a.priority] ?? 9;
@@ -662,11 +754,17 @@ async function next(opts = {}) {
       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) {
+      const unsequencedCount = allTodos.filter((st) => st.build_sequence == null).length;
+      const blockedCount = allTodos.length - unsequencedCount;
+      if (unsequencedCount > 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.
+  \u{1F512} ${unsequencedCount} stor${unsequencedCount === 1 ? "y is" : "ies are"} unsequenced \u2014 agents only build stories you've deliberately ordered.`);
+        console.log(`  Sequence ${unsequencedCount === 1 ? "it" : "them"} on the Plan view, then run \`intentdocs next\` again.
+`);
+      } else if (blockedCount > 0) {
+        console.log(`
+  \u{1F512} ${blockedCount} stories remain but all have unfinished dependencies.`);
+        console.log(`  Finish in-progress stories first, then run \`intentdocs next\` again.
 `);
       } else {
         console.log("\n  \u{1F389} All stories are done! Ship it.\n");
@@ -757,7 +855,7 @@ async function generateVerificationSuggestions(story, contextPath) {
 `);
     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._`, ``];
+  const lines = [`# Suggested verification commands: ${story.title}`, ``, `_Generated by \`intentdocs next --stub\` \u2014 copy into the criterion's command field, or run \`intentdocs check\` once wired up._`, ``];
   console.log();
   for (const suggestion of suggestions) {
     const ac = candidates[suggestion.index - 1];
@@ -816,6 +914,10 @@ async function implement(storyId, opts = {}) {
 `);
     return;
   }
+  if (s.build_sequence == null) {
+    console.log(unsequencedRefusal(s, config.apiBase, data.map.id));
+    return;
+  }
   const doneIds = new Set(
     data.stories.filter((st) => st.status === "done").map((st) => st.id)
   );
@@ -853,7 +955,7 @@ async function implement(storyId, opts = {}) {
     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?");
+    const proceed = isInteractive() ? await confirm("  Assign this story and mark in progress?") : false;
     if (!proceed) {
       console.log(`
   Skipped.
@@ -999,27 +1101,30 @@ function extractImplementationContext(storyId) {
   return { summary, files };
 }
 async function passesCriteriaGuard(story) {
-  if (story.acceptance_criteria.length === 0) return { proceed: true, forced: false };
+  if (story.acceptance_criteria.length === 0) return { proceed: true, forced: false, blockedNonInteractive: 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 };
+  if (blocking.length === 0) return { proceed: true, forced: false, blockedNonInteractive: 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();
+  if (!isInteractive()) {
+    return { proceed: false, forced: false, blockedNonInteractive: true };
+  }
   const proceed = await confirm("  Mark done anyway?");
-  return { proceed, forced: proceed };
+  return { proceed, forced: proceed, blockedNonInteractive: false };
 }
 async function done(idPrefix, opts = {}) {
   const config = requireConfig();
   const data = await listStories(config);
-  const match = data.stories.find((s) => s.id.startsWith(idPrefix));
+  const match = data.stories.find((s) => matchesStoryRef(s, idPrefix));
   if (!match) {
     console.error(`No story found matching "${idPrefix}"`);
     process.exit(1);
@@ -1031,6 +1136,13 @@ async function done(idPrefix, opts = {}) {
   const guard = await passesCriteriaGuard(match);
   if (!guard.proceed) {
     closePrompt();
+    if (guard.blockedNonInteractive) {
+      console.error(
+        `  \u2717 Not marked done: "${match.title}" has unresolved 'must' criteria and no TTY is available to confirm an override.`
+      );
+      console.error(`    Report the criteria (intent check / report_criteria) or re-run interactively to force it.`);
+      process.exit(1);
+    }
     return;
   }
   const { summary, files } = extractImplementationContext(match.id);
@@ -1050,6 +1162,17 @@ async function done(idPrefix, opts = {}) {
   if (files.length > 0) update.implemented_files = files;
   if (screenshotUrl) update.screenshot_url = screenshotUrl;
   const result = await updateStories(config, [update]);
+  const verify = await listStories(config);
+  const persisted = verify.stories.find((s) => s.id === match.id);
+  if (persisted?.status !== "done") {
+    console.error(
+      `  \u2717 Done-mark did not persist: server reports status="${persisted?.status ?? "not found"}" for "${match.title}" after the update.`
+    );
+    console.error(`    Not treating this run as successful \u2014 re-run \`intent done ${idPrefix}\` or check the sync API.`);
+    await shutdownCliAnalytics();
+    closePrompt();
+    process.exit(1);
+  }
   const effortToComplexity = (e) => e === "XL" || e === "L" ? "high" : e === "M" ? "med" : "low";
   captureCli(
     "story_shipped",
@@ -1067,12 +1190,12 @@ async function done(idPrefix, opts = {}) {
   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 ?? []) {
+  for (const release of result.readyReleases ?? []) {
     console.log();
-    console.log(`\u{1F680} Release shipped: ${release.label} (${release.storyCount} stories)`);
+    console.log(`\u{1F3C1} ${release.label} is ready to close (${release.storyCount} stories done) \u2014 close it on Validate \u203A Release`);
   }
   console.log();
-  const wantsDecision = await confirm("  Log a decision or lesson from this story?");
+  const wantsDecision = isInteractive() ? await confirm("  Log a decision or lesson from this story?") : false;
   if (wantsDecision) {
     const title = await ask("  Decision title: ");
     const description = await ask("  What was decided / learned: ");
@@ -1103,16 +1226,19 @@ async function done(idPrefix, opts = {}) {
       }
     }
   }
-  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);
+  try {
+    await 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 {
+  }
   await shutdownCliAnalytics();
   closePrompt();
 }
@@ -1188,7 +1314,7 @@ function isRunnable(ac) {
 }
 function resolveStory(stories2, idPrefix) {
   if (idPrefix) {
-    const story = stories2.find((s) => s.id.startsWith(idPrefix));
+    const story = stories2.find((s) => matchesStoryRef(s, idPrefix));
     return story ? { story } : { error: `No story found matching "${idPrefix}"` };
   }
   const inProgress = stories2.filter((s) => s.status === "in_progress");
@@ -1292,18 +1418,8 @@ function printBanner(subtitle) {
 
 // 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, {
+async function streamResponse(path, body, options) {
+  const res = await authenticatedFetch(path, {
     method: "POST",
     body: JSON.stringify(body)
   });
@@ -1331,8 +1447,7 @@ async function streamResponse(path, token, body, options) {
   return full;
 }
 async function start() {
-  const auth = requireAuth();
-  const { token } = auth;
+  await requireValidAuth();
   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  > ");
@@ -1345,13 +1460,13 @@ async function start() {
   const spinner = ora("  Thinking about your idea...").start();
   let discoveryText;
   try {
-    discoveryText = await streamResponse("/api/blueprint/discovery", token, {
+    discoveryText = await streamResponse("/api/blueprint/discovery", {
       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");
+    console.error("  Make sure you're logged in: intentdocs login");
     closePrompt();
     return;
   }
@@ -1368,7 +1483,7 @@ async function start() {
   }
   pausePrompt();
   const pitchSpinner = ora("  Synthesising your pitch...").start();
-  const pitchRes = await apiFetch2("/api/blueprint/synthesize-pitch", token, {
+  const pitchRes = await authenticatedFetch("/api/blueprint/synthesize-pitch", {
     method: "POST",
     body: JSON.stringify({ problem, qa })
   });
@@ -1404,7 +1519,7 @@ async function start() {
   Great \u2014 "${productName}" it is.
 `);
   console.log("  Creating project...");
-  const createRes = await apiFetch2("/api/blueprint/create", token, {
+  const createRes = await authenticatedFetch("/api/blueprint/create", {
     method: "POST",
     body: JSON.stringify({
       messages: [{ role: "user", content: problem }],
@@ -1423,14 +1538,14 @@ async function start() {
   Failed to create project: ${data.error ?? "unknown error"}`);
       }
     } else {
-      console.error("\n  Failed to create project. Try logging in again: intent login");
+      console.error("\n  Failed to create project. Try logging in again: intentdocs 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");
+    console.error("\n  Unexpected response from server. Try logging in again: intentdocs login");
     closePrompt();
     return;
   }
@@ -1461,9 +1576,8 @@ async function start() {
       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(
+        const pubRes = await authenticatedFetch(
           `/api/projects/${projectId}/publish`,
-          token,
           {
             method: "POST",
             body: JSON.stringify({
@@ -1503,7 +1617,7 @@ async function start() {
     closePrompt();
     return;
   }
-  const { scope: scope2 } = await import("./scope-OGKQ472D.js");
+  const { scope: scope2 } = await import("./scope-S3LZZ3KB.js");
   await scope2(projectId);
 }
 
@@ -1511,9 +1625,9 @@ async function start() {
 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();
+  await requireValidAuth();
   if (!hasConfig()) {
-    console.log("  Not connected to a project. Run `intent init` first.");
+    console.log("  Not connected to a project. Run `intentdocs init` first.");
     closePrompt();
     return;
   }
@@ -1807,7 +1921,7 @@ async function proposeFromFile(filePath, config, nameOverride) {
   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.
+  \u2705 Done! Run \`intentdocs next\` to start building.
 `);
 }
 
@@ -1820,11 +1934,11 @@ var STATUS_ICON2 = {
 async function show(idPrefix) {
   const config = requireConfig();
   const data = await listStories(config);
-  const story = data.stories.find((s) => s.id.startsWith(idPrefix));
+  const story = data.stories.find((s) => matchesStoryRef(s, idPrefix));
   if (!story) {
     console.error(`
   No story found matching "${idPrefix}"
-  Run \`intent stories\` to list IDs.
+  Run \`intentdocs stories\` to list IDs.
 `);
     process.exit(1);
   }
@@ -1853,6 +1967,13 @@ async function show(idPrefix) {
       console.log(`    ${check2} ${ac.text}`);
     }
   }
+  if (story.design_refs && story.design_refs.length > 0) {
+    console.log(`
+  Design references:`);
+    for (const ref of story.design_refs) {
+      console.log(`    ${formatDesignRefLine(ref)}`);
+    }
+  }
   if (story.notes) {
     console.log(`
   Notes:`);
@@ -1871,7 +1992,7 @@ async function show(idPrefix) {
   const relPath = contextPath.replace(process.cwd() + "/", "");
   console.log(`
   Context  : ${relPath}`);
-  console.log(`  Mark done: intent done ${story.id.slice(0, 8)}
+  console.log(`  Mark done: intent done ${storyRef(story)}
 `);
 }
 
@@ -1920,7 +2041,7 @@ async function example() {
     console.log(`
   \u2713 Example saved: "${data.title}"
 `);
-    console.log("  Run `intent sync --context` to regenerate your CLAUDE.md with this pattern.\n");
+    console.log("  Run `intentdocs sync --context` to regenerate your CLAUDE.md with this pattern.\n");
   } catch {
     rl.close();
     throw new Error("Aborted");
@@ -2222,6 +2343,38 @@ var TOOLS = [
     },
     mode: "standard"
   },
+  {
+    name: "amend_decision",
+    description: "Amend a previously logged decision's title, description, or category. Use when you got a decision wrong or need to update it after new information. Cannot amend a decision that's been retracted.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        decision_id: { type: "string", description: "Decision ID (full UUID or prefix)" },
+        title: { type: "string", description: "New title" },
+        description: { type: "string", description: "New description" },
+        category: {
+          type: "string",
+          enum: ["architecture", "product", "technical", "trade-off"],
+          description: "New category"
+        }
+      },
+      required: ["decision_id"]
+    },
+    mode: "standard"
+  },
+  {
+    name: "retract_decision",
+    description: "Retract a previously logged decision \u2014 a soft, audited removal (marked retracted with a timestamp and optional reason), never a hard delete. Use when a decision was made in error or no longer applies.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        decision_id: { type: "string", description: "Decision ID (full UUID or prefix)" },
+        reason: { type: "string", description: "Why this decision is being retracted" }
+      },
+      required: ["decision_id"]
+    },
+    mode: "standard"
+  },
   // ── All tools (~15k tokens) ─────────────────────────────────────────────
   {
     name: "analyze_complexity",
@@ -2275,7 +2428,7 @@ async function handleToolCall(name, args, config) {
     const storyId = args?.story_id;
     if (storyId) {
       const data = await listStories(config);
-      const match = data.stories.find((s) => s.id.startsWith(storyId));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (match?.cancelled_at) {
         return {
           content: [{
@@ -2312,9 +2465,27 @@ async function handleToolCall(name, args, config) {
       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));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (!match) return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
-      await updateStories(config, [{ id: match.id, status: "in_progress" }]);
+      if (match.build_sequence == null) {
+        return {
+          content: [{
+            type: "text",
+            text: `\u{1F512} "${match.title}" is unsequenced \u2014 it hasn't been ordered on the Plan view yet.
+
+Agents only build stories that have been deliberately sequenced. Sequence it on the Plan view (drag it into the plan or set its build order), then retry.`
+          }]
+        };
+      }
+      const result = await updateStories(config, [{ id: match.id, status: "in_progress" }]);
+      if (result.missing?.includes(match.id)) {
+        return {
+          content: [{
+            type: "text",
+            text: `\u2717 "${match.title}" was not updated \u2014 the server reports the id matched no row. Re-run list_stories and retry.`
+          }]
+        };
+      }
       return {
         content: [{ type: "text", text: `\u2713 ${match.title} \u2192 in_progress` }]
       };
@@ -2324,7 +2495,7 @@ async function handleToolCall(name, args, config) {
       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));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (!match) return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
       const blocking = findBlockingMusts(match.acceptance_criteria);
       if (!force && blocking.length > 0) {
@@ -2340,7 +2511,15 @@ Fix and call report_criteria, or call mark_done again with force:true to overrid
         };
       }
       const forced = force && blocking.length > 0;
-      await updateStories(config, [{ id: match.id, status: "done", ...forced ? { forced: true } : {} }]);
+      const result = await updateStories(config, [{ id: match.id, status: "done", ...forced ? { forced: true } : {} }]);
+      if (result.missing?.includes(match.id)) {
+        return {
+          content: [{
+            type: "text",
+            text: `\u2717 "${match.title}" was not marked done \u2014 the server reports the id matched no row. Re-run list_stories and retry.`
+          }]
+        };
+      }
       return {
         content: [{ type: "text", text: `\u2713 ${match.title} \u2192 done` }]
       };
@@ -2352,7 +2531,7 @@ Fix and call report_criteria, or call mark_done again with force:true to overrid
         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));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (!match) return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
       const result = await reportCriteria(
         config,
@@ -2384,7 +2563,7 @@ Fix and call report_criteria, or call mark_done again with force:true to overrid
         };
       }
       const data = await listStories(config);
-      const match = data.stories.find((s) => s.id.startsWith(storyId));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (!match) return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
       await raiseBlocker(config, {
         story_id: match.id,
@@ -2452,6 +2631,48 @@ Decision needed: ${decisionNeeded}`
       }
       return { content: [{ type: "text", text: "Failed to log decision" }] };
     }
+    case "amend_decision": {
+      const decisionId = args?.decision_id;
+      if (!decisionId) return { content: [{ type: "text", text: "decision_id is required" }] };
+      const title = args?.title;
+      const description = args?.description;
+      const category = args?.category;
+      if (!title?.trim() && !description?.trim() && !category) {
+        return { content: [{ type: "text", text: "Nothing to amend \u2014 pass title, description, and/or category" }] };
+      }
+      const { decisions } = await listDecisions(config);
+      const match = decisions.find((d) => d.id.startsWith(decisionId));
+      if (!match) return { content: [{ type: "text", text: `No decision found matching "${decisionId}"` }] };
+      if (match.retracted_at) {
+        return { content: [{ type: "text", text: `"${match.title}" has been retracted and can't be amended.` }] };
+      }
+      try {
+        const updated = await amendDecision(config, match.id, {
+          ...title?.trim() ? { title: title.trim() } : {},
+          ...description?.trim() ? { description: description.trim() } : {},
+          ...category ? { category } : {}
+        });
+        return { content: [{ type: "text", text: `\u2713 Decision amended: ${updated.title}` }] };
+      } catch {
+        return { content: [{ type: "text", text: "Failed to amend decision" }] };
+      }
+    }
+    case "retract_decision": {
+      const decisionId = args?.decision_id;
+      if (!decisionId) return { content: [{ type: "text", text: "decision_id is required" }] };
+      const { decisions } = await listDecisions(config);
+      const match = decisions.find((d) => d.id.startsWith(decisionId));
+      if (!match) return { content: [{ type: "text", text: `No decision found matching "${decisionId}"` }] };
+      if (match.retracted_at) {
+        return { content: [{ type: "text", text: `"${match.title}" is already retracted.` }] };
+      }
+      try {
+        await retractDecision(config, match.id, args?.reason);
+        return { content: [{ type: "text", text: `\u2713 Decision retracted: ${match.title}` }] };
+      } catch {
+        return { content: [{ type: "text", text: "Failed to retract decision" }] };
+      }
+    }
     case "add_note": {
       const storyId = args?.story_id;
       const note = args?.note;
@@ -2459,7 +2680,7 @@ Decision needed: ${decisionNeeded}`
         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));
+      const match = data.stories.find((s) => matchesStoryRef(s, storyId));
       if (!match) {
         return { content: [{ type: "text", text: `No story found matching "${storyId}"` }] };
       }
@@ -2481,7 +2702,7 @@ Decision needed: ${decisionNeeded}`
       }
       const res = await fetch(apiUrl(config, "/complexity"), {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers: syncHeaders({ "Content-Type": "application/json" }),
         body: JSON.stringify(body)
       });
       if (!res.ok) {
@@ -2498,7 +2719,7 @@ Decision needed: ${decisionNeeded}`
       if (!query) return { content: [{ type: "text", text: "query is required" }] };
       const res = await fetch(apiUrl(config, "/research"), {
         method: "POST",
-        headers: { "Content-Type": "application/json" },
+        headers: syncHeaders({ "Content-Type": "application/json" }),
         body: JSON.stringify({ query })
       });
       if (!res.ok) {
@@ -2515,7 +2736,7 @@ Decision needed: ${decisionNeeded}`
       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" },
+        headers: syncHeaders({ "Content-Type": "application/json" }),
         body: JSON.stringify({ prd, format: args?.format ?? "PRD" })
       });
       if (!res.ok) {
@@ -2625,7 +2846,7 @@ async function startMcpServer(mode = "all") {
         };
       }
       if (uri === "intentdocs://project/decisions") {
-        const res = await fetch(apiUrl(config, "/decisions"));
+        const res = await fetch(apiUrl(config, "/decisions"), { headers: syncHeaders() });
         if (!res.ok) {
           const text2 = JSON.stringify({ note: "Failed to fetch decisions" });
           return { contents: [{ uri, mimeType: "application/json", text: text2 }] };
@@ -2637,7 +2858,7 @@ async function startMcpServer(mode = "all") {
         };
       }
       if (uri === "intentdocs://project/data-model") {
-        const res = await fetch(apiUrl(config, "/data-model"));
+        const res = await fetch(apiUrl(config, "/data-model"), { headers: syncHeaders() });
         let data;
         if (res.status === 404) {
           data = { note: "No data model defined yet. Run the interview or add one via the web UI." };
@@ -2652,7 +2873,7 @@ async function startMcpServer(mode = "all") {
         };
       }
       if (uri === "intentdocs://project/build-order") {
-        const res = await fetch(apiUrl(config, "/build-order"));
+        const res = await fetch(apiUrl(config, "/build-order"), { headers: syncHeaders() });
         let data;
         if (res.status === 404) {
           data = { note: "No build order defined yet." };
@@ -2737,18 +2958,18 @@ Registering intentdocs MCP with OpenClaw...`);
 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.name("intentdocs").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));
+  import("./keys-5PA3D6CX.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());
+  import("./keys-5PA3D6CX.js").then((m) => void m.keysStatus());
 });
 keys.command("remove").description("Remove your stored key").action(() => {
-  import("./keys-EDWET3WG.js").then((m) => void m.keysRemove());
+  import("./keys-5PA3D6CX.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));
@@ -2761,12 +2982,12 @@ program.command("templates [name]").description("Browse story map templates").ac
       console.log(`    ${key.padEnd(20)} ${tmpl.description}`);
     }
     console.log(`
-  Usage: intent templates <name>
+  Usage: intentdocs templates <name>
 `);
   } else {
     const tmpl = templates[name];
     if (!tmpl) {
-      console.error(`Unknown template: "${name}". Run \`intent templates\` to list.`);
+      console.error(`Unknown template: "${name}". Run \`intentdocs templates\` to list.`);
     } else {
       console.log(`
   ${tmpl.name}: ${tmpl.description}`);
@@ -2779,8 +3000,12 @@ program.command("templates [name]").description("Browse story map templates").ac
     }
   }
 });
+program.command("projects").description("List the projects your token can reach \u2014 the whole workspace it is bound to").action(() => {
+  import("./projects-F7GMH66U.js").then((m) => void m.projects());
+});
 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("ci").description("Set up CI test reporting \u2014 create a key, add the workflow, store the secret").option("--status", "Show how the last CI run's results matched your saved tests").option("--new", "Create a new CI key even if one already exists (rotate)").action((opts) => void ci(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));
@@ -2790,32 +3015,48 @@ program.command("show <id>").description("Show the full spec for a story (accept
 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));
+var decide = 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-EVLWM64C.js").then((m) => void m.logDecision(title, opts));
+});
+decide.command("list").description("List logged decisions (id, category, title)").action(() => {
+  import("./log-EVLWM64C.js").then((m) => void m.listLoggedDecisions());
+});
+decide.command("amend <id>").description("Amend a logged decision's title, description, or category (accepts an ID prefix)").option("-t, --title <title>", "New title").option("-d, --description <desc>", "New description").option("-c, --category <cat>", "New category: architecture, product, technical, trade-off").action((id, opts) => {
+  import("./log-EVLWM64C.js").then((m) => void m.amendDecision(id, opts));
+});
+decide.command("delete <id>").alias("retract").description("Retract a logged decision \u2014 soft-deleted and audited, not removed (accepts an ID prefix)").option("-r, --reason <reason>", "Why this decision is being retracted").option("-y, --yes", "Skip the confirmation prompt (required when there's no TTY)").action((id, opts) => {
+  import("./log-EVLWM64C.js").then((m) => void m.deleteDecision(id, 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));
+  import("./log-EVLWM64C.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));
+  import("./complexity-ZOB3BPVD.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));
+  import("./research-4ASCZSZN.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));
+  import("./import-prd-MJUCIMHX.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());
+  import("./map-extract-W6WJLVOF.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));
+  import("./map-import-LL4AIAQE.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());
+  import("./map-schema-6GL2UKZQ.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());
+var invokedAs = process.argv[1]?.split("/").pop()?.replace(/\.js$/, "") ?? "";
+if (invokedAs === "intent" && !process.argv.includes("--quiet")) {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+    console.log("\n  Tip: the canonical command is `intentdocs`. `intent` also works but may collide with other tools.\n");
+  }
+}
 program.parse();