@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/test-utils.d.ts

@@ -1,80 +0,0 @@
-/**
- * MAMA Core Test Utilities
- *
- * Shared test helpers for mama-core consumers.
- * Optimizes test performance by sharing expensive resources (embedding model, DB adapter).
- *
- * @module test-utils
- * @version 1.1
- */
-import type Database from 'better-sqlite3';
-/**
- * Returns migration SQL filenames sorted by their leading three-digit version.
- */
-export declare function migrationFiles(): string[];
-export declare function migrationVersion(file: string): number;
-/**
- * Apply migrations in order up to `maxVersion` (inclusive), starting from
- * `fromVersion`. Mirrors the production runner's two-part contract:
- *   - skip files whose version is already recorded in `schema_version`
- *   - tolerate `duplicate column` errors (legacy migrations that add
- *     columns idempotently without recording into schema_version)
- */
-export declare function applyMigrationsThrough(db: Database.Database, maxVersion: number, fromVersion?: number): void;
-/**
- * Preload embedding model (call once in globalSetup)
- *
- * This loads the embedding model into memory so subsequent tests don't pay the ~2s load time.
- * The model stays in memory due to singleton pattern in embeddings.ts.
- */
-export declare function preloadEmbeddingModel(): Promise<void>;
-/**
- * Create isolated test database
- *
- * Creates a unique test database and sets MAMA_DB_PATH.
- * Use in beforeAll() of each test file.
- *
- * @param testName - Unique test identifier (e.g., 'search-narrative')
- * @returns Test database path
- */
-export declare function initTestDB(testName: string): Promise<string>;
-/**
- * Cleanup test database
- *
- * Call in afterAll() to clean up test database files.
- *
- * @param testDbPath - Path returned by initTestDB
- */
-export declare function cleanupTestDB(testDbPath?: string): Promise<void>;
-/**
- * Cleanup all test databases
- *
- * Call in globalTeardown to clean up all test databases.
- */
-export declare function cleanupAllTestDBs(): void;
-/**
- * Check if embeddings are available
- *
- * Returns false if embedding model failed to load (e.g., CI without ONNX).
- * Use to conditionally skip semantic search tests.
- */
-export declare function isEmbeddingsAvailable(): Promise<boolean>;
-/**
- * Create mock tool context
- *
- * Returns a mock context object for MCP tool tests.
- */
-export declare function createMockToolContext(): {
-    logger: {
-        info: () => void;
-        warn: () => void;
-        error: () => void;
-    };
-};
-/**
- * Suppress console output during tests
- *
- * Returns restore function to call after test.
- */
-export declare function suppressConsole(): () => void;
-//# sourceMappingURL=test-utils.d.ts.map

package/dist/test-utils.js

