@newrelic/preflight 0.0.1-pre.1 → 1.0.0

package/dist/metrics/context-window-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/context-window-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAA6B;IAEnD,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAQ5C,UAAU,IAAI,oBAAoB;IAuBlC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/dist/metrics/context-window-tracker.js

@@ -0,0 +1,35 @@
+export class ContextWindowTracker {
+    fileReadCounts = new Map();
+    recordToolCall(record) {
+        if (record.toolName !== 'Read')
+            return;
+        const filePath = record.filePath;
+        if (!filePath)
+            return;
+        const count = this.fileReadCounts.get(filePath) ?? 0;
+        this.fileReadCounts.set(filePath, count + 1);
+    }
+    getMetrics() {
+        const entries = [...this.fileReadCounts.entries()];
+        const totalReadOperations = entries.reduce((sum, [, c]) => sum + c, 0);
+        const uniqueFilesRead = entries.length;
+        const repeatedReadCount = entries.reduce((sum, [, c]) => sum + Math.max(0, c - 1), 0);
+        const repeatedReadRatio = totalReadOperations > 0 ? repeatedReadCount / totalReadOperations : null;
+        const topRepeatedFiles = entries
+            .filter(([, c]) => c > 1)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([file, readCount]) => ({ file, readCount }));
+        return {
+            uniqueFilesRead,
+            totalReadOperations,
+            repeatedReadCount,
+            repeatedReadRatio,
+            topRepeatedFiles,
+        };
+    }
+    reset(_sessionId) {
+        this.fileReadCounts.clear();
+    }
+}
+//# sourceMappingURL=context-window-tracker.js.map

package/dist/metrics/context-window-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window-tracker.js","sourceRoot":"","sources":["../../src/metrics/context-window-tracker.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,oBAAoB;IACvB,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,cAAc,CAAC,MAAsB;QACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA8B,CAAC;QACvD,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;QACvC,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,MAAM,iBAAiB,GACrB,mBAAmB,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3E,MAAM,gBAAgB,GAAG,OAAO;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAErD,OAAO;YACL,eAAe;YACf,mBAAmB;YACnB,iBAAiB;YACjB,iBAAiB;YACjB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAkB;QACtB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/metrics/cost-forecast.d.ts

@@ -0,0 +1,36 @@
+export interface CostForecast {
+    readonly elapsedMs: number;
+    readonly spentUsd: number;
+    readonly rateUsdPerMs: number;
+    readonly forecastEndOfDayUsd: number | null;
+    readonly forecastEndOfWeekUsd: number | null;
+    readonly forecastSessionEndUsd: number | null;
+    readonly confidenceNote: string;
+}
+export interface CostForecastInputs {
+    /** Total spend during the live session, used for the session-end forecast. */
+    readonly sessionSpentUsd: number;
+    /** Wall-clock start of the current session. */
+    readonly sessionStartMs: number;
+    /**
+     * Optional daily anchor — when provided, the EoD forecast uses today's
+     * burn rate (`dailySpentUsd / (now - dailyFirstActivityMs)`) instead of
+     * the session-wide rate. This avoids two cross-midnight bugs:
+     *   1) Inflated EoD baseline (yesterday's portion of a still-running
+     *      session counted as "today's spend so far").
+     *   2) Diluted burn rate (multi-day session averages busy hours with
+     *      overnight idle hours, dragging the rate down).
+     * When omitted, falls back to the session rate over `msUntilEndOfDay`,
+     * which only matches reality when the session started today.
+     */
+    readonly dailySpentUsd?: number;
+    readonly dailyFirstActivityMs?: number | null;
+}
+/**
+ * Backward-compatible legacy entrypoint. Prefer `buildCostForecastFromInputs`
+ * so the EoD forecast can be anchored to today's spend rather than the full
+ * session.
+ */
+export declare function buildCostForecast(spentUsd: number, sessionStartMs: number, nowMs?: number): CostForecast;
+export declare function buildCostForecastFromInputs(inputs: CostForecastInputs, nowMs?: number): CostForecast;
+//# sourceMappingURL=cost-forecast.d.ts.map

