@gobing-ai/spur 0.4.7 → 0.4.9

package/plugins/sp/scripts/run-summary.ts

@@ -1,107 +0,0 @@
-#!/usr/bin/env bun
-/**
- * run-summary — the measured execution summary `/sp:dev-run` and `/sp:dev-runall` print by default
- * (`--no-summary` skips it). Inputs: one or more `spur workflow progress <run-id> --json` files
- * (`--progress [<label>=]<file>`) and the host transcript (resolved like session-timeline, or
- * `--transcript`), OR the close-written per-run summary files (`--rollup [<label>=]<file>`, 1146 R3).
- * Measurement lives in `packages/app/src/workflow/run-summary.ts` (reached through the generated
- * pure bundle entry); presentation and host IO live in `../lib/run-summary-core` (ADR-130 glue
- * budget). This script is argv parsing and dispatch. Reporting only: no transcript or no timed
- * attempts → an `n/a` result, exit 0. Node builtins only.
- */
-import { readFileSync } from 'node:fs';
-import { getEnvVars } from '../lib/env';
-import {
-    buildRunSummary,
-    gateFromReceipt,
-    type Progress,
-    type RollupInput,
-    renderRollupMarkdown,
-    renderSummaryMarkdown,
-} from '../lib/run-summary-core';
-import { parseRows, resolveTranscript } from '../lib/transcript';
-
-// Re-exported so the suite and any consumer keep one import path for the whole surface.
-export * from '../lib/run-summary-core';
-
-export const RUN_SUMMARY_USAGE =
-    'usage: run-summary (--progress [<label>=]<file> [--progress ...] | --rollup [<label>=]<summary.json> [--rollup ...]) [--transcript <path>] [--since <iso>] [--markdown]';
-
-export function main(
-    argv: string[],
-    env: Record<string, string | undefined> = getEnvVars(),
-    write: (s: string) => void = (s) => process.stdout.write(s),
-    projectsRoot?: string,
-): number {
-    let transcript: string | undefined;
-    let since: string | undefined;
-    let markdown = false;
-    const progressArgs: string[] = [];
-    const rollupArgs: string[] = [];
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg === '--transcript' && argv[i + 1]) transcript = argv[++i];
-        else if (arg === '--progress' && argv[i + 1]) progressArgs.push(argv[++i] as string);
-        else if (arg === '--rollup' && argv[i + 1]) rollupArgs.push(argv[++i] as string);
-        else if (arg === '--since' && argv[i + 1]) since = argv[++i];
-        else if (arg === '--markdown') markdown = true;
-        else if (arg === '--spur-bin' && argv[i + 1])
-            i++; // 0482 R2: accepted, unused (no spur calls)
-        else {
-            process.stderr.write(`${RUN_SUMMARY_USAGE}\n`);
-            return 2;
-        }
-    }
-    // 1146 AC5: --rollup is a different mode — it reads close-written summary files and never
-    // re-measures, so combining it with a measurement source is a usage error.
-    if (rollupArgs.length > 0 && (progressArgs.length > 0 || since !== undefined || transcript !== undefined)) {
-        process.stderr.write(`${RUN_SUMMARY_USAGE}\n`);
-        return 2;
-    }
-    if (rollupArgs.length > 0) {
-        try {
-            const inputs: RollupInput[] = rollupArgs.map((arg) => {
-                const eq = arg.indexOf('=');
-                const [label, file] = eq > 0 ? [arg.slice(0, eq), arg.slice(eq + 1)] : [undefined, arg];
-                const summary = JSON.parse(readFileSync(file as string, 'utf8')) as RollupInput['summary'];
-                return { label: label ?? summary.runId ?? (file as string), summary };
-            });
-            write(`${renderRollupMarkdown(inputs)}\n`);
-            return 0;
-        } catch (error) {
-            process.stderr.write(`run-summary: ${(error as Error).message}\n`);
-            return 2;
-        }
-    }
-    if (!progressArgs.length) {
-        process.stderr.write(`${RUN_SUMMARY_USAGE}\n`);
-        return 2;
-    }
-    const resolved = resolveTranscript(env, projectsRoot, transcript);
-    if (!resolved.ok) {
-        const out = markdown
-            ? `Execution summary: n/a (${resolved.reason})`
-            : JSON.stringify({ available: false, reason: resolved.reason });
-        write(`${out}\n`);
-        return 0;
-    }
-    try {
-        const inputs = progressArgs.map((arg) => {
-            const eq = arg.indexOf('=');
-            const [label, file] = eq > 0 ? [arg.slice(0, eq), arg.slice(eq + 1)] : [undefined, arg];
-            return { label, progress: JSON.parse(readFileSync(file, 'utf8')) as Progress };
-        });
-        const { rows, skippedLines } = parseRows(readFileSync(resolved.path, 'utf8').split('\n'));
-        const summary = buildRunSummary(rows, inputs, { since, skippedLines });
-        summary.gate = gateFromReceipt(process.cwd(), inputs[0]?.progress.runId ?? '');
-        write(
-            `${markdown ? renderSummaryMarkdown(summary) : JSON.stringify({ ...summary, transcript: resolved.path })}\n`,
-        );
-        return 0;
-    } catch (error) {
-        process.stderr.write(`run-summary: ${(error as Error).message}\n`);
-        return 2;
-    }
-}
-
-if (import.meta.main) process.exit(main(process.argv.slice(2)));

