agentic-qe 1.8.3 → 1.8.4

package/dist/persistence/reasoning-store.js

@@ -0,0 +1,440 @@
+"use strict";
+/**
+ * @fileoverview Reasoning chain store for capturing agent reasoning processes
+ * @module persistence/reasoning-store
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReasoningStore = void 0;
+const uuid_1 = require("uuid");
+const schema_1 = require("./schema");
+/**
+ * ReasoningStore captures and persists agent reasoning processes
+ *
+ * @example
+ * ```typescript
+ * const store = new ReasoningStore({ dbPath: './data/reasoning.db' });
+ *
+ * // Start a reasoning chain
+ * const chain = store.startChain({
+ *   session_id: 'session-123',
+ *   agent_id: 'test-generator',
+ *   context: { task: 'Generate unit tests' }
+ * });
+ *
+ * // Add reasoning steps
+ * store.addStep({
+ *   chain_id: chain.id,
+ *   thought_type: 'observation',
+ *   content: 'Analyzing source code structure...',
+ *   confidence: 0.9,
+ *   token_count: 150
+ * });
+ *
+ * // Complete the chain
+ * store.completeChain(chain.id, 'completed');
+ * ```
+ */
+class ReasoningStore {
+    /**
+     * Create a new ReasoningStore instance
+     * @param config - Persistence configuration
+     */
+    constructor(config = {}) {
+        this.config = { ...schema_1.DEFAULT_PERSISTENCE_CONFIG, ...config };
+        this.db = (0, schema_1.createDatabase)(this.config);
+        this.statements = this.prepareStatements();
+    }
+    /**
+     * Prepare SQL statements for performance
+     */
+    prepareStatements() {
+        return {
+            insertChain: this.db.prepare(`
+        INSERT INTO reasoning_chains (id, session_id, agent_id, created_at, status, context)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `),
+            insertStep: this.db.prepare(`
+        INSERT INTO reasoning_steps (id, chain_id, step_order, thought_type, content, confidence, token_count, created_at, metadata)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `),
+            updateChainStatus: this.db.prepare(`
+        UPDATE reasoning_chains
+        SET status = ?, completed_at = ?
+        WHERE id = ?
+      `),
+            getChainById: this.db.prepare(`
+        SELECT * FROM reasoning_chains WHERE id = ?
+      `),
+            getStepsByChain: this.db.prepare(`
+        SELECT * FROM reasoning_steps
+        WHERE chain_id = ?
+        ORDER BY step_order ASC
+      `),
+            getChainsBySession: this.db.prepare(`
+        SELECT * FROM reasoning_chains
+        WHERE session_id = ?
+        ORDER BY created_at DESC
+        LIMIT ? OFFSET ?
+      `),
+            getChainsByAgent: this.db.prepare(`
+        SELECT * FROM reasoning_chains
+        WHERE agent_id = ?
+        ORDER BY created_at DESC
+        LIMIT ? OFFSET ?
+      `),
+            getStepCount: this.db.prepare(`
+        SELECT COUNT(*) as count FROM reasoning_steps WHERE chain_id = ?
+      `),
+            getMaxStepOrder: this.db.prepare(`
+        SELECT COALESCE(MAX(step_order), 0) as max_order
+        FROM reasoning_steps
+        WHERE chain_id = ?
+      `),
+        };
+    }
+    /**
+     * Deserialize chain record from database row
+     */
+    deserializeChain(row) {
+        return {
+            id: row.id,
+            session_id: row.session_id,
+            agent_id: row.agent_id,
+            created_at: row.created_at,
+            completed_at: row.completed_at,
+            status: row.status,
+            context: JSON.parse(row.context),
+        };
+    }
+    /**
+     * Deserialize step record from database row
+     */
+    deserializeStep(row) {
+        return {
+            id: row.id,
+            chain_id: row.chain_id,
+            step_order: row.step_order,
+            thought_type: row.thought_type,
+            content: row.content,
+            confidence: row.confidence,
+            token_count: row.token_count,
+            created_at: row.created_at,
+            metadata: JSON.parse(row.metadata),
+        };
+    }
+    /**
+     * Start a new reasoning chain
+     * @param input - Chain creation input
+     * @returns Created chain record
+     */
+    startChain(input) {
+        const id = (0, uuid_1.v4)();
+        const created_at = new Date().toISOString();
+        const context = JSON.stringify(input.context || {});
+        let retries = this.config.maxRetries || 3;
+        while (retries > 0) {
+            try {
+                this.statements.insertChain.run(id, input.session_id, input.agent_id, created_at, 'in_progress', context);
+                break;
+            }
+            catch (error) {
+                retries--;
+                if (retries === 0) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Failed to start chain after retries: ${errorMessage}`);
+                }
+                const start = Date.now();
+                while (Date.now() - start < 100) {
+                    // Busy wait for synchronous retry
+                }
+            }
+        }
+        return {
+            id,
+            session_id: input.session_id,
+            agent_id: input.agent_id,
+            created_at,
+            completed_at: null,
+            status: 'in_progress',
+            context: input.context || {},
+        };
+    }
+    /**
+     * Add a reasoning step to a chain
+     * @param input - Step creation input
+     * @returns Created step record
+     */
+    addStep(input) {
+        const id = (0, uuid_1.v4)();
+        const created_at = new Date().toISOString();
+        const metadata = JSON.stringify(input.metadata || {});
+        // Get next step order
+        const maxOrderResult = this.statements.getMaxStepOrder.get(input.chain_id);
+        const step_order = maxOrderResult.max_order + 1;
+        let retries = this.config.maxRetries || 3;
+        while (retries > 0) {
+            try {
+                this.statements.insertStep.run(id, input.chain_id, step_order, input.thought_type, input.content, input.confidence, input.token_count, created_at, metadata);
+                break;
+            }
+            catch (error) {
+                retries--;
+                if (retries === 0) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Failed to add step after retries: ${errorMessage}`);
+                }
+                const start = Date.now();
+                while (Date.now() - start < 100) {
+                    // Busy wait for synchronous retry
+                }
+            }
+        }
+        return {
+            id,
+            chain_id: input.chain_id,
+            step_order,
+            thought_type: input.thought_type,
+            content: input.content,
+            confidence: input.confidence,
+            token_count: input.token_count,
+            created_at,
+            metadata: input.metadata || {},
+        };
+    }
+    /**
+     * Complete a reasoning chain
+     * @param chainId - Chain identifier
+     * @param status - Final status (completed, failed, abandoned)
+     * @returns Updated chain record
+     */
+    completeChain(chainId, status = 'completed') {
+        const completed_at = new Date().toISOString();
+        this.statements.updateChainStatus.run(status, completed_at, chainId);
+        return this.getChainById(chainId);
+    }
+    /**
+     * Get chain by ID
+     * @param chainId - Chain identifier
+     * @returns Chain record or null
+     */
+    getChainById(chainId) {
+        const row = this.statements.getChainById.get(chainId);
+        return row ? this.deserializeChain(row) : null;
+    }
+    /**
+     * Get chain with all steps
+     * @param chainId - Chain identifier
+     * @returns Chain with steps or null
+     */
+    getChainWithSteps(chainId) {
+        const chain = this.getChainById(chainId);
+        if (!chain)
+            return null;
+        const stepRows = this.statements.getStepsByChain.all(chainId);
+        const steps = stepRows.map(row => this.deserializeStep(row));
+        return { ...chain, steps };
+    }
+    /**
+     * Get chains by session ID
+     * @param sessionId - Session identifier
+     * @param options - Query options
+     * @returns Array of chains
+     */
+    getChainsBySession(sessionId, options = {}) {
+        const { limit = 100, offset = 0, includeSteps = false } = options;
+        const rows = this.statements.getChainsBySession.all(sessionId, limit, offset);
+        const chains = rows.map(row => this.deserializeChain(row));
+        if (includeSteps) {
+            return chains.map(chain => {
+                const stepRows = this.statements.getStepsByChain.all(chain.id);
+                const steps = stepRows.map(row => this.deserializeStep(row));
+                return { ...chain, steps };
+            });
+        }
+        return chains;
+    }
+    /**
+     * Get chains by agent ID
+     * @param agentId - Agent identifier
+     * @param options - Query options
+     * @returns Array of chains
+     */
+    getChainsByAgent(agentId, options = {}) {
+        const { limit = 100, offset = 0 } = options;
+        const rows = this.statements.getChainsByAgent.all(agentId, limit, offset);
+        return rows.map(row => this.deserializeChain(row));
+    }
+    /**
+     * Get chains by status
+     * @param status - Chain status
+     * @param limit - Maximum results
+     * @returns Array of chains
+     */
+    getChainsByStatus(status, limit = 100) {
+        const rows = this.db.prepare(`
+      SELECT * FROM reasoning_chains
+      WHERE status = ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(status, limit);
+        return rows.map(row => this.deserializeChain(row));
+    }
+    /**
+     * Get step count for a chain
+     * @param chainId - Chain identifier
+     * @returns Number of steps
+     */
+    getStepCount(chainId) {
+        const result = this.statements.getStepCount.get(chainId);
+        return result.count;
+    }
+    /**
+     * Get total token count for a chain
+     * @param chainId - Chain identifier
+     * @returns Total tokens used
+     */
+    getTotalTokens(chainId) {
+        const result = this.db.prepare(`
+      SELECT COALESCE(SUM(token_count), 0) as total
+      FROM reasoning_steps
+      WHERE chain_id = ?
+    `).get(chainId);
+        return result.total;
+    }
+    /**
+     * Get average confidence for a chain
+     * @param chainId - Chain identifier
+     * @returns Average confidence score
+     */
+    getAverageConfidence(chainId) {
+        const result = this.db.prepare(`
+      SELECT COALESCE(AVG(confidence), 0) as avg_confidence
+      FROM reasoning_steps
+      WHERE chain_id = ?
+    `).get(chainId);
+        return result.avg_confidence;
+    }
+    /**
+     * Get steps by thought type
+     * @param thoughtType - Type of thought
+     * @param limit - Maximum results
+     * @returns Array of steps
+     */
+    getStepsByType(thoughtType, limit = 100) {
+        const rows = this.db.prepare(`
+      SELECT * FROM reasoning_steps
+      WHERE thought_type = ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(thoughtType, limit);
+        return rows.map(row => this.deserializeStep(row));
+    }
+    /**
+     * Search chains by context
+     * @param key - Context key to search
+     * @param value - Value to match
+     * @param limit - Maximum results
+     * @returns Matching chains
+     */
+    searchByContext(key, value, limit = 100) {
+        const pattern = `%"${key}":${JSON.stringify(value)}%`;
+        const rows = this.db.prepare(`
+      SELECT * FROM reasoning_chains
+      WHERE context LIKE ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(pattern, limit);
+        return rows.map(row => this.deserializeChain(row));
+    }
+    /**
+     * Get reasoning chain statistics
+     * @returns Statistics about stored chains
+     */
+    getStatistics() {
+        const chainStats = this.db.prepare(`
+      SELECT
+        COUNT(*) as totalChains,
+        SUM(CASE WHEN status = 'completed' THEN 1 ELSE 0 END) as completedChains,
+        SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) as failedChains
+      FROM reasoning_chains
+    `).get();
+        const stepStats = this.db.prepare(`
+      SELECT
+        COUNT(*) as totalSteps,
+        AVG(token_count) as avgTokens,
+        AVG(confidence) as avgConfidence
+      FROM reasoning_steps
+    `).get();
+        return {
+            totalChains: chainStats.totalChains,
+            totalSteps: stepStats.totalSteps,
+            completedChains: chainStats.completedChains,
+            failedChains: chainStats.failedChains,
+            avgStepsPerChain: chainStats.totalChains > 0
+                ? stepStats.totalSteps / chainStats.totalChains
+                : 0,
+            avgTokensPerChain: chainStats.totalChains > 0
+                ? (stepStats.avgTokens * stepStats.totalSteps) / chainStats.totalChains
+                : 0,
+            avgConfidence: stepStats.avgConfidence || 0,
+        };
+    }
+    /**
+     * Delete completed chains older than specified date
+     * @param olderThan - ISO timestamp cutoff
+     * @returns Number of deleted chains
+     */
+    deleteOldChains(olderThan) {
+        // Delete steps first due to foreign key
+        this.db.prepare(`
+      DELETE FROM reasoning_steps
+      WHERE chain_id IN (
+        SELECT id FROM reasoning_chains
+        WHERE created_at < ? AND status IN ('completed', 'failed', 'abandoned')
+      )
+    `).run(olderThan);
+        const result = this.db.prepare(`
+      DELETE FROM reasoning_chains
+      WHERE created_at < ? AND status IN ('completed', 'failed', 'abandoned')
+    `).run(olderThan);
+        return result.changes;
+    }
+    /**
+     * Export chain as JSON for analysis
+     * @param chainId - Chain identifier
+     * @returns JSON-serializable chain data
+     */
+    exportChain(chainId) {
+        const chain = this.getChainWithSteps(chainId);
+        if (!chain)
+            return null;
+        return {
+            id: chain.id,
+            session_id: chain.session_id,
+            agent_id: chain.agent_id,
+            created_at: chain.created_at,
+            completed_at: chain.completed_at,
+            status: chain.status,
+            context: chain.context,
+            total_tokens: this.getTotalTokens(chainId),
+            avg_confidence: this.getAverageConfidence(chainId),
+            steps: chain.steps.map(step => ({
+                order: step.step_order,
+                type: step.thought_type,
+                content: step.content,
+                confidence: step.confidence,
+                tokens: step.token_count,
+                timestamp: step.created_at,
+                metadata: step.metadata,
+            })),
+        };
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        (0, schema_1.closeDatabase)(this.db);
+    }
+}
+exports.ReasoningStore = ReasoningStore;
+//# sourceMappingURL=reasoning-store.js.map

package/dist/persistence/reasoning-store.js.map

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

package/dist/persistence/schema.d.ts

@@ -0,0 +1,181 @@
+/**
+ * @fileoverview Database schema types and migration logic for AQE persistence layer
+ * @module persistence/schema
+ */
+import Database from 'better-sqlite3';
+/**
+ * Event types for telemetry tracking
+ */
+export type EventType = 'agent_started' | 'agent_completed' | 'agent_error' | 'test_generated' | 'test_executed' | 'coverage_analyzed' | 'quality_gate_passed' | 'quality_gate_failed' | 'pattern_matched' | 'learning_completed' | 'custom';
+/**
+ * Event record for telemetry tracking
+ */
+export interface EventRecord {
+    id: string;
+    timestamp: string;
+    agent_id: string;
+    event_type: EventType;
+    payload: Record<string, unknown>;
+    correlation_id: string | null;
+    session_id: string;
+}
+/**
+ * Input for creating a new event
+ */
+export interface CreateEventInput {
+    agent_id: string;
+    event_type: EventType;
+    payload: Record<string, unknown>;
+    correlation_id?: string;
+    session_id: string;
+}
+/**
+ * Types of reasoning steps
+ */
+export type ThoughtType = 'observation' | 'hypothesis' | 'decision' | 'validation' | 'conclusion' | 'action';
+/**
+ * Status of a reasoning chain
+ */
+export type ChainStatus = 'in_progress' | 'completed' | 'failed' | 'abandoned';
+/**
+ * Reasoning chain record
+ */
+export interface ReasoningChain {
+    id: string;
+    session_id: string;
+    agent_id: string;
+    created_at: string;
+    completed_at: string | null;
+    status: ChainStatus;
+    context: Record<string, unknown>;
+}
+/**
+ * Reasoning step within a chain
+ */
+export interface ReasoningStep {
+    id: string;
+    chain_id: string;
+    step_order: number;
+    thought_type: ThoughtType;
+    content: string;
+    confidence: number;
+    token_count: number;
+    created_at: string;
+    metadata: Record<string, unknown>;
+}
+/**
+ * Input for starting a new reasoning chain
+ */
+export interface StartChainInput {
+    session_id: string;
+    agent_id: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * Input for adding a reasoning step
+ */
+export interface AddStepInput {
+    chain_id: string;
+    thought_type: ThoughtType;
+    content: string;
+    confidence: number;
+    token_count: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete chain with all steps
+ */
+export interface ReasoningChainWithSteps extends ReasoningChain {
+    steps: ReasoningStep[];
+}
+/**
+ * Aggregation window periods
+ */
+export type AggregationPeriod = '1min' | '5min' | '1hour' | '1day';
+/**
+ * Individual quality metric record
+ */
+export interface QualityMetric {
+    id: string;
+    timestamp: string;
+    agent_id: string;
+    metric_name: string;
+    metric_value: number;
+    dimensions: Record<string, string>;
+}
+/**
+ * Aggregated metrics for a time period
+ */
+export interface AggregatedMetric {
+    id: string;
+    period_start: string;
+    period_end: string;
+    agent_id: string;
+    metric_name: string;
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+}
+/**
+ * Input for recording a metric
+ */
+export interface RecordMetricInput {
+    agent_id: string;
+    metric_name: string;
+    metric_value: number;
+    dimensions?: Record<string, string>;
+}
+/**
+ * Metric trend data point
+ */
+export interface MetricTrendPoint {
+    timestamp: string;
+    value: number;
+    count: number;
+}
+/**
+ * Agent performance summary
+ */
+export interface AgentPerformance {
+    agent_id: string;
+    total_events: number;
+    avg_duration_ms: number;
+    success_rate: number;
+    metrics: Record<string, number>;
+}
+/**
+ * Configuration for persistence layer
+ */
+export interface PersistenceConfig {
+    dbPath: string;
+    enableWAL?: boolean;
+    busyTimeout?: number;
+    maxRetries?: number;
+}
+/**
+ * Default persistence configuration
+ */
+export declare const DEFAULT_PERSISTENCE_CONFIG: PersistenceConfig;
+/**
+ * Current schema version
+ */
+export declare const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Initialize database schema
+ * @param db - Database instance
+ */
+export declare function initializeSchema(db: Database.Database): void;
+/**
+ * Create database connection with configuration
+ * @param config - Persistence configuration
+ * @returns Configured database instance
+ */
+export declare function createDatabase(config?: Partial<PersistenceConfig>): Database.Database;
+/**
+ * Close database connection safely
+ * @param db - Database instance to close
+ */
+export declare function closeDatabase(db: Database.Database): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/persistence/schema.d.ts.map

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