shieldcortex 2.0.0

package/dashboard/src/lib/websocket.ts

@@ -0,0 +1,249 @@
+/**
+ * WebSocket client for real-time memory updates
+ *
+ * Connects to the visualization server's WebSocket endpoint
+ * and dispatches events to React Query for cache invalidation.
+ */
+
+import { useEffect, useRef, useCallback, useState } from 'react';
+import { useQueryClient } from '@tanstack/react-query';
+
+const WS_URL = process.env.NEXT_PUBLIC_WS_URL || 'ws://localhost:3001/ws/events';
+
+export type WebSocketEventType =
+  | 'initial_state'
+  | 'memory_created'
+  | 'memory_accessed'
+  | 'memory_updated'
+  | 'memory_deleted'
+  | 'consolidation_complete'
+  | 'decay_tick'
+  // Phase 4: Worker events
+  | 'worker_light_tick'
+  | 'worker_medium_tick'
+  | 'link_discovered'
+  | 'predictive_consolidation'
+  // Version/Update events
+  | 'update_started'
+  | 'update_complete'
+  | 'update_failed'
+  | 'server_restarting';
+
+// Alias for backwards compatibility
+export type MemoryEventType = WebSocketEventType;
+
+interface WebSocketMessage {
+  type: WebSocketEventType;
+  data?: unknown;
+}
+
+interface UseMemoryWebSocketOptions {
+  enabled?: boolean;
+  onMessage?: (event: WebSocketMessage) => void;
+}
+
+// Reconnection configuration
+const INITIAL_RECONNECT_DELAY = 1000; // 1 second
+const MAX_RECONNECT_DELAY = 30000; // 30 seconds max
+const MAX_RECONNECT_ATTEMPTS = 10;
+
+/**
+ * Hook to connect to memory WebSocket and handle real-time updates
+ */
+export function useMemoryWebSocket(options: UseMemoryWebSocketOptions = {}) {
+  const { enabled = true, onMessage } = options;
+  const queryClient = useQueryClient();
+  const wsRef = useRef<WebSocket | null>(null);
+  const reconnectTimeoutRef = useRef<NodeJS.Timeout | null>(null);
+  const reconnectAttemptsRef = useRef(0);
+  const reconnectDelayRef = useRef(INITIAL_RECONNECT_DELAY);
+  const connectRef = useRef<() => void>(() => {});
+  const [isConnected, setIsConnected] = useState(false);
+  const [lastEvent, setLastEvent] = useState<{
+    type: WebSocketEventType;
+    data?: unknown;
+    timestamp: string;
+  } | null>(null);
+
+  // Use ref for onMessage to avoid recreating connect callback when callback changes
+  // This prevents WebSocket reconnections on every render
+  const onMessageRef = useRef(onMessage);
+  useEffect(() => {
+    onMessageRef.current = onMessage;
+  }, [onMessage]);
+
+  const connect = useCallback(() => {
+    if (!enabled || wsRef.current?.readyState === WebSocket.OPEN) return;
+
+    // Clear any pending reconnect timeout
+    if (reconnectTimeoutRef.current) {
+      clearTimeout(reconnectTimeoutRef.current);
+      reconnectTimeoutRef.current = null;
+    }
+
+    try {
+      const ws = new WebSocket(WS_URL);
+      wsRef.current = ws;
+
+      ws.onopen = () => {
+        setIsConnected(true);
+        // Reset reconnect state on successful connection
+        reconnectAttemptsRef.current = 0;
+        reconnectDelayRef.current = INITIAL_RECONNECT_DELAY;
+        console.log('[WebSocket] Connected to memory server');
+      };
+
+      ws.onmessage = (event) => {
+        try {
+          const message = JSON.parse(event.data) as WebSocketMessage & { timestamp?: string };
+          setLastEvent({
+            type: message.type,
+            data: message.data,
+            timestamp: message.timestamp || new Date().toISOString(),
+          });
+
+          // Notify external handler (use ref to avoid stale closure)
+          onMessageRef.current?.(message);
+
+          // Invalidate relevant queries based on event type
+          switch (message.type) {
+            case 'initial_state':
+              // Full state received, refresh everything
+              queryClient.invalidateQueries({ queryKey: ['memories'] });
+              queryClient.invalidateQueries({ queryKey: ['stats'] });
+              queryClient.invalidateQueries({ queryKey: ['links'] });
+              break;
+
+            case 'memory_created':
+            case 'memory_updated':
+            case 'memory_deleted':
+              // Memory changed, refresh memories list
+              queryClient.invalidateQueries({ queryKey: ['memories'] });
+              queryClient.invalidateQueries({ queryKey: ['stats'] });
+              break;
+
+            case 'consolidation_complete':
+              // Major changes, refresh everything
+              queryClient.invalidateQueries({ queryKey: ['memories'] });
+              queryClient.invalidateQueries({ queryKey: ['stats'] });
+              queryClient.invalidateQueries({ queryKey: ['links'] });
+              break;
+
+            case 'decay_tick':
+              // Just decay scores updated, soft refresh
+              // We don't invalidate here to avoid constant refetches
+              // The dashboard can handle this via the onMessage callback
+              break;
+
+            // Phase 4: Worker events
+            case 'link_discovered':
+              // New link created, refresh links
+              queryClient.invalidateQueries({ queryKey: ['links'] });
+              break;
+
+            case 'predictive_consolidation':
+              // Predictive consolidation ran, refresh everything
+              queryClient.invalidateQueries({ queryKey: ['memories'] });
+              queryClient.invalidateQueries({ queryKey: ['stats'] });
+              queryClient.invalidateQueries({ queryKey: ['links'] });
+              break;
+
+            case 'worker_light_tick':
+            case 'worker_medium_tick':
+              // Worker ticks don't require cache invalidation
+              // Dashboard can track via onMessage callback if needed
+              break;
+
+            // Version/Update events
+            case 'update_started':
+            case 'update_complete':
+            case 'update_failed':
+              // Let VersionPanel handle via onMessage callback
+              // Invalidate version queries on completion
+              if (message.type === 'update_complete') {
+                queryClient.invalidateQueries({ queryKey: ['version'] });
+                queryClient.invalidateQueries({ queryKey: ['version-check'] });
+              }
+              break;
+
+            case 'server_restarting':
+              // Server is restarting - let onMessage callback handle UI
+              console.log('[WebSocket] Server restarting, will reconnect shortly...');
+              break;
+          }
+        } catch (err) {
+          console.error('[WebSocket] Failed to parse message:', err);
+        }
+      };
+
+      ws.onerror = () => {
+        // Use warn instead of error to avoid Next.js error overlay in dev mode
+        // WebSocket connection failures are expected when API server isn't running
+        console.warn('[WebSocket] Connection failed - is the API server running?');
+      };
+
+      ws.onclose = () => {
+        setIsConnected(false);
+        console.log('[WebSocket] Disconnected');
+
+        // Attempt to reconnect with exponential backoff
+        if (enabled && reconnectAttemptsRef.current < MAX_RECONNECT_ATTEMPTS) {
+          const delay = reconnectDelayRef.current;
+          reconnectAttemptsRef.current++;
+
+          // Exponential backoff: double the delay each time, up to max
+          reconnectDelayRef.current = Math.min(
+            reconnectDelayRef.current * 2,
+            MAX_RECONNECT_DELAY
+          );
+
+          console.log(
+            `[WebSocket] Reconnecting in ${delay}ms (attempt ${reconnectAttemptsRef.current}/${MAX_RECONNECT_ATTEMPTS})...`
+          );
+
+          reconnectTimeoutRef.current = setTimeout(() => {
+            connectRef.current();
+          }, delay);
+        } else if (reconnectAttemptsRef.current >= MAX_RECONNECT_ATTEMPTS) {
+          console.error('[WebSocket] Max reconnection attempts reached. Use reconnect() to try again.');
+        }
+      };
+    } catch (err) {
+      console.error('[WebSocket] Failed to connect:', err);
+    }
+  }, [enabled, queryClient]); // onMessage accessed via ref to prevent reconnection loops
+
+  useEffect(() => {
+    connectRef.current = connect;
+  });
+
+  // Connect on mount
+  useEffect(() => {
+    if (enabled) {
+      connect();
+    }
+
+    return () => {
+      if (reconnectTimeoutRef.current) {
+        clearTimeout(reconnectTimeoutRef.current);
+      }
+      if (wsRef.current) {
+        wsRef.current.close();
+        wsRef.current = null;
+      }
+    };
+  }, [enabled, connect]);
+
+  // Manual reconnect that resets backoff state
+  const manualReconnect = useCallback(() => {
+    reconnectAttemptsRef.current = 0;
+    reconnectDelayRef.current = INITIAL_RECONNECT_DELAY;
+    connect();
+  }, [connect]);
+
+  return {
+    isConnected,
+    lastEvent,
+    reconnect: manualReconnect,
+  };
+}

