intentdocs 0.11.0 → 0.12.0

package/dist/push-33V7ANJW.js

@@ -1,462 +0,0 @@
-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
-};