@jungjaehoon/mama-core 4.1.1 → 5.0.0

package/dist/knowledge/decision-edges.d.ts

@@ -1,70 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-/**
- * decision_edges + link_audit_log write boundary.
- *
- * Every mutation of the decision-edge graph goes through this module, so
- * `decision_edges` and `link_audit_log` each have exactly one writing module
- * inside `knowledge/` (the sibling judgments.ts owns the judgment-command
- * edge insert). Each function performs the edge change and its audit row
- * inside ONE adapter transaction - a link write and its audit row commit or
- * fail together.
- */
-type EdgeWriter = Pick<DatabaseAdapter, 'prepare' | 'transaction'>;
-export interface DecisionEdgeKey {
-    fromId: string;
-    toId: string;
-    relationship: string;
-}
-export interface DecisionEdgeRow extends DecisionEdgeKey {
-    reason: string | null;
-    createdBy: string | null;
-    approvedByUser: number | null;
-    decisionId: string | null;
-    evidence: string | null;
-    createdAt: number | null;
-}
-export interface ProposedDecisionEdge extends DecisionEdgeKey {
-    reason: string;
-    decisionId: string | null;
-    evidence: string | null;
-}
-export interface DecisionEdgeDeleteFailure {
-    link: string;
-    error: string;
-}
-/**
- * Insert-or-replace one decision edge row with explicit governance columns.
- * Used by the public createEdge API (createdBy 'llm', approvedByUser 1) and by
- * the backup-restore path (columns replayed from the backup file).
- */
-export declare function upsertDecisionEdge(adapter: EdgeWriter, edge: DecisionEdgeRow): void;
-/**
- * Record a proposed edge pending user approval, plus its 'proposed' audit row.
- */
-export declare function proposeDecisionEdge(adapter: EdgeWriter, edge: ProposedDecisionEdge): void;
-/**
- * Approve a pending edge, plus its 'approved' audit row.
- */
-export declare function approveDecisionEdge(adapter: EdgeWriter, key: DecisionEdgeKey): void;
-/**
- * Reject a proposed edge: the 'rejected' audit row is written before the edge
- * is deleted, in the same transaction.
- */
-export declare function rejectDecisionEdge(adapter: EdgeWriter, key: DecisionEdgeKey, reason: string): void;
-/**
- * Remove the auto-generated edge population (created_by='user' with no
- * proposal context) and record one 'deprecated' audit row per removed link.
- * `links` is the already-scanned target set; it only feeds the audit rows.
- */
-export declare function deprecateAutoDecisionEdges(adapter: EdgeWriter, links: readonly DecisionEdgeKey[], reason: string): void;
-/**
- * Delete one batch of edges, writing a 'deprecated' audit row for each. A
- * per-link failure is collected and the batch continues, matching the cleanup
- * tool's accounting; a failure of the batch itself throws to the caller.
- */
-export declare function deleteDecisionEdgesWithAudit(adapter: EdgeWriter, links: readonly DecisionEdgeKey[], reason: string): {
-    deleted: number;
-    failures: DecisionEdgeDeleteFailure[];
-};
-export {};
-//# sourceMappingURL=decision-edges.d.ts.map

package/dist/knowledge/decision-edges.js

