intentdocs 0.10.1 → 0.11.0

package/dist/{keys-UVXCCWCS.js → keys-2W5V56FS.js}

@@ -9,6 +9,16 @@ import "./chunk-UYTVTYNB.js";
 
 // src/commands/keys.ts
 var KEYS_DOC_URL = "https://console.anthropic.com/settings/keys";
+var XAI_KEYS_URL = "https://console.x.ai/";
+var ANTHROPIC_RE = /^sk-ant-[A-Za-z0-9_-]{24,250}$/;
+var XAI_RE = /^xai-[A-Za-z0-9_-]{20,250}$/;
+var OPENAI_PROJ_RE = /^sk-proj-[A-Za-z0-9_-]{20,250}$/;
+var OPENAI_SK_RE = /^sk-[A-Za-z0-9_-]{20,250}$/;
+function acceptedLocally(value) {
+  if (ANTHROPIC_RE.test(value) || XAI_RE.test(value) || OPENAI_PROJ_RE.test(value)) return true;
+  if (!OPENAI_SK_RE.test(value)) return false;
+  return !/^(sk-ant-|sk-proj-|sk-admin-|sk-svcacct-)/.test(value);
+}
 async function byokRequest(method, body) {
   const auth = await requireValidAuth();
   const res = await fetch(`${auth.apiBase}/api/settings/byok`, {
@@ -25,17 +35,22 @@ async function byokRequest(method, body) {
 async function keysSet(key) {
   let value = key?.trim();
   if (!value) {
-    console.log("\n  Optionally add your Anthropic API key to unlock AI features on any plan.");
+    console.log("\n  Optionally add an Anthropic, xAI, or OpenAI API key to unlock AI features on any plan.");
     console.log("  Your key is encrypted at rest and only used for your AI operations.");
-    console.log(`  Get one at: ${KEYS_DOC_URL}
-`);
-    value = (await ask("  Anthropic API key (sk-ant-...): ")).trim();
+    console.log(`  Anthropic keys start with sk-ant-. Get one at: ${KEYS_DOC_URL}`);
+    console.log(`  xAI keys start with xai-. Get one at: ${XAI_KEYS_URL}`);
+    console.log("  OpenAI keys start with sk- or sk-proj-. Get one at: https://platform.openai.com/api-keys\n");
+    value = (await ask("  API key (sk-ant-..., xai-..., sk-..., or sk-proj-...): ")).trim();
     closePrompt();
   }
   if (!value) {
     console.error("  No key provided. Run `npx intentdocs keys set` to try again.");
     process.exit(1);
   }
+  if (!acceptedLocally(value)) {
+    console.error("\n  \u2717 That key is not accepted. Use an sk-ant- key, an xai- key, an sk- key, or an sk-proj- key.");
+    process.exit(1);
+  }
   try {
     const { ok, data } = await byokRequest("POST", { key: value });
     if (!ok) {
@@ -59,12 +74,18 @@ async function keysStatus() {
       process.exit(1);
     }
     if (data?.enabled) {
+      const anthropic = data.anthropic?.mask || "not set";
+      const xai = data.xai?.mask || "not set";
+      const openai = data.openai?.mask || "not set";
       console.log(`
-  Anthropic API key: ${data.maskedKey ?? "(stored but unreadable \u2014 re-run `npx intentdocs keys set`)"}`);
-      console.log("  AI features run on your key.\n");
+  Anthropic API key: ${anthropic}`);
+      console.log(`  xAI API key: ${xai}`);
+      console.log(`  OpenAI API key: ${openai}`);
+      if (data.active_provider) console.log(`  Active: ${data.active_provider}`);
+      console.log("  AI features run on your active key.\n");
     } else {
-      console.log("\n  No Anthropic API key set.");
-      console.log("  Add one with `npx intentdocs keys set` to unlock AI features on any plan.\n");
+      console.log("\n  No API key set.");
+      console.log("  Add an sk-ant-, xai-, sk-, or sk-proj- key with `npx 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.");
@@ -78,7 +99,7 @@ async function keysRemove() {
       console.error("  \u2717 Failed to remove your key.");
       process.exit(1);
     }
-    console.log("\n  Key removed. AI features fall back to your plan's platform limits.\n");
+    console.log("\n  Key removed. Revoke it at the provider. AI features fall back when no key remains.\n");
   } catch {
     console.error("  \u2717 Could not reach intentdocs. Check your connection and try again.");
     process.exit(1);

package/dist/{log-XIH4BGFL.js → log-DFCCAAJN.js}

@@ -1,7 +1,10 @@
+import {
+  appendToNotes
+} from "./chunk-GFKZ5CRL.js";
 import {
   appendNoteToContext,
   storyContextPath
-} from "./chunk-F52HPVNQ.js";
+} from "./chunk-BNEU6TLJ.js";
 import {
   matchesStoryRef
 } from "./chunk-LQTPZL2Y.js";
@@ -9,11 +12,12 @@ import {
   amendDecision,
   apiFetch,
   listDecisions,
+  listStories,
   retractDecision
-} from "./chunk-34JCN66H.js";
+} from "./chunk-KTGQO3AE.js";
 import {
   requireConfig
-} from "./chunk-JX2RLGOM.js";
+} from "./chunk-K5SNF6CG.js";
 import {
   ask,
   closePrompt,
@@ -38,6 +42,18 @@ async function logDecision(title, opts) {
     closePrompt();
     return;
   }
+  let storyId;
+  if (opts?.story) {
+    const { stories } = await listStories(config);
+    const match = stories.find((s) => matchesStoryRef(s, opts.story));
+    if (!match) {
+      console.error(`  No story found matching "${opts.story}" \u2014 decision not logged.`);
+      closePrompt();
+      process.exitCode = 1;
+      return;
+    }
+    storyId = match.id;
+  }
   const res = await apiFetch(config, "/decisions", {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -45,7 +61,7 @@ async function logDecision(title, opts) {
       title: title.trim(),
       description: description.trim(),
       category: opts?.category ?? "technical",
-      story_id: opts?.story ?? void 0
+      story_id: storyId
     })
   });
   if (res.ok) {
@@ -182,7 +198,7 @@ async function logNote(storyId, note) {
     method: "PATCH",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
-      stories: [{ id: match.id, notes: note.trim() }]
+      stories: [{ id: match.id, notes: appendToNotes(match.notes, note) }]
     })
   });
   if (res.ok) {

package/dist/{map-extract-V6D27I3H.js → map-extract-YUCFLGJS.js}

@@ -1,6 +1,6 @@
 import {
   requireConfig
-} from "./chunk-JX2RLGOM.js";
+} from "./chunk-K5SNF6CG.js";
 import "./chunk-UYTVTYNB.js";
 
 // src/commands/map-extract.ts

package/dist/{map-import-LORTI4K4.js → map-import-7RN2NEUZ.js}

@@ -5,10 +5,10 @@ import {
 import {
   apiUrl,
   syncHeaders
-} from "./chunk-34JCN66H.js";
+} from "./chunk-KTGQO3AE.js";
 import {
   requireConfig
-} from "./chunk-JX2RLGOM.js";
+} from "./chunk-K5SNF6CG.js";
 import {
   closePrompt,
   confirm
@@ -322,11 +322,12 @@ async function mapImport(filePath, opts) {
         return;
       }
       if (res.status === 401) {
-        uploadSpinner.fail("  Sync token expired or invalid");
+        uploadSpinner.fail("  Your login is no longer valid");
         console.error(
-          "\n  Your sync token has expired. Run \x1B[36mstc link\x1B[0m to generate a fresh one.\n"
+          "\n  Run \x1B[36mnpx intentdocs login\x1B[0m to log in again, then re-run the import.\n"
         );
         closePrompt();
+        process.exitCode = 1;
         return;
       }
       uploadSpinner.fail("  Upload failed");

package/dist/push-33V7ANJW.js

@@ -0,0 +1,462 @@
+import {
+  login
+} from "./chunk-64I7RLP3.js";
+import {
+  checkoutMismatch
+} from "./chunk-KTGQO3AE.js";
+import {
+  checkoutConfig,
+  readConfig,
+  writeConfig
+} from "./chunk-K5SNF6CG.js";
+import {
+  choose,
+  closePrompt,
+  isInteractive
+} from "./chunk-WRRUCCVZ.js";
+import {
+  authenticatedFetch,
+  getAuth
+} from "./chunk-XZE2XP6O.js";
+import "./chunk-UYTVTYNB.js";
+
+// src/commands/push.ts
+import { exec } from "child_process";
+
+// src/lib/intent-folder.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { basename, dirname, join, relative } from "path";
+import { parse } from "yaml";
+var VISION_SECTIONS = ["Users", "Problem", "Switch", "First", "Proof"];
+var STORY_ID = /^[A-Z][A-Z0-9]{0,9}-[0-9]+$/;
+var PRIORITIES = ["must", "should", "could", "wont"];
+var STATUS = { todo: "todo", in_progress: "in_progress", needs_rework: "needs_rework", done: "dev_complete" };
+function findIntentDir(start) {
+  return existsSync(join(start, "storymap.yaml")) ? start : join(start, "intent");
+}
+function walk(dir, ext) {
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir).sort().flatMap((f) => {
+    const p = join(dir, f);
+    if (statSync(p).isDirectory()) return walk(p, ext);
+    return p.endsWith(ext) ? [p] : [];
+  });
+}
+function frontMatter(text) {
+  const m = /^---\n([\s\S]*?)\n---\n?/.exec(text);
+  if (!m) return null;
+  const meta = parse(m[1]) ?? {};
+  return { meta, body: text.slice(m[0].length) };
+}
+function sections(body) {
+  return [...body.matchAll(/^## (.+)\n([\s\S]*?)(?=^## |(?![\s\S]))/gm)].map((s) => ({ title: s[1].trim(), text: s[2].trim() }));
+}
+function tagsOf(line) {
+  return line.trim().split(/\s+/).filter((t) => t.startsWith("@")).map((t) => t.slice(1));
+}
+var EFFORTS = ["XS", "S", "M", "L", "XL"];
+function effortOf(tags) {
+  const tag = tags.find((t) => t.startsWith("effort-"))?.slice("effort-".length).toUpperCase();
+  if (!tag) return null;
+  return EFFORTS.includes(tag) ? tag : "M";
+}
+function priorityOf(tags) {
+  return tags.find((t) => PRIORITIES.includes(t)) ?? null;
+}
+function stepsSentence(steps) {
+  return steps.map(({ keyword, text }, i) => {
+    const k = keyword.toLowerCase();
+    if (k === "and" || k === "but") return `${k} ${text}`;
+    return i === 0 ? `${keyword} ${text}` : `, ${k} ${text}`;
+  }).join(" ").replace(/ ,/g, ",");
+}
+function parseFeature(text) {
+  const lines = text.split("\n");
+  const featureAt = lines.findIndex((l) => l.trim().startsWith("Feature:"));
+  if (featureAt < 0) return null;
+  const tags = lines.slice(0, featureAt).flatMap(tagsOf);
+  const title = lines[featureAt].trim().slice("Feature:".length).trim();
+  let asA = "";
+  let iWant = "";
+  let soThat = "";
+  const criteria = [];
+  let pendingTags = [];
+  let current = null;
+  const flush = () => {
+    if (current) criteria.push({ label: current.label, title: current.title, text: stepsSentence(current.steps), priority: current.priority });
+    current = null;
+  };
+  for (const raw of lines.slice(featureAt + 1)) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    if (line.startsWith("@")) {
+      pendingTags.push(...tagsOf(line));
+      continue;
+    }
+    const scenario = /^Scenario(?: Outline)?:\s*(.*)$/.exec(line);
+    if (scenario) {
+      flush();
+      const name = scenario[1].trim();
+      const label = pendingTags.find((t) => /^AC\d+$/.test(t)) ?? /^(AC\d+)\b/.exec(name)?.[1] ?? "";
+      current = { label, title: name.replace(/^AC\d+\s*[—–-]\s*/, ""), priority: priorityOf(pendingTags), steps: [] };
+      pendingTags = [];
+      continue;
+    }
+    const step = /^(Given|When|Then|And|But)\s+(.*)$/.exec(line);
+    if (step && current) {
+      current.steps.push({ keyword: step[1], text: step[2] });
+      continue;
+    }
+    if (!current) {
+      const story = /^(As (?:a|an|the)\b.*|I want\b.*|So that\b.*)$/i.exec(line);
+      if (story) {
+        const s = story[1];
+        if (/^as /i.test(s)) asA = s.replace(/^As (a|an|the)\s+/i, "");
+        else if (/^i want/i.test(s)) iWant = s.replace(/^I want( to)?\s+/i, "");
+        else soThat = s.replace(/^So that\s+/i, "");
+      }
+    }
+  }
+  flush();
+  return { tags, title, asA, iWant, soThat, criteria };
+}
+function parsePlanSteps(body) {
+  return sections(body).map(({ title, text }) => {
+    const field = (name) => new RegExp(`^\\*\\*${name}:\\*\\*\\s*(.*)$`, "m").exec(text)?.[1]?.trim() ?? "";
+    const list = (name) => field(name).split(",").map((s) => s.trim()).filter(Boolean);
+    const notes = text.split("\n").filter((l) => !/^\*\*(Why|Criteria|Files|Tests|Needs you):\*\*/.test(l.trim())).join("\n").trim();
+    const needs = field("Needs you");
+    return {
+      title: title.replace(/^\d+\.\s*/, ""),
+      why: field("Why"),
+      criteria: list("Criteria"),
+      files: list("Files"),
+      tests: list("Tests"),
+      needs_you: needs ? { question: needs } : null,
+      agent_notes: notes
+    };
+  });
+}
+function parseDecisions(text) {
+  const uncommented = text.replace(/<!--[\s\S]*?-->/g, "");
+  return sections(uncommented).map(({ title, text: body }) => {
+    const heading = /^(\d{4}-\d{2}-\d{2})\s*[—–-]\s*(.*?)(?:\s+\(([A-Z][A-Z0-9]{0,9}-\d+)\))?$/.exec(title);
+    const category = /^\*\*Category:\*\*\s*(.*)$/m.exec(body)?.[1]?.trim() ?? "architecture";
+    const description = body.split("\n").filter((l) => !/^\*\*(Category|Supersedes):\*\*/.test(l.trim())).join("\n").trim();
+    return {
+      title: heading?.[2] ?? title,
+      description,
+      category,
+      date: heading?.[1] ?? "",
+      story: heading?.[3] ?? null
+    };
+  });
+}
+function readIntentFolder(start) {
+  const dir = findIntentDir(start);
+  const errors = [];
+  const fail = () => ({ ok: false, dir, errors });
+  const file = (name) => join(dir, name);
+  if (!existsSync(dir)) return { ok: false, dir, errors: ["No intent/ folder here. Run `npx nikos init` first, or push from the repo root."] };
+  for (const name of ["constitution.md", "storymap.yaml", "state.yaml"]) {
+    if (!existsSync(file(name))) errors.push(`${name} is missing`);
+  }
+  if (errors.length) return fail();
+  let storymap;
+  let state;
+  try {
+    storymap = parse(readFileSync(file("storymap.yaml"), "utf-8")) ?? {};
+    state = parse(readFileSync(file("state.yaml"), "utf-8")) ?? {};
+  } catch (err) {
+    errors.push(`invalid YAML: ${err.message.split("\n")[0]}`);
+    return fail();
+  }
+  const constitution = frontMatter(readFileSync(file("constitution.md"), "utf-8"));
+  const vision = {};
+  if (!constitution) {
+    errors.push("constitution.md has no front matter (name and idea)");
+  } else {
+    for (const key of ["name", "idea"]) {
+      if (typeof constitution.meta[key] !== "string" || !constitution.meta[key].trim()) errors.push(`constitution.md front matter is missing '${key}'`);
+    }
+    const found = sections(constitution.body);
+    for (const name of VISION_SECTIONS) {
+      const text = found.find((s) => s.title === name)?.text ?? "";
+      if (!text) errors.push(`constitution.md ## ${name} is missing or empty`);
+      vision[name.toLowerCase()] = text;
+    }
+  }
+  if (!storymap.key || !/^[A-Z]{2,5}$/.test(storymap.key)) errors.push("storymap.yaml needs a key of 2\u20135 capital letters, like HT");
+  const activities = new Map((storymap.activities ?? []).map((a) => [a.id, a.title]));
+  const releaseOf = /* @__PURE__ */ new Map();
+  for (const r of storymap.releases ?? []) for (const id of r.stories ?? []) releaseOf.set(id, r.number);
+  const features = /* @__PURE__ */ new Map();
+  for (const path of walk(file("features"), ".feature")) {
+    const where = relative(dir, path);
+    const parsed = parseFeature(readFileSync(path, "utf-8"));
+    if (!parsed) {
+      errors.push(`${where} has no Feature:`);
+      continue;
+    }
+    const ids = parsed.tags.filter((t) => STORY_ID.test(t));
+    if (ids.length !== 1) {
+      errors.push(`${where} needs exactly one story id tag (found ${ids.length})`);
+      continue;
+    }
+    features.set(ids[0], { path, parsed });
+  }
+  const stories = [];
+  for (const [key, release] of releaseOf) {
+    const feature = features.get(key);
+    if (!feature) {
+      errors.push(`${key} is in storymap.yaml but has no feature file`);
+      continue;
+    }
+    const { parsed, path } = feature;
+    const where = relative(dir, path);
+    const activityId = parsed.tags.find((t) => t.startsWith("activity-"))?.slice("activity-".length) ?? basename(dirname(path));
+    const activity = activities.get(activityId);
+    if (!activity) errors.push(`${where}: activity '${activityId}' is not in storymap.yaml`);
+    if (!parsed.asA || !parsed.iWant || !parsed.soThat) errors.push(`${where}: needs "As a / I want / So that" under Feature:`);
+    if (!parsed.criteria.length) errors.push(`${where}: has no scenarios`);
+    for (const c of parsed.criteria) if (!c.label) errors.push(`${where}: scenario "${c.title}" has no @AC label`);
+    const entry = state.stories?.[key];
+    if (!entry) errors.push(`state.yaml has no entry for ${key}`);
+    const status = STATUS[entry?.status ?? "todo"];
+    if (!status) errors.push(`state.yaml ${key} has unknown status '${entry?.status}'`);
+    stories.push({
+      key,
+      title: parsed.title,
+      as_a: parsed.asA,
+      i_want: parsed.iWant,
+      so_that: parsed.soThat,
+      priority: priorityOf(parsed.tags),
+      release,
+      activity: activity ?? activityId,
+      activity_id: activityId,
+      effort: effortOf(parsed.tags),
+      status: status ?? "todo",
+      blockers: entry?.blockers ?? [],
+      claimed_by: entry?.claimed_by ?? null,
+      plan_version: entry?.plan_version ?? null,
+      criteria: parsed.criteria
+    });
+  }
+  for (const key of features.keys()) if (!releaseOf.has(key)) errors.push(`${key} has a feature file but is in no release in storymap.yaml`);
+  const plans = [];
+  for (const path of walk(file("plans"), ".md")) {
+    const m = /^([A-Z][A-Z0-9]{0,9}-\d+)\.v(\d+)\.md$/.exec(basename(path));
+    if (!m) continue;
+    const fm = frontMatter(readFileSync(path, "utf-8"));
+    if (!fm) {
+      errors.push(`plans/${basename(path)} has no front matter`);
+      continue;
+    }
+    plans.push({
+      story: m[1],
+      version: Number(m[2]),
+      summary: typeof fm.meta.summary === "string" ? fm.meta.summary : "",
+      risk: typeof fm.meta.risk === "string" ? fm.meta.risk : null,
+      introduces: Array.isArray(fm.meta.introduces) ? fm.meta.introduces.map(String) : [],
+      steps: parsePlanSteps(fm.body)
+    });
+  }
+  plans.sort((a, b) => a.story.localeCompare(b.story) || a.version - b.version);
+  const decisions = existsSync(file("decisions.md")) ? parseDecisions(readFileSync(file("decisions.md"), "utf-8")) : [];
+  if (errors.length) return fail();
+  return {
+    ok: true,
+    dir,
+    payload: {
+      format_version: 1,
+      project: { name: constitution.meta.name, idea: constitution.meta.idea, key: storymap.key, vision },
+      releases: (storymap.releases ?? []).map((r) => ({ number: r.number, title: r.title ?? `Release ${r.number}`, stories: r.stories ?? [] })),
+      stories,
+      plans,
+      decisions,
+      run_queue: state.run?.queue ?? []
+    }
+  };
+}
+
+// src/lib/push-api.ts
+var PUSH_ENDPOINTS = {
+  listWorkspaces: "/api/cli/workspaces",
+  createPersonalWorkspace: "/api/cli/workspaces/personal",
+  createProject: "/api/cli/push",
+  updateProject: (projectId) => `/api/cli/push/${encodeURIComponent(projectId)}`,
+  projectMaps: (projectId) => `/api/cli/projects/${encodeURIComponent(projectId)}/maps`
+};
+var PushApiError = class extends Error {
+  constructor(message, status, code = null, problems = [], projectId = null) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.problems = problems;
+    this.projectId = projectId;
+    this.name = "PushApiError";
+  }
+};
+async function call(fetcher, path, init, what) {
+  const res = await fetcher(path, init);
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    const nested = typeof body.error === "object" && body.error ? body.error : null;
+    const said = body.message ?? (nested ? nested.hint ?? nested.message : void 0);
+    throw new PushApiError(
+      said ?? `Couldn't ${what} (the server returned ${res.status}).`,
+      res.status,
+      typeof body.error === "string" ? body.error : null,
+      Array.isArray(body.problems) ? body.problems : [],
+      body.project_id ?? null
+    );
+  }
+  return await res.json();
+}
+var json = (method, body) => body === void 0 ? { method } : { method, headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) };
+function pushApi(fetcher = authenticatedFetch) {
+  return {
+    listWorkspaces: () => call(fetcher, PUSH_ENDPOINTS.listWorkspaces, json("GET"), "list your workspaces").then((r) => r.workspaces),
+    createPersonalWorkspace: () => call(fetcher, PUSH_ENDPOINTS.createPersonalWorkspace, json("POST"), "open your personal workspace").then(
+      (r) => r.workspace
+    ),
+    createProject: (workspaceId, payload) => call(fetcher, PUSH_ENDPOINTS.createProject, json("POST", { workspace_id: workspaceId, intent: payload }), "create the project"),
+    updateProject: (projectId, mapId, payload) => call(fetcher, PUSH_ENDPOINTS.updateProject(projectId), json("PUT", { map_id: mapId, intent: payload }), "update the project"),
+    /** The project's story maps, newest first. */
+    projectMaps: (projectId) => call(fetcher, PUSH_ENDPOINTS.projectMaps(projectId), json("GET"), "find the project's story map").then(
+      (r) => r.maps
+    )
+  };
+}
+
+// src/commands/push.ts
+var PushError = class extends Error {
+  constructor(message, details = []) {
+    super(message);
+    this.details = details;
+    this.name = "PushError";
+  }
+};
+function summary(p) {
+  const criteria = p.stories.reduce((n, s) => n + s.criteria.length, 0);
+  return `${p.stories.length} stories, ${criteria} criteria, ${p.releases.length} releases, ${p.plans.length} plans, ${p.decisions.length} decisions`;
+}
+async function pickWorkspace(deps, auth) {
+  const workspaces = await deps.api.listWorkspaces();
+  if (auth.binding) {
+    const { orgId, workspaceName } = auth.binding;
+    return workspaces.find((w) => w.orgId === orgId) ?? { id: orgId, orgId, name: workspaceName ?? null, personal: false };
+  }
+  if (workspaces.length === 0) return deps.api.createPersonalWorkspace();
+  if (workspaces.length === 1) return workspaces[0];
+  const personal = Math.max(0, workspaces.findIndex((w) => w.personal));
+  return workspaces[await deps.chooseWorkspace(workspaces, personal)] ?? workspaces[personal];
+}
+function pushNotes(result) {
+  const notes = [];
+  const statuses = result.ignored?.statuses ?? 0;
+  if (statuses > 0) {
+    notes.push(
+      `${statuses} story ${statuses === 1 ? "status was" : "statuses were"} not applied: intentdocs sets status itself. New stories start as To do, existing ones keep theirs, and they move through build and acceptance in intentdocs.`
+    );
+  }
+  const missing = result.summary?.stories?.missing ?? [];
+  if (missing.length) notes.push(`In intentdocs but not in intent/: ${missing.join(", ")}. Push never deletes, so they stay.`);
+  if (result.not_stored?.length) notes.push(`Not stored by intentdocs yet: ${result.not_stored.join(", ")}. They stay in intent/.`);
+  return notes;
+}
+async function runPush(deps) {
+  const read = readIntentFolder(deps.cwd);
+  if (!read.ok) throw new PushError(`intent/ can't be pushed yet (${read.dir}):`, read.errors);
+  const payload = read.payload;
+  let auth = deps.getAuth();
+  if (!auth) {
+    deps.log("You need to log in first. Opening the browser\u2026");
+    await deps.login();
+    auth = deps.getAuth();
+    if (!auth) throw new PushError("Login didn't complete, so nothing was pushed.");
+  }
+  const existing = deps.readConfig();
+  const linked = existing?.projectId && existing.mapId ? { projectId: existing.projectId, mapId: existing.mapId } : null;
+  if (existing) {
+    const mismatch = checkoutMismatch(existing, auth.binding);
+    if (mismatch) throw new PushError(mismatch);
+  }
+  deps.log(`Pushing "${payload.project.name}": ${summary(payload)}`);
+  let workspace = null;
+  let result;
+  let created = !linked;
+  if (linked) {
+    result = await deps.api.updateProject(linked.projectId, linked.mapId, payload);
+  } else {
+    workspace = await pickWorkspace(deps, auth);
+    try {
+      result = await deps.api.createProject(workspace.id, payload);
+    } catch (err) {
+      if (!(err instanceof PushApiError && err.code === "ALREADY_PUSHED" && err.projectId)) throw err;
+      const [map] = await deps.api.projectMaps(err.projectId);
+      if (!map) throw err;
+      deps.log(`"${payload.project.name}" was pushed before, so this updates that project.`);
+      result = await deps.api.updateProject(err.projectId, map.id, payload);
+      created = false;
+    }
+  }
+  deps.writeConfig({
+    ...existing,
+    ...checkoutConfig({ apiBase: auth.apiBase, project: result.project, map: result.map, appUrl: existing?.appUrl }),
+    lastPushed: deps.now().toISOString()
+  });
+  deps.openBrowser(result.url);
+  return { result, created, workspace };
+}
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`;
+  exec(cmd);
+}
+async function push() {
+  const deps = {
+    cwd: process.cwd(),
+    api: pushApi(),
+    getAuth,
+    login,
+    readConfig,
+    writeConfig,
+    openBrowser,
+    chooseWorkspace: async (workspaces, defaultIndex) => {
+      if (!isInteractive()) return defaultIndex;
+      const order = [defaultIndex, ...workspaces.map((_, i) => i).filter((i) => i !== defaultIndex)];
+      const labels = order.map((i, n) => `${workspaces[i].personal ? "Personal" : workspaces[i].name ?? "Workspace"}${n === 0 ? " (default)" : ""}`);
+      return order[await choose("Which workspace should this project go in?", labels)];
+    },
+    log: (line) => console.log(line),
+    now: () => /* @__PURE__ */ new Date()
+  };
+  try {
+    const { result, created } = await runPush(deps);
+    console.log(`
+\u2713 ${created ? "Created" : "Updated"} "${result.map.title}"${result.project.workspace ? ` in ${result.project.workspace.name ?? "your workspace"}` : ""}`);
+    for (const note of pushNotes(result)) console.log(`  ${note}`);
+    console.log(`  Linked this repo in .intent/config.json \u2014 run \`npx intentdocs push\` again to sync.`);
+    console.log(`  Opening ${result.url}
+`);
+  } catch (err) {
+    if (err instanceof PushError) {
+      console.error(`\u2717 ${err.message}`);
+      for (const d of err.details) console.error(`  - ${d}`);
+    } else if (err instanceof PushApiError) {
+      console.error(`\u2717 ${err.message}`);
+      for (const p of err.problems) console.error(`  - ${p}`);
+    } else {
+      console.error(`\u2717 Push failed: ${err.message}`);
+    }
+    process.exitCode = 1;
+  } finally {
+    closePrompt();
+  }
+}
+export {
+  PushError,
+  push,
+  pushNotes,
+  runPush
+};

