@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/metrics/latency-tracker.d.ts

@@ -0,0 +1,33 @@
+import type { ToolCallRecord } from '../storage/types.js';
+export interface LatencyPercentiles {
+    readonly p50: number;
+    readonly p95: number;
+    readonly p99: number;
+    readonly min: number;
+    readonly max: number;
+    readonly count: number;
+}
+export interface LatencyMetrics {
+    readonly overall: LatencyPercentiles | null;
+    readonly byTool: Readonly<Record<string, LatencyPercentiles | null>>;
+    readonly slowestCalls: ReadonlyArray<{
+        toolName: string;
+        durationMs: number;
+        timestamp: number;
+        filePath?: string;
+    }>;
+}
+export declare class LatencyTracker {
+    private allDurations;
+    private byTool;
+    private slowestCalls;
+    private cachedSortedAll;
+    private cachedSortedByTool;
+    private lastSortedAllCount;
+    private lastSortedToolCounts;
+    recordToolCall(record: ToolCallRecord): void;
+    private computePercentiles;
+    getMetrics(): LatencyMetrics;
+    reset(_sessionId: string): void;
+}
+//# sourceMappingURL=latency-tracker.d.ts.map

package/dist/metrics/latency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/latency-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;QACnC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,YAAY,CAKZ;IAER,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IA+B5C,OAAO,CAAC,kBAAkB;IAc1B,UAAU,IAAI,cAAc;IA8B5B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAShC"}

package/dist/metrics/latency-tracker.js

@@ -0,0 +1,93 @@
+import { computePercentile } from './percentile.js';
+// Per-tool percentiles use only the first MAX_SAMPLES_PER_TOOL observations
+// (not reservoir-sampled), so p95/p99 may reflect early-session behaviour
+// in long sessions. Overall percentiles use a larger independent cap.
+const MAX_SAMPLES_PER_TOOL = 500;
+const MAX_OVERALL_SAMPLES = 5000;
+const MAX_SLOWEST = 10;
+export class LatencyTracker {
+    allDurations = [];
+    byTool = new Map();
+    slowestCalls = [];
+    cachedSortedAll = null;
+    cachedSortedByTool = new Map();
+    lastSortedAllCount = -1;
+    lastSortedToolCounts = new Map();
+    recordToolCall(record) {
+        if (record.durationMs === null || record.durationMs === undefined)
+            return;
+        const d = record.durationMs;
+        // Overall
+        if (this.allDurations.length < MAX_OVERALL_SAMPLES)
+            this.allDurations.push(d);
+        // Per tool
+        const key = record.toolName ?? 'Unknown';
+        let arr = this.byTool.get(key);
+        if (!arr) {
+            arr = [];
+            this.byTool.set(key, arr);
+        }
+        if (arr.length < MAX_SAMPLES_PER_TOOL)
+            arr.push(d);
+        // Slowest calls
+        const filePath = record.filePath;
+        const slowCall = {
+            toolName: key,
+            durationMs: d,
+            timestamp: record.timestamp ?? Date.now(),
+            ...(filePath !== undefined ? { filePath } : {}),
+        };
+        this.slowestCalls.push(slowCall);
+        this.slowestCalls.sort((a, b) => b.durationMs - a.durationMs);
+        if (this.slowestCalls.length > MAX_SLOWEST) {
+            this.slowestCalls.length = MAX_SLOWEST;
+        }
+    }
+    computePercentiles(sorted) {
+        if (sorted.length === 0)
+            return null;
+        const count = sorted.length;
+        return {
+            p50: computePercentile(sorted, 0.5) ?? 0,
+            p95: computePercentile(sorted, 0.95) ?? 0,
+            p99: computePercentile(sorted, 0.99) ?? 0,
+            min: sorted[0],
+            max: sorted[count - 1],
+            count,
+        };
+    }
+    getMetrics() {
+        // Re-sort overall only if new samples have been added
+        if (this.allDurations.length !== this.lastSortedAllCount) {
+            this.cachedSortedAll = [...this.allDurations].sort((a, b) => a - b);
+            this.lastSortedAllCount = this.allDurations.length;
+        }
+        const overall = this.computePercentiles(this.cachedSortedAll ?? []);
+        // Re-sort per-tool only if new samples have been added to that tool
+        const byTool = {};
+        for (const [tool, durations] of this.byTool) {
+            const prevCount = this.lastSortedToolCounts.get(tool) ?? -1;
+            if (durations.length !== prevCount) {
+                this.cachedSortedByTool.set(tool, [...durations].sort((a, b) => a - b));
+                this.lastSortedToolCounts.set(tool, durations.length);
+            }
+            const sorted = this.cachedSortedByTool.get(tool) ?? [];
+            byTool[tool] = this.computePercentiles(sorted);
+        }
+        return {
+            overall,
+            byTool,
+            slowestCalls: [...this.slowestCalls],
+        };
+    }
+    reset(_sessionId) {
+        this.allDurations = [];
+        this.byTool.clear();
+        this.slowestCalls = [];
+        this.cachedSortedAll = null;
+        this.cachedSortedByTool.clear();
+        this.lastSortedAllCount = -1;
+        this.lastSortedToolCounts.clear();
+    }
+}
+//# sourceMappingURL=latency-tracker.js.map

