@pcircle/memesh 4.2.10 → 4.3.0

package/dist/core/memory-tool.js

@@ -0,0 +1,371 @@
+import { getDatabase } from '../db.js';
+import { KnowledgeGraph } from '../knowledge-graph.js';
+import { removeFromFts, insertFtsRow } from '../storage/fts-index.js';
+export const MEMORY_ROOT = '/memories';
+const NAMESPACES = ['personal', 'team', 'global'];
+const FILE_SUFFIX = '.md';
+const MAX_FILE_BYTES = 256 * 1024;
+const MAX_VIEW_CHARS = 16_000;
+const ok = (content) => ({ content, isError: false });
+const err = (content) => ({ content, isError: true });
+function encodeName(name) {
+    return name.replace(/%/g, '%25').replace(/\//g, '%2F').replace(/\\/g, '%5C');
+}
+function decodeName(segment) {
+    return segment
+        .replace(/%2F/gi, '/')
+        .replace(/%5C/gi, '\\')
+        .replace(/%25/g, '%');
+}
+function parsePath(raw) {
+    if (typeof raw !== 'string' || raw.length === 0) {
+        return err('Error: `path` must be a non-empty string.');
+    }
+    if (raw.includes('\0')) {
+        return err('Error: `path` may not contain a NUL byte.');
+    }
+    if (raw !== MEMORY_ROOT && !raw.startsWith(`${MEMORY_ROOT}/`)) {
+        return err(`Error: paths must be under ${MEMORY_ROOT}. The path ${raw} is outside it.`);
+    }
+    const rest = raw.slice(MEMORY_ROOT.length).replace(/^\//, '');
+    if (rest === '')
+        return { kind: 'root' };
+    const segments = rest.split('/');
+    for (const segment of segments) {
+        if (segment === '' || segment === '.' || segment === '..') {
+            return err(`Error: the path ${raw} contains a traversal or empty segment and was refused.`);
+        }
+        if (/%2e%2e/i.test(segment) || segment.includes('\\')) {
+            return err(`Error: the path ${raw} contains a traversal sequence and was refused.`);
+        }
+    }
+    if (segments.length > 2) {
+        return err(`Error: ${MEMORY_ROOT} is two levels deep — ${MEMORY_ROOT}/<namespace>/<memory>${FILE_SUFFIX}. ` +
+            `The path ${raw} is deeper than that.`);
+    }
+    const namespace = segments[0];
+    if (!NAMESPACES.includes(namespace)) {
+        return err(`Error: "${namespace}" is not a memory namespace. Use one of: ${NAMESPACES.join(', ')}.`);
+    }
+    if (segments.length === 1) {
+        return { kind: 'namespace', namespace: namespace };
+    }
+    const file = segments[1];
+    if (!file.endsWith(FILE_SUFFIX)) {
+        return err(`Error: memory files end in ${FILE_SUFFIX}. The path ${raw} does not.`);
+    }
+    const name = decodeName(file.slice(0, -FILE_SUFFIX.length));
+    if (name === '') {
+        return err(`Error: the path ${raw} names an empty memory.`);
+    }
+    return { kind: 'entity', namespace: namespace, name };
+}
+const isResult = (v) => 'content' in v;
+function entityPath(namespace, name) {
+    return `${MEMORY_ROOT}/${namespace}/${encodeName(name)}${FILE_SUFFIX}`;
+}
+function renderBody(entity) {
+    return entity.observations.join('\n');
+}
+function lineOwners(observations) {
+    const owners = [];
+    observations.forEach((observation, index) => {
+        const span = observation.split('\n').length;
+        for (let i = 0; i < span; i++)
+            owners.push(index);
+    });
+    return owners;
+}
+function withLineNumbers(body, from = 1) {
+    if (body === '')
+        return '';
+    return body
+        .split('\n')
+        .map((line, i) => `${String(from + i).padStart(6, ' ')}\t${line}`)
+        .join('\n');
+}
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}`;
+    return `${(bytes / 1024).toFixed(1)}K`;
+}
+function graph() {
+    return new KnowledgeGraph(getDatabase());
+}
+function listNamespace(namespace) {
+    return getDatabase()
+        .prepare(`SELECT e.name AS name,
+              e.type AS type,
+              COALESCE(SUM(LENGTH(o.content)) + MAX(COUNT(o.id) - 1, 0), 0) AS bytes
+         FROM entities e
+         LEFT JOIN observations o ON o.entity_id = e.id
+        WHERE e.status = 'active' AND e.namespace = ?
+        GROUP BY e.id
+        ORDER BY e.id DESC`)
+        .all(namespace);
+}
+function countNamespace(namespace) {
+    return getDatabase()
+        .prepare("SELECT COUNT(*) AS n FROM entities WHERE status = 'active' AND namespace = ?")
+        .get(namespace).n;
+}
+function tagsOf(name) {
+    return getDatabase()
+        .prepare('SELECT tag FROM tags WHERE entity_id = (SELECT id FROM entities WHERE name = ?)')
+        .all(name).map((t) => t.tag);
+}
+function findEntity(kg, namespace, name) {
+    const entity = kg.getEntity(name);
+    if (!entity || entity.namespace !== namespace)
+        return null;
+    return entity;
+}
+function rewriteObservations(kg, entity, observations) {
+    getDatabase().transaction(() => {
+        kg.clearEntityData(entity.name);
+        kg.createEntity(entity.name, entity.type, {
+            observations,
+            tags: entity.tags,
+            namespace: entity.namespace,
+        });
+    })();
+}
+function tooLarge(body, path) {
+    const bytes = Buffer.byteLength(body, 'utf8');
+    if (bytes <= MAX_FILE_BYTES)
+        return null;
+    return err(`Error: ${path} would be ${humanSize(bytes)}, over the ${humanSize(MAX_FILE_BYTES)} ` +
+        `limit for one memory. Split it across several memories.`);
+}
+function viewRoot() {
+    const lines = [`${MEMORY_ROOT}`];
+    for (const namespace of NAMESPACES) {
+        lines.push(`${MEMORY_ROOT}/${namespace}\t${countNamespace(namespace)} memories`);
+    }
+    return ok(`Here're the files and directories up to 2 levels deep in ${MEMORY_ROOT}, ` +
+        `excluding hidden items and node_modules:\n${lines.join('\n')}`);
+}
+function viewNamespace(namespace) {
+    const lines = listNamespace(namespace).map((row) => {
+        const tags = tagsOf(row.name);
+        const suffix = tags.length > 0 ? `  tags: ${tags.join(', ')}` : '';
+        return `${humanSize(row.bytes)}\t${entityPath(namespace, row.name)}\t(${row.type})${suffix}`;
+    });
+    return ok(`Here're the files and directories up to 2 levels deep in ${MEMORY_ROOT}/${namespace}, ` +
+        `excluding hidden items and node_modules:\n` +
+        [`${MEMORY_ROOT}/${namespace}`, ...lines].join('\n'));
+}
+function viewEntity(namespace, name, range, path) {
+    const entity = findEntity(graph(), namespace, name);
+    if (!entity) {
+        return err(`The path ${path} does not exist. Please provide a valid path.`);
+    }
+    const body = renderBody(entity);
+    const lines = body === '' ? [] : body.split('\n');
+    if (range === undefined) {
+        if (body.length > MAX_VIEW_CHARS) {
+            const kept = [];
+            let used = 0;
+            for (const line of lines) {
+                if (used + line.length + 1 > MAX_VIEW_CHARS)
+                    break;
+                kept.push(line);
+                used += line.length + 1;
+            }
+            return ok(`Here's the content of ${path} with line numbers:\n${withLineNumbers(kept.join('\n'))}\n` +
+                `\n[truncated at ${kept.length} of ${lines.length} lines — ` +
+                `use view_range to read from line ${kept.length + 1}]`);
+        }
+        return ok(`Here's the content of ${path} with line numbers:\n${withLineNumbers(body)}`);
+    }
+    if (!Array.isArray(range) || range.length !== 2 || !range.every((n) => Number.isInteger(n))) {
+        return err('Error: `view_range` must be a two-element array of integers, [start, end].');
+    }
+    const [start, rawEnd] = range;
+    const end = rawEnd === -1 ? lines.length : rawEnd;
+    if (start < 1 || start > Math.max(lines.length, 1) || end < start) {
+        return err(`Error: Invalid \`view_range\`: [${start}, ${rawEnd}]. ` +
+            `It should be within the range of lines of the file: [1, ${lines.length}]`);
+    }
+    const slice = lines.slice(start - 1, end).join('\n');
+    return ok(`Here's the content of ${path} with line numbers:\n${withLineNumbers(slice, start)}`);
+}
+function createEntityFile(namespace, name, fileText, path) {
+    if (typeof fileText !== 'string') {
+        return err('Error: `file_text` must be a string.');
+    }
+    const kg = graph();
+    const existing = findEntity(kg, namespace, name);
+    const oversize = tooLarge(fileText, path);
+    if (oversize)
+        return oversize;
+    const observations = fileText === '' ? [] : fileText.split('\n');
+    if (existing) {
+        rewriteObservations(kg, existing, observations);
+        return ok(`File created successfully at: ${path}`);
+    }
+    kg.createEntity(name, 'note', { observations, namespace });
+    return ok(`File created successfully at: ${path}`);
+}
+function strReplace(namespace, name, oldStr, newStr, path) {
+    if (typeof oldStr !== 'string' || oldStr === '') {
+        return err('Error: `old_str` must be a non-empty string.');
+    }
+    if (newStr !== undefined && typeof newStr !== 'string') {
+        return err('Error: `new_str` must be a string when present.');
+    }
+    const kg = graph();
+    const entity = findEntity(kg, namespace, name);
+    if (!entity) {
+        return err(`Error: The path ${path} does not exist. Please provide a valid path.`);
+    }
+    const body = renderBody(entity);
+    const first = body.indexOf(oldStr);
+    if (first === -1) {
+        return err(`No replacement was performed, old_str \`${oldStr}\` did not appear verbatim in ${path}.`);
+    }
+    if (body.indexOf(oldStr, first + 1) !== -1) {
+        const lines = [];
+        let at = first;
+        while (at !== -1) {
+            lines.push(body.slice(0, at).split('\n').length);
+            at = body.indexOf(oldStr, at + 1);
+        }
+        return err(`No replacement was performed. Multiple occurrences of old_str \`${oldStr}\` ` +
+            `in lines: ${lines.join(', ')}. Please ensure it is unique`);
+    }
+    const replaced = body.slice(0, first) + (newStr ?? '') + body.slice(first + oldStr.length);
+    const oversize = tooLarge(replaced, path);
+    if (oversize)
+        return oversize;
+    const observations = replaced === '' ? [] : replaced.split('\n');
+    rewriteObservations(kg, entity, observations);
+    const at = replaced.slice(0, first).split('\n').length;
+    const from = Math.max(1, at - 2);
+    const snippet = replaced.split('\n').slice(from - 1, at + 2).join('\n');
+    return ok(`The memory file has been edited. Here's a snippet of ${path} with line numbers:\n` +
+        withLineNumbers(snippet, from));
+}
+function insertLine(namespace, name, atLine, text, path) {
+    if (!Number.isInteger(atLine)) {
+        return err('Error: `insert_line` must be an integer.');
+    }
+    if (typeof text !== 'string') {
+        return err('Error: `insert_text` must be a string.');
+    }
+    const kg = graph();
+    const entity = findEntity(kg, namespace, name);
+    if (!entity)
+        return err(`Error: The path ${path} does not exist`);
+    const owners = lineOwners(entity.observations);
+    const line = atLine;
+    if (line < 0 || line > owners.length) {
+        return err(`Error: Invalid \`insert_line\` parameter: ${line}. ` +
+            `It should be within the range of lines of the file: [0, ${owners.length}]`);
+    }
+    const insertAfter = line === 0 ? -1 : owners[line - 1];
+    const observations = [...entity.observations];
+    observations.splice(insertAfter + 1, 0, text.replace(/\n$/, ''));
+    const oversize = tooLarge(observations.join('\n'), path);
+    if (oversize)
+        return oversize;
+    rewriteObservations(kg, entity, observations);
+    return ok(`The file ${path} has been edited.`);
+}
+function deletePath(parsed, path) {
+    if (parsed.kind === 'root') {
+        return err(`Error: ${MEMORY_ROOT} itself cannot be deleted.`);
+    }
+    if (parsed.kind === 'namespace') {
+        return err(`Error: ${path} is a namespace and cannot be deleted. Delete individual memories instead.`);
+    }
+    const kg = graph();
+    const entity = findEntity(kg, parsed.namespace, parsed.name);
+    if (!entity)
+        return err(`Error: The path ${path} does not exist`);
+    kg.archiveEntity(entity.name);
+    return ok(`Successfully deleted ${path}`);
+}
+function renamePath(oldRaw, newRaw) {
+    const from = parsePath(oldRaw);
+    if (isResult(from))
+        return from;
+    const to = parsePath(newRaw);
+    if (isResult(to))
+        return to;
+    if (from.kind !== 'entity' || to.kind !== 'entity') {
+        return err(`Error: rename moves one memory to another memory path. ` +
+            `${MEMORY_ROOT} and its namespaces cannot be renamed.`);
+    }
+    const kg = graph();
+    const source = findEntity(kg, from.namespace, from.name);
+    if (!source)
+        return err(`Error: The path ${String(oldRaw)} does not exist`);
+    if (findEntity(kg, to.namespace, to.name)) {
+        return err(`Error: The destination ${String(newRaw)} already exists`);
+    }
+    if (kg.getEntity(to.name)) {
+        return err(`Error: The destination ${String(newRaw)} already exists in another namespace. ` +
+            `Memory names are unique across namespaces.`);
+    }
+    const db = getDatabase();
+    const entityId = source.id;
+    const obsText = source.observations.join(' ');
+    db.transaction(() => {
+        removeFromFts(db, entityId, source.name, obsText);
+        db.prepare('UPDATE entities SET name = ?, namespace = ? WHERE id = ?')
+            .run(to.name, to.namespace, entityId);
+        insertFtsRow(db, entityId, to.name, obsText);
+    })();
+    return ok(`Successfully renamed ${String(oldRaw)} to ${String(newRaw)}`);
+}
+export function handleMemoryCommand(input) {
+    if (typeof input !== 'object' || input === null) {
+        return err('Error: the memory tool input must be an object.');
+    }
+    const cmd = input;
+    switch (cmd.command) {
+        case 'rename':
+            return renamePath(cmd.old_path, cmd.new_path);
+        case 'view':
+        case 'create':
+        case 'str_replace':
+        case 'insert':
+        case 'delete':
+            break;
+        case undefined:
+            return err('Error: the memory tool input has no `command`.');
+        default:
+            return err(`Error: unknown command ${String(cmd.command)}`);
+    }
+    const parsed = parsePath(cmd.path);
+    if (isResult(parsed))
+        return parsed;
+    const path = cmd.path;
+    if (cmd.command === 'delete')
+        return deletePath(parsed, path);
+    if (cmd.command === 'view') {
+        if (parsed.kind === 'root')
+            return viewRoot();
+        if (parsed.kind === 'namespace')
+            return viewNamespace(parsed.namespace);
+        return viewEntity(parsed.namespace, parsed.name, cmd.view_range, path);
+    }
+    if (parsed.kind !== 'entity') {
+        return err(`Error: ${path} is a directory. ${cmd.command} needs a memory file, ` +
+            `${MEMORY_ROOT}/<namespace>/<memory>${FILE_SUFFIX}.`);
+    }
+    switch (cmd.command) {
+        case 'create':
+            return createEntityFile(parsed.namespace, parsed.name, cmd.file_text, path);
+        case 'str_replace':
+            return strReplace(parsed.namespace, parsed.name, cmd.old_str, cmd.new_str, path);
+        case 'insert':
+            return insertLine(parsed.namespace, parsed.name, cmd.insert_line, cmd.insert_text, path);
+    }
+}
+export const MEMORY_TOOL_DEFINITION = {
+    type: 'memory_20250818',
+    name: 'memory',
+};
+//# sourceMappingURL=memory-tool.js.map

