linksee-memory 0.17.0 → 0.17.2

package/dist/mcp/server.js

@@ -6,11 +6,11 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { openDb, runMigrations } from '../db/migrate.js';
+import { openDb, runMigrations, DbRefusedError } from '../db/migrate.js';
 import { computeHeat } from '../lib/heat-index.js';
 import { decideForgetting } from '../lib/forgetting.js';
 import { refreshMomentumForEntity } from '../lib/momentum.js';
-import { consolidate as runConsolidate } from '../lib/consolidate.js';
+import { consolidate as runConsolidate, autoConsolidateEnabled } from '../lib/consolidate.js';
 import { isPastedExternalContent } from '../lib/session-parser.js';
 import { inferAltitude, inferType, inferState } from '../lib/session-extractor.js';
 import { normalizeEntityName } from '../lib/normalize.js';
@@ -64,6 +64,8 @@ const SUBCOMMANDS = {
     detect: 'detect-drift.js',
     export: 'export-report.js',
     'share-draft': 'share-draft.js',
+    migrate: 'migrate-legacy.js', // 0.17.2: schema 1–5 → current, without starting the server
+    runtime: 'runtime.js', // 0.17.2: runtime list | prune
 };
 const subcommand = process.argv[2];
 if (subcommand && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, subcommand)) {
@@ -72,8 +74,20 @@ if (subcommand && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, subcommand))
     const r = spawnSync(process.execPath, [binPath, ...process.argv.slice(3)], { stdio: 'inherit' });
     process.exit(r.status ?? (r.signal ? 1 : 0));
 }
-const db = openDb();
-runMigrations(db);
+let db;
+try {
+    db = openDb();
+    runMigrations(db);
+}
+catch (e) {
+    // A pre-June-2026 DB (schema < 6) is refused before any write; print what to do
+    // instead of a stack trace. MCP clients show the server's stderr in their logs.
+    if (e instanceof DbRefusedError) {
+        process.stderr.write(`${e.message}\n`);
+        process.exit(1);
+    }
+    throw e;
+}
 // Distill triage runs on EVERY start, before the first request. It is one indexed scan and a
 // handful of JSON rewrites — cheap — and 0.16.0 had tucked it inside the auto-consolidate block
 // below, which runs at most once a week and only after a 3-second timer. So it never ran.
@@ -84,29 +98,37 @@ try {
     }
 }
 catch { /* never block startup */ }
