linksee-memory 0.1.0 → 0.1.2

package/README.md

@@ -296,6 +296,22 @@ Caveat and active-goal layers are always preserved. Consider scheduling a weekly
 
 ## Changelog
 
+### v0.1.1 — Pin threshold tweak (2026-04-19)
+
+Based on real-world feedback that `importance=0.95` memories were not
+being treated as pinned despite intent.
+
+- **Pin threshold lowered from `>= 1.0` to `>= 0.9`.** Memories with
+  `importance >= 0.9` are now exempt from the auto-forget sweep and
+  surface `pinned: true` in `recall` and `remember` responses. This
+  matches the natural mental model ("0.9 = high importance = should
+  survive cleanup") without requiring exact `1.0`.
+- All existing memories with `importance >= 0.9` (including older ones
+  set to `0.9` or `0.95`) become pinned automatically — no migration
+  needed.
+- Updated tool descriptions and error messages to reflect the new
+  threshold.
+
 ### v0.1.0 — Major UX update (2026-04-18)
 
 Based on one week of dogfooding, here's what changed:

package/dist/db/migrate.js

@@ -43,6 +43,20 @@ export function runMigrations(db) {
     if (currentVersion > 0 && currentVersion < 4) {
         db.exec(`INSERT INTO memories_fts(rowid, content) SELECT id, content FROM memories;`);
     }
+    // v0.1.1 data migration: pin threshold lowered from 1.0 to 0.9.
+    //
+    // Before v0.1.1, `remember()` only set `protected = 1` for memories
+    // inserted with importance >= 1.0. After v0.1.1, the threshold is 0.9.
+    // Existing rows written under the old rule need to be reconciled so that
+    // `recall().pinned`, `list_entities.pinned_count`, and the auto-forget
+    // guard (`WHERE protected = 0 AND importance < 0.9`) all agree.
+    //
+    // This runs on every startup but is a no-op after the first successful
+    // run (UPDATE filter excludes already-protected rows).
+    const hasMemories = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'memories'").get();
+    if (hasMemories?.name) {
+        db.prepare(`UPDATE memories SET protected = 1 WHERE importance >= 0.9 AND protected = 0`).run();
+    }
 }
 // CLI entrypoint
 if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('migrate.ts') || process.argv[1]?.endsWith('migrate.js')) {

package/dist/mcp/server.js

@@ -12,7 +12,7 @@ import { refreshMomentumForEntity } from '../lib/momentum.js';
 import { consolidate as runConsolidate } from '../lib/consolidate.js';
 import { isPastedExternalContent } from '../lib/session-parser.js';
 import { handleReadSmart as handleReadSmartImpl } from './read-smart.js';
-const SERVER_VERSION = '0.1.0';
+const SERVER_VERSION = '0.1.1';
 const db = openDb();
 runMigrations(db);
 const server = new Server({ name: 'linksee-memory', version: SERVER_VERSION }, { capabilities: { tools: {} } });
@@ -57,7 +57,7 @@ const TOOLS = [
                 entity_key: { type: 'string', description: 'Optional canonical key (email, domain, file path)' },
                 layer: { type: 'string', description: 'One of: goal / context / emotion / implementation / caveat / learning. Common aliases (why, decisions, warnings, how, ...) are accepted.' },
                 content: { type: 'string', description: 'The memory content (plain text or JSON)' },
-                importance: { type: 'number', minimum: 0, maximum: 1, description: '0.0-1.0. Use 1.0 to "pin" a memory (protects from forgetting even outside caveat layer).' },
+                importance: { type: 'number', minimum: 0, maximum: 1, description: '0.0-1.0. Set to 0.9 or higher to "pin" a memory (protects from forgetting even outside caveat layer).' },
                 force: { type: 'boolean', default: false, description: 'Bypass the paste-back/CI-log quality check. Only set when you are sure the content is original user or agent thought.' },
             },
             required: ['entity_name', 'entity_kind', 'layer', 'content'],
@@ -93,7 +93,7 @@ const TOOLS = [
                 memory_id: { type: 'number', description: 'The memory.id to update' },
                 content: { type: 'string', description: 'New content (plain text or JSON). If omitted, content is kept.' },
                 layer: { type: 'string', description: 'Move to a different layer (aliases accepted). If omitted, layer is kept.' },
-                importance: { type: 'number', minimum: 0, maximum: 1, description: 'New importance 0-1. Set to 1.0 to pin.' },
+                importance: { type: 'number', minimum: 0, maximum: 1, description: 'New importance 0-1. Set to 0.9 or higher to pin.' },
             },
             required: ['memory_id'],
         },
