@gobing-ai/spur 0.2.11 → 0.3.0

package/spur.js

@@ -49160,8 +49160,9 @@ class AgentService {
     const doctorRunner = deps?.doctorRunner ?? new DoctorRunner({ agentDetector: detector, runner, env: this.ctx.env });
     return this.resolveAgent(undefined, flags, doctorRunner);
   }
-  async list(opts) {
-    const agents = await new AgentDetector().detectAll();
+  async list(opts, deps) {
+    const detector = deps?.detector ?? new AgentDetector;
+    const agents = await detector.detectAll();
     if (opts.json) {
       this.ctx.output.write(toJson({ agents }));
     } else {
@@ -49205,7 +49206,13 @@ class AgentService {
     }
     const result = outcome.result;
     const exitCode = result.exitCode === 0 ? 0 : 3;
-    return { exitCode, answer: result.stdout };
+    return {
+      exitCode,
+      answer: result.stdout,
+      durationMs: result.durationMs,
+      ...result.signal !== undefined ? { signal: result.signal } : {},
+      stderr: result.stderr
+    };
   }
   async executeRun(prompt, flags, deps, silent) {
     const mode = stringFlag(flags, "mode", "text");
@@ -57319,6 +57326,16 @@ var init_feature_check = __esm(() => {
 });
 
 // ../../packages/app/src/services/feature-service.ts
+function stripLeadingSectionHeader(body, sectionName) {
+  const match = body.match(/^(\s*)#{1,6}\s+(.+?)\s*(?:\n|$)/);
+  if (match === null)
+    return body;
+  const headingText = (match[2] ?? "").trim();
+  if (headingText.toLowerCase() !== sectionName.trim().toLowerCase())
+    return body;
+  return body.slice(match[0].length).replace(/^\n+/, "");
+}
+
 class FeatureService {
   ctx;
   constructor(ctx) {
@@ -57350,6 +57367,17 @@ class FeatureService {
     const ref = await this.refFor(id);
     return this.ctx.writeService.transition(ref, toStatus, actor ?? this.ctx.actor ?? "system");
   }
+  async updateSection(id, sectionName, sourceFile) {
+    const ref = await this.refFor(id);
+    const current = await this.ctx.fs.readFile(ref.filePath);
+    const doc2 = MarkdownDocument.parse(current, "feature");
+    if (!doc2.sectionNames.includes(sectionName)) {
+      throw new Error(`Feature ${id} does not contain section "${sectionName}". Available sections: ${doc2.sectionNames.join(", ")}`);
+    }
+    const raw = await this.ctx.fs.readFile(sourceFile);
+    const body = stripLeadingSectionHeader(raw, sectionName);
+    return this.ctx.writeService.updateSection(ref, sectionName, body);
+  }
   async list() {
     const results = [];
     try {
@@ -58655,28 +58683,26 @@ var init_task_check = __esm(() => {
       const variant = fm.template ?? DEFAULT_TASK_VARIANT;
       const entry = this.resolveMatrixEntry(variant, status);
       this.runL2(doc2, entry, findings);
-      this.runL3(doc2, entry, findings);
+      this.runL3(doc2, entry, status, findings);
       const tasksDir = dirname7(filePath);
       const featuresDir = join8(dirname7(tasksDir), "features");
       await this.runL4(doc2, fm, findings, featuresDir, tasksDir);
       await this.runL4Rollup(doc2, wbs, status, findings, tasksDir);
       return { wbs, ...this.summarizeWithStatus(status, findings, strict) };
     }
-    runL3(doc2, entry, findings) {
+    runL3(doc2, entry, status, findings) {
       const reqBody = doc2.getSection("Requirements");
       if (reqBody !== null && !isPlaceholderBody(reqBody)) {
-        const rLines = reqBody.trim().split(`
-`);
+        const blocks = reqBody.trim().split(/\n\s*\n/).filter((b) => b.trim().length > 0);
         let numbered = 0;
-        let allLines = 0;
-        for (const l of rLines) {
-          if (l.trim().length > 0) {
-            allLines++;
-            if (/^\s*[-*]?\s*(?:\[[ xX]\]\s*)?R\d+\.?\s/.test(l))
-              numbered++;
+        for (const block of blocks) {
+          const firstLine = block.trimStart().split(`
+`)[0] ?? "";
+          if (/^\s*[-*]?\s*(?:\[[ xX]\]\s*)?R\d+\.?\s/.test(firstLine)) {
+            numbered++;
           }
         }
-        if (numbered === 0 || numbered < allLines * 0.5) {
+        if (numbered === 0 || numbered < blocks.length * 0.5) {
           findings.push({
             layer: "L3",
             severity: "warning",
@@ -58737,6 +58763,18 @@ var init_task_check = __esm(() => {
           });
         }
       }
+      if (status === "done" || status === "cancelled") {
+        const fullBody = doc2.bodyWithoutFrontmatter;
+        const openBoxes = (fullBody.match(/^\s*[-*]\s\[ \]\s/gm) ?? []).length;
+        if (openBoxes > 0) {
+          findings.push({
+            layer: "L3",
+            severity: "warning",
+            section: "",
+            message: `Task is ${status} but carries ${openBoxes} unchecked checklist box(es) \u2014 flip to [x] or remove before closing`
+          });
+        }
+      }
     }
     async runL4(doc2, fm, findings, featuresDir, tasksDir) {
       const featureId2 = fm.feature_id ?? fm["feature-id"];
@@ -58939,8 +58977,9 @@ function parseVerdict(raw, fallbackWbs) {
       const wbs = typeof obj.wbs === "string" ? obj.wbs : fallbackWbs ?? "";
       const verdict = normalizeVerdict(obj.verdict);
       const requirements = normalizeRequirements(obj.requirements);
+      const acceptanceCriteria = normalizeAcceptanceCriteria(obj.acceptanceCriteria);
       const checks4 = normalizeChecks(obj.checks);
-      return { wbs, verdict, requirements, checks: checks4 };
+      return { wbs, verdict, requirements, acceptanceCriteria, checks: checks4 };
     }
   } catch {}
   return { wbs: fallbackWbs ?? "", verdict: "UNKNOWN", requirements: [], checks: [] };
@@ -58975,6 +59014,16 @@ function normalizeRequirements(raw) {
     evidence: typeof r.evidence === "string" ? r.evidence : ""
   }));
 }
+function normalizeAcceptanceCriteria(raw) {
+  if (!Array.isArray(raw))
+    return [];
+  return raw.filter((ac) => ac !== null && typeof ac === "object").map((ac) => ({
+    id: typeof ac.id === "string" ? ac.id : "",
+    status: typeof ac.status === "string" ? ac.status : "",
+    evidenceType: typeof ac.evidenceType === "string" ? ac.evidenceType : "",
+    evidence: typeof ac.evidence === "string" ? ac.evidence : ""
+  }));
+}
 function normalizeChecks(raw) {
   if (!Array.isArray(raw))
     return [];
@@ -59002,6 +59051,15 @@ function renderTesting(v) {
       lines.push(`| ${req.id} | ${req.status} | ${evidence} |`);
     }
   }
+  if ((v.acceptanceCriteria ?? []).length > 0) {
+    lines.push("");
+    lines.push("| Acceptance Criteria | Status | Evidence Type | Evidence |");
+    lines.push("|---------------------|--------|---------------|----------|");
+    for (const ac of v.acceptanceCriteria ?? []) {
+      const evidence = ac.evidence.replace(/\n/g, " ");
+      lines.push(`| ${ac.id} | ${ac.status} | ${ac.evidenceType} | ${evidence} |`);
+    }
+  }
   lines.push("- Coverage: N/A (verdict-based; verify pipeline does not measure code coverage)");
   return lines.join(`
 `);
@@ -59142,7 +59200,7 @@ function bulletizeRequirements(raw) {
   return parts.map((p) => `- ${p}`).join(`
 `);
 }
-function stripLeadingSectionHeader(body, sectionName) {
+function stripLeadingSectionHeader2(body, sectionName) {
   const match = body.match(/^(\s*)#{1,6}\s+(.+?)\s*(?:\n|$)/);
   if (match === null)
     return body;
@@ -59281,7 +59339,7 @@ class TaskService {
   async updateSection(wbs, sectionName, sourceFile) {
     const filePath = await this.resolveTaskFile(wbs);
     const raw = await this.ctx.fs.readFile(sourceFile);
-    const body = stripLeadingSectionHeader(raw, sectionName);
+    const body = stripLeadingSectionHeader2(raw, sectionName);
     const ref = { kind: "task", id: wbs, filePath, folder: this.ctx.tasksDir };
     return this.writeService.updateSection(ref, sectionName, body);
   }
@@ -59349,7 +59407,49 @@ ${issues}`);
       }
       throw err;
     }
-    return writeResults;
+    const parentsWired = await this.wireUpParents(this.collectDistinctParents(items));
+    return { children: writeResults, parentsWired };
+  }
+  collectDistinctParents(items) {
+    const seen = new Set;
+    const ordered = [];
+    for (const item of items) {
+      const wbs = item.parent_wbs;
+      if (typeof wbs !== "string" || wbs === "")
+        continue;
+      if (seen.has(wbs))
+        continue;
+      seen.add(wbs);
+      ordered.push(wbs);
+    }
+    return ordered;
+  }
+  async wireUpParents(parentWbsList) {
+    const out = [];
+    for (const wbs of parentWbsList) {
+      const entry = { wbs, rostered: false, transitionedTo: null, errors: [] };
+      try {
+        const roster = await this.refreshRoster(wbs);
+        entry.rostered = roster.written;
+      } catch (err) {
+        entry.errors.push(`refreshRoster: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      try {
+        const current = await this.show(wbs);
+        if (current.status === "todo") {
+          const filePath = await this.resolveTaskFile(wbs);
+          const ref = { kind: "task", id: wbs, filePath, folder: this.ctx.tasksDir };
+          const wr = await this.writeService.transition(ref, "wip", "system");
+          entry.transitionedTo = wr.toStatus ?? "wip";
+        } else {
+          entry.transitionedTo = null;
+        }
+      } catch (err) {
+        entry.errors.push(`transition: ${err instanceof Error ? err.message : String(err)}`);
+      }
+      out.push(entry);
+    }
+    return out;
   }
   async createBatchItem(item) {
     const folder = this.ctx.tasksDir;
@@ -59385,6 +59485,14 @@ ${issues}`);
         if (item.priority !== undefined && item.priority !== null) {
           content2 = patchFrontmatterField(content2, "priority", item.priority);
         }
+        if (item.tags !== undefined && item.tags.length > 0) {
+          content2 = patchFrontmatterField(content2, "tags", `[${item.tags.map((tag) => JSON.stringify(tag)).join(", ")}]`);
+        }
+        if ((item.requirements ?? "").trim() !== "") {
+          const doc2 = MarkdownDocument.parse(content2, "task");
+          doc2.replaceSection("Requirements", bulletizeRequirements(item.requirements ?? ""));
+          content2 = doc2.serialize();
+        }
         const ref2 = { kind: "task", id: wbs, filePath, folder };
         return { ref: ref2, content: content2 };
       }
@@ -59719,22 +59827,25 @@ var init_task_service = __esm(() => {
 // ../../packages/app/src/services/task-verdict.ts
 function deriveVerdict(answerText, taskCheckPassed) {
   const requirements = extractRequirements(answerText);
-  const checks4 = extractChecks(answerText, taskCheckPassed);
+  const acceptanceCriteria = applyAcceptanceCriteriaEvidenceRule(extractAcceptanceCriteria(answerText));
+  const checks4 = extractChecks(answerText, taskCheckPassed, acceptanceCriteria);
   if (requirements.length === 0) {
-    return { verdict: "UNKNOWN", requirements, checks: checks4 };
+    return { verdict: "UNKNOWN", requirements, acceptanceCriteria, checks: checks4 };
   }
   const hasUnmet = requirements.some((r) => r.status === "UNMET");
-  if (hasUnmet) {
-    return { verdict: "FAIL", requirements, checks: checks4 };
+  const hasUnmetAc = acceptanceCriteria.some((ac) => ac.status === "UNMET");
+  if (hasUnmet || hasUnmetAc) {
+    return { verdict: "FAIL", requirements, acceptanceCriteria, checks: checks4 };
   }
   const hasPartial = requirements.some((r) => r.status === "PARTIAL");
-  if (hasPartial) {
-    return { verdict: "PARTIAL", requirements, checks: checks4 };
+  const hasPartialAc = acceptanceCriteria.some((ac) => ac.status === "PARTIAL");
+  if (hasPartial || hasPartialAc) {
+    return { verdict: "PARTIAL", requirements, acceptanceCriteria, checks: checks4 };
   }
   if (!taskCheckPassed) {
-    return { verdict: "PARTIAL", requirements, checks: checks4 };
+    return { verdict: "PARTIAL", requirements, acceptanceCriteria, checks: checks4 };
   }
-  return { verdict: "PASS", requirements, checks: checks4 };
+  return { verdict: "PASS", requirements, acceptanceCriteria, checks: checks4 };
 }
 function extractRequirements(text4) {
   const reqs = [];
@@ -59757,6 +59868,12 @@ function extractRequirements(text4) {
     if (/^[-:]+$/.test(cells[0] ?? ""))
       continue;
     if (inTable && cells.length >= 2) {
+      const first = (cells[0] ?? "").toLowerCase();
+      const second = (cells[1] ?? "").toLowerCase();
+      if ((first === "ac" || first.includes("acceptance") || first === "check" || first === "name") && (second.includes("status") || second === "verdict")) {
+        inTable = false;
+        continue;
+      }
       const id = cells[0] ?? "";
       const statusRaw = (cells[1] ?? "").toUpperCase();
       const evidence = cells.length >= 3 ? cells[2] ?? "" : "";
@@ -59777,7 +59894,82 @@ function normalizeStatus(raw) {
     return "UNMET";
   return null;
 }
-function extractChecks(_text, taskCheckPassed) {
+function extractAcceptanceCriteria(text4) {
+  const rows = [];
+  const lines = text4.split(`
+`);
+  let inTable = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|"))
+      continue;
+    const cells = trimmed.split("|").map((c3) => c3.trim()).filter(Boolean);
+    if (!inTable && cells.length >= 4) {
+      const h0 = (cells[0] ?? "").toLowerCase();
+      const h1 = (cells[1] ?? "").toLowerCase();
+      const h2 = (cells[2] ?? "").toLowerCase();
+      if ((h0 === "ac" || h0.includes("acceptance")) && h1.includes("status") && h2.includes("evidence")) {
+        inTable = true;
+        continue;
+      }
+    }
+    if (/^[-:]+$/.test(cells[0] ?? ""))
+      continue;
+    if (inTable && cells.length >= 4) {
+      const id = cells[0] ?? "";
+      const status = normalizeAcceptanceCriteriaStatus(cells[1] ?? "");
+      const evidenceType = normalizeEvidenceType(cells[2] ?? "");
+      const evidence = cells[3] ?? "";
+      if (status !== null && evidenceType !== null && id.length > 0) {
+        rows.push({ id, status, evidenceType, evidence });
+      }
+    }
+  }
+  return rows;
+}
+function normalizeAcceptanceCriteriaStatus(raw) {
+  const upper = raw.toUpperCase();
+  if (/\bMET\b/.test(upper))
+    return "MET";
+  if (/\bPARTIAL\b/.test(upper))
+    return "PARTIAL";
+  if (/\bUNMET\b/.test(upper))
+    return "UNMET";
+  if (/\bN\/A\b/.test(upper) || /\bNA\b/.test(upper))
+    return "N/A";
+  return null;
+}
+function normalizeEvidenceType(raw) {
+  const normalized = raw.toLowerCase().trim();
+  if (normalized === "test")
+    return "test";
+  if (normalized === "command")
+    return "command";
+  if (normalized === "static-ref" || normalized === "static")
+    return "static-ref";
+  if (normalized === "manual-review" || normalized === "manual")
+    return "manual-review";
+  if (normalized === "llm-judge" || normalized === "judge")
+    return "llm-judge";
+  if (normalized === "n/a" || normalized === "na")
+    return "n/a";
+  return null;
+}
+function applyAcceptanceCriteriaEvidenceRule(rows) {
+  return rows.map((row) => {
+    if (row.status === "MET" && requiresExecutableEvidence(row.id) && row.evidenceType !== "test" && row.evidenceType !== "command") {
+      return { ...row, status: "PARTIAL" };
+    }
+    return row;
+  });
+}
+function requiresExecutableEvidence(id) {
+  const normalized = id.toLowerCase();
+  const nonCore = normalized.includes("[advisory]") || normalized.includes("[non-core]");
+  const nonBehavior = normalized.includes("[non-behavior]") || normalized.includes("[docs-only]") || normalized.includes("[doc-only]");
+  return !nonCore && !nonBehavior;
+}
+function extractChecks(_text, taskCheckPassed, acceptanceCriteria) {
   const checks4 = [
     {
       name: "spur task check",
@@ -59809,6 +60001,14 @@ function extractChecks(_text, taskCheckPassed) {
       }
     }
   }
+  if (acceptanceCriteria.length > 0) {
+    const downgraded = acceptanceCriteria.filter((row) => row.status === "PARTIAL" && requiresExecutableEvidence(row.id) && row.evidenceType !== "test" && row.evidenceType !== "command");
+    checks4.push({
+      name: downgraded.length > 0 ? "evidence-rule-failed" : "evidence-rule-pass",
+      status: downgraded.length > 0 ? "fail" : "pass",
+      evidence: downgraded.length > 0 ? `Executable evidence missing for: ${downgraded.map((row) => row.id).join(", ")}` : "All behavior-bearing AC rows have executable evidence or are explicitly non-behavioral."
+    });
+  }
   return checks4;
 }
 
@@ -59966,8 +60166,11 @@ var init_team_service = __esm(() => {
 });
 
 // ../../packages/app/src/workflow/actions/agent-run.ts
+import { execFile } from "child_process";
+import { existsSync as existsSync4 } from "fs";
 import { mkdir, writeFile } from "fs/promises";
 import { dirname as dirname9, isAbsolute as isAbsolute2, join as join10 } from "path";
+import { promisify as promisify3 } from "util";
 
 class AgentRunActionRunner {
   kind = KIND;
@@ -60012,16 +60215,31 @@ class AgentRunActionRunner {
     if (continueFlag !== undefined)
       flags.continue = continueFlag;
     const answerFile = asOptionalString(options.answerFile);
+    const expectFile = asOptionalString(options.expectFile);
     const capture = asOptionalBoolean(options.capture) || answerFile !== undefined;
     const agentLabel = agent ?? "<default>";
     if (capture) {
-      const { exitCode: exitCode2, answer } = await this.agentService.runCapture(input, flags);
+      const captured = await this.agentService.runCapture(input, flags);
+      const { exitCode: exitCode2, answer } = captured;
       const ok2 = exitCode2 === 0;
       if (answerFile !== undefined) {
         const target = isAbsolute2(answerFile) ? answerFile : join10(cwd, answerFile);
         await mkdir(dirname9(target), { recursive: true });
         await writeFile(target, answer, "utf8");
       }
+      if (ok2 && expectFile !== undefined) {
+        const target = isAbsolute2(expectFile) ? expectFile : join10(cwd, expectFile);
+        if (!existsSync4(target)) {
+          return {
+            ok: false,
+            data: { exitCode: exitCode2, agent: agentLabel, answer },
+            error: `agent.run (${agentLabel}) exited 0 but expected file is absent: ${expectFile}`
+          };
+        }
+      }
+      if (!ok2) {
+        await writePartialWorkArtifact(context3, agentLabel, captured, cwd);
+      }
       return {
         ok: ok2,
         data: { exitCode: exitCode2, agent: agentLabel, answer },
@@ -60031,6 +60249,16 @@ class AgentRunActionRunner {
     }
     const exitCode = await this.agentService.run(input, flags);
     const ok = exitCode === 0;
+    if (ok && expectFile !== undefined) {
+      const target = isAbsolute2(expectFile) ? expectFile : join10(cwd, expectFile);
+      if (!existsSync4(target)) {
+        return {
+          ok: false,
+          data: { exitCode, agent: agentLabel },
+          error: `agent.run (${agentLabel}) exited 0 but expected file is absent: ${expectFile}`
+        };
+      }
+    }
     return {
       ok,
       data: { exitCode, agent: agentLabel },
@@ -60066,8 +60294,60 @@ function asOptionalNumber(value) {
   }
   return;
 }
-var KIND = "agent.run";
-var init_agent_run = () => {};
+async function writePartialWorkArtifact(context3, agentLabel, captured, cwd) {
+  try {
+    const exitReason = captured.signal !== undefined ? `killed by signal ${captured.signal} (likely timeout)` : `exited with code ${captured.exitCode}`;
+    const diffStat = await gitDiffStat(cwd);
+    const stdoutTail = tail(captured.answer, PARTIAL_ARTIFACT_TAIL_CHARS);
+    const stderrTail = tail(captured.stderr ?? "", PARTIAL_ARTIFACT_TAIL_CHARS);
+    const body = [
+      `# Partial-work handoff \u2014 ${agentLabel}`,
+      "",
+      `- run: ${context3.runId}`,
+      `- state: ${context3.stateOrNodeId}`,
+      `- exit reason: ${exitReason}`,
+      `- elapsed: ${captured.durationMs ?? "unknown"}ms`,
+      "",
+      "## git diff --stat",
+      "```",
+      diffStat || "(no diff)",
+      "```",
+      "",
+      "## stdout tail",
+      "```",
+      stdoutTail || "(empty)",
+      "```",
+      "",
+      "## stderr tail",
+      "```",
+      stderrTail || "(empty)",
+      "```",
+      ""
+    ].join(`
+`);
+    const target = join10(cwd, ".spur", "run", `${context3.runId}-${context3.stateOrNodeId}-partial.md`);
+    await mkdir(dirname9(target), { recursive: true });
+    await writeFile(target, body, "utf8");
+  } catch {}
+}
+async function gitDiffStat(cwd) {
+  try {
+    const { stdout } = await execFileAsync("git", ["diff", "--stat"], { cwd, maxBuffer: 1024 * 1024 });
+    return stdout.trim();
+  } catch {
+    return "";
+  }
+}
+function tail(text4, maxChars) {
+  if (text4.length <= maxChars)
+    return text4;
+  return `... (truncated) ...
+${text4.slice(text4.length - maxChars)}`;
+}
+var execFileAsync, PARTIAL_ARTIFACT_TAIL_CHARS = 4000, KIND = "agent.run";
+var init_agent_run = __esm(() => {
+  execFileAsync = promisify3(execFile);
+});
 
 // ../../packages/app/src/workflow/actions/file-exists.ts
 class FileExistsActionRunner {
@@ -60146,9 +60426,51 @@ var init_file_read = __esm(() => {
   init_dist3();
 });
 
+// ../../packages/app/src/workflow/actions/file-read-into-var.ts
+class FileReadIntoVarActionRunner {
+  fileSystem;
+  kind = KIND4;
+  constructor(fileSystem) {
+    this.fileSystem = fileSystem;
+  }
+  async execute(options, context3) {
+    const rawPath = options.path;
+    if (typeof rawPath !== "string" || rawPath === "") {
+      return { ok: false, error: "file.read.into-var: path is required" };
+    }
+    const varName = options.var;
+    if (typeof varName !== "string" || varName === "") {
+      return { ok: false, error: "file.read.into-var: var is required" };
+    }
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(varName)) {
+      return {
+        ok: false,
+        error: `file.read.into-var: var name must match /^[A-Za-z_][A-Za-z0-9_]*$/, got "${varName}"`
+      };
+    }
+    const trim = options.trim === undefined ? true : options.trim !== false;
+    const resolved = isAbsolutePath(rawPath) ? normalizeSeparators(rawPath) : joinPath(context3.workdir ?? ".", rawPath);
+    const stat2 = await this.fileSystem.stat(resolved);
+    if (stat2 === null) {
+      return { ok: false, error: `file.read.into-var: file not found: ${resolved}` };
+    }
+    const raw = await this.fileSystem.readFile(resolved);
+    const projected = trim ? raw.replace(/\s+$/u, "") : raw;
+    return {
+      ok: true,
+      data: { content: projected, raw, var: varName, path: resolved, size: stat2.size },
+      setVars: { [varName]: projected }
+    };
+  }
+}
+var KIND4 = "file.read.into-var";
+var init_file_read_into_var = __esm(() => {
+  init_dist3();
+});
+
 // ../../packages/app/src/workflow/actions/hitl-confirm.ts
 class HitlConfirmActionRunner {
-  kind = KIND4;
+  kind = KIND5;
   responder;
   constructor(responder) {
     this.responder = responder;
@@ -60176,12 +60498,9 @@ class HitlConfirmActionRunner {
       node: context3.stateOrNodeId,
       ok: !(answer.cancelled || answer.value === "cancel")
     });
-    if (answer.cancelled || answer.value === "cancel") {
-      return { ok: false, error: "hitl.confirm cancelled" };
-    }
     return {
       ok: true,
-      data: { answer: answer.value },
+      data: { answer: answer.value, cancelled: answer.cancelled === true || answer.value === "cancel" },
       setVars: { [varName]: answer.value }
     };
   }
@@ -60191,11 +60510,11 @@ function asString2(value) {
     return;
   return String(value);
 }
-var KIND4 = "hitl.confirm";
+var KIND5 = "hitl.confirm";
 
 // ../../packages/app/src/workflow/actions/hitl-input.ts
 class HitlInputActionRunner {
-  kind = KIND5;
+  kind = KIND6;
   responder;
   constructor(responder) {
     this.responder = responder;
@@ -60238,11 +60557,11 @@ function asString3(value) {
     return;
   return String(value);
 }
-var KIND5 = "hitl.input";
+var KIND6 = "hitl.input";
 
 // ../../packages/app/src/workflow/actions/hitl-select.ts
 class HitlSelectActionRunner {
-  kind = KIND6;
+  kind = KIND7;
   responder;
   constructor(responder) {
     this.responder = responder;
@@ -60295,7 +60614,7 @@ function asStringArray(value) {
     return;
   return value.map((v) => String(v));
 }
-var KIND6 = "hitl.select";
+var KIND7 = "hitl.select";
 
 // ../../packages/app/src/workflow/actions/http-request.ts
 function resolveTemplate(value, vars) {
@@ -60312,7 +60631,7 @@ function redactHeaders(message) {
 }
 
 class HttpRequestActionRunner {
-  kind = KIND7;
+  kind = KIND8;
   requester;
   allowlist;
   constructor(requester, allowlist) {
@@ -60467,7 +60786,7 @@ function asNumberArray(value) {
     return [];
   return value.filter((v) => typeof v === "number" && !Number.isNaN(v));
 }
-var KIND7 = "http.request", ALLOWED_METHODS, DEFAULT_TIMEOUT_MS3 = 30000, MAX_TIMEOUT_MS = 120000, DEFAULT_MAX_RESPONSE_BYTES = 1048576, HEADER_NAME_RE, HEADER_VALUE_RE, PRIVATE_IP_PATTERNS;
+var KIND8 = "http.request", ALLOWED_METHODS, DEFAULT_TIMEOUT_MS3 = 30000, MAX_TIMEOUT_MS = 120000, DEFAULT_MAX_RESPONSE_BYTES = 1048576, HEADER_NAME_RE, HEADER_VALUE_RE, PRIVATE_IP_PATTERNS;
 var init_http_request = __esm(() => {
   ALLOWED_METHODS = {
     GET: true,
@@ -60496,7 +60815,7 @@ var init_http_request = __esm(() => {
 
 // ../../packages/app/src/workflow/actions/response-validate.ts
 class ResponseValidateActionRunner {
-  kind = KIND8;
+  kind = KIND9;
   engine;
   constructor(engine2) {
     this.engine = engine2;
@@ -60525,7 +60844,7 @@ function asString5(value) {
     return;
   return String(value);
 }
-var KIND8 = "response.validate";
+var KIND9 = "response.validate";
 
 // ../../packages/app/src/workflow/utils.ts
 var identity6 = (s) => s, NO_COLOR;
@@ -60542,7 +60861,7 @@ var init_utils3 = __esm(() => {
 
 // ../../packages/app/src/workflow/actions/rule-check.ts
 class RuleCheckActionRunner {
-  kind = KIND9;
+  kind = KIND10;
   ruleService;
   constructor(ruleService) {
     this.ruleService = ruleService;
@@ -60577,7 +60896,7 @@ function asString6(value) {
     return;
   return String(value);
 }
-var KIND9 = "rule.check";
+var KIND10 = "rule.check";
 var init_rule_check = __esm(() => {
   init_utils3();
 });
@@ -60589,6 +60908,7 @@ function registerSpurBuiltins(host, options) {
   host.registerAction(new RuleCheckActionRunner(options.ruleService), "builtin");
   host.registerAction(new FileExistsActionRunner(fileSystem), "builtin");
   host.registerAction(new FileReadActionRunner(fileSystem), "builtin");
+  host.registerAction(new FileReadIntoVarActionRunner(fileSystem), "builtin");
   host.registerAction(new HitlConfirmActionRunner(options.hitlResponder), "builtin");
   host.registerAction(new HitlSelectActionRunner(options.hitlResponder), "builtin");
   host.registerAction(new HitlInputActionRunner(options.hitlResponder), "builtin");
@@ -60604,6 +60924,7 @@ var init_builtins2 = __esm(() => {
   init_agent_run();
   init_file_exists();
   init_file_read();
+  init_file_read_into_var();
   init_http_request();
   init_rule_check();
 });
@@ -61219,6 +61540,7 @@ __export(exports_src2, {
   HitlInputActionRunner: () => HitlInputActionRunner,
   HitlConfirmActionRunner: () => HitlConfirmActionRunner,
   HistoryService: () => HistoryService,
+  FileReadIntoVarActionRunner: () => FileReadIntoVarActionRunner,
   FileReadActionRunner: () => FileReadActionRunner,
   FileExistsActionRunner: () => FileExistsActionRunner,
   FeatureService: () => FeatureService,
@@ -61248,6 +61570,7 @@ var init_src3 = __esm(() => {
   init_agent_run();
   init_file_exists();
   init_file_read();
+  init_file_read_into_var();
   init_rule_check();
   init_builtins2();
   init_lifecycle_adapter();
@@ -68685,7 +69008,7 @@ init_src3();
 init_src3();
 init_loader();
 init_src2();
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { join as join12 } from "path";
 
 // src/workflow/resolve-spur-bin.ts
@@ -68708,11 +69031,11 @@ function resolveWorkflowPath(context3, profile) {
   const bundledRoot = bundledConfigRoot();
   if (bundledRoot !== null) {
     const bundledPath = join12(bundledRoot, "workflows", `${profile.workflowName}.yaml`);
-    if (existsSync4(bundledPath))
+    if (existsSync5(bundledPath))
       return bundledPath;
   }
   const projectPath = join12(context3.cwd, ".spur", "workflows", `${profile.workflowName}.yaml`);
-  if (existsSync4(projectPath))
+  if (existsSync5(projectPath))
     return projectPath;
   return null;
 }
@@ -68768,23 +69091,115 @@ function registerFeatureCommand(program2, context3) {
       context3.setExitCode(1);
     }
   });
-  feature.command("update").summary("Update a feature status (lifecycle) or a scalar frontmatter field.").argument("<id>", "Feature ID").argument("[status]", "New lifecycle status (omit when using --field/--value)").option("--field <key>", "Frontmatter field to set (e.g. priority)").option("--value <value>", "New value for --field").option("--folder <path>", "Custom features folder").option("--json", "Output machine-readable JSON").action(async (id, status, options) => {
+  feature.command("update").summary("Update a feature status, scalar frontmatter field, or section body.").argument("<id>", "Feature ID").argument("[status]", "New lifecycle status").option("--field <key>", "Frontmatter field to set (e.g. priority)").option("--value <value>", "New value for --field").option("--section <name>", "Section name to replace").option("--from-file <path>", "File to read section body from (requires --section)").option("--folder <path>", "Custom features folder").option("--json", "Output machine-readable JSON").action(async (id, status, options) => {
     const svc = await makeService(context3, options.folder);
     try {
+      let result;
+      if (options.section !== undefined) {
+        if (options.fromFile === undefined) {
+          context3.output.error("--from-file is required with --section");
+          context3.setExitCode(2);
+          return;
+        }
+        result = await svc.updateSection(id, options.section, options.fromFile);
+        if (!options.json) {
+          for (const warning of result.warnings ?? []) {
+            context3.output.error(warning);
+          }
+          context3.output.write(`Updated section '${options.section}' in feature ${result.ref.id}`);
+        }
+      } else if (options.fromFile !== undefined) {
+        context3.output.error("--section is required with --from-file");
+        context3.setExitCode(2);
+        return;
+      }
       if (options.field !== undefined) {
         if (options.value === undefined) {
           context3.output.error("--value is required with --field");
           context3.setExitCode(2);
           return;
         }
-        const result = await svc.update(id, options.field, options.value);
-        write(context3, options.json, result, `Updated ${options.field} on feature ${result.ref.id}`);
-      } else if (status !== undefined) {
-        const result = await svc.transition(id, status);
-        write(context3, options.json, result, `${result.ref.id}: ${result.fromStatus} \u2192 ${result.toStatus}`);
-      } else {
-        context3.output.error("Either <status> or --field/--value is required");
+        result = await svc.update(id, options.field, options.value);
+        if (!options.json) {
+          context3.output.write(`Updated ${options.field} on feature ${result.ref.id}`);
+        }
+      } else if (options.value !== undefined) {
+        context3.output.error("--field is required with --value");
         context3.setExitCode(2);
+        return;
+      }
+      if (status !== undefined) {
+        result = await svc.transition(id, status);
+        if (!options.json) {
+          context3.output.write(`${result.ref.id}: ${result.fromStatus} \u2192 ${result.toStatus}`);
+        }
+      }
+      if (result === undefined) {
+        context3.output.error("Either <status>, --field/--value, or --section/--from-file is required");
+        context3.setExitCode(2);
+        return;
+      }
+      if (options.json) {
+        context3.output.write(toJson2(result));
+      }
+    } catch (err) {
+      context3.output.error(String(err));
+      context3.setExitCode(1);
+    }
+  });
+  feature.command("advance").summary("Walk a feature through the legal forward lifecycle path.").argument("<id>", "Feature ID to advance").option("--to <status>", "Target status (default: 'done')").option("--folder <path>", "Custom features folder").option("--json", "Output machine-readable JSON").action(async (id, options) => {
+    const svc = await makeService(context3, options.folder);
+    const target = options.to ?? "done";
+    const forwardPath = {
+      backlog: "active",
+      active: "verifying",
+      verifying: "done"
+    };
+    const history = [];
+    try {
+      const initial = await svc.show(id);
+      if (initial === null) {
+        context3.output.error(`Feature ${id} not found`);
+        context3.setExitCode(1);
+        return;
+      }
+      let current = initial.status;
+      if (current === target) {
+        if (options.json) {
+          context3.output.write(toJson2({ id, status: current, hops: history }));
+        } else {
+          context3.output.write(`${id}: already at ${current}; no advance needed`);
+        }
+        return;
+      }
+      let next = forwardPath[current];
+      while (next !== undefined) {
+        if (current === "active") {
+          await assertFeatureCheckPass(context3, id, options.folder, false);
+        } else if (current === "verifying") {
+          await assertFeatureCheckPass(context3, id, options.folder, true);
+        }
+        const result = await svc.transition(id, next);
+        history.push({ from: result.fromStatus ?? current, to: result.toStatus ?? next });
+        const observed = await svc.show(id);
+        current = observed?.status ?? result.toStatus ?? next;
+        if (current !== next) {
+          throw new Error(`Feature ${id} expected status '${next}' after transition, observed '${current}'`);
+        }
+        if (current === target)
+          break;
+        next = forwardPath[current];
+      }
+      if (current !== target) {
+        context3.output.error(`${id}: cannot reach '${target}' from '${current}' along the forward path`);
+        context3.setExitCode(1);
+        return;
+      }
+      if (options.json) {
+        context3.output.write(toJson2({ id, status: current, hops: history }));
+      } else {
+        const trail = history.map((h2) => `${h2.from} \u2192 ${h2.to}`).join(", ");
+        context3.output.write(`${id}: advanced to ${current} (${trail})`);
       }
     } catch (err) {
       context3.output.error(String(err));
@@ -68896,13 +69311,6 @@ ${result.id} (${result.status}): ${result.pass ? "PASS" : "FAIL"}`);
     }
   });
 }
-function write(context3, json3, result, humanLine) {
-  if (json3) {
-    context3.output.write(toJson2(result));
-  } else {
-    context3.output.write(humanLine);
-  }
-}
 async function makeService(context3, folderOverride) {
   const resolved = await resolvePlanningFolders(context3.fs);
   const featuresDir = folderOverride ?? context3.fs.resolve(resolved.featuresDir);
@@ -68914,6 +69322,25 @@ async function makeService(context3, folderOverride) {
   });
   return new FeatureService({ fs: context3.fs, writeService, featuresDir, tasksDir });
 }
+async function assertFeatureCheckPass(context3, id, folderOverride, strict) {
+  const resolved = await resolvePlanningFolders(context3.fs);
+  const featuresDir = folderOverride ?? context3.fs.resolve(resolved.featuresDir);
+  const tasksDir = context3.fs.resolve(resolved.tasksDir);
+  const entries = await context3.fs.readDir(featuresDir);
+  const fileName = entries.find((name) => name.match(new RegExp(`^${id}_.+\\.md$`)));
+  if (fileName === undefined) {
+    throw new Error(`Feature ${id} not found`);
+  }
+  const result = await new FeatureCheckService(context3.fs).check(`${featuresDir}/${fileName}`, id, {
+    strict,
+    featuresDir,
+    tasksDir
+  });
+  if (!result.pass) {
+    const details = result.findings.map((f) => `${f.layer} ${f.section}: ${f.message}`).join("; ");
+    throw new Error(`Feature ${id} check failed before advance${strict ? " (strict)" : ""}: ${details}`);
+  }
+}
 
 // src/commands/history.ts
 init_src3();
@@ -68967,7 +69394,7 @@ import { join as join13, resolve as resolve4 } from "path";
 var CLI_CONFIG = {
   binaryName: "spur",
   binaryLabel: "spur",
-  binaryVersion: "0.2.11",
+  binaryVersion: "0.3.0",
   configDir: ".spur",
   configFile: ".spur/config.yaml",
   databaseFile: ".spur/spur.db"
@@ -68983,6 +69410,8 @@ var SCAFFOLD_MANIFEST = [
   { source: "workflows/feature-dev.yaml", target: "workflows/feature-dev.yaml" },
   { source: "workflows/task-pipeline.yaml", target: "workflows/task-pipeline.yaml" },
   { source: "workflows/planning-pipeline.yaml", target: "workflows/planning-pipeline.yaml" },
+  { source: "workflows/idea-pipeline.yaml", target: "workflows/idea-pipeline.yaml" },
+  { source: "workflows/wrapup-pipeline.yaml", target: "workflows/wrapup-pipeline.yaml" },
   { source: "tasks/section-matrix.yaml", target: "tasks/section-matrix.yaml" },
   { source: "templates/task/standard.md", target: "tasks/templates/standard.md" },
   { source: "templates/task/feature-impl.md", target: "tasks/templates/feature-impl.md" },
@@ -77672,7 +78101,7 @@ async function readTargetStatus(context3, targetPath) {
 init_src3();
 init_loader();
 init_src2();
-import { existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import { join as join18 } from "path";
 // schemas/section-matrix.schema.json
 var section_matrix_schema_default = {
@@ -78319,15 +78748,23 @@ ${result.content}`);
   task.command("batch-create").summary("Create many tasks from a validated JSON file \u2014 all-or-nothing (LLM\u2192CLI gate).").requiredOption("--file <path>", "Path to the batch JSON file validated against task-batch.schema.json").option("--folder <path>", "Custom tasks folder").option("--json", "Output machine-readable JSON").action(async (options) => {
     const svc = await makeService2(context3, options.folder);
     try {
-      const results = await svc.batchCreate(options.file);
+      const { children, parentsWired } = await svc.batchCreate(options.file);
       if (options.json) {
-        const ids = results.map((r2) => r2.ref.id);
-        context3.output.write(toJson2({ created: results.length, wbs: ids }));
+        const ids = children.map((r2) => r2.ref.id);
+        context3.output.write(toJson2({ created: children.length, wbs: ids, parentsWired }));
       } else {
-        context3.output.write(`Created ${results.length} task(s)`);
-        for (const r2 of results) {
+        context3.output.write(`Created ${children.length} task(s)`);
+        for (const r2 of children) {
           context3.output.write(`  ${r2.ref.id}  ${r2.ref.filePath}`);
         }
+        if (parentsWired.length > 0) {
+          context3.output.write(`Wired ${parentsWired.length} parent(s):`);
+          for (const p2 of parentsWired) {
+            const txLine = p2.transitionedTo ? ` \u2192 ${p2.transitionedTo}` : "";
+            const errLine = p2.errors.length > 0 ? ` (errors: ${p2.errors.join("; ")})` : "";
+            context3.output.write(`  ${p2.wbs}  rostered=${p2.rostered}${txLine}${errLine}`);
+          }
+        }
       }
     } catch (err) {
       context3.output.error(String(err));
@@ -78384,7 +78821,7 @@ ${result.content}`);
     } else {
       context3.output.write(`Verdict: ${result.verdict} (${result.requirements.length} requirements, ${result.checks.length} checks)`);
     }
-    if (result.verdict === "UNKNOWN") {
+    if (result.verdict !== "PASS") {
       context3.setExitCode(1);
     }
   });
@@ -78495,7 +78932,7 @@ function loadTemplateContent(projectRoot, variant) {
   if (templateMissSet.has(variant))
     return;
   const localPath = join18(projectRoot, ".spur", "tasks", "templates", `${variant}.md`);
-  if (existsSync5(localPath)) {
+  if (existsSync6(localPath)) {
     const content = readFileSync6(localPath, "utf8");
     templateContentCache.set(variant, content);
     return content;
@@ -78503,7 +78940,7 @@ function loadTemplateContent(projectRoot, variant) {
   const root = bundledConfigRoot();
   if (root !== null) {
     const templatePath = join18(root, "templates", "task", `${variant}.md`);
-    if (existsSync5(templatePath)) {
+    if (existsSync6(templatePath)) {
       const content = readFileSync6(templatePath, "utf8");
       templateContentCache.set(variant, content);
       return content;
@@ -78519,13 +78956,13 @@ function loadTemplateBodies(projectRoot, variant) {
     return cached2;
   let bodies = {};
   const localPath = join18(projectRoot, ".spur", "tasks", "templates", `${variant}.md`);
-  if (existsSync5(localPath)) {
+  if (existsSync6(localPath)) {
     bodies = extractTemplateBodies(readFileSync6(localPath, "utf8"));
   } else {
     const root = bundledConfigRoot();
     if (root !== null) {
       const templatePath = join18(root, "templates", "task", `${variant}.md`);
-      if (existsSync5(templatePath)) {
+      if (existsSync6(templatePath)) {
         bodies = extractTemplateBodies(readFileSync6(templatePath, "utf8"));
       }
     }
@@ -78560,7 +78997,7 @@ async function loadSectionMatrix(projectRoot) {
 }
 async function loadSectionMatrixUncached(projectRoot) {
   const localPath = join18(projectRoot, ".spur", "tasks", "section-matrix.yaml");
-  if (existsSync5(localPath)) {
+  if (existsSync6(localPath)) {
     const data = await loadStructuredSpurConfig(localPath, {
       validateJsonSchema: true,
       embeddedSchemas: EMBEDDED_SPUR_SCHEMAS
@@ -78570,7 +79007,7 @@ async function loadSectionMatrixUncached(projectRoot) {
   const root = bundledConfigRoot();
   if (root !== null) {
     const matrixPath = join18(root, "tasks", "section-matrix.yaml");
-    if (existsSync5(matrixPath)) {
+    if (existsSync6(matrixPath)) {
       const data = await loadStructuredSpurConfig(matrixPath, {
         validateJsonSchema: true,
         embeddedSchemas: EMBEDDED_SPUR_SCHEMAS