package/dist/metrics/latency-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-tracker.js","sourceRoot":"","sources":["../../src/metrics/latency-tracker.ts"],"names":[],"mappings":"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"}

package/dist/metrics/live-session-registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tracks which sessions are currently active based on recent tool call activity.
+ * A session is "live" if it received a tool call within the staleness threshold.
+ */
+export interface ConcurrencySample {
+    readonly timestamp: number;
+    readonly count: number;
+}
+export declare class LiveSessionRegistry {
+    private readonly lastActivity;
+    private readonly sessionNames;
+    private readonly staleThresholdMs;
+    private peakConcurrent;
+    private readonly concurrencyTimeSeries;
+    private samplingInterval;
+    constructor(staleThresholdMs?: number);
+    touch(sessionId: string, cwd?: string): void;
+    getSessionName(sessionId: string): string | null;
+    getLastActivity(sessionId: string): number | null;
+    getLiveSessions(): string[];
+    reset(): void;
+    isLive(sessionId: string): boolean;
+    startSampling(): void;
+    stopSampling(): void;
+    getConcurrentCount(): number;
+    getPeakConcurrent(): number;
+    getConcurrencyTimeSeries(): readonly ConcurrencySample[];
+}
+//# sourceMappingURL=live-session-registry.d.ts.map

package/dist/metrics/live-session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session-registry.d.ts","sourceRoot":"","sources":["../../src/metrics/live-session-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA2B;IACjE,OAAO,CAAC,gBAAgB,CAA+C;gBAE3D,gBAAgB,SAA6B;IAIzD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAc5C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjD,eAAe,IAAI,MAAM,EAAE;IAkB3B,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWlC,aAAa,IAAI,IAAI;IAYrB,YAAY,IAAI,IAAI;IAOpB,kBAAkB,IAAI,MAAM;IAI5B,iBAAiB,IAAI,MAAM;IAI3B,wBAAwB,IAAI,SAAS,iBAAiB,EAAE;CAGzD"}

package/dist/metrics/live-session-registry.js

