@post-print/agent-harness 0.1.0

package/README.md

@@ -0,0 +1,18 @@
+# @post-print/agent-harness
+
+Host-agnostic agent runtime for capture, replay, and judging.
+
+```ts
+import { runAgent, loadContext, judgeTrace, createScenarioWorktree } from "@post-print/agent-harness";
+
+const context = await loadContext({ cwd: process.cwd(), profile: "cursor" });
+const session = await runAgent({
+  host: "replay",
+  cwd: context.cwd,
+  context,
+  prompt: "…",
+  replayTracePath: "agent-suites/example/fixtures/replays/trace.json",
+});
+```
+
+Consumer: `@post-print/agent-test`.

package/dist/adapters/index.d.ts

@@ -0,0 +1,15 @@
+import type { AgentSession, HostAdapter, RunAgentOptions } from "../types";
+import { ReplayAdapter } from "./replay";
+/** Cursor SDK adapter — requires optional @cursor/sdk peer + CURSOR_API_KEY. */
+export declare class CursorAdapter implements HostAdapter {
+    readonly host: "cursor";
+    run(options: RunAgentOptions): Promise<AgentSession>;
+}
+/** Claude Code CLI adapter — stub until structured headless output is wired. */
+export declare class ClaudeAdapter implements HostAdapter {
+    readonly host: "claude";
+    run(_options: RunAgentOptions): Promise<AgentSession>;
+}
+export declare function createAdapter(host: RunAgentOptions["host"]): HostAdapter;
+export { ReplayAdapter };
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAYzC,gFAAgF;AAChF,qBAAa,aAAc,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;CAkC1D;AAED,gFAAgF;AAChF,qBAAa,aAAc,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;CAM3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,WAAW,CASxE;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,65 @@
+import { captureGitDiff, enrichTrace } from "../capture";
+import { runCursorAgent } from "../cursor-run";
+import { buildRoutingContract } from "../routing-contract";
+import { ReplayAdapter } from "./replay";
+function emptyFailed(host, error) {
+    return {
+        host,
+        status: "skipped",
+        trace: { messages: [], toolCalls: [], shellCommands: [], artifacts: {} },
+        durationMs: 0,
+        error,
+    };
+}
+/** Cursor SDK adapter — requires optional @cursor/sdk peer + CURSOR_API_KEY. */
+export class CursorAdapter {
+    host = "cursor";
+    async run(options) {
+        if (!process.env.CURSOR_API_KEY) {
+            return emptyFailed(this.host, "CURSOR_API_KEY not set — use host replay or set API key for live runs");
+        }
+        try {
+            const started = performance.now();
+            const contract = options.outputContract
+                ? `\n\n${buildRoutingContract(options.outputContract)}\n`
+                : "";
+            const prompt = `${options.context.preamble}\n\n---\n${contract}Task:\n${options.prompt}`;
+            const { trace: streamedTrace, status } = await runCursorAgent({
+                cwd: options.cwd,
+                prompt,
+            });
+            const gitDiff = await captureGitDiff(options.cwd);
+            const trace = enrichTrace({ ...streamedTrace, gitDiff });
+            return {
+                host: this.host,
+                status: status === "completed" ? "completed" : "failed",
+                trace,
+                durationMs: Math.round(performance.now() - started),
+                error: status !== "completed" ? `cursor run status: ${status}` : undefined,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Failed to load or run @cursor/sdk";
+            return emptyFailed(this.host, message);
+        }
+    }
+}
+/** Claude Code CLI adapter — stub until structured headless output is wired. */
+export class ClaudeAdapter {
+    host = "claude";
+    async run(_options) {
+        return emptyFailed(this.host, "Claude Code adapter not implemented — use host replay or export session to trace JSON");
+    }
+}
+export function createAdapter(host) {
+    switch (host) {
+        case "cursor":
+            return new CursorAdapter();
+        case "claude":
+            return new ClaudeAdapter();
+        default:
+            return new ReplayAdapter();
+    }
+}
+export { ReplayAdapter };
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

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

package/dist/adapters/replay.d.ts

@@ -0,0 +1,7 @@
+import type { AgentSession, HostAdapter, RunAgentOptions } from "../types";
+/** Replay a committed trace JSON — host-agnostic scoring path. */
+export declare class ReplayAdapter implements HostAdapter {
+    readonly host: "replay";
+    run(options: RunAgentOptions): Promise<AgentSession>;
+}
+//# sourceMappingURL=replay.d.ts.map

package/dist/adapters/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/adapters/replay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAc,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoCvF,kEAAkE;AAClE,qBAAa,aAAc,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;CA8B1D"}

package/dist/adapters/replay.js

@@ -0,0 +1,61 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+function emptyTrace() {
+    return {
+        messages: [],
+        toolCalls: [],
+        shellCommands: [],
+        artifacts: {},
+    };
+}
+function isAgentTrace(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const trace = value;
+    return (Array.isArray(trace.messages) &&
+        Array.isArray(trace.toolCalls) &&
+        Array.isArray(trace.shellCommands) &&
+        typeof trace.artifacts === "object" &&
+        trace.artifacts !== null &&
+        !Array.isArray(trace.artifacts));
+}
+function failedReplay(started, error) {
+    return {
+        host: "replay",
+        status: "failed",
+        trace: emptyTrace(),
+        durationMs: Math.round(performance.now() - started),
+        error,
+    };
+}
+/** Replay a committed trace JSON — host-agnostic scoring path. */
+export class ReplayAdapter {
+    host = "replay";
+    async run(options) {
+        const started = performance.now();
+        if (!options.replayTracePath) {
+            return failedReplay(started, "replay host requires replayTracePath");
+        }
+        const path = resolve(options.cwd, options.replayTracePath);
+        let parsed;
+        try {
+            const raw = await readFile(path, "utf8");
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "failed to read replay trace";
+            return failedReplay(started, `invalid replay trace: ${message}`);
+        }
+        if (!isAgentTrace(parsed)) {
+            return failedReplay(started, "invalid replay trace: expected messages, toolCalls, shellCommands, and artifacts");
+        }
+        return {
+            host: this.host,
+            status: "completed",
+            trace: { ...parsed, raw: parsed },
+            durationMs: Math.round(performance.now() - started),
+        };
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/adapters/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/adapters/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,SAAS,UAAU;IAClB,OAAO;QACN,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,EAAE;QACjB,SAAS,EAAE,EAAE;KACb,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,KAAmB,CAAC;IAClC,OAAO,CACN,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;QAClC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,KAAK,CAAC,SAAS,KAAK,IAAI;QACxB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAC/B,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,KAAa;IACnD,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,UAAU,EAAE;QACnB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QACnD,KAAK;KACL,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,OAAO,aAAa;IAChB,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CAAC,GAAG,CAAC,OAAwB;QACjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC9B,OAAO,YAAY,CAAC,OAAO,EAAE,sCAAsC,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;YACvF,OAAO,YAAY,CAAC,OAAO,EAAE,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,YAAY,CAClB,OAAO,EACP,kFAAkF,CAClF,CAAC;QACH,CAAC;QAED,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;YACjC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;SACnD,CAAC;IACH,CAAC;CACD"}

package/dist/capture.d.ts

@@ -0,0 +1,69 @@
+import type { AgentMessage, AgentToolCall, AgentTrace } from "./types";
+/** Collect git diff after a live agent run. */
+export declare function captureGitDiff(cwd: string): Promise<string | undefined>;
+/** Extract shell commands from structured tool call args (Cursor SDK shell tools). */
+export declare function extractShellCommandsFromToolCalls(toolCalls: AgentToolCall[]): string[];
+/** Collapse whitespace so SDK token-chunked assistant prose still matches rubric patterns. */
+export declare function collapseTraceWhitespace(text: string): string;
+/** Infer skill folder names from Read tool paths in tool calls. */
+export declare function extractSkillsInvokedFromToolCalls(toolCalls: AgentToolCall[]): string[];
+/** Infer skill reads referenced in assistant prose. */
+export declare function extractSkillsInvokedFromText(...chunks: string[]): string[];
+/** Infer explicit skill sessions when SKILL.md is already in preamble (full catalog mode). */
+export declare function extractSkillsAppliedFromText(...chunks: string[]): string[];
+/** Infer code-review depth from synthesis status line (`Review · staged · Standard`). */
+export declare function inferReviewDepthFromText(text: string): "quick" | "standard" | "thorough" | "full" | undefined;
+export declare function mergeSkillsInvoked(...lists: Array<string[] | undefined>): string[];
+/** Pull shell-like commands from assistant prose and tool output. */
+export declare function extractShellCommands(...chunks: string[]): string[];
+/** Infer routing metadata from live agent prose when not structured. */
+/** Assistant prose before the first tool call (SDK order, or replay messages[]). */
+export declare function assistantPrefixBeforeTools(trace: AgentTrace): string;
+export declare function inferRoutingFromText(text: string): AgentTrace["routing"] | undefined;
+export declare function inferPrBodyFromText(text: string): string | undefined;
+/** Hands-off: ## Routing block appears in assistant text before the first tool call. */
+export declare function routingBlockBeforeTools(trace: AgentTrace): boolean;
+/** Hands-on: tier announce appears in assistant text before the first tool call. */
+export declare function handsOnTierBeforeTools(trace: AgentTrace, tier: NonNullable<AgentTrace["routing"]>["tier"]): boolean;
+export interface SdkTextBlock {
+    type: string;
+    text?: string;
+}
+export interface SdkToolPayload {
+    name?: string;
+    input?: unknown;
+    output?: string;
+}
+export interface SdkMessage {
+    type?: string;
+    /** Cursor SDK tool_call — tool name at event root (read, shell, edit, …). */
+    name?: string;
+    args?: Record<string, unknown>;
+    message?: {
+        role?: string;
+        content?: SdkTextBlock[];
+    };
+    tool?: SdkToolPayload;
+}
+export interface TraceAccumulator {
+    agentMessages: AgentMessage[];
+    inferenceChunks: string[];
+    textChunks: string[];
+    toolOutputChunks: string[];
+    toolCalls: AgentToolCall[];
+    preToolAssistantChunks: string[];
+    hasSeenTool: boolean;
+}
+export declare function createTraceAccumulator(): TraceAccumulator;
+/** Fold one SDK stream event into trace fields without retaining the raw event. */
+export declare function accumulateSdkEvent(acc: TraceAccumulator, event: SdkMessage): void;
+export declare function finalizeTraceAccumulator(acc: TraceAccumulator, options?: {
+    gitDiff?: string;
+}): AgentTrace;
+/** Normalize Cursor SDK messages into AgentTrace fields. */
+export declare function buildTraceFromSdkMessages(messages: SdkMessage[], options?: {
+    gitDiff?: string;
+}): AgentTrace;
+/** Fill routing / PR body from transcript when live runs omit structured fields. */
+export declare function enrichTrace(trace: AgentTrace): AgentTrace;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

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

package/dist/capture.js

@@ -0,0 +1,352 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { textBlocksFromSdkMessage } from "./cursor-run";
+const execFileAsync = promisify(execFile);
+const SHELL_COMMAND_PATTERN = /\b(bun run [\w:./-]+|validate:changed[\w ./:-]*|bunx [\w ./:-]+)/gi;
+const TIER_PATTERN = /\*\*Tier:\*\*\s*(low|medium|high)\b/i;
+const TIER_INLINE_PATTERN = /\bTier:\s*(low|medium|high)\b/i;
+/** Hands-on one-line announce: "Medium — fuzzy intent" (em/en dash only, not hyphenated words) */
+const TIER_LEADING_WORD_PATTERN = /\b(Low|Medium|High)\s*[—–]/i;
+/** Hands-on inline: "**Routing:** Medium", "Routing: Medium", "Routing: **Low**" */
+const ROUTING_LABEL_TIER_PATTERN = /\*\*Routing:\*\*\s*(?:\*\*)?(Low|Medium|High)\b|\bRouting:\s*(?:\*\*)?(Low|Medium|High)\b/i;
+const HANDS_ON_TIER_PATTERNS = [
+    TIER_PATTERN,
+    TIER_INLINE_PATTERN,
+    TIER_LEADING_WORD_PATTERN,
+    ROUTING_LABEL_TIER_PATTERN,
+];
+function tierFromMatch(match) {
+    const raw = match[1] ?? match[2];
+    const tier = raw?.toLowerCase();
+    if (tier === "low" || tier === "medium" || tier === "high") {
+        return tier;
+    }
+    return undefined;
+}
+/** Collect git diff after a live agent run. */
+export async function captureGitDiff(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["diff", "HEAD"], { cwd, maxBuffer: 10_000_000 });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Extract shell commands from structured tool call args (Cursor SDK shell tools). */
+export function extractShellCommandsFromToolCalls(toolCalls) {
+    const commands = new Set();
+    for (const call of toolCalls) {
+        if (!call.args) {
+            continue;
+        }
+        const candidates = [call.args.command, call.args.cmd, call.args.script, call.args.input];
+        for (const raw of candidates) {
+            if (typeof raw !== "string") {
+                continue;
+            }
+            for (const cmd of extractShellCommands(raw)) {
+                commands.add(cmd);
+            }
+            if (raw.includes("validate:changed") || raw.startsWith("bun run")) {
+                commands.add(raw.trim());
+            }
+        }
+    }
+    return [...commands];
+}
+const SKILL_WORKFLOW_PATH_PATTERN = /\.claude\/skills\/([^/]+)\/(?:SKILL\.md|references\/)/i;
+const APPLIED_SKILL_GENERIC_PATTERNS = [
+    /\b(?:invok(?:e|ing)|following|using|per|walk(?:ing)?)\s+(?:the\s+)?([a-z][a-z0-9-]*)\s+(?:skill|protocol|design tree)\b/gi,
+    /\*\*([a-z][a-z0-9-]*)\*\*\s*(?:skill|protocol)?/gi,
+];
+const APPLIED_SKILL_MARKERS = [
+    { skill: "grill", pattern: /\bgrill\s+before\s+implement/i },
+    { skill: "grill", pattern: /\b(?:invok(?:e|ing)|applied)\s+grill\b/i },
+    { skill: "grill", pattern: /\bgrill\b/i },
+    { skill: "grill", pattern: /\bpressure-test(?:ing)?\b/i },
+    { skill: "grill", pattern: /(?:^|\n)\s*\d+\.\s+.+(?:\n\s*\d+\.\s+.+)+/m },
+    { skill: "grill", pattern: /\b\d+\.\s+\S+(?:\s+\d+\.\s+\S+)+\b/ },
+    { skill: "crystallize", pattern: /\b(?:invok(?:e|ing)|applied)\s+crystallize\b/i },
+    { skill: "crystallize", pattern: /\bcrystalliz(?:e|ing|ation)\b/i },
+    { skill: "crystallize", pattern: /\bhalf-formed\b/i },
+    { skill: "crystallize", pattern: /\bfuzzy\s+intent\b/i },
+    { skill: "crystallize", pattern: /\bmirror(?:ed|ing)?\s+(?:the\s+)?(?:fuzzy\s+)?intent\b/i },
+    { skill: "crystallize", pattern: /\bmight be assuming\b/i },
+    { skill: "code-review", pattern: /\b(?:invok(?:e|ing)|applied)\s+code-review\b/i },
+    {
+        skill: "code-review",
+        pattern: /\bReview\s·\s*[^·]+\s·\s*(?:Quick|Standard|Thorough|Full)\b/i,
+    },
+    { skill: "code-review", pattern: /## Review synthesis/i },
+];
+const REVIEW_HEADER_DEPTH_PATTERN = /\bReview\s·\s*[^·]+\s·\s*(Quick|Standard|Thorough|Full)\b/i;
+const REVIEW_DEPTH_LABEL_PATTERN = /\*\*Depth:\*\*\s*(quick|standard|thorough|full)\b/i;
+/** Collapse whitespace so SDK token-chunked assistant prose still matches rubric patterns. */
+export function collapseTraceWhitespace(text) {
+    return text.replace(/\s+/g, " ");
+}
+function pathsFromToolArgs(args) {
+    const paths = [];
+    for (const key of ["path", "file_path", "filePath", "target_file", "uri"]) {
+        const value = args[key];
+        if (typeof value === "string") {
+            paths.push(value);
+        }
+    }
+    return paths;
+}
+function skillNameFromPath(path) {
+    const match = path.match(SKILL_WORKFLOW_PATH_PATTERN);
+    return match?.[1]?.toLowerCase();
+}
+/** Infer skill folder names from Read tool paths in tool calls. */
+export function extractSkillsInvokedFromToolCalls(toolCalls) {
+    const skills = new Set();
+    for (const call of toolCalls) {
+        if (!call.args) {
+            continue;
+        }
+        for (const path of pathsFromToolArgs(call.args)) {
+            const name = skillNameFromPath(path);
+            if (name) {
+                skills.add(name);
+            }
+        }
+        const serialized = JSON.stringify(call.args);
+        for (const match of serialized.matchAll(/\.claude\/skills\/([^/]+)\/SKILL\.md/gi)) {
+            const name = match[1]?.toLowerCase();
+            if (name) {
+                skills.add(name);
+            }
+        }
+    }
+    return [...skills];
+}
+/** Infer skill reads referenced in assistant prose. */
+export function extractSkillsInvokedFromText(...chunks) {
+    const skills = new Set();
+    for (const chunk of chunks) {
+        for (const match of chunk.matchAll(/\.claude\/skills\/([^/]+)\/SKILL\.md/gi)) {
+            const name = match[1]?.toLowerCase();
+            if (name) {
+                skills.add(name);
+            }
+        }
+    }
+    return [...skills];
+}
+/** Infer explicit skill sessions when SKILL.md is already in preamble (full catalog mode). */
+export function extractSkillsAppliedFromText(...chunks) {
+    const skills = new Set();
+    const combined = collapseTraceWhitespace(chunks.join("\n"));
+    const genericPatterns = APPLIED_SKILL_GENERIC_PATTERNS;
+    for (const pattern of genericPatterns) {
+        for (const match of combined.matchAll(pattern)) {
+            const name = match[1]?.toLowerCase();
+            if (name) {
+                skills.add(name);
+            }
+        }
+    }
+    for (const { skill, pattern } of APPLIED_SKILL_MARKERS) {
+        if (pattern.test(combined)) {
+            skills.add(skill);
+        }
+    }
+    return [...skills];
+}
+/** Infer code-review depth from synthesis status line (`Review · staged · Standard`). */
+export function inferReviewDepthFromText(text) {
+    const collapsed = collapseTraceWhitespace(text);
+    const headerMatch = collapsed.match(REVIEW_HEADER_DEPTH_PATTERN);
+    if (headerMatch?.[1]) {
+        return headerMatch[1].toLowerCase();
+    }
+    const depthMatch = collapsed.match(REVIEW_DEPTH_LABEL_PATTERN);
+    return depthMatch?.[1]?.toLowerCase();
+}
+export function mergeSkillsInvoked(...lists) {
+    return [...new Set(lists.flatMap((list) => list ?? []))];
+}
+/** Pull shell-like commands from assistant prose and tool output. */
+export function extractShellCommands(...chunks) {
+    const commands = new Set();
+    for (const chunk of chunks) {
+        for (const match of chunk.matchAll(SHELL_COMMAND_PATTERN)) {
+            const cmd = match[0]?.trim();
+            if (cmd) {
+                commands.add(cmd);
+            }
+        }
+    }
+    return [...commands];
+}
+/** Infer routing metadata from live agent prose when not structured. */
+/** Assistant prose before the first tool call (SDK order, or replay messages[]). */
+export function assistantPrefixBeforeTools(trace) {
+    if (trace.assistantTextBeforeTools !== undefined) {
+        return trace.assistantTextBeforeTools;
+    }
+    return trace.messages
+        .filter((message) => message.role === "assistant")
+        .map((message) => message.content)
+        .join("");
+}
+export function inferRoutingFromText(text) {
+    const collapsed = collapseTraceWhitespace(text);
+    for (const pattern of HANDS_ON_TIER_PATTERNS) {
+        const tierMatch = collapsed.match(pattern);
+        if (!tierMatch) {
+            continue;
+        }
+        const tier = tierFromMatch(tierMatch);
+        if (tier) {
+            return { tier, signals: ["inferred from live transcript"] };
+        }
+    }
+    return undefined;
+}
+export function inferPrBodyFromText(text) {
+    const routingIndex = text.indexOf("## Routing");
+    if (routingIndex === -1) {
+        return undefined;
+    }
+    return text.slice(routingIndex).trim();
+}
+const ROUTING_HEADING_BEFORE_TOOLS = /(?:^|\n)#+\s*Routing\b/m;
+const ROUTING_BOLD_PATTERN = /\*\*Routing\*\*/;
+/** Hands-off: ## Routing block appears in assistant text before the first tool call. */
+export function routingBlockBeforeTools(trace) {
+    const prefix = assistantPrefixBeforeTools(trace);
+    if (trace.toolCalls.length === 0) {
+        return toIncludeRoutingBlockText(`${prefix}\n${trace.prBody ?? ""}`);
+    }
+    return toIncludeRoutingBlockText(prefix);
+}
+function toIncludeRoutingBlockText(text) {
+    const collapsed = collapseTraceWhitespace(text);
+    return (text.includes("## Routing") ||
+        ROUTING_HEADING_BEFORE_TOOLS.test(text) ||
+        ROUTING_BOLD_PATTERN.test(collapsed));
+}
+/** Hands-on: tier announce appears in assistant text before the first tool call. */
+export function handsOnTierBeforeTools(trace, tier) {
+    return inferRoutingFromText(assistantPrefixBeforeTools(trace))?.tier === tier;
+}
+function isToolRelatedEvent(event) {
+    const type = event.type ?? "";
+    return type.includes("tool") || Boolean(event.tool);
+}
+function toolCallFromEvent(event) {
+    if (event.type === "tool_call" && event.name) {
+        return { name: event.name, args: event.args };
+    }
+    const name = event.tool?.name ?? (event.type?.includes("tool") ? event.type : undefined);
+    if (!name) {
+        return undefined;
+    }
+    let args;
+    if (event.tool?.input !== undefined && typeof event.tool.input === "object") {
+        args = event.tool.input;
+    }
+    else if (typeof event.tool?.input === "string") {
+        try {
+            const parsed = JSON.parse(event.tool.input);
+            if (parsed && typeof parsed === "object") {
+                args = parsed;
+            }
+        }
+        catch {
+            args = { command: event.tool.input };
+        }
+    }
+    return { name, args };
+}
+export function createTraceAccumulator() {
+    return {
+        agentMessages: [],
+        inferenceChunks: [],
+        textChunks: [],
+        toolOutputChunks: [],
+        toolCalls: [],
+        preToolAssistantChunks: [],
+        hasSeenTool: false,
+    };
+}
+/** Fold one SDK stream event into trace fields without retaining the raw event. */
+export function accumulateSdkEvent(acc, event) {
+    const text = textBlocksFromSdkMessage(event);
+    if (text) {
+        acc.inferenceChunks.push(text);
+    }
+    if (event.type === "assistant" || event.message?.role === "assistant") {
+        if (text) {
+            acc.agentMessages.push({ role: "assistant", content: text });
+            acc.textChunks.push(text);
+            if (!acc.hasSeenTool) {
+                acc.preToolAssistantChunks.push(text);
+            }
+        }
+        return;
+    }
+    if (isToolRelatedEvent(event)) {
+        if (text) {
+            acc.toolOutputChunks.push(text);
+        }
+        const toolCall = toolCallFromEvent(event);
+        if (toolCall) {
+            acc.hasSeenTool = true;
+            acc.toolCalls.push(toolCall);
+        }
+    }
+}
+export function finalizeTraceAccumulator(acc, options) {
+    const combined = [
+        ...new Set([...acc.inferenceChunks, ...acc.textChunks, ...acc.toolOutputChunks]),
+    ].join("\n");
+    const routing = inferRoutingFromText(combined);
+    const prBody = inferPrBodyFromText(combined);
+    const shellFromText = extractShellCommands(combined, ...acc.toolOutputChunks);
+    const shellFromTools = extractShellCommandsFromToolCalls(acc.toolCalls);
+    const skillsInvoked = mergeSkillsInvoked(extractSkillsInvokedFromToolCalls(acc.toolCalls), extractSkillsInvokedFromText(combined), extractSkillsAppliedFromText(combined));
+    return {
+        messages: acc.agentMessages,
+        toolCalls: acc.toolCalls,
+        shellCommands: [...new Set([...shellFromText, ...shellFromTools])],
+        skillsInvoked,
+        gitDiff: options?.gitDiff,
+        prBody,
+        artifacts: {},
+        routing,
+        assistantTextBeforeTools: acc.preToolAssistantChunks.join(""),
+    };
+}
+/** Normalize Cursor SDK messages into AgentTrace fields. */
+export function buildTraceFromSdkMessages(messages, options) {
+    const acc = createTraceAccumulator();
+    for (const event of messages) {
+        accumulateSdkEvent(acc, event);
+    }
+    return finalizeTraceAccumulator(acc, options);
+}
+/** Fill routing / PR body from transcript when live runs omit structured fields. */
+export function enrichTrace(trace) {
+    const combined = [...trace.messages.map((m) => m.content), trace.prBody ?? ""].join("\n");
+    return {
+        ...trace,
+        routing: trace.routing ?? inferRoutingFromText(combined),
+        prBody: trace.prBody ?? inferPrBodyFromText(combined),
+        skillsInvoked: mergeSkillsInvoked(trace.skillsInvoked, extractSkillsInvokedFromToolCalls(trace.toolCalls), extractSkillsInvokedFromText(combined), extractSkillsAppliedFromText(combined)),
+        shellCommands: trace.shellCommands.length > 0
+            ? trace.shellCommands
+            : [
+                ...new Set([
+                    ...extractShellCommands(combined, trace.gitDiff ?? ""),
+                    ...extractShellCommandsFromToolCalls(trace.toolCalls),
+                ]),
+            ],
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,11 @@
+import { type SkillContextSetting } from "./skills-context";
+import type { ContextProfile, LoadedContext } from "./types";
+export interface LoadContextOptions {
+    cwd: string;
+    profile?: ContextProfile;
+    /** none | catalog (index) | full (catalog + all SKILL.md bodies). */
+    skills?: SkillContextSetting;
+}
+/** Load canonical agent context files from the repo. */
+export declare function loadContext(options: LoadContextOptions): Promise<LoadedContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAmD7D,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,wDAAwD;AACxD,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgDrF"}