@hardlydifficult/pr-analyzer 1.0.0

package/dist/actions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PR Action Resolution
+ *
+ * Determines which actions are available for a PR based on its status.
+ * This is the single source of truth for core action definitions — clients
+ * (web, Discord, voice) render from these descriptors.
+ *
+ * Consumers can provide extra actions via ActionDefinition[].
+ */
+import type { ActionDefinition, ScannedPR } from "./types.js";
+/**
+ * Core action types built into the package.
+ * Consumers can define additional action types via ActionDefinition.
+ */
+export type CorePRActionType = "merge" | "mark_ready" | "enable_auto_merge";
+/**
+ * Describes an available action for a PR.
+ * `type` is `string` to allow custom action types from consumers.
+ */
+export interface PRActionDescriptor {
+    readonly type: string;
+    readonly label: string;
+    readonly description: string;
+}
+/**
+ * Core action registry — maps each core action type to its metadata.
+ */
+export declare const PR_ACTIONS: Record<CorePRActionType, Omit<PRActionDescriptor, "type">>;
+/**
+ * Determine which actions are available for a given PR.
+ *
+ * @param pr - The scanned PR object
+ * @param extraActions - Additional actions provided by consumers
+ * @param context - Key-value context for evaluating extra action conditions
+ * @returns Array of available action descriptors
+ */
+export declare function getAvailableActions(pr: ScannedPR, extraActions?: readonly ActionDefinition[], context?: Record<string, boolean>): PRActionDescriptor[];
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAC7B,gBAAgB,EAChB,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAWjC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,SAAS,EACb,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,EAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,kBAAkB,EAAE,CA2CtB"}

