codekin 0.5.4 → 0.6.0

package/server/dist/webhook-pr-github.d.ts

@@ -0,0 +1,68 @@
+/**
+ * GitHub API helpers for pull request webhook processing.
+ *
+ * All functions delegate to the `gh` CLI and degrade gracefully — errors are
+ * logged as warnings and an empty result is returned so callers can proceed
+ * with partial data.
+ */
+type GhRunner = (args: string[]) => Promise<string>;
+/** @internal Test-only: override the gh CLI runner */
+export declare function _setGhRunner(runner: GhRunner): void;
+/** @internal Test-only: reset to default gh CLI runner */
+export declare function _resetGhRunner(): void;
+/**
+ * Fetch the unified diff for a pull request.
+ * Truncates to ~100KB with a note if larger.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns The diff text, or empty string on error.
+ */
+export declare function fetchPrDiff(repo: string, prNumber: number): Promise<{
+    diff: string;
+    truncated: boolean;
+}>;
+/**
+ * Fetch the list of changed files for a pull request with stats.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted file list, or empty string on error.
+ */
+export declare function fetchPrFiles(repo: string, prNumber: number): Promise<string>;
+/**
+ * Fetch commit messages for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted commit list, or empty string on error.
+ */
+/**
+ * Fetch existing review comments (inline code comments) for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted comment list, or empty string on error.
+ */
+export declare function fetchPrReviewComments(repo: string, prNumber: number): Promise<string>;
+/**
+ * Fetch review summaries (approve/request changes/comment) for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted review list, or empty string on error.
+ */
+export declare function fetchPrReviews(repo: string, prNumber: number): Promise<string>;
+/** HTML marker embedded in Codekin review comments for identification. */
+export declare const REVIEW_COMMENT_MARKER = "<!-- codekin-review -->";
+/**
+ * Find an existing Codekin review summary comment on a PR.
+ * Searches issue comments (top-level conversation comments) for the marker.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns The comment ID if found, or undefined.
+ */
+export declare function fetchExistingReviewComment(repo: string, prNumber: number): Promise<number | undefined>;
+export declare function fetchPrCommits(repo: string, prNumber: number): Promise<string>;
+export {};

package/server/dist/webhook-pr-github.js

