@cleocode/core 2026.4.7 → 2026.4.11

package/dist/metrics/common.js

@@ -0,0 +1,64 @@
+/**
+ * Shared metrics utilities - paths, timestamps, and compliance summaries.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+/** Ensure metrics directory exists, returning its path. */
+export async function ensureMetricsDir(metricsDir) {
+    const dir = metricsDir ?? join(getCleoDir(), 'metrics');
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    return dir;
+}
+/** Get compliance log path. */
+export function getCompliancePath(metricsDir) {
+    return join(metricsDir ?? join(getCleoDir(), 'metrics'), 'COMPLIANCE.jsonl');
+}
+/** Get violations log path. */
+export function getViolationsPath(metricsDir) {
+    return join(metricsDir ?? join(getCleoDir(), 'metrics'), 'PROTOCOL_VIOLATIONS.jsonl');
+}
+/** Get sessions metrics log path. */
+export function getSessionsMetricsPath(metricsDir) {
+    return join(metricsDir ?? join(getCleoDir(), 'metrics'), 'SESSIONS.jsonl');
+}
+/** Generate ISO 8601 UTC timestamp. */
+export function isoTimestamp() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/** Generate ISO 8601 date only. */
+export function isoDate() {
+    return new Date().toISOString().split('T')[0];
+}
+/** Read a JSONL file into an array of parsed objects. */
+export function readJsonlFile(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    const content = readFileSync(filePath, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => JSON.parse(line));
+}
+/** Get compliance summary from log file. */
+export function getComplianceSummaryBase(compliancePath) {
+    const path = compliancePath ?? getCompliancePath();
+    if (!existsSync(path)) {
+        return { total: 0, pass: 0, fail: 0, rate: 0 };
+    }
+    const entries = readJsonlFile(path);
+    const total = entries.length;
+    const pass = entries.filter((e) => e.compliance_pass_rate === 1).length;
+    const fail = total - pass;
+    const rate = total > 0 ? Math.round(((pass * 100) / total) * 100) / 100 : 0;
+    return { total, pass, fail, rate };
+}
+//# sourceMappingURL=common.js.map

package/dist/metrics/common.js.map

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

package/dist/metrics/enums.js

@@ -0,0 +1,78 @@
+/**
+ * Metrics enum definitions - type-safe enums for the CLEO metrics system.
+ * All values match schema definitions in schemas/metrics.schema.json.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Violation severity levels. */
+export var Severity;
+(function (Severity) {
+    Severity["Low"] = "low";
+    Severity["Medium"] = "medium";
+    Severity["High"] = "high";
+    Severity["Critical"] = "critical";
+})(Severity || (Severity = {}));
+/** Manifest integrity states. */
+export var ManifestIntegrity;
+(function (ManifestIntegrity) {
+    ManifestIntegrity["Valid"] = "valid";
+    ManifestIntegrity["Partial"] = "partial";
+    ManifestIntegrity["Invalid"] = "invalid";
+    ManifestIntegrity["Missing"] = "missing";
+})(ManifestIntegrity || (ManifestIntegrity = {}));
+/** Instruction stability levels. */
+export var InstructionStability;
+(function (InstructionStability) {
+    InstructionStability["Stable"] = "stable";
+    InstructionStability["Clarified"] = "clarified";
+    InstructionStability["Revised"] = "revised";
+    InstructionStability["Unstable"] = "unstable";
+})(InstructionStability || (InstructionStability = {}));
+/** Session degradation levels. */
+export var SessionDegradation;
+(function (SessionDegradation) {
+    SessionDegradation["None"] = "none";
+    SessionDegradation["Mild"] = "mild";
+    SessionDegradation["Moderate"] = "moderate";
+    SessionDegradation["Severe"] = "severe";
+})(SessionDegradation || (SessionDegradation = {}));
+/** Agent reliability levels. */
+export var AgentReliability;
+(function (AgentReliability) {
+    AgentReliability["High"] = "high";
+    AgentReliability["Medium"] = "medium";
+    AgentReliability["Low"] = "low";
+    AgentReliability["Unreliable"] = "unreliable";
+})(AgentReliability || (AgentReliability = {}));
+/** Metric categories. */
+export var MetricCategory;
+(function (MetricCategory) {
+    MetricCategory["Compliance"] = "compliance";
+    MetricCategory["Efficiency"] = "efficiency";
+    MetricCategory["Session"] = "session";
+    MetricCategory["Improvement"] = "improvement";
+})(MetricCategory || (MetricCategory = {}));
+/** Metric sources. */
+export var MetricSource;
+(function (MetricSource) {
+    MetricSource["Task"] = "task";
+    MetricSource["Session"] = "session";
+    MetricSource["Agent"] = "agent";
+    MetricSource["System"] = "system";
+    MetricSource["Orchestrator"] = "orchestrator";
+})(MetricSource || (MetricSource = {}));
+/** Aggregation periods. */
+export var AggregationPeriod;
+(function (AggregationPeriod) {
+    AggregationPeriod["Instant"] = "instant";
+    AggregationPeriod["Hourly"] = "hourly";
+    AggregationPeriod["Daily"] = "daily";
+    AggregationPeriod["Weekly"] = "weekly";
+    AggregationPeriod["Monthly"] = "monthly";
+})(AggregationPeriod || (AggregationPeriod = {}));
+/** Validate that a value is a member of a given enum. */
+export function isValidEnumValue(enumObj, value) {
+    return Object.values(enumObj).includes(value);
+}
+//# sourceMappingURL=enums.js.map

