@reneturcios/greenlight 0.10.0 → 0.11.0

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 };