@jungjaehoon/mama-core 1.3.3 → 1.4.0

package/dist/db-manager.d.ts

@@ -26,8 +26,9 @@ export interface DatabaseAdapter {
     prepare: (sql: string) => PreparedStatement;
     transaction: <T>(fn: () => T) => T;
     insertEmbedding: (rowid: number, embedding: Float32Array | number[]) => void;
-    vectorSearch: (embedding: Float32Array | number[], limit: number) => Promise<VectorSearchResult[] | null>;
+    vectorSearch: (embedding: Float32Array | number[], limit: number, topicPrefix?: string) => Promise<VectorSearchResult[] | null> | VectorSearchResult[] | null;
     vectorSearchEnabled: boolean;
+    reloadVectorCache?: () => void;
     getDbPath?: () => string;
     dbPath?: string;
     constructor: {
@@ -54,6 +55,8 @@ export interface DecisionRecord {
     created_at: number;
     updated_at?: number;
     edges?: DecisionEdgeRow[];
+    /** ISO 8601 date when the event actually occurred. Null if not set. */
+    event_date?: string | null;
 }
 export interface OutcomeData {
     outcome?: string | null;
@@ -67,6 +70,7 @@ export interface VectorSearchParams {
     limit?: number;
     threshold?: number;
     timeWindow?: number;
+    includeSuperseded?: boolean;
 }
 export interface DecisionEdgeRow {
     from_id: string;
@@ -140,6 +144,12 @@ export declare function getAdapter(): DatabaseAdapter;
  * Call this on process exit
  */
 export declare function closeDB(): Promise<void>;
+export declare function ensureMemoryScope(kind: string, externalId: string): Promise<string>;
+export declare function bindMemoryToScope(memoryId: string, scopeId: string, isPrimary?: boolean): Promise<void>;
+export declare function listScopesForMemory(memoryId: string): Promise<Array<{
+    kind: string;
+    id: string;
+}>>;
 /**
  * Insert embedding into vector search table
  *
@@ -159,7 +169,7 @@ export declare function insertEmbedding(decisionRowid: number, embedding: Float3
  * @param threshold - Minimum similarity threshold (default: 0.7)
  * @returns Array of decisions with similarity scores, or empty array
  */
-export declare function vectorSearch(queryEmbedding: Float32Array | number[], limit?: number, threshold?: number): Promise<DecisionRecord[]>;
+export declare function vectorSearch(queryEmbedding: Float32Array | number[], limit?: number, threshold?: number, topicPrefix?: string): Promise<DecisionRecord[]>;
 /**
  * Decision input for storage
  */
@@ -190,6 +200,8 @@ export interface DecisionInput {
     evidence?: string | null;
     alternatives?: string | null;
     risks?: string | null;
+    /** ISO 8601 date string for when the event actually occurred (e.g. "2023-01-15") */
+    event_date?: string | null;
 }
 /**
  * Insert decision with embedding
@@ -271,4 +283,20 @@ export declare function resetDBState(options?: {
  * Returns true if MAMA_TEST_MODE or VITEST env vars are set
  */
 export declare function isTestMode(): boolean;
+/**
+ * FTS5 keyword search on decisions table.
+ * Returns matching decision IDs with BM25 rank scores.
+ */
+export declare function fts5Search(query: string, limit?: number): Promise<{
+    id: string;
+    rank: number;
+}[]>;
+/**
+ * Re-generate all embeddings using the currently configured model.
+ * Call this after changing the embedding model in config.json.
+ *
+ * @param onProgress - Optional callback with (completed, total) counts
+ * @returns Number of embeddings regenerated
+ */
+export declare function reindexEmbeddings(onProgress?: (completed: number, total: number) => void): Promise<number>;
 //# sourceMappingURL=db-manager.d.ts.map

package/dist/db-manager.js

@@ -26,6 +26,9 @@ exports.initDB = initDB;
 exports.getDB = getDB;
 exports.getAdapter = getAdapter;
 exports.closeDB = closeDB;
+exports.ensureMemoryScope = ensureMemoryScope;
+exports.bindMemoryToScope = bindMemoryToScope;
+exports.listScopesForMemory = listScopesForMemory;
 exports.insertEmbedding = insertEmbedding;
 exports.vectorSearch = vectorSearch;
 exports.insertDecisionWithEmbedding = insertDecisionWithEmbedding;
@@ -37,6 +40,8 @@ exports.getPreparedStmt = getPreparedStmt;
 exports.getDbPath = getDbPath;
 exports.resetDBState = resetDBState;
 exports.isTestMode = isTestMode;
+exports.fts5Search = fts5Search;
+exports.reindexEmbeddings = reindexEmbeddings;
 const path_1 = __importDefault(require("path"));
 const debug_logger_js_1 = require("./debug-logger.js");
 const progress_indicator_js_1 = require("./progress-indicator.js");
@@ -78,6 +83,10 @@ async function initDB() {
             dbConnection = await dbAdapter.connect();
             // Run migrations (includes 012-create-checkpoints-table.sql)
             await dbAdapter.runMigrations(MIGRATIONS_DIR);
+            // Reload vector cache after migrations (new tables/rows may now exist)
+            if (typeof dbAdapter.reloadVectorCache === 'function') {
+                dbAdapter.reloadVectorCache();
+            }
             isInitialized = true;
             (0, debug_logger_js_1.info)(`[db-manager] Database initialized (${dbAdapter.constructor.name})`);
             (0, progress_indicator_js_1.logComplete)('Database ready');
@@ -124,6 +133,9 @@ function getAdapter() {
     }
     return dbAdapter;
 }
+function buildMemoryScopeId(kind, externalId) {
+    return `scope_${kind}_${Buffer.from(externalId).toString('base64url')}`;
+}
 /**
  * Close database connection
  *
@@ -139,6 +151,38 @@ async function closeDB() {
         (0, debug_logger_js_1.info)('[db-manager] Database connection closed');
     }
 }
+async function ensureMemoryScope(kind, externalId) {
+    const adapter = getAdapter();
+    const id = buildMemoryScopeId(kind, externalId);
+    adapter
+        .prepare(`
+        INSERT OR IGNORE INTO memory_scopes (id, kind, external_id)
+        VALUES (?, ?, ?)
+      `)
+        .run(id, kind, externalId);
+    return id;
+}
+async function bindMemoryToScope(memoryId, scopeId, isPrimary = false) {
+    const adapter = getAdapter();
+    adapter
+        .prepare(`
+        INSERT OR REPLACE INTO memory_scope_bindings (memory_id, scope_id, is_primary)
+        VALUES (?, ?, ?)
+      `)
+        .run(memoryId, scopeId, isPrimary ? 1 : 0);
+}
+async function listScopesForMemory(memoryId) {
+    const adapter = getAdapter();
+    return adapter
+        .prepare(`
+        SELECT ms.kind, ms.external_id AS id
+        FROM memory_scope_bindings msb
+        JOIN memory_scopes ms ON ms.id = msb.scope_id
+        WHERE msb.memory_id = ?
+        ORDER BY msb.is_primary DESC, ms.created_at ASC
+      `)
+        .all(memoryId);
+}
 /**
  * Insert embedding into vector search table
  *
@@ -168,11 +212,11 @@ async function insertEmbedding(decisionRowid, embedding) {
  * @param threshold - Minimum similarity threshold (default: 0.7)
  * @returns Array of decisions with similarity scores, or empty array
  */
-async function vectorSearch(queryEmbedding, limit = 5, threshold = 0.7) {
+async function vectorSearch(queryEmbedding, limit = 5, threshold = 0.7, topicPrefix) {
     const adapter = getAdapter();
     try {
-        // Brute-force cosine similarity over all embeddings
-        const results = await adapter.vectorSearch(queryEmbedding, limit * 3);
+        // Brute-force cosine similarity over all embeddings (with optional topic pre-filter)
+        const results = await adapter.vectorSearch(queryEmbedding, limit * 3, topicPrefix);
         if (!results || results.length === 0) {
             return []; // No keyword fallback - fast fail
         }
@@ -216,6 +260,13 @@ async function vectorSearch(queryEmbedding, limit = 5, threshold = 0.7) {
 async function insertDecisionWithEmbedding(decision) {
     const adapter = getAdapter();
     const { generateEnhancedEmbedding } = await import('./embeddings.js');
+    // Validate event_date before any DB operations
+    if (decision.event_date !== null && decision.event_date !== undefined) {
+        const d = decision.event_date;
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(d) || isNaN(new Date(d).getTime())) {
+            throw new Error(`Invalid event_date: must be ISO 8601 YYYY-MM-DD (got: ${d})`);
+        }
+    }
     try {
         // Generate embedding BEFORE transaction (required for SQLite's sync transaction)
         // Note: Redact topic for privacy - only log length
@@ -248,14 +299,14 @@ async function insertDecisionWithEmbedding(decision) {
           confidence, created_at, updated_at,
           needs_validation, validation_attempts, last_validated_at, usage_count,
           trust_context, usage_success, usage_failure, time_saved,
-          evidence, alternatives, risks
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          evidence, alternatives, risks, event_date
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `);
             const insertResult = stmt.run(decision.id, decision.topic, decision.decision, decision.reasoning || null, decision.outcome || null, decision.failure_reason || null, decision.limitation || null, decision.user_involvement || null, decision.session_id || null, decision.supersedes || null, decision.superseded_by || null, decision.refined_from ? JSON.stringify(decision.refined_from) : null, decision.confidence !== undefined ? decision.confidence : 0.5, 
             // IMPORTANT: All timestamps are stored in milliseconds (Date.now()).
             // The schema DEFAULT uses unixepoch() (seconds) but is never used
             // since all inserts go through this function which always provides ms.
-            decision.created_at || Date.now(), decision.updated_at || Date.now(), decision.needs_validation !== undefined ? decision.needs_validation : 0, decision.validation_attempts || 0, decision.last_validated_at || null, decision.usage_count || 0, decision.trust_context || null, decision.usage_success || 0, decision.usage_failure || 0, decision.time_saved || 0, decision.evidence || null, decision.alternatives || null, decision.risks || null);
+            decision.created_at || Date.now(), decision.updated_at || Date.now(), decision.needs_validation !== undefined ? decision.needs_validation : 0, decision.validation_attempts || 0, decision.last_validated_at || null, decision.usage_count || 0, decision.trust_context || null, decision.usage_success || 0, decision.usage_failure || 0, decision.time_saved || 0, decision.evidence || null, decision.alternatives || null, decision.risks || null, decision.event_date || null);
             const rowid = Number(insertResult.lastInsertRowid);
             // Insert embedding in same transaction to ensure rowid matching
             (0, debug_logger_js_1.info)(`[db-manager] Vector search enabled: ${adapter.vectorSearchEnabled}`);
@@ -485,6 +536,10 @@ async function queryVectorSearch(params) {
             if (similarity < threshold) {
                 continue;
             }
+            // Filter out superseded decisions unless explicitly requested
+            if (!params.includeSuperseded && decision.superseded_by) {
+                continue;
+            }
             results.push({
                 ...decision,
                 similarity,
@@ -618,4 +673,74 @@ function resetDBState(options = {}) {
 function isTestMode() {
     return !!(process.env.MAMA_TEST_MODE || process.env.VITEST);
 }
+/**
+ * FTS5 keyword search on decisions table.
+ * Returns matching decision IDs with BM25 rank scores.
+ */
+async function fts5Search(query, limit = 10) {
+    const adapter = getAdapter();
+    // Check if FTS5 table exists (swallow errors — table may not exist yet)
+    let tableCheck;
+    try {
+        tableCheck = adapter
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='decisions_fts'")
+            .get();
+    }
+    catch {
+        return [];
+    }
+    if (!tableCheck)
+        return [];
+    // Query execution — let errors propagate to the caller
+    const stmt = adapter.prepare(`
+    SELECT d.id, rank
+    FROM decisions_fts
+    JOIN decisions d ON decisions_fts.rowid = d.rowid
+    WHERE decisions_fts MATCH ?
+    ORDER BY rank
+    LIMIT ?
+  `);
+    return stmt.all(query, limit);
+}
+/**
+ * Re-generate all embeddings using the currently configured model.
+ * Call this after changing the embedding model in config.json.
+ *
+ * @param onProgress - Optional callback with (completed, total) counts
+ * @returns Number of embeddings regenerated
+ */
+async function reindexEmbeddings(onProgress) {
+    const adapter = getAdapter();
+    const { generateEnhancedEmbedding } = await import('./embeddings.js');
+    const decisions = adapter
+        .prepare('SELECT rowid, topic, decision, reasoning, outcome, confidence FROM decisions')
+        .all();
+    if (typeof adapter.insertEmbedding !== 'function') {
+        throw new Error('Embedding insertion is not available on this adapter');
+    }
+    const total = decisions.length;
+    let completed = 0;
+    for (const row of decisions) {
+        try {
+            const embedding = await generateEnhancedEmbedding({
+                topic: row.topic,
+                decision: row.decision,
+                reasoning: row.reasoning || undefined,
+                outcome: row.outcome || undefined,
+                confidence: row.confidence ?? undefined,
+            });
+            adapter.insertEmbedding(row.rowid, embedding);
+            completed++;
+            if (onProgress && completed % 50 === 0) {
+                onProgress(completed, total);
+            }
+        }
+        catch (e) {
+            (0, debug_logger_js_1.error)(`[db-manager] Failed to reindex rowid ${row.rowid}: ${e}`);
+        }
+    }
+    onProgress?.(completed, total);
+    (0, debug_logger_js_1.info)(`[db-manager] Reindexed ${completed}/${total} embeddings`);
+    return completed;
+}
 //# sourceMappingURL=db-manager.js.map

package/dist/decision-formatter.d.ts

@@ -36,6 +36,8 @@ export interface DecisionForFormat {
     evidence?: string | string[] | unknown;
     alternatives?: string | string[] | unknown;
     risks?: string;
+    /** ISO 8601 date when the event actually occurred. Null if not set. */
+    event_date?: string | null;
 }
 /**
  * Trust context object

package/dist/embedding-server/mobile/session-manager.js

@@ -31,7 +31,7 @@ exports.DEFAULT_DB_PATH = process.env.MAMA_DB_PATH || path_1.default.join(os_1.d
 exports.CREATE_SESSIONS_TABLE = `
   CREATE TABLE IF NOT EXISTS sessions (
     id TEXT PRIMARY KEY,
-    project_dir TEXT NOT NULL,
+    project_path TEXT,
     created_at TEXT DEFAULT (datetime('now')),
     last_active TEXT DEFAULT (datetime('now')),
     status TEXT DEFAULT 'active',
@@ -83,6 +83,21 @@ class SessionManager {
             // Create sessions table if not exists
             this.db.exec(exports.CREATE_SESSIONS_TABLE);
             this.db.exec(CREATE_STATUS_INDEX);
+            // Add missing columns for older databases
+            for (const col of [
+                'pid INTEGER',
+                'client_id TEXT',
+                "status TEXT DEFAULT 'active'",
+                'last_active TEXT',
+                'created_at TEXT',
+            ]) {
+                try {
+                    this.db.exec(`ALTER TABLE sessions ADD COLUMN ${col}`);
+                }
+                catch {
+                    // Column already exists
+                }
+            }
             // Mark any orphaned 'active' sessions as 'terminated'
             // (from previous server crashes)
             this.db
@@ -121,7 +136,7 @@ class SessionManager {
             await daemon.spawn();
             // Insert into database
             const stmt = this.db.prepare(`
-        INSERT INTO sessions (id, project_dir, status, pid)
+        INSERT INTO sessions (id, project_path, status, pid)
         VALUES (?, ?, 'active', ?)
       `);
             stmt.run(sessionId, projectDir, daemon.getPid());
@@ -154,10 +169,10 @@ class SessionManager {
             await this.initDB();
         }
         const stmt = this.db.prepare(`
-      SELECT id, project_dir, started_at, last_active_at, status, pid, client_id
+      SELECT id, project_path, created_at, last_active, status, pid, client_id
       FROM sessions
       WHERE status = 'active'
-      ORDER BY started_at DESC
+      ORDER BY created_at DESC
     `);
         const rows = stmt.all();
         // Enrich with in-memory data
@@ -165,9 +180,9 @@ class SessionManager {
             const memSession = this.sessions.get(row.id);
             return {
                 id: row.id,
-                projectDir: row.project_dir,
-                createdAt: row.started_at,
-                lastActive: row.last_active_at,
+                projectDir: row.project_path ?? '',
+                createdAt: row.created_at,
+                lastActive: row.last_active,
                 status: row.status,
                 pid: row.pid,
                 clientId: row.client_id,

package/dist/index.d.ts

@@ -10,11 +10,15 @@
 export { generateEmbedding, generateEnhancedEmbedding, generateBatchEmbeddings, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, } from './embeddings.js';
 export { EmbeddingCache } from './embedding-cache.js';
 export { getEmbeddingFromServer, getServerStatus, isServerRunning, getServerPort, DEFAULT_PORT, HOST, TIMEOUT_MS, type ServerStatus, } from './embedding-client.js';
-export { initDB, getDB, getAdapter, closeDB, insertEmbedding, vectorSearch, queryVectorSearch, insertDecisionWithEmbedding, queryDecisionGraph, querySemanticEdges, updateDecisionOutcome, getPreparedStmt, getDbPath, type DatabaseAdapter as DBManagerAdapter, type PreparedStatement, type DecisionRecord, type OutcomeData, type VectorSearchParams, type SemanticEdges, type SemanticEdgeItem, type DecisionInput, } from './db-manager.js';
+export { initDB, getDB, getAdapter, closeDB, insertEmbedding, vectorSearch, queryVectorSearch, insertDecisionWithEmbedding, queryDecisionGraph, querySemanticEdges, updateDecisionOutcome, getPreparedStmt, getDbPath, fts5Search, reindexEmbeddings, type DatabaseAdapter as DBManagerAdapter, type PreparedStatement, type DecisionRecord, type OutcomeData, type VectorSearchParams, type SemanticEdges, type SemanticEdgeItem, type DecisionInput, } from './db-manager.js';
 export { createAdapter, DatabaseAdapter, SQLiteAdapter, type AdapterConfig, type Statement, type VectorSearchResult, type RunResult, } from './db-adapter/index.js';
 export { getSessionDecisions, incrementUsageSuccess, incrementUsageFailure, getDecisionById, traverseDecisionChain, DB_PATH, DB_DIR, LEGACY_DB_PATH, DEFAULT_DB_PATH, } from './memory-store.js';
 import mama from './mama-api.js';
 export { mama };
+export { MEMORY_SCOPE_KINDS, MEMORY_KINDS, MEMORY_STATUSES, MEMORY_EDGE_TYPES, createEmptyRecallBundle, type MemoryScopeKind, type MemoryKind, type MemoryStatus, type MemoryEdgeType, type MemoryScopeRef, type MemoryRecord, type MemoryEdge, type ProfileSnapshot, type RecallBundle, type ConversationMessage, type IngestConversationInput, type ExtractedMemoryUnit, type IngestConversationResult, } from './memory/types.js';
+export { saveMemory, recallMemory, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, ingestConversation, setExtractionFn, upsertChannelSummary, getChannelSummary, } from './memory/api.js';
+export { buildExtractionPrompt, parseExtractionResponse } from './memory/extraction-prompt.js';
+export { listRecentMemoryEvents } from './memory/event-store.js';
 export { loadConfig, getModelName, getEmbeddingDim, getCacheDir, updateConfig, getConfigPath, DEFAULT_CONFIG, type MAMAConfig, type ConfigUpdates, } from './config-loader.js';
 export { calculateRelevance, selectTopDecisions, formatTopNContext, testRelevanceScoring, type DecisionWithEmbedding, type QueryContext, type FormattedContext, type TestResult, } from './relevance-scorer.js';
 export { learnDecision, generateDecisionId, getPreviousDecision, createEdge, createSupersedesEdge, markSuperseded, calculateCombinedConfidence, detectRefinement, parseReasoningForRelationships, createEdgesFromReasoning, getSupersededChainDepth, updateConfidence, VALID_EDGE_TYPES, type EdgeType, type DecisionDetection, type ToolExecution, type SessionContext, type LearnDecisionResult, type ParsedRelationship, type EvidenceItem, } from './decision-tracker.js';

package/dist/index.js

@@ -12,9 +12,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.mama = exports.DEFAULT_DB_PATH = exports.LEGACY_DB_PATH = exports.DB_DIR = exports.DB_PATH = exports.traverseDecisionChain = exports.getDecisionById = exports.incrementUsageFailure = exports.incrementUsageSuccess = exports.getSessionDecisions = exports.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = exports.getDbPath = exports.getPreparedStmt = exports.updateDecisionOutcome = exports.querySemanticEdges = exports.queryDecisionGraph = exports.insertDecisionWithEmbedding = exports.queryVectorSearch = exports.vectorSearch = exports.insertEmbedding = exports.closeDB = exports.getAdapter = exports.getDB = exports.initDB = exports.TIMEOUT_MS = exports.HOST = exports.DEFAULT_PORT = exports.getServerPort = exports.isServerRunning = exports.getServerStatus = exports.getEmbeddingFromServer = exports.EmbeddingCache = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
-exports.formatRecall = exports.formatLegacyContext = exports.formatContext = exports.isMAMAError = exports.wrapError = exports.ErrorCodes = exports.TimeoutError = exports.RateLimitError = exports.LinkError = exports.ConfigurationError = exports.EmbeddingError = exports.DatabaseError = exports.ValidationError = exports.NotFoundError = exports.MAMAError = exports.formatTimeAgo = exports.DebugLogger = exports.error = exports.warn = exports.info = exports.debug = exports.logSearching = exports.logLoading = exports.logInfo = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierBanner = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.validateTier = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.getSupersededChainDepth = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.testRelevanceScoring = exports.formatTopNContext = void 0;
-exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.analyzeQueryIntent = exports.analyzeDecision = exports.generate = exports.extractTopicKeywords = exports.analyzeIntent = exports.injectDecisionContext = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = exports.onUserPromptSubmit = exports.markOutcome = exports.getEvidenceImpact = exports.calculateDurationDays = exports.getRecentDecision = exports.extractFailureReason = exports.matchesPartialIndicators = exports.matchesSuccessIndicators = exports.matchesFailureIndicators = exports.analyzeOutcome = exports.extractCodeExample = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = exports.formatInstantAnswer = exports.formatTeaser = exports.formatList = void 0;
+exports.recallMemory = exports.saveMemory = exports.createEmptyRecallBundle = exports.MEMORY_EDGE_TYPES = exports.MEMORY_STATUSES = exports.MEMORY_KINDS = exports.MEMORY_SCOPE_KINDS = exports.mama = exports.DEFAULT_DB_PATH = exports.LEGACY_DB_PATH = exports.DB_DIR = exports.DB_PATH = exports.traverseDecisionChain = exports.getDecisionById = exports.incrementUsageFailure = exports.incrementUsageSuccess = exports.getSessionDecisions = exports.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = exports.reindexEmbeddings = exports.fts5Search = exports.getDbPath = exports.getPreparedStmt = exports.updateDecisionOutcome = exports.querySemanticEdges = exports.queryDecisionGraph = exports.insertDecisionWithEmbedding = exports.queryVectorSearch = exports.vectorSearch = exports.insertEmbedding = exports.closeDB = exports.getAdapter = exports.getDB = exports.initDB = exports.TIMEOUT_MS = exports.HOST = exports.DEFAULT_PORT = exports.getServerPort = exports.isServerRunning = exports.getServerStatus = exports.getEmbeddingFromServer = exports.EmbeddingCache = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
+exports.logLoading = exports.logInfo = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierBanner = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.validateTier = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.getSupersededChainDepth = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.testRelevanceScoring = exports.formatTopNContext = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.listRecentMemoryEvents = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversation = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestMemory = exports.buildProfile = void 0;
+exports.analyzeQueryIntent = exports.analyzeDecision = exports.generate = exports.extractTopicKeywords = exports.analyzeIntent = exports.injectDecisionContext = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = exports.onUserPromptSubmit = exports.markOutcome = exports.getEvidenceImpact = exports.calculateDurationDays = exports.getRecentDecision = exports.extractFailureReason = exports.matchesPartialIndicators = exports.matchesSuccessIndicators = exports.matchesFailureIndicators = exports.analyzeOutcome = exports.extractCodeExample = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = exports.formatInstantAnswer = exports.formatTeaser = exports.formatList = exports.formatRecall = exports.formatLegacyContext = exports.formatContext = exports.isMAMAError = exports.wrapError = exports.ErrorCodes = exports.TimeoutError = exports.RateLimitError = exports.LinkError = exports.ConfigurationError = exports.EmbeddingError = exports.DatabaseError = exports.ValidationError = exports.NotFoundError = exports.MAMAError = exports.formatTimeAgo = exports.DebugLogger = exports.error = exports.warn = exports.info = exports.debug = exports.logSearching = void 0;
+exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = void 0;
 // Embeddings
 var embeddings_js_1 = require("./embeddings.js");
 Object.defineProperty(exports, "generateEmbedding", { enumerable: true, get: function () { return embeddings_js_1.generateEmbedding; } });
@@ -51,6 +52,8 @@ Object.defineProperty(exports, "querySemanticEdges", { enumerable: true, get: fu
 Object.defineProperty(exports, "updateDecisionOutcome", { enumerable: true, get: function () { return db_manager_js_1.updateDecisionOutcome; } });
 Object.defineProperty(exports, "getPreparedStmt", { enumerable: true, get: function () { return db_manager_js_1.getPreparedStmt; } });
 Object.defineProperty(exports, "getDbPath", { enumerable: true, get: function () { return db_manager_js_1.getDbPath; } });
+Object.defineProperty(exports, "fts5Search", { enumerable: true, get: function () { return db_manager_js_1.fts5Search; } });
+Object.defineProperty(exports, "reindexEmbeddings", { enumerable: true, get: function () { return db_manager_js_1.reindexEmbeddings; } });
 // Database adapter
 var index_js_1 = require("./db-adapter/index.js");
 Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return index_js_1.createAdapter; } });
@@ -70,6 +73,31 @@ Object.defineProperty(exports, "DEFAULT_DB_PATH", { enumerable: true, get: funct
 // MAMA API
 const mama_api_js_1 = __importDefault(require("./mama-api.js"));
 exports.mama = mama_api_js_1.default;
+// Memory V2
+var types_js_1 = require("./memory/types.js");
+Object.defineProperty(exports, "MEMORY_SCOPE_KINDS", { enumerable: true, get: function () { return types_js_1.MEMORY_SCOPE_KINDS; } });
+Object.defineProperty(exports, "MEMORY_KINDS", { enumerable: true, get: function () { return types_js_1.MEMORY_KINDS; } });
+Object.defineProperty(exports, "MEMORY_STATUSES", { enumerable: true, get: function () { return types_js_1.MEMORY_STATUSES; } });
+Object.defineProperty(exports, "MEMORY_EDGE_TYPES", { enumerable: true, get: function () { return types_js_1.MEMORY_EDGE_TYPES; } });
+Object.defineProperty(exports, "createEmptyRecallBundle", { enumerable: true, get: function () { return types_js_1.createEmptyRecallBundle; } });
+var api_js_1 = require("./memory/api.js");
+Object.defineProperty(exports, "saveMemory", { enumerable: true, get: function () { return api_js_1.saveMemory; } });
+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, "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, "ingestConversation", { enumerable: true, get: function () { return api_js_1.ingestConversation; } });
+Object.defineProperty(exports, "setExtractionFn", { enumerable: true, get: function () { return api_js_1.setExtractionFn; } });
+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; } });
+var extraction_prompt_js_1 = require("./memory/extraction-prompt.js");
+Object.defineProperty(exports, "buildExtractionPrompt", { enumerable: true, get: function () { return extraction_prompt_js_1.buildExtractionPrompt; } });
+Object.defineProperty(exports, "parseExtractionResponse", { enumerable: true, get: function () { return extraction_prompt_js_1.parseExtractionResponse; } });
+var event_store_js_1 = require("./memory/event-store.js");
+Object.defineProperty(exports, "listRecentMemoryEvents", { enumerable: true, get: function () { return event_store_js_1.listRecentMemoryEvents; } });
 // Config loader
 var config_loader_js_1 = require("./config-loader.js");
 Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_loader_js_1.loadConfig; } });

package/dist/mama-api.d.ts

@@ -19,6 +19,9 @@
  */
 import { DecisionRecord } from './db-manager.js';
 import { SemanticEdges } from './decision-formatter.js';
+import { saveMemory, recallMemory, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary } from './memory/api.js';
+import { listOpenAuditFindings } from './memory/finding-store.js';
+import { listRecentMemoryEvents } from './memory/event-store.js';
 /**
  * Parameters for mama.save()
  */
@@ -32,6 +35,13 @@ interface SaveParams {
     failure_reason?: string | null;
     limitation?: string | null;
     trust_context?: Record<string, unknown> | null;
+    is_static?: number;
+    scopes?: Array<{
+        kind: 'global' | 'user' | 'channel' | 'project';
+        id: string;
+    }>;
+    /** ISO 8601 date string for when the event actually occurred (e.g. "2023-01-15") */
+    event_date?: string | null;
 }
 /**
  * Similar decision result from search
@@ -43,6 +53,7 @@ interface SimilarDecision {
     reasoning?: string;
     similarity?: number;
     created_at?: number | string;
+    event_date?: string | null;
 }
 /**
  * Search result from mama.search()
@@ -394,7 +405,7 @@ export interface QualityReport {
  *   outcome: 'success'
  * });
  */
-declare function save({ topic, decision, reasoning, confidence, type, outcome, failure_reason, limitation, trust_context, }: SaveParams): Promise<SaveResult>;
+declare function save({ topic, decision, reasoning, confidence, type, outcome, failure_reason, limitation, trust_context: _trust_context, is_static, scopes: inputScopes, event_date, }: SaveParams): Promise<SaveResult>;
 /**
  * Recall decisions by topic
  *
@@ -485,6 +496,38 @@ interface UpdateOutcomeParams {
     limitation?: string | null;
 }
 declare function updateOutcome(decisionId: string, { outcome, failure_reason, limitation }: UpdateOutcomeParams): Promise<void>;
+/**
+ * Expand search results with graph context (Phase 1 - Graph-Enhanced Retrieval)
+ *
+ * For each candidate decision:
+ * 1. Add supersedes chain (evolution history)
+ * 2. Add semantic edges (refines, contradicts)
+ * 3. Deduplicate by ID
+ * 4. Re-rank by relevance (primary candidates ranked higher)
+ *
+ * @param {Array} candidates - Initial search results from vector/keyword search
+ * @returns {Promise<Array>} Graph-enhanced results with evolution context
+ */
+interface SearchCandidate {
+    id: string;
+    topic: string;
+    decision: string;
+    reasoning?: string | null;
+    confidence?: number;
+    similarity?: number;
+    created_at?: number | string;
+    graph_source?: string;
+    graph_rank?: number;
+    related_to?: string | null;
+    edge_reason?: string | null;
+    recency_score?: number;
+    recency_age_days?: number;
+    final_score?: number;
+    outcome?: string | null;
+    failure_reason?: string | null;
+    is_static?: number;
+}
+declare function expandWithGraph(candidates: SearchCandidate[]): Promise<SearchCandidate[]>;
 /**
  * Suggest relevant decisions based on user question
  *
@@ -520,6 +563,11 @@ interface SuggestFunctionOptions {
     recencyScale?: number;
     recencyDecay?: number;
     disableRecency?: boolean;
+    topicPrefix?: string;
+    scopes?: Array<{
+        kind: 'global' | 'user' | 'channel' | 'project';
+        id: string;
+    }>;
 }
 declare function suggest(userQuestion: string, options?: SuggestFunctionOptions): Promise<any>;
 /**
@@ -536,6 +584,10 @@ declare function suggest(userQuestion: string, options?: SuggestFunctionOptions)
 interface ListDecisionsOptions {
     limit?: number;
     format?: 'json' | 'markdown';
+    scopes?: Array<{
+        kind: 'global' | 'user' | 'channel' | 'project';
+        id: string;
+    }>;
 }
 declare function listDecisions(options?: ListDecisionsOptions): Promise<DecisionRecord[] | string>;
 /**
@@ -978,9 +1030,21 @@ declare function generateQualityReport(options?: QualityReportOptions): string |
 declare const mama: {
     save: typeof save;
     suggest: typeof suggest;
+    saveMemory: typeof saveMemory;
+    recallMemory: typeof recallMemory;
     list: typeof listDecisions;
     listCheckpoints: typeof listCheckpoints;
     updateOutcome: typeof updateOutcome;
+    buildProfile: typeof buildProfile;
+    ingestMemory: typeof ingestMemory;
+    evolveMemory: typeof evolveMemory;
+    buildMemoryBootstrap: typeof buildMemoryBootstrap;
+    createAuditAck: typeof createAuditAck;
+    recordMemoryAudit: typeof recordMemoryAudit;
+    upsertChannelSummary: typeof upsertChannelSummary;
+    getChannelSummary: typeof getChannelSummary;
+    listAuditFindings: typeof listOpenAuditFindings;
+    listRecentMemoryEvents: typeof listRecentMemoryEvents;
     saveCheckpoint: typeof saveCheckpoint;
     loadCheckpoint: typeof loadCheckpoint;
     recall: typeof recall;
@@ -1003,7 +1067,8 @@ declare const mama: {
     verifyBackupExists: typeof verifyBackupExists;
     deleteAutoLinks: typeof deleteAutoLinks;
     validateCleanupResult: typeof validateCleanupResult;
+    expandWithGraph: typeof expandWithGraph;
 };
-export { save, suggest, listDecisions as list, listCheckpoints, updateOutcome, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, };
+export { save, suggest, saveMemory, recallMemory, listDecisions as list, listCheckpoints, updateOutcome, buildProfile, ingestMemory, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary, listOpenAuditFindings, listRecentMemoryEvents, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, };
 export default mama;
 //# sourceMappingURL=mama-api.d.ts.map