@@ -0,0 +1,103 @@
+/**
+ * Tracks which sessions are currently active based on recent tool call activity.
+ * A session is "live" if it received a tool call within the staleness threshold.
+ */
+import { basename } from 'node:path';
+const DEFAULT_STALE_THRESHOLD_MS = 180_000; // 3 minutes
+const MAX_CONCURRENCY_SAMPLES = 2880; // 24h at 30s intervals
+const SAMPLE_INTERVAL_MS = 30_000;
+export class LiveSessionRegistry {
+    lastActivity = new Map();
+    sessionNames = new Map();
+    staleThresholdMs;
+    peakConcurrent = 0;
+    concurrencyTimeSeries = [];
+    samplingInterval = null;
+    constructor(staleThresholdMs = DEFAULT_STALE_THRESHOLD_MS) {
+        this.staleThresholdMs = staleThresholdMs;
+    }
+    touch(sessionId, cwd) {
+        this.lastActivity.set(sessionId, Date.now());
+        if (cwd && !this.sessionNames.has(sessionId)) {
+            const name = basename(cwd);
+            if (name.length > 0 && name !== '.' && name !== '..') {
+                this.sessionNames.set(sessionId, name);
+            }
+        }
+        const liveCount = this.getLiveSessions().length;
+        if (liveCount > this.peakConcurrent) {
+            this.peakConcurrent = liveCount;
+        }
+    }
+    getSessionName(sessionId) {
+        return this.sessionNames.get(sessionId) ?? null;
+    }
+    // Task #17 (D3): the dashboard's `/api/sessions/live` endpoint surfaces
+    // last-activity per live session so the Today selector can default to the
+    // most-recently-active live session. Returns null when the session is not
+    // tracked (e.g. already gc'd as stale).
+    getLastActivity(sessionId) {
+        return this.lastActivity.get(sessionId) ?? null;
+    }
+    getLiveSessions() {
+        const now = Date.now();
+        const live = [];
+        const stale = [];
+        for (const [id, ts] of this.lastActivity) {
+            if (now - ts <= this.staleThresholdMs) {
+                live.push(id);
+            }
+            else {
+                stale.push(id);
+            }
+        }
+        for (const id of stale) {
+            this.lastActivity.delete(id);
+            this.sessionNames.delete(id);
+        }
+        return live;
+    }
+    reset() {
+        this.lastActivity.clear();
+        this.sessionNames.clear();
+    }
+    isLive(sessionId) {
+        const ts = this.lastActivity.get(sessionId);
+        if (ts === undefined)
+            return false;
+        if (Date.now() - ts > this.staleThresholdMs) {
+            this.lastActivity.delete(sessionId);
+            this.sessionNames.delete(sessionId);
+            return false;
+        }
+        return true;
+    }
+    startSampling() {
+        if (this.samplingInterval)
+            return;
+        this.samplingInterval = setInterval(() => {
+            const count = this.getLiveSessions().length;
+            this.concurrencyTimeSeries.push({ timestamp: Date.now(), count });
+            if (this.concurrencyTimeSeries.length > MAX_CONCURRENCY_SAMPLES) {
+                this.concurrencyTimeSeries.shift();
+            }
+        }, SAMPLE_INTERVAL_MS);
+        this.samplingInterval.unref();
+    }
+    stopSampling() {
+        if (this.samplingInterval) {
+            clearInterval(this.samplingInterval);
+            this.samplingInterval = null;
+        }
+    }
+    getConcurrentCount() {
+        return this.getLiveSessions().length;
+    }
+    getPeakConcurrent() {
+        return this.peakConcurrent;
+    }
+    getConcurrencyTimeSeries() {
+        return this.concurrencyTimeSeries;
+    }
+}
+//# sourceMappingURL=live-session-registry.js.map

package/dist/metrics/live-session-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session-registry.js","sourceRoot":"","sources":["../../src/metrics/live-session-registry.ts"],"names":[],"mappings":"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"}

package/dist/metrics/model-usage-tracker.d.ts

@@ -0,0 +1,21 @@
+export interface ModelStats {
+    readonly requestCount: number;
+    readonly totalInputTokens: number;
+    readonly totalOutputTokens: number;
+    readonly totalCostUsd: number;
+    readonly costPerOutputToken: number | null;
+    readonly avgOutputTokensPerRequest: number | null;
+}
+export interface ModelUsageMetrics {
+    readonly byModel: Readonly<Record<string, ModelStats>>;
+    readonly mostUsedModel: string | null;
+    readonly mostEfficientModel: string | null;
+    readonly totalModelsUsed: number;
+}
+export declare class ModelUsageTracker {
+    private byModel;
+    recordUsage(model: string, inputTokens: number, outputTokens: number, costUsd: number): void;
+    getMetrics(): ModelUsageMetrics;
+    reset(_sessionId: string): void;
+}
+//# sourceMappingURL=model-usage-tracker.d.ts.map