package/dist/core/memory-tool.js.map

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

package/dist/core/operations.d.ts

@@ -1,3 +1,4 @@
+import type { EmbedOutcome } from './embedder.js';
 import type { RememberInput, RememberResult, RecallInput, ForgetInput, ForgetResult, LearnInput, LearnResult, Entity } from './types.js';
 export declare function remember(args: RememberInput): RememberResult;
 export declare function recall(args: RecallInput): Entity[];
@@ -6,7 +7,6 @@ export declare function recallWithConflicts(args: RecallInput): Promise<{
     entities: Entity[];
     conflicts: string[];
 }>;
-export { consolidate } from './consolidator.js';
 export { exportMemories, importMemories } from './serializer.js';
 export declare function learn(args: LearnInput): LearnResult;
 export declare function forget(args: ForgetInput): ForgetResult;
@@ -15,11 +15,17 @@ export declare function setPinned(name: string, pinned: boolean): {
     pinned: boolean;
     found: boolean;
 };
-export declare function reindex(opts?: {
-    namespace?: string;
-}): Promise<{
+export interface ReindexResult {
     processed: number;
     embedded: number;
     skipped: number;
-}>;
+    outcomes: Record<EmbedOutcome | 'entity_missing' | 'nothing_to_embed', number>;
+    failed: number;
+    missingVectors: number;
+    missingVectorsDatabaseWide: number;
+    pendingReindexCleared: boolean;
+}
+export declare function reindex(opts?: {
+    namespace?: string;
+}): Promise<ReindexResult>;
 //# sourceMappingURL=operations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/core/operations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,MAAM,EACP,MAAM,YAAY,CAAC;AAiCpB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAgF5D;AAQD,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAmBlD;AA4DD,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBzE;AASD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW;;;GAK1D;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYjE,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAmBnD;AAMD,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAuBtD;AAYD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAe1G;AAOD,wBAAsB,OAAO,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAuDD"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/core/operations.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,MAAM,EACP,MAAM,YAAY,CAAC;AAgDpB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAgF5D;AAUD,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAGlD;AAsHD,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAezE;AASD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW;;;GAK1D;AAGD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYjE,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAmBnD;AAMD,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAuBtD;AAYD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAe1G;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAgB/E,MAAM,EAAE,MAAM,CAAC;IAYf,cAAc,EAAE,MAAM,CAAC;IAOvB,0BAA0B,EAAE,MAAM,CAAC;IAEnC,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAwCD,wBAAsB,OAAO,CAAC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAwInF"}

