cloving 1.2.0 → 1.4.0

package/dist/src/report.d.ts

@@ -0,0 +1,712 @@
+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";
+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;
+        readonly estimatedCostUsd?: number;
+    }[] | 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?: 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;
+    };
+}
+export declare function loopReport(input: ReportInput): {
+    sources: {
+        daemon: {
+            status: string;
+        };
+        github: Readonly<Record<string, unknown>>;
+    };
+    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;
+            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;
+                };
+            };
+        };
+        reruns: {
+            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;
+                };
+            };
+        };
+    };
+    operator: {
+        merges: {
+            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;
+                };
+            };
+        };
+        labelChanges: {
+            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;
+                };
+            };
+        };
+    };
+    coverage: {};
+    metrics: {
+        "cost.medianRunUsd": {
+            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;
+                };
+            };
+        };
+        "cost.medianCompletedTicketUsd": {
+            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;
+                };
+            };
+        };
+        "leadTime.medianHours": {
+            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;
+                };
+            };
+        };
+        "tickets.completed": {
+            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;
+                };
+            };
+        };
+        "pullRequests.merged": {
+            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;
+                };
+            };
+        };
+    };
+    runCosts: {
+        mark?: string;
+        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;
+            };
+        };
+        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>>[];
+            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;
+            };
+        };
+        issue: unknown;
+        closedAt: number;
+        costUsd: number | null;
+        runs: {
+            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;
+            };
+        }[];
+        evidence: {
+            issue: unknown;
+            runIds: string[];
+        };
+    }[];
+    schemaVersion: number;
+    kind: string;
+    window: {
+        start: number;
+        end: number;
+        hours: number;
+    };
+    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;
+    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;
+    };
+}[];