driftdetect-core 0.1.0

package/dist/store/pattern-store.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Pattern Store - Pattern persistence and querying
+ *
+ * Loads and saves patterns to .drift/patterns/ directory.
+ * Supports querying by category, confidence, and status.
+ * Handles pattern state transitions (discovered → approved/ignored).
+ *
+ * @requirements 4.1 - THE Pattern_Store SHALL persist patterns as JSON in .drift/patterns/ directory
+ * @requirements 4.3 - WHEN a pattern is approved, THE Pattern_Store SHALL move it from discovered/ to approved/
+ * @requirements 4.6 - THE Pattern_Store SHALL support querying patterns by category, confidence, and status
+ */
+import { EventEmitter } from 'node:events';
+import type { Pattern, PatternCategory, PatternStatus, PatternQueryOptions, PatternQueryResult, PatternStoreConfig, PatternStoreStats, ConfidenceLevel } from './types.js';
+/**
+ * Error thrown when a pattern is not found
+ */
+export declare class PatternNotFoundError extends Error {
+    readonly patternId: string;
+    readonly category?: PatternCategory | undefined;
+    constructor(patternId: string, category?: PatternCategory | undefined);
+}
+/**
+ * Error thrown when an invalid state transition is attempted
+ */
+export declare class InvalidStateTransitionError extends Error {
+    readonly patternId: string;
+    readonly fromStatus: PatternStatus;
+    readonly toStatus: PatternStatus;
+    constructor(patternId: string, fromStatus: PatternStatus, toStatus: PatternStatus);
+}
+/**
+ * Error thrown when a pattern store operation fails
+ */
+export declare class PatternStoreError extends Error {
+    readonly errorCause: Error | undefined;
+    constructor(message: string, errorCause?: Error);
+}
+/**
+ * Pattern Store - Manages pattern persistence and querying
+ *
+ * Patterns are stored in .drift/patterns/ directory organized by status:
+ * - .drift/patterns/discovered/ - Patterns found but not yet reviewed
+ * - .drift/patterns/approved/ - User-approved patterns (enforced)
+ * - .drift/patterns/ignored/ - Patterns explicitly ignored by user
+ *
+ * Each status directory contains JSON files named by category (e.g., structural.json).
+ *
+ * @requirements 4.1 - Patterns persisted as JSON in .drift/patterns/
+ * @requirements 4.3 - Patterns move between status directories on approval/ignore
+ * @requirements 4.6 - Patterns queryable by category, confidence, status
+ */
+export declare class PatternStore extends EventEmitter {
+    private readonly config;
+    private readonly patternsDir;
+    private patterns;
+    private loaded;
+    private dirty;
+    private saveTimeout;
+    constructor(config?: Partial<PatternStoreConfig>);
+    /**
+     * Initialize the pattern store
+     *
+     * Creates necessary directories and loads existing patterns.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure the directory structure exists
+     */
+    private ensureDirectoryStructure;
+    /**
+     * Load all patterns from disk
+     *
+     * @requirements 4.1 - Load patterns from .drift/patterns/
+     */
+    loadAll(): Promise<void>;
+    /**
+     * Load patterns for a specific status
+     */
+    private loadByStatus;
+    /**
+     * Load a single category file
+     */
+    private loadCategoryFile;
+    /**
+     * Save all patterns to disk
+     *
+     * @requirements 4.1 - Persist patterns as JSON in .drift/patterns/
+     */
+    saveAll(): Promise<void>;
+    /**
+     * Group patterns by status and category
+     */
+    private groupPatternsByStatusAndCategory;
+    /**
+     * Save a single category file
+     */
+    private saveCategoryFile;
+    /**
+     * Create a backup of a file
+     */
+    private createBackup;
+    /**
+     * Clean up old backups, keeping only the most recent ones
+     */
+    private cleanupBackups;
+    /**
+     * Schedule an auto-save if enabled
+     */
+    private scheduleAutoSave;
+    /**
+     * Get a pattern by ID
+     *
+     * @param id - Pattern ID
+     * @returns The pattern or undefined if not found
+     */
+    get(id: string): Pattern | undefined;
+    /**
+     * Get a pattern by ID, throwing if not found
+     *
+     * @param id - Pattern ID
+     * @returns The pattern
+     * @throws PatternNotFoundError if pattern not found
+     */
+    getOrThrow(id: string): Pattern;
+    /**
+     * Check if a pattern exists
+     *
+     * @param id - Pattern ID
+     * @returns True if pattern exists
+     */
+    has(id: string): boolean;
+    /**
+     * Add a new pattern
+     *
+     * @param pattern - Pattern to add
+     * @throws Error if pattern with same ID already exists
+     */
+    add(pattern: Pattern): void;
+    /**
+     * Update an existing pattern
+     *
+     * @param id - Pattern ID
+     * @param updates - Partial pattern updates
+     * @returns The updated pattern
+     * @throws PatternNotFoundError if pattern not found
+     */
+    update(id: string, updates: Partial<Omit<Pattern, 'id'>>): Pattern;
+    /**
+     * Delete a pattern
+     *
+     * @param id - Pattern ID
+     * @returns True if pattern was deleted
+     */
+    delete(id: string): boolean;
+    /**
+     * Approve a pattern (move from discovered to approved)
+     *
+     * @requirements 4.3 - Move pattern from discovered/ to approved/
+     *
+     * @param id - Pattern ID
+     * @param approvedBy - User who approved the pattern
+     * @returns The updated pattern
+     * @throws PatternNotFoundError if pattern not found
+     * @throws InvalidStateTransitionError if transition is invalid
+     */
+    approve(id: string, approvedBy?: string): Pattern;
+    /**
+     * Ignore a pattern (move to ignored)
+     *
+     * @param id - Pattern ID
+     * @returns The updated pattern
+     * @throws PatternNotFoundError if pattern not found
+     * @throws InvalidStateTransitionError if transition is invalid
+     */
+    ignore(id: string): Pattern;
+    /**
+     * Transition a pattern to a new status
+     *
+     * @requirements 4.3 - Move patterns between status directories
+     *
+     * @param id - Pattern ID
+     * @param newStatus - Target status
+     * @param user - User performing the transition
+     * @returns The updated pattern
+     */
+    private transitionStatus;
+    /**
+     * Query patterns with filtering, sorting, and pagination
+     *
+     * @requirements 4.6 - Support querying by category, confidence, status
+     *
+     * @param options - Query options
+     * @returns Query result with matching patterns
+     */
+    query(options?: PatternQueryOptions): PatternQueryResult;
+    /**
+     * Apply filters to patterns
+     */
+    private applyFilters;
+    /**
+     * Apply sorting to patterns
+     */
+    private applySorting;
+    /**
+     * Get all patterns
+     */
+    getAll(): Pattern[];
+    /**
+     * Get patterns by category
+     *
+     * @requirements 4.6 - Query by category
+     */
+    getByCategory(category: PatternCategory): Pattern[];
+    /**
+     * Get patterns by status
+     *
+     * @requirements 4.6 - Query by status
+     */
+    getByStatus(status: PatternStatus): Pattern[];
+    /**
+     * Get patterns by confidence level
+     *
+     * @requirements 4.6 - Query by confidence
+     */
+    getByConfidenceLevel(level: ConfidenceLevel): Pattern[];
+    /**
+     * Get patterns with minimum confidence score
+     *
+     * @requirements 4.6 - Query by confidence
+     */
+    getByMinConfidence(minScore: number): Pattern[];
+    /**
+     * Get approved patterns
+     */
+    getApproved(): Pattern[];
+    /**
+     * Get discovered patterns
+     */
+    getDiscovered(): Pattern[];
+    /**
+     * Get ignored patterns
+     */
+    getIgnored(): Pattern[];
+    /**
+     * Get patterns that have locations in a specific file
+     */
+    getByFile(file: string): Pattern[];
+    /**
+     * Get patterns with outliers
+     */
+    getWithOutliers(): Pattern[];
+    /**
+     * Get high confidence patterns
+     */
+    getHighConfidence(): Pattern[];
+    /**
+     * Get statistics about the pattern store
+     */
+    getStats(): PatternStoreStats;
+    /**
+     * Emit a pattern store event
+     */
+    private emitEvent;
+    /**
+     * Get the number of patterns in the store
+     */
+    get size(): number;
+    /**
+     * Check if the store has been loaded
+     */
+    get isLoaded(): boolean;
+    /**
+     * Check if there are unsaved changes
+     */
+    get isDirty(): boolean;
+    /**
+     * Get the patterns directory path
+     */
+    get path(): string;
+    /**
+     * Clear all patterns from memory (does not affect disk)
+     */
+    clear(): void;
+    /**
+     * Dispose of the pattern store
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=pattern-store.d.ts.map

package/dist/store/pattern-store.d.ts.map

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