@jungjaehoon/mama-core 1.8.1 → 2.0.0

package/dist/cases/tombstone-sweeper.js

@@ -1,128 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sweepStaleCaseMemberships = sweepStaleCaseMemberships;
-const node_crypto_1 = require("node:crypto");
-const canonicalize_js_1 = require("../canonicalize.js");
-const sqlite_transaction_js_1 = require("./sqlite-transaction.js");
-const SWEEP_SOURCE_TYPES = ['decision', 'event', 'observation'];
-const SOURCE_EXISTS_SQL = {
-    decision: 'SELECT 1 AS id FROM decisions WHERE id = ?',
-    event: 'SELECT 1 AS id FROM entity_timeline_events WHERE id = ?',
-    observation: 'SELECT 1 AS id FROM entity_observations WHERE id = ?',
-};
-function normalizeNow(value) {
-    return value ?? new Date().toISOString();
-}
-function createdAtMs(now) {
-    const parsed = Date.parse(now);
-    return Number.isFinite(parsed) ? parsed : Date.now();
-}
-function isSweptSourceType(value) {
-    return SWEEP_SOURCE_TYPES.includes(value);
-}
-function readCandidates(adapter, limit) {
-    const sql = `
-    SELECT source_type, source_id
-      FROM case_memberships
-     WHERE status IN ('active', 'candidate', 'removed', 'excluded')
-       AND source_type IN ('decision', 'event', 'observation')
-     GROUP BY source_type, source_id
-     ORDER BY source_type ASC, source_id ASC
-     ${limit === undefined ? '' : 'LIMIT ?'}
-  `;
-    const stmt = adapter.prepare(sql);
-    return (limit === undefined ? stmt.all() : stmt.all(limit));
-}
-function sourceExists(adapter, sourceType, sourceId) {
-    const row = adapter.prepare(SOURCE_EXISTS_SQL[sourceType]).get(sourceId);
-    return row !== undefined;
-}
-function countTransitionTargets(adapter, sourceType, sourceId) {
-    return adapter
-        .prepare(`
-        SELECT COUNT(*) AS count,
-               SUM(CASE WHEN user_locked = 1 THEN 1 ELSE 0 END) AS locked_count
-          FROM case_memberships
-         WHERE status <> 'stale'
-           AND source_type = ?
-           AND source_id = ?
-      `)
-        .get(sourceType, sourceId);
-}
-function markSourceStale(adapter, sourceType, sourceId, now) {
-    const result = adapter
-        .prepare(`
-        UPDATE case_memberships
-           SET status = 'stale',
-               updated_at = ?
-         WHERE status <> 'stale'
-           AND source_type = ?
-           AND source_id = ?
-           AND NOT EXISTS (${SOURCE_EXISTS_SQL[sourceType]})
-      `)
-        .run(now, sourceType, sourceId, sourceId);
-    return result.changes;
-}
-function insertTombstoneAuditEvent(input) {
-    const eventId = `me_${(0, node_crypto_1.randomUUID)()}`;
-    input.adapter
-        .prepare(`
-        INSERT INTO memory_events (
-          event_id, event_type, actor, source_turn_id, memory_id, topic,
-          scope_refs, evidence_refs, reason, created_at
-        )
-        VALUES (?, 'case.membership_tombstoned', 'system', NULL, NULL, ?, ?, ?, ?, ?)
-      `)
-        .run(eventId, 'case:tombstone-sweeper', (0, canonicalize_js_1.canonicalizeJSON)([{ kind: 'project', id: 'case-first' }]), (0, canonicalize_js_1.canonicalizeJSON)(input.sources), (0, canonicalize_js_1.canonicalizeJSON)({
-        stale_count: input.stale_count,
-        locked_stale_count: input.locked_stale_count,
-    }), createdAtMs(input.now));
-    return eventId;
-}
-function sweepStaleCaseMemberships(adapter, options = {}) {
-    const sweepAdapter = adapter;
-    return (0, sqlite_transaction_js_1.runImmediateTransaction)(sweepAdapter, () => {
-        const now = normalizeNow(options.now);
-        const candidates = readCandidates(sweepAdapter, options.limit);
-        let staleCount = 0;
-        let lockedStaleCount = 0;
-        const tombstonedSources = [];
-        for (const candidate of candidates) {
-            if (!isSweptSourceType(candidate.source_type)) {
-                continue;
-            }
-            if (sourceExists(sweepAdapter, candidate.source_type, candidate.source_id)) {
-                continue;
-            }
-            const before = countTransitionTargets(sweepAdapter, candidate.source_type, candidate.source_id);
-            if (before.count === 0) {
-                continue;
-            }
-            const changes = markSourceStale(sweepAdapter, candidate.source_type, candidate.source_id, now);
-            if (changes === 0) {
-                continue;
-            }
-            staleCount += changes;
-            lockedStaleCount += Math.min(changes, before.locked_count ?? 0);
-            tombstonedSources.push(candidate);
-        }
-        const auditEventIds = staleCount > 0
-            ? [
-                insertTombstoneAuditEvent({
-                    adapter: sweepAdapter,
-                    now,
-                    stale_count: staleCount,
-                    locked_stale_count: lockedStaleCount,
-                    sources: tombstonedSources,
-                }),
-            ]
-            : [];
-        return {
-            scanned_count: candidates.length,
-            stale_count: staleCount,
-            locked_stale_count: lockedStaleCount,
-            audit_event_ids: auditEventIds,
-        };
-    });
-}
-//# sourceMappingURL=tombstone-sweeper.js.map

