driftdetect-cortex 0.9.41

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

@@ -0,0 +1,59 @@
+/**
+ * Tribal Memory Type
+ *
+ * Institutional knowledge that isn't written down anywhere.
+ * The "gotchas", warnings, and hard-won lessons that only
+ * experienced team members know.
+ */
+import type { BaseMemory } from './memory.js';
+/**
+ * Source of tribal knowledge
+ */
+export interface TribalSource {
+    /** How this knowledge was acquired */
+    type: 'manual' | 'pr_comment' | 'code_review' | 'incident' | 'documentation' | 'inferred';
+    /** Reference to source (PR URL, incident ID, etc.) */
+    reference?: string;
+}
+/**
+ * Severity levels for tribal knowledge
+ */
+export type TribalSeverity = 'info' | 'warning' | 'critical';
+/**
+ * Tribal Memory - Institutional knowledge
+ *
+ * Half-life: 365 days
+ *
+ * Examples:
+ * - "Never call the payment API without idempotency keys"
+ * - "The legacy auth system has a 5-second timeout that can't be changed"
+ * - "Always check user.isActive before user.permissions"
+ */
+export interface TribalMemory extends BaseMemory {
+    type: 'tribal';
+    /** Main topic (e.g., 'authentication', 'payments', 'database') */
+    topic: string;
+    /** Subtopic for more specific categorization */
+    subtopic?: string;
+    /** The actual knowledge */
+    knowledge: string;
+    /** Additional context */
+    context?: string;
+    /** Specific warnings */
+    warnings?: string[];
+    /** Consequences of ignoring this knowledge */
+    consequences?: string[];
+    /** Severity level */
+    severity: TribalSeverity;
+    /** How we learned this */
+    source: TribalSource;
+    /** People who contributed to this knowledge */
+    contributors?: string[];
+    /** When this was last validated by a human */
+    lastValidated?: string;
+    /** Auto-linked database tables (from Drift analysis) */
+    linkedTables?: string[];
+    /** Auto-linked environment variables */
+    linkedEnvVars?: string[];
+}
+//# sourceMappingURL=tribal-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tribal-memory.d.ts","sourceRoot":"","sources":["../../src/types/tribal-memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,CAAC;IAC1F,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IAEf,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,qBAAqB;IACrB,QAAQ,EAAE,cAAc,CAAC;IAEzB,0BAA0B;IAC1B,MAAM,EAAE,YAAY,CAAC;IAErB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/types/tribal-memory.js

@@ -0,0 +1,9 @@
+/**
+ * Tribal Memory Type
+ *
+ * Institutional knowledge that isn't written down anywhere.
+ * The "gotchas", warnings, and hard-won lessons that only
+ * experienced team members know.
+ */
+export {};
+//# sourceMappingURL=tribal-memory.js.map

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

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

package/dist/utils/hash.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Hashing Utilities
+ *
+ * Content hashing for citation drift detection.
+ */
+/**
+ * Hash content for citation comparison
+ * Returns first 16 characters of SHA-256 hash
+ */
+export declare function hashContent(content: string): string;
+/**
+ * Hash a memory for deduplication
+ */
+export declare function hashMemory(memory: unknown): string;
+/**
+ * Compare two hashes
+ */
+export declare function hashesMatch(a: string, b: string): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/utils/hash.js