package/dist/{research-CO3W7PLC.js → research-SHO5SXVQ.js}

@@ -5,10 +5,10 @@ import {
 import {
   apiUrl,
   syncHeaders
-} from "./chunk-34JCN66H.js";
+} from "./chunk-KTGQO3AE.js";
 import {
   requireConfig
-} from "./chunk-JX2RLGOM.js";
+} from "./chunk-K5SNF6CG.js";
 import {
   ask,
   closePrompt

package/dist/scope-RRGJHS2G.js

@@ -0,0 +1,13 @@
+import {
+  connectCheckout,
+  scope
+} from "./chunk-ID4B5RZ2.js";
+import "./chunk-KTGQO3AE.js";
+import "./chunk-K5SNF6CG.js";
+import "./chunk-WRRUCCVZ.js";
+import "./chunk-XZE2XP6O.js";
+import "./chunk-UYTVTYNB.js";
+export {
+  connectCheckout,
+  scope
+};

package/dist/{setup-WSYIG2CR.js → setup-UILQVYIB.js}

@@ -1,11 +1,11 @@
 import {
   setup
-} from "./chunk-PUGYRSMK.js";
-import "./chunk-KPQ42YE6.js";
-import "./chunk-F52HPVNQ.js";
+} from "./chunk-IORMKLAQ.js";
+import "./chunk-BNEU6TLJ.js";
 import "./chunk-LQTPZL2Y.js";
-import "./chunk-34JCN66H.js";
-import "./chunk-JX2RLGOM.js";
+import "./chunk-KPQ42YE6.js";
+import "./chunk-KTGQO3AE.js";
+import "./chunk-K5SNF6CG.js";
 import "./chunk-WRRUCCVZ.js";
 import "./chunk-XZE2XP6O.js";
 import "./chunk-UYTVTYNB.js";