package/plugins/sp/scripts/script-root.mjs

@@ -1,129 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/script-root.ts
-import { spawnSync } from "child_process";
-import { createHash } from "crypto";
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-
-// plugins/sp/lib/env.ts
-function getEnvVars() {
-  return process.env;
-}
-
-// plugins/sp/scripts/script-root.ts
-var SOURCE_REPO_MARKER = join("config", "plugin-scripts.json");
-var PROJECT_SCRIPTS_DIR = join("plugins", "sp", "scripts");
-var SCRIPT_ROOT_TWIN_REL = "script-root.mjs";
-function defaultResolveScript(cwd) {
-  return (rel) => {
-    const run = spawnSync("superskill", ["script", "path", "sp", rel, "--json"], {
-      cwd,
-      encoding: "utf8",
-      env: getEnvVars()
-    });
-    if (run.status !== 0 || !run.stdout)
-      return null;
-    const lastLine = run.stdout.trim().split(`
-`).pop() ?? "";
-    try {
-      const parsed = JSON.parse(lastLine);
-      return typeof parsed.path === "string" && parsed.path.length > 0 ? parsed : null;
-    } catch {
-      return null;
-    }
-  };
-}
-function digestScriptSet(dir, cwd) {
-  const abs = cwd ? join(cwd, dir) : dir;
-  const names = readdirSync(abs).filter((name) => {
-    try {
-      return statSync(join(abs, name)).isFile();
-    } catch {
-      return false;
-    }
-  }).sort();
-  const list = names.map((name) => `${name}:${createHash("sha256").update(readFileSync(join(abs, name))).digest("hex")}`);
-  return `sha256:${createHash("sha256").update(list.join(`
-`)).digest("hex")}`;
-}
-function runScriptRoot(env, options = {}) {
-  const cwd = options.cwd;
-  const runId = env.__runId ?? env.runId ?? "";
-  const relResult = join(".spur", "run", `${runId}-script-root.json`);
-  const abs = (p) => cwd ? join(cwd, p) : p;
-  const warn = options.warn ?? ((message) => void process.stderr.write(`${message}
-`));
-  mkdirSync(abs(join(".spur", "run")), { recursive: true });
-  const write = (row) => {
-    writeFileSync(abs(relResult), `${JSON.stringify(row)}
-`);
-    return { ...row, resultFile: relResult, exitCode: 0 };
-  };
-  if (existsSync(abs(SOURCE_REPO_MARKER))) {
-    try {
-      return write({
-        mode: "source-repo",
-        source: "project",
-        dir: PROJECT_SCRIPTS_DIR,
-        scriptSetDigest: digestScriptSet(PROJECT_SCRIPTS_DIR, cwd)
-      });
-    } catch (error) {
-      return write({ mode: "unresolved", error: `source-repo digest failed: ${String(error)}` });
-    }
-  }
-  if (existsSync(abs(PROJECT_SCRIPTS_DIR))) {
-    warn(`script-root: ignoring vendored ${PROJECT_SCRIPTS_DIR}/ (no ${SOURCE_REPO_MARKER} marker) \u2014 ` + `steps resolve the installed twin via 'superskill script path sp <rel>'`);
-  }
-  const resolve = options.resolveScript ?? defaultResolveScript(cwd);
-  const resolved = resolve(SCRIPT_ROOT_TWIN_REL);
-  if (!resolved?.path) {
-    return write({
-      mode: "unresolved",
-      error: `'superskill script path sp ${SCRIPT_ROOT_TWIN_REL}' resolved nothing`
-    });
-  }
-  const dir = dirname(resolved.path);
-  try {
-    return write({
-      mode: "installed",
-      source: resolved.source ?? "unknown",
-      dir,
-      scriptSetDigest: digestScriptSet(dir)
-    });
-  } catch (error) {
-    return write({ mode: "unresolved", error: `installed digest failed: ${String(error)}` });
-  }
-}
-var SCRIPT_ROOT_USAGE = "usage: script-root --run-id <id> [--spur-bin <path>]";
-function main(argv, env = getEnvVars(), options = {}) {
-  let runId = env.__runId ?? "";
-  for (let i = 0;i < argv.length; i++) {
-    if (argv[i] === "--run-id") {
-      runId = argv[i + 1] ?? "";
-      i++;
-      continue;
-    }
-    if (argv[i] === "--spur-bin") {
-      i++;
-      continue;
-    }
-    process.stderr.write(`${SCRIPT_ROOT_USAGE}
-`);
-    return 2;
-  }
-  return runScriptRoot({ ...env, __runId: runId }, options).exitCode;
-}
-{
-  process.exit(main(process.argv.slice(2)));
-}
-export {
-  PROJECT_SCRIPTS_DIR,
-  SCRIPT_ROOT_TWIN_REL,
-  SCRIPT_ROOT_USAGE,
-  SOURCE_REPO_MARKER,
-  digestScriptSet,
-  main,
-  runScriptRoot
-};

