@coopcli/specsketch 2026.817.2 → 2026.825.1

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // server/cli.ts
-import { existsSync as existsSync8, readFileSync as readFileSync9, readdirSync as readdirSync8 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync9, readdirSync as readdirSync8 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { dirname as dirname6, extname, join as join11, normalize as normalize2, resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -2150,7 +2150,7 @@ var ChangeWorkspace = class {
 };
 
 // server/workbench-host.ts
-import { existsSync as existsSync7, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { dirname as dirname5, join as join10, resolve as resolve3 } from "node:path";
 
@@ -2491,6 +2491,7 @@ function changeDocument(change) {
     design: change.design,
     groups: numberTasks(change.tasks),
     testing: testingRows(change.capabilities),
+    proposalExtras: change.proposalExtras,
     deltaSpecs: change.capabilities.filter(emitsDeltaSpec).map(deltaSpecDocument).sort((a, b) => a.capability < b.capability ? -1 : a.capability > b.capability ? 1 : 0)
   };
 }
@@ -2517,10 +2518,14 @@ ${UNSATISFIED_MARKER}
   }
 }
 function renderProposal(doc) {
+  const extras = doc.proposalExtras ?? [];
+  const after = (id) => extras.filter((e) => e.afterSection === id).map((e) => `${e.text.trimEnd()}
+`);
   const parts = [`# ${doc.id}
-`];
+`, ...after(null)];
   for (const spec of PROPOSAL_SECTIONS) {
     parts.push(renderProposalSection(spec, doc.proposal[spec.id]));
+    parts.push(...after(spec.id));
   }
   return `${parts.join("\n")}`;
 }
@@ -2560,7 +2565,8 @@ function renderTasks(doc) {
 `];
     for (const task of group.tasks) {
       const box = task.done ? "x" : " ";
-      lines.push(`- [${box}] ${task.number} ${task.title}`);
+      lines.push(`- [${box}] ${task.number} ${task.title.split("\n").join(`
+${TASK_CONTINUATION}`)}`);
     }
     parts.push(`${lines.join("\n")}
 `);
@@ -2640,6 +2646,8 @@ function emitChange(change) {
   return renderChangeDocument(changeDocument(change));
 }
 var TASK_LINE = /^- \[([ xX])\] (\d+\.\d+) (.*)$/;
