lastlight 0.1.15 → 0.2.0

package/dist/engine/github.d.ts

@@ -1,15 +1,27 @@
+import { type GitHubAppClientConfig } from "./github-app-client.js";
+/** GitHub reaction emoji values accepted by the reactions API. */
+export type ReactionContent = "+1" | "-1" | "laugh" | "confused" | "heart" | "hooray" | "rocket" | "eyes";
 /**
  * GitHub client for the harness — uses GitHub App auth.
  * Used by the orchestrator to post comments, not by agent sessions.
  */
 export declare class GitHubClient {
     private octokit;
-    constructor(config: {
-        appId: string;
-        privateKeyPath: string;
-        installationId: string;
-    });
-    postComment(owner: string, repo: string, issueNumber: number, body: string): Promise<void>;
+    constructor(config: GitHubAppClientConfig);
+    /**
+     * Create a new comment on an issue/PR. Returns the new comment id so callers
+     * that want to edit it later (the in-place status checklist — see
+     * `src/notify/transports/github.ts`) can hold onto a handle. Callers that
+     * just post a one-off comment can ignore the return.
+     */
+    postComment(owner: string, repo: string, issueNumber: number, body: string): Promise<number>;
+    /**
+     * Edit an existing issue/PR comment in place. Paired with `postComment` to
+     * maintain a single status comment that updates as a workflow progresses,
+     * rather than posting a new comment per phase. GitHub does NOT notify
+     * watchers on edits, which is exactly why this keeps the thread quiet.
+     */
+    updateComment(owner: string, repo: string, commentId: number, body: string): Promise<void>;
     /**
      * Add an emoji reaction to a specific issue comment. Used as an immediate
      * (silent) acknowledgment that the agent has accepted a request, before
@@ -18,7 +30,19 @@ export declare class GitHubClient {
      * Reaction `content` values: "+1" | "-1" | "laugh" | "confused" | "heart"
      * | "hooray" | "rocket" | "eyes".
      */
-    reactToComment(owner: string, repo: string, commentId: number, content?: "rocket" | "+1" | "eyes" | "hooray"): Promise<void>;
+    reactToComment(owner: string, repo: string, commentId: number, content?: ReactionContent): Promise<void>;
+    /**
+     * Add an emoji reaction to an issue or PR itself (not a comment) — used to
+     * ack events that aren't comments, e.g. a freshly opened issue/PR. PRs are
+     * issues for the reactions API, so this works for both.
+     */
+    reactToIssue(owner: string, repo: string, issueNumber: number, content?: ReactionContent): Promise<void>;
+    /**
+     * Add an emoji reaction to a pull-request review comment (inline diff
+     * comment). Distinct endpoint from issue comments — review comments live on
+     * the pulls API.
+     */
+    reactToReviewComment(owner: string, repo: string, commentId: number, content?: ReactionContent): Promise<void>;
     getIssue(owner: string, repo: string, issueNumber: number): Promise<{
         id: number;
         node_id: string;
@@ -33,8 +57,31 @@ export declare class GitHubClient {
         state_reason?: "completed" | "reopened" | "not_planned" | "duplicate" | null;
         title: string;
         body?: string | null;
-        user: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
-        labels: import("@octokit/openapi-types").OneOf<[string, {
+        user: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        } | null;
+        labels: (string | {
             id?: number;
             node_id?: string;
             url?: string;
@@ -42,10 +89,96 @@ export declare class GitHubClient {
             description?: string | null;
             color?: string | null;
             default?: boolean;
-        }]>[];
-        assignee: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
-        assignees?: import("@octokit/openapi-types").components["schemas"]["simple-user"][] | null;
-        milestone: import("@octokit/openapi-types").components["schemas"]["nullable-milestone"];
+        })[];
+        assignee: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        } | null;
+        assignees?: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        }[] | null;
+        milestone: {
+            url: string;
+            html_url: string;
+            labels_url: string;
+            id: number;
+            node_id: string;
+            number: number;
+            state: "open" | "closed";
+            title: string;
+            description: string | null;
+            creator: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            } | null;
+            open_issues: number;
+            closed_issues: number;
+            created_at: string;
+            updated_at: string;
+            closed_at: string | null;
+            due_on: string | null;
+        } | null;
         locked: boolean;
         active_lock_reason?: string | null;
         comments: number;
