intentdocs 0.10.0 → 0.11.0

package/dist/{chunk-EEKEF2FD.js → chunk-IORMKLAQ.js}

@@ -1,31 +1,30 @@
+import {
+  writeStoryContext
+} from "./chunk-BNEU6TLJ.js";
 import {
   captureCli,
   shutdownCliAnalytics
-} from "./chunk-HEHHSSUM.js";
-import {
-  writeStoryContext
-} from "./chunk-NFIXRIHM.js";
+} from "./chunk-KPQ42YE6.js";
 import {
   apiFetch,
   getContext,
   listStories
-} from "./chunk-YUW3W43S.js";
+} from "./chunk-KTGQO3AE.js";
 import {
   hasConfig,
   requireConfig
-} from "./chunk-UF535HZL.js";
+} from "./chunk-K5SNF6CG.js";
 import {
   choose,
   closePrompt
 } from "./chunk-WRRUCCVZ.js";
 import {
   requireValidAuth
-} from "./chunk-LXQXJULN.js";
+} from "./chunk-XZE2XP6O.js";
 
 // src/commands/setup.ts
-import { existsSync as existsSync2, mkdirSync, writeFileSync as writeFileSync2, readFileSync, unlinkSync } from "fs";
-import { join as join2, dirname } from "path";
-import { homedir } from "os";
+import { existsSync as existsSync3, mkdirSync, writeFileSync as writeFileSync3, readFileSync as readFileSync2, unlinkSync } from "fs";
+import { join as join3 } from "path";
 
 // src/commands/sync.ts
 import { writeFileSync, readdirSync, existsSync, statSync } from "fs";
@@ -120,11 +119,66 @@ async function sync(opts) {
   await shutdownCliAnalytics();
 }
 
