@cleocode/cleo 2026.2.5

package/dist/core/lifecycle/index.js

@@ -0,0 +1,213 @@
+/**
+ * RCSD pipeline lifecycle - stage transitions and gate enforcement.
+ * @task T4467
+ * @epic T4454
+ */
+import { readJson, saveJson } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getCleoDirAbsolute, getBackupDir } from '../paths.js';
+import { join } from 'node:path';
+/** RCSD pipeline stages in order. */
+export const RCSD_STAGES = ['research', 'consensus', 'specification', 'decomposition'];
+/** Execution stages. */
+export const EXECUTION_STAGES = ['implementation', 'contribution', 'release'];
+/**
+ * Get RCSD manifest path for an epic.
+ * @task T4467
+ */
+function getRcsdPath(epicId, cwd) {
+    return join(getCleoDirAbsolute(cwd), 'rcsd', epicId, '_manifest.json');
+}
+/**
+ * Read or initialize RCSD manifest for an epic.
+ * @task T4467
+ */
+async function readRcsdManifest(epicId, cwd) {
+    const path = getRcsdPath(epicId, cwd);
+    const existing = await readJson(path);
+    if (existing)
+        return existing;
+    // Initialize new manifest
+    const now = new Date().toISOString();
+    const allStages = [...RCSD_STAGES, ...EXECUTION_STAGES];
+    const stages = {};
+    for (const stage of allStages) {
+        stages[stage] = { status: 'not_started' };
+    }
+    return {
+        epicId,
+        createdAt: now,
+        updatedAt: now,
+        stages,
+    };
+}
+/**
+ * Save RCSD manifest.
+ * @task T4467
+ */
+async function saveRcsdManifest(manifest, cwd) {
+    const path = getRcsdPath(manifest.epicId, cwd);
+    manifest.updatedAt = new Date().toISOString();
+    await saveJson(path, manifest, { backupDir: getBackupDir(cwd) });
+}
+/**
+ * Get the current lifecycle state for an epic.
+ * @task T4467
+ */
+export async function getLifecycleState(epicId, cwd) {
+    return readRcsdManifest(epicId, cwd);
+}
+/**
+ * Start a lifecycle stage.
+ * @task T4467
+ */
+export async function startStage(epicId, stage, cwd) {
+    const manifest = await readRcsdManifest(epicId, cwd);
+    // Gate check
+    const gateResult = await checkGate(epicId, stage, cwd);
+    if (!gateResult.allowed) {
+        throw new CleoError(ExitCode.LIFECYCLE_GATE_FAILED, gateResult.message);
+    }
+    const stageData = manifest.stages[stage];
+    if (!stageData) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Unknown stage: ${stage}`);
+    }
+    const previousStatus = stageData.status;
+    if (previousStatus === 'completed') {
+        throw new CleoError(ExitCode.LIFECYCLE_TRANSITION_INVALID, `Stage '${stage}' is already completed`);
+    }
+    const now = new Date().toISOString();
+    stageData.status = 'in_progress';
+    stageData.startedAt = now;
+    await saveRcsdManifest(manifest, cwd);
+    return {
+        epicId,
+        stage,
+        previousStatus,
+        newStatus: 'in_progress',
+        timestamp: now,
+    };
+}
+/**
+ * Complete a lifecycle stage.
+ * @task T4467
+ */
+export async function completeStage(epicId, stage, artifacts, cwd) {
+    const manifest = await readRcsdManifest(epicId, cwd);
+    const stageData = manifest.stages[stage];
+    if (!stageData) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Unknown stage: ${stage}`);
+    }
+    const previousStatus = stageData.status;
+    if (previousStatus !== 'in_progress' && previousStatus !== 'not_started') {
+        throw new CleoError(ExitCode.LIFECYCLE_TRANSITION_INVALID, `Cannot complete stage '${stage}' from status '${previousStatus}'`);
+    }
+    const now = new Date().toISOString();
+    stageData.status = 'completed';
+    stageData.completedAt = now;
+    if (artifacts?.length) {
+        stageData.artifacts = artifacts;
+    }
+    await saveRcsdManifest(manifest, cwd);
+    return {
+        epicId,
+        stage,
+        previousStatus,
+        newStatus: 'completed',
+        timestamp: now,
+    };
+}
+/**
+ * Skip a lifecycle stage.
+ * @task T4467
+ */
+export async function skipStage(epicId, stage, _reason, cwd) {
+    const manifest = await readRcsdManifest(epicId, cwd);
+    const stageData = manifest.stages[stage];
+    if (!stageData) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Unknown stage: ${stage}`);
+    }
+    const previousStatus = stageData.status;
+    if (previousStatus === 'completed') {
+        throw new CleoError(ExitCode.LIFECYCLE_TRANSITION_INVALID, `Cannot skip stage '${stage}' - already completed`);
+    }
+    const now = new Date().toISOString();
+    stageData.status = 'skipped';
+    await saveRcsdManifest(manifest, cwd);
+    return {
+        epicId,
+        stage,
+        previousStatus,
+        newStatus: 'skipped',
+        timestamp: now,
+    };
+}
+/**
+ * Check lifecycle gate before starting a stage.
+ * @task T4467
+ */
+export async function checkGate(epicId, targetStage, cwd) {
+    // Get enforcement mode from config
+    const mode = await getEnforcementMode(cwd);
+    if (mode === 'off') {
+        return {
+            allowed: true,
+            mode,
+            missingPrerequisites: [],
+            currentStage: targetStage,
+            message: 'Gate check disabled',
+        };
+    }
+    const manifest = await readRcsdManifest(epicId, cwd);
+    const allStages = [...RCSD_STAGES, ...EXECUTION_STAGES];
+    const targetIndex = allStages.indexOf(targetStage);
+    if (targetIndex === -1) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Unknown stage: ${targetStage}`);
+    }
+    // Check all prior stages are completed or skipped
+    const missing = [];
+    for (let i = 0; i < targetIndex; i++) {
+        const stage = allStages[i];
+        const status = manifest.stages[stage]?.status ?? 'not_started';
+        if (status !== 'completed' && status !== 'skipped') {
+            missing.push(stage);
+        }
+    }
+    const allowed = mode === 'advisory' || missing.length === 0;
+    const message = missing.length > 0
+        ? `SPAWN BLOCKED: Lifecycle prerequisites not met. Missing: ${missing.join(', ')}`
+        : 'All prerequisites met';
+    return {
+        allowed,
+        mode,
+        missingPrerequisites: missing,
+        currentStage: targetStage,
+        message,
+    };
+}
+/**
+ * Get lifecycle enforcement mode from config.
+ * @task T4467
+ */
+async function getEnforcementMode(cwd) {
+    // Check environment variable first
+    const envMode = process.env['LIFECYCLE_ENFORCEMENT_MODE'];
+    if (envMode && ['strict', 'advisory', 'off'].includes(envMode)) {
+        return envMode;
+    }
+    // Read from config
+    try {
+        const configPath = join(getCleoDirAbsolute(cwd), 'config.json');
+        const config = await readJson(configPath);
+        const mode = config?.lifecycleEnforcement?.mode;
+        if (mode && ['strict', 'advisory', 'off'].includes(mode)) {
+            return mode;
+        }
+    }
+    catch {
+        // Config may not exist
+    }
+    return 'strict';
+}
+//# sourceMappingURL=index.js.map

