driftdetect-core 0.4.6 → 0.6.0

package/dist/patterns/service.js

@@ -0,0 +1,25 @@
+/**
+ * Pattern Service Interface
+ *
+ * Defines the consumer-facing API for pattern operations. This is the
+ * recommended interface for all consumers (MCP tools, CLI, Dashboard).
+ *
+ * The service layer provides:
+ * - Higher-level operations than the repository
+ * - Business logic (validation, enrichment)
+ * - Caching integration
+ * - Metrics collection
+ *
+ * @module patterns/service
+ * @see PATTERN-SYSTEM-CONSOLIDATION.md
+ */
+/**
+ * Default service configuration
+ */
+export const DEFAULT_SERVICE_CONFIG = {
+    enableCache: true,
+    cacheTtlMs: 60000, // 1 minute
+    enableMetrics: true,
+    codeExampleContextLines: 5,
+};
+//# sourceMappingURL=service.js.map

package/dist/patterns/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/patterns/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyUH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK,EAAE,WAAW;IAC9B,aAAa,EAAE,IAAI;IACnB,uBAAuB,EAAE,CAAC;CAC3B,CAAC"}

package/dist/patterns/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Unified Pattern Types
+ *
+ * This module defines the unified data model for patterns across the entire
+ * Drift system. It consolidates the previously separate Pattern (from PatternStore)
+ * and PatternShardEntry (from PatternShardStore) types into a single source of truth.
+ *
+ * @module patterns/types
+ * @see PATTERN-SYSTEM-CONSOLIDATION.md
+ */
+/**
+ * Categories of patterns that can be detected.
+ * Each category corresponds to a detector category.
+ */
+export type PatternCategory = 'api' | 'auth' | 'security' | 'errors' | 'logging' | 'data-access' | 'config' | 'testing' | 'performance' | 'components' | 'styling' | 'structural' | 'types' | 'accessibility' | 'documentation';
+/**
+ * Array of all valid pattern categories
+ */
+export declare const PATTERN_CATEGORIES: PatternCategory[];
+/**
+ * Status of a pattern in the system.
+ *
+ * - discovered: Pattern found but not yet reviewed
+ * - approved: Pattern approved for enforcement
+ * - ignored: Pattern explicitly ignored by user
+ */
+export type PatternStatus = 'discovered' | 'approved' | 'ignored';
+/**
+ * Valid state transitions for patterns
+ */
+export declare const VALID_STATUS_TRANSITIONS: Record<PatternStatus, PatternStatus[]>;
+/**
+ * Confidence level classification based on score thresholds.
+ *
+ * - high: score >= 0.85
+ * - medium: score >= 0.70 and < 0.85
+ * - low: score >= 0.50 and < 0.70
+ * - uncertain: score < 0.50
+ */
+export type ConfidenceLevel = 'high' | 'medium' | 'low' | 'uncertain';
+/**
+ * Confidence score thresholds
+ */
+export declare const CONFIDENCE_THRESHOLDS: {
+    readonly high: 0.85;
+    readonly medium: 0.7;
+    readonly low: 0.5;
+};
+/**
+ * Compute confidence level from score
+ */
+export declare function computeConfidenceLevel(score: number): ConfidenceLevel;
+/**
+ * Severity levels for pattern violations.
+ *
+ * - error: Blocks commits and merges
+ * - warning: Displayed but doesn't block
+ * - info: Informational only
+ * - hint: Subtle suggestion
+ */
+export type Severity = 'error' | 'warning' | 'info' | 'hint';
+/**
+ * Severity level ordering (higher = more severe)
+ */
+export declare const SEVERITY_ORDER: Record<Severity, number>;
+/**
+ * Type of detection method used by a detector
+ */
+export type DetectionMethod = 'ast' | 'regex' | 'semantic' | 'learning' | 'structural';
+/**
+ * Location of a pattern occurrence in source code
+ */
+export interface PatternLocation {
+    /** File path (relative to project root) */
+    file: string;
+    /** Line number (1-indexed) */
+    line: number;
+    /** Column number (1-indexed) */
+    column: number;
+    /** End line number (optional, 1-indexed) */
+    endLine?: number | undefined;
+    /** End column number (optional, 1-indexed) */
+    endColumn?: number | undefined;
+    /** Code snippet for context */
+    snippet?: string | undefined;
+}
+/**
+ * Location of an outlier with reason for deviation
+ */
+export interface OutlierLocation extends PatternLocation {
+    /** Reason why this location is an outlier */
+    reason: string;
+    /** Deviation score (0.0 to 1.0, higher = more deviation) */
+    deviationScore?: number | undefined;
+}
+/**
+ * Metadata for a pattern
+ */
+export interface PatternMetadata {
+    /** ISO timestamp when pattern was first detected */
+    firstSeen: string;
+    /** ISO timestamp when pattern was last seen */
+    lastSeen: string;
+    /** ISO timestamp when pattern was approved (if approved) */
+    approvedAt?: string | undefined;
+    /** User who approved the pattern (if approved) */
+    approvedBy?: string | undefined;
+    /** Version of the pattern definition */
+    version?: string | undefined;
+    /** Tags for additional categorization */
+    tags?: string[] | undefined;
+    /** Related pattern IDs */
+    relatedPatterns?: string[] | undefined;
+    /** Source of the pattern (e.g., 'auto-detected', 'imported') */
+    source?: string | undefined;
+    /** Custom metadata fields */
+    custom?: Record<string, unknown> | undefined;
+}
+/**
+ * Configuration for a pattern detector
+ */
+export interface DetectorConfig {
+    /** Type of detection method */
+    type: DetectionMethod;
+    /** Detector-specific configuration */
+    config: Record<string, unknown>;
+}
+/**
+ * Unified Pattern type - the single source of truth for pattern data.
+ *
+ * This type consolidates:
+ * - Pattern from PatternStore (full metadata, status tracking)
+ * - PatternShardEntry from PatternShardStore (optimized for queries)
+ *
+ * All consumers should use this type for pattern data.
+ */
+export interface Pattern {
+    /** Unique pattern identifier */
+    id: string;
+    /** Pattern category */
+    category: PatternCategory;
+    /** Pattern subcategory for more specific classification */
+    subcategory: string;
+    /** Human-readable pattern name */
+    name: string;
+    /** Detailed pattern description */
+    description: string;
+    /** Detector ID that found this pattern */
+    detectorId: string;
+    /** Detector name */
+    detectorName: string;
+    /** Detection method used */
+    detectionMethod: DetectionMethod;
+    /** Detector configuration */
+    detector: DetectorConfig;
+    /** Confidence score (0.0 to 1.0) */
+    confidence: number;
+    /** Confidence level (computed from score) */
+    confidenceLevel: ConfidenceLevel;
+    /** Locations where pattern is found */
+    locations: PatternLocation[];
+    /** Outlier locations that deviate from the pattern */
+    outliers: OutlierLocation[];
+    /** Current status of the pattern */
+    status: PatternStatus;
+    /** Severity level for violations */
+    severity: Severity;
+    /** ISO timestamp when pattern was first detected */
+    firstSeen: string;
+    /** ISO timestamp when pattern was last seen */
+    lastSeen: string;
+    /** ISO timestamp when pattern was approved (if approved) */
+    approvedAt?: string | undefined;
+    /** User who approved the pattern (if approved) */
+    approvedBy?: string | undefined;
+    /** Tags for additional categorization */
+    tags: string[];
+    /** Whether the pattern can be auto-fixed */
+    autoFixable: boolean;
+    /** Full metadata object */
+    metadata: PatternMetadata;
+}
+/**
+ * Lightweight pattern summary for listings and indexes.
+ * Contains only the essential fields needed for display.
+ */
+export interface PatternSummary {
+    id: string;
+    name: string;
+    category: PatternCategory;
+    subcategory: string;
+    status: PatternStatus;
+    confidence: number;
+    confidenceLevel: ConfidenceLevel;
+    severity: Severity;
+    locationCount: number;
+    outlierCount: number;
+}
+/**
+ * Convert a Pattern to PatternSummary
+ */
+export declare function toPatternSummary(pattern: Pattern): PatternSummary;
+/**
+ * Input for creating a new pattern (minimal required fields)
+ */
+export interface CreatePatternInput {
+    id: string;
+    category: PatternCategory;
+    subcategory: string;
+    name: string;
+    description: string;
+    detectorId: string;
+    detectorName: string;
+    detectionMethod: DetectionMethod;
+    confidence: number;
+    locations: PatternLocation[];
+    severity?: Severity;
+    outliers?: OutlierLocation[];
+    tags?: string[];
+    autoFixable?: boolean;
+    detector?: DetectorConfig;
+}
+/**
+ * Create a new Pattern with defaults
+ */
+export declare function createPattern(input: CreatePatternInput): Pattern;
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/types.d.ts.map

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