+var TASK_CONTINUATION = "  ";
+var TASK_CONTINUATION_LINE = /^ {2}(.*)$/;
 var GROUP_CITATION = /^(.*) — implements `([^`]+)`: `([^`]+)`$/;
 var GROUP_HEADING = /^## (\d+)\. (.*)$/;
 var FENCE = /^```(\S*)\s*$/;
@@ -2648,11 +2656,13 @@ function parseChangeDocument(emitted) {
   const proposalSrc = byPath.get("proposal.md") ?? "";
   const designSrc = byPath.get("design.md") ?? "";
   const tasksSrc = byPath.get("tasks.md") ?? "";
+  const parsedProposal = parseProposalFile(proposalSrc);
   const groups = parseTasksFile(tasksSrc);
   const deltaSpecs = emitted.files.filter((f) => f.path.startsWith("specs/") && f.path.endsWith("/spec.md")).map((f) => parseDeltaSpecFile(capabilityOfPath(f.path), f.content));
   return {
     id: emitted.id,
-    proposal: parseProposalFile(proposalSrc),
+    proposal: parsedProposal.draft,
+    proposalExtras: parsedProposal.extras,
     design: parseDesignFile(designSrc),
     groups: numberTasks(groups),
     testing: parseTestingTable(tasksSrc),
@@ -2667,25 +2677,44 @@ function parseProposalFile(src) {
   const lines = src.split("\n");
   const bodies = /* @__PURE__ */ new Map();
   let current = null;
+  const extras = [];
+  let extra = null;
+  let lastFixed = null;
+  const flushExtra = () => {
+    if (!extra) return;
+    const text = extra.lines.join("\n").trimEnd();
+    if (text !== "") extras.push({ afterSection: extra.afterSection, text });
+    extra = null;
+  };
   for (const line of lines) {
     const p = probe2(line);
     const spec = PROPOSAL_SECTIONS.find(
       (s) => p === `${"#".repeat(s.level)} ${s.title}`
     );
     if (spec) {
+      flushExtra();
       current = spec.id;
+      lastFixed = spec.id;
       bodies.set(spec.id, []);
       continue;
     }
     if (ANY_HEADING.test(p)) {
+      flushExtra();
       current = null;
+      if (/^#[ \t]/.test(p) && !/^##/.test(p)) continue;
+      extra = { afterSection: lastFixed, lines: [p] };
       continue;
     }
     if (current) bodies.get(current).push(p);
+    else if (extra) extra.lines.push(p);
   }
+  flushExtra();
   const draft = emptyProposal();
   for (const spec of PROPOSAL_SECTIONS) {
-    const body = (bodies.get(spec.id) ?? []).join("\n").trim();
+    const collected = [...bodies.get(spec.id) ?? []];
+    if (collected[0] === "") collected.shift();
+    if (collected.length > 0 && collected[collected.length - 1] === "") collected.pop();
+    const body = collected.join("\n");
     if (body === "" || body === UNSATISFIED_MARKER) {
       draft[spec.id] = { state: "empty" };
       continue;
@@ -2696,7 +2725,7 @@ function parseProposalFile(src) {
     }
     draft[spec.id] = { state: "authored", body };
   }
-  return draft;
+  return { draft, extras };
 }
 var DESIGN_HEADING = /^##[ \t]+(.*)$/;
 function parseDesignFile(src) {
@@ -2775,7 +2804,17 @@ function parseTasksFile(src) {
     const task = TASK_LINE.exec(p);
     if (task && open) {
       const done = (task[1] ?? " ").toLowerCase() === "x";
-      open.tasks.push({ title: (task[3] ?? "").trim(), done });
+      open.tasks.push({ title: task[3] ?? "", done });
+      continue;
+    }
+    const continuation = TASK_CONTINUATION_LINE.exec(p);
+    if (continuation && open && open.tasks.length > 0) {
+      const last = open.tasks[open.tasks.length - 1];
+      open.tasks[open.tasks.length - 1] = {
+        ...last,
+        title: `${last.title}
+${continuation[1] ?? ""}`
+      };
     }
   }
   if (open) groups.push(open);
@@ -2997,10 +3036,29 @@ function validateDesign(change) {
   });
   return findings;
 }
+function draftIsWholeAgain(entry) {
+  const declared = entry.declaredRequirements ?? [];
+  if (declared.length === 0) return false;
+  return declared.every(
+    (name) => new RegExp(`^###[ \\t]+Requirement:[ \\t]*${escapeForRegExp(name)}\\s*$`, "m").test(entry.draft)
+  );
+}
+function escapeForRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function validateCapabilities(change) {
   const findings = [];
   let derivedDeltas = 0;
   for (const entry of change.capabilities) {
+    if (entry.reconstructed === false && !draftIsWholeAgain(entry)) {
+      findings.push({
+        severity: "error",
+        kind: "capability-draft-unreconstructed",
+        subject: { kind: "capability", capability: entry.capability },
+        message: `\`${entry.capability}\`'s draft could not be rebuilt from this change's delta and opened from the folded text instead${entry.reconstructionReason ? ` (${entry.reconstructionReason})` : ""}. Emitting from it would derive a delta without whatever this change had already added. Restore the draft before emitting.`
+      });
+      continue;
+    }
     if (entry.derivation.outcome === "refused") {
       findings.push(...refusalFindings(entry));
       continue;
@@ -3433,8 +3491,16 @@ function isDirectory(path) {
 }
 
 // src/workbench/write/write-change.ts
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, readdirSync as readdirSync6, statSync as statSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, readdirSync as readdirSync6, statSync as statSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { dirname as dirname4, join as join8 } from "node:path";
+
+// src/workbench/shell/lifecycle.ts
+var SPEC_DRIVEN = Object.freeze({
+  name: "spec-driven",
+  artifacts: Object.freeze(["proposal", "specs", "design", "tasks"])
+});
+
+// src/workbench/write/write-change.ts
 function changeDirectory(repoRoot, changeId) {
   return join8(repoRoot, "openspec", "changes", changeId);
 }
@@ -3454,6 +3520,7 @@ function writeChange(repoRoot, change, provenance, options = {}) {
   }
   const emitted = emitChangeWithProvenance(change, provenance);
   writeEmitted(directory, emitted);
+  writeSchemaFile(directory);
   return {
     outcome: "written",
     directory,
@@ -3489,6 +3556,12 @@ function readEmittedChange(directory, id) {
   }
   return { id, files };
 }
+function writeSchemaFile(directory) {
+  const path = join8(directory, ".openspec.yaml");
+  if (existsSync6(path)) return;
+  writeFileSync3(path, `schema: ${SPEC_DRIVEN.name}
+`, "utf8");
+}
 function writeEmitted(directory, emitted) {
   mkdirSync4(directory, { recursive: true });
   for (const file of emitted.files) {
@@ -3599,11 +3672,11 @@ ${body}
 }
 
 // src/workbench/agent/credential-probe.ts
-import { existsSync as existsSync6, readFileSync as readFileSync7, readdirSync as readdirSync7, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7, readdirSync as readdirSync7, statSync as statSync5 } from "node:fs";
 import { delimiter, join as join9 } from "node:path";
 function readSubscriptionToken(home) {
   const path = join9(home, ".claude", ".credentials.json");
-  if (!existsSync6(path)) return null;
+  if (!existsSync7(path)) return null;
   try {
     const parsed = JSON.parse(readFileSync7(path, "utf8"));
     const token = parsed.claudeAiOauth?.accessToken;
@@ -3841,7 +3914,7 @@ ${file.content}`;
   if (!target.resuming) return { read, changeText };
   for (const name of ["proposal.md", "tasks.md"]) {
     const file = join10(target.changeDir, name);
-    if (!existsSync7(file)) continue;
+    if (!existsSync8(file)) continue;
     changeText += `
 
 ===== ${name} =====
@@ -3850,7 +3923,7 @@ ${readFileSync8(file, "utf8")}`;
   }
   for (const capability of source.openCapabilities ?? []) {
     const file = join10(target.changeDir, "specs", capability, "spec.md");
-    if (!existsSync7(file)) continue;
+    if (!existsSync8(file)) continue;
     changeText += `
 
 ===== specs/${capability}/spec.md (the change's deltas) =====
@@ -3864,7 +3937,7 @@ var WorkbenchHostError = class extends Error {
 function findRepoRoot(start) {
   let dir = resolve3(start);
   for (; ; ) {
-    if (existsSync7(join10(dir, "openspec"))) return dir;
+    if (existsSync8(join10(dir, "openspec"))) return dir;
     const parent = dirname5(dir);
     if (parent === dir) return null;
     dir = parent;
@@ -3886,7 +3959,7 @@ function resolveTarget(cwd, changeId) {
     );
   }
   const changeDir = changeDirectory(repoRoot, changeId);
-  return { repoRoot, changeId, changeDir, resuming: existsSync7(changeDir) };
+  return { repoRoot, changeId, changeDir, resuming: existsSync8(changeDir) };
 }
 function mountWorkbenchHost(app, options) {
   const { target } = options;
@@ -3908,7 +3981,13 @@ function mountWorkbenchHost(app, options) {
             folded,
             draft: rebuilt.draft,
             reconstructed: rebuilt.outcome === "reconstructed",
-            ...rebuilt.outcome === "unreconstructable" ? { reason: rebuilt.reason } : {}
+            ...rebuilt.outcome === "unreconstructable" ? { reason: rebuilt.reason } : {},
+            // The requirement names the EMITTED delta declares. Carried so the
+            // emission gate can ask whether the draft is whole NOW, rather than
+            // only whether it loaded whole — otherwise an author who restores a
+            // requirement by hand stays blocked with no way forward inside the
+            // tool, which is a lock rather than a guard.
+            declared: [...spec.added, ...spec.modified].map((b) => /^###[ \t]+Requirement:[ \t]*(.*)$/m.exec(b)?.[1]?.trim()).filter((n) => n !== void 0 && n !== "")
           });
         }
       } catch {
@@ -4014,7 +4093,7 @@ function mountWorkbenchHost(app, options) {
 }
 
 // server/cli.ts
-var CLI_VERSION = true ? "2026.08.17.2" : "dev";
+var CLI_VERSION = true ? "2026.08.25.1" : "dev";
 var USAGE = `Usage: specsketch <change-id> [--port <n>] [--fixture]
        specsketch login [--profile <name>] [--web-url <url>]
        specsketch --version
@@ -4095,7 +4174,7 @@ function resolveClientDir(moduleUrl) {
     // repo: server/ -> dist/client
   ];
   for (const dir of candidates) {
-    if (existsSync8(join11(dir, "index.html"))) return dir;
+    if (existsSync9(join11(dir, "index.html"))) return dir;
   }
   return null;
 }
@@ -4103,8 +4182,8 @@ function staticResponse(clientDir, pathname) {
   const rel = normalize2(decodeURIComponent(pathname)).replace(/^\/+/, "");
   const target = resolve4(clientDir, rel === "" ? "index.html" : rel);
   if (!target.startsWith(resolve4(clientDir))) return null;
-  const file = existsSync8(target) && extname(target) ? target : join11(clientDir, "index.html");
-  if (!existsSync8(file)) return null;
+  const file = existsSync9(target) && extname(target) ? target : join11(clientDir, "index.html");
+  if (!existsSync9(file)) return null;
   return new Response(readFileSync9(file), {
     headers: { "Content-Type": MIME[extname(file)] ?? "application/octet-stream" }
   });