@@ -0,0 +1,202 @@
+/**
+ * GitHub API helpers for pull request webhook processing.
+ *
+ * All functions delegate to the `gh` CLI and degrade gracefully — errors are
+ * logged as warnings and an empty result is returned so callers can proceed
+ * with partial data.
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+const GH_TIMEOUT_MS = 30_000;
+/** Maximum diff size in bytes before truncation (~100KB). */
+const MAX_DIFF_BYTES = 100_000;
+let ghRunner = async (args) => {
+    const { stdout } = await execFileAsync('gh', args, { timeout: GH_TIMEOUT_MS });
+    return stdout;
+};
+/** @internal Test-only: override the gh CLI runner */
+export function _setGhRunner(runner) {
+    ghRunner = runner;
+}
+/** @internal Test-only: reset to default gh CLI runner */
+export function _resetGhRunner() {
+    ghRunner = async (args) => {
+        const { stdout } = await execFileAsync('gh', args, { timeout: GH_TIMEOUT_MS });
+        return stdout;
+    };
+}
+/**
+ * Fetch the unified diff for a pull request.
+ * Truncates to ~100KB with a note if larger.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns The diff text, or empty string on error.
+ */
+export async function fetchPrDiff(repo, prNumber) {
+    try {
+        const output = await ghRunner([
+            'api',
+            `/repos/${repo}/pulls/${prNumber}`,
+            '-H', 'Accept: application/vnd.github.diff',
+        ]);
+        if (output.length > MAX_DIFF_BYTES) {
+            const truncated = output.slice(0, MAX_DIFF_BYTES);
+            // Cut at last newline to avoid splitting a line
+            const lastNewline = truncated.lastIndexOf('\n');
+            return {
+                diff: (lastNewline > 0 ? truncated.slice(0, lastNewline) : truncated) +
+                    `\n\n... (diff truncated — full diff is ${Math.round(output.length / 1024)}KB, showing first ~${Math.round(MAX_DIFF_BYTES / 1024)}KB)`,
+                truncated: true,
+            };
+        }
+        return { diff: output, truncated: false };
+    }
+    catch (err) {
+        console.warn(`fetchPrDiff: failed for ${repo} PR #${prNumber}:`, err);
+        return { diff: '', truncated: false };
+    }
+}
+/**
+ * Fetch the list of changed files for a pull request with stats.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted file list, or empty string on error.
+ */
+export async function fetchPrFiles(repo, prNumber) {
+    try {
+        const raw = await ghRunner([
+            'api',
+            `/repos/${repo}/pulls/${prNumber}/files`,
+            '--paginate',
+        ]);
+        const files = JSON.parse(raw);
+        if (!Array.isArray(files) || files.length === 0)
+            return '';
+        return files
+            .map(f => `${f.filename} (${f.status}, +${f.additions}/-${f.deletions})`)
+            .join('\n');
+    }
+    catch (err) {
+        console.warn(`fetchPrFiles: failed for ${repo} PR #${prNumber}:`, err);
+        return '';
+    }
+}
+/**
+ * Fetch commit messages for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted commit list, or empty string on error.
+ */
+/**
+ * Fetch existing review comments (inline code comments) for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted comment list, or empty string on error.
+ */
+export async function fetchPrReviewComments(repo, prNumber) {
+    try {
+        const raw = await ghRunner([
+            'api',
+            `/repos/${repo}/pulls/${prNumber}/comments`,
+            '--paginate',
+        ]);
+        const comments = JSON.parse(raw);
+        if (!Array.isArray(comments) || comments.length === 0)
+            return '';
+        return comments
+            .map(c => {
+            const location = c.line ? `${c.path}:${c.line}` : c.path;
+            return `- ${c.user.login} on ${location}: ${c.body}`;
+        })
+            .join('\n');
+    }
+    catch (err) {
+        console.warn(`fetchPrReviewComments: failed for ${repo} PR #${prNumber}:`, err);
+        return '';
+    }
+}
+/**
+ * Fetch review summaries (approve/request changes/comment) for a pull request.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns Formatted review list, or empty string on error.
+ */
+export async function fetchPrReviews(repo, prNumber) {
+    try {
+        const raw = await ghRunner([
+            'api',
+            `/repos/${repo}/pulls/${prNumber}/reviews`,
+            '--paginate',
+        ]);
+        const reviews = JSON.parse(raw);
+        if (!Array.isArray(reviews) || reviews.length === 0)
+            return '';
+        return reviews
+            .filter(r => r.state !== 'PENDING')
+            .map(r => `- ${r.user.login} (${r.state}): ${r.body || '(no summary)'}`)
+            .join('\n');
+    }
+    catch (err) {
+        console.warn(`fetchPrReviews: failed for ${repo} PR #${prNumber}:`, err);
+        return '';
+    }
+}
+/** HTML marker embedded in Codekin review comments for identification. */
+export const REVIEW_COMMENT_MARKER = '<!-- codekin-review -->';
+/**
+ * Find an existing Codekin review summary comment on a PR.
+ * Searches issue comments (top-level conversation comments) for the marker.
+ *
+ * @param repo     - GitHub repo in `owner/name` format.
+ * @param prNumber - Pull request number.
+ * @returns The comment ID if found, or undefined.
+ */
+export async function fetchExistingReviewComment(repo, prNumber) {
+    try {
+        const raw = await ghRunner([
+            'api',
+            `/repos/${repo}/issues/${prNumber}/comments`,
+            '--paginate',
+        ]);
+        const comments = JSON.parse(raw);
+        if (!Array.isArray(comments) || comments.length === 0)
+            return undefined;
+        // Search in reverse to find the most recent matching comment
+        for (let i = comments.length - 1; i >= 0; i--) {
+            if (comments[i].body.includes(REVIEW_COMMENT_MARKER)) {
+                return comments[i].id;
+            }
+        }
+        return undefined;
+    }
+    catch (err) {
+        console.warn(`fetchExistingReviewComment: failed for ${repo} PR #${prNumber}:`, err);
+        return undefined;
+    }
+}
+export async function fetchPrCommits(repo, prNumber) {
+    try {
+        const raw = await ghRunner([
+            'api',
+            `/repos/${repo}/pulls/${prNumber}/commits`,
+            '--paginate',
+        ]);
+        const commits = JSON.parse(raw);
+        if (!Array.isArray(commits) || commits.length === 0)
+            return '';
+        return commits
+            .map(c => `- ${c.sha.slice(0, 7)}: ${c.commit.message.split('\n')[0]}`)
+            .join('\n');
+    }
+    catch (err) {
+        console.warn(`fetchPrCommits: failed for ${repo} PR #${prNumber}:`, err);
+        return '';
+    }
+}
+//# sourceMappingURL=webhook-pr-github.js.map

