intentdocs 0.8.0 → 0.10.0

package/dist/{keys-EDWET3WG.js → keys-5PA3D6CX.js}

@@ -1,15 +1,16 @@
 import {
   ask,
   closePrompt
-} from "./chunk-WPVDURTJ.js";
+} from "./chunk-WRRUCCVZ.js";
 import {
-  requireAuth
-} from "./chunk-PCNDP5SX.js";
+  requireValidAuth
+} from "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
 
 // src/commands/keys.ts
 var KEYS_DOC_URL = "https://console.anthropic.com/settings/keys";
 async function byokRequest(method, body) {
-  const auth = requireAuth();
+  const auth = await requireValidAuth();
   const res = await fetch(`${auth.apiBase}/api/settings/byok`, {
     method,
     headers: {
@@ -32,7 +33,7 @@ async function keysSet(key) {
     closePrompt();
   }
   if (!value) {
-    console.error("  No key provided. Run `intent keys set` to try again.");
+    console.error("  No key provided. Run `intentdocs keys set` to try again.");
     process.exit(1);
   }
   try {
@@ -59,11 +60,11 @@ async function keysStatus() {
     }
     if (data?.enabled) {
       console.log(`
-  Anthropic API key: ${data.maskedKey ?? "(stored but unreadable \u2014 re-run `intent keys set`)"}`);
+  Anthropic API key: ${data.maskedKey ?? "(stored but unreadable \u2014 re-run `intentdocs keys set`)"}`);
       console.log("  AI features run on your key.\n");
     } else {
       console.log("\n  No Anthropic API key set.");
-      console.log("  Add one with `intent keys set` to unlock AI features on any plan.\n");
+      console.log("  Add one with `intentdocs keys set` to unlock AI features on any plan.\n");
     }
   } catch {
     console.error("  \u2717 Could not reach intentdocs. Check your connection and try again.");

package/dist/log-EVLWM64C.js

@@ -0,0 +1,206 @@
+import {
+  appendNoteToContext,
+  storyContextPath
+} from "./chunk-NFIXRIHM.js";
+import {
+  matchesStoryRef
+} from "./chunk-LQTPZL2Y.js";
+import {
+  amendDecision,
+  apiFetch,
+  listDecisions,
+  retractDecision
+} from "./chunk-YUW3W43S.js";
+import {
+  requireConfig
+} from "./chunk-UF535HZL.js";
+import {
+  ask,
+  closePrompt,
+  confirm,
+  isInteractive
+} from "./chunk-WRRUCCVZ.js";
+import "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
+
+// src/commands/log.ts
+async function logDecision(title, opts) {
+  const config = requireConfig();
+  if (!title) {
+    title = await ask("  Decision title: ");
+  }
+  let description = opts?.description;
+  if (!description) {
+    description = await ask("  Description (what was decided and why): ");
+  }
+  if (!title?.trim() || !description?.trim()) {
+    console.log("  Title and description required.");
+    closePrompt();
+    return;
+  }
+  const res = await apiFetch(config, "/decisions", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      title: title.trim(),
+      description: description.trim(),
+      category: opts?.category ?? "technical",
+      story_id: opts?.story ?? void 0
+    })
+  });
+  if (res.ok) {
+    console.log(`  \u2713 Decision logged: ${title}`);
+  } else {
+    console.error("  Failed to log decision.");
+  }
+  closePrompt();
+}
+async function findDecision(idPrefix) {
+  const config = requireConfig();
+  const { decisions } = await listDecisions(config);
+  const match = decisions.find((d) => d.id.startsWith(idPrefix));
+  if (!match) {
+    console.error(`  No decision found matching "${idPrefix}"`);
+    return null;
+  }
+  return { config, match };
+}
+async function listLoggedDecisions() {
+  const config = requireConfig();
+  const { decisions } = await listDecisions(config);
+  if (decisions.length === 0) {
+    console.log("  No decisions logged yet. Run `intent decide` to log one.");
+    return;
+  }
+  console.log();
+  for (const d of decisions) {
+    const status = d.retracted_at ? " (retracted)" : "";
+    console.log(`  ${d.id.slice(0, 8)}  [${d.category}]  ${d.title}${status}`);
+  }
+  console.log();
+}
+async function amendDecision2(idPrefix, opts) {
+  const found = await findDecision(idPrefix);
+  if (!found) {
+    closePrompt();
+    process.exitCode = 1;
+    return;
+  }
+  const { config, match } = found;
+  if (match.retracted_at) {
+    console.error(`  "${match.title}" has been retracted and can't be amended.`);
+    closePrompt();
+    process.exitCode = 1;
+    return;
+  }
+  let title = opts?.title;
+  let description = opts?.description;
+  const category = opts?.category;
+  if (!title && !description && !category) {
+    if (!isInteractive()) {
+      console.error("  Nothing to amend \u2014 pass --title, --description, and/or --category.");
+      closePrompt();
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`  Amending: "${match.title}"`);
+    title = await ask(`  New title (leave blank to keep current): `);
+    description = await ask(`  New description (leave blank to keep current): `);
+  }
+  if (!title?.trim() && !description?.trim() && !category) {
+    console.log("  Nothing changed.");
+    closePrompt();
+    return;
+  }
+  const updated = await amendDecision(config, match.id, {
+    ...title?.trim() ? { title: title.trim() } : {},
+    ...description?.trim() ? { description: description.trim() } : {},
+    ...category ? { category } : {}
+  });
+  console.log(`  \u2713 Decision amended: "${updated.title}"`);
+  closePrompt();
+}
+async function deleteDecision(idPrefix, opts) {
+  const found = await findDecision(idPrefix);
+  if (!found) {
+    closePrompt();
+    process.exitCode = 1;
+    return;
+  }
+  const { config, match } = found;
+  if (match.retracted_at) {
+    console.log(`  "${match.title}" is already retracted.`);
+    closePrompt();
+    return;
+  }
+  console.log(`  Retract: "${match.title}"`);
+  console.log(`  ${match.description}`);
+  if (!opts?.yes) {
+    if (!isInteractive()) {
+      console.error();
+      console.error(`  \u2717 Refusing to retract "${match.title}" without confirmation \u2014 no TTY is available to confirm.`);
+      console.error(`    Re-run with --yes to retract non-interactively, or run interactively to confirm.`);
+      closePrompt();
+      process.exitCode = 1;
+      return;
+    }
+    const proceed = await confirm("  Retract this decision?");
+    if (!proceed) {
+      console.log("  Not retracted.");
+      closePrompt();
+      return;
+    }
+  }
+  await retractDecision(config, match.id, opts?.reason);
+  console.log(`  \u2713 Decision retracted: "${match.title}"`);
+  closePrompt();
+}
+async function logNote(storyId, note) {
+  const config = requireConfig();
+  if (!note) {
+    note = await ask("  Note: ");
+  }
+  if (!note?.trim()) {
+    console.log("  Note required.");
+    closePrompt();
+    return;
+  }
+  const listRes = await apiFetch(config, "/stories");
+  if (!listRes.ok) {
+    console.error("  Failed to fetch stories.");
+    closePrompt();
+    return;
+  }
+  const data = await listRes.json();
+  const match = data.stories.find((s) => matchesStoryRef(s, storyId));
+  if (!match) {
+    console.error(`  No story found matching "${storyId}"`);
+    closePrompt();
+    return;
+  }
+  const res = await apiFetch(config, "/stories", {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      stories: [{ id: match.id, notes: note.trim() }]
+    })
+  });
+  if (res.ok) {
+    console.log(`  \u2713 Note added to: ${match.title.slice(0, 60)}`);
+  } else {
+    console.error("  Failed to add note.");
+  }
+  const appended = appendNoteToContext(match.id, note.trim());
+  if (appended) {
+    const relPath = storyContextPath(match.id).replace(process.cwd() + "/", "");
+    console.log(`  \u2713 Updated local context: ${relPath}`);
+  }
+  closePrompt();
+}
+export {
+  amendDecision2 as amendDecision,
+  deleteDecision,
+  listLoggedDecisions,
+  logDecision,
+  logNote
+};

package/dist/{map-extract-I3AACTGL.js → map-extract-W6WJLVOF.js}

@@ -1,6 +1,7 @@
 import {
   requireConfig
-} from "./chunk-ICOMMHKG.js";
+} from "./chunk-UF535HZL.js";
+import "./chunk-UYTVTYNB.js";
 
 // src/commands/map-extract.ts
 function mapExtract() {

package/dist/{map-import-IYUMRASO.js → map-import-LL4AIAQE.js}

@@ -1,18 +1,20 @@
-import {
-  closePrompt,
-  confirm
-} from "./chunk-WPVDURTJ.js";
 import {
   isPlanGated,
   printUpgradeMessage
-} from "./chunk-ITQUQYWB.js";
+} from "./chunk-UR73WX5I.js";
 import {
-  apiUrl
-} from "./chunk-6XKB6RTU.js";
+  apiUrl,
+  syncHeaders
+} from "./chunk-YUW3W43S.js";
 import {
   requireConfig
-} from "./chunk-ICOMMHKG.js";
-import "./chunk-PCNDP5SX.js";
+} from "./chunk-UF535HZL.js";
+import {
+  closePrompt,
+  confirm
+} from "./chunk-WRRUCCVZ.js";
+import "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
 
 // src/commands/map-import.ts
 import { readFileSync, existsSync } from "fs";
