dino-spec 16.2.0 → 17.2.0

package/dist/core/experiments/experiment-schema.js

@@ -0,0 +1,238 @@
+/**
+ * Experiment Schema - v17.0.0
+ *
+ * Defines types and validation for A/B testing experiments.
+ * Part of the Context Engineering A/B Testing Framework.
+ *
+ * Features:
+ * - Typed experiment definitions
+ * - Schema validation
+ * - Version compatibility
+ * - Status transitions
+ */
+// =============================================================================
+// Constants
+// =============================================================================
+/** Current schema version */
+export const EXPERIMENT_SCHEMA_VERSION = '1.0.0';
+/** Maximum name length */
+export const MAX_NAME_LENGTH = 100;
+/** Maximum description length */
+export const MAX_DESCRIPTION_LENGTH = 500;
+/** Maximum hypothesis length */
+export const MAX_HYPOTHESIS_LENGTH = 200;
+/** Default split ratio (50/50) */
+export const DEFAULT_SPLIT_RATIO = 0.5;
+/** Default minimum samples per arm */
+export const DEFAULT_MIN_SAMPLES = 30;
+/** Valid status transitions */
+export const STATUS_TRANSITIONS = {
+    draft: ['running', 'cancelled'],
+    running: ['concluded', 'cancelled'],
+    concluded: [], // Terminal state
+    cancelled: [], // Terminal state
+};
+// =============================================================================
+// Validation
+// =============================================================================
+/**
+ * Validate experiment name
+ */
+function validateName(name) {
+    if (!name || name.trim().length === 0) {
+        return { field: 'name', message: 'Name is required' };
+    }
+    if (name.length > MAX_NAME_LENGTH) {
+        return { field: 'name', message: `Name must be ${MAX_NAME_LENGTH} characters or less` };
+    }
+    return null;
+}
+/**
+ * Validate experiment description
+ */
+function validateDescription(description) {
+    if (!description || description.trim().length === 0) {
+        return { field: 'description', message: 'Description is required' };
+    }
+    if (description.length > MAX_DESCRIPTION_LENGTH) {
+        return {
+            field: 'description',
+            message: `Description must be ${MAX_DESCRIPTION_LENGTH} characters or less`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate experiment hypothesis
+ */
+function validateHypothesis(hypothesis) {
+    if (!hypothesis || hypothesis.trim().length === 0) {
+        return { field: 'hypothesis', message: 'Hypothesis is required' };
+    }
+    if (hypothesis.length > MAX_HYPOTHESIS_LENGTH) {
+        return {
+            field: 'hypothesis',
+            message: `Hypothesis must be ${MAX_HYPOTHESIS_LENGTH} characters or less`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate experiment arm
+ */
+function validateArm(arm, armName) {
+    if (!arm.name || arm.name.trim().length === 0) {
+        return { field: `${armName}.name`, message: 'Arm name is required' };
+    }
+    const validStrategies = ['conservative', 'moderate', 'aggressive'];
+    if (!validStrategies.includes(arm.strategyType)) {
+        return {
+            field: `${armName}.strategyType`,
+            message: `Invalid strategy type: ${arm.strategyType}`,
+        };
+    }
+    return null;
+}
+/**
+ * Validate split ratio
+ */
+function validateSplitRatio(splitRatio) {
+    if (typeof splitRatio !== 'number' || Number.isNaN(splitRatio)) {
+        return { field: 'splitRatio', message: 'Split ratio must be a number' };
+    }
+    if (splitRatio < 0 || splitRatio > 1) {
+        return { field: 'splitRatio', message: 'Split ratio must be between 0 and 1' };
+    }
+    return null;
+}
+/**
+ * Validate minimum samples per arm
+ */
+function validateMinSamples(minSamples) {
+    if (typeof minSamples !== 'number' || Number.isNaN(minSamples)) {
+        return { field: 'minSamplesPerArm', message: 'Minimum samples must be a number' };
+    }
+    if (!Number.isInteger(minSamples) || minSamples < 1) {
+        return { field: 'minSamplesPerArm', message: 'Minimum samples must be a positive integer' };
+    }
+    return null;
+}
+/**
+ * Validate UUID v4 format
+ */
+export function isValidUuidV4(id) {
+    const uuidV4Regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidV4Regex.test(id);
+}
+/**
+ * Validate complete experiment
+ */
+export function validateExperiment(experiment) {
+    const errors = [];
+    // Validate ID
+    if (!experiment.id || !isValidUuidV4(experiment.id)) {
+        errors.push({ field: 'id', message: 'ID must be a valid UUID v4' });
+    }
+    // Validate name
+    const nameError = validateName(experiment.name);
+    if (nameError)
+        errors.push(nameError);
+    // Validate description
+    const descError = validateDescription(experiment.description);
+    if (descError)
+        errors.push(descError);
+    // Validate hypothesis
+    const hypError = validateHypothesis(experiment.hypothesis);
+    if (hypError)
+        errors.push(hypError);
+    // Validate arms
+    const controlError = validateArm(experiment.control, 'control');
+    if (controlError)
+        errors.push(controlError);
+    const treatmentError = validateArm(experiment.treatment, 'treatment');
+    if (treatmentError)
+        errors.push(treatmentError);
+    // Validate split ratio
+    const splitError = validateSplitRatio(experiment.splitRatio);
+    if (splitError)
+        errors.push(splitError);
+    // Validate min samples
+    const samplesError = validateMinSamples(experiment.minSamplesPerArm);
+    if (samplesError)
+        errors.push(samplesError);
+    // Validate target metric exists
+    if (!experiment.targetMetric) {
+        errors.push({ field: 'targetMetric', message: 'Target metric is required' });
+    }
+    // Validate status
+    const validStatuses = ['draft', 'running', 'concluded', 'cancelled'];
+    if (!validStatuses.includes(experiment.status)) {
+        errors.push({ field: 'status', message: `Invalid status: ${experiment.status}` });
+    }
+    // Validate schema version
+    if (experiment.schemaVersion !== EXPERIMENT_SCHEMA_VERSION) {
+        errors.push({
+            field: 'schemaVersion',
+            message: `Invalid schema version: ${experiment.schemaVersion}`,
+        });
+    }
+    return errors;
+}
+/**
+ * Validate status transition
+ */
+export function canTransitionStatus(currentStatus, newStatus) {
+    const allowedTransitions = STATUS_TRANSITIONS[currentStatus];
+    return allowedTransitions.includes(newStatus);
+}
+/**
+ * Check if experiment is in terminal state
+ */
+export function isTerminalStatus(status) {
+    return status === 'concluded' || status === 'cancelled';
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Generate UUID v4
+ */
+export function generateExperimentId() {
+    // Use crypto.randomUUID if available (Node 16+)
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback implementation
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Get current ISO timestamp
+ */
+export function now() {
+    return new Date().toISOString();
+}
+/**
+ * Create a new experiment with defaults
+ */
+export function createExperimentDefinition(name, description, hypothesis, control, treatment, targetMetric, options) {
+    return {
+        id: generateExperimentId(),
+        name,
+        description,
+        hypothesis,
+        control,
+        treatment,
+        targetMetric,
+        secondaryMetrics: options?.secondaryMetrics || [],
+        splitRatio: options?.splitRatio ?? DEFAULT_SPLIT_RATIO,
+        minSamplesPerArm: options?.minSamplesPerArm ?? DEFAULT_MIN_SAMPLES,
+        status: 'draft',
+        createdAt: now(),
+        schemaVersion: EXPERIMENT_SCHEMA_VERSION,
+    };
+}
+//# sourceMappingURL=experiment-schema.js.map

package/dist/core/experiments/experiment-schema.js.map

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

package/dist/core/experiments/experiment-store.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Experiment Store - v17.0.0
+ *
+ * Storage and CRUD operations for A/B testing experiments.
+ * Persists to .dino/research/experiments/ directory.
+ *
+ * Features:
+ * - Create, read, update, delete experiments
+ * - Status transition enforcement
+ * - Single running experiment constraint
+ * - File-based persistence
+ */
+import type { Experiment, ExperimentStatus, ExperimentWinner } from './experiment-schema.js';
+/**
+ * Experiment index file structure
+ */
+export interface ExperimentIndex {
+    /** Schema version */
+    version: string;
+    /** Last updated timestamp */
+    lastUpdated: string;
+    /** List of experiment IDs */
+    experimentIds: string[];
+    /** Currently running experiment ID (null if none) */
+    runningExperimentId: string | null;
+}
+/**
+ * Filter options for listing experiments
+ */
+export interface ExperimentFilter {
+    /** Filter by status */
+    status?: ExperimentStatus;
+    /** Filter by winner */
+    winner?: ExperimentWinner;
+    /** Include only running experiment */
+    onlyRunning?: boolean;
+}
+/**
+ * Create a new experiment
+ *
+ * @param experiment - Experiment definition
+ * @param projectDir - Project root directory
+ * @throws Error if validation fails or another experiment is already running
+ */
+export declare function createExperiment(experiment: Experiment, projectDir?: string): Promise<void>;
+/**
+ * Get an experiment by ID
+ *
+ * @param experimentId - Experiment ID
+ * @param projectDir - Project root directory
+ * @returns The experiment, or null if not found
+ */
+export declare function getExperiment(experimentId: string, projectDir?: string): Promise<Experiment | null>;
+/**
+ * List all experiments with optional filtering
+ *
+ * @param filter - Filter options
+ * @param projectDir - Project root directory
+ * @returns Array of experiments matching the filter
+ */
+export declare function listExperiments(filter?: ExperimentFilter, projectDir?: string): Promise<Experiment[]>;
+/**
+ * Update experiment status
+ *
+ * @param experimentId - Experiment ID
+ * @param newStatus - New status
+ * @param projectDir - Project root directory
+ * @param winner - Optional winner (required when transitioning to 'concluded')
+ * @throws Error if transition is invalid or experiment not found
+ */
+export declare function updateExperimentStatus(experimentId: string, newStatus: ExperimentStatus, projectDir?: string, winner?: ExperimentWinner): Promise<void>;
+/**
+ * Delete an experiment
+ *
+ * @param experimentId - Experiment ID
+ * @param projectDir - Project root directory
+ * @throws Error if experiment is currently running
+ */
+export declare function deleteExperiment(experimentId: string, projectDir?: string): Promise<void>;
+/**
+ * Get the currently running experiment
+ *
+ * @param projectDir - Project root directory
+ * @returns The running experiment, or null if none
+ */
+export declare function getRunningExperiment(projectDir?: string): Promise<Experiment | null>;
+/**
+ * Check if an experiment is running
+ *
+ * @param projectDir - Project root directory
+ * @returns True if an experiment is currently running
+ */
+export declare function isExperimentRunning(projectDir?: string): Promise<boolean>;
+//# sourceMappingURL=experiment-store.d.ts.map

package/dist/core/experiments/experiment-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiment-store.d.ts","sourceRoot":"","sources":["../../../src/core/experiments/experiment-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAY5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,uBAAuB;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AA2FD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,UAAU,EACtB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5B;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,CAAC,EAAE,gBAAgB,EACzB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,gBAAgB,EAC3B,UAAU,GAAE,MAAsB,EAClC,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,GAAE,MAAsB,GACjC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9F"}

package/dist/core/experiments/experiment-store.js

@@ -0,0 +1,271 @@
+/**
+ * Experiment Store - v17.0.0
+ *
+ * Storage and CRUD operations for A/B testing experiments.
+ * Persists to .dino/research/experiments/ directory.
+ *
+ * Features:
+ * - Create, read, update, delete experiments
+ * - Status transition enforcement
+ * - Single running experiment constraint
+ * - File-based persistence
+ */
+import { join } from 'node:path';
+import { FileSystem } from '../../utils/file-system.js';
+import { DINO_DIR_NAME } from '../config/constants.js';
+import { canTransitionStatus, EXPERIMENT_SCHEMA_VERSION, isTerminalStatus, validateExperiment, } from './experiment-schema.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const EXPERIMENTS_DIR = 'experiments';
+const RESEARCH_DIR = 'research';
+const INDEX_FILE = 'index.json';
+// =============================================================================
+// Path Helpers
+// =============================================================================
+/**
+ * Get the experiments directory path
+ */
+function getExperimentsDir(projectDir = process.cwd()) {
+    return join(projectDir, DINO_DIR_NAME, RESEARCH_DIR, EXPERIMENTS_DIR);
+}
+/**
+ * Get the index file path
+ */
+function getIndexPath(projectDir = process.cwd()) {
+    return join(getExperimentsDir(projectDir), INDEX_FILE);
+}
+/**
+ * Get the experiment file path
+ */
+function getExperimentPath(experimentId, projectDir = process.cwd()) {
+    return join(getExperimentsDir(projectDir), `${experimentId}.json`);
+}
+/**
+ * Get current ISO timestamp
+ */
+function now() {
+    return new Date().toISOString();
+}
+// =============================================================================
+// Index Operations
+// =============================================================================
+/**
+ * Load experiment index
+ */
+async function loadIndex(projectDir = process.cwd()) {
+    const indexPath = getIndexPath(projectDir);
+    const data = await FileSystem.readJsonSafe(indexPath);
+    if (!data) {
+        return {
+            version: EXPERIMENT_SCHEMA_VERSION,
+            lastUpdated: now(),
+            experimentIds: [],
+            runningExperimentId: null,
+        };
+    }
+    return {
+        version: data.version || EXPERIMENT_SCHEMA_VERSION,
+        lastUpdated: data.lastUpdated || now(),
+        experimentIds: data.experimentIds || [],
+        runningExperimentId: data.runningExperimentId || null,
+    };
+}
+/**
+ * Save experiment index
+ */
+async function saveIndex(index, projectDir = process.cwd()) {
+    const indexPath = getIndexPath(projectDir);
+    index.lastUpdated = now();
+    // Ensure directory exists
+    const experimentsDir = getExperimentsDir(projectDir);
+    await FileSystem.createDirectory(experimentsDir);
+    await FileSystem.writeJson(indexPath, index);
+}
+// =============================================================================
+// CRUD Operations
+// =============================================================================
+/**
+ * Create a new experiment
+ *
+ * @param experiment - Experiment definition
+ * @param projectDir - Project root directory
+ * @throws Error if validation fails or another experiment is already running
+ */
+export async function createExperiment(experiment, projectDir = process.cwd()) {
+    // Validate experiment
+    const errors = validateExperiment(experiment);
+    if (errors.length > 0) {
+        const errorMessages = errors.map((e) => `${e.field}: ${e.message}`).join(', ');
+        throw new Error(`Experiment validation failed: ${errorMessages}`);
+    }
+    // Load index
+    const index = await loadIndex(projectDir);
+    // Check if experiment already exists
+    if (index.experimentIds.includes(experiment.id)) {
+        throw new Error(`Experiment with ID ${experiment.id} already exists`);
+    }
+    // If experiment is running, check constraint
+    if (experiment.status === 'running') {
+        if (index.runningExperimentId !== null) {
+            throw new Error(`Cannot create running experiment: experiment ${index.runningExperimentId} is already running`);
+        }
+        index.runningExperimentId = experiment.id;
+    }
+    // Save experiment file
+    const experimentPath = getExperimentPath(experiment.id, projectDir);
+    await FileSystem.writeJson(experimentPath, experiment);
+    // Update index
+    index.experimentIds.push(experiment.id);
+    await saveIndex(index, projectDir);
+}
+/**
+ * Get an experiment by ID
+ *
+ * @param experimentId - Experiment ID
+ * @param projectDir - Project root directory
+ * @returns The experiment, or null if not found
+ */
+export async function getExperiment(experimentId, projectDir = process.cwd()) {
+    const experimentPath = getExperimentPath(experimentId, projectDir);
+    const experiment = await FileSystem.readJsonSafe(experimentPath);
+    return experiment;
+}
+/**
+ * List all experiments with optional filtering
+ *
+ * @param filter - Filter options
+ * @param projectDir - Project root directory
+ * @returns Array of experiments matching the filter
+ */
+export async function listExperiments(filter, projectDir = process.cwd()) {
+    const index = await loadIndex(projectDir);
+    const experiments = [];
+    for (const id of index.experimentIds) {
+        const experiment = await getExperiment(id, projectDir);
+        if (!experiment)
+            continue;
+        // Apply filters
+        if (filter) {
+            if (filter.status && experiment.status !== filter.status)
+                continue;
+            if (filter.winner && experiment.winner !== filter.winner)
+                continue;
+            if (filter.onlyRunning && experiment.status !== 'running')
+                continue;
+        }
+        experiments.push(experiment);
+    }
+    return experiments;
+}
+/**
+ * Update experiment status
+ *
+ * @param experimentId - Experiment ID
+ * @param newStatus - New status
+ * @param projectDir - Project root directory
+ * @param winner - Optional winner (required when transitioning to 'concluded')
+ * @throws Error if transition is invalid or experiment not found
+ */
+export async function updateExperimentStatus(experimentId, newStatus, projectDir = process.cwd(), winner) {
+    // Load experiment
+    const experiment = await getExperiment(experimentId, projectDir);
+    if (!experiment) {
+        throw new Error(`Experiment ${experimentId} not found`);
+    }
+    // Check if already in terminal state
+    if (isTerminalStatus(experiment.status)) {
+        throw new Error(`Cannot update experiment in terminal state: ${experiment.status}`);
+    }
+    // Validate transition
+    if (!canTransitionStatus(experiment.status, newStatus)) {
+        throw new Error(`Invalid status transition: ${experiment.status} -> ${newStatus}`);
+    }
+    // Load index
+    const index = await loadIndex(projectDir);
+    // Handle running experiment constraint
+    if (newStatus === 'running') {
+        if (index.runningExperimentId !== null && index.runningExperimentId !== experimentId) {
+            throw new Error(`Cannot start experiment: experiment ${index.runningExperimentId} is already running`);
+        }
+        index.runningExperimentId = experimentId;
+        experiment.startedAt = now();
+    }
+    // Clear running experiment if transitioning away from running
+    if (experiment.status === 'running' && newStatus !== 'running') {
+        index.runningExperimentId = null;
+    }
+    // Update experiment
+    experiment.status = newStatus;
+    // Set timestamps
+    if (newStatus === 'concluded' || newStatus === 'cancelled') {
+        experiment.concludedAt = now();
+    }
+    // Set winner if provided
+    if (newStatus === 'concluded') {
+        if (!winner) {
+            throw new Error('Winner must be specified when concluding experiment');
+        }
+        experiment.winner = winner;
+    }
+    // Save experiment
+    const experimentPath = getExperimentPath(experimentId, projectDir);
+    await FileSystem.writeJson(experimentPath, experiment);
+    // Save index
+    await saveIndex(index, projectDir);
+}
+/**
+ * Delete an experiment
+ *
+ * @param experimentId - Experiment ID
+ * @param projectDir - Project root directory
+ * @throws Error if experiment is currently running
+ */
+export async function deleteExperiment(experimentId, projectDir = process.cwd()) {
+    // Load experiment
+    const experiment = await getExperiment(experimentId, projectDir);
+    if (!experiment) {
+        throw new Error(`Experiment ${experimentId} not found`);
+    }
+    // Cannot delete running experiment
+    if (experiment.status === 'running') {
+        throw new Error('Cannot delete running experiment. Cancel it first.');
+    }
+    // Load index
+    const index = await loadIndex(projectDir);
+    // Remove from index
+    index.experimentIds = index.experimentIds.filter((id) => id !== experimentId);
+    // Clear running experiment ID if it matches
+    if (index.runningExperimentId === experimentId) {
+        index.runningExperimentId = null;
+    }
+    // Delete experiment file
+    const experimentPath = getExperimentPath(experimentId, projectDir);
+    await FileSystem.remove(experimentPath);
+    // Save index
+    await saveIndex(index, projectDir);
+}
+/**
+ * Get the currently running experiment
+ *
+ * @param projectDir - Project root directory
+ * @returns The running experiment, or null if none
+ */
+export async function getRunningExperiment(projectDir = process.cwd()) {
+    const index = await loadIndex(projectDir);
+    if (!index.runningExperimentId) {
+        return null;
+    }
+    return await getExperiment(index.runningExperimentId, projectDir);
+}
+/**
+ * Check if an experiment is running
+ *
+ * @param projectDir - Project root directory
+ * @returns True if an experiment is currently running
+ */
+export async function isExperimentRunning(projectDir = process.cwd()) {
+    const index = await loadIndex(projectDir);
+    return index.runningExperimentId !== null;
+}
+//# sourceMappingURL=experiment-store.js.map

package/dist/core/experiments/experiment-store.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Experiments Module - v17.0.0
+ *
+ * A/B Testing Framework for Context Engineering
+ *
+ * Exports:
+ * - Experiment schema types and validation
+ * - Experiment store CRUD operations
+ */
+export type { SessionAssignment } from './assignment-engine.js';
+export { assignSession, assignSessionWithRatio, cacheSessionAssignment, clearAssignmentCache, createAssignmentRecord, getOrAssignSession, getSessionArm, isValidSessionId, } from './assignment-engine.js';
+export type { Experiment, ExperimentArm, ExperimentArmType, ExperimentStatus, ExperimentWinner, ValidationError, } from './experiment-schema.js';
+export { canTransitionStatus, createExperimentDefinition, DEFAULT_MIN_SAMPLES, DEFAULT_SPLIT_RATIO, EXPERIMENT_SCHEMA_VERSION, generateExperimentId, isTerminalStatus, isValidUuidV4, MAX_DESCRIPTION_LENGTH, MAX_HYPOTHESIS_LENGTH, MAX_NAME_LENGTH, now, STATUS_TRANSITIONS, validateExperiment, } from './experiment-schema.js';
+export type { ExperimentFilter, ExperimentIndex, } from './experiment-store.js';
+export { createExperiment, deleteExperiment, getExperiment, getRunningExperiment, isExperimentRunning, listExperiments, updateExperimentStatus, } from './experiment-store.js';
+export type { ArmMetrics, ExperimentSummary, SegmentedMetrics, } from './metrics-segmenter.js';
+export { formatExperimentSummary, getExperimentSummary, queryMetricsByExperiment, queryMetricsByExperimentAndOperation, } from './metrics-segmenter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/experiments/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,GAAG,EACH,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAG9B,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,oCAAoC,GACrC,MAAM,wBAAwB,CAAA"}

package/dist/core/experiments/index.js

@@ -0,0 +1,14 @@
+/**
+ * Experiments Module - v17.0.0
+ *
+ * A/B Testing Framework for Context Engineering
+ *
+ * Exports:
+ * - Experiment schema types and validation
+ * - Experiment store CRUD operations
+ */
+export { assignSession, assignSessionWithRatio, cacheSessionAssignment, clearAssignmentCache, createAssignmentRecord, getOrAssignSession, getSessionArm, isValidSessionId, } from './assignment-engine.js';
+export { canTransitionStatus, createExperimentDefinition, DEFAULT_MIN_SAMPLES, DEFAULT_SPLIT_RATIO, EXPERIMENT_SCHEMA_VERSION, generateExperimentId, isTerminalStatus, isValidUuidV4, MAX_DESCRIPTION_LENGTH, MAX_HYPOTHESIS_LENGTH, MAX_NAME_LENGTH, now, STATUS_TRANSITIONS, validateExperiment, } from './experiment-schema.js';
+export { createExperiment, deleteExperiment, getExperiment, getRunningExperiment, isExperimentRunning, listExperiments, updateExperimentStatus, } from './experiment-store.js';
+export { formatExperimentSummary, getExperimentSummary, queryMetricsByExperiment, queryMetricsByExperimentAndOperation, } from './metrics-segmenter.js';
+//# sourceMappingURL=index.js.map