package/dist/metrics/cost-forecast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-forecast.d.ts","sourceRoot":"","sources":["../../src/metrics/cost-forecast.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAmB,GACzB,YAAY,CAEd;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,GAAE,MAAmB,GACzB,YAAY,CA0Fd"}

package/dist/metrics/cost-forecast.js

@@ -0,0 +1,91 @@
+import { localStartOfDay } from '../lib/date.js';
+/**
+ * Backward-compatible legacy entrypoint. Prefer `buildCostForecastFromInputs`
+ * so the EoD forecast can be anchored to today's spend rather than the full
+ * session.
+ */
+export function buildCostForecast(spentUsd, sessionStartMs, nowMs = Date.now()) {
+    return buildCostForecastFromInputs({ sessionSpentUsd: spentUsd, sessionStartMs }, nowMs);
+}
+export function buildCostForecastFromInputs(inputs, nowMs = Date.now()) {
+    const { sessionSpentUsd, sessionStartMs, dailySpentUsd, dailyFirstActivityMs } = inputs;
+    const elapsedMs = nowMs - sessionStartMs;
+    if (elapsedMs < 1) {
+        return {
+            elapsedMs: 0,
+            spentUsd: 0,
+            rateUsdPerMs: 0,
+            forecastEndOfDayUsd: null,
+            forecastEndOfWeekUsd: null,
+            forecastSessionEndUsd: null,
+            confidenceNote: 'Insufficient data for forecast.',
+        };
+    }
+    // Session running but nothing spent yet — return zero forecasts so callers
+    // display $0.00 instead of "—".
+    if (sessionSpentUsd === 0) {
+        return {
+            elapsedMs,
+            spentUsd: 0,
+            rateUsdPerMs: 0,
+            forecastEndOfDayUsd: 0,
+            forecastEndOfWeekUsd: 0,
+            forecastSessionEndUsd: 0,
+            confidenceNote: 'Session running — no spend recorded yet.',
+        };
+    }
+    const sessionRateUsdPerMs = sessionSpentUsd / elapsedMs;
+    // End-of-day boundary in **local** time, matching the rest of the dashboard
+    // (lib/date.ts localStartOfDay). Previously this used UTC, which drifted
+    // a forecast across the day boundary for non-UTC users.
+    const dayStartMs = localStartOfDay(nowMs);
+    const dayEndMs = dayStartMs + 86_400_000;
+    const msUntilEndOfDay = Math.max(0, dayEndMs - nowMs);
+    // Daily-anchored EoD/EoW forecast when caller supplies today's spend +
+    // first-activity-of-day. Both the day and week projections use the same
+    // effective rate and base so they are internally consistent: the week
+    // forecast is simply the day forecast extended to the full remaining week.
+    // Falls back to session rate/base when the daily anchor is absent.
+    let effectiveRateUsdPerMs;
+    let effectiveBaseUsd;
+    if (typeof dailySpentUsd === 'number' &&
+        dailySpentUsd >= 0 &&
+        typeof dailyFirstActivityMs === 'number' &&
+        dailyFirstActivityMs > 0) {
+        const dailyElapsedMs = Math.max(1, nowMs - dailyFirstActivityMs);
+        effectiveRateUsdPerMs = dailySpentUsd / dailyElapsedMs;
+        effectiveBaseUsd = dailySpentUsd;
+    }
+    else {
+        effectiveRateUsdPerMs = sessionRateUsdPerMs;
+        effectiveBaseUsd = sessionSpentUsd;
+    }
+    const forecastEndOfDayUsd = effectiveBaseUsd + effectiveRateUsdPerMs * msUntilEndOfDay;
+    // ISO week ends on Sunday. Convert local getDay() (0=Sun…6=Sat) to ISO day (1=Mon…7=Sun)
+    // then compute remaining days: Sunday → 0 remaining, Monday → 6, …, Saturday → 1.
+    // Use getDay() (local) not getUTCDay() — the week boundary must match the local EoD boundary.
+    const now = new Date(nowMs);
+    const dayOfWeek = now.getDay();
+    const isoDay = dayOfWeek === 0 ? 7 : dayOfWeek;
+    const msUntilEndOfWeek = ((7 - isoDay) % 7) * 86_400_000 + msUntilEndOfDay;
+    const forecastEndOfWeekUsd = effectiveBaseUsd + effectiveRateUsdPerMs * msUntilEndOfWeek;
+    const SESSION_TARGET_MS = 8 * 60 * 60 * 1000;
+    const msUntilSessionEnd = Math.max(0, SESSION_TARGET_MS - elapsedMs);
+    const forecastSessionEndUsd = sessionSpentUsd + sessionRateUsdPerMs * msUntilSessionEnd;
+    const elapsedMinutes = elapsedMs / 60_000;
+    const confidenceNote = elapsedMinutes < 10
+        ? 'Low confidence — less than 10 minutes of data.'
+        : elapsedMinutes < 30
+            ? 'Moderate confidence — based on less than 30 minutes of data.'
+            : 'Reasonable confidence — based on 30+ minutes of data.';
+    return {
+        elapsedMs,
+        spentUsd: sessionSpentUsd,
+        rateUsdPerMs: sessionRateUsdPerMs,
+        forecastEndOfDayUsd,
+        forecastEndOfWeekUsd,
+        forecastSessionEndUsd,
+        confidenceNote,
+    };
+}
+//# sourceMappingURL=cost-forecast.js.map