@@ -113,7 +113,7 @@ const TOOLS = [
     },
     {
         name: 'forget',
-        description: 'Explicitly delete a memory by id, OR run auto-forgetting across all memories based on forgettingRisk (importance + heat + age). Caveat-layer, goal-layer, and importance=1.0 (pinned) memories are always preserved. Prefer update_memory for corrections — forget is destructive.',
+        description: 'Explicitly delete a memory by id, OR run auto-forgetting across all memories based on forgettingRisk (importance + heat + age). Caveat-layer, goal-layer, and pinned (importance>=0.9) memories are always preserved. Prefer update_memory for corrections — forget is destructive.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -205,7 +205,7 @@ function handleRemember(args) {
     const importance = Math.min(1, Math.max(0, Number(args.importance ?? 0.5)));
     const result = db
         .prepare('INSERT INTO memories (entity_id, layer, content, importance, protected) VALUES (?, ?, ?, ?, ?)')
-        .run(entityId, layer, rawContent, importance, importance >= 1.0 ? 1 : 0);
+        .run(entityId, layer, rawContent, importance, importance >= 0.9 ? 1 : 0);
     db.prepare('INSERT INTO events (entity_id, kind, payload) VALUES (?, ?, ?)').run(entityId, 'memory_stored', JSON.stringify({ layer, memory_id: result.lastInsertRowid }));
     const mom = refreshMomentumForEntity(db, entityId);
     return JSON.stringify({
@@ -213,7 +213,7 @@ function handleRemember(args) {
         memory_id: Number(result.lastInsertRowid),
         entity_id: entityId,
         layer,
-        pinned: importance >= 1.0,
+        pinned: importance >= 0.9,
         momentum: { score: mom.score, band: mom.band },
     });
 }
@@ -372,7 +372,7 @@ function handleRecall(args) {
         const heatNorm = heat.score / 100;
         const momNorm = Math.min(1, (r.momentum_score ?? 0) / 10);
         const importanceBoost = r.importance; // 0-1
-        // Composite: give a bit to importance so pinned (1.0) memories always rank high
+        // Composite: give a bit to importance so pinned (>=0.9) memories always rank high
         const w_rel = 0.45, w_heat = 0.25, w_mom = 0.15, w_imp = 0.15;
         const composite = w_rel * relevance + w_heat * heatNorm + w_mom * momNorm + w_imp * importanceBoost;
         // match_reasons: human-readable WHY this row is here
@@ -393,7 +393,7 @@ function handleRecall(args) {
             reasons.push('heat:warm');
         if (r.momentum_score >= 5)
             reasons.push('entity_active');
-        if (r.importance >= 1.0)
+        if (r.importance >= 0.9)
             reasons.push('pinned');
         else if (r.importance >= 0.8)
             reasons.push('high_importance');
@@ -461,7 +461,7 @@ function handleRecall(args) {
                 content: parsedContent,
                 content_raw: r.content,
                 importance: r.importance,
-                pinned: r.importance >= 1.0,
+                pinned: r.importance >= 0.9,
                 heat: Number(r.heat_score.toFixed(1)),
                 band: r.heat_band,
                 composite: Number(r.composite_score.toFixed(3)),
@@ -473,27 +473,27 @@ function handleRecall(args) {
 }
 function handleForget(args) {
     if (args.memory_id) {
-        // Explicit delete by id — respect protected AND pinned (importance >= 1.0)
+        // Explicit delete by id — respect protected AND pinned (importance >= 0.9)
         const target = db.prepare('SELECT id, layer, importance, protected FROM memories WHERE id = ?').get(args.memory_id);
         if (!target) {
             return JSON.stringify({ ok: false, error: `memory_id ${args.memory_id} not found` });
         }
-        if (target.protected === 1 || target.importance >= 1.0) {
+        if (target.protected === 1 || target.importance >= 0.9) {
             return JSON.stringify({
                 ok: false,
                 preserved: true,
-                reason: target.protected === 1 ? `${target.layer}-layer is auto-protected` : 'pinned (importance=1.0)',
-                hint: 'Use update_memory to lower importance below 1.0 first, then forget.',
+                reason: target.protected === 1 ? `${target.layer}-layer is auto-protected` : 'pinned (importance>=0.9)',
+                hint: 'Use update_memory to lower importance below 0.9 first, then forget.',
             });
         }
         const res = db.prepare('DELETE FROM memories WHERE id = ?').run(args.memory_id);
         return JSON.stringify({ ok: true, deleted: res.changes, memory_id: args.memory_id });
     }
-    // Auto-sweep — also respect importance=1.0 as protection
+    // Auto-sweep — also respect pin (importance >= 0.9) as protection
     const rows = db
         .prepare(`SELECT id, layer, importance, access_count, last_accessed_at, protected
               FROM memories
-              WHERE protected = 0 AND importance < 1.0`)
+              WHERE protected = 0 AND importance < 0.9`)
         .all();
     const now = Math.floor(Date.now() / 1000);
     const actions = [];
@@ -545,7 +545,7 @@ function handleConsolidate(args) {
       FROM memories m
       JOIN entities e ON e.id = m.entity_id
       WHERE m.protected = 0
-        AND m.importance < 1.0
+        AND m.importance < 0.9
         AND m.layer IN ('context', 'emotion', 'implementation')
         AND m.created_at <= ?
       GROUP BY m.entity_id, m.layer
@@ -601,7 +601,7 @@ function handleUpdateMemory(args) {
     if (args.importance !== undefined) {
         const imp = Math.min(1, Math.max(0, Number(args.importance)));
         patch.importance = imp;
-        patch.protected = imp >= 1.0 || existing.protected === 1 ? 1 : 0;
+        patch.protected = imp >= 0.9 || existing.protected === 1 ? 1 : 0;
     }
     const keys = Object.keys(patch);
     if (keys.length === 0) {
@@ -616,7 +616,7 @@ function handleUpdateMemory(args) {
         ok: true,
         memory_id: memoryId,
         updated_fields: keys,
-        pinned: (patch.importance ?? existing.importance) >= 1.0,
+        pinned: (patch.importance ?? existing.importance) >= 0.9,
     });
 }
 function handleListEntities(args) {
@@ -633,7 +633,7 @@ function handleListEntities(args) {
            SUM(CASE WHEN m.layer = 'caveat' THEN 1 ELSE 0 END) as caveat_count,
            SUM(CASE WHEN m.layer = 'learning' THEN 1 ELSE 0 END) as learning_count,
            SUM(CASE WHEN m.layer = 'implementation' THEN 1 ELSE 0 END) as impl_count,
-           SUM(CASE WHEN m.importance >= 1.0 THEN 1 ELSE 0 END) as pinned_count
+           SUM(CASE WHEN m.importance >= 0.9 THEN 1 ELSE 0 END) as pinned_count
     FROM entities e
     LEFT JOIN memories m ON m.entity_id = e.id
     WHERE 1=1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linksee-memory",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "mcpName": "io.github.michielinksee/linksee-memory",
   "description": "Local-first agent memory MCP — cross-agent brain with 6-layer structured memory + token-saving file diff cache",
   "type": "module",