@post-print/agent-harness 0.1.0

package/dist/routing-contract.js

@@ -0,0 +1,22 @@
+/** Live dogfood output contract derived from agent-routing.md (not scenario answer keys). */
+export function buildRoutingContract(mode) {
+    if (mode === "hands-off") {
+        return [
+            "Output contract (mandatory — first lines of your reply, before tools or other prose):",
+            "Print the PR § Routing block from agent-routing.md exactly as markdown:",
+            "## Routing",
+            "- **Tier:** Low | Medium | High",
+            "- **Signals:** …",
+            "- **Invariant applied:** …",
+            "- **Escalations:** none | …",
+            "- **Open questions:** none | …",
+            "Do not call tools or write planning text until this block is complete.",
+        ].join("\n");
+    }
+    return [
+        "Output contract (before any tools or edits):",
+        "Announce routing per agent-routing.md hands-on rule — one line with tier, e.g.:",
+        "  Tier: low — …   OR   Medium — …   OR   Routing: Medium — …",
+    ].join("\n");
+}
+//# sourceMappingURL=routing-contract.js.map

package/dist/routing-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-contract.js","sourceRoot":"","sources":["../src/routing-contract.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,IAAqB;IACzD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO;YACN,uFAAuF;YACvF,yEAAyE;YACzE,YAAY;YACZ,iCAAiC;YACjC,kBAAkB;YAClB,4BAA4B;YAC5B,6BAA6B;YAC7B,gCAAgC;YAChC,wEAAwE;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,OAAO;QACN,8CAA8C;QAC9C,iFAAiF;QACjF,8DAA8D;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/skills-context.d.ts

@@ -0,0 +1,25 @@
+export type SkillContextMode = "none" | "catalog" | "full";
+export interface SkillContextOptions {
+    mode: SkillContextMode;
+    /** Full mode: load only these skill folder names. Omit = all public skills. */
+    include?: string[];
+}
+export type SkillContextSetting = SkillContextMode | SkillContextOptions;
+export interface SkillCatalogEntry {
+    name: string;
+    dir: string;
+    relPath: string;
+    description: string;
+    disableModelInvocation: boolean;
+}
+declare function normalizeSkillContext(setting: SkillContextSetting | undefined): SkillContextOptions;
+export interface LoadedSkillContext {
+    mode: SkillContextMode;
+    sources: string[];
+    preamble: string;
+    catalog: SkillCatalogEntry[];
+}
+/** Load skill catalog index and/or full SKILL.md bodies for agent preamble. */
+export declare function loadSkillContext(cwd: string, setting: SkillContextSetting | undefined): Promise<LoadedSkillContext>;
+export { normalizeSkillContext };
+//# sourceMappingURL=skills-context.d.ts.map

package/dist/skills-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-context.d.ts","sourceRoot":"","sources":["../src/skills-context.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,OAAO,CAAC;CAChC;AAsBD,iBAAS,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,mBAAmB,CAQ5F;AAiED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACtC,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/skills-context.js

