p-dev-harness 0.3.0

package/dist/cursor/run-observer.js

@@ -0,0 +1,228 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { Agent, CursorAgentError } from "@cursor/sdk";
+import { getCursorRunResultPath } from "../artifacts/paths.js";
+import { classifyCursorError, classifyRunResultStatus } from "./errors.js";
+import { extractTargetRepoGitResult } from "./git-result.js";
+import { extractRevisionGitResult } from "./revision-git-result.js";
+import { cancelCursorRun } from "./run-cleanup.js";
+import { ImplementationError, MergeError, PlanningError, PhaseError, RevisionError, } from "../runner/errors.js";
+const DEFAULT_CLOUD_RUN_POLL_INTERVAL_MS = 5_000;
+export function isStreamUnavailableRunResult(result) {
+    return (result.status === "error" &&
+        result.error?.code === "stream_unavailable");
+}
+export function isTerminalRunStatus(status) {
+    return (status === "finished" ||
+        status === "completed" ||
+        status === "error" ||
+        status === "cancelled");
+}
+function sleep(ms, abortSignal) {
+    if (abortSignal?.aborted) {
+        return Promise.reject(abortSignal.reason);
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            abortSignal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortSignal?.reason);
+        };
+        abortSignal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export async function pollCloudRunResult(options) {
+    const fetchCloudRun = options.fetchCloudRun ?? Agent.getRun.bind(Agent);
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_CLOUD_RUN_POLL_INTERVAL_MS;
+    while (true) {
+        if (options.abortSignal?.aborted) {
+            throw options.abortSignal.reason;
+        }
+        const snapshot = await fetchCloudRun(options.runId, {
+            runtime: "cloud",
+            agentId: options.agentId,
+            apiKey: options.apiKey,
+        });
+        if (isTerminalRunStatus(snapshot.status) &&
+            !isStreamUnavailableRunResult(snapshot)) {
+            return snapshot;
+        }
+        await sleep(pollIntervalMs, options.abortSignal);
+    }
+}
+function makePhaseError(phase, classification, message, cancelOutcome = null) {
+    if (phase === "implementation") {
+        return new ImplementationError(classification, message, cancelOutcome);
+    }
+    if (phase === "revision") {
+        return new RevisionError(classification, message, cancelOutcome);
+    }
+    if (phase === "integration_repair") {
+        return new MergeError(classification, message);
+    }
+    return new PlanningError(classification, message, cancelOutcome);
+}
+async function abortRun(phase, abortSignal, ensureCancelled) {
+    const cancelOutcome = await ensureCancelled();
+    const reason = abortSignal.reason;
+    if (reason instanceof PhaseError) {
+        throw makePhaseError(phase, reason.classification ?? "cursor_run_timeout", reason.message, cancelOutcome);
+    }
+    throw makePhaseError(phase, "cursor_run_timeout", reason instanceof Error ? reason.message : "Cursor run aborted", cancelOutcome);
+}
+function attachAbortHandler(abortSignal, ensureCancelled) {
+    if (!abortSignal) {
+        return () => undefined;
+    }
+    const onAbort = () => {
+        void ensureCancelled();
+    };
+    abortSignal.addEventListener("abort", onAbort, { once: true });
+    return () => abortSignal.removeEventListener("abort", onAbort);
+}
+export async function sendAndObserve(agent, prompt, runDirectory, events, options = {}) {
+    const phase = options.phase ?? "planning";
+    const agentId = agent.agentId;
+    let run;
+    let detachAbort;
+    let cancelOutcome = null;
+    let cancelPromise = null;
+    const ensureCancelled = () => {
+        if (cancelOutcome !== null) {
+            return Promise.resolve(cancelOutcome);
+        }
+        if (!cancelPromise) {
+            cancelPromise = cancelCursorRun(run, events).then((outcome) => {
+                cancelOutcome = outcome;
+                return outcome;
+            });
+        }
+        return cancelPromise;
+    };
+    try {
+        run = await agent.send(prompt);
+    }
+    catch (error) {
+        const classification = classifyCursorError(error);
+        throw makePhaseError(phase, classification ?? "cursor_api_failure", error instanceof Error ? error.message : String(error));
+    }
+    await events.log("cursor_agent_created", "info", { agentId, runId: run.id });
+    if (options.onAgentCreated) {
+        await options.onAgentCreated({ agentId, runId: run.id });
+    }
+    detachAbort = attachAbortHandler(options.abortSignal, ensureCancelled);
+    if (options.abortSignal?.aborted) {
+        await abortRun(phase, options.abortSignal, ensureCancelled);
+    }
+    try {
+        for await (const event of run.stream()) {
+            if (options.abortSignal?.aborted) {
+                await abortRun(phase, options.abortSignal, ensureCancelled);
+            }
+            await events.log("cursor_event", "info", {
+                type: event.type,
+            });
+        }
+    }
+    catch (error) {
+        if (options.abortSignal?.aborted) {
+            await abortRun(phase, options.abortSignal, ensureCancelled);
+        }
+        if (error instanceof PhaseError) {
+            throw error;
+        }
+        // Streaming is best-effort; wait() is authoritative.
+    }
+    if (options.abortSignal?.aborted) {
+        await abortRun(phase, options.abortSignal, ensureCancelled);
+    }
+    let result;
+    try {
+        result = await run.wait();
+        if (options.apiKey &&
+            agentId.startsWith("bc-") &&
+            isStreamUnavailableRunResult(result)) {
+            await events.log("cursor_run_poll_fallback", "info", {
+                runId: result.id,
+                agentId,
+            });
+            result = await pollCloudRunResult({
+                apiKey: options.apiKey,
+                agentId,
+                runId: result.id,
+                abortSignal: options.abortSignal,
+                pollIntervalMs: options.pollIntervalMs,
+                fetchCloudRun: options.fetchCloudRun,
+            });
+        }
+    }
+    catch (error) {
+        if (options.abortSignal?.aborted) {
+            await abortRun(phase, options.abortSignal, ensureCancelled);
+        }
+        if (error instanceof CursorAgentError) {
+            throw makePhaseError(phase, "cursor_api_failure", error.message);
+        }
+        throw error;
+    }
+    finally {
+        detachAbort?.();
+    }
+    if (options.abortSignal?.aborted) {
+        await abortRun(phase, options.abortSignal, ensureCancelled);
+    }
+    await mkdir(`${runDirectory}/cursor`, { recursive: true });
+    await writeFile(getCursorRunResultPath(runDirectory), `${JSON.stringify({
+        id: result.id,
+        status: result.status,
+        durationMs: result.durationMs,
+        model: result.model,
+        git: result.git,
+        error: result.error,
+        usage: result.usage,
+    }, null, 2)}\n`, "utf8");
+    await events.log("cursor_run_finished", "info", {
+        runId: result.id,
+        status: result.status,
+        durationMs: result.durationMs,
+    });
+    const failureClass = classifyRunResultStatus(result.status);
+    if (failureClass) {
+        throw makePhaseError(phase, failureClass, result.error?.message ?? `Cursor run ended with status ${result.status}`);
+    }
+    const assistantText = result.result?.trim() ?? "";
+    if (!assistantText) {
+        throw makePhaseError(phase, "cursor_run_failed", "Cursor run finished without assistant text");
+    }
+    const gitBranches = result.git?.branches ?? [];
+    const hasBranchOrPr = gitBranches.some((b) => b.branch || b.prUrl);
+    if (phase === "planning" && hasBranchOrPr) {
+        throw new PlanningError("agent_policy_violation", "Planning agent created a branch or PR despite read-only constraints");
+    }
+    let gitResult = null;
+    if (phase === "implementation") {
+        gitResult = extractTargetRepoGitResult(result.git, options.targetRepo ?? "");
+    }
+    else if (phase === "revision" || phase === "integration_repair") {
+        try {
+            gitResult = extractRevisionGitResult(result.git, options.targetRepo ?? "", options.expectedBranch ?? "", options.expectedPrUrl ?? "");
+        }
+        catch (error) {
+            if (phase === "integration_repair" && error instanceof RevisionError) {
+                throw new MergeError(error.classification ?? "cursor_branch_attach_failure", error.message);
+            }
+            throw error;
+        }
+    }
+    return {
+        agentId,
+        runId: result.id,
+        result,
+        assistantText,
+        gitResult,
+        cancelOutcome,
+    };
+}
+//# sourceMappingURL=run-observer.js.map

