@gobing-ai/spur 0.4.7 → 0.4.9

package/plugins/sp/scripts/history-anatomy-cache.ts

@@ -1,247 +0,0 @@
-#!/usr/bin/env bun
-/**
- * history-anatomy-cache — CLI glue (task 1005 R4, ADR-130 lib rule) for the history-anatomy
- * report cache (feature I8, HA-S1 0659 / ADR-079): eight verbs, byte-identical argv/stdout/exit.
- * Logic lives in packages/app/src/services/history-anatomy.ts, reached through the generated
- * standalone bundle `plugins/sp/lib/history-anatomy.generated.mjs`; twin runs under bare `node`
- * (`bun run build:scripts`).
- */
-import { spawnSync } from 'node:child_process';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import * as core from '../lib/history-anatomy.generated.mjs';
-
-export * from '../lib/history-anatomy.generated.mjs';
-
-const VALID_COMMANDS = 'digest, check, paths, assert-clean, probe, stamp, refresh, publish';
-const PROBE_USAGE =
-    '<script> probe --artifact <a.json> --target <report.md> [--baseline <b.json>] [--mode daily|ad-hoc] ' +
-    '[--date <YYYY-MM-DD>] [--recompute true] [--out <prov.json>] [--skill-dir <d>] [--contract <f>] [--workflow <f>] [--helper <f>]';
-
-/** `--key value` / `--flag` → record. Bare flags become `"true"` so `--recompute` needs no value. */
-function parseFlags(args: string[]): Record<string, string | undefined> {
-    const out: Record<string, string | undefined> = {};
-    for (let i = 0; i < args.length; i++) {
-        const a = args[i] ?? '';
-        if (!a.startsWith('--')) continue;
-        const key = a.slice(2);
-        const next = args[i + 1];
-        if (next === undefined || next.startsWith('--')) {
-            out[key] = 'true';
-        } else {
-            out[key] = next;
-            i++;
-        }
-    }
-    return out;
-}
-
-/**
- * Run the CLI with captured stdout/stderr (data, not process side-effects) so unit tests invoke
- * it in-process without leaking into the test runner's own output.
- */
-export function runCacheCli(argv: string[]): core.CacheCliResult {
-    const [cmd, a, b] = argv;
-    switch (cmd) {
-        case 'digest': {
-            if (a === undefined) {
-                return { exitCode: 1, stdout: '', stderr: 'usage: <script> digest <artifact.json>\n' };
-            }
-            let artifact: unknown;
-            try {
-                artifact = JSON.parse(readFileSync(a, 'utf8'));
-            } catch {
-                return { exitCode: 1, stdout: '', stderr: `could not parse artifact at ${a}\n` };
-            }
-            const digest = core.semanticArtifactDigest(artifact);
-            return { exitCode: 0, stdout: `${digest}\n`, stderr: '' };
-        }
-        case 'check': {
-            if (a === undefined) {
-                return { exitCode: 1, stdout: '', stderr: 'usage: <script> check <report.md>\n' };
-            }
-            const result = core.checkReportStructure(readFileSync(a, 'utf8'));
-            const stdout = `${result.ok ? 'PASS' : 'FAIL'}\n${result.problems.map((p) => `- ${p}\n`).join('')}`;
-            return { exitCode: result.ok ? 0 : 1, stdout, stderr: '' };
-        }
-        case 'publish': {
-            if (a === undefined || b === undefined) {
-                return { exitCode: 1, stdout: '', stderr: 'usage: <script> publish <candidate.md> <target.md>\n' };
-            }
-            core.publishAtomically(a, b);
-            return { exitCode: 0, stdout: '', stderr: '' };
-        }
-        case 'assert-clean': {
-            // 0676 R3: fingerprint diff around a model stage. `--baseline` holds the
-            // pre-stage `git status --porcelain`; every path present now but absent there
-            // must be one of the stage's declared outputs, else exit 1 naming each.
-            const f = parseFlags(argv.slice(1));
-            if (f.baseline === undefined) {
-                return {
-                    exitCode: 1,
-                    stdout: '',
-                    stderr: 'usage: <script> assert-clean --baseline <porcelain.txt> [--expect <path>]...\n',
-                };
-            }
-            const expects = new Set<string>();
-            for (const arg of argv.slice(1)) {
-                if (arg.startsWith('--expect=')) expects.add(arg.slice('--expect='.length));
-            }
-            let now: string;
-            try {
-                now =
-                    spawnSync('git', ['status', '--porcelain'], {
-                        encoding: 'utf8',
-                        ...(f.cwd !== undefined ? { cwd: f.cwd } : {}),
-                    }).stdout ?? '';
-            } catch {
-                return { exitCode: 0, stdout: '', stderr: 'assert-clean: git unavailable; skipped\n' };
-            }
-            const undeclared = core.diffPorcelain(readFileSync(f.baseline, 'utf8'), now, expects);
-            if (undeclared.length > 0) {
-                return {
-                    exitCode: 1,
-                    stdout: '',
-                    stderr: undeclared.map((p) => `undeclared write: ${p}\n`).join(''),
-                };
-            }
-            return { exitCode: 0, stdout: 'clean\n', stderr: '' };
-        }
-        case 'paths': {
-            const f = parseFlags(argv.slice(1));
-            if (f.helper === undefined || f.out === undefined) {
-                return {
-                    exitCode: 1,
-                    stdout: '',
-                    stderr: 'usage: <script> paths --helper <p> --out <env> [--report-dir <d>] [--date <d>] [--output <p>] [--mode <m>] [--since <s>] [--until <u>] [--focus <text>] [--recompute true|false] [--run-id <id>]\n',
-                };
-            }
-            const v = core.validateSelector({
-                mode: f.mode,
-                date: f.date,
-                since: f.since,
-                until: f.until,
-                focus: f.focus,
-                recompute: f.recompute,
-                output: f.output,
-            });
-            if (!v.ok) return { exitCode: 1, stdout: '', stderr: `${v.errors.join('\n')}\n` };
-            const env = core.resolvePaths({
-                helper: f.helper,
-                reportDir: f['report-dir'] ?? 'docs/report',
-                date: f.date,
-                output: f.output,
-                mode: v.mode,
-                since: f.since,
-                until: f.until,
-            });
-            writeFileSync(f.out, env);
-            // 0920: run-scoped selector observation artifact — written only after successful
-            // validation; historical selector files have incompatible shapes and are not consumed.
-            if (f['run-id'] !== undefined && f['run-id'] !== '') {
-                mkdirSync('.spur/run', { recursive: true });
-                const envVars = Object.fromEntries(
-                    env
-                        .trim()
-                        .split('\n')
-                        .map((l) => [l.slice(0, l.indexOf('=')), l.slice(l.indexOf('=') + 1)]),
-                );
-                const tz = Intl.DateTimeFormat().resolvedOptions().timeZone ?? 'UTC';
-                writeFileSync(
-                    `.spur/run/${f['run-id']}-selector.json`,
-                    `${JSON.stringify(
-                        {
-                            mode: v.mode,
-                            date: envVars.HA_DATE ?? null,
-                            focus: v.focus,
-                            since: envVars.HA_SINCE ?? null,
-                            until: envVars.HA_UNTIL ?? null,
-                            timezone: tz,
-                        },
-                        null,
-                        2,
-                    )}\n`,
-                );
-            }
-            return { exitCode: 0, stdout: '', stderr: '' };
-        }
-        case 'probe': {
-            const f = parseFlags(argv.slice(1));
-            if (f.artifact === undefined || f.target === undefined) {
-                return { exitCode: 1, stdout: '', stderr: `usage: ${PROBE_USAGE}\n` };
-            }
-            let result: ReturnType<typeof core.probe>;
-            try {
-                result = core.probe({
-                    artifact: f.artifact,
-                    target: f.target,
-                    baseline: f.baseline,
-                    mode: f.mode === 'ad-hoc' ? 'ad-hoc' : 'daily',
-                    date: f.date,
-                    recompute: f.recompute === 'true',
-                    executor: f.executor,
-                    model: f.model,
-                    skillDir: f['skill-dir'],
-                    contractFile: f.contract,
-                    workflowFile: f.workflow,
-                    helperFile: f.helper,
-                    contractVersion: f['contract-version'],
-                    runId: f['run-id'],
-                    spurVersion: f['spur-version'],
-                });
-            } catch {
-                return { exitCode: 1, stdout: '', stderr: `could not read artifact at ${f.artifact}\n` };
-            }
-            if (f.out !== undefined) writeFileSync(f.out, `${JSON.stringify(result.current, null, 2)}\n`);
-            const reasons = result.decision.reasons.map((r) => `- ${r}\n`).join('');
-            return { exitCode: 0, stdout: `${result.decision.disposition}\n${reasons}`, stderr: '' };
-        }
-        case 'stamp': {
-            const f = parseFlags(argv.slice(1));
-            if (f.candidate === undefined || f.provenance === undefined || f.out === undefined) {
-                return {
-                    exitCode: 1,
-                    stdout: '',
-                    stderr: 'usage: <script> stamp --candidate <c.md> --provenance <p.json> --out <o.md>\n',
-                };
-            }
-            try {
-                const p = JSON.parse(readFileSync(f.provenance, 'utf8')) as core.CacheProvenance;
-                writeFileSync(f.out, `${core.stampReport(readFileSync(f.candidate, 'utf8'), p)}\n`);
-            } catch {
-                return { exitCode: 1, stdout: '', stderr: 'stamp: could not read candidate or provenance\n' };
-            }
-            return { exitCode: 0, stdout: '', stderr: '' };
-        }
-        case 'refresh': {
-            const f = parseFlags(argv.slice(1));
-            if (f.report === undefined || f.out === undefined) {
-                return {
-                    exitCode: 1,
-                    stdout: '',
-                    stderr: 'usage: <script> refresh --report <published.md> --out <o.md> [--disposition hit]\n',
-                };
-            }
-            try {
-                const disposition = (f.disposition ?? 'hit') as core.CacheDisposition;
-                const refreshed = core.refreshReport(
-                    readFileSync(f.report, 'utf8'),
-                    f['validated-at'] ?? new Date().toISOString(),
-                    disposition,
-                );
-                writeFileSync(f.out, refreshed.endsWith('\n') ? refreshed : `${refreshed}\n`);
-            } catch {
-                return { exitCode: 1, stdout: '', stderr: `refresh: could not read report at ${f.report}\n` };
-            }
-            return { exitCode: 0, stdout: '', stderr: '' };
-        }
-        default:
-            return { exitCode: 1, stdout: '', stderr: `valid commands: ${VALID_COMMANDS}\n` };
-    }
-}
-
-if (import.meta.main) {
-    const { exitCode, stdout, stderr } = runCacheCli(process.argv.slice(2));
-    process.stdout.write(stdout);
-    process.stderr.write(stderr);
-    process.exitCode = exitCode;
-}