@@ -1,218 +0,0 @@
-"use strict";
-/**
- * MAMA Core Test Utilities
- *
- * Shared test helpers for mama-core consumers.
- * Optimizes test performance by sharing expensive resources (embedding model, DB adapter).
- *
- * @module test-utils
- * @version 1.1
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.migrationFiles = migrationFiles;
-exports.migrationVersion = migrationVersion;
-exports.applyMigrationsThrough = applyMigrationsThrough;
-exports.preloadEmbeddingModel = preloadEmbeddingModel;
-exports.initTestDB = initTestDB;
-exports.cleanupTestDB = cleanupTestDB;
-exports.cleanupAllTestDBs = cleanupAllTestDBs;
-exports.isEmbeddingsAvailable = isEmbeddingsAvailable;
-exports.createMockToolContext = createMockToolContext;
-exports.suppressConsole = suppressConsole;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const db_manager_js_1 = require("./db-manager.js");
-const debug_logger_js_1 = require("./debug-logger.js");
-const MIGRATIONS_DIR = (0, node_path_1.join)(__dirname, '..', 'db', 'migrations');
-/**
- * Returns migration SQL filenames sorted by their leading three-digit version.
- */
-function migrationFiles() {
-    return (0, node_fs_1.readdirSync)(MIGRATIONS_DIR)
-        .filter((file) => /^\d{3}-.+\.sql$/.test(file))
-        .sort((left, right) => left.localeCompare(right));
-}
-function migrationVersion(file) {
-    return Number.parseInt(file.slice(0, 3), 10);
-}
-/**
- * Apply migrations in order up to `maxVersion` (inclusive), starting from
- * `fromVersion`. Mirrors the production runner's two-part contract:
- *   - skip files whose version is already recorded in `schema_version`
- *   - tolerate `duplicate column` errors (legacy migrations that add
- *     columns idempotently without recording into schema_version)
- */
-function applyMigrationsThrough(db, maxVersion, fromVersion = 1) {
-    for (const file of migrationFiles()) {
-        const version = migrationVersion(file);
-        if (version < fromVersion)
-            continue;
-        if (version > maxVersion)
-            break;
-        let alreadyApplied = false;
-        try {
-            alreadyApplied = !!db
-                .prepare('SELECT 1 FROM schema_version WHERE version = ?')
-                .get(version);
-        }
-        catch {
-            alreadyApplied = false;
-        }
-        if (alreadyApplied)
-            continue;
-        try {
-            db.exec((0, node_fs_1.readFileSync)((0, node_path_1.join)(MIGRATIONS_DIR, file), 'utf8'));
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (!/duplicate column/i.test(msg))
-                throw err;
-        }
-    }
-}
-// Track test databases for cleanup
-const testDatabases = [];
-// Embedding model preload state
-let embeddingModelPreloaded = false;
-/**
- * Preload embedding model (call once in globalSetup)
- *
- * This loads the embedding model into memory so subsequent tests don't pay the ~2s load time.
- * The model stays in memory due to singleton pattern in embeddings.ts.
- */
-async function preloadEmbeddingModel() {
-    if (embeddingModelPreloaded) {
-        return;
-    }
-    try {
-        const { generateEmbedding } = await import('./embeddings.js');
-        await generateEmbedding('preload');
-        embeddingModelPreloaded = true;
-    }
-    catch (error) {
-        // Non-fatal: some CI environments may not have ONNX runtime
-        const message = error instanceof Error ? error.message : String(error);
-        (0, debug_logger_js_1.warn)(`[test-utils] Embedding model preload failed: ${message}`);
-    }
-}
-/**
- * Create isolated test database
- *
- * Creates a unique test database and sets MAMA_DB_PATH.
- * Use in beforeAll() of each test file.
- *
- * @param testName - Unique test identifier (e.g., 'search-narrative')
- * @returns Test database path
- */
-async function initTestDB(testName) {
-    // Reset any existing DB state first
-    (0, db_manager_js_1.resetDBState)({ disconnect: true });
-    // Create unique test database path
-    const testDbPath = path_1.default.join(os_1.default.tmpdir(), `mama-test-${testName}-${Date.now()}.db`);
-    // Clean up any existing files
-    cleanupDbFiles(testDbPath);
-    // Set environment variable
-    process.env.MAMA_DB_PATH = testDbPath;
-    // Track for cleanup
-    testDatabases.push(testDbPath);
-    // Initialize database
-    await (0, db_manager_js_1.initDB)();
-    return testDbPath;
-}
-/**
- * Cleanup test database
- *
- * Call in afterAll() to clean up test database files.
- *
- * @param testDbPath - Path returned by initTestDB
- */
-async function cleanupTestDB(testDbPath) {
-    // Close database connection
-    await (0, db_manager_js_1.closeDB)();
-    // Clean up files
-    if (testDbPath) {
-        cleanupDbFiles(testDbPath);
-    }
-}
-/**
- * Cleanup all test databases
- *
- * Call in globalTeardown to clean up all test databases.
- */
-function cleanupAllTestDBs() {
-    for (const dbPath of testDatabases) {
-        cleanupDbFiles(dbPath);
-    }
-    testDatabases.length = 0;
-}
-/**
- * Helper to clean up SQLite database files
- */
-function cleanupDbFiles(dbPath) {
-    const files = [dbPath, `${dbPath}-wal`, `${dbPath}-shm`];
-    for (const file of files) {
-        try {
-            if (fs_1.default.existsSync(file)) {
-                fs_1.default.unlinkSync(file);
-            }
-        }
-        catch {
-            // Ignore cleanup errors
-        }
-    }
-}
-/**
- * Check if embeddings are available
- *
- * Returns false if embedding model failed to load (e.g., CI without ONNX).
- * Use to conditionally skip semantic search tests.
- */
-async function isEmbeddingsAvailable() {
-    try {
-        const { generateEmbedding } = await import('./embeddings.js');
-        await generateEmbedding('test');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Create mock tool context
- *
- * Returns a mock context object for MCP tool tests.
- */
-function createMockToolContext() {
-    return {
-        logger: {
-            info: () => { },
-            warn: () => { },
-            error: () => { },
-        },
-    };
-}
-/**
- * Suppress console output during tests
- *
- * Returns restore function to call after test.
- */
-function suppressConsole() {
-    const originalLog = console.log;
-    const originalWarn = console.warn;
-    const originalError = console.error;
-    console.log = () => { };
-    console.warn = () => { };
-    console.error = () => { };
-    return () => {
-        console.log = originalLog;
-        console.warn = originalWarn;
-        console.error = originalError;
-    };
-}
-//# sourceMappingURL=test-utils.js.map

package/dist/tier-validator.d.ts

@@ -1,43 +0,0 @@
-/**
- * MAMA Tier Validator
- *
- * Centralized tier validation module for MAMA.
- * Validates system requirements and determines tier status (1 or 2).
- *
- * Tier 1: Full features (Node.js 22.13+, SQLite, Embeddings, Database)
- * Tier 2: Degraded mode (missing one or more requirements)
- *
- * @module tier-validator
- */
-export interface CheckResult {
-    status: 'pass' | 'fail';
-    details: string;
-}
-export interface NamedCheckResult extends CheckResult {
-    name: string;
-}
-export interface TierValidation {
-    tier: 1 | 2;
-    checks: NamedCheckResult[];
-}
-/**
- * Validates Node.js version requirement
- */
-export declare function checkNodeVersion(): CheckResult;
-/**
- * Validates SQLite availability (node:sqlite)
- */
-export declare function checkSQLite(): CheckResult;
-/**
- * Validates embedding model availability
- */
-export declare function checkEmbeddings(): CheckResult;
-/**
- * Validates database file accessibility
- */
-export declare function checkDatabase(): CheckResult;
-/**
- * Get user-friendly tier description
- */
-export declare function getTierDescription(tier: number): string;
-//# sourceMappingURL=tier-validator.d.ts.map

package/dist/tier-validator.js

@@ -1,159 +0,0 @@
-"use strict";
-/**
- * MAMA Tier Validator
- *
- * Centralized tier validation module for MAMA.
- * Validates system requirements and determines tier status (1 or 2).
- *
- * Tier 1: Full features (Node.js 22.13+, SQLite, Embeddings, Database)
- * Tier 2: Degraded mode (missing one or more requirements)
- *
- * @module tier-validator
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkNodeVersion = checkNodeVersion;
-exports.checkSQLite = checkSQLite;
-exports.checkEmbeddings = checkEmbeddings;
-exports.checkDatabase = checkDatabase;
-exports.getTierDescription = getTierDescription;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-/**
- * Validates Node.js version requirement
- */
-function checkNodeVersion() {
-    try {
-        const nodeVersion = process.versions.node;
-        const [majorVersion, minorVersion] = nodeVersion.split('.').map((part) => parseInt(part, 10));
-        if (majorVersion > 22 || (majorVersion === 22 && minorVersion >= 13)) {
-            return {
-                status: 'pass',
-                details: `v${nodeVersion}`,
-            };
-        }
-        return {
-            status: 'fail',
-            details: `v${nodeVersion} (requires 22.13+)`,
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            status: 'fail',
-            details: `Error checking version: ${message}`,
-        };
-    }
-}
-/**
- * Validates SQLite availability (node:sqlite)
- */
-function checkSQLite() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const { DatabaseSync } = require('node:sqlite');
-        const testDb = new DatabaseSync(':memory:');
-        testDb.close();
-        return {
-            status: 'pass',
-            details: 'node:sqlite built-in driver ready',
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            status: 'fail',
-            details: `node:sqlite not available: ${message}`,
-        };
-    }
-}
-/**
- * Validates embedding model availability
- */
-function checkEmbeddings() {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const { getModelName } = require('./embeddings');
-        const modelName = getModelName();
-        // Check if model is cached
-        const cacheDir = process.env.HF_HOME ||
-            process.env.TRANSFORMERS_CACHE ||
-            path_1.default.join(os_1.default.homedir(), '.cache', 'huggingface', 'transformers');
-        // Model cache structure: cache_dir/models--org--model/snapshots/hash/
-        const modelPath = path_1.default.join(cacheDir, `models--${modelName.replace('/', '--')}`);
-        if (fs_1.default.existsSync(modelPath)) {
-            return {
-                status: 'pass',
-                details: `${modelName} (cached)`,
-            };
-        }
-        return {
-            status: 'fail',
-            details: `${modelName} not cached (will download on first use)`,
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            status: 'fail',
-            details: `Error checking embeddings: ${message}`,
-        };
-    }
-}
-/**
- * Validates database file accessibility
- */
-function checkDatabase() {
-    try {
-        const dbPath = process.env.MAMA_DB_PATH || path_1.default.join(os_1.default.homedir(), '.claude', 'mama-memory.db');
-        const dbDir = path_1.default.dirname(dbPath);
-        // Check if directory exists or can be created
-        if (!fs_1.default.existsSync(dbDir)) {
-            try {
-                fs_1.default.mkdirSync(dbDir, { recursive: true });
-            }
-            catch (mkdirErr) {
-                const message = mkdirErr instanceof Error ? mkdirErr.message : String(mkdirErr);
-                return {
-                    status: 'fail',
-                    details: `Cannot create database directory: ${message}`,
-                };
-            }
-        }
-        // Check write access
-        try {
-            fs_1.default.accessSync(dbDir, fs_1.default.constants.W_OK);
-        }
-        catch {
-            return {
-                status: 'fail',
-                details: `No write access to ${dbDir}`,
-            };
-        }
-        return {
-            status: 'pass',
-            details: dbPath,
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            status: 'fail',
-            details: `Error checking database: ${message}`,
-        };
-    }
-}
-/**
- * Get user-friendly tier description
- */
-function getTierDescription(tier) {
-    const descriptions = {
-        1: 'Full Features - All systems operational',
-        2: 'Degraded Mode - Some features unavailable',
-    };
-    return descriptions[tier] || 'Unknown Tier';
-}
-//# sourceMappingURL=tier-validator.js.map

