@planu/cli 0.68.0 → 0.70.0

package/dist/engine/token-optimizer/analytics.js

@@ -0,0 +1,362 @@
+// Cost Analytics Engine (SPEC-182)
+// Aggregations, trends, anomaly detection, and projections from token ledger data
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const TREND_WINDOW_DAYS = 7;
+const TREND_STABLE_THRESHOLD = 10; // percent
+const SPIKE_MULTIPLIER = 2;
+const SPIKE_CRITICAL_MULTIPLIER = 3;
+const SPIKE_WINDOW_DAYS = 14;
+const HIGH_COST_TOOL_PERCENT = 0.5;
+const DEFAULT_TOP_CONSUMERS_LIMIT = 10;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isoToDate(timestamp) {
+    return timestamp.slice(0, 10); // YYYY-MM-DD
+}
+function modeOf(values) {
+    if (values.length === 0) {
+        return '';
+    }
+    const freq = new Map();
+    for (const v of values) {
+        freq.set(v, (freq.get(v) ?? 0) + 1);
+    }
+    let topKey = '';
+    let topCount = 0;
+    for (const [k, c] of freq) {
+        if (c > topCount) {
+            topCount = c;
+            topKey = k;
+        }
+    }
+    return topKey;
+}
+function average(nums) {
+    if (nums.length === 0) {
+        return 0;
+    }
+    return nums.reduce((s, n) => s + n, 0) / nums.length;
+}
+function daysInCalendarMonth(year, month) {
+    return new Date(year, month, 0).getDate(); // month is 1-based here
+}
+// ---------------------------------------------------------------------------
+// aggregateEntries
+// ---------------------------------------------------------------------------
+function computeEstimationAccuracy(estimatedCount, actualForEstimated, estimatedSum) {
+    if (estimatedCount === 0 || actualForEstimated === 0) {
+        return { estimationAccuracy: 100, overEstimationPercent: 0 };
+    }
+    return {
+        estimationAccuracy: Math.min(100, (actualForEstimated / estimatedSum) * 100),
+        overEstimationPercent: ((estimatedSum - actualForEstimated) / actualForEstimated) * 100,
+    };
+}
+function buildEmptyAggregation() {
+    return {
+        totalTokens: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCostUsd: 0,
+        totalEstimatedCostUsd: 0,
+        entryCount: 0,
+        uniqueTools: 0,
+        uniqueModels: 0,
+        uniqueSessions: 0,
+        avgTokensPerCall: 0,
+        avgCostPerCall: 0,
+        tokensByTool: {},
+        costByTool: {},
+        tokensByModel: {},
+        costByModel: {},
+        estimationAccuracy: 100,
+        overEstimationPercent: 0,
+    };
+}
+function incrementRecord(rec, key, val) {
+    return { ...rec, [key]: (rec[key] ?? 0) + val };
+}
+export function aggregateEntries(entries) {
+    if (entries.length === 0) {
+        return buildEmptyAggregation();
+    }
+    const result = entries.reduce((a, e) => {
+        const hasEst = e.estimatedTokens !== undefined;
+        return {
+            tT: a.tT + e.totalTokens,
+            tI: a.tI + e.inputTokens,
+            tO: a.tO + e.outputTokens,
+            tC: a.tC + e.costUsd,
+            tE: a.tE + (e.estimatedCostUsd ?? 0),
+            eS: a.eS + (hasEst ? (e.estimatedTokens ?? 0) : 0),
+            aE: a.aE + (hasEst ? e.totalTokens : 0),
+            eC: a.eC + (hasEst ? 1 : 0),
+            byTool: incrementRecord(a.byTool, e.toolName, e.totalTokens),
+            cByTool: incrementRecord(a.cByTool, e.toolName, e.costUsd),
+            byModel: incrementRecord(a.byModel, e.model, e.totalTokens),
+            cByModel: incrementRecord(a.cByModel, e.model, e.costUsd),
+            tools: new Set([...a.tools, e.toolName]),
+            models: new Set([...a.models, e.model]),
+            sessions: new Set([...a.sessions, e.sessionId]),
+        };
+    }, {
+        tT: 0,
+        tI: 0,
+        tO: 0,
+        tC: 0,
+        tE: 0,
+        eS: 0,
+        aE: 0,
+        eC: 0,
+        byTool: {},
+        cByTool: {},
+        byModel: {},
+        cByModel: {},
+        tools: new Set(),
+        models: new Set(),
+        sessions: new Set(),
+    });
+    const { estimationAccuracy, overEstimationPercent } = computeEstimationAccuracy(result.eC, result.aE, result.eS);
+    const count = entries.length;
+    return {
+        totalTokens: result.tT,
+        totalInputTokens: result.tI,
+        totalOutputTokens: result.tO,
+        totalCostUsd: result.tC,
+        totalEstimatedCostUsd: result.tE,
+        entryCount: count,
+        uniqueTools: result.tools.size,
+        uniqueModels: result.models.size,
+        uniqueSessions: result.sessions.size,
+        avgTokensPerCall: result.tT / count,
+        avgCostPerCall: result.tC / count,
+        tokensByTool: result.byTool,
+        costByTool: result.cByTool,
+        tokensByModel: result.byModel,
+        costByModel: result.cByModel,
+        estimationAccuracy,
+        overEstimationPercent,
+    };
+}
+// ---------------------------------------------------------------------------
+// computeDailyBreakdown
+// ---------------------------------------------------------------------------
+export function computeDailyBreakdown(entries) {
+    const byDate = new Map();
+    for (const e of entries) {
+        const date = isoToDate(e.timestamp);
+        const existing = byDate.get(date) ?? { tokens: 0, cost: 0, tools: [], models: [], count: 0 };
+        existing.tokens += e.totalTokens;
+        existing.cost += e.costUsd;
+        existing.tools.push(e.toolName);
+        existing.models.push(e.model);
+        existing.count += 1;
+        byDate.set(date, existing);
+    }
+    return Array.from(byDate.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([date, data]) => ({
+        date,
+        totalTokens: data.tokens,
+        totalCostUsd: data.cost,
+        callCount: data.count,
+        topTool: modeOf(data.tools),
+        topModel: modeOf(data.models),
+    }));
+}
+// ---------------------------------------------------------------------------
+// detectTrend
+// ---------------------------------------------------------------------------
+export function detectTrend(dailyBreakdown) {
+    if (dailyBreakdown.length < TREND_WINDOW_DAYS * 2) {
+        return {
+            direction: 'stable',
+            changePercent: 0,
+            description: 'Insufficient data to determine trend (need 14+ days).',
+        };
+    }
+    const sorted = [...dailyBreakdown].sort((a, b) => a.date.localeCompare(b.date));
+    const last14 = sorted.slice(-14);
+    const prev7 = last14.slice(0, 7).map((d) => d.totalTokens);
+    const curr7 = last14.slice(7).map((d) => d.totalTokens);
+    const prevAvg = average(prev7);
+    const currAvg = average(curr7);
+    if (prevAvg === 0) {
+        return { direction: 'stable', changePercent: 0, description: 'No previous data to compare.' };
+    }
+    const changePercent = ((currAvg - prevAvg) / prevAvg) * 100;
+    let direction;
+    if (changePercent > TREND_STABLE_THRESHOLD) {
+        direction = 'increasing';
+    }
+    else if (changePercent < -TREND_STABLE_THRESHOLD) {
+        direction = 'decreasing';
+    }
+    else {
+        direction = 'stable';
+    }
+    const absPercent = Math.abs(changePercent).toFixed(0);
+    const description = direction === 'stable'
+        ? `Token usage is stable (${absPercent}% change week over week).`
+        : `Token usage is ${direction} ${absPercent}% week over week.`;
+    return { direction, changePercent: parseFloat(changePercent.toFixed(2)), description };
+}
+// ---------------------------------------------------------------------------
+// detectAnomalies
+// ---------------------------------------------------------------------------
+export function detectAnomalies(entries, dailyBreakdown) {
+    const anomalies = [];
+    if (dailyBreakdown.length === 0) {
+        return anomalies;
+    }
+    const sorted = [...dailyBreakdown].sort((a, b) => a.date.localeCompare(b.date));
+    for (let i = 0; i < sorted.length; i++) {
+        const day = sorted[i];
+        if (day === undefined) {
+            continue;
+        }
+        // --- Spike detection ---
+        const windowStart = Math.max(0, i - SPIKE_WINDOW_DAYS);
+        const windowDays = sorted.slice(windowStart, i);
+        if (windowDays.length > 0) {
+            const windowAvg = average(windowDays.map((d) => d.totalTokens));
+            if (windowAvg > 0 && day.totalTokens > windowAvg * SPIKE_MULTIPLIER) {
+                const severity = day.totalTokens > windowAvg * SPIKE_CRITICAL_MULTIPLIER ? 'critical' : 'warning';
+                anomalies.push({
+                    date: day.date,
+                    type: 'spike',
+                    severity,
+                    description: `Token spike on ${day.date}: ${day.totalTokens.toLocaleString()} tokens vs ${Math.round(windowAvg).toLocaleString()} avg.`,
+                    value: day.totalTokens,
+                    threshold: windowAvg * SPIKE_MULTIPLIER,
+                });
+            }
+        }
+        // --- High cost tool detection ---
+        const dayEntries = entries.filter((e) => isoToDate(e.timestamp) === day.date);
+        if (day.totalCostUsd > 0 && dayEntries.length > 0) {
+            const costByTool = new Map();
+            for (const e of dayEntries) {
+                costByTool.set(e.toolName, (costByTool.get(e.toolName) ?? 0) + e.costUsd);
+            }
+            for (const [tool, cost] of costByTool) {
+                const fraction = cost / day.totalCostUsd;
+                if (fraction > HIGH_COST_TOOL_PERCENT) {
+                    anomalies.push({
+                        date: day.date,
+                        type: 'high_cost_tool',
+                        severity: 'warning',
+                        description: `Tool "${tool}" consumed ${(fraction * 100).toFixed(0)}% of daily cost on ${day.date}.`,
+                        value: cost,
+                        threshold: day.totalCostUsd * HIGH_COST_TOOL_PERCENT,
+                    });
+                }
+            }
+        }
+    }
+    return anomalies;
+}
+// ---------------------------------------------------------------------------
+// computeBudgetStatus
+// ---------------------------------------------------------------------------
+export function computeBudgetStatus(entries, config) {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = now.getMonth() + 1; // 1-based
+    const daysInMonth = daysInCalendarMonth(year, month);
+    const daysElapsed = now.getDate();
+    // Current month filter
+    const monthPrefix = `${year}-${String(month).padStart(2, '0')}`;
+    const monthEntries = entries.filter((e) => e.timestamp.startsWith(monthPrefix));
+    const spentUsd = monthEntries.reduce((sum, e) => sum + e.costUsd, 0);
+    const dailyAvgUsd = daysElapsed > 0 ? spentUsd / daysElapsed : 0;
+    const projectedMonthlyUsd = dailyAvgUsd * daysInMonth;
+    const limit = config.monthlyLimitUsd ?? null;
+    const remainingUsd = limit !== null ? Math.max(0, limit - spentUsd) : null;
+    const percentUsed = limit !== null && limit > 0 ? (spentUsd / limit) * 100 : null;
+    const warningFraction = config.warningThresholdPercent / 100;
+    const criticalFraction = config.criticalThresholdPercent / 100;
+    const isWarning = limit !== null && percentUsed !== null && percentUsed / 100 >= warningFraction;
+    const isCritical = limit !== null && percentUsed !== null && percentUsed / 100 >= criticalFraction;
+    const isOverBudget = limit !== null && spentUsd > limit;
+    // Projected exhaustion day
+    let projectedExhaustionDay = null;
+    if (limit !== null && dailyAvgUsd > 0 && projectedMonthlyUsd > limit) {
+        const daysUntilExhaustion = limit / dailyAvgUsd;
+        projectedExhaustionDay = Math.min(daysInMonth, Math.ceil(daysUntilExhaustion));
+    }
+    return {
+        monthlyLimitUsd: limit,
+        spentUsd,
+        remainingUsd,
+        percentUsed: percentUsed !== null ? parseFloat(percentUsed.toFixed(2)) : null,
+        projectedMonthlyUsd: parseFloat(projectedMonthlyUsd.toFixed(4)),
+        projectedExhaustionDay,
+        isWarning,
+        isCritical,
+        isOverBudget,
+        daysInMonth,
+        daysElapsed,
+        dailyAvgUsd: parseFloat(dailyAvgUsd.toFixed(6)),
+    };
+}
+// ---------------------------------------------------------------------------
+// getTopConsumers
+// ---------------------------------------------------------------------------
+export function getTopConsumers(entries, limit = DEFAULT_TOP_CONSUMERS_LIMIT) {
+    const totalTokens = entries.reduce((s, e) => s + e.totalTokens, 0);
+    const byTool = new Map();
+    for (const e of entries) {
+        const existing = byTool.get(e.toolName) ?? { tokens: 0, cost: 0, count: 0 };
+        existing.tokens += e.totalTokens;
+        existing.cost += e.costUsd;
+        existing.count += 1;
+        byTool.set(e.toolName, existing);
+    }
+    return Array.from(byTool.entries())
+        .map(([name, data]) => ({
+        name,
+        tokens: data.tokens,
+        costUsd: data.cost,
+        percentage: totalTokens > 0 ? parseFloat(((data.tokens / totalTokens) * 100).toFixed(2)) : 0,
+        callCount: data.count,
+    }))
+        .sort((a, b) => b.tokens - a.tokens)
+        .slice(0, limit);
+}
+// ---------------------------------------------------------------------------
+// computeOptimizationSavings
+// ---------------------------------------------------------------------------
+export function computeOptimizationSavings(entries) {
+    let tokensSavedByCache = 0;
+    let tokensSavedByOptimization = 0;
+    let totalCost = 0;
+    for (const e of entries) {
+        if (e.cached) {
+            tokensSavedByCache += e.totalTokens;
+        }
+        if (e.optimizationSavings !== undefined && e.optimizationSavings > 0) {
+            tokensSavedByOptimization += e.optimizationSavings;
+        }
+        totalCost += e.costUsd;
+    }
+    const totalTokensSaved = tokensSavedByCache + tokensSavedByOptimization;
+    // Estimate cost saved: use average cost per token across all entries
+    const totalActualTokens = entries.reduce((s, e) => s + e.totalTokens, 0);
+    const avgCostPerToken = totalActualTokens > 0 ? totalCost / totalActualTokens : 0;
+    const costSavedUsd = totalTokensSaved * avgCostPerToken;
+    // savingsPercent relative to (total consumed + what was saved)
+    const totalWithSavings = totalActualTokens + totalTokensSaved;
+    const savingsPercent = totalWithSavings > 0 ? parseFloat(((totalTokensSaved / totalWithSavings) * 100).toFixed(2)) : 0;
+    return {
+        tokensSavedByCache,
+        tokensSavedByOptimization,
+        totalTokensSaved,
+        costSavedUsd: parseFloat(costSavedUsd.toFixed(6)),
+        savingsPercent,
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/engine/token-optimizer/analytics.js.map

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

package/dist/engine/token-optimizer/index.d.ts

@@ -7,4 +7,6 @@ export { IncrementalTracker } from './incremental.js';
 export { BudgetManager } from './budget.js';
 export { OptimizationReporter } from './reporter.js';
 export { TokenOptimizer } from './optimizer.js';
+export { aggregateEntries, computeDailyBreakdown, detectTrend, detectAnomalies, computeBudgetStatus, getTopConsumers, computeOptimizationSavings, } from './analytics.js';
+export type { DailyBreakdown, TrendResult, Anomaly, TopConsumer, OptimizationSavings, } from './analytics.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/token-optimizer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/engine/token-optimizer/index.js

@@ -8,4 +8,5 @@ export { IncrementalTracker } from './incremental.js';
 export { BudgetManager } from './budget.js';
 export { OptimizationReporter } from './reporter.js';
 export { TokenOptimizer } from './optimizer.js';
+export { aggregateEntries, computeDailyBreakdown, detectTrend, detectAnomalies, computeBudgetStatus, getTopConsumers, computeOptimizationSavings, } from './analytics.js';
 //# sourceMappingURL=index.js.map

package/dist/engine/token-optimizer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/engine/token-optimizer/reconciler.d.ts

@@ -0,0 +1,22 @@
+import type { ReconciliationInput, ReconciliationResult, CalibrationData } from '../../types/index.js';
+export type { ReconciliationInput, ReconciliationResult, CalibrationData };
+/**
+ * Pure reconciliation: compares a pre-implementation estimate against actual
+ * ledger entries to produce deviation, accuracy, and calibration data.
+ */
+export declare function reconcile(input: ReconciliationInput): ReconciliationResult;
+/**
+ * Formats a ReconciliationResult as a markdown report with visual indicators.
+ */
+export declare function formatReconciliation(result: ReconciliationResult): string;
+/**
+ * Extracts calibration data points from multiple reconciliation results.
+ */
+export declare function buildCalibrationData(results: ReconciliationResult[]): CalibrationData[];
+/**
+ * Computes a weighted average calibration factor from historical data.
+ * Recent entries (second half of the array) are weighted 2x.
+ * Returns the factor to multiply future estimates by (>1 = need to increase estimates).
+ */
+export declare function suggestCalibrationFactor(calibrations: CalibrationData[]): number;
+//# sourceMappingURL=reconciler.d.ts.map

package/dist/engine/token-optimizer/reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/reconciler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,CAAC;AAsI3E;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAmC1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA4CzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,eAAe,EAAE,CAQvF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,MAAM,CAgBhF"}

package/dist/engine/token-optimizer/reconciler.js

@@ -0,0 +1,215 @@
+// Estimation Reconciler (SPEC-182)
+// Closes the loop: estimate_ai_cost prediction vs actual token usage from ledger
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const ACCURATE_THRESHOLD_PCT = 15;
+const GRADE_EXCELLENT = 90;
+const GRADE_GOOD = 75;
+const GRADE_FAIR = 50;
+const CALIBRATION_RECENT_WEIGHT = 2;
+// ---------------------------------------------------------------------------
+// Core functions
+// ---------------------------------------------------------------------------
+/**
+ * Aggregates ledger entries into actual token/cost totals.
+ */
+function aggregateEntries(entries) {
+    if (entries.length === 0) {
+        return {
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            costUsd: 0,
+            models: [],
+            callCount: 0,
+        };
+    }
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let costUsd = 0;
+    const modelSet = new Set();
+    for (const entry of entries) {
+        inputTokens += entry.inputTokens;
+        outputTokens += entry.outputTokens;
+        costUsd += entry.costUsd;
+        modelSet.add(entry.model);
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: inputTokens + outputTokens,
+        costUsd,
+        models: [...modelSet],
+        callCount: entries.length,
+    };
+}
+/**
+ * Computes deviation percent: (estimated - actual) / actual * 100.
+ * Returns 0 when actual is 0 to avoid division by zero.
+ */
+function computeDeviationPercent(estimated, actual) {
+    if (actual === 0) {
+        return 0;
+    }
+    return ((estimated - actual) / actual) * 100;
+}
+/**
+ * Converts deviation percent to accuracy: max(0, 100 - abs(deviation)).
+ */
+function deviationToAccuracy(deviationPct) {
+    return Math.max(0, 100 - Math.abs(deviationPct));
+}
+/**
+ * Maps accuracy value to a grade label.
+ */
+function gradeAccuracy(accuracy) {
+    if (accuracy >= GRADE_EXCELLENT) {
+        return 'excellent';
+    }
+    if (accuracy >= GRADE_GOOD) {
+        return 'good';
+    }
+    if (accuracy >= GRADE_FAIR) {
+        return 'fair';
+    }
+    return 'poor';
+}
+/**
+ * Maps deviation percent to a direction label.
+ */
+function computeDirection(deviationPct) {
+    if (Math.abs(deviationPct) <= ACCURATE_THRESHOLD_PCT) {
+        return 'accurate';
+    }
+    return deviationPct > 0 ? 'over' : 'under';
+}
+/**
+ * Generates a human-readable calibration suggestion from deviation info.
+ */
+function buildCalibrationSuggestion(direction, tokenDeviationPct) {
+    if (direction === 'accurate') {
+        return undefined;
+    }
+    const absPct = Math.abs(tokenDeviationPct).toFixed(1);
+    if (direction === 'over') {
+        return (`Estimates are running ${absPct}% high. ` +
+            `Consider reducing future token estimates by ~${absPct}% for specs of similar size.`);
+    }
+    return (`Estimates are running ${absPct}% low. ` +
+        `Consider increasing future token estimates by ~${absPct}% for specs of similar size.`);
+}
+// ---------------------------------------------------------------------------
+// Exported functions
+// ---------------------------------------------------------------------------
+/**
+ * Pure reconciliation: compares a pre-implementation estimate against actual
+ * ledger entries to produce deviation, accuracy, and calibration data.
+ */
+export function reconcile(input) {
+    const estimatedTotal = input.estimatedInputTokens + input.estimatedOutputTokens;
+    const actual = aggregateEntries(input.actualEntries);
+    const tokenDeviationPct = computeDeviationPercent(estimatedTotal, actual.totalTokens);
+    const costDeviationPct = computeDeviationPercent(input.estimatedCostUsd, actual.costUsd);
+    const tokenAccuracy = deviationToAccuracy(tokenDeviationPct);
+    const costAccuracy = deviationToAccuracy(costDeviationPct);
+    const direction = computeDirection(tokenDeviationPct);
+    return {
+        specId: input.specId,
+        estimated: {
+            inputTokens: input.estimatedInputTokens,
+            outputTokens: input.estimatedOutputTokens,
+            totalTokens: estimatedTotal,
+            costUsd: input.estimatedCostUsd,
+            model: input.estimatedModel,
+        },
+        actual,
+        deviation: {
+            tokenPercent: tokenDeviationPct,
+            costPercent: costDeviationPct,
+            absoluteTokenDiff: estimatedTotal - actual.totalTokens,
+            absoluteCostDiff: input.estimatedCostUsd - actual.costUsd,
+            direction,
+        },
+        accuracy: {
+            tokenAccuracy,
+            costAccuracy,
+            grade: gradeAccuracy(tokenAccuracy),
+        },
+        calibrationSuggestion: buildCalibrationSuggestion(direction, tokenDeviationPct),
+    };
+}
+/**
+ * Formats a ReconciliationResult as a markdown report with visual indicators.
+ */
+export function formatReconciliation(result) {
+    const gradeIcon = result.accuracy.grade === 'excellent'
+        ? '✅'
+        : result.accuracy.grade === 'good'
+            ? '✅'
+            : result.accuracy.grade === 'fair'
+                ? '⚠️'
+                : '❌';
+    const directionLabel = result.deviation.direction === 'accurate'
+        ? '✅ Within 15% (accurate)'
+        : result.deviation.direction === 'over'
+            ? `⚠️ Over-estimated by ${result.deviation.tokenPercent.toFixed(1)}%`
+            : `❌ Under-estimated by ${Math.abs(result.deviation.tokenPercent).toFixed(1)}%`;
+    const lines = [
+        `## Estimation Reconciliation — ${result.specId}`,
+        '',
+        '### Token Summary',
+        `| Metric | Estimated | Actual | Deviation |`,
+        `|--------|-----------|--------|-----------|`,
+        `| Input tokens | ${String(result.estimated.inputTokens)} | ${String(result.actual.inputTokens)} | — |`,
+        `| Output tokens | ${String(result.estimated.outputTokens)} | ${String(result.actual.outputTokens)} | — |`,
+        `| Total tokens | ${String(result.estimated.totalTokens)} | ${String(result.actual.totalTokens)} | ${result.deviation.tokenPercent.toFixed(1)}% |`,
+        `| Cost (USD) | $${result.estimated.costUsd.toFixed(6)} | $${result.actual.costUsd.toFixed(6)} | ${result.deviation.costPercent.toFixed(1)}% |`,
+        '',
+        '### Accuracy',
+        `${gradeIcon} Grade: **${result.accuracy.grade.toUpperCase()}**`,
+        `- Token accuracy: ${result.accuracy.tokenAccuracy.toFixed(1)}%`,
+        `- Cost accuracy: ${result.accuracy.costAccuracy.toFixed(1)}%`,
+        `- Direction: ${directionLabel}`,
+        '',
+        '### Actual Usage Details',
+        `- API calls: ${String(result.actual.callCount)}`,
+        `- Models used: ${result.actual.models.join(', ') || '—'}`,
+    ];
+    if (result.calibrationSuggestion) {
+        lines.push('', '### Calibration Suggestion', result.calibrationSuggestion);
+    }
+    return lines.join('\n');
+}
+/**
+ * Extracts calibration data points from multiple reconciliation results.
+ */
+export function buildCalibrationData(results) {
+    return results.map((r) => ({
+        specId: r.specId,
+        timestamp: new Date().toISOString(),
+        estimatedTokens: r.estimated.totalTokens,
+        actualTokens: r.actual.totalTokens,
+        ratio: r.estimated.totalTokens > 0 ? r.actual.totalTokens / r.estimated.totalTokens : 1,
+    }));
+}
+/**
+ * Computes a weighted average calibration factor from historical data.
+ * Recent entries (second half of the array) are weighted 2x.
+ * Returns the factor to multiply future estimates by (>1 = need to increase estimates).
+ */
+export function suggestCalibrationFactor(calibrations) {
+    if (calibrations.length === 0) {
+        return 1;
+    }
+    const midpoint = Math.floor(calibrations.length / 2);
+    let weightedSum = 0;
+    let totalWeight = 0;
+    for (let i = 0; i < calibrations.length; i++) {
+        const weight = i >= midpoint ? CALIBRATION_RECENT_WEIGHT : 1;
+        weightedSum += (calibrations[i]?.ratio ?? 1) * weight;
+        totalWeight += weight;
+    }
+    return weightedSum / totalWeight;
+}
+//# sourceMappingURL=reconciler.js.map