package/dashboard/src/types/memory.ts

@@ -0,0 +1,73 @@
+/**
+ * Memory Types
+ * Shared type definitions for the dashboard
+ */
+
+export type MemoryType = 'short_term' | 'long_term' | 'episodic';
+
+export type MemoryCategory =
+  | 'architecture'
+  | 'pattern'
+  | 'preference'
+  | 'error'
+  | 'context'
+  | 'learning'
+  | 'todo'
+  | 'note'
+  | 'relationship'
+  | 'custom';
+
+export interface Memory {
+  id: number;
+  type: MemoryType;
+  category: MemoryCategory;
+  title: string;
+  content: string;
+  project?: string;
+  tags: string[];
+  salience: number;
+  accessCount: number;
+  lastAccessed: string;
+  createdAt: string;
+  decayedScore?: number;
+  metadata?: Record<string, unknown>;
+}
+
+export interface MemoryLink {
+  id: number;
+  source_id: number;
+  target_id: number;
+  relationship: string;
+  strength: number;
+  created_at: string;
+  source_title?: string;
+  target_title?: string;
+  source_category?: MemoryCategory;
+  target_category?: MemoryCategory;
+}
+
+export interface MemoryStats {
+  total: number;
+  shortTerm: number;
+  longTerm: number;
+  episodic: number;
+  byCategory: Record<string, number>;
+  averageSalience: number;
+  decayDistribution?: {
+    healthy: number;
+    fading: number;
+    critical: number;
+  };
+}
+
+export interface MemoryEvent {
+  type: 'memory_created' | 'memory_accessed' | 'memory_updated' | 'memory_deleted' | 'consolidation_complete' | 'decay_tick';
+  timestamp: string;
+  data: unknown;
+}
+
+export interface Memory3DPosition {
+  x: number;
+  y: number;
+  z: number;
+}