package/dist/time-formatter.d.ts

@@ -1,25 +0,0 @@
-/**
- * Time Formatter - Human-Readable Time Formatting
- *
- * Converts Unix timestamps to human-readable relative time format
- * Examples: "2d ago", "3h ago", "just now"
- *
- * Used by list_decisions and recall_decision tools
- *
- * @module time-formatter
- */
-/**
- * Format Unix timestamp (milliseconds) to human-readable relative time
- *
- * AC #2: Format created_at as human-readable ("2d ago", "3h ago", etc.)
- *
- * @param timestamp - Unix timestamp in milliseconds OR ISO 8601 string
- * @returns Human-readable time string
- *
- * @example
- * formatTimeAgo(Date.now() - 3600000) // "1h ago"
- * formatTimeAgo(Date.now() - 172800000) // "2d ago"
- * formatTimeAgo("2025-11-20T10:30:00Z") // "2d ago" (if today is 2025-11-22)
- */
-export declare function formatTimeAgo(timestamp: number | string | null | undefined): string;
-//# sourceMappingURL=time-formatter.d.ts.map

package/dist/time-formatter.js

@@ -1,93 +0,0 @@
-"use strict";
-/**
- * Time Formatter - Human-Readable Time Formatting
- *
- * Converts Unix timestamps to human-readable relative time format
- * Examples: "2d ago", "3h ago", "just now"
- *
- * Used by list_decisions and recall_decision tools
- *
- * @module time-formatter
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatTimeAgo = formatTimeAgo;
-const debug_logger_js_1 = require("./debug-logger.js");
-/**
- * Format Unix timestamp (milliseconds) to human-readable relative time
- *
- * AC #2: Format created_at as human-readable ("2d ago", "3h ago", etc.)
- *
- * @param timestamp - Unix timestamp in milliseconds OR ISO 8601 string
- * @returns Human-readable time string
- *
- * @example
- * formatTimeAgo(Date.now() - 3600000) // "1h ago"
- * formatTimeAgo(Date.now() - 172800000) // "2d ago"
- * formatTimeAgo("2025-11-20T10:30:00Z") // "2d ago" (if today is 2025-11-22)
- */
-function formatTimeAgo(timestamp) {
-    try {
-        // Handle null/undefined (but allow 0 as valid Unix epoch)
-        if (timestamp === null || timestamp === undefined) {
-            (0, debug_logger_js_1.warn)('[time-formatter] Timestamp is null or undefined, returning "unknown"');
-            return 'unknown';
-        }
-        // Parse ISO 8601 string to timestamp (if string provided)
-        let timestampMs;
-        if (typeof timestamp === 'string') {
-            timestampMs = new Date(timestamp).getTime();
-            if (isNaN(timestampMs)) {
-                (0, debug_logger_js_1.warn)(`[time-formatter] Invalid ISO 8601 string: ${timestamp}`);
-                return 'unknown';
-            }
-        }
-        else {
-            timestampMs = timestamp;
-        }
-        const now = Date.now();
-        const diff = now - timestampMs;
-        // Handle future timestamps (shouldn't happen, but be defensive)
-        if (diff < 0) {
-            (0, debug_logger_js_1.warn)(`[time-formatter] Future timestamp detected: ${timestamp}`);
-            return 'just now';
-        }
-        // Calculate time units
-        const seconds = Math.floor(diff / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        const days = Math.floor(hours / 24);
-        const weeks = Math.floor(days / 7);
-        const months = Math.floor(days / 30);
-        const years = Math.floor(days / 365);
-        // Return human-readable format
-        if (seconds < 60) {
-            return 'just now';
-        }
-        if (minutes < 60) {
-            return `${minutes}m ago`;
-        }
-        if (hours < 24) {
-            return `${hours}h ago`;
-        }
-        if (days < 7) {
-            return `${days}d ago`;
-        }
-        if (weeks < 4) {
-            return `${weeks}w ago`;
-        }
-        // Guard against "0mo ago" when days are 28-29 (months = Math.floor(days/30) = 0)
-        if (months < 1) {
-            return `${weeks}w ago`;
-        }
-        if (months < 12) {
-            return `${months}mo ago`;
-        }
-        return `${years}y ago`;
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        (0, debug_logger_js_1.warn)(`[time-formatter] Error formatting timestamp ${timestamp}: ${message}`);
-        return 'unknown';
-    }
-}
-//# sourceMappingURL=time-formatter.js.map