@open-mercato/cezar 0.9.1 → 0.9.2

package/dist/server/forge/github.d.ts

@@ -1,5 +1,14 @@
 import { z } from 'zod';
-import type { DraftPrInput, DraftPrOutcome, ForgeAvailability, ForgeComment, ForgeCommentsData, ForgeDriver, ForgeItem, ForgeTimelineEvent, ForgeTimelineEventKind } from './types.js';
+import type { DraftPrInput, DraftPrOutcome, ForgeAvailability, ForgeComment, ForgeCommentsData, ForgeDriver, ForgeItem, ForgePrMergeState, ForgePrDiffResult, ForgeTimelineEvent, ForgeTimelineEventKind } from './types.ts';
+export declare const GH_PR_DIFF_FILE_CAP = 300;
+export declare const GH_PR_PATCH_CAP: number;
+export declare const GH_PR_DIFF_JSON_CAP: number;
+export declare class GithubPrNotFoundError extends Error {
+}
+export type PrFilesPageRunner = (page: number) => Promise<string>;
+/** Fetch no more than the three GitHub pages represented by the public 300-file response cap. */
+export declare function fetchPrFilePages(runPage: PrFilesPageRunner): Promise<unknown[]>;
+export declare function fetchGithubPrDiff(repoRoot: string, number: number, refresh?: boolean): Promise<ForgePrDiffResult>;
 /** One GitHub issue or pull request, flattened for the cockpit's GitHub tab. */
 export type GithubItem = ForgeItem;
 export interface GithubData {
@@ -19,28 +28,12 @@ export declare const ghCheckRunSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     conclusion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    state?: string | null | undefined;
-    status?: string | null | undefined;
-    conclusion?: string | null | undefined;
-}, {
-    state?: string | null | undefined;
-    status?: string | null | undefined;
-    conclusion?: string | null | undefined;
-}>;
+}, z.core.$strip>;
 declare const ghStatusCheckRollup: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
     state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     conclusion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    state?: string | null | undefined;
-    status?: string | null | undefined;
-    conclusion?: string | null | undefined;
-}, {
-    state?: string | null | undefined;
-    status?: string | null | undefined;
-    conclusion?: string | null | undefined;
-}>, "many">>>;
+}, z.core.$strip>>>>;
 /** Exported for unit tests (#400) — collapses a zod-validated `statusCheckRollup` array down to
  *  the single enum the GitHub tab (list rows + detail badge) renders. */
 export declare function rollupToChecks(rollup: z.infer<typeof ghStatusCheckRollup>): GithubItem['checks'];
@@ -104,13 +97,7 @@ export declare const ghTimelineEventSchema: z.ZodObject<{
     actor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         login: z.ZodString;
         avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        login: string;
-        avatar_url?: string | null | undefined;
-    }, {
-        login: string;
-        avatar_url?: string | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     html_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -118,145 +105,27 @@ export declare const ghTimelineEventSchema: z.ZodObject<{
     author: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        name?: string | null | undefined;
-        date?: string | null | undefined;
-    }, {
-        name?: string | null | undefined;
-        date?: string | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     label: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        color?: string | null | undefined;
-    }, {
-        name: string;
-        color?: string | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         login: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        login: string;
-    }, {
-        login: string;
-    }>>>;
+    }, z.core.$strip>>>;
     rename: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         from: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         to: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        from?: string | null | undefined;
