@reneturcios/greenlight 0.10.1 → 0.11.0

package/dist/autopilot-triage.js

@@ -0,0 +1,222 @@
+import { authorKindOf } from "./review-triage.js";
+/**
+ * Pull candidate file paths and short code quotes out of a bot finding body.
+ * Review comments usually name the file explicitly (backticked paths or
+ * file names) or ship a diff hunk; both are usable for verification.
+ */
+export function extractCandidates(body, anchoredPath) {
+    const paths = new Set();
+    if (anchoredPath)
+        paths.add(anchoredPath);
+    const backtick = body.match(/`([^`\n]{1,120})`/g) ?? [];
+    for (const b of backtick) {
+        const inner = b.slice(1, -1).trim();
+        if (/^[a-zA-Z0-9_./-]+\.[a-zA-Z0-9]{1,8}$/.test(inner) || inner.startsWith("src/") || inner.startsWith("packages/")) {
+            paths.add(inner.replace(/^\.\//, ""));
+        }
+    }
+    const quoted = [];
+    for (const m of body.matchAll(/^```(?:\w+)?\n([\s\S]{1,800}?)\n```/gm)) {
+        const snippet = m[1].trim();
+        if (snippet.length >= 12)
+            quoted.push(snippet);
+    }
+    const inline = body.match(/`([^`]{12,160})`/g) ?? [];
+    for (const b of inline)
+        quoted.push(b.slice(1, -1));
+    return { paths: [...paths].slice(0, 4), quotes: quoted.slice(0, 4) };
+}
+const normalize = (s) => s.replace(/\s+/g, " ").trim();
+/**
+ * Deterministically verify one bot finding against the code at head.
+ * REAL when the flagged pattern exists as described; FALSE_POSITIVE when
+ * it demonstrably does not (counter-evidence quoted); NEEDS_HUMAN when the
+ * files cannot be resolved or the claim is not checkable this way.
+ */
+export async function verifyBotFinding(item, deps = {}) {
+    const { paths, quotes } = extractCandidates(item.body, item.path);
+    const fetchFile = deps.fetchFileAtHead;
+    if (paths.length === 0 && quotes.length === 0) {
+        return {
+            verdict: "NEEDS_HUMAN",
+            evidence: "finding names no file and quotes no code to verify against",
+        };
+    }
+    if (!fetchFile) {
+        return {
+            verdict: "NEEDS_HUMAN",
+            evidence: "no file fetcher available, cannot verify against head",
+        };
+    }
+    const texts = [];
+    for (const p of paths) {
+        try {
+            const content = await fetchFile(p);
+            if (content !== null)
+                texts.push(content);
+        }
+        catch {
+            // unreadable file: keep going with what we have
+        }
+    }
+    if (texts.length === 0) {
+        return {
+            verdict: "NEEDS_HUMAN",
+            evidence: `could not read any of the referenced files (${paths.join(", ")}) at head`,
+        };
+    }
+    const haystack = normalize(texts.join("\n"));
+    let real = false;
+    let falsePositive = false;
+    let counter = "";
+    for (const q of quotes) {
+        const needle = normalize(q);
+        if (needle.length < 12)
+            continue;
+        if (haystack.includes(needle)) {
+            real = true;
+        }
+        else if (!counter) {
+            // A quoted code block that does not exist at head is a candidate
+            // false positive, unless it is clearly a suggestion (diff-like).
+            if (!/^[+-]/.test(q.trim()) && !/\bsuggest\b|\binstead\b/i.test(item.body)) {
+                falsePositive = true;
+                counter = q.length > 160 ? q.slice(0, 160) + "..." : q;
+            }
+        }
+    }
+    if (real) {
+        return { verdict: "REAL", evidence: `quoted code is present at head (${paths.length} file(s) checked)` };
+    }
+    if (falsePositive) {
+        return {
+            verdict: "FALSE_POSITIVE",
+            evidence: `the finding quotes "${counter}", which does not exist at head in any referenced file`,
+        };
+    }
+    return {
+        verdict: "NEEDS_HUMAN",
+        evidence: "the finding's claim could not be reduced to a code lookup",
+    };
+}
+/** Kind-only classification for review items, before any verification. */
+export function classifyReviewItem(input) {
+    const body = input.body;
+    const state = (input.reviewState ?? "").toUpperCase();
+    if (state === "APPROVED")
+        return "approval";
+    if (state === "CHANGES_REQUESTED")
+        return "review_change_request";
+    if (input.authorKind === "bot")
+        return "bot_finding";
+    // Human authors: questions and requests are maintainer input, not noise.
+    if (/\?\s*$/.test(body.trim()) || /\?(\s|$)/.test(body.slice(0, 200)))
+        return "maintainer_question";
+    if (/\b(please|could you|would you|can you)\b/i.test(body))
+        return "maintainer_question";
+    return "other";
+}
+/**
+ * Build Autopilot feedback items from review-triage findings, keeping the
+ * triage class and the ready reply draft. Bot findings keep kind
+ * "bot_finding" so the verifier can adjudicate them.
+ */
+export function feedbackFromReviewFindings(findings, prAuthor) {
+    const out = [];
+    for (const f of findings) {
+        const isAuthor = f.author === prAuthor;
+        if (isAuthor)
+            continue; // the author's own comments are replies, not incoming
+        const kind = f.class === "likely-noise"
+            ? "other"
+            : classifyReviewItem({ body: f.summary, author: f.author, authorKind: f.authorKind });
+        out.push({
+            id: `finding:${f.author}:${oneLineKey(f.summary)}`,
+            kind: f.class === "likely-noise" ? "other" : kind,
+            title: f.summary.slice(0, 120),
+            body: f.summary,
+            author: f.author,
+            authorKind: f.authorKind,
+            path: f.path,
+            line: f.line,
+            // Bot findings are verified against head by the Autopilot run after this.
+            verdict: undefined,
+            evidence: f.reason,
+            draftReply: f.draft || undefined,
+        });
+    }
+    return out;
+}
+function oneLineKey(s) {
+    return s.replace(/\s+/g, " ").trim().slice(0, 60);
+}
+/**
+ * Build feedback items from CI triage. Only failures the classifier leans
+ * "yours" or cannot place (indeterminate) become fix candidates; pre-existing
+ * and external blockers are reported but never touched.
+ */
+export function feedbackFromCiChecks(checks) {
+    return checks
+        .filter((c) => c.conclusion !== "success")
+        .map((c) => ({
+        id: `check:${c.name}`,
+        kind: "ci_failure",
+        title: `CI: ${c.name} (${c.conclusion})`,
+        body: [c.name, c.conclusion, c.failureLines?.join(" | ") ?? ""].filter(Boolean).join(" - "),
+        author: "ci",
+        authorKind: "bot",
+        url: c.detailsUrl,
+        evidence: c.evidence,
+        verdict: c.class === "likely-yours"
+            ? "REAL"
+            : c.class === "indeterminate"
+                ? "NEEDS_HUMAN"
+                : "FALSE_POSITIVE",
+    }));
+}
+export function summarizeFeedback(items) {
+    const byKind = {
+        ci_failure: 0,
+        review_change_request: 0,
+        bot_finding: 0,
+        merge_conflict: 0,
+        dco_gap: 0,
+        maintainer_question: 0,
+        approval: 0,
+        other: 0,
+    };
+    let botFindingsReal = 0;
+    let botFindingsFalsePositive = 0;
+    let botFindingsNeedsHuman = 0;
+    let ciIntroduced = 0;
+    let ciPreExistingOrExternal = 0;
+    for (const i of items) {
+        byKind[i.kind] += 1;
+        if (i.kind === "bot_finding") {
+            if (i.verdict === "REAL")
+                botFindingsReal += 1;
+            else if (i.verdict === "FALSE_POSITIVE")
+                botFindingsFalsePositive += 1;
+            else if (i.verdict === "NEEDS_HUMAN")
+                botFindingsNeedsHuman += 1;
+        }
+        if (i.kind === "ci_failure") {
+            if (i.verdict === "REAL")
+                ciIntroduced += 1;
+            else
+                ciPreExistingOrExternal += 1;
+        }
+    }
+    return {
+        total: items.length,
+        byKind,
+        botFindingsReal,
+        botFindingsFalsePositive,
+        botFindingsNeedsHuman,
+        ciIntroduced,
+        ciPreExistingOrExternal,
+    };
+}
+// Re-export for callers that only need the author kind helper.
+export { authorKindOf };
+//# sourceMappingURL=autopilot-triage.js.map