package/dist/actions.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * PR Action Resolution
+ *
+ * Determines which actions are available for a PR based on its status.
+ * This is the single source of truth for core action definitions — clients
+ * (web, Discord, voice) render from these descriptors.
+ *
+ * Consumers can provide extra actions via ActionDefinition[].
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PR_ACTIONS = void 0;
+exports.getAvailableActions = getAvailableActions;
+/**
+ * Core action registry — maps each core action type to its metadata.
+ */
+exports.PR_ACTIONS = {
+    merge: { label: "Merge", description: "Squash and merge this PR" },
+    mark_ready: {
+        label: "Mark Ready",
+        description: "Mark this draft PR as ready for review",
+    },
+    enable_auto_merge: {
+        label: "Enable Auto-Merge",
+        description: "Enable GitHub auto-merge when checks pass",
+    },
+};
+/**
+ * Determine which actions are available for a given PR.
+ *
+ * @param pr - The scanned PR object
+ * @param extraActions - Additional actions provided by consumers
+ * @param context - Key-value context for evaluating extra action conditions
+ * @returns Array of available action descriptors
+ */
+function getAvailableActions(pr, extraActions, context) {
+    const actions = [];
+    const { status } = pr;
+    // Core actions based on status
+    switch (status) {
+        case "ready_to_merge":
+        case "approved":
+            actions.push({ type: "merge", ...exports.PR_ACTIONS.merge });
+            break;
+        case "draft":
+            if (pr.ciStatus.allPassed && !pr.hasConflicts) {
+                actions.push({ type: "mark_ready", ...exports.PR_ACTIONS.mark_ready });
+            }
+            break;
+        case "ci_running":
+        case "needs_review":
+            if (!pr.pr.draft && !pr.hasConflicts && pr.pr.merged_at === null) {
+                actions.push({
+                    type: "enable_auto_merge",
+                    ...exports.PR_ACTIONS.enable_auto_merge,
+                });
+            }
+            break;
+        default:
+            break;
+    }
+    // Evaluate extra actions from consumers
+    if (extraActions) {
+        const ctx = context ?? {};
+        for (const action of extraActions) {
+            if (action.when(pr, ctx)) {
+                actions.push({
+                    type: action.type,
+                    label: action.label,
+                    description: action.description,
+                });
+            }
+        }
+    }
+    return actions;
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA8CH,kDA+CC;AAzED;;GAEG;AACU,QAAA,UAAU,GAGnB;IACF,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE;IAClE,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,wCAAwC;KACtD;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,2CAA2C;KACzD;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,EAAa,EACb,YAA0C,EAC1C,OAAiC;IAEjC,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAEtB,+BAA+B;IAC/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,kBAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM;QACR,KAAK,OAAO;YACV,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,kBAAU,CAAC,UAAU,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,MAAM;QACR,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc;YACjB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBACjE,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,mBAAmB;oBACzB,GAAG,kBAAU,CAAC,iBAAiB;iBAChC,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QACR;YACE,MAAM;IACV,CAAC;IAED,wCAAwC;IACxC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,OAAO,IAAI,EAAE,CAAC;QAC1B,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;iBAChC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/analysis.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PR Analysis
+ *
+ * Analyzes a single PR to determine its status:
+ *   1. Fetch CI checks, comments, reviews, and repo info
+ *   2. Analyze CI status (running, failed, passed)
+ *   3. Check if waiting on a bot response
+ *   4. Determine overall PR status based on all factors
+ *
+ * Custom status logic can be injected via AnalyzerHooks.resolveStatus.
+ */
+import type { GitHubClient, PullRequest } from "@hardlydifficult/github";
+import type { AnalyzerHooks, DiscoveredPR, Logger, ScannedPR } from "./types.js";
+/**
+ * Analyze a PR and determine its status
+ */
+export declare function analyzePR(client: GitHubClient, owner: string, repo: string, pr: PullRequest, botMention: string, hooks?: AnalyzerHooks): Promise<ScannedPR>;
+/**
+ * Analyze all discovered PRs, logging any failures
+ */
+export declare function analyzeAll(prs: readonly DiscoveredPR[], client: GitHubClient, botMention: string, logger?: Logger, hooks?: AnalyzerHooks): Promise<ScannedPR[]>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,YAAY,EACZ,WAAW,EAGZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,aAAa,EAGb,YAAY,EACZ,MAAM,EACN,SAAS,EACV,MAAM,YAAY,CAAC;AAmBpB;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,WAAW,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,SAAS,CAAC,CAwCpB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,SAAS,YAAY,EAAE,EAC5B,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAkBtB"}

package/dist/analysis.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * PR Analysis
+ *
+ * Analyzes a single PR to determine its status:
+ *   1. Fetch CI checks, comments, reviews, and repo info
+ *   2. Analyze CI status (running, failed, passed)
+ *   3. Check if waiting on a bot response
+ *   4. Determine overall PR status based on all factors
+ *
+ * Custom status logic can be injected via AnalyzerHooks.resolveStatus.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzePR = analyzePR;
+exports.analyzeAll = analyzeAll;
+// Bot usernames to detect when waiting for bot response
+const BOT_USERNAMES = new Set([
+    "cursor",
+    "cursor-bot",
+    "github-actions",
+    "github-actions[bot]",
+    "dependabot",
+    "dependabot[bot]",
+    "renovate",
+    "renovate[bot]",
+    "codecov",
+    "codecov[bot]",
+    "vercel",
+    "vercel[bot]",
+    "claude",
+]);
+/**
+ * Analyze a PR and determine its status
+ */
+async function analyzePR(client, owner, repo, pr, botMention, hooks) {
+    // Fetch all required data in parallel
+    const repoClient = client.repo(owner, repo);
+    const prClient = repoClient.pr(pr.number);
+    const [checks, comments, reviews, repoInfo] = await Promise.all([
+        prClient.getCheckRuns(),
+        prClient.getComments(),
+        prClient.getReviews(),
+        repoClient.get(),
+    ]);
+    // Analyze the fetched data
+    const ciStatus = analyzeCIStatus(checks);
+    const waitingOnBot = isWaitingOnBot(comments, botMention);
+    const conflicting = hasConflicts(pr);
+    const coreStatus = determineStatus(pr, ciStatus, reviews, waitingOnBot);
+    // Allow hook to override status
+    const status = hooks?.resolveStatus?.(coreStatus, {
+        comments,
+        checks,
+        reviews,
+        ciStatus,
+        hasConflicts: conflicting,
+        waitingOnBot,
+    }) ?? coreStatus;
+    const daysSinceUpdate = calculateDaysSinceUpdate(pr.updated_at);
+    return {
+        pr,
+        repo: repoInfo,
+        status,
+        ciStatus,
+        ciSummary: ciStatus.summary,
+        hasConflicts: conflicting,
+        waitingOnBot,
+        daysSinceUpdate,
+    };
+}
+/**
+ * Analyze all discovered PRs, logging any failures
+ */
+async function analyzeAll(prs, client, botMention, logger, hooks) {
+    const results = [];
+    for (const { pr, repoOwner, repoName } of prs) {
+        try {
+            results.push(await analyzePR(client, repoOwner, repoName, pr, botMention, hooks));
+        }
+        catch (err) {
+            logger?.error("Failed to analyze PR", {
+                repo: `${repoOwner}/${repoName}`,
+                pr: pr.number,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return results;
+}
+// --- Status Determination ---
+/**
+ * Determine the core status of a PR based on GitHub data.
+ *
+ * Priority order:
+ *   1. Draft → draft
+ *   2. CI running → ci_running
+ *   3. CI failed → ci_failed
+ *   4. Has conflicts → has_conflicts
+ *   5. Waiting on bot → waiting_on_bot
+ *   6. Changes requested → changes_requested
+ *   7. CI passed → ready_to_merge
+ *   8. Approved → approved
+ *   9. Default → needs_review
+ */
+function determineStatus(pr, ci, reviews, waitingOnBot) {
+    if (pr.draft) {
+        return "draft";
+    }
+    if (ci.isRunning) {
+        return "ci_running";
+    }
+    if (ci.hasFailed) {
+        return "ci_failed";
+    }
+    if (hasConflicts(pr)) {
+        return "has_conflicts";
+    }
+    if (waitingOnBot) {
+        return "waiting_on_bot";
+    }
+    const reviewStatus = analyzeReviews(reviews);
+    if (reviewStatus.hasChangesRequested) {
+        return "changes_requested";
+    }
+    if (ci.allPassed) {
+        return "ready_to_merge";
+    }
+    if (reviewStatus.hasApproval) {
+        return "approved";
+    }
+    return "needs_review";
+}
+// --- CI Analysis ---
+function analyzeCIStatus(checks) {
+    if (checks.length === 0) {
+        return {
+            isRunning: false,
+            hasFailed: false,
+            allPassed: true,
+            summary: "No CI checks",
+        };
+    }
+    const running = checks.filter(isCheckRunning);
+    const failed = checks.filter(isCheckFailed);
+    const passed = checks.filter(isCheckPassed);
+    // Validate that all checks are categorized
+    const categorized = running.length + failed.length + passed.length;
+    if (categorized !== checks.length) {
+        const uncategorized = checks.filter((c) => !isCheckRunning(c) && !isCheckFailed(c) && !isCheckPassed(c));
+        running.push(...uncategorized);
+    }
+    const isRunning = running.length > 0;
+    const hasFailed = failed.length > 0;
+    const allPassed = !isRunning && !hasFailed && passed.length === checks.length;
+    return {
+        isRunning,
+        hasFailed,
+        allPassed,
+        summary: formatCISummary(running, failed, passed, checks.length),
+    };
+}
+function isCheckRunning(check) {
+    if (check.status === "in_progress" || check.status === "queued") {
+        return true;
+    }
+    return check.conclusion === null;
+}
+function isCheckFailed(check) {
+    return (check.status === "completed" &&
+        (check.conclusion === "failure" ||
+            check.conclusion === "timed_out" ||
+            check.conclusion === "cancelled" ||
+            check.conclusion === "action_required"));
+}
+function isCheckPassed(check) {
+    return (check.status === "completed" &&
+        (check.conclusion === "success" ||
+            check.conclusion === "skipped" ||
+            check.conclusion === "neutral"));
+}
+function formatCISummary(running, failed, passed, total) {
+    if (running.length > 0 && passed.length > 0) {
+        return `CI running: ${String(running.length)} in progress, ${String(passed.length)} passed`;
+    }
+    if (running.length > 0) {
+        return `CI running: ${String(running.length)} in progress`;
+    }
+    if (failed.length > 0 && passed.length > 0) {
+        return `CI failed: ${String(failed.length)} failed, ${String(passed.length)} passed`;
+    }
+    if (failed.length > 0) {
+        return `CI failed: ${failed.map((c) => c.name).join(", ")}`;
+    }
+    if (passed.length === total) {
+        return `CI passed: ${String(passed.length)} checks`;
+    }
+    return `CI: ${String(total)} checks`;
+}
+// --- Review Analysis ---
+function analyzeReviews(reviews) {
+    const latestByUser = new Map();
+    for (const review of reviews) {
+        const existing = latestByUser.get(review.user.login);
+        if (existing === undefined ||
+            new Date(review.submitted_at) > new Date(existing.submitted_at)) {
+            latestByUser.set(review.user.login, review);
+        }
+    }
+    const latestReviews = Array.from(latestByUser.values());
+    return {
+        hasChangesRequested: latestReviews.some((r) => r.state === "CHANGES_REQUESTED"),
+        hasApproval: latestReviews.some((r) => r.state === "APPROVED"),
+    };
+}
+// --- Bot Detection ---
+function isWaitingOnBot(comments, botMention) {
+    if (comments.length === 0) {
+        return false;
+    }
+    const botMentionLower = botMention.toLowerCase();
+    const mentionComments = comments.filter((c) => c.body.toLowerCase().includes(botMentionLower));
+    if (mentionComments.length === 0) {
+        return false;
+    }
+    const lastMention = mentionComments[mentionComments.length - 1];
+    const botComments = comments.filter((c) => isBot(c.user.login));
+    if (botComments.length === 0) {
+        return true;
+    }
+    const lastBotComment = botComments[botComments.length - 1];
+    return new Date(lastBotComment.created_at) < new Date(lastMention.created_at);
+}
+function isBot(username) {
+    const lower = username.toLowerCase();
+    return (BOT_USERNAMES.has(lower) || lower.endsWith("[bot]") || lower.includes("bot"));
+}
+// --- Utility ---
+function hasConflicts(pr) {
+    return pr.mergeable === false || pr.mergeable_state === "conflicting";
+}
+function calculateDaysSinceUpdate(updatedAt) {
+    return Math.floor((Date.now() - new Date(updatedAt).getTime()) / (1000 * 60 * 60 * 24));
+}
+//# sourceMappingURL=analysis.js.map

package/dist/analysis.js.map

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

package/dist/classification.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PR Classification
+ *
+ * Classifies PRs into action buckets:
+ *   - readyForHuman: PRs that need human attention (review, approve, merge)
+ *   - needsBotBump: PRs waiting on a bot response
+ *   - inProgress: PRs with active work (CI running)
+ *   - blocked: PRs waiting but no active work (draft, CI failed, conflicts)
+ *
+ * Consumers can extend buckets via ClassificationConfig.
+ */
+import type { ClassificationConfig, ScannedPR, ScanResult } from "./types.js";
+/**
+ * Classify PRs into action buckets.
+ *
+ * @param prs - The PRs to classify
+ * @param config - Optional extra statuses to include in each bucket
+ */
+export declare function classifyPRs(prs: readonly ScannedPR[], config?: ClassificationConfig): ScanResult;
+//# sourceMappingURL=classification.d.ts.map

package/dist/classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAqB9E;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,SAAS,EAAE,EACzB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,UAAU,CAmBZ"}

package/dist/classification.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * PR Classification
+ *
+ * Classifies PRs into action buckets:
+ *   - readyForHuman: PRs that need human attention (review, approve, merge)
+ *   - needsBotBump: PRs waiting on a bot response
+ *   - inProgress: PRs with active work (CI running)
+ *   - blocked: PRs waiting but no active work (draft, CI failed, conflicts)
+ *
+ * Consumers can extend buckets via ClassificationConfig.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyPRs = classifyPRs;
+// --- Core status lists ---
+const READY_FOR_HUMAN_STATUSES = [
+    "needs_review",
+    "changes_requested",
+    "approved",
+    "ready_to_merge",
+];
+const IN_PROGRESS_STATUSES = ["ci_running"];
+const BLOCKED_STATUSES = [
+    "draft",
+    "ci_failed",
+    "has_conflicts",
+];
+const NEEDS_BOT_BUMP_STATUSES = ["waiting_on_bot"];
+/**
+ * Classify PRs into action buckets.
+ *
+ * @param prs - The PRs to classify
+ * @param config - Optional extra statuses to include in each bucket
+ */
+function classifyPRs(prs, config) {
+    const readyForHuman = mergeStatuses(READY_FOR_HUMAN_STATUSES, config?.readyForHuman);
+    const inProgress = mergeStatuses(IN_PROGRESS_STATUSES, config?.inProgress);
+    const blocked = mergeStatuses(BLOCKED_STATUSES, config?.blocked);
+    const needsBotBump = mergeStatuses(NEEDS_BOT_BUMP_STATUSES, config?.needsBotBump);
+    return {
+        all: prs,
+        readyForHuman: prs.filter((pr) => readyForHuman.includes(pr.status)),
+        needsBotBump: prs.filter((pr) => needsBotBump.includes(pr.status)),
+        inProgress: prs.filter((pr) => inProgress.includes(pr.status)),
+        blocked: prs.filter((pr) => blocked.includes(pr.status)),
+    };
+}
+function mergeStatuses(base, extra) {
+    if (!extra || extra.length === 0) {
+        return base;
+    }
+    return [...base, ...extra];
+}
+//# sourceMappingURL=classification.js.map

package/dist/classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA6BH,kCAsBC;AA/CD,4BAA4B;AAE5B,MAAM,wBAAwB,GAAsB;IAClD,cAAc;IACd,mBAAmB;IACnB,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,MAAM,oBAAoB,GAAsB,CAAC,YAAY,CAAC,CAAC;AAE/D,MAAM,gBAAgB,GAAsB;IAC1C,OAAO;IACP,WAAW;IACX,eAAe;CAChB,CAAC;AAEF,MAAM,uBAAuB,GAAsB,CAAC,gBAAgB,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,SAAgB,WAAW,CACzB,GAAyB,EACzB,MAA6B;IAE7B,MAAM,aAAa,GAAG,aAAa,CACjC,wBAAwB,EACxB,MAAM,EAAE,aAAa,CACtB,CAAC;IACF,MAAM,UAAU,GAAG,aAAa,CAAC,oBAAoB,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,aAAa,CAChC,uBAAuB,EACvB,MAAM,EAAE,YAAY,CACrB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,GAAG;QACR,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACpE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAClE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC9D,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,IAAuB,EACvB,KAAyB;IAEzB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PR Analyzer
+ *
+ * Analyzes and classifies GitHub PRs.
+ * See workflow.ts for single-PR scanning.
+ */
+export { scanSinglePR } from "./workflow.js";
+export { analyzePR, analyzeAll } from "./analysis.js";
+export { classifyPRs } from "./classification.js";
+export { getAvailableActions, PR_ACTIONS } from "./actions.js";
+export type { CorePRStatus, ScannedPR, ScanResult, CIStatus, DiscoveredPR, Logger, AnalysisDetails, AnalyzerHooks, ClassificationConfig, ActionDefinition, } from "./types.js";
+export type { CorePRActionType, PRActionDescriptor } from "./actions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * PR Analyzer
+ *
+ * Analyzes and classifies GitHub PRs.
+ * See workflow.ts for single-PR scanning.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PR_ACTIONS = exports.getAvailableActions = exports.classifyPRs = exports.analyzeAll = exports.analyzePR = exports.scanSinglePR = void 0;
+var workflow_js_1 = require("./workflow.js");
+Object.defineProperty(exports, "scanSinglePR", { enumerable: true, get: function () { return workflow_js_1.scanSinglePR; } });
+var analysis_js_1 = require("./analysis.js");
+Object.defineProperty(exports, "analyzePR", { enumerable: true, get: function () { return analysis_js_1.analyzePR; } });
+Object.defineProperty(exports, "analyzeAll", { enumerable: true, get: function () { return analysis_js_1.analyzeAll; } });
+var classification_js_1 = require("./classification.js");
+Object.defineProperty(exports, "classifyPRs", { enumerable: true, get: function () { return classification_js_1.classifyPRs; } });
+var actions_js_1 = require("./actions.js");
+Object.defineProperty(exports, "getAvailableActions", { enumerable: true, get: function () { return actions_js_1.getAvailableActions; } });
+Object.defineProperty(exports, "PR_ACTIONS", { enumerable: true, get: function () { return actions_js_1.PR_ACTIONS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6CAA6C;AAApC,2GAAA,YAAY,OAAA;AACrB,6CAAsD;AAA7C,wGAAA,SAAS,OAAA;AAAE,yGAAA,UAAU,OAAA;AAC9B,yDAAkD;AAAzC,gHAAA,WAAW,OAAA;AACpB,2CAA+D;AAAtD,iHAAA,mBAAmB,OAAA;AAAE,wGAAA,UAAU,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * PR Analysis Types
+ */
+import type { CheckRun, PullRequest, PullRequestComment, PullRequestReview, Repository } from "@hardlydifficult/github";
+/**
+ * Core PR statuses derived purely from GitHub data.
+ * Consumers can extend with custom statuses via AnalyzerHooks.
+ */
+export type CorePRStatus = "draft" | "ci_running" | "ci_failed" | "needs_review" | "changes_requested" | "approved" | "has_conflicts" | "ready_to_merge" | "waiting_on_bot";
+/**
+ * A PR that has been scanned and analyzed.
+ * Status is `string` to allow custom statuses from hooks.
+ */
+export interface ScannedPR {
+    readonly pr: PullRequest;
+    readonly repo: Repository;
+    readonly status: string;
+    readonly ciStatus: CIStatus;
+    readonly ciSummary: string;
+    readonly hasConflicts: boolean;
+    readonly waitingOnBot: boolean;
+    readonly daysSinceUpdate: number;
+}
+/**
+ * Result of scanning all PRs, classified into buckets
+ */
+export interface ScanResult {
+    readonly all: readonly ScannedPR[];
+    readonly readyForHuman: readonly ScannedPR[];
+    readonly needsBotBump: readonly ScannedPR[];
+    readonly inProgress: readonly ScannedPR[];
+    readonly blocked: readonly ScannedPR[];
+}
+/**
+ * CI status analysis result
+ */
+export interface CIStatus {
+    readonly isRunning: boolean;
+    readonly hasFailed: boolean;
+    readonly allPassed: boolean;
+    readonly summary: string;
+}
+/**
+ * A discovered PR with its repository context (used internally by analysis)
+ */
+export interface DiscoveredPR {
+    readonly pr: PullRequest;
+    readonly repoOwner: string;
+    readonly repoName: string;
+}
+/**
+ * Logger interface for pr-analyzer consumers to implement
+ */
+export interface Logger {
+    info(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Raw analysis data passed to hooks for custom status resolution.
+ */
+export interface AnalysisDetails {
+    readonly comments: readonly PullRequestComment[];
+    readonly checks: readonly CheckRun[];
+    readonly reviews: readonly PullRequestReview[];
+    readonly ciStatus: CIStatus;
+    readonly hasConflicts: boolean;
+    readonly waitingOnBot: boolean;
+}
+/**
+ * Hooks for customizing analysis behavior.
+ * Consumers can override status determination with custom logic.
+ */
+export interface AnalyzerHooks {
+    /**
+     * Called after the core status is determined.
+     * Return a custom status string to override, or undefined to keep the core status.
+     */
+    readonly resolveStatus?: (coreStatus: CorePRStatus, details: AnalysisDetails) => string | undefined;
+}
+/**
+ * Configuration for extending classification buckets with custom statuses.
+ */
+export interface ClassificationConfig {
+    readonly readyForHuman?: readonly string[];
+    readonly inProgress?: readonly string[];
+    readonly blocked?: readonly string[];
+    readonly needsBotBump?: readonly string[];
+}
+/**
+ * Definition for a custom action provided by consumers.
+ */
+export interface ActionDefinition {
+    readonly type: string;
+    readonly label: string;
+    readonly description: string;
+    readonly when: (pr: ScannedPR, context: Record<string, boolean>) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * PR Analysis Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PR Scanning Workflow
+ *
+ * Scans a single PR by repo and number for real-time event handling.
+ */
+import type { GitHubClient } from "@hardlydifficult/github";
+import type { AnalyzerHooks, ScannedPR } from "./types.js";
+/**
+ * Scan a single PR by repo and number.
+ * Used for real-time event handling - much faster than a full scan.
+ */
+export declare function scanSinglePR(client: GitHubClient, botMention: string, owner: string, repo: string, prNumber: number, hooks?: AnalyzerHooks): Promise<ScannedPR>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,SAAS,CAAC,CAGpB"}

package/dist/workflow.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * PR Scanning Workflow
+ *
+ * Scans a single PR by repo and number for real-time event handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanSinglePR = scanSinglePR;
+const analysis_js_1 = require("./analysis.js");
+/**
+ * Scan a single PR by repo and number.
+ * Used for real-time event handling - much faster than a full scan.
+ */
+async function scanSinglePR(client, botMention, owner, repo, prNumber, hooks) {
+    const pr = await client.repo(owner, repo).pr(prNumber).get();
+    return (0, analysis_js_1.analyzePR)(client, owner, repo, pr, botMention, hooks);
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAWH,oCAUC;AAjBD,+CAA0C;AAG1C;;;GAGG;AACI,KAAK,UAAU,YAAY,CAChC,MAAoB,EACpB,UAAkB,EAClB,KAAa,EACb,IAAY,EACZ,QAAgB,EAChB,KAAqB;IAErB,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;IAC7D,OAAO,IAAA,uBAAS,EAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@hardlydifficult/pr-analyzer",
+  "version": "1.0.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@hardlydifficult/github": "1.0.22"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
+  }
+}