@post-print/agent-harness 0.1.0

package/dist/context.js

@@ -0,0 +1,93 @@
+import { access, readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { loadSkillContext } from "./skills-context";
+const SHARED_SOURCES = ["AGENTS.md", ".claude/skills/README.md"];
+const CLAUDE_SOURCES = ["CLAUDE.md", "AGENTS.md"];
+const CURSOR_RULES_DIR = ".cursor/rules";
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readIfExists(cwd, rel) {
+    const path = join(cwd, rel);
+    if (!(await fileExists(path))) {
+        return null;
+    }
+    return readFile(path, "utf8");
+}
+async function loadCursorRules(cwd) {
+    const rulesDir = join(cwd, CURSOR_RULES_DIR);
+    if (!(await fileExists(rulesDir))) {
+        return [];
+    }
+    const entries = (await readdir(rulesDir)).filter((name) => name.endsWith(".mdc")).sort();
+    const loaded = [];
+    for (const name of entries) {
+        const rel = `${CURSOR_RULES_DIR}/${name}`;
+        const text = await readIfExists(cwd, rel);
+        if (text !== null) {
+            loaded.push({ rel, text });
+        }
+    }
+    return loaded;
+}
+function sourcesForProfile(profile) {
+    switch (profile) {
+        case "claude":
+            return [...SHARED_SOURCES, ...CLAUDE_SOURCES];
+        default:
+            return SHARED_SOURCES;
+    }
+}
+/** Load canonical agent context files from the repo. */
+export async function loadContext(options) {
+    const profile = options.profile ?? "shared";
+    const seen = new Set();
+    const parts = [];
+    const loaded = [];
+    for (const rel of sourcesForProfile(profile)) {
+        if (seen.has(rel)) {
+            continue;
+        }
+        seen.add(rel);
+        const text = await readIfExists(options.cwd, rel);
+        if (text === null) {
+            continue;
+        }
+        loaded.push(rel);
+        parts.push(`<!-- ${rel} -->\n${text}`);
+    }
+    if (profile === "cursor") {
+        for (const rule of await loadCursorRules(options.cwd)) {
+            if (seen.has(rule.rel)) {
+                continue;
+            }
+            seen.add(rule.rel);
+            loaded.push(rule.rel);
+            parts.push(`<!-- ${rule.rel} -->\n${rule.text}`);
+        }
+    }
+    const skillContext = await loadSkillContext(options.cwd, options.skills);
+    if (skillContext.preamble) {
+        for (const rel of skillContext.sources) {
+            if (!seen.has(rel)) {
+                seen.add(rel);
+                loaded.push(rel);
+            }
+        }
+        parts.push(skillContext.preamble);
+    }
+    return {
+        profile,
+        cwd: options.cwd,
+        sources: loaded,
+        preamble: parts.join("\n\n---\n\n"),
+        skillsMode: skillContext.mode,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/cursor-run.d.ts

@@ -0,0 +1,44 @@
+import { type SdkMessage } from "./capture";
+import type { AgentTrace } from "./types";
+export interface CursorRunOptions {
+    cwd: string;
+    prompt: string;
+    apiKey?: string;
+    model?: {
+        id: string;
+        params?: Array<{
+            id: string;
+            value: string;
+        }>;
+    };
+}
+export interface JudgeClassifierOptions {
+    cwd: string;
+    prompt: string;
+    apiKey?: string;
+    model?: {
+        id: string;
+        params?: Array<{
+            id: string;
+            value: string;
+        }>;
+    };
+}
+export interface JudgeClassifierResult {
+    status: string;
+    text: string;
+}
+export interface CursorRunResult {
+    status: string;
+    trace: AgentTrace;
+}
+/** Map Cursor SDK terminal status to harness run status. */
+export declare function normalizeSdkRunStatus(status: string): "completed" | "failed";
+/** Shared Cursor SDK path — Agent.create + send + wait (runs and judge use the same surface). */
+export declare function runCursorAgent(options: CursorRunOptions): Promise<CursorRunResult>;
+/** Classifier-only judge path — one-shot Agent.prompt, JSON reply, temperature 0 when supported. */
+export declare function runJudgeClassifier(options: JudgeClassifierOptions): Promise<JudgeClassifierResult>;
+/** Assistant prose from a Cursor SDK message stream (last assistant block wins for short replies). */
+export declare function assistantTextFromSdkMessages(messages: SdkMessage[]): string;
+export declare function textBlocksFromSdkMessage(event: SdkMessage): string;
+//# sourceMappingURL=cursor-run.d.ts.map

package/dist/cursor-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-run.d.ts","sourceRoot":"","sources":["../src/cursor-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,UAAU,EACf,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA0B1C,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CACtE;AAED,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;CAClB;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAE5E;AAED,iGAAiG;AACjG,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBxF;AAED,oGAAoG;AACpG,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC;AAED,sGAAsG;AACtG,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAS3E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqBlE"}

package/dist/cursor-run.js

@@ -0,0 +1,159 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { accumulateSdkEvent, createTraceAccumulator, finalizeTraceAccumulator, } from "./capture";
+/** Default local agent model; override with CURSOR_AGENT_MODEL or options.model. */
+const DEFAULT_CURSOR_MODEL = "auto";
+function judgeModelSelection(override) {
+    const id = override?.id ??
+        process.env.CURSOR_JUDGE_MODEL ??
+        process.env.CURSOR_AGENT_MODEL ??
+        DEFAULT_CURSOR_MODEL;
+    const params = override?.params ?? judgeModelParamsFromEnv();
+    return params ? { id, params } : { id };
+}
+function judgeModelParamsFromEnv() {
+    const raw = process.env.CURSOR_JUDGE_TEMPERATURE ?? "0";
+    if (!raw.trim()) {
+        return undefined;
+    }
+    return [{ id: "temperature", value: raw.trim() }];
+}
+/** Map Cursor SDK terminal status to harness run status. */
+export function normalizeSdkRunStatus(status) {
+    return status === "finished" || status === "completed" ? "completed" : "failed";
+}
+/** Shared Cursor SDK path — Agent.create + send + wait (runs and judge use the same surface). */
+export async function runCursorAgent(options) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const apiKey = options.apiKey ?? process.env.CURSOR_API_KEY;
+        if (!apiKey) {
+            throw new Error("CURSOR_API_KEY not set");
+        }
+        const sdkModule = await import("@cursor/sdk");
+        const modelId = options.model?.id ?? process.env.CURSOR_AGENT_MODEL ?? DEFAULT_CURSOR_MODEL;
+        const agent = __addDisposableResource(env_1, await sdkModule.Agent.create({
+            apiKey,
+            model: { id: modelId },
+            local: { cwd: options.cwd },
+        }), true);
+        const run = await agent.send(options.prompt);
+        const acc = createTraceAccumulator();
+        for await (const event of run.stream()) {
+            accumulateSdkEvent(acc, event);
+        }
+        const result = await run.wait();
+        return {
+            status: normalizeSdkRunStatus(result.status),
+            trace: finalizeTraceAccumulator(acc),
+        };
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        const result_1 = __disposeResources(env_1);
+        if (result_1)
+            await result_1;
+    }
+}
+/** Classifier-only judge path — one-shot Agent.prompt, JSON reply, temperature 0 when supported. */
+export async function runJudgeClassifier(options) {
+    const apiKey = options.apiKey ?? process.env.CURSOR_API_KEY;
+    if (!apiKey) {
+        throw new Error("CURSOR_API_KEY not set");
+    }
+    const sdkModule = await import("@cursor/sdk");
+    const result = await sdkModule.Agent.prompt(options.prompt, {
+        apiKey,
+        model: judgeModelSelection(options.model),
+        name: "agent-spec-judge",
+        local: { cwd: options.cwd },
+    });
+    const text = result.result?.trim() ?? "";
+    const status = result.status === "finished" ? "completed" : result.status;
+    return {
+        status: normalizeSdkRunStatus(status),
+        text,
+    };
+}
+/** Assistant prose from a Cursor SDK message stream (last assistant block wins for short replies). */
+export function assistantTextFromSdkMessages(messages) {
+    const chunks = [];
+    for (const event of messages) {
+        const text = textBlocksFromSdkMessage(event);
+        if (text.length > 0 && (event.type === "assistant" || event.message?.role === "assistant")) {
+            chunks.push(text);
+        }
+    }
+    return chunks.join("\n").trim();
+}
+export function textBlocksFromSdkMessage(event) {
+    const parts = [];
+    if (event.message?.content) {
+        for (const block of event.message.content) {
+            if (block.text) {
+                parts.push(block.text);
+            }
+        }
+    }
+    if (event.tool?.input !== undefined) {
+        parts.push(typeof event.tool.input === "string" ? event.tool.input : JSON.stringify(event.tool.input));
+    }
+    if (event.tool?.output) {
+        parts.push(event.tool.output);
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=cursor-run.js.map

package/dist/cursor-run.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { type LoadContextOptions, loadContext } from "./context";
+import type { AgentSession, ContextProfile, RunAgentOptions } from "./types";
+export type { SdkMessage } from "./capture";
+export type { AgentHost, AgentMessage, AgentSession, AgentToolCall, AgentTrace, ContextProfile, HostAdapter, LoadedContext, RoutingContract, RunAgentOptions, RunStatus, SkillContextMode, SkillContextOptions, SkillContextSetting, } from "./types";
+export { loadContext, type LoadContextOptions };
+export { ClaudeAdapter, CursorAdapter, createAdapter, ReplayAdapter, } from "./adapters";
+export { assistantPrefixBeforeTools, buildTraceFromSdkMessages, captureGitDiff, collapseTraceWhitespace, enrichTrace, extractShellCommands, extractShellCommandsFromToolCalls, extractSkillsAppliedFromText, extractSkillsInvokedFromText, extractSkillsInvokedFromToolCalls, handsOnTierBeforeTools, inferReviewDepthFromText, inferRoutingFromText, mergeSkillsInvoked, routingBlockBeforeTools, } from "./capture";
+export { assistantTextFromSdkMessages, type CursorRunOptions, type CursorRunResult, type JudgeClassifierOptions, type JudgeClassifierResult, runCursorAgent, runJudgeClassifier, textBlocksFromSdkMessage, } from "./cursor-run";
+export { type JudgeCriterion, type JudgeTraceOptions, type JudgeTraceResult, type JudgeVerdict, judgeTrace, type ParsedJudgeJson, parseJudgeJsonResponse, parseJudgeLegacyResponse, parseJudgeResponse, } from "./judge";
+export { buildRoutingContract } from "./routing-contract";
+export { loadSkillContext, normalizeSkillContext, type SkillCatalogEntry } from "./skills-context";
+export { captureWorkingTreeStatus, findWorkingTreeLeak, formatWorkingTreeLeak, } from "./working-tree-guard";
+export { cleanupStaleScenarioWorktrees, createScenarioWorktree, SCENARIO_WORKTREE_DIR_PREFIX, type ScenarioWorktree, } from "./worktree";
+export interface RunAgentInput extends Omit<RunAgentOptions, "context"> {
+    context?: RunAgentOptions["context"];
+    profile?: ContextProfile;
+}
+/** Run an agent session via the selected host adapter. */
+export declare function runAgent(input: RunAgentInput): Promise<AgentSession>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE7E,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,CAAC;AAChD,OAAO,EACN,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,cAAc,EACd,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,UAAU,EACV,KAAK,eAAe,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EACN,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,gBAAgB,GACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC;IACtE,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,0DAA0D;AAC1D,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAK1E"}

package/dist/index.js

@@ -0,0 +1,18 @@
+import { createAdapter } from "./adapters";
+import { loadContext } from "./context";
+export { loadContext };
+export { ClaudeAdapter, CursorAdapter, createAdapter, ReplayAdapter, } from "./adapters";
+export { assistantPrefixBeforeTools, buildTraceFromSdkMessages, captureGitDiff, collapseTraceWhitespace, enrichTrace, extractShellCommands, extractShellCommandsFromToolCalls, extractSkillsAppliedFromText, extractSkillsInvokedFromText, extractSkillsInvokedFromToolCalls, handsOnTierBeforeTools, inferReviewDepthFromText, inferRoutingFromText, mergeSkillsInvoked, routingBlockBeforeTools, } from "./capture";
+export { assistantTextFromSdkMessages, runCursorAgent, runJudgeClassifier, textBlocksFromSdkMessage, } from "./cursor-run";
+export { judgeTrace, parseJudgeJsonResponse, parseJudgeLegacyResponse, parseJudgeResponse, } from "./judge";
+export { buildRoutingContract } from "./routing-contract";
+export { loadSkillContext, normalizeSkillContext } from "./skills-context";
+export { captureWorkingTreeStatus, findWorkingTreeLeak, formatWorkingTreeLeak, } from "./working-tree-guard";
+export { cleanupStaleScenarioWorktrees, createScenarioWorktree, SCENARIO_WORKTREE_DIR_PREFIX, } from "./worktree";
+/** Run an agent session via the selected host adapter. */
+export async function runAgent(input) {
+    const context = input.context ?? (await loadContext({ cwd: input.cwd, profile: input.profile ?? "shared" }));
+    const adapter = createAdapter(input.host);
+    return adapter.run({ ...input, context });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAA2B,WAAW,EAAE,MAAM,WAAW,CAAC;AAqBjE,OAAO,EAAE,WAAW,EAA2B,CAAC;AAChD,OAAO,EACN,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,4BAA4B,EAK5B,cAAc,EACd,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAKN,UAAU,EAEV,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAA0B,MAAM,kBAAkB,CAAC;AACnG,OAAO,EACN,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,GAE5B,MAAM,YAAY,CAAC;AAOpB,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAoB;IAClD,MAAM,OAAO,GACZ,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/judge.d.ts

@@ -0,0 +1,35 @@
+import type { AgentTrace } from "./types";
+export interface JudgeCriterion {
+    id: string;
+    question: string;
+}
+export interface JudgeVerdict {
+    id: string;
+    pass: boolean;
+    rationale: string;
+    evidence?: string[];
+}
+export interface JudgeTraceOptions {
+    cwd: string;
+    apiKey?: string;
+}
+export interface JudgeTraceResult {
+    verdicts: JudgeVerdict[];
+    skipped: boolean;
+    error?: string;
+}
+export interface ParsedJudgeJson {
+    pass: boolean;
+    rationale: string;
+    evidence: string[];
+    valid: boolean;
+}
+/** Parse structured judge JSON (`verdict`, `evidence`, `rationale`). */
+export declare function parseJudgeJsonResponse(text: string): ParsedJudgeJson;
+/** Fallback when model ignores JSON contract — parse YES/NO prose. */
+export declare function parseJudgeLegacyResponse(text: string): ParsedJudgeJson;
+/** Parse structured JSON first, then legacy YES/NO prose. */
+export declare function parseJudgeResponse(text: string): ParsedJudgeJson;
+/** Score fuzzy rubric criteria with a structured JSON judge (live runs only). */
+export declare function judgeTrace(trace: AgentTrace, criteria: JudgeCriterion[], options: JudgeTraceOptions): Promise<JudgeTraceResult>;
+//# sourceMappingURL=judge.d.ts.map

package/dist/judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../src/judge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CACf;AAuBD,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAuCpE;AA+BD,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA4CtE;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAMhE;AA6DD,iFAAiF;AACjF,wBAAsB,UAAU,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B"}

package/dist/judge.js

@@ -0,0 +1,222 @@
+import { runJudgeClassifier } from "./cursor-run";
+const JSON_FENCE_PATTERN = /```(?:json)?\s*([\s\S]*?)```/i;
+const JSON_OBJECT_PATTERN = /\{[\s\S]*\}/;
+function transcriptForJudge(trace) {
+    return [
+        ...trace.messages.map((m) => m.content),
+        trace.prBody ?? "",
+        trace.gitDiff ? `Git diff:\n${trace.gitDiff}` : "",
+        trace.shellCommands.length > 0 ? `Shell commands:\n${trace.shellCommands.join("\n")}` : "",
+    ]
+        .filter(Boolean)
+        .join("\n\n---\n\n");
+}
+function normalizeVerdict(value) {
+    const verdict = String(value ?? "")
+        .trim()
+        .toLowerCase();
+    if (verdict === "yes" || verdict === "no") {
+        return verdict;
+    }
+    return undefined;
+}
+/** Parse structured judge JSON (`verdict`, `evidence`, `rationale`). */
+export function parseJudgeJsonResponse(text) {
+    const trimmed = text.trim();
+    const candidates = [trimmed];
+    const fenced = trimmed.match(JSON_FENCE_PATTERN);
+    if (fenced?.[1]) {
+        candidates.unshift(fenced[1].trim());
+    }
+    const objectMatch = trimmed.match(JSON_OBJECT_PATTERN);
+    if (objectMatch?.[0]) {
+        candidates.push(objectMatch[0]);
+    }
+    for (const candidate of candidates) {
+        try {
+            const parsed = JSON.parse(candidate);
+            const verdict = normalizeVerdict(parsed.verdict);
+            if (verdict !== undefined) {
+                return {
+                    pass: verdict === "yes",
+                    rationale: String(parsed.rationale ?? "").trim() || "no rationale",
+                    evidence: Array.isArray(parsed.evidence)
+                        ? parsed.evidence.map((item) => String(item)).filter(Boolean)
+                        : [],
+                    valid: true,
+                };
+            }
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return {
+        pass: false,
+        rationale: "judge returned invalid JSON (expected { verdict, evidence, rationale })",
+        evidence: [],
+        valid: false,
+    };
+}
+const JUDGE_MARKDOWN_TRIM_PATTERN = /^\*+\s*|\s*\*+$/g;
+const JUDGE_VERDICT_PREFIX_PATTERN = /^(?:answer|verdict|line\s*1)\s*:\s*/i;
+const JUDGE_TRAILING_PUNCT_PATTERN = /[.:!]+$/g;
+const JUDGE_TAIL_VERDICT_PATTERN = /\b(YES|NO)\.?\s*$/i;
+const JUDGE_INLINE_VERDICT_PATTERN = /\b(YES|NO)\b/i;
+function extractLegacyVerdict(line) {
+    const stripped = line
+        .replace(JUDGE_MARKDOWN_TRIM_PATTERN, "")
+        .replace(JUDGE_VERDICT_PREFIX_PATTERN, "")
+        .trim();
+    const head = stripped.replace(JUDGE_TRAILING_PUNCT_PATTERN, "").toUpperCase();
+    if (head === "YES" || head.startsWith("YES ")) {
+        return "yes";
+    }
+    if (head === "NO" || head.startsWith("NO ")) {
+        return "no";
+    }
+    const tailMatch = stripped.match(JUDGE_TAIL_VERDICT_PATTERN);
+    if (tailMatch?.[1]) {
+        return tailMatch[1].toLowerCase();
+    }
+    const inlineMatch = stripped.match(JUDGE_INLINE_VERDICT_PATTERN);
+    if (inlineMatch?.[1]) {
+        return inlineMatch[1].toLowerCase();
+    }
+    return undefined;
+}
+/** Fallback when model ignores JSON contract — parse YES/NO prose. */
+export function parseJudgeLegacyResponse(text) {
+    const lines = text
+        .trim()
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    for (let index = 0; index < Math.min(lines.length, 3); index++) {
+        const line = lines[index];
+        if (!line) {
+            continue;
+        }
+        const verdict = extractLegacyVerdict(line);
+        if (verdict !== undefined) {
+            const rationale = lines
+                .filter((_, i) => i !== index)
+                .join(" ")
+                .trim() || line.replace(JUDGE_TAIL_VERDICT_PATTERN, "").trim();
+            return {
+                pass: verdict === "yes",
+                rationale: rationale || line,
+                evidence: [],
+                valid: true,
+            };
+        }
+    }
+    const fallback = extractLegacyVerdict(lines[0] ?? text.trim());
+    if (fallback !== undefined) {
+        return {
+            pass: fallback === "yes",
+            rationale: lines.slice(1).join(" ").trim() || lines[0] || text,
+            evidence: [],
+            valid: true,
+        };
+    }
+    return {
+        pass: false,
+        rationale: "judge returned invalid JSON (expected { verdict, evidence, rationale })",
+        evidence: [],
+        valid: false,
+    };
+}
+/** Parse structured JSON first, then legacy YES/NO prose. */
+export function parseJudgeResponse(text) {
+    const json = parseJudgeJsonResponse(text);
+    if (json.valid) {
+        return json;
+    }
+    return parseJudgeLegacyResponse(text);
+}
+function buildJudgePrompt(transcript, question) {
+    return [
+        "You are a test harness classifier. Do not use tools. Do not edit files.",
+        "Decide whether the transcript satisfies the criterion using only transcript evidence.",
+        "Reply with one JSON object only — no markdown fences, no text before or after:",
+        '{"verdict":"yes"|"no","evidence":["verbatim quote from transcript"],"rationale":"one sentence"}',
+        'Use verdict "yes" only when evidence clearly supports the criterion.',
+        "",
+        "Transcript:",
+        transcript,
+        "",
+        `Criterion: ${question}`,
+    ].join("\n");
+}
+async function runJudgePrompt(prompt, options) {
+    const apiKey = options.apiKey ?? process.env.CURSOR_API_KEY;
+    if (!apiKey) {
+        return {
+            pass: false,
+            rationale: "CURSOR_API_KEY not set",
+            evidence: [],
+            error: "missing api key",
+        };
+    }
+    try {
+        const result = await runJudgeClassifier({
+            cwd: options.cwd,
+            prompt,
+            apiKey,
+        });
+        if (result.status !== "completed") {
+            return {
+                pass: false,
+                rationale: `judge run status: ${result.status}`,
+                evidence: [],
+                error: `judge run status: ${result.status}`,
+            };
+        }
+        const parsed = parseJudgeResponse(result.text);
+        if (!parsed.valid) {
+            return {
+                pass: false,
+                rationale: `${parsed.rationale} (raw: ${result.text.slice(0, 160) || "empty"})`,
+                evidence: [],
+                error: parsed.rationale,
+            };
+        }
+        return { pass: parsed.pass, rationale: parsed.rationale, evidence: parsed.evidence };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "judge prompt failed";
+        return { pass: false, rationale: message, evidence: [], error: message };
+    }
+}
+/** Score fuzzy rubric criteria with a structured JSON judge (live runs only). */
+export async function judgeTrace(trace, criteria, options) {
+    if (criteria.length === 0) {
+        return { verdicts: [], skipped: true };
+    }
+    const apiKey = options.apiKey ?? process.env.CURSOR_API_KEY;
+    if (!apiKey) {
+        return {
+            verdicts: [],
+            skipped: true,
+            error: "CURSOR_API_KEY not set — judge criteria skipped",
+        };
+    }
+    const transcript = transcriptForJudge(trace);
+    const verdicts = [];
+    for (const criterion of criteria) {
+        const prompt = buildJudgePrompt(transcript, criterion.question);
+        const parsed = await runJudgePrompt(prompt, { ...options, apiKey });
+        verdicts.push({
+            id: criterion.id,
+            pass: parsed.pass,
+            rationale: parsed.rationale,
+            evidence: parsed.evidence,
+        });
+        if (parsed.error) {
+            return { verdicts, skipped: false, error: parsed.error };
+        }
+    }
+    return { verdicts, skipped: false };
+}
+//# sourceMappingURL=judge.js.map

package/dist/judge.js.map

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

package/dist/routing-contract.d.ts

@@ -0,0 +1,4 @@
+export type RoutingContract = "hands-on" | "hands-off";
+/** Live dogfood output contract derived from agent-routing.md (not scenario answer keys). */
+export declare function buildRoutingContract(mode: RoutingContract): string;
+//# sourceMappingURL=routing-contract.d.ts.map

package/dist/routing-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-contract.d.ts","sourceRoot":"","sources":["../src/routing-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,CAAC;AAEvD,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAoBlE"}