@cogmem/engram 0.3.0 → 0.3.1

package/src/core/consolidation.ts

@@ -1,8 +1,5 @@
 import type { CognitiveConfig } from "../config/defaults.ts";
 import type { EngramStorage } from "../storage/sqlite.ts";
-import type { Memory, ConsolidationLog } from "./memory.ts";
-import { generateId } from "./memory.ts";
-import { refreshActivations } from "./forgetting.ts";
 import {
   formSemanticAssociations,
   formTemporalAssociations,
@@ -10,6 +7,9 @@ import {
   formCausalAssociations,
 } from "./associations.ts";
 import { encode } from "./encoder.ts";
+import { refreshActivations } from "./forgetting.ts";
+import type { Memory, ConsolidationLog } from "./memory.ts";
+import { generateId } from "./memory.ts";
 import { extractKeywords, tokenize } from "./search.ts";
 
 export interface ConsolidationResult {
@@ -69,11 +69,26 @@ export function consolidate(
   const remainingMemories = storage.getAllMemories();
   for (const memory of remainingMemories) {
     const temporalAssocs = formTemporalAssociations(storage, memory, config, currentTime);
-    const semanticAssocs = formSemanticAssociations(storage, memory, currentTime, remainingMemories);
-    const emotionalAssocs = formEmotionalAssociations(storage, memory, currentTime, remainingMemories);
+    const semanticAssocs = formSemanticAssociations(
+      storage,
+      memory,
+      currentTime,
+      remainingMemories,
+    );
+    const emotionalAssocs = formEmotionalAssociations(
+      storage,
+      memory,
+      currentTime,
+      remainingMemories,
+    );
     const causalAssocs = formCausalAssociations(storage, memory, config, currentTime);
 
-    for (const assoc of [...temporalAssocs, ...semanticAssocs, ...emotionalAssocs, ...causalAssocs]) {
+    for (const assoc of [
+      ...temporalAssocs,
+      ...semanticAssocs,
+      ...emotionalAssocs,
+      ...causalAssocs,
+    ]) {
       result.associationsDiscovered++;
       result.discoveredAssociationPairs.push([assoc.sourceId, assoc.targetId]);
     }

package/src/core/encoder.ts

@@ -1,10 +1,10 @@
 import type { CognitiveConfig } from "../config/defaults.ts";
 import type { EngramStorage } from "../storage/sqlite.ts";
-import type { Memory, EncodeInput } from "./memory.ts";
-import { generateMemoryId } from "./memory.ts";
-import { defaultEmotionWeight } from "./emotional-tag.ts";
 import { baseLevelActivation } from "./activation.ts";
 import { formEmotionalAssociations, formCausalAssociations } from "./associations.ts";
+import { defaultEmotionWeight } from "./emotional-tag.ts";
+import type { Memory, EncodeInput } from "./memory.ts";
+import { generateMemoryId } from "./memory.ts";
 
 export function encode(
   storage: EngramStorage,

package/src/core/engine.ts

@@ -1,8 +1,9 @@
+import { execSync } from "node:child_process";
+import { basename } from "node:path";
+
 import type { CognitiveConfig } from "../config/defaults.ts";
 import { loadConfig } from "../config/defaults.ts";
 import { EngramStorage } from "../storage/sqlite.ts";
-import { execSync } from "node:child_process";
-import { basename } from "node:path";
 
 export function detectProjectContext(): string | null {
   try {

package/src/core/forgetting.ts

@@ -3,7 +3,10 @@ import type { EngramStorage } from "../storage/sqlite.ts";
 import { baseLevelActivation } from "./activation.ts";
 
 // R(t) = e^{-t/S}
-export function ebbinghausRetention(timeSinceLastRecall: number, strength: number): number {
+export function ebbinghausRetention(
+  timeSinceLastRecall: number,
+  strength: number
+): number {
   if (strength <= 0) return 0;
   return Math.exp(-timeSinceLastRecall / strength);
 }
@@ -12,7 +15,7 @@ export function memoryStrength(
   recallCount: number,
   emotionWeight: number,
   associationCount: number,
-  emotionalBoostFactor: number,
+  emotionalBoostFactor: number
 ): number {
   const recallStrength = 1 + recallCount * 0.8;
   const emotionalStrength = 1 + emotionWeight * emotionalBoostFactor;
@@ -23,7 +26,7 @@ export function memoryStrength(
 export function refreshActivations(
   storage: EngramStorage,
   config: CognitiveConfig,
-  now?: number,
+  now?: number
 ): { updated: number; atRisk: number } {
   const currentTime = now ?? Date.now();
   const memories = storage.getAllMemories();
@@ -34,7 +37,11 @@ export function refreshActivations(
     if (memory.type === "procedural") continue;
 
     const timestamps = storage.getAccessTimestamps(memory.id);
-    const newActivation = baseLevelActivation(timestamps, currentTime, config.decayRate);
+    const newActivation = baseLevelActivation(
+      timestamps,
+      currentTime,
+      config.decayRate
+    );
 
     const emotionBoost =
       memory.emotionWeight > 0

package/src/core/memory.ts

@@ -32,7 +32,8 @@ export const AssociationType = {
   Emotional: "emotional",
   Causal: "causal",
 } as const;
-export type AssociationType = (typeof AssociationType)[keyof typeof AssociationType];
+export type AssociationType =
+  (typeof AssociationType)[keyof typeof AssociationType];
 
 export const AccessType = {
   Encode: "encode",

package/src/core/procedural-store.ts

@@ -1,7 +1,7 @@
 import type { CognitiveConfig } from "../config/defaults.ts";
 import type { EngramStorage } from "../storage/sqlite.ts";
-import type { Memory } from "./memory.ts";
 import { encode } from "./encoder.ts";
+import type { Memory } from "./memory.ts";
 
 export function encodeProcedural(
   storage: EngramStorage,

package/src/core/recall.ts

@@ -1,8 +1,11 @@
 import type { CognitiveConfig } from "../config/defaults.ts";
 import type { EngramStorage } from "../storage/sqlite.ts";
-import type { Memory, RecallResult } from "./memory.ts";
-import { computeActivation, spreadingActivationStrength } from "./activation.ts";
+import {
+  computeActivation,
+  spreadingActivationStrength,
+} from "./activation.ts";
 import { getSpreadingActivationTargets } from "./associations.ts";
+import type { Memory, RecallResult } from "./memory.ts";
 import { getWorkingMemoryIds } from "./working-memory.ts";
 
 export function recall(
@@ -16,7 +19,7 @@ export function recall(
     context?: string;
     now?: number;
     deterministic?: boolean;
-  },
+  }
 ): RecallResult[] {
   const now = options?.now ?? Date.now();
   const limit = options?.limit ?? 10;
@@ -31,14 +34,18 @@ export function recall(
   for (const id of ftsIds) seedIds.add(id);
 
   if (options?.context) {
-    const contextMatches = storage.getMemoriesByContext(options.context, options?.type, limit * 2);
+    const contextMatches = storage.getMemoriesByContext(
+      options.context,
+      options?.type,
+      limit * 2
+    );
     for (const m of contextMatches) seedIds.add(m.id);
   }
 
   const topByActivation = storage.getTopMemoriesByActivation(
     limit,
     options?.type,
-    options?.context,
+    options?.context
   );
   for (const m of topByActivation) {
     seedIds.add(m.id);
@@ -56,7 +63,10 @@ export function recall(
       for (const t of targets) {
         candidateIds.add(t.memoryId);
         const existing = graphBoosts.get(t.memoryId) ?? 0;
-        graphBoosts.set(t.memoryId, existing + t.activationBoost * primingWeight);
+        graphBoosts.set(
+          t.memoryId,
+          existing + t.activationBoost * primingWeight
+        );
       }
     }
   }
@@ -66,7 +76,11 @@ export function recall(
     const m = storage.getMemory(id);
     if (!m) continue;
     if (options?.type && m.type !== options.type) continue;
-    if (options?.context && (!m.context || !m.context.startsWith(options.context))) continue;
+    if (
+      options?.context &&
+      (!m.context || !m.context.startsWith(options.context))
+    )
+      continue;
     candidateMap.set(m.id, m);
   }
 
@@ -84,9 +98,13 @@ export function recall(
       const allAssocs = [...assocFrom, ...assocTo];
 
       for (const assoc of allAssocs) {
-        const otherId = assoc.sourceId === memory.id ? assoc.targetId : assoc.sourceId;
+        const otherId =
+          assoc.sourceId === memory.id ? assoc.targetId : assoc.sourceId;
         const fanCount = storage.getFanCount(otherId);
-        const strength = spreadingActivationStrength(config.maxSpreadingActivation, fanCount);
+        const strength = spreadingActivationStrength(
+          config.maxSpreadingActivation,
+          fanCount
+        );
         spreadingSum += assoc.strength * strength;
       }
     }

package/src/core/reconsolidation.ts

@@ -12,7 +12,7 @@ export function reconsolidate(
   storage: EngramStorage,
   memory: Memory,
   recallContext: ReconsolidationContext,
-  config: CognitiveConfig,
+  config: CognitiveConfig
 ): Memory {
   const blendRate = config.reconsolidationBlendRate;
 
@@ -24,7 +24,10 @@ export function reconsolidate(
     memory.context = recallContext.newContext;
   }
 
-  if (recallContext.currentEmotion && recallContext.currentEmotion !== memory.emotion) {
+  if (
+    recallContext.currentEmotion &&
+    recallContext.currentEmotion !== memory.emotion
+  ) {
     const blendedWeight =
       memory.emotionWeight * (1 - blendRate) +
       (recallContext.currentEmotionWeight ?? 0.5) * blendRate;

package/src/core/working-memory.ts

@@ -6,7 +6,7 @@ export function pushFocus(
   storage: EngramStorage,
   content: string,
   config: CognitiveConfig,
-  options?: { memoryRef?: string; now?: number },
+  options?: { memoryRef?: string; now?: number }
 ): { slot: WorkingMemorySlot; evicted: WorkingMemorySlot | null } {
   const now = options?.now ?? Date.now();
   const currentSlots = storage.getWorkingMemory();
@@ -14,7 +14,9 @@ export function pushFocus(
   let evicted: WorkingMemorySlot | null = null;
 
   if (currentSlots.length >= config.workingMemoryCapacity) {
-    const oldest = currentSlots.reduce((min, s) => (s.pushedAt < min.pushedAt ? s : min));
+    const oldest = currentSlots.reduce((min, s) =>
+      s.pushedAt < min.pushedAt ? s : min
+    );
     evicted = oldest;
     storage.removeWorkingMemorySlot(oldest.slot);
   }
@@ -38,7 +40,9 @@ export function popFocus(storage: EngramStorage): WorkingMemorySlot | null {
   const slots = storage.getWorkingMemory();
   if (slots.length === 0) return null;
 
-  const newest = slots.reduce((max, s) => (s.pushedAt > max.pushedAt ? s : max));
+  const newest = slots.reduce((max, s) =>
+    s.pushedAt > max.pushedAt ? s : max
+  );
 
   storage.removeWorkingMemorySlot(newest.slot);
   return newest;
@@ -63,7 +67,7 @@ export function getWorkingMemoryIds(storage: EngramStorage): string[] {
 
 export function focusUtilization(
   storage: EngramStorage,
-  config: CognitiveConfig,
+  config: CognitiveConfig
 ): { used: number; capacity: number; utilization: number } {
   const used = storage.getWorkingMemoryCount();
   return {

package/src/mcp/server.ts

@@ -2,6 +2,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod/v4";
+
 import { EngramEngine } from "../core/engine.ts";
 import { MemoryType, Emotion } from "../core/memory.ts";
 import { handleStore, handleRecall, handleManage } from "./tools.ts";
@@ -22,10 +23,21 @@ server.registerTool(
       z.object({
         action: z.literal("encode"),
         content: z.string().describe("Memory content"),
-        type: z.nativeEnum(MemoryType).optional().describe("Memory type (default: semantic)"),
+        type: z
+          .nativeEnum(MemoryType)
+          .optional()
+          .describe("Memory type (default: semantic)"),
         emotion: z.nativeEnum(Emotion).optional().describe("Emotional tag"),
-        emotionWeight: z.number().min(0).max(1).optional().describe("Emotion intensity 0-1"),
-        context: z.string().optional().describe("Context tag (e.g. project:acme)"),
+        emotionWeight: z
+          .number()
+          .min(0)
+          .max(1)
+          .optional()
+          .describe("Emotion intensity 0-1"),
+        context: z
+          .string()
+          .optional()
+          .describe("Context tag (e.g. project:acme)"),
       }),
       z.object({
         action: z.literal("encode_batch"),
@@ -37,7 +49,7 @@ server.registerTool(
               emotion: z.nativeEnum(Emotion).optional(),
               emotionWeight: z.number().min(0).max(1).optional(),
               context: z.string().optional(),
-            }),
+            })
           )
           .min(1)
           .max(50)
@@ -47,12 +59,20 @@ server.registerTool(
         action: z.literal("reconsolidate"),
         id: z.string().describe("Memory ID to update"),
         newContext: z.string().optional().describe("New context to blend"),
-        currentEmotion: z.nativeEnum(Emotion).optional().describe("Current emotional state"),
-        currentEmotionWeight: z.number().min(0).max(1).optional().describe("Emotion intensity"),
+        currentEmotion: z
+          .nativeEnum(Emotion)
+          .optional()
+          .describe("Current emotional state"),
+        currentEmotionWeight: z
+          .number()
+          .min(0)
+          .max(1)
+          .optional()
+          .describe("Emotion intensity"),
       }),
     ]),
   },
-  async (args) => handleStore(engine, args),
+  async (args) => handleStore(engine, args)
 );
 
 server.registerTool(
@@ -67,9 +87,15 @@ server.registerTool(
         limit: z.number().optional().describe("Max results (default: 5)"),
         type: z.nativeEnum(MemoryType).optional().describe("Filter by type"),
         context: z.string().optional().describe("Filter by context"),
-        associative: z.boolean().optional().describe("Spreading activation (default: true)"),
+        associative: z
+          .boolean()
+          .optional()
+          .describe("Spreading activation (default: true)"),
         verbose: z.boolean().optional().describe("Full fields"),
-        format: z.enum(["full", "content", "ids"]).optional().describe("Response format (default: full)"),
+        format: z
+          .enum(["full", "content", "ids"])
+          .optional()
+          .describe("Response format (default: full)"),
       }),
       z.object({
         action: z.literal("inspect"),
@@ -80,15 +106,21 @@ server.registerTool(
         type: z.nativeEnum(MemoryType).optional().describe("Filter by type"),
         context: z.string().optional().describe("Filter by context prefix"),
         limit: z.number().optional().describe("Max results (default: 20)"),
-        offset: z.number().optional().describe("Skip first N results (default: 0)"),
-        format: z.enum(["full", "content", "ids"]).optional().describe("Response format (default: full)"),
+        offset: z
+          .number()
+          .optional()
+          .describe("Skip first N results (default: 0)"),
+        format: z
+          .enum(["full", "content", "ids"])
+          .optional()
+          .describe("Response format (default: full)"),
       }),
       z.object({
         action: z.literal("stats"),
       }),
     ]),
   },
-  async (args) => handleRecall(engine, args),
+  async (args) => handleRecall(engine, args)
 );
 
 server.registerTool(
@@ -103,7 +135,10 @@ server.registerTool(
       z.object({
         action: z.literal("focus_push"),
         content: z.string().describe("Content to hold in focus"),
-        memoryRef: z.string().optional().describe("Reference to existing memory ID"),
+        memoryRef: z
+          .string()
+          .optional()
+          .describe("Reference to existing memory ID"),
       }),
       z.object({
         action: z.literal("focus_pop"),
@@ -117,13 +152,16 @@ server.registerTool(
       z.object({
         action: z.literal("recall_to_focus"),
         cue: z.string().describe("Recall cue"),
-        limit: z.number().optional().describe("Max memories to load (default: 3)"),
+        limit: z
+          .number()
+          .optional()
+          .describe("Max memories to load (default: 3)"),
         type: z.nativeEnum(MemoryType).optional().describe("Filter by type"),
         context: z.string().optional().describe("Filter by context"),
       }),
     ]),
   },
-  async (args) => handleManage(engine, args),
+  async (args) => handleManage(engine, args)
 );
 
 async function main() {