@jungjaehoon/mama-core 1.8.1 → 2.0.0

package/dist/index.d.ts

@@ -7,12 +7,12 @@
  * @module mama-core
  * @version 1.0.0
  */
-export { generateEmbedding, generateEnhancedEmbedding, generateBatchEmbeddings, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, EMBEDDING_PREFIX_SCHEME, type EmbeddingRole, } from './embeddings.js';
+export { generateEmbedding, generateEnhancedEmbedding, cosineSimilarity, embeddingCache, EMBEDDING_DIM, MODEL_NAME, EMBEDDING_PREFIX_SCHEME, type EmbeddingRole, } 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, 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 { 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, fts5Search, 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';
+export { 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 MemorySourceRef, type MemoryRecord, type MemoryWriteProvenance, type MemoryProvenanceRecord, type PublicSaveMemoryInput, type PublicIngestMemoryInput, type PublicIngestConversationInput, type MemorySearchResultHit, type MemoryEdge, type ProfileSnapshot, type RecallBundle, type ConversationMessage, type IngestConversationInput, type ExtractedMemoryUnit, type IngestConversationResult, } from './memory/types.js';
@@ -21,14 +21,14 @@ export { buildExtractionPrompt, parseExtractionResponse } from './memory/extract
 export { appendMemoryEvent, insertMemoryEventInTransaction, listMemoryEventsForMemory, listRecentMemoryEvents, } from './memory/event-store.js';
 export { createTrustedProvenanceCapability, assertTrustedProvenanceCapability, type TrustedProvenanceCapability, type TrustedMemoryWriteOptions, } from './memory/provenance.js';
 export { getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, } from './memory/provenance-query.js';
-export { backfillLegacyMemoryProvenance, backfillConnectorEventScopeMetadata, type BackfillResult, type ConnectorEventScopeBackfillInput, } from './memory/scope-backfill.js';
+export { type BackfillResult, type ConnectorEventScopeBackfillInput, } from './memory/scope-backfill.js';
 export { getMemoryProvenanceAudit, listMemoryProvenanceAudit, type MemoryProvenanceAuditRecord, type MemoryProvenanceAuditListOptions, } from './memory/provenance-audit.js';
 export { MODEL_RUN_STATUSES, type ModelRunStatus, type BeginModelRunInput, type ModelRunRecord, type AppendToolTraceInput, type ToolTraceRecord, } from './model-runs/types.js';
 export { beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, } from './model-runs/store.js';
 export { appendToolTrace, listToolTracesForRun } from './model-runs/tool-trace-store.js';
 export { TWIN_EDGE_SOURCES, TWIN_EDGE_TYPES, TWIN_REF_KINDS, type InsertTwinEdgeInput, type ListVisibleTwinEdgesOptions, type TwinEdgeRecord, type TwinEdgeSource, type TwinEdgeType, type TwinRef, type TwinRefKind, type TwinScopeRef, } from './edges/types.js';
-export { getTwinEdge, insertTwinEdge, listTwinEdgesForRefs, mapTwinEdgeRow, } from './edges/store.js';
-export { assertTwinRefsVisibleToScopes, listVisibleTwinEdgesForRefs, } from './edges/ref-validation.js';
+export { getTwinEdge, listTwinEdgesForRefs, mapTwinEdgeRow } from './edges/store.js';
+export { listVisibleTwinEdgesForRefs } from './edges/ref-validation.js';
 export * from './context-compile/index.js';
 export * from './provenance/source-ref.js';
 export * from './agent-situation/index.js';
@@ -43,48 +43,32 @@ export * from './entities/read-identity.js';
 export * from './entities/audit-metrics.js';
 export * from './entities/provenance-query.js';
 export * from './entities/lineage-store.js';
-export * from './entities/lineage-backfill.js';
-export * from './entities/exact-merge-backfill.js';
 export * from './entities/entity-search.js';
 export * from './entities/entity-list.js';
 export * from './entities/entity-orphan-list.js';
-export * from './entities/entity-impact.js';
 export * from './entities/rollback-preview.js';
 export * from './entities/source-locator.js';
 export * from './entities/policy-types.js';
 export * from './entities/policy-store.js';
 export { canonicalizeJSON, targetRefHash, CanonicalizeError, type CanonicalizeErrorCode, } from './canonicalize.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';
-export { validateTier, checkNodeVersion, checkSQLite, checkEmbeddings, checkDatabase, getTierDescription, getTierBanner, type TierValidation, type CheckResult, type NamedCheckResult, } from './tier-validator.js';
-export { logProgress, logComplete, logFailed, logError, logInfo, logLoading, logSearching, } from './progress-indicator.js';
+export { calculateRelevance, selectTopDecisions, formatTopNContext, type DecisionWithEmbedding, type QueryContext, type FormattedContext, type TestResult, } from './relevance-scorer.js';
+export { learnDecision, generateDecisionId, getPreviousDecision, createEdge, createSupersedesEdge, markSuperseded, calculateCombinedConfidence, detectRefinement, parseReasoningForRelationships, createEdgesFromReasoning, updateConfidence, VALID_EDGE_TYPES, type EdgeType, type DecisionDetection, type ToolExecution, type SessionContext, type LearnDecisionResult, type ParsedRelationship, type EvidenceItem, } from './decision-tracker.js';
+export { checkNodeVersion, checkSQLite, checkEmbeddings, checkDatabase, getTierDescription, type TierValidation, type CheckResult, type NamedCheckResult, } from './tier-validator.js';
+export { logProgress, logComplete, logFailed, logError, logLoading, logSearching, } from './progress-indicator.js';
 export { debug, info, warn, error, DebugLogger } from './debug-logger.js';
 export { formatTimeAgo } from './time-formatter.js';
 export { MAMAError, NotFoundError, ValidationError, DatabaseError, EmbeddingError, ConfigurationError, LinkError, RateLimitError, TimeoutError, ErrorCodes, wrapError, isMAMAError, type ErrorDetails, type ErrorResponse, type ErrorJSON, type ErrorCode, } from './errors.js';
-export { formatContext, formatLegacyContext, formatRecall, formatList, formatTeaser, formatInstantAnswer, formatTrustContext, ensureTokenBudget, estimateTokens, extractQuickAnswer, extractCodeExample, type DecisionForFormat, type TrustContext, type SemanticEdges as FormatterSemanticEdges, type FormatOptions, } from './decision-formatter.js';
-export { analyzeOutcome, matchesFailureIndicators, matchesSuccessIndicators, matchesPartialIndicators, extractFailureReason, getRecentDecision, calculateDurationDays, getEvidenceImpact, markOutcome, onUserPromptSubmit, FAILURE_INDICATORS, SUCCESS_INDICATORS, PARTIAL_INDICATORS, RECENT_WINDOW_MS, type HookContext, type OutcomeType, } from './outcome-tracker.js';
-export { injectDecisionContext } from './memory-inject.js';
-export { analyzeIntent, extractTopicKeywords, type IntentResult, type AnalyzeOptions, } from './query-intent.js';
-export { generate, analyzeDecision, analyzeQueryIntent, isAvailable, listModels, DEFAULT_MODEL, FALLBACK_MODEL, type GenerateOptions, type DecisionAnalysisResult, type QueryIntentResult, } from './ollama-client.js';
+export { formatContext, formatLegacyContext, formatRecall, formatList, formatTrustContext, ensureTokenBudget, estimateTokens, extractQuickAnswer, extractCodeExample, type DecisionForFormat, type TrustContext, type SemanticEdges as FormatterSemanticEdges, type FormatOptions, } from './decision-formatter.js';
+export { analyzeOutcome, matchesFailureIndicators, matchesSuccessIndicators, matchesPartialIndicators, extractFailureReason, getRecentDecision, calculateDurationDays, getEvidenceImpact, markOutcome, FAILURE_INDICATORS, SUCCESS_INDICATORS, PARTIAL_INDICATORS, RECENT_WINDOW_MS, type HookContext, type OutcomeType, } from './outcome-tracker.js';
+export { analyzeIntent, type IntentResult, type AnalyzeOptions } from './query-intent.js';
+export { generate, isAvailable, listModels, DEFAULT_MODEL, FALLBACK_MODEL, type GenerateOptions, type DecisionAnalysisResult, type QueryIntentResult, } from './ollama-client.js';
 export { notifyInsight } from './notification-manager.js';
 export * from './cases/types.js';
 export * from './cases/store.js';
-export * from './cases/role-inference.js';
-export * from './cases/target-ref.js';
-export * from './cases/corrections.js';
-export * from './cases/sqlite-transaction.js';
-export * from './cases/live-state.js';
-export * from './cases/tombstone-sweeper.js';
-export * from './cases/merge-split.js';
-export * from './cases/membership-matcher.js';
 export * from './cases/search-rollup.js';
 export * from './cases/timeline-range.js';
 export * from './cases/wiki-page-index.js';
-export * from './cases/case-links.js';
-export * from './cases/composition-overrides.js';
-export * from './cases/freshness.js';
-export * from './cases/membership-explain.js';
 export * from './connectors/event-index.js';
 export * from './connectors/raw-query.js';
 export * from './connectors/types.js';

package/dist/index.js

@@ -26,14 +26,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-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.EMBEDDING_PREFIX_SCHEME = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateBatchEmbeddings = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
-exports.assertTwinRefsVisibleToScopes = exports.mapTwinEdgeRow = exports.listTwinEdgesForRefs = exports.insertTwinEdge = exports.getTwinEdge = exports.TWIN_REF_KINDS = exports.TWIN_EDGE_TYPES = exports.TWIN_EDGE_SOURCES = exports.listToolTracesForRun = exports.appendToolTrace = exports.getModelRunInAdapter = exports.getModelRun = exports.failModelRunInAdapter = exports.failModelRun = exports.commitModelRunInAdapter = exports.commitModelRun = exports.beginModelRunInAdapter = exports.beginModelRun = exports.MODEL_RUN_STATUSES = exports.listMemoryProvenanceAudit = exports.getMemoryProvenanceAudit = exports.backfillConnectorEventScopeMetadata = exports.backfillLegacyMemoryProvenance = exports.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.assertTrustedProvenanceCapability = exports.createTrustedProvenanceCapability = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = exports.insertMemoryEventInTransaction = exports.appendMemoryEvent = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestWithTrustedProvenance = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.promoteMemoryStatus = exports.saveMemoryWithTrustedProvenance = void 0;
-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 = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.CanonicalizeError = exports.targetRefHash = exports.canonicalizeJSON = exports.listVisibleTwinEdgesForRefs = 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 = 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 = void 0;
+exports.createAuditAck = exports.buildMemoryBootstrap = exports.evolveMemory = exports.ingestWithTrustedProvenance = exports.ingestMemory = exports.buildProfile = exports.recallMemory = exports.promoteMemoryStatus = exports.saveMemoryWithTrustedProvenance = 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.SQLiteAdapter = exports.DatabaseAdapter = exports.createAdapter = 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.EmbeddingCache = exports.EMBEDDING_PREFIX_SCHEME = exports.MODEL_NAME = exports.EMBEDDING_DIM = exports.embeddingCache = exports.cosineSimilarity = exports.generateEnhancedEmbedding = exports.generateEmbedding = void 0;
+exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = exports.getConfigPath = exports.updateConfig = exports.getCacheDir = exports.getEmbeddingDim = exports.getModelName = exports.loadConfig = exports.CanonicalizeError = exports.targetRefHash = exports.canonicalizeJSON = exports.listVisibleTwinEdgesForRefs = exports.mapTwinEdgeRow = exports.listTwinEdgesForRefs = exports.getTwinEdge = exports.TWIN_REF_KINDS = exports.TWIN_EDGE_TYPES = exports.TWIN_EDGE_SOURCES = exports.listToolTracesForRun = exports.appendToolTrace = exports.getModelRunInAdapter = exports.getModelRun = exports.failModelRunInAdapter = exports.failModelRun = exports.commitModelRunInAdapter = exports.commitModelRun = exports.beginModelRunInAdapter = exports.beginModelRun = exports.MODEL_RUN_STATUSES = exports.listMemoryProvenanceAudit = exports.getMemoryProvenanceAudit = exports.listMemoriesByModelRunId = exports.listMemoriesByGatewayCallId = exports.listMemoriesByEnvelopeHash = exports.getMemoryProvenance = exports.assertTrustedProvenanceCapability = exports.createTrustedProvenanceCapability = exports.listRecentMemoryEvents = exports.listMemoryEventsForMemory = exports.insertMemoryEventInTransaction = exports.appendMemoryEvent = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = void 0;
+exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = exports.formatTrustContext = 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 = exports.logLoading = exports.logError = exports.logFailed = exports.logComplete = exports.logProgress = exports.getTierDescription = exports.checkDatabase = exports.checkEmbeddings = exports.checkSQLite = exports.checkNodeVersion = exports.VALID_EDGE_TYPES = exports.updateConfidence = exports.createEdgesFromReasoning = exports.parseReasoningForRelationships = exports.detectRefinement = exports.calculateCombinedConfidence = exports.markSuperseded = exports.createSupersedesEdge = exports.createEdge = exports.getPreviousDecision = exports.generateDecisionId = exports.learnDecision = exports.formatTopNContext = void 0;
+exports.notifyInsight = exports.FALLBACK_MODEL = exports.DEFAULT_MODEL = exports.listModels = exports.isAvailable = exports.generate = exports.analyzeIntent = exports.RECENT_WINDOW_MS = exports.PARTIAL_INDICATORS = exports.SUCCESS_INDICATORS = exports.FAILURE_INDICATORS = exports.markOutcome = exports.getEvidenceImpact = exports.calculateDurationDays = exports.getRecentDecision = exports.extractFailureReason = exports.matchesPartialIndicators = exports.matchesSuccessIndicators = exports.matchesFailureIndicators = exports.analyzeOutcome = exports.extractCodeExample = void 0;
 var embeddings_js_1 = require("./embeddings.js");
 Object.defineProperty(exports, "generateEmbedding", { enumerable: true, get: function () { return embeddings_js_1.generateEmbedding; } });
 Object.defineProperty(exports, "generateEnhancedEmbedding", { enumerable: true, get: function () { return embeddings_js_1.generateEnhancedEmbedding; } });
-Object.defineProperty(exports, "generateBatchEmbeddings", { enumerable: true, get: function () { return embeddings_js_1.generateBatchEmbeddings; } });
 Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return embeddings_js_1.cosineSimilarity; } });
 Object.defineProperty(exports, "embeddingCache", { enumerable: true, get: function () { return embeddings_js_1.embeddingCache; } });
 Object.defineProperty(exports, "EMBEDDING_DIM", { enumerable: true, get: function () { return embeddings_js_1.EMBEDDING_DIM; } });