package/plugins/sp/scripts/idea-handoff.mjs

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/lib/env.ts
-function getEnvVars() {
-  return process.env;
-}
-
-// plugins/sp/scripts/idea-handoff.ts
-var libUrl = new URL("../lib/idea-handoff.generated.mjs", import.meta.url).href;
-async function loadHandoffLib() {
-  return await import(libUrl);
-}
-var IDEA_HANDOFF_USAGE = "usage: idea-handoff.ts  (env: __runId, featureId, optional spurBin) \u2014 no subcommands";
-async function main(argv, env = getEnvVars()) {
-  if (argv.length > 0) {
-    process.stderr.write(`${IDEA_HANDOFF_USAGE}
-`);
-    return 2;
-  }
-  const { runIdeaHandoffCli } = await loadHandoffLib();
-  const outcome = await runIdeaHandoffCli(env);
-  return outcome.exitCode;
-}
-{
-  process.exit(await main(process.argv.slice(2)));
-}
-export {
-  IDEA_HANDOFF_USAGE,
-  loadHandoffLib,
-  main
-};

package/plugins/sp/scripts/idea-handoff.ts

@@ -1,47 +0,0 @@
-#!/usr/bin/env bun
-
-import { getEnvVars } from '../lib/env';
-
-/**
- * idea-handoff — portable entrypoint for the idea-pipeline finalization (task 0824, feature I21).
- *
- * ADR-065 standard plugin script: the workflow wrapper prefers the monorepo writer
- * (`bun packages/app/src/workflow/idea-handoff-cli.ts`) and falls back to this script's
- * registered `.mjs` twin under bare `node`, so a seeded project with no monorepo checkout
- * still finalizes the handoff (run-scoped report + task-deps ordering + roster refresh) and
- * fails closed (exit 1) when neither writer resolves.
- *
- * The behavior lives in the generated bundle `../lib/idea-handoff.generated.mjs`, produced by
- * `bun run build:plugin-lib` from `packages/app/src/workflow/idea-handoff-cli.ts` — the same
- * source the monorepo branch executes, so both branches share one contract (0604/0824).
- * Declarations: `../lib/idea-handoff.generated.d.mts`. The bundle is imported by computed URL
- * on purpose: `superskill script convert` must NOT inline it (its tree carries one
- * `Bun.spawn` site in a ts-runtime streaming path this workflow never exercises), so the
- * twin stays a thin node-runnable loader over the committed runtime asset.
- *
- * Environment: `__runId`, `featureId`, optional `spurBin`. Missing required vars exit 1
- * (mis-invocation is failed-closed, never a silent skip).
- */
-
-const libUrl = new URL('../lib/idea-handoff.generated.mjs', import.meta.url).href;
-
-export async function loadHandoffLib(): Promise<typeof import('../lib/idea-handoff.generated.mjs')> {
-    return (await import(libUrl)) as typeof import('../lib/idea-handoff.generated.mjs');
-}
-
-export const IDEA_HANDOFF_USAGE =
-    'usage: idea-handoff.ts  (env: __runId, featureId, optional spurBin) — no subcommands';
-
-export async function main(argv: string[], env: NodeJS.ProcessEnv = getEnvVars()): Promise<number> {
-    if (argv.length > 0) {
-        process.stderr.write(`${IDEA_HANDOFF_USAGE}\n`);
-        return 2;
-    }
-    const { runIdeaHandoffCli } = await loadHandoffLib();
-    const outcome = await runIdeaHandoffCli(env as { __runId?: string; featureId?: string; spurBin?: string });
-    return outcome.exitCode;
-}
-
-if (import.meta.main) {
-    process.exit(await main(process.argv.slice(2)));
-}

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

