@jungjaehoon/mama-core 1.3.3 → 1.4.1

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