attocode 0.1.0 → 0.1.2

package/dist/src/integrations/learning-store.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Learning Store Integration
+ *
+ * Provides cross-session persistence for failure patterns and learnings.
+ * Extends the failure-evidence system with long-term memory.
+ *
+ * Features:
+ * - SQLite persistence for learnings
+ * - Pattern extraction from failures
+ * - User validation workflow
+ * - Retrieval of relevant learnings for new sessions
+ *
+ * @example
+ * ```typescript
+ * const store = createLearningStore({
+ *   dbPath: '.agent/learnings.db',
+ *   requireValidation: true,
+ * });
+ *
+ * // Connect failure tracker to store
+ * store.connectFailureTracker(tracker);
+ *
+ * // Learnings are auto-extracted and proposed
+ * store.on((event) => {
+ *   if (event.type === 'learning.proposed') {
+ *     // Ask user to validate
+ *     const approved = await askUser(event.learning.description);
+ *     if (approved) {
+ *       store.validateLearning(event.learning.id, true);
+ *     }
+ *   }
+ * });
+ *
+ * // Retrieve relevant learnings for context
+ * const learnings = store.retrieveRelevant('file operations', 5);
+ * ```
+ */
+import { type FailureTracker, type Failure, type FailurePattern, type FailureCategory } from '../tricks/failure-evidence.js';
+/**
+ * Status of a learning.
+ */
+export type LearningStatus = 'proposed' | 'validated' | 'rejected' | 'archived';
+/**
+ * Type of learning.
+ */
+export type LearningType = 'pattern' | 'workaround' | 'antipattern' | 'best_practice' | 'gotcha';
+/**
+ * A learning record.
+ */
+export interface Learning {
+    /** Unique ID */
+    id: string;
+    /** When created */
+    createdAt: string;
+    /** When last updated */
+    updatedAt: string;
+    /** Learning type */
+    type: LearningType;
+    /** Current status */
+    status: LearningStatus;
+    /** Short description */
+    description: string;
+    /** Detailed explanation */
+    details?: string;
+    /** Related categories */
+    categories: FailureCategory[];
+    /** Related actions/tools */
+    actions: string[];
+    /** Keywords for retrieval */
+    keywords: string[];
+    /** How often this learning was applied */
+    applyCount: number;
+    /** How often it helped */
+    helpCount: number;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Original failure IDs that led to this learning */
+    sourceFailureIds: string[];
+    /** User notes */
+    userNotes?: string;
+}
+/**
+ * Input for proposing a learning.
+ */
+export interface LearningProposal {
+    /** Learning type */
+    type: LearningType;
+    /** Short description */
+    description: string;
+    /** Detailed explanation */
+    details?: string;
+    /** Related categories */
+    categories?: FailureCategory[];
+    /** Related actions */
+    actions?: string[];
+    /** Keywords for retrieval */
+    keywords?: string[];
+    /** Source failures */
+    sourceFailures?: Failure[];
+    /** Initial confidence */
+    confidence?: number;
+}
+/**
+ * Configuration for learning store.
+ */
+export interface LearningStoreConfig {
+    /** Path to SQLite database */
+    dbPath?: string;
+    /** Whether to require user validation */
+    requireValidation?: boolean;
+    /** Minimum confidence to auto-validate */
+    autoValidateThreshold?: number;
+    /** Max learnings to keep */
+    maxLearnings?: number;
+    /** Whether to use in-memory database (for testing) */
+    inMemory?: boolean;
+}
+/**
+ * Events emitted by learning store.
+ */
+export type LearningStoreEvent = {
+    type: 'learning.proposed';
+    learning: Learning;
+} | {
+    type: 'learning.validated';
+    learningId: string;
+} | {
+    type: 'learning.rejected';
+    learningId: string;
+    reason?: string;
+} | {
+    type: 'learning.applied';
+    learningId: string;
+    context: string;
+} | {
+    type: 'learning.helped';
+    learningId: string;
+} | {
+    type: 'pattern.extracted';
+    pattern: FailurePattern;
+    learning: Learning;
+};
+export type LearningStoreEventListener = (event: LearningStoreEvent) => void;
+/**
+ * Manages persistent storage and retrieval of learnings.
+ */
+export declare class LearningStore {
+    private config;
+    private db;
+    private listeners;
+    private failureTrackerUnsubscribe?;
+    constructor(config?: LearningStoreConfig);
+    /**
+     * Initialize the database schema.
+     */
+    private initializeSchema;
+    /**
+     * Connect a failure tracker to automatically extract learnings.
+     */
+    connectFailureTracker(tracker: FailureTracker): () => void;
+    /**
+     * Propose a new learning.
+     */
+    proposeLearning(proposal: LearningProposal): Learning;
+    /**
+     * Validate a proposed learning.
+     */
+    validateLearning(learningId: string, approved: boolean, reason?: string): boolean;
+    /**
+     * Record that a learning was applied.
+     */
+    recordApply(learningId: string, context: string): boolean;
+    /**
+     * Record that a learning helped.
+     */
+    recordHelped(learningId: string): boolean;
+    /**
+     * Get a learning by ID.
+     */
+    getLearning(id: string): Learning | null;
+    /**
+     * Get all validated learnings.
+     */
+    getValidatedLearnings(): Learning[];
+    /**
+     * Get proposed learnings awaiting validation.
+     */
+    getPendingLearnings(): Learning[];
+    /**
+     * Retrieve learnings relevant to a query.
+     */
+    retrieveRelevant(query: string, limit?: number): Learning[];
+    /**
+     * Retrieve learnings by keyword (fallback).
+     */
+    private retrieveByKeyword;
+    /**
+     * Retrieve learnings by category.
+     */
+    retrieveByCategory(category: FailureCategory, limit?: number): Learning[];
+    /**
+     * Retrieve learnings by action.
+     */
+    retrieveByAction(action: string, limit?: number): Learning[];
+    /**
+     * Get learning context formatted for LLM inclusion.
+     */
+    getLearningContext(options?: {
+        query?: string;
+        categories?: FailureCategory[];
+        actions?: string[];
+        maxLearnings?: number;
+    }): string;
+    /**
+     * Archive a learning.
+     */
+    archiveLearning(learningId: string): boolean;
+    /**
+     * Delete a learning.
+     */
+    deleteLearning(learningId: string): boolean;
+    /**
+     * Get learning statistics.
+     */
+    getStats(): {
+        total: number;
+        byStatus: Record<LearningStatus, number>;
+        byType: Record<LearningType, number>;
+        topApplied: Array<{
+            id: string;
+            description: string;
+            applyCount: number;
+        }>;
+        topHelpful: Array<{
+            id: string;
+            description: string;
+            helpCount: number;
+        }>;
+    };
+    /**
+     * Subscribe to events.
+     */
+    on(listener: LearningStoreEventListener): () => void;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+    private shouldAutoValidate;
+    private extractLearningFromPattern;
+    private extractKeywords;
+    private sanitizeFtsQuery;
+    private saveLearning;
+    private rowToLearning;
+    private emit;
+}
+/**
+ * Create a learning store.
+ *
+ * @example
+ * ```typescript
+ * const store = createLearningStore({
+ *   dbPath: '.agent/learnings.db',
+ *   requireValidation: true,
+ * });
+ *
+ * // Propose a learning manually
+ * store.proposeLearning({
+ *   type: 'gotcha',
+ *   description: 'Always check file exists before reading',
+ *   actions: ['read_file'],
+ *   categories: ['not_found'],
+ * });
+ *
+ * // Retrieve relevant learnings
+ * const learnings = store.retrieveRelevant('file permissions');
+ * ```
+ */
+export declare function createLearningStore(config?: LearningStoreConfig): LearningStore;
+/**
+ * Create an in-memory learning store (for testing).
+ */
+export declare function createInMemoryLearningStore(config?: Omit<LearningStoreConfig, 'dbPath' | 'inMemory'>): LearningStore;
+/**
+ * Format learnings as context for LLM.
+ */
+export declare function formatLearningsContext(learnings: Learning[]): string;
+/**
+ * Format learning stats for display.
+ */
+export declare function formatLearningStats(stats: ReturnType<LearningStore['getStats']>): string;
+//# sourceMappingURL=learning-store.d.ts.map