@@ -1,131 +0,0 @@
-#!/usr/bin/env node
-// @bun
-
-// plugins/sp/scripts/inline-run-dispatch.ts
-import { spawnSync } from "child_process";
-import { fileURLToPath as fileURLToPath2 } from "url";
-
-// plugins/sp/lib/env.ts
-function getEnvVar(name, fallback) {
-  const raw = process.env[name];
-  return raw === undefined ? fallback : raw;
-}
-
-// plugins/sp/lib/inline-run-app.ts
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-function resolveAppEntry(spurBin) {
-  const fallback = fileURLToPath(new URL("../../../apps/cli/src/index.ts", import.meta.url));
-  const candidates = spurBin !== "" ? [spurBin] : [fallback];
-  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))
-      continue;
-    const repoRoot = resolve(dirname(mainModule), "..", "..", "..");
-    const appEntry = join(repoRoot, "packages", "app", "src", "index.ts");
-    if (existsSync(appEntry))
-      return { entry: appEntry, portable: false };
-  }
-  const entry = fileURLToPath(new URL("../lib/inline-run.generated.mjs", import.meta.url));
-  if (!existsSync(entry)) {
-    throw new Error("inline application bundle is missing — rebuild/install the sp plugin before running inline");
-  }
-  return { entry, portable: true };
-}
-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/scripts/inline-run-dispatch.ts
-function usage() {
-  console.error([
-    "Usage: bun plugins/sp/scripts/inline-run-dispatch.ts --attribution --run-id <id> --stage <state> [--executor <name>] [--agent <name>] [--model <m>] [--spur-bin <path>]",
-    "       bun plugins/sp/scripts/inline-run-dispatch.ts --dispatch-failure --run-id <id> --stage <state> --decision <escalate|stop|host-inline> (--text <record> | --text-file <path>) [--executor <name>] [--agent <name>] [--model <m>] [--spur-bin <path>]",
-    "       --attribution writes .spur/run/<run-id>-attribution.jsonl; an omitted/empty --executor records the explicit no-attribution marker.",
-    "       --dispatch-failure classifies the record upstream, writes .spur/run/<run-id>-dispatch-fallback.json, and carries an attributed capacity exhaustion onto the durable availability path."
-  ].join(`
-`));
-  process.exit(2);
-}
-var SAFE_RUN_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-async function main() {
-  if (!process.versions.bun) {
-    const child = spawnSync("bun", [fileURLToPath2(import.meta.url), ...process.argv.slice(2)], {
-      stdio: "inherit"
-    });
-    if (child.error)
-      console.error(`inline-run-dispatch requires Bun on PATH: ${child.error.message}`);
-    process.exit(child.status ?? 1);
-  }
-  const flags = new Map;
-  let attribution = false;
-  let dispatchFailure = false;
-  let spurBin = getEnvVar("SPUR_BIN") ?? "";
-  const argv = process.argv.slice(2);
-  for (let i = 0;i < argv.length; i++) {
-    const flag = argv[i];
-    if (flag === "--attribution")
-      attribution = true;
-    else if (flag === "--dispatch-failure")
-      dispatchFailure = true;
-    else if (flag === "--spur-bin")
-      spurBin = argv[++i] ?? spurBin;
-    else if (flag !== undefined)
-      flags.set(flag, argv[++i] ?? "");
-  }
-  const runId = flags.get("--run-id") ?? "";
-  const stage = flags.get("--stage") ?? "";
-  const decision = flags.get("--decision") ?? "";
-  const text = flags.get("--text") ?? "";
-  const textFile = flags.get("--text-file") ?? "";
-  const executor = flags.get("--executor") ?? "";
-  const agent = flags.get("--agent") ?? "";
-  const model = flags.get("--model") ?? "";
-  if (attribution === dispatchFailure)
-    usage();
-  if (runId.trim() === "" || stage.trim() === "" || !SAFE_RUN_ID_RE.test(runId))
-    usage();
-  const identity = {
-    executor: executor.trim() === "" ? null : executor,
-    agent: agent.trim() === "" ? null : agent,
-    ...model.trim() === "" ? {} : { model }
-  };
-  const { app, portable } = await loadInlineApp(spurBin, resolveAppEntry, [
-    "recordInlineRunAttribution",
-    "runInlineRunDispatchFailure"
-  ]);
-  if (attribution) {
-    app.recordInlineRunAttribution(process.cwd(), runId, {
-      stage,
-      ...identity,
-      observedAt: new Date().toISOString()
-    });
-    process.stdout.write(`${JSON.stringify({ ok: true, runId, stage })}
-`);
-    process.exit(0);
-  }
-  if (decision.trim() === "" || text === "" === (textFile === ""))
-    usage();
-  const { app: lib } = await loadInlineApp(spurBin, () => ({ entry: fileURLToPath2(new URL("../lib/inline-run.generated.mjs", import.meta.url)), portable }), ["loadSpurConfig"]);
-  const spurConfig = await lib.loadSpurConfig(process.cwd(), portable ? { embeddedSchemas: lib.EMBEDDED_SPUR_SCHEMAS } : undefined);
-  process.exit(await app.runInlineRunDispatchFailure({
-    runId,
-    stage,
-    decision,
-    ...text === "" ? { textFile } : { text },
-    ...identity,
-    spurConfig
-  }));
-}
-main().catch((e) => {
-  console.error(`inline-run-dispatch: FAIL \u2014 ${e instanceof Error ? e.message : String(e)}`);
-  process.exit(1);
-});

