@reneturcios/greenlight 0.14.0 → 0.15.1

package/dist/brief.d.ts

@@ -0,0 +1,94 @@
+import { type CiTriageDeps, type CiTriageResult } from "./ci-triage.js";
+import { type ReviewTriageDeps, type ReviewTriageResult } from "./review-triage.js";
+export type BriefFileArea = "source" | "tests" | "config" | "docs" | "generated" | "other";
+export interface BriefFile {
+    filename: string;
+    status: "added" | "modified" | "removed" | "renamed" | "other";
+    additions: number;
+    deletions: number;
+    area: BriefFileArea;
+}
+export interface BriefResult {
+    pr: string;
+    number: number;
+    title: string;
+    author: string;
+    state: string;
+    merged: boolean;
+    draft: boolean;
+    url: string;
+    createdAt: string;
+    ageDays: number;
+    baseRef: string;
+    size: {
+        additions: number;
+        deletions: number;
+        filesChanged: number;
+    };
+    areas: Array<{
+        area: BriefFileArea;
+        files: string[];
+    }>;
+    ci: CiTriageResult;
+    review: ReviewTriageResult;
+    testEvidence: {
+        newOrChangedTestFiles: string[];
+        /** Plain statement: what test evidence exists, or that none does. */
+        note: string;
+    };
+    /** Concrete merge blockers found, each with evidence. */
+    blockers: string[];
+    /** Things not verified, stated plainly. */
+    unverified: string[];
+    /** One line: what the reviewer should look at first. */
+    lookFirst: string;
+    /** API calls consumed (measured, for budget honesty). */
+    apiCalls: number;
+}
+export interface BriefDeps {
+    /** Test seam / alternate PR detail fetch. */
+    fetchPullDetail?: (owner: string, repo: string, number: number) => Promise<PullDetailFull>;
+    /** Test seam / alternate file list fetch. */
+    fetchPullFiles?: (owner: string, repo: string, number: number) => Promise<BriefFile[]>;
+    /** Test seam / alternate reviews fetch (for change-request blockers). */
+    fetchReviews?: (owner: string, repo: string, number: number) => Promise<ReviewStateItem[]>;
+    /** Test seam / alternate contributing-text fetch (changeset signal). */
+    fetchContributingText?: (owner: string, repo: string) => Promise<string | undefined>;
+    /** Forwarded to the CI triage engine. */
+    ciDeps?: CiTriageDeps;
+    /** Forwarded to the review triage engine. */
+    reviewDeps?: ReviewTriageDeps;
+}
+export interface PullDetailFull {
+    title: string;
+    author: string;
+    state: string;
+    merged: boolean;
+    draft: boolean;
+    url: string;
+    createdAt: string;
+    baseRef: string;
+    mergeable: boolean | null;
+    mergeableState: string;
+}
+export interface ReviewStateItem {
+    state: string;
+    author: string;
+    dismissed: boolean;
+}
+/**
+ * Parse a PR target: full /pull/ URL, or owner/repo#N shorthand.
+ * Throws a usage error otherwise.
+ */
+export declare function parseBriefTarget(target: string): {
+    owner: string;
+    repo: string;
+    number: number;
+};
+/** Area classification for a file path. Pure. */
+export declare function fileArea(path: string): BriefFileArea;
+/**
+ * The brief pipeline. Best-effort per source: a failed fetch degrades to
+ * an "unverified" note, never to silence or a fabricated verdict.
+ */
+export declare function briefPR(target: string, deps?: BriefDeps): Promise<BriefResult>;

package/dist/brief.js

