driftdetect-cortex 0.9.41

package/dist/types/causal.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Causal Relationship Types
+ *
+ * Defines the causal graph data structures for tracking
+ * "why" relationships between memories. This enables:
+ * - Tracing the origins of knowledge
+ * - Understanding effects of decisions
+ * - Generating human-readable narratives
+ *
+ * @module types/causal
+ */
+/**
+ * The 8 causal relationship types
+ *
+ * These represent different ways memories can be causally connected:
+ * - caused: Direct causation (A caused B)
+ * - enabled: Made possible (A enabled B to happen)
+ * - prevented: Blocked from happening (A prevented B)
+ * - contradicts: Conflicts with (A contradicts B)
+ * - supersedes: Replaces (A supersedes B, making B obsolete)
+ * - supports: Provides evidence for (A supports B)
+ * - derived_from: Extracted from (A was derived from B)
+ * - triggered_by: Initiated by (A was triggered by B)
+ */
+export type CausalRelation = 'caused' | 'enabled' | 'prevented' | 'contradicts' | 'supersedes' | 'supports' | 'derived_from' | 'triggered_by';
+/**
+ * Evidence supporting a causal relationship
+ */
+export interface CausalEvidence {
+    /** Type of evidence */
+    type: 'temporal' | 'semantic' | 'entity' | 'explicit' | 'user_confirmed';
+    /** Description of the evidence */
+    description: string;
+    /** Confidence in this evidence (0.0 - 1.0) */
+    confidence: number;
+    /** Reference to supporting data (commit hash, file path, etc.) */
+    reference?: string;
+    /** When this evidence was gathered */
+    gatheredAt: string;
+}
+/**
+ * An edge in the causal graph
+ *
+ * Represents a directed relationship from source to target
+ * with a specific causal relation type.
+ */
+export interface CausalEdge {
+    /** Unique identifier for this edge */
+    id: string;
+    /** Source memory ID (the cause) */
+    sourceId: string;
+    /** Target memory ID (the effect) */
+    targetId: string;
+    /** Type of causal relationship */
+    relation: CausalRelation;
+    /** Strength of the relationship (0.0 - 1.0) */
+    strength: number;
+    /** Evidence supporting this relationship */
+    evidence: CausalEvidence[];
+    /** When this edge was created */
+    createdAt: string;
+    /** When this edge was last validated */
+    validatedAt?: string | undefined;
+    /** Whether this edge was inferred or explicitly created */
+    inferred: boolean;
+    /** User who created/validated this edge */
+    createdBy?: string | undefined;
+}
+/**
+ * A node in a causal chain (memory with context)
+ */
+export interface CausalNode {
+    /** Memory ID */
+    memoryId: string;
+    /** Memory type */
+    memoryType: string;
+    /** Memory summary */
+    summary: string;
+    /** Depth in the chain (0 = root) */
+    depth: number;
+    /** Edges leading to this node */
+    incomingEdges: CausalEdge[];
+    /** Edges leading from this node */
+    outgoingEdges: CausalEdge[];
+}
+/**
+ * A path through the causal graph
+ *
+ * Represents a chain of causally connected memories,
+ * useful for generating narratives and explanations.
+ */
+export interface CausalChain {
+    /** The root memory ID (starting point) */
+    rootId: string;
+    /** Direction of traversal */
+    direction: 'origins' | 'effects' | 'bidirectional';
+    /** All nodes in the chain */
+    nodes: CausalNode[];
+    /** All edges in the chain */
+    edges: CausalEdge[];
+    /** Maximum depth reached */
+    maxDepth: number;
+    /** Total number of memories in chain */
+    totalMemories: number;
+    /** Aggregate confidence of the chain */
+    chainConfidence: number;
+    /** When this chain was computed */
+    computedAt: string;
+}
+/**
+ * Result of automatic causal inference
+ */
+export interface CausalInferenceResult {
+    /** The memory being analyzed */
+    memoryId: string;
+    /** Inferred causal edges */
+    inferredEdges: CausalEdge[];
+    /** Confidence in the overall inference */
+    confidence: number;
+    /** Strategies used for inference */
+    strategiesUsed: CausalInferenceStrategy[];
+    /** Time taken for inference (ms) */
+    inferenceTimeMs: number;
+    /** Any warnings or notes */
+    warnings?: string[] | undefined;
+}
+/**
+ * Strategies for automatic causal inference
+ */
+export type CausalInferenceStrategy = 'temporal_proximity' | 'semantic_similarity' | 'entity_overlap' | 'explicit_reference' | 'pattern_matching' | 'file_co_occurrence';
+/**
+ * Options for graph traversal
+ */
+export interface GraphTraversalOptions {
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+    /** Minimum edge strength to follow */
+    minStrength?: number;
+    /** Relation types to include (empty = all) */
+    relationTypes?: CausalRelation[];
+    /** Whether to include inferred edges */
+    includeInferred?: boolean;
+    /** Maximum number of nodes to return */
+    maxNodes?: number;
+    /** Whether to compute chain confidence */
+    computeConfidence?: boolean;
+}
+/**
+ * Statistics about the causal graph
+ */
+export interface CausalGraphStats {
+    /** Total number of edges */
+    totalEdges: number;
+    /** Edges by relation type */
+    edgesByRelation: Record<CausalRelation, number>;
+    /** Number of inferred vs explicit edges */
+    inferredCount: number;
+    explicitCount: number;
+    /** Average edge strength */
+    averageStrength: number;
+    /** Number of connected components */
+    connectedComponents: number;
+    /** Memories with most causal connections */
+    mostConnected: Array<{
+        memoryId: string;
+        connectionCount: number;
+    }>;
+}
+/**
+ * Request to create a causal edge
+ */
+export interface CreateCausalEdgeRequest {
+    sourceId: string;
+    targetId: string;
+    relation: CausalRelation;
+    strength?: number;
+    evidence?: CausalEvidence[];
+    inferred?: boolean;
+    createdBy?: string;
+}
+/**
+ * Request to update a causal edge
+ */
+export interface UpdateCausalEdgeRequest {
+    strength?: number;
+    evidence?: CausalEvidence[];
+    validatedAt?: string;
+}
+//# sourceMappingURL=causal.d.ts.map

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

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