package/dist/metrics/model-usage-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-usage-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/model-usage-tracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AASD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAwC;IAEvD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY5F,UAAU,IAAI,iBAAiB;IA6C/B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/metrics/model-usage-tracker.js

@@ -0,0 +1,53 @@
+export class ModelUsageTracker {
+    byModel = new Map();
+    recordUsage(model, inputTokens, outputTokens, costUsd) {
+        let stats = this.byModel.get(model);
+        if (!stats) {
+            stats = { requestCount: 0, totalInputTokens: 0, totalOutputTokens: 0, totalCostUsd: 0 };
+            this.byModel.set(model, stats);
+        }
+        stats.requestCount++;
+        stats.totalInputTokens += inputTokens;
+        stats.totalOutputTokens += outputTokens;
+        stats.totalCostUsd += costUsd;
+    }
+    getMetrics() {
+        const byModel = {};
+        let mostUsedModel = null;
+        let maxRequests = 0;
+        let mostEfficientModel = null;
+        let lowestCostPerOutputToken = Infinity;
+        for (const [model, stats] of this.byModel) {
+            const costPerOutputToken = stats.totalOutputTokens > 0 ? stats.totalCostUsd / stats.totalOutputTokens : null;
+            const avgOutputTokensPerRequest = stats.requestCount > 0 ? stats.totalOutputTokens / stats.requestCount : null;
+            byModel[model] = {
+                requestCount: stats.requestCount,
+                totalInputTokens: stats.totalInputTokens,
+                totalOutputTokens: stats.totalOutputTokens,
+                totalCostUsd: stats.totalCostUsd,
+                costPerOutputToken,
+                avgOutputTokensPerRequest,
+            };
+            if (stats.requestCount > maxRequests) {
+                maxRequests = stats.requestCount;
+                mostUsedModel = model;
+            }
+            if (costPerOutputToken !== null &&
+                (costPerOutputToken < lowestCostPerOutputToken ||
+                    (costPerOutputToken === lowestCostPerOutputToken && model < (mostEfficientModel ?? '￿')))) {
+                lowestCostPerOutputToken = costPerOutputToken;
+                mostEfficientModel = model;
+            }
+        }
+        return {
+            byModel,
+            mostUsedModel,
+            mostEfficientModel,
+            totalModelsUsed: this.byModel.size,
+        };
+    }
+    reset(_sessionId) {
+        this.byModel.clear();
+    }
+}
+//# sourceMappingURL=model-usage-tracker.js.map

package/dist/metrics/model-usage-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-usage-tracker.js","sourceRoot":"","sources":["../../src/metrics/model-usage-tracker.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,iBAAiB;IACpB,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEvD,WAAW,CAAC,KAAa,EAAE,WAAmB,EAAE,YAAoB,EAAE,OAAe;QACnF,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YACxF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,YAAY,EAAE,CAAC;QACrB,KAAK,CAAC,gBAAgB,IAAI,WAAW,CAAC;QACtC,KAAK,CAAC,iBAAiB,IAAI,YAAY,CAAC;QACxC,KAAK,CAAC,YAAY,IAAI,OAAO,CAAC;IAChC,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAA+B,EAAE,CAAC;QAC/C,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,kBAAkB,GAAkB,IAAI,CAAC;QAC7C,IAAI,wBAAwB,GAAG,QAAQ,CAAC;QAExC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,kBAAkB,GACtB,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC;YACpF,MAAM,yBAAyB,GAC7B,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAE/E,OAAO,CAAC,KAAK,CAAC,GAAG;gBACf,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,kBAAkB;gBAClB,yBAAyB;aAC1B,CAAC;YAEF,IAAI,KAAK,CAAC,YAAY,GAAG,WAAW,EAAE,CAAC;gBACrC,WAAW,GAAG,KAAK,CAAC,YAAY,CAAC;gBACjC,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;YAED,IACE,kBAAkB,KAAK,IAAI;gBAC3B,CAAC,kBAAkB,GAAG,wBAAwB;oBAC5C,CAAC,kBAAkB,KAAK,wBAAwB,IAAI,KAAK,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,CAAC,CAAC,EAC3F,CAAC;gBACD,wBAAwB,GAAG,kBAAkB,CAAC;gBAC9C,kBAAkB,GAAG,KAAK,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO;YACP,aAAa;YACb,kBAAkB;YAClB,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;SACnC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAkB;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/metrics/percentile.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Percentile calculation utilities.
+ */
+export declare function computePercentile(sorted: readonly number[], percentile: number): number | null;
+//# sourceMappingURL=percentile.d.ts.map