-        to?: string | null | undefined;
-    }, {
-        from?: string | null | undefined;
-        to?: string | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         issue: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             number: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             html_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pull_request: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
-        }, "strip", z.ZodTypeAny, {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        }, {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        }>>>;
-    }, "strip", z.ZodTypeAny, {
-        issue?: {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        } | null | undefined;
-    }, {
-        issue?: {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        } | null | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    event: string;
-    id?: number | null | undefined;
-    node_id?: string | null | undefined;
-    created_at?: string | null | undefined;
-    actor?: {
-        login: string;
-        avatar_url?: string | null | undefined;
-    } | null | undefined;
-    url?: string | null | undefined;
-    html_url?: string | null | undefined;
-    sha?: string | null | undefined;
-    message?: string | null | undefined;
-    author?: {
-        name?: string | null | undefined;
-        date?: string | null | undefined;
-    } | null | undefined;
-    label?: {
-        name: string;
-        color?: string | null | undefined;
-    } | null | undefined;
-    assignee?: {
-        login: string;
-    } | null | undefined;
-    rename?: {
-        from?: string | null | undefined;
-        to?: string | null | undefined;
-    } | null | undefined;
-    source?: {
-        issue?: {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        } | null | undefined;
-    } | null | undefined;
-}, {
-    event: string;
-    id?: number | null | undefined;
-    node_id?: string | null | undefined;
-    created_at?: string | null | undefined;
-    actor?: {
-        login: string;
-        avatar_url?: string | null | undefined;
-    } | null | undefined;
-    url?: string | null | undefined;
-    html_url?: string | null | undefined;
-    sha?: string | null | undefined;
-    message?: string | null | undefined;
-    author?: {
-        name?: string | null | undefined;
-        date?: string | null | undefined;
-    } | null | undefined;
-    label?: {
-        name: string;
-        color?: string | null | undefined;
-    } | null | undefined;
-    assignee?: {
-        login: string;
-    } | null | undefined;
-    rename?: {
-        from?: string | null | undefined;
-        to?: string | null | undefined;
-    } | null | undefined;
-    source?: {
-        issue?: {
-            number?: number | null | undefined;
-            title?: string | null | undefined;
-            html_url?: string | null | undefined;
-            pull_request?: unknown;
-        } | null | undefined;
-    } | null | undefined;
-}>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 /** First 200 thread entries, then `truncated`; each body sliced to 8 000 chars (same cap as
  *  item bodies). */
 export declare const THREAD_ENTRY_CAP = 200;
@@ -349,6 +218,38 @@ export declare const COMMIT_CHECKS_CHUNK = 50;
  * `runGraphql` is injected so this is testable without shelling out.
  */
 export declare function fetchCommitChecks(runGraphql: GraphqlRunner, owner: string, name: string, shas: string[], chunkSize?: number): Promise<Record<string, ForgeTimelineEvent['checks']>>;
+/** The single enum a PR row's checks glyph renders (never `undefined` on the wire). */
+export type ChecksGlyph = 'passing' | 'failing' | 'pending' | null;
+export type GithubChecksData = {
+    available: true;
+    checks: Record<number, ChecksGlyph>;
+} | {
+    available: false;
+    reason: string;
+};
+/** PR numbers per checks query. Aliases resolve independently (a failed chunk costs only its own
+ *  glyphs); bounded so an unbounded number list can't blow the query size limit. Also the route's
+ *  hard cap on how many PRs one request may ask about. */
+export declare const GH_CHECKS_MAX = 100;
+/**
+ * Rolled-up CI state per PR number, as a `number → glyph` map.
+ *
+ * Batched and aliased so a 100-PR window costs one subprocess, not a hundred. Each alias resolves
+ * independently and an unknown number comes back `null` (alias resolved null → left absent), so
+ * partial results degrade cleanly. Degrades to an empty map on any failure — exactly as
+ * `fetchCommitChecks` does. Exported for tests; `runGraphql` is injected so this is testable
+ * without shelling out.
+ */
+export declare function fetchPrChecks(runGraphql: GraphqlRunner, owner: string, name: string, numbers: number[], chunkSize?: number): Promise<Record<number, ChecksGlyph>>;
+/** Test hook — the per-PR checks cache would otherwise leak state across cases in one process. */
+export declare function __clearChecksCacheForTests(): void;
+/**
+ * Lazy checks glyphs for the given PR numbers (route-facing). Resolves the repo handle once,
+ * serves fresh cache entries, queries only the misses, and degrades to `{ available: false,
+ * reason }` when `gh` or the handle is unavailable — never a throw, never a 5xx (plan rule 7).
+ * Numbers are de-duplicated, validated, and capped at `GH_CHECKS_MAX`.
+ */
+export declare function fetchGithubChecks(repoRoot: string, numbers: number[]): Promise<GithubChecksData>;
 /**
  * The conversation thread for one issue/PR, lazily. `{owner}`/`{repo}` in the gh api paths are
  * filled from the worktree's remote by gh itself, so no extra handle lookup. Everything degrades:
@@ -380,6 +281,12 @@ export declare function buildPrBody(handoffText: string, task: string): string;
  * dropping `forge.available` and blinking the sidebar item out until the background probe warmed.
  */
 export declare function detectGithubCached(repoRoot: string): ForgeAvailability | null;
+export declare function normalizeMergeState(raw: unknown, policyRaw: unknown, requirements?: {
+    readable: boolean;
+    requiredChecks: string[];
+}): ForgePrMergeState;
+export declare function evictGithubProjectCaches(repoRoot: string): void;
+export declare function mergePreflightAllowed(current: ForgePrMergeState, overrideRules?: boolean): boolean;
 /** owner/repo parsed out of the origin remote — feeds `viewUrl`. */
 export interface GithubRepoRef {
     owner: string;