package/dist/types/causal.js

@@ -0,0 +1,13 @@
+/**
+ * Causal Relationship Types
+ *
+ * Defines the causal graph data structures for tracking
+ * "why" relationships between memories. This enables:
+ * - Tracing the origins of knowledge
+ * - Understanding effects of decisions
+ * - Generating human-readable narratives
+ *
+ * @module types/causal
+ */
+export {};
+//# sourceMappingURL=causal.js.map

package/dist/types/causal.js.map

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

package/dist/types/citation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Memory Citation Type
+ *
+ * Citations link memories to specific code locations.
+ * The hash enables drift detection - when code changes,
+ * we can detect that the citation is stale.
+ */
+/**
+ * A citation to a specific code location
+ */
+export interface MemoryCitation {
+    /** File path relative to project root */
+    file: string;
+    /** Starting line number (1-indexed) */
+    lineStart: number;
+    /** Ending line number (1-indexed) */
+    lineEnd: number;
+    /** Sanitized code snippet (PII removed) */
+    snippet?: string;
+    /** SHA-256 hash of the cited content (first 16 chars) for drift detection */
+    hash: string;
+    /** When this citation was last validated */
+    validatedAt?: string;
+    /** Whether the citation is still valid (hash matches) */
+    valid?: boolean;
+}
+/**
+ * Citation validation result
+ */
+export interface CitationValidationResult {
+    citation: MemoryCitation;
+    isValid: boolean;
+    currentHash?: string;
+    driftDetected: boolean;
+    suggestion?: string;
+}
+//# sourceMappingURL=citation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation.d.ts","sourceRoot":"","sources":["../../src/types/citation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/citation.js

@@ -0,0 +1,9 @@
+/**
+ * Memory Citation Type
+ *
+ * Citations link memories to specific code locations.
+ * The hash enables drift detection - when code changes,
+ * we can detect that the citation is stale.
+ */
+export {};
+//# sourceMappingURL=citation.js.map

package/dist/types/citation.js.map

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