package/dist/core/lifecycle/index.js.map

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

package/dist/core/log/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Audit log viewing core module.
+ * @task T4538
+ * @epic T4454
+ */
+/** Get log entries with filtering. */
+export declare function getLogEntries(opts: {
+    limit?: number;
+    offset?: number;
+    operation?: string;
+    task?: string;
+    since?: string;
+    cwd?: string;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/log/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,sCAAsC;AACtC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2BnC"}

package/dist/core/log/index.js

@@ -0,0 +1,33 @@
+/**
+ * Audit log viewing core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { readLogEntries } from '../../store/json.js';
+import { getLogPath } from '../paths.js';
+/** Get log entries with filtering. */
+export async function getLogEntries(opts) {
+    const raw = await readLogEntries(getLogPath(opts.cwd));
+    let entries = raw;
+    // Apply filters
+    if (opts.operation) {
+        entries = entries.filter(e => e.operation === opts.operation);
+    }
+    if (opts.task) {
+        entries = entries.filter(e => e.taskId === opts.task);
+    }
+    if (opts.since) {
+        entries = entries.filter(e => e.timestamp >= opts.since);
+    }
+    // Sort by timestamp descending
+    entries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    const total = entries.length;
+    const offset = opts.offset ?? 0;
+    const limit = opts.limit ?? 20;
+    const paginated = entries.slice(offset, offset + limit);
+    return {
+        entries: paginated,
+        pagination: { total, offset, limit, hasMore: offset + limit < total },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/log/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAOnC;IACC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,IAAI,OAAO,GAAG,GAAiB,CAAC;IAEhC,gBAAgB;IAChB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAM,CAAC,CAAC;IAC5D,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAExD,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE;KACtE,CAAC;AACJ,CAAC"}

package/dist/core/mcp/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MCP environment detection - CLEO-specific runtime mode resolution.
+ *
+ * Detects dev-ts vs prod-npm mode by reading ~/.cleo/VERSION.
+ * This is the only CLEO-specific concern here — all provider detection,
+ * config writing, and MCP server installation is delegated to @cleocode/caamp.
+ *
+ * @task T4676
+ * @epic T4663
+ */
+/** Resolved environment mode for MCP server config. */
+export interface McpEnvMode {
+    mode: 'dev-ts' | 'prod-npm' | 'unknown';
+    /** Absolute path to the source directory (dev-ts mode only). */
+    source: string | null;
+}
+/**
+ * Detect the current CLEO environment mode by reading ~/.cleo/VERSION.
+ *
+ * The VERSION file format:
+ *   Line 1: version number
+ *   Lines 2+: key=value pairs (mode, source, etc.)
+ *
+ * @task T4584
+ */
+export declare function detectEnvMode(): McpEnvMode;
+/**
+ * Generate the MCP server entry for the cleo server based on env mode.
+ *
+ * Returns a config object compatible with CAAMP's McpServerConfig:
+ * - dev-ts: { command: 'node', args: ['<source>/dist/mcp/index.js'] }
+ * - prod-npm: { command: 'cleo-mcp', args: [] }
+ *
+ * @task T4584
+ */
+export declare function generateMcpServerEntry(env: McpEnvMode): Record<string, unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,UAAU,CA+B1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe/E"}

package/dist/core/mcp/index.js

@@ -0,0 +1,73 @@
+/**
+ * MCP environment detection - CLEO-specific runtime mode resolution.
+ *
+ * Detects dev-ts vs prod-npm mode by reading ~/.cleo/VERSION.
+ * This is the only CLEO-specific concern here — all provider detection,
+ * config writing, and MCP server installation is delegated to @cleocode/caamp.
+ *
+ * @task T4676
+ * @epic T4663
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Detect the current CLEO environment mode by reading ~/.cleo/VERSION.
+ *
+ * The VERSION file format:
+ *   Line 1: version number
+ *   Lines 2+: key=value pairs (mode, source, etc.)
+ *
+ * @task T4584
+ */
+export function detectEnvMode() {
+    const versionPath = join(process.env['CLEO_HOME'] ?? join(homedir(), '.cleo'), 'VERSION');
+    let content;
+    try {
+        content = readFileSync(versionPath, 'utf-8');
+    }
+    catch {
+        return { mode: 'unknown', source: null };
+    }
+    const kvPairs = {};
+    const lines = content.trim().split('\n');
+    for (let i = 1; i < lines.length; i++) {
+        const eqIdx = lines[i].indexOf('=');
+        if (eqIdx > 0) {
+            kvPairs[lines[i].slice(0, eqIdx).trim()] = lines[i].slice(eqIdx + 1).trim();
+        }
+    }
+    const rawMode = kvPairs['mode'] ?? 'unknown';
+    const mode = rawMode === 'dev-ts' ? 'dev-ts'
+        : rawMode === 'prod-npm' ? 'prod-npm'
+            : 'unknown';
+    return {
+        mode,
+        source: mode === 'dev-ts' ? (kvPairs['source'] ?? null) : null,
+    };
+}
+/**
+ * Generate the MCP server entry for the cleo server based on env mode.
+ *
+ * Returns a config object compatible with CAAMP's McpServerConfig:
+ * - dev-ts: { command: 'node', args: ['<source>/dist/mcp/index.js'] }
+ * - prod-npm: { command: 'cleo-mcp', args: [] }
+ *
+ * @task T4584
+ */
+export function generateMcpServerEntry(env) {
+    if (env.mode === 'dev-ts' && env.source) {
+        return {
+            command: 'node',
+            args: [join(env.source, 'dist', 'mcp', 'index.js')],
+            env: {},
+        };
+    }
+    // prod-npm or unknown: use globally installed binary
+    return {
+        command: 'cleo-mcp',
+        args: [],
+        env: {},
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlC;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,WAAW,GAAG,IAAI,CACtB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,EACpD,SAAS,CACV,CAAC;IAEF,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ;QAC1C,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU;YACrC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAe;IACpD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO;YACL,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACnD,GAAG,EAAE,EAAE;SACR,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,EAAE;KACR,CAAC;AACJ,CAAC"}

package/dist/core/metrics/ab-test.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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
+ */
+/** A/B test variant. */
+export type ABVariant = 'cleo' | 'baseline';
+/** A/B test event types. */
+export type ABEventType = 'start' | 'end' | 'milestone' | 'note';
+/** Log an A/B test event. */
+export declare function logABEvent(eventType: ABEventType, testName: string, variant: ABVariant, context?: Record<string, unknown> | string, cwd?: string): Promise<void>;
+/** Start an A/B test session. */
+export declare function startABTest(testName: string, variant: ABVariant, description?: string, cwd?: string): Promise<void>;
+/** A/B test summary result. */
+export interface ABTestSummary {
+    test_name: string;
+    variant: ABVariant;
+    start_time: string;
+    end_time: string;
+    duration_seconds: number;
+    tokens_consumed: number;
+    token_source: string;
+    tasks_completed: number;
+    validations: {
+        passed: number;
+        failed: number;
+        total: number;
+        pass_rate_percent: number;
+    };
+    notes: string;
+}
+/** End an A/B test session with summary. */
+export declare function endABTest(options?: {
+    tasksCompleted?: number;
+    validationPasses?: number;
+    validationFailures?: number;
+    notes?: string;
+}, cwd?: string): Promise<ABTestSummary | null>;
+/** Get results for a specific test variant. */
+export declare function getABTestResults(testName: string, variant: ABVariant, cwd?: string): Record<string, unknown> | null;
+/** List all A/B tests. */
+export declare function listABTests(filter?: string, cwd?: string): Record<string, unknown>[];
+/** Compare two variants of the same test. */
+export declare function compareABTest(testName: string, cwd?: string): Record<string, unknown>;
+/** Get aggregate statistics of all A/B tests. */
+export declare function getABTestStats(cwd?: string): Record<string, unknown>;
+//# sourceMappingURL=ab-test.d.ts.map

package/dist/core/metrics/ab-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ab-test.d.ts","sourceRoot":"","sources":["../../../src/core/metrics/ab-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,wBAAwB;AACxB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5C,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAoBjE,6BAA6B;AAC7B,wBAAsB,UAAU,CAC9B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAC1C,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,iCAAiC;AACjC,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,wBAAsB,SAAS,CAC7B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAsD/B;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAehC;AAED,0BAA0B;AAC1B,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuBpF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsEzB;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCpE"}