linksee-memory 0.11.5 → 0.12.1

package/dist/mcp/server.js

@@ -174,6 +174,7 @@ const TOOLS = [
                 path: { type: 'string', description: 'File path or substring. When set, returns file edit history with per-edit user-intent context instead of memory search.' },
                 max_intents: { type: 'number', description: 'For file mode: max user-intent snippets. Default 10.', default: 10 },
                 scope_to_roots: { type: 'boolean', default: false, description: 'For file mode: filter to client-provided roots.' },
+                explain: { type: 'boolean', default: false, description: 'Include ranking internals (composite, heat, band, momentum, match_reasons, score_breakdown). Off by default so more memories fit the token budget.' },
                 kind: { type: 'string', enum: ['person', 'company', 'project', 'concept', 'file', 'other'], description: 'For overview mode: filter by entity kind.' },
                 min_memories: { type: 'number', description: 'For overview mode: minimum memory count. Default 1.', default: 1 },
             },
@@ -200,6 +201,7 @@ const TOOLS = [
             properties: {
                 domain: { type: 'string', description: 'Filter by domain (strategy, product, engineering, growth, etc.)' },
                 decision_mode: { type: 'string', description: 'Filter by decision_mode (hypothesis, constraint, commitment, source_of_truth)' },
+                verbose: { type: 'boolean', default: false, description: 'Return full aligned nodes and all candidates. Default is compact: attention items in full, aligned as id+statement per domain, candidates as counts.' },
             },
         },
     },
@@ -477,15 +479,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) {
@@ -499,14 +501,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) {
@@ -767,12 +769,18 @@ function handleRecall(args) {
             content: parsedContent,
             importance: r.importance,
             pinned: r.importance >= 0.9,
-            heat: Number(r.heat_score.toFixed(1)),
-            band: r.heat_band,
-            composite: Number(r.composite_score.toFixed(3)),
-            match_reasons: r._reasons,
-            score_breakdown: r._breakdown,
+            // Ranking internals only on request — they roughly double the per-memory cost and an
+            // agent acting on the memory needs what/why/state, not the scorer's arithmetic.
+            ...(args?.explain ? {
+                heat: Number(r.heat_score.toFixed(1)),
+                band: r.heat_band,
+                composite: Number(r.composite_score.toFixed(3)),
+                match_reasons: r._reasons,
+                score_breakdown: r._breakdown,
+            } : {}),
         };
+        if (!args?.explain)
+            delete memObj.entity.momentum;
         const memTokens = estimateTokens(JSON.stringify(memObj));
         if (memoriesOut.length > 0 && accTokens + memTokens > maxTokens) {
             stoppedBy = 'tokens';
@@ -831,8 +839,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);
@@ -881,17 +889,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({
@@ -965,19 +973,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) {
@@ -1029,29 +1037,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}%`);
@@ -1118,10 +1126,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)
@@ -1287,14 +1295,35 @@ function handleDriftStatus(args) {
         by_state.held > 0 ? `⚪ ${by_state.held} held` : null,
         `🔵 ${by_state.aligned} aligned`,
     ].filter(Boolean).join(' · ');
+    if (args?.verbose) {
+        return JSON.stringify({
+            ok: true,
+            triage: `${nodes} anchors: ${triage}`,
+            nextReopen: view.nextReopen,
+            attention: view.attention,
+            alignedByDomain: view.alignedByDomain,
+            candidates: view.candidates,
+            counts: view.counts,
+        });
+    }
+    // Compact by default. The agent asked "what needs attention" — answer that in full and keep
+    // the rest to one line per node. (Full form was ~15k tokens for 43 anchors; the 2 drifting
+    // items were buried under 41 aligned ones with rationale.)
+    const aligned = view.alignedByDomain.map((g) => ({
+        domain: g.domain,
+        count: g.nodes.length,
+        nodes: g.nodes.map((n) => ({ id: n.id, statement: n.statement, reality: n.reality })),
+    }));
+    const cand = view.candidates;
     return JSON.stringify({
         ok: true,
         triage: `${nodes} anchors: ${triage}`,
         nextReopen: view.nextReopen,
         attention: view.attention,
-        alignedByDomain: view.alignedByDomain,
-        candidates: view.candidates,
+        aligned,
+        candidates: { auto: cand?.auto?.length ?? 0, suppressed: cand?.suppressed?.length ?? 0 },
         counts: view.counts,
+        hint: 'verbose:true for full aligned nodes and candidate details; check_decision(anchor_id) for one node.',
     });
 }
 // Fix ① (2026-06-17): infer the Map project from the client's workspace roots when the
@@ -1315,9 +1344,39 @@ async function resolveProjectFromRoots() {
     });
     return matches.length === 1 ? matches[0] : undefined; // unique repo match only; else ② handles it
 }
+// ①b (2026-09-05): when the client sends no roots (common — not every MCP host implements
+// roots), infer the map from the files edited most recently. The DB already knows what you
+// touched; the map slug is a path segment of those files.
+function resolveProjectFromRecentEdits() {
+    const projects = listMapProjects(db);
+    if (projects.length <= 1)
+        return { project: projects[0] };
+    const rows = db
+        .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)
+        return {};
+    const hits = new Map();
+    for (const r of rows) {
+        const segs = r.file_path.toLowerCase().replace(/\\/g, '/').split('/');
+        for (const p of projects)
+            if (segs.includes(p.toLowerCase()))
+                hits.set(p, (hits.get(p) ?? 0) + 1);
+    }
+    if (hits.size === 0)
+        return {};
+    const [best, second] = [...hits.entries()].sort((a, b) => b[1] - a[1]);
+    if (second && second[1] === best[1])
+        return {}; // tie → still ambiguous
+    return { project: best[0], from: 'recent_edits' };
+}
 async function handleWhereAmI(args) {
-    // ① resolve project from cwd/roots when not explicitly passed; ② (inside whereAmI) is the fallback.
-    const project = args?.project ?? (await resolveProjectFromRoots());
+    // ① roots; ①b recent edits; ② (inside whereAmI) is the last fallback.
+    let project = args?.project ?? (await resolveProjectFromRoots());
+    if (!project)
+        project = resolveProjectFromRecentEdits().project;
     const res = whereAmI(db, {
         query: args?.query, node_id: args?.node_id, project, limit: args?.limit,
     });
@@ -1325,7 +1384,7 @@ async function handleWhereAmI(args) {
         return JSON.stringify({
             ok: true, located: false, reason: 'ambiguous_project',
             available_projects: res.ambiguous.available,
-            hint: `Multiple maps imported — pass project: one of [${res.ambiguous.available.join(', ')}]. (No-arg can't yet tell which repo you mean; cwd/roots match is coming.)`,
+            hint: `Multiple maps imported and none matched your workspace roots or the files you edited in the last 24h — pass project: one of [${res.ambiguous.available.join(', ')}].`,
         });
     }
     if (res.matched.length === 0) {
@@ -1445,25 +1504,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(() => {
@@ -1507,13 +1566,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.
@@ -1530,15 +1589,18 @@ function handleDream(args) {
     // why-strings so the existing backlog is drainable without a backfill write.
     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)
-         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.created_at DESC LIMIT 8
+        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, '$.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.created_at DESC LIMIT 8
     `).all();
         distillQueue = rows.map((r) => {
             let c = {};
@@ -1576,26 +1638,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)
@@ -1675,12 +1737,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`);