package/dist/entities/entity-impact.d.ts

@@ -1,41 +0,0 @@
-import { type SourceLocatorKind } from './source-locator.js';
-import type { EntityIngestRun, EntityLineageLink, EntityNode } from './types.js';
-interface InspectorDetail {
-    entity: EntityNode;
-    history_incomplete: boolean;
-}
-interface InspectorLineageRow extends EntityLineageLink {
-    source_connector: string;
-    source_raw_record_id: string;
-    source_locator: string | null;
-    source_locator_kind: SourceLocatorKind;
-    surface_form: string;
-}
-interface InspectorLineageResult {
-    rows: InspectorLineageRow[];
-    history_incomplete: boolean;
-}
-interface ImpactMemoryRow {
-    id: string;
-    topic: string;
-    summary: string;
-    created_at: number;
-}
-interface ImpactAuditRunRow {
-    id: string;
-    classification: string | null;
-    status: string;
-    created_at: number;
-    completed_at: number | null;
-}
-interface EntityImpactResult {
-    related_memories: ImpactMemoryRow[];
-    ingest_runs: EntityIngestRun[];
-    audit_runs: ImpactAuditRunRow[];
-}
-export declare function getEntityInspectorDetail(entityId: string): Promise<InspectorDetail>;
-export declare function listEntityLineageForInspector(entityId: string, limit?: number): Promise<InspectorLineageResult>;
-export declare function getEntityImpact(entityId: string): Promise<EntityImpactResult>;
-export declare function getEntityIngestRun(runId: string): Promise<EntityIngestRun | null>;
-export {};
-//# sourceMappingURL=entity-impact.d.ts.map

package/dist/entities/entity-impact.js

