@allocator-one/rcl 4.4.19

package/dist/resolver/github-client.d.ts

@@ -0,0 +1,82 @@
+import { Octokit } from '@octokit/rest';
+import type { GitHubTarget } from './github.js';
+export declare function createGitHubClient(token?: string): Promise<Octokit>;
+export declare function getGitHubPullRequest(client: Octokit, target: GitHubTarget): Promise<import("@octokit/types").OctokitResponse<{
+    url: string;
+    id: number;
+    node_id: string;
+    html_url: string;
+    diff_url: string;
+    patch_url: string;
+    issue_url: string;
+    commits_url: string;
+    review_comments_url: string;
+    review_comment_url: string;
+    comments_url: string;
+    statuses_url: string;
+    number: number;
+    state: "open" | "closed";
+    locked: boolean;
+    title: string;
+    user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+    body: string | null;
+    labels: {
+        id: number;
+        node_id: string;
+        url: string;
+        name: string;
+        description: string | null;
+        color: string;
+        default: boolean;
+    }[];
+    milestone: import("@octokit/openapi-types").components["schemas"]["nullable-milestone"];
+    active_lock_reason?: string | null;
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+    merged_at: string | null;
+    merge_commit_sha: string | null;
+    assignee: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
+    assignees?: import("@octokit/openapi-types").components["schemas"]["simple-user"][] | null;
+    requested_reviewers?: import("@octokit/openapi-types").components["schemas"]["simple-user"][] | null;
+    requested_teams?: import("@octokit/openapi-types").components["schemas"]["team-simple"][] | null;
+    head: {
+        label: string;
+        ref: string;
+        repo: import("@octokit/openapi-types").components["schemas"]["repository"];
+        sha: string;
+        user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+    };
+    base: {
+        label: string;
+        ref: string;
+        repo: import("@octokit/openapi-types").components["schemas"]["repository"];
+        sha: string;
+        user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+    };
+    _links: {
+        comments: import("@octokit/openapi-types").components["schemas"]["link"];
+        commits: import("@octokit/openapi-types").components["schemas"]["link"];
+        statuses: import("@octokit/openapi-types").components["schemas"]["link"];
+        html: import("@octokit/openapi-types").components["schemas"]["link"];
+        issue: import("@octokit/openapi-types").components["schemas"]["link"];
+        review_comments: import("@octokit/openapi-types").components["schemas"]["link"];
+        review_comment: import("@octokit/openapi-types").components["schemas"]["link"];
+        self: import("@octokit/openapi-types").components["schemas"]["link"];
+    };
+    author_association: import("@octokit/openapi-types").components["schemas"]["author-association"];
+    auto_merge: import("@octokit/openapi-types").components["schemas"]["auto-merge"];
+    draft?: boolean;
+    merged: boolean;
+    mergeable: boolean | null;
+    rebaseable?: boolean | null;
+    mergeable_state: string;
+    merged_by: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
+    comments: number;
+    review_comments: number;
+    maintainer_can_modify: boolean;
+    commits: number;
+    additions: number;
+    deletions: number;
+    changed_files: number;
+}, 200>>;

package/dist/resolver/github-client.js

