intentdocs 0.10.0 → 0.10.1

package/README.md

@@ -98,6 +98,11 @@ intent sync          # Refresh INTENT.md
 intent sync --context  # Regenerate CLAUDE.md from your project page
 ```
 
+`intent` is a short alias for typing. Another tool on your machine may also be
+called `intent`, so everything the CLI writes for your agent (CLAUDE.md, slash
+commands, hints) spells commands as `npx intentdocs …`, which always runs this
+package.
+
 ---
 
 ## All Commands

package/dist/{chunk-YUW3W43S.js → chunk-34JCN66H.js}

@@ -1,6 +1,6 @@
 import {
   getAuth
-} from "./chunk-LXQXJULN.js";
+} from "./chunk-XZE2XP6O.js";
 
 // src/lib/api.ts
 var AuthError = class extends Error {
@@ -15,11 +15,11 @@ function checkoutMismatch(config, binding) {
   const checkoutName = checkout.name ?? "another workspace";
   const here = config.mapTitle ? `"${config.mapTitle}"` : "this checkout";
   if (!binding) {
-    return `${here} belongs to ${checkoutName}, but your token is personal. Run \`intentdocs login\` and choose ${checkoutName}.`;
+    return `${here} belongs to ${checkoutName}, but your token is personal. Run \`npx intentdocs login\` and choose ${checkoutName}.`;
   }
   if (binding.orgId !== checkout.orgId) {
     const bound = binding.workspaceName ?? "a different workspace";
-    return `This checkout is ${checkoutName}'s \u2014 ${here} \u2014 but your token is bound to ${bound}. Run \`intentdocs login\` and choose ${checkoutName}, or work from a checkout of ${bound}'s.`;
+    return `This checkout is ${checkoutName}'s \u2014 ${here} \u2014 but your token is bound to ${bound}. Run \`npx intentdocs login\` and choose ${checkoutName}, or work from a checkout of ${bound}'s.`;
   }
   return null;
 }