package/dist/cursor/run-observer.js.map

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

package/dist/cursor/urls.d.ts

@@ -0,0 +1,3 @@
+export declare function buildCursorCloudRunUrl(agentId: string, runId?: string | null): string;
+export declare function formatCursorCloudRunLink(agentId: string, runId?: string | null): string;
+//# sourceMappingURL=urls.d.ts.map

package/dist/cursor/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/cursor/urls.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAMR;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAER"}

package/dist/cursor/urls.js

@@ -0,0 +1,12 @@
+const CURSOR_CLOUD_BASE_URL = "https://cursor.com/agents";
+export function buildCursorCloudRunUrl(agentId, runId) {
+    const url = new URL(`${CURSOR_CLOUD_BASE_URL}/${encodeURIComponent(agentId)}`);
+    if (runId) {
+        url.searchParams.set("run", runId);
+    }
+    return url.toString();
+}
+export function formatCursorCloudRunLink(agentId, runId) {
+    return `[Cursor Cloud run](${buildCursorCloudRunUrl(agentId, runId)})`;
+}
+//# sourceMappingURL=urls.js.map

package/dist/cursor/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../src/cursor/urls.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAE1D,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,KAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,qBAAqB,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,KAAqB;IAErB,OAAO,sBAAsB,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC;AACzE,CAAC"}

