cloving 1.3.0 → 1.5.0

package/dist/src/report.d.ts

@@ -1,15 +1,14 @@
+import { type ReportQualityData } from "./report-quality.ts";
 import { type ReportDatum } from "./report-statistics.ts";
+import { type ReportCiData } from "./report-ci.ts";
+import type { ReportFlow } from "./report-flow-types.ts";
+import type { ReportReadyTicket } from "./report-flow-types.ts";
 import type { Fields } from "./protocol.ts";
-export declare const reportOutcomes: readonly ["completed", "partial", "blocked", "failed", "cancelled"];
-export type ReportOutcome = (typeof reportOutcomes)[number];
-export interface ReportCompletion {
-    readonly runId: string;
-    readonly sequence: number;
-    readonly at: number;
-    readonly outcome: ReportOutcome;
-}
+import { type ReportCompletion } from "./report-flow-types.ts";
+export { reportOutcomes, type ReportCompletion, type ReportOutcome, } from "./report-flow-types.ts";
 export interface ReportCost {
     readonly runId: string;
+    readonly ticketId?: string | null;
     readonly turns: readonly {
         readonly operationId: string;
         readonly costUsd: number | null;
@@ -17,15 +16,22 @@ export interface ReportCost {
     }[] | null;
 }
 interface ReportInput {
+    readonly flow?: ReportFlow;
+    readonly effects?: readonly Fields[] | null;
     readonly since: number;
     readonly now: number;
     readonly completions: readonly ReportCompletion[] | null;
     readonly observedSince?: number | null;
     readonly costs?: readonly ReportCost[];
-    readonly github?: {
+    readonly github?: ReportQualityData & {
+        readonly labels?: readonly ReportDatum[] | null;
+        readonly ciUsage?: ReportCiData | null;
+        readonly mainFirstPass?: readonly ReportDatum[] | null;
         readonly observedSince?: number | null;
         readonly issues: readonly ReportDatum[] | null;
         readonly pulls: readonly ReportDatum[] | null;
+        readonly ready?: readonly ReportReadyTicket[] | null;
+        readonly leadTimes?: readonly ReportDatum[] | null;
         readonly sources: Fields;
     };
 }
@@ -36,50 +42,555 @@ export declare function loopReport(input: ReportInput): {
         };
         github: Readonly<Record<string, unknown>>;
     };
-    coverage: {
-        ci: {
+    quality: {
+        reviewScore: {
+            [k: string]: {
+                evidence: Readonly<Record<string, unknown>>[];
+                mark?: string;
+                status: string;
+                value: number | null;
+                comparisonValue: number | null;
+                baseline: {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: null;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: {
+                        low: number;
+                        high: number;
+                    };
+                };
+            };
+        };
+        reopenedTickets: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
+            status: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
+        };
+        revertedPullRequests: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
+            status: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
+        };
+        jobLogs: {
+            readonly read: number;
+            readonly notRead: number;
+            readonly limit: number;
+            readonly maximumBytes: number;
+        } | {
+            status: string;
+        };
+        mainFirstPassShare: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
+            status: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
+        };
+        flakyFailures: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
+            status: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
+        };
+        realFailures: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
+            status: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
+        };
+    };
+    ci: {
+        jobMinutes: {
+            [k: string]: {
+                evidence: Readonly<Record<string, unknown>>[];
+                mark?: string;
+                status: string;
+                value: number | null;
+                comparisonValue: number | null;
+                baseline: {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: null;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: {
+                        low: number;
+                        high: number;
+                    };
+                };
+            };
+        };
+        jobLimitShare: {
+            [k: string]: {
+                evidence: Readonly<Record<string, unknown>>[];
+                mark?: string;
+                status: string;
+                value: number | null;
+                comparisonValue: number | null;
+                baseline: {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: null;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: {
+                        low: number;
+                        high: number;
+                    };
+                };
+            };
+        };
+        runnerWaitMinutes: {
+            [k: string]: {
+                evidence: Readonly<Record<string, unknown>>[];
+                mark?: string;
+                status: string;
+                value: number | null;
+                comparisonValue: number | null;
+                baseline: {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: null;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: null;
+                } | {
+                    evidence: Readonly<Record<string, unknown>>[];
+                    history: string;
+                    days: number;
+                    median: number;
+                    band: {
+                        low: number;
+                        high: number;
+                    };
+                };
+            };
+        };
+        timeouts: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        flow: {
+        reruns: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        quality: {
+    };
+    operator: {
+        merges: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        operator: {
+        labelChanges: {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        phases: {
+    };
+    coverage: {};
+    metrics: {
+        "cost.medianRunUsd": {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        fixRounds: {
+        "cost.medianCompletedTicketUsd": {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        leadTime: {
+        "leadTime.medianHours": {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        ticketClosureHistory: {
+        "tickets.completed": {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
-        completedTicketCosts: {
+        "pullRequests.merged": {
+            evidence: Readonly<Record<string, unknown>>[];
+            mark?: string;
             status: string;
-            reason: string;
+            value: number | null;
+            comparisonValue: number | null;
+            baseline: {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: null;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: null;
+            } | {
+                evidence: Readonly<Record<string, unknown>>[];
+                history: string;
+                days: number;
+                median: number;
+                band: {
+                    low: number;
+                    high: number;
+                };
+            };
         };
     };
-    metrics: Record<string, {
-        evidence: Readonly<Record<string, unknown>>[];
+    runCosts: {
         mark?: string;
-        status: string;
-        value: number | null;
-        comparisonValue: number | null;
         baseline: {
             evidence: Readonly<Record<string, unknown>>[];
             history: string;
@@ -102,8 +613,22 @@ export declare function loopReport(input: ReportInput): {
                 high: number;
             };
         };
-    }>;
-    runCosts: {
+        runId: string;
+        ticketId: string | null | undefined;
+        outcome: "cancelled" | "completed" | "failed" | "partial" | "blocked";
+        completedAt: number;
+        costUsd: number | null;
+        turns: readonly {
+            readonly operationId: string;
+            readonly costUsd: number | null;
+            readonly estimatedCostUsd?: number;
+        }[] | null;
+        evidence: {
+            runId: string;
+            sequence: number;
+        };
+    }[];
+    completedTicketCosts: {
         mark?: string;
         baseline: {
             evidence: Readonly<Record<string, unknown>>[];
@@ -127,18 +652,28 @@ export declare function loopReport(input: ReportInput): {
                 high: number;
             };
         };
-        runId: string;
-        outcome: "completed" | "failed" | "cancelled" | "partial" | "blocked";
-        completedAt: number;
+        issue: unknown;
+        closedAt: number;
         costUsd: number | null;
-        turns: readonly {
-            readonly operationId: string;
-            readonly costUsd: number | null;
-            readonly estimatedCostUsd?: number;
-        }[] | null;
-        evidence: {
+        runs: {
             runId: string;
-            sequence: number;
+            ticketId: string | null | undefined;
+            outcome: "cancelled" | "completed" | "failed" | "partial" | "blocked";
+            completedAt: number;
+            costUsd: number | null;
+            turns: readonly {
+                readonly operationId: string;
+                readonly costUsd: number | null;
+                readonly estimatedCostUsd?: number;
+            }[] | null;
+            evidence: {
+                runId: string;
+                sequence: number;
+            };
+        }[];
+        evidence: {
+            issue: unknown;
+            runIds: string[];
         };
     }[];
     schemaVersion: number;
@@ -150,12 +685,19 @@ export declare function loopReport(input: ReportInput): {
     };
     semantics: {
         tickets: string;
+        flowLanes: string;
+        flowTickets: string;
+        flowIdle: string;
+        flowWait: string;
+        flowStreak: string;
+        operatorLabels: string;
         costs: string;
     };
 };
 export declare function reportRunCosts(completions: readonly ReportCompletion[], costs: readonly ReportCost[]): {
     runId: string;
-    outcome: "completed" | "failed" | "cancelled" | "partial" | "blocked";
+    ticketId: string | null | undefined;
+    outcome: "cancelled" | "completed" | "failed" | "partial" | "blocked";
     completedAt: number;
     costUsd: number | null;
     turns: readonly {
@@ -168,4 +710,3 @@ export declare function reportRunCosts(completions: readonly ReportCompletion[],
         sequence: number;
     };
 }[];
-export {};