@cleocode/cleo 2026.2.5

package/dist/core/metrics/ab-test.js

@@ -0,0 +1,261 @@
+/**
+ * A/B testing framework for CLEO vs baseline comparison.
+ *
+ * Enables scientific comparison of CLEO (with subagents, manifests, protocols)
+ * vs baseline (direct implementation) across token consumption, validation
+ * effectiveness, and completion rates.
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, appendFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getCleoDir } from '../paths.js';
+import { isoTimestamp, readJsonlFile } from './common.js';
+import { isOtelEnabled, getSessionTokens } from './otel-integration.js';
+let currentTest = null;
+function getABMetricsDir(cwd) {
+    return process.env.AB_TEST_METRICS_DIR ?? join(getCleoDir(cwd), 'metrics', 'ab-tests');
+}
+function getABMetricsFile(cwd) {
+    return join(getABMetricsDir(cwd), 'AB_TESTS.jsonl');
+}
+/** Log an A/B test event. */
+export async function logABEvent(eventType, testName, variant, context, cwd) {
+    const dir = getABMetricsDir(cwd);
+    await mkdir(dir, { recursive: true });
+    const file = getABMetricsFile(cwd);
+    const parsedContext = typeof context === 'string'
+        ? { note: context }
+        : (context ?? {});
+    const entry = {
+        timestamp: isoTimestamp(),
+        event_type: eventType,
+        test_name: testName,
+        variant,
+        context: parsedContext,
+    };
+    try {
+        appendFileSync(file, JSON.stringify(entry) + '\n');
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/** Start an A/B test session. */
+export async function startABTest(testName, variant, description, cwd) {
+    if (!testName)
+        throw new Error('Test name required');
+    if (variant !== 'cleo' && variant !== 'baseline') {
+        throw new Error("Invalid variant. Must be 'cleo' or 'baseline'");
+    }
+    let startTokens = 0;
+    if (isOtelEnabled()) {
+        const tokenData = getSessionTokens(`${testName}-${variant}`, cwd);
+        startTokens = tokenData.tokens.total;
+    }
+    currentTest = {
+        testName,
+        variant,
+        startTime: isoTimestamp(),
+        startTokens,
+    };
+    await logABEvent('start', testName, variant, {
+        description: description ?? '',
+        otel_enabled: isOtelEnabled(),
+    }, cwd);
+}
+/** End an A/B test session with summary. */
+export async function endABTest(options = {}, cwd) {
+    if (!currentTest)
+        return null;
+    const endTime = isoTimestamp();
+    const startEpoch = new Date(currentTest.startTime).getTime();
+    const endEpoch = new Date(endTime).getTime();
+    const durationSeconds = Math.floor((endEpoch - startEpoch) / 1000);
+    let totalTokens = 0;
+    let tokenSource = 'none';
+    if (isOtelEnabled()) {
+        const endTokenData = getSessionTokens(`${currentTest.testName}-${currentTest.variant}`, cwd);
+        totalTokens = endTokenData.tokens.total - currentTest.startTokens;
+        tokenSource = 'otel';
+    }
+    else {
+        const tokenFile = join(getCleoDir(cwd), 'metrics', 'TOKEN_USAGE.jsonl');
+        if (existsSync(tokenFile)) {
+            const entries = readJsonlFile(tokenFile);
+            totalTokens = entries
+                .filter(e => e.session_id === currentTest.testName)
+                .reduce((sum, e) => sum + (e.estimated_tokens ?? 0), 0);
+            tokenSource = 'estimated';
+        }
+    }
+    const tasksCompleted = options.tasksCompleted ?? 0;
+    const valPasses = options.validationPasses ?? 0;
+    const valFailures = options.validationFailures ?? 0;
+    const totalVal = valPasses + valFailures;
+    const valRate = totalVal > 0 ? Math.floor((valPasses * 100) / totalVal) : 0;
+    const summary = {
+        test_name: currentTest.testName,
+        variant: currentTest.variant,
+        start_time: currentTest.startTime,
+        end_time: endTime,
+        duration_seconds: durationSeconds,
+        tokens_consumed: totalTokens,
+        token_source: tokenSource,
+        tasks_completed: tasksCompleted,
+        validations: {
+            passed: valPasses,
+            failed: valFailures,
+            total: totalVal,
+            pass_rate_percent: valRate,
+        },
+        notes: options.notes ?? '',
+    };
+    await logABEvent('end', currentTest.testName, currentTest.variant, summary, cwd);
+    currentTest = null;
+    return summary;
+}
+/** Get results for a specific test variant. */
+export function getABTestResults(testName, variant, cwd) {
+    const file = getABMetricsFile(cwd);
+    if (!existsSync(file))
+        return null;
+    const entries = readJsonlFile(file);
+    const endEntry = entries
+        .filter(e => e.test_name === testName &&
+        e.variant === variant &&
+        e.event_type === 'end')
+        .pop();
+    if (!endEntry)
+        return null;
+    return endEntry.context;
+}
+/** List all A/B tests. */
+export function listABTests(filter, cwd) {
+    const file = getABMetricsFile(cwd);
+    if (!existsSync(file))
+        return [];
+    let entries = readJsonlFile(file);
+    if (filter) {
+        entries = entries.filter(e => e.test_name === filter);
+    }
+    // Group by test name
+    const byTest = new Map();
+    for (const e of entries) {
+        const name = e.test_name;
+        if (!byTest.has(name))
+            byTest.set(name, []);
+        byTest.get(name).push(e);
+    }
+    return Array.from(byTest.entries()).map(([testName, group]) => ({
+        test_name: testName,
+        variants: [...new Set(group.map(e => e.variant))],
+        total_runs: group.length,
+        last_run: group.map(e => e.timestamp).sort().pop() ?? null,
+    }));
+}
+/** Compare two variants of the same test. */
+export function compareABTest(testName, cwd) {
+    const cleoResult = getABTestResults(testName, 'cleo', cwd);
+    const baselineResult = getABTestResults(testName, 'baseline', cwd);
+    if (!cleoResult)
+        return { error: `No CLEO variant found for test '${testName}'` };
+    if (!baselineResult)
+        return { error: `No baseline variant found for test '${testName}'` };
+    const cleoTokens = cleoResult.tokens_consumed ?? 0;
+    const baselineTokens = baselineResult.tokens_consumed ?? 0;
+    const cleoTasks = cleoResult.tasks_completed ?? 0;
+    const baselineTasks = baselineResult.tasks_completed ?? 0;
+    const cleoValRate = (cleoResult.validations?.pass_rate_percent) ?? 0;
+    const baselineValRate = (baselineResult.validations?.pass_rate_percent) ?? 0;
+    const cleoDuration = cleoResult.duration_seconds ?? 0;
+    const baselineDuration = baselineResult.duration_seconds ?? 0;
+    const tokenDiff = baselineTokens - cleoTokens;
+    const tokenSavingsPct = baselineTokens > 0 ? Math.floor((tokenDiff * 100) / baselineTokens) : 0;
+    const cleoTokensPerTask = cleoTasks > 0 ? Math.floor(cleoTokens / cleoTasks) : 0;
+    const baselineTokensPerTask = baselineTasks > 0 ? Math.floor(baselineTokens / baselineTasks) : 0;
+    const isSignificant = Math.abs(tokenSavingsPct) >= 20;
+    let verdict;
+    if (tokenSavingsPct >= 70)
+        verdict = 'Excellent: CLEO saves >70% tokens';
+    else if (tokenSavingsPct >= 50)
+        verdict = 'Good: CLEO saves 50-70% tokens';
+    else if (tokenSavingsPct >= 20)
+        verdict = 'Moderate: CLEO saves 20-50% tokens';
+    else if (tokenSavingsPct >= 0)
+        verdict = 'Minimal: CLEO saves <20% tokens';
+    else
+        verdict = 'Warning: CLEO used MORE tokens';
+    return {
+        test_name: testName,
+        comparison: {
+            tokens: {
+                cleo: cleoTokens,
+                baseline: baselineTokens,
+                difference: tokenDiff,
+                savings_percent: tokenSavingsPct,
+                winner: tokenDiff > 0 ? 'cleo' : 'baseline',
+            },
+            tasks_completed: {
+                cleo: cleoTasks,
+                baseline: baselineTasks,
+                difference: cleoTasks - baselineTasks,
+            },
+            tokens_per_task: {
+                cleo: cleoTokensPerTask,
+                baseline: baselineTokensPerTask,
+                efficiency_gain_percent: baselineTokensPerTask > 0
+                    ? Math.floor(((baselineTokensPerTask - cleoTokensPerTask) * 100) / baselineTokensPerTask)
+                    : 0,
+            },
+            validation_pass_rate: {
+                cleo: cleoValRate,
+                baseline: baselineValRate,
+                difference: cleoValRate - baselineValRate,
+            },
+            duration_seconds: {
+                cleo: cleoDuration,
+                baseline: baselineDuration,
+                difference: baselineDuration - cleoDuration,
+            },
+        },
+        statistical: {
+            significant: isSignificant,
+            confidence_note: 'Simple threshold test: >20% difference considered significant',
+        },
+        verdict,
+        details: { cleo: cleoResult, baseline: baselineResult },
+    };
+}
+/** Get aggregate statistics of all A/B tests. */
+export function getABTestStats(cwd) {
+    const file = getABMetricsFile(cwd);
+    if (!existsSync(file)) {
+        return { total_tests: 0, total_runs: 0, avg_token_savings: 0 };
+    }
+    const entries = readJsonlFile(file);
+    const uniqueTests = new Set(entries.map(e => e.test_name));
+    const totalRuns = entries.length;
+    let totalSavings = 0;
+    let comparisonCount = 0;
+    for (const testName of uniqueTests) {
+        const comparison = compareABTest(testName, cwd);
+        if (!comparison.error) {
+            const savings = comparison.comparison
+                ?.tokens?.savings_percent ?? 0;
+            totalSavings += savings;
+            comparisonCount++;
+        }
+    }
+    const avgSavings = comparisonCount > 0 ? Math.floor(totalSavings / comparisonCount) : 0;
+    return {
+        total_tests: uniqueTests.size,
+        total_runs: totalRuns,
+        completed_comparisons: comparisonCount,
+        avg_token_savings_percent: avgSavings,
+        summary: `Tracked ${uniqueTests.size} tests with ${comparisonCount} A/B comparisons. Average token savings: ${avgSavings}%`,
+    };
+}
+//# sourceMappingURL=ab-test.js.map

package/dist/core/metrics/ab-test.js.map

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

package/dist/core/metrics/aggregation.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Metrics aggregation - project-to-global sync and compliance summaries.
+ *
+ * Project metrics: .cleo/metrics/COMPLIANCE.jsonl
+ * Global metrics:  ~/.cleo/metrics/GLOBAL.jsonl
+ *
+ * @task T4454
+ * @epic T4454
+ */
+/** Sync project metrics to global aggregation file. */
+export declare function syncMetricsToGlobal(options?: {
+    force?: boolean;
+}, cwd?: string): Promise<Record<string, unknown>>;
+/** Get compliance summary for the current project. */
+export declare function getProjectComplianceSummary(options?: {
+    since?: string;
+    agent?: string;
+    category?: string;
+}, cwd?: string): Record<string, unknown>;
+/** Get compliance summary across all projects. */
+export declare function getGlobalComplianceSummary(options?: {
+    since?: string;
+    project?: string;
+}): Record<string, unknown>;
+/** Get compliance trend over time. */
+export declare function getComplianceTrend(days?: number, options?: {
+    project?: string;
+    global?: boolean;
+}, cwd?: string): Record<string, unknown>;
+/** Get reliability stats per skill/agent. */
+export declare function getSkillReliability(options?: {
+    since?: string;
+    global?: boolean;
+}, cwd?: string): Record<string, unknown>;
+/** Log session metrics to SESSIONS.jsonl. */
+export declare function logSessionMetrics(metricsJson: Record<string, unknown>, cwd?: string): Promise<Record<string, unknown>>;
+/** Get summary of session metrics. */
+export declare function getSessionMetricsSummary(options?: {
+    since?: string;
+}, cwd?: string): Record<string, unknown>;
+//# sourceMappingURL=aggregation.d.ts.map

package/dist/core/metrics/aggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.d.ts","sourceRoot":"","sources":["../../../src/core/metrics/aggregation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsCH,uDAAuD;AACvD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EACjC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2ClC;AAgBD,sDAAsD;AACtD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,EACnE,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CACxC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AA8DD,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,MAAU,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,EACpD,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2CzB;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,EAClD,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB;AAED,6CAA6C;AAC7C,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBlC;AAED,sCAAsC;AACtC,wBAAgB,wBAAwB,CACtC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAChC,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwEzB"}

package/dist/core/metrics/aggregation.js

@@ -0,0 +1,353 @@
+/**
+ * Metrics aggregation - project-to-global sync and compliance summaries.
+ *
+ * Project metrics: .cleo/metrics/COMPLIANCE.jsonl
+ * Global metrics:  ~/.cleo/metrics/GLOBAL.jsonl
+ *
+ * @task T4454
+ * @epic T4454
+ */
+import { existsSync, appendFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { getCleoDir } from '../paths.js';
+import { getCompliancePath, getSessionsMetricsPath, readJsonlFile, } from './common.js';
+function getProjectMetricsDir(cwd) {
+    return join(getCleoDir(cwd), 'metrics');
+}
+function getGlobalMetricsDir() {
+    return join(homedir(), '.cleo', 'metrics');
+}
+function getGlobalPath() {
+    return join(getGlobalMetricsDir(), 'GLOBAL.jsonl');
+}
+function getProjectName() {
+    try {
+        const url = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const match = url.match(/[/:]([^/]+?)(?:\.git)?$/);
+        if (match)
+            return match[1];
+    }
+    catch { /* not a git repo */ }
+    return basename(process.cwd());
+}
+/** Sync project metrics to global aggregation file. */
+export async function syncMetricsToGlobal(options = {}, cwd) {
+    const projectPath = getCompliancePath(join(getCleoDir(cwd), 'metrics'));
+    if (!existsSync(projectPath)) {
+        return { success: true, result: { synced: 0, skipped: 0, reason: 'No project metrics file' } };
+    }
+    const globalDir = getGlobalMetricsDir();
+    await mkdir(globalDir, { recursive: true });
+    const globalPath = getGlobalPath();
+    const projectName = getProjectName();
+    // Get existing entry keys for deduplication
+    const existingKeys = new Set();
+    if (!options.force && existsSync(globalPath)) {
+        for (const entry of readJsonlFile(globalPath)) {
+            const ts = entry.timestamp;
+            const srcId = entry.source_id;
+            if (ts && srcId)
+                existingKeys.add(`${ts}_${srcId}`);
+        }
+    }
+    const projectEntries = readJsonlFile(projectPath);
+    let synced = 0;
+    let skipped = 0;
+    for (const entry of projectEntries) {
+        const ts = entry.timestamp;
+        const srcId = entry.source_id;
+        if (!ts || !srcId) {
+            skipped++;
+            continue;
+        }
+        const key = `${ts}_${srcId}`;
+        if (!options.force && existingKeys.has(key)) {
+            skipped++;
+            continue;
+        }
+        const enriched = { ...entry, project: projectName };
+        appendFileSync(globalPath, JSON.stringify(enriched) + '\n');
+        synced++;
+    }
+    return {
+        success: true,
+        result: { project: projectName, synced, skipped, globalFile: '~/.cleo/metrics/GLOBAL.jsonl' },
+    };
+}
+/** Get compliance summary for the current project. */
+export function getProjectComplianceSummary(options = {}, cwd) {
+    const projectPath = getCompliancePath(join(getCleoDir(cwd), 'metrics'));
+    const projectName = getProjectName();
+    if (!existsSync(projectPath)) {
+        return {
+            success: true,
+            result: {
+                project: projectName,
+                totalEntries: 0,
+                averagePassRate: 0,
+                averageAdherence: 0,
+                totalViolations: 0,
+                bySeverity: {},
+                byAgent: {},
+            },
+        };
+    }
+    let entries = readJsonlFile(projectPath);
+    if (options.since)
+        entries = entries.filter(e => (e.timestamp ?? '') >= options.since);
+    if (options.agent)
+        entries = entries.filter(e => e.source_id === options.agent);
+    if (options.category)
+        entries = entries.filter(e => e.category === options.category);
+    return {
+        success: true,
+        result: computeComplianceSummary(entries, projectName),
+    };
+}
+/** Get compliance summary across all projects. */
+export function getGlobalComplianceSummary(options = {}) {
+    const globalPath = getGlobalPath();
+    if (!existsSync(globalPath)) {
+        return {
+            success: true,
+            result: {
+                totalEntries: 0,
+                totalProjects: 0,
+                averagePassRate: 0,
+                averageAdherence: 0,
+                totalViolations: 0,
+                byProject: {},
+                bySeverity: {},
+            },
+        };
+    }
+    let entries = readJsonlFile(globalPath);
+    if (options.since)
+        entries = entries.filter(e => (e.timestamp ?? '') >= options.since);
+    if (options.project)
+        entries = entries.filter(e => e.project === options.project);
+    const projects = new Set(entries.map(e => e.project ?? 'unknown'));
+    const summary = computeComplianceSummary(entries);
+    return {
+        success: true,
+        result: { ...summary, totalProjects: projects.size },
+    };
+}
+/** Compute compliance summary from entries. */
+function computeComplianceSummary(entries, projectName) {
+    const total = entries.length;
+    if (total === 0) {
+        return {
+            ...(projectName && { project: projectName }),
+            totalEntries: 0,
+            averagePassRate: 0,
+            averageAdherence: 0,
+            totalViolations: 0,
+            bySeverity: {},
+            byAgent: {},
+        };
+    }
+    const avgPassRate = entries.reduce((s, e) => s + (e.compliance?.compliance_pass_rate ?? 0), 0) / total;
+    const avgAdherence = entries.reduce((s, e) => s + (e.compliance?.rule_adherence_score ?? 0), 0) / total;
+    const totalViolations = entries.reduce((s, e) => s + (e.compliance?.violation_count ?? 0), 0);
+    // Group by severity
+    const bySeverity = {};
+    for (const e of entries) {
+        const sev = e.compliance?.violation_severity ?? 'unknown';
+        bySeverity[sev] = (bySeverity[sev] ?? 0) + 1;
+    }
+    // Group by agent
+    const byAgent = {};
+    for (const e of entries) {
+        const agent = e.source_id ?? 'unknown';
+        if (!byAgent[agent])
+            byAgent[agent] = { count: 0, avgPassRate: 0, violations: 0 };
+        byAgent[agent].count++;
+        byAgent[agent].avgPassRate += e.compliance?.compliance_pass_rate ?? 0;
+        byAgent[agent].violations += e.compliance?.violation_count ?? 0;
+    }
+    for (const agent of Object.keys(byAgent)) {
+        byAgent[agent].avgPassRate /= byAgent[agent].count;
+    }
+    // Time range
+    const timestamps = entries.map(e => e.timestamp ?? '').filter(Boolean).sort();
+    return {
+        ...(projectName && { project: projectName }),
+        totalEntries: total,
+        averagePassRate: avgPassRate,
+        averageAdherence: avgAdherence,
+        totalViolations,
+        bySeverity,
+        byAgent,
+        timeRange: {
+            oldest: timestamps[0] ?? null,
+            newest: timestamps[timestamps.length - 1] ?? null,
+        },
+    };
+}
+/** Get compliance trend over time. */
+export function getComplianceTrend(days = 7, options = {}, cwd) {
+    const metricsPath = options.global
+        ? getGlobalPath()
+        : getCompliancePath(join(getCleoDir(cwd), 'metrics'));
+    if (!existsSync(metricsPath)) {
+        return { success: true, result: { days, dataPoints: [], trend: 'no_data' } };
+    }
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const cutoffStr = cutoff.toISOString();
+    let entries = readJsonlFile(metricsPath);
+    entries = entries.filter(e => (e.timestamp ?? '') >= cutoffStr);
+    if (options.project)
+        entries = entries.filter(e => e.project === options.project);
+    // Group by date
+    const byDate = new Map();
+    for (const e of entries) {
+        const date = (e.timestamp ?? '').split('T')[0];
+        if (!byDate.has(date))
+            byDate.set(date, []);
+        byDate.get(date).push(e);
+    }
+    const dataPoints = Array.from(byDate.entries())
+        .map(([date, group]) => ({
+        date,
+        entries: group.length,
+        avgPassRate: group.reduce((s, e) => s + (e.compliance?.compliance_pass_rate ?? 0), 0) / group.length,
+        avgAdherence: group.reduce((s, e) => s + (e.compliance?.rule_adherence_score ?? 0), 0) / group.length,
+        violations: group.reduce((s, e) => s + (e.compliance?.violation_count ?? 0), 0),
+    }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    let trend = 'stable';
+    if (dataPoints.length >= 2) {
+        const diff = dataPoints[dataPoints.length - 1].avgPassRate - dataPoints[0].avgPassRate;
+        if (diff > 0.05)
+            trend = 'improving';
+        else if (diff < -0.05)
+            trend = 'declining';
+    }
+    return { success: true, result: { days, dataPoints, trend } };
+}
+/** Get reliability stats per skill/agent. */
+export function getSkillReliability(options = {}, cwd) {
+    const metricsPath = options.global
+        ? getGlobalPath()
+        : getCompliancePath(join(getCleoDir(cwd), 'metrics'));
+    if (!existsSync(metricsPath)) {
+        return { success: true, result: { skills: [], summary: { totalSkills: 0, avgReliability: 0 } } };
+    }
+    let entries = readJsonlFile(metricsPath);
+    if (options.since)
+        entries = entries.filter(e => (e.timestamp ?? '') >= options.since);
+    // Group by source_id (skill)
+    const bySkill = new Map();
+    for (const e of entries) {
+        const skill = e.source_id ?? 'unknown';
+        if (!bySkill.has(skill))
+            bySkill.set(skill, []);
+        bySkill.get(skill).push(e);
+    }
+    const skills = Array.from(bySkill.entries()).map(([skill, group]) => {
+        const avgPassRate = group.reduce((s, e) => s + (e.compliance?.compliance_pass_rate ?? 0), 0) / group.length;
+        const avgAdherence = group.reduce((s, e) => s + (e.compliance?.rule_adherence_score ?? 0), 0) / group.length;
+        const totalViolations = group.reduce((s, e) => s + (e.compliance?.violation_count ?? 0), 0);
+        const reliability = avgPassRate * 0.6 + avgAdherence * 0.4;
+        return {
+            skill,
+            invocations: group.length,
+            avgPassRate,
+            avgAdherence,
+            totalViolations,
+            reliability,
+        };
+    }).sort((a, b) => b.reliability - a.reliability);
+    const totalSkills = skills.length;
+    const avgReliability = totalSkills > 0
+        ? skills.reduce((s, sk) => s + sk.reliability, 0) / totalSkills
+        : 0;
+    return {
+        success: true,
+        result: { skills, summary: { totalSkills, avgReliability } },
+    };
+}
+/** Log session metrics to SESSIONS.jsonl. */
+export async function logSessionMetrics(metricsJson, cwd) {
+    const metricsDir = getProjectMetricsDir(cwd);
+    await mkdir(metricsDir, { recursive: true });
+    const sessionsPath = getSessionsMetricsPath(join(getCleoDir(cwd), 'metrics'));
+    try {
+        appendFileSync(sessionsPath, JSON.stringify(metricsJson) + '\n');
+    }
+    catch {
+        return { success: false, error: { code: 'E_LOCK_FAILED', message: 'Failed to append session metrics' } };
+    }
+    const sessionId = metricsJson.session_id ?? 'unknown';
+    return {
+        success: true,
+        result: { sessionsFile: sessionsPath, sessionId, action: 'appended' },
+    };
+}
+/** Get summary of session metrics. */
+export function getSessionMetricsSummary(options = {}, cwd) {
+    const sessionsPath = getSessionsMetricsPath(join(getCleoDir(cwd), 'metrics'));
+    if (!existsSync(sessionsPath)) {
+        return {
+            success: true,
+            result: {
+                totalSessions: 0,
+                avgEfficiency: 0,
+                avgInterventionRate: 0,
+                totalTasksCompleted: 0,
+                totalTokensConsumed: 0,
+            },
+        };
+    }
+    let entries = readJsonlFile(sessionsPath);
+    if (options.since) {
+        entries = entries.filter(e => (e.start_timestamp ?? '') >= options.since);
+    }
+    const total = entries.length;
+    if (total === 0) {
+        return {
+            success: true,
+            result: {
+                totalSessions: 0,
+                avgEfficiency: 0,
+                avgInterventionRate: 0,
+                totalTasksCompleted: 0,
+                totalTokensConsumed: 0,
+            },
+        };
+    }
+    const avgEfficiency = entries.reduce((s, e) => s + (e.efficiency?.session_efficiency_score ?? 0), 0) / total;
+    const avgInterventionRate = entries.reduce((s, e) => s + (e.efficiency?.human_intervention_rate ?? 0), 0) / total;
+    const avgContextUtil = entries.reduce((s, e) => s + (e.efficiency?.context_utilization ?? 0), 0) / total;
+    const totalTasksCompleted = entries.reduce((s, e) => s + (e.stats?.tasks_completed ?? 0), 0);
+    const totalTokensConsumed = entries.reduce((s, e) => s + (e.tokens?.consumed ?? 0), 0);
+    return {
+        success: true,
+        result: {
+            totalSessions: total,
+            avgEfficiency,
+            avgInterventionRate,
+            avgContextUtilization: avgContextUtil,
+            totalTasksCompleted,
+            totalTokensConsumed,
+            avgTasksPerSession: totalTasksCompleted / total,
+            byContextUtilization: {
+                low: entries.filter(e => (e.efficiency?.context_utilization ?? 0) < 0.3).length,
+                medium: entries.filter(e => {
+                    const cu = e.efficiency?.context_utilization ?? 0;
+                    return cu >= 0.3 && cu < 0.7;
+                }).length,
+                high: entries.filter(e => (e.efficiency?.context_utilization ?? 0) >= 0.7).length,
+            },
+        },
+    };
+}
+//# sourceMappingURL=aggregation.js.map