@@ -309,7 +311,7 @@ async function mapImport(filePath, opts) {
     const uploadSpinner = ora("  Uploading storymap...").start();
     const res = await fetch(apiUrl(config, "/map-import"), {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
+      headers: syncHeaders({ "Content-Type": "application/json" }),
       body: JSON.stringify(storymap)
     });
     if (!res.ok) {

package/dist/{map-schema-JVL3O2TJ.js → map-schema-6GL2UKZQ.js}

@@ -2,7 +2,7 @@
 var SCHEMA = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
   title: "IntentDocs Story Map",
-  description: "Schema for storymap.json files produced by `intent map extract` and consumed by `intent map import`.",
+  description: "Schema for storymap.json files produced by `intentdocs map extract` and consumed by `intentdocs map import`.",
   type: "object",
   required: ["schema_version", "source", "product_summary", "backbone"],
   additionalProperties: false,

package/dist/projects-F7GMH66U.js

@@ -0,0 +1,37 @@
+import {
+  authenticatedFetch,
+  bindingLabel,
+  getAuth
+} from "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
+
+// src/commands/projects.ts
+async function projects() {
+  const res = await authenticatedFetch("/api/cli/projects");
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    const said = body.message ?? (typeof body.error === "object" && body.error ? body.error.hint ?? body.error.message : void 0);
+    console.error(said ?? "Failed to fetch projects. The server returned an error \u2014 try again or check intentdocs.com for status.");
+    process.exit(1);
+  }
+  const data = await res.json();
+  console.log(`
+  ${data.workspace}`);
+  console.log(`  Token ${bindingLabel(getAuth()?.binding)}
+`);
+  if (data.projects.length === 0) {
+    console.log("  No projects here yet. Create one at intentdocs.com first.\n");
+    return;
+  }
+  for (const p of data.projects) {
+    const where = p.workspace ? ` \xB7 ${p.workspace.name ?? "workspace"}` : "";
+    console.log(`  ${p.id}  ${p.name}${where}`);
+    if (p.description) console.log(`    ${p.description.slice(0, 100)}`);
+  }
+  console.log(`
+  ${data.projects.length} ${data.projects.length === 1 ? "project" : "projects"}. Check one out with: intentdocs init
+`);
+}
+export {
+  projects
+};

package/dist/{prompt-WAWCRGHN.js → prompt-GOAFIKBZ.js}

@@ -4,13 +4,15 @@ import {
   choose,
   closePrompt,
   confirm,
+  isInteractive,
   pausePrompt
-} from "./chunk-WPVDURTJ.js";
+} from "./chunk-WRRUCCVZ.js";
 export {
   ask,
   askMultiline,
   choose,
   closePrompt,
   confirm,
+  isInteractive,
   pausePrompt
 };

