@pcircle/memesh 2.11.0 → 3.0.1

package/dist/core/operations.js

@@ -0,0 +1,342 @@
+import { getDatabase } from '../db.js';
+import { KnowledgeGraph } from '../knowledge-graph.js';
+import { expandQuery, isExpansionAvailable } from './query-expander.js';
+import { rankEntities } from './scoring.js';
+import { detectCapabilities } from './config.js';
+export function remember(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    const entityId = kg.createEntity(args.name, args.type, {
+        observations: args.observations,
+        tags: args.tags,
+        namespace: args.namespace,
+    });
+    const relationsCreated = [];
+    const relationErrors = [];
+    if (args.relations) {
+        for (const rel of args.relations) {
+            try {
+                kg.createRelation(args.name, rel.to, rel.type);
+                relationsCreated.push(rel);
+            }
+            catch (err) {
+                relationErrors.push(`Relation to "${rel.to}" failed: ${err.message}`);
+            }
+        }
+    }
+    const superseded = [];
+    if (args.relations) {
+        for (const rel of relationsCreated) {
+            if (rel.type === 'supersedes') {
+                const archiveResult = kg.archiveEntity(rel.to);
+                if (archiveResult.archived) {
+                    superseded.push(rel.to);
+                }
+            }
+        }
+    }
+    return {
+        stored: true,
+        entityId,
+        name: args.name,
+        type: args.type,
+        observations: args.observations?.length ?? 0,
+        tags: args.tags?.length ?? 0,
+        relations: relationsCreated.length,
+        ...(superseded.length > 0 ? { superseded } : {}),
+        ...(relationErrors.length > 0 ? { relationErrors } : {}),
+    };
+}
+export function recall(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    const entities = kg.search(args.query, {
+        tag: args.cross_project ? undefined : args.tag,
+        limit: args.limit,
+        includeArchived: args.include_archived,
+        namespace: args.namespace,
+    });
+    const relevanceMap = new Map();
+    for (const e of entities) {
+        relevanceMap.set(e.name, args.query ? 1.0 : 0.5);
+    }
+    return rankEntities(entities, relevanceMap).slice(0, args.limit ?? 20);
+}
+export async function recallEnhanced(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    if (args.query && isExpansionAvailable()) {
+        try {
+            const expandedTerms = await expandQuery(args.query);
+            const allResults = new Map();
+            const relevanceMap = new Map();
+            for (let i = 0; i < expandedTerms.length; i++) {
+                const termRelevance = i === 0 ? 1.0 : 0.7;
+                const results = kg.search(expandedTerms[i], {
+                    tag: args.cross_project ? undefined : args.tag,
+                    limit: args.limit,
+                    includeArchived: args.include_archived,
+                    namespace: args.namespace,
+                });
+                for (const entity of results) {
+                    if (!allResults.has(entity.name)) {
+                        allResults.set(entity.name, entity);
+                    }
+                    const existing = relevanceMap.get(entity.name) ?? 0;
+                    if (termRelevance > existing) {
+                        relevanceMap.set(entity.name, termRelevance);
+                    }
+                }
+            }
+            const merged = [...allResults.values()];
+            return rankEntities(merged, relevanceMap).slice(0, args.limit ?? 20);
+        }
+        catch {
+        }
+    }
+    const entities = kg.search(args.query, {
+        tag: args.cross_project ? undefined : args.tag,
+        limit: args.limit,
+        includeArchived: args.include_archived,
+        namespace: args.namespace,
+    });
+    const relevanceMap = new Map();
+    for (const e of entities) {
+        relevanceMap.set(e.name, args.query ? 1.0 : 0.5);
+    }
+    return rankEntities(entities, relevanceMap).slice(0, args.limit ?? 20);
+}
+export async function consolidate(args) {
+    const caps = detectCapabilities();
+    if (!caps.llm) {
+        return {
+            consolidated: 0,
+            entities_processed: [],
+            observations_before: 0,
+            observations_after: 0,
+            error: 'Consolidation requires an LLM provider. Run: memesh setup',
+        };
+    }
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    const minObs = args.min_observations ?? 5;
+    let entities;
+    if (args.name) {
+        const entity = kg.getEntity(args.name);
+        entities = entity ? [entity] : [];
+    }
+    else if (args.tag) {
+        entities = kg.search(undefined, { tag: args.tag, limit: 100 });
+    }
+    else {
+        entities = kg.listRecent(100);
+    }
+    entities = entities.filter((e) => e.observations.length >= minObs);
+    if (entities.length === 0) {
+        return { consolidated: 0, entities_processed: [], observations_before: 0, observations_after: 0 };
+    }
+    let totalBefore = 0;
+    let totalAfter = 0;
+    const processed = [];
+    for (const entity of entities) {
+        totalBefore += entity.observations.length;
+        try {
+            const compressed = await compressObservations(entity.observations, caps.llm);
+            if (compressed.length < entity.observations.length) {
+                for (const obs of entity.observations) {
+                    kg.removeObservation(entity.name, obs);
+                }
+                kg.createEntity(entity.name, entity.type, {
+                    observations: compressed,
+                });
+                totalAfter += compressed.length;
+                processed.push(entity.name);
+            }
+            else {
+                totalAfter += entity.observations.length;
+            }
+        }
+        catch {
+            totalAfter += entity.observations.length;
+        }
+    }
+    return {
+        consolidated: processed.length,
+        entities_processed: processed,
+        observations_before: totalBefore,
+        observations_after: totalAfter,
+    };
+}
+async function compressObservations(observations, llmConfig) {
+    const prompt = `You have ${observations.length} observations about a topic. ` +
+        `Compress them into 2-3 dense, information-rich sentences that preserve all key facts. ` +
+        `Return ONLY a JSON array of strings, no explanation.\n\n` +
+        `Observations:\n${observations.map((o, i) => `${i + 1}. ${o}`).join('\n')}`;
+    let text;
+    if (llmConfig.provider === 'anthropic') {
+        const apiKey = llmConfig.apiKey || process.env.ANTHROPIC_API_KEY;
+        if (!apiKey)
+            return observations;
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01',
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: llmConfig.model || 'claude-haiku-4-5',
+                max_tokens: 500,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`Anthropic API error: ${response.status}`);
+        const data = await response.json();
+        text = data.content?.[0]?.text || '[]';
+    }
+    else if (llmConfig.provider === 'openai') {
+        const apiKey = llmConfig.apiKey || process.env.OPENAI_API_KEY;
+        if (!apiKey)
+            return observations;
+        const response = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: llmConfig.model || 'gpt-4o-mini',
+                max_tokens: 500,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`OpenAI API error: ${response.status}`);
+        const data = await response.json();
+        text = data.choices?.[0]?.message?.content || '[]';
+    }
+    else if (llmConfig.provider === 'ollama') {
+        const host = process.env.OLLAMA_HOST || 'http://localhost:11434';
+        const response = await fetch(`${host}/api/generate`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: llmConfig.model || 'llama3.2',
+                prompt,
+                stream: false,
+            }),
+        });
+        if (!response.ok)
+            throw new Error(`Ollama error: ${response.status}`);
+        const data = await response.json();
+        text = data.response || '[]';
+    }
+    else {
+        return observations;
+    }
+    try {
+        const match = text.match(/\[[\s\S]*?\]/);
+        if (match) {
+            const arr = JSON.parse(match[0]);
+            if (Array.isArray(arr) && arr.length > 0) {
+                const filtered = arr.filter((s) => typeof s === 'string' && s.length > 0);
+                if (filtered.length > 0)
+                    return filtered;
+            }
+        }
+    }
+    catch { }
+    return observations;
+}
+export function exportMemories(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    let entities = kg.search(undefined, {
+        tag: args.tag,
+        limit: args.limit || 1000,
+        includeArchived: false,
+    });
+    if (args.namespace) {
+        entities = entities.filter((e) => (e.namespace ?? 'personal') === args.namespace);
+    }
+    return {
+        version: '3.0.0',
+        exported_at: new Date().toISOString(),
+        entity_count: entities.length,
+        entities: entities.map((e) => ({
+            name: e.name,
+            type: e.type,
+            namespace: e.namespace ?? 'personal',
+            observations: e.observations,
+            tags: e.tags,
+            relations: (e.relations || []).map((r) => ({ to: r.to, type: r.type })),
+        })),
+    };
+}
+export function importMemories(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    let imported = 0;
+    let skipped = 0;
+    let appended = 0;
+    const errors = [];
+    for (const entity of args.data.entities) {
+        try {
+            const existing = kg.getEntity(entity.name);
+            const namespace = args.namespace || entity.namespace || 'personal';
+            if (existing) {
+                if (args.merge_strategy === 'skip') {
+                    skipped++;
+                    continue;
+                }
+                if (args.merge_strategy === 'append') {
+                    kg.createEntity(entity.name, entity.type, {
+                        observations: entity.observations,
+                        tags: entity.tags,
+                        namespace,
+                    });
+                    appended++;
+                    continue;
+                }
+                kg.archiveEntity(entity.name);
+            }
+            kg.createEntity(entity.name, entity.type, {
+                observations: entity.observations,
+                tags: entity.tags,
+                namespace,
+            });
+            for (const rel of entity.relations || []) {
+                try {
+                    kg.createRelation(entity.name, rel.to, rel.type);
+                }
+                catch {
+                }
+            }
+            imported++;
+        }
+        catch (err) {
+            errors.push(`${entity.name}: ${err.message}`);
+        }
+    }
+    return { imported, skipped, appended, errors };
+}
+export function forget(args) {
+    const db = getDatabase();
+    const kg = new KnowledgeGraph(db);
+    if (args.observation) {
+        const result = kg.removeObservation(args.name, args.observation);
+        return {
+            observation_removed: result.removed,
+            name: args.name,
+            observation: args.observation,
+            remaining_observations: result.remainingObservations,
+        };
+    }
+    const result = kg.archiveEntity(args.name);
+    if (!result.archived) {
+        return { archived: false, message: `Entity "${args.name}" not found` };
+    }
+    return { archived: true, name: args.name };
+}
+//# sourceMappingURL=operations.js.map

