agentic-qe 3.2.3 → 3.3.1

package/v3/dist/learning/experience-capture.d.ts

@@ -0,0 +1,266 @@
+/**
+ * AQE Experience Capture Module
+ * Phase 4: Self-Learning Features
+ *
+ * Captures task execution experiences for pattern learning.
+ * Works standalone and integrates with Claude Flow trajectories when available.
+ *
+ * Features:
+ * - Task execution recording
+ * - Outcome capture with quality metrics
+ * - Pattern extraction from successful tasks
+ * - Pattern promotion after threshold uses
+ * - Cross-domain experience sharing
+ */
+import type { MemoryBackend, EventBus } from '../kernel/interfaces.js';
+import type { Result } from '../shared/types/index.js';
+import type { QEDomain } from './qe-patterns.js';
+import type { PatternStore } from './pattern-store.js';
+/**
+ * Task execution experience
+ */
+export interface TaskExperience {
+    /** Unique experience ID */
+    id: string;
+    /** Task description */
+    task: string;
+    /** Agent that executed the task */
+    agent?: string;
+    /** QE Domain (if applicable) */
+    domain?: QEDomain;
+    /** Model used (haiku/sonnet/opus) */
+    model?: 'haiku' | 'sonnet' | 'opus';
+    /** Task started timestamp */
+    startedAt: number;
+    /** Task completed timestamp */
+    completedAt: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Execution steps */
+    steps: ExperienceStep[];
+    /** Success indicator */
+    success: boolean;
+    /** Quality score (0-1) */
+    quality: number;
+    /** Feedback provided */
+    feedback?: string;
+    /** Extracted patterns (if any) */
+    patterns?: string[];
+    /** Claude Flow trajectory ID (if available) */
+    trajectoryId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Experience step
+ */
+export interface ExperienceStep {
+    /** Action taken */
+    action: string;
+    /** Result of the action */
+    result?: string;
+    /** Quality score for this step (0-1) */
+    quality?: number;
+    /** Timestamp */
+    timestamp: number;
+    /** Tokens used (if tracked) */
+    tokensUsed?: number;
+}
+/**
+ * Experience capture configuration
+ */
+export interface ExperienceCaptureConfig {
+    /** Storage namespace */
+    namespace: string;
+    /** Minimum quality for pattern extraction (0-1) */
+    minQualityForPatternExtraction: number;
+    /** Similarity threshold for pattern matching */
+    similarityThreshold: number;
+    /** Promotion threshold (successful uses) */
+    promotionThreshold: number;
+    /** Maximum experiences to keep per domain */
+    maxExperiencesPerDomain: number;
+    /** Enable cross-domain sharing */
+    enableCrossDomainSharing: boolean;
+    /** Auto-cleanup old experiences */
+    autoCleanup: boolean;
+    /** Cleanup interval in milliseconds */
+    cleanupIntervalMs: number;
+}
+/**
+ * Default experience capture configuration
+ */
+export declare const DEFAULT_EXPERIENCE_CONFIG: ExperienceCaptureConfig;
+/**
+ * Experience capture statistics
+ */
+export interface ExperienceCaptureStats {
+    /** Total experiences captured */
+    totalExperiences: number;
+    /** Experiences by domain */
+    byDomain: Record<QEDomain, number>;
+    /** Success rate */
+    successRate: number;
+    /** Average quality */
+    avgQuality: number;
+    /** Patterns extracted */
+    patternsExtracted: number;
+    /** Patterns promoted */
+    patternsPromoted: number;
+}
+/**
+ * Pattern extraction result
+ */
+export interface PatternExtractionResult {
+    /** Whether a new pattern was created */
+    newPattern: boolean;
+    /** Pattern ID (new or existing) */
+    patternId?: string;
+    /** Whether an existing pattern was reinforced */
+    reinforced: boolean;
+    /** Whether pattern was promoted */
+    promoted: boolean;
+}
+/**
+ * Experience Capture Service
+ *
+ * Captures and processes task execution experiences for pattern learning.
+ */
+export declare class ExperienceCaptureService {
+    private readonly memory;
+    private readonly patternStore?;
+    private readonly eventBus?;
+    private readonly config;
+    private initialized;
+    private cleanupTimer?;
+    private activeExperiences;
+    private stats;
+    constructor(memory: MemoryBackend, patternStore?: PatternStore | undefined, eventBus?: EventBus | undefined, config?: Partial<ExperienceCaptureConfig>);
+    /**
+     * Initialize the experience capture service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start capturing a task experience
+     */
+    startCapture(task: string, options?: {
+        agent?: string;
+        domain?: QEDomain;
+        model?: 'haiku' | 'sonnet' | 'opus';
+        trajectoryId?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    /**
+     * Record a step in the experience
+     */
+    recordStep(experienceId: string, step: Omit<ExperienceStep, 'timestamp'>): void;
+    /**
+     * Complete and capture the experience
+     */
+    completeCapture(experienceId: string, outcome: {
+        success: boolean;
+        quality?: number;
+        feedback?: string;
+    }): Promise<Result<TaskExperience>>;
+    /**
+     * Get an active experience
+     */
+    getActiveExperience(experienceId: string): TaskExperience | undefined;
+    /**
+     * Get experience by ID
+     */
+    getExperience(experienceId: string): Promise<TaskExperience | null>;
+    /**
+     * Search experiences
+     */
+    searchExperiences(options?: {
+        domain?: QEDomain;
+        agent?: string;
+        success?: boolean;
+        minQuality?: number;
+        limit?: number;
+    }): Promise<TaskExperience[]>;
+    /**
+     * Get experience capture statistics
+     */
+    getStats(): Promise<ExperienceCaptureStats>;
+    /**
+     * Extract pattern from experience
+     */
+    extractPattern(experience: TaskExperience): Promise<PatternExtractionResult>;
+    /**
+     * Share experience across domains
+     */
+    shareAcrossDomains(experience: TaskExperience): Promise<void>;
+    /**
+     * Cleanup old experiences
+     */
+    cleanup(): Promise<{
+        removed: number;
+    }>;
+    /**
+     * Dispose the service
+     */
+    dispose(): Promise<void>;
+    /**
+     * Store experience in memory
+     */
+    private storeExperience;
+    /**
+     * Delete experience
+     */
+    private deleteExperience;
+    /**
+     * Calculate quality from experience steps
+     */
+    private calculateQuality;
+    /**
+     * Update statistics
+     */
+    private updateStats;
+    /**
+     * Calculate average quality across all experiences
+     */
+    private calculateAvgQuality;
+    /**
+     * Convert experience to pattern options
+     */
+    private experienceToPatternOptions;
+    /**
+     * Detect pattern type from task description
+     */
+    private detectPatternType;
+    /**
+     * Generate pattern name from experience
+     */
+    private generatePatternName;
+    /**
+     * Extract tags from experience
+     */
+    private extractTags;
+    /**
+     * Detect test type from task
+     */
+    private detectTestType;
+    /**
+     * Get related domains for cross-domain sharing
+     */
+    private getRelatedDomains;
+    /**
+     * Emit experience captured event
+     */
+    private emitExperienceCaptured;
+    /**
+     * Load stats from persistence
+     */
+    private loadStats;
+    /**
+     * Save stats to persistence
+     */
+    private saveStats;
+}
+/**
+ * Create experience capture service
+ */
+export declare function createExperienceCaptureService(memory: MemoryBackend, patternStore?: PatternStore, eventBus?: EventBus, config?: Partial<ExperienceCaptureConfig>): ExperienceCaptureService;
+//# sourceMappingURL=experience-capture.d.ts.map

package/v3/dist/learning/experience-capture.d.ts.map

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