@moorline/core 0.0.1

package/dist/core/domain/memory/retrieval/markdownChunker.js

@@ -0,0 +1,77 @@
+import { CHUNK_MAX_CHARS, CHUNK_TARGET_CHARS } from './types.js';
+import { normalizeTokens } from './tokenEmbedding.js';
+export function extractHeadings(content) {
+    return content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => /^#{1,6}\s+/.test(line))
+        .map((line) => line.replace(/^#{1,6}\s+/, '').trim())
+        .filter(Boolean)
+        .slice(0, 6);
+}
+export function tokenizeMetadata(input) {
+    return normalizeTokens(input).filter((token, index, list) => list.indexOf(token) === index);
+}
+export function markdownAwareChunks(content) {
+    const lines = content.split(/\r?\n/);
+    if (!lines.length) {
+        return [];
+    }
+    const segments = [];
+    let inCodeFence = false;
+    let current = [];
+    const flushSegment = () => {
+        if (!current.length) {
+            return;
+        }
+        const segment = current.join('\n').trim();
+        if (segment) {
+            segments.push(segment);
+        }
+        current = [];
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const isFence = trimmed.startsWith('```');
+        if (!inCodeFence && /^#{1,6}\s+/.test(trimmed) && current.length) {
+            flushSegment();
+        }
+        current.push(line);
+        if (isFence) {
+            inCodeFence = !inCodeFence;
+            if (!inCodeFence) {
+                flushSegment();
+            }
+            continue;
+        }
+        if (!inCodeFence && trimmed === '') {
+            flushSegment();
+        }
+    }
+    flushSegment();
+    if (!segments.length) {
+        return [content.trim()].filter(Boolean);
+    }
+    const chunks = [];
+    let chunk = '';
+    const flushChunk = () => {
+        const trimmed = chunk.trim();
+        if (trimmed) {
+            chunks.push(trimmed);
+        }
+        chunk = '';
+    };
+    for (const segment of segments) {
+        const withSeparator = chunk.length ? `${chunk}\n\n${segment}` : segment;
+        if (withSeparator.length > CHUNK_MAX_CHARS && chunk.length) {
+            flushChunk();
+        }
+        chunk = chunk.length ? `${chunk}\n\n${segment}` : segment;
+        if (chunk.length >= CHUNK_TARGET_CHARS) {
+            flushChunk();
+        }
+    }
+    flushChunk();
+    return chunks.length ? chunks : [content.trim()].filter(Boolean);
+}
+//# sourceMappingURL=markdownChunker.js.map

package/dist/core/domain/memory/retrieval/markdownChunker.js.map

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

package/dist/core/domain/memory/retrieval/parse.d.ts

@@ -0,0 +1,2 @@
+export declare function safeParseEmbedding(raw: string): number[] | null;
+export declare function safeParseStringArray(raw: string): string[];

package/dist/core/domain/memory/retrieval/parse.js

@@ -0,0 +1,28 @@
+export function safeParseEmbedding(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return null;
+        }
+        if (!parsed.length) {
+            return [];
+        }
+        if (!parsed.every((value) => typeof value === 'number' && Number.isFinite(value))) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function safeParseStringArray(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) && parsed.every((value) => typeof value === 'string') ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/domain/memory/retrieval/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/parse.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAClF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAkB,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/domain/memory/retrieval/ranking.d.ts

@@ -0,0 +1,11 @@
+import type { HybridRetrievalDocument, StrategyScores } from './types.js';
+export declare function rankByScore(docs: Array<{
+    chunkId: string;
+    scores: StrategyScores;
+}>, strategy: keyof StrategyScores): Map<string, number>;
+export declare function topStrategy(scores: StrategyScores): 'symbolic' | 'semantic' | 'metadata';
+export declare function rerankWithHeuristics(query: string, queryTokens: string[], docs: Array<HybridRetrievalDocument & {
+    retrievalScore: number;
+}>): Array<HybridRetrievalDocument & {
+    retrievalScore: number;
+}>;

package/dist/core/domain/memory/retrieval/ranking.js

@@ -0,0 +1,63 @@
+export function rankByScore(docs, strategy) {
+    const ranked = docs
+        .filter((doc) => doc.scores[strategy] > 0)
+        .sort((a, b) => {
+        if (b.scores[strategy] !== a.scores[strategy]) {
+            return b.scores[strategy] - a.scores[strategy];
+        }
+        return a.chunkId.localeCompare(b.chunkId);
+    });
+    const rankMap = new Map();
+    for (let index = 0; index < ranked.length; index += 1) {
+        rankMap.set(ranked[index].chunkId, index + 1);
+    }
+    return rankMap;
+}
+export function topStrategy(scores) {
+    if (scores.semantic >= scores.symbolic && scores.semantic >= scores.metadata) {
+        return 'semantic';
+    }
+    if (scores.symbolic >= scores.metadata) {
+        return 'symbolic';
+    }
+    return 'metadata';
+}
+export function rerankWithHeuristics(query, queryTokens, docs) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery || !docs.length) {
+        return docs;
+    }
+    return docs
+        .map((doc) => {
+        const lower = doc.content.toLowerCase();
+        const coverage = queryTokens.length
+            ? queryTokens.filter((token) => lower.includes(token)).length / queryTokens.length
+            : 0;
+        let orderedHits = 0;
+        let cursor = 0;
+        for (const token of queryTokens) {
+            const pos = lower.indexOf(token, cursor);
+            if (pos >= 0) {
+                orderedHits += 1;
+                cursor = pos + token.length;
+            }
+        }
+        const orderedRatio = queryTokens.length ? orderedHits / queryTokens.length : 0;
+        const exactPhraseBonus = normalizedQuery.length > 4 && lower.includes(normalizedQuery) ? 0.18 : 0;
+        const rerankScore = doc.retrievalScore * 0.72 + coverage * 0.2 + orderedRatio * 0.08 + exactPhraseBonus;
+        return {
+            ...doc,
+            score: rerankScore
+        };
+    })
+        .sort((a, b) => {
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        if (b.retrievalScore !== a.retrievalScore) {
+            return b.retrievalScore - a.retrievalScore;
+        }
+        return a.id.localeCompare(b.id);
+    });
+}
+//# sourceMappingURL=ranking.js.map