@@ -47,13 +47,13 @@ async function apiFetch(config, path, init) {
   const mismatch = checkoutMismatch(config, auth?.binding);
   if (mismatch) throw new AuthError(mismatch);
   if (!auth?.token) {
-    throw new AuthError("Not logged in \u2014 every sync runs as you now. Run `intentdocs login`.");
+    throw new AuthError("Not logged in \u2014 every sync runs as you now. Run `npx intentdocs login`.");
   }
   const withBearer = { ...init, headers: syncHeaders(init?.headers, auth) };
   const res = await fetch(apiUrl(config, path), withBearer);
   if (res.status === 401) {
     const said = await refusalMessage(res);
-    throw new AuthError(said ?? "Your login is no longer valid. Run `intentdocs login`.");
+    throw new AuthError(said ?? "Your login is no longer valid. Run `npx intentdocs login`.");
   }
   if (res.status === 404) {
     const said = await refusalMessage(res);
@@ -62,7 +62,7 @@ async function apiFetch(config, path, init) {
   if (res.status === 403) {
     const said = await refusalMessage(res);
     throw new AuthError(
-      said ?? "Access denied \u2014 you may not have permission for this project. Run `intentdocs login` to re-authenticate."
+      said ?? "Access denied \u2014 you may not have permission for this project. Run `npx intentdocs login` to re-authenticate."
     );
   }
   if (!res.ok) throw new Error(`API error: ${res.status}`);
@@ -70,7 +70,7 @@ async function apiFetch(config, path, init) {
 }
 function apiUrl(config, path) {
   if (!config.mapId) {
-    throw new AuthError("This checkout has no map id. Run `intentdocs init` to reconnect it.");
+    throw new AuthError("This checkout has no map id. Run `npx intentdocs init` to reconnect it.");
   }
   return `${config.apiBase}/api/sync/${config.mapId}${path}`;
 }

package/dist/{chunk-IDNUBI2P.js → chunk-6X4BORMW.js}

@@ -1,10 +1,10 @@
 import {
   captureCli,
   shutdownCliAnalytics
-} from "./chunk-HEHHSSUM.js";
+} from "./chunk-KPQ42YE6.js";
 import {
   requireConfig
-} from "./chunk-UF535HZL.js";
+} from "./chunk-JX2RLGOM.js";
 import {
   closePrompt,
   confirm,
@@ -13,7 +13,7 @@ import {
 import {
   authenticatedFetch,
   requireValidAuth
-} from "./chunk-LXQXJULN.js";
+} from "./chunk-XZE2XP6O.js";
 import {
   canonicalApiBase
 } from "./chunk-UYTVTYNB.js";
@@ -173,7 +173,7 @@ async function listKeys(projectId) {
 async function reportStatus(projectId) {
   const keys = (await listKeys(projectId)).filter((k) => !k.revoked_at);
   if (keys.length === 0) {
-    console.log("No CI key yet. Run `intentdocs ci` to set up test reporting.");
+    console.log("No CI key yet. Run `npx intentdocs ci` to set up test reporting.");
     return;
   }
   const reported = keys.filter((k) => k.last_report_at);
@@ -198,7 +198,7 @@ async function ci(opts = {}) {
   await requireValidAuth();
   const projectId = config.projectId;
   if (!projectId) {
-    console.error("This checkout has no project id. Run `intentdocs init` to reconnect.");
+    console.error("This checkout has no project id. Run `npx intentdocs init` to reconnect.");
     process.exit(1);
   }
   if (opts.status) {
@@ -278,7 +278,7 @@ Tell your agent to save each test with its file and full name so CI results can
       { project: projectId }
     );
     console.log(`
-After your next default-branch CI run, check how results matched with: intentdocs ci --status
+After your next default-branch CI run, check how results matched with: npx intentdocs ci --status
 `);
   } finally {
     closePrompt();

package/dist/{chunk-NFIXRIHM.js → chunk-F52HPVNQ.js}

@@ -124,11 +124,11 @@ function writeStoryContext(story) {
     ...approachSection,
     `## Implementation notes`,
     ``,
-    `_Notes added via \`intentdocs note ${storyRef(story)} "..."\`_`,
+    `_Notes added via \`npx intentdocs note ${storyRef(story)} "..."\`_`,
     ``,
     `## Decisions`,
     ``,
-    `_Log decisions via \`intentdocs decide "..." -s ${storyRef(story)}\`_`,
+    `_Log decisions via \`npx intentdocs decide "..." -s ${storyRef(story)}\`_`,
     ``,
     `## Relevant files`,
     ``,
@@ -136,7 +136,7 @@ function writeStoryContext(story) {
     ``,
     `---`,
     ``,
-    `Mark done: \`intentdocs done ${storyRef(story)}\``
+    `Mark done: \`npx intentdocs done ${storyRef(story)}\``
   ].join("\n");
   const path = storyContextPath(story.id);
   writeFileSync(path, md);

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

@@ -39,12 +39,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);
   }

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";

package/dist/{chunk-5USVG4DW.js → chunk-NHNBCNND.js}

@@ -1,9 +1,9 @@
 import {
   getContext
-} from "./chunk-YUW3W43S.js";
+} from "./chunk-34JCN66H.js";
 import {
   writeConfig
-} from "./chunk-UF535HZL.js";
+} from "./chunk-JX2RLGOM.js";
 import {
   ask,
   closePrompt,
@@ -12,7 +12,7 @@ import {
 import {
   authenticatedFetch,
   requireValidAuth
-} from "./chunk-LXQXJULN.js";
+} from "./chunk-XZE2XP6O.js";
 import {
   API_BASE
 } from "./chunk-UYTVTYNB.js";
@@ -176,7 +176,7 @@ async function scope(projectId) {
     "  Configure your AI tool (Claude Code / Cursor) with intentdocs agent workflows?"
   );
   if (wantSetup) {
-    const { setup } = await import("./setup-YLUPBLK6.js");
+    const { setup } = await import("./setup-WSYIG2CR.js");
     await setup();
     return;
   }
@@ -184,10 +184,10 @@ async function scope(projectId) {
   \u2705 Your project is scoped and ready to build!
 
   Next steps:
-    \u2022 intent setup          \u2014 configure your AI tool
-    \u2022 intent status         \u2014 see your story map progress
-    \u2022 intent next           \u2014 see what to build first
-    \u2022 intent done <id>      \u2014 mark stories as you complete them
+    \u2022 npx intentdocs setup          \u2014 configure your AI tool
+    \u2022 npx intentdocs status         \u2014 see your story map progress
+    \u2022 npx intentdocs next           \u2014 see what to build first
+    \u2022 npx intentdocs done <id>      \u2014 mark stories as you complete them
 
   Your story map is also live at ${API_BASE}
   Seek advice from the community and our resources.

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

@@ -1,26 +1,26 @@
 import {
   captureCli,
   shutdownCliAnalytics
-} from "./chunk-HEHHSSUM.js";
+} from "./chunk-KPQ42YE6.js";
 import {
   writeStoryContext
-} from "./chunk-NFIXRIHM.js";
+} from "./chunk-F52HPVNQ.js";
 import {
   apiFetch,
   getContext,
   listStories
-} from "./chunk-YUW3W43S.js";
+} from "./chunk-34JCN66H.js";
 import {
   hasConfig,
   requireConfig
-} from "./chunk-UF535HZL.js";
+} from "./chunk-JX2RLGOM.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";
@@ -124,7 +124,7 @@ async function sync(opts) {
 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 +142,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,13 +162,13 @@ 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();
 }
