@gobing-ai/spur 0.3.96 → 0.3.97

package/plugins/sp/lib/quality-gate.generated.mjs

@@ -111,6 +111,9 @@ function readReceiptStatus(receiptPath, currentDigest) {
   }
   if (receipt.tier !== "full")
     return { reuse: false, reason: "light-only" };
+  if (!Array.isArray(receipt.checks) || receipt.checks.length === 0 || receipt.checks.some((row) => row === null || typeof row !== "object" || row.status !== "PASS" || typeof row.cmd !== "string" || row.cmd.trim().length === 0)) {
+    return { reuse: false, reason: "failed" };
+  }
   return { reuse: true, reason: "ok" };
 }
 var TEST_FILE_PATTERN = /\.test\.tsx?$/;
@@ -305,9 +308,13 @@ function runQualityGate(mode, env, options = {}) {
     writeFileSync(abs(attemptFile), `0
 `);
   const gateStartedAtMs = Date.now();
-  let gateRc = 0;
+  const commandPresent = (env.qualityGateCmd ?? "").trim().length > 0;
+  let gateRc = commandPresent ? 0 : 1;
   let gateAttempt = 0;
-  const reusePass = readReceiptStatus(abs(rel("-check-receipt.json")), env.proofDigest ?? "").reuse;
+  if (!commandPresent)
+    appendFileSync(abs(logFile), `quality-gate: mode ${mode} requires env \`qualityGateCmd\` to be non-empty
+`);
+  const reusePass = commandPresent && readReceiptStatus(abs(rel("-check-receipt.json")), env.proofDigest ?? "").reuse;
   if (reusePass) {
     const line = `check.reused — full-tier PASS receipt at input digest ${env.proofDigest ?? ""}; gate skipped
 `;
@@ -318,7 +325,7 @@ function runQualityGate(mode, env, options = {}) {
 `);
     return { status: "PASS", attempts: 0, logFile, findingsFile, statusFile, attemptFile };
   }
-  const noProgressSkip = mode === "recheck" && receiptFailsAtDigest(readReceipt(abs(rel("-check-receipt.json"))), env.proofDigest ?? "");
+  const noProgressSkip = commandPresent && mode === "recheck" && receiptFailsAtDigest(readReceipt(abs(rel("-check-receipt.json"))), env.proofDigest ?? "");
   if (noProgressSkip) {
     const line = `check.skipped-no-progress — full-tier FAIL receipt at input digest ${env.proofDigest ?? ""}; recheck skipped
 `;
@@ -326,7 +333,7 @@ function runQualityGate(mode, env, options = {}) {
     appendFileSync(abs(logFile), line);
     gateRc = 1;
   }
-  if (mode === "recheck" && !noProgressSkip && (env.gateProbeCmd ?? "").length > 0) {
+  if (mode === "recheck" && gateRc === 0 && (env.gateProbeCmd ?? "").length > 0) {
     const probe = runShellCommand(env.gateProbeCmd ?? "", cwd);
     writeFileSync(abs(`${logFile}.probe`), probe.output);
     gateRc = probe.code;
@@ -383,7 +390,7 @@ function runQualityGate(mode, env, options = {}) {
   appendFileSync(abs(logFile), `proof-digest: ${env.proofDigest ?? ""}
 `);
   let receiptFile;
-  if (!noProgressSkip) {
+  if (!noProgressSkip && commandPresent) {
     if ((env.proofDigest ?? "").length > 0) {
       receiptFile = join(runDir, `${env.wbs}-check-receipt.json`);
       const receipt = buildReceipt({

package/plugins/sp/lib/residual-scan.generated.d.mts

@@ -37,6 +37,7 @@ export declare interface FoldResult {
     findings: string;
 }
 export declare const ALLOW_PRAGMA: 'residual-scan:allow';
+export declare function recordedVerdictPath(runDir: string, wbs: string, fs: Pick<typeof import('node:fs'), 'lstatSync' | 'existsSync'>): string;
 export declare function makeItemId(category: ResidualCategory, location: string, text: string): string;
 export declare function normalizeAnchor(location: string): string;
 export declare function locationOf(locationCell: string, finding: string): string;

package/plugins/sp/lib/residual-scan.generated.mjs

@@ -1,4 +1,5 @@
 // packages/app/src/services/residual-scan.ts
+import { join } from "node:path";
 import { createHash } from "node:crypto";
 var MARKER_PATTERN = /TODO|FIXME|XXX|HACK/;
 var PRIORITY_PATTERN = /^P[1-4]/;
@@ -194,9 +195,24 @@ function renderReport(wbs, items, attemptCount) {
 `)}
 `;
 }
+function recordedVerdictPath(runDir, wbs, fs) {
+  const evidence = join(runDir, "..", "memory", "evidence");
+  const durable = join(evidence, `${wbs}-verdict.json`);
+  for (const path of [join(runDir, ".."), join(evidence, ".."), evidence, durable]) {
+    try {
+      if (fs.lstatSync(path).isSymbolicLink())
+        throw new Error(`residual-scan: symlink evidence path: ${path}`);
+    } catch (error) {
+      if (error.code !== "ENOENT")
+        throw error;
+    }
+  }
+  return fs.existsSync(durable) ? durable : join(runDir, `${wbs}-verdict.json`);
+}
 export {
   scanResiduals,
   renderReport,
+  recordedVerdictPath,
   parseReviewFindings,
   parseDiffMarkers,
   normalizeAnchor,

package/plugins/sp/plugin.json

@@ -1,6 +1,6 @@
 {
     "name": "sp",
-    "version": "0.3.96",
+    "version": "0.3.97",
     "description": "Spur — a local-first harness engineering toolkit that wraps mainstream coding agents with constraint checking, workflow orchestration, and history analytics.",
     "extensions": {
         "pi": ["./hooks/pi/guard-extension.ts"]

package/plugins/sp/references/roles.md

@@ -50,7 +50,7 @@ version: 1
 roles:
   - id: scribe
     tier: cheap
-    commands: [dev-gitmsg, dev-handover, dev-daily, dev-changelog, dev-refresh, rule-add, rule-refine, workflow-add, workflow-refine, spur-init]
+    commands: [dev-gitmsg, dev-handover, dev-job-dump, dev-daily, dev-changelog, dev-refresh, rule-add, rule-refine, workflow-add, workflow-refine, spur-init]
     stages: [changelog]
   - id: coder
     tier: standard
@@ -62,7 +62,7 @@ roles:
     stages: [verify, review, dogfood]
   - id: planner
     tier: capable-2
-    commands: [dev-plan, dev-refine, dev-brainstorm, dev-idea, dev-runall, dev-parallel, dev-next, dev-arch, dev-refineall, dev-find-next, dev-feature-change]
+    commands: [dev-plan, dev-refine, dev-brainstorm, dev-idea, dev-runall, dev-parallel, dev-next, dev-job-resume, dev-arch, dev-refineall, dev-find-next, dev-feature-change]
     stages: [plan, refine, brainstorm]
 ```
 

package/plugins/sp/scripts/feature-verification-steps.mjs

@@ -10,7 +10,9 @@ import {
   openSync,
   readdirSync,
   readFileSync,
+  realpathSync,
   renameSync,
+  statSync,
   writeFileSync
 } from "fs";
 import { join } from "path";
@@ -74,6 +76,17 @@ function findFeatureFile(featureDir, featureId) {
   return name === undefined ? undefined : join(featureDir, name);
 }
 var nodeFsShim = {
+  realPath: realpathSync,
+  readDir: readdirSync,
+  stat: (path) => {
+    try {
+      return statSync(path);
+    } catch (error) {
+      if (error.code === "ENOENT")
+        return null;
+      throw error;
+    }
+  },
   ensureDir: (dir) => {
     mkdirSync(dir, { recursive: true });
   },
@@ -123,7 +136,7 @@ async function verify(featureId, runId, cmdOverride, spurBin, mode) {
   try {
     await new mod.ArtifactDao(db.adapter).record({
       runId,
-      path: join(runDir, `${runId}-feature-verification.json`),
+      path: mod.featureReceiptPaths(runDir, featureId, runId).runScoped,
       kind: "feature-verification"
     });
   } finally {

package/plugins/sp/scripts/feature-verification-steps.ts

@@ -33,7 +33,9 @@ import {
     openSync,
     readdirSync,
     readFileSync,
+    realpathSync,
     renameSync,
+    statSync,
     writeFileSync,
 } from 'node:fs';
 import { join } from 'node:path';
@@ -45,6 +47,7 @@ const SAFE_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
 
 /** Shape of the generated inline bundle / repo app source this script consumes. */
 interface VerificationModule {
+    featureReceiptPaths: typeof import('../../../packages/app/src/workflow/feature-verification-receipt')['featureReceiptPaths'];
     startFeatureVerificationReceipt: typeof import('../../../packages/app/src/workflow/feature-verification-receipt')['startFeatureVerificationReceipt'];
     completeFeatureVerificationReceipt: typeof import('../../../packages/app/src/workflow/feature-verification-receipt')['completeFeatureVerificationReceipt'];
     captureFeatureReceiptDigest: typeof import('../../../packages/app/src/workflow/feature-verification-receipt')['captureFeatureReceiptDigest'];
@@ -143,6 +146,16 @@ function findFeatureFile(featureDir: string, featureId: string): string | undefi
 // FileSystem port; only ensureDir/writeFile/rename are exercised on the
 // start/complete paths. Swap to createNodeFileSystem if more surface is needed.
 const nodeFsShim = {
+    realPath: realpathSync,
+    readDir: readdirSync,
+    stat: (path: string) => {
+        try {
+            return statSync(path);
+        } catch (error) {
+            if ((error as { code?: string }).code === 'ENOENT') return null;
+            throw error;
+        }
+    },
     ensureDir: (dir: string) => {
         mkdirSync(dir, { recursive: true });
     },
@@ -209,7 +222,7 @@ async function verify(
     try {
         await new mod.ArtifactDao(db.adapter as never).record({
             runId,
-            path: join(runDir, `${runId}-feature-verification.json`),
+            path: mod.featureReceiptPaths(runDir, featureId, runId).runScoped,
             kind: 'feature-verification',
         });
     } finally {

package/plugins/sp/scripts/quality-gate.mjs

@@ -123,6 +123,9 @@ function readReceiptStatus(receiptPath, currentDigest) {
   }
   if (receipt.tier !== "full")
     return { reuse: false, reason: "light-only" };
+  if (!Array.isArray(receipt.checks) || receipt.checks.length === 0 || receipt.checks.some((row) => row === null || typeof row !== "object" || row.status !== "PASS" || typeof row.cmd !== "string" || row.cmd.trim().length === 0)) {
+    return { reuse: false, reason: "failed" };
+  }
   return { reuse: true, reason: "ok" };
 }
 var TEST_FILE_PATTERN = /\.test\.tsx?$/;
@@ -317,9 +320,13 @@ function runQualityGate(mode, env, options = {}) {
     writeFileSync(abs(attemptFile), `0
 `);
   const gateStartedAtMs = Date.now();
-  let gateRc = 0;
+  const commandPresent = (env.qualityGateCmd ?? "").trim().length > 0;
+  let gateRc = commandPresent ? 0 : 1;
   let gateAttempt = 0;
-  const reusePass = readReceiptStatus(abs(rel("-check-receipt.json")), env.proofDigest ?? "").reuse;
+  if (!commandPresent)
+    appendFileSync(abs(logFile), `quality-gate: mode ${mode} requires env \`qualityGateCmd\` to be non-empty
+`);
+  const reusePass = commandPresent && readReceiptStatus(abs(rel("-check-receipt.json")), env.proofDigest ?? "").reuse;
   if (reusePass) {
     const line = `check.reused — full-tier PASS receipt at input digest ${env.proofDigest ?? ""}; gate skipped
 `;
@@ -330,7 +337,7 @@ function runQualityGate(mode, env, options = {}) {
 `);
     return { status: "PASS", attempts: 0, logFile, findingsFile, statusFile, attemptFile };
   }
-  const noProgressSkip = mode === "recheck" && receiptFailsAtDigest(readReceipt(abs(rel("-check-receipt.json"))), env.proofDigest ?? "");
+  const noProgressSkip = commandPresent && mode === "recheck" && receiptFailsAtDigest(readReceipt(abs(rel("-check-receipt.json"))), env.proofDigest ?? "");
   if (noProgressSkip) {
     const line = `check.skipped-no-progress — full-tier FAIL receipt at input digest ${env.proofDigest ?? ""}; recheck skipped
 `;
@@ -338,7 +345,7 @@ function runQualityGate(mode, env, options = {}) {
     appendFileSync(abs(logFile), line);
     gateRc = 1;
   }
-  if (mode === "recheck" && !noProgressSkip && (env.gateProbeCmd ?? "").length > 0) {
+  if (mode === "recheck" && gateRc === 0 && (env.gateProbeCmd ?? "").length > 0) {
     const probe = runShellCommand(env.gateProbeCmd ?? "", cwd);
     writeFileSync(abs(`${logFile}.probe`), probe.output);
     gateRc = probe.code;
@@ -395,7 +402,7 @@ function runQualityGate(mode, env, options = {}) {
   appendFileSync(abs(logFile), `proof-digest: ${env.proofDigest ?? ""}
 `);
   let receiptFile;
-  if (!noProgressSkip) {
+  if (!noProgressSkip && commandPresent) {
     if ((env.proofDigest ?? "").length > 0) {
       receiptFile = join(runDir, `${env.wbs}-check-receipt.json`);
       const receipt = buildReceipt({
@@ -452,7 +459,7 @@ function main(argv, rawEnv = getEnvVars(), options = {}) {
     process.stdout.write(`${JSON.stringify(verdict)}
 `);
   } else {
-    runQualityGate(mode, env);
+    return runQualityGate(mode, env, options).status === "PASS" ? 0 : 1;
   }
   return 0;
 }

package/plugins/sp/scripts/quality-gate.ts

@@ -54,7 +54,7 @@ export function main(
         }
         process.stdout.write(`${JSON.stringify(verdict)}\n`);
     } else {
-        runQualityGate(mode, env);
+        return runQualityGate(mode, env, options).status === 'PASS' ? 0 : 1;
     }
     return 0;
 }

package/plugins/sp/scripts/residual-scan.mjs

@@ -3,9 +3,9 @@
 
 // plugins/sp/scripts/residual-scan.ts
 import { spawnSync } from "child_process";
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
+import * as fs from "fs";
 import { tmpdir } from "os";
-import { join } from "path";
+import { join as join2 } from "path";
 
 // plugins/sp/lib/env.ts
 function getEnvVars() {
@@ -13,6 +13,7 @@ function getEnvVars() {
 }
 
 // plugins/sp/lib/residual-scan.generated.mjs
+import { join } from "node:path";
 import { createHash } from "node:crypto";
 var MARKER_PATTERN = /TODO|FIXME|XXX|HACK/;
 var PRIORITY_PATTERN = /^P[1-4]/;
@@ -208,6 +209,20 @@ function renderReport(wbs, items, attemptCount) {
 `)}
 `;
 }
+function recordedVerdictPath(runDir, wbs, fs) {
+  const evidence = join(runDir, "..", "memory", "evidence");
+  const durable = join(evidence, `${wbs}-verdict.json`);
+  for (const path of [join(runDir, ".."), join(evidence, ".."), evidence, durable]) {
+    try {
+      if (fs.lstatSync(path).isSymbolicLink())
+        throw new Error(`residual-scan: symlink evidence path: ${path}`);
+    } catch (error) {
+      if (error.code !== "ENOENT")
+        throw error;
+    }
+  }
+  return fs.existsSync(durable) ? durable : join(runDir, `${wbs}-verdict.json`);
+}
 
 // plugins/sp/lib/spur-bin.ts
 function spurCommand(spurBin) {
@@ -229,7 +244,7 @@ function spur(env, spurBinFlag, args, cwd) {
 }
 function isRegularFile(path) {
   try {
-    return statSync(path).isFile();
+    return fs.statSync(path).isFile();
   } catch {
     return false;
   }
@@ -251,9 +266,9 @@ function collectAddedLines(root, base) {
   const untracked = run("git", ["ls-files", "--others", "--exclude-standard"], root);
   for (const f of untracked.stdout.split(`
 `)) {
-    if (f.length === 0 || !isRegularFile(join(root, f)))
+    if (f.length === 0 || !isRegularFile(join2(root, f)))
       continue;
-    for (const [idx, text] of readFileSync(join(root, f), "utf8").split(`
+    for (const [idx, text] of fs.readFileSync(join2(root, f), "utf8").split(`
 `).entries())
       out.push({ file: f, line: idx + 1, text });
   }
@@ -262,28 +277,28 @@ function collectAddedLines(root, base) {
 function listStagingResidue(tmpDir, wbs) {
   let names;
   try {
-    names = readdirSync(tmpDir);
+    names = fs.readdirSync(tmpDir);
   } catch {
     return [];
   }
-  return names.filter((n) => n.startsWith(`${wbs}-`) && isRegularFile(join(tmpDir, n))).map((n) => join(tmpDir, n));
+  return names.filter((n) => n.startsWith(`${wbs}-`) && isRegularFile(join2(tmpDir, n))).map((n) => join2(tmpDir, n));
 }
 function readDeferrals(runDir, wbs) {
-  const path = join(runDir, `${wbs}-residual-deferrals.json`);
-  if (!existsSync(path))
+  const path = join2(runDir, `${wbs}-residual-deferrals.json`);
+  if (!fs.existsSync(path))
     return [];
   const isDeferral = (e) => typeof e === "object" && e !== null && typeof e.id === "string" && typeof e.reason === "string" && e.reason.trim().length > 0;
   try {
-    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    const parsed = JSON.parse(fs.readFileSync(path, "utf8"));
     return (Array.isArray(parsed) ? parsed : []).filter(isDeferral);
   } catch {
     return [];
   }
 }
 function scanResiduals2(root, wbs, tmpDir, taskContent, _env) {
-  const runDir = join(root, ".spur", "run");
-  const basePath = join(runDir, `${wbs}-base.sha`);
-  const base = existsSync(basePath) ? readFileSync(basePath, "utf8").trim() : null;
+  const runDir = join2(root, ".spur", "run");
+  const basePath = join2(runDir, `${wbs}-base.sha`);
+  const base = fs.existsSync(basePath) ? fs.readFileSync(basePath, "utf8").trim() : null;
   const stagingResidue = listStagingResidue(tmpDir, wbs);
   const deferrals = readDeferrals(runDir, wbs);
   const addedLines = base === null ? [] : collectAddedLines(root, base);
@@ -323,29 +338,39 @@ function loadTask(env, spurBinFlag, wbs, root) {
   return { content: typeof parsed.content === "string" ? parsed.content : "", featureId };
 }
 function loadVerdict(runDir, wbs) {
-  return JSON.parse(readFileSync(join(runDir, `${wbs}-verdict.json`), "utf8"));
+  return JSON.parse(fs.readFileSync(recordedVerdictPath(runDir, wbs, fs), "utf8"));
 }
 function scanMode(opts, env, io) {
-  const runDir = join(opts.root, ".spur", "run");
-  mkdirSync(runDir, { recursive: true });
+  const runDir = join2(opts.root, ".spur", "run");
+  fs.mkdirSync(runDir, { recursive: true });
   const { content } = loadTask(env, opts.spurBin, opts.wbs, opts.root);
   const artifact = scanResiduals2(opts.root, opts.wbs, opts.tmpDir, content, env);
-  writeFileSync(join(runDir, `${opts.wbs}-residuals.json`), `${JSON.stringify(artifact, null, 2)}
+  fs.writeFileSync(join2(runDir, `${opts.wbs}-residuals.json`), `${JSON.stringify(artifact, null, 2)}
 `);
   io.out(`residual-scan: ${opts.wbs} blocking=${artifact.counts.blocking} deferrable=${artifact.counts.deferrable} advisory=${artifact.counts.advisory} housekeeping=${artifact.counts.housekeeping}
 `);
   return 0;
 }
 function foldMode(opts, _env, io) {
-  const runDir = join(opts.root, ".spur", "run");
-  const scan = JSON.parse(readFileSync(join(runDir, `${opts.wbs}-residuals.json`), "utf8"));
-  const verdictPath = join(runDir, `${opts.wbs}-verdict.json`);
+  const runDir = join2(opts.root, ".spur", "run");
+  const scan = JSON.parse(fs.readFileSync(join2(runDir, `${opts.wbs}-residuals.json`), "utf8"));
+  const target = recordedVerdictPath(runDir, opts.wbs, fs);
   const verdict = loadVerdict(runDir, opts.wbs);
-  const findingsPath = join(runDir, `${opts.wbs}-test-gate.findings`);
-  const fold = foldVerdict(verdict, scan, existsSync(findingsPath) ? readFileSync(findingsPath, "utf8") : "");
-  writeFileSync(verdictPath, `${JSON.stringify({ ...verdict, verdict: fold.verdict, checks: fold.checks }, null, 2)}
-`);
-  writeFileSync(findingsPath, fold.findings);
+  const findingsPath = join2(runDir, `${opts.wbs}-test-gate.findings`);
+  const fold = foldVerdict(verdict, scan, fs.existsSync(findingsPath) ? fs.readFileSync(findingsPath, "utf8") : "");
+  const bytes = `${JSON.stringify({ ...verdict, verdict: fold.verdict, checks: fold.checks }, null, 2)}
+`;
+  const temporary = `${target}.${process.pid}.tmp`;
+  try {
+    fs.writeFileSync(temporary, bytes, { flag: "wx" });
+    fs.renameSync(temporary, target);
+  } finally {
+    fs.rmSync(temporary, { force: true });
+  }
+  const scratch = join2(runDir, `${opts.wbs}-verdict.json`);
+  if (target !== scratch)
+    fs.writeFileSync(scratch, bytes);
+  fs.writeFileSync(findingsPath, fold.findings);
   io.out(`residual-fold: ${opts.wbs} verdict=${fold.verdict} residual-sweep=${fold.checks.find((c) => c.name === "residual-sweep")?.status}
 `);
   return 0;
@@ -353,12 +378,12 @@ function foldMode(opts, _env, io) {
 function settleMode(opts, env, io) {
   const wbs = opts.wbs;
   const task = loadTask(env, opts.spurBin, wbs, opts.root);
-  const runDir = join(opts.root, ".spur", "run");
+  const runDir = join2(opts.root, ".spur", "run");
   const scan = scanResiduals2(opts.root, wbs, opts.tmpDir, task.content, env);
-  const residualsPath = join(runDir, `${wbs}-residuals.json`);
+  const residualsPath = join2(runDir, `${wbs}-residuals.json`);
   let prior = {};
-  if (existsSync(residualsPath))
-    prior = JSON.parse(readFileSync(residualsPath, "utf8"));
+  if (fs.existsSync(residualsPath))
+    prior = JSON.parse(fs.readFileSync(residualsPath, "utf8"));
   const deferred = scan.items.filter((i) => i.class === "deferrable");
   if (deferred.length > 0 && prior.followUp === undefined) {
     if (task.featureId === "") {
@@ -383,8 +408,8 @@ function settleMode(opts, env, io) {
     }
     const rows = deferred.map((i) => `- ${i.id} \u2014 ${i.location}: ${i.text}`);
     const head = `Source task: ${wbs} (feature ${task.featureId}) \u2014 deferred residuals filed by residual-scan settle.`;
-    const bgFile = join(runDir, `${wbs}-residual-background.md`);
-    writeFileSync(bgFile, `${[head, "", ...rows].join(`
+    const bgFile = join2(runDir, `${wbs}-residual-background.md`);
+    fs.writeFileSync(bgFile, `${[head, "", ...rows].join(`
 `)}
 `);
     const updArgs = ["task", "update", wbsNew, "--section", "Background", "--from-file", bgFile];
@@ -399,28 +424,28 @@ function settleMode(opts, env, io) {
   }
   for (const path of listStagingResidue(opts.tmpDir, wbs)) {
     try {
-      rmSync(path, { force: true });
+      fs.rmSync(path, { force: true });
     } catch {
       io.err(`residual-settle: could not remove ${path}; re-run: residual-scan settle ${wbs}
 `);
       return 0;
     }
   }
-  writeFileSync(residualsPath, `${JSON.stringify({ ...scan, ...prior }, null, 2)}
+  fs.writeFileSync(residualsPath, `${JSON.stringify({ ...scan, ...prior }, null, 2)}
 `);
   return 0;
 }
 function reportMode(opts, env, io) {
-  const runDir = join(opts.root, ".spur", "run");
+  const runDir = join2(opts.root, ".spur", "run");
   const sweep = loadVerdict(runDir, opts.wbs).checks.find((c) => c.name === "residual-sweep");
   if (sweep === undefined || sweep.status !== "fail")
     return 0;
   const { content } = loadTask(env, opts.spurBin, opts.wbs, opts.root);
   const scan = scanResiduals2(opts.root, opts.wbs, opts.tmpDir, content, env);
   const blocking = scan.items.filter((i) => i.class === "blocking");
-  const attemptFile = join(runDir, `${opts.wbs}-test-fix-attempt`);
-  const attempts = existsSync(attemptFile) ? Number.parseInt(readFileSync(attemptFile, "utf8").trim() || "0", 10) : 0;
-  writeFileSync(join(runDir, `${opts.wbs}-residual-report.md`), renderReport(opts.wbs, blocking, Number.isNaN(attempts) ? 0 : attempts));
+  const attemptFile = join2(runDir, `${opts.wbs}-test-fix-attempt`);
+  const attempts = fs.existsSync(attemptFile) ? Number.parseInt(fs.readFileSync(attemptFile, "utf8").trim() || "0", 10) : 0;
+  fs.writeFileSync(join2(runDir, `${opts.wbs}-residual-report.md`), renderReport(opts.wbs, blocking, Number.isNaN(attempts) ? 0 : attempts));
   io.out(`Recovery: fix the items in .spur/run/${opts.wbs}-residual-report.md, then /sp:dev-run ${opts.wbs}
 `);
   return 0;
@@ -439,13 +464,14 @@ function main(argv, env = getEnvVars(), options = {}) {
 `);
     return 2;
   }
-  const resolved = { ...opts, root: opts.root.startsWith("/") ? opts.root : join(cwd, opts.root) };
+  const resolved = { ...opts, root: opts.root.startsWith("/") ? opts.root : join2(cwd, opts.root) };
   return modeFn(resolved, env, io);
 }
 process.exit(main(process.argv.slice(2)));
 export {
   scanResiduals2 as scanResiduals,
   renderReport,
+  recordedVerdictPath,
   parseReviewFindings,
   parseDiffMarkers,
   normalizeAnchor,