@interf/compiler 0.3.2 → 0.3.3

package/dist/commands/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAuB3C,eAAO,MAAM,WAAW,EAAE,aAQzB,CAAC;AAkDF,wBAAsB,cAAc,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EtF"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAwB3C,eAAO,MAAM,WAAW,EAAE,aAczB,CAAC;AAuDF,wBAAsB,cAAc,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFtF"}

package/dist/commands/test.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import * as p from "@clack/prompts";
-import { detectInterf, resolveSourceFolderPath, } from "../lib/interf.js";
+import { detectInterf, resolveSourceControlPath, } from "../lib/interf.js";
 import { loadSourceFolderConfig } from "../lib/source-config.js";
 import { addExecutionProfileOptions, executionProfileFromArgv, } from "../lib/execution-profile.js";
 import { chooseWorkspaceConfigToBuild, findBuiltWorkspacePath, findSavedWorkspaceConfig, } from "./workspace-flow.js";
@@ -8,12 +8,20 @@ import { printSavedTestComparison, runSavedRawTest, runSavedWorkspaceTest, } fro
 export const testCommand = {
     command: "test",
     aliases: ["benchmark"],
-    describe: "Run your saved questions on raw files or a workspace",
-    builder: (yargs) => addExecutionProfileOptions(yargs),
+    describe: "Run saved truth checks on raw data or a workspace",
+    builder: (yargs) => addExecutionProfileOptions(yargs).option("keep-sandboxes", {
+        type: "boolean",
+        default: false,
+        describe: "Keep every raw or workspace test sandbox under interf/benchmarks/sandboxes for review instead of pruning successful runs",
+    }),
     handler: async (argv) => {
         await runTestCommand(argv);
     },
 };