package/server/dist/webhook-pr-github.js.map

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

package/server/dist/webhook-pr-prompt.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Builds the structured prompt sent to Claude for pull request code review.
+ *
+ * Supports a 3-tier custom prompt resolution for the review instructions:
+ *   1. Repo-level: {workspacePath}/.codekin/pr-review-prompt.md
+ *   2. Global:     ~/.codekin/pr-review-prompt.md
+ *   3. Built-in default (hardcoded below)
+ *
+ * The PR metadata and diff context are always prepended — custom prompts
+ * only replace the review instructions section.
+ */
+import type { PullRequestContext } from './webhook-types.js';
+import type { PrCacheData } from './webhook-pr-cache.js';
+/** Options for prompt assembly — cache context and comment management. */
+export interface PrPromptOptions {
+    priorCache?: PrCacheData;
+    cachePath?: string;
+    existingCommentId?: number;
+}
+/**
+ * Builds the full prompt for PR review, combining PR context with review instructions.
+ *
+ * @param ctx           - Pull request context with metadata and diff.
+ * @param workspacePath - Path to the cloned workspace (for repo-level prompt lookup).
+ * @param options       - Optional cache context and comment management settings.
+ */
+export declare function buildPrReviewPrompt(ctx: PullRequestContext, workspacePath: string, options?: PrPromptOptions): string;

package/server/dist/webhook-pr-prompt.js

