crewly 1.20.194 → 1.20.196

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-stats.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Ticket autopilot stats (specs/2026-10-03-autopilot-experiments.md §2):
+ * per day and in total, what the autopilot moved (tickets triaged / started /
+ * done / verified / sent back / stalled, cycle times), how much the owner had
+ * to step in, where it stalled and why, how much the harness pushed, what it
+ * cost against the daily budget, and how long it sat paused on the budget.
+ *
+ * Pure: built from the trace events and the #984 metrics of the project's
+ * tagged traces (the run traces and the ticket traces) plus the token ledger
+ * numbers the caller passes in. No I/O.
+ *
+ * @module services/project-tickets/ticket-autopilot-stats
+ */
+import { type StallCause, type TraceMetrics } from '../trace/trace-metrics.js';
+import type { TraceEvent, TraceIndexEntry } from '../trace/trace.types.js';
+import type { ExperimentProcessSummary } from '../../types/experiment.types.js';
+/** One trace as the stats read it. */
+export interface StatsTrace {
+    entry: TraceIndexEntry;
+    events: TraceEvent[];
+    /**
+     * #984 metrics computed with `detail` (every stall, each owner touch with
+     * its time). Absent = computed here from the events.
+     */
+    metrics?: TraceMetrics | null;
+}
+/** Token ledger numbers of one day (the project's team sessions). */
+export interface LedgerDay {
+    tokens: number;
+    costUsd: number;
+}
+/** Input of {@link computeAutopilotStats}. */
+export interface AutopilotStatsInput {
+    projectId: string;
+    /** Only ticket traces carrying this label (null = all) */
+    label?: string | null;
+    /** Local days of the range, oldest first (YYYY-MM-DD) */
+    days: string[];
+    /** Run and ticket traces tagged with the project, active in the range */
+    traces: StatsTrace[];
+    /** Ledger per day (missing = 0) */
+    ledger?: Record<string, LedgerDay>;
+    /** Today's configured budget (tokens) */
+    dailyBudgetTokens: number;
+    /** Stall threshold the metrics used (minutes) */
+    stallMinutes: number;
+    now: Date;
+    /** Traces that could not be read (the result is then incomplete) */
+    unreadable?: number;
+}
+/** Median / mean of a set of durations. */
+export interface CycleStat {
+    count: number;
+    medianMs: number | null;
+    meanMs: number | null;
+}
+/** Owner touches (the #984 kinds; `manual` is not collected yet). */
+export interface OwnerTouchCounts {
+    answered: number;
+    approved: number;
+    sentBack: number;
+    corrected: number;
+    total: number;
+}
+/** Stalls by cause. */
+export interface StallCounts {
+    count: number;
+    totalMs: number;
+    byCause: Record<StallCause, {
+        count: number;
+        ms: number;
+    }>;
+}
+/** Harness interventions (the #984 definitions, counted by event day). */
+export interface InterventionCounts {
+    nudges: number;
+    redeliveries: number;
+    wakes: number;
+    corrections: number;
+    guardBlocks: number;
+    misroutes: number;
+    total: number;
+}
+/** The ledger against the budget. */
+export interface BudgetUse {
+    dailyBudgetTokens: number;
+    ledgerTokens: number;
+    ledgerCostUsd: number;
+    /** ledgerTokens / dailyBudgetTokens (0 with no budget) */
+    pct: number;
+}
+/** Numbers of a day, or of the whole range. */
+export interface AutopilotPeriodStats {
+    triaged: number;
+    started: number;
+    done: number;
+    verified: number;
+    sentBack: number;
+    stalled: number;
+    cycleTime: {
+        toDone: CycleStat;
+        toVerified: CycleStat;
+    };
+    ownerTouches: OwnerTouchCounts;
+    stalls: StallCounts;
+    interventions: InterventionCounts;
+    /** Tokens / USD of the traced autopilot work (run + ticket traces), by event day */
+    tokens: number;
+    costUsd: number;
+    budget: BudgetUse;
+    /** Time paused on the daily budget */
+    pausedMs: number;
+}
+/** One day. */
+export interface AutopilotDayStats extends AutopilotPeriodStats {
+    day: string;
+    /** The day's run trace */
+    runTraceId: string | null;
+    /** Ticket traces whose work started that day */
+    ticketTraceIds: string[];
+}
+/** {@link computeAutopilotStats} output. */
+export interface AutopilotStats {
+    projectId: string;
+    label: string | null;
+    range: {
+        start: string;
+        end: string;
+    };
+    stallMinutes: number;
+    /** Oldest first */
+    days: AutopilotDayStats[];
+    total: AutopilotPeriodStats;
+    /** Every label seen on the project's ticket traces (for a filter) */
+    labels: string[];
+    /** The budget and paused time are project-wide even with a label */
+    scope: {
+        budget: 'project';
+        pausedMs: 'project';
+    };
+    /** Run and ticket traces in the range (0 = no autopilot data, not zeros) */
+    traceCount: number;
+    /** Some traces could not be read: the numbers are short */
+    incomplete: boolean;
+}
+/**
+ * Median and mean.
+ *
+ * @param xs - Durations
+ * @returns Stat
+ */
+export declare function cycleStat(xs: number[]): CycleStat;
+/**
+ * Local midnight of a day key.
+ *
+ * @param day - YYYY-MM-DD
+ * @returns Epoch ms
+ */
+export declare function dayStartMs(day: string): number;
+/**
+ * The next local midnight after a day starts (23 or 25 hours on a DST day).
+ *
+ * @param day - YYYY-MM-DD
+ * @returns Epoch ms
+ */
+export declare function dayEndMs(day: string): number;
+/**
+ * A local day shifted by whole days.
+ *
+ * @param day - YYYY-MM-DD
+ * @param delta - Days (negative = earlier)
+ * @returns YYYY-MM-DD
+ */
+export declare function addDays(day: string, delta: number): string;
+/**
+ * The local days of a range ending today, oldest first.
+ *
+ * @param now - Today
+ * @param days - Number of days (today included)
+ * @returns Day keys
+ */
+export declare function rangeDays(now: Date, days: number): string[];
+/**
+ * The days between two dates (inclusive), oldest first.
+ *
+ * @param start - YYYY-MM-DD
+ * @param end - YYYY-MM-DD
+ * @returns Day keys
+ */
+export declare function daysBetween(start: string, end: string): string[];
+/**
+ * Compute the autopilot stats of a project over a range of days.
+ *
+ * Everything counts on the local day it happened: ticket moves, owner
+ * touches (each touch's own time), stalls (their start), interventions,
+ * tokens; paused time is clipped to each day. A ticket trace counts only
+ * from the moment the autopilot started work on it.
+ *
+ * @param input - Traces, ledger, range, label
+ * @returns Stats per day and in total
+ */
+export declare function computeAutopilotStats(input: AutopilotStatsInput): AutopilotStats;
+/** The process numbers an experiment compares (spec §3). */
+export type AutopilotProcessSummary = ExperimentProcessSummary;
+/**
+ * The experiment's process summary of a stats range.
+ *
+ * @param stats - Stats of the range
+ * @returns Summary
+ */
+export declare function processSummary(stats: AutopilotStats): AutopilotProcessSummary;
+//# sourceMappingURL=ticket-autopilot-stats.d.ts.map

package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-autopilot-stats.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/ticket-autopilot-stats.ts"],"names":[],"mappings":"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"}