@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/edges/ref-validation.js

@@ -1,321 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertTwinRefsVisible = assertTwinRefsVisible;
-exports.listVisibleTwinEdgesForRefs = listVisibleTwinEdgesForRefs;
-const store_js_1 = require("./store.js");
-const channel_grant_js_1 = require("../context-compile/channel-grant.js");
-const TABLE_COLUMN_PRAGMAS = {
-    decisions: 'PRAGMA table_info(decisions)',
-    case_truth: 'PRAGMA table_info(case_truth)',
-};
-const tableColumnCache = new WeakMap();
-// Keep memory-truth quarantine semantics excluded for legacy/backcompat rows even though the
-// current decisions.status CHECK only admits superseded/contradicted/stale terminal states.
-const EXCLUDED_MEMORY_STATUSES = new Set(['superseded', 'quarantined', 'contradicted', 'stale']);
-function scopeKey(scope) {
-    return `${scope.kind}\0${scope.id}`;
-}
-function hasScopes(scopes) {
-    return Array.isArray(scopes) && scopes.length > 0;
-}
-function hasProjectRefs(projectRefs) {
-    return Array.isArray(projectRefs) && projectRefs.length > 0;
-}
-function asOfMs(visibility) {
-    return typeof visibility.asOfMs === 'number' ? visibility.asOfMs : null;
-}
-function startMs(visibility) {
-    return typeof visibility.startMs === 'number' ? visibility.startMs : null;
-}
-function isWithinVisibilityTime(value, visibility) {
-    const start = startMs(visibility);
-    const asOf = asOfMs(visibility);
-    if (start === null && asOf === null) {
-        return true;
-    }
-    return (typeof value === 'number' &&
-        (start === null || value >= start) &&
-        (asOf === null || value <= asOf));
-}
-function parseTimestamp(value) {
-    if (typeof value === 'number' && Number.isFinite(value)) {
-        return Math.floor(value);
-    }
-    if (typeof value === 'string') {
-        const trimmed = value.trim();
-        if (trimmed.length === 0) {
-            return null;
-        }
-        const numeric = Number(trimmed);
-        if (Number.isFinite(numeric)) {
-            return Math.floor(numeric);
-        }
-        const parsed = Date.parse(trimmed);
-        return Number.isFinite(parsed) ? parsed : null;
-    }
-    return null;
-}
-function tableColumns(adapter, table) {
-    const pragma = TABLE_COLUMN_PRAGMAS[table];
-    if (!pragma) {
-        throw new Error(`Unsupported table for column introspection: ${table}`);
-    }
-    let adapterCache = tableColumnCache.get(adapter);
-    if (!adapterCache) {
-        adapterCache = new Map();
-        tableColumnCache.set(adapter, adapterCache);
-    }
-    const cached = adapterCache.get(table);
-    if (cached) {
-        return cached;
-    }
-    const rows = adapter.prepare(pragma).all();
-    const columns = new Set(rows.map((row) => row.name));
-    adapterCache.set(table, columns);
-    return columns;
-}
-function isMemoryVisible(adapter, id, visibility) {
-    const columns = tableColumns(adapter, 'decisions');
-    const statusSelect = columns.has('status') ? 'status' : 'NULL AS status';
-    const supersededBySelect = columns.has('superseded_by')
-        ? 'superseded_by'
-        : 'NULL AS superseded_by';
-    const row = adapter
-        .prepare(`
-        SELECT created_at, event_datetime, ${statusSelect}, ${supersededBySelect}
-        FROM decisions
-        WHERE id = ?
-        LIMIT 1
-      `)
-        .get(id);
-    if (!row) {
-        return false;
-    }
-    const status = typeof row.status === 'string' ? row.status : 'active';
-    if (EXCLUDED_MEMORY_STATUSES.has(status) ||
-        (typeof row.superseded_by === 'string' && row.superseded_by.length > 0)) {
-        return false;
-    }
-    if (!isWithinVisibilityTime(row.event_datetime ?? row.created_at, visibility)) {
-        return false;
-    }
-    const scopes = visibility.scopes;
-    if (!hasScopes(scopes)) {
-        return true;
-    }
-    const scopeClauses = scopes.map(() => '(ms.kind = ? AND ms.external_id = ?)').join(' OR ');
-    const params = scopes.flatMap((scope) => [scope.kind, scope.id]);
-    const bindingRow = adapter
-        .prepare(`
-        SELECT 1 AS ok
-        FROM memory_scope_bindings msb
-        JOIN memory_scopes ms ON ms.id = msb.scope_id
-        WHERE msb.memory_id = ?
-          AND (${scopeClauses})
-        LIMIT 1
-      `)
-        .get(id, ...params);
-    if (bindingRow?.ok) {
-        return true;
-    }
-    if (columns.has('memory_scope_kind') && columns.has('memory_scope_id')) {
-        const row = adapter
-            .prepare(`
-          SELECT 1 AS ok
-          FROM decisions
-          WHERE id = ?
-            AND (${scopes.map(() => '(memory_scope_kind = ? AND memory_scope_id = ?)').join(' OR ')})
-          LIMIT 1
-        `)
-            .get(id, ...params);
-        return Boolean(row?.ok);
-    }
-    return false;
-}
-function parseCaseScopeRefs(scopeRefs) {
-    if (typeof scopeRefs !== 'string' || scopeRefs.length === 0) {
-        return [];
-    }
-    try {
-        const parsed = JSON.parse(scopeRefs);
-        if (!Array.isArray(parsed)) {
-            return [];
-        }
-        return parsed.filter((item) => item !== null &&
-            typeof item === 'object' &&
-            typeof item.kind === 'string' &&
-            typeof item.id === 'string');
-    }
-    catch {
-        return [];
-    }
-}
-function isCaseVisible(adapter, id, visibility) {
-    const row = adapter.prepare('SELECT * FROM case_truth WHERE case_id = ? LIMIT 1').get(id);
-    if (!row) {
-        return false;
-    }
-    const timestamp = parseTimestamp(row.last_activity_at) ?? parseTimestamp(row.updated_at);
-    if (!isWithinVisibilityTime(timestamp, visibility)) {
-        return false;
-    }
-    const scopes = visibility.scopes;
-    if (!hasScopes(scopes)) {
-        return true;
-    }
-    const requested = new Set(scopes.map(scopeKey));
-    const scopeRefs = parseCaseScopeRefs(row.scope_refs);
-    if (scopeRefs.some((scope) => requested.has(scopeKey(scope)))) {
-        return true;
-    }
-    const columns = tableColumns(adapter, 'case_truth');
-    if (columns.has('memory_scope_kind') && columns.has('memory_scope_id')) {
-        return scopes.some((scope) => row.memory_scope_kind === scope.kind && row.memory_scope_id === scope.id);
-    }
-    return false;
-}
-/**
- * The time bound, shared by both branches so a grant cannot skip it.
- *
- * DELIBERATELY STRICTER THAN THE READER, and a review flagged the difference as a
- * divergence between two delegates of one rule. It is not. A row with no usable timestamp
- * is refused here even when no bound is set, while the reader - whose clause is on
- * `COALESCE(event_datetime, source_timestamp_ms)` - leaves such a row alone when there is
- * no bound to apply.
- *
- * The direction is what makes it correct: this gate guards refs reached INDIRECTLY, through
- * a seed the caller named or an edge the graph walked. Refusing what cannot be shown to sit
- * inside any window keeps the indirect path no wider than the direct one, which is the
- * invariant the whole design rests on. Relaxing it to match the reader would have made
- * citation reach further than reading for exactly the rows whose position in time is
- * unknown. `fails closed for raw endpoints with blank timestamps` states the intent.
- */
-function isRawWithinTime(row, visibility) {
-    const rawTs = row.event_datetime ?? row.source_timestamp_ms;
-    if (rawTs === null || rawTs === undefined || (typeof rawTs === 'string' && rawTs.trim() === '')) {
-        return false;
-    }
-    const eventTsMs = parseTimestamp(rawTs);
-    return eventTsMs !== null && eventTsMs >= 0 && isWithinVisibilityTime(eventTsMs, visibility);
-}
-function isRawVisible(adapter, id, visibility) {
-    const row = adapter
-        .prepare('SELECT * FROM connector_event_index WHERE event_index_id = ? LIMIT 1')
-        .get(id);
-    if (!row) {
-        return false;
-    }
-    if (Array.isArray(visibility.connectors) &&
-        !visibility.connectors.includes(String(row.source_connector))) {
-        return false;
-    }
-    // The grant decides, and it decides the same way here as in the reader - one rule, taken
-    // from one place. The scope/project/tenant clauses below are the pre-grant rule and are
-    // skipped when a grant is present, exactly as the reader skips them, because applying
-    // both would make a cited ref satisfy a stricter test than a read one.
-    if (visibility.channels) {
-        return ((0, channel_grant_js_1.isChannelGranted)(String(row.source_connector), typeof row.channel === 'string' ? row.channel : null, visibility.channels) && isRawWithinTime(row, visibility));
-    }
-    if (hasProjectRefs(visibility.projectRefs) &&
-        !visibility.projectRefs.some((project) => project.id === row.project_id)) {
-        return false;
-    }
-    if (typeof visibility.tenantId === 'string' &&
-        visibility.tenantId.length > 0 &&
-        row.tenant_id !== visibility.tenantId) {
-        return false;
-    }
-    if (!isRawWithinTime(row, visibility)) {
-        return false;
-    }
-    if (!hasScopes(visibility.scopes)) {
-        return true;
-    }
-    return visibility.scopes.some((scope) => row.memory_scope_kind === scope.kind && row.memory_scope_id === scope.id);
-}
-function isEntityVisible(adapter, id, visibility) {
-    const row = adapter
-        .prepare('SELECT scope_kind, scope_id, created_at FROM entity_nodes WHERE id = ? AND status = ? LIMIT 1')
-        .get(id, 'active');
-    if (!row) {
-        return false;
-    }
-    if (!isWithinVisibilityTime(row.created_at, visibility)) {
-        return false;
-    }
-    const scopes = visibility.scopes;
-    if (!hasScopes(scopes)) {
-        return true;
-    }
-    return scopes.some((scope) => row.scope_kind === scope.kind && row.scope_id === scope.id);
-}
-function isTwinRefVisible(adapter, ref, visibility, visitedEdges, edgeCache) {
-    if (ref.kind === 'entity') {
-        return isEntityVisible(adapter, ref.id, visibility);
-    }
-    if (ref.kind === 'report') {
-        return !hasScopes(visibility.scopes);
-    }
-    if (ref.kind === 'memory') {
-        return isMemoryVisible(adapter, ref.id, visibility);
-    }
-    if (ref.kind === 'case') {
-        return isCaseVisible(adapter, ref.id, visibility);
-    }
-    if (ref.kind === 'raw') {
-        return isRawVisible(adapter, ref.id, visibility);
-    }
-    if (visitedEdges.has(ref.id)) {
-        return false;
-    }
-    let edge = edgeCache.get(ref.id);
-    if (edge === undefined) {
-        edge = (0, store_js_1.getTwinEdge)(adapter, ref.id);
-        edgeCache.set(ref.id, edge);
-    }
-    if (!edge) {
-        return false;
-    }
-    if (!isWithinVisibilityTime(edge.created_at, visibility)) {
-        return false;
-    }
-    const pathWithCurrent = new Set(visitedEdges);
-    pathWithCurrent.add(ref.id);
-    return (isTwinRefVisible(adapter, edge.subject_ref, visibility, new Set(pathWithCurrent), edgeCache) &&
-        isTwinRefVisible(adapter, edge.object_ref, visibility, new Set(pathWithCurrent), edgeCache));
-}
-function assertTwinRefsVisible(adapter, refs, visibility = {}) {
-    const edgeCache = new Map();
-    for (const ref of refs) {
-        if (!isTwinRefVisible(adapter, ref, visibility, new Set(), edgeCache)) {
-            throw new Error(`Twin ref is not visible to requested visibility: ${ref.kind}:${ref.id}`);
-        }
-    }
-}
-function listVisibleTwinEdgesForRefs(adapter, refs, options = {}) {
-    const edgeCache = new Map();
-    const edgeTypes = normalizeEdgeTypes(options.edgeTypes);
-    const edges = (0, store_js_1.listTwinEdgesForRefs)(adapter, refs).filter((edge) => (edgeTypes.size === 0 || edgeTypes.has(edge.edge_type)) &&
-        (typeof options.startMs !== 'number' || edge.created_at >= options.startMs) &&
-        (typeof options.asOfMs !== 'number' || edge.created_at <= options.asOfMs) &&
-        isTwinRefVisible(adapter, edge.subject_ref, options, new Set(), edgeCache) &&
-        isTwinRefVisible(adapter, edge.object_ref, options, new Set(), edgeCache));
-    const limit = typeof options.limit === 'number' && Number.isFinite(options.limit)
-        ? Math.max(0, Math.floor(options.limit))
-        : null;
-    const sortedEdges = [...edges].sort((left, right) => {
-        const createdDiff = right.created_at - left.created_at;
-        return createdDiff !== 0 ? createdDiff : left.edge_id.localeCompare(right.edge_id);
-    });
-    if (limit === null) {
-        return sortedEdges;
-    }
-    return sortedEdges.slice(0, limit);
-}
-function normalizeEdgeTypes(edgeTypes) {
-    if (!Array.isArray(edgeTypes) || edgeTypes.length === 0) {
-        return new Set();
-    }
-    return new Set(edgeTypes);
-}
-//# sourceMappingURL=ref-validation.js.map