@@ -0,0 +1,27 @@
+/**
+ * Hashing Utilities
+ *
+ * Content hashing for citation drift detection.
+ */
+import { createHash } from 'crypto';
+/**
+ * Hash content for citation comparison
+ * Returns first 16 characters of SHA-256 hash
+ */
+export function hashContent(content) {
+    return createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+/**
+ * Hash a memory for deduplication
+ */
+export function hashMemory(memory) {
+    const content = JSON.stringify(memory);
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Compare two hashes
+ */
+export function hashesMatch(a, b) {
+    return a === b;
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}

package/dist/utils/id-generator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ID Generator
+ *
+ * Generates unique IDs for memories.
+ * Uses a combination of timestamp and random bytes.
+ */
+/**
+ * Generate a unique memory ID
+ * Format: mem_<timestamp>_<random>
+ */
+export declare function generateId(): string;
+/**
+ * Generate a unique consolidation run ID
+ */
+export declare function generateConsolidationId(): string;
+/**
+ * Generate a unique validation run ID
+ */
+export declare function generateValidationId(): string;
+/**
+ * Generate a unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Generate a unique causal edge ID
+ */
+export declare function generateCausalEdgeId(): string;
+/**
+ * Generate a unique correction ID
+ */
+export declare function generateCorrectionId(): string;
+/**
+ * Generate a unique prediction ID
+ */
+export declare function generatePredictionId(): string;
+/**
+ * Generate a unique generation request ID
+ */
+export declare function generateGenerationId(): string;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/utils/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../src/utils/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAIhD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C"}

package/dist/utils/id-generator.js

@@ -0,0 +1,73 @@
+/**
+ * ID Generator
+ *
+ * Generates unique IDs for memories.
+ * Uses a combination of timestamp and random bytes.
+ */
+import { randomBytes } from 'crypto';
+/**
+ * Generate a unique memory ID
+ * Format: mem_<timestamp>_<random>
+ */
+export function generateId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(6).toString('hex');
+    return `mem_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique consolidation run ID
+ */
+export function generateConsolidationId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `cons_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique validation run ID
+ */
+export function generateValidationId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `val_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique session ID
+ */
+export function generateSessionId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `sess_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique causal edge ID
+ */
+export function generateCausalEdgeId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `edge_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique correction ID
+ */
+export function generateCorrectionId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `corr_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique prediction ID
+ */
+export function generatePredictionId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `pred_${timestamp}_${random}`;
+}
+/**
+ * Generate a unique generation request ID
+ */
+export function generateGenerationId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `gen_${timestamp}_${random}`;
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/utils/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../src/utils/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility Functions
+ */
+export * from './id-generator.js';
+export * from './hash.js';
+export * from './tokens.js';
+export * from './time.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Utility Functions
+ */
+export * from './id-generator.js';
+export * from './hash.js';
+export * from './tokens.js';
+export * from './time.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Time Utilities
+ */
+/**
+ * Get current ISO timestamp
+ */
+export declare function now(): string;
+/**
+ * Calculate days between two dates
+ */
+export declare function daysBetween(a: string | Date, b: string | Date): number;
+/**
+ * Calculate days since a date
+ */
+export declare function daysSince(date: string | Date): number;
+/**
+ * Check if a date is in the past
+ */
+export declare function isPast(date: string | Date): boolean;
+/**
+ * Add days to a date
+ */
+export declare function addDays(date: string | Date, days: number): string;
+/**
+ * Subtract days from a date
+ */
+export declare function subtractDays(date: string | Date, days: number): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/utils/time.js

@@ -0,0 +1,46 @@
+/**
+ * Time Utilities
+ */
+/**
+ * Get current ISO timestamp
+ */
+export function now() {
+    return new Date().toISOString();
+}
+/**
+ * Calculate days between two dates
+ */
+export function daysBetween(a, b) {
+    const dateA = typeof a === 'string' ? new Date(a) : a;
+    const dateB = typeof b === 'string' ? new Date(b) : b;
+    const diff = Math.abs(dateB.getTime() - dateA.getTime());
+    return Math.floor(diff / (1000 * 60 * 60 * 24));
+}
+/**
+ * Calculate days since a date
+ */
+export function daysSince(date) {
+    return daysBetween(date, new Date());
+}
+/**
+ * Check if a date is in the past
+ */
+export function isPast(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d < new Date();
+}
+/**
+ * Add days to a date
+ */
+export function addDays(date, days) {
+    const d = typeof date === 'string' ? new Date(date) : new Date(date);
+    d.setDate(d.getDate() + days);
+    return d.toISOString();
+}
+/**
+ * Subtract days from a date
+ */
+export function subtractDays(date, days) {
+    return addDays(date, -days);
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,CAAgB,EAAE,CAAgB;IAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAmB;IACxC,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,OAAO,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmB,EAAE,IAAY;IACvD,MAAM,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAmB,EAAE,IAAY;IAC5D,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Rough token estimation for budget management.
+ */
+/**
+ * Estimate tokens for a string
+ * Rough approximation: ~4 characters per token
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Estimate tokens for a JSON object
+ */
+export declare function estimateObjectTokens(obj: unknown): number;
+/**
+ * Check if content fits within a token budget
+ */
+export declare function fitsInBudget(text: string, budget: number): boolean;
+/**
+ * Truncate text to fit within a token budget
+ */
+export declare function truncateToFit(text: string, budget: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlE"}

package/dist/utils/tokens.js

@@ -0,0 +1,35 @@
+/**
+ * Token Estimation Utilities
+ *
+ * Rough token estimation for budget management.
+ */
+/**
+ * Estimate tokens for a string
+ * Rough approximation: ~4 characters per token
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Estimate tokens for a JSON object
+ */
+export function estimateObjectTokens(obj) {
+    const json = JSON.stringify(obj);
+    return estimateTokens(json);
+}
+/**
+ * Check if content fits within a token budget
+ */
+export function fitsInBudget(text, budget) {
+    return estimateTokens(text) <= budget;
+}
+/**
+ * Truncate text to fit within a token budget
+ */
+export function truncateToFit(text, budget) {
+    const maxChars = budget * 4;
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars - 3) + '...';
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc;IACvD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAc;IACxD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC7C,CAAC"}

package/dist/validation/citation-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Citation Validator
+ *
+ * Validates that code citations in memories still match the actual code.
+ * Uses content hashing to detect drift.
+ */
+import type { Memory } from '../types/index.js';
+import type { ValidationIssue } from './engine.js';
+/**
+ * Citation validator
+ */
+export declare class CitationValidator {
+    /**
+     * Validate citations in a memory
+     */
+    validate(memory: Memory): Promise<ValidationIssue[]>;
+    /**
+     * Validate a single citation
+     */
+    private validateCitation;
+    /**
+     * Hash content for comparison
+     */
+    private hash;
+    /**
+     * Get citations from a memory
+     */
+    private getCitations;
+}
+//# sourceMappingURL=citation-validator.d.ts.map

package/dist/validation/citation-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-validator.d.ts","sourceRoot":"","sources":["../../src/validation/citation-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyC1D;;OAEG;YACW,gBAAgB;IAc9B;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/validation/citation-validator.js

@@ -0,0 +1,86 @@
+/**
+ * Citation Validator
+ *
+ * Validates that code citations in memories still match the actual code.
+ * Uses content hashing to detect drift.
+ */
+import { readFile } from 'fs/promises';
+import { createHash } from 'crypto';
+/**
+ * Citation validator
+ */
+export class CitationValidator {
+    /**
+     * Validate citations in a memory
+     */
+    async validate(memory) {
+        const citations = this.getCitations(memory);
+        if (citations.length === 0)
+            return [];
+        const issues = [];
+        let validCount = 0;
+        for (const citation of citations) {
+            try {
+                const isValid = await this.validateCitation(citation);
+                if (isValid) {
+                    validCount++;
+                }
+                else {
+                    issues.push({
+                        dimension: 'citation',
+                        severity: 'moderate',
+                        description: `Citation in ${citation.file}:${citation.lineStart} has drifted`,
+                        suggestion: 'Update citation or verify memory is still accurate',
+                    });
+                }
+            }
+            catch {
+                issues.push({
+                    dimension: 'citation',
+                    severity: 'severe',
+                    description: `File ${citation.file} not found or unreadable`,
+                    suggestion: 'File may have been deleted or moved',
+                });
+            }
+        }
+        // If more than half of citations are invalid, it's severe
+        if (validCount < citations.length / 2 && citations.length > 1) {
+            const firstIssue = issues[0];
+            if (firstIssue) {
+                firstIssue.severity = 'severe';
+            }
+        }
+        return issues;
+    }
+    /**
+     * Validate a single citation
+     */
+    async validateCitation(citation) {
+        const content = await readFile(citation.file, 'utf-8');
+        const lines = content.split('\n');
+        // Extract section with context
+        const start = Math.max(0, citation.lineStart - 3);
+        const end = Math.min(lines.length, citation.lineEnd + 3);
+        const section = lines.slice(start, end).join('\n');
+        // Compare hash
+        const currentHash = this.hash(section);
+        return currentHash === citation.hash;
+    }
+    /**
+     * Hash content for comparison
+     */
+    hash(content) {
+        return createHash('sha256').update(content).digest('hex').slice(0, 16);
+    }
+    /**
+     * Get citations from a memory
+     */
+    getCitations(memory) {
+        // Different memory types store citations differently
+        if ('citations' in memory && Array.isArray(memory.citations)) {
+            return memory.citations;
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=citation-validator.js.map

package/dist/validation/citation-validator.js.map

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

package/dist/validation/contradiction-detector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Contradiction Detector
+ *
+ * Detects contradictions between memories.
+ * Newer memories with higher confidence win.
+ */
+import type { IMemoryStorage } from '../storage/interface.js';
+import type { Memory } from '../types/index.js';
+import type { ValidationIssue } from './engine.js';
+/**
+ * Contradiction detector
+ */
+export declare class ContradictionDetector {
+    private storage;
+    constructor(storage: IMemoryStorage);
+    /**
+     * Detect contradictions for a memory
+     */
+    detect(memory: Memory): Promise<ValidationIssue[]>;
+    /**
+     * Find related memories
+     */
+    private findRelated;
+    /**
+     * Check if two memories contradict each other
+     */
+    private checkContradiction;
+    /**
+     * Calculate similarity between two strings
+     */
+    private calculateSimilarity;
+}
+//# sourceMappingURL=contradiction-detector.d.ts.map

package/dist/validation/contradiction-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction-detector.d.ts","sourceRoot":"","sources":["../../src/validation/contradiction-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAE3C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA8BxD;;OAEG;YACW,WAAW;IAiBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS5B"}