package/dist/core/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/core/operations.ts"],"names":[],"mappings":"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"}

package/dist/core/query-expander.d.ts

@@ -0,0 +1,4 @@
+export declare function expandQuery(query: string): Promise<string[]>;
+export declare function parseKeywords(text: string): string[];
+export declare function isExpansionAvailable(): boolean;
+//# sourceMappingURL=query-expander.d.ts.map

package/dist/core/query-expander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expander.d.ts","sourceRoot":"","sources":["../../src/core/query-expander.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAclE;AAqFD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBpD;AAKD,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C"}

package/dist/core/query-expander.js

@@ -0,0 +1,114 @@
+import { detectCapabilities } from './config.js';
+export async function expandQuery(query) {
+    const caps = detectCapabilities();
+    if (!caps.llm)
+        return [query];
+    try {
+        const expanded = await callLLMForExpansion(query, caps.llm);
+        if (!expanded.includes(query)) {
+            expanded.unshift(query);
+        }
+        return expanded;
+    }
+    catch {
+        return [query];
+    }
+}
+async function callLLMForExpansion(query, config) {
+    const prompt = `Given the search query "${query}", generate a list of 5-10 related keywords and synonyms that someone might use to describe the same concept. Return ONLY a JSON array of strings, no explanation. Example: ["keyword1", "keyword2", ...]`;
+    if (config.provider === 'anthropic') {
+        return await callAnthropic(prompt, config);
+    }
+    else if (config.provider === 'openai') {
+        return await callOpenAI(prompt, config);
+    }
+    else if (config.provider === 'ollama') {
+        return await callOllama(prompt, config);
+    }
+    return [query];
+}
+async function callAnthropic(prompt, config) {
+    const apiKey = config.apiKey || process.env.ANTHROPIC_API_KEY;
+    if (!apiKey)
+        return [];
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+            'content-type': 'application/json',
+        },
+        body: JSON.stringify({
+            model: config.model || 'claude-haiku-4-5',
+            max_tokens: 200,
+            messages: [{ role: 'user', content: prompt }],
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`Anthropic API error: ${response.status}`);
+    const data = await response.json();
+    const text = data.content?.[0]?.text || '[]';
+    return parseKeywords(text);
+}
+async function callOpenAI(prompt, config) {
+    const apiKey = config.apiKey || process.env.OPENAI_API_KEY;
+    if (!apiKey)
+        return [];
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            model: config.model || 'gpt-4o-mini',
+            max_tokens: 200,
+            messages: [{ role: 'user', content: prompt }],
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`OpenAI API error: ${response.status}`);
+    const data = await response.json();
+    const text = data.choices?.[0]?.message?.content || '[]';
+    return parseKeywords(text);
+}
+async function callOllama(prompt, config) {
+    const host = process.env.OLLAMA_HOST || 'http://localhost:11434';
+    const response = await fetch(`${host}/api/generate`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            model: config.model || 'llama3.2',
+            prompt,
+            stream: false,
+        }),
+    });
+    if (!response.ok)
+        throw new Error(`Ollama error: ${response.status}`);
+    const data = await response.json();
+    return parseKeywords(data.response || '[]');
+}
+export function parseKeywords(text) {
+    try {
+        const match = text.match(/\[[\s\S]*?\]/);
+        if (match) {
+            const arr = JSON.parse(match[0]);
+            if (Array.isArray(arr)) {
+                return arr
+                    .filter((k) => typeof k === 'string' && k.length > 0)
+                    .slice(0, 15);
+            }
+        }
+    }
+    catch { }
+    return text
+        .split(/[,\n]+/)
+        .map((s) => s.trim().replace(/["\[\]]/g, ''))
+        .filter((s) => s.length > 1)
+        .slice(0, 15);
+}
+export function isExpansionAvailable() {
+    const caps = detectCapabilities();
+    return caps.llm !== null;
+}
+//# sourceMappingURL=query-expander.js.map

package/dist/core/query-expander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-expander.js","sourceRoot":"","sources":["../../src/core/query-expander.ts"],"names":[],"mappings":"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"}

package/dist/core/schema-export.d.ts

@@ -0,0 +1,2 @@
+export declare function exportOpenAITools(): object[];
+//# sourceMappingURL=schema-export.d.ts.map

package/dist/core/schema-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.d.ts","sourceRoot":"","sources":["../../src/core/schema-export.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAiE5C"}

package/dist/core/schema-export.js

@@ -0,0 +1,67 @@
+export function exportOpenAITools() {
+    return [
+        {
+            type: 'function',
+            function: {
+                name: 'memesh_remember',
+                description: 'Store knowledge as an entity with observations, tags, and relations.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Unique entity name' },
+                        type: { type: 'string', description: 'Entity type (decision, pattern, lesson, etc.)' },
+                        observations: { type: 'array', items: { type: 'string' }, description: 'Key facts about this entity' },
+                        tags: { type: 'array', items: { type: 'string' }, description: 'Tags for filtering' },
+                    },
+                    required: ['name', 'type'],
+                },
+            },
+        },
+        {
+            type: 'function',
+            function: {
+                name: 'memesh_recall',
+                description: 'Search and retrieve stored knowledge. Uses full-text search with scoring.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Search query' },
+                        tag: { type: 'string', description: 'Filter by tag' },
+                        limit: { type: 'number', description: 'Max results (default: 20)' },
+                    },
+                },
+            },
+        },
+        {
+            type: 'function',
+            function: {
+                name: 'memesh_forget',
+                description: 'Archive an entity or remove a specific observation.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Entity name to archive' },
+                        observation: { type: 'string', description: 'Specific observation to remove (optional)' },
+                    },
+                    required: ['name'],
+                },
+            },
+        },
+        {
+            type: 'function',
+            function: {
+                name: 'memesh_consolidate',
+                description: 'Compress verbose entity observations using LLM.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Entity to consolidate' },
+                        tag: { type: 'string', description: 'Consolidate all entities with this tag' },
+                        min_observations: { type: 'number', description: 'Min observations to trigger (default: 5)' },
+                    },
+                },
+            },
+        },
+    ];
+}
+//# sourceMappingURL=schema-export.js.map