package/dist/autopilot-triage.js.map

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

package/dist/autopilot.d.ts

@@ -0,0 +1,207 @@
+import { type CensusPr } from "./sync.js";
+import { type ClassifiedCheck } from "./ci-triage.js";
+import { authorKindOf } from "./review-triage.js";
+import { type GitOps } from "./autopilot-git.js";
+import { type FeedbackItem, type FeedbackKind } from "./autopilot-triage.js";
+import { type GitRunner } from "./autopilot-fixes.js";
+/** Rene's identity for fix commits. Standing signatory authority, non-legal. */
+export declare const AUTOPILOT_COMMITTER: {
+    name: string;
+    email: string;
+};
+export interface AutopilotPull {
+    owner: string;
+    repo: string;
+    number: number;
+    url: string;
+    title: string;
+    author: string;
+    headSha: string;
+    baseRef: string;
+    baseSha: string;
+    mergeable: boolean | null;
+    mergeableState: string | null;
+    forkOwner: string;
+    forkRepo: string;
+    forkBranch: string;
+    forkCloneUrl: string;
+}
+export interface PrWatermark {
+    lastHeadSha: string;
+    lastReviewId: number;
+    lastReviewCommentId: number;
+    lastIssueCommentId: number;
+    checkConclusions: Record<string, string>;
+}
+export interface AutopilotState {
+    version: number;
+    prs: Record<string, PrWatermark>;
+}
+export declare function defaultAutopilotStatePath(): string;
+export declare function defaultRepliesPath(): string;
+/**
+ * Autopilot consumes the v0.10.1 capability ledger (src/capabilities.ts)
+ * rather than duplicating it: loadCapabilities reads the canonical
+ * ~/.greenlight/capabilities.json shape, prCreateBlockReason answers the
+ * skip question, and fix outcomes are appended with autopilot-scoped
+ * actions so they never shadow the ledger's pr_create/claim outcomes.
+ */
+export declare function recordAutopilotFixOutcome(capsPath: string, repo: string, kind: "dco" | "merge-conflict" | "format", outcome: "ok" | "failed-other", evidence: string, at?: string): void;
+export declare function loadAutopilotState(path: string): AutopilotState;
+export declare function saveAutopilotState(path: string, state: AutopilotState): void;
+export interface AutopilotFix {
+    kind: "dco" | "merge-conflict" | "format";
+    itemId: string;
+    oldHead: string;
+    newHead: string;
+    detail: string;
+}
+export interface AutopilotPlan {
+    itemId: string;
+    kind: FeedbackKind;
+    title: string;
+    plan: string;
+}
+export interface ReplyDraft {
+    pr: string;
+    itemId: string;
+    kind: FeedbackKind;
+    draft: string;
+    queuedAt: string;
+    queuedReason: string;
+}
+export interface PrReport {
+    pr: AutopilotPull | null;
+    url: string;
+    skipped?: string;
+    items: FeedbackItem[];
+    fixes: AutopilotFix[];
+    plans: AutopilotPlan[];
+    replyDrafts: number;
+    error?: string;
+}
+export interface AutopilotSummary {
+    prsScanned: number;
+    prsSkippedBlocked: number;
+    prsErrored: number;
+    itemsFound: number;
+    fixesPushed: number;
+    plans: number;
+    repliesQueued: number;
+    itemsByKind: Record<FeedbackKind, number>;
+    botVerdicts: {
+        real: number;
+        falsePositive: number;
+        needsHuman: number;
+    };
+    ciIntroduced: number;
+    ciPreExistingOrExternal: number;
+}
+export interface AutopilotRun {
+    perPr: PrReport[];
+    summary: AutopilotSummary;
+    json: Record<string, unknown>;
+    markdown: string;
+}
+export interface AutopilotDeps {
+    discoverPrs?: (author: string) => Promise<CensusPr[]>;
+    fetchPr?: (owner: string, repo: string, number: number) => Promise<AutopilotPull>;
+    triageCi?: (prUrl: string) => Promise<{
+        checks: ClassifiedCheck[];
+    }>;
+    fetchReviewSources?: (owner: string, repo: string, number: number, since: {
+        reviewId: number;
+        reviewCommentId: number;
+        issueCommentId: number;
+    }) => Promise<{
+        reviews: Array<{
+            id: number;
+            state?: string;
+            body?: string;
+            user?: {
+                login?: string;
+            };
+        }>;
+        reviewComments: Array<{
+            id: number;
+            body?: string;
+            user?: {
+                login?: string;
+            };
+            path?: string;
+            line?: number;
+            diff_hunk?: string;
+            pull_request_review_id?: number;
+        }>;
+        issueComments: Array<{
+            id: number;
+            body?: string;
+            user?: {
+                login?: string;
+            };
+        }>;
+        maxIds: {
+            reviewId: number;
+            reviewCommentId: number;
+            issueCommentId: number;
+        };
+    }>;
+    fetchFileAtHead?: (owner: string, repo: string, headSha: string, path: string) => Promise<string | null>;
+    /** PR commit SHAs, oldest first. Defaults to the pulls/commits endpoint. */
+    fetchPrCommits?: (owner: string, repo: string, number: number) => Promise<string[]>;
+    gitOps?: GitOps;
+    gitRunner?: GitRunner;
+    runInDir?: (cwd: string, label: string) => Promise<void>;
+    cloneFork?: (cloneUrl: string, branch: string, dest: string) => Promise<void>;
+    expectedForkOwner?: string;
+}
+export interface AutopilotRunOptions {
+    author?: string;
+    prs?: string[];
+    maxPrs?: number;
+    apply?: boolean;
+    maxFixes?: number;
+    statePath?: string;
+    repliesPath?: string;
+    capabilitiesPath?: string;
+    concurrency?: number;
+    deps?: AutopilotDeps;
+}
+/**
+ * Draft reply for a fixed item: what a human would post on the PR.
+ * Autopilot never posts; these queue in autopilot-replies.json.
+ */
+export declare function draftForFix(item: FeedbackItem, fix: AutopilotFix): string;
+/** Draft reply for a rebutted bot finding. */
+export declare function draftForRebuttal(item: FeedbackItem): string;
+/**
+ * Mechanical merge of the current base into the fork branch. Local git does
+ * the merge computation in a temp clone; the merged tree is committed
+ * through the Git Data API and the branch ref fast-forwarded. Returns
+ * ok:false with a NEEDS_HUMAN reason whenever a conflict is not mechanical.
+ */
+export declare function attemptMergeFix(pr: AutopilotPull, deps: AutopilotDeps, expectedForkOwner: string): Promise<{
+    ok: true;
+    oldHead: string;
+    newHead: string;
+    detail: string;
+} | {
+    ok: false;
+    reason: string;
+}>;
+/** Persist reply drafts to the replies file, appending to any existing queue. */
+export declare function saveReplyDrafts(path: string, drafts: ReplyDraft[]): number;
+export declare function autopilotMarkdown(run: {
+    perPr: PrReport[];
+    summary: AutopilotSummary;
+}): string;
+export declare function autopilotJson(run: {
+    perPr: PrReport[];
+    summary: AutopilotSummary;
+}): Record<string, unknown>;
+/**
+ * Run Autopilot. Report-only by default; --apply performs fixes.
+ * Returns the run with markdown and json renderings.
+ */
+export declare function runAutopilot(opts: AutopilotRunOptions): Promise<AutopilotRun>;
+export { authorKindOf as autopilotAuthorKindOf };