package/dist/metrics/cost-forecast.js.map

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

package/dist/metrics/cost-per-outcome.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Cost-Per-Outcome Analysis — classifies AI coding tasks by outcome type,
+ * computes cost attribution per outcome category, and estimates ROI.
+ *
+ * Outcome types:
+ *   - bug_fix: test failed → edit → test passed
+ *   - feature: new files created via Write
+ *   - refactor: existing files modified, no test regressions
+ *   - investigation: mostly Read/Grep/Glob calls
+ *   - configuration: only config file edits (.json, .yaml, etc.)
+ *   - documentation: only .md file edits
+ *   - failed_attempt: tests failed and never recovered
+ */
+import type { MetricAggregator } from '../shared/index.js';
+import type { AiCodingTask } from './task-detector.js';
+export type OutcomeType = 'bug_fix' | 'feature' | 'refactor' | 'investigation' | 'configuration' | 'documentation' | 'failed_attempt';
+export interface OutcomeDistribution {
+    [outcome: string]: {
+        count: number;
+        totalCost: number;
+        avgCost: number;
+    };
+}
+export interface CostAttribution {
+    readonly outcomeDistribution: OutcomeDistribution;
+    readonly costPerBugFix: number;
+    readonly costPerFeature: number;
+    readonly costPerRefactor: number;
+    readonly costPerInvestigation: number;
+    readonly costPerConfiguration: number;
+    readonly costPerDocumentation: number;
+    readonly costPerFailedAttempt: number;
+    readonly wasteRatio: number;
+    readonly totalCost: number;
+    readonly totalTasks: number;
+}
+export interface RoiEstimate {
+    readonly totalAiCost: number;
+    readonly estimatedHoursSaved: number;
+    readonly estimatedValueUsd: number;
+    readonly roi: number;
+    readonly byOutcome: Record<string, {
+        count: number;
+        hoursSaved: number;
+        valueUsd: number;
+    }>;
+}
+export interface TaskOutcomeEvent {
+    readonly outcome: OutcomeType;
+    readonly costUsd: number;
+    readonly toolCalls: number;
+    readonly durationMs: number;
+    readonly developer: string;
+    readonly sessionId: string;
+}
+export declare class CostPerOutcomeAnalyzer {
+    private readonly hoursSaved;
+    constructor(options?: {
+        hoursSaved?: Partial<Record<OutcomeType, number>>;
+    });
+    /**
+     * Classify a task by its outcome type using a priority-based rule set
+     * that inspects the tool call sequence.
+     */
+    classifyOutcome(task: AiCodingTask): OutcomeType;
+    /**
+     * Attribute costs across tasks by outcome category.
+     */
+    attributeCosts(tasks: AiCodingTask[]): CostAttribution;
+    /**
+     * Estimate ROI by multiplying task counts by hours-saved estimates
+     * and the developer's hourly cost.
+     */
+    estimateROI(attribution: CostAttribution, developerHourlyCost: number): RoiEstimate;
+    /**
+     * Emit outcome metrics to New Relic.
+     */
+    emitMetrics(aggregator: MetricAggregator, tasks: AiCodingTask[], developer: string): void;
+}
+/**
+ * Subset of FullSessionSummary fields needed to bucket a stored session into
+ * an outcome category. Used by the History view so we can render a
+ * cost-per-outcome breakdown across persisted sessions without retaining the
+ * raw per-task tool-call sequence on disk.
+ *
+ * The heuristic mirrors classifyOutcome's priority order but uses session
+ * aggregates: it cannot detect intra-session "test fail → edit → test pass"
+ * flow precisely, so a passing test with edits is treated as bug_fix.
+ */
+export interface SessionOutcomeInputs {
+    readonly testRunCount: number;
+    readonly testPassCount: number;
+    readonly filesModified: readonly string[];
+    readonly toolBreakdown: Record<string, number>;
+    readonly toolCallCount: number;
+}
+export declare function classifySessionOutcome(s: SessionOutcomeInputs): OutcomeType;
+export interface SessionLikeForCostOutcome extends SessionOutcomeInputs {
+    readonly estimatedCostUsd: number | null;
+}
+export declare function attributeSessionCosts(sessions: readonly SessionLikeForCostOutcome[]): CostAttribution;
+//# sourceMappingURL=cost-per-outcome.d.ts.map