@@ -179,20 +179,20 @@ function setupClaudeCode() {
 # 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");
@@ -219,7 +219,7 @@ story map, decisions, examples, tools, and guardrails.
     join2(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
@@ -233,7 +233,7 @@ story map, decisions, examples, tools, and guardrails.
 
 ## 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 +254,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
@@ -299,9 +299,9 @@ 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
 `
@@ -310,7 +310,7 @@ story map, decisions, examples, tools, and guardrails.
     join2(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
@@ -319,16 +319,16 @@ story map, decisions, examples, tools, and guardrails.
   );
   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.`
+    `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
+    `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(
@@ -336,10 +336,10 @@ Both decisions and notes flow back to the project page on intentdocs.com.`
     `# 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,7 +347,7 @@ 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"),
@@ -360,18 +360,18 @@ 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(
@@ -386,13 +386,13 @@ 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.
@@ -404,13 +404,13 @@ The file is at \`.intent/stories/<full-story-id>.md\` \u2014 read it directly.
 
 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..."
@@ -423,7 +423,7 @@ Good decisions to log:
 
 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,7 +431,7 @@ 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();
@@ -464,12 +464,12 @@ function setupCursor() {
 3. **CONVENTIONS.md** \u2014 coding patterns, naming, file structure
 
 ## 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 +480,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

package/dist/{chunk-UR73WX5I.js → chunk-UQDMUKLP.js}

@@ -3,14 +3,14 @@ import chalk from "chalk";
 function isPlanGated(status) {
   return status === 402 || status === 403;
 }
-var UPGRADE_MESSAGE_PLAIN = "This feature requires a Pro plan or your own Anthropic key.\n  Upgrade: https://intentdocs.com/pricing\n  Or add your key: intent keys set";
+var UPGRADE_MESSAGE_PLAIN = "This feature requires a Pro plan or your own Anthropic key.\n  Upgrade: https://intentdocs.com/pricing\n  Or add your key: npx intentdocs keys set";
 function printUpgradeMessage() {
   console.log();
   console.log(
     `  ${chalk.yellow("This feature requires a Pro plan or your own Anthropic key.")}`
   );
   console.log(`    Upgrade: ${chalk.cyan.underline("https://intentdocs.com/pricing")}`);
-  console.log(`    Or add your key: ${chalk.cyan("intentdocs keys set")}`);
+  console.log(`    Or add your key: ${chalk.cyan("npx intentdocs keys set")}`);
   console.log();
 }
 

package/dist/{chunk-LXQXJULN.js → chunk-XZE2XP6O.js}

@@ -66,14 +66,14 @@ async function requireValidAuth() {
   if (result.valid) return result.auth;
   switch (result.reason) {
     case "no_file":
-      console.error("Not logged in \u2014 no auth credentials found. Run: intentdocs login");
+      console.error("Not logged in \u2014 no auth credentials found. Run: npx intentdocs login");
       break;
     case "revoked":
-      console.error("Your auth token has been revoked. Run: intentdocs login");
+      console.error("Your auth token has been revoked. Run: npx intentdocs login");
       clearAuth();
       break;
     case "not_found":
-      console.error("Your auth token is no longer valid (it may have been deleted). Run: intentdocs login");
+      console.error("Your auth token is no longer valid (it may have been deleted). Run: npx intentdocs login");
       clearAuth();
       break;
     case "network_error":

package/dist/ci-XCOXFTLB.js

@@ -0,0 +1,11 @@
+import {
+  ci
+} from "./chunk-6X4BORMW.js";
+import "./chunk-KPQ42YE6.js";
+import "./chunk-JX2RLGOM.js";
+import "./chunk-WRRUCCVZ.js";
+import "./chunk-XZE2XP6O.js";
+import "./chunk-UYTVTYNB.js";
+export {
+  ci
+};

package/dist/{complexity-ZOB3BPVD.js → complexity-X3IJKNNV.js}

@@ -1,7 +1,7 @@
 import {
   isPlanGated,
   printUpgradeMessage
-} from "./chunk-UR73WX5I.js";
+} from "./chunk-UQDMUKLP.js";
 import {
   matchesStoryRef
 } from "./chunk-LQTPZL2Y.js";
@@ -9,11 +9,11 @@ import {
   apiUrl,
   listStories,
   syncHeaders
-} from "./chunk-YUW3W43S.js";
+} from "./chunk-34JCN66H.js";
 import {
   requireConfig
-} from "./chunk-UF535HZL.js";
-import "./chunk-LXQXJULN.js";
+} from "./chunk-JX2RLGOM.js";
+import "./chunk-XZE2XP6O.js";
 import "./chunk-UYTVTYNB.js";
 
 // src/commands/complexity.ts

package/dist/{import-prd-MJUCIMHX.js → import-prd-IJTM6FZE.js}

@@ -1,19 +1,19 @@
 import {
   isPlanGated,
   printUpgradeMessage
-} from "./chunk-UR73WX5I.js";
+} from "./chunk-UQDMUKLP.js";
 import {
   apiUrl,
   syncHeaders
-} from "./chunk-YUW3W43S.js";
+} from "./chunk-34JCN66H.js";
 import {
   requireConfig
-} from "./chunk-UF535HZL.js";
+} from "./chunk-JX2RLGOM.js";
 import {
   closePrompt,
   confirm
 } from "./chunk-WRRUCCVZ.js";
-import "./chunk-LXQXJULN.js";
+import "./chunk-XZE2XP6O.js";
 import "./chunk-UYTVTYNB.js";
 
 // src/commands/import-prd.ts