true-mem 1.0.2 → 1.0.3

package/README.md

@@ -7,17 +7,13 @@
 ## Table of Contents
 
 - [Overview](#overview)
-- [The Problem](#the-problem)
-- [The Solution](#the-solution)
-- [The Psychology Behind It](#the-psychology-behind-it)
 - [Key Features](#key-features)
+- [Noise Filtering](#noise-filtering)
 - [Installation](#installation)
 - [Usage](#usage)
 - [Architecture](#architecture)
 - [Memory Classifications](#memory-classifications)
 - [Technical Details](#technical-details)
-- [Inspiration](#inspiration)
-- [Debug](#debug)
 
 ---
 
@@ -78,13 +74,36 @@ What makes True-Mem different from a simple database? It's modeled after how hum
 
 ---
 
-## Installation
+## Noise Filtering
 
-```bash
-npm install true-mem
-```
+What truly sets True-Mem apart is its ability to distinguish **signal from noise**. Unlike simpler memory plugins that store everything matching a keyword, True-Mem understands context and intent:
+
+**What gets filtered OUT:**
+
+| Pattern Type | Example | Why filtered |
+|--------------|---------|--------------|
+| Questions | "Do you remember this?" | It's a question, not a statement |
+| 1st person recall | "I remember when we fixed that" | Recounting, not requesting storage |
+| Remind-me recall | "Remind me how we did this" | Asking AI to recall info, not store |
+| AI meta-talk | "Goal: The user is trying to..." | AI-generated, not user content |
+| List selections | "I prefer option 3" | Context-specific choice, not general preference |
+
+**What gets stored:**
+
+| Pattern Type | Example | Why stored |
+|--------------|---------|------------|
+| Imperatives | "Remember this: always run tests" | Explicit storage request |
+| Preferences | "I prefer TypeScript over JavaScript" | General, reusable preference |
+| Decisions | "We decided to use SQLite" | Project-level decision |
+| Constraints | "Never use var keyword" | Permanent rule |
 
-Then add to your `~/.config/opencode/opencode.jsonc`:
+All filtering patterns support **10 languages**: English, Italian, Spanish, French, German, Portuguese, Dutch, Polish, Turkish, and Russian.
+
+---
+
+## Installation
+
+Add to your `~/.config/opencode/opencode.jsonc`:
 
 ```jsonc
 {
@@ -94,6 +113,8 @@ Then add to your `~/.config/opencode/opencode.jsonc`:
 }
 ```
 
+OpenCode will automatically download the plugin from npm.
+
 ---
 
 ## Usage
@@ -111,11 +132,11 @@ Just have conversations with OpenCode. True-Mem extracts relevant info in the ba
 
 ### Explicit Memory Storage
 
-Use phrases like "Remember this:" or "Ricorda questo:" to force storage:
+Use phrases like "Remember this:" or "Remember that ..." to force storage:
 
 ```
-"Ricorda questo: preferisco sempre usare TypeScript per i miei progetti"
 "Remember this: never commit without running tests first"
+"Remember that I prefer to use TypeScript in my projects"
 ```
 
 ---
@@ -182,10 +203,10 @@ true-mem/
 
 | Layer | Purpose |
 |-------|---------|
-| 1. Negative Patterns | Filter known false positives |
-| 2. Multi-Keyword Scoring | Require 2+ signals |
-| 3. Confidence Threshold | Store only if score >= 0.6 |
-| 4. Role Validation | Human-only for user-level memories |
+| 1. Question Detection | Filter questions before classification |
+| 2. Negative Patterns | AI meta-talk, list selections, 1st person recall, remind-me recall (10 languages) |
+| 3. Multi-Keyword + Sentence-Level | Require 2+ signals in the same sentence |
+| 4. Confidence Threshold | Store only if score >= 0.6 |
 
 ### Decay Strategy
 

package/dist/index.js

@@ -858,12 +858,18 @@ function matchesNegativePattern(text, classification) {
   if (isAIMetaTalk(text)) {
     return true;
   }
+  if (FIRST_PERSON_RECALL_PATTERNS.some((pattern) => pattern.test(text))) {
+    return true;
+  }
+  if (REMIND_RECALL_PATTERNS.some((pattern) => pattern.test(text))) {
+    return true;
+  }
   const patterns = NEGATIVE_PATTERNS[classification];
   if (!patterns)
     return false;
   return patterns.some((pattern) => pattern.test(text));
 }
-var AI_META_TALK_PATTERNS, NEGATIVE_PATTERNS;
+var AI_META_TALK_PATTERNS, FIRST_PERSON_RECALL_PATTERNS, REMIND_RECALL_PATTERNS, NEGATIVE_PATTERNS;
 var init_negative_patterns = __esm(() => {
   AI_META_TALK_PATTERNS = [
     /^(Goal|Summary|Context|Analysis|Note|Overview|Background):\s+The user/i,
@@ -886,6 +892,45 @@ var init_negative_patterns = __esm(() => {
     /\|\w+\|.*\.\.\./i,
     /^\|.+\|$/i
   ];
+  FIRST_PERSON_RECALL_PATTERNS = [
+    /\bI\s+(remember|recall|recollect|don'?t\s+forget)\b/i,
+    /\bwe\s+(remember|recall|recollect)\b/i,
+    /\bI\s+can\s+remember\b/i,
+    /\b(io\s+)?ricordo\b/i,
+    /\bmi\s+ricordo\b/i,
+    /\bho\s+ricordato\b/i,
+    /\b(ci\s+)?ricordiamo\s+(che|di|quando|come|perch)\b/i,
+    /\b(yo\s+)?recuerdo\b/i,
+    /\bme\s+acuerdo\b/i,
+    /\brecordamos\b/i,
+    /\bje\s+(me\s+)?souviens\b/i,
+    /\bnous\s+(nous\s+)?souvenons\b/i,
+    /\bich\s+erinnere(\s+mich)?\b/i,
+    /\bwir\s+erinnern(\s+uns)?\b/i,
+    /\b(eu\s+)?(me\s+)?lembro\b/i,
+    /\bnos\s+lembramos\b/i,
+    /\bik\s+herinner(\s+me)?\b/i,
+    /\bwe\s+herinneren(\s+ons)?\b/i,
+    /\bpami\u0119tam\b/i,
+    /\bpami\u0119tamy\b/i,
+    /\bhat\u0131rl\u0131yorum\b/i,
+    /\bhat\u0131rl\u0131yoruz\b/i
+  ];
+  REMIND_RECALL_PATTERNS = [
+    /\bremind\s+me\s+(how|what|when|where|why|who|which)\b/i,
+    /\bremind\s+me\s+of\s+(the|what|how|when|where|why)\b/i,
+    /\bricordami\s+(come|cosa|quando|dove|perch[e\u00E9]|chi|quale|quanto)\b/i,
+    /\bricordami\s+che\s+(cosa|tipo|ragione)\b/i,
+    /\brec[u\u00FA]rdame\s+(c[o\u00F3]mo|qu[e\u00E9]|cu[a\u00E1]ndo|d[o\u00F3]nde|por\s*qu[e\u00E9]|qui[e\u00E9]n|cu[a\u00E1]l)\b/i,
+    /\brappelle[s]?\s*-?\s*moi\s+(comment|quand|o[u\u00F9]|pourquoi|qui|quel)\b/i,
+    /\brappelle[s]?\s*-?\s*moi\s+ce\s+que\b/i,
+    /\berinner\s+(mich|uns)\s+(wie|was|wann|wo|warum|wer|welche[ns]?)\b/i,
+    /\blembre\s*-?\s*me\s+(como|quando|onde|por\s*que|quem|qual)\b/i,
+    /\blembre\s*-?\s*me\s+o\s+que\b/i,
+    /\bherinner\s+(me|ons)\s+(hoe|wat|wanneer|waar|waarom|wie|welke)\b/i,
+    /\bprzypomnij\s+mi\s+(jak|co|kiedy|gdzie|dlaczego|kto|kt[o\u00F3]ry)\b/i,
+    /\bhat[\u0131i]rlat\s+(bana)\s+(nas[\u0131i]l|ne|ne\s+zaman|nere[dy]e|neden|kim|hangi)\b/i
+  ];
   NEGATIVE_PATTERNS = {
     bugfix: [
       /resolve\s+(dns|ip|address|hostname|url|uri|path)/i,
@@ -1086,8 +1131,6 @@ function classifyWithExplicitIntent(text, signals) {
     /\bmemorizziamo\b:?\s*/gi,
     /\bricordiamoci che\b:?\s*/gi,
     /\bricordiamoci di\b:?\s*/gi,
-    /\bricorda\b:?\s*/gi,
-    /\bremember\b:?\s*/gi,
     /\btieni a mente\b:?\s*/gi,
     /\bkeep in mind\b:?\s*/gi,
     /\bnota che\b:?\s*/gi,
@@ -2912,7 +2955,7 @@ init_logger();
 // package.json
 var package_default = {
   name: "true-mem",
-  version: "1.0.2",
+  version: "1.0.3",
   description: "Persistent memory plugin for OpenCode with cognitive psychology-based memory management",
   main: "dist/index.js",
   types: "dist/index.d.ts",

package/dist/memory/classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/memory/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoCjE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAkCzF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0DxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc/D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EAAE,GACb;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA4FhF;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,WAAW,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8CpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EAAE,EACd,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GACxC;IACD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAsEA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAWR"}
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/memory/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoCjE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAkCzF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0DxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc/D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EAAE,GACb;IAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA0FhF;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,WAAW,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8CpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,EAAE,EACd,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GACxC;IACD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAsEA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAWR"}

package/dist/memory/negative-patterns.d.ts

@@ -23,6 +23,28 @@ export declare function isAIMetaTalk(text: string): boolean;
  * Check if text is a question (should NOT be stored as a statement)
  */
 export declare function isQuestion(text: string): boolean;
+/**
+ * First Person Recall Patterns
+ *
+ * These patterns detect when the user is recounting/recalling something
+ * (1st person indicative) rather than requesting storage (imperative).
+ *
+ * "I remember when..." = recounting, NOT storage request
+ * "Remember this!" = imperative, storage request
+ */
+export declare const FIRST_PERSON_RECALL_PATTERNS: RegExp[];
+/**
+ * Remind Recall Patterns
+ *
+ * These patterns detect when "remind me" is used to request INFORMATION
+ * (recall) rather than to store something (imperative).
+ *
+ * "Remind me how we did this" = asking AI to recall → DON'T store
+ * "Remind me to commit" = imperative to store → STORE
+ *
+ * Key distinction: question word vs. preposition/demonstrative after "remind me"
+ */
+export declare const REMIND_RECALL_PATTERNS: RegExp[];
 export declare const NEGATIVE_PATTERNS: Record<string, RegExp[]>;
 /**
  * Check if text matches any negative pattern for the given classification

package/dist/memory/negative-patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"negative-patterns.d.ts","sourceRoot":"","sources":["../../src/memory/negative-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAmCzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAahD;AAGD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA0DtD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAUpF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB1F"}
+{"version":3,"file":"negative-patterns.d.ts","sourceRoot":"","sources":["../../src/memory/negative-patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAmCzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAahD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,EA0ChD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EA+B1C,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA0DtD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAoBpF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B1F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "true-mem",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Persistent memory plugin for OpenCode with cognitive psychology-based memory management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",