-// Auto-maintenance: consolidate stale memories on startup (non-blocking)
-setTimeout(() => {
-    try {
-        let shouldRun = true;
+// Auto-maintenance: consolidate stale memories on startup (non-blocking).
+//
+// OFF by default since 0.17.1 (L-1-106 / audit F1): consolidate deletes the original rows after
+// writing a summary that keeps only the top 3 × 200 characters, ignores thread_id, and cascades
+// away their edges — reasons and history lost with no action from the user. It now runs only
+// when asked: LINKSEE_AUTO_CONSOLIDATE=1 (or `--auto-consolidate` on the server command line).
+// There is no `consolidate` tool (merged away in 0.7.0). Rows already removed by earlier versions
+// are not restored.
+if (autoConsolidateEnabled(process.env, process.argv.slice(2)))
+    setTimeout(() => {
         try {
-            // Check if consolidations table exists before querying
-            const tableExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='consolidations'").get();
-            if (tableExists) {
-                const lastRow = db.prepare('SELECT MAX(created_at) as ts FROM consolidations').get();
-                if (lastRow?.ts && (Date.now() / 1000 - lastRow.ts) / 86400 < 7)
-                    shouldRun = false;
+            let shouldRun = true;
+            try {
+                // Check if consolidations table exists before querying
+                const tableExists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='consolidations'").get();
+                if (tableExists) {
+                    const lastRow = db.prepare('SELECT MAX(created_at) as ts FROM consolidations').get();
+                    if (lastRow?.ts && (Date.now() / 1000 - lastRow.ts) / 86400 < 7)
+                        shouldRun = false;
+                }
+            }
+            catch {
+                shouldRun = false; /* genuinely unexpected — skip to be safe */
+            }
+            if (shouldRun) {
+                runConsolidate(db, { scope: 'all', min_age_days: 7 });
+                process.stderr.write('[linksee-memory] auto-consolidate complete\n');
             }
         }
-        catch {
-            shouldRun = false; /* genuinely unexpected — skip to be safe */
-        }
-        if (shouldRun) {
-            runConsolidate(db, { scope: 'all', min_age_days: 7 });
-            process.stderr.write('[linksee-memory] auto-consolidate complete\n');
-        }
-    }
-    catch { /* non-fatal */ }
-}, 3000);
+        catch { /* non-fatal */ }
+    }, 3000);
 const server = new Server({ name: 'linksee-memory', version: SERVER_VERSION }, {
     capabilities: {
         tools: {},
@@ -610,15 +632,15 @@ function appendAxisFilters(sql, params, filters) {
     return sql;
 }
 function runFtsQuery(query, layer, limit, axis) {
-    let sql = `
-    SELECT m.id, m.entity_id, e.name as entity_name, e.kind as entity_kind, e.momentum_score,
-           m.layer, m.content, m.importance, m.created_at, m.last_accessed_at, m.access_count,
-           m.altitude as _altitude, m.mem_type as _mem_type, m.mem_state as _mem_state, m.thread_id as _thread_id,
-           bm25(memories_fts) as bm25_score
-    FROM memories_fts
-    JOIN memories m ON m.id = memories_fts.rowid
-    JOIN entities e ON e.id = m.entity_id
-    WHERE memories_fts MATCH ?
+    let sql = `
+    SELECT m.id, m.entity_id, e.name as entity_name, e.kind as entity_kind, e.momentum_score,
+           m.layer, m.content, m.importance, m.created_at, m.last_accessed_at, m.access_count,
+           m.altitude as _altitude, m.mem_type as _mem_type, m.mem_state as _mem_state, m.thread_id as _thread_id,
+           bm25(memories_fts) as bm25_score
+    FROM memories_fts
+    JOIN memories m ON m.id = memories_fts.rowid
+    JOIN entities e ON e.id = m.entity_id
+    WHERE memories_fts MATCH ?
   `;
     const params = [query];
     if (layer) {
@@ -632,14 +654,14 @@ function runFtsQuery(query, layer, limit, axis) {
     return db.prepare(sql).all(...params);
 }
 function runLikeQuery(query, entityName, layer, limit, axis) {
-    let sql = `
-    SELECT m.id, m.entity_id, e.name as entity_name, e.kind as entity_kind, e.momentum_score,
-           m.layer, m.content, m.importance, m.created_at, m.last_accessed_at, m.access_count,
-           m.altitude as _altitude, m.mem_type as _mem_type, m.mem_state as _mem_state, m.thread_id as _thread_id,
-           0 as bm25_score
-    FROM memories m
-    JOIN entities e ON e.id = m.entity_id
-    WHERE 1=1
+    let sql = `
+    SELECT m.id, m.entity_id, e.name as entity_name, e.kind as entity_kind, e.momentum_score,
+           m.layer, m.content, m.importance, m.created_at, m.last_accessed_at, m.access_count,
+           m.altitude as _altitude, m.mem_type as _mem_type, m.mem_state as _mem_state, m.thread_id as _thread_id,
+           0 as bm25_score
+    FROM memories m
+    JOIN entities e ON e.id = m.entity_id
+    WHERE 1=1
   `;
     const params = [];
     if (entityName) {
@@ -970,8 +992,8 @@ function handleForget(args) {
     }
     // Auto-sweep — also respect pin (importance >= 0.9) as protection
     const rows = db
-        .prepare(`SELECT id, layer, importance, access_count, last_accessed_at, protected, altitude
-              FROM memories
+        .prepare(`SELECT id, layer, importance, access_count, last_accessed_at, protected, altitude
+              FROM memories
               WHERE protected = 0 AND importance < 0.9`)
         .all();
     const now = Math.floor(Date.now() / 1000);
@@ -1020,17 +1042,17 @@ function handleConsolidate(args) {
         // read-only audit: count candidates using the same rules.
         const now = Math.floor(Date.now() / 1000);
         const ageCutoff = now - (args.min_age_days ?? 7) * 86400;
-        const candidates = db.prepare(`
-      SELECT m.entity_id, e.name as entity_name, m.layer, COUNT(*) as c
-      FROM memories m
-      JOIN entities e ON e.id = m.entity_id
-      WHERE m.protected = 0
-        AND m.importance < 0.9
-        AND m.layer IN ('context', 'emotion', 'implementation')
-        AND m.created_at <= ?
-      GROUP BY m.entity_id, m.layer
-      HAVING c >= 2
-      ORDER BY c DESC
+        const candidates = db.prepare(`
+      SELECT m.entity_id, e.name as entity_name, m.layer, COUNT(*) as c
+      FROM memories m
+      JOIN entities e ON e.id = m.entity_id
+      WHERE m.protected = 0
+        AND m.importance < 0.9
+        AND m.layer IN ('context', 'emotion', 'implementation')
+        AND m.created_at <= ?
+      GROUP BY m.entity_id, m.layer
+      HAVING c >= 2
+      ORDER BY c DESC
     `).all(ageCutoff);
         const totalReplaced = candidates.reduce((s, c) => s + c.c, 0);
         return JSON.stringify({
@@ -1104,19 +1126,19 @@ function handleListEntities(args) {
     const minMemories = Math.max(1, Number(args?.min_memories ?? 1));
     const limit = Math.max(1, Math.min(200, Number(args?.limit ?? 30)));
     const offset = Math.max(0, Number(args?.offset ?? 0));
-    let sql = `
-    SELECT e.id, e.name, e.kind, e.canonical_key, e.momentum_score,
-           e.updated_at, e.created_at,
-           COUNT(m.id) as memory_count,
-           MAX(m.last_accessed_at) as last_memory_access,
-           SUM(CASE WHEN m.layer = 'goal' THEN 1 ELSE 0 END) as goal_count,
-           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 >= 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
+    let sql = `
+    SELECT e.id, e.name, e.kind, e.canonical_key, e.momentum_score,
+           e.updated_at, e.created_at,
+           COUNT(m.id) as memory_count,
+           MAX(m.last_accessed_at) as last_memory_access,
+           SUM(CASE WHEN m.layer = 'goal' THEN 1 ELSE 0 END) as goal_count,
+           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 >= 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
   `;
     const params = [];
     if (kind) {
@@ -1168,29 +1190,29 @@ function handleRecallFile(args) {
         return JSON.stringify({ ok: true, count: 0, note: 'No edits found for that path substring.' });
     }
     // Daily breakdown
-    const daily = db.prepare(`
-    SELECT DATE(occurred_at, 'unixepoch') as day, operation, COUNT(*) as edits
-    FROM session_file_edits WHERE file_path LIKE ?
-    GROUP BY day, operation ORDER BY day
+    const daily = db.prepare(`
+    SELECT DATE(occurred_at, 'unixepoch') as day, operation, COUNT(*) as edits
+    FROM session_file_edits WHERE file_path LIKE ?
+    GROUP BY day, operation ORDER BY day
   `).all(`%${sub}%`);
     // Distinct context_snippets (intents) — deduped, ordered by recency
-    const intents = db.prepare(`
-    SELECT DISTINCT context_snippet, MAX(occurred_at) as last_at, COUNT(*) as freq
-    FROM session_file_edits
-    WHERE file_path LIKE ? AND context_snippet IS NOT NULL AND LENGTH(context_snippet) > 20
-    GROUP BY context_snippet
-    ORDER BY last_at DESC
-    LIMIT ?
+    const intents = db.prepare(`
+    SELECT DISTINCT context_snippet, MAX(occurred_at) as last_at, COUNT(*) as freq
+    FROM session_file_edits
+    WHERE file_path LIKE ? AND context_snippet IS NOT NULL AND LENGTH(context_snippet) > 20
+    GROUP BY context_snippet
+    ORDER BY last_at DESC
+    LIMIT ?
   `).all(`%${sub}%`, maxIntents);
     // Linked memories
-    const memories = db.prepare(`
-    SELECT DISTINCT m.id, m.layer, m.content, m.importance, e.name as entity_name
-    FROM session_file_edits sfe
-    JOIN memories m ON m.id = sfe.memory_id
-    JOIN entities e ON e.id = m.entity_id
-    WHERE sfe.file_path LIKE ?
-    ORDER BY m.importance DESC
-    LIMIT 20
+    const memories = db.prepare(`
+    SELECT DISTINCT m.id, m.layer, m.content, m.importance, e.name as entity_name
+    FROM session_file_edits sfe
+    JOIN memories m ON m.id = sfe.memory_id
+    JOIN entities e ON e.id = m.entity_id
+    WHERE sfe.file_path LIKE ?
+    ORDER BY m.importance DESC
+    LIMIT 20
   `).all(`%${sub}%`);
     // Distinct file paths matched (the substring may match multiple files)
     const paths = db.prepare(`SELECT file_path, COUNT(*) as edits FROM session_file_edits WHERE file_path LIKE ? GROUP BY file_path ORDER BY edits DESC`).all(`%${sub}%`);
@@ -1257,10 +1279,10 @@ async function handleConsolidateWithSampling(args) {
     const ageCutoff = Math.floor(Date.now() / 1000) - (typeof args?.min_age_days === 'number' ? args.min_age_days : 7) * 86400;
     const snapshot = new Map();
     const candidateRows = db
-        .prepare(`SELECT m.id, m.content, e.name as entity_name
-       FROM memories m JOIN entities e ON e.id = m.entity_id
-       WHERE m.protected = 0
-         AND m.layer IN ('context','emotion','implementation')
+        .prepare(`SELECT m.id, m.content, e.name as entity_name
+       FROM memories m JOIN entities e ON e.id = m.entity_id
+       WHERE m.protected = 0
+         AND m.layer IN ('context','emotion','implementation')
          AND m.created_at <= ?`)
         .all(ageCutoff);
     for (const r of candidateRows)
@@ -1626,8 +1648,8 @@ function resolveProjectFromRecentEdits() {
     if (projects.length <= 1)
         return { project: projects[0] };
     const rows = db
-        .prepare(`SELECT file_path FROM session_file_edits
-        WHERE occurred_at > unixepoch() - 86400
+        .prepare(`SELECT file_path FROM session_file_edits
+        WHERE occurred_at > unixepoch() - 86400
         ORDER BY occurred_at DESC LIMIT 50`)
         .all();
     if (rows.length === 0)
@@ -1815,25 +1837,25 @@ function handleFlagProposals(args) {
     const sessionContext = args.session_context ?? 'conversation session';
     const PROPOSAL_TAG = 'orphaned_proposal';
     const now = Math.floor(Date.now() / 1000);
-    const insertAnchor = db.prepare(`
-    INSERT INTO drift_anchors (
-      kind, statement, rationale, domain, decision_mode,
-      confidence, lifecycle, status, owner,
-      evidence_refs, created_at, updated_at
-    ) VALUES (
-      'decision', ?, ?, ?, 'hypothesis',
-      ?, 'active', 'active', 'agent',
-      ?, ?, ?
-    )
+    const insertAnchor = db.prepare(`
+    INSERT INTO drift_anchors (
+      kind, statement, rationale, domain, decision_mode,
+      confidence, lifecycle, status, owner,
+      evidence_refs, created_at, updated_at
+    ) VALUES (
+      'decision', ?, ?, ?, 'hypothesis',
+      ?, 'active', 'active', 'agent',
+      ?, ?, ?
+    )
   `);
-    const insertCandidate = db.prepare(`
-    INSERT INTO memory_write_candidates (
-      scope, candidate_type, target_node_id, rationale,
-      confidence, evidence_refs, status, created_at
-    ) VALUES (
-      'orphaned_proposal', 'update_node', ?, ?,
-      ?, ?, 'pending_review', ?
-    )
+    const insertCandidate = db.prepare(`
+    INSERT INTO memory_write_candidates (
+      scope, candidate_type, target_node_id, rationale,
+      confidence, evidence_refs, status, created_at
+    ) VALUES (
+      'orphaned_proposal', 'update_node', ?, ?,
+      ?, ?, 'pending_review', ?
+    )
   `);
     const results = [];
     const txn = db.transaction(() => {
@@ -1877,13 +1899,13 @@ function handleFlagProposals(args) {
 function handleDream(args) {
     const domainFilter = args?.domain;
     // 1. Fetch active North Star anchor(s)
-    const northStars = db.prepare(`
-    SELECT id, statement, rationale, domain, confidence, lifecycle,
-           datetime(review_after, 'unixepoch') as review_date,
-           datetime(created_at, 'unixepoch') as declared_at
-    FROM drift_anchors
-    WHERE node_type = 'north_star' AND status = 'active'
-    ORDER BY created_at DESC
+    const northStars = db.prepare(`
+    SELECT id, statement, rationale, domain, confidence, lifecycle,
+           datetime(review_after, 'unixepoch') as review_date,
+           datetime(created_at, 'unixepoch') as declared_at
+    FROM drift_anchors
+    WHERE node_type = 'north_star' AND status = 'active'
+    ORDER BY created_at DESC
   `).all();
     // Re-injection friction — the active-observability loop closing back into reflection.
     // "Re-surfaced N×, yet still contradicted in reality" is the machine evidence behind #15443.
@@ -1901,23 +1923,23 @@ function handleDream(args) {
     const distillLimit = Math.max(1, Math.min(25, Number(args?.distill ?? 8) || 8));
     let distillQueue = [];
     try {
-        const rows = db.prepare(`
-      SELECT m.id, m.layer, m.content, datetime(m.created_at, 'unixepoch') AS created, e.name AS entity
-        FROM memories m JOIN entities e ON e.id = m.entity_id
-       WHERE m.layer IN ('learning', 'caveat')
-         AND json_valid(m.content)
-         -- settle window: the Stop hook extracts every turn, so the newest rows belong to a
-         -- session still in motion. Don't ask the agent to distill the conversation it is in.
-         AND m.created_at < unixepoch() - 1800
-         AND json_extract(m.content, '$.distill_verdict') IS NULL
-         AND (json_extract(m.content, '$.needs_distill') = 1
-              OR json_extract(m.content, '$.why') = 'Decision detected by pattern match — may need agent enrichment'
-              OR json_extract(m.content, '$.why') = 'User-stated warning/prohibition — auto-extracted by caveat pattern match')
-       ORDER BY (m.layer = 'caveat') DESC,
-                (e.name <> 'Local') DESC,
-                length(json_extract(m.content, '$.what')) DESC,
-                m.created_at DESC
-       LIMIT ${distillLimit}
+        const rows = db.prepare(`
+      SELECT m.id, m.layer, m.content, datetime(m.created_at, 'unixepoch') AS created, e.name AS entity
+        FROM memories m JOIN entities e ON e.id = m.entity_id
+       WHERE m.layer IN ('learning', 'caveat')
+         AND json_valid(m.content)
+         -- settle window: the Stop hook extracts every turn, so the newest rows belong to a
+         -- session still in motion. Don't ask the agent to distill the conversation it is in.
+         AND m.created_at < unixepoch() - 1800
+         AND json_extract(m.content, '$.distill_verdict') IS NULL
+         AND (json_extract(m.content, '$.needs_distill') = 1
+              OR json_extract(m.content, '$.why') = 'Decision detected by pattern match — may need agent enrichment'
+              OR json_extract(m.content, '$.why') = 'User-stated warning/prohibition — auto-extracted by caveat pattern match')
+       ORDER BY (m.layer = 'caveat') DESC,
+                (e.name <> 'Local') DESC,
+                length(json_extract(m.content, '$.what')) DESC,
+                m.created_at DESC
+       LIMIT ${distillLimit}
     `).all();
         distillQueue = rows.map((r) => {
             let c = {};
@@ -1957,26 +1979,26 @@ function handleDream(args) {
     }
     // 2. Fetch pending orphaned proposals
     const candidateQuery = domainFilter
-        ? `SELECT mc.id as candidate_id, mc.target_node_id as anchor_id,
-              mc.rationale as candidate_rationale, mc.confidence,
-              mc.evidence_refs, mc.status,
-              datetime(mc.created_at, 'unixepoch') as flagged_at,
-              da.statement, da.rationale as anchor_rationale, da.domain,
-              da.evidence_refs as anchor_evidence
-       FROM memory_write_candidates mc
-       JOIN drift_anchors da ON mc.target_node_id = da.id
-       WHERE mc.scope = 'orphaned_proposal' AND mc.status = 'pending_review'
-         AND da.domain = ?
+        ? `SELECT mc.id as candidate_id, mc.target_node_id as anchor_id,
+              mc.rationale as candidate_rationale, mc.confidence,
+              mc.evidence_refs, mc.status,
+              datetime(mc.created_at, 'unixepoch') as flagged_at,
+              da.statement, da.rationale as anchor_rationale, da.domain,
+              da.evidence_refs as anchor_evidence
+       FROM memory_write_candidates mc
+       JOIN drift_anchors da ON mc.target_node_id = da.id
+       WHERE mc.scope = 'orphaned_proposal' AND mc.status = 'pending_review'
+         AND da.domain = ?
        ORDER BY mc.created_at DESC`
-        : `SELECT mc.id as candidate_id, mc.target_node_id as anchor_id,
-              mc.rationale as candidate_rationale, mc.confidence,
-              mc.evidence_refs, mc.status,
-              datetime(mc.created_at, 'unixepoch') as flagged_at,
-              da.statement, da.rationale as anchor_rationale, da.domain,
-              da.evidence_refs as anchor_evidence
-       FROM memory_write_candidates mc
-       JOIN drift_anchors da ON mc.target_node_id = da.id
-       WHERE mc.scope = 'orphaned_proposal' AND mc.status = 'pending_review'
+        : `SELECT mc.id as candidate_id, mc.target_node_id as anchor_id,
+              mc.rationale as candidate_rationale, mc.confidence,
+              mc.evidence_refs, mc.status,
+              datetime(mc.created_at, 'unixepoch') as flagged_at,
+              da.statement, da.rationale as anchor_rationale, da.domain,
+              da.evidence_refs as anchor_evidence
+       FROM memory_write_candidates mc
+       JOIN drift_anchors da ON mc.target_node_id = da.id
+       WHERE mc.scope = 'orphaned_proposal' AND mc.status = 'pending_review'
        ORDER BY mc.created_at DESC`;
     const candidates = domainFilter
         ? db.prepare(candidateQuery).all(domainFilter)
@@ -2058,12 +2080,12 @@ function handleResolveProposal(args) {
         throw new Error('verdict must be "surface" or "dismiss"');
     }
     // Verify candidate exists and is pending
-    const candidate = db.prepare(`
-    SELECT mc.id, mc.target_node_id, mc.status, mc.evidence_refs,
-           da.statement
-    FROM memory_write_candidates mc
-    JOIN drift_anchors da ON mc.target_node_id = da.id
-    WHERE mc.id = ? AND mc.scope = 'orphaned_proposal'
+    const candidate = db.prepare(`
+    SELECT mc.id, mc.target_node_id, mc.status, mc.evidence_refs,
+           da.statement
+    FROM memory_write_candidates mc
+    JOIN drift_anchors da ON mc.target_node_id = da.id
+    WHERE mc.id = ? AND mc.scope = 'orphaned_proposal'
   `).get(candidateId);
     if (!candidate) {
         throw new Error(`Candidate #${candidateId} not found or not an orphaned proposal`);
@@ -2199,7 +2221,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
                     forget: 'remember({ forget: true, memory_id: <id> })',
                     list_entities: 'recall() with no params',
                     recall_file: 'recall({ path: "<file_path>" })',
-                    consolidate: 'Auto-runs on server startup. No manual call needed.',
+                    consolidate: 'No longer a tool, and since 0.17.1 it does not run on server start either (it deletes the original rows). Opt in on the server with LINKSEE_AUTO_CONSOLIDATE=1 if you want the old weekly start-up run.',
                 };
                 if (name in migrations) {
                     throw new Error(`Tool "${name}" was merged in v0.7.0. Migration: ${migrations[name]}`);

package/dist/skill/SKILL.md

@@ -372,26 +372,19 @@ Recording `prior_belief` leaves a **belief-update history**. Later, this becomes
 2. ❌ Solve an error on the spot without recording — future you (or another agent) will hit the same failure
 3. ❌ Use `Read` everywhere instead of `read_smart` (wastes tokens)
 4. ❌ Write caveats in a flippant tone — preserve them seriously
-5. ❌ Skip `consolidate` during long-running work — run it weekly
+5. ❌ Try to call a `consolidate` tool — there is none; consolidation is a server opt-in that deletes originals (see below)
 6. ❌ Recall the same entity twice in one session without new context (wastes tokens)
 7. ❌ Write `recall({ query: "what happened last time" })` — use specific keywords
 
 ---
 
-## 🔁 Consolidate — periodic memory tidy-up
+## 🔁 Consolidation — off unless the user turns it on
 
-When memory has grown (rough guideline: DB > 20MB, memories > 15,000):
+There is no `consolidate` tool. Consolidation clusters cold, low-importance memories older than 7 days into one `learning`-layer entry and **deletes the originals**, so since 0.17.1 it never runs on its own. The user can opt in by starting the server with `LINKSEE_AUTO_CONSOLIDATE=1` (then it runs at start-up, at most weekly).
 
-```
-mcp__linksee__consolidate({
-  scope: "session",
-  min_age_days: 7
-})
-```
-
-This clusters cold, low-importance memories older than 7 days → compresses them into a single `learning`-layer entry → deletes originals.
+Do not suggest turning it on as routine housekeeping. If the user asks about a large DB, explain the trade-off (originals are deleted) and suggest backing up `~/.linksee-memory/` first.
 
-**`caveat` memories and active `goal` memories are never consolidated away.** Equivalent to sleep-time memory reorganization.
+**`caveat` memories and active `goal` memories are never consolidated away.**
 
 ---
 
@@ -525,7 +518,6 @@ User: "That's it for today"
    })
 
 3. Report: "Recorded N decisions, M caveats. Retrievable via recall."
-4. Optionally suggest: consolidate({scope:"session", min_age_days: 14})
 ```
 
 ### Case F2 — Flag orphaned proposals at session end
@@ -725,7 +717,7 @@ Now you have both bodies of knowledge before starting
 | Day 1 | low (little data) | Stop hook is still collecting |
 | Week 1 | medium | thousands of memories, FTS5 kicks in |
 | Month 1 | high | heat_score stabilizes, important memories surface |
-| Month 3+ | strongest | consolidate has run, learnings crystallized |
+| Month 3+ | strongest | learnings crystallized (distilled) |
 
 **"Gets smarter with use"** — time is on your side. Today's record is read by tomorrow's you.