driftdetect-cortex 0.9.41

package/dist/types/learning.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Learning System Types
+ *
+ * Defines types for the true learning system that:
+ * - Analyzes corrections to understand WHY something was wrong
+ * - Extracts generalizable principles
+ * - Calibrates confidence based on evidence
+ * - Identifies memories needing validation
+ *
+ * @module types/learning
+ */
+/**
+ * The 10 correction categories
+ *
+ * Each category represents a different type of mistake
+ * that the system can learn from.
+ */
+export type CorrectionCategory = 'pattern_violation' | 'tribal_miss' | 'constraint_violation' | 'style_preference' | 'naming_convention' | 'architecture_mismatch' | 'security_issue' | 'performance_issue' | 'api_misuse' | 'other';
+/**
+ * Analyzed correction result
+ *
+ * The full analysis of a user correction, including
+ * categorization, principle extraction, and memory creation hints.
+ */
+export interface AnalyzedCorrection {
+    /** Unique identifier for this analysis */
+    id: string;
+    /** The original code/content that was corrected */
+    original: string;
+    /** The user's feedback/correction */
+    feedback: string;
+    /** The corrected code (if provided) */
+    correctedCode?: string;
+    /** Computed diff between original and corrected */
+    diff?: CorrectionDiff;
+    /** Determined category */
+    category: CorrectionCategory;
+    /** Confidence in the categorization (0.0 - 1.0) */
+    categoryConfidence: number;
+    /** Extracted principle */
+    principle: ExtractedPrinciple;
+    /** Suggested memory type to create */
+    suggestedMemoryType: SuggestedMemoryType;
+    /** Related existing memories */
+    relatedMemories: string[];
+    /** When this analysis was performed */
+    analyzedAt: string;
+    /** Analysis metadata */
+    metadata?: CorrectionMetadata;
+}
+/**
+ * Diff between original and corrected code
+ */
+export interface CorrectionDiff {
+    /** Lines added */
+    additions: DiffLine[];
+    /** Lines removed */
+    removals: DiffLine[];
+    /** Lines modified */
+    modifications: DiffModification[];
+    /** Summary of changes */
+    summary: string;
+    /** Semantic changes detected */
+    semanticChanges: SemanticChange[];
+}
+/**
+ * A line in a diff
+ */
+export interface DiffLine {
+    /** Line number */
+    lineNumber: number;
+    /** Line content */
+    content: string;
+}
+/**
+ * A modification in a diff
+ */
+export interface DiffModification {
+    /** Original line number */
+    originalLine: number;
+    /** New line number */
+    newLine: number;
+    /** Original content */
+    originalContent: string;
+    /** New content */
+    newContent: string;
+}
+/**
+ * Semantic change detected in diff
+ */
+export interface SemanticChange {
+    /** Type of semantic change */
+    type: 'rename' | 'refactor' | 'add_error_handling' | 'change_logic' | 'add_validation' | 'other';
+    /** Description of the change */
+    description: string;
+    /** Affected code elements */
+    affectedElements: string[];
+}
+/**
+ * Extracted principle from a correction
+ *
+ * A generalizable rule that can be applied to future
+ * code generation to avoid similar mistakes.
+ */
+export interface ExtractedPrinciple {
+    /** The principle statement */
+    statement: string;
+    /** Detailed explanation */
+    explanation: string;
+    /** Scope where this principle applies */
+    scope: PrincipleScope;
+    /** Confidence in this principle (0.0 - 1.0) */
+    confidence: number;
+    /** Example of correct usage */
+    correctExample?: string;
+    /** Example of incorrect usage */
+    incorrectExample?: string;
+    /** Keywords for matching */
+    keywords: string[];
+    /** Whether this is a hard rule or soft preference */
+    isHardRule: boolean;
+}
+/**
+ * Scope where a principle applies
+ */
+export interface PrincipleScope {
+    /** File patterns where this applies */
+    filePatterns?: string[];
+    /** Languages where this applies */
+    languages?: string[];
+    /** Frameworks where this applies */
+    frameworks?: string[];
+    /** Specific patterns where this applies */
+    patterns?: string[];
+    /** Whether this is project-wide */
+    projectWide: boolean;
+}
+/**
+ * Suggested memory type to create from correction
+ */
+export type SuggestedMemoryType = 'tribal' | 'code_smell' | 'pattern_rationale' | 'constraint_override' | 'procedural';
+/**
+ * Metadata about a correction
+ */
+export interface CorrectionMetadata {
+    /** File where correction occurred */
+    filePath?: string;
+    /** Language of the code */
+    language?: string;
+    /** User who made the correction */
+    userId?: string;
+    /** Session ID */
+    sessionId?: string;
+    /** Related pattern IDs */
+    relatedPatterns?: string[];
+    /** Related constraint IDs */
+    relatedConstraints?: string[];
+}
+/**
+ * Confidence metrics for a memory
+ */
+export interface ConfidenceMetrics {
+    /** Base confidence from creation */
+    baseConfidence: number;
+    /** Number of supporting evidence items */
+    supportingEvidenceCount: number;
+    /** Number of contradicting evidence items */
+    contradictingEvidenceCount: number;
+    /** Times this memory was used successfully */
+    successfulUses: number;
+    /** Times this memory was rejected/modified */
+    rejectedUses: number;
+    /** Age of the memory in days */
+    ageInDays: number;
+    /** Last validation timestamp */
+    lastValidated?: string;
+    /** User confirmations */
+    userConfirmations: number;
+    /** User rejections */
+    userRejections: number;
+}
+/**
+ * Calculated confidence result
+ */
+export interface CalculatedConfidence {
+    /** Final confidence score (0.0 - 1.0) */
+    confidence: number;
+    /** Breakdown of factors */
+    factors: ConfidenceFactor[];
+    /** Whether validation is recommended */
+    needsValidation: boolean;
+    /** Reason for validation recommendation */
+    validationReason?: string;
+}
+/**
+ * A factor contributing to confidence
+ */
+export interface ConfidenceFactor {
+    /** Factor name */
+    name: string;
+    /** Factor weight */
+    weight: number;
+    /** Factor value */
+    value: number;
+    /** Contribution to final score */
+    contribution: number;
+    /** Description */
+    description: string;
+}
+/**
+ * A memory that needs validation
+ */
+export interface ValidationCandidate {
+    /** Memory ID */
+    memoryId: string;
+    /** Memory type */
+    memoryType: string;
+    /** Memory summary */
+    summary: string;
+    /** Current confidence */
+    currentConfidence: number;
+    /** Reason for validation */
+    reason: ValidationReason;
+    /** Priority (higher = more urgent) */
+    priority: number;
+    /** Suggested validation prompt */
+    suggestedPrompt: string;
+}
+/**
+ * Reasons a memory needs validation
+ */
+export type ValidationReason = 'low_confidence' | 'conflicting_evidence' | 'stale' | 'never_validated' | 'high_importance_low_confidence' | 'frequent_rejection' | 'user_requested';
+/**
+ * Validation prompt for user
+ */
+export interface ValidationPrompt {
+    /** Memory being validated */
+    memoryId: string;
+    /** Formatted prompt text */
+    promptText: string;
+    /** Memory summary */
+    memorySummary: string;
+    /** Current confidence */
+    currentConfidence: number;
+    /** Validation reason */
+    reason: ValidationReason;
+    /** Available actions */
+    actions: ValidationAction[];
+}
+/**
+ * Available validation actions
+ */
+export interface ValidationAction {
+    /** Action type */
+    type: 'confirm' | 'reject' | 'modify' | 'skip';
+    /** Display label */
+    label: string;
+    /** Description */
+    description: string;
+}
+/**
+ * Result of validation feedback
+ */
+export interface ValidationFeedback {
+    /** Memory ID */
+    memoryId: string;
+    /** Action taken */
+    action: 'confirm' | 'reject' | 'modify';
+    /** Modification details (if action is 'modify') */
+    modification?: string;
+    /** User feedback text */
+    feedback?: string;
+    /** When feedback was provided */
+    providedAt: string;
+    /** User who provided feedback */
+    providedBy?: string;
+}
+/**
+ * Learning outcome tracking
+ */
+export interface LearningOutcome {
+    /** Correction ID */
+    correctionId: string;
+    /** Memory created (if any) */
+    memoryCreated?: string;
+    /** Memories updated */
+    memoriesUpdated: string[];
+    /** Principles extracted */
+    principlesExtracted: number;
+    /** Whether learning was successful */
+    success: boolean;
+    /** Any errors */
+    error?: string;
+    /** When learning completed */
+    completedAt: string;
+}
+//# sourceMappingURL=learning.d.ts.map

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

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