package/dist/core/schema-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-export.js","sourceRoot":"","sources":["../../src/core/schema-export.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,sEAAsE;gBACnF,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;wBAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;wBACtF,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE;wBACtG,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE;qBACtF;oBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;iBAC3B;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,2EAA2E;gBACxF,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;wBACtD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;wBACrD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;qBACpE;iBACF;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,qDAAqD;gBAClE,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBAC/D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;qBAC1F;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,iDAAiD;gBAC9D,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;wBAC9D,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;wBAC9E,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;qBAC9F;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/core/scoring.d.ts

@@ -0,0 +1,25 @@
+export interface ScoringWeights {
+    searchRelevance: number;
+    recency: number;
+    frequency: number;
+    confidence: number;
+    temporalValidity: number;
+}
+export declare const DEFAULT_WEIGHTS: ScoringWeights;
+export declare function recencyScore(lastAccessedAt: string | null | undefined): number;
+export declare function frequencyScore(accessCount: number, maxAccessCount: number): number;
+export declare function temporalValidityScore(validUntil: string | null | undefined): number;
+export declare function scoreEntity(entity: {
+    access_count?: number;
+    last_accessed_at?: string;
+    confidence?: number;
+    valid_until?: string;
+}, searchRelevanceValue: number, maxAccessCount: number, weights?: ScoringWeights): number;
+export declare function rankEntities<T extends {
+    name: string;
+    access_count?: number;
+    last_accessed_at?: string;
+    confidence?: number;
+    valid_until?: string;
+}>(entities: T[], searchRelevanceValues: Map<string, number>, weights?: ScoringWeights): T[];
+//# sourceMappingURL=scoring.d.ts.map

