universal-agent-memory 1.0.25 → 1.2.0

package/dist/memory/terminal-bench-knowledge.js

@@ -8,6 +8,7 @@
  * - extract-elf: ELF format knowledge enabled correct parsing
  * - password-recovery: hashcat/john guidance led to successful recovery
  */
+import { fuzzyKeywordMatch } from '../utils/string-similarity.js';
 export const TERMINAL_BENCH_KNOWLEDGE = [
     // Security - Password Cracking (proven +1 task improvement)
     {
@@ -153,20 +154,25 @@ export const TERMINAL_BENCH_KNOWLEDGE = [
 ];
 /**
  * Get domain knowledge relevant to a task
+ * Uses fuzzy/stemming matching for better recall
  */
 export function getRelevantKnowledge(taskInstruction, category) {
-    const lower = taskInstruction.toLowerCase();
     const relevant = [];
     for (const knowledge of TERMINAL_BENCH_KNOWLEDGE) {
         // Category filter
         if (category && knowledge.category !== category)
             continue;
-        // Score by keyword matches
+        // Score by keyword matches using fuzzy matching
         let score = 0;
         for (const keyword of knowledge.keywords) {
-            if (lower.includes(keyword.toLowerCase())) {
+            // Exact match gets full point
+            if (taskInstruction.toLowerCase().includes(keyword.toLowerCase())) {
                 score += 1;
             }
+            // Fuzzy/stemmed match gets partial point
+            else if (fuzzyKeywordMatch(taskInstruction, keyword)) {
+                score += 0.5;
+            }
         }
         if (score > 0) {
             relevant.push({ ...knowledge, score });
@@ -190,9 +196,82 @@ export function formatKnowledgeForContext(knowledge) {
     }
     return lines.join('\n');
 }
+/**
+ * Record knowledge outcome and optionally persist to long-term memory.
+ * Call this when a task succeeds or fails to improve future accuracy.
+ *
+ * @param taskPattern - Keywords describing the task (e.g., "password 7z crack")
+ * @param success - Whether the task succeeded
+ * @param learnedKnowledge - Optional new knowledge to persist (only on success)
+ * @param persistPath - Path to long_term_prepopulated.json (optional)
+ */
+export function recordKnowledgeOutcome(taskPattern, success, learnedKnowledge, persistPath) {
+    // Update relevance/importance of existing knowledge based on outcome
+    const matchedKnowledge = getRelevantKnowledge(taskPattern);
+    for (const k of matchedKnowledge) {
+        // Find in main array and adjust importance
+        const original = TERMINAL_BENCH_KNOWLEDGE.find(tk => tk.content === k.content && tk.category === k.category);
+        if (original) {
+            if (success) {
+                // Boost importance on success (max 10)
+                original.importance = Math.min(10, original.importance + 0.5);
+            }
+            else {
+                // Slightly reduce importance on failure (min 3)
+                original.importance = Math.max(3, original.importance - 0.2);
+            }
+        }
+    }
+    // Add new knowledge if provided and task succeeded
+    if (success && learnedKnowledge) {
+        const newEntry = {
+            ...learnedKnowledge,
+            importance: learnedKnowledge.importance ?? 7,
+        };
+        // Check if similar knowledge already exists
+        const exists = TERMINAL_BENCH_KNOWLEDGE.some(k => k.content === newEntry.content ||
+            (k.category === newEntry.category &&
+                k.keywords.some(kw => newEntry.keywords.includes(kw))));
+        if (!exists) {
+            TERMINAL_BENCH_KNOWLEDGE.push(newEntry);
+            // Persist to file if path provided (fire-and-forget, don't block)
+            if (persistPath) {
+                persistNewKnowledge(newEntry, persistPath).catch(() => { });
+            }
+        }
+    }
+}
+/**
+ * Persist new knowledge to long_term_prepopulated.json
+ */
+async function persistNewKnowledge(knowledge, filePath) {
+    try {
+        const fs = await import('fs');
+        let data = { memories: [] };
+        if (fs.existsSync(filePath)) {
+            try {
+                data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            }
+            catch {
+                // Start fresh if parse fails
+            }
+        }
+        if (!data.memories)
+            data.memories = [];
+        data.memories.push({
+            ...knowledge,
+            addedAt: new Date().toISOString(),
+        });
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+    }
+    catch {
+        // Silently fail persistence - don't break the main flow
+    }
+}
 export default {
     TERMINAL_BENCH_KNOWLEDGE,
     getRelevantKnowledge,
     formatKnowledgeForContext,
+    recordKnowledgeOutcome,
 };
 //# sourceMappingURL=terminal-bench-knowledge.js.map

package/dist/memory/terminal-bench-knowledge.js.map

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

package/dist/utils/string-similarity.d.ts

@@ -0,0 +1,37 @@
+/**
+ * String Similarity Utilities for UAM
+ *
+ * Shared text comparison functions used across memory compression,
+ * deduplication, and retrieval systems.
+ */
+/**
+ * Calculate Jaccard similarity between two strings (word-level)
+ * Returns a value between 0 (no overlap) and 1 (identical)
+ */
+export declare function jaccardSimilarity(a: string, b: string): number;
+/**
+ * Calculate content hash for deduplication
+ * Uses SHA-256 for reliable collision resistance
+ */
+export declare function contentHash(text: string): string;
+/**
+ * Improved token estimation
+ * More accurate than simple length/4 for mixed code and prose
+ */
+export declare function estimateTokensAccurate(text: string): number;
+/**
+ * Simple stemming for keyword matching
+ * Handles common English suffixes for better fuzzy matching
+ */
+export declare function simpleStem(word: string): string;
+/**
+ * Fuzzy keyword match using stemming
+ * Returns true if any stemmed form matches
+ */
+export declare function fuzzyKeywordMatch(text: string, keyword: string): boolean;
+/**
+ * Calculate text similarity using multiple methods
+ * Returns weighted average for more robust comparison
+ */
+export declare function textSimilarity(a: string, b: string): number;
+//# sourceMappingURL=string-similarity.d.ts.map

package/dist/utils/string-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-similarity.d.ts","sourceRoot":"","sources":["../../src/utils/string-similarity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuB3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAkBxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa3D"}

package/dist/utils/string-similarity.js

@@ -0,0 +1,114 @@
+/**
+ * String Similarity Utilities for UAM
+ *
+ * Shared text comparison functions used across memory compression,
+ * deduplication, and retrieval systems.
+ */
+import { createHash } from 'crypto';
+/**
+ * Calculate Jaccard similarity between two strings (word-level)
+ * Returns a value between 0 (no overlap) and 1 (identical)
+ */
+export function jaccardSimilarity(a, b) {
+    const setA = new Set(a.toLowerCase().split(/\s+/).filter(w => w.length > 1));
+    const setB = new Set(b.toLowerCase().split(/\s+/).filter(w => w.length > 1));
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    if (setA.size === 0 || setB.size === 0)
+        return 0;
+    const intersection = new Set([...setA].filter(x => setB.has(x)));
+    const union = new Set([...setA, ...setB]);
+    return intersection.size / union.size;
+}
+/**
+ * Calculate content hash for deduplication
+ * Uses SHA-256 for reliable collision resistance
+ */
+export function contentHash(text) {
+    return createHash('sha256')
+        .update(text.toLowerCase().replace(/\s+/g, ' ').trim())
+        .digest('hex')
+        .slice(0, 16); // 16 hex chars = 64 bits, sufficient for dedup
+}
+/**
+ * Improved token estimation
+ * More accurate than simple length/4 for mixed code and prose
+ */
+export function estimateTokensAccurate(text) {
+    if (!text || text.length === 0)
+        return 0;
+    // Split by whitespace and count
+    const words = text.split(/\s+/).filter(w => w.length > 0);
+    // Count special characters that typically become separate tokens
+    const specialChars = (text.match(/[{}()\[\]<>:;,."'`@#$%^&*+=|\\/?!~-]/g) || []).length;
+    // Code tokens: variable names split on camelCase/snake_case
+    const codeTokens = (text.match(/[a-z][A-Z]|_[a-z]/g) || []).length;
+    // Numbers often tokenize separately
+    const numbers = (text.match(/\d+/g) || []).length;
+    // Base: words + adjustments
+    // Average English word is ~1.3 tokens, code identifiers ~1.5
+    const baseTokens = words.length * 1.3;
+    const specialTokens = specialChars * 0.5;
+    const extraCodeTokens = codeTokens * 0.3;
+    const numberTokens = numbers * 0.5;
+    return Math.ceil(baseTokens + specialTokens + extraCodeTokens + numberTokens);
+}
+/**
+ * Simple stemming for keyword matching
+ * Handles common English suffixes for better fuzzy matching
+ */
+export function simpleStem(word) {
+    const lower = word.toLowerCase();
+    // Common suffixes to strip
+    const suffixes = ['ing', 'ed', 'es', 's', 'er', 'est', 'ly', 'tion', 'ment', 'ness', 'able', 'ible'];
+    for (const suffix of suffixes) {
+        if (lower.endsWith(suffix) && lower.length > suffix.length + 2) {
+            const stem = lower.slice(0, -suffix.length);
+            // Handle doubling (e.g., "running" -> "run")
+            if (stem.length > 2 && stem[stem.length - 1] === stem[stem.length - 2]) {
+                return stem.slice(0, -1);
+            }
+            return stem;
+        }
+    }
+    return lower;
+}
+/**
+ * Fuzzy keyword match using stemming
+ * Returns true if any stemmed form matches
+ */
+export function fuzzyKeywordMatch(text, keyword) {
+    const textLower = text.toLowerCase();
+    const keywordLower = keyword.toLowerCase();
+    // Exact match first
+    if (textLower.includes(keywordLower))
+        return true;
+    // Stemmed match
+    const keywordStem = simpleStem(keywordLower);
+    const textWords = textLower.split(/\s+/);
+    for (const word of textWords) {
+        if (simpleStem(word) === keywordStem)
+            return true;
+        // Also check if the stem is contained in the word (for compound words)
+        if (word.includes(keywordStem) && keywordStem.length >= 3)
+            return true;
+    }
+    return false;
+}
+/**
+ * Calculate text similarity using multiple methods
+ * Returns weighted average for more robust comparison
+ */
+export function textSimilarity(a, b) {
+    // Jaccard on words
+    const jaccard = jaccardSimilarity(a, b);
+    // Character-level containment
+    const aLower = a.toLowerCase();
+    const bLower = b.toLowerCase();
+    const shorter = aLower.length < bLower.length ? aLower : bLower;
+    const longer = aLower.length >= bLower.length ? aLower : bLower;
+    const containment = shorter.length > 0 && longer.includes(shorter) ? 0.8 : 0;
+    // Weighted combination
+    return Math.max(jaccard, containment);
+}
+//# sourceMappingURL=string-similarity.js.map

package/dist/utils/string-similarity.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-agent-memory",
-  "version": "1.0.25",
+  "version": "1.2.0",
   "description": "Universal AI agent memory system - CLAUDE.md templates, memory, worktrees for Claude Code, Factory.AI, VSCode, OpenCode",
   "type": "module",
   "main": "dist/index.js",