package/plugins/sp/scripts/script-root.ts

@@ -1,199 +0,0 @@
-#!/usr/bin/env bun
-/**
- * script-root — run-start script-resolution identity for the sp pipelines (task 0960 R2).
- *
- * WHY: the pipeline YAML ships to every consumer, but its script probes resolved
- * `plugins/sp/scripts/` **project-first**. A consumer that hand-vendored a stale copy then ran
- * a different revision than the installed twin, mixing revisions across steps that write and
- * read the same cross-step artifacts (status files, verdicts, proof digests). The probe is
- * dogfooding-only, so it is now gated on `config/plugin-scripts.json` — a marker that lives
- * outside `plugins/sp/`, so copying the plugin tree cannot reproduce it.
- *
- * This script records *which* tree a run resolved, once, before any step executes:
- *   `.spur/run/<runId>-script-root.json`  `{ mode, source, dir, scriptSetDigest }`
- *
- * - `source-repo` — the marker is present; the project's live `plugins/sp/scripts/` is the
- *   resolved tree (the dogfood path).
- * - `installed` — no marker; the tree is `dirname(superskill script path sp script-root.mjs
- *   --json .path)`, with `source` from the same probe. One stderr warning names a dead
- *   vendored `plugins/sp/scripts/` dir that is no longer executed.
- * - `unresolved` — nothing resolved. Written with an `error` and **exit 0**: a missing
- *   optional script must stay a per-step fail-closed outcome, never a run-wide abort (R3).
- *
- * `scriptSetDigest` is one sha256 over the sorted `name:sha256` list of the resolved dir's
- * regular files (non-recursive) — the installed staging has no version file, so this answers
- * "which revision produced this run?" without a Superskill change.
- *
- * Node/bun builtins and the vendored `../lib/env` gateway only — bundled standalone by
- * `superskill install`, so no `@gobing-ai/*` value imports (task 0669).
- */
-
-import { spawnSync } from 'node:child_process';
-import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { getEnvVars } from '../lib/env';
-
-export type ScriptRootMode = 'source-repo' | 'installed' | 'unresolved';
-
-export interface ScriptRoot {
-    mode: ScriptRootMode;
-    source?: string;
-    dir?: string;
-    scriptSetDigest?: string;
-    error?: string;
-}
-
-export interface ScriptRootResult extends ScriptRoot {
-    resultFile: string;
-    exitCode: number;
-}
-
-export interface ScriptRootEnv {
-    __runId?: string;
-    [key: string]: string | undefined;
-}
-
-/** Resolved script descriptor from `superskill script path sp <rel> --json`. */
-export interface ResolvedScript {
-    path?: string;
-    source?: string;
-}
-
-export interface ScriptRootOptions {
-    /** Base directory for `.spur/run` and the project marker; defaults to process cwd. */
-    cwd?: string;
-    /** Test seam: run `superskill script path sp script-root.mjs --json`. */
-    resolveScript?: (rel: string) => ResolvedScript | null;
-    /** Test seam: the one-warning sink. */
-    warn?: (message: string) => void;
-}
-
-/** Marker that identifies the Spur source repo (owned by script-contract-check, outside plugins/sp). */
-export const SOURCE_REPO_MARKER = join('config', 'plugin-scripts.json');
-/** The project-first tree the dogfood probes execute. */
-export const PROJECT_SCRIPTS_DIR = join('plugins', 'sp', 'scripts');
-/** The rel the installed twin resolves under (its own staging name). */
-export const SCRIPT_ROOT_TWIN_REL = 'script-root.mjs';
-
-function defaultResolveScript(cwd?: string): (rel: string) => ResolvedScript | null {
-    return (rel: string): ResolvedScript | null => {
-        const run = spawnSync('superskill', ['script', 'path', 'sp', rel, '--json'], {
-            cwd,
-            encoding: 'utf8',
-            env: getEnvVars(),
-        });
-        if (run.status !== 0 || !run.stdout) return null;
-        const lastLine = run.stdout.trim().split('\n').pop() ?? '';
-        try {
-            const parsed = JSON.parse(lastLine) as ResolvedScript;
-            return typeof parsed.path === 'string' && parsed.path.length > 0 ? parsed : null;
-        } catch {
-            return null;
-        }
-    };
-}
-
-/** sha256 over the sorted `name:sha256` list of `dir`'s regular files (non-recursive). */
-export function digestScriptSet(dir: string, cwd?: string): string {
-    const abs = cwd ? join(cwd, dir) : dir;
-    const names = readdirSync(abs)
-        .filter((name) => {
-            try {
-                return statSync(join(abs, name)).isFile();
-            } catch {
-                return false;
-            }
-        })
-        .sort();
-    const list = names.map(
-        (name) =>
-            `${name}:${createHash('sha256')
-                .update(readFileSync(join(abs, name)))
-                .digest('hex')}`,
-    );
-    return `sha256:${createHash('sha256').update(list.join('\n')).digest('hex')}`;
-}
-
-/**
- * Resolve the run's script root and write `.spur/run/<runId>-script-root.json`.
- * Never aborts: every failure is recorded as `mode: "unresolved"` with exit 0 (R3).
- */
-export function runScriptRoot(env: ScriptRootEnv, options: ScriptRootOptions = {}): ScriptRootResult {
-    const cwd = options.cwd;
-    const runId = env.__runId ?? env.runId ?? '';
-    const relResult = join('.spur', 'run', `${runId}-script-root.json`);
-    const abs = (p: string): string => (cwd ? join(cwd, p) : p);
-    const warn = options.warn ?? ((message: string): void => void process.stderr.write(`${message}\n`));
-    mkdirSync(abs(join('.spur', 'run')), { recursive: true });
-
-    const write = (row: ScriptRoot): ScriptRootResult => {
-        writeFileSync(abs(relResult), `${JSON.stringify(row)}\n`);
-        return { ...row, resultFile: relResult, exitCode: 0 };
-    };
-
-    // Source repo: the project's live tree is the resolved tree (R6).
-    if (existsSync(abs(SOURCE_REPO_MARKER))) {
-        try {
-            return write({
-                mode: 'source-repo',
-                source: 'project',
-                dir: PROJECT_SCRIPTS_DIR,
-                scriptSetDigest: digestScriptSet(PROJECT_SCRIPTS_DIR, cwd),
-            });
-        } catch (error) {
-            return write({ mode: 'unresolved', error: `source-repo digest failed: ${String(error)}` });
-        }
-    }
-
-    // Installed: resolve the twin, and name a dead vendored dir that is no longer executed.
-    if (existsSync(abs(PROJECT_SCRIPTS_DIR))) {
-        warn(
-            `script-root: ignoring vendored ${PROJECT_SCRIPTS_DIR}/ (no ${SOURCE_REPO_MARKER} marker) — ` +
-                `steps resolve the installed twin via 'superskill script path sp <rel>'`,
-        );
-    }
-    const resolve = options.resolveScript ?? defaultResolveScript(cwd);
-    const resolved = resolve(SCRIPT_ROOT_TWIN_REL);
-    if (!resolved?.path) {
-        return write({
-            mode: 'unresolved',
-            error: `'superskill script path sp ${SCRIPT_ROOT_TWIN_REL}' resolved nothing`,
-        });
-    }
-    const dir = dirname(resolved.path);
-    try {
-        return write({
-            mode: 'installed',
-            source: resolved.source ?? 'unknown',
-            dir,
-            scriptSetDigest: digestScriptSet(dir),
-        });
-    } catch (error) {
-        return write({ mode: 'unresolved', error: `installed digest failed: ${String(error)}` });
-    }
-}
-
-export const SCRIPT_ROOT_USAGE = 'usage: script-root --run-id <id> [--spur-bin <path>]';
-
-export function main(argv: string[], env: ScriptRootEnv = getEnvVars(), options: ScriptRootOptions = {}): number {
-    let runId = env.__runId ?? '';
-    for (let i = 0; i < argv.length; i++) {
-        if (argv[i] === '--run-id') {
-            runId = argv[i + 1] ?? '';
-            i++;
-            continue;
-        }
-        if (argv[i] === '--spur-bin') {
-            i++;
-            continue;
-        }
-        process.stderr.write(`${SCRIPT_ROOT_USAGE}\n`);
-        return 2;
-    }
-    return runScriptRoot({ ...env, __runId: runId }, options).exitCode;
-}
-
-if (import.meta.main) {
-    process.exit(main(process.argv.slice(2)));
-}