@@ -42,9 +41,6 @@ Object.defineProperty(exports, "EMBEDDING_PREFIX_SCHEME", { enumerable: true, ge
 var embedding_cache_js_1 = require("./embedding-cache.js");
 Object.defineProperty(exports, "EmbeddingCache", { enumerable: true, get: function () { return embedding_cache_js_1.EmbeddingCache; } });
 var embedding_client_js_1 = require("./embedding-client.js");
-Object.defineProperty(exports, "getEmbeddingFromServer", { enumerable: true, get: function () { return embedding_client_js_1.getEmbeddingFromServer; } });
-Object.defineProperty(exports, "getServerStatus", { enumerable: true, get: function () { return embedding_client_js_1.getServerStatus; } });
-Object.defineProperty(exports, "isServerRunning", { enumerable: true, get: function () { return embedding_client_js_1.isServerRunning; } });
 Object.defineProperty(exports, "getServerPort", { enumerable: true, get: function () { return embedding_client_js_1.getServerPort; } });
 Object.defineProperty(exports, "DEFAULT_PORT", { enumerable: true, get: function () { return embedding_client_js_1.DEFAULT_PORT; } });
 Object.defineProperty(exports, "HOST", { enumerable: true, get: function () { return embedding_client_js_1.HOST; } });
@@ -64,16 +60,11 @@ Object.defineProperty(exports, "updateDecisionOutcome", { enumerable: true, get:
 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; } });
 var index_js_1 = require("./db-adapter/index.js");
 Object.defineProperty(exports, "createAdapter", { enumerable: true, get: function () { return index_js_1.createAdapter; } });
 Object.defineProperty(exports, "DatabaseAdapter", { enumerable: true, get: function () { return index_js_1.DatabaseAdapter; } });
 Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return index_js_1.SQLiteAdapter; } });
 var memory_store_js_1 = require("./memory-store.js");
