linksee-memory 0.16.0 → 0.17.0

package/dist/mcp/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // linksee-memory MCP server (stdio transport).
-// Tools: remember / recall / read_smart / drift_status / check_decision / declare_anchor / resolve_drift / flag_proposals / dream / resolve_proposal
+// Tools: remember / recall / read_smart / drift_status / check_decision / declare_anchor / resolve_drift / flag_proposals / dream / resolve_proposal / share_draft
 // v0.10.0 — Re-injection layer: pre-action guard (PreToolUse/SessionStart hooks) + extraction
 //           quality gate + distillation routine (dream distill_queue) + harden/soften escalation
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
@@ -26,6 +26,7 @@ import { getReinjectionFriction, setGateMode } from '../lib/guard.js';
 import { logAnchorTouch } from '../lib/anchor-touch.js';
 import { triageDistillQueue, distillPending } from '../lib/distill-triage.js';
 import { whereAmI, listMapProjects } from '../lib/map-view.js';
+import { buildShareDraft, KINDS, RUNTIMES } from '../lib/share-draft.js';
 import { readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
@@ -62,6 +63,7 @@ const SUBCOMMANDS = {
     declare: 'declare-anchor.js',
     detect: 'detect-drift.js',
     export: 'export-report.js',
+    'share-draft': 'share-draft.js',
 };
 const subcommand = process.argv[2];
 if (subcommand && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, subcommand)) {
@@ -72,6 +74,16 @@ if (subcommand && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, subcommand))
 }
 const db = openDb();
 runMigrations(db);
+// 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.
+try {
+    const t = triageDistillQueue(db);
+    if (t.noise + t.stale > 0) {
+        process.stderr.write(`[linksee-memory] distill triage: archived ${t.noise} noise + ${t.stale} stale, ${t.remaining} remain\n`);
+    }
+}
+catch { /* never block startup */ }
 // Auto-maintenance: consolidate stale memories on startup (non-blocking)
 setTimeout(() => {
     try {
@@ -91,13 +103,6 @@ setTimeout(() => {
         if (shouldRun) {
             runConsolidate(db, { scope: 'all', min_age_days: 7 });
             process.stderr.write('[linksee-memory] auto-consolidate complete\n');
-            // Triage the distill queue by rule before any agent is asked to think about it.
-            try {
-                const t = triageDistillQueue(db);
-                if (t.noise + t.stale > 0)
-                    process.stderr.write(`[linksee-memory] distill triage: archived ${t.noise} noise + ${t.stale} stale, ${t.remaining} remain\n`);
-            }
-            catch { /* never block startup */ }
         }
     }
     catch { /* non-fatal */ }
@@ -385,6 +390,35 @@ const TOOLS = [
             required: ['candidate_id', 'verdict', 'rationale'],
         },
     },
+    // ── Share a fix (opt-in, link only) ──────────────────────
+    {
+        name: 'share_draft',
+        description: 'Make a LINK to a reviewed draft of a field note for other agents (KanseiLINK note page). ' +
+            'ONLY when the user says they want to share — never call it on your own.\n\n' +
+            'Use after a SaaS / MCP / API connection got stuck and was fixed (or was not). You write the fields; ' +
+            'this tool only checks them and builds the URL. Linksee sends nothing: the user opens the link, ' +
+            'reviews the filled form, and only their click on that page sends it.\n\n' +
+            'No values, only kinds: write "401 invalid_token", not the token. A field that looks like a key, ' +
+            'token, JWT, e-mail, tenant URL (acme.slack.com), IP, local path (C:\, /Users/, /home/) or a long ' +
+            'hex/base64 run stops the build and returns which field. The whole URL must fit in 2,000 characters ' +
+            '(a Japanese character takes 9) — if not, it asks you to shorten; it does not cut.\n\n' +
+            'Returns { url, notice } — show the user both. Linksee records only that a draft was made (no field text).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                service: { type: 'string', description: 'KanseiLINK service_id, lowercase (e.g. freee, slack, google-drive). ^[a-z0-9_.-]{1,160}$' },
+                task: { type: 'string', maxLength: 300, description: 'What you were trying to do (≤300 chars)' },
+                symptom: { type: 'string', maxLength: 600, description: 'The KIND of error that came back — no values (≤600 chars)' },
+                tried: { type: 'string', maxLength: 2000, description: 'The steps you tried (≤2,000 chars)' },
+                result: { type: 'string', maxLength: 1000, description: 'How it was solved, or that it was not (≤1,000 chars)' },
+                conditions: { type: 'string', maxLength: 600, description: 'Optional. Tool + version, kind of environment (≤600 chars)' },
+                kind: { type: 'string', enum: [...KINDS], description: 'execution = you ran it · documentation = you read it · hypothesis = untested guess' },
+                runtime: { type: 'string', enum: [...RUNTIMES], description: 'Optional. Which AI wrote this' },
+            },
+            required: ['service', 'task', 'symptom', 'tried', 'result', 'kind'],
+            additionalProperties: false,
+        },
+    },
 ];
 // ============================================================
 // Handlers