package/dist/fixture/frontmatter.d.ts

@@ -0,0 +1,11 @@
+export interface FixtureMetadata {
+    title: string;
+    status: string | null;
+    projectName: string | null;
+    teamName: string | null;
+}
+export declare function parseFixtureMarkdown(raw: string): {
+    metadata: FixtureMetadata;
+    body: string;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/fixture/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/fixture/frontmatter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CA6CA"}

package/dist/fixture/frontmatter.js

@@ -0,0 +1,45 @@
+export function parseFixtureMarkdown(raw) {
+    const frontmatterMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        return {
+            metadata: {
+                title: "Fixture issue",
+                status: null,
+                projectName: null,
+                teamName: null,
+            },
+            body: raw,
+        };
+    }
+    const metadata = {
+        title: "Fixture issue",
+        status: null,
+        projectName: null,
+        teamName: null,
+    };
+    for (const line of frontmatterMatch[1].split("\n")) {
+        const match = line.match(/^([A-Za-z]+):\s*(.*)$/);
+        if (!match)
+            continue;
+        const key = match[1].toLowerCase();
+        const value = match[2].trim().replace(/^["']|["']$/g, "");
+        switch (key) {
+            case "title":
+                metadata.title = value;
+                break;
+            case "status":
+                metadata.status = value || null;
+                break;
+            case "projectname":
+                metadata.projectName = value || null;
+                break;
+            case "teamname":
+                metadata.teamName = value || null;
+                break;
+            default:
+                break;
+        }
+    }
+    return { metadata, body: frontmatterMatch[2] };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/fixture/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/fixture/frontmatter.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAI9C,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAClF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO;YACL,QAAQ,EAAE;gBACR,KAAK,EAAE,eAAe;gBACtB,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,IAAI;aACf;YACD,IAAI,EAAE,GAAG;SACV,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAoB;QAChC,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC3D,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,OAAO;gBACV,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;gBACvB,MAAM;YACR,KAAK,QAAQ;gBACX,QAAQ,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC;gBAChC,MAAM;YACR,KAAK,aAAa;gBAChB,QAAQ,CAAC,WAAW,GAAG,KAAK,IAAI,IAAI,CAAC;gBACrC,MAAM;YACR,KAAK,UAAU;gBACb,QAAQ,CAAC,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC;gBAClC,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAE,EAAE,CAAC;AAClD,CAAC"}

package/dist/github/actions-url.d.ts

@@ -0,0 +1,3 @@
+export declare function getGitHubActionsRunUrl(): string | null;
+export declare function formatGitHubActionsRunLink(url: string): string;
+//# sourceMappingURL=actions-url.d.ts.map

package/dist/github/actions-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-url.d.ts","sourceRoot":"","sources":["../../src/github/actions-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAQtD;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/github/actions-url.js

@@ -0,0 +1,13 @@
+export function getGitHubActionsRunUrl() {
+    const serverUrl = process.env.GITHUB_SERVER_URL;
+    const repository = process.env.GITHUB_REPOSITORY;
+    const runId = process.env.GITHUB_RUN_ID;
+    if (!serverUrl || !repository || !runId) {
+        return null;
+    }
+    return `${serverUrl}/${repository}/actions/runs/${runId}`;
+}
+export function formatGitHubActionsRunLink(url) {
+    return `[GitHub Actions run](${url})`;
+}
+//# sourceMappingURL=actions-url.js.map

package/dist/github/actions-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-url.js","sourceRoot":"","sources":["../../src/github/actions-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,SAAS,IAAI,UAAU,iBAAiB,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,wBAAwB,GAAG,GAAG,CAAC;AACxC,CAAC"}

package/dist/github/base-branch.d.ts

@@ -0,0 +1,25 @@
+import type { GitHubClient } from "./client.js";
+export interface ParsedGitHubRepoUrl {
+    owner: string;
+    repo: string;
+}
+export declare function parseGitHubRepoUrl(repoUrl: string): ParsedGitHubRepoUrl | null;
+export declare function assertBaseBranchExists(client: GitHubClient, targetRepo: string, baseBranch: string): Promise<void>;
+export declare function assertHeadBranchWritePermission(client: GitHubClient, targetRepo: string): Promise<void>;
+export declare function assertPrBaseBranchMatches(input: {
+    prUrl: string;
+    actualBaseBranch: string;
+    expectedBaseBranch: string;
+}): void;
+export declare function assertPullRequestMergeable(input: {
+    prUrl: string;
+    merged: boolean;
+    mergeable: boolean | null;
+    mergeableState: string | null;
+    baseBranch: string;
+}): void;
+export declare function isIntegrationRepairEligible(input: {
+    mergeable: boolean | null;
+    mergeableState: string | null;
+}): boolean;
+//# sourceMappingURL=base-branch.d.ts.map

package/dist/github/base-branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-branch.d.ts","sourceRoot":"","sources":["../../src/github/base-branch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAQ9E;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,IAAI,CAQP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAiBP;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,OAAO,CAMV"}

package/dist/github/base-branch.js

@@ -0,0 +1,73 @@
+import { GitHubApiError } from "./client.js";
+export function parseGitHubRepoUrl(repoUrl) {
+    const match = repoUrl
+        .trim()
+        .match(/^https:\/\/github\.com\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)\/?$/);
+    if (!match) {
+        return null;
+    }
+    return { owner: match[1], repo: match[2] };
+}
+export async function assertBaseBranchExists(client, targetRepo, baseBranch) {
+    const parsed = parseGitHubRepoUrl(targetRepo);
+    if (!parsed) {
+        throw new Error(`wrong_target_repo: Invalid GitHub repo URL: ${targetRepo}`);
+    }
+    try {
+        await client.getBranchRef(parsed.owner, parsed.repo, baseBranch);
+    }
+    catch (error) {
+        if (error instanceof GitHubApiError && error.status === 404) {
+            throw new Error(`base_branch_missing: Target repo ${targetRepo} does not have base branch "${baseBranch}". Create the branch or update repos[].baseBranch before running the harness.`);
+        }
+        throw error;
+    }
+}
+export async function assertHeadBranchWritePermission(client, targetRepo) {
+    const parsed = parseGitHubRepoUrl(targetRepo);
+    if (!parsed) {
+        throw new Error(`wrong_target_repo: Invalid GitHub repo URL: ${targetRepo}`);
+    }
+    try {
+        const repo = await client.getRepository(parsed.owner, parsed.repo);
+        if (repo.permissions?.push === true || repo.permissions?.admin === true) {
+            return;
+        }
+    }
+    catch (error) {
+        if (error instanceof GitHubApiError && error.status === 401) {
+            throw error;
+        }
+        if (error instanceof GitHubApiError && error.status === 403) {
+            throw new Error(`repair_head_branch_write_denied: HARNESS_GITHUB_TOKEN cannot verify write access for ${targetRepo}. Grant classic repo scope, or fine-grained Contents: Read and write plus Pull requests: Read and write on the target repo.`);
+        }
+        throw error;
+    }
+    throw new Error(`repair_head_branch_write_denied: HARNESS_GITHUB_TOKEN lacks PR head-branch write access for ${targetRepo}. Grant classic repo scope, or fine-grained Contents: Read and write plus Pull requests: Read and write on the target repo.`);
+}
+export function assertPrBaseBranchMatches(input) {
+    if (input.actualBaseBranch === input.expectedBaseBranch) {
+        return;
+    }
+    throw new Error(`wrong_pr_base_branch: PR ${input.prUrl} targets "${input.actualBaseBranch}"; expected "${input.expectedBaseBranch}". Update the PR base branch before continuing.`);
+}
+export function assertPullRequestMergeable(input) {
+    if (input.merged) {
+        return;
+    }
+    const state = input.mergeableState?.toLowerCase() ?? null;
+    if (state === "dirty" || state === "behind" || state === "blocked") {
+        throw new Error(`pr_not_mergeable: PR ${input.prUrl} is ${state} against "${input.baseBranch}". Update or rebase the PR branch after other merges land, then retry.`);
+    }
+    if (input.mergeable === false) {
+        throw new Error(`pr_not_mergeable: PR ${input.prUrl} is not mergeable into "${input.baseBranch}". Resolve conflicts or update the branch, then retry.`);
+    }
+}
+export function isIntegrationRepairEligible(input) {
+    const state = input.mergeableState?.toLowerCase() ?? null;
+    if (state === "blocked" || state === "unstable") {
+        return false;
+    }
+    return state === "dirty" || state === "behind" || input.mergeable === false;
+}
+//# sourceMappingURL=base-branch.js.map

package/dist/github/base-branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-branch.js","sourceRoot":"","sources":["../../src/github/base-branch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,KAAK,GAAG,OAAO;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAoB,EACpB,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,UAAU,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,oCAAoC,UAAU,+BAA+B,UAAU,+EAA+E,CACvK,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,MAAoB,EACpB,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,UAAU,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;YACxE,OAAO;QACT,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5D,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CACb,wFAAwF,UAAU,6HAA6H,CAChO,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,IAAI,KAAK,CACb,+FAA+F,UAAU,6HAA6H,CACvO,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAIzC;IACC,IAAI,KAAK,CAAC,gBAAgB,KAAK,KAAK,CAAC,kBAAkB,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,CAAC,KAAK,aAAa,KAAK,CAAC,gBAAgB,gBAAgB,KAAK,CAAC,kBAAkB,iDAAiD,CACpK,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAM1C;IACC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;IAC1D,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,KAAK,OAAO,KAAK,aAAa,KAAK,CAAC,UAAU,wEAAwE,CACrJ,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,KAAK,2BAA2B,KAAK,CAAC,UAAU,wDAAwD,CACvI,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAG3C;IACC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC;AAC9E,CAAC"}

package/dist/github/check-policy.d.ts

@@ -0,0 +1,12 @@
+import type { HarnessConfig } from "../config/types.js";
+import type { PrCheckInfo } from "./pr-inspector.js";
+import type { ErrorClassification } from "../types/run.js";
+export type CheckPolicyDecision = "allow" | "block";
+export interface CheckPolicyResult {
+    decision: CheckPolicyDecision;
+    classification: ErrorClassification;
+    reason: string;
+    warnings: string[];
+}
+export declare function evaluateChecksForMerge(checks: PrCheckInfo[], config: HarnessConfig): CheckPolicyResult;
+//# sourceMappingURL=check-policy.d.ts.map

package/dist/github/check-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-policy.d.ts","sourceRoot":"","sources":["../../src/github/check-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAO3D,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,cAAc,EAAE,mBAAmB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAWD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,aAAa,GACpB,iBAAiB,CA6EnB"}

package/dist/github/check-policy.js

@@ -0,0 +1,71 @@
+import { DEFAULT_MERGE_ALLOW_NEUTRAL_CHECKS, DEFAULT_MERGE_ALLOW_PENDING_CHECKS, DEFAULT_MERGE_ALLOW_UNKNOWN_CHECKS, } from "../config/defaults.js";
+const FAILING_CONCLUSIONS = new Set([
+    "failure",
+    "cancelled",
+    "timed_out",
+    "action_required",
+]);
+const NEUTRAL_CONCLUSIONS = new Set(["neutral", "skipped", "success"]);
+export function evaluateChecksForMerge(checks, config) {
+    const allowPending = config.merge?.allowPendingChecks ?? DEFAULT_MERGE_ALLOW_PENDING_CHECKS;
+    const allowUnknown = config.merge?.allowUnknownChecks ?? DEFAULT_MERGE_ALLOW_UNKNOWN_CHECKS;
+    const allowNeutral = config.merge?.allowNeutralChecks ?? DEFAULT_MERGE_ALLOW_NEUTRAL_CHECKS;
+    if (checks.length === 0) {
+        if (allowUnknown) {
+            return {
+                decision: "allow",
+                classification: null,
+                reason: "No check runs reported; proceeding per allowUnknownChecks",
+                warnings: ["No GitHub check runs reported for the PR head commit"],
+            };
+        }
+        return {
+            decision: "block",
+            classification: "checks_unknown",
+            reason: "No GitHub check runs reported for the PR head commit",
+            warnings: [],
+        };
+    }
+    const failing = checks.filter((check) => check.conclusion !== null && FAILING_CONCLUSIONS.has(check.conclusion));
+    if (failing.length > 0) {
+        return {
+            decision: "block",
+            classification: "checks_failing",
+            reason: `Failing checks: ${failing.map((c) => c.name).join(", ")}`,
+            warnings: [],
+        };
+    }
+    const pending = checks.filter((check) => check.status !== "completed" || check.conclusion === null);
+    if (pending.length > 0) {
+        if (allowPending) {
+            return {
+                decision: "allow",
+                classification: null,
+                reason: "Pending checks present; proceeding per allowPendingChecks",
+                warnings: pending.map((c) => `Pending check: ${c.name}`),
+            };
+        }
+        return {
+            decision: "block",
+            classification: "checks_pending",
+            reason: `Pending checks: ${pending.map((c) => c.name).join(", ")}`,
+            warnings: [],
+        };
+    }
+    const nonNeutral = checks.filter((check) => check.conclusion !== null && !NEUTRAL_CONCLUSIONS.has(check.conclusion));
+    if (nonNeutral.length > 0 && !allowNeutral) {
+        return {
+            decision: "block",
+            classification: "checks_unknown",
+            reason: `Unrecognized check conclusions: ${nonNeutral.map((c) => `${c.name}=${c.conclusion}`).join(", ")}`,
+            warnings: [],
+        };
+    }
+    return {
+        decision: "allow",
+        classification: null,
+        reason: "Checks policy passed",
+        warnings: [],
+    };
+}
+//# sourceMappingURL=check-policy.js.map

package/dist/github/check-policy.js.map

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