package/dist/types/code-smell.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Code Smell Memory Type
+ *
+ * Patterns to avoid - anti-patterns, bad practices,
+ * and mistakes that have been made before.
+ */
+import type { BaseMemory } from './memory.js';
+/**
+ * Severity of the code smell
+ */
+export type SmellSeverity = 'error' | 'warning' | 'info';
+/**
+ * A recorded occurrence of this smell
+ */
+export interface SmellOccurrence {
+    /** File where the smell was found */
+    file: string;
+    /** Line number */
+    line: number;
+    /** When it was found */
+    timestamp: string;
+    /** Whether it has been resolved */
+    resolved: boolean;
+    /** Who resolved it */
+    resolvedBy?: string;
+}
+/**
+ * Code Smell Memory - Patterns to avoid
+ *
+ * Half-life: 90 days
+ *
+ * Records anti-patterns and mistakes that should not be repeated.
+ * Can include auto-detection rules for proactive warnings.
+ *
+ * Examples:
+ * - "Don't use string concatenation for SQL queries"
+ * - "Avoid nested ternaries more than 2 levels deep"
+ * - "Don't store sensitive data in localStorage"
+ */
+export interface CodeSmellMemory extends BaseMemory {
+    type: 'code_smell';
+    /** Name of the smell */
+    name: string;
+    /** Pattern to match (regex or description) */
+    pattern?: string;
+    /** Description of the smell */
+    description: string;
+    /** Severity level */
+    severity: SmellSeverity;
+    /** Why this is bad */
+    reason: string;
+    /** Consequences of this smell */
+    consequences?: string[];
+    /** How to fix it */
+    suggestion: string;
+    /** Example of bad code */
+    exampleBad?: string;
+    /** Example of good code */
+    exampleGood?: string;
+    /** Historical occurrences */
+    occurrences?: SmellOccurrence[];
+    /** Whether to auto-detect this smell */
+    autoDetect: boolean;
+    /** Detection rule (regex, AST pattern, etc.) */
+    detectionRule?: string;
+}
+//# sourceMappingURL=code-smell.d.ts.map

package/dist/types/code-smell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-smell.d.ts","sourceRoot":"","sources":["../../src/types/code-smell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,YAAY,CAAC;IAEnB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAEhC,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/code-smell.js

@@ -0,0 +1,8 @@
+/**
+ * Code Smell Memory Type
+ *
+ * Patterns to avoid - anti-patterns, bad practices,
+ * and mistakes that have been made before.
+ */
+export {};
+//# sourceMappingURL=code-smell.js.map

package/dist/types/code-smell.js.map

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

