@gobing-ai/spur 0.4.0 → 0.4.1

package/plugins/sp/scripts/inline-run-setup.mjs

@@ -3,8 +3,8 @@
 
 // plugins/sp/scripts/inline-run-setup.ts
 import { spawnSync } from "child_process";
-import { existsSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { dirname, join as join3, resolve } from "path";
 import { fileURLToPath } from "url";
 
 // plugins/sp/lib/env.ts
@@ -13,14 +13,519 @@ function getEnvVar(name, fallback) {
   return raw === undefined ? fallback : raw;
 }
 
+// plugins/sp/lib/inline-run-app.ts
+async function loadInlineApp(spurBin, resolveAppEntry, required) {
+  const { entry, portable } = resolveAppEntry(spurBin);
+  const app = await import(entry);
+  const missing = portable ? required.filter((name) => typeof app[name] !== "function") : [];
+  if (missing.length > 0) {
+    throw new Error(`inline application bundle ${entry} is older than its scripts — missing ${missing.join(", ")}. Reinstall sp with a superskill release that stages lib/ (commit b42961b), or pass --spur-bin <spur checkout>/apps/cli/src/index.ts.`);
+  }
+  return { app, portable };
+}
+
+// plugins/sp/lib/env.ts
+function getEnvVars() {
+  return process.env;
+}
+
+// plugins/sp/lib/run-summary-core.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join as join2 } from "node:path";
+
+// plugins/sp/lib/transcript.ts
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+var SESSION_ID = /^[A-Za-z0-9_-]+$/;
+var OPERATOR_TOOLS = new Set(["AskUserQuestion", "ask_user_question"]);
+var PI_ROLES = new Set(["user", "assistant", "toolResult"]);
+var zeroTokens = () => ({ input: 0, cacheCreate: 0, cacheRead: 0, output: 0 });
+function formatDuration(ms) {
+  const s = Math.round(ms / 1000);
+  const h = Math.floor(s / 3600);
+  const m = Math.floor(s % 3600 / 60);
+  const ss = String(s % 60).padStart(2, "0");
+  return h > 0 ? `${h}:${String(m).padStart(2, "0")}:${ss}` : `${m}:${ss}`;
+}
+function formatTokens(n) {
+  if (n >= 999500)
+    return `${(n / 1e6).toFixed(1)}M`;
+  return n >= 1000 ? `${Math.round(n / 1000)}k` : String(n);
+}
+function formatTokenSplit(t) {
+  if (!t)
+    return "n/a";
+  const nonCached = t.input + t.cacheCreate + t.output;
+  return `${formatTokens(nonCached + t.cacheRead)} / ${formatTokens(nonCached)}`;
+}
+function promptText(row) {
+  if (row.type === "message") {
+    if (row.message?.role !== "user")
+      return;
+    if (isInjectedPrompt(row))
+      return;
+    const content2 = row.message.content;
+    if (typeof content2 === "string")
+      return content2;
+    if (!Array.isArray(content2))
+      return;
+    return content2.find((b) => b.type === "text")?.text;
+  }
+  if (row.type !== "user" || row.isMeta || row.isCompactSummary)
+    return;
+  const content = row.message?.content;
+  if (typeof content === "string")
+    return content;
+  if (!Array.isArray(content) || content.some((b) => b.type === "tool_result"))
+    return;
+  return content.find((b) => b.type === "text")?.text;
+}
+function isInjectedPrompt(row) {
+  if (row.type !== "message" || row.message?.role !== "user")
+    return false;
+  const content = row.message.content;
+  const text = typeof content === "string" ? content : Array.isArray(content) ? content.find((b) => b.type === "text")?.text : undefined;
+  return typeof text === "string" && text.replace(/^\s+/, "").startsWith('<skill name="');
+}
+function sumTokens(all) {
+  const total = zeroTokens();
+  for (const t of all)
+    for (const k of Object.keys(total))
+      total[k] += t[k];
+  return total;
+}
+function sumSpans(spans) {
+  return {
+    workMs: spans.reduce((n, s) => n + s.workMs, 0),
+    waitMs: spans.reduce((n, s) => n + s.waitMs, 0),
+    toolCalls: spans.reduce((n, s) => n + s.toolCalls, 0),
+    tokens: sumTokens(spans.map((s) => s.tokens))
+  };
+}
+var newAcc = (ts) => ({
+  last: ts,
+  askMs: 0,
+  asks: new Map,
+  toolIds: new Set,
+  messages: new Map,
+  compactions: 0
+});
+function accumulate(acc, row, ts) {
+  acc.last = Math.max(acc.last, ts);
+  if (row.type === "message") {
+    const m = row.message;
+    if (m?.role === "assistant") {
+      const blocks2 = Array.isArray(m.content) ? m.content : [];
+      for (const b of blocks2) {
+        if (b.type === "toolCall" && b.id) {
+          acc.toolIds.add(b.id);
+          if (b.name && OPERATOR_TOOLS.has(b.name))
+            acc.asks.set(b.id, ts);
+        }
+      }
+      const u2 = m.usage;
+      if (u2 && row.id)
+        acc.messages.set(row.id, {
+          input: u2.input ?? 0,
+          cacheCreate: u2.cacheWrite ?? 0,
+          cacheRead: u2.cacheRead ?? 0,
+          output: u2.output ?? 0
+        });
+    } else if (m?.role === "toolResult" && m.toolCallId && acc.asks.has(m.toolCallId)) {
+      acc.askMs += ts - (acc.asks.get(m.toolCallId) ?? ts);
+    }
+    return;
+  }
+  if (row.type === "compaction")
+    acc.compactions++;
+  const blocks = Array.isArray(row.message?.content) ? row.message.content : [];
+  for (const b of blocks) {
+    if (b.type === "tool_use" && b.id) {
+      acc.toolIds.add(b.id);
+      if (b.name && OPERATOR_TOOLS.has(b.name))
+        acc.asks.set(b.id, ts);
+    } else if (b.type === "tool_result" && b.tool_use_id && acc.asks.has(b.tool_use_id)) {
+      acc.askMs += ts - (acc.asks.get(b.tool_use_id) ?? ts);
+    }
+  }
+  const u = row.message?.usage;
+  if (row.type === "assistant" && u && row.message?.id) {
+    acc.messages.set(row.message.id, {
+      input: u.input_tokens ?? 0,
+      cacheCreate: u.cache_creation_input_tokens ?? 0,
+      cacheRead: u.cache_read_input_tokens ?? 0,
+      output: u.output_tokens ?? 0
+    });
+  }
+}
+function isCompaction(row) {
+  return row.type === "compaction" || row.type === "system" && row.subtype === "compact_boundary";
+}
+function sniffFormat(rows) {
+  for (const row of rows) {
+    if (row.type === "message" && PI_ROLES.has(row.message?.role ?? ""))
+      return "pi";
+    if (row.type === "user" || row.type === "assistant")
+      return "claude";
+  }
+  return "unknown";
+}
+function parseRows(lines) {
+  const rows = [];
+  let skippedLines = 0;
+  for (const line of lines) {
+    if (!line.trim())
+      continue;
+    let row;
+    try {
+      row = JSON.parse(line);
+    } catch {
+      skippedLines++;
+      continue;
+    }
+    const ts = row.timestamp ? Date.parse(row.timestamp) : Number.NaN;
+    if (!Number.isNaN(ts))
+      rows.push([row, ts]);
+  }
+  return { rows, skippedLines, format: sniffFormat(rows.map(([r]) => r)) };
+}
+function resolveTranscript(env, projectsRoot = join(homedir(), ".claude", "projects"), override) {
+  if (override)
+    return existsSync(override) ? { ok: true, path: override } : { ok: false, reason: "no transcript" };
+  const id = env.CLAUDE_CODE_SESSION_ID;
+  if (!id) {
+    const piFile = env.PI_SESSION_FILE;
+    if (piFile !== undefined && piFile !== "") {
+      return existsSync(piFile) ? { ok: true, path: piFile } : { ok: false, reason: `PI_SESSION_FILE ${piFile} does not exist` };
+    }
+    return {
+      ok: false,
+      reason: "no host session id; pass --transcript <path> (pi: ~/.pi/agent/sessions/<cwd-slug>/<file>.jsonl, " + "or set PI_SESSION_FILE)"
+    };
+  }
+  if (!SESSION_ID.test(id))
+    return { ok: false, reason: "refusing a session id with path characters" };
+  if (!existsSync(projectsRoot))
+    return { ok: false, reason: `no transcript root ${projectsRoot}` };
+  for (const dir of readdirSync(projectsRoot)) {
+    const path = join(projectsRoot, dir, `${id}.jsonl`);
+    if (existsSync(path))
+      return { ok: true, path };
+  }
+  return { ok: false, reason: `no transcript for session ${id}` };
+}
+
+// plugins/sp/lib/run-summary-core.ts
+var IDLE_GAP_MS = 300000;
+var SHELL_TOOLS = new Set(["bash", "shell", "exec", "exec_command", "run_command", "command"]);
+var SUBAGENT_TOOLS = new Set(["agent", "task", "invoke_subagent", "subagent", "dispatch_agent"]);
+var OPERATOR_TOOLS2 = new Set(["askuserquestion", "ask_user_question"]);
+var ACTOR_PRECEDENCE = ["operator", "subagent", "shell", "other"];
+function actorOf(tool) {
+  const t = tool.toLowerCase().replace(/[^a-z_]/g, "");
+  if (OPERATOR_TOOLS2.has(t))
+    return "operator";
+  if (SUBAGENT_TOOLS.has(t))
+    return "subagent";
+  if (SHELL_TOOLS.has(t))
+    return "shell";
+  return "other";
+}
+function unionMs(spans, start, end) {
+  const clipped = spans.map(([a, b]) => [Math.max(a, start), Math.min(b, end)]).filter(([a, b]) => b > a).sort((x, y) => x[0] - y[0]);
+  let total = 0;
+  let cursor = Number.NaN;
+  let openUntil = Number.NaN;
+  for (const [a, b] of clipped) {
+    if (!Number.isFinite(cursor)) {
+      cursor = a;
+      openUntil = b;
+      continue;
+    }
+    if (a > openUntil) {
+      total += openUntil - cursor;
+      cursor = a;
+      openUntil = b;
+    } else {
+      openUntil = Math.max(openUntil, b);
+    }
+  }
+  if (Number.isFinite(cursor))
+    total += openUntil - cursor;
+  return total;
+}
+function subtract(spans, claimed) {
+  let free = spans;
+  for (const [ca, cb] of claimed) {
+    const next = [];
+    for (const [a, b] of free) {
+      if (cb <= a || ca >= b) {
+        next.push([a, b]);
+        continue;
+      }
+      if (ca > a)
+        next.push([a, ca]);
+      if (cb < b)
+        next.push([cb, b]);
+    }
+    free = next;
+  }
+  return free;
+}
+function actorSplit(rows, start, end) {
+  const empty = {
+    operatorMs: 0,
+    longestOperatorWaitMs: 0,
+    modelMs: 0,
+    shellMs: 0,
+    subagentMs: 0,
+    otherToolMs: 0,
+    idleMs: 0,
+    compactions: 0,
+    subagentErrors: 0
+  };
+  const window = end - start;
+  if (window <= 0)
+    return empty;
+  const calls = new Map;
+  const results = new Map;
+  const eventTs = [];
+  let compactions = 0;
+  for (const [row, ts] of rows) {
+    if (ts < start || ts > end)
+      continue;
+    eventTs.push(ts);
+    if (isCompaction(row))
+      compactions++;
+    const blocks = Array.isArray(row.message?.content) ? row.message?.content : [];
+    if (row.message?.role === "toolResult" && row.message.toolCallId !== undefined) {
+      results.set(row.message.toolCallId, { ts, isError: row.message.isError === true });
+    }
+    for (const b of blocks) {
+      if ((b.type === "tool_use" || b.type === "toolCall") && b.id !== undefined && b.name !== undefined) {
+        calls.set(b.id, { id: b.id, actor: actorOf(b.name), ts });
+      } else if (b.type === "tool_result" && b.tool_use_id !== undefined) {
+        results.set(b.tool_use_id, { ts, isError: b.is_error === true });
+      }
+    }
+  }
+  let subagentErrors = 0;
+  const resolved = [];
+  for (const call of calls.values()) {
+    const result = results.get(call.id);
+    if (result?.isError === true && call.actor === "subagent")
+      subagentErrors++;
+    resolved.push({ ...call, end: Math.min(result?.ts ?? end, end) });
+  }
+  const claimed = [];
+  const byActor = new Map;
+  for (const actor of ACTOR_PRECEDENCE) {
+    const mine = resolved.filter((r) => r.actor === actor).map((r) => [r.ts, r.end]);
+    const free = subtract(mine, claimed);
+    for (const span of free)
+      claimed.push(span);
+    const ms = unionMs(free, start, end);
+    byActor.set(actor, ms);
+    if (actor === "operator") {
+      empty.longestOperatorWaitMs = Math.max(0, ...mine.map(([a, b]) => b - a));
+    }
+  }
+  const boundaries = [...new Set([start, end, ...eventTs, ...claimed.flat()])].sort((a, b) => a - b);
+  const claimedSorted = [...claimed].sort((a, b) => a[0] - b[0]);
+  let idleMs = 0;
+  for (let i = 0;i < boundaries.length - 1; i++) {
+    const a = boundaries[i];
+    const b = boundaries[i + 1];
+    if (b - a < IDLE_GAP_MS)
+      continue;
+    if (claimedSorted.some(([ca, cb]) => ca < b && cb > a))
+      continue;
+    idleMs += b - a;
+  }
+  const accounted = (byActor.get("operator") ?? 0) + (byActor.get("subagent") ?? 0) + (byActor.get("shell") ?? 0) + (byActor.get("other") ?? 0) + idleMs;
+  return {
+    ...empty,
+    operatorMs: byActor.get("operator") ?? 0,
+    subagentMs: byActor.get("subagent") ?? 0,
+    shellMs: byActor.get("shell") ?? 0,
+    otherToolMs: byActor.get("other") ?? 0,
+    idleMs,
+    modelMs: Math.max(0, window - accounted),
+    compactions,
+    subagentErrors
+  };
+}
+function attemptWindow(attempts) {
+  const starts = attempts.map((a) => Date.parse(a.startedAt ?? "")).filter((n) => !Number.isNaN(n));
+  const ends = attempts.map((a) => Date.parse(a.completedAt ?? "")).filter((n) => !Number.isNaN(n));
+  return starts.length && ends.length ? [Math.min(...starts), Math.max(...ends)] : undefined;
+}
+function summaryRow(stage, status, span, measured) {
+  return {
+    stage,
+    status,
+    workMs: span.workMs,
+    waitMs: span.waitMs,
+    toolCalls: measured ? span.toolCalls : null,
+    tokens: measured ? span.tokens : null,
+    time: formatDuration(span.workMs),
+    wait: formatDuration(span.waitMs),
+    token: formatTokenSplit(measured ? span.tokens : null)
+  };
+}
+function buildRunSummary(lines, inputs, since, until) {
+  const windows = [];
+  for (const { label, progress } of inputs) {
+    const states = (progress.states ?? []).flatMap((s) => {
+      const w = attemptWindow((s.actions ?? []).flatMap((a) => a.attempts ?? []));
+      return w ? [{ s, w }] : [];
+    });
+    if (!states.length)
+      throw new Error(`progress for run ${progress.runId} has no timed attempts`);
+    if (inputs.length === 1) {
+      for (const { s, w } of states) {
+        const stage = (s.visit ?? 1) > 1 ? `${s.state} (visit ${s.visit})` : s.state;
+        windows.push({ stage, status: s.status ?? "", start: w[0], end: w[1] });
+      }
+    } else {
+      const stage = label ?? `${progress.workflow ?? "run"} ${progress.runId.slice(0, 8)}`;
+      const start = Math.min(...states.map(({ w }) => w[0]));
+      windows.push({
+        stage,
+        status: progress.status ?? "",
+        start,
+        end: Math.max(...states.map(({ w }) => w[1]))
+      });
+    }
+  }
+  windows.sort((a, b) => a.start - b.start);
+  const { rows, skippedLines } = parseRows(lines);
+  const measure = (start, end) => {
+    const acc = newAcc(start);
+    for (const [row, ts] of rows)
+      if (ts >= start && ts <= end && promptText(row) === undefined)
+        accumulate(acc, row, ts);
+    const span = {
+      workMs: end - start - acc.askMs,
+      waitMs: acc.askMs,
+      toolCalls: acc.toolIds.size,
+      tokens: sumTokens([...acc.messages.values()])
+    };
+    return { span, measured: acc.toolIds.size > 0 || acc.messages.size > 0 };
+  };
+  const sinceMs = since ? Date.parse(since) : Number.NaN;
+  const totalStart = Number.isNaN(sinceMs) ? Math.min(...windows.map((w) => w.start)) : sinceMs;
+  let totalEnd = Math.max(...windows.map((w) => w.end));
+  if (!Number.isNaN(sinceMs)) {
+    for (const [, ts] of rows)
+      if (ts >= sinceMs)
+        totalEnd = Math.max(totalEnd, ts);
+  }
+  const untilMs = until ? Date.parse(until) : Number.NaN;
+  if (!Number.isNaN(untilMs) && untilMs > totalStart)
+    totalEnd = untilMs;
+  const stageRows = windows.map((w) => {
+    const { span, measured } = measure(w.start, w.end);
+    return summaryRow(w.stage, w.status, span, measured);
+  });
+  const totalMeasure = measure(totalStart, totalEnd);
+  const statuses = [...new Set(inputs.map((i) => i.progress.status ?? ""))].join("/");
+  const total = summaryRow("Total", statuses, totalMeasure.span, totalMeasure.measured);
+  const overlaps = windows.some((w, i) => i > 0 && w.start < (windows[i - 1]?.end ?? 0));
+  const sum = sumSpans(stageRows.map((r) => ({ ...r, toolCalls: r.toolCalls ?? 0, tokens: r.tokens ?? zeroTokens() })));
+  const overhead = {
+    workMs: total.workMs - sum.workMs,
+    waitMs: total.waitMs - sum.waitMs,
+    toolCalls: (total.toolCalls ?? 0) - sum.toolCalls,
+    tokens: Object.fromEntries(Object.keys(sum.tokens).map((k) => [k, (total.tokens?.[k] ?? 0) - sum.tokens[k]]))
+  };
+  if (!overlaps && overhead.workMs > 0)
+    stageRows.push(summaryRow("driver overhead", "", overhead, totalMeasure.measured));
+  return {
+    available: true,
+    rows: stageRows,
+    total,
+    actors: actorSplit(rows, totalStart, totalEnd),
+    gate: { ms: null, reason: "no matching check receipt" },
+    skippedLines
+  };
+}
+function renderSummaryMarkdown(summary) {
+  const line = (r, bold = false) => {
+    const stage = bold ? `**${r.stage}**` : r.stage;
+    return `| ${stage} | ${r.status} | ${r.time} | ${r.wait} | ${r.toolCalls ?? "n/a"} | ${r.token} |`;
+  };
+  const a = summary.actors;
+  const window = summary.total.workMs + summary.total.waitMs;
+  const share = (ms) => window > 0 ? `${Math.round(ms / window * 100)}%` : "n/a";
+  const gate = summary.gate.ms === null ? `n/a (${summary.gate.reason})` : formatDuration(summary.gate.ms);
+  return [
+    "| Stage | Status | Time | Wait | Tool calls | Token (total / non-cached) |",
+    "| --- | --- | ---: | ---: | ---: | ---: |",
+    ...summary.rows.map((r) => line(r)),
+    line(summary.total, true),
+    "",
+    "| Actor | Time | Share |",
+    "| --- | ---: | ---: |",
+    `| operator wait (longest ${formatDuration(a.longestOperatorWaitMs)}) | ${formatDuration(a.operatorMs)} | ${share(a.operatorMs)} |`,
+    `| model | ${formatDuration(a.modelMs)} | ${share(a.modelMs)} |`,
+    `| shell | ${formatDuration(a.shellMs)} | ${share(a.shellMs)} |`,
+    `|   of which gate (informational) | ${gate} | — |`,
+    `| subagent | ${formatDuration(a.subagentMs)} | ${share(a.subagentMs)} |`,
+    `| other tools | ${formatDuration(a.otherToolMs)} | ${share(a.otherToolMs)} |`,
+    `| idle / unattributed | ${formatDuration(a.idleMs)} | ${share(a.idleMs)} |`,
+    "",
+    `Compactions: ${a.compactions} · Subagent errors: ${a.subagentErrors}`
+  ].join(`
+`);
+}
+function writeCloseSummary(run, opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const runDir = join2(cwd, ".spur", "run");
+  const rel = join2(".spur", "run", `${run.runId}-summary.md`);
+  const abs = join2(cwd, rel);
+  const na = (reason) => {
+    mkdirSync(runDir, { recursive: true });
+    writeFileSync(abs, `Execution summary: n/a (${reason})
+`);
+    return rel;
+  };
+  try {
+    if (run.startedAt === undefined)
+      return na("run row has no started_at");
+    const resolved = resolveTranscript(opts.env ?? getEnvVars(), opts.projectsRoot);
+    if (!resolved.ok)
+      return na(resolved.reason);
+    const lines = readFileSync(resolved.path, "utf8").split(`
+`);
+    const summary = buildRunSummary(lines, [{ progress: run.progress }], run.startedAt, run.completedAt);
+    if (summary.rows.length === 0)
+      return na("no timed attempts");
+    mkdirSync(runDir, { recursive: true });
+    writeFileSync(abs, `${renderSummaryMarkdown(summary)}
+`);
+    writeFileSync(join2(runDir, `${run.runId}-summary.json`), JSON.stringify({ ...summary, runId: run.runId, startedAt: run.startedAt, completedAt: run.completedAt }, null, 2));
+    return rel;
+  } catch (error) {
+    return na(error instanceof Error ? error.message : String(error));
+  }
+}
+// plugins/sp/scripts/run-summary.ts
+if (false)
+  ;
+
 // plugins/sp/scripts/inline-run-setup.ts
 function usage() {
   const text = [
     "Usage: bun plugins/sp/scripts/inline-run-setup.ts --run-id <id> --file <definition> [--spur-bin <path>]",
     "       bun plugins/sp/scripts/inline-run-setup.ts --fingerprint --task-file <path> [--feature-file <path>] [--spur-bin <path>]",
-    "       bun plugins/sp/scripts/inline-run-setup.ts --action --run-id <id> --node <state> --kind <kind> --status <done|failed> --ok <true|false> --duration-ms <n> [--estimated] [--spur-bin <path>]",
-    "       bun plugins/sp/scripts/inline-run-setup.ts --actions-file <json-file> --run-id <id> [--spur-bin <path>]  (1007 R5 batch trace emission)",
-    "       bun plugins/sp/scripts/inline-run-setup.ts --close --run-id <id> --status <done|failed|paused> [--reason <terminal-reason>] [--spur-bin <path>]",
+    "       bun plugins/sp/scripts/inline-run-setup.ts --action --run-id <id> --node <state> --kind <kind> --status <done|failed> --ok <true|false> [--duration-ms <n>] [--estimated] [--project-root <path>] [--spur-bin <path>]",
+    "       bun plugins/sp/scripts/inline-run-setup.ts --node-enter --run-id <id> --node <state> [--project-root <path>] [--spur-bin <path>]  (1136 R4: stamps the node enter time)",
+    "       bun plugins/sp/scripts/inline-run-setup.ts --actions-file <json-file> --run-id <id> [--project-root <path>] [--spur-bin <path>]  (1007 R5 batch trace emission)",
+    "       bun plugins/sp/scripts/inline-run-setup.ts --close --run-id <id> --status <done|failed|paused> [--reason <terminal-reason>] [--no-summary] [--project-root <path>] [--spur-bin <path>]",
+    "       --project-root (1136 R1) names the tree that OWNS the run row; without it the run row is read from the cwd tree, and a miss exits 1 with RUN_NOT_FOUND",
+    "       --duration-ms is optional on --action (1136 R4): omitted, the duration is measured from the calling --node-enter; supplied, it records provenance host-reported",
     "       bun plugins/sp/scripts/inline-run-setup.ts --persist-out --from <worktree-path> [--task-file <path>]... [--spur-bin <path>]",
     "       terminal-reason is a closed enum (0937 R2): done, paused-operator, failed-check, failed-agent, failed-timeout, failed-guard, cancelled, interrupted, retry-exhausted",
     "       close defaults (1051 AC1): --status done \u2192 reason done, --status paused \u2192 reason paused-operator; --status failed requires an explicit --reason",
@@ -42,30 +547,20 @@ function resolveAppEntry(spurBin) {
   for (const candidate of candidates) {
     const tokens = candidate.split(/\s+/).filter(Boolean);
     const mainModule = [...tokens].reverse().find((t) => t.endsWith(".ts"));
-    if (mainModule === undefined || !existsSync(mainModule))
+    if (mainModule === undefined || !existsSync3(mainModule))
       continue;
     const repoRoot = resolve(dirname(mainModule), "..", "..", "..");
-    const appEntry = join(repoRoot, "packages", "app", "src", "index.ts");
-    if (existsSync(appEntry))
+    const appEntry = join3(repoRoot, "packages", "app", "src", "index.ts");
+    if (existsSync3(appEntry))
       return { entry: appEntry, portable: false };
   }
   const entry = fileURLToPath(new URL("../lib/inline-run.generated.mjs", import.meta.url));
-  if (!existsSync(entry)) {
+  if (!existsSync3(entry)) {
     throw new Error("inline application bundle is missing \u2014 rebuild/install the sp plugin before running inline");
   }
   return { entry, portable: true };
 }
-var TERMINAL_REASONS = new Set([
-  "done",
-  "paused-operator",
-  "failed-check",
-  "failed-agent",
-  "failed-timeout",
-  "failed-guard",
-  "cancelled",
-  "interrupted",
-  "retry-exhausted"
-]);
+var SETUP_EXPORTS = ["readInstalledInventory", "runInlineRunSetup", "writeInlineRunOutcome"];
 async function main() {
   if (!process.versions.bun) {
     const child = spawnSync("bun", [fileURLToPath(import.meta.url), ...process.argv.slice(2)], {
@@ -76,7 +571,7 @@ async function main() {
     process.exit(child.status ?? 1);
   }
   const flags = new Map;
-  let fingerprint = false, action = false, close = false, decide = false, persistOut = false, estimated = false;
+  let fingerprint = false, action = false, close = false, decide = false, persistOut = false, nodeEnter = false, estimated = false, noSummary = false;
   const taskFiles = [];
   let spurBin = getEnvVar("SPUR_BIN") ?? "";
   const argv = process.argv.slice(2);
@@ -90,10 +585,14 @@ async function main() {
       close = true;
     else if (flag === "--decide")
       decide = true;
+    else if (flag === "--node-enter")
+      nodeEnter = true;
     else if (flag === "--persist-out")
       persistOut = true;
     else if (flag === "--estimated")
       estimated = true;
+    else if (flag === "--no-summary")
+      noSummary = true;
     else if (flag === "--task-file")
       taskFiles.push(argv[++i] ?? "");
     else if (flag === "--spur-bin")
@@ -108,6 +607,7 @@ async function main() {
   const optionsJson = flags.get("--options-json") ?? "";
   const node = flags.get("--node") ?? "";
   const kind = flags.get("--kind") ?? "";
+  const projectRoot = flags.get("--project-root") ?? "";
   const status = flags.get("--status") ?? "";
   const reason = flags.get("--reason") ?? "";
   const okRaw = flags.get("--ok") ?? "";
@@ -115,24 +615,14 @@ async function main() {
   const actionsFile = flags.get("--actions-file") ?? "";
   if (estimated && !action)
     usage();
+  if (noSummary && !close)
+    usage();
   if (fingerprint) {
     if (runId !== "" || file !== "" || taskFiles.length !== 1 || (taskFiles[0] ?? "").trim() === "")
       usage();
-    const app2 = await import(resolveAppEntry(spurBin).entry);
+    const { app: app2 } = await loadInlineApp(spurBin, resolveAppEntry, ["runInlineRunFingerprint"]);
     process.exit(await app2.runInlineRunFingerprint({ taskFile: taskFiles[0] ?? "", featureFile }));
   }
-  if (actionsFile !== "") {
-    if (action || close || fingerprint || decide || persistOut || file !== "" || taskFiles.length > 0)
-      usage();
-    if (runId.trim() === "" || status !== "" || node !== "" || kind !== "")
-      usage();
-    if (okRaw !== "" || durationRaw !== "")
-      usage();
-    if (!SAFE_RUN_ID_RE.test(runId))
-      refuseUnsafeRunId(runId);
-    const app2 = await import(resolveAppEntry(spurBin).entry);
-    process.exit(await app2.runInlineRunTraceBatch({ runId, actionsFile }));
-  }
   if (decide) {
     if (action || close || fingerprint || file !== "" || taskFiles.length > 0)
       usage();
@@ -141,12 +631,14 @@ async function main() {
     if (!SAFE_RUN_ID_RE.test(runId))
       refuseUnsafeRunId(runId);
     try {
-      const { entry: entry2, portable: portable2 } = resolveAppEntry(spurBin);
-      const app2 = await import(entry2);
-      const bundlePath = fileURLToPath(new URL("../lib/inline-run.generated.mjs", import.meta.url));
-      const lib = await import(bundlePath);
-      const enabled = await lib.resolveDecideDecisionMakerEnabled(process.cwd(), portable2 ? { embeddedSchemas: lib.EMBEDDED_SPUR_SCHEMAS } : undefined);
-      process.exit(await app2.runInlineRunDecide({ runId, node, optionsFile: optionsJson, enabled }));
+      const { app: app2, portable: portable2 } = await loadInlineApp(spurBin, resolveAppEntry, ["runInlineRunDecide"]);
+      const { app: lib } = await loadInlineApp(spurBin, () => ({ entry: fileURLToPath(new URL("../lib/inline-run.generated.mjs", import.meta.url)), portable: portable2 }), ["resolveDecideDecisionMakerEnabled", "loadSpurConfig"]);
+      const loadOpts = portable2 ? { embeddedSchemas: lib.EMBEDDED_SPUR_SCHEMAS } : undefined;
+      const [enabled, spurConfig] = await Promise.all([
+        lib.resolveDecideDecisionMakerEnabled(process.cwd(), loadOpts),
+        lib.loadSpurConfig(process.cwd(), loadOpts)
+      ]);
+      process.exit(await app2.runInlineRunDecide({ runId, node, optionsFile: optionsJson, enabled, spurConfig }));
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       process.stdout.write(`${JSON.stringify({ ok: false, runId, error: message })}
@@ -159,59 +651,38 @@ async function main() {
       usage();
     if (from.trim() === "" || taskFiles.some((taskFile) => taskFile.trim() === ""))
       usage();
-    const app2 = await import(resolveAppEntry(spurBin).entry);
+    const { app: app2 } = await loadInlineApp(spurBin, resolveAppEntry, ["runInlineRunPersistOut"]);
     process.exit(await app2.runInlineRunPersistOut({ from, taskFiles }));
   }
-  if (action || close) {
-    if (action && close)
-      usage();
-    if (runId.trim() === "" || status.trim() === "")
-      usage();
+  if (nodeEnter || actionsFile !== "" || action || close) {
     if (!SAFE_RUN_ID_RE.test(runId))
       refuseUnsafeRunId(runId);
-    const app2 = await import(resolveAppEntry(spurBin).entry);
-    if (close) {
-      if (!app2.isInlineRunCloseStatus(status))
-        usage();
-      if (reason.trim() === "" ? status === "failed" : !TERMINAL_REASONS.has(reason))
-        usage();
-      process.exit(await app2.runInlineRunTrace({
-        runId,
-        close: true,
-        node: "",
-        kind: "",
-        status,
-        ok: true,
-        durationMs: 0,
-        ...reason.trim() === "" ? {} : { reason }
-      }));
-    }
-    if (node.trim() === "" || kind.trim() === "")
-      usage();
-    if (!app2.isInlineRunActionStatus(status))
-      usage();
-    if (okRaw !== "true" && okRaw !== "false")
-      usage();
-    const durationMs = Number(durationRaw);
-    if (durationRaw.trim() === "" || !Number.isFinite(durationMs) || durationMs < 0)
-      usage();
-    process.exit(await app2.runInlineRunTrace({
+    const mode = nodeEnter ? "node-enter" : actionsFile !== "" ? "actions-file" : close ? "close" : "action";
+    const { app: app2 } = await loadInlineApp(spurBin, resolveAppEntry, ["runInlineRunTraceMode"]);
+    const code = await app2.runInlineRunTraceMode({
+      mode,
       runId,
-      close: false,
       node,
       kind,
       status,
-      ok: okRaw === "true",
-      durationMs,
-      ...estimated ? { estimated: true } : {}
-    }));
+      reason,
+      ok: okRaw,
+      durationMs: durationRaw,
+      actionsFile,
+      projectRoot,
+      estimated,
+      noSummary,
+      ...noSummary ? {} : { summarize: async (run) => writeCloseSummary(run) }
+    });
+    if (code === 2)
+      usage();
+    process.exit(code);
   }
   if (runId.trim() === "" || file.trim() === "")
     usage();
   if (!SAFE_RUN_ID_RE.test(runId))
     refuseUnsafeRunId(runId);
-  const { entry, portable } = resolveAppEntry(spurBin);
-  const app = await import(entry);
+  const { app, portable } = await loadInlineApp(spurBin, resolveAppEntry, SETUP_EXPORTS);
   let inventory;
   try {
     inventory = await app.readInstalledInventory({