@@ -0,0 +1,283 @@
+/**
+ * PR Brief: a verified review brief for ANY pull request.
+ *
+ * Generalizes the existing review/CI triage (built for our own PRs) into a
+ * one-screen brief any reviewer — or maintainer — can read before opening
+ * the diff. This is the overlap into review tooling (CodeRabbit/Greptile
+ * territory) done Greenlight's way: every claim carries quoted evidence
+ * or a link, classifications come from the existing deterministic triage
+ * engines, and anything unverified is marked as such. No generic praise,
+ * no invented findings.
+ *
+ * Sections:
+ *   1. What changed: files grouped by area/risk (source, tests, config,
+ *      docs, generated, other), plus size and shape.
+ *   2. CI: the existing ci_triage base-vs-head classification, reused.
+ *   3. Review findings: the existing review-triage classification, reused
+ *      (real vs false-positive vs already-addressed, each with evidence).
+ *   4. Test evidence present in the PR (new/changed test files), or
+ *      explicitly marked absent.
+ *   5. Merge-readiness blockers: conflicts, unresolved change requests,
+ *      missing changeset where the repo requires one.
+ *   6. A one-line "look at this first" for the reviewer.
+ *
+ * Budget: PR detail (1) + files (1-2) + reviews (1-2) + the triage
+ * engines' own fetches + house-rules (cached, 24h TTL) for the changeset
+ * signal. All reads ride the existing file cache.
+ */
+import { apiCallsUsed, apiGet, cacheGet, cacheSet, fetchContributing, parsePullUrl, } from "./github.js";
+import { triagePr } from "./ci-triage.js";
+import { triageReview } from "./review-triage.js";
+/**
+ * Parse a PR target: full /pull/ URL, or owner/repo#N shorthand.
+ * Throws a usage error otherwise.
+ */
+export function parseBriefTarget(target) {
+    const t = target.trim();
+    try {
+        return parsePullUrl(t);
+    }
+    catch {
+        const m = /^([^/]+)\/([^/#]+)#(\d+)$/.exec(t);
+        if (!m) {
+            throw new Error(`Not a PR target: ${target} (expected a pull-request URL or owner/repo#N)`);
+        }
+        return { owner: m[1], repo: m[2], number: Number(m[3]) };
+    }
+}
+/** Area classification for a file path. Pure. */
+export function fileArea(path) {
+    const p = path.toLowerCase();
+    if (/\/tests?\/|\/__tests__\/|\.test\.|\.spec\.|_test\.|-test\.|test_\b/.test(p) ||
+        p.startsWith("test/") ||
+        p.startsWith("tests/")) {
+        return "tests";
+    }
+    if (p.startsWith(".github/") ||
+        p.endsWith("package-lock.json") ||
+        p.endsWith("yarn.lock") ||
+        p.endsWith("pnpm-lock.yaml") ||
+        p.endsWith(".lock") ||
+        /(^|\/)dist\//.test(p) ||
+        p.endsWith(".min.js") ||
+        p.endsWith(".map") ||
+        /\/generated\//.test(p)) {
+        return "generated";
+    }
+    if (p.startsWith(".") ||
+        /(^|\/)(config|conf|settings?|scripts?|tools?|tooling|build|ci|infra|docker|k8s|kubernetes)\//.test(p) ||
+        /\.(ya?ml|toml|ini|cfg|env|example)$/.test(p) ||
+        p === "package.json" ||
+        p === "tsconfig.json" ||
+        p === "dockerfile") {
+        return "config";
+    }
+    if (p.endsWith(".md") || p.endsWith(".mdx") || p.startsWith("docs/") || p.startsWith("doc/")) {
+        return "docs";
+    }
+    if (/\.(ts|tsx|js|jsx|mjs|cjs|py|go|rs|rb|php|java|kt|swift|c|cpp|h|hpp|cs|vue|svelte)$/.test(p)) {
+        return "source";
+    }
+    return "other";
+}
+function toBriefFile(item) {
+    const filename = String(item.filename ?? "");
+    const rawStatus = String(item.status ?? "other").toLowerCase();
+    const status = rawStatus === "added" || rawStatus === "modified" || rawStatus === "removed" || rawStatus === "renamed"
+        ? rawStatus
+        : "other";
+    return {
+        filename,
+        status,
+        additions: typeof item.additions === "number" ? item.additions : 0,
+        deletions: typeof item.deletions === "number" ? item.deletions : 0,
+        area: fileArea(filename),
+    };
+}
+async function defaultFetchPullDetail(owner, repo, number) {
+    const key = [owner, repo, String(number), "brief-detail"];
+    const cached = cacheGet("issue", key);
+    if (cached)
+        return cached;
+    const p = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}`));
+    const detail = {
+        title: String(p.title ?? ""),
+        author: String(p.user?.login ?? "unknown"),
+        state: String(p.state ?? "open"),
+        merged: p.merged_at != null,
+        draft: Boolean(p.draft),
+        url: String(p.html_url ?? `https://github.com/${owner}/${repo}/pull/${number}`),
+        createdAt: String(p.created_at ?? ""),
+        baseRef: String(p.base?.ref ?? ""),
+        mergeable: p.mergeable ?? null,
+        mergeableState: String(p.mergeable_state ?? "unknown"),
+    };
+    cacheSet("issue", key, detail);
+    return detail;
+}
+async function defaultFetchPullFiles(owner, repo, number) {
+    const key = [owner, repo, String(number), "brief-files"];
+    const cached = cacheGet("issue", key);
+    if (cached)
+        return cached;
+    const files = [];
+    for (let page = 1; page <= 5; page++) {
+        const data = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}/files?per_page=100&page=${page}`));
+        for (const item of data ?? [])
+            files.push(toBriefFile(item));
+        if ((data ?? []).length < 100)
+            break;
+    }
+    cacheSet("issue", key, files);
+    return files;
+}
+async function defaultFetchReviews(owner, repo, number) {
+    const data = (await apiGet(`/repos/${owner}/${repo}/pulls/${number}/reviews?per_page=100`));
+    return (data ?? []).map((r) => ({
+        state: String(r.state ?? ""),
+        author: String(r.user?.login ?? "unknown"),
+        dismissed: String(r.state ?? "") === "DISMISSED",
+    }));
+}
+const ageDays = (iso) => {
+    const t = Date.parse(iso);
+    if (!Number.isFinite(t))
+        return 0;
+    return Math.floor((Date.now() - t) / (24 * 60 * 60 * 1000));
+};
+/**
+ * The brief pipeline. Best-effort per source: a failed fetch degrades to
+ * an "unverified" note, never to silence or a fabricated verdict.
+ */
+export async function briefPR(target, deps = {}) {
+    const callsBefore = apiCallsUsed();
+    const { owner, repo, number } = parseBriefTarget(target);
+    const prUrl = `https://github.com/${owner}/${repo}/pull/${number}`;
+    const unverified = [];
+    const blockers = [];
+    const fetchPullDetail = deps.fetchPullDetail ?? defaultFetchPullDetail;
+    const fetchPullFiles = deps.fetchPullFiles ?? defaultFetchPullFiles;
+    const fetchReviews = deps.fetchReviews ?? defaultFetchReviews;
+    let detail;
+    try {
+        detail = await fetchPullDetail(owner, repo, number);
+    }
+    catch (err) {
+        throw new Error(`could not fetch PR ${prUrl}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let files;
+    try {
+        files = await fetchPullFiles(owner, repo, number);
+    }
+    catch {
+        files = [];
+        unverified.push("changed-file list unavailable; area breakdown is empty");
+    }
+    // Reviews for change-request blockers (independent of the triage engine).
+    let reviews = [];
+    try {
+        reviews = await fetchReviews(owner, repo, number);
+    }
+    catch {
+        unverified.push("review list unavailable; change-request blocker check skipped");
+    }
+    const openChangeRequests = reviews.filter((r) => r.state === "CHANGES_REQUESTED" && !r.dismissed && r.author !== detail.author);
+    for (const r of openChangeRequests) {
+        blockers.push(`unresolved change request from @${r.author}`);
+    }
+    // Merge conflicts.
+    if (detail.mergeable === false || detail.mergeableState === "dirty") {
+        blockers.push("merge conflicts (mergeable_state=dirty)");
+    }
+    else if (detail.mergeable === null && detail.mergeableState === "unknown") {
+        unverified.push("mergeable state not reported by GitHub yet");
+    }
+    // CI classification: reuse the existing triage engine (base vs head).
+    let ci;
+    try {
+        ci = await triagePr(prUrl, deps.ciDeps ?? {});
+    }
+    catch {
+        ci = {
+            pr: prUrl, title: detail.title, baseRef: detail.baseRef, baseSha: "",
+            headSha: "", verdict: "NO FAILURES", checks: [],
+        };
+        unverified.push("CI triage unavailable");
+    }
+    // Review findings: reuse the existing deterministic review triage.
+    let review;
+    try {
+        review = await triageReview(prUrl, deps.reviewDeps ?? {});
+    }
+    catch {
+        review = {
+            pr: prUrl, title: detail.title, verdict: "NO FINDINGS",
+            findings: [], counts: { likelyReal: 0, likelyNoise: 0, needsDecision: 0, noise: 0, resolved: 0 },
+        };
+        unverified.push("review triage unavailable");
+    }
+    // Changeset convention (remote variant of ci-prep's signal): repo
+    // mentions changesets in its policy files, but the PR ships no
+    // .changeset file -> blocker.
+    try {
+        const contributing = deps.fetchContributingText
+            ? await deps.fetchContributingText(owner, repo)
+            : await fetchContributing(owner, repo);
+        if (contributing && /changeset/i.test(contributing)) {
+            const hasChangeset = files.some((f) => /(^|\/)\.changeset\//.test(f.filename));
+            if (!hasChangeset)
+                blockers.push("repo requires changesets (CONTRIBUTING), none in this PR");
+        }
+    }
+    catch {
+        unverified.push("changeset convention check skipped (policy fetch failed)");
+    }
+    // Area breakdown.
+    const areaOrder = ["source", "tests", "config", "docs", "generated", "other"];
+    const areas = areaOrder
+        .map((area) => ({ area, files: files.filter((f) => f.area === area).map((f) => f.filename) }))
+        .filter((g) => g.files.length > 0);
+    const additions = files.reduce((s, f) => s + f.additions, 0);
+    const deletions = files.reduce((s, f) => s + f.deletions, 0);
+    // Test evidence: new or changed test-area files, stated plainly.
+    const testFiles = files.filter((f) => f.area === "tests").map((f) => f.filename);
+    const testEvidenceNote = testFiles.length > 0
+        ? `${testFiles.length} test file${testFiles.length === 1 ? "" : "s"} touched — verification is visible in the PR`
+        : "no test files touched — verification is not visible in this PR";
+    // Look-first: blockers first, then real findings, then CI, else shape.
+    const firstReal = review.findings?.find((f) => f.class === "likely-real");
+    const firstFailing = ci.checks?.find((c) => c.class === "likely-yours");
+    const biggestArea = areas.reduce((best, g) => (best === undefined || g.files.length > best.count ? { area: g.area, count: g.files.length } : best), undefined);
+    const lookFirst = blockers.length > 0
+        ? `Start here: ${blockers[0]}.`
+        : firstReal !== undefined
+            ? `Start here: ${firstReal.author}'s ${firstReal.class} finding${firstReal.path ? ` on ${firstReal.path}` : ""}: ${firstReal.summary}.`
+            : firstFailing !== undefined
+                ? `Start here: CI check "${firstFailing.name}" classified ${firstFailing.class}: ${firstFailing.evidence}.`
+                : biggestArea !== undefined
+                    ? `No blockers or real findings. Start here: ${biggestArea.count} ${biggestArea.area} file${biggestArea.count === 1 ? "" : "s"} carry the change.`
+                    : "No blockers, findings, or files visible. Nothing to review.";
+    return {
+        pr: prUrl,
+        number,
+        title: detail.title,
+        author: detail.author,
+        state: detail.merged ? "merged" : detail.state,
+        merged: detail.merged,
+        draft: detail.draft,
+        url: detail.url,
+        createdAt: detail.createdAt,
+        ageDays: ageDays(detail.createdAt),
+        baseRef: detail.baseRef,
+        size: { additions, deletions, filesChanged: files.length },
+        areas,
+        ci,
+        review,
+        testEvidence: { newOrChangedTestFiles: testFiles, note: testEvidenceNote },
+        blockers,
+        unverified,
+        lookFirst,
+        apiCalls: apiCallsUsed() - callsBefore,
+    };
+}
+//# sourceMappingURL=brief.js.map

package/dist/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../src/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAA0C,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAkD,MAAM,oBAAoB,CAAC;AA6ElG;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CACb,oBAAoB,MAAM,gDAAgD,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IACE,oEAAoE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,EACtB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IACE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxB,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC/B,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC5B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClB,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EACvB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IACE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QACjB,8FAA8F,CAAC,IAAI,CAAC,CAAC,CAAC;QACtG,qCAAqC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC,KAAK,cAAc;QACpB,CAAC,KAAK,eAAe;QACrB,CAAC,KAAK,YAAY,EAClB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,oFAAoF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AASD,SAAS,WAAW,CAAC,IAAiB;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,MAAM,MAAM,GACV,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QACrG,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC;IACd,OAAO;QACL,QAAQ;QACR,MAAM;QACN,SAAS,EAAE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClE,SAAS,EAAE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAc;IAC/E,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAA+B,CAAC;IACpE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,MAAM,EAAE,CAAC,CAA4B,CAAC;IAC/F,MAAM,MAAM,GAAmB;QAC7B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAE,CAAC,CAAC,IAA4C,EAAE,KAAK,IAAI,SAAS,CAAC;QACnF,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;QAChC,MAAM,EAAG,CAAC,CAAC,SAAqB,IAAI,IAAI;QACxC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;QAC/E,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,MAAM,CAAE,CAAC,CAAC,IAA4C,EAAE,GAAG,IAAI,EAAE,CAAC;QAC3E,SAAS,EAAG,CAAC,CAAC,SAAwC,IAAI,IAAI;QAC9D,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC;KACvD,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAc;IAC9E,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAA4B,CAAC;IACjE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CACxB,UAAU,KAAK,IAAI,IAAI,UAAU,MAAM,4BAA4B,IAAI,EAAE,CAC1E,CAAkB,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,IAAI,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM;IACvC,CAAC;IACD,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAc;IAC5E,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CACxB,UAAU,KAAK,IAAI,IAAI,UAAU,MAAM,uBAAuB,CAC/D,CAAmC,CAAC;IACrC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAE,CAAC,CAAC,IAA4C,EAAE,KAAK,IAAI,SAAS,CAAC;QACnF,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,WAAW;KACjD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,GAAW,EAAU,EAAE;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,OAAkB,EAAE;IAChE,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,sBAAsB,KAAK,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;IACnE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,sBAAsB,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,qBAAqB,CAAC;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,mBAAmB,CAAC;IAE9D,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,EAAE,CAAC;QACX,UAAU,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,0EAA0E;IAC1E,IAAI,OAAO,GAAsB,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,mBAAmB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CACrF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,mBAAmB;IACnB,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,IAAI,MAAM,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC5E,UAAU,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,sEAAsE;IACtE,IAAI,EAAkB,CAAC;IACvB,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,GAAG;YACH,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YACpE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE;SACnB,CAAC;QAC/B,UAAU,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,mEAAmE;IACnE,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG;YACP,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa;YACtD,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;SAChE,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,kEAAkE;IAClE,+DAA+D;IAC/D,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB;YAC7C,CAAC,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC;YAC/C,CAAC,CAAC,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,YAAY;gBAAE,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,SAAS;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;SAC7F,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAE7D,iEAAiE;IACjE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjF,MAAM,gBAAgB,GACpB,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,aAAa,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,8CAA8C;QACjH,CAAC,CAAC,gEAAgE,CAAC;IAEvE,uEAAuE;IACvE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EACjH,SAAS,CACV,CAAC;IACF,MAAM,SAAS,GACb,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,eAAe,QAAQ,CAAC,CAAC,CAAC,GAAG;QAC/B,CAAC,CAAC,SAAS,KAAK,SAAS;YACvB,CAAC,CAAC,eAAe,SAAS,CAAC,MAAM,MAAM,SAAS,CAAC,KAAK,WAAW,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,OAAO,GAAG;YACvI,CAAC,CAAC,YAAY,KAAK,SAAS;gBAC1B,CAAC,CAAC,yBAAyB,YAAY,CAAC,IAAI,gBAAgB,YAAY,CAAC,KAAK,KAAK,YAAY,CAAC,QAAQ,GAAG;gBAC3G,CAAC,CAAC,WAAW,KAAK,SAAS;oBACzB,CAAC,CAAC,6CAA6C,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,QAAQ,WAAW,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oBAAoB;oBAClJ,CAAC,CAAC,6DAA6D,CAAC;IAE1E,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;QAC9C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE;QAC1D,KAAK;QACL,EAAE;QACF,MAAM;QACN,YAAY,EAAE,EAAE,qBAAqB,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE;QAC1E,QAAQ;QACR,UAAU;QACV,SAAS;QACT,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW;KACvC,CAAC;AACJ,CAAC"}

package/dist/cli.js

@@ -50,6 +50,8 @@ import { scoutCampaign, SCOUT_DEFAULT_BUDGET } from "./scout.js";
 import { buildVerifiedComment, suggestsVerifiedComment, verifiedCommentSuggestion, parseNoteFile, } from "./verify-comment.js";
 import { verifyRepo } from "./verify.js";
 import { runCiPrep, formatCiPrepHuman } from "./ci-prep.js";
+import { radarPRs } from "./radar.js";
+import { briefPR } from "./brief.js";
 import { babysit, defaultStatePath, defaultAccountAuthor } from "./babysit.js";
 import { runAutopilot, defaultAutopilotStatePath } from "./autopilot.js";
 import { runSync, formatSyncHuman, syncJson } from "./sync.js";
@@ -776,6 +778,66 @@ async function cmdCiPrep(target, args) {
     if (result.verdict === "NO-GO")
         process.exitCode = 1;
 }
+async function cmdRadar(repoRef, args) {
+    const { owner, repo } = parseRepoRef(repoRef);
+    const asJson = args.includes("--json");
+    const limitRaw = flagValue(args, "--limit");
+    const limit = limitRaw !== undefined ? Math.max(1, Math.min(Math.trunc(Number(limitRaw)) || 25, 100)) : 25;
+    const result = await radarPRs(owner, repo, { limit });
+    if (asJson) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`PR Radar for ${result.repo}: ${result.prsScanned} open PRs scanned, ${result.clusters.length} competing cluster(s), ${result.unclustered.length} unclustered (${result.apiCalls} API calls)`);
+    if (result.clusters.length === 0) {
+        console.log("No competing-PR clusters found. The open queue has no obvious duplicates.");
+        return;
+    }
+    for (const c of result.clusters) {
+        const kindLabel = c.kind === "same-issue" ? "same issue" : "file overlap";
+        const what = c.issue ? `competing on issue #${c.issue.number} (${c.issue.url})` : "no shared linked issue";
+        console.log(`\n[${kindLabel}] ${what}`);
+        for (const ev of c.evidence)
+            console.log(`  - ${ev}`);
+        console.log(`  suggested keep (heuristic): #${c.suggestedKeep} — ${c.suggestedKeepReason}`);
+    }
+}
+async function cmdBrief(target, args) {
+    const asJson = args.includes("--json");
+    const result = await briefPR(target);
+    if (asJson) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`PR Brief: ${result.pr}`);
+    console.log(`  "${result.title}" by @${result.author} — ${result.state}${result.draft ? " (draft)" : ""}, ${result.ageDays}d old`);
+    console.log(`  size: ${result.size.filesChanged} files, +${result.size.additions}/-${result.size.deletions}`);
+    for (const g of result.areas) {
+        console.log(`  ${g.area}: ${g.files.length} file${g.files.length === 1 ? "" : "s"}`);
+    }
+    console.log(`  CI: ${result.ci.verdict}`);
+    for (const check of (result.ci.checks ?? []).filter((c) => c.class !== "pre-existing")) {
+        console.log(`    [${check.class}] ${check.name}: ${check.evidence}`);
+    }
+    const rc = result.review.counts;
+    console.log(`  review: ${result.review.verdict} (real: ${rc.likelyReal}, needs decision: ${rc.needsDecision}, noise: ${rc.likelyNoise})`);
+    for (const f of (result.review.findings ?? []).filter((x) => x.class === "likely-real").slice(0, 5)) {
+        console.log(`    [${f.author}] ${f.summary}${f.path ? ` (${f.path})` : ""}`);
+        console.log(`      why: ${f.reason}`);
+    }
+    console.log(`  tests: ${result.testEvidence.note}`);
+    if (result.blockers.length > 0) {
+        console.log("  BLOCKERS:");
+        for (const b of result.blockers)
+            console.log(`    - ${b}`);
+    }
+    if (result.unverified.length > 0) {
+        console.log("  not verified:");
+        for (const u of result.unverified)
+            console.log(`    - ${u}`);
+    }
+    console.log(`\n  ${result.lookFirst}`);
+}
 async function cmdReview(prUrl, asJson) {
     const result = await triageReview(prUrl);
     if (asJson) {
@@ -1396,6 +1458,10 @@ async function main() {
             return await cmdCiPrep(target, args);
         if (command === "review" && target)
             return await cmdReview(target, args.includes("--json"));
+        if (command === "radar" && target)
+            return await cmdRadar(target, args);
+        if (command === "brief" && target)
+            return await cmdBrief(target, args);
         if (command === "guard" && target)
             return await cmdGuard(target, args);
         if (command === "digest" && target)