package/dist/src/integrations/learning-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-store.d.ts","sourceRoot":"","sources":["../../../src/integrations/learning-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAMvC;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,WAAW,GACX,UAAU,GACV,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,aAAa,GACb,eAAe,GACf,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IAEnB,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IAEvB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAE9B,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IAEnB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,sBAAsB;IACtB,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAE3B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AA6D7E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,yBAAyB,CAAC,CAAa;gBAEnC,MAAM,GAAE,mBAAwB;IAc5C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI;IAe1D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ;IA2BrD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAoBjF;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAYzD;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAczC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAMxC;;OAEG;IACH,qBAAqB,IAAI,QAAQ,EAAE;IAOnC;;OAEG;IACH,mBAAmB,IAAI,QAAQ,EAAE;IAOjC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAqB/D;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAc7E;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,QAAQ,EAAE;IAchE;;OAEG;IACH,kBAAkB,CAAC,OAAO,GAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,MAAM;IA0Cf;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAW5C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAK3C;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrC,UAAU,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3E,UAAU,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3E;IA6CD;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,IAAI;IAQpD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,YAAY;IAsDpB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,IAAI;CASb;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAEf;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,UAAU,CAAM,GAC5D,aAAa,CAKf;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CA+BpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,MAAM,CA4CxF"}