+// src/lib/claude-mcp-config.ts
+import { existsSync as existsSync2, readFileSync, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
+import { homedir } from "os";
+var LOCAL_SERVER_NAME = "intent";
+var LOCAL_SERVER_ENTRY = { type: "stdio", command: "npx", args: ["intentdocs", "mcp"], env: {} };
+var CLAUDE_MCP_ADD_COMMAND = `claude mcp add --scope project ${LOCAL_SERVER_NAME} -- npx intentdocs mcp`;
+function sameEntry(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+function registerLocalServerInMcpJson(cwd = process.cwd()) {
+  const path = join2(cwd, ".mcp.json");
+  let config = {};
+  if (existsSync2(path)) {
+    try {
+      const parsed = JSON.parse(readFileSync(path, "utf-8"));
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return { status: "unreadable", path };
+      config = parsed;
+    } catch {
+      return { status: "unreadable", path };
+    }
+  }
+  const rawServers = config.mcpServers;
+  if (rawServers !== void 0 && (typeof rawServers !== "object" || rawServers === null || Array.isArray(rawServers))) {
+    return { status: "unreadable", path };
+  }
+  const servers = { ...rawServers ?? {} };
+  const before = servers[LOCAL_SERVER_NAME];
+  if (sameEntry(before, LOCAL_SERVER_ENTRY)) return { status: "unchanged", path };
+  servers[LOCAL_SERVER_NAME] = { ...LOCAL_SERVER_ENTRY, args: [...LOCAL_SERVER_ENTRY.args], env: {} };
+  writeFileSync2(path, JSON.stringify({ ...config, mcpServers: servers }, null, 2) + "\n");
+  return { status: before === void 0 ? "added" : "updated", path };
+}
+var LEGACY_SETTINGS_ENTRY = { command: "npx", args: ["intentdocs", "mcp"] };
+function removeLegacySettingsEntry(home = homedir()) {
+  const path = join2(home, ".claude", "settings.json");
+  if (!existsSync2(path)) return false;
+  let settings;
+  try {
+    settings = JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return false;
+  }
+  if (!settings || typeof settings !== "object" || Array.isArray(settings)) return false;
+  const servers = settings.mcpServers;
+  if (!servers || typeof servers !== "object" || !sameEntry(servers[LOCAL_SERVER_NAME], LEGACY_SETTINGS_ENTRY)) return false;
+  const rest = { ...servers };
+  delete rest[LOCAL_SERVER_NAME];
+  const next = { ...settings };
+  if (Object.keys(rest).length > 0) next.mcpServers = rest;
+  else delete next.mcpServers;
+  writeFileSync2(path, JSON.stringify(next, null, 2) + "\n");
+  return true;
+}
+
 // src/commands/setup.ts
 async function setup() {
   await requireValidAuth();
   if (!hasConfig()) {
-    console.log("  Not connected to a project. Run `intentdocs init` first.");
+    console.log("  Not connected to a project. Run `npx intentdocs init` first.");
     closePrompt();
     return;
   }
@@ -142,7 +196,7 @@ async function setup() {
   try {
     await syncContextFile(config);
   } catch {
-    console.log("  \u26A0 Could not fetch project context (run `intentdocs sync --context` to retry)");
+    console.log("  \u26A0 Could not fetch project context (run `npx intentdocs sync --context` to retry)");
   }
   generateAgentDocs();
   console.log(`
@@ -162,64 +216,64 @@ async function setup() {
     /intent-sync        Refresh context from intentdocs
 
   Terminal commands:
-    intent next              Next priority story
-    intent done <id>         Mark done + log decision/lesson
-    intent decide            Log an architectural decision
-    intent example           Log a reference pattern
-    intent sync              Refresh INTENT.md
-    intent sync --context    Regenerate CLAUDE.md from intentdocs
-    intent status            Recent activity
+    npx intentdocs next              Next priority story
+    npx intentdocs done <id>         Mark done + log decision/lesson
+    npx intentdocs decide            Log an architectural decision
+    npx intentdocs example           Log a reference pattern
+    npx intentdocs sync              Refresh INTENT.md
+    npx intentdocs sync --context    Regenerate CLAUDE.md from intentdocs
+    npx intentdocs status            Recent activity
   `);
   closePrompt();
 }
 function setupClaudeCode() {
   const cwd = process.cwd();
-  const claudeMdPath = join2(cwd, "CLAUDE.md");
+  const claudeMdPath = join3(cwd, "CLAUDE.md");
   const claudeBlock = `
 # intentdocs Integration
 
 This project is connected to a intentdocs story map.
-Run \`intentdocs sync --context\` to generate the full CLAUDE.md with your project's instructions,
+Run \`npx intentdocs sync --context\` to generate the full CLAUDE.md with your project's instructions,
 story map, decisions, examples, tools, and guardrails.
 
 ## Quick reference
 
 | Command | What it does |
 |---|---|
-| \`intentdocs next\` | Pick up the next priority story |
-| \`intentdocs done <id>\` | Mark a story done + log a decision |
-| \`intentdocs decide\` | Log an architectural or product decision |
-| \`intentdocs example\` | Log a reference pattern for this codebase |
-| \`intentdocs sync\` | Refresh story map + INTENT.md |
-| \`intentdocs sync --context\` | Regenerate this file from intentdocs |
-| \`intentdocs status\` | Show recent activity |
+| \`npx intentdocs next\` | Pick up the next priority story |
+| \`npx intentdocs done <id>\` | Mark a story done + log a decision |
+| \`npx intentdocs decide\` | Log an architectural or product decision |
+| \`npx intentdocs example\` | Log a reference pattern for this codebase |
+| \`npx intentdocs sync\` | Refresh story map + INTENT.md |
+| \`npx intentdocs sync --context\` | Regenerate this file from intentdocs |
+| \`npx intentdocs status\` | Show recent activity |
 `;
-  if (existsSync2(claudeMdPath)) {
-    const existing = readFileSync(claudeMdPath, "utf-8");
+  if (existsSync3(claudeMdPath)) {
+    const existing = readFileSync2(claudeMdPath, "utf-8");
     if (!existing.includes("intentdocs Integration")) {
-      writeFileSync2(claudeMdPath, existing + "\n" + claudeBlock);
+      writeFileSync3(claudeMdPath, existing + "\n" + claudeBlock);
       console.log("  \u2713 Updated CLAUDE.md with intentdocs agent workflow");
     } else {
       console.log("  \u2713 CLAUDE.md already configured");
     }
   } else {
-    writeFileSync2(claudeMdPath, claudeBlock.trim() + "\n");
+    writeFileSync3(claudeMdPath, claudeBlock.trim() + "\n");
     console.log("  \u2713 Created CLAUDE.md with intentdocs agent workflow");
   }
-  const commandsDir = join2(cwd, ".claude", "commands");
-  if (!existsSync2(commandsDir)) mkdirSync(commandsDir, { recursive: true });
+  const commandsDir = join3(cwd, ".claude", "commands");
+  if (!existsSync3(commandsDir)) mkdirSync(commandsDir, { recursive: true });
   const oldPbCommands = ["pb-next", "pb-implement", "pb-review", "pb-document", "pb-test", "pb-status", "pb-done", "pb-sync", "pb-propose", "pb-context"];
   for (const name of oldPbCommands) {
-    const oldPath = join2(commandsDir, name + ".md");
-    if (existsSync2(oldPath)) {
+    const oldPath = join3(commandsDir, name + ".md");
+    if (existsSync3(oldPath)) {
       unlinkSync(oldPath);
     }
   }
-  writeFileSync2(
-    join2(commandsDir, "intent-next.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-next.md"),
     `# Pick up the next story
 
-1. Run \`intentdocs next\` to get the highest-priority story
+1. Run \`npx intentdocs next\` to get the highest-priority story
 2. Read the acceptance criteria carefully \u2014 these define "done"
 3. Check ARCHITECTURE.md for relevant technical decisions
 4. Read CONVENTIONS.md for coding patterns to follow
@@ -227,13 +281,13 @@ story map, decisions, examples, tools, and guardrails.
 6. Ask for confirmation before proceeding
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-implement.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-implement.md"),
     `# Implement a story
 
 ## Context to load first
 1. Read CLAUDE.md \u2014 your full project harness (instructions, decisions, examples, tools, guardrails)
-2. Run \`intentdocs next\` if you don't have a story yet
+2. Run \`npx intentdocs next\` if you don't have a story yet
 3. Review the "Done when" acceptance criteria \u2014 each one carries a priority
    (\`must\`/\`should\`) and a verification method: \`[executable]\` gives you a
    \`check:\` command to run, \`[self-check]\`/\`[visual]\`/\`[founder]\` give you
@@ -254,18 +308,18 @@ story map, decisions, examples, tools, and guardrails.
    \`must\` criterion fails 3 times, call \`raise_blocker\` with what you
    attempted, what's failing, and the single decision the founder needs to
    make \u2014 then stop working on this story.
-10. Never call \`mark_done\` (or \`intentdocs done\`) while a \`must\` criterion is
+10. Never call \`mark_done\` (or \`npx intentdocs done\`) while a \`must\` criterion is
     still failing or has never been reported \u2014 both will warn you and
     require an explicit override if you try.
 
 ## Write back to intentdocs
 11. Add implementation notes:
-    \`intentdocs note <story-id> "How this was implemented"\`
-12. Log decisions: \`intentdocs decide "Title" -d "What and why" -c architecture\`
-13. Log useful patterns: \`intentdocs example\`
+    \`npx intentdocs note <story-id> "How this was implemented"\`
+12. Log decisions: \`npx intentdocs decide "Title" -d "What and why" -c architecture\`
+13. Log useful patterns: \`npx intentdocs example\`
 14. If you discovered new requirements:
-    \`intentdocs add "title" --activity "Activity" --priority should\`
-15. Mark done: \`intentdocs done <story-id>\`
+    \`npx intentdocs add "title" --activity "Activity" --priority should\`
+15. Mark done: \`npx intentdocs done <story-id>\`
 16. Commit: \`git commit -m "feat: description [SC-<id>]"\`
 
 ## Rules
@@ -275,8 +329,8 @@ story map, decisions, examples, tools, and guardrails.
 - Never mark a story done with a failing or unreported \`must\` criterion.
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-review.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-review.md"),
     `# Review against acceptance criteria
 
 1. Identify the story being worked on
@@ -287,8 +341,8 @@ story map, decisions, examples, tools, and guardrails.
 4. Summarise: what's done, what needs work, any concerns
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-document.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-document.md"),
     `# Document a feature
 
 1. Check which story was just completed
@@ -299,47 +353,47 @@ story map, decisions, examples, tools, and guardrails.
    - Decisions made and trade-offs
    - How to test it manually
 4. Log decisions to intentdocs:
-   \`intentdocs decide "Title" -d "Description" -c architecture\`
+   \`npx intentdocs decide "Title" -d "Description" -c architecture\`
 5. Add implementation notes:
-   \`intentdocs note <story-id> "Summary of how it works"\`
+   \`npx intentdocs note <story-id> "Summary of how it works"\`
 6. Update ARCHITECTURE.md if needed
 7. Update CONVENTIONS.md if new patterns were introduced
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-test.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-test.md"),
     `# Write tests for a story
 
-1. Get the story details: \`intentdocs next\` or provided story ID
+1. Get the story details: \`npx intentdocs next\` or provided story ID
 2. Each acceptance criterion becomes at least one test
 3. Also consider: error cases, boundary conditions, integration points
 4. Follow testing patterns in CONVENTIONS.md
 5. Run the tests to verify they pass
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-status.md"),
-    `Run \`intentdocs status\` and \`intentdocs stories --filter todo\` to show current progress and remaining backlog. Summarise what's done and what's left.`
+  writeFileSync3(
+    join3(commandsDir, "intent-status.md"),
+    `Run \`npx intentdocs status\` and \`npx intentdocs stories --filter todo\` to show current progress and remaining backlog. Summarise what's done and what's left.`
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-done.md"),
-    `Ask which story was just completed, then run \`intentdocs done <id>\`.
-\`intentdocs done\` prints the acceptance-criteria table first. If any \`must\` criterion is still failing or was
+  writeFileSync3(
+    join3(commandsDir, "intent-done.md"),
+    `Ask which story was just completed, then run \`npx intentdocs done <id>\`.
+\`npx intentdocs done\` prints the acceptance-criteria table first. If any \`must\` criterion is still failing or was
 never reported via \`report_criteria\`, it will list them and ask "Mark done anyway?" \u2014 only confirm that
-if the founder explicitly wants to override; otherwise go fix the failing criterion and re-run \`intentdocs done\`.
+if the founder explicitly wants to override; otherwise go fix the failing criterion and re-run \`npx intentdocs done\`.
 The CLI will prompt for an optional decision or lesson learned \u2014 encourage the user to capture it.
-Also ask if there are implementation notes to add: \`intentdocs note <id> "..."\`
+Also ask if there are implementation notes to add: \`npx intentdocs note <id> "..."\`
 Both decisions and notes flow back to the project page on intentdocs.com.`
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-sync.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-sync.md"),
     `# Refresh context from intentdocs
 
 ## Refresh story map summary
-Run \`intentdocs sync\` \u2014 updates INTENT.md with the latest stories and their status.
+Run \`npx intentdocs sync\` \u2014 updates INTENT.md with the latest stories and their status.
 
 ## Regenerate the full CLAUDE.md harness
-Run \`intentdocs sync --context\` \u2014 rebuilds CLAUDE.md from your project page, pulling in:
+Run \`npx intentdocs sync --context\` \u2014 rebuilds CLAUDE.md from your project page, pulling in:
 - Role & Goals (Instructions section)
 - Scope (all story maps + story counts)
 - Decisions & Memory (last 10 decisions)
@@ -347,10 +401,10 @@ Run \`intentdocs sync --context\` \u2014 rebuilds CLAUDE.md from your project pa
 - Tools & Stack (structured tool registry + MCP config)
 - Guardrails (hard constraints)
 
-Run \`intentdocs sync --context\` after updating any section on intentdocs.com.`
+Run \`npx intentdocs sync --context\` after updating any section on intentdocs.com.`
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-propose.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-propose.md"),
     `# Propose a new change
 
 Use this when you want to plan a new feature, improvement, or fix before writing code.
@@ -360,22 +414,22 @@ stories there AND saves a local spec for the AI to reference during implementati
 ## Process
 1. Ask the user: "What do you want to build or change? Describe the problem and the solution."
 2. Help them break it into 2-5 stories with clear acceptance criteria (each AC is testable)
-3. Run: \`intentdocs propose <change-name>\`
+3. Run: \`npx intentdocs propose <change-name>\`
    - The CLI will guide through: problem, solution, activity, priority, stories + ACs
    - Stories are created in the live story map at intentdocs.com
    - A local spec is saved to \`intent-changes/<name>/proposal.md\`
-4. Once done: \`intentdocs sync\` to pull the new stories into INTENT.md
-5. Run \`intentdocs next\` to start implementing
+4. Once done: \`npx intentdocs sync\` to pull the new stories into INTENT.md
+5. Run \`npx intentdocs next\` to start implementing
 
 ## Tips
 - Change names should be kebab-case: add-dark-mode, fix-auth-flow, onboarding-revamp
 - Keep stories small \u2014 one story = one deployable increment
 - Write ACs as testable outcomes: "Given X, when Y, then Z" or "User can..."
-- If the change is already defined in the UI, just run \`intentdocs sync\` instead
+- If the change is already defined in the UI, just run \`npx intentdocs sync\` instead
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-context.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-context.md"),
     `# Load current story context
 
 Use this to focus on a single story without loading the full story map.
@@ -386,44 +440,44 @@ Use this to focus on a single story without loading the full story map.
 - When you need a clean, focused view of ACs and notes
 
 ## Process
-1. Run \`intentdocs next\` to get the active story \u2014 this automatically writes the context file to \`.intent/stories/<id>.md\`
+1. Run \`npx intentdocs next\` to get the active story \u2014 this automatically writes the context file to \`.intent/stories/<id>.md\`
 2. Read that file \u2014 it contains: title, user story, acceptance criteria (as checkboxes), notes, and space for relevant files
 3. Use it as your working document throughout implementation:
    - Check off ACs as you satisfy them
    - Add file paths under "Relevant files" as you discover them
-   - Run \`intentdocs note <id> "..."\` to log notes (updates both remote map and local file)
-4. When all ACs are checked: \`intentdocs done <id>\`
+   - Run \`npx intentdocs note <id> "..."\` to log notes (updates both remote map and local file)
+4. When all ACs are checked: \`npx intentdocs done <id>\`
 
 ## If you already know the story ID
 The file is at \`.intent/stories/<full-story-id>.md\` \u2014 read it directly.
 `
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-decide.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-decide.md"),
     `# Log an architectural or product decision
 
 Use this when you've made a decision that future agents (or teammates) should know about.
 
-Run \`intentdocs decide\` \u2014 the CLI will prompt for:
+Run \`npx intentdocs decide\` \u2014 the CLI will prompt for:
 - Title: short, specific description of the decision
 - Description: what was decided and why (include trade-offs considered)
 - Category: architecture / product / technical / trade-off
 
 Decisions appear in the Memory section of the project page at intentdocs.com
-and are included in CLAUDE.md the next time you run \`intentdocs sync --context\`.
+and are included in CLAUDE.md the next time you run \`npx intentdocs sync --context\`.
 
 Good decisions to log:
 - "Chose X over Y because..."
 - "Decided not to do Z because..."
 - "This pattern is used throughout because..."`
   );
-  writeFileSync2(
-    join2(commandsDir, "intent-example.md"),
+  writeFileSync3(
+    join3(commandsDir, "intent-example.md"),
     `# Log a reference pattern for this codebase
 
 Use this when you've written code that represents the right way to do something in this project.
 
-Run \`intentdocs example\` \u2014 the CLI will prompt for:
+Run \`npx intentdocs example\` \u2014 the CLI will prompt for:
 - Title: what the pattern is
 - Description: when to use it
 - Language: typescript / python / bash / other
@@ -431,30 +485,28 @@ Run \`intentdocs example\` \u2014 the CLI will prompt for:
 - After code: the correct pattern to follow
 
 Examples appear in the Knowledge > Examples section of the project page
-and are included in CLAUDE.md as Reference Patterns the next time you run \`intentdocs sync --context\`.`
+and are included in CLAUDE.md as Reference Patterns the next time you run \`npx intentdocs sync --context\`.`
   );
   console.log("  \u2713 Created slash commands: /intent-propose, /intent-next, /intent-implement, /intent-review, /intent-document, /intent-test, /intent-status, /intent-done, /intent-sync, /intent-context, /intent-decide, /intent-example");
   registerMcpWithClaudeCode();
 }
 function registerMcpWithClaudeCode() {
-  const settingsPath = join2(homedir(), ".claude", "settings.json");
-  let settings = {};
-  if (existsSync2(settingsPath)) {
-    try {
-      settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
-    } catch {
-    }
+  const result = registerLocalServerInMcpJson(process.cwd());
+  if (result.status === "unreadable") {
+    console.log(`  \u26A0 Couldn't read ${result.path}, so it was left as it is. Add the IntentDocs server yourself:`);
+    console.log(`      ${CLAUDE_MCP_ADD_COMMAND}`);
+  } else if (result.status === "unchanged") {
+    console.log(`  \u2713 MCP server "${LOCAL_SERVER_NAME}" already registered in .mcp.json`);
+  } else {
+    console.log(`  \u2713 Registered MCP server "${LOCAL_SERVER_NAME}" in .mcp.json \u2014 restart Claude Code and approve it when asked`);
+  }
+  if (removeLegacySettingsEntry()) {
+    console.log("  \u2713 Removed the old entry from ~/.claude/settings.json, where Claude Code doesn't read MCP servers");
   }
-  const servers = settings.mcpServers ?? {};
-  servers.intent = { command: "npx", args: ["intentdocs", "mcp"] };
-  settings.mcpServers = servers;
-  mkdirSync(dirname(settingsPath), { recursive: true });
-  writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-  console.log("  \u2713 Registered MCP server in ~/.claude/settings.json \u2014 restart Claude Code to activate");
 }
 function setupCursor() {
   const cwd = process.cwd();
-  const cursorRulesPath = join2(cwd, ".cursorrules");
+  const cursorRulesPath = join3(cwd, ".cursorrules");
   const cursorBlock = `
 # intentdocs Integration
 
@@ -463,13 +515,18 @@ function setupCursor() {
 2. **ARCHITECTURE.md** \u2014 technical decisions and system structure
 3. **CONVENTIONS.md** \u2014 coding patterns, naming, file structure
 
+## First run
+- No story started yet? The founder's next step is their first story:
+  claim it with \`npx intentdocs next\` (or \`start_story\` over MCP), build it,
+  report each criterion, then mark it done.
+
 ## Workflow
-- Next story: \`intentdocs next\`
-- Mark done: \`intentdocs done <id>\`
-- Add notes: \`intentdocs note <id> "..."\`
-- Log decisions: \`intentdocs decide "Title" -d "Why"\`
-- Create stories: \`intentdocs add "title" --activity "Name"\`
-- Refresh context: \`intentdocs sync\`
+- Next story: \`npx intentdocs next\`
+- Mark done: \`npx intentdocs done <id>\`
+- Add notes: \`npx intentdocs note <id> "..."\`
+- Log decisions: \`npx intentdocs decide "Title" -d "Why"\`
+- Create stories: \`npx intentdocs add "title" --activity "Name"\`
+- Refresh context: \`npx intentdocs sync\`
 
 ## The acceptance-criteria loop
 - Each "Done when" criterion carries a priority (\`must\`/\`should\`) and a
@@ -480,7 +537,7 @@ function setupCursor() {
 - For a failing \`must\` criterion: fix and re-check. If the same \`must\`
   fails 3 times, call \`raise_blocker\` with what you attempted, what's
   failing, and the single decision needed \u2014 then stop.
-- Never call \`mark_done\`/\`intentdocs done\` while a \`must\` criterion is still
+- Never call \`mark_done\`/\`npx intentdocs done\` while a \`must\` criterion is still
   failing or unreported \u2014 both warn and require an explicit override.
 
 ## Rules
@@ -489,14 +546,14 @@ function setupCursor() {
 - Log decisions and trade-offs back to intentdocs
 - Follow patterns in CONVENTIONS.md
 `;
-  if (existsSync2(cursorRulesPath)) {
-    const existing = readFileSync(cursorRulesPath, "utf-8");
+  if (existsSync3(cursorRulesPath)) {
+    const existing = readFileSync2(cursorRulesPath, "utf-8");
     if (!existing.includes("intentdocs Integration")) {
-      writeFileSync2(cursorRulesPath, existing + "\n" + cursorBlock);
+      writeFileSync3(cursorRulesPath, existing + "\n" + cursorBlock);
       console.log("  \u2713 Updated .cursorrules");
     }
   } else {
-    writeFileSync2(cursorRulesPath, cursorBlock.trim() + "\n");
+    writeFileSync3(cursorRulesPath, cursorBlock.trim() + "\n");
     console.log("  \u2713 Created .cursorrules");
   }
   console.log(`
@@ -515,9 +572,9 @@ function setupCursor() {
 }
 function generateAgentDocs() {
   const cwd = process.cwd();
-  const archPath = join2(cwd, "ARCHITECTURE.md");
-  if (!existsSync2(archPath)) {
-    writeFileSync2(
+  const archPath = join3(cwd, "ARCHITECTURE.md");
+  if (!existsSync3(archPath)) {
+    writeFileSync3(
       archPath,
       `# Architecture
 
@@ -544,9 +601,9 @@ _Record trade-offs and why._
     );
     console.log("  \u2713 Created ARCHITECTURE.md scaffold");
   }
-  const convPath = join2(cwd, "CONVENTIONS.md");
-  if (!existsSync2(convPath)) {
-    writeFileSync2(
+  const convPath = join3(cwd, "CONVENTIONS.md");
+  if (!existsSync3(convPath)) {
+    writeFileSync3(
       convPath,
       `# Conventions
 

package/dist/{chunk-UF535HZL.js → chunk-K5SNF6CG.js}

@@ -5,6 +5,16 @@ import {
 // src/lib/config.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { join, dirname } from "path";
+function checkoutConfig(input) {
+  return {
+    apiBase: input.apiBase,
+    mapTitle: input.map.title,
+    projectId: input.project.id,
+    mapId: input.map.id,
+    workspace: input.project.workspace ? { orgId: input.project.workspace.orgId, name: input.project.workspace.name } : { orgId: null, name: null },
+    ...input.appUrl && { appUrl: input.appUrl }
+  };
+}
 var CONFIG_DIR = ".intent";
 var CONFIG_FILE = "config.json";
 function configPath() {
@@ -39,12 +49,12 @@ function writeConfig(config) {
 function requireConfig() {
   const config = readConfig();
   if (!config) {
-    console.error("Not initialized. Run: intent init");
+    console.error("Not initialized. Run: npx intentdocs init");
     process.exit(1);
   }
   if (!config.mapId) {
     console.error(
-      "This checkout was connected with a sync token, which has been retired: every sync now runs as you.\nRemove .intent/config.json and run `intentdocs login` then `intentdocs init` to reconnect."
+      "This checkout was connected with a sync token, which has been retired: every sync now runs as you.\nRemove .intent/config.json and run `npx intentdocs login` then `npx intentdocs init` to reconnect."
     );
     process.exit(1);
   }
@@ -52,6 +62,7 @@ function requireConfig() {
 }
 
 export {
+  checkoutConfig,
   hasConfig,
   readConfig,
   writeConfig,

package/dist/{chunk-HEHHSSUM.js → chunk-KPQ42YE6.js}

@@ -1,6 +1,6 @@
 import {
   getAuth
-} from "./chunk-LXQXJULN.js";
+} from "./chunk-XZE2XP6O.js";
 
 // src/lib/analytics.ts
 import { PostHog } from "posthog-node";