@jungjaehoon/mama-core 2.4.0 → 4.0.0

package/dist/mama-api.js

@@ -18,102 +18,59 @@
  * @version 1.3
  * @date 2025-11-26
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listToolTracesForRun = exports.appendToolTrace = exports.getModelRunInAdapter = exports.getModelRun = exports.failModelRunInAdapter = exports.failModelRun = exports.commitModelRunInAdapter = exports.commitModelRun = exports.beginModelRunInAdapter = exports.beginModelRun = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = exports.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.createAuditFinding = exports.listOpenAuditFindings = exports.getChannelSummary = exports.upsertChannelSummary = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.ingestWithTrustedProvenance = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.saveMemoryWithTrustedProvenance = exports.saveMemory = void 0;
+exports.createAuditAck = exports.evolveMemory = void 0;
+exports.createMamaApi = createMamaApi;
 exports.save = save;
-exports.saveWithTrustedProvenance = saveWithTrustedProvenance;
 exports.suggest = suggest;
-exports.annotateTopicCurrency = annotateTopicCurrency;
+exports.saveMemory = saveMemory;
+exports.recallMemory = recallMemory;
 exports.list = listDecisions;
 exports.listCheckpoints = listCheckpoints;
 exports.updateOutcome = updateOutcome;
+exports.buildProfile = buildProfile;
+exports.ingestMemory = ingestMemory;
+exports.ingestConversation = ingestConversation;
+exports.buildMemoryBootstrap = buildMemoryBootstrap;
+exports.recordMemoryAudit = recordMemoryAudit;
+exports.upsertChannelSummary = upsertChannelSummary;
+exports.getChannelSummary = getChannelSummary;
+exports.listOpenAuditFindings = listOpenAuditFindings;
+exports.createAuditFinding = createAuditFinding;
+exports.getMemoryProvenance = getMemoryProvenance;
+exports.listMemoriesByEnvelopeHash = listMemoriesByEnvelopeHash;
+exports.listMemoriesByGatewayCallId = listMemoriesByGatewayCallId;
+exports.listMemoriesByModelRunId = listMemoriesByModelRunId;
+exports.listMemoryEventsForMemory = listMemoryEventsForMemory;
+exports.listRecentMemoryEvents = listRecentMemoryEvents;
+exports.beginModelRun = beginModelRun;
+exports.commitModelRun = commitModelRun;
+exports.failModelRun = failModelRun;
+exports.getModelRun = getModelRun;
+exports.appendToolTrace = appendToolTrace;
+exports.listToolTracesForRun = listToolTracesForRun;
+exports.listToolTraces = listToolTraces;
+exports.readToolTrace = readToolTrace;
 exports.saveCheckpoint = saveCheckpoint;
 exports.loadCheckpoint = loadCheckpoint;
 exports.recall = recall;
-exports.proposeLink = proposeLink;
-exports.approveLink = approveLink;
-exports.rejectLink = rejectLink;
-exports.getPendingLinks = getPendingLinks;
-exports.deprecateAutoLinks = deprecateAutoLinks;
-exports.calculateCoverage = calculateCoverage;
-exports.calculateQuality = calculateQuality;
-exports.generateQualityReport = generateQualityReport;
-exports.logRestartAttempt = logRestartAttempt;
-exports.calculateRestartSuccessRate = calculateRestartSuccessRate;
-exports.calculateRestartLatency = calculateRestartLatency;
-exports.getRestartMetrics = getRestartMetrics;
-exports.scanAutoLinks = scanAutoLinks;
-exports.createLinkBackup = createLinkBackup;
-exports.generatePreCleanupReport = generatePreCleanupReport;
-exports.restoreLinkBackup = restoreLinkBackup;
-exports.verifyBackupExists = verifyBackupExists;
-exports.deleteAutoLinks = deleteAutoLinks;
-exports.validateCleanupResult = validateCleanupResult;
 exports.expandWithGraph = expandWithGraph;
-// Node built-ins
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const crypto_1 = __importDefault(require("crypto"));
 // Internal modules
-const decision_tracker_js_1 = require("./decision-tracker.js");
+const api_js_1 = require("./memory/api.js");
 const db_manager_js_1 = require("./db-manager.js");
-const memory_store_js_1 = require("./memory-store.js");
-const db_manager_js_2 = require("./db-manager.js");
+const graph_query_js_1 = require("./knowledge/graph-query.js");
 const decision_formatter_js_1 = require("./decision-formatter.js");
 const progress_indicator_js_1 = require("./progress-indicator.js");
-const embeddings_js_1 = require("./embeddings.js");
-const ollama_client_js_1 = require("./ollama-client.js");
 const debug_logger_js_1 = require("./debug-logger.js");
