@jungjaehoon/mama-core 2.2.2 → 2.2.3

package/dist/index.d.ts

@@ -18,6 +18,7 @@ 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, type AuditFindingRecord, } from './memory/types.js';
 export { saveMemory, saveMemoryWithTrustedProvenance, promoteMemoryStatus, recallMemory, buildProfile, ingestMemory, ingestWithTrustedProvenance, evolveMemory, buildMemoryBootstrap, createAuditAck, recordMemoryAudit, ingestConversation, ingestConversationWithTrustedProvenance, setExtractionFn, upsertChannelSummary, getChannelSummary, } from './memory/api.js';
 export { buildExtractionPrompt, parseExtractionResponse } from './memory/extraction-prompt.js';
+export { queryRelevantTruth } from './memory/truth-store.js';
 export { createAuditFinding, listOpenAuditFindings } from './memory/finding-store.js';
 export { appendMemoryEvent, insertMemoryEventInTransaction, listMemoryEventsForMemory, listRecentMemoryEvents, } from './memory/event-store.js';
 export { createTrustedProvenanceCapability, assertTrustedProvenanceCapability, type TrustedProvenanceCapability, type TrustedMemoryWriteOptions, } from './memory/provenance.js';

package/dist/index.js

@@ -27,9 +27,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 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.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.listOpenAuditFindings = exports.createAuditFinding = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = void 0;
-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 = exports.selectTopDecisions = exports.calculateRelevance = 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 = exports.extractQuickAnswer = exports.estimateTokens = void 0;
+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.listOpenAuditFindings = exports.createAuditFinding = exports.queryRelevantTruth = exports.parseExtractionResponse = exports.buildExtractionPrompt = exports.getChannelSummary = exports.upsertChannelSummary = exports.setExtractionFn = exports.ingestConversationWithTrustedProvenance = exports.ingestConversation = exports.recordMemoryAudit = void 0;
+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 = exports.selectTopDecisions = exports.calculateRelevance = exports.DEFAULT_CONFIG = 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 = exports.extractQuickAnswer = exports.estimateTokens = exports.ensureTokenBudget = 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; } });
@@ -98,6 +98,8 @@ Object.defineProperty(exports, "getChannelSummary", { enumerable: true, get: fun
 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 truth_store_js_1 = require("./memory/truth-store.js");
+Object.defineProperty(exports, "queryRelevantTruth", { enumerable: true, get: function () { return truth_store_js_1.queryRelevantTruth; } });
 var finding_store_js_1 = require("./memory/finding-store.js");
 Object.defineProperty(exports, "createAuditFinding", { enumerable: true, get: function () { return finding_store_js_1.createAuditFinding; } });
 Object.defineProperty(exports, "listOpenAuditFindings", { enumerable: true, get: function () { return finding_store_js_1.listOpenAuditFindings; } });

package/dist/memory/api.js

@@ -31,7 +31,6 @@ const bootstrap_builder_js_1 = require("./bootstrap-builder.js");
 const evolution_engine_js_1 = require("./evolution-engine.js");
 const channel_summary_state_store_js_1 = require("./channel-summary-state-store.js");
 const debug_logger_js_1 = require("../debug-logger.js");
-const truth_store_js_1 = require("./truth-store.js");
 const extraction_prompt_js_1 = require("./extraction-prompt.js");
 const types_js_1 = require("./types.js");
 const channel_summary_store_js_1 = require("./channel-summary-store.js");
@@ -647,9 +646,6 @@ async function saveMemoryInternal(input, options) {
                     adapter
                         .prepare(`UPDATE decisions SET superseded_by = ?, status = 'superseded', updated_at = ? WHERE id = ?`)
                         .run(id, now, edge.to_id);
-                    adapter
-                        .prepare(`UPDATE memory_truth SET truth_status = 'superseded', superseded_by = ?, updated_at = ? WHERE memory_id = ?`)
-                        .run(id, now, edge.to_id);
                 }
                 adapter
                     .prepare(`
@@ -683,25 +679,6 @@ async function saveMemoryInternal(input, options) {
             }
         }
     }
-    if (options?.projectTruth !== false) {
-        // Project to memory_truth table (best-effort; failure should not break save)
-        try {
-            await (0, truth_store_js_1.projectMemoryTruth)({
-                memory_id: id,
-                topic: input.topic,
-                truth_status: targetStatus,
-                effective_summary: input.summary,
-                effective_details: input.details,
-                trust_score: input.confidence ?? 0.5,
-                scope_refs: input.scopes,
-                supporting_event_ids: [],
-                superseded_by: undefined,
-            });
-        }
-        catch {
-            // Truth projection is best-effort; do not fail the save
-        }
-    }
     return {
         success: true,
         id,
@@ -724,7 +701,7 @@ async function promoteMemoryStatus(input) {
     const targetStatus = input.status;
     const row = adapter
         .prepare(`
-        SELECT id, topic, decision, reasoning, confidence, kind, summary, supersedes
+        SELECT id, topic, decision, confidence, kind, summary, supersedes
         FROM decisions
         WHERE id = ?
       `)
@@ -734,7 +711,6 @@ async function promoteMemoryStatus(input) {
     }
     const topic = String(row.topic);
     const summary = String(row.summary ?? row.decision ?? '');
-    const details = String(row.reasoning ?? row.decision ?? '');
     const kind = (row.kind ?? 'fact') || 'fact';
     const scopes = batchLoadScopes(adapter, [memoryId]).get(memoryId) ?? [];
     let evolution = { edges: [] };
@@ -823,23 +799,11 @@ async function promoteMemoryStatus(input) {
         if (updated.changes !== 1) {
             throw new Error(`Cannot promote missing memory ${memoryId}`);
         }
-        adapter
-            .prepare(`
-          INSERT OR REPLACE INTO memory_truth (
-            memory_id, topic, truth_status, effective_summary, effective_details, trust_score,
-            scope_refs, supporting_event_ids, superseded_by, contradicted_by, created_at, updated_at
-          )
-          VALUES (?, ?, ?, ?, ?, ?, ?, COALESCE((SELECT supporting_event_ids FROM memory_truth WHERE memory_id = ?), '[]'), NULL, NULL, COALESCE((SELECT created_at FROM memory_truth WHERE memory_id = ?), ?), ?)
-        `)
-            .run(memoryId, topic, targetStatus, summary, details, row.confidence ?? 0.5, JSON.stringify(scopes), memoryId, memoryId, now, now);
         for (const edge of evolution.edges) {
             if (edge.type === 'supersedes') {
                 adapter
                     .prepare(`UPDATE decisions SET superseded_by = ?, status = 'superseded', updated_at = ? WHERE id = ?`)
                     .run(memoryId, now, edge.to_id);
-                adapter
-                    .prepare(`UPDATE memory_truth SET truth_status = 'superseded', superseded_by = ?, updated_at = ? WHERE memory_id = ?`)
-                    .run(memoryId, now, edge.to_id);
             }
             adapter
                 .prepare(`

package/dist/memory/bootstrap-builder.js

@@ -11,7 +11,7 @@ async function buildMemoryAgentBootstrap(params) {
         (0, truth_store_js_1.queryRelevantTruth)({
             query: '',
             scopes: params.scopes,
-            includeHistory: true,
+            includeHistory: false,
         }),
         (0, finding_store_js_1.listOpenAuditFindings)(),
         (0, event_store_js_1.listRecentMemoryEvents)(10),
@@ -25,11 +25,11 @@ async function buildMemoryAgentBootstrap(params) {
         summary: row.effective_summary,
         details: row.effective_details,
         confidence: row.trust_score,
-        status: row.truth_status === 'quarantined' ? 'stale' : row.truth_status,
+        status: row.truth_status,
         scopes: row.scope_refs,
         source: {
             package: 'mama-core',
-            source_type: 'truth_projection',
+            source_type: 'decisions_current',
         },
         created_at: 0,
         updated_at: 0,

package/dist/memory/provenance.d.ts

@@ -5,7 +5,6 @@ export interface TrustedProvenanceCapability {
 export interface TrustedMemoryWriteOptions {
     provenance: MemoryWriteProvenance;
     capability: TrustedProvenanceCapability;
-    projectTruth?: boolean;
 }
 export interface NormalizedMemoryProvenance {
     actor: MemoryEventRecord['actor'];

package/dist/memory/provenance.js

@@ -92,7 +92,6 @@ function appendProvenanceSourceRefs(options, refs) {
     assertTrustedProvenanceCapability(options.capability);
     return {
         capability: options.capability,
-        projectTruth: options.projectTruth,
         provenance: {
             ...options.provenance,
             source_refs: [...(options.provenance.source_refs ?? []), ...refs],

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

@@ -1,5 +1,4 @@
 import type { MemoryScopeRef, MemoryTruthRow } from './types.js';
-export declare function projectMemoryTruth(row: MemoryTruthRow): Promise<void>;
 export declare function queryRelevantTruth(params: {
     query: string;
     scopes: MemoryScopeRef[];

package/dist/memory/truth-store.js

@@ -1,33 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.projectMemoryTruth = projectMemoryTruth;
 exports.queryRelevantTruth = queryRelevantTruth;
 const db_manager_js_1 = require("../db-manager.js");
-function deserializeTruthRow(row) {
+function decisionToTruthRow(row) {
     return {
-        memory_id: String(row.memory_id),
-        topic: String(row.topic),
-        truth_status: row.truth_status,
-        effective_summary: String(row.effective_summary),
-        effective_details: String(row.effective_details),
-        trust_score: Number(row.trust_score),
-        scope_refs: JSON.parse(String(row.scope_refs)),
-        supporting_event_ids: JSON.parse(String(row.supporting_event_ids)),
-        superseded_by: typeof row.superseded_by === 'string' ? row.superseded_by : undefined,
-        contradicted_by: typeof row.contradicted_by === 'string'
-            ? JSON.parse(row.contradicted_by)
-            : undefined,
-        created_at: typeof row.created_at === 'number' ? row.created_at : undefined,
-        updated_at: typeof row.updated_at === 'number' ? row.updated_at : undefined,
-        kind: typeof row.kind === 'string' ? row.kind : undefined,
+        memory_id: row.id,
+        topic: row.topic,
+        truth_status: row.status,
+        effective_summary: row.summary ?? row.decision,
+        effective_details: row.reasoning ?? '',
+        trust_score: row.confidence,
+        scope_refs: JSON.parse(row.scope_refs),
+        supporting_event_ids: [],
+        superseded_by: row.superseded_by ?? undefined,
+        created_at: row.created_at,
+        updated_at: row.updated_at ?? undefined,
+        kind: row.kind ?? undefined,
     };
 }
-function matchesScopes(row, scopes) {
-    if (scopes.length === 0) {
-        return true;
-    }
-    return row.scope_refs.some((scopeRef) => scopes.some((scope) => scope.kind === scopeRef.kind && scope.id === scopeRef.id));
-}
 function matchesQuery(row, query) {
     const tokens = query
         .toLowerCase()
@@ -40,47 +30,43 @@ function matchesQuery(row, query) {
         ? haystack.includes(query.toLowerCase())
         : tokens.some((token) => haystack.includes(token));
 }
-async function projectMemoryTruth(row) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const now = Date.now();
-    adapter
-        .prepare(`
-        INSERT OR REPLACE INTO memory_truth (
-          memory_id, topic, truth_status, effective_summary, effective_details, trust_score,
-          scope_refs, supporting_event_ids, superseded_by, contradicted_by, created_at, updated_at
-        )
-        VALUES (
-          ?, ?,
-          COALESCE((SELECT status FROM decisions WHERE id = ?), ?),
-          ?, ?, ?, ?, ?,
-          COALESCE((SELECT superseded_by FROM decisions WHERE id = ?), ?),
-          ?, COALESCE((SELECT created_at FROM memory_truth WHERE memory_id = ?), ?), ?
-        )
-      `)
-        .run(row.memory_id, row.topic, row.memory_id, row.truth_status, row.effective_summary, row.effective_details, row.trust_score, JSON.stringify(row.scope_refs), JSON.stringify(row.supporting_event_ids), row.memory_id, row.superseded_by ?? null, row.contradicted_by ? JSON.stringify(row.contradicted_by) : null, row.memory_id, now, now);
-}
 async function queryRelevantTruth(params) {
     await (0, db_manager_js_1.initDB)();
     const adapter = (0, db_manager_js_1.getAdapter)();
+    const scopeMatch = params.scopes
+        .map(() => '(scope_filter.kind = ? AND scope_filter.external_id = ?)')
+        .join(' OR ');
+    const scopeFilter = params.scopes.length > 0
+        ? `
+        AND EXISTS (
+          SELECT 1
+          FROM memory_scope_bindings binding_filter
+          JOIN memory_scopes scope_filter ON scope_filter.id = binding_filter.scope_id
+          WHERE binding_filter.memory_id = d.id
+            AND (${scopeMatch})
+        )
+      `
+        : 'AND 1 = 0';
+    const currentFilter = params.includeHistory === true ? '' : "AND d.status = 'active'";
+    const scopeParams = params.scopes.flatMap((scope) => [scope.kind, scope.id]);
     const rows = adapter
         .prepare(`
-        SELECT mt.memory_id, mt.topic, mt.truth_status, mt.effective_summary, mt.effective_details, mt.trust_score,
-               mt.scope_refs, mt.supporting_event_ids, mt.superseded_by, mt.contradicted_by, mt.created_at, mt.updated_at,
-               d.kind
-        FROM memory_truth mt
-        LEFT JOIN decisions d ON d.id = mt.memory_id
-        ORDER BY mt.updated_at DESC
+        SELECT d.id, d.topic, d.status, d.summary, d.decision, d.reasoning, d.confidence,
+               d.superseded_by, d.created_at, d.updated_at, d.kind,
+               json_group_array(json_object('kind', scope.kind, 'id', scope.external_id)) AS scope_refs
+        FROM decisions d
+        JOIN memory_scope_bindings binding ON binding.memory_id = d.id
+        JOIN memory_scopes scope ON scope.id = binding.scope_id
+        WHERE 1 = 1
+          ${currentFilter}
+          ${scopeFilter}
+        GROUP BY d.id
+        ORDER BY d.updated_at DESC, d.created_at DESC
       `)
-        .all();
+        .all(...scopeParams);
     return rows
-        .map(deserializeTruthRow)
-        .filter((row) => matchesScopes(row, params.scopes))
+        .map(decisionToTruthRow)
         .filter((row) => matchesQuery(row, params.query))
-        .filter((row) => params.includeHistory === true ||
-        (row.truth_status !== 'quarantined' &&
-            row.truth_status !== 'superseded' &&
-            row.truth_status !== 'contradicted'))
         .sort((left, right) => right.trust_score - left.trust_score);
 }
 //# sourceMappingURL=truth-store.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",