package/dist/types/compressed-memory.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Compressed Memory Types
+ *
+ * Defines the 4-level hierarchical compression system for
+ * token-efficient memory retrieval:
+ *
+ * Level 0: IDs only (~5 tokens)
+ * Level 1: One-liners (~50 tokens)
+ * Level 2: With examples (~200 tokens)
+ * Level 3: Full context (variable)
+ *
+ * @module types/compressed-memory
+ */
+/**
+ * Compression levels
+ *
+ * 0 = Minimal (IDs, type, importance only)
+ * 1 = Summary (one-liner + tags)
+ * 2 = Standard (knowledge + one example + evidence)
+ * 3 = Full (complete memory with all context)
+ */
+export type CompressionLevel = 0 | 1 | 2 | 3;
+/**
+ * Token budget configuration per level
+ */
+export interface LevelConfig {
+    /** Compression level */
+    level: CompressionLevel;
+    /** Target token count for this level */
+    targetTokens: number;
+    /** Maximum token count allowed */
+    maxTokens: number;
+    /** Description of what's included */
+    description: string;
+}
+/**
+ * Default level configurations
+ */
+export declare const DEFAULT_LEVEL_CONFIGS: Record<CompressionLevel, LevelConfig>;
+/**
+ * Level 0 compressed output (IDs only)
+ */
+export interface Level0Output {
+    /** Memory ID */
+    id: string;
+    /** Memory type */
+    type: string;
+    /** Importance level */
+    importance: string;
+    /** Actual token count */
+    tokens: number;
+}
+/**
+ * Level 1 compressed output (one-liners)
+ */
+export interface Level1Output extends Level0Output {
+    /** One-line summary */
+    oneLiner: string;
+    /** Key tags (max 3) */
+    tags: string[];
+    /** Confidence score */
+    confidence: number;
+}
+/**
+ * Level 2 compressed output (with examples)
+ */
+export interface Level2Output extends Level1Output {
+    /** Detailed content */
+    details: {
+        /** Core knowledge/content */
+        knowledge: string;
+        /** Single best example */
+        example?: string;
+        /** Key evidence points (max 2) */
+        evidence: string[];
+    };
+}
+/**
+ * Level 3 compressed output (full context)
+ */
+export interface Level3Output extends Level2Output {
+    /** Full context */
+    full: {
+        /** Complete knowledge */
+        completeKnowledge: string;
+        /** All examples */
+        allExamples: CodeSnippet[];
+        /** All evidence */
+        allEvidence: Evidence[];
+        /** Related memory IDs */
+        relatedMemories: string[];
+        /** Causal chain summary */
+        causalChain: string[];
+        /** Linked entities */
+        linkedPatterns?: string[];
+        linkedConstraints?: string[];
+        linkedFiles?: string[];
+        linkedFunctions?: string[];
+    };
+}
+/**
+ * Code snippet for examples
+ */
+export interface CodeSnippet {
+    /** Code content */
+    code: string;
+    /** Programming language */
+    language?: string;
+    /** File path */
+    filePath?: string;
+    /** Line numbers */
+    lineStart?: number;
+    lineEnd?: number;
+    /** Description of what this shows */
+    description?: string;
+}
+/**
+ * Evidence item
+ */
+export interface Evidence {
+    /** Evidence type */
+    type: 'code' | 'commit' | 'pr' | 'incident' | 'documentation' | 'user';
+    /** Evidence content/description */
+    content: string;
+    /** Reference URL or ID */
+    reference?: string;
+    /** When this evidence was gathered */
+    gatheredAt?: string;
+}
+/**
+ * A memory with compression metadata
+ */
+export interface CompressedMemory {
+    /** Original memory ID */
+    memoryId: string;
+    /** Compression level applied */
+    level: CompressionLevel;
+    /** Compressed output based on level */
+    output: Level0Output | Level1Output | Level2Output | Level3Output;
+    /** Actual token count */
+    tokenCount: number;
+    /** Original token count (level 3) */
+    originalTokenCount: number;
+    /** Compression ratio */
+    compressionRatio: number;
+    /** When compression was performed */
+    compressedAt: string;
+}
+/**
+ * Result of a compression operation
+ */
+export interface CompressionResult {
+    /** Successfully compressed memories */
+    compressed: CompressedMemory[];
+    /** Total tokens used */
+    totalTokens: number;
+    /** Average compression ratio */
+    averageCompressionRatio: number;
+    /** Breakdown by level */
+    levelBreakdown: Record<CompressionLevel, number>;
+    /** Any warnings */
+    warnings?: string[];
+}
+/**
+ * Options for compression
+ */
+export interface CompressionOptions {
+    /** Target compression level */
+    targetLevel?: CompressionLevel;
+    /** Maximum tokens allowed */
+    maxTokens?: number;
+    /** Whether to allow level escalation */
+    allowEscalation?: boolean;
+    /** Minimum level to use */
+    minLevel?: CompressionLevel;
+    /** Maximum level to use */
+    maxLevel?: CompressionLevel;
+    /** Custom level configs */
+    levelConfigs?: Partial<Record<CompressionLevel, LevelConfig>>;
+}
+/**
+ * Token budget allocation
+ */
+export interface TokenBudget {
+    /** Total budget available */
+    total: number;
+    /** Already used */
+    used: number;
+    /** Remaining */
+    remaining: number;
+    /** Reserved for system prompts */
+    reserved: number;
+    /** Available for memories */
+    availableForMemories: number;
+}
+//# sourceMappingURL=compressed-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compressed-memory.d.ts","sourceRoot":"","sources":["../../src/types/compressed-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAyBvE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,uBAAuB;IACvB,OAAO,EAAE;QACP,6BAA6B;QAC7B,SAAS,EAAE,MAAM,CAAC;QAClB,0BAA0B;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,kCAAkC;QAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,mBAAmB;IACnB,IAAI,EAAE;QACJ,yBAAyB;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB;QACnB,WAAW,EAAE,WAAW,EAAE,CAAC;QAC3B,mBAAmB;QACnB,WAAW,EAAE,QAAQ,EAAE,CAAC;QACxB,yBAAyB;QACzB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,2BAA2B;QAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,sBAAsB;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,CAAC;IACvE,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,uCAAuC;IACvC,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;IAClE,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}