@@ -0,0 +1,251 @@
+/**
+ * Builds the structured prompt sent to Claude for pull request code review.
+ *
+ * Supports a 3-tier custom prompt resolution for the review instructions:
+ *   1. Repo-level: {workspacePath}/.codekin/pr-review-prompt.md
+ *   2. Global:     ~/.codekin/pr-review-prompt.md
+ *   3. Built-in default (hardcoded below)
+ *
+ * The PR metadata and diff context are always prepended — custom prompts
+ * only replace the review instructions section.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { REVIEW_COMMENT_MARKER } from './webhook-pr-github.js';
+const CUSTOM_PROMPT_FILENAME = 'pr-review-prompt.md';
+/**
+ * Attempt to load a custom review prompt from disk.
+ * Returns the file contents if found, or undefined.
+ */
+function loadCustomPrompt(workspacePath) {
+    // 1. Repo-level
+    const repoPromptPath = join(workspacePath, '.codekin', CUSTOM_PROMPT_FILENAME);
+    if (existsSync(repoPromptPath)) {
+        try {
+            const content = readFileSync(repoPromptPath, 'utf-8').trim();
+            if (content) {
+                console.log(`[pr-prompt] Using repo-level custom prompt: ${repoPromptPath}`);
+                return content;
+            }
+        }
+        catch (err) {
+            console.warn(`[pr-prompt] Failed to read repo-level prompt:`, err);
+        }
+    }
+    // 2. Global
+    const globalPromptPath = join(homedir(), '.codekin', CUSTOM_PROMPT_FILENAME);
+    if (existsSync(globalPromptPath)) {
+        try {
+            const content = readFileSync(globalPromptPath, 'utf-8').trim();
+            if (content) {
+                console.log(`[pr-prompt] Using global custom prompt: ${globalPromptPath}`);
+                return content;
+            }
+        }
+        catch (err) {
+            console.warn(`[pr-prompt] Failed to read global prompt:`, err);
+        }
+    }
+    return undefined;
+}
+/**
+ * Build the default review instructions (used when no custom prompt is found).
+ */
+function buildDefaultInstructions(ctx) {
+    const lines = [];
+    if (ctx.action === 'synchronize' && ctx.beforeSha) {
+        lines.push(`This PR has been updated with new commits. The previous head was \`${ctx.beforeSha.slice(0, 7)}\`, the new head is \`${ctx.headSha.slice(0, 7)}\`. Review the full PR diff but pay particular attention to changes since the previous head.`);
+    }
+    else if (ctx.action === 'reopened') {
+        lines.push('This PR has been reopened. Provide a fresh comprehensive code review.');
+    }
+    else {
+        lines.push('Provide a comprehensive code review of this pull request.');
+    }
+    lines.push('');
+    lines.push('Focus on:');
+    lines.push('1. Code correctness and logic errors');
+    lines.push('2. Security vulnerabilities (injection, auth issues, data exposure)');
+    lines.push('3. Performance implications');
+    lines.push('4. Code style, readability, and maintainability');
+    lines.push('5. Test coverage for new or changed code');
+    lines.push('');
+    lines.push('Produce a structured review report with:');
+    lines.push('- **Summary**: 1-2 sentence overview of the PR');
+    lines.push('- **Findings**: Grouped by severity (Critical / Warning / Suggestion / Nitpick)');
+    lines.push('  - For each finding: file path, line number(s), description, and suggested fix');
+    lines.push('- **Overall Assessment**: Approve / Request Changes / Comment');
+    return lines.join('\n');
+}
+/**
+ * Builds the full prompt for PR review, combining PR context with review instructions.
+ *
+ * @param ctx           - Pull request context with metadata and diff.
+ * @param workspacePath - Path to the cloned workspace (for repo-level prompt lookup).
+ * @param options       - Optional cache context and comment management settings.
+ */
+export function buildPrReviewPrompt(ctx, workspacePath, options) {
+    const lines = [];
+    const reviewBodyPath = `${workspacePath}/pr-${ctx.prNumber}-review-body.md`;
+    // --- PR metadata (always included) ---
+    lines.push('A pull request needs code review.');
+    lines.push('');
+    lines.push('## PR Details');
+    lines.push(`- **Repository**: ${ctx.repo}`);
+    lines.push(`- **PR**: #${ctx.prNumber} — ${ctx.prTitle}`);
+    lines.push(`- **Author**: ${ctx.author}`);
+    lines.push(`- **Branch**: ${ctx.headBranch} → ${ctx.baseBranch}`);
+    lines.push(`- **Stats**: ${ctx.changedFiles} files changed, +${ctx.additions}/-${ctx.deletions}`);
+    const shortHead = ctx.headSha.slice(0, 7);
+    lines.push(`- **Head**: ${shortHead}`);
+    if (ctx.prUrl) {
+        lines.push(`- **URL**: ${ctx.prUrl}`);
+    }
+    // PR description
+    if (ctx.prBody) {
+        lines.push('');
+        lines.push('## PR Description');
+        lines.push(ctx.prBody);
+    }
+    // Changed files
+    if (ctx.fileList) {
+        lines.push('');
+        lines.push('## Changed Files');
+        lines.push(ctx.fileList);
+    }
+    // Commit messages
+    if (ctx.commitMessages) {
+        lines.push('');
+        lines.push('## Commits');
+        lines.push(ctx.commitMessages);
+    }
+    // Existing review comments
+    if (ctx.reviews || ctx.reviewComments) {
+        lines.push('');
+        lines.push('## Existing Reviews');
+        if (ctx.reviews) {
+            lines.push('### Review Summaries');
+            lines.push(ctx.reviews);
+        }
+        if (ctx.reviewComments) {
+            lines.push('### Inline Comments');
+            lines.push(ctx.reviewComments);
+        }
+    }
+    // Prior review context (from cache)
+    if (options?.priorCache) {
+        const cache = options.priorCache;
+        lines.push('');
+        lines.push('## Prior Review Context');
+        lines.push(`(from review at commit ${cache.lastReviewedSha} on ${cache.timestamp})`);
+        lines.push('');
+        lines.push('### Codebase Familiarity');
+        lines.push(cache.codebaseContext);
+        lines.push('');
+        lines.push('### Previous Review Findings');
+        lines.push(cache.reviewFindings);
+        lines.push('');
+        lines.push('### Previous Review Summary');
+        lines.push(cache.priorReviewSummary);
+        lines.push('');
+        lines.push('Note: The above is from a previous review. The diff and comments below are fresh. Review the full current diff but leverage your prior context for faster, more informed review.');
+    }
+    // Diff
+    lines.push('');
+    lines.push('## Diff');
+    if (ctx.diff) {
+        lines.push('```diff');
+        lines.push(ctx.diff);
+        lines.push('```');
+    }
+    else {
+        lines.push('No diff available.');
+    }
+    // --- Review instructions (custom or default) ---
+    lines.push('');
+    lines.push('## Instructions');
+    const customPrompt = loadCustomPrompt(workspacePath);
+    if (customPrompt) {
+        lines.push(customPrompt);
+    }
+    else {
+        lines.push(buildDefaultInstructions(ctx));
+    }
+    // Override any hardcoded intermediate review file paths from custom prompts
+    // so concurrent reviews don't collide or write into tracked repo files.
+    lines.push('');
+    lines.push('## File Paths for This Review');
+    lines.push('When writing intermediate files during the review process, use these paths:');
+    lines.push(`- Draft review: \`${workspacePath}/pr-${ctx.prNumber}-draft-review.md\``);
+    lines.push(`- Codex cross-review output: \`${workspacePath}/pr-${ctx.prNumber}-codex-review.md\``);
+    lines.push(`- Codex command: \`codex exec - --skip-git-repo-check -o ${workspacePath}/pr-${ctx.prNumber}-codex-review.md < ${workspacePath}/pr-${ctx.prNumber}-draft-review.md\``);
+    lines.push('These paths override any file paths mentioned in the review instructions above.');
+    lines.push('Do NOT write review files to the `docs/` directory or any other git-tracked location.');
+    // --- Comment posting instructions ---
+    lines.push('');
+    if (options?.existingCommentId) {
+        lines.push('## Posting Your Review Summary');
+        lines.push(`An existing Codekin review comment was found on this PR (comment ID: ${options.existingCommentId}).`);
+        lines.push('Update it instead of creating a new comment. Use a temporary file for the body to avoid shell escaping issues:');
+        lines.push('');
+        lines.push(`1. Write your review summary to \`${reviewBodyPath}\``);
+        lines.push(`2. Ensure the file starts with \`${REVIEW_COMMENT_MARKER}\` on its own line`);
+        lines.push(`3. Run: \`gh api repos/${ctx.repo}/issues/comments/${options.existingCommentId} -X PATCH -F body=@${reviewBodyPath}\``);
+        lines.push('');
+        lines.push(`IMPORTANT: Always include \`${REVIEW_COMMENT_MARKER}\` at the very beginning of the comment body.`);
+    }
+    else {
+        lines.push('## Posting Your Review Summary');
+        lines.push('Post your review summary as a new comment on the PR. Use a temporary file for the body to avoid shell escaping issues:');
+        lines.push('');
+        lines.push(`1. Write your review summary to \`${reviewBodyPath}\``);
+        lines.push(`2. Ensure the file starts with \`${REVIEW_COMMENT_MARKER}\` on its own line`);
+        lines.push(`3. Run: \`gh api repos/${ctx.repo}/issues/${ctx.prNumber}/comments -F body=@${reviewBodyPath}\``);
+        lines.push('');
+        lines.push(`IMPORTANT: Always include \`${REVIEW_COMMENT_MARKER}\` at the very beginning of the comment body. This marker allows future reviews to update this comment instead of creating a new one.`);
+    }
+    // --- Cache-writing instructions ---
+    if (options?.cachePath) {
+        lines.push('');
+        lines.push('## Post-Review: Save Context');
+        lines.push('After completing your review, write a JSON file to preserve your context for future reviews of this PR.');
+        lines.push('');
+        lines.push(`Path: ${options.cachePath}`);
+        lines.push('');
+        lines.push('The file must be valid JSON with this exact structure:');
+        lines.push('```json');
+        lines.push('{');
+        lines.push(`  "prNumber": ${ctx.prNumber},`);
+        lines.push(`  "repo": "${ctx.repo}",`);
+        lines.push(`  "lastReviewedSha": "${ctx.headSha}",`);
+        lines.push('  "timestamp": "<current ISO timestamp>",');
+        lines.push('  "priorReviewSummary": "<1-3 sentence summary of your review findings>",');
+        lines.push('  "codebaseContext": "<key architectural observations, module structure, patterns you noticed>",');
+        lines.push('  "reviewFindings": "<specific issues found, their locations, and whether they were fixed>",');
+        lines.push('  "verdict": "<approve | request_changes | comment>",');
+        lines.push('  "structuredFindings": [');
+        lines.push('    {');
+        lines.push('      "severity": "<critical | must-fix | suggestion | minor | nitpick>",');
+        lines.push('      "file": "<path/to/file.ts>",');
+        lines.push('      "line": <line number or null>,');
+        lines.push('      "description": "<short description of the finding>",');
+        lines.push('      "status": "<new | open | fixed>"');
+        lines.push('    }');
+        lines.push('  ],');
+        lines.push(`  "author": ${JSON.stringify(ctx.author)},`);
+        lines.push(`  "prTitle": ${JSON.stringify(ctx.prTitle)},`);
+        lines.push(`  "changedFiles": ${ctx.changedFiles},`);
+        lines.push(`  "additions": ${ctx.additions},`);
+        lines.push(`  "deletions": ${ctx.deletions}`);
+        lines.push('}');
+        lines.push('```');
+        lines.push('');
+        lines.push('IMPORTANT: The `structuredFindings` array must include every finding from your review.');
+        lines.push('Use an empty array `[]` if there are no findings. The `verdict` must be exactly one of: approve, request_changes, comment.');
+        lines.push('');
+        lines.push('Use the Write tool to save this file. This helps future reviews of this PR be more efficient.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=webhook-pr-prompt.js.map

package/server/dist/webhook-pr-prompt.js.map

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

package/server/dist/webhook-types.d.ts

@@ -1,4 +1,4 @@
-export type WebhookEventStatus = 'received' | 'filtered' | 'duplicate' | 'processing' | 'session_created' | 'completed' | 'error';
+export type WebhookEventStatus = 'received' | 'filtered' | 'duplicate' | 'processing' | 'session_created' | 'completed' | 'error' | 'superseded';
 export interface WebhookEvent {
     id: string;
     idempotencyKey: string;
@@ -15,6 +15,10 @@ export interface WebhookEvent {
     sessionId?: string;
     error?: string;
     filterReason?: string;
+    prNumber?: number;
+    prTitle?: string;
+    headSha?: string;
+    baseBranch?: string;
 }
 export interface WorkflowRunPayload {
     action: string;
@@ -97,3 +101,68 @@ export interface WebhookConfig {
     logLinesToInclude: number;
     actorAllowlist: string[];
 }
+export interface PullRequestPayload {
+    action: string;
+    number: number;
+    before?: string;
+    after?: string;
+    pull_request: {
+        number: number;
+        title: string;
+        body: string | null;
+        state: string;
+        draft: boolean;
+        merged: boolean;
+        user: {
+            login: string;
+        };
+        head: {
+            ref: string;
+            sha: string;
+            repo: {
+                clone_url: string;
+            } | null;
+        };
+        base: {
+            ref: string;
+            sha: string;
+        };
+        html_url: string;
+        changed_files: number;
+        additions: number;
+        deletions: number;
+    };
+    repository: {
+        full_name: string;
+        name: string;
+        clone_url: string;
+    };
+    sender: {
+        login: string;
+    };
+}
+export interface PullRequestContext {
+    repo: string;
+    repoName: string;
+    prNumber: number;
+    prTitle: string;
+    prBody: string;
+    prUrl: string;
+    author: string;
+    headBranch: string;
+    baseBranch: string;
+    headSha: string;
+    baseSha: string;
+    beforeSha?: string;
+    action: 'opened' | 'synchronize' | 'reopened' | 'ready_for_review';
+    changedFiles: number;
+    additions: number;
+    deletions: number;
+    diff: string;
+    fileList: string;
+    commitMessages: string;
+    reviewComments: string;
+    reviews: string;
+    existingComment: string | null;
+    priorCache: import('./webhook-pr-cache.js').PrCacheData | null;
+}