package/dist/edges/store.d.ts

@@ -1,8 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import { type TwinEdgeRecord, type TwinRef } from './types.js';
-type TwinEdgeReadAdapter = Pick<DatabaseAdapter, 'prepare'>;
-export declare function mapTwinEdgeRow(row: Record<string, unknown>): TwinEdgeRecord;
-export declare function getTwinEdge(adapter: TwinEdgeReadAdapter, edgeId: string): TwinEdgeRecord | null;
-export declare function listTwinEdgesForRefs(adapter: TwinEdgeReadAdapter, refs: readonly TwinRef[]): TwinEdgeRecord[];
-export {};
-//# sourceMappingURL=store.d.ts.map

package/dist/edges/store.js

@@ -1,129 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapTwinEdgeRow = mapTwinEdgeRow;
-exports.getTwinEdge = getTwinEdge;
-exports.listTwinEdgesForRefs = listTwinEdgesForRefs;
-const types_js_1 = require("./types.js");
-const EDGE_TYPE_SET = new Set(types_js_1.TWIN_EDGE_TYPES);
-const REF_KIND_SET = new Set(types_js_1.TWIN_REF_KINDS);
-const SOURCE_SET = new Set(types_js_1.TWIN_EDGE_SOURCES);
-function nullableString(value) {
-    return typeof value === 'string' && value.length > 0 ? value : null;
-}
-function requireNonEmptyString(value, field) {
-    if (typeof value !== 'string' || value.length === 0) {
-        throw new Error(`twin_edges.${field} must be a non-empty string`);
-    }
-    return value;
-}
-function normalizeEdgeType(value) {
-    if (typeof value === 'string' && EDGE_TYPE_SET.has(value)) {
-        return value;
-    }
-    throw new Error(`Unsupported twin edge type: ${String(value)}`);
-}
-function normalizeSource(value) {
-    if (typeof value === 'string' && SOURCE_SET.has(value)) {
-        return value;
-    }
-    throw new Error(`Unsupported twin edge source: ${String(value)}`);
-}
-function normalizeRef(ref, field) {
-    if (!ref || typeof ref !== 'object') {
-        throw new Error(`${field} must be a TwinRef`);
-    }
-    if (!REF_KIND_SET.has(ref.kind)) {
-        throw new Error(`${field}.kind is unsupported: ${String(ref.kind)}`);
-    }
-    return {
-        kind: ref.kind,
-        id: requireNonEmptyString(ref.id, `${field}.id`),
-    };
-}
-function parseJsonField(value, field, edgeId) {
-    if (value === null || value === undefined) {
-        return null;
-    }
-    const text = String(value);
-    if (text.length === 0) {
-        return null;
-    }
-    try {
-        return JSON.parse(text);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Invalid twin_edges.${field} for ${edgeId}: ${message}`);
-    }
-}
-function toBuffer(value) {
-    if (Buffer.isBuffer(value)) {
-        return value;
-    }
-    if (value instanceof Uint8Array) {
-        return Buffer.from(value);
-    }
-    throw new Error('twin_edges.content_hash must be a 32-byte Buffer');
-}
-function mapTwinEdgeRow(row) {
-    const edgeId = String(row.edge_id);
-    return {
-        edge_id: edgeId,
-        edge_type: normalizeEdgeType(row.edge_type),
-        subject_ref: {
-            kind: String(row.subject_kind),
-            id: String(row.subject_id),
-        },
-        object_ref: {
-            kind: String(row.object_kind),
-            id: String(row.object_id),
-        },
-        relation_attrs_json: nullableString(row.relation_attrs_json),
-        relation_attrs: parseJsonField(row.relation_attrs_json, 'relation_attrs_json', edgeId),
-        confidence: Number(row.confidence),
-        source: normalizeSource(row.source),
-        agent_id: nullableString(row.agent_id),
-        model_run_id: nullableString(row.model_run_id),
-        envelope_hash: nullableString(row.envelope_hash),
-        human_actor_id: nullableString(row.human_actor_id),
-        human_actor_role: nullableString(row.human_actor_role),
-        authority_scope_json: nullableString(row.authority_scope_json),
-        authority_scope: parseJsonField(row.authority_scope_json, 'authority_scope_json', edgeId),
-        reason_classification: nullableString(row.reason_classification),
-        reason_text: nullableString(row.reason_text),
-        evidence_refs_json: nullableString(row.evidence_refs_json),
-        evidence_refs: parseJsonField(row.evidence_refs_json, 'evidence_refs_json', edgeId),
-        request_idempotency_key: nullableString(row.request_idempotency_key),
-        edge_idempotency_key: nullableString(row.edge_idempotency_key),
-        content_hash: toBuffer(row.content_hash),
-        created_at: Number(row.created_at),
-    };
-}
-function getTwinEdge(adapter, edgeId) {
-    const row = adapter.prepare('SELECT * FROM twin_edges WHERE edge_id = ?').get(edgeId);
-    return row ? mapTwinEdgeRow(row) : null;
-}
-function listTwinEdgesForRefs(adapter, refs) {
-    const normalizedRefs = refs.map((ref, index) => normalizeRef(ref, `refs[${index}]`));
-    if (normalizedRefs.length === 0) {
-        return [];
-    }
-    const clauses = [];
-    const params = [];
-    for (const ref of normalizedRefs) {
-        clauses.push('(subject_kind = ? AND subject_id = ?)');
-        params.push(ref.kind, ref.id);
-        clauses.push('(object_kind = ? AND object_id = ?)');
-        params.push(ref.kind, ref.id);
-    }
-    const rows = adapter
-        .prepare(`
-        SELECT *
-        FROM twin_edges
-        WHERE ${clauses.join(' OR ')}
-        ORDER BY created_at ASC, edge_id ASC
-      `)
-        .all(...params);
-    return rows.map(mapTwinEdgeRow);
-}
-//# sourceMappingURL=store.js.map

package/dist/embedding-client.d.ts

@@ -1,28 +0,0 @@
-/**
- * MAMA Embedding Client
- *
- * HTTP client for the embedding server running in MCP server.
- * Used by hooks for fast embedding generation.
- *
- * Features:
- * - Auto-discovery via port file
- * - Timeout handling
- * - Fallback to local embedding when server unavailable
- *
- * @module embedding-client
- */
-export declare const DEFAULT_PORT: number;
-export declare const HOST = "127.0.0.1";
-export declare const TIMEOUT_MS = 500;
-export declare const PORT_FILE: string;
-export interface ServerStatus {
-    status: string;
-    model?: string;
-    dimension?: number;
-    uptime?: number;
-}
-/**
- * Get server port from port file or default
- */
-export declare function getServerPort(): number;
-//# sourceMappingURL=embedding-client.d.ts.map

package/dist/embedding-client.js

@@ -1,53 +0,0 @@
-"use strict";
-/**
- * MAMA Embedding Client
- *
- * HTTP client for the embedding server running in MCP server.
- * Used by hooks for fast embedding generation.
- *
- * Features:
- * - Auto-discovery via port file
- * - Timeout handling
- * - Fallback to local embedding when server unavailable
- *
- * @module embedding-client
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PORT_FILE = exports.TIMEOUT_MS = exports.HOST = exports.DEFAULT_PORT = void 0;
-exports.getServerPort = getServerPort;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-function resolveConfiguredPort() {
-    const rawPort = process.env.MAMA_EMBEDDING_PORT || process.env.MAMA_HTTP_PORT || '';
-    const parsedPort = parseInt(rawPort, 10);
-    if (Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort < 65536) {
-        return parsedPort;
-    }
-    return 3849;
-}
-// Configuration
-exports.DEFAULT_PORT = resolveConfiguredPort();
-exports.HOST = '127.0.0.1';
-exports.TIMEOUT_MS = 500; // 500ms timeout for fast response
-exports.PORT_FILE = path_1.default.join(process.env.HOME || '/tmp', '.mama-embedding-port');
-/**
- * Get server port from port file or default
- */
-function getServerPort() {
-    try {
-        if (fs_1.default.existsSync(exports.PORT_FILE)) {
-            const port = parseInt(fs_1.default.readFileSync(exports.PORT_FILE, 'utf8').trim(), 10);
-            if (port > 0 && port < 65536) {
-                return port;
-            }
-        }
-    }
-    catch {
-        // Ignore errors, use default
-    }
-    return exports.DEFAULT_PORT;
-}
-//# sourceMappingURL=embedding-client.js.map

package/dist/embedding-server/index.d.ts

@@ -1,67 +0,0 @@
-/**
- * MAMA Embedding HTTP Server
- *
- * HTTP API for embedding generation, integrated with MCP server.
- * Provides fast embedding access for Claude Code hooks.
- *
- * Features:
- * - Model stays loaded in memory (singleton)
- * - HTTP API at localhost:${MAMA_EMBEDDING_PORT || MAMA_HTTP_PORT || 3849}
- * - Health check endpoint
- * - Shared model with MCP server
- *
- * @module embedding-http-server
- */
-import type { IncomingMessage, ServerResponse, Server as HTTPServer } from 'http';
-export declare const SHUTDOWN_TOKEN: string;
-import type { EmbeddingRole } from '../embeddings.js';
-export declare const DEFAULT_PORT: number;
-export declare const HOST = "127.0.0.1";
-export declare const PORT_FILE: string;
-/**
- * Request handler type
- */
-type RequestHandler = (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
-/**
- * MessageRouter interface
- */
-interface MessageRouter {
-    process(message: unknown): Promise<unknown>;
-}
-/**
- * SessionStore interface
- */
-interface SessionStore {
-    getHistory?(sessionId: string): unknown[];
-    getHistoryByChannel?(source: string, channelId: string): unknown[];
-}
-/**
- * Server options
- */
-export interface ServerOptions {
-    messageRouter?: MessageRouter;
-    sessionStore?: SessionStore;
-    graphHandler?: RequestHandler;
-}
-export declare function resolveEmbeddingRole(raw: unknown): EmbeddingRole;
-/**
- * Clean up port file on exit
- */
-export declare function cleanupPortFile(): void;
-/**
- * Start the HTTP embedding server
- *
- * @param port - Port to listen on (default: DEFAULT_PORT)
- * @returns HTTP server instance
- */
-export declare function startEmbeddingServer(port?: number, options?: ServerOptions): Promise<HTTPServer | null>;
-/**
- * Pre-warm the embedding model
- */
-export declare function warmModel(): Promise<{
-    success: boolean;
-    latency?: number;
-    error?: string;
-}>;
-export {};
-//# sourceMappingURL=index.d.ts.map