package/dist/types/compressed-memory.js

@@ -0,0 +1,43 @@
+/**
+ * Compressed Memory Types
+ *
+ * Defines the 4-level hierarchical compression system for
+ * token-efficient memory retrieval:
+ *
+ * Level 0: IDs only (~5 tokens)
+ * Level 1: One-liners (~50 tokens)
+ * Level 2: With examples (~200 tokens)
+ * Level 3: Full context (variable)
+ *
+ * @module types/compressed-memory
+ */
+/**
+ * Default level configurations
+ */
+export const DEFAULT_LEVEL_CONFIGS = {
+    0: {
+        level: 0,
+        targetTokens: 5,
+        maxTokens: 10,
+        description: 'IDs only - memory ID, type, importance',
+    },
+    1: {
+        level: 1,
+        targetTokens: 50,
+        maxTokens: 75,
+        description: 'One-liner summary with key tags',
+    },
+    2: {
+        level: 2,
+        targetTokens: 200,
+        maxTokens: 300,
+        description: 'Knowledge with one example and key evidence',
+    },
+    3: {
+        level: 3,
+        targetTokens: 500,
+        maxTokens: 1000,
+        description: 'Full context with all examples and evidence',
+    },
+};
+//# sourceMappingURL=compressed-memory.js.map

package/dist/types/compressed-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressed-memory.js","sourceRoot":"","sources":["../../src/types/compressed-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0BH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA0C;IAC1E,CAAC,EAAE;QACD,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,wCAAwC;KACtD;IACD,CAAC,EAAE;QACD,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,iCAAiC;KAC/C;IACD,CAAC,EAAE;QACD,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,6CAA6C;KAC3D;IACD,CAAC,EAAE;QACD,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,6CAA6C;KAC3D;CACF,CAAC"}

package/dist/types/constraint-override.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Constraint Override Memory Type
+ *
+ * Records approved exceptions to constraints.
+ * Links to Drift's constraint system.
+ */
+import type { BaseMemory } from './memory.js';
+/**
+ * Scope of the override
+ */
+export interface OverrideScope {
+    /** Type of scope */
+    type: 'file' | 'directory' | 'function' | 'pattern' | 'global';
+    /** Target of the scope (file path, directory path, function name, pattern ID) */
+    target: string;
+}
+/**
+ * Constraint Override Memory - Approved exceptions
+ *
+ * Half-life: 90 days
+ *
+ * Records when a constraint has been intentionally overridden
+ * with proper approval and documentation.
+ *
+ * Examples:
+ * - "The no-any rule is overridden in legacy/adapter.ts for third-party compatibility"
+ * - "Rate limiting is disabled for internal health check endpoints"
+ * - "The authentication middleware is bypassed for public API routes"
+ */
+export interface ConstraintOverrideMemory extends BaseMemory {
+    type: 'constraint_override';
+    /** Constraint ID from Drift's constraint system */
+    constraintId: string;
+    /** Human-readable constraint name */
+    constraintName: string;
+    /** Where this override applies */
+    scope: OverrideScope;
+    /** Why this override was approved */
+    reason: string;
+    /** Who approved this override */
+    approvedBy?: string;
+    /** When this override was approved */
+    approvalDate?: string;
+    /** Whether this override is permanent */
+    permanent: boolean;
+    /** When this override expires (if not permanent) */
+    expiresAt?: string;
+    /** When this override should be reviewed */
+    reviewAt?: string;
+    /** How many times this override has been used */
+    usageCount: number;
+    /** When this override was last used */
+    lastUsed?: string;
+}
+//# sourceMappingURL=constraint-override.d.ts.map

package/dist/types/constraint-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-override.d.ts","sourceRoot":"","sources":["../../src/types/constraint-override.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/D,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,IAAI,EAAE,qBAAqB,CAAC;IAE5B,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IAEvB,kCAAkC;IAClC,KAAK,EAAE,aAAa,CAAC;IAErB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/constraint-override.js

@@ -0,0 +1,8 @@
+/**
+ * Constraint Override Memory Type
+ *
+ * Records approved exceptions to constraints.
+ * Links to Drift's constraint system.
+ */
+export {};
+//# sourceMappingURL=constraint-override.js.map

package/dist/types/constraint-override.js.map

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