@@ -60,20 +193,292 @@ export declare class GitHubClient {
         created_at: string;
         updated_at: string;
         draft?: boolean;
-        closed_by?: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
+        closed_by?: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        } | null;
         body_html?: string;
         body_text?: string;
         timeline_url?: string;
-        type?: import("@octokit/openapi-types").components["schemas"]["issue-type"];
-        repository?: import("@octokit/openapi-types").components["schemas"]["repository"];
-        performed_via_github_app?: import("@octokit/openapi-types").components["schemas"]["nullable-integration"];
-        author_association?: import("@octokit/openapi-types").components["schemas"]["author-association"];
-        reactions?: import("@octokit/openapi-types").components["schemas"]["reaction-rollup"];
-        sub_issues_summary?: import("@octokit/openapi-types").components["schemas"]["sub-issues-summary"];
+        type?: {
+            id: number;
+            node_id: string;
+            name: string;
+            description: string | null;
+            color?: "gray" | "blue" | "green" | "yellow" | "orange" | "red" | "pink" | "purple" | null;
+            created_at?: string;
+            updated_at?: string;
+            is_enabled?: boolean;
+        } | null;
+        repository?: {
+            id: number;
+            node_id: string;
+            name: string;
+            full_name: string;
+            license: {
+                key: string;
+                name: string;
+                url: string | null;
+                spdx_id: string | null;
+                node_id: string;
+                html_url?: string;
+            } | null;
+            forks: number;
+            permissions?: {
+                admin: boolean;
+                pull: boolean;
+                triage?: boolean;
+                push: boolean;
+                maintain?: boolean;
+            };
+            owner: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            };
+            private: boolean;
+            html_url: string;
+            description: string | null;
+            fork: boolean;
+            url: string;
+            archive_url: string;
+            assignees_url: string;
+            blobs_url: string;
+            branches_url: string;
+            collaborators_url: string;
+            comments_url: string;
+            commits_url: string;
+            compare_url: string;
+            contents_url: string;
+            contributors_url: string;
+            deployments_url: string;
+            downloads_url: string;
+            events_url: string;
+            forks_url: string;
+            git_commits_url: string;
+            git_refs_url: string;
+            git_tags_url: string;
+            git_url: string;
+            issue_comment_url: string;
+            issue_events_url: string;
+            issues_url: string;
+            keys_url: string;
+            labels_url: string;
+            languages_url: string;
+            merges_url: string;
+            milestones_url: string;
+            notifications_url: string;
+            pulls_url: string;
+            releases_url: string;
+            ssh_url: string;
+            stargazers_url: string;
+            statuses_url: string;
+            subscribers_url: string;
+            subscription_url: string;
+            tags_url: string;
+            teams_url: string;
+            trees_url: string;
+            clone_url: string;
+            mirror_url: string | null;
+            hooks_url: string;
+            svn_url: string;
+            homepage: string | null;
+            language: string | null;
+            forks_count: number;
+            stargazers_count: number;
+            watchers_count: number;
+            size: number;
+            default_branch: string;
+            open_issues_count: number;
+            is_template?: boolean;
+            topics?: string[];
+            has_issues: boolean;
+            has_projects: boolean;
+            has_wiki: boolean;
+            has_pages: boolean;
+            has_downloads: boolean;
+            has_discussions?: boolean;
+            archived: boolean;
+            disabled: boolean;
+            visibility?: string;
+            pushed_at: string | null;
+            created_at: string | null;
+            updated_at: string | null;
+            allow_rebase_merge?: boolean;
+            temp_clone_token?: string;
+            allow_squash_merge?: boolean;
+            allow_auto_merge?: boolean;
+            delete_branch_on_merge?: boolean;
+            allow_update_branch?: boolean;
+            use_squash_pr_title_as_default?: boolean;
+            squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
+            squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
+            merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
+            merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
+            allow_merge_commit?: boolean;
+            allow_forking?: boolean;
+            web_commit_signoff_required?: boolean;
+            open_issues: number;
+            watchers: number;
+            master_branch?: string;
+            starred_at?: string;
+            anonymous_access_enabled?: boolean;
+            code_search_index_status?: {
+                lexical_search_ok?: boolean;
+                lexical_commit_sha?: string;
+            };
+        };
+        performed_via_github_app?: {
+            id: number;
+            slug?: string;
+            node_id: string;
+            client_id?: string;
+            owner: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            } | {
+                description?: string | null;
+                html_url: string;
+                website_url?: string | null;
+                id: number;
+                node_id: string;
+                name: string;
+                slug: string;
+                created_at: string | null;
+                updated_at: string | null;
+                avatar_url: string;
+            };
+            name: string;
+            description: string | null;
+            external_url: string;
+            html_url: string;
+            created_at: string;
+            updated_at: string;
+            permissions: {
+                issues?: string;
+                checks?: string;
+                metadata?: string;
+                contents?: string;
+                deployments?: string;
+                [key: string]: string | undefined;
+            };
+            events: string[];
+            installations_count?: number;
+        } | null;
+        author_association?: "COLLABORATOR" | "CONTRIBUTOR" | "FIRST_TIMER" | "FIRST_TIME_CONTRIBUTOR" | "MANNEQUIN" | "MEMBER" | "NONE" | "OWNER";
+        reactions?: {
+            url: string;
+            total_count: number;
+            "+1": number;
+            "-1": number;
+            laugh: number;
+            confused: number;
+            heart: number;
+            hooray: number;
+            eyes: number;
+            rocket: number;
+        };
+        sub_issues_summary?: {
+            total: number;
+            completed: number;
+            percent_completed: number;
+        };
         parent_issue_url?: string | null;