package/dist/core/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/core/scoring.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,eAAe,EAAE,cAM7B,CAAC;AAOF,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI9E;AAMD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAGlF;AAOD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGnF;AAMD,wBAAgB,WAAW,CACzB,MAAM,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EACvG,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,cAAgC,GACxC,MAAM,CAOR;AAMD,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAClJ,QAAQ,EAAE,CAAC,EAAE,EACb,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,CAAC,EAAE,CAQL"}

package/dist/core/scoring.js

@@ -0,0 +1,40 @@
+export const DEFAULT_WEIGHTS = {
+    searchRelevance: 0.35,
+    recency: 0.25,
+    frequency: 0.20,
+    confidence: 0.15,
+    temporalValidity: 0.05,
+};
+export function recencyScore(lastAccessedAt) {
+    if (!lastAccessedAt)
+        return 0.5;
+    const days = (Date.now() - new Date(lastAccessedAt).getTime()) / (1000 * 60 * 60 * 24);
+    return Math.exp(-days / 30);
+}
+export function frequencyScore(accessCount, maxAccessCount) {
+    if (maxAccessCount <= 0)
+        return 0;
+    return Math.log(accessCount + 1) / Math.log(maxAccessCount + 1);
+}
+export function temporalValidityScore(validUntil) {
+    if (!validUntil)
+        return 1.0;
+    return new Date(validUntil).getTime() > Date.now() ? 1.0 : 0.5;
+}
+export function scoreEntity(entity, searchRelevanceValue, maxAccessCount, weights = DEFAULT_WEIGHTS) {
+    const sr = searchRelevanceValue * weights.searchRelevance;
+    const rc = recencyScore(entity.last_accessed_at) * weights.recency;
+    const fq = frequencyScore(entity.access_count ?? 0, maxAccessCount) * weights.frequency;
+    const cf = (entity.confidence ?? 1.0) * weights.confidence;
+    const tv = temporalValidityScore(entity.valid_until) * weights.temporalValidity;
+    return sr + rc + fq + cf + tv;
+}
+export function rankEntities(entities, searchRelevanceValues, weights) {
+    const maxAccess = Math.max(...entities.map(e => e.access_count ?? 0), 1);
+    return [...entities].sort((a, b) => {
+        const scoreA = scoreEntity(a, searchRelevanceValues.get(a.name) ?? 0.5, maxAccess, weights);
+        const scoreB = scoreEntity(b, searchRelevanceValues.get(b.name) ?? 0.5, maxAccess, weights);
+        return scoreB - scoreA;
+    });
+}
+//# sourceMappingURL=scoring.js.map

package/dist/core/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/core/scoring.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,eAAe,EAAE,IAAI;IACrB,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAOF,MAAM,UAAU,YAAY,CAAC,cAAyC;IACpE,IAAI,CAAC,cAAc;QAAE,OAAO,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AAC9B,CAAC;AAMD,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,cAAsB;IACxE,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAOD,MAAM,UAAU,qBAAqB,CAAC,UAAqC;IACzE,IAAI,CAAC,UAAU;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACjE,CAAC;AAMD,MAAM,UAAU,WAAW,CACzB,MAAuG,EACvG,oBAA4B,EAC5B,cAAsB,EACtB,UAA0B,eAAe;IAEzC,MAAM,EAAE,GAAG,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC1D,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IACnE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IACxF,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAC3D,MAAM,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAChF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAChC,CAAC;AAMD,MAAM,UAAU,YAAY,CAC1B,QAAa,EACb,qBAA0C,EAC1C,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEzE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5F,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}