package/dist/{research-6SXJ37TI.js → research-4ASCZSZN.js}

@@ -1,18 +1,20 @@
-import {
-  ask,
-  closePrompt
-} from "./chunk-WPVDURTJ.js";
 import {
   isPlanGated,
   printUpgradeMessage
-} from "./chunk-ITQUQYWB.js";
+} from "./chunk-UR73WX5I.js";
 import {
-  apiUrl
-} from "./chunk-6XKB6RTU.js";
+  apiUrl,
+  syncHeaders
+} from "./chunk-YUW3W43S.js";
 import {
   requireConfig
-} from "./chunk-ICOMMHKG.js";
-import "./chunk-PCNDP5SX.js";
+} from "./chunk-UF535HZL.js";
+import {
+  ask,
+  closePrompt
+} from "./chunk-WRRUCCVZ.js";
+import "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
 
 // src/commands/research.ts
 import ora from "ora";
@@ -31,7 +33,7 @@ async function research(query) {
   try {
     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) {

package/dist/scope-S3LZZ3KB.js

@@ -0,0 +1,11 @@
+import {
+  scope
+} from "./chunk-5USVG4DW.js";
+import "./chunk-YUW3W43S.js";
+import "./chunk-UF535HZL.js";
+import "./chunk-WRRUCCVZ.js";
+import "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
+export {
+  scope
+};

package/dist/setup-YLUPBLK6.js

@@ -0,0 +1,14 @@
+import {
+  setup
+} from "./chunk-EEKEF2FD.js";
+import "./chunk-HEHHSSUM.js";
+import "./chunk-NFIXRIHM.js";
+import "./chunk-LQTPZL2Y.js";
+import "./chunk-YUW3W43S.js";
+import "./chunk-UF535HZL.js";
+import "./chunk-WRRUCCVZ.js";
+import "./chunk-LXQXJULN.js";
+import "./chunk-UYTVTYNB.js";
+export {
+  setup
+};

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "intentdocs",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "CLI for intentdocs.com — intent-driven development: connect your codebase to your product specs",
   "bin": {
+    "intentdocs": "bin/intentdocs.js",
     "intent": "bin/intent.js"
   },
   "scripts": {
-    "build": "tsup --clean && chmod +x dist/index.js && chmod +x bin/intent.js",
+    "build": "tsup --clean && chmod +x dist/index.js && chmod +x bin/intent.js && chmod +x bin/intentdocs.js",
+    "postinstall": "echo '\\n  intentdocs installed.\\n  Commands: intentdocs (canonical), intent (alias — may collide with other tools)\\n'",
     "dev": "tsup --watch",
     "test": "vitest run",
     "prepublishOnly": "npm run build"

package/dist/chunk-6XKB6RTU.js

@@ -1,123 +0,0 @@
-import {
-  writeConfig
-} from "./chunk-ICOMMHKG.js";
-import {
-  getAuth
-} from "./chunk-PCNDP5SX.js";
-
-// src/lib/api.ts
-var AuthError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "AuthError";
-  }
-};
-async function refreshSyncToken(config) {
-  const auth = getAuth();
-  if (!auth || !config.projectId || !config.mapId) return null;
-  try {
-    const res = await fetch(
-      `${auth.apiBase}/api/cli/projects/${config.projectId}/maps`,
-      { headers: { Authorization: `Bearer ${auth.token}`, "Content-Type": "application/json" } }
-    );
-    if (!res.ok) return null;
-    const { maps } = await res.json();
-    const map = maps.find((m) => m.id === config.mapId);
-    if (!map) return null;
-    const updated = { ...config, syncToken: map.syncToken };
-    writeConfig(updated);
-    return map.syncToken;
-  } catch {
-    return null;
-  }
-}
-async function apiFetch(config, path, init) {
-  const res = await fetch(apiUrl(config, path), init);
-  if (res.status === 401) {
-    const newToken = await refreshSyncToken(config);
-    if (newToken) {
-      const refreshedConfig = { ...config, syncToken: newToken };
-      const retry = await fetch(apiUrl(refreshedConfig, path), init);
-      if (retry.ok) return retry;
-    }
-    throw new AuthError(
-      "Session expired. Run `intent login` then `intent init` to re-authenticate."
-    );
-  }
-  if (res.status === 403) {
-    throw new AuthError(
-      "Access denied. You may not have permission for this project. Run `intent login`."
-    );
-  }
-  if (!res.ok) throw new Error(`API error: ${res.status}`);
-  return res;
-}
-function apiUrl(config, path) {
-  return `${config.apiBase}/api/sync/${config.syncToken}${path}`;
-}
-async function listStories(config) {
-  const res = await apiFetch(config, "/stories");
-  return res.json();
-}
-async function getContext(config) {
-  const res = await apiFetch(config, "/context");
-  return res.text();
-}
-async function updateStories(config, stories) {
-  const res = await apiFetch(config, "/stories", {
-    method: "PATCH",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ stories })
-  });
-  return res.json();
-}
-async function uploadScreenshot(config, storyId, screenshot) {
-  try {
-    const form = new FormData();
-    form.append("story_id", storyId);
-    form.append("image", new Blob([screenshot.buffer], { type: screenshot.mimeType }), screenshot.filename);
-    const res = await apiFetch(config, "/screenshots", {
-      method: "POST",
-      body: form
-    });
-    return await res.json();
-  } catch {
-    return null;
-  }
-}
-async function createStories(config, stories) {
-  const res = await apiFetch(config, "/stories", {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ stories })
-  });
-  return res.json();
-}
-async function reportCriteria(config, storyId, results) {
-  const res = await apiFetch(config, "/criteria", {
-    method: "PATCH",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ story_id: storyId, results })
-  });
-  return res.json();
-}
-async function raiseBlocker(config, payload) {
-  const res = await apiFetch(config, "/blocker", {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload)
-  });
-  return res.json();
-}
-
-export {
-  apiFetch,
-  apiUrl,
-  listStories,
-  getContext,
-  updateStories,
-  uploadScreenshot,
-  createStories,
-  reportCriteria,
-  raiseBlocker
-};

package/dist/chunk-PCNDP5SX.js

@@ -1,34 +0,0 @@
-// src/lib/auth.ts
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-var AUTH_DIR = join(homedir(), ".intent");
-var AUTH_FILE = join(AUTH_DIR, "auth.json");
-function getAuth() {
-  try {
-    const raw = readFileSync(AUTH_FILE, "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-function saveAuth(data) {
-  if (!existsSync(AUTH_DIR)) mkdirSync(AUTH_DIR, { recursive: true });
-  writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2) + "\n", { mode: 384 });
-}
-function requireAuth() {
-  const auth = getAuth();
-  if (!auth) {
-    console.error("Not logged in. Run: intent login");
-    process.exit(1);
-  }
-  return auth;
-}
-var API_BASE = "https://intentdocs.com";
-
-export {
-  getAuth,
-  saveAuth,
-  requireAuth,
-  API_BASE
-};