-        issue_dependencies_summary?: import("@octokit/openapi-types").components["schemas"]["issue-dependencies-summary"];
-        issue_field_values?: import("@octokit/openapi-types").components["schemas"]["issue-field-value"][];
+        issue_dependencies_summary?: {
+            blocked_by: number;
+            blocking: number;
+            total_blocked_by: number;
+            total_blocking: number;
+        };
+        issue_field_values?: {
+            issue_field_id: number;
+            node_id: string;
+            data_type: "text" | "single_select" | "number" | "date";
+            value: (string | number) | null;
+            single_select_option?: {
+                id: number;
+                name: string;
+                color: string;
+            } | null;
+        }[];
     }>;
+    /**
+     * Fetch the issue body. Used by the dispatch path so build/explore/pr-fix
+     * workflows always see the real issue body, even when triggered from a
+     * comment (where the EventEnvelope.body field is the comment, not the
+     * issue body).
+     */
+    getIssueBody(owner: string, repo: string, issueNumber: number): Promise<string>;
+    /**
+     * List all comments on an issue/PR, oldest first. Used by the dispatch path
+     * to inject the full conversation thread into the architect's context — the
+     * spec the bot writes during an `explore` run lives here, and the build
+     * cycle needs to see it to implement the agreed design.
+     */
+    listIssueComments(owner: string, repo: string, issueNumber: number): Promise<Array<{
+        user: string;
+        body: string;
+        createdAt: string;
+    }>>;
     getPullRequest(owner: string, repo: string, pullNumber: number): Promise<{
         url: string;
         id: number;
@@ -91,7 +496,30 @@ export declare class GitHubClient {
         state: "open" | "closed";
         locked: boolean;
         title: string;
-        user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+        user: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        };
         body: string | null;
         labels: {
             id: number;
@@ -102,49 +530,560 @@ export declare class GitHubClient {
             color: string;
             default: boolean;
         }[];
-        milestone: import("@octokit/openapi-types").components["schemas"]["nullable-milestone"];
+        milestone: {
+            url: string;
+            html_url: string;
+            labels_url: string;
+            id: number;
+            node_id: string;
+            number: number;
+            state: "open" | "closed";
+            title: string;
+            description: string | null;
+            creator: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            } | null;
+            open_issues: number;
+            closed_issues: number;
+            created_at: string;
+            updated_at: string;
+            closed_at: string | null;
+            due_on: string | null;
+        } | null;
         active_lock_reason?: string | null;
         created_at: string;
         updated_at: string;
         closed_at: string | null;
         merged_at: string | null;
         merge_commit_sha: string | null;
-        assignee: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
-        assignees?: import("@octokit/openapi-types").components["schemas"]["simple-user"][] | null;
-        requested_reviewers?: import("@octokit/openapi-types").components["schemas"]["simple-user"][] | null;
-        requested_teams?: import("@octokit/openapi-types").components["schemas"]["team-simple"][] | null;
+        assignee: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        } | null;
+        assignees?: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        }[] | null;
+        requested_reviewers?: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        }[] | null;
+        requested_teams?: {
+            id: number;
+            node_id: string;
+            url: string;
+            members_url: string;
+            name: string;
+            description: string | null;
+            permission: string;
+            privacy?: string;
+            notification_setting?: string;
+            html_url: string;
+            repositories_url: string;
+            slug: string;
+            ldap_dn?: string;
+            type: "enterprise" | "organization";
+            organization_id?: number;
+            enterprise_id?: number;
+        }[] | null;
         head: {
             label: string;
             ref: string;
-            repo: import("@octokit/openapi-types").components["schemas"]["repository"];
+            repo: {
+                id: number;
+                node_id: string;
+                name: string;
+                full_name: string;
+                license: {
+                    key: string;
+                    name: string;
+                    url: string | null;
+                    spdx_id: string | null;
+                    node_id: string;
+                    html_url?: string;
+                } | null;
+                forks: number;
+                permissions?: {
+                    admin: boolean;
+                    pull: boolean;
+                    triage?: boolean;
+                    push: boolean;
+                    maintain?: boolean;
+                };
+                owner: {
+                    name?: string | null;
+                    email?: string | null;
+                    login: string;
+                    id: number;
+                    node_id: string;
+                    avatar_url: string;
+                    gravatar_id: string | null;
+                    url: string;
+                    html_url: string;
+                    followers_url: string;
+                    following_url: string;
+                    gists_url: string;
+                    starred_url: string;
+                    subscriptions_url: string;
+                    organizations_url: string;
+                    repos_url: string;
+                    events_url: string;
+                    received_events_url: string;
+                    type: string;
+                    site_admin: boolean;
+                    starred_at?: string;
+                    user_view_type?: string;
+                };
+                private: boolean;
+                html_url: string;
+                description: string | null;
+                fork: boolean;
+                url: string;
+                archive_url: string;
+                assignees_url: string;
+                blobs_url: string;
+                branches_url: string;
+                collaborators_url: string;
+                comments_url: string;
+                commits_url: string;
+                compare_url: string;
+                contents_url: string;
+                contributors_url: string;
+                deployments_url: string;
+                downloads_url: string;
+                events_url: string;
+                forks_url: string;
+                git_commits_url: string;
+                git_refs_url: string;
+                git_tags_url: string;
+                git_url: string;
+                issue_comment_url: string;
+                issue_events_url: string;
+                issues_url: string;
+                keys_url: string;
+                labels_url: string;
+                languages_url: string;
+                merges_url: string;
+                milestones_url: string;
+                notifications_url: string;
+                pulls_url: string;
+                releases_url: string;
+                ssh_url: string;
+                stargazers_url: string;
+                statuses_url: string;
+                subscribers_url: string;
+                subscription_url: string;
+                tags_url: string;
+                teams_url: string;
+                trees_url: string;
+                clone_url: string;
+                mirror_url: string | null;
+                hooks_url: string;
+                svn_url: string;
+                homepage: string | null;
+                language: string | null;
+                forks_count: number;
+                stargazers_count: number;
+                watchers_count: number;
+                size: number;
+                default_branch: string;
+                open_issues_count: number;
+                is_template?: boolean;
+                topics?: string[];
+                has_issues: boolean;
+                has_projects: boolean;
+                has_wiki: boolean;
+                has_pages: boolean;
+                has_downloads: boolean;
+                has_discussions?: boolean;
+                archived: boolean;
+                disabled: boolean;
+                visibility?: string;
+                pushed_at: string | null;
+                created_at: string | null;
+                updated_at: string | null;
+                allow_rebase_merge?: boolean;
+                temp_clone_token?: string;
+                allow_squash_merge?: boolean;
+                allow_auto_merge?: boolean;
+                delete_branch_on_merge?: boolean;
+                allow_update_branch?: boolean;
+                use_squash_pr_title_as_default?: boolean;
+                squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
+                squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
+                merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
+                merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
+                allow_merge_commit?: boolean;
+                allow_forking?: boolean;
+                web_commit_signoff_required?: boolean;
+                open_issues: number;
+                watchers: number;
+                master_branch?: string;
+                starred_at?: string;
+                anonymous_access_enabled?: boolean;
+                code_search_index_status?: {
+                    lexical_search_ok?: boolean;
+                    lexical_commit_sha?: string;
+                };
+            };
             sha: string;
-            user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+            user: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            };
         };
         base: {
             label: string;
             ref: string;
-            repo: import("@octokit/openapi-types").components["schemas"]["repository"];
+            repo: {
+                id: number;
+                node_id: string;
+                name: string;
+                full_name: string;
+                license: {
+                    key: string;
+                    name: string;
+                    url: string | null;
+                    spdx_id: string | null;
+                    node_id: string;
+                    html_url?: string;
+                } | null;
+                forks: number;
+                permissions?: {
+                    admin: boolean;
+                    pull: boolean;
+                    triage?: boolean;
+                    push: boolean;
+                    maintain?: boolean;
+                };
+                owner: {
+                    name?: string | null;
+                    email?: string | null;
+                    login: string;
+                    id: number;
+                    node_id: string;
+                    avatar_url: string;
+                    gravatar_id: string | null;
+                    url: string;
+                    html_url: string;
+                    followers_url: string;
+                    following_url: string;
+                    gists_url: string;
+                    starred_url: string;
+                    subscriptions_url: string;
+                    organizations_url: string;
+                    repos_url: string;
+                    events_url: string;
+                    received_events_url: string;
+                    type: string;
+                    site_admin: boolean;
+                    starred_at?: string;
+                    user_view_type?: string;
+                };
+                private: boolean;
+                html_url: string;
+                description: string | null;
+                fork: boolean;
+                url: string;
+                archive_url: string;
+                assignees_url: string;
+                blobs_url: string;
+                branches_url: string;
+                collaborators_url: string;
+                comments_url: string;
+                commits_url: string;
+                compare_url: string;
+                contents_url: string;
+                contributors_url: string;
+                deployments_url: string;
+                downloads_url: string;
+                events_url: string;
+                forks_url: string;
+                git_commits_url: string;
+                git_refs_url: string;
+                git_tags_url: string;
+                git_url: string;
+                issue_comment_url: string;
+                issue_events_url: string;
+                issues_url: string;
+                keys_url: string;
+                labels_url: string;
+                languages_url: string;
+                merges_url: string;
+                milestones_url: string;
+                notifications_url: string;
+                pulls_url: string;
+                releases_url: string;
+                ssh_url: string;
+                stargazers_url: string;
+                statuses_url: string;
+                subscribers_url: string;
+                subscription_url: string;
+                tags_url: string;
+                teams_url: string;
+                trees_url: string;
+                clone_url: string;
+                mirror_url: string | null;
+                hooks_url: string;
+                svn_url: string;
+                homepage: string | null;
+                language: string | null;
+                forks_count: number;
+                stargazers_count: number;
+                watchers_count: number;
+                size: number;
+                default_branch: string;
+                open_issues_count: number;
+                is_template?: boolean;
+                topics?: string[];
+                has_issues: boolean;
+                has_projects: boolean;
+                has_wiki: boolean;
+                has_pages: boolean;
+                has_downloads: boolean;
+                has_discussions?: boolean;
+                archived: boolean;
+                disabled: boolean;
+                visibility?: string;
+                pushed_at: string | null;
+                created_at: string | null;
+                updated_at: string | null;
+                allow_rebase_merge?: boolean;
+                temp_clone_token?: string;
+                allow_squash_merge?: boolean;
+                allow_auto_merge?: boolean;
+                delete_branch_on_merge?: boolean;
+                allow_update_branch?: boolean;
+                use_squash_pr_title_as_default?: boolean;
+                squash_merge_commit_title?: "PR_TITLE" | "COMMIT_OR_PR_TITLE";
+                squash_merge_commit_message?: "PR_BODY" | "COMMIT_MESSAGES" | "BLANK";
+                merge_commit_title?: "PR_TITLE" | "MERGE_MESSAGE";
+                merge_commit_message?: "PR_BODY" | "PR_TITLE" | "BLANK";
+                allow_merge_commit?: boolean;
+                allow_forking?: boolean;
+                web_commit_signoff_required?: boolean;
+                open_issues: number;
+                watchers: number;
+                master_branch?: string;
+                starred_at?: string;
+                anonymous_access_enabled?: boolean;
+                code_search_index_status?: {
+                    lexical_search_ok?: boolean;
+                    lexical_commit_sha?: string;
+                };
+            };
             sha: string;
-            user: import("@octokit/openapi-types").components["schemas"]["simple-user"];
+            user: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            };
         };
         _links: {
-            comments: import("@octokit/openapi-types").components["schemas"]["link"];
-            commits: import("@octokit/openapi-types").components["schemas"]["link"];
-            statuses: import("@octokit/openapi-types").components["schemas"]["link"];
-            html: import("@octokit/openapi-types").components["schemas"]["link"];
-            issue: import("@octokit/openapi-types").components["schemas"]["link"];
-            review_comments: import("@octokit/openapi-types").components["schemas"]["link"];
-            review_comment: import("@octokit/openapi-types").components["schemas"]["link"];
-            self: import("@octokit/openapi-types").components["schemas"]["link"];
+            comments: {
+                href: string;
+            };
+            commits: {
+                href: string;
+            };
+            statuses: {
+                href: string;
+            };
+            html: {
+                href: string;
+            };
+            issue: {
+                href: string;
+            };
+            review_comments: {
+                href: string;
+            };
+            review_comment: {
+                href: string;
+            };
+            self: {
+                href: string;
+            };
         };