-Object.defineProperty(exports, "getSessionDecisions", { enumerable: true, get: function () { return memory_store_js_1.getSessionDecisions; } });
-Object.defineProperty(exports, "incrementUsageSuccess", { enumerable: true, get: function () { return memory_store_js_1.incrementUsageSuccess; } });
-Object.defineProperty(exports, "incrementUsageFailure", { enumerable: true, get: function () { return memory_store_js_1.incrementUsageFailure; } });
-Object.defineProperty(exports, "getDecisionById", { enumerable: true, get: function () { return memory_store_js_1.getDecisionById; } });
 Object.defineProperty(exports, "traverseDecisionChain", { enumerable: true, get: function () { return memory_store_js_1.traverseDecisionChain; } });
 Object.defineProperty(exports, "DB_PATH", { enumerable: true, get: function () { return memory_store_js_1.DB_PATH; } });
 Object.defineProperty(exports, "DB_DIR", { enumerable: true, get: function () { return memory_store_js_1.DB_DIR; } });
@@ -120,9 +111,6 @@ Object.defineProperty(exports, "getMemoryProvenance", { enumerable: true, get: f
 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; } });
-var scope_backfill_js_1 = require("./memory/scope-backfill.js");
-Object.defineProperty(exports, "backfillLegacyMemoryProvenance", { enumerable: true, get: function () { return scope_backfill_js_1.backfillLegacyMemoryProvenance; } });
-Object.defineProperty(exports, "backfillConnectorEventScopeMetadata", { enumerable: true, get: function () { return scope_backfill_js_1.backfillConnectorEventScopeMetadata; } });
 var provenance_audit_js_1 = require("./memory/provenance-audit.js");
 Object.defineProperty(exports, "getMemoryProvenanceAudit", { enumerable: true, get: function () { return provenance_audit_js_1.getMemoryProvenanceAudit; } });
 Object.defineProperty(exports, "listMemoryProvenanceAudit", { enumerable: true, get: function () { return provenance_audit_js_1.listMemoryProvenanceAudit; } });