@@ -0,0 +1,27 @@
+import { execFile } from 'node:child_process';
+import { Octokit } from '@octokit/rest';
+export async function createGitHubClient(token) {
+    const configuredToken = token?.trim() || process.env['GITHUB_TOKEN']?.trim();
+    const auth = configuredToken || await new Promise((resolve) => {
+        execFile('gh', ['auth', 'token', '--hostname', 'github.com'], { encoding: 'utf8', timeout: 5000, maxBuffer: 16384 }, (error, stdout) => resolve(error ? undefined : stdout.trim() || undefined));
+    });
+    return new Octokit({ auth });
+}
+export async function getGitHubPullRequest(client, target) {
+    try {
+        return await client.pulls.get({
+            owner: target.owner,
+            repo: target.repo,
+            pull_number: target.number,
+        });
+    }
+    catch (error) {
+        if (typeof error === 'object' && error !== null && 'status' in error && error.status === 404) {
+            throw new Error('PR fetch returned 404 — the pull request may not exist or access may be missing. ' +
+                'For private repos, verify access with gh auth status --hostname github.com, ' +
+                'or set GITHUB_TOKEN or githubToken in config.');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=github-client.js.map

package/dist/resolver/github-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.js","sourceRoot":"","sources":["../../src/resolver/github-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc;IACrD,MAAM,eAAe,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7E,MAAM,IAAI,GAAG,eAAe,IAAI,MAAM,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;QAChF,QAAQ,CACN,IAAI,EACJ,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,EAC7C,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EACrD,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,CAC3E,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAe,EAAE,MAAoB;IAC9E,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CACb,mFAAmF;gBACnF,8EAA8E;gBAC9E,+CAA+C,CAChD,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/resolver/github.d.ts

@@ -0,0 +1,29 @@
+import type { Octokit } from '@octokit/rest';
+import type { Diff } from './types.js';
+export interface GitHubTarget {
+    owner: string;
+    repo: string;
+    number: number;
+}
+/** A GitHub repository by owner and name. */
+export interface RepoRef {
+    owner: string;
+    repo: string;
+}
+export declare const GITHUB_OWNER_PATTERN = "[A-Za-z0-9](?:[A-Za-z0-9]|-(?=[A-Za-z0-9]))*";
+export declare const GITHUB_REPO_PATTERN = "[A-Za-z0-9_.-]+";
+/** The pair as a repository, or `null` when GitHub would not accept either segment. */
+export declare function legalRepo(owner: string, repo: string): RepoRef | null;
+/** An `owner/repo` argument as a repository, or `null` when it is not one GitHub would accept. */
+export declare function parseRepoName(text: string): RepoRef | null;
+/**
+ * Whether a positional target names a GitHub PR (`owner/repo#N` or a PR
+ * URL). Everything else a caller passes is a local patch file — by shape,
+ * not by extension, so `fix.DIFF`, `patches/fix` and `changes.txt` all route
+ * to the patch loader instead of failing as an "invalid GitHub target".
+ */
+export declare function isGitHubTarget(target: string): boolean;
+export declare function parseGitHubTarget(target: string): GitHubTarget;
+export declare function fetchPRDiff(target: GitHubTarget, token?: string, octokitClient?: Octokit, options?: {
+    requireMergeBase?: boolean;
+}): Promise<Diff>;

package/dist/resolver/github.js

@@ -0,0 +1,166 @@
+import { detectLanguage } from '../prepare/language.js';
+import { createGitHubClient, getGitHubPullRequest } from './github-client.js';
+// GitHub's segment rules: an owner is alphanumerics and single hyphens (no
+// leading or trailing hyphen); a repository is alphanumerics, `-`, `_` and
+// `.`, never `.` or `..` — so neither can carry a control character, a path
+// separator or a dot-segment into a request path.
+export const GITHUB_OWNER_PATTERN = '[A-Za-z0-9](?:[A-Za-z0-9]|-(?=[A-Za-z0-9]))*';
+export const GITHUB_REPO_PATTERN = '[A-Za-z0-9_.-]+';
+const OWNER_RE = new RegExp(`^${GITHUB_OWNER_PATTERN}$`);
+const REPO_RE = new RegExp(`^${GITHUB_REPO_PATTERN}$`);
+/** The pair as a repository, or `null` when GitHub would not accept either segment. */
+export function legalRepo(owner, repo) {
+    if (!OWNER_RE.test(owner) || !REPO_RE.test(repo) || repo === '.' || repo === '..')
+        return null;
+    return { owner, repo };
+}
+/** An `owner/repo` argument as a repository, or `null` when it is not one GitHub would accept. */
+export function parseRepoName(text) {
+    const parts = text.trim().split('/');
+    if (parts.length !== 2)
+        return null;
+    return legalRepo(parts[0], parts[1]);
+}
+// Anchored: the whole target must be a PR URL (any scheme, optional www,
+// optional sub-page such as /files, optional query or fragment) or the short
+// owner/repo#N form with single-segment owner and repo. A local path that
+// merely contains "github.com/…/pull/N" or ends in "#2" is not a PR.
+const PR_URL = /^(?:https?:\/\/)?(?:www\.)?github\.com(?::\d+)?\/([^/\s#?]+)\/([^/\s#?]+)\/pull\/(\d+)(?:\/[^\s?#]*)?(?:[?#].*)?$/i;
+const PR_SHORT = /^([^/#\s]+)\/([^/#\s]+)#(\d+)$/;
+/**
+ * Whether a positional target names a GitHub PR (`owner/repo#N` or a PR
+ * URL). Everything else a caller passes is a local patch file — by shape,
+ * not by extension, so `fix.DIFF`, `patches/fix` and `changes.txt` all route
+ * to the patch loader instead of failing as an "invalid GitHub target".
+ */
+export function isGitHubTarget(target) {
+    return PR_URL.test(target) || PR_SHORT.test(target);
+}
+export function parseGitHubTarget(target) {
+    // Supports: owner/repo#123 or https://github.com/owner/repo/pull/123
+    const prUrlMatch = target.match(PR_URL);
+    if (prUrlMatch) {
+        return {
+            owner: prUrlMatch[1],
+            repo: prUrlMatch[2],
+            number: parseInt(prUrlMatch[3], 10),
+        };
+    }
+    const shortMatch = target.match(PR_SHORT);
+    if (shortMatch) {
+        return {
+            owner: shortMatch[1],
+            repo: shortMatch[2],
+            number: parseInt(shortMatch[3], 10),
+        };
+    }
+    throw new Error(`Invalid GitHub target: "${target}". Use owner/repo#123 or a GitHub PR URL.`);
+}
+/**
+ * GitHub's compare endpoint returns the changed files only in its first
+ * response and caps them at 300 (paging applies to commits, not files).
+ */
+const COMPARE_FILE_CAP = 300;
+/**
+ * The PR's changed files, bound to the SHAs the PR response named.
+ *
+ * Preferred path: `GET /compare/{base}...{head}` — the same merge-base
+ * comparison a PR shows, addressed by immutable object ids, so nothing that
+ * happens to the PR after `pulls.get` can change what comes back. GitHub
+ * includes at most 300 files in that response, so it is authoritative only
+ * below the cap.
+ *
+ * Large PRs fall back to the PR-number-addressed listing (paged to 3,000
+ * files), bracketed by PR reads: if the head or base moved while the pages
+ * were fetched, the report is not bound. A move-and-move-back inside that
+ * window is not detectable here; every PR up to the compare cap takes the
+ * pinned path and has no such window.
+ */
+async function fetchChangedFiles(octokit, target, pr, requireMergeBase) {
+    let mergeBaseSha;
+    if (requireMergeBase && (![pr.base.sha, pr.head.sha].every(sha => /^[a-f0-9]{40}$/.test(sha)))) {
+        throw new Error("A retained PR needs exact commits to resolve its effective merge base.");
+    }
+    if (requireMergeBase || pr.changed_files <= COMPARE_FILE_CAP) {
+        let files;
+        try {
+            const { data } = await octokit.repos.compareCommitsWithBasehead({
+                owner: target.owner,
+                repo: target.repo,
+                basehead: `${pr.base.sha}...${pr.head.sha}`,
+            });
+            files = data.files ?? [];
+            mergeBaseSha = data.merge_base_commit?.sha;
+        }
+        catch {
+            // A compare the API refuses (e.g. an object id it cannot resolve for
+            // this repository) must not fail the review: the bracketed listing
+            // below still binds the files, just less tightly.
+            files = undefined;
+        }
+        // Complete only when it accounts for every file the PR reports; anything
+        // else (the 300 cap, or an API nuance) falls through to the listing.
+        if (requireMergeBase && (typeof mergeBaseSha !== "string" || !/^[a-f0-9]{40}$/.test(mergeBaseSha))) {
+            throw new Error("The exact PR comparison did not provide a valid effective merge base.");
+        }
+        if (files !== undefined && files.length === pr.changed_files)
+            return { files, ...(requireMergeBase ? { mergeBaseSha } : {}) };
+    }
+    const listed = await octokit.paginate(octokit.pulls.listFiles, {
+        owner: target.owner,
+        repo: target.repo,
+        pull_number: target.number,
+        per_page: 100,
+    });
+    const recheck = (await getGitHubPullRequest(octokit, target)).data;
+    if (recheck.head.sha !== pr.head.sha || recheck.base.sha !== pr.base.sha) {
+        throw new Error(`PR #${target.number} moved (${pr.base.sha}...${pr.head.sha} → ${recheck.base.sha}...${recheck.head.sha}) while its ${listed.length} files were being listed — rerun the review.`);
+    }
+    // GitHub lists at most 3,000 files; a shorter list than the PR reports is
+    // an incomplete diff, and an incomplete diff must never read as reviewed.
+    if (listed.length !== recheck.changed_files) {
+        throw new Error(`PR #${target.number} reports ${recheck.changed_files} changed files but the API listed ${listed.length} — the diff is incomplete (GitHub lists at most 3,000 files), refusing to review it as if it were whole.`);
+    }
+    return { files: listed, ...(requireMergeBase ? { mergeBaseSha } : {}) };
+}
+export async function fetchPRDiff(target, token, octokitClient, options = {}) {
+    const octokit = octokitClient ?? await createGitHubClient(token);
+    const pr = (await getGitHubPullRequest(octokit, target)).data;
+    // Exact-head binding: the files come from a compare pinned to the base and
+    // head object ids this very response named (see fetchChangedFiles for the
+    // large-PR fallback and its bracket), so the patches belong to `head_sha`.
+    const { files, mergeBaseSha } = await fetchChangedFiles(octokit, target, pr, options.requireMergeBase === true);
+    const metadata = {
+        owner: target.owner,
+        repo: target.repo,
+        number: target.number,
+        title: pr.title,
+        body: pr.body ?? '',
+        author: pr.user?.login ?? 'unknown',
+        base: pr.base.ref,
+        head: pr.head.ref,
+        headSha: pr.head.sha,
+        baseSha: pr.base.sha,
+        ...(mergeBaseSha ? { mergeBaseSha } : {}),
+        ...(pr.merge_commit_sha ? { mergeCommitSha: pr.merge_commit_sha } : {}),
+        url: pr.html_url,
+        labels: pr.labels.map((l) => l.name),
+        draft: pr.draft ?? false,
+    };
+    const fileChanges = files.map((f) => ({
+        filename: f.filename,
+        status: f.status,
+        additions: f.additions,
+        deletions: f.deletions,
+        patch: f.patch ?? '',
+        language: detectLanguage(f.filename),
+        previousFilename: f.previous_filename,
+        ...(f.sha ? { blobSha: f.sha } : {}),
+    }));
+    return {
+        files: fileChanges,
+        metadata,
+        source: 'github',
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/resolver/github.js.map

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

package/dist/resolver/local.d.ts

@@ -0,0 +1,3 @@
+import type { Diff } from './types.js';
+export declare function loadLocalDiff(filePath: string): Promise<Diff>;
+export declare function parseDiffFromString(diffText: string): Diff;

package/dist/resolver/local.js

@@ -0,0 +1,75 @@
+import { readFile } from 'fs/promises';
+import { detectLanguage } from '../prepare/language.js';
+function parseDiffText(diffText) {
+    const hunks = [];
+    const fileBlocks = diffText.split(/^diff --git /m).filter(Boolean);
+    for (const block of fileBlocks) {
+        const lines = block.split('\n');
+        const headerLine = lines[0] ?? '';
+        // Extract filenames from "a/path b/path"
+        const headerMatch = headerLine.match(/^a\/(.+) b\/(.+)$/);
+        if (!headerMatch)
+            continue;
+        const aPath = headerMatch[1];
+        const bPath = headerMatch[2];
+        let status = 'modified';
+        let previousFilename;
+        const deletedMatch = block.match(/^deleted file mode/m);
+        const newFileMatch = block.match(/^new file mode/m);
+        const renameFromMatch = block.match(/^rename from (.+)$/m);
+        const renameToMatch = block.match(/^rename to (.+)$/m);
+        if (deletedMatch) {
+            status = 'deleted';
+        }
+        else if (newFileMatch) {
+            status = 'added';
+        }
+        else if (renameFromMatch && renameToMatch) {
+            status = 'renamed';
+            previousFilename = renameFromMatch[1].trim();
+        }
+        const filename = status === 'deleted' ? aPath : bPath;
+        // Extract the actual patch lines (@@...)
+        const patchStart = block.indexOf('\n@@');
+        const patch = patchStart >= 0 ? block.slice(patchStart + 1) : '';
+        let additions = 0;
+        let deletions = 0;
+        for (const line of patch.split('\n')) {
+            if (line.startsWith('+') && !line.startsWith('+++'))
+                additions++;
+            if (line.startsWith('-') && !line.startsWith('---'))
+                deletions++;
+        }
+        hunks.push({
+            filename,
+            status,
+            previousFilename,
+            patch,
+            additions,
+            deletions,
+        });
+    }
+    return hunks;
+}
+export async function loadLocalDiff(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return parseDiffFromString(content);
+}
+export function parseDiffFromString(diffText) {
+    const hunks = parseDiffText(diffText);
+    const files = hunks.map((h) => ({
+        filename: h.filename,
+        status: h.status,
+        additions: h.additions,
+        deletions: h.deletions,
+        patch: h.patch,
+        language: detectLanguage(h.filename),
+        previousFilename: h.previousFilename,
+    }));
+    return {
+        files,
+        source: 'local',
+        rawDiff: diffText,
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/resolver/local.js.map

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

package/dist/resolver/plan.d.ts

@@ -0,0 +1,8 @@
+import type { Diff } from './types.js';
+/**
+ * Load a plan document as a synthetic single-file diff (the whole document
+ * as added lines) so the entire review pipeline — chunking, prompts,
+ * dedup, consensus, output — works unchanged. Finding line numbers map
+ * 1:1 onto plan document lines because the synthetic hunk starts at +1.
+ */
+export declare function loadPlanAsDiff(path: string): Promise<Diff>;

package/dist/resolver/plan.js

@@ -0,0 +1,44 @@
+import { readFile } from 'fs/promises';
+/**
+ * Plans beyond this size are not reviewable in one council pass anyway;
+ * failing loudly beats silently truncating what the models see. (The
+ * chunker additionally splits large plans at its own line limits.)
+ */
+const MAX_PLAN_BYTES = 400_000;
+/**
+ * Load a plan document as a synthetic single-file diff (the whole document
+ * as added lines) so the entire review pipeline — chunking, prompts,
+ * dedup, consensus, output — works unchanged. Finding line numbers map
+ * 1:1 onto plan document lines because the synthetic hunk starts at +1.
+ */
+export async function loadPlanAsDiff(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch {
+        throw new Error(`Could not read plan file: ${path}`);
+    }
+    if (Buffer.byteLength(content, 'utf-8') > MAX_PLAN_BYTES) {
+        throw new Error(`Plan file exceeds ${MAX_PLAN_BYTES / 1000}KB: ${path}. Split it or review a section.`);
+    }
+    if (!content.trim()) {
+        throw new Error(`Plan file is empty: ${path}`);
+    }
+    const lines = content.replace(/\n$/, '').split('\n');
+    const patch = `@@ -0,0 +1,${lines.length} @@\n` + lines.map((l) => `+${l}`).join('\n');
+    return {
+        files: [
+            {
+                filename: path,
+                status: 'added',
+                additions: lines.length,
+                deletions: 0,
+                patch,
+                language: 'plan',
+            },
+        ],
+        source: 'local',
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/resolver/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/resolver/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC;;;;GAIG;AACH,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,cAAc,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,qBAAqB,cAAc,GAAG,IAAI,OAAO,IAAI,iCAAiC,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,cAAc,KAAK,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvF,OAAO;QACL,KAAK,EAAE;YACL;gBACE,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,SAAS,EAAE,CAAC;gBACZ,KAAK;gBACL,QAAQ,EAAE,MAAM;aACjB;SACF;QACD,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC"}

package/dist/resolver/target.d.ts

@@ -0,0 +1,35 @@
+import type { Diff } from './types.js';
+import type { GitHeads } from './git.js';
+import { type RunHeaderInput } from '../report/run-header.js';
+/**
+ * Exact-head binding (IO-12475 section 8.1): which commit a diff belongs
+ * to. PR mode takes the SHAs GitHub returned with the PR; git modes use the
+ * HEAD the caller resolved around the diff read (see `runReview`); a patch
+ * file carries only its digest unless the caller vouches for its head with
+ * --head-sha — the file could have come from anywhere, so rcl never guesses
+ * from the working directory.
+ */
+export type ReviewTarget = RunHeaderInput['target'];
+export type GitDiffMode = 'staged' | 'working-tree';
+export interface TargetOverrides {
+    headSha?: string;
+    baseSha?: string;
+    /**
+     * The pull request a patch-file review is evidence for (`owner/repo#N` or a
+     * pull request URL), so Harness can verify its head and count the run for
+     * that pull request's gate (RCL-39). A converge target of the same form
+     * attributes the run the same way.
+     */
+    forPr?: string;
+    convergeTarget?: string;
+}
+export declare function resolveReviewTarget(diff: Diff, gitMode: GitDiffMode | undefined, opts: TargetOverrides, deps?: {
+    gitHeads?: GitHeads;
+    resolveGitHeads?: () => Promise<GitHeads>;
+}): Promise<ReviewTarget>;
+/**
+ * `--expect-head-sha`: refuse to review a target whose head is not the one
+ * the caller expects. The message names the way out for each target kind —
+ * a patch file can be vouched for with --head-sha, a git mode cannot.
+ */
+export declare function assertExpectedHead(target: ReviewTarget, expected: string): void;

package/dist/resolver/target.js

@@ -0,0 +1,112 @@
+import { resolveGitHeads } from './git.js';
+import { validateSha } from '../report/run-header.js';
+import { isGitHubTarget, parseGitHubTarget } from './github.js';
+import { parseRepoName } from './github.js';
+export async function resolveReviewTarget(diff, gitMode, opts, deps = {}) {
+    const overrideGiven = opts.headSha !== undefined || opts.baseSha !== undefined;
+    // `--for-pr` names the pull request a patch file stands for; a PR target
+    // names its own, and a git mode reviews a checkout, not a pull request.
+    if (opts.forPr !== undefined && (diff.metadata || gitMode)) {
+        throw new Error('--for-pr applies to patch files only; a PR target names its pull request itself and a git mode reviews the checkout.');
+    }
+    if (diff.metadata) {
+        if (overrideGiven) {
+            throw new Error('--head-sha and --base-sha apply to patch files only; a PR target resolves its heads from GitHub.');
+        }
+        const m = diff.metadata;
+        return {
+            kind: 'pr',
+            repo: `${m.owner}/${m.repo}`,
+            prNumber: m.number,
+            url: m.url,
+            headSha: m.headSha,
+            baseSha: m.baseSha,
+            headRef: m.head,
+            baseRef: m.base,
+        };
+    }
+    if (gitMode) {
+        if (overrideGiven) {
+            throw new Error(`--head-sha and --base-sha apply to patch files only; --${gitMode} resolves HEAD itself.`);
+        }
+        const heads = deps.gitHeads ?? (await (deps.resolveGitHeads ?? resolveGitHeads)());
+        return { kind: gitMode === 'staged' ? 'staged' : 'working_tree', ...heads };
+    }
+    const attributed = pullRequestFor(opts);
+    // Evidence for a pull request binds to a commit: an attributed patch without
+    // its head could be any bytes presented against that pull request's gate.
+    // The explicit flag is refused without one; a converge target only
+    // attributes when the head is there, since it is a bookkeeping key first.
+    if (attributed && opts.headSha === undefined && attributed.source === '--for-pr') {
+        throw new Error('A patch review bound to a pull request by --for-pr needs --head-sha: evidence binds to the commit it reviewed.');
+    }
+    const pr = attributed && opts.headSha !== undefined ? attributed : undefined;
+    return {
+        kind: 'patch',
+        ...(pr ? { repo: `${pr.owner}/${pr.repo}`, prNumber: pr.number, url: `https://github.com/${pr.owner}/${pr.repo}/pull/${pr.number}` } : {}),
+        ...(opts.headSha !== undefined ? { headSha: validateSha(opts.headSha, '--head-sha') } : {}),
+        ...(opts.baseSha !== undefined ? { baseSha: validateSha(opts.baseSha, '--base-sha') } : {}),
+    };
+}
+/**
+ * The pull request a patch review stands for: `--for-pr` when given (an
+ * invalid value is an error), else a converge target that parses cleanly as
+ * `owner/repo#N` (anything else — a slug such as `rcl-7`, a malformed
+ * reference — is a bookkeeping key and attributes nothing).
+ */
+function pullRequestFor(opts) {
+    if (opts.forPr !== undefined) {
+        const text = opts.forPr.trim();
+        if (!isGitHubTarget(text))
+            throw new Error(`--for-pr must name a pull request as owner/repo#N or a pull request URL, got "${text}".`);
+        const pr = checked(parseGitHubTarget(text));
+        if (!pr)
+            throw new Error('--for-pr does not name a GitHub pull request.');
+        return { ...pr, source: '--for-pr' };
+    }
+    if (opts.convergeTarget !== undefined && isGitHubTarget(opts.convergeTarget.trim())) {
+        const pr = checked(parseGitHubTarget(opts.convergeTarget.trim()));
+        return pr ? { ...pr, source: '--converge-target' } : undefined;
+    }
+    return undefined;
+}
+/** GitHub's segment rules for both names and a positive number, lower-cased (one spelling, one key on the server); `null` otherwise. */
+function checked(pr) {
+    if (parseRepoName(`${pr.owner}/${pr.repo}`) === null || !Number.isSafeInteger(pr.number) || pr.number <= 0)
+        return null;
+    return { owner: pr.owner.toLowerCase(), repo: pr.repo.toLowerCase(), number: pr.number };
+}
+/**
+ * `--expect-head-sha`: refuse to review a target whose head is not the one
+ * the caller expects. The message names the way out for each target kind —
+ * a patch file can be vouched for with --head-sha, a git mode cannot.
+ */
+export function assertExpectedHead(target, expected) {
+    const sha = validateSha(expected, '--expect-head-sha');
+    if (target.headSha === undefined) {
+        // A PR target always carries its head (PRMetadata requires it); only a
+        // patch file or a git mode outside a repository can lack one.
+        const hint = target.kind === 'patch'
+            ? 'pass --head-sha with the patch file'
+            : 'HEAD could not be resolved (not a git repository, or an unborn branch)';
+        throw new Error(`--expect-head-sha was given but this ${describeKind(target.kind)} has no head SHA: ${hint}.`);
+    }
+    if (target.headSha !== sha) {
+        throw new Error(`Resolved head ${target.headSha} does not match --expect-head-sha ${sha}; the target has moved — refusing to review.`);
+    }
+}
+function describeKind(kind) {
+    switch (kind) {
+        case 'pr':
+            return 'PR';
+        case 'patch':
+            return 'patch file';
+        case 'working_tree':
+            return 'working-tree diff';
+        case 'staged':
+            return 'staged diff';
+        case 'plan':
+            return 'plan';
+    }
+}
+//# sourceMappingURL=target.js.map

package/dist/resolver/target.js.map

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