package/dist/core/operations.js

@@ -1,9 +1,10 @@
 import { getDatabase, clearPendingReindexFlag } from '../db.js';
+import { hasSearchableTerms } from '../storage/fts-index.js';
 import { KnowledgeGraph } from '../knowledge-graph.js';
 import { rankEntities } from './scoring.js';
 import { getProjectName } from './paths.js';
 import { createExplicitLesson } from './lesson-engine.js';
-import { embedAndStore, isEmbeddingAvailable, embedText, scheduleEmbedAndStore, vectorSearch } from './embedder.js';
+import { embedAndStore, isEmbeddingAvailable, embedText, scheduleEmbedAndStore, vectorSearch, vectorSimilarity, MAX_VECTOR_DISTANCE } from './embedder.js';
 import { autoTagAndApply } from './auto-tagger.js';
 import { detectCapabilities } from './config.js';
 function buildLocalMetadata(existingMetadata, overrides) {
@@ -21,6 +22,9 @@ function buildLocalMetadata(existingMetadata, overrides) {
 function recallTagFilter(args) {
     return args.cross_project ? undefined : args.tag;
 }
+function buildRelevanceMap(entities) {
+    return new Map(entities.map((entity, index) => [entity.name, 1 - index / (entities.length + 1)]));
+}
 export function remember(args) {
     const db = getDatabase();
     const kg = new KnowledgeGraph(db);
@@ -84,19 +88,22 @@ export function remember(args) {
     };
 }
 export function recall(args) {
-    const db = getDatabase();
-    const kg = new KnowledgeGraph(db);
+    const { entities, relevanceMap } = searchAndScore(args);
+    return rankEntities(entities, relevanceMap).slice(0, args.limit ?? 20);
+}
+function searchAndScore(args) {
+    const kg = new KnowledgeGraph(getDatabase());
     const entities = kg.search(args.query, {
         tag: recallTagFilter(args),
         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);
+    return {
+        kg,
+        entities,
+        relevanceMap: args.query ? buildRelevanceMap(entities) : new Map(),
+    };
 }
 async function supplementWithVectors(query, args, kg, merged, relevanceMap) {
     if (!isEmbeddingAvailable())
@@ -108,7 +115,10 @@ async function supplementWithVectors(query, args, kg, merged, relevanceMap) {
         const vectorHits = vectorSearch(queryEmb, args.limit ?? 20);
         if (vectorHits.length === 0)
             return;
-        const hitIds = vectorHits.map(h => h.id);
+        const alreadyMerged = new Set(merged.map(e => e.id));
+        const hitIds = vectorHits.map(h => h.id).filter(id => !alreadyMerged.has(id));
+        if (hitIds.length === 0)
+            return;
         const hitEntities = kg.getEntitiesByIds(hitIds, {
             includeArchived: args.include_archived === true,
             namespace: args.namespace,
@@ -119,28 +129,17 @@ async function supplementWithVectors(query, args, kg, merged, relevanceMap) {
             if (existingNames.has(entity.name))
                 continue;
             merged.push(entity);
-            const dist = vectorHits.find(h => h.id === entity.id)?.distance ?? 1;
-            relevanceMap.set(entity.name, Math.max(0, 1 - dist));
+            const dist = vectorHits.find(h => h.id === entity.id)?.distance ?? MAX_VECTOR_DISTANCE;
+            relevanceMap.set(entity.name, vectorSimilarity(dist));
         }
     }
     catch {
     }
 }
 export async function recallEnhanced(args) {
-    const db = getDatabase();
-    const kg = new KnowledgeGraph(db);
-    const entities = kg.search(args.query, {
-        tag: recallTagFilter(args),
-        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);
-    }
+    const { kg, entities, relevanceMap } = searchAndScore(args);
     const mergedEntities = [...entities];
-    if (args.query) {
+    if (args.query && hasSearchableTerms(args.query)) {
         await supplementWithVectors(args.query, args, kg, mergedEntities, relevanceMap);
     }
     return rankEntities(mergedEntities, relevanceMap).slice(0, args.limit ?? 20);
@@ -151,7 +150,6 @@ export async function recallWithConflicts(args) {
     const conflicts = kg.findConflicts(entities.map((e) => e.name));
     return { entities, conflicts };
 }
-export { consolidate } from './consolidator.js';
 export { exportMemories, importMemories } from './serializer.js';
 export function learn(args) {
     const projectName = getProjectName();
@@ -200,6 +198,16 @@ export function setPinned(name, pinned) {
     });
     return { name, pinned, found: true };
 }
+function countMissingVectors(db, namespace) {
+    const row = db.prepare(`
+    SELECT COUNT(*) AS n FROM entities e
+    WHERE e.status = 'active'
+      ${namespace ? 'AND e.namespace = ?' : ''}
+      AND EXISTS (SELECT 1 FROM observations o WHERE o.entity_id = e.id AND TRIM(o.content) <> '')
+      AND NOT EXISTS (SELECT 1 FROM entities_vec v WHERE v.rowid = e.id)
+  `).get(...(namespace ? [namespace] : []));
+    return row.n;
+}
 export async function reindex(opts) {
     if (!isEmbeddingAvailable()) {
         throw new Error('No embedding provider available. Configure OpenAI API key, Ollama, or install @huggingface/transformers.');
@@ -209,32 +217,81 @@ export async function reindex(opts) {
     const namespaceFilter = opts?.namespace ? 'AND namespace = ?' : '';
     const params = opts?.namespace ? [opts.namespace] : [];
     const entities = db.prepare(`SELECT id, name FROM entities WHERE status = 'active' ${namespaceFilter} ORDER BY id`).all(...params);
+    const outcomes = {
+        stored: 0,
+        removed: 0,
+        no_embedding: 0,
+        dimension_mismatch: 0,
+        write_failed: 0,
+        database_closed: 0,
+        entity_missing: 0,
+        nothing_to_embed: 0,
+    };
     let processed = 0;
-    let embedded = 0;
-    let skipped = 0;
     process.stderr.write(`MeMesh: Reindexing ${entities.length} entities...\n`);
     for (const entity of entities) {
         processed++;
         const fullEntity = kg.getEntity(entity.name);
         if (!fullEntity) {
-            skipped++;
+            outcomes.entity_missing++;
             continue;
         }
         const text = fullEntity.observations.join(' ');
+        if (text.trim() === '') {
+            outcomes.nothing_to_embed++;
+            continue;
+        }
         try {
-            await embedAndStore(entity.id, text);
-            embedded++;
+            outcomes[await embedAndStore(entity.id, text)]++;
             if (processed % 10 === 0) {
-                process.stderr.write(`MeMesh: Processed ${processed}/${entities.length} (${embedded} embedded, ${skipped} skipped)\n`);
+                process.stderr.write(`MeMesh: Processed ${processed}/${entities.length} ` +
+                    `(${outcomes.stored} embedded, ${processed - outcomes.stored} skipped)\n`);
             }
         }
         catch (err) {
-            skipped++;
+            outcomes.write_failed++;
             process.stderr.write(`MeMesh: Failed to embed entity ${entity.name}: ${err}\n`);
         }
     }
+    const embedded = outcomes.stored;
+    const skipped = processed - embedded;
+    const failed = outcomes.no_embedding +
+        outcomes.dimension_mismatch +
+        outcomes.write_failed +
+        outcomes.database_closed;
+    const missingVectors = countMissingVectors(db, opts?.namespace);
+    const missingVectorsDatabaseWide = opts?.namespace
+        ? countMissingVectors(db)
+        : missingVectors;
     process.stderr.write(`MeMesh: Reindex complete. ${embedded}/${processed} entities embedded.\n`);
-    clearPendingReindexFlag();
-    return { processed, embedded, skipped };
+    if (outcomes.dimension_mismatch > 0) {
+        process.stderr.write(`MeMesh: ${outcomes.dimension_mismatch} entities were skipped because the provider's ` +
+            `embedding dimension does not match this database's vector index. Rebuild it with ` +
+            `'memesh reindex --vectors'.\n`);
+    }
+    const pendingReindexCleared = missingVectorsDatabaseWide === 0 && failed === 0;
+    if (pendingReindexCleared) {
+        clearPendingReindexFlag();
+    }
+    else if (missingVectorsDatabaseWide > 0) {
+        process.stderr.write(`MeMesh: ${missingVectorsDatabaseWide} active memories still have no vector` +
+            `${opts?.namespace ? ' (across all namespaces)' : ''}, so the ` +
+            `reindex-needed flag was left set.\n`);
+    }
+    else {
+        process.stderr.write(`MeMesh: every memory has a vector, but ${failed} could not be regenerated, ` +
+            `so those still hold their previous embedding and the reindex-needed flag ` +
+            `was left set.\n`);
+    }
+    return {
+        processed,
+        embedded,
+        skipped,
+        outcomes,
+        failed,
+        missingVectors,
+        missingVectorsDatabaseWide,
+        pendingReindexCleared,
+    };
 }
 //# sourceMappingURL=operations.js.map