package/dist/types/learning.js

@@ -0,0 +1,13 @@
+/**
+ * Learning System Types
+ *
+ * Defines types for the true learning system that:
+ * - Analyzes corrections to understand WHY something was wrong
+ * - Extracts generalizable principles
+ * - Calibrates confidence based on evidence
+ * - Identifies memories needing validation
+ *
+ * @module types/learning
+ */
+export {};
+//# sourceMappingURL=learning.js.map

package/dist/types/learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.js","sourceRoot":"","sources":["../../src/types/learning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/types/memory.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Base Memory Interface
+ *
+ * All memory types extend this base interface which provides:
+ * - Unique identification
+ * - Type discrimination
+ * - Bitemporal tracking
+ * - Confidence and importance
+ * - Access tracking
+ * - Linking to Drift entities
+ * - Archival support
+ */
+import type { TransactionTime, ValidTime } from './bitemporal.js';
+/**
+ * All supported memory types
+ */
+export type MemoryType = 'core' | 'tribal' | 'procedural' | 'semantic' | 'episodic' | 'pattern_rationale' | 'constraint_override' | 'decision_context' | 'code_smell';
+/**
+ * Importance levels for memories
+ */
+export type Importance = 'low' | 'normal' | 'high' | 'critical';
+/**
+ * Base interface for all memory types
+ */
+export interface BaseMemory {
+    /** Unique identifier */
+    id: string;
+    /** Discriminator for memory type */
+    type: MemoryType;
+    /** When we learned this */
+    transactionTime: TransactionTime;
+    /** When this was/is true */
+    validTime: ValidTime;
+    /** Confidence score 0.0 - 1.0 */
+    confidence: number;
+    /** Importance level */
+    importance: Importance;
+    /** ISO timestamp of last access */
+    lastAccessed?: string;
+    /** Number of times accessed */
+    accessCount: number;
+    /** Short summary (~20 tokens) */
+    summary: string;
+    /** Pattern IDs this memory relates to */
+    linkedPatterns?: string[];
+    /** Constraint IDs this memory relates to */
+    linkedConstraints?: string[];
+    /** File paths this memory relates to */
+    linkedFiles?: string[];
+    /** Function IDs from call graph */
+    linkedFunctions?: string[];
+    /** ISO timestamp of creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Who created this memory */
+    createdBy?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Whether this memory is archived */
+    archived?: boolean;
+    /** Reason for archival */
+    archiveReason?: string;
+    /** ID of memory that supersedes this one */
+    supersededBy?: string;
+    /** ID of memory this one supersedes */
+    supersedes?: string;
+    /** ISO timestamp of last validation */
+    lastValidated?: string;
+}
+/**
+ * Union type of all memory types
+ */
+export type Memory = import('./core-memory.js').CoreMemory | import('./tribal-memory.js').TribalMemory | import('./procedural-memory.js').ProceduralMemory | import('./semantic-memory.js').SemanticMemory | import('./episodic-memory.js').EpisodicMemory | import('./pattern-rationale.js').PatternRationaleMemory | import('./constraint-override.js').ConstraintOverrideMemory | import('./decision-context.js').DecisionContextMemory | import('./code-smell.js').CodeSmellMemory;
+/**
+ * Memory summary for list views
+ */
+export interface MemorySummary {
+    id: string;
+    type: MemoryType;
+    summary: string;
+    confidence: number;
+    importance: Importance;
+    createdAt: string;
+    lastAccessed?: string;
+    accessCount: number;
+}
+/**
+ * Query options for memory searches
+ */
+export interface MemoryQuery {
+    /** Filter by memory types */
+    types?: MemoryType[];
+    /** Filter by topics (for tribal, semantic) */
+    topics?: string[];
+    /** Filter by pattern IDs */
+    patterns?: string[];
+    /** Filter by constraint IDs */
+    constraints?: string[];
+    /** Filter by decision IDs */
+    decisions?: string[];
+    /** Filter by file paths */
+    files?: string[];
+    /** Filter by function IDs */
+    functions?: string[];
+    /** Minimum confidence */
+    minConfidence?: number;
+    /** Maximum confidence */
+    maxConfidence?: number;
+    /** Minimum access count */
+    minAccessCount?: number;
+    /** Filter by importance */
+    importance?: Importance[];
+    /** Include archived memories */
+    includeArchived?: boolean;
+    /** Filter by tags */
+    tags?: string[];
+    /** Minimum date (createdAt) */
+    minDate?: string;
+    /** Maximum date (createdAt) */
+    maxDate?: string;
+    /** Consolidation status (for episodic) */
+    consolidationStatus?: 'pending' | 'consolidated' | 'pruned';
+    /** Order by field */
+    orderBy?: string;
+    /** Order direction */
+    orderDir?: 'asc' | 'desc';
+    /** Maximum results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+//# sourceMappingURL=memory.d.ts.map

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

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

package/dist/types/memory.js

@@ -0,0 +1,14 @@
+/**
+ * Base Memory Interface
+ *
+ * All memory types extend this base interface which provides:
+ * - Unique identification
+ * - Type discrimination
+ * - Bitemporal tracking
+ * - Confidence and importance
+ * - Access tracking
+ * - Linking to Drift entities
+ * - Archival support
+ */
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/types/pattern-rationale.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pattern Rationale Memory Type
+ *
+ * Captures WHY a pattern exists in the codebase.
+ * Links to Drift's pattern detection system.
+ */
+import type { BaseMemory } from './memory.js';
+import type { MemoryCitation } from './citation.js';
+/**
+ * Pattern Rationale Memory - Why patterns exist
+ *
+ * Half-life: 180 days
+ *
+ * Provides human context for patterns detected by Drift.
+ * Answers the question "Why do we do it this way?"
+ *
+ * Examples:
+ * - "We use barrel exports because it simplifies imports and enables tree-shaking"
+ * - "The repository pattern was chosen to abstract database access for testing"
+ * - "Error boundaries are placed at route level to prevent full-page crashes"
+ */
+export interface PatternRationaleMemory extends BaseMemory {
+    type: 'pattern_rationale';
+    /** Pattern ID from Drift's pattern system */
+    patternId: string;
+    /** Human-readable pattern name */
+    patternName: string;
+    /** Pattern category (e.g., 'api', 'auth', 'structural') */
+    patternCategory: string;
+    /** The rationale - why this pattern exists */
+    rationale: string;
+    /** Business context for the pattern */
+    businessContext?: string;
+    /** Technical context for the pattern */
+    technicalContext?: string;
+    /** Alternatives that were considered and rejected */
+    alternativesRejected?: string[];
+    /** Trade-offs made by choosing this pattern */
+    tradeoffs?: string[];
+    /** Who introduced this pattern */
+    introducedBy?: string;
+    /** When this pattern was introduced */
+    introducedWhen?: string;
+    /** Related decision ID from decision mining */
+    relatedDecisionId?: string;
+    /** Code citations supporting this rationale */
+    citations?: MemoryCitation[];
+}
+//# sourceMappingURL=pattern-rationale.d.ts.map

package/dist/types/pattern-rationale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-rationale.d.ts","sourceRoot":"","sources":["../../src/types/pattern-rationale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,IAAI,EAAE,mBAAmB,CAAC;IAE1B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IAExB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/types/pattern-rationale.js

@@ -0,0 +1,8 @@
+/**
+ * Pattern Rationale Memory Type
+ *
+ * Captures WHY a pattern exists in the codebase.
+ * Links to Drift's pattern detection system.
+ */
+export {};
+//# sourceMappingURL=pattern-rationale.js.map

package/dist/types/pattern-rationale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-rationale.js","sourceRoot":"","sources":["../../src/types/pattern-rationale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}