@@ -1,140 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEntityInspectorDetail = getEntityInspectorDetail;
-exports.listEntityLineageForInspector = listEntityLineageForInspector;
-exports.getEntityImpact = getEntityImpact;
-exports.getEntityIngestRun = getEntityIngestRun;
-const db_manager_js_1 = require("../db-manager.js");
-const source_locator_js_1 = require("./source-locator.js");
-const lineage_store_js_1 = require("./lineage-store.js");
-function mapEntityNode(row) {
-    return {
-        id: String(row.id),
-        kind: row.kind,
-        preferred_label: String(row.preferred_label),
-        status: row.status,
-        scope_kind: typeof row.scope_kind === 'string' ? row.scope_kind : null,
-        scope_id: typeof row.scope_id === 'string' ? row.scope_id : null,
-        merged_into: typeof row.merged_into === 'string' ? row.merged_into : null,
-        created_at: Number(row.created_at),
-        updated_at: Number(row.updated_at),
-    };
-}
-async function getEntityInspectorDetail(entityId) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const row = adapter.prepare(`SELECT * FROM entity_nodes WHERE id = ?`).get(entityId);
-    if (!row) {
-        throw new Error(`Entity not found: ${entityId}`);
-    }
-    const lineageCount = adapter
-        .prepare(`
-        SELECT COUNT(*) AS total
-        FROM entity_lineage_links
-        WHERE canonical_entity_id = ?
-          AND status = 'active'
-      `)
-        .get(entityId);
-    return {
-        entity: mapEntityNode(row),
-        history_incomplete: lineageCount.total === 0,
-    };
-}
-async function listEntityLineageForInspector(entityId, limit = 50) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const safeLimit = Math.max(1, Math.min(limit, 500));
-    const rows = adapter
-        .prepare(`
-        SELECT
-          l.*,
-          o.source_connector,
-          o.source_raw_record_id,
-          o.source_locator,
-          o.surface_form
-        FROM entity_lineage_links l
-        JOIN entity_observations o ON o.id = l.entity_observation_id
-        WHERE l.canonical_entity_id = ?
-          AND l.status = 'active'
-        ORDER BY l.created_at ASC
-        LIMIT ?
-      `)
-        .all(entityId, safeLimit);
-    return {
-        rows: rows.map((row) => ({
-            id: String(row.id),
-            canonical_entity_id: String(row.canonical_entity_id),
-            entity_observation_id: String(row.entity_observation_id),
-            source_entity_id: typeof row.source_entity_id === 'string' ? row.source_entity_id : null,
-            contribution_kind: row.contribution_kind,
-            run_id: typeof row.run_id === 'string' ? row.run_id : null,
-            candidate_id: typeof row.candidate_id === 'string' ? row.candidate_id : null,
-            review_action_id: typeof row.review_action_id === 'string' ? row.review_action_id : null,
-            status: row.status,
-            capture_mode: row.capture_mode,
-            confidence: Number(row.confidence),
-            created_at: Number(row.created_at),
-            superseded_at: typeof row.superseded_at === 'number' ? row.superseded_at : null,
-            source_connector: String(row.source_connector),
-            source_raw_record_id: String(row.source_raw_record_id),
-            source_locator: typeof row.source_locator === 'string' ? row.source_locator : null,
-            source_locator_kind: (0, source_locator_js_1.detectSourceLocatorKind)(typeof row.source_locator === 'string' ? row.source_locator : null),
-            surface_form: String(row.surface_form),
-        })),
-        history_incomplete: rows.length === 0,
-    };
-}
-async function getEntityImpact(entityId) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const relatedMemories = adapter
-        .prepare(`
-        SELECT DISTINCT d.id, d.topic, d.summary, d.created_at
-        FROM entity_lineage_links l
-        JOIN decision_entity_sources des ON des.entity_observation_id = l.entity_observation_id
-        JOIN decisions d ON d.id = des.decision_id
-        WHERE l.canonical_entity_id = ?
-          AND l.status = 'active'
-        ORDER BY d.created_at DESC
-      `)
-        .all(entityId);
-    const ingestRuns = adapter
-        .prepare(`
-        SELECT DISTINCT ir.*
-        FROM entity_lineage_links l
-        JOIN entity_ingest_runs ir ON ir.id = l.run_id
-        WHERE l.canonical_entity_id = ?
-          AND l.status = 'active'
-        ORDER BY ir.created_at DESC
-      `)
-        .all(entityId);
-    const auditRuns = adapter
-        .prepare(`
-        SELECT DISTINCT ar.id, ar.classification, ar.status, ar.created_at, ar.completed_at
-        FROM entity_lineage_links l
-        JOIN entity_ingest_runs ir ON ir.id = l.run_id
-        JOIN entity_audit_runs ar ON ar.id = ir.audit_run_id
-        WHERE l.canonical_entity_id = ?
-          AND l.status = 'active'
-        ORDER BY ar.created_at DESC
-        LIMIT 10
-      `)
-        .all(entityId);
-    return {
-        related_memories: relatedMemories.map((row) => ({
-            id: row.id,
-            topic: row.topic,
-            summary: row.summary ?? row.topic,
-            created_at: row.created_at,
-        })),
-        ingest_runs: ingestRuns.map(lineage_store_js_1.parseEntityIngestRunRow),
-        audit_runs: auditRuns,
-    };
-}
-async function getEntityIngestRun(runId) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const row = adapter.prepare(`SELECT * FROM entity_ingest_runs WHERE id = ?`).get(runId);
-    return row ? (0, lineage_store_js_1.parseEntityIngestRunRow)(row) : null;
-}
-//# sourceMappingURL=entity-impact.js.map