package/dashboard/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/dist/__tests__/consolidation-merge.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Consolidation Merge Tests
+ *
+ * Tests the similarity-based clustering logic used by mergeSimilarMemories.
+ * Since the full function requires database access, we test the clustering
+ * algorithm components and similarity thresholds.
+ */
+export {};
+//# sourceMappingURL=consolidation-merge.test.d.ts.map

package/dist/__tests__/consolidation-merge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-merge.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/consolidation-merge.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/consolidation-merge.test.js

@@ -0,0 +1,137 @@
+/**
+ * Consolidation Merge Tests
+ *
+ * Tests the similarity-based clustering logic used by mergeSimilarMemories.
+ * Since the full function requires database access, we test the clustering
+ * algorithm components and similarity thresholds.
+ */
+import { describe, it, expect } from '@jest/globals';
+import { jaccardSimilarity } from '../memory/similarity.js';
+describe('mergeSimilarMemories clustering logic', () => {
+    // Simulate the clustering algorithm from mergeSimilarMemories
+    function findClusters(memories, threshold = 0.25) {
+        const clustered = new Set();
+        const clusters = [];
+        for (let i = 0; i < memories.length; i++) {
+            if (clustered.has(i))
+                continue;
+            const cluster = [i];
+            const memA = memories[i];
+            for (let j = i + 1; j < memories.length; j++) {
+                if (clustered.has(j))
+                    continue;
+                const memB = memories[j];
+                const contentSim = jaccardSimilarity(memA.content, memB.content);
+                const titleSim = jaccardSimilarity(memA.title, memB.title);
+                const combinedSim = contentSim * 0.6 + titleSim * 0.4;
+                if (combinedSim >= threshold) {
+                    cluster.push(j);
+                }
+            }
+            if (cluster.length >= 2) {
+                for (const idx of cluster)
+                    clustered.add(idx);
+                clusters.push(cluster);
+            }
+        }
+        return clusters;
+    }
+    it('should cluster related JWT memories together', () => {
+        const memories = [
+            {
+                title: 'JWT authentication token setup',
+                content: 'Set up JWT authentication token signing using RS256 algorithm in the auth service for user authentication and token validation',
+                salience: 0.6,
+            },
+            {
+                title: 'JWT authentication token expiry',
+                content: 'JWT authentication tokens expire after 24 hours with refresh token rotation for the auth service user authentication flow',
+                salience: 0.5,
+            },
+            {
+                title: 'JWT authentication token middleware',
+                content: 'Created JWT authentication token middleware that validates user tokens on every auth service API request and handles token refresh',
+                salience: 0.4,
+            },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        // All 3 should be in one cluster (they share JWT/token/auth vocabulary)
+        expect(clusters.length).toBeGreaterThanOrEqual(1);
+        const biggestCluster = clusters.reduce((a, b) => (a.length > b.length ? a : b), []);
+        expect(biggestCluster.length).toBeGreaterThanOrEqual(2);
+    });
+    it('should pick highest salience memory as base', () => {
+        const memories = [
+            { title: 'JWT authentication setup', content: 'JWT authentication token signing RS256 in auth service', salience: 0.6 },
+            { title: 'JWT authentication expiry', content: 'JWT authentication token expiry 24 hours auth service', salience: 0.5 },
+            { title: 'JWT authentication middleware', content: 'JWT authentication token middleware validates auth service', salience: 0.4 },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        expect(clusters.length).toBeGreaterThanOrEqual(1);
+        // Sort cluster by salience desc - index 0 (salience 0.6) should be first
+        const cluster = clusters[0];
+        const sorted = [...cluster].sort((a, b) => memories[b].salience - memories[a].salience);
+        expect(sorted[0]).toBe(0); // Highest salience is index 0
+    });
+    it('should not cluster unrelated memories', () => {
+        const memories = [
+            {
+                title: 'JWT Setup',
+                content: 'Set up JWT authentication using RS256 algorithm',
+                salience: 0.5,
+            },
+            {
+                title: 'Database Migration',
+                content: 'Migrated PostgreSQL schema to add user preferences table with JSONB columns',
+                salience: 0.5,
+            },
+        ];
+        const clusters = findClusters(memories, 0.25);
+        // These should NOT cluster - completely different topics
+        expect(clusters.length).toBe(0);
+    });
+    it('should produce correct merged content format', () => {
+        // Simulate what mergeSimilarMemories does after clustering
+        const base = {
+            title: 'JWT Setup',
+            content: 'Set up JWT authentication using RS256 algorithm for token signing in the auth service',
+        };
+        const others = [
+            {
+                title: 'JWT Token Expiry',
+                content: 'JWT tokens expire after 24 hours, refresh tokens last 30 days for the auth system',
+            },
+            {
+                title: 'JWT Middleware',
+                content: 'Created JWT middleware that validates tokens on every API request and attaches user context',
+            },
+        ];
+        const bulletPoints = others
+            .map(m => `- ${m.title}: ${m.content}`)
+            .join('\n');
+        const mergedContent = `${base.content}\n\nConsolidated context:\n${bulletPoints}`;
+        expect(mergedContent).toContain('RS256');
+        expect(mergedContent).toContain('24 hours');
+        expect(mergedContent).toContain('middleware');
+        expect(mergedContent).toContain('Consolidated context:');
+    });
+    it('should merge tags as a union', () => {
+        const tagSets = [
+            ['jwt', 'auth'],
+            ['jwt', 'expiry'],
+            ['jwt', 'middleware'],
+        ];
+        const allTags = new Set();
+        for (const tags of tagSets) {
+            for (const t of tags)
+                allTags.add(t);
+        }
+        expect([...allTags].sort()).toEqual(['auth', 'expiry', 'jwt', 'middleware']);
+    });
+    it('should cap salience at 1.0 after boost', () => {
+        const baseSalience = 0.95;
+        const newSalience = Math.min(1.0, baseSalience + 0.1);
+        expect(newSalience).toBe(1.0);
+    });
+});
+//# sourceMappingURL=consolidation-merge.test.js.map

package/dist/__tests__/consolidation-merge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-merge.test.js","sourceRoot":"","sources":["../../src/__tests__/consolidation-merge.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,8DAA8D;IAC9D,SAAS,YAAY,CACnB,QAAgE,EAChE,YAAoB,IAAI;QAExB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,MAAM,QAAQ,GAAe,EAAE,CAAC;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAE/B,MAAM,OAAO,GAAa,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,SAAS;gBAE/B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3D,MAAM,WAAW,GAAG,UAAU,GAAG,GAAG,GAAG,QAAQ,GAAG,GAAG,CAAC;gBAEtD,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,OAAO;oBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,QAAQ,GAAG;YACf;gBACE,KAAK,EAAE,gCAAgC;gBACvC,OAAO,EAAE,gIAAgI;gBACzI,QAAQ,EAAE,GAAG;aACd;YACD;gBACE,KAAK,EAAE,iCAAiC;gBACxC,OAAO,EAAE,2HAA2H;gBACpI,QAAQ,EAAE,GAAG;aACd;YACD;gBACE,KAAK,EAAE,qCAAqC;gBAC5C,OAAO,EAAE,oIAAoI;gBAC7I,QAAQ,EAAE,GAAG;aACd;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAE9C,wEAAwE;QACxE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACvC,EAAE,CACH,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,QAAQ,GAAG;YACf,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,wDAAwD,EAAE,QAAQ,EAAE,GAAG,EAAE;YACvH,EAAE,KAAK,EAAE,2BAA2B,EAAE,OAAO,EAAE,uDAAuD,EAAE,QAAQ,EAAE,GAAG,EAAE;YACvH,EAAE,KAAK,EAAE,+BAA+B,EAAE,OAAO,EAAE,4DAA4D,EAAE,QAAQ,EAAE,GAAG,EAAE;SACjI,CAAC;QAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAElD,yEAAyE;QACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CACtD,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG;YACf;gBACE,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE,iDAAiD;gBAC1D,QAAQ,EAAE,GAAG;aACd;YACD;gBACE,KAAK,EAAE,oBAAoB;gBAC3B,OAAO,EAAE,6EAA6E;gBACtF,QAAQ,EAAE,GAAG;aACd;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9C,yDAAyD;QACzD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,2DAA2D;QAC3D,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,uFAAuF;SACjG,CAAC;QACF,MAAM,MAAM,GAAG;YACb;gBACE,KAAK,EAAE,kBAAkB;gBACzB,OAAO,EAAE,mFAAmF;aAC7F;YACD;gBACE,KAAK,EAAE,gBAAgB;gBACvB,OAAO,EAAE,6FAA6F;aACvG;SACF,CAAC;QAEF,MAAM,YAAY,GAAG,MAAM;aACxB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,OAAO,8BAA8B,YAAY,EAAE,CAAC;QAElF,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG;YACd,CAAC,KAAK,EAAE,MAAM,CAAC;YACf,CAAC,KAAK,EAAE,QAAQ,CAAC;YACjB,CAAC,KAAK,EAAE,YAAY,CAAC;SACtB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,GAAG,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/contradictions.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Contradiction Surfacing Tests
+ *
+ * Tests that contradictions are properly included in search results
+ * and displayed in recall output.
+ */
+export {};
+//# sourceMappingURL=contradictions.test.d.ts.map

package/dist/__tests__/contradictions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradictions.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contradictions.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/contradictions.test.js

@@ -0,0 +1,78 @@
+/**
+ * Contradiction Surfacing Tests
+ *
+ * Tests that contradictions are properly included in search results
+ * and displayed in recall output.
+ */
+import { describe, it, expect } from '@jest/globals';
+import { formatRecallResult } from '../tools/recall.js';
+function makeMemory(overrides = {}) {
+    return {
+        id: 1,
+        type: 'long_term',
+        category: 'architecture',
+        title: 'Use PostgreSQL',
+        content: 'Decided to use PostgreSQL for the database',
+        project: 'test',
+        tags: [],
+        salience: 0.8,
+        accessCount: 1,
+        lastAccessed: new Date(),
+        createdAt: new Date(),
+        decayedScore: 0.7,
+        metadata: {},
+        scope: 'project',
+        transferable: false,
+        ...overrides,
+    };
+}
+describe('SearchResult contradictions field', () => {
+    it('should allow contradictions on SearchResult', () => {
+        const result = {
+            memory: makeMemory(),
+            relevanceScore: 0.9,
+            contradictions: [
+                { memoryId: 2, title: 'Use SQLite', score: 0.8 },
+            ],
+        };
+        expect(result.contradictions).toBeDefined();
+        expect(result.contradictions).toHaveLength(1);
+        expect(result.contradictions[0].memoryId).toBe(2);
+        expect(result.contradictions[0].title).toBe('Use SQLite');
+        expect(result.contradictions[0].score).toBe(0.8);
+    });
+    it('should allow SearchResult without contradictions', () => {
+        const result = {
+            memory: makeMemory(),
+            relevanceScore: 0.9,
+        };
+        expect(result.contradictions).toBeUndefined();
+    });
+});
+describe('formatRecallResult with contradictions', () => {
+    it('should show contradiction warnings in formatted output', () => {
+        const mem1 = makeMemory({ id: 1, title: 'Use PostgreSQL' });
+        const mem2 = makeMemory({ id: 2, title: 'Use SQLite' });
+        const contradictions = new Map();
+        contradictions.set(1, [{ memoryId: 2, title: 'Use SQLite', score: 0.8 }]);
+        const output = formatRecallResult({
+            success: true,
+            memories: [mem1, mem2],
+            contradictions,
+            count: 2,
+        });
+        expect(output).toContain('CONTRADICTS');
+        expect(output).toContain('"Use SQLite"');
+        expect(output).toContain('ID 2');
+    });
+    it('should not show contradiction warning for memories without contradictions', () => {
+        const mem = makeMemory({ id: 3, title: 'Some memory' });
+        const output = formatRecallResult({
+            success: true,
+            memories: [mem],
+            count: 1,
+        });
+        expect(output).not.toContain('CONTRADICTS');
+    });
+});
+//# sourceMappingURL=contradictions.test.js.map

package/dist/__tests__/contradictions.test.js.map

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

package/dist/__tests__/salience-evolution.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Salience Evolution Tests
+ *
+ * Tests that salience evolves over time based on structural importance.
+ */
+export {};
+//# sourceMappingURL=salience-evolution.test.d.ts.map

package/dist/__tests__/salience-evolution.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salience-evolution.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/salience-evolution.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}