package/dist/core/domain/memory/retrieval/ranking.js.map

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

package/dist/core/domain/memory/retrieval/schema.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseSync } from 'node:sqlite';
+export declare function ensureRetrievalSchema(db: DatabaseSync): void;

package/dist/core/domain/memory/retrieval/schema.js

@@ -0,0 +1,105 @@
+function hasColumn(columns, columnName) {
+    return columns.some((column) => column.name === columnName);
+}
+function tableColumns(db, tableName) {
+    return db.prepare(`PRAGMA table_info(${tableName})`).all();
+}
+function createRetrievalTables(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS retrieval_embeddings (
+      scope_key TEXT NOT NULL,
+      chunk_id TEXT NOT NULL,
+      content_hash TEXT NOT NULL,
+      embedding TEXT NOT NULL,
+      embedding_version INTEGER NOT NULL DEFAULT 1,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (scope_key, chunk_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS retrieval_chunks (
+      scope_key TEXT NOT NULL,
+      chunk_id TEXT NOT NULL,
+      doc_id TEXT NOT NULL,
+      layer TEXT NOT NULL,
+      project_key TEXT,
+      scope_id TEXT,
+      space_id TEXT,
+      thread_id TEXT,
+      file_path TEXT NOT NULL,
+      file_mtime_ms INTEGER NOT NULL,
+      file_size INTEGER NOT NULL,
+      chunk_index INTEGER NOT NULL,
+      content TEXT NOT NULL,
+      source_refs TEXT NOT NULL,
+      recency_boost REAL NOT NULL,
+      content_hash TEXT NOT NULL,
+      metadata_tokens TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (scope_key, chunk_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS retrieval_files (
+      scope_key TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      layer TEXT NOT NULL,
+      project_key TEXT,
+      scope_id TEXT,
+      space_id TEXT,
+      thread_id TEXT,
+      file_mtime_ms INTEGER NOT NULL,
+      file_size INTEGER NOT NULL,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (scope_key, file_path)
+    );
+
+    CREATE TABLE IF NOT EXISTS retrieval_index_state (
+      scope_key TEXT PRIMARY KEY,
+      last_refresh_started_at TEXT NOT NULL,
+      last_refresh_completed_at TEXT
+    );
+  `);
+}
+function ensureScopedIndexes(db) {
+    db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_retrieval_chunks_scope
+      ON retrieval_chunks (layer, project_key, scope_id, space_id, thread_id);
+
+    CREATE INDEX IF NOT EXISTS idx_retrieval_chunks_file
+      ON retrieval_chunks (scope_key, file_path);
+
+    CREATE INDEX IF NOT EXISTS idx_retrieval_files_scope
+      ON retrieval_files (layer, project_key, scope_id, space_id, thread_id);
+  `);
+}
+function isLegacyChunkSchema(columns) {
+    return (columns.length > 0 &&
+        (!hasColumn(columns, 'scope_key') || hasColumn(columns, 'guild_id') || hasColumn(columns, 'channel_id') || !hasColumn(columns, 'layer')));
+}
+function isLegacyFileSchema(columns) {
+    return (columns.length > 0 &&
+        (!hasColumn(columns, 'scope_key') || hasColumn(columns, 'guild_id') || hasColumn(columns, 'channel_id') || !hasColumn(columns, 'layer')));
+}
+function isLegacyEmbeddingSchema(columns) {
+    return columns.length > 0 && hasColumn(columns, 'doc_id');
+}
+function assertCurrentRetrievalSchema(db) {
+    const outdatedTables = [];
+    if (isLegacyChunkSchema(tableColumns(db, 'retrieval_chunks'))) {
+        outdatedTables.push('retrieval_chunks');
+    }
+    if (isLegacyFileSchema(tableColumns(db, 'retrieval_files'))) {
+        outdatedTables.push('retrieval_files');
+    }
+    if (isLegacyEmbeddingSchema(tableColumns(db, 'retrieval_embeddings'))) {
+        outdatedTables.push('retrieval_embeddings');
+    }
+    if (outdatedTables.length > 0) {
+        throw new Error(`Retrieval schema is outdated in ${outdatedTables.join(', ')}. Delete the retrieval index tables and let Moorline rebuild them with the current scope_key schema.`);
+    }
+}
+export function ensureRetrievalSchema(db) {
+    createRetrievalTables(db);
+    assertCurrentRetrievalSchema(db);
+    ensureScopedIndexes(db);
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/domain/memory/retrieval/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/schema.ts"],"names":[],"mappings":"AAOA,SAAS,SAAS,CAAC,OAA0B,EAAE,UAAkB;IAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,EAAgB,EAAE,SAAiB;IACvD,OAAO,EAAE,CAAC,OAAO,CAAC,qBAAqB,SAAS,GAAG,CAAC,CAAC,GAAG,EAAkC,CAAC;AAC7F,CAAC;AAED,SAAS,qBAAqB,CAAC,EAAgB;IAC7C,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAgB;IAC3C,EAAE,CAAC,IAAI,CAAC;;;;;;;;;GASP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA0B;IACrD,OAAO,CACL,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CACzI,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAA0B;IACpD,OAAO,CACL,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CACzI,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAA0B;IACzD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,4BAA4B,CAAC,EAAgB;IACpD,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,mBAAmB,CAAC,YAAY,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC;QAC9D,cAAc,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;QAC5D,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,uBAAuB,CAAC,YAAY,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC;QACtE,cAAc,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,mCAAmC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,sGAAsG,CACnK,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAgB;IACpD,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/domain/memory/retrieval/scope.d.ts

@@ -0,0 +1,20 @@
+import type { RetrievalScope } from './types.js';
+export interface NormalizedRetrievalScope {
+    scopeId: string;
+    spaceId: string | null;
+    threadId: string | null;
+    projectKey: string;
+}
+interface RetrievalStorageScope {
+    layer: 'project' | 'server' | 'session';
+    projectKey: string | null;
+    scopeId: string | null;
+    spaceId: string | null;
+    threadId: string | null;
+}
+export declare function normalizeScope(scope: RetrievalScope): NormalizedRetrievalScope;
+export declare function scopeKey(scope: NormalizedRetrievalScope): string;
+export declare function storageScopeKey(scope: RetrievalStorageScope): string;
+export declare function selectScopeFilter(alias: string, includeAllScopeSessions: boolean): string;
+export declare function scopeFilterArgs(scope: NormalizedRetrievalScope): string[];
+export {};

package/dist/core/domain/memory/retrieval/scope.js

@@ -0,0 +1,38 @@
+import { sanitizePathSegment } from '../pathSafety.js';
+export function normalizeScope(scope) {
+    const scopeId = sanitizePathSegment(scope.scopeId, 'scopeId');
+    const spaceId = scope.spaceId ? sanitizePathSegment(scope.spaceId, 'spaceId') : null;
+    const threadId = spaceId ? sanitizePathSegment(scope.threadId ?? 'root', 'threadId') : null;
+    const projectKey = sanitizePathSegment(scope.projectKey ?? 'default', 'projectKey');
+    return {
+        scopeId,
+        spaceId,
+        threadId,
+        projectKey
+    };
+}
+export function scopeKey(scope) {
+    return JSON.stringify(scope);
+}
+export function storageScopeKey(scope) {
+    if (scope.layer === 'project') {
+        return `project:${scope.projectKey ?? 'default'}`;
+    }
+    if (scope.layer === 'server') {
+        return `server:${scope.scopeId ?? 'unknown'}`;
+    }
+    return `session:${scope.scopeId ?? 'unknown'}:${scope.spaceId ?? '*'}:${scope.threadId ?? '*'}`;
+}
+export function selectScopeFilter(alias, includeAllScopeSessions) {
+    return `(
+    (${alias}.layer = 'project' AND ${alias}.project_key = ?)
+    OR (${alias}.layer = 'server' AND ${alias}.scope_id = ?)
+    OR (${alias}.layer = 'session' AND ${alias}.scope_id = ? AND ${includeAllScopeSessions ? '1 = 1' : `${alias}.space_id = ? AND ${alias}.thread_id = ?`})
+  )`;
+}
+export function scopeFilterArgs(scope) {
+    return !scope.spaceId
+        ? [scope.projectKey, scope.scopeId, scope.scopeId]
+        : [scope.projectKey, scope.scopeId, scope.scopeId, scope.spaceId, scope.threadId ?? 'root'];
+}
+//# sourceMappingURL=scope.js.map

package/dist/core/domain/memory/retrieval/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAiBvD,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,IAAI,SAAS,EAAE,YAAY,CAAC,CAAC;IACpF,OAAO;QACL,OAAO;QACP,OAAO;QACP,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAA+B;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA4B;IAC1D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,KAAK,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,UAAU,KAAK,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,WAAW,KAAK,CAAC,OAAO,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,IAAI,KAAK,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,uBAAgC;IAC/E,OAAO;OACF,KAAK,0BAA0B,KAAK;UACjC,KAAK,yBAAyB,KAAK;UACnC,KAAK,0BAA0B,KAAK,qBACxC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,qBAAqB,KAAK,gBACxE;IACA,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA+B;IAC7D,OAAO,CAAC,KAAK,CAAC,OAAO;QACnB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;QAClD,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;AAChG,CAAC"}

package/dist/core/domain/memory/retrieval/tokenEmbedding.d.ts

@@ -0,0 +1,4 @@
+export declare function hashContent(content: string): string;
+export declare function normalizeTokens(text: string): string[];
+export declare function tokenEmbedding(text: string): number[];
+export declare function cosineSimilarity(a: number[], b: number[]): number;

package/dist/core/domain/memory/retrieval/tokenEmbedding.js

@@ -0,0 +1,44 @@
+import { createHash } from 'node:crypto';
+import { VECTOR_DIMENSIONS } from './types.js';
+export function hashContent(content) {
+    return createHash('sha1').update(content).digest('hex');
+}
+export function normalizeTokens(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((token) => token.length > 1);
+}
+export function tokenEmbedding(text) {
+    const vector = new Array(VECTOR_DIMENSIONS).fill(0);
+    const tokens = normalizeTokens(text);
+    if (!tokens.length) {
+        return vector;
+    }
+    for (const token of tokens) {
+        const tokenHash = createHash('sha1').update(token).digest();
+        for (let i = 0; i < tokenHash.length; i += 1) {
+            const bucket = tokenHash[i] % VECTOR_DIMENSIONS;
+            const sign = i % 2 === 0 ? 1 : -1;
+            vector[bucket] += sign * (1 + tokenHash[i] / 255);
+        }
+    }
+    const norm = Math.sqrt(vector.reduce((sum, value) => sum + value * value, 0));
+    if (norm === 0) {
+        return vector;
+    }
+    return vector.map((value) => value / norm);
+}
+export function cosineSimilarity(a, b) {
+    const length = Math.min(a.length, b.length);
+    if (length === 0) {
+        return 0;
+    }
+    let sum = 0;
+    for (let i = 0; i < length; i += 1) {
+        sum += a[i] * b[i];
+    }
+    return Math.max(0, sum);
+}
+//# sourceMappingURL=tokenEmbedding.js.map

package/dist/core/domain/memory/retrieval/tokenEmbedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEmbedding.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/tokenEmbedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;YAChD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/domain/memory/retrieval/types.d.ts

@@ -0,0 +1,88 @@
+export interface HybridRetrievalDocument {
+    id: string;
+    content: string;
+    sourceRefs: string[];
+    score: number;
+    strategy: 'symbolic' | 'semantic' | 'metadata';
+}
+export interface CandidateDoc {
+    scopeKey: string;
+    docId: string;
+    chunkId: string;
+    chunkIndex: number;
+    content: string;
+    sourceRefs: string[];
+    recencyBoost: number;
+    contentHash: string;
+    metadataTokens: string[];
+}
+export interface StrategyScores {
+    symbolic: number;
+    semantic: number;
+    metadata: number;
+}
+export interface VectorRow {
+    scopeKey: string;
+    chunkId: string;
+    contentHash: string;
+    embedding: string;
+    embeddingVersion?: number;
+}
+export interface RetrievalChunkRow {
+    scopeKey: string;
+    docId: string;
+    chunkId: string;
+    chunkIndex: number;
+    content: string;
+    sourceRefs: string;
+    recencyBoost: number;
+    contentHash: string;
+    metadataTokens: string;
+}
+export interface CachedEmbeddingChunkRow {
+    scopeKey: string;
+    chunkId: string;
+    content: string;
+    contentHash: string;
+    embedding: string | null;
+    embeddingVersion: number | null;
+}
+export interface RetrievalFileRow {
+    scopeKey: string;
+    filePath: string;
+    fileMtimeMs: number;
+    fileSize: number;
+}
+export interface RetrievalIndexStateRow {
+    scopeKey: string;
+    lastRefreshCompletedAt: string | null;
+}
+export interface IndexTarget {
+    layer: 'project' | 'server' | 'session';
+    rootPath: string;
+    projectKey: string | null;
+    scopeId: string | null;
+    spaceId: string | null;
+    threadId: string | null;
+}
+export interface RetrievalOptions {
+    enableRerank?: boolean;
+    maxResults?: number;
+}
+export interface RetrievalScope {
+    scopeId: string;
+    spaceId?: string;
+    threadId?: string | null;
+    projectKey?: string;
+}
+export interface RetrievalDocument {
+    id: string;
+    content: string;
+    sourceRefs: string[];
+}
+export declare const VECTOR_DIMENSIONS = 96;
+export declare const EMBEDDING_VERSION = 2;
+export declare const CHUNK_TARGET_CHARS = 1200;
+export declare const CHUNK_MAX_CHARS = 1800;
+export declare const RRF_K = 60;
+export declare const REFRESH_INTERVAL_MS = 30000;

package/dist/core/domain/memory/retrieval/types.js

@@ -0,0 +1,7 @@
+export const VECTOR_DIMENSIONS = 96;
+export const EMBEDDING_VERSION = 2;
+export const CHUNK_TARGET_CHARS = 1200;
+export const CHUNK_MAX_CHARS = 1800;
+export const RRF_K = 60;
+export const REFRESH_INTERVAL_MS = 30_000;
+//# sourceMappingURL=types.js.map

package/dist/core/domain/memory/retrieval/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../src/core/domain/memory/retrieval/types.ts"],"names":[],"mappings":"AA8FA,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;AACxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC"}

package/dist/core/domain/memory/retrieval.d.ts

@@ -0,0 +1,4 @@
+import type { HybridRetrievalDocument, RetrievalDocument, RetrievalOptions, RetrievalScope } from './retrieval/types.js';
+export declare function retrieveWithProvenance(query: string, docs: RetrievalDocument[]): RetrievalDocument[];
+export declare function refreshMemoryIndex(repoPath: string, scope: RetrievalScope, sqlitePath: string): Promise<void>;
+export declare function retrieveFromMemoryWithSQLite(query: string, repoPath: string, scope: RetrievalScope, sqlitePath: string, options?: RetrievalOptions): Promise<HybridRetrievalDocument[]>;