package/dist/entities/exact-merge-backfill.d.ts

@@ -1,11 +0,0 @@
-export interface ExactMergeBackfillOptions {
-    dryRun?: boolean;
-}
-export interface ExactMergeBackfillResult {
-    groups: number;
-    merged: number;
-    incomplete: number;
-    skipped: number;
-}
-export declare function backfillExactDuplicateCanonicals(opts?: ExactMergeBackfillOptions): Promise<ExactMergeBackfillResult>;
-//# sourceMappingURL=exact-merge-backfill.d.ts.map

package/dist/entities/exact-merge-backfill.js

@@ -1,161 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.backfillExactDuplicateCanonicals = backfillExactDuplicateCanonicals;
-const db_manager_js_1 = require("../db-manager.js");
-const store_js_1 = require("./store.js");
-const lineage_store_js_1 = require("./lineage-store.js");
-function normalizeExactLabel(input) {
-    return input.normalize('NFKC').trim().replace(/\s+/gu, ' ').toLowerCase();
-}
-function buildExactGroupKey(row) {
-    if (row.normalized_form) {
-        return {
-            key: JSON.stringify([row.kind, row.scope_kind, row.scope_id ?? '', row.normalized_form]),
-            fromObservation: true,
-        };
-    }
-    const fallback = normalizeExactLabel(row.preferred_label);
-    if (!fallback) {
-        return null;
-    }
-    return {
-        key: JSON.stringify([row.kind, row.scope_kind, row.scope_id ?? '', fallback]),
-        fromObservation: false,
-    };
-}
-function compareRows(left, right) {
-    if (left.created_at !== right.created_at) {
-        return left.created_at - right.created_at;
-    }
-    return left.id.localeCompare(right.id);
-}
-function runAdapterTransaction(adapter, fn) {
-    const result = adapter.transaction(fn);
-    return typeof result === 'function' ? result() : result;
-}
-function requireTransactionAdapter(adapter) {
-    if (!('transaction' in adapter) || typeof adapter.transaction !== 'function') {
-        throw new Error('exact-merge-backfill requires adapter.transaction');
-    }
-    return adapter;
-}
-function mergeAndAdoptLineage(input) {
-    const mergeResult = (0, store_js_1.mergeEntityNodes)({
-        adapter: input.adapter,
-        source_id: input.source.id,
-        target_id: input.target.id,
-        actor_type: 'system',
-        actor_id: 'exact-duplicate-backfill',
-        reason: 'Exact duplicate canonical backfill',
-        candidate_id: null,
-        evidence_json: JSON.stringify({
-            strategy: 'exact_duplicate_backfill',
-            group_key: input.groupKey,
-            normalized_form: input.source.normalized_form,
-            target_id: input.target.id,
-        }),
-    });
-    (0, lineage_store_js_1.adoptLineageAfterMergeSync)({
-        adapter: input.adapter,
-        source_entity_id: input.source.id,
-        target_entity_id: input.target.id,
-        candidate_id: null,
-        review_action_id: mergeResult.merge_action_id,
-    });
-}
-async function backfillExactDuplicateCanonicals(opts = {}) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const dryRun = opts.dryRun === true;
-    let groups = 0;
-    let merged = 0;
-    let incomplete = 0;
-    let skipped = 0;
-    const rows = adapter
-        .prepare(`
-        SELECT
-          n.id,
-          n.kind,
-          n.preferred_label,
-          n.scope_kind,
-          n.scope_id,
-          n.created_at,
-          MIN(o.normalized_form) AS normalized_form
-        FROM entity_nodes n
-        LEFT JOIN entity_lineage_links l
-          ON l.canonical_entity_id = n.id
-         AND l.status = 'active'
-        LEFT JOIN entity_observations o
-          ON o.id = l.entity_observation_id
-        WHERE n.status = 'active'
-          AND n.merged_into IS NULL
-        GROUP BY n.id, n.kind, n.preferred_label, n.scope_kind, n.scope_id, n.created_at
-      `)
-        .all();
-    const grouped = new Map();
-    const fallbackRows = new Set();
-    for (const row of rows) {
-        const keyInfo = buildExactGroupKey(row);
-        if (!keyInfo) {
-            incomplete += 1;
-            continue;
-        }
-        if (!keyInfo.fromObservation) {
-            fallbackRows.add(row.id);
-        }
-        const bucket = grouped.get(keyInfo.key) ?? [];
-        bucket.push(row);
-        grouped.set(keyInfo.key, bucket);
-    }
-    for (const bucket of grouped.values()) {
-        if (bucket.length >= 2) {
-            continue;
-        }
-        for (const row of bucket) {
-            if (fallbackRows.has(row.id)) {
-                incomplete += 1;
-            }
-        }
-    }
-    for (const [groupKey, bucket] of grouped.entries()) {
-        if (bucket.length < 2) {
-            continue;
-        }
-        groups += 1;
-        const sorted = [...bucket].sort(compareRows);
-        const target = sorted[0];
-        const sources = sorted.slice(1);
-        if (dryRun) {
-            merged += sources.length;
-            continue;
-        }
-        try {
-            const transactionalAdapter = requireTransactionAdapter(adapter);
-            runAdapterTransaction(transactionalAdapter, () => {
-                for (const source of sources) {
-                    mergeAndAdoptLineage({
-                        adapter,
-                        source,
-                        target,
-                        groupKey,
-                    });
-                }
-            });
-            merged += sources.length;
-        }
-        catch (error) {
-            if (error instanceof store_js_1.EntityMergeError) {
-                skipped += sources.length;
-                continue;
-            }
-            throw error;
-        }
-    }
-    return {
-        groups,
-        merged,
-        incomplete,
-        skipped,
-    };
-}
-//# sourceMappingURL=exact-merge-backfill.js.map