package/dist/metrics/cost-per-outcome.d.ts.map

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

package/dist/metrics/cost-per-outcome.js

@@ -0,0 +1,266 @@
+/**
+ * Cost-Per-Outcome Analysis — classifies AI coding tasks by outcome type,
+ * computes cost attribution per outcome category, and estimates ROI.
+ *
+ * Outcome types:
+ *   - bug_fix: test failed → edit → test passed
+ *   - feature: new files created via Write
+ *   - refactor: existing files modified, no test regressions
+ *   - investigation: mostly Read/Grep/Glob calls
+ *   - configuration: only config file edits (.json, .yaml, etc.)
+ *   - documentation: only .md file edits
+ *   - failed_attempt: tests failed and never recovered
+ */
+import { createLogger } from '../shared/index.js';
+const logger = createLogger('cost-per-outcome');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_HOURS_SAVED = {
+    bug_fix: 2,
+    feature: 4,
+    refactor: 1.5,
+    investigation: 0.5,
+    configuration: 0.5,
+    documentation: 1,
+    failed_attempt: 0,
+};
+const CONFIG_EXTENSIONS = /\.(json|yaml|yml|toml|env|ini)$/i;
+const DOC_EXTENSIONS = /\.md$/i;
+const READ_TOOLS = new Set(['Read', 'Grep', 'Glob']);
+// ---------------------------------------------------------------------------
+// CostPerOutcomeAnalyzer
+// ---------------------------------------------------------------------------
+export class CostPerOutcomeAnalyzer {
+    hoursSaved;
+    constructor(options) {
+        this.hoursSaved = { ...DEFAULT_HOURS_SAVED, ...options?.hoursSaved };
+    }
+    /**
+     * Classify a task by its outcome type using a priority-based rule set
+     * that inspects the tool call sequence.
+     */
+    classifyOutcome(task) {
+        const toolCalls = task.toolCalls;
+        let hasTestFailure = false;
+        let hasTestPassAfterEdit = false;
+        let hasWriteNewFile = false;
+        let sawEditAfterFailure = false;
+        for (const tc of toolCalls) {
+            const rec = tc;
+            if (rec.isTestCommand === true) {
+                if (tc.success === false) {
+                    hasTestFailure = true;
+                }
+                else if (tc.success === true && hasTestFailure && sawEditAfterFailure) {
+                    hasTestPassAfterEdit = true;
+                }
+            }
+            if ((tc.toolName === 'Edit' || tc.toolName === 'Write') && hasTestFailure) {
+                sawEditAfterFailure = true;
+            }
+            if (tc.toolName === 'Write') {
+                hasWriteNewFile = true;
+            }
+        }
+        // Priority 1: failed_attempt — tests failed and never recovered.
+        // Exclude tasks that also created new files; those are better classified
+        // as feature/refactor attempts that happen to have failing tests.
+        if (hasTestFailure && !hasTestPassAfterEdit && !hasWriteNewFile) {
+            return 'failed_attempt';
+        }
+        // Priority 2: bug_fix — test fail → edit → test pass
+        if (hasTestFailure && hasTestPassAfterEdit) {
+            return 'bug_fix';
+        }
+        // Priority 3: feature — new files created
+        if (hasWriteNewFile) {
+            return 'feature';
+        }
+        // Priority 4: configuration — only config files modified
+        const modifiedFiles = task.filesModified;
+        if (modifiedFiles.length > 0 && modifiedFiles.every((f) => CONFIG_EXTENSIONS.test(f))) {
+            return 'configuration';
+        }
+        // Priority 5: documentation — only .md files modified
+        if (modifiedFiles.length > 0 && modifiedFiles.every((f) => DOC_EXTENSIONS.test(f))) {
+            return 'documentation';
+        }
+        // Priority 6: refactor — files modified, no test regressions
+        if (modifiedFiles.length > 0) {
+            return 'refactor';
+        }
+        // Priority 7: investigation — mostly read/search tools
+        if (task.toolCallCount > 0) {
+            const readCount = toolCalls.filter((tc) => READ_TOOLS.has(tc.toolName)).length;
+            if (readCount / task.toolCallCount >= 0.8) {
+                return 'investigation';
+            }
+        }
+        // Default
+        return 'feature';
+    }
+    /**
+     * Attribute costs across tasks by outcome category.
+     */
+    attributeCosts(tasks) {
+        const distribution = {};
+        let totalCost = 0;
+        for (const task of tasks) {
+            const outcome = this.classifyOutcome(task);
+            const cost = task.estimatedCostUsd ?? 0;
+            totalCost += cost;
+            if (!distribution[outcome]) {
+                distribution[outcome] = { count: 0, totalCost: 0, avgCost: 0 };
+            }
+            distribution[outcome].count++;
+            distribution[outcome].totalCost += cost;
+        }
+        // Compute averages
+        for (const entry of Object.values(distribution)) {
+            entry.avgCost = entry.count > 0 ? round(entry.totalCost / entry.count, 4) : 0;
+            entry.totalCost = round(entry.totalCost, 4);
+        }
+        const avgCostFor = (outcome) => distribution[outcome]?.avgCost ?? 0;
+        const failedCost = distribution['failed_attempt']?.totalCost ?? 0;
+        const wasteRatio = totalCost > 0 ? round(failedCost / totalCost, 4) : 0;
+        return {
+            outcomeDistribution: distribution,
+            costPerBugFix: avgCostFor('bug_fix'),
+            costPerFeature: avgCostFor('feature'),
+            costPerRefactor: avgCostFor('refactor'),
+            costPerInvestigation: avgCostFor('investigation'),
+            costPerConfiguration: avgCostFor('configuration'),
+            costPerDocumentation: avgCostFor('documentation'),
+            costPerFailedAttempt: avgCostFor('failed_attempt'),
+            wasteRatio,
+            totalCost: round(totalCost, 4),
+            totalTasks: tasks.length,
+        };
+    }
+    /**
+     * Estimate ROI by multiplying task counts by hours-saved estimates
+     * and the developer's hourly cost.
+     */
+    estimateROI(attribution, developerHourlyCost) {
+        let totalHoursSaved = 0;
+        let totalValue = 0;
+        const byOutcome = {};
+        for (const [outcome, entry] of Object.entries(attribution.outcomeDistribution)) {
+            const hours = (this.hoursSaved[outcome] ?? 0) * entry.count;
+            const value = hours * developerHourlyCost;
+            totalHoursSaved += hours;
+            totalValue += value;
+            byOutcome[outcome] = {
+                count: entry.count,
+                hoursSaved: round(hours, 2),
+                valueUsd: round(value, 2),
+            };
+        }
+        const roi = round(totalValue - attribution.totalCost, 2);
+        return {
+            totalAiCost: attribution.totalCost,
+            estimatedHoursSaved: round(totalHoursSaved, 2),
+            estimatedValueUsd: round(totalValue, 2),
+            roi,
+            byOutcome,
+        };
+    }
+    /**
+     * Emit outcome metrics to New Relic.
+     */
+    emitMetrics(aggregator, tasks, developer) {
+        const attribution = this.attributeCosts(tasks);
+        // Per-task outcome events
+        for (const task of tasks) {
+            const outcome = this.classifyOutcome(task);
+            aggregator.record('ai.task.outcome', 1, {
+                developer,
+                outcome,
+                costUsd: task.estimatedCostUsd ?? 0,
+                toolCalls: task.toolCallCount,
+            });
+        }
+        // Per-category cost summaries
+        for (const [outcome, entry] of Object.entries(attribution.outcomeDistribution)) {
+            aggregator.record('ai.cost_per_outcome', entry.avgCost, {
+                developer,
+                outcome,
+                count: entry.count,
+                totalCost: entry.totalCost,
+            });
+        }
+        logger.debug('Cost-per-outcome metrics emitted', {
+            developer,
+            taskCount: tasks.length,
+            categories: Object.keys(attribution.outcomeDistribution).length,
+        });
+    }
+}
+export function classifySessionOutcome(s) {
+    if (s.testRunCount > 0 && s.testPassCount === 0)
+        return 'failed_attempt';
+    if (s.testRunCount > 0 && s.testPassCount > 0 && s.filesModified.length > 0)
+        return 'bug_fix';
+    const writeCount = s.toolBreakdown['Write'] ?? 0;
+    if (writeCount >= 1 && s.filesModified.length > 0)
+        return 'feature';
+    if (s.filesModified.length > 0 && s.filesModified.every((f) => CONFIG_EXTENSIONS.test(f))) {
+        return 'configuration';
+    }
+    if (s.filesModified.length > 0 && s.filesModified.every((f) => DOC_EXTENSIONS.test(f))) {
+        return 'documentation';
+    }
+    if (s.filesModified.length > 0)
+        return 'refactor';
+    if (s.toolCallCount > 0) {
+        const readCount = (s.toolBreakdown['Read'] ?? 0) +
+            (s.toolBreakdown['Grep'] ?? 0) +
+            (s.toolBreakdown['Glob'] ?? 0);
+        if (readCount / s.toolCallCount >= 0.8)
+            return 'investigation';
+    }
+    return 'feature';
+}
+export function attributeSessionCosts(sessions) {
+    const distribution = {};
+    let totalCost = 0;
+    for (const s of sessions) {
+        const outcome = classifySessionOutcome(s);
+        const cost = s.estimatedCostUsd ?? 0;
+        totalCost += cost;
+        if (!distribution[outcome]) {
+            distribution[outcome] = { count: 0, totalCost: 0, avgCost: 0 };
+        }
+        distribution[outcome].count++;
+        distribution[outcome].totalCost += cost;
+    }
+    for (const entry of Object.values(distribution)) {
+        entry.avgCost = entry.count > 0 ? round(entry.totalCost / entry.count, 4) : 0;
+        entry.totalCost = round(entry.totalCost, 4);
+    }
+    const avgCostFor = (outcome) => distribution[outcome]?.avgCost ?? 0;
+    const failedCost = distribution['failed_attempt']?.totalCost ?? 0;
+    const wasteRatio = totalCost > 0 ? round(failedCost / totalCost, 4) : 0;
+    return {
+        outcomeDistribution: distribution,
+        costPerBugFix: avgCostFor('bug_fix'),
+        costPerFeature: avgCostFor('feature'),
+        costPerRefactor: avgCostFor('refactor'),
+        costPerInvestigation: avgCostFor('investigation'),
+        costPerConfiguration: avgCostFor('configuration'),
+        costPerDocumentation: avgCostFor('documentation'),
+        costPerFailedAttempt: avgCostFor('failed_attempt'),
+        wasteRatio,
+        totalCost: round(totalCost, 4),
+        totalTasks: sessions.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function round(value, decimals) {
+    const factor = Math.pow(10, decimals);
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=cost-per-outcome.js.map

package/dist/metrics/cost-per-outcome.js.map

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

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

@@ -0,0 +1,78 @@
+/**
+ * Cost Tracking — maintains running token counts and cost calculations.
+ *
+ * Two paths feed into the tracker:
+ *   1. Self-reporting via the `nr_observe_report_tokens` MCP tool (primary)
+ *   2. Estimation from hook input/output byte sizes (fallback)
+ *
+ * Cost calculation delegates to `calculateCost()` from the shared package.
+ */
+import type { TokenUsage, CostBreakdown, MetricAggregator } from '../shared/index.js';
+import type { SessionTracker } from './session-tracker.js';
+export interface CostMetrics {
+    sessionTotalCostUsd: number | null;
+    costByTask: null;
+    costByModel: Record<string, number>;
+    costPerLineOfCode: number | null;
+    costPerFileModified: number | null;
+    model: string | null;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalThinkingTokens: number;
+    totalCacheReadTokens: number;
+    totalCacheCreationTokens: number;
+    reportCount: number;
+    estimationCount: number;
+    latestCostBreakdown: CostBreakdown | null;
+}
+export declare class CostTracker {
+    private sessionTracker;
+    private totalCostUsd;
+    private totalInputTokens;
+    private totalOutputTokens;
+    private totalThinkingTokens;
+    private totalCacheReadTokens;
+    private totalCacheCreationTokens;
+    private currentModel;
+    private reportCount;
+    private estimationCount;
+    private latestCostBreakdown;
+    private costByModel;
+    private costByDayUsd;
+    private firstActivityMsByDay;
+    private totalLinesChanged;
+    constructor(sessionTracker?: SessionTracker);
+    /**
+     * Primary path: record exact token usage from self-reporting.
+     */
+    recordTokenUsage(usage: TokenUsage, model: string): CostBreakdown;
+    /**
+     * Fallback path: estimate tokens from character counts.
+     * Uses the heuristic: tokens ≈ characters / 4.
+     */
+    recordEstimatedTokens(inputChars: number, outputChars: number, model: string): CostBreakdown;
+    private accumulateTokens;
+    /**
+     * Cost spent during a specific local-time day, attributed at the moment
+     * each token event was recorded. Used to fix the cross-midnight inflation
+     * of "Today Spend" — when a session that started yesterday continues into
+     * today, this returns only today's portion.
+     */
+    getCostForDay(dayKey: string): number;
+    /**
+     * Epoch ms of the first token event recorded today (local time), or null
+     * if no spend has been booked today. The forecast burn-rate denominator
+     * should be (now - firstActivityToday), not (now - sessionStart) — the
+     * latter dilutes the rate with idle hours from previous days when a
+     * session spans midnight.
+     */
+    getFirstActivityMsForDay(dayKey: string): number | null;
+    /**
+     * Record lines of code changed (from Edit/Write tool data).
+     */
+    recordLinesChanged(lines: number): void;
+    getMetrics(): CostMetrics;
+    emitMetrics(aggregator: MetricAggregator): void;
+    reset(): void;
+}
+//# sourceMappingURL=cost-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,aAAa,GAAG,IAAI,CAAC;CAC3C;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,WAAW,CAA6B;IAMhD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,iBAAiB,CAAK;gBAElB,cAAc,CAAC,EAAE,cAAc;IAI3C;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAKjE;;;OAGG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAgB5F,OAAO,CAAC,gBAAgB;IAuBxB;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;;OAMG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvC,UAAU,IAAI,WAAW;IA2BzB,WAAW,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAmC/C,KAAK,IAAI,IAAI;CAgBd"}