@gobing-ai/spur 0.4.7 → 0.4.9

package/plugins/sp/scripts/workflow-step-profile.mjs

@@ -1,338 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/workflow-step-profile.ts
-import { spawnSync } from "child_process";
-
-// plugins/sp/lib/spur-bin.ts
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-
-// plugins/sp/lib/env.ts
-function getEnvVar(name, fallback) {
-  const raw = process.env[name];
-  return raw === undefined ? fallback : raw;
-}
-
-// 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) };
-}
-function defaultSpurBin() {
-  const fromEnv = getEnvVar("SPUR_BIN");
-  if (fromEnv)
-    return fromEnv;
-  const local = fileURLToPath(new URL("../../../apps/cli/src/index.ts", import.meta.url));
-  if (existsSync(local))
-    return `bun ${local}`;
-  return "spur";
-}
-
-// plugins/sp/lib/step-profile.generated.mjs
-var DEFAULT_LAST = 20;
-var DEFAULT_WINDOW_SEC = 300;
-function nearestRankP50(values) {
-  if (values.length === 0)
-    return null;
-  const sorted = [...values].sort((a, b) => a - b);
-  return sorted[Math.ceil(sorted.length / 2) - 1] ?? null;
-}
-function numeric(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function msBetween(from, to) {
-  if (typeof from !== "string" || typeof to !== "string")
-    return null;
-  const start = Date.parse(from);
-  const end = Date.parse(to);
-  if (!Number.isFinite(start) || !Number.isFinite(end))
-    return null;
-  return end - start;
-}
-function sessionOf(event) {
-  const value = event.invocation?.continue;
-  if (value === true)
-    return "resumed";
-  if (value === false)
-    return "fresh";
-  return null;
-}
-function cacheHitOf(event) {
-  return numeric(event.cost?.exact?.cacheHit);
-}
-function startKey(event) {
-  const parsed = typeof event.startedAt === "string" ? Date.parse(event.startedAt) : Number.NaN;
-  return Number.isFinite(parsed) ? parsed : Number.POSITIVE_INFINITY;
-}
-function extractExecutions(runId, events) {
-  const actions = events.filter((e) => e.kind === "action").sort((a, b) => {
-    const left = startKey(a);
-    const right = startKey(b);
-    return left === right ? 0 : left - right;
-  });
-  const executions = [];
-  for (const [index, event] of actions.entries()) {
-    const previous = index === 0 ? undefined : actions[index - 1];
-    executions.push({
-      runId,
-      node: event.node ?? "",
-      actionKind: event.actionKind ?? "",
-      durationMs: numeric(event.durationMs),
-      idleGapMs: msBetween(previous?.completedAt, event.startedAt),
-      session: sessionOf(event),
-      cacheHit: cacheHitOf(event)
-    });
-  }
-  return executions;
-}
-function foldSession(executions) {
-  const known = new Set(executions.map((e) => e.session).filter((s) => s !== null));
-  if (known.size === 0)
-    return null;
-  if (known.size === 1)
-    return [...known][0] ?? null;
-  return "mixed";
-}
-function rowFlags(row, windowSec) {
-  const wMs = windowSec * 1000;
-  const flags = [];
-  const agentRun = row.actionKind === "agent.run";
-  const resumed = row.session === "resumed" || row.session === "mixed";
-  const p50 = row.durationMs.p50;
-  if (!agentRun && p50 !== null && p50 > wMs)
-    flags.push("step-over-window");
-  const idle = row.idleGapMs.p50;
-  if (agentRun && resumed && idle !== null && idle > wMs)
-    flags.push("resume-after-idle");
-  const hit = row.cacheHit.p50;
-  if (agentRun && resumed && row.cacheHit.known > 0 && hit !== null && hit < 0.5)
-    flags.push("resume-cold-cache");
-  if (agentRun && p50 !== null && p50 > 2 * wMs)
-    flags.push("agent-run-over-2w");
-  return flags;
-}
-function buildRows(executions, windowSec) {
-  const grouped = new Map;
-  for (const execution of executions) {
-    const key = `${execution.node}\x00${execution.actionKind}`;
-    const bucket = grouped.get(key);
-    if (bucket === undefined)
-      grouped.set(key, [execution]);
-    else
-      bucket.push(execution);
-  }
-  const rows = [];
-  for (const bucket of grouped.values()) {
-    const first = bucket[0];
-    if (first === undefined)
-      continue;
-    const durations = bucket.map((e) => e.durationMs).filter((d) => d !== null);
-    const gaps = bucket.map((e) => e.idleGapMs).filter((g) => g !== null);
-    const hits = bucket.map((e) => e.cacheHit).filter((h) => h !== null);
-    const row = {
-      node: first.node,
-      actionKind: first.actionKind,
-      runs: new Set(bucket.map((e) => e.runId)).size,
-      executions: bucket.length,
-      durationMs: {
-        p50: nearestRankP50(durations),
-        max: durations.length === 0 ? null : Math.max(...durations)
-      },
-      idleGapMs: { p50: nearestRankP50(gaps) },
-      session: first.actionKind === "agent.run" ? foldSession(bucket) : null,
-      cacheHit: {
-        p50: nearestRankP50(hits),
-        known: hits.length,
-        of: bucket.length
-      },
-      flags: []
-    };
-    row.flags = rowFlags(row, windowSec);
-    rows.push(row);
-  }
-  return rows.sort((a, b) => a.node === b.node ? a.actionKind.localeCompare(b.actionKind) : a.node.localeCompare(b.node));
-}
-function buildStepProfile(input) {
-  const executions = input.runs.flatMap((run) => extractExecutions(run.runId, run.events));
-  return {
-    workflow: input.workflow,
-    windowSec: input.windowSec,
-    sampledRuns: input.runs.length,
-    rows: buildRows(executions, input.windowSec)
-  };
-}
-function nonDryRuns(entries) {
-  return entries.filter((e) => e.isDryRun !== true && typeof e.runId === "string" && e.runId.length > 0);
-}
-function seconds(value) {
-  return value === null ? "?" : `${(value / 1000).toFixed(1)}s`;
-}
-function ratio(value) {
-  return value === null ? "?" : value.toFixed(2);
-}
-function formatStepProfileHuman(profile) {
-  const lines = [
-    `step profile — ${profile.workflow} (window ${profile.windowSec}s, ${profile.sampledRuns} sampled runs)`
-  ];
-  for (const row of profile.rows) {
-    lines.push([
-      row.node.padEnd(20),
-      row.actionKind.padEnd(14),
-      `${row.runs}/${row.executions}`.padEnd(8),
-      `p50=${seconds(row.durationMs.p50)}`.padEnd(12),
-      `max=${seconds(row.durationMs.max)}`.padEnd(12),
-      `idle=${seconds(row.idleGapMs.p50)}`.padEnd(12),
-      `session=${row.session ?? "?"}`.padEnd(15),
-      `cacheHit=${ratio(row.cacheHit.p50)} (${row.cacheHit.known}/${row.cacheHit.of})`.padEnd(20),
-      `flags=${row.flags.length === 0 ? "-" : row.flags.join(",")}`
-    ].join(" "));
-  }
-  return `${lines.join(`
-`)}
-`;
-}
-
-// plugins/sp/scripts/workflow-step-profile.ts
-function positiveInt(raw, fallback) {
-  const parsed = Number.parseInt(raw ?? "", 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-function parseStepProfileCliArgs(argv) {
-  let workflow = "";
-  let spurBin = defaultSpurBin();
-  let last = DEFAULT_LAST;
-  let windowSec = DEFAULT_WINDOW_SEC;
-  let json = false;
-  let help = false;
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === undefined)
-      continue;
-    if (a === "--help" || a === "-h")
-      help = true;
-    else if (a === "--json")
-      json = true;
-    else if (a === "--last")
-      last = positiveInt(argv[++i], last);
-    else if (a === "--window")
-      windowSec = positiveInt(argv[++i], windowSec);
-    else if (a === "--spur-bin")
-      spurBin = argv[++i] ?? spurBin;
-    else if (!a.startsWith("--") && workflow === "")
-      workflow = a;
-  }
-  return { workflow, last, windowSec, spurBin, json, help };
-}
-function runSpurJson(spurBin, args) {
-  const { cmd, prefix } = spurCommand(spurBin);
-  const cmdArgs = [...prefix, ...args];
-  const r = spawnSync(cmd, cmdArgs, { stdio: ["ignore", "pipe", "pipe"], encoding: "utf8" });
-  const decode = (b) => typeof b === "string" ? b : Buffer.from(b ?? []).toString("utf8");
-  return {
-    stdout: typeof r.stdout === "string" ? r.stdout : decode(r.stdout),
-    stderr: typeof r.stderr === "string" ? r.stderr : decode(r.stderr),
-    exitCode: r.status ?? (r.error ? 1 : 0),
-    ok: (r.status ?? (r.error ? 1 : 0)) === 0
-  };
-}
-var STEP_PROFILE_USAGE = `usage: workflow-step-profile <workflow> [--last <N>] [--window <sec>] [--json] [--spur-bin <cmd>]
-
-Read-only step profile from \`spur workflow trace\`: per node and action kind it reports runs,
-executions, p50/max durationMs, p50 idle gap, session mode and cacheHit p50 with coverage, then
-flags the satellite \xA710 cache-window budgets. --last defaults to ${DEFAULT_LAST} runs and --window
-(W) to ${DEFAULT_WINDOW_SEC} seconds. Unknown evidence is reported as \`?\` / null, never 0.
-
-Exit: 0 = profile produced (flags included); 1 = a spur call failed, its JSON did not parse, or the
-workflow argument is missing.`;
-function failure(message) {
-  return { exitCode: 1, stdout: "", stderr: `workflow-step-profile: ${message}
-` };
-}
-function runFailure(spurBin, result, what) {
-  const detail = result.stderr.trim().split(`
-`).slice(-1)[0] ?? "";
-  return failure(`${what} failed (exit ${result.exitCode}${detail === "" ? "" : `: ${detail}`}) [${spurBin}]`);
-}
-function runStepProfileCli(argv) {
-  const args = parseStepProfileCliArgs(argv);
-  if (args.help)
-    return { exitCode: 0, stdout: `${STEP_PROFILE_USAGE}
-`, stderr: "" };
-  if (args.workflow === "")
-    return failure(`a workflow name is required
-${STEP_PROFILE_USAGE}`);
-  const listArgs = [
-    "workflow",
-    "trace",
-    "--workflow",
-    args.workflow,
-    "--status",
-    "done",
-    "--last",
-    String(args.last),
-    "--json"
-  ];
-  const list = runSpurJson(args.spurBin, listArgs);
-  if (!list.ok)
-    return runFailure(args.spurBin, list, `spur ${listArgs.join(" ")}`);
-  let entries;
-  try {
-    const parsed = JSON.parse(list.stdout);
-    if (!Array.isArray(parsed.entries))
-      throw new Error('no "entries" array');
-    entries = parsed.entries;
-  } catch (err) {
-    return failure(`spur workflow trace output did not parse as JSON: ${String(err)}`);
-  }
-  const runs = [];
-  for (const entry of nonDryRuns(entries)) {
-    const runArgs = ["workflow", "trace", entry.runId, "--json"];
-    const timeline = runSpurJson(args.spurBin, runArgs);
-    if (!timeline.ok)
-      return runFailure(args.spurBin, timeline, `spur ${runArgs.join(" ")}`);
-    try {
-      const parsed = JSON.parse(timeline.stdout);
-      if (!Array.isArray(parsed.events))
-        throw new Error('no "events" array');
-      runs.push({ runId: entry.runId, events: parsed.events });
-    } catch (err) {
-      return failure(`spur workflow trace ${entry.runId} output did not parse as JSON: ${String(err)}`);
-    }
-  }
-  const profile = buildStepProfile({ workflow: args.workflow, windowSec: args.windowSec, runs });
-  return {
-    exitCode: 0,
-    stdout: args.json ? `${JSON.stringify(profile, null, 2)}
-` : formatStepProfileHuman(profile),
-    stderr: ""
-  };
-}
-function main(argv) {
-  const { exitCode, stdout, stderr } = runStepProfileCli(argv);
-  if (stdout)
-    process.stdout.write(stdout);
-  if (stderr)
-    process.stderr.write(stderr.endsWith(`
-`) ? stderr : `${stderr}
-`);
-  return exitCode;
-}
-{
-  process.exit(main(process.argv.slice(2)));
-}
-export {
-  DEFAULT_LAST,
-  DEFAULT_WINDOW_SEC,
-  STEP_PROFILE_USAGE,
-  buildRows,
-  buildStepProfile,
-  extractExecutions,
-  formatStepProfileHuman,
-  main,
-  nearestRankP50,
-  nonDryRuns,
-  parseStepProfileCliArgs,
-  rowFlags,
-  runStepProfileCli
-};

package/plugins/sp/scripts/workflow-step-profile.ts

@@ -1,165 +0,0 @@
-#!/usr/bin/env bun
-/**
- * workflow-step-profile — per-node step evidence for `sp:spur-doctor` (task 0827, feature I21).
- *
- * IO glue only (task 1005 R4, ADR-130 lib rule): argv parsing, `spur workflow trace --json`
- * spawning and the two output modes. The aggregation core (nearestRankP50, extractExecutions,
- * rowFlags, buildRows, buildStepProfile, nonDryRuns, formatStepProfileHuman and their types) lives
- * in packages/app/src/workflow/step-profile.ts and reaches this script through the generated
- * standalone bundle `plugins/sp/lib/step-profile.generated.mjs` — node-builtin only, so the
- * committed `.mjs` twin runs under bare `node`. Regenerate with `bun run build:scripts`.
- *
- * Exit: 0 whenever a profile is produced (including `sampledRuns: 0` and flagged rows). Flags are
- * evidence, not a gate. 1, with a stderr message, only when a `spur` call fails, its JSON does not
- * parse, or the workflow argument is missing.
- */
-import { spawnSync } from 'node:child_process';
-import { defaultSpurBin, spurCommand } from '../lib/spur-bin';
-import {
-    buildStepProfile,
-    DEFAULT_LAST,
-    DEFAULT_WINDOW_SEC,
-    formatStepProfileHuman,
-    nonDryRuns,
-    type StepProfileRun,
-    type TraceActionEvent,
-    type TraceRunEntry,
-} from '../lib/step-profile.generated.mjs';
-
-export * from '../lib/step-profile.generated.mjs';
-export interface StepProfileCliArgs {
-    workflow: string;
-    last: number;
-    windowSec: number;
-    spurBin: string;
-    json: boolean;
-    help: boolean;
-}
-
-function positiveInt(raw: string | undefined, fallback: number): number {
-    const parsed = Number.parseInt(raw ?? '', 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-
-export function parseStepProfileCliArgs(argv: string[]): StepProfileCliArgs {
-    let workflow = '';
-    let spurBin = defaultSpurBin();
-    let last = DEFAULT_LAST;
-    let windowSec = DEFAULT_WINDOW_SEC;
-    let json = false;
-    let help = false;
-
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === undefined) continue;
-        if (a === '--help' || a === '-h') help = true;
-        else if (a === '--json') json = true;
-        else if (a === '--last') last = positiveInt(argv[++i], last);
-        else if (a === '--window') windowSec = positiveInt(argv[++i], windowSec);
-        else if (a === '--spur-bin') spurBin = argv[++i] ?? spurBin;
-        else if (!a.startsWith('--') && workflow === '') workflow = a;
-    }
-    return { workflow, last, windowSec, spurBin, json, help };
-}
-
-type SpawnResult = { stdout: string; stderr: string; exitCode: number; ok: boolean };
-
-function runSpurJson(spurBin: string, args: string[]): SpawnResult {
-    const { cmd, prefix } = spurCommand(spurBin);
-    const cmdArgs = [...prefix, ...args];
-    const r = spawnSync(cmd, cmdArgs, { stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' });
-    const decode = (b: unknown): string =>
-        typeof b === 'string' ? b : Buffer.from((b as Uint8Array) ?? []).toString('utf8');
-    return {
-        stdout: typeof r.stdout === 'string' ? r.stdout : decode(r.stdout),
-        stderr: typeof r.stderr === 'string' ? r.stderr : decode(r.stderr),
-        exitCode: r.status ?? (r.error ? 1 : 0),
-        ok: (r.status ?? (r.error ? 1 : 0)) === 0,
-    };
-}
-
-export interface StepProfileCliResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}
-
-export const STEP_PROFILE_USAGE = `usage: workflow-step-profile <workflow> [--last <N>] [--window <sec>] [--json] [--spur-bin <cmd>]
-
-Read-only step profile from \`spur workflow trace\`: per node and action kind it reports runs,
-executions, p50/max durationMs, p50 idle gap, session mode and cacheHit p50 with coverage, then
-flags the satellite §10 cache-window budgets. --last defaults to ${DEFAULT_LAST} runs and --window
-(W) to ${DEFAULT_WINDOW_SEC} seconds. Unknown evidence is reported as \`?\` / null, never 0.
-
-Exit: 0 = profile produced (flags included); 1 = a spur call failed, its JSON did not parse, or the
-workflow argument is missing.`;
-
-function failure(message: string): StepProfileCliResult {
-    return { exitCode: 1, stdout: '', stderr: `workflow-step-profile: ${message}\n` };
-}
-
-function runFailure(spurBin: string, result: SpawnResult, what: string): StepProfileCliResult {
-    const detail = result.stderr.trim().split('\n').slice(-1)[0] ?? '';
-    return failure(`${what} failed (exit ${result.exitCode}${detail === '' ? '' : `: ${detail}`}) [${spurBin}]`);
-}
-
-export function runStepProfileCli(argv: string[]): StepProfileCliResult {
-    const args = parseStepProfileCliArgs(argv);
-    if (args.help) return { exitCode: 0, stdout: `${STEP_PROFILE_USAGE}\n`, stderr: '' };
-    if (args.workflow === '') return failure(`a workflow name is required\n${STEP_PROFILE_USAGE}`);
-
-    const listArgs = [
-        'workflow',
-        'trace',
-        '--workflow',
-        args.workflow,
-        '--status',
-        'done',
-        '--last',
-        String(args.last),
-        '--json',
-    ];
-    const list = runSpurJson(args.spurBin, listArgs);
-    if (!list.ok) return runFailure(args.spurBin, list, `spur ${listArgs.join(' ')}`);
-
-    let entries: TraceRunEntry[];
-    try {
-        const parsed = JSON.parse(list.stdout) as { entries?: unknown };
-        if (!Array.isArray(parsed.entries)) throw new Error('no "entries" array');
-        entries = parsed.entries as TraceRunEntry[];
-    } catch (err) {
-        return failure(`spur workflow trace output did not parse as JSON: ${String(err)}`);
-    }
-
-    const runs: StepProfileRun[] = [];
-    for (const entry of nonDryRuns(entries)) {
-        const runArgs = ['workflow', 'trace', entry.runId, '--json'];
-        const timeline = runSpurJson(args.spurBin, runArgs);
-        if (!timeline.ok) return runFailure(args.spurBin, timeline, `spur ${runArgs.join(' ')}`);
-        try {
-            const parsed = JSON.parse(timeline.stdout) as { events?: unknown };
-            if (!Array.isArray(parsed.events)) throw new Error('no "events" array');
-            runs.push({ runId: entry.runId, events: parsed.events as TraceActionEvent[] });
-        } catch (err) {
-            return failure(`spur workflow trace ${entry.runId} output did not parse as JSON: ${String(err)}`);
-        }
-    }
-
-    const profile = buildStepProfile({ workflow: args.workflow, windowSec: args.windowSec, runs });
-    return {
-        exitCode: 0,
-        stdout: args.json ? `${JSON.stringify(profile, null, 2)}\n` : formatStepProfileHuman(profile),
-        stderr: '',
-    };
-}
-
-export function main(argv: string[]): number {
-    const { exitCode, stdout, stderr } = runStepProfileCli(argv);
-    if (stdout) process.stdout.write(stdout);
-    if (stderr) process.stderr.write(stderr.endsWith('\n') ? stderr : `${stderr}\n`);
-    return exitCode;
-}
-
-if (import.meta.main) {
-    process.exit(main(process.argv.slice(2)));
-}

package/plugins/sp/scripts/wrapup-drift-probe.mjs

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/wrapup-drift-probe.ts
-import { spawnSync } from "child_process";
-import { 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-drift-probe.ts
-var WORKFLOWS_GLOB = `${join("config", "workflows")}/**`;
-var DOC_OWNED_SURFACES = [
-  "packages/contracts/**",
-  "apps/cli/src/commands/**",
-  "packages/config/src/**",
-  "drizzle/*.sql",
-  WORKFLOWS_GLOB,
-  "plugins/sp/commands/**",
-  "plugins/sp/skills/**",
-  "plugins/sp/hooks/**",
-  "package.json",
-  "docs/00_ADR.md",
-  "docs/03_ARCHITECTURE.md",
-  "docs/04_DESIGN.md",
-  "docs/design/**"
-];
-var KNOWN_TOP_LEVEL = new Set([
-  "apps",
-  "packages",
-  "plugins",
-  "config",
-  "docs",
-  "drizzle",
-  "scripts",
-  "vendors",
-  "package.json",
-  "bun.lock",
-  "bunfig.toml"
-]);
-var CORPUS_PREFIXES = ["docs/tasks", "docs/features/"];
-function solutionSectionOf(content) {
-  const heading = /^#{2,4}\s+Solution\s*$/m.exec(content);
-  if (!heading)
-    return null;
-  const rest = content.slice(heading.index + heading[0].length);
-  const next = /^#{2,4}\s+\S/m.exec(rest);
-  return next ? rest.slice(0, next.index) : rest;
-}
-var CHANGE_ENTRY = /`([^`\r\n]+):(\d+)(?:-\d+)?`/g;
-function changedPathsOf(section) {
-  if (section === null)
-    return [];
-  const paths = [];
-  for (const match of section.matchAll(CHANGE_ENTRY)) {
-    const path = match[1];
-    if (path === undefined)
-      continue;
-    if (/\s/.test(path))
-      continue;
-    if (!path.includes("/") && !path.includes("."))
-      continue;
-    paths.push(path);
-  }
-  return paths;
-}
-function surfaceRegex(glob) {
-  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replaceAll("**", "\x00").replaceAll("*", "[^/]*").replaceAll("\x00", ".*");
-  return new RegExp(`^${escaped}$`);
-}
-var SURFACE_MATCHERS = DOC_OWNED_SURFACES.map((glob) => ({ glob, regex: surfaceRegex(glob) }));
-function driftReasonForPath(path) {
-  if (CORPUS_PREFIXES.some((prefix) => path.startsWith(prefix)))
-    return null;
-  const top = path.split("/")[0];
-  if (path.includes("/") && top !== undefined && !KNOWN_TOP_LEVEL.has(top)) {
-    return "new top-level workspace directory";
-  }
-  const match = SURFACE_MATCHERS.find((entry) => entry.regex.test(path));
-  return match ? `matches doc-owned surface ${match.glob}` : null;
-}
-function defaultSpurRunner(env, cwd) {
-  const { cmd, prefix } = spurCommand(env.spurBin);
-  return (args) => {
-    const run = spawnSync(cmd, [...prefix, ...args], {
-      cwd,
-      encoding: "utf8",
-      env: getEnvVars()
-    });
-    return { status: run.status ?? 1, stdout: run.stdout ?? "" };
-  };
-}
-function runDriftProbe(env, options = {}, spur = defaultSpurRunner(env, options.cwd)) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? "";
-  if (runId.length === 0) {
-    process.stderr.write(`wrapup-drift-probe: __runId is empty \u2014 refusing the legacy fixed-path fallback
-`);
-    return { clean: false, reasons: [], paths: [], probeFile: "", modeFile: "", exitCode: 1 };
-  }
-  const relProbeFile = join(".spur", "run", `${runId}-drift-probe.json`);
-  const relModeFile = join(".spur", "run", `${runId}-mode.txt`);
-  const relTasksFile = join(".spur", "run", `${runId}-wrapup-tasks.json`);
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  mkdirSync(abs(join(".spur", "run")), { recursive: true });
-  writeFileSync(abs(relModeFile), `
-`);
-  const finish = (clean, reasons, paths) => {
-    writeFileSync(abs(relProbeFile), `${JSON.stringify({ clean, reasons, paths })}
-`);
-    writeFileSync(abs(relModeFile), clean ? `fast
-` : `
-`);
-    return { clean, reasons, paths, probeFile: relProbeFile, modeFile: relModeFile, exitCode: 0 };
-  };
-  let tasks;
-  try {
-    tasks = JSON.parse(readFileSync(abs(relTasksFile), "utf8"));
-  } catch {
-    tasks = undefined;
-  }
-  if (!Array.isArray(tasks) || !tasks.every((wbs) => typeof wbs === "string")) {
-    process.stderr.write(`wrapup-drift-probe: normalized task capture is missing or corrupted \u2014 failing safe (dirty)
-`);
-    return finish(false, ["normalized task capture missing or corrupted"], []);
-  }
-  const reasons = [];
-  const allPaths = new Set;
-  for (const wbs of tasks) {
-    const shown = spur(["task", "show", wbs, "--json"]);
-    if (shown.status !== 0) {
-      reasons.push(`${wbs}: task show failed (status=${shown.status})`);
-      continue;
-    }
-    let content;
-    try {
-      content = JSON.parse(shown.stdout).content;
-    } catch {
-      content = undefined;
-    }
-    if (typeof content !== "string") {
-      reasons.push(`${wbs}: task show output unparseable`);
-      continue;
-    }
-    const changedPaths = changedPathsOf(solutionSectionOf(content));
-    if (changedPaths.length === 0) {
-      reasons.push(`${wbs}: Solution empty or unparseable`);
-      continue;
-    }
-    for (const path of changedPaths) {
-      if (CORPUS_PREFIXES.some((prefix) => path.startsWith(prefix)))
-        continue;
-      allPaths.add(path);
-      const drift = driftReasonForPath(path);
-      if (drift)
-        reasons.push(`${wbs}: ${path} ${drift}`);
-    }
-  }
-  return finish(reasons.length === 0, reasons, [...allPaths].sort());
-}
-var WRAPUP_DRIFT_PROBE_USAGE = "usage: wrapup-drift-probe  (env: __runId, spurBin)";
-function main(argv, env = getEnvVars(), options = {}) {
-  if (argv.length > 0) {
-    process.stderr.write(`${WRAPUP_DRIFT_PROBE_USAGE}
-`);
-    return 2;
-  }
-  return runDriftProbe(env, options).exitCode;
-}
-{
-  process.exit(main(process.argv.slice(2)));
-}
-export {
-  DOC_OWNED_SURFACES,
-  WRAPUP_DRIFT_PROBE_USAGE,
-  changedPathsOf,
-  driftReasonForPath,
-  main,
-  runDriftProbe,
-  solutionSectionOf
-};