+function readSandboxRetentionMode(argv) {
+    const enabled = argv["keep-sandboxes"] ?? argv.keepSandboxes ?? false;
+    return enabled ? "always" : "on-failure";
+}
 async function chooseTestMode(options) {
     if (!options.hasBuiltWorkspace) {
         const selected = await p.select({
@@ -62,7 +70,7 @@ async function chooseTestMode(options) {
 export async function runTestCommand(argv = {}) {
     const cwd = process.cwd();
     const detected = detectInterf(cwd);
-    const sourcePath = detected ? resolveSourceFolderPath(detected.path, detected.config) : cwd;
+    const sourcePath = detected ? resolveSourceControlPath(detected.path) : cwd;
     const config = loadSourceFolderConfig(sourcePath);
     if (!config) {
         process.exitCode = 1;
@@ -86,11 +94,12 @@ export async function runTestCommand(argv = {}) {
     }
     if (selectedWorkspace.checks.length === 0) {
         process.exitCode = 1;
-        console.log(chalk.red(`  Workspace "${selectedWorkspace.name}" does not have any saved questions yet.`));
+        console.log(chalk.red(`  Workspace "${selectedWorkspace.name}" does not have any saved truth checks yet.`));
         console.log(chalk.dim("  Run `interf` or `interf init` to add a few first."));
         return;
     }
     const executionProfile = executionProfileFromArgv(argv);
+    const preserveSandboxes = readSandboxRetentionMode(argv);
     const builtWorkspacePath = detected?.path ?? findBuiltWorkspacePath(sourcePath, selectedWorkspace.name);
     const hasBuiltWorkspace = Boolean(builtWorkspacePath);
     const mode = detected
@@ -112,6 +121,7 @@ export async function runTestCommand(argv = {}) {
             sourcePath,
             workspaceConfig: selectedWorkspace,
             executionProfile,
+            preserveSandboxes,
         })
         : null;
     const workspaceOutcome = mode === "workspace" || mode === "both"
@@ -120,6 +130,7 @@ export async function runTestCommand(argv = {}) {
             workspaceConfig: selectedWorkspace,
             executionProfile,
             workspacePath: builtWorkspacePath,
+            preserveSandboxes,
         })
         : null;
     if ((mode === "workspace" || mode === "both") && !workspaceOutcome) {

package/dist/commands/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EACL,YAAY,EACZ,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,WAAW,CAAC;IACtB,QAAQ,EAAE,mDAAmD;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,0BAA0B,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE;QACzD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,QAAQ,EACN,0HAA0H;KAC7H,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,cAAc,CAAC,IAA+B,CAAC,CAAC;IACxD,CAAC;CACF,CAAC;AAEF,SAAS,wBAAwB,CAAC,IAA6B;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;IACtE,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,OAG7B;IACC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;YAC9B,OAAO,EAAE,SAAS,OAAO,CAAC,aAAa,iBAAiB;YACxD,OAAO,EAAE;gBACP;oBACE,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,WAAW;oBAClB,IAAI,EAAE,2CAA2C;iBAClD;gBACD;oBACE,KAAK,EAAE,WAAW;oBAClB,KAAK,EAAE,oBAAoB;oBAC3B,IAAI,EAAE,sCAAsC;iBAC7C;aACF;SACF,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,QAAoB,CAAC;IAC9B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,SAAS,OAAO,CAAC,aAAa,iBAAiB;QACxD,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,gDAAgD;gBACvD,IAAI,EAAE,iDAAiD;aACxD;YACD;gBACE,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,uBAAuB;aAC9B;YACD;gBACE,KAAK,EAAE,WAAW;gBAClB,KAAK,EAAE,oBAAoB;gBAC3B,IAAI,EAAE,+CAA+C;aACtD;SACF;KACF,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,QAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAgC,EAAE;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5E,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAElD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,GAAG,QAAQ;QAChC,CAAC,CAAC,CAAC,wBAAwB,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QACtE,CAAC,CAAC,MAAM,4BAA4B,CAAC;YACjC,UAAU;YACV,aAAa,EAAE,sCAAsC;SACtD,CAAC,CAAC;IACP,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO;IAC5C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,iBAAiB,CAAC,IAAI,6CAA6C,CAAC,CAAC,CAAC;QAC5G,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,kBAAkB,GAAG,QAAQ,EAAE,IAAI,IAAI,sBAAsB,CAAC,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxG,MAAM,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEtD,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,cAAc,CAAC;YACnB,aAAa,EAAE,iBAAiB,CAAC,IAAI;YACrC,iBAAiB;SAClB,CAAC,CAAC;IACP,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,IAAI,IAAI,KAAK,WAAW,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,iBAAiB,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GACd,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM;QAC/B,CAAC,CAAC,MAAM,eAAe,CAAC;YACpB,UAAU;YACV,eAAe,EAAE,iBAAiB;YAClC,gBAAgB;YAChB,iBAAiB;SAClB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,gBAAgB,GACpB,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM;QACrC,CAAC,CAAC,MAAM,qBAAqB,CAAC;YAC1B,UAAU;YACV,eAAe,EAAE,iBAAiB;YAClC,gBAAgB;YAChB,aAAa,EAAE,kBAAkB;YACjC,iBAAiB;SAClB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,iBAAiB,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACzD,CAAC"}

package/dist/commands/workspace-flow.d.ts

@@ -1,4 +1,5 @@
 import type { SourceWorkspaceConfig } from "../lib/schema.js";
+import { type StageShellRetentionMode } from "../lib/workflows.js";
 import type { WorkflowExecutor } from "../lib/executors.js";
 import type { WorkspaceCompileResult } from "../lib/workflows.js";
 export interface SavedWorkspaceEntry {
@@ -17,5 +18,6 @@ export declare function ensureWorkspaceFromConfig(sourcePath: string, workspaceC
 export declare function compileWorkspaceWithReporter(executor: WorkflowExecutor, workspacePath: string, options?: {
     heading?: string;
     successMessage?: string;
+    preserveStageShells?: StageShellRetentionMode;
 }): Promise<WorkspaceCompileResult>;
 //# sourceMappingURL=workspace-flow.d.ts.map

package/dist/commands/workspace-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-flow.d.ts","sourceRoot":"","sources":["../../src/commands/workspace-flow.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAM9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AASD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,EAAE,CASnF;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,qBAAqB,GAAG,IAAI,CAE9B;AAED,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,GAAG,SAAS,CAAC,CAyBpD;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,GAC1E,MAAM,CAUR;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,GAC1E,MAAM,CAQR;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC,sBAAsB,CAAC,CA2BjC"}
+{"version":3,"file":"workspace-flow.d.ts","sourceRoot":"","sources":["../../src/commands/workspace-flow.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AASD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,EAAE,CASnF;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,qBAAqB,GAAG,IAAI,CAE9B;AAED,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,GAAG,SAAS,CAAC,CAyBpD;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,GAC1E,MAAM,CAUR;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,GAC1E,MAAM,CAQR;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CAC1C,GACL,OAAO,CAAC,sBAAsB,CAAC,CA4BjC"}

package/dist/commands/workspace-flow.js

@@ -10,8 +10,8 @@ function formatSavedWorkspaceHint(config) {
     if (config.about)
         return config.about;
     if (checkCount === 0)
-        return "No saved questions yet";
-    return `${checkCount} saved question${checkCount === 1 ? "" : "s"}`;
+        return "No saved truth checks yet";
+    return `${checkCount} saved truth check${checkCount === 1 ? "" : "s"}`;
 }
 export function listSavedWorkspaceEntries(sourcePath) {
     const builtByName = new Map(listWorkspacesForSourceFolder(sourcePath).map((entry) => [entry.config.name, entry.path]));
@@ -79,6 +79,7 @@ export async function compileWorkspaceWithReporter(executor, workspacePath, opti
         executor,
         workspacePath,
         reporter,
+        preserveStageShells: options.preserveStageShells,
     });
     if (!result.ok) {
         return result;

package/dist/commands/workspace-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-flow.js","sourceRoot":"","sources":["../../src/commands/workspace-flow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workspace-flow.js","sourceRoot":"","sources":["../../src/commands/workspace-flow.ts"],"names":[],"mappings":"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"}

package/dist/lib/agent-shells.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeContractType, WorkflowZoneId } from "./schema.js";
+export interface NativeStageDefinition {
+    id: string;
+    label: string;
+    description: string;
+    contractType: RuntimeContractType;
+    skillDir: string;
+    reads: WorkflowZoneId[];
+    writes: WorkflowZoneId[];
+}
+export declare function renderClaudeBootstrap(content: string): string;
+export declare function pruneStageExecutionShells(workspacePath: string): void;
+export declare function projectWorkspaceQueryShell(workspacePath: string, workspaceName: string, workflowId: string, about?: string): boolean;
+export declare function createStageExecutionShell(workspacePath: string, workspaceName: string, workflowId: string, stage: NativeStageDefinition): {
+    rootPath: string;
+};
+//# sourceMappingURL=agent-shells.d.ts.map

package/dist/lib/agent-shells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-shells.d.ts","sourceRoot":"","sources":["../../src/lib/agent-shells.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAGV,mBAAmB,EAGnB,cAAc,EACf,MAAM,aAAa,CAAC;AAWrB,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,mBAAmB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AA4UD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAeT;AAED,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,qBAAqB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAoCtB"}

package/dist/lib/agent-shells.js

@@ -0,0 +1,294 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, symlinkSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { WORKFLOW_PACKAGE_DIR } from "./interf-detect.js";
+import { renderWorkspaceAgents, renderWorkspaceQuerySkill, } from "./workspace-docs.js";
+import { ensureWorkspaceZoneTargets, readWorkspaceSchemaFile, workspaceZoneAbsolutePath, } from "./workspace-schema.js";
+const LOCAL_SKILL_ROOTS = [
+    ".claude/skills",
+    ".codex/skills",
+    ".agents/skills",
+    ".cursor/skills",
+];
+function stageShellsRoot(workspacePath) {
+    return join(workspacePath, ".interf", "execution-shells");
+}
+function stageShellWorkflowRoot(shellRoot) {
+    return join(shellRoot, WORKFLOW_PACKAGE_DIR);
+}
+function shellInputZonePath(shellRoot, zoneId) {
+    return join(shellRoot, "inputs", zoneId);
+}
+function shellOutputZonePath(shellRoot, zoneId) {
+    return join(shellRoot, "outputs", zoneId);
+}
+function shellRuntimePath(shellRoot, relativePath) {
+    return join(shellRoot, "runtime", relativePath);
+}
+function writeIfChanged(path, content) {
+    if (existsSync(path) && readFileSync(path, "utf8") === content) {
+        return false;
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+    return true;
+}
+function writeNativeSkillCopies(rootPath, skillName, content) {
+    let changed = false;
+    for (const skillsRoot of LOCAL_SKILL_ROOTS) {
+        const skillPath = join(rootPath, skillsRoot, skillName, "SKILL.md");
+        changed = writeIfChanged(skillPath, content) || changed;
+    }
+    return changed;
+}
+function linkPath(targetPath, linkPathname) {
+    mkdirSync(dirname(linkPathname), { recursive: true });
+    symlinkSync(targetPath, linkPathname);
+}
+function loadWorkspaceSchema(workspacePath) {
+    const schema = readWorkspaceSchemaFile(join(workspacePath, WORKFLOW_PACKAGE_DIR));
+    if (!schema) {
+        throw new Error(`Missing workflow workspace schema at ${join(workspacePath, WORKFLOW_PACKAGE_DIR, "workspace.schema.json")}`);
+    }
+    return schema;
+}
+function zoneMap(schema) {
+    return new Map(schema.zones.map((zone) => [zone.id, zone]));
+}
+function zoneOrThrow(zones, zoneId) {
+    const zone = zones.get(zoneId);
+    if (!zone) {
+        throw new Error(`Missing workspace schema zone "${zoneId}" for stage shell projection.`);
+    }
+    return zone;
+}
+function ensureWorkspaceExecutionSurface(workspacePath) {
+    mkdirSync(join(workspacePath, ".interf"), { recursive: true });
+    mkdirSync(join(workspacePath, WORKFLOW_PACKAGE_DIR), { recursive: true });
+    const schema = loadWorkspaceSchema(workspacePath);
+    ensureWorkspaceZoneTargets(workspacePath, schema);
+    return schema;
+}
+function readStageMethodDoc(workspacePath, stage) {
+    const path = join(workspacePath, WORKFLOW_PACKAGE_DIR, "compile", "stages", stage.skillDir, "SKILL.md");
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path, "utf8").trim();
+}
+function stageWorkflowDocsPath(workspacePath, stage) {
+    return join(workspacePath, WORKFLOW_PACKAGE_DIR, "compile", "stages", stage.skillDir);
+}
+function renderStageExecutionAgents(workspaceName, workflowId, stage) {
+    return [
+        `# ${workspaceName} — ${stage.label} Execution Shell`,
+        "",
+        "This is an ephemeral Interf stage-execution shell.",
+        "It is for automated pipeline execution only, not for manual querying.",
+        "",
+        "## Start Here",
+        "",
+        "1. Read `runtime/stage-contract.json` now.",
+        "2. Read `runtime/paths.json` now.",
+        "3. Use the local native `interf-stage` skill now.",
+        `4. Execute only the current stage: \`${stage.id}\` (${stage.label}).`,
+        "",
+        "## Shell ABI",
+        "",
+        "- `inputs/<zone-id>/` = read mounts for the current stage.",
+        "- `outputs/<zone-id>/` = write mounts for the current stage.",
+        "- schema-declared workspace paths are also projected at the shell root so workflow-relative contract paths stay valid.",
+        "- `runtime/` = stage contract and machine-readable path map for this shell.",
+        "- `workflow/` = workflow metadata, workspace schema, and docs for the current stage only.",
+        "",
+        "## Boundaries",
+        "",
+        `- Workflow: \`${workflowId}\`.`,
+        `- Contract type: \`${stage.contractType}\`.`,
+        "- This shell has its own AGENTS/CLAUDE/native skills. It does not inherit the compiled workspace query shell.",
+        "- The compiled workspace root itself is not linked into this shell.",
+        "- Do not switch into query mode or act like a user-facing assistant.",
+        "- Do not modify files under `inputs/` unless the same zone is also mounted under `outputs/`.",
+        "",
+        "## Current Stage Zones",
+        "",
+        `- reads: ${stage.reads.join(", ")}`,
+        `- writes: ${stage.writes.join(", ")}`,
+        "",
+        "## Goal",
+        "",
+        "- complete the current stage",
+        "- honor the deterministic contract",
+        "- write outputs through the declared zone mounts",
+        "- stop when the stage is complete",
+        "",
+    ].join("\n");
+}
+function renderStageExecutionSkill(stage, stageMethodDoc) {
+    return [
+        "---",
+        "name: interf-stage",
+        "description: >",
+        `  Native local execution skill for the ${stage.label} stage in this Interf`,
+        "  compile run. Use it only inside an automated stage execution shell.",
+        "---",
+        "",
+        `# Interf Stage Execution — ${stage.label}`,
+        "",
+        "This local native skill exists for automated Interf stage execution.",
+        "Read `runtime/stage-contract.json` first.",
+        "Then read `runtime/paths.json` and use the mounted `inputs/` and `outputs/` zones for this stage.",
+        "Do not switch into manual query mode.",
+        "",
+        "## Current Stage",
+        "",
+        `- id: \`${stage.id}\``,
+        `- label: ${stage.label}`,
+        `- contract type: \`${stage.contractType}\``,
+        `- reads: ${stage.reads.join(", ")}`,
+        `- writes: ${stage.writes.join(", ")}`,
+        `- editable source: \`workflow/compile/stages/${stage.skillDir}/SKILL.md\``,
+        "",
+        ...(stageMethodDoc
+            ? [
+                "## Stage Method",
+                "",
+                stageMethodDoc,
+                "",
+            ]
+            : []),
+    ].join("\n");
+}
+function renderWorkspaceQueryNativeSkill() {
+    return [
+        "---",
+        "name: interf-query",
+        "description: >",
+        "  Native local query skill for this Interf compiled workspace. Use it for",
+        "  manual questions against the compiled workspace and its raw fallback.",
+        "---",
+        "",
+        "# Interf Query",
+        "",
+        "This is the native local query skill for an Interf compiled workspace.",
+        "Use it when reading this workspace manually.",
+        "Editable source: `workflow/use/query/SKILL.md`.",
+        "",
+        renderWorkspaceQuerySkill().trim(),
+        "",
+    ].join("\n");
+}
+function syncWorkspaceNativeQuerySkillCopies(workspacePath) {
+    return writeNativeSkillCopies(workspacePath, "interf-query", renderWorkspaceQueryNativeSkill());
+}
+function projectWorkflowMetadata(workspacePath, shellRoot, stage) {
+    const workflowRoot = stageShellWorkflowRoot(shellRoot);
+    mkdirSync(join(workflowRoot, "compile", "stages"), { recursive: true });
+    const workflowJsonPath = join(workspacePath, WORKFLOW_PACKAGE_DIR, "workflow.json");
+    if (existsSync(workflowJsonPath)) {
+        linkPath(workflowJsonPath, join(workflowRoot, "workflow.json"));
+    }
+    const workspaceSchemaPath = join(workspacePath, WORKFLOW_PACKAGE_DIR, "workspace.schema.json");
+    if (existsSync(workspaceSchemaPath)) {
+        linkPath(workspaceSchemaPath, join(workflowRoot, "workspace.schema.json"));
+    }
+    const readmePath = join(workspacePath, WORKFLOW_PACKAGE_DIR, "README.md");
+    if (existsSync(readmePath)) {
+        linkPath(readmePath, join(workflowRoot, "README.md"));
+    }
+    const stageDocsPath = stageWorkflowDocsPath(workspacePath, stage);
+    if (existsSync(stageDocsPath)) {
+        linkPath(stageDocsPath, join(workflowRoot, "compile", "stages", stage.skillDir));
+    }
+}
+function projectWorkspaceSchemaZones(workspacePath, shellRoot, schema) {
+    for (const zone of schema.zones) {
+        linkPath(workspaceZoneAbsolutePath(workspacePath, zone), join(shellRoot, zone.path));
+    }
+}
+function buildStageZoneMounts(workspacePath, shellRoot, stage, schema) {
+    const zones = zoneMap(schema);
+    const mountFor = (zoneId) => {
+        const zone = zoneOrThrow(zones, zoneId);
+        return {
+            zone_id: zone.id,
+            workspace_path: zone.path,
+            shell_root_path: zone.path,
+            input_mount_path: stage.reads.includes(zoneId) ? `inputs/${zone.id}` : null,
+            output_mount_path: stage.writes.includes(zoneId) ? `outputs/${zone.id}` : null,
+        };
+    };
+    return {
+        reads: stage.reads.map(mountFor),
+        writes: stage.writes.map(mountFor),
+    };
+}
+function projectStageZoneMountAliases(workspacePath, shellRoot, stage, schema) {
+    const zones = zoneMap(schema);
+    for (const zoneId of new Set([...stage.reads, ...stage.writes])) {
+        const zone = zoneOrThrow(zones, zoneId);
+        const targetPath = workspaceZoneAbsolutePath(workspacePath, zone);
+        if (stage.reads.includes(zoneId)) {
+            linkPath(targetPath, shellInputZonePath(shellRoot, zoneId));
+        }
+        if (stage.writes.includes(zoneId)) {
+            linkPath(targetPath, shellOutputZonePath(shellRoot, zoneId));
+        }
+    }
+}
+function writeExecutionShellPathsFile(shellRoot, workflowId, stage, mounts) {
+    const paths = {
+        kind: "interf-execution-shell",
+        version: 1,
+        workflow: workflowId,
+        stage: stage.id,
+        reads: mounts.reads,
+        writes: mounts.writes,
+    };
+    writeFileSync(shellRuntimePath(shellRoot, "paths.json"), `${JSON.stringify(paths, null, 2)}\n`);
+}
+export function renderClaudeBootstrap(content) {
+    return [
+        "<!-- Generated from AGENTS.md. Edit AGENTS.md; Interf will rewrite this file. -->",
+        "",
+        content.trimEnd(),
+        "",
+    ].join("\n");
+}
+export function pruneStageExecutionShells(workspacePath) {
+    rmSync(stageShellsRoot(workspacePath), { recursive: true, force: true });
+}
+export function projectWorkspaceQueryShell(workspacePath, workspaceName, workflowId, about) {
+    const agentsContent = renderWorkspaceAgents(workspaceName, workflowId, about);
+    const querySkillContent = renderWorkspaceQuerySkill();
+    let changed = false;
+    changed = writeIfChanged(join(workspacePath, "AGENTS.md"), agentsContent) || changed;
+    changed =
+        writeIfChanged(join(workspacePath, "CLAUDE.md"), renderClaudeBootstrap(agentsContent)) || changed;
+    const querySkillPath = join(workspacePath, WORKFLOW_PACKAGE_DIR, "use", "query", "SKILL.md");
+    mkdirSync(dirname(querySkillPath), { recursive: true });
+    changed = writeIfChanged(querySkillPath, querySkillContent) || changed;
+    changed = syncWorkspaceNativeQuerySkillCopies(workspacePath) || changed;
+    return changed;
+}
+export function createStageExecutionShell(workspacePath, workspaceName, workflowId, stage) {
+    const schema = ensureWorkspaceExecutionSurface(workspacePath);
+    const shellsRoot = stageShellsRoot(workspacePath);
+    const shellRoot = join(shellsRoot, `${stage.id}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
+    mkdirSync(shellRoot, { recursive: true });
+    mkdirSync(join(shellRoot, "runtime"), { recursive: true });
+    mkdirSync(join(shellRoot, "inputs"), { recursive: true });
+    mkdirSync(join(shellRoot, "outputs"), { recursive: true });
+    linkPath(join(workspacePath, "interf.json"), join(shellRoot, "interf.json"));
+    linkPath(join(workspacePath, ".interf", "stage-contract.json"), shellRuntimePath(shellRoot, "stage-contract.json"));
+    projectWorkspaceSchemaZones(workspacePath, shellRoot, schema);
+    projectWorkflowMetadata(workspacePath, shellRoot, stage);
+    projectStageZoneMountAliases(workspacePath, shellRoot, stage, schema);
+    writeExecutionShellPathsFile(shellRoot, workflowId, stage, buildStageZoneMounts(workspacePath, shellRoot, stage, schema));
+    const agentsContent = renderStageExecutionAgents(workspaceName, workflowId, stage);
+    writeFileSync(join(shellRoot, "AGENTS.md"), `${agentsContent}\n`);
+    writeFileSync(join(shellRoot, "CLAUDE.md"), renderClaudeBootstrap(agentsContent));
+    writeNativeSkillCopies(shellRoot, "interf-stage", renderStageExecutionSkill(stage, readStageMethodDoc(workspacePath, stage)));
+    return {
+        rootPath: shellRoot,
+    };
+}
+//# sourceMappingURL=agent-shells.js.map

package/dist/lib/agent-shells.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-shells.js","sourceRoot":"","sources":["../../src/lib/agent-shells.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAS1D,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAY/B,MAAM,iBAAiB,GAAG;IACxB,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAEX,SAAS,eAAe,CAAC,aAAqB;IAC5C,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB,EAAE,MAAsB;IACnE,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB,EAAE,MAAsB;IACpE,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,YAAoB;IAC/D,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB,EAAE,SAAiB,EAAE,OAAe;IAClF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACpE,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC;IAC1D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkB,EAAE,YAAoB;IACxD,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,WAAW,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,mBAAmB,CAAC,aAAqB;IAChD,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,uBAAuB,CAAC,EAAE,CAC7G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,MAA+B;IAC9C,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAClB,KAAiD,EACjD,MAAsB;IAEtB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,+BAA+B,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,+BAA+B,CAAC,aAAqB;IAC5D,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAClD,0BAA0B,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,aAAqB,EAAE,KAA4B;IAC7E,MAAM,IAAI,GAAG,IAAI,CACf,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,KAAK,CAAC,QAAQ,EACd,UAAU,CACX,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,qBAAqB,CAAC,aAAqB,EAAE,KAA4B;IAChF,OAAO,IAAI,CACT,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,KAAK,CAAC,QAAQ,CACf,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,aAAqB,EACrB,UAAkB,EAClB,KAA4B;IAE5B,OAAO;QACL,KAAK,aAAa,MAAM,KAAK,CAAC,KAAK,kBAAkB;QACrD,EAAE;QACF,oDAAoD;QACpD,uEAAuE;QACvE,EAAE;QACF,eAAe;QACf,EAAE;QACF,4CAA4C;QAC5C,mCAAmC;QACnC,mDAAmD;QACnD,wCAAwC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC,KAAK,IAAI;QACtE,EAAE;QACF,cAAc;QACd,EAAE;QACF,4DAA4D;QAC5D,8DAA8D;QAC9D,wHAAwH;QACxH,6EAA6E;QAC7E,2FAA2F;QAC3F,EAAE;QACF,eAAe;QACf,EAAE;QACF,iBAAiB,UAAU,KAAK;QAChC,sBAAsB,KAAK,CAAC,YAAY,KAAK;QAC7C,+GAA+G;QAC/G,qEAAqE;QACrE,sEAAsE;QACtE,8FAA8F;QAC9F,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,YAAY,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpC,aAAa,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtC,EAAE;QACF,SAAS;QACT,EAAE;QACF,8BAA8B;QAC9B,oCAAoC;QACpC,kDAAkD;QAClD,mCAAmC;QACnC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,yBAAyB,CAChC,KAA4B,EAC5B,cAA6B;IAE7B,OAAO;QACL,KAAK;QACL,oBAAoB;QACpB,gBAAgB;QAChB,0CAA0C,KAAK,CAAC,KAAK,uBAAuB;QAC5E,uEAAuE;QACvE,KAAK;QACL,EAAE;QACF,8BAA8B,KAAK,CAAC,KAAK,EAAE;QAC3C,EAAE;QACF,sEAAsE;QACtE,2CAA2C;QAC3C,mGAAmG;QACnG,uCAAuC;QACvC,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,WAAW,KAAK,CAAC,EAAE,IAAI;QACvB,YAAY,KAAK,CAAC,KAAK,EAAE;QACzB,sBAAsB,KAAK,CAAC,YAAY,IAAI;QAC5C,YAAY,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpC,aAAa,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtC,gDAAgD,KAAK,CAAC,QAAQ,aAAa;QAC3E,EAAE;QACF,GAAG,CAAC,cAAc;YAChB,CAAC,CAAC;gBACE,iBAAiB;gBACjB,EAAE;gBACF,cAAc;gBACd,EAAE;aACH;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,+BAA+B;IACtC,OAAO;QACL,KAAK;QACL,oBAAoB;QACpB,gBAAgB;QAChB,2EAA2E;QAC3E,yEAAyE;QACzE,KAAK;QACL,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,wEAAwE;QACxE,8CAA8C;QAC9C,iDAAiD;QACjD,EAAE;QACF,yBAAyB,EAAE,CAAC,IAAI,EAAE;QAClC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,mCAAmC,CAAC,aAAqB;IAChE,OAAO,sBAAsB,CAC3B,aAAa,EACb,cAAc,EACd,+BAA+B,EAAE,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,aAAqB,EACrB,SAAiB,EACjB,KAA4B;IAE5B,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAC;IACpF,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;IAC/F,IAAI,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,WAAW,CAAC,CAAC;IAC1E,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAClE,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,QAAQ,CACN,aAAa,EACb,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,aAAqB,EACrB,SAAiB,EACjB,MAA+B;IAE/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,QAAQ,CACN,yBAAyB,CAAC,aAAa,EAAE,IAAI,CAAC,EAC9C,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAC3B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,aAAqB,EACrB,SAAiB,EACjB,KAA4B,EAC5B,MAA+B;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAA2B,EAAE;QACnE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,cAAc,EAAE,IAAI,CAAC,IAAI;YACzB,eAAe,EAAE,IAAI,CAAC,IAAI;YAC1B,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YAC3E,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;SAC/E,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,aAAqB,EACrB,SAAiB,EACjB,KAA4B,EAC5B,MAA+B;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,yBAAyB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,SAAiB,EACjB,UAAkB,EAClB,KAA4B,EAC5B,MAA+E;IAE/E,MAAM,KAAK,GAAwB;QACjC,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;IAEF,aAAa,CAAC,gBAAgB,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,mFAAmF;QACnF,EAAE;QACF,OAAO,CAAC,OAAO,EAAE;QACjB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,aAAqB;IAC7D,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,aAAqB,EACrB,aAAqB,EACrB,UAAkB,EAClB,KAAc;IAEd,MAAM,aAAa,GAAG,qBAAqB,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9E,MAAM,iBAAiB,GAAG,yBAAyB,EAAE,CAAC;IAEtD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,aAAa,CAAC,IAAI,OAAO,CAAC;IACrF,OAAO;QACL,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC;IAEpG,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7F,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,cAAc,CAAC,cAAc,EAAE,iBAAiB,CAAC,IAAI,OAAO,CAAC;IACvE,OAAO,GAAG,mCAAmC,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC;IAExE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,aAAqB,EACrB,aAAqB,EACrB,UAAkB,EAClB,KAA4B;IAE5B,MAAM,MAAM,GAAG,+BAA+B,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CACpB,UAAU,EACV,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CACnF,CAAC;IACF,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3D,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,qBAAqB,CAAC,EAAE,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACpH,2BAA2B,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9D,uBAAuB,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACzD,4BAA4B,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACtE,4BAA4B,CAC1B,SAAS,EACT,UAAU,EACV,KAAK,EACL,oBAAoB,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAC9D,CAAC;IAEF,MAAM,aAAa,GAAG,0BAA0B,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACnF,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,aAAa,IAAI,CAAC,CAAC;IAClE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;IAClF,sBAAsB,CACpB,SAAS,EACT,cAAc,EACd,yBAAyB,CAAC,KAAK,EAAE,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAC3E,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC"}

package/dist/lib/benchmark-execution.d.ts

@@ -1,9 +1,13 @@
 import { type WorkflowExecutor } from "./executors.js";
 import type { BenchmarkRunResult, BenchmarkTargetCandidate, LoadedBenchmarkSpec } from "./benchmark-types.js";
+import { type BenchmarkSandboxRetentionMode } from "./benchmark-sandbox.js";
 export declare function runBenchmark(sourcePath: string, spec: LoadedBenchmarkSpec, targets: BenchmarkTargetCandidate[]): BenchmarkRunResult;
-export declare function runBenchmarkWithJudge(sourcePath: string, spec: LoadedBenchmarkSpec, targets: BenchmarkTargetCandidate[], executor: WorkflowExecutor): Promise<BenchmarkRunResult>;
+export declare function runBenchmarkWithJudge(sourcePath: string, spec: LoadedBenchmarkSpec, targets: BenchmarkTargetCandidate[], executor: WorkflowExecutor, options?: {
+    preserveSandboxes?: BenchmarkSandboxRetentionMode;
+}): Promise<BenchmarkRunResult>;
 export declare function runBenchmarkAuto(sourcePath: string, spec: LoadedBenchmarkSpec, targets: BenchmarkTargetCandidate[], options?: {
     executor?: WorkflowExecutor | null;
+    preserveSandboxes?: BenchmarkSandboxRetentionMode;
 }): Promise<BenchmarkRunResult>;
 export declare function saveBenchmarkRun(sourcePath: string, result: BenchmarkRunResult): string;
 //# sourceMappingURL=benchmark-execution.d.ts.map

package/dist/lib/benchmark-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark-execution.d.ts","sourceRoot":"","sources":["../../src/lib/benchmark-execution.ts"],"names":[],"mappings":"AAUA,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAIV,kBAAkB,EAClB,wBAAwB,EAExB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAigB9B,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,GAClC,kBAAkB,CAmBpB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,EACnC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,EACnC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACpC,GACA,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAkCR"}
+{"version":3,"file":"benchmark-execution.d.ts","sourceRoot":"","sources":["../../src/lib/benchmark-execution.ts"],"names":[],"mappings":"AAUA,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAIV,kBAAkB,EAClB,wBAAwB,EAExB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAC;AAigBhC,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,GAClC,kBAAkB,CAmBpB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,EACnC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IACP,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CAC9C,GACL,OAAO,CAAC,kBAAkB,CAAC,CAgD7B;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,wBAAwB,EAAE,EACnC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD,GACA,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAkCR"}

package/dist/lib/benchmark-execution.js

@@ -2,8 +2,8 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { buildRuntimeExecutorInfo } from "./executors.js";
-import { benchmarkRunGitignorePath, benchmarkRunsPath, } from "./benchmark-paths.js";
-import { createBenchmarkSandbox } from "./benchmark-sandbox.js";
+import { benchmarkRunGitignorePath, benchmarkRunsPath, benchmarkSandboxGitignorePath, benchmarkSandboxesPath, normalizeBenchmarkId, } from "./benchmark-paths.js";
+import { createBenchmarkSandbox, } from "./benchmark-sandbox.js";
 function parseWords(content) {
     return content.trim().split(/\s+/).filter(Boolean).length;
 }
@@ -199,10 +199,12 @@ function buildBenchmarkQueryPrompt(target, benchmarkCase, answerPath, tracePath)
         ? [
             "You are running an Interf benchmark inside an isolated sandboxed compiled workspace.",
             "Read `AGENTS.md` first.",
-            "Then read `workflow/use/query/SKILL.md`.",
+            "Use the local native `interf-query` skill available in this workspace.",
+            "If you need the editable method source, read `workflow/use/query/SKILL.md`.",
             "Answer the benchmark question the same way you would answer a real user inside this compiled workspace.",
             "Prefer `home.md`, `knowledge/`, and `summaries/` before raw fallback.",
-            "The source-folder control plane is intentionally absent from this sandbox. Work only from the sandboxed workspace and sandboxed raw files.",
+            "This sandbox is self-contained: the copied workspace has its own sanitized `raw/` fallback via `interf.json` `source.path`.",
+            "The source-folder control plane is intentionally absent from this sandbox. Work only from this sandboxed workspace and its embedded raw files.",
         ]
         : [
             "You are running an Interf baseline test inside an isolated sandbox of the raw files for this folder.",
@@ -371,7 +373,7 @@ async function runBenchmarkCaseWithJudge(target, benchmarkCase, executor) {
         checks,
     };
 }
-function buildBenchmarkTargetResult(target, caseResults) {
+function buildBenchmarkTargetResult(target, caseResults, options = {}) {
     const passedCases = caseResults.filter((result) => result.ok).length;
     const passedChecks = caseResults.reduce((total, result) => total + result.passedChecks, 0);
     const totalChecks = caseResults.reduce((total, result) => total + result.totalChecks, 0);
@@ -382,6 +384,7 @@ function buildBenchmarkTargetResult(target, caseResults) {
             path: target.path,
             workflow: target.workflow,
         },
+        ...(options.sandboxPath ? { sandbox_path: options.sandboxPath } : {}),
         ok: passedCases === caseResults.length,
         passedCases,
         totalCases: caseResults.length,
@@ -390,11 +393,11 @@ function buildBenchmarkTargetResult(target, caseResults) {
         caseResults,
     };
 }
-function buildBenchmarkRunResult(sourcePath, spec, results, executor) {
+function buildBenchmarkRunResult(sourcePath, spec, results, executor, generatedAt) {
     return {
         kind: "interf-benchmark-run",
         version: 1,
-        generated_at: new Date().toISOString(),
+        generated_at: generatedAt ?? new Date().toISOString(),
         benchmark: {
             id: spec.id,
             name: spec.name,
@@ -429,14 +432,17 @@ export function runBenchmark(sourcePath, spec, targets) {
     const results = targets.map((target) => buildBenchmarkTargetResult(target, spec.cases.map((benchmarkCase) => runBenchmarkCase(target, benchmarkCase))));
     return buildBenchmarkRunResult(sourcePath, spec, results);
 }
-export async function runBenchmarkWithJudge(sourcePath, spec, targets, executor) {
+export async function runBenchmarkWithJudge(sourcePath, spec, targets, executor, options = {}) {
+    const preserveMode = options.preserveSandboxes ?? "on-failure";
+    const generatedAt = new Date().toISOString();
+    const sandboxRunId = `${generatedAt.replace(/[:.]/g, "-")}-${spec.id}`;
     for (const target of targets) {
         if (target.type !== spec.type) {
             throw new Error(`Benchmark target type mismatch: expected ${spec.type}, got ${target.type}`);
         }
     }
     const results = [];
-    for (const target of targets) {
+    for (const [index, target] of targets.entries()) {
         const sandbox = createBenchmarkSandbox(target);
         try {
             const sandboxTarget = {
@@ -452,20 +458,36 @@ export async function runBenchmarkWithJudge(sourcePath, spec, targets, executor)
                     caseResults.push(await runBenchmarkCaseWithJudge(sandboxTarget, benchmarkCase, executor));
                 }
             }
-            results.push(buildBenchmarkTargetResult(target, caseResults));
+            let sandboxPath;
+            const targetResult = buildBenchmarkTargetResult(target, caseResults);
+            const shouldPreserveSandbox = preserveMode === "always" || !targetResult.ok;
+            if (shouldPreserveSandbox) {
+                const sandboxRoot = benchmarkSandboxesPath(sourcePath, target.type);
+                mkdirSync(sandboxRoot, { recursive: true });
+                const gitignorePath = benchmarkSandboxGitignorePath(sourcePath, target.type);
+                if (!existsSync(gitignorePath)) {
+                    writeFileSync(gitignorePath, "*\n!.gitignore\n");
+                }
+                const sandboxPathName = `${String(index + 1).padStart(2, "0")}-${normalizeBenchmarkId(target.name) || target.type}`;
+                sandbox.preserve(join(sandboxRoot, sandboxRunId, sandboxPathName));
+                sandboxPath = sandbox.targetPath;
+            }
+            results.push(buildBenchmarkTargetResult(target, caseResults, { sandboxPath }));
         }
         finally {
             sandbox.cleanup();
         }
     }
-    return buildBenchmarkRunResult(sourcePath, spec, results, executor);
+    return buildBenchmarkRunResult(sourcePath, spec, results, executor, generatedAt);
 }
 export async function runBenchmarkAuto(sourcePath, spec, targets, options) {
     if (spec.cases.some((benchmarkCase) => benchmarkCaseNeedsExecutor(benchmarkCase))) {
         if (!options?.executor) {
             throw new Error("This benchmark needs a live local executor, but no executor was provided.");
         }
-        return runBenchmarkWithJudge(sourcePath, spec, targets, options.executor);
+        return runBenchmarkWithJudge(sourcePath, spec, targets, options.executor, {
+            preserveSandboxes: options.preserveSandboxes,
+        });
     }
     return runBenchmark(sourcePath, spec, targets);
 }