@jungjaehoon/mama-core 1.4.2 → 1.6.0

package/dist/search/search-quality.d.ts

@@ -0,0 +1,36 @@
+export type SearchStrictness = 'recall' | 'balanced' | 'strict';
+export interface SearchQualityOptions {
+    threshold?: number;
+    strict?: boolean;
+    strictness?: SearchStrictness;
+    disableRecency?: boolean;
+    includeRelated?: boolean;
+    topicPrefix?: string;
+    minLexicalSupport?: boolean;
+    diagnostics?: boolean;
+}
+export interface NormalizedSearchQualityOptions {
+    threshold: number;
+    strictness: SearchStrictness;
+    disableRecency: boolean;
+    includeRelated: boolean;
+    topicPrefix?: string;
+    minLexicalSupport: boolean;
+    diagnostics: boolean;
+}
+export interface SearchHitDiagnostics {
+    retrieval_source: string;
+    vector_similarity: number | null;
+    lexical_support: boolean;
+    entity_support: boolean;
+    scope_support: boolean;
+    graph_source: 'primary' | 'expanded' | null;
+    is_vector_only: boolean;
+    /** Relevance confirmations only: never include scope or graph position here. */
+    confirmation_signals: string[];
+    /** Non-relevance metadata useful for diagnostics and audit output. */
+    metadata_signals: string[];
+    candidate_threshold_used: number;
+}
+export declare function normalizeSearchQualityOptions(options?: SearchQualityOptions): NormalizedSearchQualityOptions;
+//# sourceMappingURL=search-quality.d.ts.map

package/dist/search/search-quality.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSearchQualityOptions = normalizeSearchQualityOptions;
+function normalizeSearchQualityOptions(options = {}) {
+    // Validate strictness at runtime — untyped callers can otherwise pass invalid
+    // strings that silently fall through and skew filtering.
+    const strictnessCandidate = options.strict === true ? 'strict' : options.strictness;
+    const strictness = strictnessCandidate === 'strict' ||
+        strictnessCandidate === 'balanced' ||
+        strictnessCandidate === 'recall'
+        ? strictnessCandidate
+        : 'recall';
+    const defaultThreshold = strictness === 'strict' ? 0.6 : strictness === 'balanced' ? 0.45 : 0.3;
+    const rawThreshold = typeof options.threshold === 'number' ? options.threshold : defaultThreshold;
+    // Clamp threshold to [0, 1]; fall back to default for non-finite values (NaN, ±Inf).
+    const threshold = Number.isFinite(rawThreshold)
+        ? Math.min(1, Math.max(0, rawThreshold))
+        : defaultThreshold;
+    return {
+        threshold,
+        strictness,
+        disableRecency: options.disableRecency === true,
+        includeRelated: options.includeRelated ?? strictness !== 'strict',
+        topicPrefix: options.topicPrefix,
+        minLexicalSupport: options.minLexicalSupport ?? strictness !== 'recall',
+        diagnostics: options.diagnostics === true,
+    };
+}
+//# sourceMappingURL=search-quality.js.map

package/dist/test-utils.d.ts

@@ -7,6 +7,20 @@
  * @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)
  *

package/dist/test-utils.js

@@ -12,6 +12,9 @@ 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;
@@ -22,8 +25,57 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,7 +26,32 @@
     "./time-formatter": "./dist/time-formatter.js",
     "./outcome-tracker": "./dist/outcome-tracker.js",
     "./query-intent": "./dist/query-intent.js",
-    "./test-utils": "./dist/test-utils.js"
+    "./test-utils": "./dist/test-utils.js",
+    "./entities/store": "./dist/entities/store.js",
+    "./entities/candidate-generator": "./dist/entities/candidate-generator.js",
+    "./canonicalize": "./dist/canonicalize.js",
+    "./cases/types": "./dist/cases/types.js",
+    "./cases/store": "./dist/cases/store.js",
+    "./cases/role-inference": "./dist/cases/role-inference.js",
+    "./cases/target-ref": "./dist/cases/target-ref.js",
+    "./cases/corrections": "./dist/cases/corrections.js",
+    "./cases/sqlite-transaction": "./dist/cases/sqlite-transaction.js",
+    "./cases/live-state": "./dist/cases/live-state.js",
+    "./cases/tombstone-sweeper": "./dist/cases/tombstone-sweeper.js",
+    "./cases/merge-split": "./dist/cases/merge-split.js",
+    "./cases/membership-matcher": "./dist/cases/membership-matcher.js",
+    "./cases/search-rollup": "./dist/cases/search-rollup.js",
+    "./cases/timeline-range": "./dist/cases/timeline-range.js",
+    "./cases/wiki-page-index": "./dist/cases/wiki-page-index.js",
+    "./connectors": "./dist/connectors/event-index.js",
+    "./connectors/event-index": "./dist/connectors/event-index.js",
+    "./connectors/raw-query": "./dist/connectors/raw-query.js",
+    "./connectors/types": "./dist/connectors/types.js",
+    "./agent-situation": "./dist/agent-situation/index.js",
+    "./agent-graph": "./dist/agent-graph/index.js",
+    "./edges/types": "./dist/edges/types.js",
+    "./edges/store": "./dist/edges/store.js",
+    "./edges/ref-validation": "./dist/edges/ref-validation.js"
   },
   "scripts": {
     "build": "tsc",
@@ -71,7 +96,7 @@
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
-    "typescript": "^5.4.0",
+    "typescript": "^5.9.3",
     "vitest": "^1.0.0"
   },
   "files": [