@gobing-ai/spur 0.4.8 → 0.4.9

package/plugins/sp/scripts/wrapup-steps.mjs

@@ -1,627 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/wrapup-steps.ts
-import { spawnSync } from "child_process";
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-
-// plugins/sp/lib/env.ts
-function getEnvVars() {
-  return process.env;
-}
-
-// plugins/sp/lib/spur-bin.ts
-function spurCommand(spurBin) {
-  const parts = (spurBin ?? "spur").trim().split(/\s+/).filter((p) => p.length > 0);
-  return { cmd: parts[0] ?? "spur", prefix: parts.slice(1) };
-}
-
-// plugins/sp/scripts/wrapup-steps.ts
-function jqPick(...values) {
-  for (const value of values) {
-    if (value !== null && value !== undefined && value !== false)
-      return value;
-  }
-  return values[values.length - 1];
-}
-function jqText(value) {
-  return typeof value === "string" ? value : JSON.stringify(value);
-}
-var WBS_PATTERN = /^[0-9]{4}$/;
-function spur(env, args, options = {}) {
-  const { cmd, prefix } = spurCommand(env.spurBin);
-  const result = spawnSync(cmd, [...prefix, ...args], {
-    cwd: options.cwd,
-    encoding: "utf8",
-    ...options.stderr === "inherit" ? { stdio: ["ignore", "pipe", "inherit"] } : {}
-  });
-  if (result.error !== undefined)
-    return { status: result.status ?? 1, stdout: "" };
-  return { status: result.status ?? 1, stdout: result.stdout ?? "" };
-}
-function taskStatusOf(taskJson) {
-  let parsed;
-  try {
-    parsed = JSON.parse(taskJson);
-  } catch {
-    return { resolved: null, present: false };
-  }
-  if (parsed === null || typeof parsed !== "object")
-    return { resolved: null, present: false };
-  const frontmatter = parsed.frontmatter;
-  const fmStatus = frontmatter !== null && typeof frontmatter === "object" ? frontmatter.status : undefined;
-  const status = parsed.status;
-  if (fmStatus === null || fmStatus === undefined) {
-    return { resolved: status ?? null, present: status !== undefined && status !== null };
-  }
-  return { resolved: fmStatus, present: true };
-}
-function statusDisplay(taskJson) {
-  const { resolved } = taskStatusOf(taskJson);
-  if (resolved === null || resolved === undefined || resolved === false)
-    return "unresolved";
-  return jqText(resolved);
-}
-function resolveTasks(env, options = {}) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? "";
-  if (runId.length === 0) {
-    process.stderr.write(`task-resolve: __runId is empty \u2014 refusing the legacy fixed-path fallback
-`);
-    return { status: "FAIL", statusFile: "", tasksFile: "", exitCode: 1 };
-  }
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  const relTasksFile = join(".spur", "run", `${runId}-wrapup-tasks.json`);
-  const relReasonFile = join(".spur", "run", `${runId}-route-reason.txt`);
-  const relStatusFile = join(".spur", "run", `${runId}-wrapup-resolve.status`);
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  const writeFail = (reason) => {
-    writeFileSync(abs(relReasonFile), reason);
-    writeFileSync(abs(relStatusFile), `FAIL
-`);
-    return { status: "FAIL", statusFile: relStatusFile, tasksFile: relTasksFile, exitCode: 0 };
-  };
-  let parsedTasks;
-  try {
-    parsedTasks = JSON.parse(env.tasks ?? "");
-  } catch {
-    parsedTasks = undefined;
-  }
-  const validArray = Array.isArray(parsedTasks) && parsedTasks.every((w) => typeof w === "string" && WBS_PATTERN.test(w));
-  if (!validArray) {
-    process.stderr.write(`task-resolve: tasks must be a JSON array of canonical four-digit WBS strings (whitespace is rejected, not trimmed)
-`);
-    return writeFail("failed:tasks is not a JSON array of canonical four-digit WBS strings");
-  }
-  const deduped = [];
-  for (const wbs of parsedTasks) {
-    if (!deduped.includes(wbs))
-      deduped.push(wbs);
-  }
-  writeFileSync(abs(relTasksFile), `${JSON.stringify(deduped)}
-`);
-  let unresolved = false;
-  for (const wbs of deduped) {
-    const shown = spur(env, ["task", "show", wbs, "--json"], { cwd });
-    const status = shown.status === 0 ? statusDisplay(shown.stdout) : "unresolved";
-    if (status !== "done" && status !== "cancelled") {
-      process.stderr.write(`task-resolve: task ${wbs} did not resolve to a completed status (status=${status})
-`);
-      unresolved = true;
-    }
-  }
-  if (unresolved) {
-    return writeFail(`failed:unresolved or non-completed task (see ${relTasksFile})`);
-  }
-  if ((env.feature ?? "") !== "") {
-    const pf = preflightFeature(env, cwd);
-    if (pf)
-      return writeFail(pf);
-  }
-  writeFileSync(abs(relStatusFile), `PASS
-`);
-  return { status: "PASS", statusFile: relStatusFile, tasksFile: relTasksFile, exitCode: 0 };
-}
-function isFindingList(value) {
-  return Array.isArray(value) && value.every((f) => f !== null && typeof f === "object" && typeof f.severity === "string" && typeof f.code === "string" && f.code.length > 0);
-}
-function sortedUniqueCodes(findings) {
-  const codes = findings.filter((f) => f.severity === "error").map((f) => String(f.code ?? "")).filter((c) => c.length > 0);
-  return [...new Set(codes)].sort();
-}
-function preflightFeature(env, cwd) {
-  const feature = env.feature ?? "";
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  const syncOut = spur(env, ["feature", "sync", feature, "--dry-run", "--json"], { cwd });
-  let sync;
-  if (syncOut.status === 0) {
-    try {
-      const parsed = JSON.parse(syncOut.stdout);
-      if (parsed !== null && typeof parsed === "object")
-        sync = parsed;
-    } catch {}
-  }
-  if (sync === undefined)
-    return "failed:preflight:sync-unreadable";
-  const proposal = sync.proposal;
-  if (proposal === null || typeof proposal !== "object" || Array.isArray(proposal) || proposal.gateBlocked !== undefined && typeof proposal.gateBlocked !== "boolean" || proposal.gateFindings !== undefined && !isFindingList(proposal.gateFindings) || proposal.hops !== undefined && (!Array.isArray(proposal.hops) || !proposal.hops.every((hop) => typeof hop === "string")) || proposal.gateBlocked !== true && (typeof proposal.from !== "string" || typeof proposal.to !== "string")) {
-    return "failed:preflight:sync-unreadable";
-  }
-  if (proposal.gateBlocked === true) {
-    return `failed:preflight:gate-blocked ${sortedUniqueCodes(proposal.gateFindings ?? []).join(",")}`;
-  }
-  const reachesDone = proposal.to === "done" || (proposal.hops ?? []).includes("done");
-  if (!reachesDone)
-    return null;
-  const checkOut = spur(env, ["feature", "check", feature, "--strict", "--as", "done", "--json"], { cwd });
-  let check;
-  try {
-    check = JSON.parse(checkOut.stdout);
-  } catch {
-    return "failed:preflight:check-unreadable";
-  }
-  const payload = Array.isArray(check) && check.length === 1 ? check[0] : check;
-  const findings = payload !== null && typeof payload === "object" ? payload.findings : undefined;
-  if (!isFindingList(findings) || checkOut.status !== 0 && (checkOut.status !== 1 || !findings.some((f) => f.severity === "error"))) {
-    return "failed:preflight:check-unreadable";
-  }
-  const eligible = proposal.from === "verifying" ? findings : findings.filter((f) => !String(f.code ?? "").startsWith("L4.feature-receipt-"));
-  const runId = env.__runId ?? "";
-  if (runId.length > 0) {
-    mkdirSync(abs(join(".spur", "run")), { recursive: true });
-    writeFileSync(abs(join(".spur", "run", `${runId}-wrapup-preflight.json`)), `${JSON.stringify(check)}
-`);
-  }
-  const codes = sortedUniqueCodes(eligible);
-  return codes.length > 0 ? `failed:preflight:done-gate ${codes.join(",")}` : null;
-}
-var ROUTE_REASON_TABLE = {
-  fast: "fast:evidence complete+consistent",
-  "": "safety:missing evidence (mode empty)",
-  unknown: "safety:unknown evidence quality",
-  conflict: "safety:conflicting evidence",
-  safety: "safety:operator-forced doc-sync"
-};
-function writeRouteReason(env, options = {}) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? "";
-  if (runId.length === 0) {
-    process.stderr.write(`task-resolve: __runId is empty \u2014 refusing to write a route reason
-`);
-    return { reason: "", reasonFile: "", exitCode: 1 };
-  }
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  mkdirSync(cwd ? join(cwd, ".spur", "memory") : join(".spur", "memory"), { recursive: true });
-  const relReasonFile = join(".spur", "run", `${runId}-route-reason.txt`);
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  const statusFile = join(".spur", "run", `${runId}-wrapup-resolve.status`);
-  if (readFileSyncSafe(abs(statusFile))?.trim() === "FAIL") {
-    return { reason: "", reasonFile: relReasonFile, exitCode: 0 };
-  }
-  let taskCount = -1;
-  try {
-    const parsed = JSON.parse(readFileSync(abs(join(".spur", "run", `${runId}-wrapup-tasks.json`)), "utf8"));
-    if (Array.isArray(parsed))
-      taskCount = parsed.length;
-  } catch {}
-  let probeClean = false;
-  try {
-    const probe = JSON.parse(readFileSync(abs(join(".spur", "run", `${runId}-drift-probe.json`)), "utf8"));
-    probeClean = probe?.clean === true;
-  } catch {}
-  const mode = env.mode ?? "";
-  let reason;
-  if (taskCount === 0) {
-    reason = "skipped:empty task list";
-  } else if (mode === "fast" && probeClean) {
-    reason = "fast:drift-probe-clean";
-  } else {
-    reason = ROUTE_REASON_TABLE[mode] ?? `safety:unrecognized evidence (mode=${mode})`;
-  }
-  writeFileSync(abs(relReasonFile), `${reason}
-`);
-  appendFileSync(abs(join(".spur", "memory", "wrapup-routes.log")), `${runId} ${reason}
-`);
-  return { reason, reasonFile: relReasonFile, exitCode: 0 };
-}
-function readFileSyncSafe(path) {
-  try {
-    return readFileSync(path, "utf8");
-  } catch {
-    return null;
-  }
-}
-function verdictFromTestingSection(content) {
-  const heading = /^#{1,6}\s+Testing\s*$/m.exec(content);
-  if (!heading)
-    return null;
-  const level = heading[0].match(/^#+/)?.[0]?.length ?? 2;
-  const rest = content.slice(heading.index + heading[0].length);
-  const next = new RegExp(`^#{1,${level}}\\s+\\S`, "m").exec(rest);
-  const section = next ? rest.slice(0, next.index) : rest;
-  for (const line of section.split(`
-`)) {
-    const m = /^(?:-\s*|\*\*)?Verdict:\s*(PASS|PARTIAL|FAIL|UNKNOWN)\b/i.exec(line.trim());
-    if (m?.[1] !== undefined)
-      return m[1].toUpperCase();
-  }
-  return null;
-}
-function verdictOfArtifact(verdictPath) {
-  try {
-    const raw = jqPick(JSON.parse(readFileSync(verdictPath, "utf8")).verdict, "");
-    const text = jqText(raw);
-    return text.length > 0 ? text : null;
-  } catch {
-    return null;
-  }
-}
-function runMetrics(env, options = {}) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? "";
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  mkdirSync(cwd ? join(cwd, ".spur", "memory") : join(".spur", "memory"), { recursive: true });
-  const relStatusFile = join(".spur", "run", `${runId}-wrapup-metrics.status`);
-  const relTasksFile = join(".spur", "run", `${runId}-wrapup-tasks.json`);
-  const relMetricsFile = join(".spur", "memory", "wrapup-metrics.jsonl");
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  const fail = () => {
-    writeFileSync(abs(relStatusFile), `FAIL
-`);
-    return { status: "FAIL", statusFile: relStatusFile };
-  };
-  let captured;
-  try {
-    captured = JSON.parse(readFileSync(abs(relTasksFile), "utf8"));
-  } catch {
-    captured = undefined;
-  }
-  const validCapture = Array.isArray(captured) && captured.every((w) => typeof w === "string" && WBS_PATTERN.test(w));
-  if (!validCapture) {
-    process.stderr.write(`metrics-record: run-scoped task capture missing, corrupted or non-canonical \u2014 refusing to record metrics
-`);
-    return fail();
-  }
-  let metricsRc = 0;
-  for (const wbs of captured) {
-    const shown = spur(env, ["task", "show", wbs, "--json"], { cwd });
-    const lookup = shown.status === 0 ? taskStatusOf(shown.stdout) : { resolved: null, present: false };
-    if (!lookup.present) {
-      process.stderr.write(`metrics-record: task ${wbs} lookup failed or was malformed \u2014 recording FAIL instead of silently omitting its metrics row
-`);
-      metricsRc = 1;
-      continue;
-    }
-    const parsed = JSON.parse(shown.stdout);
-    const frontmatter = parsed.frontmatter !== null && typeof parsed.frontmatter === "object" ? parsed.frontmatter : {};
-    const featureId = String(jqPick(frontmatter.feature_id, parsed.feature_id, ""));
-    const status = String(jqPick(frontmatter.status, parsed.status, "unknown"));
-    const durable = join(".spur", "memory", "evidence", `${wbs}-verdict.json`);
-    const hasDurable = existsSync(abs(durable));
-    const verdictPath = hasDurable ? durable : join(".spur", "run", `${wbs}-verdict.json`);
-    const artifactVerdict = verdictOfArtifact(abs(verdictPath)) ?? (hasDurable ? "UNKNOWN" : null);
-    const trackedVerdict = verdictFromTestingSection(typeof parsed.content === "string" ? parsed.content : "");
-    const verdict = artifactVerdict ?? trackedVerdict ?? "UNKNOWN";
-    if (verdict === "UNKNOWN") {
-      process.stderr.write(`metrics-record: task ${wbs} has no certifying verdict \u2014 ${verdictPath}: ${artifactVerdict ?? "missing or carries none"}, tracked Testing: ${trackedVerdict ?? "no Verdict: line"} \u2014 recording UNKNOWN telemetry
-`);
-    }
-    const timestamp = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
-    const row = { wbs, feature_id: featureId, status, verdict, timestamp };
-    try {
-      appendFileSync(abs(relMetricsFile), `${JSON.stringify(row)}
-`);
-    } catch {
-      process.stderr.write(`metrics-record: metrics append failed for task ${wbs} \u2014 recording FAIL instead of claiming the row landed
-`);
-      metricsRc = 1;
-    }
-  }
-  const status = metricsRc === 0 ? "PASS" : "FAIL";
-  writeFileSync(abs(relStatusFile), `${status}
-`);
-  return { status, statusFile: relStatusFile };
-}
-function classifySync(syncOutput, syncRc, feature, observed) {
-  if (syncRc !== 0) {
-    return { reason: `sync exited nonzero (rc=${syncRc})`, applied: "unreadable", syncOk: false };
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(syncOutput);
-  } catch {
-    parsed = undefined;
-  }
-  const obj = parsed !== null && typeof parsed === "object" ? parsed : undefined;
-  const proposal = obj?.proposal !== null && typeof obj?.proposal === "object" ? obj.proposal : undefined;
-  const shapeOk = obj !== undefined && proposal !== undefined && typeof proposal.featureId === "string" && typeof proposal.from === "string" && typeof proposal.to === "string" && typeof obj.applied === "boolean";
-  if (!shapeOk) {
-    return { reason: "malformed or unreadable sync result", applied: "unreadable", syncOk: false };
-  }
-  const applied = obj.applied === true ? "true" : "false";
-  const pFrom = String(jqPick(proposal.from, ""));
-  const pTo = String(jqPick(proposal.to, ""));
-  if (String(jqPick(proposal.featureId, "")) !== feature) {
-    return { reason: `sync proposal does not match feature ${feature}`, applied, syncOk: false };
-  }
-  if (proposal.gateBlocked === true) {
-    return {
-      reason: "sync proposal is gate-blocked \u2014 a blocked sync is not a no-change success",
-      applied,
-      syncOk: false
-    };
-  }
-  if (proposal.requiresConfirm === true) {
-    return { reason: "sync proposal requires operator confirmation", applied, syncOk: false };
-  }
-  if (applied === "true" && observed !== pTo) {
-    return {
-      reason: `applied sync did not land on the proposal target (observed=${observed}, to=${pTo})`,
-      applied,
-      syncOk: false
-    };
-  }
-  if (applied === "false" && (pFrom !== pTo || observed !== pTo)) {
-    return {
-      reason: `sync applied nothing without a from==to observed no-op (from=${pFrom}, to=${pTo}, observed=${observed})`,
-      applied,
-      syncOk: false
-    };
-  }
-  return { reason: "", applied, syncOk: true };
-}
-function runFeatureTransition(env, options = {}) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? "";
-  const feature = env.feature ?? "";
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  const relStatusFile = join(".spur", "run", `${runId}-wrapup-sync.status`);
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  if (feature.length === 0) {
-    process.stderr.write(`feature-transition: vars.feature is empty \u2014 refusing no-op feature sync (mis-invocation, not a blocked sync)
-`);
-    return { status: "FAIL", statusFile: relStatusFile, exitCode: 1 };
-  }
-  let syncOutput = "";
-  let syncRc = 1;
-  const sync = spur(env, ["feature", "sync", feature, "--json"], { cwd, stderr: "inherit" });
-  syncOutput = sync.stdout;
-  syncRc = sync.status;
-  process.stdout.write(`${syncOutput}
-`);
-  const shown = spur(env, ["feature", "show", feature, "--json"], { cwd });
-  let observed = "";
-  if (shown.status === 0) {
-    try {
-      const parsed = JSON.parse(shown.stdout);
-      const frontmatter = parsed.frontmatter !== null && typeof parsed.frontmatter === "object" ? parsed.frontmatter : {};
-      const picked = jqPick(parsed.status, frontmatter.status, "");
-      observed = picked === "" ? "" : jqText(picked);
-    } catch {
-      observed = "";
-    }
-  }
-  if (observed.length === 0)
-    observed = "unreadable";
-  const classified = classifySync(syncOutput, syncRc, feature, observed);
-  const { reason, applied } = classified;
-  const syncOk = classified.syncOk;
-  let gate = "skipped";
-  if (applied === "true" || syncRc !== 0) {
-    process.stdout.write(`feature-transition: sync applied or failed after a possible partial transition for ${feature} \u2014 running feature gate: ${env.featureGateCmd ?? ""}
-`);
-    const gateResult = spawnSync("sh", ["-c", env.featureGateCmd ?? ""], { cwd, stdio: "inherit" });
-    if ((gateResult.status ?? 1) === 0) {
-      gate = "PASS";
-      process.stdout.write(`feature-transition: feature gate PASS for feature ${feature}
-`);
-    } else {
-      gate = "FAIL";
-      process.stderr.write(`feature-transition: feature gate FAIL for feature ${feature} \u2014 inspect findings before reporting the transition complete
-`);
-    }
-  } else {
-    process.stdout.write(`feature-transition: sync did not apply a transition (rc=${syncRc}, applied=${applied}) \u2014 feature gate skipped
-`);
-  }
-  let syncStatus;
-  if (!syncOk || gate === "FAIL") {
-    syncStatus = "FAIL";
-    process.stderr.write(`feature-transition: required synchronization failed for ${feature} \u2014 ${reason}; gate=${gate}
-`);
-  } else if (applied === "false") {
-    syncStatus = "PASS";
-    process.stdout.write(`feature-transition: feature sync verified for ${feature} (from==to observed at ${observed}, gate=${gate}) \u2014 explicit no-change
-`);
-  } else {
-    syncStatus = "PASS";
-    process.stdout.write(`feature-transition: feature sync verified for ${feature} (applied, observed=${observed}, gate=${gate})
-`);
-  }
-  writeFileSync(abs(relStatusFile), `${syncStatus}
-`);
-  return { status: syncStatus, statusFile: relStatusFile, exitCode: 0 };
-}
-var DOC_SYNC_SNAPSHOT_SUFFIX = "wrapup-doc-sync-snapshot.txt";
-var DOC_SYNC_SCOPE_STATUS_SUFFIX = "wrapup-doc-sync-scope.status";
-var DOC_SYNC_SUPERSESSION_STATUS_SUFFIX = "wrapup-doc-supersession.status";
-var SUPERSESSION_PIN = "repo-wide-tests/adr-supersession.test.ts";
-var GIT_UNAVAILABLE_MARKER = "# git-unavailable:";
-var SNAPSHOT_MISSING = "snapshot-missing";
-function porcelainPath(line) {
-  const body = line.length >= 3 ? line.slice(3) : line;
-  const arrow = body.indexOf(" -> ");
-  const target = arrow >= 0 ? body.slice(arrow + 4) : body;
-  const trimmed = target.trim();
-  return trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2 ? trimmed.slice(1, -1) : trimmed;
-}
-function isDocSyncAllowedPath(path, allowedExtra) {
-  if (allowedExtra.includes(path))
-    return true;
-  if (!path.startsWith("docs/"))
-    return false;
-  return !path.startsWith("docs/tasks") && !path.startsWith("docs/features");
-}
-function docSyncScopeViolations(snapshot, current, allowedExtra) {
-  const before = new Set(snapshot.split(`
-`).filter((line) => line.trim() !== ""));
-  const paths = new Set;
-  for (const line of current.split(`
-`)) {
-    if (line.trim() === "" || before.has(line))
-      continue;
-    const path = porcelainPath(line);
-    if (!isDocSyncAllowedPath(path, allowedExtra))
-      paths.add(path);
-  }
-  return [...paths].sort();
-}
-function gitPorcelain(cwd) {
-  const result = spawnSync("git", ["status", "--porcelain", "-uall"], {
-    cwd,
-    encoding: "utf8"
-  });
-  if (result.error !== undefined)
-    return { ok: false, listing: "", detail: String(result.error) };
-  if (result.status !== 0)
-    return { ok: false, listing: "", detail: (result.stderr ?? "").trim() };
-  return { ok: true, listing: result.stdout ?? "", detail: "" };
-}
-function wrapupRunPaths(env, cwd) {
-  const runId = env.__runId ?? "";
-  const rel = (suffix) => join(".spur", "run", `${runId}-${suffix}`);
-  return { rel, abs: (suffix) => cwd ? join(cwd, rel(suffix)) : rel(suffix) };
-}
-function docSyncAllowedExtra(env) {
-  const runId = env.__runId ?? "";
-  return [
-    join(".spur", "run", `${runId}-wrapup-learnings.md`),
-    join(".spur", "run", `${runId}-${DOC_SYNC_SNAPSHOT_SUFFIX}`),
-    join(".spur", "run", `${runId}-${DOC_SYNC_SCOPE_STATUS_SUFFIX}`)
-  ];
-}
-function runDocSyncSnapshot(env, options = {}) {
-  const cwd = options.cwd;
-  const paths = wrapupRunPaths(env, cwd);
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  writeFileSync(paths.abs(DOC_SYNC_SNAPSHOT_SUFFIX), "");
-  const listing = gitPorcelain(cwd);
-  if (!listing.ok) {
-    writeFileSync(paths.abs(DOC_SYNC_SNAPSHOT_SUFFIX), `${GIT_UNAVAILABLE_MARKER} ${listing.detail}
-`);
-    process.stderr.write(`doc-sync-snapshot: git status unavailable \u2014 scope check skips (${listing.detail})
-`);
-    return { statusFile: paths.rel(DOC_SYNC_SNAPSHOT_SUFFIX), captured: false, exitCode: 0 };
-  }
-  writeFileSync(paths.abs(DOC_SYNC_SNAPSHOT_SUFFIX), listing.listing);
-  return { statusFile: paths.rel(DOC_SYNC_SNAPSHOT_SUFFIX), captured: true, exitCode: 0 };
-}
-function runDocSyncScope(env, options = {}) {
-  const cwd = options.cwd;
-  const paths = wrapupRunPaths(env, cwd);
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  const statusFile = paths.rel(DOC_SYNC_SCOPE_STATUS_SUFFIX);
-  const write = (status, detail) => {
-    writeFileSync(paths.abs(DOC_SYNC_SCOPE_STATUS_SUFFIX), `${detail}
-`);
-    if (status !== "PASS")
-      process.stderr.write(`doc-sync-scope: ${detail}
-`);
-    return { status, statusFile, violations: status === "PASS" ? [] : [detail], exitCode: 0 };
-  };
-  const snapshot = readFileSyncSafe(paths.abs(DOC_SYNC_SNAPSHOT_SUFFIX));
-  if (snapshot === null) {
-    return write("scope-violation", `scope-violation: ${SNAPSHOT_MISSING}`);
-  }
-  if (snapshot.startsWith(GIT_UNAVAILABLE_MARKER)) {
-    process.stderr.write(`doc-sync-scope: entry snapshot recorded no git listing \u2014 scope check skipped
-`);
-    return write("PASS", "PASS");
-  }
-  const current = gitPorcelain(cwd);
-  if (!current.ok) {
-    return write("scope-violation", `scope-violation: git-unavailable (${current.detail})`);
-  }
-  const violations = docSyncScopeViolations(snapshot, current.listing, docSyncAllowedExtra(env));
-  if (violations.length === 0)
-    return write("PASS", "PASS");
-  return write("scope-violation", `scope-violation: ${violations.join(" ")}`);
-}
-function runDocSupersessionCheck(env, options = {}) {
-  const cwd = options.cwd;
-  const paths = wrapupRunPaths(env, cwd);
-  mkdirSync(cwd ? join(cwd, ".spur", "run") : join(".spur", "run"), { recursive: true });
-  const statusFile = paths.rel(DOC_SYNC_SUPERSESSION_STATUS_SUFFIX);
-  const pinPath = cwd ? join(cwd, SUPERSESSION_PIN) : SUPERSESSION_PIN;
-  if (!existsSync(pinPath)) {
-    writeFileSync(paths.abs(DOC_SYNC_SUPERSESSION_STATUS_SUFFIX), `PASS
-`);
-    return { status: "PASS", statusFile, exitCode: 0 };
-  }
-  const pin = spawnSync("bun", ["test", SUPERSESSION_PIN], { cwd, encoding: "utf8" });
-  if (pin.status === 0) {
-    writeFileSync(paths.abs(DOC_SYNC_SUPERSESSION_STATUS_SUFFIX), `PASS
-`);
-    return { status: "PASS", statusFile, exitCode: 0 };
-  }
-  writeFileSync(paths.abs(DOC_SYNC_SUPERSESSION_STATUS_SUFFIX), `supersession-pin-failed: ${SUPERSESSION_PIN}
-`);
-  const detail = `${pin.stdout ?? ""}${pin.stderr ?? ""}`.trim();
-  process.stderr.write(`doc-supersession: ${SUPERSESSION_PIN} failed (exit ${String(pin.status ?? 1)}) \u2014 the doc-sync step introduced or kept superseded index content:
-${detail.slice(-2000)}
-`);
-  return { status: "supersession-pin-failed", statusFile, exitCode: 0 };
-}
-var WRAPUP_STEPS_USAGE = "usage: wrapup-steps.ts <resolve|route-reason|metrics|feature-transition|doc-sync-snapshot|doc-sync-scope|doc-supersession>  (env: __runId, tasks, mode, feature, featureGateCmd, spurBin)";
-function main(argv, env = getEnvVars(), options = {}) {
-  const sub = argv[0];
-  if (sub === "resolve")
-    return resolveTasks(env, options).exitCode;
-  if (sub === "route-reason")
-    return writeRouteReason(env, options).exitCode;
-  if (sub === "metrics") {
-    runMetrics(env, options);
-    return 0;
-  }
-  if (sub === "feature-transition")
-    return runFeatureTransition(env, options).exitCode;
-  if (sub === "doc-sync-snapshot")
-    return runDocSyncSnapshot(env, options).exitCode;
-  if (sub === "doc-sync-scope")
-    return runDocSyncScope(env, options).exitCode;
-  if (sub === "doc-supersession")
-    return runDocSupersessionCheck(env, options).exitCode;
-  process.stderr.write(`${WRAPUP_STEPS_USAGE}
-`);
-  return 2;
-}
-{
-  process.exit(main(process.argv.slice(2)));
-}
-export {
-  DOC_SYNC_SCOPE_STATUS_SUFFIX,
-  DOC_SYNC_SNAPSHOT_SUFFIX,
-  DOC_SYNC_SUPERSESSION_STATUS_SUFFIX,
-  GIT_UNAVAILABLE_MARKER,
-  SNAPSHOT_MISSING,
-  SUPERSESSION_PIN,
-  WBS_PATTERN,
-  WRAPUP_STEPS_USAGE,
-  classifySync,
-  docSyncScopeViolations,
-  isDocSyncAllowedPath,
-  jqPick,
-  main,
-  porcelainPath,
-  preflightFeature,
-  resolveTasks,
-  runDocSupersessionCheck,
-  runDocSyncScope,
-  runDocSyncSnapshot,
-  runFeatureTransition,
-  runMetrics,
-  taskStatusOf,
-  verdictFromTestingSection,
-  writeRouteReason
-};