package/dist/patterns/types.js

@@ -0,0 +1,117 @@
+/**
+ * Unified Pattern Types
+ *
+ * This module defines the unified data model for patterns across the entire
+ * Drift system. It consolidates the previously separate Pattern (from PatternStore)
+ * and PatternShardEntry (from PatternShardStore) types into a single source of truth.
+ *
+ * @module patterns/types
+ * @see PATTERN-SYSTEM-CONSOLIDATION.md
+ */
+/**
+ * Array of all valid pattern categories
+ */
+export const PATTERN_CATEGORIES = [
+    'api',
+    'auth',
+    'security',
+    'errors',
+    'logging',
+    'data-access',
+    'config',
+    'testing',
+    'performance',
+    'components',
+    'styling',
+    'structural',
+    'types',
+    'accessibility',
+    'documentation',
+];
+/**
+ * Valid state transitions for patterns
+ */
+export const VALID_STATUS_TRANSITIONS = {
+    discovered: ['approved', 'ignored'],
+    approved: ['ignored'],
+    ignored: ['approved'],
+};
+/**
+ * Confidence score thresholds
+ */
+export const CONFIDENCE_THRESHOLDS = {
+    high: 0.85,
+    medium: 0.70,
+    low: 0.50,
+};
+/**
+ * Compute confidence level from score
+ */
+export function computeConfidenceLevel(score) {
+    if (score >= CONFIDENCE_THRESHOLDS.high)
+        return 'high';
+    if (score >= CONFIDENCE_THRESHOLDS.medium)
+        return 'medium';
+    if (score >= CONFIDENCE_THRESHOLDS.low)
+        return 'low';
+    return 'uncertain';
+}
+/**
+ * Severity level ordering (higher = more severe)
+ */
+export const SEVERITY_ORDER = {
+    error: 4,
+    warning: 3,
+    info: 2,
+    hint: 1,
+};
+/**
+ * Convert a Pattern to PatternSummary
+ */
+export function toPatternSummary(pattern) {
+    return {
+        id: pattern.id,
+        name: pattern.name,
+        category: pattern.category,
+        subcategory: pattern.subcategory,
+        status: pattern.status,
+        confidence: pattern.confidence,
+        confidenceLevel: pattern.confidenceLevel,
+        severity: pattern.severity,
+        locationCount: pattern.locations.length,
+        outlierCount: pattern.outliers.length,
+    };
+}
+/**
+ * Create a new Pattern with defaults
+ */
+export function createPattern(input) {
+    const now = new Date().toISOString();
+    return {
+        id: input.id,
+        category: input.category,
+        subcategory: input.subcategory,
+        name: input.name,
+        description: input.description,
+        detectorId: input.detectorId,
+        detectorName: input.detectorName,
+        detectionMethod: input.detectionMethod,
+        detector: input.detector ?? { type: input.detectionMethod, config: {} },
+        confidence: input.confidence,
+        confidenceLevel: computeConfidenceLevel(input.confidence),
+        locations: input.locations,
+        outliers: input.outliers ?? [],
+        status: 'discovered',
+        severity: input.severity ?? 'info',
+        firstSeen: now,
+        lastSeen: now,
+        tags: input.tags ?? [],
+        autoFixable: input.autoFixable ?? false,
+        metadata: {
+            firstSeen: now,
+            lastSeen: now,
+            tags: input.tags ?? [],
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/patterns/types.js.map

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

package/dist/simulation/approach-generator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Approach Generator
+ *
+ * Generates implementation approaches for a given task by:
+ * 1. Detecting the task category from the description
+ * 2. Detecting the project language and framework
+ * 3. Using language-specific strategies to generate approaches
+ * 4. Enriching approaches with target files from the codebase
+ *
+ * @module simulation/approach-generator
+ */
+import type { CallGraphLanguage, CallGraph } from '../call-graph/types.js';
+import type { IPatternService } from '../patterns/service.js';
+import type { SimulationTask, SimulationApproach, TaskCategory } from './types.js';
+export interface ApproachGeneratorConfig {
+    projectRoot: string;
+    patternService?: IPatternService | undefined;
+    callGraph?: CallGraph | undefined;
+}
+export interface GeneratedApproaches {
+    approaches: SimulationApproach[];
+    detectedLanguage: CallGraphLanguage;
+    detectedFramework: string | null;
+    detectedCategory: TaskCategory;
+}
+/**
+ * Generates implementation approaches for a task
+ */
+export declare class ApproachGenerator {
+    private readonly config;
+    constructor(config: ApproachGeneratorConfig);
+    /**
+     * Generate approaches for a task
+     */
+    generate(task: SimulationTask, maxApproaches?: number): Promise<GeneratedApproaches>;
+    /**
+     * Detect the primary language and framework from the codebase
+     */
+    private detectLanguageAndFramework;
+    /**
+     * Detect specific framework from file contents
+     */
+    private detectFrameworkFromFiles;
+    /**
+     * Find relevant files for the task from the call graph
+     */
+    private findRelevantFiles;
+    /**
+     * Get keywords for a category
+     */
+    private getCategoryKeywords;
+    /**
+     * Find relevant patterns for the category
+     */
+    private findRelevantPatterns;
+    /**
+     * Create an approach from a strategy template
+     */
+    private createApproach;
+    /**
+     * Create a custom/hybrid approach
+     */
+    private createCustomApproach;
+    /**
+     * Create a fallback approach when no strategies are available
+     */
+    private createFallbackApproach;
+}
+/**
+ * Create an approach generator
+ */
+export declare function createApproachGenerator(config: ApproachGeneratorConfig): ApproachGenerator;
+//# sourceMappingURL=approach-generator.d.ts.map

package/dist/simulation/approach-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approach-generator.d.ts","sourceRoot":"","sources":["../../src/simulation/approach-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACb,MAAM,YAAY,CAAC;AAYpB,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,YAAY,CAAC;CAChC;AAgCD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,MAAM,EAAE,uBAAuB;IAI3C;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,cAAc,EACpB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,mBAAmB,CAAC;IA4D/B;;OAEG;YACW,0BAA0B;IAiDxC;;OAEG;YACW,wBAAwB;IAgEtC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;IACH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAgB/B;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAE1F"}