-        author_association: import("@octokit/openapi-types").components["schemas"]["author-association"];
-        auto_merge: import("@octokit/openapi-types").components["schemas"]["auto-merge"];
+        author_association: "COLLABORATOR" | "CONTRIBUTOR" | "FIRST_TIMER" | "FIRST_TIME_CONTRIBUTOR" | "MANNEQUIN" | "MEMBER" | "NONE" | "OWNER";
+        auto_merge: {
+            enabled_by: {
+                name?: string | null;
+                email?: string | null;
+                login: string;
+                id: number;
+                node_id: string;
+                avatar_url: string;
+                gravatar_id: string | null;
+                url: string;
+                html_url: string;
+                followers_url: string;
+                following_url: string;
+                gists_url: string;
+                starred_url: string;
+                subscriptions_url: string;
+                organizations_url: string;
+                repos_url: string;
+                events_url: string;
+                received_events_url: string;
+                type: string;
+                site_admin: boolean;
+                starred_at?: string;
+                user_view_type?: string;
+            };
+            merge_method: "merge" | "squash" | "rebase";
+            commit_title: string;
+            commit_message: string;
+        } | null;
         draft?: boolean;
         merged: boolean;
         mergeable: boolean | null;
         rebaseable?: boolean | null;
         mergeable_state: string;