@@ -576,15 +610,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) {
@@ -598,14 +632,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) {
@@ -936,8 +970,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);
@@ -986,17 +1020,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({
@@ -1070,19 +1104,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) {
@@ -1134,29 +1168,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}%`);
@@ -1223,10 +1257,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)
@@ -1470,7 +1504,7 @@ async function handleRecallUnified(args) {
     // Folded surfaces (roadmap 5): locating yourself and the triage session are ways of
     // recalling, not separate tools.
     if (args?.dream)
-        return handleDream({ domain: args.domain });
+        return handleDream({ domain: args.domain, distill: args.distill });
     if (args?.where !== undefined && args?.where !== false) {
         return handleWhereAmI({ query: args.where === true ? undefined : String(args.where), project: args.project, limit: args.limit });
     }
@@ -1592,8 +1626,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)
@@ -1781,25 +1815,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(() => {
@@ -1843,13 +1877,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.
@@ -1867,23 +1901,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 = {};
@@ -1923,26 +1957,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)
@@ -2004,7 +2038,9 @@ function handleDream(args) {
         friction,
         friction_total: friction.length,
         distill_queue: distillQueue,
-        distill_total: distillQueue.length,
+        distill_total: distillPending(db),
+        distill_shown: distillQueue.length,
+        distill_hint: 'Ordered by value (caveats first, named entities, longer text). Pass distill: N (max 25) for a longer drain. Rules already set a distill_verdict on acknowledgements, bare paths and 90-day-old never-recalled items — you only see what needs judgement.',
         guide: guideParts.join(' '),
     });
 }
@@ -2022,12 +2058,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`);
@@ -2092,6 +2128,18 @@ const LEGACY_TOOLS = {
     dream: 'recall({ dream: true }) — recall() with no arguments already includes the counts',
     resolve_proposal: "resolve_drift({ candidate_id, action: 'surface' | 'dismiss', rationale })",
 };
+// share_draft: check fields + build the link. No network. Records only that a draft was made.
+function handleShareDraft(args) {
+    const r = buildShareDraft(args);
+    if (!r.ok)
+        return JSON.stringify(r, null, 2);
+    try {
+        // events row with no entity and no payload: the fact and the time, nothing from the fields.
+        db.prepare('INSERT INTO events (entity_id, kind, payload) VALUES (NULL, ?, NULL)').run('share_draft_created');
+    }
+    catch { /* the record must never break the tool */ }
+    return JSON.stringify(r, null, 2);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     const showLegacy = process.env.LINKSEE_LEGACY_TOOLS === '1';
     const tools = TOOLS
@@ -2141,6 +2189,10 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             case 'resolve_proposal':
                 text = handleResolveProposal(args);
                 break;
+            // Share a fix (link only)
+            case 'share_draft':
+                text = handleShareDraft(args);
+                break;
             default: {
                 const migrations = {
                     update_memory: 'remember({ memory_id: <id>, content: "...", importance: 0.8 })',