package/dist/entities/lineage-backfill.d.ts

@@ -1,12 +0,0 @@
-interface BackfillEntityLineageOptions {
-    dryRun?: boolean;
-    now?: number;
-}
-interface BackfillEntityLineageResult {
-    seeded: number;
-    adopted: number;
-    incomplete: number;
-}
-export declare function backfillEntityLineage(opts?: BackfillEntityLineageOptions): Promise<BackfillEntityLineageResult>;
-export {};
-//# sourceMappingURL=lineage-backfill.d.ts.map

package/dist/entities/lineage-backfill.js

@@ -1,101 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.backfillEntityLineage = backfillEntityLineage;
-const db_manager_js_1 = require("../db-manager.js");
-const lineage_store_js_1 = require("./lineage-store.js");
-async function backfillEntityLineage(opts = {}) {
-    await (0, db_manager_js_1.initDB)();
-    const adapter = (0, db_manager_js_1.getAdapter)();
-    const dryRun = opts.dryRun === true;
-    const seedConfidence = 0.75;
-    const adoptConfidence = 0.6;
-    let seeded = 0;
-    let adopted = 0;
-    let incomplete = 0;
-    const activeRows = adapter
-        .prepare(`
-        SELECT n.id, o.id AS observation_id
-        FROM entity_nodes n
-        LEFT JOIN entity_observations o ON o.id = n.id
-        WHERE n.status = 'active'
-          AND n.merged_into IS NULL
-      `)
-        .all();
-    for (const row of activeRows) {
-        if (!row.observation_id) {
-            incomplete += 1;
-            continue;
-        }
-        const existing = adapter
-            .prepare(`
-          SELECT id
-          FROM entity_lineage_links
-          WHERE canonical_entity_id = ?
-            AND entity_observation_id = ?
-            AND status = 'active'
-          LIMIT 1
-        `)
-            .get(row.id, row.observation_id);
-        if (existing) {
-            continue;
-        }
-        seeded += 1;
-        if (!dryRun) {
-            await (0, lineage_store_js_1.appendEntityLineageLink)({
-                canonical_entity_id: row.id,
-                entity_observation_id: row.observation_id,
-                source_entity_id: null,
-                contribution_kind: 'seed',
-                run_id: null,
-                candidate_id: null,
-                review_action_id: null,
-                capture_mode: 'backfilled',
-                confidence: seedConfidence,
-            });
-        }
-    }
-    const mergedRows = adapter
-        .prepare(`
-        SELECT n.id AS source_entity_id, n.merged_into AS target_entity_id, o.id AS observation_id
-        FROM entity_nodes n
-        LEFT JOIN entity_observations o ON o.id = n.id
-        WHERE n.status = 'merged'
-          AND n.merged_into IS NOT NULL
-      `)
-        .all();
-    for (const row of mergedRows) {
-        if (!row.observation_id) {
-            incomplete += 1;
-            continue;
-        }
-        const existing = adapter
-            .prepare(`
-          SELECT id
-          FROM entity_lineage_links
-          WHERE canonical_entity_id = ?
-            AND entity_observation_id = ?
-            AND status = 'active'
-          LIMIT 1
-        `)
-            .get(row.target_entity_id, row.observation_id);
-        if (existing) {
-            continue;
-        }
-        adopted += 1;
-        if (!dryRun) {
-            await (0, lineage_store_js_1.appendEntityLineageLink)({
-                canonical_entity_id: row.target_entity_id,
-                entity_observation_id: row.observation_id,
-                source_entity_id: row.source_entity_id,
-                contribution_kind: 'merge_adopt',
-                run_id: null,
-                candidate_id: null,
-                review_action_id: null,
-                capture_mode: 'backfilled',
-                confidence: adoptConfidence,
-            });
-        }
-    }
-    return { seeded, adopted, incomplete };
-}
-//# sourceMappingURL=lineage-backfill.js.map

package/dist/memory-inject.d.ts

@@ -1,24 +0,0 @@
-/**
- * MAMA (Memory-Augmented MCP Architecture) - Memory Injection Hook
- *
- * UserPromptSubmit hook that injects decision history into Claude's context
- * Tasks: 1.1-1.9 (Hook setup, timeout handling, context injection)
- * AC #1: Query intent → Graph query → Format → Inject (5s timeout for LLM latency)
- * AC #2: No history → null (graceful fallback)
- * AC #3: Timeout → graceful fallback
- *
- * @module memory-inject
- * @version 1.0
- * @date 2025-11-14
- */
-/**
- * UserPromptSubmit Hook Handler
- *
- * Task 1.1-1.9: Main entry point for memory injection
- * AC #1, #2, #3: Intent analysis → Query → Format → Inject
- *
- * @param userMessage - User's message from prompt
- * @returns Injected context or null
- */
-export declare function injectDecisionContext(userMessage: string): Promise<string | null>;
-//# sourceMappingURL=memory-inject.d.ts.map