-        merged_by: import("@octokit/openapi-types").components["schemas"]["nullable-simple-user"];
+        merged_by: {
+            name?: string | null;
+            email?: string | null;
+            login: string;
+            id: number;
+            node_id: string;
+            avatar_url: string;
+            gravatar_id: string | null;
+            url: string;
+            html_url: string;
+            followers_url: string;
+            following_url: string;
+            gists_url: string;
+            starred_url: string;
+            subscriptions_url: string;
+            organizations_url: string;
+            repos_url: string;
+            events_url: string;
+            received_events_url: string;
+            type: string;
+            site_admin: boolean;
+            starred_at?: string;
+            user_view_type?: string;
+        } | null;
         comments: number;
         review_comments: number;
         maintainer_can_modify: boolean;
@@ -153,6 +1092,51 @@ export declare class GitHubClient {
         deletions: number;
         changed_files: number;
     }>;
+    /** Convenience: fetch only the PR's head commit SHA. Used by check-run code. */
+    getPullRequestHeadSha(owner: string, repo: string, pullNumber: number): Promise<string>;
+    /**
+     * Create a Check Run on a PR's head commit. Returns the new check_run id so
+     * the caller can later transition it from `in_progress` → `completed` with
+     * a conclusion. Repos that enable "Require status checks to pass" with
+     * `name` in their list will gate merges on the eventual conclusion.
+     *
+     * Requires the GitHub App to have `Checks: Read and write` permission.
+     */
+    createCheckRun(owner: string, repo: string, headSha: string, name: string, options?: {
+        detailsUrl?: string;
+        output?: {
+            title: string;
+            summary: string;
+        };
+    }): Promise<number>;
+    /**
+     * Update an existing Check Run — typically to transition `in_progress` →
+     * `completed` with a conclusion. Conclusion values that branch protection
+     * treats as passing: `success`, `neutral`, `skipped`. Failing: `failure`,
+     * `cancelled`, `timed_out`, `action_required`.
+     */
+    updateCheckRun(owner: string, repo: string, checkRunId: number, update: {
+        status?: "queued" | "in_progress" | "completed";
+        conclusion?: "success" | "failure" | "neutral" | "cancelled" | "timed_out" | "action_required" | "skipped";
+        output?: {
+            title: string;
+            summary: string;
+        };
+    }): Promise<void>;
+    /**
+     * Find the bot's most recent review on this PR's current head commit. Used
+     * after a pr-review workflow finishes to derive the check-run conclusion
+     * from the review the agent actually posted (APPROVE / REQUEST_CHANGES /
+     * COMMENT). Returns null when the bot hasn't reviewed this SHA yet.
+     *
+     * `botLogin` defaults to `last-light[bot]` so the lookup matches App-auth'd
+     * reviews regardless of how the agent identified itself.
+     */
+    getLatestBotReview(owner: string, repo: string, pullNumber: number, headSha: string, botLogin?: string): Promise<{
+        state: string;
+        body: string | null;
+        submittedAt: string | null;
+    } | null>;
     /**
      * Get failed check runs for a PR's head SHA.
      * Fetches the actual job logs (not just annotations) to show real errors.