-const api_js_1 = require("./memory/api.js");
-Object.defineProperty(exports, "saveMemory", { enumerable: true, get: function () { return api_js_1.saveMemory; } });
-Object.defineProperty(exports, "saveMemoryWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.saveMemoryWithTrustedProvenance; } });
-Object.defineProperty(exports, "recallMemory", { enumerable: true, get: function () { return api_js_1.recallMemory; } });
-Object.defineProperty(exports, "buildProfile", { enumerable: true, get: function () { return api_js_1.buildProfile; } });
-Object.defineProperty(exports, "ingestMemory", { enumerable: true, get: function () { return api_js_1.ingestMemory; } });
-Object.defineProperty(exports, "ingestWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.ingestWithTrustedProvenance; } });
-Object.defineProperty(exports, "ingestConversation", { enumerable: true, get: function () { return api_js_1.ingestConversation; } });
-Object.defineProperty(exports, "ingestConversationWithTrustedProvenance", { enumerable: true, get: function () { return api_js_1.ingestConversationWithTrustedProvenance; } });
-Object.defineProperty(exports, "evolveMemory", { enumerable: true, get: function () { return api_js_1.evolveMemory; } });
-Object.defineProperty(exports, "buildMemoryBootstrap", { enumerable: true, get: function () { return api_js_1.buildMemoryBootstrap; } });
-Object.defineProperty(exports, "createAuditAck", { enumerable: true, get: function () { return api_js_1.createAuditAck; } });
-Object.defineProperty(exports, "recordMemoryAudit", { enumerable: true, get: function () { return api_js_1.recordMemoryAudit; } });
-Object.defineProperty(exports, "upsertChannelSummary", { enumerable: true, get: function () { return api_js_1.upsertChannelSummary; } });
-Object.defineProperty(exports, "getChannelSummary", { enumerable: true, get: function () { return api_js_1.getChannelSummary; } });
+const api_js_2 = require("./memory/api.js");
+Object.defineProperty(exports, "evolveMemory", { enumerable: true, get: function () { return api_js_2.evolveMemory; } });
+Object.defineProperty(exports, "createAuditAck", { enumerable: true, get: function () { return api_js_2.createAuditAck; } });
 const finding_store_js_1 = require("./memory/finding-store.js");
-Object.defineProperty(exports, "createAuditFinding", { enumerable: true, get: function () { return finding_store_js_1.createAuditFinding; } });
-Object.defineProperty(exports, "listOpenAuditFindings", { enumerable: true, get: function () { return finding_store_js_1.listOpenAuditFindings; } });
 const event_store_js_1 = require("./memory/event-store.js");
-Object.defineProperty(exports, "listMemoryEventsForMemory", { enumerable: true, get: function () { return event_store_js_1.listMemoryEventsForMemory; } });
-Object.defineProperty(exports, "listRecentMemoryEvents", { enumerable: true, get: function () { return event_store_js_1.listRecentMemoryEvents; } });
 const provenance_query_js_1 = require("./memory/provenance-query.js");
-Object.defineProperty(exports, "getMemoryProvenance", { enumerable: true, get: function () { return provenance_query_js_1.getMemoryProvenance; } });
-Object.defineProperty(exports, "listMemoriesByEnvelopeHash", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByEnvelopeHash; } });
-Object.defineProperty(exports, "listMemoriesByGatewayCallId", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByGatewayCallId; } });
-Object.defineProperty(exports, "listMemoriesByModelRunId", { enumerable: true, get: function () { return provenance_query_js_1.listMemoriesByModelRunId; } });
-const store_js_1 = require("./model-runs/store.js");
-Object.defineProperty(exports, "beginModelRun", { enumerable: true, get: function () { return store_js_1.beginModelRun; } });
-Object.defineProperty(exports, "beginModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.beginModelRunInAdapter; } });
-Object.defineProperty(exports, "commitModelRun", { enumerable: true, get: function () { return store_js_1.commitModelRun; } });
-Object.defineProperty(exports, "commitModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.commitModelRunInAdapter; } });
-Object.defineProperty(exports, "failModelRun", { enumerable: true, get: function () { return store_js_1.failModelRun; } });
-Object.defineProperty(exports, "failModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.failModelRunInAdapter; } });
-Object.defineProperty(exports, "getModelRun", { enumerable: true, get: function () { return store_js_1.getModelRun; } });
-Object.defineProperty(exports, "getModelRunInAdapter", { enumerable: true, get: function () { return store_js_1.getModelRunInAdapter; } });
-const tool_trace_store_js_1 = require("./model-runs/tool-trace-store.js");
-Object.defineProperty(exports, "appendToolTrace", { enumerable: true, get: function () { return tool_trace_store_js_1.appendToolTrace; } });
-Object.defineProperty(exports, "listToolTracesForRun", { enumerable: true, get: function () { return tool_trace_store_js_1.listToolTracesForRun; } });
-const search_rollup_js_1 = require("./cases/search-rollup.js");
-const ranker_rescore_js_1 = require("./search/ranker-rescore.js");
-const ranker_features_js_1 = require("./search/ranker-features.js");
-const search_quality_js_1 = require("./search/search-quality.js");
-// Session-level warning cooldown cache (Story 1.1, 1.2)
+const model_run_store_js_1 = require("./runtime/model-run-store.js");
+const tool_trace_store_js_1 = require("./runtime/tool-trace-store.js");
 // Prevents spam by tracking warned topics per session
-const warnedTopicsCache = new Map();
-const WARNING_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
 /**
  * Save a decision or insight to MAMA's memory
  *
@@ -141,7 +98,7 @@ const WARNING_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
  *   outcome: 'success'
  * });
  */
-async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type = 'user_decision', outcome = 'pending', failure_reason = null, limitation = null, trust_context: _trust_context = null, is_static, scopes: inputScopes, event_date, timelineEvent, }, options) {
+async function saveInternal(adapter, { topic, decision, reasoning, confidence = 0.5, type = 'user_decision', outcome = 'pending', failure_reason = null, limitation = null, trust_context: _trust_context = null, is_static, scopes: inputScopes, item, actors, event_date, }) {
     // Validate required fields
     if (!topic || typeof topic !== 'string') {
         throw new Error('mama.save() requires topic (string)');
@@ -190,97 +147,45 @@ async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type
     // Note: Current schema uses user_involvement ('requested', 'approved', 'rejected')
     // Future: Will use decision_type column for proper distinction
     const _userInvolvement = type === 'user_decision' ? 'approved' : null;
+    const outcomeMap = {
+        pending: null,
+        success: 'SUCCESS',
+        failure: 'FAILED',
+        partial: 'PARTIAL',
+        superseded: null,
+    };
+    const dbOutcome = outcome in outcomeMap ? outcomeMap[outcome] : outcome;
+    // Reasoning text is evidence, not authority: relationships are only written
+    // when the caller names explicit targets (saveLegacyMemory's legacy field or
+    // twin-edge links). Parsing IDs out of prose fabricated edges, so it is gone.
     (0, progress_indicator_js_1.logProgress)(`Saving decision: ${topic.substring(0, 30)}...`);
-    const { id: decisionId, timeline_event_id: timelineEventId, timeline_event_ids: timelineEventIds, } = options
-        ? await (0, api_js_1.saveMemoryWithTrustedProvenance)({
-            topic,
-            kind: is_static === 1 ? 'preference' : 'decision',
-            summary: decision,
-            details: reasoning,
-            confidence,
-            scopes: Array.isArray(inputScopes) && inputScopes.length > 0 ? inputScopes : [],
-            source: {
-                package: 'mama-core',
-                source_type: 'legacy_save',
-            },
-            eventDate: event_date ?? undefined,
-            timelineEvent,
-        }, options)
-        : await (0, api_js_1.saveMemory)({
-            topic,
-            kind: is_static === 1 ? 'preference' : 'decision',
-            summary: decision,
-            details: reasoning,
-            confidence,
-            scopes: Array.isArray(inputScopes) && inputScopes.length > 0 ? inputScopes : [],
-            source: {
-                package: 'mama-core',
-                source_type: 'legacy_save',
-            },
-            eventDate: event_date ?? undefined,
-            timelineEvent,
-        });
+    const { id: decisionId } = await (0, api_js_2.saveLegacyMemory)(adapter, {
+        topic,
+        kind: is_static === 1 ? 'preference' : 'decision',
+        summary: decision,
+        details: reasoning,
+        confidence,
+        scopes: Array.isArray(inputScopes) && inputScopes.length > 0 ? inputScopes : [],
+        source: {
+            package: 'mama-core',
+            source_type: 'legacy_save',
+        },
+        eventDate: event_date ?? undefined,
+        itemId: item ?? undefined,
+        actors: actors?.map((actor) => ({ personId: actor.person, role: actor.role })),
+    }, {
+        userInvolvement: _userInvolvement,
+        outcome: dbOutcome,
+        failureReason: failure_reason ?? null,
+        limitation: limitation ?? null,
+        isStatic: is_static,
+    });
     (0, progress_indicator_js_1.logComplete)(`Decision saved: ${decisionId.substring(0, 20)}...`);
-    // Update user_involvement, outcome, failure_reason, limitation
-    // Note: learnDecision always sets 'requested', we need to override it
-    await (0, db_manager_js_2.initDB)();
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    // Build UPDATE query dynamically based on what fields are provided
-    const updates = [];
-    const values = [];
-    // user_involvement based on type
-    if (type === 'assistant_insight') {
-        updates.push('user_involvement = NULL');
-    }
-    else if (type === 'user_decision') {
-        updates.push('user_involvement = ?');
-        values.push('approved');
-    }
-    // outcome (always set, default is 'pending')
-    // Story M4.1 fix: Map to DB format (uppercase, pending → NULL)
-    if (outcome) {
-        const outcomeMap = {
-            pending: null,
-            success: 'SUCCESS',
-            failure: 'FAILED',
-            partial: 'PARTIAL',
-            superseded: null,
-        };
-        const dbOutcome = outcomeMap[outcome] !== undefined ? outcomeMap[outcome] : outcome;
-        updates.push('outcome = ?');
-        values.push(dbOutcome);
-    }
-    // failure_reason (optional)
-    if (failure_reason) {
-        updates.push('failure_reason = ?');
-        values.push(failure_reason);
-    }
-    // limitation (optional)
-    if (limitation) {
-        updates.push('limitation = ?');
-        values.push(limitation);
-    }
-    // is_static (user profile marker)
-    if (is_static !== undefined) {
-        updates.push('is_static = ?');
-        values.push(is_static);
-    }
-    // Execute UPDATE if we have any fields to update
-    if (updates.length > 0) {
-        values.push(decisionId); // WHERE id = ?
-        const stmt = adapter.prepare(`
-      UPDATE decisions
-      SET ${updates.join(', ')}
-      WHERE id = ?
-    `);
-        await stmt.run(...values);
-    }
     // ════════════════════════════════════════════════════════════════════════════
     // Story 1.1: Auto-Search on Save
     // Story 1.2: Response Enhancement
     // ════════════════════════════════════════════════════════════════════════════
     let similar_decisions = [];
-    let warning = null;
     let collaboration_hint = null;
     let reasoning_graph = null;
     // Only run auto-search for decisions (not checkpoints) with a topic
@@ -292,7 +197,7 @@ async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type
                 // NOTE: suggest() searches globally and does not yet support scoped similarity search.
                 // Cross-scope suggestions are possible here. Track as a follow-up.
                 (0, progress_indicator_js_1.logSearching)('Searching for related decisions...');
-                const searchResults = await suggest(topic, {
+                const searchResults = await (0, api_js_1.suggestInAdapter)(adapter, topic, {
                     limit: 3,
                     threshold: 0.7,
                     disableRecency: true, // Pure semantic similarity for comparison
@@ -316,12 +221,12 @@ async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type
                     if (similar_decisions.length > 0) {
                         (0, progress_indicator_js_1.logComplete)(`Found ${similar_decisions.length} related decision(s)`);
                     }
-                    // Story 1.2: Warning logic (similarity >= 0.85)
-                    const highSimilarity = similar_decisions.find((d) => (d.similarity ?? 0) >= 0.85);
-                    if (highSimilarity && !_isTopicInCooldown(topic)) {
-                        warning = `High similarity (${((highSimilarity.similarity ?? 0) * 100).toFixed(0)}%) with existing decision "${highSimilarity.decision.substring(0, 50)}..."`;
-                        _markTopicWarned(topic);
-                    }
+                    // There was a "High similarity (N%)" warning here, keyed on a number
+                    // that measured rank rather than likeness -- it fired on every save
+                    // that had a second result at all, whatever that result said. Nothing
+                    // in either retrieval path now produces a similarity for this query
+                    // shape, so the warning has no measure to stand on and is gone. The
+                    // hint below states what IS true: how many related rows came back.
                     // Story 1.2: Collaboration hint
                     if (similar_decisions.length > 0) {
                         collaboration_hint = _generateCollaborationHint(similar_decisions);
@@ -335,34 +240,20 @@ async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type
             }
             // Story 1.2: Reasoning graph info
             try {
-                reasoning_graph = await _getReasoningGraphInfo(topic, decisionId);
+                reasoning_graph = await _getReasoningGraphInfo(adapter, topic, decisionId);
             }
             catch (error) {
                 const errMsg = error instanceof Error ? error.message : String(error);
                 (0, debug_logger_js_1.error)('Reasoning graph query failed:', errMsg);
             }
         }
-        // Story 2.2: Parse reasoning for relationship edges (builds_on, debates, synthesizes)
-        if (reasoning) {
-            try {
-                await (0, decision_tracker_js_1.createEdgesFromReasoning)(decisionId, reasoning);
-            }
-            catch (error) {
-                // Best-effort - save succeeds even if edge creation fails
-                const errMsg = error instanceof Error ? error.message : String(error);
-                (0, debug_logger_js_1.error)('Edge creation from reasoning failed:', errMsg);
-            }
-        }
     }
     // Story 1.2: Enhanced response (backward compatible)
     return {
         success: true,
         id: decisionId,
         saved_decision_id: decisionId,
-        timeline_event_id: timelineEventId ?? null,
-        timeline_event_ids: timelineEventIds ?? [],
         ...(similar_decisions.length > 0 && { similar_decisions }),
-        ...(warning && { warning }),
         ...(collaboration_hint && { collaboration_hint }),
         ...(reasoning_graph && { reasoning_graph }),
     };
@@ -370,25 +261,6 @@ async function saveInternal({ topic, decision, reasoning, confidence = 0.5, type
 // ════════════════════════════════════════════════════════════════════════════
 // Story 1.2: Helper functions for Response Enhancement
 // ════════════════════════════════════════════════════════════════════════════
-/**
- * Check if a topic is in warning cooldown
- * @param {string} topic - Topic to check
- * @returns {boolean} True if topic was warned recently
- */
-function _isTopicInCooldown(topic) {
-    const lastWarned = warnedTopicsCache.get(topic);
-    if (!lastWarned) {
-        return false;
-    }
-    return Date.now() - lastWarned < WARNING_COOLDOWN_MS;
-}
-/**
- * Mark a topic as warned (start cooldown)
- * @param {string} topic - Topic to mark
- */
-function _markTopicWarned(topic) {
-    warnedTopicsCache.set(topic, Date.now());
-}
 /**
  * Generate collaboration hint message
  * @param {Array} similarDecisions - Similar decisions found
@@ -400,7 +272,7 @@ function _generateCollaborationHint(similarDecisions) {
         return null;
     }
     return `Found ${count} related decision(s). Consider:
-- SUPERSEDE: Same topic replaces prior (automatic)
+- SUPERSEDE: Add "supersedes: <id>" in reasoning to replace a specific prior decision
 - BUILD-ON: Add "builds_on: <id>" in reasoning to extend
 - DEBATE: Add "debates: <id>" in reasoning for alternative view
 - SYNTHESIZE: Add "synthesizes: [id1, id2]" in reasoning to unify`;
@@ -411,9 +283,9 @@ function _generateCollaborationHint(similarDecisions) {
  * @param {string} currentId - Current decision ID
  * @returns {Object} Reasoning graph info
  */
-async function _getReasoningGraphInfo(topic, currentId) {
+async function _getReasoningGraphInfo(adapter, topic, currentId) {
     try {
-        const chain = await (0, memory_store_js_1.queryDecisionGraph)(topic);
+        const chain = await (0, graph_query_js_1.queryDecisionGraph)(adapter, topic);
         if (!chain || chain.length === 0) {
             return {
                 topic,
@@ -435,13 +307,13 @@ async function _getReasoningGraphInfo(topic, currentId) {
         };
     }
 }
-async function recall(topic, options = {}) {
+async function recallInAdapter(adapter, topic, options = {}) {
     if (!topic || typeof topic !== 'string') {
         throw new Error('mama.recall() requires topic (string)');
     }
     const { format = 'json' } = options;
     try {
-        const decisions = await (0, memory_store_js_1.queryDecisionGraph)(topic);
+        const decisions = await (0, graph_query_js_1.queryDecisionGraph)(adapter, topic);
         if (!decisions || decisions.length === 0) {
             if (format === 'markdown') {
                 return `❌ No decisions found for topic: ${topic}`;
@@ -460,7 +332,7 @@ async function recall(topic, options = {}) {
         }
         // Query semantic edges for all decisions
         const decisionIds = decisions.map((d) => d.id);
-        const rawEdges = await (0, memory_store_js_1.querySemanticEdges)(decisionIds);
+        const rawEdges = await (0, graph_query_js_1.querySemanticEdges)(adapter, decisionIds);
         const semanticEdges = {
             refines: rawEdges.refines || [],
             refined_by: rawEdges.refined_by || [],
@@ -559,2216 +431,158 @@ async function recall(topic, options = {}) {
         throw new Error(`mama.recall() failed: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
-async function updateOutcome(decisionId, { outcome, failure_reason, limitation }) {
-    if (!decisionId || typeof decisionId !== 'string') {
-        throw new Error('mama.updateOutcome() requires decisionId (string)');
-    }
-    // AX Improvement: Be forgiving with case sensitivity
-    const normalizedOutcome = outcome ? outcome.toUpperCase() : null;
-    if (!normalizedOutcome || !['SUCCESS', 'FAILED', 'PARTIAL'].includes(normalizedOutcome)) {
-        throw new Error('mama.updateOutcome() outcome must be "SUCCESS", "FAILED", or "PARTIAL"');
-    }
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        // Update outcome and related fields
-        const stmt = adapter.prepare(`
-      UPDATE decisions
-      SET
-        outcome = ?,
-        failure_reason = ?,
-        limitation = ?,
-        updated_at = ?
-      WHERE id = ?
-    `);
-        const result = stmt.run(normalizedOutcome, failure_reason || null, limitation || null, Date.now(), decisionId);
-        // Check if decision was found and updated
-        if (result.changes === 0) {
-            throw new Error(`Decision not found: ${decisionId}`);
-        }
-        return;
-    }
-    catch (error) {
-        throw new Error(`mama.updateOutcome() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-async function expandWithGraph(candidates) {
-    const graphEnhanced = new Map(); // Use Map for deduplication by ID
-    const primaryIds = new Set(candidates.map((c) => c.id)); // Track primary candidates
-    // Process each candidate
-    for (const candidate of candidates) {
-        // Add primary candidate with higher rank
-        if (!graphEnhanced.has(candidate.id)) {
-            graphEnhanced.set(candidate.id, {
-                ...candidate,
-                graph_source: 'primary', // Mark as primary result
-                graph_rank: 1.0, // Highest rank
-            });
-        }
-        // 1. Add supersedes chain (evolution history)
-        try {
-            const chain = await (0, memory_store_js_1.queryDecisionGraph)(candidate.topic);
-            for (const decision of chain) {
-                if (!graphEnhanced.has(decision.id)) {
-                    graphEnhanced.set(decision.id, {
-                        ...decision,
-                        graph_source: 'supersedes_chain',
-                        graph_rank: 0.8, // Lower rank than primary
-                        similarity: (candidate.similarity ?? 0) * 0.9, // Inherit similarity, slightly reduced
-                        related_to: candidate.id, // Track relationship
-                    });
-                }
-            }
-        }
-        catch (error) {
-            (0, debug_logger_js_1.warn)(`Failed to get supersedes chain for ${candidate.topic}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        // 2. Add semantic edges (refines, contradicts, builds_on, debates, synthesizes)
-        try {
-            const rawEdges = (await (0, memory_store_js_1.querySemanticEdges)([candidate.id])) || {};
-            const edges = {
-                refines: rawEdges.refines || [],
-                refined_by: rawEdges.refined_by || [],
-                contradicts: rawEdges.contradicts || [],
-                contradicted_by: rawEdges.contradicted_by || [],
-                builds_on: rawEdges.builds_on || [],
-                built_on_by: rawEdges.built_on_by || [],
-                debates: rawEdges.debates || [],
-                debated_by: rawEdges.debated_by || [],
-                synthesizes: rawEdges.synthesizes || [],
-                synthesized_by: rawEdges.synthesized_by || [],
-            };
-            // Helper to add edge to graph
-            const addEdge = (edge, idField, source, rank, simFactor) => {
-                const id = edge[idField];
-                if (!graphEnhanced.has(id)) {
-                    graphEnhanced.set(id, {
-                        id: id,
-                        topic: edge.topic,
-                        decision: edge.decision,
-                        confidence: edge.confidence,
-                        created_at: edge.created_at,
-                        graph_source: source,
-                        graph_rank: rank,
-                        similarity: (candidate.similarity ?? 0) * simFactor,
-                        related_to: candidate.id,
-                        edge_reason: edge.reason,
-                    });
-                }
-            };
-            // Add refines edges
-            for (const edge of edges.refines) {
-                addEdge(edge, 'to_id', 'refines', 0.7, 0.85);
-            }
-            // Add refined_by edges
-            for (const edge of edges.refined_by) {
-                addEdge(edge, 'from_id', 'refined_by', 0.7, 0.85);
-            }
-            // Add contradicts edges (lower rank, but still relevant)
-            for (const edge of edges.contradicts) {
-                addEdge(edge, 'to_id', 'contradicts', 0.6, 0.8);
-            }
-            // Story 2.1: Add builds_on edges (high relevance - extending prior work)
-            for (const edge of edges.builds_on) {
-                addEdge(edge, 'to_id', 'builds_on', 0.75, 0.9);
-            }
-            // Add built_on_by edges (someone built on this decision)
-            for (const edge of edges.built_on_by) {
-                addEdge(edge, 'from_id', 'built_on_by', 0.75, 0.9);
-            }
-            // Add debates edges (alternative view)
-            for (const edge of edges.debates) {
-                addEdge(edge, 'to_id', 'debates', 0.65, 0.85);
-            }
-            // Add debated_by edges
-            for (const edge of edges.debated_by) {
-                addEdge(edge, 'from_id', 'debated_by', 0.65, 0.85);
-            }
-            // Add synthesizes edges (unified approach)
-            for (const edge of edges.synthesizes) {
-                addEdge(edge, 'to_id', 'synthesizes', 0.7, 0.88);
-            }
-            // Add synthesized_by edges
-            for (const edge of edges.synthesized_by) {
-                addEdge(edge, 'from_id', 'synthesized_by', 0.7, 0.88);
-            }
-        }
-        catch (error) {
-            (0, debug_logger_js_1.warn)(`Failed to get semantic edges for ${candidate.id}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    // 3. Convert Map to Array
-    const allResults = Array.from(graphEnhanced.values());
-    // 4. Sort: Interleave expanded results after their related primary
-    // This ensures edge-connected decisions appear near their source
-    const primaryResults = allResults
-        .filter((r) => primaryIds.has(r.id))
-        .sort((a, b) => {
-        const scoreA = a.final_score || a.similarity || 0;
-        const scoreB = b.final_score || b.similarity || 0;
-        return scoreB - scoreA;
-    });
-    const expandedResults = allResults.filter((r) => !primaryIds.has(r.id));
-    // Build final results: each primary followed by its related expanded results
-    const results = [];
-    for (const primary of primaryResults) {
-        results.push(primary);
-        // Find expanded results related to this primary
-        const relatedExpanded = expandedResults.filter((e) => e.related_to === primary.id);
-        // Sort related by graph_rank (higher first)
-        relatedExpanded.sort((a, b) => (b.graph_rank || 0) - (a.graph_rank || 0));
-        // Add related expanded results right after their primary
-        results.push(...relatedExpanded);
-    }
-    // Add any orphaned expanded results (shouldn't happen, but safety net)
-    const includedIds = new Set(results.map((r) => r.id));
-    const orphaned = expandedResults.filter((e) => !includedIds.has(e.id));
-    results.push(...orphaned);
-    return results;
-}
-function applyRecencyBoost(results, options = {}) {
-    const { recencyWeight = 0.3, recencyScale = 7, recencyDecay = 0.5, disableRecency = false, } = options;
-    if (disableRecency || recencyWeight === 0) {
-        return results;
-    }
-    const now = Date.now(); // Current timestamp in milliseconds
-    return results
-        .map((r) => {
-        // created_at is stored in milliseconds in the database
-        const createdAt = typeof r.created_at === 'number' ? r.created_at : Date.parse(r.created_at || '0');
-        const ageInDays = (now - createdAt) / (86400 * 1000);
-        // Gaussian Decay: exp(-((age / scale)^2) / (2 * ln(1 / decay)))
-        // At scale days: score = decay (e.g., 7 days = 50%)
-        const gaussianDecay = Math.exp(-Math.pow(ageInDays / recencyScale, 2) / (2 * Math.log(1 / recencyDecay)));
-        // Combine semantic similarity with recency
-        const similarity = r.similarity ?? 0;
-        const finalScore = similarity * (1 - recencyWeight) + gaussianDecay * recencyWeight;
-        return {
-            ...r,
-            recency_score: gaussianDecay,
-            recency_age_days: Math.round(ageInDays * 10) / 10,
-            final_score: finalScore,
-        };
-    })
-        .sort((a, b) => (b.final_score ?? 0) - (a.final_score ?? 0));
-}
-/** Phase 3 Task 33: learned-ranker meta attached to mama.suggest response. */
-function buildRankerMeta(applied, modelId, skippedReason) {
-    const meta = {
-        model_id: modelId,
-        feature_set_version: ranker_features_js_1.SEARCH_RANKER_FEATURE_SET_VERSION,
-        applied,
-        mode: 'offline',
-    };
-    if (skippedReason) {
-        meta.skipped_reason = skippedReason;
-    }
-    return meta;
-}
-function resultRecord(result) {
-    if (typeof result.record === 'object' &&
-        result.record !== null &&
-        !Array.isArray(result.record)) {
-        return result.record;
-    }
-    return {};
-}
-function stringOrNull(value) {
-    if (value === null || value === undefined) {
-        return null;
-    }
-    return String(value);
-}
-function numberOrNull(value) {
-    if (typeof value !== 'number' || !Number.isFinite(value)) {
-        return null;
-    }
-    return value;
-}
-function confidenceValue(record, fallback) {
-    const numeric = numberOrNull(record.confidence);
-    if (numeric !== null) {
-        return numeric;
-    }
-    switch (record.confidence) {
-        case 'high':
-            return 0.9;
-        case 'medium':
-            return 0.6;
-        case 'low':
-            return 0.3;
-        default:
-            return fallback;
-    }
-}
-function mapRolledUpResult(result) {
-    const record = resultRecord(result);
-    const retrievalDiagnostics = result.retrieval_diagnostics;
-    const topic = stringOrNull(record.topic ?? record.title) ?? result.source_id;
-    // For wiki_page leaves, prefer the markdown body (`content`) in `decision` so
-    // downstream consumers see the meaningful body rather than the short title.
-    // Decision/checkpoint records use their own fields (summary/decision).
-    const isWikiPageLeaf = result.source_type === 'wiki_page';
-    const decision = isWikiPageLeaf
-        ? (stringOrNull(record.content ?? record.summary ?? record.decision ?? record.title) ??
-            result.source_id)
-        : (stringOrNull(record.summary ?? record.decision ?? record.title ?? record.content) ??
-            result.source_id);
-    const reasoning = stringOrNull(record.details ?? record.reasoning ?? record.status_reason ?? record.content) ??
-        '';
-    return {
-        id: result.source_id,
-        topic,
-        decision,
-        reasoning,
-        confidence: confidenceValue(record, result.score),
-        // Back-compat with pre-rollup consumers (swarm-mama-adapter tests,
-        // older callers): similarity mirrors the retrieval score when we don't
-        // have a separate similarity measure. retrieval_score remains the
-        // authoritative field for Phase 3 code paths.
-        similarity: result.score,
-        retrieval_score: result.score,
-        created_at: record.created_at ?? null,
-        event_date: record.event_date ?? null,
-        event_datetime: record.event_datetime ?? null,
-        graph_source: retrievalDiagnostics?.graph_source ?? 'primary',
-        graph_rank: 1,
-        related_to: null,
-        edge_reason: null,
-        case_id: result.case_id,
-        source_type: result.source_type,
-        contributing_leaves: result.contributing_leaves ?? null,
-        ...(result.contributing_leaf_diagnostics
-            ? { contributing_leaf_diagnostics: result.contributing_leaf_diagnostics }
-            : {}),
-        ...(retrievalDiagnostics ? { retrieval_diagnostics: retrievalDiagnostics } : {}),
-    };
-}
 async function save(params) {
-    return saveInternal(params);
+    await (0, db_manager_js_1.initDB)();
+    return saveInternal((0, db_manager_js_1.getAdapter)(), params);
 }
-async function saveWithTrustedProvenance(params, options) {
-    return saveInternal(params, options);
+// Facade boundary: the ambient handle is resolved only here so the public
+// (input)-only signatures stay intact. Instance-owning callers use
+// createMamaApi(adapter) instead.
+async function suggest(userQuestion, options = {}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.suggestInAdapter)((0, db_manager_js_1.getAdapter)(), userQuestion, options);
 }
-/**
- * Annotate suggest results with topic currency. MAMA semantics treat topic
- * reuse as supersession, so a result row is stale when the DB holds a newer
- * decision row for the same topic - even when its status column still says
- * 'active' (historical chains predate status maintenance). Surfacing
- * `superseded_by_newer` lets consumers (and LLMs) tell current truth from
- * superseded history; delta-bench measured 80% -> 92.5% answer accuracy when
- * the current row is explicitly marked.
- */
-function annotateTopicCurrency(rows, scopes) {
-    try {
-        const topics = [
-            ...new Set(rows.map((r) => r.topic).filter((t) => typeof t === 'string' && t.length > 0)),
-        ];
-        if (topics.length === 0) {
-            return rows;
-        }
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        const placeholders = topics.map(() => '?').join(',');
-        // Supersession is scope-isolated (mirrors the save-path same-topic lookup):
-        // a newer row for the same topic in ANOTHER project/channel must not mark
-        // this scope's current truth as stale. When the search ran scoped, the
-        // currency comparison is restricted to the same scopes. Rows with an
-        // excluded status (quarantined etc.) never count as "the newer truth".
-        const statusFilter = "AND (d.status IS NULL OR d.status NOT IN ('superseded','quarantined','contradicted','stale'))";
-        let all;
-        if (scopes && scopes.length > 0) {
-            const scopePairs = scopes.flatMap((s) => [s.kind, s.id]);
-            const scopePlaceholders = scopes
-                .map(() => '(ms.kind = ? AND ms.external_id = ?)')
-                .join(' OR ');
-            all = adapter
-                .prepare(`SELECT DISTINCT d.id, d.topic, d.created_at
-           FROM decisions d
-           JOIN memory_scope_bindings msb ON msb.memory_id = d.id
-           JOIN memory_scopes ms ON ms.id = msb.scope_id
-           WHERE d.topic IN (${placeholders}) AND (${scopePlaceholders}) ${statusFilter}`)
-                .all(...topics, ...scopePairs);
-        }
-        else {
-            all = adapter
-                .prepare(`SELECT id, topic, created_at FROM decisions d WHERE topic IN (${placeholders}) ${statusFilter}`)
-                .all(...topics);
-        }
-        // created_at mixes epoch seconds, epoch ms, and TEXT datetimes in live DBs.
-        const toMs = (v) => {
-            if (typeof v === 'number' && Number.isFinite(v)) {
-                return v > 1e12 ? v : v * 1000;
-            }
-            if (typeof v === 'string') {
-                const trimmed = v.trim();
-                if (/^\d+$/.test(trimmed)) {
-                    return toMs(Number(trimmed));
-                }
-                // Stamp UTC only when the text carries no timezone marker: appending
-                // 'Z' to a value that already ends in 'Z' or an offset yields NaN, and
-                // a bare T-form datetime would otherwise parse as ambiguous local time.
-                const formatted = trimmed.includes('T') ? trimmed : trimmed.replace(' ', 'T');
-                const hasTz = formatted.endsWith('Z') || /[+-]\d{2}:?\d{2}$/.test(formatted);
-                const parsed = Date.parse(hasTz ? formatted : formatted + 'Z');
-                // Unparseable rows are skipped per-row by the caller (NaN), never
-                // thrown: one legacy bad timestamp must not blank the whole annotation.
-                return Number.isFinite(parsed) ? parsed : NaN;
-            }
-            return NaN;
-        };
-        const newestByTopic = new Map();
-        for (const row of all) {
-            const ms = toMs(row.created_at);
-            if (!Number.isFinite(ms)) {
-                continue;
-            }
-            const cur = newestByTopic.get(row.topic);
-            // Deterministic tiebreak on equal timestamps: higher id wins (ids embed
-            // their creation ms, so lexicographic order is stable and monotonic-ish).
-            if (!cur || ms > cur.ms || (ms === cur.ms && row.id > cur.id)) {
-                newestByTopic.set(row.topic, { ms, id: row.id });
-            }
-        }
-        return rows.map((r) => {
-            const newest = typeof r.topic === 'string' ? newestByTopic.get(r.topic) : undefined;
-            if (!newest) {
-                return r;
-            }
-            return { ...r, superseded_by_newer: newest.id !== r.id };
-        });
-    }
-    catch (err) {
-        // Annotation is additive - a failure must degrade to unannotated results,
-        // never break the search itself. But it is logged loudly, not swallowed.
-        (0, debug_logger_js_1.warn)(`[mama.suggest] topic-currency annotation failed: ${String(err)}`);
-        return rows;
-    }
+async function recall(topic, options = {}) {
+    await (0, db_manager_js_1.initDB)();
+    return recallInAdapter((0, db_manager_js_1.getAdapter)(), topic, options);
 }
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-async function suggest(userQuestion, options = {}) {
-    if (!userQuestion || typeof userQuestion !== 'string') {
-        throw new Error('mama.suggest() requires userQuestion (string)');
-    }
-    const { format = 'json', limit = 5, threshold, useReranking = false, rerankWithLearned = false, 
-    // Recency boosting parameters (Gaussian Decay - Elasticsearch style)
-    recencyWeight = 0.3, // 0-1: How much to weight recency (0.3 = 70% semantic, 30% recency)
-    recencyScale = 7, // Days until recency score drops to 50%
-    recencyDecay = 0.5, // Score at scale point (0.5 = 50%)
-    disableRecency = false, // Set true to disable recency boosting entirely
-    strict, strictness, includeRelated, minLexicalSupport, diagnostics: includeDiagnostics, } = options;
-    const normalizedSearchOptions = (0, search_quality_js_1.normalizeSearchQualityOptions)({
-        threshold,
-        strict,
-        strictness,
-        disableRecency,
-        includeRelated,
-        topicPrefix: options.topicPrefix,
-        minLexicalSupport,
-        diagnostics: includeDiagnostics,
-    });
-    const memoryV2QualityContractRequested = threshold !== undefined ||
-        strict !== undefined ||
-        strictness !== undefined ||
-        includeRelated !== undefined ||
-        minLexicalSupport !== undefined ||
-        includeDiagnostics === true ||
-        options.topicPrefix !== undefined ||
-        options.scopes !== undefined;
-    const rerankPoolLimit = rerankWithLearned ? Math.max(limit * 4, limit + 5) : limit;
-    try {
-        const bundle = await (0, api_js_1.recallMemory)(userQuestion, {
-            includeProfile: false,
-            topicPrefix: options.topicPrefix,
-            limit: rerankPoolLimit,
-            threshold,
-            strict,
-            strictness,
-            disableRecency,
-            includeRelated,
-            minLexicalSupport,
-            diagnostics: includeDiagnostics,
-            ...(options.scopes && { scopes: options.scopes }),
-        });
-        const diagnosticsByMemoryId = new Map(bundle.memories
-            .filter((memory) => memory.retrieval_diagnostics)
-            .map((memory) => [memory.id, memory.retrieval_diagnostics]));
-        const rawFusedHits = bundle.fused_hits ?? [];
-        const fusedHits = rawFusedHits.map((hit) => {
-            if (hit.source_type !== 'decision') {
-                return hit;
-            }
-            const recordDiagnostics = typeof hit.record === 'object' && hit.record !== null && !Array.isArray(hit.record)
-                ? hit.record.retrieval_diagnostics
-                : undefined;
-            const retrievalDiagnostics = diagnosticsByMemoryId.get(hit.source_id) ?? recordDiagnostics;
-            if (!retrievalDiagnostics) {
-                return hit;
-            }
-            const record = typeof hit.record === 'object' && hit.record !== null && !Array.isArray(hit.record)
-                ? { ...hit.record, retrieval_diagnostics: retrievalDiagnostics }
-                : hit.record;
-            return {
-                ...hit,
-                record,
-                retrieval_diagnostics: retrievalDiagnostics,
-            };
-        });
-        const rolledUp = fusedHits.length > 0 ? (0, search_rollup_js_1.rollUpSearchHits)({ fusedHits, adapter: (0, memory_store_js_1.getAdapter)() }) : [];
-        const diagnosticsResponse = includeDiagnostics === true ? { diagnostics: bundle.search_meta.diagnostics ?? null } : {};
-        // Phase 3 Task 33: compute base ranker meta once so every return path
-        // (rolledUp, memories fallback, vector-search fallback) can attach it.
-        // rerankWithLearned-driven rescoring still only applies to result arrays
-        // that match the ranker's expected shape (id + source_type + case_id).
-        const baseRankerMeta = useReranking
-            ? buildRankerMeta(false, null, 'llm_reranking_requested')
-            : rerankWithLearned
-                ? null // marker: rescoring requested, actual meta set per-path after rescore
-                : buildRankerMeta(false, null, 'feature_disabled');
-        const applyLearnedRanker = (results) => {
-            if (baseRankerMeta !== null) {
-                return { results, meta: baseRankerMeta };
-            }
-            // Phase 3 Task 33: the caller opted in via rerankWithLearned, but the
-            // runtime `search_ranker_enabled` gate still has final say. This lets
-            // operators disable the learned ranker globally during rollback without
-            // touching any caller code.
-            let runtimeEnabled = true;
-            try {
-                runtimeEnabled = (0, ranker_rescore_js_1.isSearchRankerEnabled)((0, memory_store_js_1.getAdapter)());
-            }
-            catch (err) {
-                (0, debug_logger_js_1.warn)(`[mama.suggest] isSearchRankerEnabled check failed: ${String(err)}`);
-            }
-            if (!runtimeEnabled) {
-                return { results, meta: buildRankerMeta(false, null, 'feature_disabled') };
-            }
-            try {
-                const rescored = (0, ranker_rescore_js_1.rescoreSearchResults)((0, memory_store_js_1.getAdapter)(), {
-                    query: userQuestion,
-                    results,
-                });
-                return {
-                    results: rescored.results,
-                    meta: buildRankerMeta(rescored.skipped_reason === undefined, rescored.model_id, rescored.skipped_reason),
-                };
-            }
-            catch (err) {
-                (0, debug_logger_js_1.warn)(`[mama.suggest] learned-ranker rescore failed: ${String(err)}`);
-                return { results, meta: buildRankerMeta(false, null, 'rescore_error') };
-            }
-        };
-        const summarizeGraphExpansion = (rows) => {
-            const sources = {
-                primary: 0,
-                supersedes_chain: 0,
-                refines: 0,
-                refined_by: 0,
-                contradicts: 0,
-            };
-            let expandedCount = 0;
-            for (const row of rows) {
-                const graphSource = row.graph_source ?? 'primary';
-                if (graphSource === 'primary') {
-                    sources.primary += 1;
-                    continue;
-                }
-                expandedCount += 1;
-                if (graphSource in sources) {
-                    const key = graphSource;
-                    sources[key] += 1;
-                }
-            }
-            return {
-                total_results: rows.length,
-                primary_count: sources.primary,
-                expanded_count: expandedCount,
-                sources,
-            };
-        };
-        if (rolledUp.length > 0) {
-            const filteredResults = rolledUp.slice(0, rerankPoolLimit);
-            const { results: mappedResults, meta: rankerMeta } = applyLearnedRanker(filteredResults.map(mapRolledUpResult));
-            const limitedResults = mappedResults.slice(0, limit);
-            if (format === 'markdown') {
-                const context = limitedResults
-                    .map((result, index) => `${index + 1}. [${result.topic}] ${result.decision}\n   ${result.reasoning}`)
-                    .join('\n');
-                return `🔍 Search method: memory_v2\n${context}`;
-            }
-            return {
-                query: userQuestion,
-                results: annotateTopicCurrency(limitedResults, options.scopes),
-                ...diagnosticsResponse,
-                meta: {
-                    count: limitedResults.length,
-                    search_method: 'memory_v2',
-                    threshold: normalizedSearchOptions.threshold,
-                    recency_boost: disableRecency
-                        ? null
-                        : {
-                            weight: recencyWeight,
-                            scale: recencyScale,
-                            decay: recencyDecay,
-                        },
-                    graph_expansion: summarizeGraphExpansion(limitedResults),
-                    ranker: rankerMeta,
-                },
-            };
-        }
-        if (bundle.memories.length > 0) {
-            // recallMemory uses RRF fusion — confidence is overwritten with the normalized
-            // retrieval score (0-1 range, where 1.0 = best match in this result set).
-            // The original stored confidence is lost after RRF normalization.
-            // We capture the retrieval score separately so `similarity` reflects search
-            // relevance while `confidence` is passed through as-is from the bundle.
-            const filteredMemories = bundle.memories.slice(0, rerankPoolLimit);
-            const baseRows = filteredMemories.map((memory) => ({
-                id: memory.id,
-                topic: memory.topic,
-                decision: memory.summary,
-                reasoning: memory.details,
-                confidence: memory.confidence,
-                // recallMemory currently normalizes fused retrieval rank into `confidence`.
-                // Keep that value visible as retrieval_score, but do not pretend it is
-                // semantic similarity; save-time warning logic keys off `similarity`.
-                similarity: null,
-                retrieval_score: memory.confidence ?? null,
-                final_score: memory.confidence ?? null,
-                created_at: memory.created_at,
-                event_date: memory.event_date ?? null,
-                event_datetime: memory.event_datetime ?? null,
-                graph_source: memory.retrieval_diagnostics?.graph_source ?? 'primary',
-                graph_rank: 1,
-                related_to: null,
-                edge_reason: null,
-                case_id: null,
-                source_type: memory.kind ??
-                    memory.source?.source_type ??
-                    memory.source_type ??
-                    memory.type ??
-                    'decision',
-                ...(memory.retrieval_diagnostics
-                    ? { retrieval_diagnostics: memory.retrieval_diagnostics }
-                    : {}),
-            }));
-            const { results: rankedRows, meta: rankerMeta } = applyLearnedRanker(baseRows);
-            const limitedRows = rankedRows.slice(0, limit);
-            if (format === 'markdown') {
-                const context = limitedRows
-                    .map((row, index) => `${index + 1}. [${row.topic}] ${row.decision}\n   ${row.reasoning}`)
-                    .join('\n');
-                return `🔍 Search method: memory_v2\n${context}`;
-            }
-            return {
-                query: userQuestion,
-                results: annotateTopicCurrency(limitedRows, options.scopes),
-                ...diagnosticsResponse,
-                meta: {
-                    count: limitedRows.length,
-                    search_method: 'memory_v2',
-                    threshold: normalizedSearchOptions.threshold,
-                    recency_boost: disableRecency
-                        ? null
-                        : {
-                            weight: recencyWeight,
-                            scale: recencyScale,
-                            decay: recencyDecay,
-                        },
-                    graph_expansion: summarizeGraphExpansion(limitedRows),
-                    ranker: rankerMeta,
-                },
-            };
-        }
-        if (memoryV2QualityContractRequested) {
-            const emptyRows = [];
-            const { meta: rankerMeta } = applyLearnedRanker(emptyRows);
-            if (format === 'markdown') {
-                return '🔍 Search method: memory_v2\n';
-            }
-            return {
-                query: userQuestion,
-                results: emptyRows,
-                ...diagnosticsResponse,
-                meta: {
-                    count: 0,
-                    search_method: 'memory_v2',
-                    threshold: normalizedSearchOptions.threshold,
-                    recency_boost: disableRecency
-                        ? null
-                        : {
-                            weight: recencyWeight,
-                            scale: recencyScale,
-                            decay: recencyDecay,
-                        },
-                    graph_expansion: summarizeGraphExpansion(emptyRows),
-                    ranker: rankerMeta,
-                },
-            };
-        }
-        // 1. Try vector search first (if sqlite-vss is available)
-        // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-explicit-any
-        let results = [];
-        let searchMethod = 'vector';
-        try {
-            // Check if vector search is available
-            if (!(0, memory_store_js_1.getAdapter)().vectorSearchEnabled) {
-                throw new Error('Vector search not available');
-            }
-            // Generate query embedding
-            const queryEmbedding = await (0, embeddings_js_1.generateEmbedding)(userQuestion, 'query');
-            // Adaptive threshold (shorter queries need higher confidence)
-            const wordCount = userQuestion.split(/\s+/).length;
-            const adaptiveThreshold = threshold !== undefined ? threshold : wordCount < 3 ? 0.7 : 0.6;
-            // Vector search
-            results = await (0, memory_store_js_1.vectorSearch)(queryEmbedding, rerankPoolLimit * 2, 0.5); // Get more candidates
-            // Filter by adaptive threshold
-            results = results.filter((r) => r.similarity >= adaptiveThreshold);
-            // Stage 1.4: Temporal boost — detect time-related queries and boost matching results
-            {
-                const temporalPatterns = [
-                    // English
-                    /\b(yesterday|today|last\s+(?:week|month|year)|(\d+)\s+(?:days?|weeks?|months?)\s+ago)\b/i,
-                    /\b(before|after|since|until|during)\s+\w+/i,
-                    /\b(how\s+long|when\s+did|what\s+date|what\s+day)\b/i,
-                    // Korean
-                    /(?:어제|오늘|그제|지난\s*(?:주|달|해)|(\d+)\s*(?:일|주|달|개월)\s*(?:전|후|뒤))/,
-                    /(?:언제|얼마나|며칠|몇\s*(?:일|주|달|개월))/,
-                ];
-                const isTemporalQuery = temporalPatterns.some((p) => p.test(userQuestion));
-                if (isTemporalQuery && results.length > 0) {
-                    // Boost results that contain date/time references in their content
-                    const datePatterns = [
-                        /\d{4}[-/]\d{1,2}[-/]\d{1,2}/,
-                        /(?:jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\w*\s+\d/i,
-                        /\d+\s*(?:일|월|년|주|시간|분)/,
-                        /(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday)/i,
-                        /(?:월요일|화요일|수요일|목요일|금요일|토요일|일요일)/,
-                    ];
-                    for (const result of results) {
-                        const content = `${result.decision || ''} ${result.reasoning || ''}`;
-                        const hasDateRef = datePatterns.some((p) => p.test(content));
-                        if (hasDateRef) {
-                            result.similarity = Math.min(1.0, (result.similarity || 0) + 0.1);
-                        }
-                    }
-                    results.sort((a, b) => (b.similarity || 0) - (a.similarity || 0));
-                }
-            }
-            // Stage 1.5: Apply recency boosting (Gaussian Decay)
-            // Allows Claude to adjust search strategy (recent vs historical)
-            if (results.length > 0 && !disableRecency) {
-                results = applyRecencyBoost(results, {
-                    recencyWeight,
-                    recencyScale,
-                    recencyDecay,
-                    disableRecency,
-                });
-                searchMethod = 'vector+recency';
-            }
-            // Stage 1.7: FTS5 hybrid merge (Haiku Memory Layer)
-            {
-                try {
-                    const ftsResults = await (0, db_manager_js_1.fts5Search)(userQuestion, rerankPoolLimit * 2);
-                    if (ftsResults.length > 0) {
-                        // Normalize FTS5 ranks (BM25 returns negative values, closer to 0 = better)
-                        const maxRank = Math.max(...ftsResults.map((r) => Math.abs(r.rank)));
-                        const ftsMap = new Map(ftsResults.map((r) => [r.id, maxRank > 0 ? 1 - Math.abs(r.rank) / maxRank : 0.5]));
-                        // Tunable hybrid weights (env: MAMA_VECTOR_WEIGHT, MAMA_FTS5_WEIGHT)
-                        const vectorWeight = parseFloat(process.env.MAMA_VECTOR_WEIGHT || '0.6');
-                        const fts5Weight = parseFloat(process.env.MAMA_FTS5_WEIGHT || '0.4');
-                        // Merge: boost existing results that also matched FTS5
-                        for (const result of results) {
-                            const ftsScore = ftsMap.get(result.id);
-                            if (ftsScore !== undefined) {
-                                result.similarity = vectorWeight * result.similarity + fts5Weight * ftsScore;
-                                ftsMap.delete(result.id);
-                            }
-                        }
-                        // Add FTS5-only results (not in embedding results)
-                        for (const [id, ftsScore] of ftsMap) {
-                            const ftsResult = ftsResults.find((r) => r.id === id);
-                            if (ftsResult) {
-                                // Need to get full decision record
-                                const adapter = (0, memory_store_js_1.getAdapter)();
-                                const stmt = adapter.prepare('SELECT * FROM decisions WHERE id = ? AND superseded_by IS NULL');
-                                const decision = stmt.get(id);
-                                if (decision) {
-                                    results.push({
-                                        ...decision,
-                                        similarity: fts5Weight * ftsScore, // Only FTS5 score component
-                                        graph_source: 'fts5',
-                                    });
-                                }
-                            }
-                        }
-                        // Re-sort by similarity
-                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        results.sort((a, b) => (b.similarity || 0) - (a.similarity || 0));
-                        searchMethod = disableRecency ? 'vector+fts5' : 'vector+recency+fts5';
-                    }
-                }
-                catch {
-                    // FTS5 not available, continue with embedding-only results
-                }
-            }
-            // Stage 2: Graph expansion (NEW - Phase 1)
-            // Expand candidates with supersedes chain and semantic edges
-            if (results.length > 0) {
-                const graphEnhanced = await expandWithGraph(results);
-                results = graphEnhanced;
-                searchMethod = disableRecency ? 'vector+graph' : 'vector+recency+graph';
-            }
-            // Stage 2.5: is_static boost (after graph expansion to preserve sort order)
-            for (const result of results) {
-                if (result.is_static === 1) {
-                    result.final_score = Math.min(1.0, (result.final_score ?? result.similarity ?? 0) + 0.2);
-                }
-            }
-            // Re-sort by final_score after is_static boost
-            results.sort((a, b) => (b.final_score ?? b.similarity ?? 0) - (a.final_score ?? a.similarity ?? 0));
-        }
-        catch (vectorError) {
-            // Fallback to keyword search if vector search unavailable
-            (0, debug_logger_js_1.warn)(`Vector search failed: ${vectorError instanceof Error ? vectorError.message : String(vectorError)}, falling back to keyword search`);
-            searchMethod = 'keyword';
-            // Keyword search fallback
-            const adapter = (0, memory_store_js_1.getAdapter)();
-            const keywords = userQuestion
-                .toLowerCase()
-                .split(/\s+/)
-                .filter((w) => w.length > 2); // Filter short words
-            if (keywords.length === 0) {
-                if (format === 'markdown') {
-                    return `💡 Hint: Please be more specific.\nExample: "Railway Volume settings" or "mesh parameter optimization"`;
-                }
-                return null; // JSON mode returns null for empty/invalid queries
-            }
-            // Build LIKE query for each keyword
-            const likeConditions = keywords.map(() => '(topic LIKE ? OR decision LIKE ?)').join(' OR ');
-            const likeParams = keywords.flatMap((k) => [`%${k}%`, `%${k}%`]);
-            const stmt = adapter.prepare(`
-        SELECT * FROM decisions
-        WHERE ${likeConditions}
-        AND superseded_by IS NULL
-        ORDER BY created_at DESC
-        LIMIT ?
-      `);
-            const rows = (await stmt.all(...likeParams, rerankPoolLimit));
-            results = rows.map((row) => ({
-                ...row,
-                similarity: 0.75, // Assign moderate similarity for keyword matches
-            }));
-            // Stage 2: Graph expansion for keyword results (Phase 1)
-            if (results.length > 0) {
-                const graphEnhanced = await expandWithGraph(results);
-                results = graphEnhanced;
-                searchMethod = 'keyword+graph';
-            }
-        }
-        if (results.length === 0) {
-            if (format === 'markdown') {
-                const wordCount = userQuestion.split(/\s+/).length;
-                if (wordCount < 3) {
-                    return `💡 Hint: Please be more specific.\nExample: "Why did we choose COMPLEX mesh structure?" or "What parameters are used for large layers?"`;
-                }
-            }
-            return null;
-        }
-        // 5. Optional: LLM re-ranking (only if requested)
-        if (useReranking) {
-            results = await rerankWithLLM(userQuestion, results);
-        }
-        const rerankCandidateResults = results.slice(0, rerankPoolLimit);
-        const vectorRows = rerankCandidateResults.map((r) => ({
-            id: r.id,
-            topic: r.topic,
-            decision: r.decision,
-            reasoning: r.reasoning,
-            confidence: r.confidence,
-            similarity: r.similarity,
-            created_at: r.created_at,
-            event_date: r.event_date ?? null,
-            event_datetime: r.event_datetime ?? null,
-            // Recency metadata (NEW - Gaussian Decay)
-            recency_score: r.recency_score,
-            recency_age_days: r.recency_age_days,
-            final_score: r.final_score || r.similarity, // Falls back to similarity if no recency
-            retrieval_score: r.similarity ?? null,
-            // Graph metadata (NEW - Phase 1)
-            graph_source: r.graph_source || 'primary',
-            graph_rank: r.graph_rank || 1.0,
-            related_to: r.related_to || null,
-            edge_reason: r.edge_reason || null,
-            case_id: null,
-            source_type: 'decision',
-        }));
-        const { results: rankedVectorRows, meta: rankerMeta } = applyLearnedRanker(vectorRows);
-        const finalResults = rankedVectorRows.slice(0, limit);
-        // Markdown format (for human display)
-        if (format === 'markdown') {
-            const context = (0, decision_formatter_js_1.formatContext)(finalResults, { maxTokens: 500 });
-            // Add graph expansion summary if applicable
-            let graphSummary = '';
-            if (searchMethod.includes('graph')) {
-                const primaryCount = finalResults.filter((r) => r.graph_source === 'primary').length;
-                const expandedCount = finalResults.filter((r) => r.graph_source !== 'primary').length;
-                graphSummary = `\n📊 Graph expansion: ${primaryCount} primary + ${expandedCount} related (supersedes/refines/contradicts)\n`;
-            }
-            return `🔍 Search method: ${searchMethod}${graphSummary}\n${context}`;
-        }
-        // Calculate graph expansion stats
-        const graphStats = {
-            total_results: finalResults.length,
-            primary_count: finalResults.filter((r) => r.graph_source === 'primary').length,
-            expanded_count: finalResults.filter((r) => r.graph_source !== 'primary').length,
-            sources: {
-                primary: finalResults.filter((r) => r.graph_source === 'primary').length,
-                supersedes_chain: finalResults.filter((r) => r.graph_source === 'supersedes_chain').length,
-                refines: finalResults.filter((r) => r.graph_source === 'refines').length,
-                refined_by: finalResults.filter((r) => r.graph_source === 'refined_by').length,
-                contradicts: finalResults.filter((r) => r.graph_source === 'contradicts').length,
-            },
-        };
-        return {
-            query: userQuestion,
-            results: finalResults,
-            meta: {
-                count: finalResults.length,
-                search_method: searchMethod,
-                threshold: threshold || 'adaptive',
-                // Recency boosting config (NEW - Gaussian Decay)
-                recency_boost: disableRecency
-                    ? null
-                    : {
-                        weight: recencyWeight,
-                        scale: recencyScale,
-                        decay: recencyDecay,
-                    },
-                // Graph expansion stats (NEW - Phase 1)
-                graph_expansion: searchMethod.includes('graph') ? graphStats : null,
-                ranker: rankerMeta,
-            },
-        };
-    }
-    catch (error) {
-        // Graceful degradation
-        (0, debug_logger_js_1.warn)(`mama.suggest() failed: ${error instanceof Error ? error.message : String(error)}`);
-        return null;
-    }
+async function expandWithGraph(candidates) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.expandWithGraphInAdapter)((0, db_manager_js_1.getAdapter)(), candidates);
 }
-/**
- * Re-rank search results using local LLM (optional enhancement)
- *
- * @param {string} userQuestion - User's question
- * @param {Array} results - Vector search results
- * @returns {Promise<Array>} Re-ranked results
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-async function rerankWithLLM(userQuestion, results) {
-    try {
-        const prompt = `User asked: "${userQuestion}"
-
-Found decisions (ranked by vector similarity):
-${results.map((r, i) => `${i + 1}. [${(r.similarity ?? 0).toFixed(3)}] ${r.topic}: ${r.decision.substring(0, 60)}...`).join('\n')}
-
-Re-rank these by actual relevance to the user's intent (not just keyword similarity).
-Return JSON: { "ranking": [index1, index2, ...] } (0-based indices)
-
-Example: { "ranking": [2, 0, 4, 1, 3] } means 3rd is most relevant, then 1st, then 5th...`;
-        const response = await (0, ollama_client_js_1.generate)(prompt, {
-            format: 'json',
-            temperature: 0.3,
-            max_tokens: 100,
-            timeout: 3000,
-        });
-        const parsed = typeof response === 'string' ? JSON.parse(response) : response;
-        // Reorder results based on LLM ranking
-        return parsed.ranking.map((idx) => results[idx]).filter(Boolean);
-    }
-    catch (error) {
-        (0, debug_logger_js_1.warn)(`Re-ranking failed: ${error instanceof Error ? error.message : String(error)}, using vector ranking`);
-        return results; // Fallback to vector ranking
-    }
+async function updateOutcome(decisionId, outcome) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.updateOutcomeInAdapter)((0, db_manager_js_1.getAdapter)(), decisionId, outcome);
 }
 async function listDecisions(options = {}) {
-    const { limit = 10, format = 'json' } = options;
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        let decisions;
-        if (options.scopes && options.scopes.length > 0) {
-            // Scope-filtered query: JOIN memory_scope_bindings + memory_scopes
-            const scopeIds = await Promise.all(options.scopes.map((s) => (0, db_manager_js_1.ensureMemoryScope)(s.kind, s.id)));
-            const placeholders = scopeIds.map(() => '?').join(', ');
-            const stmt = adapter.prepare(`
-        SELECT DISTINCT d.* FROM decisions d
-        JOIN memory_scope_bindings msb ON msb.memory_id = d.id
-        WHERE msb.scope_id IN (${placeholders})
-          AND d.superseded_by IS NULL
-        ORDER BY COALESCE(d.event_datetime, d.created_at) DESC, d.created_at DESC
-        LIMIT ?
-      `);
-            decisions = await stmt.all(...scopeIds, limit);
-        }
-        else {
-            const stmt = adapter.prepare(`
-        SELECT * FROM decisions
-        WHERE superseded_by IS NULL
-        ORDER BY COALESCE(event_datetime, created_at) DESC, created_at DESC
-        LIMIT ?
-      `);
-            decisions = await stmt.all(limit);
-        }
-        if (format === 'markdown') {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            return (0, decision_formatter_js_1.formatList)(decisions);
-        }
-        return decisions;
-    }
-    catch (error) {
-        throw new Error(`mama.listDecisions() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.listDecisionsInAdapter)((0, db_manager_js_1.getAdapter)(), options);
 }
-/**
- * Save current session checkpoint (New Feature: Session Continuity)
- *
- * @param {string} summary - Summary of current session state
- * @param {Array<string>} openFiles - List of currently open files
- * @param {string} nextSteps - Next steps to be taken
- * @returns {Promise<number>} Checkpoint ID
- */
 async function saveCheckpoint(summary, openFiles = [], nextSteps = '', 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 recentConversation = []) {
-    if (!summary) {
-        throw new Error('Summary is required for checkpoint');
-    }
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        const stmt = adapter.prepare(`
-      INSERT INTO checkpoints (timestamp, summary, open_files, next_steps, recent_conversation, status)
-      VALUES (?, ?, ?, ?, ?, 'active')
-    `);
-        const result = stmt.run(Date.now(), summary, JSON.stringify(openFiles), nextSteps, JSON.stringify(recentConversation || []));
-        return result.lastInsertRowid;
-    }
-    catch (error) {
-        throw new Error(`Failed to save checkpoint: ${error instanceof Error ? error.message : String(error)}`);
-    }
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.saveCheckpointInAdapter)((0, db_manager_js_1.getAdapter)(), summary, openFiles, nextSteps, recentConversation);
 }
 async function loadCheckpoint() {
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        const stmt = adapter.prepare(`
-      SELECT * FROM checkpoints
-      WHERE status = 'active'
-      ORDER BY timestamp DESC
-      LIMIT 1
-    `);
-        const checkpoint = stmt.get();
-        if (checkpoint) {
-            try {
-                checkpoint.open_files =
-                    typeof checkpoint.open_files === 'string'
-                        ? JSON.parse(checkpoint.open_files)
-                        : checkpoint.open_files || [];
-            }
-            catch {
-                checkpoint.open_files = [];
-            }
-            try {
-                checkpoint.recent_conversation =
-                    typeof checkpoint.recent_conversation === 'string'
-                        ? JSON.parse(checkpoint.recent_conversation || '[]')
-                        : checkpoint.recent_conversation || [];
-            }
-            catch {
-                checkpoint.recent_conversation = [];
-            }
-        }
-        return checkpoint || null;
-    }
-    catch (error) {
-        throw new Error(`Failed to load checkpoint: ${error instanceof Error ? error.message : String(error)}`);
-    }
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.loadCheckpointInAdapter)((0, db_manager_js_1.getAdapter)());
 }
-/**
- * List recent checkpoints (New Feature: Session Continuity)
- *
- * @param {number} limit - Max number of checkpoints to return
- * @returns {Promise<Array>} Recent checkpoints
- */
 async function listCheckpoints(limit = 10) {
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        const stmt = adapter.prepare(`
-      SELECT * FROM checkpoints
-      ORDER BY timestamp DESC
-      LIMIT ?
-    `);
-        const checkpoints = stmt.all(limit);
-        return checkpoints.map((c) => {
-            try {
-                c.open_files =
-                    typeof c.open_files === 'string' ? JSON.parse(c.open_files) : c.open_files || [];
-            }
-            catch {
-                c.open_files = [];
-            }
-            try {
-                c.recent_conversation =
-                    typeof c.recent_conversation === 'string'
-                        ? JSON.parse(c.recent_conversation)
-                        : c.recent_conversation || [];
-            }
-            catch {
-                c.recent_conversation = [];
-            }
-            return c;
-        });
-    }
-    catch (error) {
-        throw new Error(`Failed to list checkpoints: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-async function proposeLink({ from_id, to_id, relationship, reason, decision_id, evidence, }) {
-    if (!from_id || !to_id || !relationship || !reason) {
-        throw new Error('proposeLink() requires from_id, to_id, relationship, and reason');
-    }
-    if (!['refines', 'contradicts'].includes(relationship)) {
-        throw new Error('proposeLink() relationship must be "refines" or "contradicts"');
-    }
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        // Use transaction to ensure atomicity (link + audit log)
-        adapter.transaction(() => {
-            // Insert link with pending approval
-            const stmt = adapter.prepare(`
-        INSERT INTO decision_edges
-          (from_id, to_id, relationship, reason, created_by, approved_by_user, decision_id, evidence, created_at)
-        VALUES (?, ?, ?, ?, 'llm', 0, ?, ?, ?)
-      `);
-            stmt.run(from_id, to_id, relationship, reason, decision_id || null, evidence || null, Date.now());
-            // Log to audit trail
-            const auditStmt = adapter.prepare(`
-        INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-        VALUES (?, ?, ?, 'proposed', 'llm', ?, ?)
-      `);
-            auditStmt.run(from_id, to_id, relationship, reason, Date.now());
-        });
-        return;
-    }
-    catch (error) {
-        throw new Error(`proposeLink() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Approve a proposed link (Epic 3 - Story 3.1)
- *
- * User approves a pending link, making it active.
- *
- * @param {string} from_id - Source decision ID
- * @param {string} to_id - Target decision ID
- * @param {string} relationship - Link relationship type
- * @returns {Promise<void>}
- */
-async function approveLink(from_id, to_id, relationship) {
-    if (!from_id || !to_id || !relationship) {
-        throw new Error('approveLink() requires from_id, to_id, and relationship');
-    }
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        // Update link to approved with timestamp
-        const stmt = adapter.prepare(`
-      UPDATE decision_edges
-      SET approved_by_user = 1, approved_at = ?
-      WHERE from_id = ? AND to_id = ? AND relationship = ?
-    `);
-        stmt.run(Date.now(), from_id, to_id, relationship);
-        // Log approval
-        const auditStmt = adapter.prepare(`
-      INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, created_at)
-      VALUES (?, ?, ?, 'approved', 'user', ?)
-    `);
-        auditStmt.run(from_id, to_id, relationship, Date.now());
-        return;
-    }
-    catch (error) {
-        throw new Error(`approveLink() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Reject a proposed link (Epic 3 - Story 3.1)
- *
- * User rejects a pending link, removing it from the database.
- *
- * @param {string} from_id - Source decision ID
- * @param {string} to_id - Target decision ID
- * @param {string} relationship - Link relationship type
- * @param {string} [reason] - Optional reason for rejection
- * @returns {Promise<void>}
- */
-async function rejectLink(from_id, to_id, relationship, reason) {
-    if (!from_id || !to_id || !relationship) {
-        throw new Error('rejectLink() requires from_id, to_id, and relationship');
-    }
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        // Log rejection before deletion
-        const auditStmt = adapter.prepare(`
-      INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-      VALUES (?, ?, ?, 'rejected', 'user', ?, ?)
-    `);
-        auditStmt.run(from_id, to_id, relationship, reason || 'User rejected', Date.now());
-        // Delete the link
-        const stmt = adapter.prepare(`
-      DELETE FROM decision_edges
-      WHERE from_id = ? AND to_id = ? AND relationship = ?
-    `);
-        stmt.run(from_id, to_id, relationship);
-        return;
-    }
-    catch (error) {
-        throw new Error(`rejectLink() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-async function getPendingLinks(options = {}) {
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        const { from_id, to_id } = options;
-        let query = `
-      SELECT
-        e.*,
-        d_from.topic as from_topic,
-        d_from.decision as from_decision,
-        d_to.topic as to_topic,
-        d_to.decision as to_decision
-      FROM decision_edges e
-      LEFT JOIN decisions d_from ON e.from_id = d_from.id
-      LEFT JOIN decisions d_to ON e.to_id = d_to.id
-      WHERE e.approved_by_user = 0
-    `;
-        const params = [];
-        if (from_id) {
-            query += ' AND e.from_id = ?';
-            params.push(from_id);
-        }
-        if (to_id) {
-            query += ' AND e.to_id = ?';
-            params.push(to_id);
-        }
-        query += ' ORDER BY e.created_at DESC';
-        const stmt = adapter.prepare(query);
-        const links = await stmt.all(...params);
-        return links;
-    }
-    catch (error) {
-        throw new Error(`getPendingLinks() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-async function deprecateAutoLinks(options = {}) {
-    const { dryRun = true } = options;
-    try {
-        const adapter = (0, memory_store_js_1.getAdapter)();
-        // Identify auto-generated links (v0 legacy)
-        // Criteria: created_by='user' (default) AND decision_id IS NULL (no proposal context)
-        // Protected: decision_id IS NOT NULL OR created_by='llm' (explicitly proposed)
-        const identifyStmt = adapter.prepare(`
-      SELECT * FROM decision_edges
-      WHERE created_by = 'user' AND decision_id IS NULL
-    `);
-        const autoLinks = (await identifyStmt.all());
-        // Identify protected links for comparison
-        const protectedStmt = adapter.prepare(`
-      SELECT COUNT(*) as count FROM decision_edges
-      WHERE decision_id IS NOT NULL OR created_by = 'llm'
-    `);
-        const protectedResult = (await protectedStmt.get());
-        const protectedCount = protectedResult?.count ?? 0;
-        const totalLinks = autoLinks.length + protectedCount;
-        const autoLinkRatio = totalLinks > 0 ? (autoLinks.length / totalLinks) * 100 : 0;
-        if (!dryRun && autoLinks.length > 0) {
-            // Delete auto-generated links
-            const deleteStmt = adapter.prepare(`
-        DELETE FROM decision_edges
-        WHERE created_by = 'user' AND decision_id IS NULL
-      `);
-            await deleteStmt.run();
-            // Log deprecation to audit trail
-            const timestamp = Date.now();
-            const auditStmt = adapter.prepare(`
-        INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-        VALUES (?, ?, ?, 'deprecated', 'system', ?, ?)
-      `);
-            for (const link of autoLinks) {
-                await auditStmt.run(link.from_id, link.to_id, link.relationship, 'v0 auto-generated link removed during governance migration', timestamp);
-            }
-        }
-        return {
-            dryRun,
-            deprecated: autoLinks.length,
-            protected: protectedCount,
-            total: totalLinks,
-            autoLinkRatio: autoLinkRatio.toFixed(2) + '%',
-            links: autoLinks.map((l) => ({
-                from_id: l.from_id,
-                to_id: l.to_id,
-                relationship: l.relationship,
-                reason: l.reason,
-                created_at: l.created_at,
-            })),
-        };
-    }
-    catch (error) {
-        throw new Error(`deprecateAutoLinks() failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Scan and identify auto-generated links for cleanup (Epic 5 - Story 5.1)
- *
- * Identifies auto-generated links lacking proper approval metadata.
- * Separates deletion targets from protected links.
- *
- * Identification criteria:
- * - approved_by_user = 0 OR (created_by IS NULL AND decision_id IS NULL)
- *
- * Protected (excluded from deletion):
- * - approved_by_user = 1 AND (decision_id IS NOT NULL OR evidence IS NOT NULL)
- *
- * @returns {Object} Scan results with counts and link details
- */
-function scanAutoLinks() {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    // Total links
-    const totalStmt = adapter.prepare(`SELECT COUNT(*) as count FROM decision_edges`);
-    const totalResult = totalStmt.get();
-    const totalLinks = totalResult?.count ?? 0;
-    // Auto-generated links (lacking proper metadata)
-    const autoStmt = adapter.prepare(`
-    SELECT * FROM decision_edges
-    WHERE approved_by_user = 0
-       OR (created_by IS NULL AND decision_id IS NULL)
-  `);
-    const autoLinks = autoStmt.all();
-    // Protected links (approved or has complete metadata)
-    const protectedStmt = adapter.prepare(`
-    SELECT COUNT(*) as count FROM decision_edges
-    WHERE approved_by_user = 1
-       OR (decision_id IS NOT NULL AND evidence IS NOT NULL)
-  `);
-    const protectedResult = protectedStmt.get();
-    const protectedLinks = protectedResult?.count ?? 0;
-    // Filter deletion targets (exclude protected links)
-    const deletionTargets = autoLinks.filter((link) => {
-        // Exclude protected links
-        return !(link.approved_by_user === 1 || (link.decision_id && link.evidence));
-    });
-    return {
-        total_links: totalLinks,
-        auto_links: autoLinks.length,
-        protected_links: protectedLinks,
-        deletion_targets: deletionTargets.length,
-        deletion_target_list: deletionTargets,
-    };
-}
-/**
- * Create backup of links before cleanup (Epic 5 - Story 5.1)
- *
- * Backs up deletion target links with full metadata to JSON file.
- * Generates SHA-256 checksum for data integrity verification.
- * Creates backup manifest with timestamp and metadata.
- *
- * @param {Array} targetLinks - Links to back up
- * @returns {Object} Backup result with file paths and checksum
- */
-function createLinkBackup(targetLinks) {
-    const backupDir = path_1.default.join(os_1.default.homedir(), '.claude', 'mama-backups');
-    // Create backup directory if not exists
-    if (!fs_1.default.existsSync(backupDir)) {
-        fs_1.default.mkdirSync(backupDir, { recursive: true });
-    }
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const backupFile = path_1.default.join(backupDir, `links-backup-${timestamp}.json`);
-    // Serialize target links with full metadata
-    const backupData = {
-        timestamp: new Date().toISOString(),
-        link_count: targetLinks.length,
-        links: targetLinks,
-    };
-    const backupJson = JSON.stringify(backupData, null, 2);
-    // Calculate SHA-256 checksum
-    const checksum = crypto_1.default.createHash('sha256').update(backupJson).digest('hex');
-    // Save backup file
-    fs_1.default.writeFileSync(backupFile, backupJson, 'utf8');
-    // Save manifest
-    const manifest = {
-        timestamp: backupData.timestamp,
-        backup_file: backupFile,
-        checksum,
-        link_count: targetLinks.length,
-    };
-    const manifestFile = path_1.default.join(backupDir, `backup-manifest-${timestamp}.json`);
-    fs_1.default.writeFileSync(manifestFile, JSON.stringify(manifest, null, 2), 'utf8');
-    return {
-        backup_file: backupFile,
-        manifest_file: manifestFile,
-        checksum,
-        link_count: targetLinks.length,
-    };
-}
-/**
- * Generate pre-cleanup report with risk assessment (Epic 5 - Story 5.1)
- *
- * Creates comprehensive report with statistics, risk level, and samples.
- * Risk assessment based on deletion ratio:
- * - HIGH: > 50% deletion
- * - MEDIUM: 30-50% deletion
- * - LOW: < 30% deletion
- *
- * @returns {Object} Report data with markdown output and file path
- */
-function generatePreCleanupReport() {
-    const scanResult = scanAutoLinks();
-    // Calculate risk level (guard against division by zero)
-    const deletionRatio = scanResult.total_links > 0 ? scanResult.deletion_targets / scanResult.total_links : 0;
-    let riskLevel;
-    if (deletionRatio > 0.5) {
-        riskLevel = 'HIGH';
-    }
-    else if (deletionRatio > 0.3) {
-        riskLevel = 'MEDIUM';
-    }
-    else {
-        riskLevel = 'LOW';
-    }
-    // Sample deletion targets (max 10)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const samples = scanResult.deletion_target_list.slice(0, 10).map((link) => ({
-        from_id: link.from_id,
-        to_id: link.to_id,
-        relationship: link.relationship,
-        reason: link.reason,
-        created_by: link.created_by,
-        approved_by_user: link.approved_by_user,
-    }));
-    const report = {
-        generated_at: new Date().toISOString(),
-        statistics: {
-            total_links: scanResult.total_links,
-            auto_links: scanResult.auto_links,
-            protected_links: scanResult.protected_links,
-            deletion_targets: scanResult.deletion_targets,
-            deletion_ratio: `${(deletionRatio * 100).toFixed(1)}%`,
-        },
-        risk_assessment: {
-            level: riskLevel,
-            message: riskLevel === 'HIGH'
-                ? '⚠️ HIGH RISK: Deletion targets exceed 50%. Create backup before proceeding.'
-                : riskLevel === 'MEDIUM'
-                    ? '⚡ MEDIUM RISK: Deletion targets 30-50%. Verify backup recommended.'
-                    : '✅ LOW RISK: Deletion targets under 30%. Safe to proceed.',
-        },
-        deletion_target_samples: samples,
-    };
-    // Generate markdown report
-    const markdown = `# Pre-Cleanup Report
-
-**Generated:** ${report.generated_at}
-
-## Statistics
-
-- **Total Links:** ${report.statistics.total_links}
-- **Auto Links:** ${report.statistics.auto_links}
-- **Protected Links:** ${report.statistics.protected_links}
-- **Deletion Targets:** ${report.statistics.deletion_targets} (${report.statistics.deletion_ratio})
-
-## Risk Assessment
-
-**Level:** ${report.risk_assessment.level}
-
-${report.risk_assessment.message}
-
-## Sample Deletion Targets (First 10)
-
-${samples
-        .map(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    (link, idx) => `
-### ${idx + 1}. ${link.from_id} → ${link.to_id}
-
-- **Relationship:** ${link.relationship}
-- **Reason:** ${link.reason || 'N/A'}
-- **Created By:** ${link.created_by || 'N/A'}
-- **Approved:** ${link.approved_by_user ? 'Yes' : 'No'}
-`)
-        .join('\n')}
-
----
-
-**Next Steps:**
-
-1. Review the deletion targets above
-2. Run \`create_link_backup\` to create a backup
-3. Proceed with cleanup using Story 5.2 tools
-4. If needed, restore from backup using \`restore_link_backup\`
-`;
-    const backupDir = path_1.default.join(os_1.default.homedir(), '.claude', 'mama-backups');
-    // Ensure backup directory exists
-    if (!fs_1.default.existsSync(backupDir)) {
-        fs_1.default.mkdirSync(backupDir, { recursive: true });
-    }
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const reportFile = path_1.default.join(backupDir, `pre-cleanup-report-${timestamp}.md`);
-    fs_1.default.writeFileSync(reportFile, markdown, 'utf8');
-    return {
-        report: report,
-        report_file: reportFile,
-        markdown,
-    };
-}
-/**
- * Restore links from backup file (Epic 5 - Story 5.1)
- *
- * Restores previously backed-up links to the database.
- * Verifies checksum before restoration to ensure data integrity.
- * Reports number of restored and failed links.
- *
- * @param {string} backupFile - Path to backup file
- * @returns {Object} Restoration result with counts
- */
-function restoreLinkBackup(backupFile) {
-    // Read backup file
-    const backupJson = fs_1.default.readFileSync(backupFile, 'utf8');
-    const backupData = JSON.parse(backupJson);
-    // Read manifest for checksum verification
-    const manifestFile = backupFile.replace('links-backup', 'backup-manifest');
-    const manifest = JSON.parse(fs_1.default.readFileSync(manifestFile, 'utf8'));
-    // Verify checksum
-    const calculatedChecksum = crypto_1.default.createHash('sha256').update(backupJson).digest('hex');
-    if (calculatedChecksum !== manifest.checksum) {
-        throw new Error('Backup file checksum mismatch. File may be corrupted.');
-    }
-    // Restore links to database
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    let restored = 0;
-    let failed = 0;
-    const insertStmt = adapter.prepare(`
-    INSERT OR REPLACE INTO decision_edges
-    (from_id, to_id, relationship, reason, created_by, approved_by_user, decision_id, evidence, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `);
-    for (const link of backupData.links) {
-        try {
-            insertStmt.run(link.from_id, link.to_id, link.relationship, link.reason, link.created_by, link.approved_by_user, link.decision_id, link.evidence, link.created_at);
-            restored++;
-        }
-        catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            (0, debug_logger_js_1.error)(`Failed to restore link ${link.from_id} -> ${link.to_id}:`, msg);
-            failed++;
-        }
-    }
-    return {
-        total_links: backupData.link_count,
-        restored,
-        failed,
-        backup_file: backupFile,
-    };
-}
-/**
- * Verify backup file exists and is recent (Epic 5 - Story 5.2)
- *
- * Checks for backup files in backup directory and verifies they are recent enough.
- * Required as safety check before executing link deletion.
- *
- * @param {number} maxAgeHours - Maximum age of backup in hours (default: 24)
- * @returns {Object} Backup verification result with latest backup info
- */
-function verifyBackupExists(maxAgeHours = 24) {
-    const backupDir = path_1.default.join(os_1.default.homedir(), '.claude', 'mama-backups');
-    if (!fs_1.default.existsSync(backupDir)) {
-        throw new Error('Backup directory not found. Please create a backup first using create_link_backup.');
-    }
-    const backupFiles = fs_1.default
-        .readdirSync(backupDir)
-        .filter((f) => f.startsWith('links-backup-'))
-        .map((f) => ({
-        name: f,
-        path: path_1.default.join(backupDir, f),
-        mtime: fs_1.default.statSync(path_1.default.join(backupDir, f)).mtime,
-    }))
-        .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
-    if (backupFiles.length === 0) {
-        throw new Error('No recent backup found. Please run create_link_backup first.');
-    }
-    const latestBackup = backupFiles[0];
-    const backupAge = Date.now() - latestBackup.mtime.getTime();
-    const maxAgeMs = maxAgeHours * 60 * 60 * 1000;
-    if (backupAge > maxAgeMs) {
-        throw new Error(`Most recent backup is too old (${(backupAge / (60 * 60 * 1000)).toFixed(1)} hours). Max age: ${maxAgeHours} hours.`);
-    }
-    // Read backup metadata
-    const backupJson = fs_1.default.readFileSync(latestBackup.path, 'utf8');
-    const backupData = JSON.parse(backupJson);
-    return {
-        backup_file: latestBackup.path,
-        age_hours: backupAge / (60 * 60 * 1000),
-        link_count: backupData.link_count || 0,
-    };
-}
-/**
- * Delete auto-generated links with batch processing (Epic 5 - Story 5.2)
- *
- * Executes batch deletion of auto-generated links with transaction support.
- * Requires recent backup (within 24 hours) before execution.
- * Logs all deletions to audit trail.
- *
- * Safety features:
- * - Backup verification before deletion
- * - Batch processing with transaction support
- * - Dry-run mode for simulation
- * - Large deletion warning (> 1000 links)
- *
- * @param {number} batchSize - Number of links to delete per batch (default: 100)
- * @param {boolean} dryRun - If true, simulate deletion without actual changes (default: true)
- * @returns {Object} Deletion result with counts and backup info
- */
-function deleteAutoLinks(batchSize = 100, dryRun = true) {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    // Safety check: Verify recent backup exists
-    const backupInfo = verifyBackupExists(24);
-    // Scan for deletion targets
-    const scanResult = scanAutoLinks();
-    const deletionTargets = scanResult.deletion_target_list;
-    if (deletionTargets.length === 0) {
-        return {
-            dry_run: dryRun,
-            deleted: 0,
-            failed: 0,
-            total_targets: 0,
-            backup_file: backupInfo.backup_file,
-            message: 'No auto-generated links found. Nothing to delete.',
-        };
-    }
-    // Large deletion warning
-    const largeDelection = deletionTargets.length > 1000;
-    if (largeDelection) {
-        (0, debug_logger_js_1.warn)(`⚠️ LARGE DELETION: ${deletionTargets.length} links will be deleted. Consider running in dry-run mode first.`);
-    }
-    if (dryRun) {
-        return {
-            dry_run: true,
-            would_delete: deletionTargets.length,
-            deleted: 0,
-            backup_file: backupInfo.backup_file,
-            large_deletion_warning: largeDelection,
-            warning_message: largeDelection
-                ? `Warning: More than 1000 links (${deletionTargets.length}) will be deleted.`
-                : null,
-            sample_links: deletionTargets.slice(0, 5).map((l) => ({
-                from_id: l.from_id,
-                to_id: l.to_id,
-                relationship: l.relationship,
-            })),
-            message: 'Dry-run mode: No links were actually deleted.',
-        };
-    }
-    // Execute batch deletion with transaction support
-    let deleted = 0;
-    let failed = 0;
-    let batchesProcessed = 0;
-    const errors = [];
-    const deleteStmt = adapter.prepare(`
-    DELETE FROM decision_edges
-    WHERE from_id = ? AND to_id = ? AND relationship = ?
-  `);
-    const auditStmt = adapter.prepare(`
-    INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-    VALUES (?, ?, ?, 'deprecated', 'system', ?, ?)
-  `);
-    // Process in batches
-    for (let i = 0; i < deletionTargets.length; i += batchSize) {
-        const batch = deletionTargets.slice(i, i + batchSize);
-        try {
-            const processBatch = () => {
-                for (const link of batch) {
-                    try {
-                        deleteStmt.run(link.from_id, link.to_id, link.relationship);
-                        auditStmt.run(link.from_id, link.to_id, link.relationship, 'Auto-link cleanup - v1.1 migration', Date.now());
-                        deleted++;
-                    }
-                    catch (error) {
-                        failed++;
-                        errors.push({
-                            link: `${link.from_id}->${link.to_id}`,
-                            error: error instanceof Error ? error.message : String(error),
-                        });
-                    }
-                }
-            };
-            // Use transaction if available, otherwise run directly
-            if (adapter.transaction) {
-                adapter.transaction(processBatch);
-            }
-            else {
-                processBatch();
-            }
-            batchesProcessed++;
-        }
-        catch (error) {
-            (0, debug_logger_js_1.error)(`Batch deletion failed at index ${i}:`, error);
-            failed += batch.length;
-            errors.push({
-                batch_index: i,
-                batch_size: batch.length,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            break; // Stop on batch failure
-        }
-    }
-    const successRate = deletionTargets.length > 0 ? (deleted / deletionTargets.length) * 100 : 0;
-    return {
-        dry_run: false,
-        deleted,
-        failed,
-        total_targets: deletionTargets.length,
-        backup_file: backupInfo.backup_file,
-        batches_processed: batchesProcessed,
-        errors: errors.slice(0, 10), // Return first 10 errors
-        success_rate: successRate,
-    };
-}
-/**
- * Validate cleanup result and generate post-cleanup report (Epic 5 - Story 5.2)
- *
- * Re-scans for remaining auto-generated links and evaluates cleanup success.
- * Generates comprehensive report with statistics and recommendations.
- *
- * Success criteria:
- * - SUCCESS: Remaining auto links < 5%
- * - PARTIAL: Remaining auto links 5-10%
- * - FAILED: Remaining auto links > 10%
- *
- * @returns {Object} Validation result with report and file path
- */
-function validateCleanupResult() {
-    // Re-scan for remaining auto links
-    const scanResult = scanAutoLinks();
-    // Calculate remaining ratio
-    const totalLinks = scanResult.total_links;
-    const remainingAutoLinks = scanResult.auto_links;
-    const remainingRatio = totalLinks > 0 ? remainingAutoLinks / totalLinks : 0;
-    // Evaluate cleanup success
-    let status;
-    let message;
-    let recommendation;
-    if (remainingRatio < 0.05) {
-        status = 'SUCCESS';
-        message = '✅ SUCCESS: Remaining auto-links under 5%. Target achieved!';
-        recommendation = 'Cleanup completed successfully. You can proceed with migration.';
-    }
-    else if (remainingRatio < 0.1) {
-        status = 'PARTIAL';
-        message = '⚡ PARTIAL: Remaining auto-links 5-10%. Additional cleanup recommended.';
-        recommendation = 'Run execute_link_cleanup again to clean up more auto-links.';
-    }
-    else {
-        status = 'FAILED';
-        message = '⚠️ FAILED: Remaining auto-links exceed 10%. Rollback or re-run needed.';
-        recommendation = 'Significantly missed target. Consider restoring from backup and retry.';
-    }
-    // Generate post-cleanup report
-    const report = {
-        validated_at: new Date().toISOString(),
-        status,
-        message,
-        statistics: {
-            total_links: totalLinks,
-            remaining_auto_links: remainingAutoLinks,
-            remaining_ratio: `${(remainingRatio * 100).toFixed(1)}%`,
-            protected_links: scanResult.protected_links,
-            deletion_targets: scanResult.deletion_targets,
-        },
-        recommendation,
-    };
-    // Generate markdown report
-    const markdown = generatePostCleanupReportMarkdown(report);
-    // Save report to file
-    const backupDir = path_1.default.join(os_1.default.homedir(), '.claude', 'mama-backups');
-    if (!fs_1.default.existsSync(backupDir)) {
-        fs_1.default.mkdirSync(backupDir, { recursive: true });
-    }
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const reportFile = path_1.default.join(backupDir, `post-cleanup-report-${timestamp}.md`);
-    fs_1.default.writeFileSync(reportFile, markdown, 'utf8');
-    return {
-        status,
-        total_links_before: totalLinks,
-        auto_links_remaining: remainingAutoLinks,
-        remaining_ratio: remainingRatio * 100,
-        protected_links: scanResult.protected_links,
-        report,
-        report_file: reportFile,
-        markdown,
-    };
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_1.listCheckpointsInAdapter)((0, db_manager_js_1.getAdapter)(), limit);
 }
 /**
- * Generate post-cleanup report in Markdown format (Epic 5 - Story 5.2)
- *
- * @param {Object} report - Validation report data
- * @returns {string} Markdown formatted report
+ * Public write boundary for audit findings. The store writer takes the adapter
+ * from its caller; this edge resolves the ambient adapter so the
+ * MAMAApiInterface signature stays (input) => Promise<string>.
  */
-function generatePostCleanupReportMarkdown(report) {
-    let markdown = `# Post-Cleanup Validation Report
-
-**Generated:** ${report.validated_at}
-**Status:** ${report.status}
-
-${report.message}
-
-## Statistics
-
-- **Total Links:** ${report.statistics.total_links}
-- **Remaining Auto Links:** ${report.statistics.remaining_auto_links}
-- **Remaining Ratio:** ${report.statistics.remaining_ratio}
-- **Protected Links:** ${report.statistics.protected_links}
-- **Deletion Targets (if any):** ${report.statistics.deletion_targets}
-
-## Recommendation
-
-${report.recommendation}
-`;
-    // Add rollback instructions for non-SUCCESS statuses
-    if (report.status !== 'SUCCESS') {
-        markdown += `
-
----
-
-## Rollback Instructions
-
-If you need to restore the deleted links:
-
-1. Find the latest backup file in \`~/.claude/mama-backups/\`
-2. Run: \`restore_link_backup <backup_file_path>\`
-3. Re-run validation: \`validate_cleanup_result\`
-
-**Next Steps:**
-
-- For PARTIAL status: Review remaining auto links and run cleanup again if needed
-- For FAILED status: Consider rollback and investigate why many links remain
-`;
-    }
-    return markdown;
-}
-/**
- * Calculate coverage metrics (Epic 4 - Story 4.1)
- *
- * Measures narrative coverage (% of decisions with narrative fields)
- * and link coverage (% of decisions with at least one link).
- *
- * @returns {Object} Coverage metrics
- */
-function calculateCoverage() {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    // Total decisions
-    const totalDecisions = adapter.prepare(`SELECT COUNT(*) as count FROM decisions`).get().count;
-    if (totalDecisions === 0) {
-        return {
-            narrativeCoverage: '0.0%',
-            linkCoverage: '0.0%',
-            totalDecisions: 0,
-            completeNarratives: 0,
-            decisionsWithLinks: 0,
-        };
-    }
-    // Narrative coverage: Decisions with evidence, alternatives, and risks filled
-    // Note: Using existing schema fields (evidence, alternatives, risks) instead of
-    // 5-layer fields (specificity, evidence, reasoning, tension, continuity) mentioned in story
-    const completeNarratives = adapter
-        .prepare(`
-    SELECT COUNT(*) as count FROM decisions
-    WHERE evidence IS NOT NULL AND evidence != ''
-      AND alternatives IS NOT NULL AND alternatives != ''
-      AND risks IS NOT NULL AND risks != ''
-  `)
-        .get().count;
-    const narrativeCoverage = (completeNarratives / totalDecisions) * 100;
-    // Link coverage: Decisions with at least one link
-    const decisionsWithLinks = adapter
-        .prepare(`
-    SELECT COUNT(DISTINCT d.id) as count FROM decisions d
-    WHERE EXISTS (
-      SELECT 1 FROM decision_edges e
-      WHERE e.from_id = d.id OR e.to_id = d.id
-    )
-  `)
-        .get().count;
-    const linkCoverage = (decisionsWithLinks / totalDecisions) * 100;
-    return {
-        narrativeCoverage: `${narrativeCoverage.toFixed(1)}%`,
-        linkCoverage: `${linkCoverage.toFixed(1)}%`,
-        totalDecisions,
-        completeNarratives,
-        decisionsWithLinks,
-    };
-}
-/**
- * Log restart attempt (Epic 4 - Story 4.2)
- *
- * Records restart attempt with success/failure status, latency, and mode.
- * Replaces in-memory restart-metrics.js with SQLite-backed storage.
- *
- * @param {string} sessionId - Session identifier
- * @param {string} status - 'success' or 'failure'
- * @param {string|null} failureReason - 'NO_CHECKPOINT', 'LOAD_ERROR', 'CONTEXT_INCOMPLETE', or null
- * @param {number} latencyMs - Latency in milliseconds
- * @param {string} mode - 'full' (narrative+links) or 'summary' (summary only)
- * @returns {void}
- */
-function logRestartAttempt(sessionId, status, failureReason, latencyMs, mode = 'full') {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    const timestamp = new Date().toISOString();
-    adapter
-        .prepare(`
-    INSERT INTO restart_metrics (timestamp, session_id, status, failure_reason, latency_ms, mode)
-    VALUES (?, ?, ?, ?, ?, ?)
-  `)
-        .run(timestamp, sessionId, status, failureReason, latencyMs, mode);
-    // Performance warning if exceeds threshold
-    // Note: Using console.warn directly (not logWarn) because performance warnings
-    // should always be visible regardless of MAMA_LOG_LEVEL setting
-    const threshold = mode === 'summary' ? 1000 : 2500;
-    if (latencyMs > threshold) {
-        console.warn(JSON.stringify({
-            performance_warning: true,
-            message: `Restart latency exceeded threshold: ${latencyMs}ms > ${threshold}ms`,
-            session_id: sessionId,
-            mode,
-            latency_ms: latencyMs,
-            threshold_ms: threshold,
-        }));
-    }
-}
-/**
- * Calculate restart success rate (Epic 4 - Story 4.2)
- *
- * Calculates success rate over a given period (24h, 7d, 30d).
- *
- * @param {string} period - '24h', '7d', or '30d'
- * @returns {Object} Success rate metrics
- */
-function calculateRestartSuccessRate(period = '7d') {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    const periodMap = {
-        '24h': 1,
-        '7d': 7,
-        '30d': 30,
-    };
-    const days = periodMap[period] || 7;
-    const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
-    const stats = adapter
-        .prepare(`
-    SELECT
-      COUNT(*) as total,
-      COUNT(CASE WHEN status = 'success' THEN 1 END) as success,
-      COUNT(CASE WHEN status = 'failure' THEN 1 END) as failure
-    FROM restart_metrics
-    WHERE timestamp >= ?
-  `)
-        .get(since);
-    const successRate = stats.total > 0 ? stats.success / stats.total : 0;
-    return {
-        period,
-        total: stats.total,
-        success: stats.success,
-        failure: stats.failure,
-        successRate: `${(successRate * 100).toFixed(1)}%`,
-        meetsTarget: successRate >= 0.95,
-    };
-}
-/**
- * Calculate restart latency percentiles (Epic 4 - Story 4.2)
- *
- * Calculates p50, p95, p99 latencies for successful restarts.
- * Optionally filters by mode (full/summary).
- *
- * @param {string} period - '24h', '7d', or '30d'
- * @param {string|null} mode - 'full', 'summary', or null (all modes)
- * @returns {Object} Latency percentile metrics
- */
-function calculateRestartLatency(period = '7d', mode = null) {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    const periodMap = { '24h': 1, '7d': 7, '30d': 30 };
-    const days = periodMap[period] || 7;
-    const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
-    let query = `
-    SELECT latency_ms
-    FROM restart_metrics
-    WHERE timestamp >= ? AND status = 'success'
-  `;
-    const params = [since];
-    if (mode) {
-        query += ` AND mode = ?`;
-        params.push(mode);
-    }
-    query += ` ORDER BY latency_ms ASC`;
-    const rows = adapter.prepare(query).all(...params);
-    const latencies = rows.map((r) => r.latency_ms);
-    if (latencies.length === 0) {
-        return { p50: 0, p95: 0, p99: 0, count: 0, mode: mode || 'all' };
-    }
-    const percentile = (arr, p) => {
-        const index = Math.ceil((p / 100) * arr.length) - 1;
-        return arr[Math.max(0, index)];
-    };
-    return {
-        p50: percentile(latencies, 50),
-        p95: percentile(latencies, 95),
-        p99: percentile(latencies, 99),
-        count: latencies.length,
-        mode: mode || 'all',
-    };
-}
-/**
- * Get restart metrics (Epic 4 - Story 4.2)
- *
- * Combines success rate and latency metrics for a given period.
- *
- * @param {string} period - '24h', '7d', or '30d'
- * @param {boolean} includeLatency - Whether to include latency percentiles
- * @returns {Object} Combined restart metrics
- */
-function getRestartMetrics(period = '7d', includeLatency = true) {
-    const successRate = calculateRestartSuccessRate(period);
-    const result = { successRate };
-    if (includeLatency) {
-        result.latency = {
-            full: calculateRestartLatency(period, 'full'),
-            summary: calculateRestartLatency(period, 'summary'),
-        };
-    }
-    return result;
-}
-/**
- * Calculate quality metrics (Epic 4 - Story 4.1)
- *
- * Measures narrative quality (field completeness per layer)
- * and link quality (rich reason ratio, approved link ratio).
- *
- * @returns {Object} Quality metrics
- */
-function calculateQuality() {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    // Narrative quality: Average completeness for each narrative field
-    const narrativeQuality = adapter
-        .prepare(`
-    SELECT
-      AVG(CASE WHEN evidence IS NOT NULL AND evidence != '' THEN 1 ELSE 0 END) as evidence,
-      AVG(CASE WHEN alternatives IS NOT NULL AND alternatives != '' THEN 1 ELSE 0 END) as alternatives,
-      AVG(CASE WHEN risks IS NOT NULL AND risks != '' THEN 1 ELSE 0 END) as risks
-    FROM decisions
-  `)
-        .get();
-    // Link quality: "Rich" reason ratio (reason > 50 chars) and approved link ratio
-    const linkStats = adapter
-        .prepare(`
-    SELECT
-      COUNT(*) as total,
-      COUNT(CASE WHEN reason IS NOT NULL AND LENGTH(reason) > 50 THEN 1 END) as rich,
-      COUNT(CASE WHEN approved_by_user = 1 THEN 1 END) as approved
-    FROM decision_edges
-  `)
-        .get();
-    const linkQuality = linkStats.total > 0 ? ((linkStats.rich / linkStats.total) * 100).toFixed(1) : '0.0';
-    const approvedRatio = linkStats.total > 0 ? ((linkStats.approved / linkStats.total) * 100).toFixed(1) : '0.0';
-    return {
-        narrativeQuality: {
-            evidence: `${(narrativeQuality.evidence * 100).toFixed(1)}%`,
-            alternatives: `${(narrativeQuality.alternatives * 100).toFixed(1)}%`,
-            risks: `${(narrativeQuality.risks * 100).toFixed(1)}%`,
-        },
-        linkQuality: {
-            richReasonRatio: `${linkQuality}%`,
-            approvedRatio: `${approvedRatio}%`,
-            totalLinks: linkStats.total,
-            richLinks: linkStats.rich,
-            approvedLinks: linkStats.approved,
-        },
-    };
-}
-/**
- * Generate quality report with recommendations (Epic 4 - Story 4.1 + 4.2)
- *
- * Generates a comprehensive quality report with coverage, quality metrics,
- * restart metrics, and recommendations for improvement.
- *
- * @param {Object} options - Report options
- * @param {string} [options.format='json'] - Output format: 'json' or 'markdown'
- * @param {string} [options.period='7d'] - Period for restart metrics: '24h', '7d', or '30d'
- * @param {Object} [options.thresholds] - Custom thresholds
- * @param {number} [options.thresholds.narrativeCoverage=0.8] - Narrative coverage threshold (0-1)
- * @param {number} [options.thresholds.linkCoverage=0.7] - Link coverage threshold (0-1)
- * @param {number} [options.thresholds.richReasonRatio=0.7] - Rich reason ratio threshold (0-1)
- * @param {number} [options.thresholds.restartSuccessRate=0.95] - Restart success rate threshold (0-1)
- * @param {number} [options.thresholds.restartLatencyP95Full=2500] - Full mode p95 latency threshold (ms)
- * @param {number} [options.thresholds.restartLatencyP95Summary=1000] - Summary mode p95 latency threshold (ms)
- * @returns {Object|string} Quality report as JSON or Markdown
- */
-function generateQualityReport(options = {}) {
-    const { format = 'json', period = '7d', thresholds = {} } = options;
-    const defaultThresholds = {
-        narrativeCoverage: 0.8,
-        linkCoverage: 0.7,
-        richReasonRatio: 0.7,
-        restartSuccessRate: 0.95,
-        restartLatencyP95Full: 2500,
-        restartLatencyP95Summary: 1000,
-        ...thresholds,
-    };
-    const coverage = calculateCoverage();
-    const quality = calculateQuality();
-    // Story 4.2: Add restart metrics
-    const validPeriod = (['24h', '7d', '30d'].includes(period || '7d') ? period : '7d');
-    const restartMetrics = getRestartMetrics(validPeriod, true);
-    const recommendations = [];
-    // Check narrative coverage threshold
-    const narrativeCoveragePct = parseFloat(coverage.narrativeCoverage);
-    if (narrativeCoveragePct < defaultThresholds.narrativeCoverage * 100) {
-        recommendations.push({
-            type: 'narrative_coverage',
-            message: `Narrative coverage below target (${defaultThresholds.narrativeCoverage * 100}%). Add narrative to decisions missing evidence, alternatives, or risks fields.`,
-            target: `${defaultThresholds.narrativeCoverage * 100}%`,
-            current: coverage.narrativeCoverage,
-        });
-    }
-    // Check link coverage threshold
-    const linkCoveragePct = parseFloat(coverage.linkCoverage);
-    if (linkCoveragePct < defaultThresholds.linkCoverage * 100) {
-        recommendations.push({
-            type: 'link_coverage',
-            message: `Link coverage below target (${defaultThresholds.linkCoverage * 100}%). Add links between related decisions.`,
-            target: `${defaultThresholds.linkCoverage * 100}%`,
-            current: coverage.linkCoverage,
-        });
-    }
-    // Check link quality threshold
-    const richReasonRatioPct = parseFloat(quality.linkQuality.richReasonRatio);
-    if (richReasonRatioPct < defaultThresholds.richReasonRatio * 100) {
-        recommendations.push({
-            type: 'link_quality',
-            message: `Link quality below target (${defaultThresholds.richReasonRatio * 100}%). Add specific causality and evidence to link reason fields.`,
-            target: `${defaultThresholds.richReasonRatio * 100}%`,
-            current: quality.linkQuality.richReasonRatio,
-        });
-    }
-    // Story 4.2: Check restart success rate threshold (only if there's data)
-    if (restartMetrics.successRate.total > 0 && !restartMetrics.successRate.meetsTarget) {
-        const _successRatePct = parseFloat(restartMetrics.successRate.successRate);
-        recommendations.push({
-            type: 'restart_success_rate',
-            message: `Restart success rate below target (95%). Analyze failure reasons and improve checkpoint quality.`,
-            target: '95%',
-            current: restartMetrics.successRate.successRate,
-        });
-    }
-    // Story 4.2: Check restart latency thresholds (only if there's data)
-    if (restartMetrics.latency) {
-        const fullP95 = restartMetrics.latency.full.p95;
-        if (restartMetrics.latency.full.count > 0 &&
-            fullP95 > defaultThresholds.restartLatencyP95Full) {
-            recommendations.push({
-                type: 'restart_latency_full',
-                message: `Narrative+link expansion p95 latency exceeds target (2.5s). Consider limiting link expansion depth or adding caching.`,
-                target: `${defaultThresholds.restartLatencyP95Full}ms`,
-                current: `${fullP95}ms`,
-            });
-        }
-        const summaryP95 = restartMetrics.latency.summary.p95;
-        if (restartMetrics.latency.summary.count > 0 &&
-            summaryP95 > defaultThresholds.restartLatencyP95Summary) {
-            recommendations.push({
-                type: 'restart_latency_summary',
-                message: `Summary mode p95 latency exceeds target (1.0s). Review query optimization or add indexes.`,
-                target: `${defaultThresholds.restartLatencyP95Summary}ms`,
-                current: `${summaryP95}ms`,
-            });
-        }
-    }
-    const report = {
-        generated_at: new Date().toISOString(),
-        period,
-        coverage,
-        quality,
-        restart: restartMetrics,
-        thresholds: defaultThresholds,
-        recommendations,
-        format,
-    };
-    if (format === 'markdown') {
-        return formatQualityReportMarkdown(report);
-    }
-    return report;
-}
-/**
- * Format quality report as Markdown
- *
- * @param {Object} report - Quality report data
- * @returns {string} Markdown-formatted report
- */
-function formatQualityReportMarkdown(report) {
-    const { generated_at, period, coverage, quality, restart, thresholds, recommendations } = report;
-    let markdown = `# 📊 MAMA Quality Report\n\n`;
-    markdown += `Generated: ${generated_at}\n`;
-    markdown += `Period: ${period}\n\n`;
-    markdown += `## Coverage Metrics\n\n`;
-    markdown += `- **Narrative Coverage**: ${coverage.narrativeCoverage} (${coverage.completeNarratives}/${coverage.totalDecisions} decisions)\n`;
-    markdown += `- **Link Coverage**: ${coverage.linkCoverage} (${coverage.decisionsWithLinks}/${coverage.totalDecisions} decisions)\n\n`;
-    markdown += `## Quality Metrics\n\n`;
-    markdown += `### Narrative Quality\n`;
-    markdown += `- Evidence: ${quality.narrativeQuality.evidence}\n`;
-    markdown += `- Alternatives: ${quality.narrativeQuality.alternatives}\n`;
-    markdown += `- Risks: ${quality.narrativeQuality.risks}\n\n`;
-    markdown += `### Link Quality\n`;
-    markdown += `- Rich Reason Ratio: ${quality.linkQuality.richReasonRatio} (${quality.linkQuality.richLinks}/${quality.linkQuality.totalLinks} links)\n`;
-    markdown += `- Approved Link Ratio: ${quality.linkQuality.approvedRatio} (${quality.linkQuality.approvedLinks}/${quality.linkQuality.totalLinks} links)\n\n`;
-    // Story 4.2: Add restart metrics section
-    if (restart) {
-        markdown += `## Restart Metrics\n\n`;
-        markdown += `### Success Rate\n`;
-        markdown += `- **Success Rate**: ${restart.successRate.successRate} (${restart.successRate.success}/${restart.successRate.total} attempts)\n`;
-        markdown += `- **Meets Target**: ${restart.successRate.meetsTarget ? '✅ Yes' : '❌ No'}\n`;
-        markdown += `- Failures: ${restart.successRate.failure}\n\n`;
-        if (restart.latency) {
-            markdown += `### Latency (Percentiles)\n\n`;
-            markdown += `**Full Mode (Narrative + Links)**\n`;
-            markdown += `- p50: ${restart.latency.full.p50}ms\n`;
-            markdown += `- p95: ${restart.latency.full.p95}ms\n`;
-            markdown += `- p99: ${restart.latency.full.p99}ms\n`;
-            markdown += `- Count: ${restart.latency.full.count}\n\n`;
-            markdown += `**Summary Mode**\n`;
-            markdown += `- p50: ${restart.latency.summary.p50}ms\n`;
-            markdown += `- p95: ${restart.latency.summary.p95}ms\n`;
-            markdown += `- p99: ${restart.latency.summary.p99}ms\n`;
-            markdown += `- Count: ${restart.latency.summary.count}\n\n`;
-        }
-    }
-    markdown += `## Thresholds\n\n`;
-    markdown += `- Narrative Coverage: ≥ ${thresholds.narrativeCoverage * 100}%\n`;
-    markdown += `- Link Coverage: ≥ ${thresholds.linkCoverage * 100}%\n`;
-    markdown += `- Rich Reason Ratio: ≥ ${thresholds.richReasonRatio * 100}%\n`;
-    markdown += `- Restart Success Rate: ≥ ${thresholds.restartSuccessRate * 100}%\n`;
-    markdown += `- Restart Latency p95 (Full): ≤ ${thresholds.restartLatencyP95Full}ms\n`;
-    markdown += `- Restart Latency p95 (Summary): ≤ ${thresholds.restartLatencyP95Summary}ms\n\n`;
-    if (recommendations.length > 0) {
-        markdown += `## ⚠️ Recommendations\n\n`;
-        recommendations.forEach((rec, idx) => {
-            markdown += `${idx + 1}. **${rec.type}**: ${rec.message}\n`;
-            markdown += `   - Target: ${rec.target}, Current: ${rec.current}\n\n`;
-        });
-    }
-    else {
-        markdown += `## ✅ All quality targets met!\n\n`;
-    }
-    return markdown;
+async function createAuditFinding(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, finding_store_js_1.createAuditFinding)((0, db_manager_js_1.getAdapter)(), input);
+}
+// Facade wrappers: the stores below take an explicit adapter as their first
+// argument; the `mama` surface keeps its published (input) signatures and
+// resolves the ambient adapter at this boundary instead.
+async function upsertChannelSummary(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.upsertChannelSummary)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function getChannelSummary(channelKey) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.getChannelSummary)((0, db_manager_js_1.getAdapter)(), channelKey);
+}
+async function listOpenAuditFindings() {
+    await (0, db_manager_js_1.initDB)();
+    return (0, finding_store_js_1.listOpenAuditFindings)((0, db_manager_js_1.getAdapter)());
+}
+async function listMemoryEventsForMemory(memoryId) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, event_store_js_1.listMemoryEventsForMemory)((0, db_manager_js_1.getAdapter)(), memoryId);
+}
+async function listRecentMemoryEvents(limit) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, event_store_js_1.listRecentMemoryEvents)((0, db_manager_js_1.getAdapter)(), limit);
+}
+async function getMemoryProvenance(memoryId, options) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, provenance_query_js_1.getMemoryProvenance)((0, db_manager_js_1.getAdapter)(), memoryId, options);
+}
+async function listMemoriesByEnvelopeHash(envelopeHash, options) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, provenance_query_js_1.listMemoriesByEnvelopeHash)((0, db_manager_js_1.getAdapter)(), envelopeHash, options);
+}
+async function listMemoriesByGatewayCallId(gatewayCallId, options) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, provenance_query_js_1.listMemoriesByGatewayCallId)((0, db_manager_js_1.getAdapter)(), gatewayCallId, options);
+}
+async function listMemoriesByModelRunId(modelRunId, options) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, provenance_query_js_1.listMemoriesByModelRunId)((0, db_manager_js_1.getAdapter)(), modelRunId, options);
+}
+// memory/api.ts is adapter-first; the `mama` surface keeps its published
+// (input) signatures and resolves the ambient adapter at this boundary.
+async function saveMemory(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.saveMemory)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function recallMemory(query, options) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.recallMemory)((0, db_manager_js_1.getAdapter)(), query, options);
+}
+async function buildProfile(scopes) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.buildProfile)((0, db_manager_js_1.getAdapter)(), scopes);
+}
+async function ingestMemory(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.ingestMemory)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function ingestConversation(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.ingestConversation)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function buildMemoryBootstrap(params) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.buildMemoryBootstrap)((0, db_manager_js_1.getAdapter)(), params);
+}
+async function recordMemoryAudit(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, api_js_2.recordMemoryAudit)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function beginModelRun(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, model_run_store_js_1.beginModelRun)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function commitModelRun(modelRunId, summary, tokenCount) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, model_run_store_js_1.commitModelRun)((0, db_manager_js_1.getAdapter)(), modelRunId, summary, tokenCount);
+}
+async function failModelRun(modelRunId, errorSummary, tokenCount) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, model_run_store_js_1.failModelRun)((0, db_manager_js_1.getAdapter)(), modelRunId, errorSummary, tokenCount);
+}
+async function getModelRun(modelRunId) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, model_run_store_js_1.getModelRun)((0, db_manager_js_1.getAdapter)(), modelRunId);
+}
+async function appendToolTrace(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, tool_trace_store_js_1.appendToolTrace)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function listToolTracesForRun(modelRunId) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, tool_trace_store_js_1.listToolTracesForRun)((0, db_manager_js_1.getAdapter)(), modelRunId);
+}
+async function listToolTraces(input) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, tool_trace_store_js_1.listToolTraces)((0, db_manager_js_1.getAdapter)(), input);
+}
+async function readToolTrace(traceId, scope) {
+    await (0, db_manager_js_1.initDB)();
+    return (0, tool_trace_store_js_1.readToolTrace)((0, db_manager_js_1.getAdapter)(), traceId, scope);
 }
 /**
  * MAMA Public API
@@ -2791,77 +605,119 @@ function formatQualityReportMarkdown(report) {
 // Retained internal functions for future use, but MCP exposes only:
 //   save, search, update, load_checkpoint
 // ════════════════════════════════════════════════════════════════════════════
+/**
+ * Instance-bound MAMA API factory.
+ *
+ * Same member surface as the ambient `mama` object, but every call reads and
+ * writes through the adapter the owner hands in — no module-global handle is
+ * consulted. Products that own their database lifetime (openDatabase) bind
+ * once at boot and pass this object down; the ambient `mama` export remains
+ * the compatibility boundary for callers without an instance.
+ */
+function createMamaApi(adapter) {
+    return {
+        save: (params) => saveInternal(adapter, params),
+        suggest: (userQuestion, options) => (0, api_js_1.suggestInAdapter)(adapter, userQuestion, options),
+        saveMemory: (input) => (0, api_js_2.saveMemory)(adapter, input),
+        recallMemory: (query, options) => (0, api_js_2.recallMemory)(adapter, query, options),
+        list: (options) => (0, api_js_1.listDecisionsInAdapter)(adapter, options),
+        listDecisions: (options) => (0, api_js_1.listDecisionsInAdapter)(adapter, options),
+        listCheckpoints: (limit) => (0, api_js_1.listCheckpointsInAdapter)(adapter, limit),
+        updateOutcome: (decisionId, outcome) => (0, api_js_1.updateOutcomeInAdapter)(adapter, decisionId, outcome),
+        buildProfile: (scopes) => (0, api_js_2.buildProfile)(adapter, scopes),
+        ingestMemory: (input) => (0, api_js_2.ingestMemory)(adapter, input),
+        ingestConversation: (input) => (0, api_js_2.ingestConversation)(adapter, input),
+        evolveMemory: (input) => (0, api_js_2.evolveMemory)(input),
+        buildMemoryBootstrap: (params) => (0, api_js_2.buildMemoryBootstrap)(adapter, params),
+        createAuditAck: (input) => (0, api_js_2.createAuditAck)(input),
+        recordMemoryAudit: (input) => (0, api_js_2.recordMemoryAudit)(adapter, input),
+        upsertChannelSummary: (input) => (0, api_js_2.upsertChannelSummary)(adapter, input),
+        getChannelSummary: (channelKey) => (0, api_js_2.getChannelSummary)(adapter, channelKey),
+        listAuditFindings: () => (0, finding_store_js_1.listOpenAuditFindings)(adapter),
+        listOpenAuditFindings: () => (0, finding_store_js_1.listOpenAuditFindings)(adapter),
+        createAuditFinding: (input) => (0, finding_store_js_1.createAuditFinding)(adapter, input),
+        getMemoryProvenance: (memoryId, options) => (0, provenance_query_js_1.getMemoryProvenance)(adapter, memoryId, options),
+        listMemoriesByEnvelopeHash: (envelopeHash, options) => (0, provenance_query_js_1.listMemoriesByEnvelopeHash)(adapter, envelopeHash, options),
+        listMemoriesByGatewayCallId: (gatewayCallId, options) => (0, provenance_query_js_1.listMemoriesByGatewayCallId)(adapter, gatewayCallId, options),
+        listMemoriesByModelRunId: (modelRunId, options) => (0, provenance_query_js_1.listMemoriesByModelRunId)(adapter, modelRunId, options),
+        listMemoryEventsForMemory: (memoryId) => (0, event_store_js_1.listMemoryEventsForMemory)(adapter, memoryId),
+        listRecentMemoryEvents: (limit) => (0, event_store_js_1.listRecentMemoryEvents)(adapter, limit),
+        beginModelRun: (input) => (0, model_run_store_js_1.beginModelRun)(adapter, input),
+        commitModelRun: (modelRunId, summary, tokenCount) => (0, model_run_store_js_1.commitModelRun)(adapter, modelRunId, summary, tokenCount),
+        failModelRun: (modelRunId, errorSummary, tokenCount) => (0, model_run_store_js_1.failModelRun)(adapter, modelRunId, errorSummary, tokenCount),
+        getModelRun: (modelRunId) => (0, model_run_store_js_1.getModelRun)(adapter, modelRunId),
+        listModelRunNativeInputs: async (modelRunId, principalId, options) => (0, model_run_store_js_1.listModelRunNativeInputs)(adapter, modelRunId, principalId, options),
+        appendToolTrace: (input) => (0, tool_trace_store_js_1.appendToolTrace)(adapter, input),
+        listToolTracesForRun: (modelRunId) => (0, tool_trace_store_js_1.listToolTracesForRun)(adapter, modelRunId),
+        listToolTraces: (input) => (0, tool_trace_store_js_1.listToolTraces)(adapter, input),
+        readToolTrace: (traceId, scope) => (0, tool_trace_store_js_1.readToolTrace)(adapter, traceId, scope),
+        saveCheckpoint: (summary, openFiles, nextSteps, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        recentConversation) => (0, api_js_1.saveCheckpointInAdapter)(adapter, summary, openFiles, nextSteps, recentConversation),
+        loadCheckpoint: () => (0, api_js_1.loadCheckpointInAdapter)(adapter),
+        recall: (topic, options) => recallInAdapter(adapter, topic, options),
+        expandWithGraph: (candidates) => (0, api_js_1.expandWithGraphInAdapter)(adapter, candidates),
+    };
+}
 const mama = {
     // Core functions (used by 4 MCP tools)
     save,
-    saveWithTrustedProvenance,
     suggest,
-    saveMemory: api_js_1.saveMemory,
-    saveMemoryWithTrustedProvenance: api_js_1.saveMemoryWithTrustedProvenance,
-    recallMemory: api_js_1.recallMemory,
+    saveMemory,
+    recallMemory,
     list: listDecisions,
     listCheckpoints,
     updateOutcome,
-    buildProfile: api_js_1.buildProfile,
-    ingestMemory: api_js_1.ingestMemory,
-    ingestWithTrustedProvenance: api_js_1.ingestWithTrustedProvenance,
-    ingestConversation: api_js_1.ingestConversation,
-    ingestConversationWithTrustedProvenance: api_js_1.ingestConversationWithTrustedProvenance,
-    evolveMemory: api_js_1.evolveMemory,
-    buildMemoryBootstrap: api_js_1.buildMemoryBootstrap,
-    createAuditAck: api_js_1.createAuditAck,
-    recordMemoryAudit: api_js_1.recordMemoryAudit,
-    upsertChannelSummary: api_js_1.upsertChannelSummary,
-    getChannelSummary: api_js_1.getChannelSummary,
-    listAuditFindings: finding_store_js_1.listOpenAuditFindings,
-    listOpenAuditFindings: finding_store_js_1.listOpenAuditFindings,
-    createAuditFinding: finding_store_js_1.createAuditFinding,
-    getMemoryProvenance: provenance_query_js_1.getMemoryProvenance,
-    listMemoriesByEnvelopeHash: provenance_query_js_1.listMemoriesByEnvelopeHash,
-    listMemoriesByGatewayCallId: provenance_query_js_1.listMemoriesByGatewayCallId,
-    listMemoriesByModelRunId: provenance_query_js_1.listMemoriesByModelRunId,
-    listMemoryEventsForMemory: event_store_js_1.listMemoryEventsForMemory,
-    listRecentMemoryEvents: event_store_js_1.listRecentMemoryEvents,
-    beginModelRun: store_js_1.beginModelRun,
-    beginModelRunInAdapter: store_js_1.beginModelRunInAdapter,
-    commitModelRun: store_js_1.commitModelRun,
-    commitModelRunInAdapter: store_js_1.commitModelRunInAdapter,
-    failModelRun: store_js_1.failModelRun,
-    failModelRunInAdapter: store_js_1.failModelRunInAdapter,
-    getModelRun: store_js_1.getModelRun,
-    getModelRunInAdapter: store_js_1.getModelRunInAdapter,
-    appendToolTrace: tool_trace_store_js_1.appendToolTrace,
-    listToolTracesForRun: tool_trace_store_js_1.listToolTracesForRun,
+    buildProfile,
+    ingestMemory,
+    ingestConversation,
+    evolveMemory: api_js_2.evolveMemory,
+    buildMemoryBootstrap,
+    createAuditAck: api_js_2.createAuditAck,
+    recordMemoryAudit,
+    upsertChannelSummary,
+    getChannelSummary,
+    listAuditFindings: listOpenAuditFindings,
+    listOpenAuditFindings,
+    createAuditFinding,
+    getMemoryProvenance,
+    listMemoriesByEnvelopeHash,
+    listMemoriesByGatewayCallId,
+    listMemoriesByModelRunId,
+    listMemoryEventsForMemory,
+    listRecentMemoryEvents,
+    beginModelRun,
+    commitModelRun,
+    failModelRun,
+    getModelRun,
+    appendToolTrace,
+    listToolTracesForRun,
+    listToolTraces,
+    readToolTrace,
     saveCheckpoint,
     loadCheckpoint,
     // Legacy functions (retained for internal use, not exposed via MCP)
     recall,
-    proposeLink,
-    approveLink,
-    rejectLink,
-    getPendingLinks,
-    deprecateAutoLinks,
-    calculateCoverage,
-    calculateQuality,
-    generateQualityReport,
-    logRestartAttempt,
-    calculateRestartSuccessRate,
-    calculateRestartLatency,
-    getRestartMetrics,
-    scanAutoLinks,
-    createLinkBackup,
-    generatePreCleanupReport,
-    restoreLinkBackup,
-    verifyBackupExists,
-    deleteAutoLinks,
-    validateCleanupResult,
     expandWithGraph,
 };
 // Default export for backward compatibility
 exports.default = mama;
-// CommonJS compatibility - allows require('@jungjaehoon/mama-core/mama-api').save()
+// CommonJS compatibility - require('@jungjaehoon/mama-core/mama-api') exposes the
+// ambient `mama` facade methods at top level. Merge instead of replacing
+// module.exports: the compiled `exports.X = X` named exports (suggestInAdapter,
+// saveCheckpointInAdapter, ...) are how api/catalog.ts reaches them from dist.
+// Getter-only named exports (evolveMemory, createAuditAck) keep their getter —
+// it already returns the same function the facade carries.
 if (typeof module !== 'undefined' && module.exports) {
-    module.exports = mama;
-    module.exports.default = mama;
+    const target = module.exports;
+    for (const [key, value] of Object.entries(mama)) {
+        const descriptor = Object.getOwnPropertyDescriptor(target, key);
+        if (!descriptor || descriptor.writable) {
+            target[key] = value;
+        }
+    }
+    target.default = mama;
+    target.mama = mama;
+    target.createMamaApi = createMamaApi;
 }
 //# sourceMappingURL=mama-api.js.map