@helmiq/crew-git 0.1.0 → 0.1.1

package/dist/git-tools.test.js

@@ -8,7 +8,7 @@ import { gitBranch } from './tool-git-branch.js';
 import { gitCommit } from './tool-git-commit.js';
 import { gitDiff } from './tool-git-diff.js';
 import { gitLog } from './tool-git-log.js';
-import { createGithubPr, GitHubClientError } from './github-client.js';
+import { createGithubPr, getPrCheckRuns, GitHubClientError } from './github-client.js';
 describe('Git Tools', () => {
     let repoDir;
     beforeEach(async () => {
@@ -143,6 +143,82 @@ describe('Git Tools', () => {
                 base: 'main',
             }, 'ghp_test_token')).rejects.toThrow(/PR_CREATION_FAILED|422/);
         });
+        it('fetches check runs for a commit ref', async () => {
+            const mockResponse = {
+                total_count: 2,
+                check_runs: [
+                    { id: 1, name: 'lint', status: 'completed', conclusion: 'success' },
+                    { id: 2, name: 'test', status: 'completed', conclusion: 'success' },
+                ],
+            };
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+                ok: true,
+                json: () => Promise.resolve(mockResponse),
+            }));
+            const result = await getPrCheckRuns({ owner: 'test', repo: 'repo', ref: 'abc123' }, 'ghp_test_token');
+            expect(result.totalCount).toBe(2);
+            expect(result.checkRuns).toHaveLength(2);
+            expect(result.allCompleted).toBe(true);
+            expect(result.allPassed).toBe(true);
+            expect(result.failed).toHaveLength(0);
+            const fetchCalls = vi.mocked(fetch).mock.calls;
+            expect(fetchCalls[0][0]).toContain('/commits/abc123/check-runs');
+        });
+        it('reports failed check runs', async () => {
+            const mockResponse = {
+                total_count: 2,
+                check_runs: [
+                    { id: 1, name: 'lint', status: 'completed', conclusion: 'success' },
+                    { id: 2, name: 'test', status: 'completed', conclusion: 'failure' },
+                ],
+            };
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+                ok: true,
+                json: () => Promise.resolve(mockResponse),
+            }));
+            const result = await getPrCheckRuns({ owner: 'test', repo: 'repo', ref: 'abc123' }, 'ghp_test_token');
+            expect(result.allCompleted).toBe(true);
+            expect(result.allPassed).toBe(false);
+            expect(result.failed).toHaveLength(1);
+            expect(result.failed[0].name).toBe('test');
+        });
+        it('reports pending check runs as not completed', async () => {
+            const mockResponse = {
+                total_count: 2,
+                check_runs: [
+                    { id: 1, name: 'lint', status: 'completed', conclusion: 'success' },
+                    { id: 2, name: 'test', status: 'in_progress', conclusion: null },
+                ],
+            };
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+                ok: true,
+                json: () => Promise.resolve(mockResponse),
+            }));
+            const result = await getPrCheckRuns({ owner: 'test', repo: 'repo', ref: 'abc123' }, 'ghp_test_token');
+            expect(result.allCompleted).toBe(false);
+            expect(result.allPassed).toBe(false);
+        });
+        it('throws CHECK_RUNS_QUERY_FAILED on non-ok response', async () => {
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+                ok: false,
+                status: 404,
+                text: () => Promise.resolve('{"message":"Not Found"}'),
+            }));
+            await expect(getPrCheckRuns({ owner: 'test', repo: 'repo', ref: 'abc123' }, 'ghp_test_token')).rejects.toThrow(/CHECK_RUNS_QUERY_FAILED|404/);
+        });
+        it('treats skipped checks as passing', async () => {
+            const mockResponse = {
+                total_count: 1,
+                check_runs: [{ id: 1, name: 'deploy', status: 'completed', conclusion: 'skipped' }],
+            };
+            vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+                ok: true,
+                json: () => Promise.resolve(mockResponse),
+            }));
+            const result = await getPrCheckRuns({ owner: 'test', repo: 'repo', ref: 'abc123' }, 'ghp_test_token');
+            expect(result.allPassed).toBe(true);
+            expect(result.failed).toHaveLength(0);
+        });
         it('sends labels in a separate request when provided', async () => {
             const prResponse = {
                 number: 10,

package/dist/github-client.d.ts

@@ -19,6 +19,25 @@ export interface CreatePrResult {
     htmlUrl: string;
 }
 export declare function createGithubPr(params: CreatePrParams, token?: string): Promise<CreatePrResult>;
+export interface GetPrCheckRunsParams {
+    owner: string;
+    repo: string;
+    ref: string;
+}
+export interface CheckRun {
+    id: number;
+    name: string;
+    status: 'queued' | 'in_progress' | 'completed';
+    conclusion: string | null;
+}
+export interface GetPrCheckRunsResult {
+    totalCount: number;
+    checkRuns: CheckRun[];
+    allCompleted: boolean;
+    allPassed: boolean;
+    failed: CheckRun[];
+}
+export declare function getPrCheckRuns(params: GetPrCheckRunsParams, token?: string): Promise<GetPrCheckRunsResult>;
 export declare class GitHubClientError extends Error {
     readonly code: string;
     readonly statusCode?: number;

package/dist/github-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../src/github-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAoDzB;AAgCD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAM/D"}
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../src/github-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAoDzB;AAoCD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;IAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CA4D/B;AAMD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAM/D"}

package/dist/github-client.js

@@ -62,6 +62,44 @@ async function addLabels(owner, repo, issueNumber, labels, token) {
         throw new GitHubClientError(`Failed to add labels (${response.status})`, 'PR_LABELS_FAILED', response.status);
     }
 }
+export async function getPrCheckRuns(params, token) {
+    const authToken = token ?? process.env['GITHUB_TOKEN'];
+    if (!authToken) {
+        throw new GitHubClientError('GITHUB_TOKEN environment variable is not set. Required for check-run queries.', 'GITHUB_TOKEN_MISSING');
+    }
+    const response = await fetch(`${GITHUB_API}/repos/${params.owner}/${params.repo}/commits/${params.ref}/check-runs`, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${authToken}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+        },
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        throw new GitHubClientError(`GitHub check-runs query failed (${response.status}): ${errorBody}`, 'CHECK_RUNS_QUERY_FAILED', response.status);
+    }
+    const data = (await response.json());
+    const checkRuns = data.check_runs.map((cr) => ({
+        id: cr.id,
+        name: cr.name,
+        status: cr.status,
+        conclusion: cr.conclusion,
+    }));
+    const allCompleted = checkRuns.length > 0 && checkRuns.every((cr) => cr.status === 'completed');
+    const failed = checkRuns.filter((cr) => cr.status === 'completed' && cr.conclusion !== 'success' && cr.conclusion !== 'skipped');
+    const allPassed = allCompleted && failed.length === 0;
+    return {
+        totalCount: data.total_count,
+        checkRuns,
+        allCompleted,
+        allPassed,
+        failed,
+    };
+}
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
 export class GitHubClientError extends Error {
     code;
     statusCode;

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { validateBranchName, BranchConventionError } from './branch-conventions.js';
-export { createGithubPr, GitHubClientError } from './github-client.js';
-export type { CreatePrParams, CreatePrResult } from './github-client.js';
+export { createGithubPr, getPrCheckRuns, GitHubClientError } from './github-client.js';
+export type { CreatePrParams, CreatePrResult, CheckRun } from './github-client.js';
+export { getPrChecks } from './tool-get-pr-checks.js';
+export type { GetPrChecksParams, GetPrChecksResult } from './tool-get-pr-checks.js';
 export { gitBranch, GitToolError } from './tool-git-branch.js';
 export type { GitBranchParams, GitBranchResult } from './tool-git-branch.js';
 export { gitCommit } from './tool-git-commit.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { validateBranchName, BranchConventionError } from './branch-conventions.js';
-export { createGithubPr, GitHubClientError } from './github-client.js';
+export { createGithubPr, getPrCheckRuns, GitHubClientError } from './github-client.js';
+export { getPrChecks } from './tool-get-pr-checks.js';
 export { gitBranch, GitToolError } from './tool-git-branch.js';
 export { gitCommit } from './tool-git-commit.js';
 export { gitPush } from './tool-git-push.js';

package/dist/tool-get-pr-checks.d.ts

@@ -0,0 +1,22 @@
+import type { GetPrCheckRunsParams, GetPrCheckRunsResult } from './github-client.js';
+export type { GetPrCheckRunsParams, GetPrCheckRunsResult };
+export interface GetPrChecksParams {
+    owner: string;
+    repo: string;
+    ref: string;
+    /** Maximum seconds to wait for all checks to complete. Defaults to 120. */
+    timeoutSeconds?: number;
+    /** Seconds between poll attempts. Defaults to 15. */
+    intervalSeconds?: number;
+}
+export interface GetPrChecksResult extends GetPrCheckRunsResult {
+    timedOut: boolean;
+}
+/**
+ * Poll GitHub check runs for a commit ref until all complete or timeout.
+ *
+ * Returns the final status, including whether polling timed out and
+ * which check runs (if any) failed.
+ */
+export declare function getPrChecks(params: GetPrChecksParams, token?: string): Promise<GetPrChecksResult>;
+//# sourceMappingURL=tool-get-pr-checks.d.ts.map

package/dist/tool-get-pr-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-get-pr-checks.d.ts","sourceRoot":"","sources":["../src/tool-get-pr-checks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAErF,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAsB5B"}

package/dist/tool-get-pr-checks.js

@@ -0,0 +1,31 @@
+import { getPrCheckRuns } from './github-client.js';
+const DEFAULT_TIMEOUT_SECONDS = 120;
+const DEFAULT_INTERVAL_SECONDS = 15;
+/**
+ * Poll GitHub check runs for a commit ref until all complete or timeout.
+ *
+ * Returns the final status, including whether polling timed out and
+ * which check runs (if any) failed.
+ */
+export async function getPrChecks(params, token) {
+    const timeout = (params.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS) * 1000;
+    const interval = (params.intervalSeconds ?? DEFAULT_INTERVAL_SECONDS) * 1000;
+    const deadline = Date.now() + timeout;
+    const apiParams = {
+        owner: params.owner,
+        repo: params.repo,
+        ref: params.ref,
+    };
+    let result = await getPrCheckRuns(apiParams, token);
+    while (!result.allCompleted && Date.now() < deadline) {
+        await sleep(Math.min(interval, deadline - Date.now()));
+        result = await getPrCheckRuns(apiParams, token);
+    }
+    return {
+        ...result,
+        timedOut: !result.allCompleted,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helmiq/crew-git",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Git and GitHub tools for the Crew delivery runtime",
   "type": "module",
   "license": "MIT",