package/plugins/sp/scripts/inline-run-dispatch.ts

@@ -1,115 +0,0 @@
-#!/usr/bin/env bun
-/** Inline dispatch fail-fast facade (task 1134 R1–R4): argv/env only. The classification, the
- *  decision artifact and the durable availability write all live in the app runners
- *  (`recordInlineRunAttribution`, `runInlineRunDispatchFailure`), reached through the same
- *  `loadInlineApp` seam the setup facade uses. It is a SEPARATE script from `inline-run-setup.ts`
- *  because it is a separate operation and the ADR-130 glue budget is per script. */
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-// Type-only namespace import (erased before bundling; the smoke scanner exempts `import type`).
-import type * as spurApp from '@gobing-ai/spur-app';
-import { getEnvVar } from '../lib/env';
-import { loadInlineApp, resolveAppEntry } from '../lib/inline-run-app';
-
-// EMBEDDED_SPUR_SCHEMAS is declared by the bundle twin, never exported by the barrel.
-type InlineApp = typeof spurApp & { EMBEDDED_SPUR_SCHEMAS?: ReadonlyMap<string, string> };
-
-function usage(): never {
-    console.error(
-        [
-            'Usage: bun plugins/sp/scripts/inline-run-dispatch.ts --attribution --run-id <id> --stage <state> [--executor <name>] [--agent <name>] [--model <m>] [--spur-bin <path>]',
-            '       bun plugins/sp/scripts/inline-run-dispatch.ts --dispatch-failure --run-id <id> --stage <state> --decision <escalate|stop|host-inline> (--text <record> | --text-file <path>) [--executor <name>] [--agent <name>] [--model <m>] [--spur-bin <path>]',
-            '       --attribution writes .spur/run/<run-id>-attribution.jsonl; an omitted/empty --executor records the explicit no-attribution marker.',
-            '       --dispatch-failure classifies the record upstream, writes .spur/run/<run-id>-dispatch-fallback.json, and carries an attributed capacity exhaustion onto the durable availability path.',
-        ].join('\n'),
-    );
-    process.exit(2);
-}
-
-/** Run ids become filenames under `.spur/run/` — single safe component only (0804 R8). */
-const SAFE_RUN_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-
-/** Resolve the app entry: --spur-bin/SPUR_BIN main module if it proves a repo checkout, else the bundle. */
-
-async function main(): Promise<void> {
-    // The portable Node twin has no workspace imports; the app bundle still uses Spur's Bun runtime.
-    if (!process.versions.bun) {
-        const child = spawnSync('bun', [fileURLToPath(import.meta.url), ...process.argv.slice(2)], {
-            stdio: 'inherit',
-        });
-        if (child.error) console.error(`inline-run-dispatch requires Bun on PATH: ${child.error.message}`);
-        process.exit(child.status ?? 1);
-    }
-    const flags = new Map<string, string>();
-    let attribution = false;
-    let dispatchFailure = false;
-    let spurBin = getEnvVar('SPUR_BIN') ?? '';
-    const argv = process.argv.slice(2);
-    for (let i = 0; i < argv.length; i++) {
-        const flag = argv[i];
-        if (flag === '--attribution') attribution = true;
-        else if (flag === '--dispatch-failure') dispatchFailure = true;
-        else if (flag === '--spur-bin') spurBin = argv[++i] ?? spurBin;
-        else if (flag !== undefined) flags.set(flag, argv[++i] ?? '');
-    }
-    const runId = flags.get('--run-id') ?? '';
-    const stage = flags.get('--stage') ?? '';
-    const decision = flags.get('--decision') ?? '';
-    const text = flags.get('--text') ?? '';
-    const textFile = flags.get('--text-file') ?? '';
-    const executor = flags.get('--executor') ?? '';
-    const agent = flags.get('--agent') ?? '';
-    const model = flags.get('--model') ?? '';
-
-    if (attribution === dispatchFailure) usage();
-    if (runId.trim() === '' || stage.trim() === '' || !SAFE_RUN_ID_RE.test(runId)) usage();
-    // R3: the executor identity the inline stage actually used. An omitted/empty `--executor` is the
-    // explicit no-attribution marker — never a silent drop.
-    const identity = {
-        executor: executor.trim() === '' ? null : executor,
-        agent: agent.trim() === '' ? null : agent,
-        ...(model.trim() === '' ? {} : { model }),
-    };
-    const { app, portable } = await loadInlineApp<InlineApp>(spurBin, resolveAppEntry, [
-        'recordInlineRunAttribution',
-        'runInlineRunDispatchFailure',
-    ]);
-
-    if (attribution) {
-        app.recordInlineRunAttribution(process.cwd(), runId, {
-            stage,
-            ...identity,
-            observedAt: new Date().toISOString(),
-        });
-        process.stdout.write(`${JSON.stringify({ ok: true, runId, stage })}\n`);
-        process.exit(0);
-    }
-
-    if (decision.trim() === '' || (text === '') === (textFile === '')) usage();
-    // ADR-082: this facade is the composition root, so it loads the effective config once and
-    // threads the merged result into the app runner (never a per-slice load in packages/app).
-    const { app: lib } = await loadInlineApp<typeof import('../lib/inline-run.generated.mjs')>(
-        spurBin,
-        () => ({ entry: fileURLToPath(new URL('../lib/inline-run.generated.mjs', import.meta.url)), portable }),
-        ['loadSpurConfig'],
-    );
-    const spurConfig = await lib.loadSpurConfig(
-        process.cwd(),
-        portable ? { embeddedSchemas: lib.EMBEDDED_SPUR_SCHEMAS } : undefined,
-    );
-    process.exit(
-        await app.runInlineRunDispatchFailure({
-            runId,
-            stage,
-            decision: decision as 'escalate' | 'stop' | 'host-inline',
-            ...(text === '' ? { textFile } : { text }),
-            ...identity,
-            spurConfig,
-        }),
-    );
-}
-
-main().catch((e: unknown) => {
-    console.error(`inline-run-dispatch: FAIL — ${e instanceof Error ? e.message : String(e)}`);
-    process.exit(1);
-});