@@ -1,123 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.upsertDecisionEdge = upsertDecisionEdge;
-exports.proposeDecisionEdge = proposeDecisionEdge;
-exports.approveDecisionEdge = approveDecisionEdge;
-exports.rejectDecisionEdge = rejectDecisionEdge;
-exports.deprecateAutoDecisionEdges = deprecateAutoDecisionEdges;
-exports.deleteDecisionEdgesWithAudit = deleteDecisionEdgesWithAudit;
-/**
- * Insert-or-replace one decision edge row with explicit governance columns.
- * Used by the public createEdge API (createdBy 'llm', approvedByUser 1) and by
- * the backup-restore path (columns replayed from the backup file).
- */
-function upsertDecisionEdge(adapter, edge) {
-    adapter
-        .prepare(`INSERT OR REPLACE INTO decision_edges
-       (from_id, to_id, relationship, reason, created_by, approved_by_user, decision_id, evidence, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-        .run(edge.fromId, edge.toId, edge.relationship, edge.reason, edge.createdBy, edge.approvedByUser, edge.decisionId, edge.evidence, edge.createdAt);
-}
-/**
- * Record a proposed edge pending user approval, plus its 'proposed' audit row.
- */
-function proposeDecisionEdge(adapter, edge) {
-    adapter.transaction(() => {
-        adapter
-            .prepare(`INSERT INTO decision_edges
-         (from_id, to_id, relationship, reason, created_by, approved_by_user, decision_id, evidence, created_at)
-         VALUES (?, ?, ?, ?, 'llm', 0, ?, ?, ?)`)
-            .run(edge.fromId, edge.toId, edge.relationship, edge.reason, edge.decisionId, edge.evidence, Date.now());
-        adapter
-            .prepare(`INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-         VALUES (?, ?, ?, 'proposed', 'llm', ?, ?)`)
-            .run(edge.fromId, edge.toId, edge.relationship, edge.reason, Date.now());
-    });
-}
-/**
- * Approve a pending edge, plus its 'approved' audit row.
- */
-function approveDecisionEdge(adapter, key) {
-    adapter.transaction(() => {
-        adapter
-            .prepare(`UPDATE decision_edges
-         SET approved_by_user = 1, approved_at = ?
-         WHERE from_id = ? AND to_id = ? AND relationship = ?`)
-            .run(Date.now(), key.fromId, key.toId, key.relationship);
-        adapter
-            .prepare(`INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, created_at)
-         VALUES (?, ?, ?, 'approved', 'user', ?)`)
-            .run(key.fromId, key.toId, key.relationship, Date.now());
-    });
-}
-/**
- * Reject a proposed edge: the 'rejected' audit row is written before the edge
- * is deleted, in the same transaction.
- */
-function rejectDecisionEdge(adapter, key, reason) {
-    adapter.transaction(() => {
-        adapter
-            .prepare(`INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-         VALUES (?, ?, ?, 'rejected', 'user', ?, ?)`)
-            .run(key.fromId, key.toId, key.relationship, reason, Date.now());
-        adapter
-            .prepare(`DELETE FROM decision_edges
-         WHERE from_id = ? AND to_id = ? AND relationship = ?`)
-            .run(key.fromId, key.toId, key.relationship);
-    });
-}
-/**
- * Remove the auto-generated edge population (created_by='user' with no
- * proposal context) and record one 'deprecated' audit row per removed link.
- * `links` is the already-scanned target set; it only feeds the audit rows.
- */
-function deprecateAutoDecisionEdges(adapter, links, reason) {
-    adapter.transaction(() => {
-        adapter
-            .prepare(`DELETE FROM decision_edges WHERE created_by = 'user' AND decision_id IS NULL`)
-            .run();
-        const auditStmt = adapter.prepare(`INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-       VALUES (?, ?, ?, 'deprecated', 'system', ?, ?)`);
-        const timestamp = Date.now();
-        for (const link of links) {
-            auditStmt.run(link.fromId, link.toId, link.relationship, reason, timestamp);
-        }
-    });
-}
-/**
- * Delete one batch of edges, writing a 'deprecated' audit row for each. A
- * per-link failure is collected and the batch continues, matching the cleanup
- * tool's accounting; a failure of the batch itself throws to the caller.
- */
-function deleteDecisionEdgesWithAudit(adapter, links, reason) {
-    const deleteStmt = adapter.prepare(`DELETE FROM decision_edges
-     WHERE from_id = ? AND to_id = ? AND relationship = ?`);
-    const auditStmt = adapter.prepare(`INSERT INTO link_audit_log (from_id, to_id, relationship, action, actor, reason, created_at)
-     VALUES (?, ?, ?, 'deprecated', 'system', ?, ?)`);
-    let deleted = 0;
-    const failures = [];
-    const processLinks = () => {
-        for (const link of links) {
-            try {
-                deleteStmt.run(link.fromId, link.toId, link.relationship);
-                auditStmt.run(link.fromId, link.toId, link.relationship, reason, Date.now());
-                deleted++;
-            }
-            catch (error) {
-                failures.push({
-                    link: `${link.fromId}->${link.toId}`,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-    };
-    // Use transaction if available, otherwise run directly
-    if (adapter.transaction) {
-        adapter.transaction(processLinks);
-    }
-    else {
-        processLinks();
-    }
-    return { deleted, failures };
-}
-//# sourceMappingURL=decision-edges.js.map

package/dist/memory/evolution-engine.d.ts

@@ -1,22 +0,0 @@
-import type { MemoryEdge, MemoryRecord } from './types.js';
-interface EvolutionInput {
-    incoming: Pick<MemoryRecord, 'topic' | 'summary' | 'kind'>;
-    existing: Array<Pick<MemoryRecord, 'id' | 'topic' | 'summary' | 'kind'> & {
-        _semanticMatch?: boolean;
-    }>;
-}
-export interface EvolutionResult {
-    edges: MemoryEdge[];
-}
-/**
- * Resolve how an incoming memory relates to existing memories.
- *
- * Supersede rules (conservative — avoid information loss):
- *   1. Raw → Extracted: structured fact replaces raw conversation (same topic, raw kind)
- *   2. Same fact update: same topic + high summary overlap (≥0.6) between two extracted facts
- *
- * Everything else → builds_on (preserves independent facts under same topic)
- */
-export declare function resolveMemoryEvolution(input: EvolutionInput): EvolutionResult;
-export {};
-//# sourceMappingURL=evolution-engine.d.ts.map

package/dist/memory/evolution-engine.js

@@ -1,133 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveMemoryEvolution = resolveMemoryEvolution;
-const STOP_WORDS = new Set([
-    'the',
-    'is',
-    'a',
-    'an',
-    'to',
-    'in',
-    'on',
-    'of',
-    'for',
-    'and',
-    'or',
-    'but',
-    'it',
-    'we',
-    'i',
-    'this',
-    'that',
-    'with',
-    'as',
-    'at',
-    'by',
-    'from',
-    'be',
-    'are',
-    'was',
-    'were',
-    'been',
-    'has',
-    'have',
-    'had',
-    'do',
-    'does',
-    'did',
-    'will',
-    'would',
-    'can',
-    'could',
-    'should',
-    'not',
-    'no',
-    'so',
-    'if',
-    'up',
-    'out',
-    'all',
-    'its',
-    'user',
-    'assistant',
-]);
-const MIN_TOKEN_LENGTH = 3;
-function summaryOverlapRatio(left, right) {
-    const tokenize = (s) => new Set(s
-        .toLowerCase()
-        .split(/[^a-z0-9_]+/)
-        .filter((t) => t.length >= MIN_TOKEN_LENGTH && !STOP_WORDS.has(t)));
-    const leftTokens = tokenize(left);
-    const rightTokens = tokenize(right);
-    if (leftTokens.size === 0 && rightTokens.size === 0) {
-        return left.toLowerCase().trim() === right.toLowerCase().trim() ? 1 : 0;
-    }
-    const smaller = leftTokens.size <= rightTokens.size ? leftTokens : rightTokens;
-    const larger = leftTokens.size > rightTokens.size ? leftTokens : rightTokens;
-    let shared = 0;
-    for (const t of smaller) {
-        if (larger.has(t))
-            shared++;
-    }
-    return shared / Math.max(smaller.size, 1);
-}
-/**
- * Resolve how an incoming memory relates to existing memories.
- *
- * Supersede rules (conservative — avoid information loss):
- *   1. Raw → Extracted: structured fact replaces raw conversation (same topic, raw kind)
- *   2. Same fact update: same topic + high summary overlap (≥0.6) between two extracted facts
- *
- * Everything else → builds_on (preserves independent facts under same topic)
- */
-function resolveMemoryEvolution(input) {
-    const edges = [];
-    for (const existing of input.existing) {
-        if (existing.topic === input.incoming.topic) {
-            // Rule 1: Raw → Extracted supersede (ingestConversation saves raw first, then extracted)
-            // Raw records have kind='fact' but summary starts with conversation text (role prefixes)
-            const existingIsRaw = existing.kind === 'fact' && /^(user:|assistant:)/i.test(existing.summary.trim());
-            if (existingIsRaw) {
-                edges.push({
-                    from_id: 'incoming',
-                    to_id: existing.id,
-                    type: 'supersedes',
-                    reason: 'Structured extraction replaces raw conversation',
-                });
-                continue;
-            }
-            // Rule 2: Same fact update — supersede if summaries share meaningful overlap.
-            // Threshold 0.3 balances: "Use SQLite" → "Switch to PostgreSQL" (same topic, genuine update)
-            // vs "User's cat Luna" / "User's wedding plan" (same topic, independent facts).
-            const overlap = summaryOverlapRatio(existing.summary, input.incoming.summary);
-            if (overlap >= 0.3) {
-                edges.push({
-                    from_id: 'incoming',
-                    to_id: existing.id,
-                    type: 'supersedes',
-                    reason: `Updated fact (${(overlap * 100).toFixed(0)}% overlap)`,
-                });
-                continue;
-            }
-            // Different content under same topic → independent facts, link as builds_on
-            edges.push({
-                from_id: 'incoming',
-                to_id: existing.id,
-                type: 'builds_on',
-                reason: `Related but distinct (${(overlap * 100).toFixed(0)}% overlap)`,
-            });
-            continue;
-        }
-        // Semantic candidates (vector similarity >= 0.82) → builds_on
-        if (existing._semanticMatch) {
-            edges.push({
-                from_id: 'incoming',
-                to_id: existing.id,
-                type: 'builds_on',
-                reason: 'Semantically similar memory detected via vector search',
-            });
-        }
-    }
-    return { edges };
-}
-//# sourceMappingURL=evolution-engine.js.map