@@ -146,11 +134,9 @@ Object.defineProperty(exports, "TWIN_EDGE_TYPES", { enumerable: true, get: funct
 Object.defineProperty(exports, "TWIN_REF_KINDS", { enumerable: true, get: function () { return types_js_3.TWIN_REF_KINDS; } });
 var store_js_2 = require("./edges/store.js");
 Object.defineProperty(exports, "getTwinEdge", { enumerable: true, get: function () { return store_js_2.getTwinEdge; } });
-Object.defineProperty(exports, "insertTwinEdge", { enumerable: true, get: function () { return store_js_2.insertTwinEdge; } });
 Object.defineProperty(exports, "listTwinEdgesForRefs", { enumerable: true, get: function () { return store_js_2.listTwinEdgesForRefs; } });
 Object.defineProperty(exports, "mapTwinEdgeRow", { enumerable: true, get: function () { return store_js_2.mapTwinEdgeRow; } });
 var ref_validation_js_1 = require("./edges/ref-validation.js");
-Object.defineProperty(exports, "assertTwinRefsVisibleToScopes", { enumerable: true, get: function () { return ref_validation_js_1.assertTwinRefsVisibleToScopes; } });
 Object.defineProperty(exports, "listVisibleTwinEdgesForRefs", { enumerable: true, get: function () { return ref_validation_js_1.listVisibleTwinEdgesForRefs; } });
 __exportStar(require("./context-compile/index.js"), exports);
 __exportStar(require("./provenance/source-ref.js"), exports);
@@ -166,12 +152,9 @@ __exportStar(require("./entities/read-identity.js"), exports);
 __exportStar(require("./entities/audit-metrics.js"), exports);
 __exportStar(require("./entities/provenance-query.js"), exports);
 __exportStar(require("./entities/lineage-store.js"), exports);
-__exportStar(require("./entities/lineage-backfill.js"), exports);
-__exportStar(require("./entities/exact-merge-backfill.js"), exports);
 __exportStar(require("./entities/entity-search.js"), exports);
 __exportStar(require("./entities/entity-list.js"), exports);
 __exportStar(require("./entities/entity-orphan-list.js"), exports);
-__exportStar(require("./entities/entity-impact.js"), exports);
 __exportStar(require("./entities/rollback-preview.js"), exports);
 __exportStar(require("./entities/source-locator.js"), exports);
 __exportStar(require("./entities/policy-types.js"), exports);
@@ -192,7 +175,6 @@ var relevance_scorer_js_1 = require("./relevance-scorer.js");
 Object.defineProperty(exports, "calculateRelevance", { enumerable: true, get: function () { return relevance_scorer_js_1.calculateRelevance; } });
 Object.defineProperty(exports, "selectTopDecisions", { enumerable: true, get: function () { return relevance_scorer_js_1.selectTopDecisions; } });
 Object.defineProperty(exports, "formatTopNContext", { enumerable: true, get: function () { return relevance_scorer_js_1.formatTopNContext; } });
-Object.defineProperty(exports, "testRelevanceScoring", { enumerable: true, get: function () { return relevance_scorer_js_1.testRelevanceScoring; } });
 var decision_tracker_js_1 = require("./decision-tracker.js");
 Object.defineProperty(exports, "learnDecision", { enumerable: true, get: function () { return decision_tracker_js_1.learnDecision; } });
 Object.defineProperty(exports, "generateDecisionId", { enumerable: true, get: function () { return decision_tracker_js_1.generateDecisionId; } });
@@ -204,23 +186,19 @@ Object.defineProperty(exports, "calculateCombinedConfidence", { enumerable: true
 Object.defineProperty(exports, "detectRefinement", { enumerable: true, get: function () { return decision_tracker_js_1.detectRefinement; } });
 Object.defineProperty(exports, "parseReasoningForRelationships", { enumerable: true, get: function () { return decision_tracker_js_1.parseReasoningForRelationships; } });
 Object.defineProperty(exports, "createEdgesFromReasoning", { enumerable: true, get: function () { return decision_tracker_js_1.createEdgesFromReasoning; } });
-Object.defineProperty(exports, "getSupersededChainDepth", { enumerable: true, get: function () { return decision_tracker_js_1.getSupersededChainDepth; } });
 Object.defineProperty(exports, "updateConfidence", { enumerable: true, get: function () { return decision_tracker_js_1.updateConfidence; } });
 Object.defineProperty(exports, "VALID_EDGE_TYPES", { enumerable: true, get: function () { return decision_tracker_js_1.VALID_EDGE_TYPES; } });
 var tier_validator_js_1 = require("./tier-validator.js");
-Object.defineProperty(exports, "validateTier", { enumerable: true, get: function () { return tier_validator_js_1.validateTier; } });
 Object.defineProperty(exports, "checkNodeVersion", { enumerable: true, get: function () { return tier_validator_js_1.checkNodeVersion; } });
 Object.defineProperty(exports, "checkSQLite", { enumerable: true, get: function () { return tier_validator_js_1.checkSQLite; } });
 Object.defineProperty(exports, "checkEmbeddings", { enumerable: true, get: function () { return tier_validator_js_1.checkEmbeddings; } });
 Object.defineProperty(exports, "checkDatabase", { enumerable: true, get: function () { return tier_validator_js_1.checkDatabase; } });
 Object.defineProperty(exports, "getTierDescription", { enumerable: true, get: function () { return tier_validator_js_1.getTierDescription; } });
-Object.defineProperty(exports, "getTierBanner", { enumerable: true, get: function () { return tier_validator_js_1.getTierBanner; } });
 var progress_indicator_js_1 = require("./progress-indicator.js");
 Object.defineProperty(exports, "logProgress", { enumerable: true, get: function () { return progress_indicator_js_1.logProgress; } });
 Object.defineProperty(exports, "logComplete", { enumerable: true, get: function () { return progress_indicator_js_1.logComplete; } });
 Object.defineProperty(exports, "logFailed", { enumerable: true, get: function () { return progress_indicator_js_1.logFailed; } });
 Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return progress_indicator_js_1.logError; } });
-Object.defineProperty(exports, "logInfo", { enumerable: true, get: function () { return progress_indicator_js_1.logInfo; } });
 Object.defineProperty(exports, "logLoading", { enumerable: true, get: function () { return progress_indicator_js_1.logLoading; } });
 Object.defineProperty(exports, "logSearching", { enumerable: true, get: function () { return progress_indicator_js_1.logSearching; } });
 var debug_logger_js_1 = require("./debug-logger.js");
@@ -249,8 +227,6 @@ Object.defineProperty(exports, "formatContext", { enumerable: true, get: functio
 Object.defineProperty(exports, "formatLegacyContext", { enumerable: true, get: function () { return decision_formatter_js_1.formatLegacyContext; } });
 Object.defineProperty(exports, "formatRecall", { enumerable: true, get: function () { return decision_formatter_js_1.formatRecall; } });
 Object.defineProperty(exports, "formatList", { enumerable: true, get: function () { return decision_formatter_js_1.formatList; } });
-Object.defineProperty(exports, "formatTeaser", { enumerable: true, get: function () { return decision_formatter_js_1.formatTeaser; } });
-Object.defineProperty(exports, "formatInstantAnswer", { enumerable: true, get: function () { return decision_formatter_js_1.formatInstantAnswer; } });
 Object.defineProperty(exports, "formatTrustContext", { enumerable: true, get: function () { return decision_formatter_js_1.formatTrustContext; } });
 Object.defineProperty(exports, "ensureTokenBudget", { enumerable: true, get: function () { return decision_formatter_js_1.ensureTokenBudget; } });
 Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return decision_formatter_js_1.estimateTokens; } });