package/dist/metrics/percentile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.d.ts","sourceRoot":"","sources":["../../src/metrics/percentile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9F"}

package/dist/metrics/percentile.js

@@ -0,0 +1,10 @@
+/**
+ * Percentile calculation utilities.
+ */
+export function computePercentile(sorted, percentile) {
+    if (sorted.length === 0)
+        return null;
+    const index = Math.floor((sorted.length - 1) * percentile);
+    return sorted[index] ?? null;
+}
+//# sourceMappingURL=percentile.js.map

package/dist/metrics/percentile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.js","sourceRoot":"","sources":["../../src/metrics/percentile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,UAAkB;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC/B,CAAC"}

package/dist/metrics/personal-coach.d.ts

@@ -0,0 +1,47 @@
+import type { WeeklySummaryGenerator } from '../storage/weekly-summary.js';
+export interface PersonalWeekMetrics {
+    readonly weekId: string;
+    readonly totalCostUsd: number;
+    readonly avgCostPerSession: number;
+    readonly avgEfficiencyScore: number | null;
+    readonly antiPatternCount: number;
+    readonly antiPatternRate: number;
+    readonly sessionsCount: number;
+    readonly avgToolCallsPerSession: number;
+    readonly topAntiPattern: string | null;
+}
+export interface PersonalInsightsReport {
+    readonly status: 'ok';
+    readonly developer: string;
+    readonly generatedAt: number;
+    readonly weeksAnalyzed: number;
+    readonly highlights: readonly string[];
+    readonly regressions: readonly string[];
+    readonly streaks: readonly string[];
+    readonly topRecommendation: string;
+    readonly thisWeek: PersonalWeekMetrics;
+    readonly lastWeek: PersonalWeekMetrics | null;
+    readonly baseline: PersonalWeekMetrics;
+}
+export interface PersonalInsightsInsufficientData {
+    readonly status: 'insufficient_data';
+    readonly developer: string;
+    readonly weeksAvailable: number;
+    readonly weeksRequired: number;
+    readonly message: string;
+}
+export type PersonalInsightsResult = PersonalInsightsReport | PersonalInsightsInsufficientData;
+export declare class PersonalCoach {
+    private readonly summaryGenerator;
+    private readonly developer;
+    constructor(summaryGenerator: WeeklySummaryGenerator, developer: string);
+    generate(): PersonalInsightsResult;
+    private loadDeveloperWeeks;
+    private toPersonalWeekMetrics;
+    private computeBaseline;
+    private buildHighlights;
+    private buildRegressions;
+    private buildStreaks;
+    private buildTopRecommendation;
+}
+//# sourceMappingURL=personal-coach.d.ts.map

package/dist/metrics/personal-coach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal-coach.d.ts","sourceRoot":"","sources":["../../src/metrics/personal-coach.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAS3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,GAAG,gCAAgC,CAAC;AAS/F,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,gBAAgB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM;IAKvE,QAAQ,IAAI,sBAAsB;IAqDlC,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,qBAAqB;IAgC7B,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,sBAAsB;CAgC/B"}