@@ -0,0 +1,120 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+const SKILLS_ROOT = ".claude/skills";
+const INTERNAL_SKILL_NAMES = new Set(["align-commands"]);
+const FRONTMATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n---/;
+function parseFrontmatter(raw) {
+    const match = FRONTMATTER_PATTERN.exec(raw);
+    if (!match?.[1]) {
+        return {};
+    }
+    const fields = {};
+    for (const line of match[1].split("\n")) {
+        const colon = line.indexOf(":");
+        if (colon === -1) {
+            continue;
+        }
+        const key = line.slice(0, colon).trim();
+        const value = line.slice(colon + 1).trim();
+        if (key) {
+            fields[key] = value;
+        }
+    }
+    return fields;
+}
+function normalizeSkillContext(setting) {
+    if (!setting) {
+        return { mode: "none" };
+    }
+    if (typeof setting === "string") {
+        return { mode: setting };
+    }
+    return setting;
+}
+async function discoverSkills(cwd) {
+    const skillsDir = join(cwd, SKILLS_ROOT);
+    let entries;
+    try {
+        entries = await readdir(skillsDir, { withFileTypes: true }).then((items) => items.filter((item) => item.isDirectory()).map((item) => item.name));
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const dir of entries.sort()) {
+        const relPath = `${SKILLS_ROOT}/${dir}/SKILL.md`;
+        const absPath = join(cwd, relPath);
+        let raw;
+        try {
+            raw = await readFile(absPath, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const frontmatter = parseFrontmatter(raw);
+        const name = frontmatter.name ?? dir;
+        if (INTERNAL_SKILL_NAMES.has(name) || INTERNAL_SKILL_NAMES.has(dir)) {
+            continue;
+        }
+        skills.push({
+            name,
+            dir,
+            relPath,
+            description: frontmatter.description ?? "",
+            disableModelInvocation: frontmatter["disable-model-invocation"] === "true",
+        });
+    }
+    return skills;
+}
+function filterSkills(skills, include) {
+    if (!include?.length) {
+        return skills;
+    }
+    const wanted = new Set(include.map((name) => name.toLowerCase()));
+    return skills.filter((skill) => wanted.has(skill.name.toLowerCase()) || wanted.has(skill.dir));
+}
+function buildCatalogSection(skills) {
+    const lines = [
+        "## Skill catalog (available skills — read SKILL.md before following a skill)",
+        "",
+        "| Skill | Path | Invocation | Description |",
+        "|-------|------|------------|-------------|",
+    ];
+    for (const skill of skills) {
+        const invocation = skill.disableModelInvocation ? "user-invoked" : "model-invoked";
+        const description = skill.description.replace(/\|/g, "\\|");
+        lines.push(`| ${skill.name} | \`${skill.relPath}\` | ${invocation} | ${description} |`);
+    }
+    return lines.join("\n");
+}
+/** Load skill catalog index and/or full SKILL.md bodies for agent preamble. */
+export async function loadSkillContext(cwd, setting) {
+    const options = normalizeSkillContext(setting);
+    if (options.mode === "none") {
+        return { mode: "none", sources: [], preamble: "", catalog: [] };
+    }
+    const allSkills = await discoverSkills(cwd);
+    const skills = filterSkills(allSkills, options.include);
+    const sources = [];
+    const parts = [];
+    if (options.mode === "catalog" || options.mode === "full") {
+        parts.push(buildCatalogSection(skills));
+        sources.push(`${SKILLS_ROOT}/catalog`);
+    }
+    if (options.mode === "full") {
+        for (const skill of skills) {
+            const absPath = join(cwd, skill.relPath);
+            const body = await readFile(absPath, "utf8");
+            sources.push(skill.relPath);
+            parts.push(`<!-- ${skill.relPath} -->\n${body}`);
+        }
+    }
+    return {
+        mode: options.mode,
+        sources,
+        preamble: parts.join("\n\n---\n\n"),
+        catalog: skills,
+    };
+}
+export { normalizeSkillContext };
+//# sourceMappingURL=skills-context.js.map

package/dist/skills-context.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+export type AgentHost = "cursor" | "claude" | "replay";
+import type { RoutingContract } from "./routing-contract";
+import type { SkillContextMode } from "./skills-context";
+export type { RoutingContract } from "./routing-contract";
+export type { SkillContextMode, SkillContextOptions, SkillContextSetting } from "./skills-context";
+/** Which entry router to inject alongside shared skills context. */
+export type ContextProfile = "shared" | "cursor" | "claude";
+export interface AgentMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+}
+export interface AgentToolCall {
+    name: string;
+    args?: Record<string, unknown>;
+}
+export interface AgentTrace {
+    messages: AgentMessage[];
+    toolCalls: AgentToolCall[];
+    shellCommands: string[];
+    /** Skill folder names inferred from Read tool paths (e.g. grill, crystallize). */
+    skillsInvoked?: string[];
+    gitDiff?: string;
+    prBody?: string;
+    artifacts: Record<string, string>;
+    routing?: {
+        tier?: "low" | "medium" | "high";
+        signals?: string[];
+        invariantApplied?: string[];
+        escalations?: string[];
+    };
+    /** Live SDK: assistant prose before the first tool call. Replay: omit (all messages[] precede toolCalls[]). */
+    assistantTextBeforeTools?: string;
+    judgeVerdicts?: Array<{
+        id: string;
+        pass: boolean;
+        rationale: string;
+    }>;
+    raw?: unknown;
+}
+export interface LoadedContext {
+    profile: ContextProfile;
+    cwd: string;
+    /** Repo-relative paths loaded for the agent prompt preamble. */
+    sources: string[];
+    preamble: string;
+    /** Skill catalog / full SKILL.md loading mode when enabled. */
+    skillsMode?: SkillContextMode;
+}
+export interface RunAgentOptions {
+    host: AgentHost;
+    cwd: string;
+    context: LoadedContext;
+    prompt: string;
+    /** Live dogfood: rubric-derived hands-off ## Routing contract (not the user prompt). */
+    outputContract?: RoutingContract;
+    /** Required when host is replay. */
+    replayTracePath?: string;
+    env?: Record<string, string>;
+}
+export type RunStatus = "completed" | "failed" | "skipped";
+export interface AgentSession {
+    host: AgentHost;
+    status: RunStatus;
+    trace: AgentTrace;
+    durationMs: number;
+    error?: string;
+}
+export interface HostAdapter {
+    readonly host: AgentHost;
+    run(options: RunAgentOptions): Promise<AgentSession>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEnG,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,+GAA+G;IAC/G,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,KAAK,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACrD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/working-tree-guard.d.ts

@@ -0,0 +1,6 @@
+/** Porcelain snapshot of the caller repo root — used to detect live-run leakage. */
+export declare function captureWorkingTreeStatus(repoRoot: string): Promise<string>;
+/** Lines present after a scenario that were not in the before snapshot. */
+export declare function findWorkingTreeLeak(before: string, after: string): string[];
+export declare function formatWorkingTreeLeak(lines: string[]): string;
+//# sourceMappingURL=working-tree-guard.d.ts.map

package/dist/working-tree-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-tree-guard.d.ts","sourceRoot":"","sources":["../src/working-tree-guard.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAM3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D"}

package/dist/working-tree-guard.js

@@ -0,0 +1,20 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Porcelain snapshot of the caller repo root — used to detect live-run leakage. */
+export async function captureWorkingTreeStatus(repoRoot) {
+    const { stdout } = await execFileAsync("git", ["status", "--porcelain"], { cwd: repoRoot });
+    return stdout.trim();
+}
+/** Lines present after a scenario that were not in the before snapshot. */
+export function findWorkingTreeLeak(before, after) {
+    const beforeLines = new Set(before.split("\n").filter(Boolean));
+    return after
+        .split("\n")
+        .filter(Boolean)
+        .filter((line) => !beforeLines.has(line));
+}
+export function formatWorkingTreeLeak(lines) {
+    return lines.join("\n");
+}
+//# sourceMappingURL=working-tree-guard.js.map

package/dist/working-tree-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-tree-guard.js","sourceRoot":"","sources":["../src/working-tree-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,KAAa;IAChE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,OAAO,KAAK;SACV,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/worktree.d.ts

@@ -0,0 +1,10 @@
+export declare const SCENARIO_WORKTREE_DIR_PREFIX = "agent-harness-wt-";
+export interface ScenarioWorktree {
+    path: string;
+    cleanup: () => Promise<void>;
+}
+/** Remove orphaned agent-test worktrees left after SIGKILL (exit 137) or crash. */
+export declare function cleanupStaleScenarioWorktrees(repoRoot: string): Promise<string[]>;
+/** Detached git worktree so live agent runs do not mutate the caller's working tree. */
+export declare function createScenarioWorktree(repoRoot: string, label: string): Promise<ScenarioWorktree>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAwBD,mFAAmF;AACnF,wBAAsB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcvF;AAED,wFAAwF;AACxF,wBAAsB,sBAAsB,CAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}

package/dist/worktree.js

@@ -0,0 +1,58 @@
+import { execFile } from "node:child_process";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const WORKTREE_LIST_PATH_SPLIT = /\s+/;
+export const SCENARIO_WORKTREE_DIR_PREFIX = "agent-harness-wt-";
+function slugify(label) {
+    return label
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48);
+}
+async function removeWorktreeAt(repoRoot, worktreePath) {
+    try {
+        await execFileAsync("git", ["worktree", "remove", "--force", worktreePath], {
+            cwd: repoRoot,
+        });
+    }
+    catch {
+        // Best-effort when worktree is already gone.
+    }
+    const parent = dirname(worktreePath);
+    if (parent.includes(SCENARIO_WORKTREE_DIR_PREFIX)) {
+        await rm(parent, { recursive: true, force: true });
+    }
+}
+/** Remove orphaned agent-test worktrees left after SIGKILL (exit 137) or crash. */
+export async function cleanupStaleScenarioWorktrees(repoRoot) {
+    const { stdout } = await execFileAsync("git", ["worktree", "list"], { cwd: repoRoot });
+    const removed = [];
+    for (const line of stdout.split("\n")) {
+        const path = line.split(WORKTREE_LIST_PATH_SPLIT)[0];
+        if (!path?.includes(SCENARIO_WORKTREE_DIR_PREFIX)) {
+            continue;
+        }
+        await removeWorktreeAt(repoRoot, path);
+        removed.push(path);
+    }
+    return removed;
+}
+/** Detached git worktree so live agent runs do not mutate the caller's working tree. */
+export async function createScenarioWorktree(repoRoot, label) {
+    const parent = await mkdtemp(join(tmpdir(), SCENARIO_WORKTREE_DIR_PREFIX));
+    const worktreePath = join(parent, slugify(label) || "scenario");
+    await execFileAsync("git", ["worktree", "add", "--detach", worktreePath, "HEAD"], {
+        cwd: repoRoot,
+    });
+    return {
+        path: worktreePath,
+        cleanup: async () => {
+            await removeWorktreeAt(repoRoot, worktreePath);
+        },
+    };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@post-print/agent-harness",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "bunx tsc --build",
+		"typecheck": "bunx tsc --build",
+		"lint": "bunx biome check .",
+		"lint:fix": "bunx biome check . --write",
+		"test": "vitest run --passWithNoTests",
+		"clean": "rm -rf dist tsconfig.tsbuildinfo"
+	},
+	"dependencies": {},
+	"peerDependencies": {
+		"@cursor/sdk": ">=0.1.0"
+	},
+	"peerDependenciesMeta": {
+		"@cursor/sdk": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@cursor/sdk": "^1.0.23",
+		"@types/node": "^22.10.0",
+		"typescript": "~6.0.2",
+		"vitest": "^4.0.17"
+	},
+	"description": "Host-agnostic agent runtime for capture, replay, and judging",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/post-print/agent-spec.git",
+		"directory": "packages/harness"
+	},
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	}
+}