@@ -266,20 +242,14 @@ Object.defineProperty(exports, "getRecentDecision", { enumerable: true, get: fun
 Object.defineProperty(exports, "calculateDurationDays", { enumerable: true, get: function () { return outcome_tracker_js_1.calculateDurationDays; } });
 Object.defineProperty(exports, "getEvidenceImpact", { enumerable: true, get: function () { return outcome_tracker_js_1.getEvidenceImpact; } });
 Object.defineProperty(exports, "markOutcome", { enumerable: true, get: function () { return outcome_tracker_js_1.markOutcome; } });
-Object.defineProperty(exports, "onUserPromptSubmit", { enumerable: true, get: function () { return outcome_tracker_js_1.onUserPromptSubmit; } });
 Object.defineProperty(exports, "FAILURE_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.FAILURE_INDICATORS; } });
 Object.defineProperty(exports, "SUCCESS_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.SUCCESS_INDICATORS; } });
 Object.defineProperty(exports, "PARTIAL_INDICATORS", { enumerable: true, get: function () { return outcome_tracker_js_1.PARTIAL_INDICATORS; } });
 Object.defineProperty(exports, "RECENT_WINDOW_MS", { enumerable: true, get: function () { return outcome_tracker_js_1.RECENT_WINDOW_MS; } });
-var memory_inject_js_1 = require("./memory-inject.js");
-Object.defineProperty(exports, "injectDecisionContext", { enumerable: true, get: function () { return memory_inject_js_1.injectDecisionContext; } });
 var query_intent_js_1 = require("./query-intent.js");
 Object.defineProperty(exports, "analyzeIntent", { enumerable: true, get: function () { return query_intent_js_1.analyzeIntent; } });
-Object.defineProperty(exports, "extractTopicKeywords", { enumerable: true, get: function () { return query_intent_js_1.extractTopicKeywords; } });
 var ollama_client_js_1 = require("./ollama-client.js");
 Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return ollama_client_js_1.generate; } });
-Object.defineProperty(exports, "analyzeDecision", { enumerable: true, get: function () { return ollama_client_js_1.analyzeDecision; } });
-Object.defineProperty(exports, "analyzeQueryIntent", { enumerable: true, get: function () { return ollama_client_js_1.analyzeQueryIntent; } });
 Object.defineProperty(exports, "isAvailable", { enumerable: true, get: function () { return ollama_client_js_1.isAvailable; } });
 Object.defineProperty(exports, "listModels", { enumerable: true, get: function () { return ollama_client_js_1.listModels; } });
 Object.defineProperty(exports, "DEFAULT_MODEL", { enumerable: true, get: function () { return ollama_client_js_1.DEFAULT_MODEL; } });
@@ -288,21 +258,9 @@ var notification_manager_js_1 = require("./notification-manager.js");
 Object.defineProperty(exports, "notifyInsight", { enumerable: true, get: function () { return notification_manager_js_1.notifyInsight; } });
 __exportStar(require("./cases/types.js"), exports);
 __exportStar(require("./cases/store.js"), exports);
-__exportStar(require("./cases/role-inference.js"), exports);
-__exportStar(require("./cases/target-ref.js"), exports);
-__exportStar(require("./cases/corrections.js"), exports);
-__exportStar(require("./cases/sqlite-transaction.js"), exports);
-__exportStar(require("./cases/live-state.js"), exports);
-__exportStar(require("./cases/tombstone-sweeper.js"), exports);
-__exportStar(require("./cases/merge-split.js"), exports);
-__exportStar(require("./cases/membership-matcher.js"), exports);
 __exportStar(require("./cases/search-rollup.js"), exports);
 __exportStar(require("./cases/timeline-range.js"), exports);
 __exportStar(require("./cases/wiki-page-index.js"), exports);
-__exportStar(require("./cases/case-links.js"), exports);
-__exportStar(require("./cases/composition-overrides.js"), exports);
-__exportStar(require("./cases/freshness.js"), exports);
-__exportStar(require("./cases/membership-explain.js"), exports);
 __exportStar(require("./connectors/event-index.js"), exports);
 __exportStar(require("./connectors/raw-query.js"), exports);
 __exportStar(require("./connectors/types.js"), exports);

package/dist/mama-api.d.ts

@@ -567,6 +567,24 @@ interface SuggestFunctionOptions extends SearchQualityOptions {
 }
 declare function save(params: SaveParams): Promise<SaveResult>;
 declare function saveWithTrustedProvenance(params: SaveParams, options: TrustedMemoryWriteOptions): Promise<SaveResult>;
+/**
+ * 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.
+ */
+declare function annotateTopicCurrency<T extends {
+    id?: unknown;
+    topic?: unknown;
+}>(rows: T[], scopes?: Array<{
+    kind: string;
+    id: string;
+}>): Array<T & {
+    superseded_by_newer?: boolean;
+}>;
 declare function suggest(userQuestion: string, options?: SuggestFunctionOptions): Promise<any>;
 /**
  * List recent decisions (all topics, chronological)
@@ -1087,6 +1105,6 @@ declare const mama: {
     validateCleanupResult: typeof validateCleanupResult;
     expandWithGraph: typeof expandWithGraph;
 };
-export { save, saveWithTrustedProvenance, suggest, saveMemory, saveMemoryWithTrustedProvenance, recallMemory, listDecisions as list, listCheckpoints, updateOutcome, buildProfile, ingestMemory, ingestWithTrustedProvenance, ingestConversation, ingestConversationWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary, listOpenAuditFindings, getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, listMemoryEventsForMemory, listRecentMemoryEvents, beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, appendToolTrace, listToolTracesForRun, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, expandWithGraph, };
+export { save, saveWithTrustedProvenance, suggest, annotateTopicCurrency, saveMemory, saveMemoryWithTrustedProvenance, recallMemory, listDecisions as list, listCheckpoints, updateOutcome, buildProfile, ingestMemory, ingestWithTrustedProvenance, ingestConversation, ingestConversationWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, upsertChannelSummary, getChannelSummary, listOpenAuditFindings, getMemoryProvenance, listMemoriesByEnvelopeHash, listMemoriesByGatewayCallId, listMemoriesByModelRunId, listMemoryEventsForMemory, listRecentMemoryEvents, beginModelRun, beginModelRunInAdapter, commitModelRun, commitModelRunInAdapter, failModelRun, failModelRunInAdapter, getModelRun, getModelRunInAdapter, appendToolTrace, listToolTracesForRun, saveCheckpoint, loadCheckpoint, recall, proposeLink, approveLink, rejectLink, getPendingLinks, deprecateAutoLinks, calculateCoverage, calculateQuality, generateQualityReport, logRestartAttempt, calculateRestartSuccessRate, calculateRestartLatency, getRestartMetrics, scanAutoLinks, createLinkBackup, generatePreCleanupReport, restoreLinkBackup, verifyBackupExists, deleteAutoLinks, validateCleanupResult, expandWithGraph, };
 export default mama;
 //# sourceMappingURL=mama-api.d.ts.map

package/dist/mama-api.js

@@ -26,6 +26,7 @@ exports.listToolTracesForRun = exports.appendToolTrace = exports.getModelRunInAd
 exports.save = save;
 exports.saveWithTrustedProvenance = saveWithTrustedProvenance;
 exports.suggest = suggest;
+exports.annotateTopicCurrency = annotateTopicCurrency;
 exports.list = listDecisions;
 exports.listCheckpoints = listCheckpoints;
 exports.updateOutcome = updateOutcome;
@@ -847,6 +848,100 @@ async function save(params) {
 async function saveWithTrustedProvenance(params, options) {
     return saveInternal(params, 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;
+    }
+}
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 async function suggest(userQuestion, options = {}) {
     if (!userQuestion || typeof userQuestion !== 'string') {
@@ -1000,7 +1095,7 @@ async function suggest(userQuestion, options = {}) {
             }
             return {
                 query: userQuestion,
-                results: limitedResults,
+                results: annotateTopicCurrency(limitedResults, options.scopes),
                 ...diagnosticsResponse,
                 meta: {
                     count: limitedResults.length,
@@ -1064,7 +1159,7 @@ async function suggest(userQuestion, options = {}) {
             }
             return {
                 query: userQuestion,
-                results: limitedRows,
+                results: annotateTopicCurrency(limitedRows, options.scopes),
                 ...diagnosticsResponse,
                 meta: {
                     count: limitedRows.length,

package/dist/memory/api.d.ts

@@ -15,8 +15,17 @@ export interface FusedHit {
     case_id?: string | null;
     retrieval_diagnostics?: SearchHitDiagnostics;
 }
+export declare function buildDecisionId(topic: string): string;
 export declare const LEXICAL_STOPWORDS: Set<string>;
 export declare function getLexicalQueryTokens(query: string): string[];
+/**
+ * Boost for how strongly a query matches a record's TOPIC (identity field).
+ * Scaled to dominate normalized BM25 scores (0-1 range): a query whose every
+ * token hits the topic is topic-anchored and must outrank body-text matches
+ * (delta-bench: before this, a topic string failed to surface its own rows in
+ * top-5 for 42.5% of chains - present in the candidate pool, buried by rank).
+ */
+export declare function topicAffinityBoost(topic: string, tokens: string[], normalizedQuery: string): number;
 export declare function loadEdgesForIds(ids: string[]): Promise<MemoryEdge[]>;
 type SaveMemoryResult = {
     success: boolean;

package/dist/memory/api.js

@@ -4,7 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getChannelSummary = exports.upsertChannelSummary = exports.LEXICAL_STOPWORDS = void 0;
+exports.buildDecisionId = buildDecisionId;
 exports.getLexicalQueryTokens = getLexicalQueryTokens;
+exports.topicAffinityBoost = topicAffinityBoost;
 exports.loadEdgesForIds = loadEdgesForIds;
 exports.saveMemory = saveMemory;
 exports.saveMemoryWithTrustedProvenance = saveMemoryWithTrustedProvenance;
@@ -41,8 +43,18 @@ const search_quality_js_1 = require("../search/search-quality.js");
 const event_store_js_1 = require("./event-store.js");
 const provenance_js_1 = require("./provenance.js");
 function buildDecisionId(topic) {
-    const safeTopic = topic.replace(/[^a-z0-9_]+/gi, '_').toLowerCase();
-    return `decision_${safeTopic}_${Date.now()}_${node_crypto_1.default.randomUUID().slice(0, 8)}`;
+    // Non-ASCII topics (Korean etc.) used to collapse into bare underscore runs
+    // ("decision_______<ts>") - unreadable and near-colliding. Collapse the runs
+    // and fall back to a stable topic hash when nothing ASCII survives; the
+    // human-readable topic itself is stored verbatim in the topic column.
+    const safeTopic = topic
+        .replace(/[^a-z0-9_]+/gi, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .toLowerCase();
+    // sha256 (not sha1) purely to keep SAST scanners quiet - this is an id slug, not crypto.
+    const slug = safeTopic || `t${node_crypto_1.default.createHash('sha256').update(topic).digest('hex').slice(0, 8)}`;
+    return `decision_${slug}_${Date.now()}_${node_crypto_1.default.randomUUID().slice(0, 8)}`;
 }
 function buildSaveEventReason(toolName, gatewayCallId) {
     const parts = ['saved'];
@@ -334,6 +346,33 @@ function looksMixedKoreanEnglish(query) {
 function looksEntityLike(query) {
     return /\b[A-Z][A-Za-z0-9_-]{2,}\b/.test(query) || /[#/][A-Za-z0-9_-]{2,}/.test(query);
 }
+/**
+ * Boost for how strongly a query matches a record's TOPIC (identity field).
+ * Scaled to dominate normalized BM25 scores (0-1 range): a query whose every
+ * token hits the topic is topic-anchored and must outrank body-text matches
+ * (delta-bench: before this, a topic string failed to surface its own rows in
+ * top-5 for 42.5% of chains - present in the candidate pool, buried by rank).
+ */
+function topicAffinityBoost(topic, tokens, normalizedQuery) {
+    if (tokens.length === 0) {
+        return 0;
+    }
+    const topicText = topic.toLowerCase().replace(/_/g, ' ');
+    // Word-boundary matching (exact word or stem-prefix), not raw substring:
+    // "sent" must not match inside "consent" - a spurious all-tokens match would
+    // vault an unrelated topic over the whole BM25 range.
+    const topicWords = topicText.split(' ');
+    let topicMatches = 0;
+    for (const token of tokens) {
+        const stem = stemToken(token);
+        if (topicWords.some((word) => word === token || word.startsWith(stem))) {
+            topicMatches += 1;
+        }
+    }
+    const allTokensInTopic = topicMatches === tokens.length;
+    const exact = topicText === normalizedQuery;
+    return (exact ? 1 : 0) + (allTokensInTopic ? 2 : 0) + (topicMatches / tokens.length) * 0.5;
+}
 function buildLexicalCandidates(records, query) {
     const tokens = getLexicalQueryTokens(query);
     const normalizedQuery = query.toLowerCase();
@@ -354,7 +393,11 @@ function buildLexicalCandidates(records, query) {
             return count + 1;
         }, 0);
         const phraseBoost = haystack.includes(normalizedQuery) ? 2 : 0;
-        const score = tokenMatches + phraseBoost;
+        // Topic is the identity field: a hit there must outweigh a hit buried in
+        // a long decision text. Scale the shared 0-1 affinity boost up to this
+        // scorer's integer range so a full topic match dominates.
+        const topicBoost = topicAffinityBoost(record.topic, tokens, normalizedQuery) * 5;
+        const score = tokenMatches + phraseBoost + topicBoost;
         return { memory: record, score };
     })
         .filter((candidate) => candidate.score > 0)
@@ -1049,6 +1092,19 @@ async function recallMemory(query, options = {}) {
         catch {
             // FTS5 not available — fall through to in-memory lexical
         }
+        // Topic-affinity rescore for FTS5 candidates: the OR-joined FTS query
+        // floods the pool with body-text matches and plain BM25 buries rows whose
+        // TOPIC matches the query (observed: target row present at rank 26/50 in
+        // the pool, cut by the limit-5 slice). RRF consumes this array's ORDER,
+        // so rescoring must happen before fusion.
+        if (lexicalCandidates.length > 0) {
+            const boostTokens = getLexicalQueryTokens(query);
+            const boostQuery = query.toLowerCase();
+            for (const candidate of lexicalCandidates) {
+                candidate.score += topicAffinityBoost(candidate.memory.topic, boostTokens, boostQuery);
+            }
+            lexicalCandidates.sort((left, right) => right.score - left.score);
+        }
         // Fallback: in-memory lexical if FTS5 returned nothing
         if (lexicalCandidates.length === 0) {
             let lexicalRecords = await loadLexical();
@@ -1648,13 +1704,21 @@ async function recallMemory(query, options = {}) {
                 ];
             });
             diagnostics.candidate_counts.graph_expanded = bundle.graph_context.expanded.length;
+            // Graph-expanded hits are supporting context for the primary matches -
+            // they must never OUTRANK them. The previous score ((graph_rank)*0.1,
+            // typically 0.05-0.095) sat far above the entire RRF range (<=~0.018),
+            // so expansion hits displaced every primary hit from the fused top-N
+            // (delta-bench root cause: top-5 filled with related-but-wrong topics
+            // while the queried topic's own rows were cut). Scale them into a band
+            // strictly below the weakest primary hit, ordered by graph rank.
+            const minPrimaryScore = fusedHits.length > 0 ? Math.min(...fusedHits.map((hit) => hit.fused_rank_score)) : 0.002;
             fusedHits = [
                 ...fusedHits,
                 ...bundle.graph_context.expanded.map((record) => ({
                     source_type: 'decision',
                     source_id: record.id,
                     record,
-                    fused_rank_score: (record.confidence ?? 0.5) * 0.1,
+                    fused_rank_score: minPrimaryScore * 0.9 * Math.min(1, Math.max(0.1, record.confidence ?? 0.5)),
                     retrieval_diagnostics: record.retrieval_diagnostics,
                 })),
             ].sort((left, right) => right.fused_rank_score - left.fused_rank_score);

package/dist/memory/event-store.d.ts

@@ -2,7 +2,6 @@ import type { DatabaseAdapter } from '../db-manager.js';
 import type { MemoryEventRecord } from './types.js';
 export declare function appendMemoryEvent(input: Omit<MemoryEventRecord, 'event_id'>): Promise<string>;
 export declare function insertMemoryEventInTransaction(adapter: Pick<DatabaseAdapter, 'prepare'>, input: Omit<MemoryEventRecord, 'event_id'>): string;
-export declare function listMemoryEventsForTopic(topic: string): Promise<MemoryEventRecord[]>;
 export declare function listMemoryEventsForMemory(memoryId: string): Promise<MemoryEventRecord[]>;
 export declare function listRecentMemoryEvents(limit?: number): Promise<MemoryEventRecord[]>;
 //# sourceMappingURL=event-store.d.ts.map