intentdocs 0.10.1 → 0.12.0

package/dist/push-7LJ654MJ.js

@@ -0,0 +1,220 @@
+import {
+  login
+} from "./chunk-64I7RLP3.js";
+import {
+  checkoutMismatch
+} from "./chunk-KTGQO3AE.js";
+import {
+  checkoutConfig,
+  readConfig,
+  readIntentFolder,
+  readSyncBase,
+  specOfPushStory,
+  writeConfig,
+  writeSyncBase
+} from "./chunk-RGFGTIIH.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/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()
+  });
+  const base = deps.readSyncBase();
+  for (const story of payload.stories) {
+    base.stories[story.key] = specOfPushStory(story);
+    base.activities[story.activity_id] = story.activity;
+  }
+  for (const release of payload.releases) base.releases[String(release.number)] = release.title;
+  for (const key of result.summary?.stories?.created ?? []) base.statuses[key] = "todo";
+  deps.writeSyncBase(base);
+  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,
+    readSyncBase,
+    writeSyncBase,
+    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-L27DLYXC.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-RGFGTIIH.js";
 import {
   ask,
   closePrompt

package/dist/scope-ORIFXV4P.js

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

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

@@ -1,11 +1,11 @@
 import {
   setup
-} from "./chunk-PUGYRSMK.js";
-import "./chunk-KPQ42YE6.js";
-import "./chunk-F52HPVNQ.js";
+} from "./chunk-SDXDVNNP.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-RGFGTIIH.js";
 import "./chunk-WRRUCCVZ.js";
 import "./chunk-XZE2XP6O.js";
 import "./chunk-UYTVTYNB.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intentdocs",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "CLI for intentdocs.com — intent-driven development: connect your codebase to your product specs",
   "bin": {
     "intentdocs": "bin/intentdocs.js",
@@ -30,16 +30,17 @@
   "author": "intentdocs.com",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "commander": "^12.0.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "chalk": "^5.3.0",
+    "commander": "^12.0.0",
     "ora": "^8.0.0",
-    "posthog-node": "^4.0.0"
+    "posthog-node": "^4.0.0",
+    "yaml": "^2.9.1"
   },
   "devDependencies": {
+    "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
-    "@types/node": "^20.0.0",
     "vitest": "^4.1.2"
   }
 }

package/dist/chunk-JX2RLGOM.js

@@ -1,59 +0,0 @@
-import {
-  canonicalApiBase
-} from "./chunk-UYTVTYNB.js";
-
-// src/lib/config.ts
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join, dirname } from "path";
-var CONFIG_DIR = ".intent";
-var CONFIG_FILE = "config.json";
-function configPath() {
-  let dir = process.cwd();
-  while (true) {
-    const candidate = join(dir, CONFIG_DIR, CONFIG_FILE);
-    if (existsSync(candidate)) return candidate;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return join(process.cwd(), CONFIG_DIR, CONFIG_FILE);
-}
-function hasConfig() {
-  return existsSync(configPath());
-}
-function readConfig() {
-  try {
-    const raw = readFileSync(configPath(), "utf-8");
-    const config = JSON.parse(raw);
-    return config.apiBase ? { ...config, apiBase: canonicalApiBase(config.apiBase) } : config;
-  } catch {
-    return null;
-  }
-}
-function writeConfig(config) {
-  const existing = existsSync(configPath()) ? configPath() : null;
-  const dir = existing ? dirname(existing) : join(process.cwd(), CONFIG_DIR);
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  writeFileSync(join(dir, CONFIG_FILE), JSON.stringify(config, null, 2) + "\n");
-}
-function requireConfig() {
-  const config = readConfig();
-  if (!config) {
-    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 `npx intentdocs login` then `npx intentdocs init` to reconnect."
-    );
-    process.exit(1);
-  }
-  return config;
-}
-
-export {
-  hasConfig,
-  readConfig,
-  writeConfig,
-  requireConfig
-};

package/dist/scope-ZZLKQEF5.js

@@ -1,11 +0,0 @@
-import {
-  scope
-} from "./chunk-NHNBCNND.js";
-import "./chunk-34JCN66H.js";
-import "./chunk-JX2RLGOM.js";
-import "./chunk-WRRUCCVZ.js";
-import "./chunk-XZE2XP6O.js";
-import "./chunk-UYTVTYNB.js";
-export {
-  scope
-};