@coopcli/specplan 5.5.7 → 2026.817.2

package/dist/cli/index.js

@@ -3,7 +3,7 @@
 // server/cli.ts
 import { existsSync as existsSync7, readFileSync as readFileSync5, readdirSync as readdirSync5 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { dirname as dirname7, extname, join as join12, normalize as normalize2, resolve as resolve6 } from "node:path";
+import { dirname as dirname8, extname, join as join14, normalize as normalize2, resolve as resolve6 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parseArgs as parseArgs2 } from "node:util";
 import { serve } from "@hono/node-server";
@@ -121,7 +121,11 @@ function* mapMessage(message, expectStructuredOutput) {
   switch (message.type) {
     case "system": {
       if (message.subtype === "init") {
-        yield { type: "start", sessionId: message.session_id };
+        yield {
+          type: "start",
+          sessionId: message.session_id,
+          ...message.apiKeySource !== void 0 ? { apiKeySource: message.apiKeySource } : {}
+        };
       }
       return;
     }
@@ -891,6 +895,9 @@ var nodeSyncFs = {
   removeFile(path) {
     rmSync(path, { force: true });
   },
+  removeDir(path) {
+    rmSync(path, { force: true, recursive: true });
+  },
   exists(path) {
     return existsSync5(path);
   },
@@ -918,11 +925,11 @@ function readTaskProgress(changeDir, fsx = nodeSyncFs) {
   return md === void 0 ? null : parseTaskProgress(md);
 }
 function parseLedgerStatus(md, specId) {
-  const cellsOf2 = (line) => line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
+  const cellsOf3 = (line) => line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
   let statusIdx = 2;
   for (const line of md.split(/\r?\n/)) {
     if (!line.trim().startsWith("|")) continue;
-    const cells = cellsOf2(line);
+    const cells = cellsOf3(line);
     if (cells.every((c) => /^:?-+:?$/.test(c))) continue;
     const lower = cells.map((c) => c.toLowerCase());
     if (lower.includes("status") && lower.includes("change")) {
@@ -1078,10 +1085,10 @@ var PlanJournal = class {
         }
         if (ledgerMd !== void 0) {
           const status = parseLedgerStatus(ledgerMd, targetId);
-          if (status === void 0 || !/^approved\b/i.test(status)) {
+          if (status === void 0 || !/^(archived|approved)\b/i.test(status)) {
             reports.push({
               targetId,
-              expected: "SPECS.md row status approved",
+              expected: "SPECS.md row status archived",
               actual: status === void 0 ? "no SPECS.md row" : `SPECS.md row status "${status}"`,
               detail: `journal records approved: true for ${targetId} but its SPECS.md ledger row ${status === void 0 ? "is missing" : `reads "${status}"`}`
             });
@@ -1701,7 +1708,7 @@ function locateArchivedDir(store, specId) {
   const newest = names[names.length - 1];
   return newest ? join7("changes", "archive", newest) : null;
 }
-var APPROVED_LEDGER_STATUS = "approved `[not-implemented]`";
+var ARCHIVED_LEDGER_STATUS = "archived";
 function cellsOf(line) {
   return line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
 }
@@ -1765,12 +1772,12 @@ function maintainLedgerRow(store, specId, archivedRelDir) {
         continue;
       }
       if ((cells[0] ?? "").includes(token)) {
-        lines[i] = replaceStatusCell(line, statusIdx, APPROVED_LEDGER_STATUS);
+        lines[i] = replaceStatusCell(line, statusIdx, ARCHIVED_LEDGER_STATUS);
         store.fsx.writeAtomicFile(ledgerPath, lines.join("\n"));
         return "updated";
       }
     }
-    const row2 = `| ${token} (archived \`${archivedBase}\`) | ${deriveDomains(store, archivedRelDir)} | ${APPROVED_LEDGER_STATUS} | (auto-created by specplan apply) |`;
+    const row2 = `| ${token} (archived \`${archivedBase}\`) | ${deriveDomains(store, archivedRelDir)} | ${ARCHIVED_LEDGER_STATUS} | (auto-created by specplan apply) |`;
     const insertAt = activeTableInsertIndex(lines);
     if (insertAt !== null) {
       lines.splice(insertAt, 0, row2);
@@ -1782,7 +1789,7 @@ function maintainLedgerRow(store, specId, archivedRelDir) {
 ${freshLedger(row2)}`);
     return "created";
   }
-  const row = `| ${token} (archived \`${archivedBase}\`) | ${deriveDomains(store, archivedRelDir)} | ${APPROVED_LEDGER_STATUS} | (auto-created by specplan apply) |`;
+  const row = `| ${token} (archived \`${archivedBase}\`) | ${deriveDomains(store, archivedRelDir)} | ${ARCHIVED_LEDGER_STATUS} | (auto-created by specplan apply) |`;
   store.fsx.writeAtomicFile(ledgerPath, freshLedger(row));
   return "created";
 }
@@ -2094,6 +2101,44 @@ var PlanStore = class {
     }
     return edge;
   }
+  /**
+   * Drop a proposal node and every edge touching it — the counterpart to
+   * `adoptExistingChanges`, which adds a node for every change directory and
+   * (until this existed) never removed one.
+   *
+   * Deleting a change without this leaves a node whose `specFile` points at a
+   * directory that is gone: a dangling reference on the canvas, which is the
+   * SAME failure as the stale roadmap row this change exists to fix. Observed
+   * live — deleting a scratch change left its node behind in `specplan.yaml`.
+   *
+   * Returns false when no such node exists, which is not an error: a change can
+   * be deleted before the plan ever adopted it.
+   */
+  removeProposal(nodeId) {
+    const doc = this.loadDoc();
+    const plan = this.planOf(doc);
+    const idx = plan.nodes.findIndex((n) => n.id === nodeId);
+    if (idx < 0) return false;
+    const doomed = plan.edges.map((edge, i) => ({ edge, i })).filter(({ edge }) => edge.from === nodeId || edge.to === nodeId).map(({ i }) => i).reverse();
+    for (const i of doomed) doc.deleteIn(["edges", i]);
+    doc.deleteIn(["nodes", idx]);
+    this.save(doc);
+    const next = {
+      ...plan,
+      nodes: plan.nodes.filter((_, i) => i !== idx),
+      edges: plan.edges.filter((e) => e.from !== nodeId && e.to !== nodeId)
+    };
+    for (const source of new Set(
+      plan.edges.filter((e) => e.to === nodeId).map((e) => e.from)
+    )) {
+      if (next.nodes.find((n) => n.id === source)?.type !== "proposal") continue;
+      try {
+        this.writeSpecMeta(source, containedStories(next, source), specDependencies(next, source));
+      } catch {
+      }
+    }
+    return true;
+  }
   /** Update one node's sibling `order` hint. Never touches edges. */
   reorder(nodeId, order) {
     const doc = this.loadDoc();
@@ -2570,6 +2615,265 @@ function registerPlanRoutes(app, store, workspace, opts = {}) {
   });
 }
 
+// server/app.ts
+import { dirname as dirname6, join as join11 } from "node:path";
+
+// server/gallery.ts
+import { join as join10 } from "node:path";
+var SNIPPET_LIMIT = 180;
+var REQUIRED_PROPOSAL_SECTIONS = [
+  { title: "Why", level: 2 },
+  { title: "What Changes", level: 2 },
+  { title: "System context", level: 3 },
+  { title: "Containers", level: 3 },
+  { title: "Components", level: 3 },
+  { title: "Impact", level: 2 }
+];
+function titleOf(proposal, id) {
+  const heading = /^#[ \t]+(.+)$/m.exec(proposal ?? "");
+  const text = heading?.[1]?.trim();
+  return text === void 0 || text === "" ? id : text;
+}
+function snippetOf(proposal, limit = SNIPPET_LIMIT) {
+  if (!proposal) return "";
+  const why = /^##[ \t]+Why[ \t]*$/m.exec(proposal);
+  if (!why) return "";
+  const after = proposal.slice(why.index + why[0].length);
+  const untilNextHeading = after.split(/^#{1,6}[ \t]/m)[0] ?? "";
+  const paragraph = untilNextHeading.split(/\n\s*\n/).map((p) => p.trim()).find((p) => p !== "");
+  if (paragraph === void 0) return "";
+  const flat = paragraph.replace(/\s+/g, " ").trim();
+  return truncateOnWord(flat, limit);
+}
+function truncateOnWord(text, limit) {
+  if (text.length <= limit) return text;
+  const clipped = text.slice(0, limit);
+  const lastSpace = clipped.lastIndexOf(" ");
+  return `${(lastSpace > 0 ? clipped.slice(0, lastSpace) : clipped).trimEnd()}\u2026`;
+}
+function taskCounts(tasks) {
+  if (!tasks) return { done: 0, total: 0 };
+  const items = tasks.match(/^[ \t]*-[ \t]+\[[ xX]\]/gm) ?? [];
+  const done = items.filter((i) => /\[[xX]\]/.test(i)).length;
+  return { done, total: items.length };
+}
+function proposalState(proposal) {
+  if (!proposal || proposal.trim() === "") return "absent";
+  let filled = 0;
+  for (const section of REQUIRED_PROPOSAL_SECTIONS) {
+    const hashes = "#".repeat(section.level);
+    const heading = new RegExp(`^${hashes}[ \\t]+${section.title}[ \\t]*$`, "m").exec(proposal);
+    if (!heading) continue;
+    const after = proposal.slice(heading.index + heading[0].length);
+    const body = (after.split(/^#{1,6}[ \t]/m)[0] ?? "").trim();
+    if (body !== "") filled += 1;
+  }
+  if (filled === 0) return "absent";
+  return filled === REQUIRED_PROPOSAL_SECTIONS.length ? "complete" : "partial";
+}
+function designState(design) {
+  if (!design || design.trim() === "") return "absent";
+  return /^##[ \t]+\S/m.test(design) ? "complete" : "absent";
+}
+var DATE_PREFIX = /^\d{4}-\d{2}-\d{2}-/;
+function archivedIds(deps) {
+  const dir = join10(deps.root, "changes", "archive");
+  if (!deps.fsx.exists(dir)) return /* @__PURE__ */ new Set();
+  const ids = /* @__PURE__ */ new Set();
+  for (const entry of deps.fsx.readdir(dir)) {
+    if (!entry.directory || entry.name.startsWith(".")) continue;
+    ids.add(entry.name.replace(DATE_PREFIX, ""));
+    ids.add(entry.name);
+  }
+  return ids;
+}
+function listChanges(deps) {
+  const changesDir = join10(deps.root, "changes");
+  if (!deps.fsx.exists(changesDir)) return [];
+  const cards = [];
+  for (const entry of deps.fsx.readdir(changesDir).sort((a, b) => a.name.localeCompare(b.name))) {
+    if (!entry.directory || entry.name === "archive" || entry.name.startsWith(".")) continue;
+    cards.push(readChange(deps, changesDir, entry.name));
+  }
+  return cards;
+}
+function readChange(deps, changesDir, id) {
+  const dir = join10(changesDir, id);
+  const proposal = deps.fsx.readIfExists(join10(dir, "proposal.md"));
+  const design = deps.fsx.readIfExists(join10(dir, "design.md"));
+  const tasks = deps.fsx.readIfExists(join10(dir, "tasks.md"));
+  const specsDir = join10(dir, "specs");
+  const capabilities = deps.fsx.exists(specsDir) ? deps.fsx.readdir(specsDir).filter((e) => e.directory && deps.fsx.exists(join10(specsDir, e.name, "spec.md"))).map((e) => e.name).sort() : [];
+  const counts = taskCounts(tasks);
+  const states = {
+    proposal: proposalState(proposal),
+    design: designState(design),
+    // Deltas have no middle state either.
+    deltas: capabilities.length > 0 ? "complete" : "absent",
+    tasks: counts.total === 0 ? "absent" : counts.done === counts.total ? "complete" : "partial"
+  };
+  return {
+    id,
+    title: titleOf(proposal, id),
+    snippet: snippetOf(proposal),
+    capabilities,
+    ...states,
+    tasksDone: counts.done,
+    tasksTotal: counts.total,
+    tasksOpen: counts.total - counts.done,
+    // Derived from the four states rather than re-read, so "empty" cannot disagree with
+    // the indicators sitting next to it on the same card.
+    empty: Object.values(states).every((state) => state === "absent")
+  };
+}
+function deleteChange(deps, id) {
+  const name = id.trim();
+  if (name === "") return { outcome: "refused", reason: "no change was named" };
+  if (name === "archive") {
+    return { outcome: "refused", reason: "the archive is not a change and cannot be deleted" };
+  }
+  if (name.startsWith(".") || /[/\\]/.test(name) || name.split(".").includes("..")) {
+    return { outcome: "refused", reason: `\`${name}\` is not a change directory name` };
+  }
+  const dir = join10(deps.root, "changes", name);
+  if (!deps.fsx.exists(dir)) {
+    return { outcome: "refused", reason: `\`${name}\` has no directory under openspec/changes/` };
+  }
+  deps.fsx.removeDir(dir);
+  return { outcome: "deleted" };
+}
+function readChangePreview(deps, id) {
+  const dir = join10(deps.root, "changes", id);
+  if (!deps.fsx.exists(dir)) return null;
+  const documents = ["proposal.md", "design.md", "tasks.md"].map((path) => ({
+    path,
+    content: deps.fsx.readIfExists(join10(dir, path)) ?? null
+  }));
+  const specsDir = join10(dir, "specs");
+  if (deps.fsx.exists(specsDir)) {
+    for (const entry of deps.fsx.readdir(specsDir).sort((a, b) => a.name.localeCompare(b.name))) {
+      if (!entry.directory) continue;
+      const path = `specs/${entry.name}/spec.md`;
+      const content = deps.fsx.readIfExists(join10(specsDir, entry.name, "spec.md"));
+      if (content !== void 0) documents.push({ path, content });
+    }
+  }
+  return {
+    id,
+    title: titleOf(deps.fsx.readIfExists(join10(dir, "proposal.md")), id),
+    // The real id, never a placeholder: a command the reader has to edit is one they
+    // will mistype.
+    command: `specsketch ${id}`,
+    documents
+  };
+}
+
+// server/roadmap.ts
+var ROW_ID = /^\|[^|]*\|\s*`([a-z0-9][a-z0-9-]*)`\s*\|/;
+function readOrder(roadmap) {
+  const rows = [];
+  roadmap.split("\n").forEach((text, line) => {
+    const match = ROW_ID.exec(text);
+    if (match?.[1]) rows.push({ id: match[1], line, text });
+  });
+  return { rows, order: rows.map((r) => r.id) };
+}
+function reorder(roadmap, id, beforeId) {
+  const lines = roadmap.split("\n");
+  const { rows } = readOrder(roadmap);
+  const moving = rows.find((r) => r.id === id);
+  if (!moving) return { outcome: "refused", reason: `\`${id}\` has no row in the roadmap` };
+  if (beforeId !== null && !rows.some((r) => r.id === beforeId)) {
+    return { outcome: "refused", reason: `\`${beforeId}\` has no row in the roadmap` };
+  }
+  if (id === beforeId) {
+    return { outcome: "refused", reason: "a change cannot be moved before itself" };
+  }
+  const row = lines[moving.line];
+  lines.splice(moving.line, 1);
+  let insertAt;
+  if (beforeId === null) {
+    const remaining = readOrder(lines.join("\n")).rows;
+    const last = remaining[remaining.length - 1];
+    insertAt = last === void 0 ? lines.length : last.line + 1;
+  } else {
+    const target = readOrder(lines.join("\n")).rows.find((r) => r.id === beforeId);
+    if (!target) return { outcome: "refused", reason: `\`${beforeId}\` vanished while reordering` };
+    insertAt = target.line;
+  }
+  lines.splice(insertAt, 0, row);
+  const content = lines.join("\n");
+  const before = roadmap.split("\n");
+  const withoutMoved = (all) => {
+    const copy = [...all];
+    const at = copy.indexOf(row);
+    if (at >= 0) copy.splice(at, 1);
+    return copy;
+  };
+  const kept = withoutMoved(before);
+  const now = withoutMoved(lines);
+  if (kept.length !== now.length || kept.some((line, i) => line !== now[i])) {
+    return {
+      outcome: "refused",
+      reason: "the reorder would have changed a line it did not move"
+    };
+  }
+  return { outcome: "reordered", content };
+}
+function cellsOf2(line) {
+  return line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|");
+}
+function isSeparator(line) {
+  return line.trim().startsWith("|") && cellsOf2(line).every((c) => /^\s*:?-+:?\s*$/.test(c));
+}
+function governingHeader(lines, index) {
+  for (let i = Math.min(index, lines.length) - 1; i >= 1; i -= 1) {
+    if (!isSeparator(lines[i])) continue;
+    return (lines[i - 1] ?? "").trim().startsWith("|") ? i - 1 : null;
+  }
+  return null;
+}
+function addRow(roadmap, id) {
+  const lines = roadmap.split("\n");
+  const { rows } = readOrder(roadmap);
+  if (rows.some((r) => r.id === id)) {
+    return { outcome: "refused", reason: `\`${id}\` already has a roadmap row` };
+  }
+  const firstSeparator = lines.findIndex(isSeparator);
+  const insertAt = rows.length > 0 ? rows[rows.length - 1].line + 1 : firstSeparator + 1;
+  const headerAt = governingHeader(lines, insertAt);
+  if (headerAt === null) {
+    return { outcome: "refused", reason: "the roadmap carries no table to append a row to" };
+  }
+  const header = cellsOf2(lines[headerAt]).map((c) => c.trim());
+  const rowsHere = rows.filter((r) => governingHeader(lines, r.line) === headerAt);
+  const idColumn = rowsHere.length > 0 ? cellsOf2(rowsHere[0].text).findIndex((c) => /^\s*`[^`]+`\s*$/.test(c)) : header.findIndex((h) => /change[- ]?id|^id$/i.test(h));
+  if (idColumn < 0) {
+    return { outcome: "refused", reason: "the roadmap table declares no change-id column" };
+  }
+  const cells = header.map(() => "");
+  cells[idColumn] = `\`${id}\``;
+  if (/^#$/.test(header[0] ?? "") && idColumn !== 0) {
+    const written = rows.map((r) => Number.parseInt((cellsOf2(r.text)[0] ?? "").trim(), 10)).filter((n) => Number.isFinite(n));
+    cells[0] = String(written.length > 0 ? Math.max(...written) + 1 : rows.length + 1);
+  }
+  const row = `| ${cells.join(" | ")} |`;
+  lines.splice(insertAt, 0, row);
+  const content = lines.join("\n");
+  const before = roadmap.split("\n");
+  const after = lines.filter((_, i) => i !== insertAt);
+  if (before.length !== after.length || before.some((line, i) => line !== after[i])) {
+    return { outcome: "refused", reason: "the append would have changed a line it did not add" };
+  }
+  if (cellsOf2(row).length !== header.length) {
+    return {
+      outcome: "refused",
+      reason: `the appended row would carry ${cellsOf2(row).length} cells in a ${header.length}-column table`
+    };
+  }
+  return { outcome: "reordered", content };
+}
+
 // server/tools.ts
 import { z as z4 } from "zod";
 var CreateSpecInput = z4.object({ title: z4.string().min(1) });
@@ -2774,6 +3078,68 @@ function createApp(anthropic, workspace, store, options) {
   const powerProfile = readMostlyProfile("specplan-assistant");
   const app = new Hono();
   app.get("/api/health", (c) => c.json({ ok: true }));
+  if (store) {
+    const roadmapPath = () => {
+      const beside = join11(dirname6(store.dir), "roadmap.md");
+      return store.fsx.exists(beside) ? beside : join11(store.dir, "roadmap.md");
+    };
+    app.get("/api/gallery", (c) => {
+      const cards = listChanges({ fsx: store.fsx, root: store.dir });
+      const roadmap = store.fsx.readIfExists(roadmapPath());
+      const order = roadmap === void 0 ? [] : readOrder(roadmap).order;
+      const rank = new Map(order.map((id, i) => [id, i]));
+      const roadmapped = cards.filter((card) => rank.has(card.id)).sort((a, b) => rank.get(a.id) - rank.get(b.id));
+      const backlog2 = cards.filter((card) => !rank.has(card.id));
+      const present = new Set(cards.map((card) => card.id));
+      const archive = archivedIds({ fsx: store.fsx, root: store.dir });
+      const absent = order.filter((id) => !present.has(id));
+      const archived = absent.filter((id) => archive.has(id));
+      const missing = absent.filter((id) => !archive.has(id));
+      return c.json({
+        roadmap: roadmapped,
+        backlog: backlog2,
+        archived,
+        missing,
+        hasRoadmap: roadmap !== void 0
+      });
+    });
+    app.get("/api/gallery/:id", (c) => {
+      const preview = readChangePreview({ fsx: store.fsx, root: store.dir }, c.req.param("id"));
+      if (preview === null) return c.json({ error: "no-such-change" }, 404);
+      return c.json(preview);
+    });
+    app.post("/api/gallery/roadmap", async (c) => {
+      const body = await c.req.json();
+      const path = roadmapPath();
+      const roadmap = store.fsx.readIfExists(path);
+      if (roadmap === void 0) {
+        return c.json({ outcome: "refused", reason: "no roadmap.md to add to" }, 409);
+      }
+      const result = addRow(roadmap, body.id ?? "");
+      if (result.outcome !== "reordered") return c.json(result, 409);
+      store.fsx.writeAtomicFile(path, result.content);
+      return c.json({ outcome: "added" });
+    });
+    app.delete("/api/gallery/:id", (c) => {
+      const id = c.req.param("id");
+      const result = deleteChange({ fsx: store.fsx, root: store.dir }, id);
+      if (result.outcome !== "deleted") return c.json(result, 409);
+      store.removeProposal(id);
+      return c.json(result);
+    });
+    app.post("/api/gallery/reorder", async (c) => {
+      const body = await c.req.json();
+      const path = roadmapPath();
+      const roadmap = store.fsx.readIfExists(path);
+      if (roadmap === void 0) {
+        return c.json({ outcome: "refused", reason: "no roadmap.md to reorder" }, 409);
+      }
+      const result = reorder(roadmap, body.id ?? "", body.before ?? null);
+      if (result.outcome !== "reordered") return c.json(result, 409);
+      store.fsx.writeAtomicFile(path, result.content);
+      return c.json({ outcome: "reordered" });
+    });
+  }
   app.get(
     "/api/config",
     (c) => c.json({
@@ -2997,7 +3363,7 @@ import { parseArgs } from "node:util";
 // ../shared/src/cli-config.ts
 import { readFile, writeFile, mkdir, chmod } from "node:fs/promises";
 import { homedir as homedir2, hostname } from "node:os";
-import { join as join10, dirname as dirname6 } from "node:path";
+import { join as join12, dirname as dirname7 } from "node:path";
 
 // ../shared/src/schemas.ts
 import { z as z5 } from "zod";
@@ -3196,8 +3562,8 @@ var poolCancelInputSchema = z5.object({
 });
 
 // ../shared/src/cli-config.ts
-var DEFAULT_CONFIG_DIR = join10(homedir2(), ".coopcli");
-var DEFAULT_CONFIG_PATH = join10(DEFAULT_CONFIG_DIR, "config.json");
+var DEFAULT_CONFIG_DIR = join12(homedir2(), ".coopcli");
+var DEFAULT_CONFIG_PATH = join12(DEFAULT_CONFIG_DIR, "config.json");
 var PROD_API_URL = "https://api.coopcli.com";
 function emptyProfile(apiUrl) {
   return {
@@ -3243,7 +3609,7 @@ var ConfigStore = class {
   configDir;
   constructor(configPath) {
     this.configPath = configPath ?? DEFAULT_CONFIG_PATH;
-    this.configDir = dirname6(this.configPath);
+    this.configDir = dirname7(this.configPath);
   }
   /**
    * Select the profile this store operates on for the rest of the process
@@ -3620,14 +3986,15 @@ function deriveApiUrl(webUrl) {
 async function login(input, deps) {
   const state = randomBytes(16).toString("hex");
   const machineId = input.machine ?? hostname2();
+  const log = deps.log ?? ((message) => void process.stderr.write(message));
   const server = await startLocalhostServer({ expectedState: state, loginCommand: input.loginCommand });
   try {
     const webUrl = input.webUrl ?? "https://coopcli.com";
     const authUrl = `${webUrl}/cli-auth?port=${server.port}&state=${state}&machine=${encodeURIComponent(machineId)}`;
-    process.stderr.write(`Opening browser for authentication...
+    log(`Opening browser for authentication...
 `);
     await deps.openBrowser(authUrl);
-    process.stderr.write(`Waiting for callback on port ${server.port}...
+    log(`Waiting for callback on port ${server.port}...
 `);
     const params = await server.waitForCallback();
     const displayName = resolveDisplayName(params.displayName, params.email, params.userId);
@@ -3644,7 +4011,7 @@ async function login(input, deps) {
     });
     const config = await deps.config.load();
     if (params.apiUrl && config.apiUrl && params.apiUrl !== config.apiUrl) {
-      process.stderr.write(
+      log(
         `
 Backend mismatch: you authenticated against ${params.apiUrl}
   but your config points to ${config.apiUrl}
@@ -3762,7 +4129,7 @@ function validateCommand(rootDir, log = console.log, logError = console.error) {
 }
 
 // server/workspace.ts
-import { join as join11, resolve as resolve5 } from "node:path";
+import { join as join13, resolve as resolve5 } from "node:path";
 var SIDECAR_FILE = "specplan-ui.json";
 var PlanWorkspace = class {
   /** Resolved openspec root directory. */
@@ -3776,7 +4143,7 @@ var PlanWorkspace = class {
   }
   // ── Sidecar ──────────────────────────────────────────────────────────────
   readSidecar() {
-    const raw = this.fsx.readIfExists(join11(this.dir, SIDECAR_FILE));
+    const raw = this.fsx.readIfExists(join13(this.dir, SIDECAR_FILE));
     if (!raw) return {};
     try {
       return JSON.parse(raw);
@@ -3791,7 +4158,7 @@ var PlanWorkspace = class {
     delete next.positions;
     next.createdAt ??= now;
     next.updatedAt = now;
-    this.fsx.writeAtomicFile(join11(this.dir, SIDECAR_FILE), JSON.stringify(next, null, 2));
+    this.fsx.writeAtomicFile(join13(this.dir, SIDECAR_FILE), JSON.stringify(next, null, 2));
   }
   readModel() {
     return this.readSidecar().model;
@@ -3839,7 +4206,9 @@ var PlanWorkspace = class {
 };
 
 // server/cli.ts
+var CLI_VERSION = true ? "2026.08.17.2" : "dev";
 var USAGE = `Usage: specplan [rootDir] [--port <n>]
+       specplan --version
        specplan generate <specId> [rootDir]
        specplan apply <proposalId> [rootDir] [--confirm-hand-edit]
        specplan validate [rootDir]
@@ -3974,15 +4343,15 @@ var MIME = {
   ".woff": "font/woff"
 };
 function resolveClientDir(moduleUrl) {
-  const here = dirname7(fileURLToPath(moduleUrl));
+  const here = dirname8(fileURLToPath(moduleUrl));
   const candidates = [
-    join12(here, "..", "client"),
+    join14(here, "..", "client"),
     // packed: dist/cli -> dist/client
-    join12(here, "..", "dist", "client")
+    join14(here, "..", "dist", "client")
     // repo: server/ -> dist/client
   ];
   for (const dir of candidates) {
-    if (existsSync7(join12(dir, "index.html"))) return dir;
+    if (existsSync7(join14(dir, "index.html"))) return dir;
   }
   return null;
 }
@@ -3990,7 +4359,7 @@ function staticResponse(clientDir, pathname) {
   const rel = normalize2(decodeURIComponent(pathname)).replace(/^\/+/, "");
   const target = resolve6(clientDir, rel === "" ? "index.html" : rel);
   if (!target.startsWith(resolve6(clientDir))) return null;
-  const file = existsSync7(target) && extname(target) ? target : join12(clientDir, "index.html");
+  const file = existsSync7(target) && extname(target) ? target : join14(clientDir, "index.html");
   if (!existsSync7(file)) return null;
   return new Response(readFileSync5(file), {
     headers: { "Content-Type": MIME[extname(file)] ?? "application/octet-stream" }
@@ -4008,7 +4377,7 @@ function detectCredentialSource(env = process.env, home = homedir3()) {
   if (env.ANTHROPIC_API_KEY) return "ANTHROPIC_API_KEY";
   if (env.ANTHROPIC_AUTH_TOKEN) return "ANTHROPIC_AUTH_TOKEN";
   try {
-    const dir = join12(home, ".config", "anthropic", "credentials");
+    const dir = join14(home, ".config", "anthropic", "credentials");
     if (readdirSync5(dir).some((f) => f.endsWith(".json"))) return "anthropic profile";
   } catch {
   }
@@ -4023,6 +4392,10 @@ function preflight(log = console.log) {
   }
 }
 async function main(argv) {
+  if (argv[0] === "--version") {
+    console.log(CLI_VERSION);
+    return;
+  }
   preflight();
   if (argv[0] === "login") {
     let loginArgs;

package/dist/client/assets/{abnfDiagram-VRR7QNED-DYWyHZ9F.js → abnfDiagram-VRR7QNED-BYxvjjLu.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{t}from"./src-_g_WvJI1.js";import"./chunk-WYO6CB5R-DWSMU6gp.js";import"./chunk-VAUOI2AC-D14Dfnyc.js";import{m as n,t as r}from"./mermaid-parser.core-OvIPAtjO.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-CHtb7Cmu.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";var c=n().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{o.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new r(n);let i=n.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{t}from"./src-B56W74gN.js";import"./chunk-WYO6CB5R-qHfws5Na.js";import"./chunk-VAUOI2AC-D7taetBr.js";import{m as n,t as r}from"./mermaid-parser.core-CWtD7LBQ.js";import{n as i,r as a,t as o}from"./chunk-MOJQB5TN-Bio7zOcN.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";var c=n().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{o.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new r(n);let i=n.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/dist/client/assets/architecture-TIHT7OUA-Cz2n_8dt.js

@@ -0,0 +1 @@
+import"./chunk-KEIR6QF5-BfrZ3jm6.js";import{M as e}from"./mermaid-parser.core-CWtD7LBQ.js";export{e as createArchitectureServices};