package/dist/metrics/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/metrics/enums.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iCAAiC;AACjC,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,uBAAW,CAAA;IACX,6BAAiB,CAAA;IACjB,yBAAa,CAAA;IACb,iCAAqB,CAAA;AACvB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED,iCAAiC;AACjC,MAAM,CAAN,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;AACrB,CAAC,EALW,iBAAiB,KAAjB,iBAAiB,QAK5B;AAED,oCAAoC;AACpC,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,+CAAuB,CAAA;IACvB,2CAAmB,CAAA;IACnB,6CAAqB,CAAA;AACvB,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AAED,kCAAkC;AAClC,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,gCAAgC;AAChC,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,iCAAa,CAAA;IACb,qCAAiB,CAAA;IACjB,+BAAW,CAAA;IACX,6CAAyB,CAAA;AAC3B,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAED,yBAAyB;AACzB,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,2CAAyB,CAAA;IACzB,qCAAmB,CAAA;IACnB,6CAA2B,CAAA;AAC7B,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAED,sBAAsB;AACtB,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,mCAAmB,CAAA;IACnB,+BAAe,CAAA;IACf,iCAAiB,CAAA;IACjB,6CAA6B,CAAA;AAC/B,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,2BAA2B;AAC3B,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,oCAAe,CAAA;IACf,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;AACrB,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAC9B,OAAU,EACV,KAAa;IAEb,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC;AAC9D,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,19 @@
+/**
+ * Metrics module - token tracking, compliance aggregation, A/B testing, OpenTelemetry.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+// A/B testing
+export { compareABTest, endABTest, getABTestResults, getABTestStats, listABTests, logABEvent, startABTest, } from './ab-test.js';
+// Metrics aggregation
+export { getComplianceTrend, getGlobalComplianceSummary, getProjectComplianceSummary, getSessionMetricsSummary, getSkillReliability, logSessionMetrics, syncMetricsToGlobal, } from './aggregation.js';
+// Common utilities
+export { ensureMetricsDir, getCompliancePath, getComplianceSummaryBase, getSessionsMetricsPath, getViolationsPath, isoDate, isoTimestamp, readJsonlFile, } from './common.js';
+// Enums
+export { AgentReliability, AggregationPeriod, InstructionStability, isValidEnumValue, ManifestIntegrity, MetricCategory, MetricSource, SessionDegradation, Severity, } from './enums.js';
+// OTel integration
+export { compareSessions, getOtelSetupCommands, getSessionTokens, getTokenStats, isOtelEnabled, parseTokenMetrics, recordSessionEnd, recordSessionStart, } from './otel-integration.js';
+// Token estimation
+export { compareManifestVsFull, endTokenSession, estimateTokens, estimateTokensFromFile, getTokenSummary, getTrackingStatus, logTokenEvent, startTokenSession, trackFileRead, trackManifestQuery, trackPromptBuild, trackSkillInjection, trackSpawnComplete, trackSpawnOutput, } from './token-estimation.js';
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc;AACd,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,QAAQ;AACR,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/metrics/model-provider-registry.js

@@ -0,0 +1,88 @@
+const MODELS_DEV_URL = 'https://models.dev/api.json';
+let modelsDevCache = null;
+function getModelPrefix(model) {
+    const value = (model ?? '').trim().toLowerCase();
+    if (!value.includes('/'))
+        return undefined;
+    const [prefix] = value.split('/');
+    return prefix || undefined;
+}
+function uniq(values) {
+    return Array.from(new Set(values));
+}
+export function resolveProviderFromModelIndex(index, model) {
+    const value = (model ?? '').trim().toLowerCase();
+    if (!value)
+        return { source: 'none' };
+    const exactMatches = [];
+    const suffixMatches = [];
+    for (const [providerId, provider] of Object.entries(index)) {
+        const models = provider.models ?? {};
+        if (models[value])
+            exactMatches.push(providerId);
+        for (const modelId of Object.keys(models)) {
+            if (!modelId.includes('/'))
+                continue;
+            const [, suffix] = modelId.split(/\/(.+)/, 2);
+            if (suffix === value) {
+                suffixMatches.push(providerId);
+            }
+        }
+    }
+    const prefix = getModelPrefix(value);
+    const exactCandidates = uniq(exactMatches);
+    if (prefix && exactCandidates.includes(prefix)) {
+        return { provider: prefix, source: 'model-prefix', candidates: exactCandidates };
+    }
+    if (exactCandidates.length === 1) {
+        return {
+            provider: exactCandidates[0],
+            source: 'models.dev-exact',
+            candidates: exactCandidates,
+        };
+    }
+    if (exactCandidates.length > 1) {
+        return { source: 'models.dev-exact', candidates: exactCandidates };
+    }
+    const suffixCandidates = uniq(suffixMatches);
+    if (suffixCandidates.length === 1) {
+        return {
+            provider: suffixCandidates[0],
+            source: 'models.dev-suffix',
+            candidates: suffixCandidates,
+        };
+    }
+    if (suffixCandidates.length > 1) {
+        return { source: 'models.dev-suffix', candidates: suffixCandidates };
+    }
+    return { source: 'none' };
+}
+async function loadModelsDevIndex() {
+    if (!modelsDevCache) {
+        modelsDevCache = fetch(MODELS_DEV_URL, {
+            signal: AbortSignal.timeout(1500),
+            headers: { accept: 'application/json' },
+        })
+            .then(async (response) => {
+            if (!response.ok)
+                return null;
+            return response.json();
+        })
+            .catch(() => null);
+    }
+    return modelsDevCache;
+}
+export async function resolveProviderFromModelRegistry(model) {
+    const prefix = getModelPrefix(model);
+    if (prefix) {
+        return { provider: prefix, source: 'model-prefix' };
+    }
+    const index = await loadModelsDevIndex();
+    if (!index)
+        return { source: 'none' };
+    return resolveProviderFromModelIndex(index, model);
+}
+export function resetModelsDevCache() {
+    modelsDevCache = null;
+}
+//# sourceMappingURL=model-provider-registry.js.map

package/dist/metrics/model-provider-registry.js.map

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

package/dist/metrics/otel-integration.js

@@ -0,0 +1,263 @@
+/**
+ * OpenTelemetry integration for Claude Code metrics.
+ *
+ * Captures real token usage data from Claude Code OTel exports.
+ * Supports setup, parsing, aggregation, and session comparison.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { appendFileSync, existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+import { isoTimestamp } from './common.js';
+function getOtelDir(cwd) {
+    return process.env.OTEL_METRICS_DIR ?? join(getCleoDir(cwd), 'metrics', 'otel');
+}
+function getTokenMetricsPath(cwd) {
+    return join(getOtelDir(cwd), 'token_metrics.jsonl');
+}
+/** Check if OTel telemetry is enabled. */
+export function isOtelEnabled() {
+    return process.env.CLAUDE_CODE_ENABLE_TELEMETRY === '1';
+}
+/** Get environment variable commands for OTel capture setup. */
+export function getOtelSetupCommands(mode = 'file', cwd) {
+    switch (mode) {
+        case 'console':
+            return [
+                'export CLAUDE_CODE_ENABLE_TELEMETRY=1',
+                'export OTEL_METRICS_EXPORTER=console',
+                'export OTEL_METRIC_EXPORT_INTERVAL=5000',
+            ].join('\n');
+        case 'file':
+            return [
+                'export CLAUDE_CODE_ENABLE_TELEMETRY=1',
+                'export OTEL_METRICS_EXPORTER=otlp',
+                'export OTEL_EXPORTER_OTLP_PROTOCOL=http/json',
+                `export OTEL_EXPORTER_OTLP_ENDPOINT=file://${getOtelDir(cwd)}/`,
+            ].join('\n');
+        case 'prometheus':
+            return [
+                'export CLAUDE_CODE_ENABLE_TELEMETRY=1',
+                'export OTEL_METRICS_EXPORTER=prometheus',
+                '# Metrics available at localhost:9464/metrics',
+            ].join('\n');
+    }
+}
+/** Find the most recent OTel metrics JSON file. */
+function findLatestMetricsFile(cwd) {
+    const otelDir = getOtelDir(cwd);
+    if (!existsSync(otelDir))
+        return null;
+    const files = readdirSync(otelDir)
+        .filter((f) => f.endsWith('.json'))
+        .map((f) => join(otelDir, f))
+        .filter((f) => {
+        try {
+            return statSync(f).isFile();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort((a, b) => statSync(b).mtimeMs - statSync(a).mtimeMs);
+    return files[0] ?? null;
+}
+/** Parse OTel token metrics from collected data. */
+export function parseTokenMetrics(inputFile, cwd) {
+    const file = inputFile ?? findLatestMetricsFile(cwd);
+    if (!file || !existsSync(file))
+        return [];
+    try {
+        const raw = JSON.parse(readFileSync(file, 'utf-8'));
+        // Standard OTel JSON format
+        if (raw.resourceMetrics) {
+            const points = [];
+            for (const rm of raw.resourceMetrics ?? []) {
+                for (const sm of rm.scopeMetrics ?? []) {
+                    for (const metric of sm.metrics ?? []) {
+                        if (metric.name !== 'claude_code.token.usage')
+                            continue;
+                        for (const dp of metric.sum?.dataPoints ?? []) {
+                            const attrs = dp.attributes ?? [];
+                            const typeAttr = attrs.find((a) => a.key === 'type');
+                            const modelAttr = attrs.find((a) => a.key === 'model');
+                            points.push({
+                                timestamp: dp.timeUnixNano,
+                                type: typeAttr?.value?.stringValue ?? 'unknown',
+                                model: modelAttr?.value?.stringValue ?? 'unknown',
+                                tokens: dp.asInt ?? Math.floor(dp.asDouble ?? 0),
+                            });
+                        }
+                    }
+                }
+            }
+            return points;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Get aggregated token counts from OTel data. */
+export function getSessionTokens(sessionId, cwd) {
+    let input = 0;
+    let output = 0;
+    let cacheRead = 0;
+    let cacheCreate = 0;
+    for (const point of parseTokenMetrics(undefined, cwd)) {
+        switch (point.type) {
+            case 'input':
+                input += point.tokens;
+                break;
+            case 'output':
+                output += point.tokens;
+                break;
+            case 'cacheRead':
+                cacheRead += point.tokens;
+                break;
+            case 'cacheCreation':
+                cacheCreate += point.tokens;
+                break;
+        }
+    }
+    return {
+        session_id: sessionId ?? null,
+        tokens: {
+            input,
+            output,
+            cache_read: cacheRead,
+            cache_creation: cacheCreate,
+            total: input + output,
+            effective: input + output - cacheRead,
+        },
+        api_requests: 0,
+        source: 'otel',
+    };
+}
+/** Record token counts at session start. */
+export async function recordSessionStart(sessionId, cwd) {
+    const otelDir = getOtelDir(cwd);
+    await mkdir(otelDir, { recursive: true });
+    const snapshot = getSessionTokens(sessionId, cwd);
+    const entry = {
+        ...snapshot,
+        timestamp: isoTimestamp(),
+        event: 'session_start',
+    };
+    const metricsPath = getTokenMetricsPath(cwd);
+    appendFileSync(metricsPath, JSON.stringify(entry) + '\n');
+    return entry;
+}
+/** Record token counts at session end. */
+export async function recordSessionEnd(sessionId, cwd) {
+    const otelDir = getOtelDir(cwd);
+    await mkdir(otelDir, { recursive: true });
+    const current = getSessionTokens(sessionId, cwd);
+    const metricsPath = getTokenMetricsPath(cwd);
+    // Find session start
+    let deltaInput = 0;
+    let deltaOutput = 0;
+    if (existsSync(metricsPath)) {
+        const lines = readFileSync(metricsPath, 'utf-8').trim().split('\n').filter(Boolean);
+        const startLine = lines
+            .reverse()
+            .find((l) => l.includes(`"session_id":"${sessionId}"`) && l.includes('session_start'));
+        if (startLine) {
+            const startData = JSON.parse(startLine);
+            deltaInput = current.tokens.input - startData.tokens.input;
+            deltaOutput = current.tokens.output - startData.tokens.output;
+        }
+    }
+    const summary = {
+        session_id: sessionId,
+        timestamp: isoTimestamp(),
+        event: 'session_end',
+        session_tokens: {
+            input: deltaInput,
+            output: deltaOutput,
+            total: deltaInput + deltaOutput,
+        },
+        cumulative: current.tokens,
+    };
+    appendFileSync(metricsPath, JSON.stringify(summary) + '\n');
+    return summary;
+}
+/** Compare token usage between two sessions. */
+export function compareSessions(sessionA, sessionB, cwd) {
+    const metricsPath = getTokenMetricsPath(cwd);
+    if (!existsSync(metricsPath)) {
+        return { error: 'One or both sessions not found' };
+    }
+    const lines = readFileSync(metricsPath, 'utf-8').trim().split('\n').filter(Boolean);
+    const findSessionEnd = (id) => {
+        const line = lines
+            .reverse()
+            .find((l) => l.includes(`"session_id":"${id}"`) && l.includes('session_end'));
+        if (!line)
+            return 0;
+        const data = JSON.parse(line);
+        return data.session_tokens?.total ?? 0;
+    };
+    const aTotal = findSessionEnd(sessionA);
+    const bTotal = findSessionEnd(sessionB);
+    if (aTotal === 0 && bTotal === 0) {
+        return { error: 'One or both sessions not found' };
+    }
+    const difference = bTotal - aTotal;
+    const savingsPercent = bTotal > 0 ? Math.floor((difference * 100) / bTotal) : 0;
+    let verdict;
+    if (savingsPercent >= 50)
+        verdict = 'Significant savings';
+    else if (savingsPercent >= 20)
+        verdict = 'Moderate savings';
+    else if (savingsPercent >= 0)
+        verdict = 'Minimal difference';
+    else
+        verdict = 'Session A used more tokens';
+    return {
+        comparison: {
+            session_a: { id: sessionA, total_tokens: aTotal },
+            session_b: { id: sessionB, total_tokens: bTotal },
+        },
+        difference,
+        savings_percent: savingsPercent,
+        winner: aTotal < bTotal ? sessionA : sessionB,
+        verdict,
+    };
+}
+/** Get statistics about token usage across sessions. */
+export function getTokenStats(cwd) {
+    const metricsPath = getTokenMetricsPath(cwd);
+    if (!existsSync(metricsPath)) {
+        return { error: 'No token metrics recorded' };
+    }
+    const lines = readFileSync(metricsPath, 'utf-8').trim().split('\n').filter(Boolean);
+    const endEvents = lines.filter((l) => l.includes('session_end'));
+    if (endEvents.length === 0) {
+        return { sessions: 0, avg_tokens: 0, min_tokens: 0, max_tokens: 0 };
+    }
+    let sum = 0;
+    let min = Infinity;
+    let max = 0;
+    for (const line of endEvents) {
+        const data = JSON.parse(line);
+        const tokens = data.session_tokens?.total ?? 0;
+        sum += tokens;
+        if (tokens < min)
+            min = tokens;
+        if (tokens > max)
+            max = tokens;
+    }
+    return {
+        sessions_tracked: endEvents.length,
+        total_tokens_all_sessions: sum,
+        avg_tokens_per_session: Math.floor(sum / endEvents.length),
+        min_tokens_session: min === Infinity ? 0 : min,
+        max_tokens_session: max,
+    };
+}
+//# sourceMappingURL=otel-integration.js.map

package/dist/metrics/otel-integration.js.map

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

package/dist/metrics/provider-detection.js

@@ -0,0 +1,103 @@
+import { basename } from 'node:path';
+import { detectProjectProviders, getProvider, resolveAlias, } from '@cleocode/caamp';
+function inferProviderFromVendor(vendor) {
+    const value = (vendor ?? '').trim().toLowerCase();
+    if (!value)
+        return undefined;
+    if (value.includes('anthropic') || value.includes('claude'))
+        return 'anthropic';
+    if (value.includes('openai') || value.includes('codex') || value.includes('chatgpt'))
+        return 'openai';
+    if (value.includes('google') || value.includes('gemini'))
+        return 'google';
+    if (value.includes('xai') || value.includes('grok'))
+        return 'xai';
+    return undefined;
+}
+function getRuntimeHints(snapshot) {
+    const argv = snapshot.argv ?? process.argv;
+    const env = snapshot.env ?? process.env;
+    const hints = new Set();
+    const bin = basename(argv[1] ?? argv[0] ?? '').replace(/\.[^.]+$/, '');
+    if (bin)
+        hints.add(bin);
+    if (env['CLAUDE_CODE_ENABLE_TELEMETRY'] || env['CLAUDE_CODE_ENTRYPOINT']) {
+        hints.add('claude-code');
+        hints.add('claude');
+    }
+    if (env['OPENCODE_AGENT'] || env['OPENCODE']) {
+        hints.add('opencode');
+    }
+    if (env['CURSOR_TRACE_ID'] || env['CURSOR_AGENT']) {
+        hints.add('cursor');
+    }
+    return Array.from(hints);
+}
+function pickDetectionByHint(detections, hints) {
+    for (const hint of hints) {
+        const resolved = resolveAlias(hint);
+        const direct = detections.find((entry) => entry.provider.id === resolved || entry.provider.id === hint);
+        if (direct)
+            return direct;
+        const byAlias = detections.find((entry) => entry.provider.aliases.includes(hint) ||
+            entry.provider.agentFlag === hint ||
+            entry.provider.toolName.toLowerCase() === hint.toLowerCase());
+        if (byAlias)
+            return byAlias;
+        const provider = getProvider(resolved);
+        if (provider) {
+            return {
+                provider,
+                installed: true,
+                methods: [],
+                projectDetected: false,
+            };
+        }
+    }
+    return null;
+}
+export function selectRuntimeProviderContext(detections, snapshot = {}) {
+    const hints = getRuntimeHints(snapshot);
+    const hinted = pickDetectionByHint(detections, hints);
+    const projectMatches = detections.filter((entry) => entry.projectDetected);
+    const installed = detections.filter((entry) => entry.installed);
+    const selected = hinted ??
+        (projectMatches.length === 1 ? projectMatches[0] : null) ??
+        (installed.length === 1 ? installed[0] : null);
+    if (!selected) {
+        return {
+            runtimeCandidates: installed.map((entry) => entry.provider.id),
+        };
+    }
+    return {
+        runtimeProviderId: selected.provider.id,
+        runtimeToolName: selected.provider.toolName,
+        runtimeVendor: selected.provider.vendor,
+        runtimeInstructionFile: selected.provider.instructFile,
+        runtimeProjectDetected: selected.projectDetected,
+        runtimeDetectionMethods: selected.methods,
+        runtimeCandidates: installed.map((entry) => entry.provider.id),
+        inferredModelProvider: inferProviderFromVendor(selected.provider.vendor),
+    };
+}
+let cachedRuntimeProvider = null;
+export function detectRuntimeProviderContext(snapshot = {}) {
+    if (!snapshot.cwd && !snapshot.argv && !snapshot.env && cachedRuntimeProvider) {
+        return cachedRuntimeProvider;
+    }
+    try {
+        const detections = detectProjectProviders(snapshot.cwd ?? process.cwd());
+        const context = selectRuntimeProviderContext(detections, snapshot);
+        if (!snapshot.cwd && !snapshot.argv && !snapshot.env) {
+            cachedRuntimeProvider = context;
+        }
+        return context;
+    }
+    catch {
+        return {};
+    }
+}
+export function resetRuntimeProviderContextCache() {
+    cachedRuntimeProvider = null;
+}
+//# sourceMappingURL=provider-detection.js.map