@jungjaehoon/mama-core 1.9.0 → 2.1.0

package/dist/provenance/source-ref.js

@@ -1,13 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LEGACY_SOURCE_REF_KINDS = exports.STRICT_SOURCE_REF_KINDS = void 0;
-exports.fromContextRef = fromContextRef;
-exports.toContextRef = toContextRef;
-exports.fromVerifyArtifact = fromVerifyArtifact;
-exports.parseSourceRefString = parseSourceRefString;
 exports.serializeSourceRef = serializeSourceRef;
-exports.assertNonEmptySourceRefs = assertNonEmptySourceRefs;
-const types_js_1 = require("../context-compile/types.js");
 exports.STRICT_SOURCE_REF_KINDS = [
     'memory',
     'raw',
@@ -25,17 +19,7 @@ exports.STRICT_SOURCE_REF_KINDS = [
 ];
 exports.LEGACY_SOURCE_REF_KINDS = ['message', 'conversation', 'raw_memory'];
 const STRICT_SOURCE_REF_KIND_SET = new Set(exports.STRICT_SOURCE_REF_KINDS);
-const CONTEXT_REF_KIND_SET = new Set(types_js_1.CONTEXT_REF_KINDS);
 const LEGACY_SOURCE_REF_KIND_SET = new Set(exports.LEGACY_SOURCE_REF_KINDS);
-const VERIFY_ARTIFACT_KIND_SET = new Set([
-    'decision',
-    'os_task',
-    'agent_situation_packet',
-    'report_slot',
-    'context_packet',
-    'model_run',
-    'tool_trace',
-]);
 function requiredString(value, field) {
     if (typeof value !== 'string') {
         throw new Error(`Source ref ${field} must be a string`);
@@ -46,18 +30,6 @@ function requiredString(value, field) {
     }
     return trimmed;
 }
-function optionalString(value, field) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return requiredString(value, field);
-}
-function optionalNullableString(value, field) {
-    if (value === null) {
-        return null;
-    }
-    return optionalString(value, field);
-}
 function assertStrictSourceRefKind(kind) {
     if (!STRICT_SOURCE_REF_KIND_SET.has(kind)) {
         throw new Error(`Unsupported source ref kind: ${kind}`);
@@ -68,115 +40,6 @@ function assertLegacySourceRefKind(kind) {
         throw new Error(`Unsupported legacy source ref kind: ${kind}`);
     }
 }
-function assertContextSourceRefKind(kind) {
-    if (kind === 'raw' || !CONTEXT_REF_KIND_SET.has(kind)) {
-        throw new Error(`Unsupported context source ref kind: ${kind}`);
-    }
-}
-function fromContextRef(ref) {
-    if (ref === null || ref === undefined) {
-        throw new Error('Context ref must not be null or undefined');
-    }
-    const input = ref;
-    const kind = requiredString(input.kind, 'kind');
-    if (kind === 'raw') {
-        const normalized = {
-            kind: 'raw',
-            id: requiredString(input.raw_id, 'raw_id'),
-            connector: requiredString(input.connector, 'connector'),
-        };
-        const sourceId = optionalString(input.source_id, 'source_id');
-        const channelId = optionalNullableString(input.channel_id, 'channel_id');
-        if (sourceId !== undefined) {
-            normalized.source_id = sourceId;
-        }
-        if (channelId !== undefined) {
-            normalized.channel_id = channelId;
-        }
-        return normalized;
-    }
-    assertContextSourceRefKind(kind);
-    return {
-        kind,
-        id: requiredString(input.id, 'id'),
-    };
-}
-function toContextRef(ref) {
-    if (ref === null || ref === undefined) {
-        return null;
-    }
-    switch (ref.kind) {
-        case 'memory':
-        case 'entity':
-        case 'case':
-            return {
-                kind: ref.kind,
-                id: requiredString(ref.id, 'id'),
-            };
-        case 'raw': {
-            const normalized = {
-                kind: 'raw',
-                raw_id: requiredString(ref.id, 'id'),
-                connector: requiredString(ref.connector, 'connector'),
-            };
-            const sourceId = optionalString(ref.source_id, 'source_id');
-            const channelId = optionalNullableString(ref.channel_id, 'channel_id');
-            if (sourceId !== undefined) {
-                normalized.source_id = sourceId;
-            }
-            if (channelId !== undefined) {
-                normalized.channel_id = channelId;
-            }
-            return normalized;
-        }
-        default:
-            return null;
-    }
-}
-function fromVerifyArtifact(artifact) {
-    if (artifact === null || artifact === undefined) {
-        throw new Error('Artifact must not be null or undefined');
-    }
-    const kind = requiredString(artifact.type, 'type');
-    if (!VERIFY_ARTIFACT_KIND_SET.has(kind)) {
-        throw new Error(`Unsupported verify artifact source ref kind: ${kind}`);
-    }
-    assertStrictSourceRefKind(kind);
-    if (kind === 'raw') {
-        throw new Error('Verify artifact source refs cannot use raw kind');
-    }
-    return {
-        kind,
-        id: requiredString(artifact.id, 'id'),
-    };
-}
-function parseSourceRefString(value) {
-    const rawValue = requiredString(value, 'value');
-    const parts = rawValue.split(':');
-    const kind = requiredString(parts[0], 'kind');
-    if (kind === 'raw') {
-        const connector = requiredString(parts[1], 'connector');
-        const id = requiredString(parts.slice(2).join(':'), 'id');
-        return { kind: 'raw', connector, id };
-    }
-    if (LEGACY_SOURCE_REF_KIND_SET.has(kind)) {
-        assertLegacySourceRefKind(kind);
-        return {
-            kind: 'legacy',
-            legacy_kind: kind,
-            id: requiredString(parts.slice(1).join(':'), 'id'),
-        };
-    }
-    assertStrictSourceRefKind(kind);
-    if (kind === 'raw') {
-        throw new Error('Raw source refs must include connector and id');
-    }
-    const sourceKind = kind;
-    return {
-        kind: sourceKind,
-        id: requiredString(parts.slice(1).join(':'), 'id'),
-    };
-}
 function serializeSourceRef(ref) {
     if (ref === null || ref === undefined) {
         throw new Error('Source ref must not be null or undefined');
@@ -193,12 +56,4 @@ function serializeSourceRef(ref) {
         }
     }
 }
-function assertNonEmptySourceRefs(refs) {
-    if (!Array.isArray(refs) || refs.length === 0) {
-        throw new Error('Source refs must not be empty');
-    }
-    for (const ref of refs) {
-        serializeSourceRef(ref);
-    }
-}
 //# sourceMappingURL=source-ref.js.map

package/dist/query-intent.d.ts

@@ -20,8 +20,4 @@ export interface AnalyzeOptions {
  * Analyze user message for decision-related intent
  */
 export declare function analyzeIntent(userMessage: string, options?: AnalyzeOptions): Promise<IntentResult>;
-/**
- * Extract topic keywords from user message (fallback method)
- */
-export declare function extractTopicKeywords(userMessage: string): IntentResult;
 //# sourceMappingURL=query-intent.d.ts.map

package/dist/query-intent.js

@@ -9,7 +9,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeIntent = analyzeIntent;
-exports.extractTopicKeywords = extractTopicKeywords;
 const debug_logger_js_1 = require("./debug-logger.js");
 const ollama_client_js_1 = require("./ollama-client.js");
 /**
@@ -112,33 +111,4 @@ async function generateWithFallback(prompt, options = {}) {
     // Unreachable: loop always returns or throws
     throw new Error('Unexpected: all LLM tiers exhausted without result');
 }
-/**
- * Extract topic keywords from user message (fallback method)
- */
-function extractTopicKeywords(userMessage) {
-    const topicPatterns = {
-        workflow_storage: /workflow|save|persist/i,
-        mesh_structure: /mesh|structure/i,
-        authentication: /auth|jwt|oauth|login/i,
-        testing: /test|jest|spec/i,
-        architecture: /architecture|design/i,
-        coding_style: /style|format|coding/i,
-    };
-    for (const [topic, pattern] of Object.entries(topicPatterns)) {
-        if (pattern.test(userMessage)) {
-            return {
-                involves_decision: true,
-                topic,
-                confidence: 0.5, // Lower confidence for keyword matching
-                reasoning: 'Keyword-based detection (LLM fallback)',
-            };
-        }
-    }
-    return {
-        involves_decision: false,
-        topic: null,
-        confidence: 0.0,
-        reasoning: 'No topic keywords found',
-    };
-}
 //# sourceMappingURL=query-intent.js.map

package/dist/relevance-scorer.d.ts

@@ -112,13 +112,4 @@ export interface TestResult {
     calculated: string;
     pass: boolean;
 }
-/**
- * Test relevance scoring with sample decisions
- *
- * Task 1.4: Test relevance scoring with sample decisions
- * AC #1, #4: Verify scoring formula and failure priority
- *
- * @returns Test results
- */
-export declare function testRelevanceScoring(): TestResult[];
 //# sourceMappingURL=relevance-scorer.d.ts.map

package/dist/relevance-scorer.js

@@ -14,7 +14,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculateRelevance = calculateRelevance;
 exports.selectTopDecisions = selectTopDecisions;
 exports.formatTopNContext = formatTopNContext;
-exports.testRelevanceScoring = testRelevanceScoring;
 const embeddings_js_1 = require("./embeddings.js");
 /**
  * Outcome weights for importance scoring
@@ -160,84 +159,4 @@ function formatTopNContext(decisions, topN = 3) {
     }
     return { full, summary };
 }
-/**
- * Test relevance scoring with sample decisions
- *
- * Task 1.4: Test relevance scoring with sample decisions
- * AC #1, #4: Verify scoring formula and failure priority
- *
- * @returns Test results
- */
-function testRelevanceScoring() {
-    const now = Date.now();
-    // Mock embeddings (dummy for testing)
-    const queryEmbedding = new Float32Array(384).fill(0.5);
-    const decisionEmbedding1 = new Float32Array(384).fill(0.5); // Identical (similarity = 1.0)
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const _decisionEmbedding2 = new Float32Array(384).fill(0.3); // Different (similarity < 1.0)
-    const scenarios = [
-        // Scenario 1: Recent FAILED decision (should have highest relevance)
-        {
-            name: 'Recent FAILED decision',
-            decision: {
-                created_at: now - 5 * 24 * 60 * 60 * 1000, // 5 days ago
-                outcome: 'FAILED',
-                embedding: decisionEmbedding1,
-                decision: 'test decision',
-            },
-            queryContext: { embedding: queryEmbedding },
-            expected: {
-                recency: 0.85, // exp(-5/30) ≈ 0.85
-                importance: 1.0, // FAILED = 1.0 (AC #4)
-                semantic: 1.0, // Identical embeddings
-                relevance: 0.87, // (0.85×0.2) + (1.0×0.5) + (1.0×0.3)
-            },
-        },
-        // Scenario 2: Recent SUCCESS decision (lower importance)
-        {
-            name: 'Recent SUCCESS decision',
-            decision: {
-                created_at: now - 5 * 24 * 60 * 60 * 1000, // 5 days ago
-                outcome: 'SUCCESS',
-                embedding: decisionEmbedding1,
-                decision: 'test decision',
-            },
-            queryContext: { embedding: queryEmbedding },
-            expected: {
-                recency: 0.85,
-                importance: 0.5, // SUCCESS = 0.5
-                semantic: 1.0,
-                relevance: 0.62, // (0.85×0.2) + (0.5×0.5) + (1.0×0.3)
-            },
-        },
-        // Scenario 3: Old FAILED decision (recency decay)
-        {
-            name: 'Old FAILED decision',
-            decision: {
-                created_at: now - 60 * 24 * 60 * 60 * 1000, // 60 days ago
-                outcome: 'FAILED',
-                embedding: decisionEmbedding1,
-                decision: 'test decision',
-            },
-            queryContext: { embedding: queryEmbedding },
-            expected: {
-                recency: 0.25, // exp(-60/30) ≈ 0.25
-                importance: 1.0,
-                semantic: 1.0,
-                relevance: 0.85, // (0.25×0.2) + (1.0×0.5) + (1.0×0.3)
-            },
-        },
-    ];
-    const results = scenarios.map((scenario) => {
-        const calculated = calculateRelevance(scenario.decision, scenario.queryContext);
-        const pass = Math.abs(calculated - scenario.expected.relevance) < 0.05;
-        return {
-            name: scenario.name,
-            expected: scenario.expected.relevance.toFixed(2),
-            calculated: calculated.toFixed(2),
-            pass,
-        };
-    });
-    return results;
-}
 //# sourceMappingURL=relevance-scorer.js.map

package/dist/search/feedback-store.d.ts

@@ -51,7 +51,6 @@ export interface FeedbackStoreAdapter {
     };
     transaction?<T>(fn: () => T): T | (() => T);
 }
-export declare function hashQuery(query: string): string;
 export declare function getFeedbackRetentionDays(adapter: FeedbackStoreAdapter): number;
 export declare function compactShownSearchFeedback(adapter: FeedbackStoreAdapter, retentionDays?: number): number;
 export declare function recordSearchFeedback(adapter: FeedbackStoreAdapter, input: SearchFeedbackInput): RecordSearchFeedbackResult;

package/dist/search/feedback-store.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hashQuery = hashQuery;
 exports.getFeedbackRetentionDays = getFeedbackRetentionDays;
 exports.compactShownSearchFeedback = compactShownSearchFeedback;
 exports.recordSearchFeedback = recordSearchFeedback;
@@ -18,9 +17,6 @@ function fullQueryHashHex(query) {
 function fullQueryHashBuffer(query) {
     return Buffer.from(fullQueryHashHex(query), 'hex');
 }
-function hashQuery(query) {
-    return fullQueryHashHex(query).slice(0, 16);
-}
 function assertNonEmpty(value, field) {
     if (!value || value.trim().length === 0) {
         throw new Error(`${field} is required`);

package/dist/search/ranker-rescore.d.ts

@@ -1,5 +1,4 @@
 import type { RunResult } from '../db-adapter/statement.js';
-import { type SearchRankerModel } from './ranker-trainer.js';
 export type SearchRankerSkippedReason = 'feature_disabled' | 'no_active_model' | 'feature_set_mismatch' | 'quality_gate_failed' | 'insufficient_result_count' | 'llm_reranking_requested';
 export interface RankerRescoreAdapter {
     prepare(sql: string): {
@@ -24,8 +23,6 @@ export interface RescoreSearchResultsResult<T> {
     model_id: string | null;
     skipped_reason?: SearchRankerSkippedReason;
 }
-export declare function loadActiveSearchRankerModel(adapter: RankerRescoreAdapter): SearchRankerModel | null;
 export declare function isSearchRankerEnabled(adapter: RankerRescoreAdapter): boolean;
 export declare function rescoreSearchResults<T extends Record<string, unknown>>(adapter: RankerRescoreAdapter, options: RescoreSearchResultsOptions<T>): RescoreSearchResultsResult<T>;
-export declare function logisticScoreForRow(model: SearchRankerModel, row: Record<string, unknown>, query: string): number;
 //# sourceMappingURL=ranker-rescore.d.ts.map

package/dist/search/ranker-rescore.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadActiveSearchRankerModel = loadActiveSearchRankerModel;
 exports.isSearchRankerEnabled = isSearchRankerEnabled;
 exports.rescoreSearchResults = rescoreSearchResults;
-exports.logisticScoreForRow = logisticScoreForRow;
 const ranker_features_js_1 = require("./ranker-features.js");
 const ranker_trainer_js_1 = require("./ranker-trainer.js");
 const question_type_js_1 = require("./question-type.js");
@@ -78,17 +76,6 @@ function logSkipped(reason, modelId) {
         feature_set_version: ranker_features_js_1.SEARCH_RANKER_FEATURE_SET_VERSION,
     }));
 }
-function loadActiveSearchRankerModel(adapter) {
-    const row = loadActiveRow(adapter);
-    if (!row) {
-        return null;
-    }
-    if (row.feature_set_version !== ranker_features_js_1.SEARCH_RANKER_FEATURE_SET_VERSION) {
-        logSkipped('feature_set_mismatch', row.model_id);
-        return null;
-    }
-    return modelFromRow(row);
-}
 function isSearchRankerEnabled(adapter) {
     const row = adapter
         .prepare(`
@@ -209,18 +196,4 @@ function rescoreSearchResults(adapter, options) {
         model_id: model.model_id,
     };
 }
-function logisticScoreForRow(model, row, query) {
-    const questionType = (0, question_type_js_1.classifyQuestionType)(query);
-    const features = (0, ranker_features_js_1.serializeFeatures)((0, ranker_features_js_1.extractFeatures)(row, query, { question_type: questionType }));
-    const coefficients = model.question_type_weights[questionType] ?? model.coefficients;
-    let score = model.intercept;
-    for (let index = 0; index < Math.min(coefficients.length, features.length); index += 1) {
-        score += coefficients[index] * features[index];
-    }
-    if (score >= 35)
-        return 1;
-    if (score <= -35)
-        return 0;
-    return 1 / (1 + Math.exp(-score));
-}
 //# sourceMappingURL=ranker-rescore.js.map

package/dist/search/ranker-trainer.d.ts

@@ -75,20 +75,12 @@ interface QualityFixture {
     candidates: QualityCandidate[];
 }
 export declare const RANKER_QUALITY_FIXTURES: readonly QualityFixture[];
-export declare function trainOfflineRanker(input: RankerTrainerInput): Promise<TrainOfflineRankerResult>;
 export declare function scoreWithRankerModel(model: SearchRankerModel, row: Record<string, unknown>, query: string, questionType: QuestionType): number;
-export declare function evaluateAgainstBaselines(_input: RankerTrainerInput, model: SearchRankerModel): Promise<RankerEvaluation>;
-export declare function insertRankerModelVersion(adapter: RankerTrainerAdapter, model: SearchRankerModel, evaluation: RankerEvaluation): Promise<{
-    model_id: string;
-    active: boolean;
-}>;
-export declare function activateRankerModel(adapter: RankerTrainerAdapter, model_id: string): Promise<'activated' | 'quality_gate_failed' | 'feature_set_mismatch' | 'not_found'>;
 export declare function ndcgAtK<T extends {
     id: string;
 }>(results: readonly T[], relevanceMap: Map<string, number>, k: number): number;
 export declare function mrr<T extends {
     id: string;
 }>(results: readonly T[], relevantSet: Set<string>): number;
-export declare function seedQualityFixtureFeedback(adapter: RankerTrainerAdapter, createdAt?: string): void;
 export { SEARCH_RANKER_FEATURE_SET_VERSION, currentFeatureSetVersion as featureSetVersion };
 //# sourceMappingURL=ranker-trainer.d.ts.map