@jim80net/memex-core 0.1.0

package/dist/cache.d.ts

@@ -0,0 +1,9 @@
+import type { CacheData, CachedSkill, IndexedSkill } from "./types.js";
+export declare function loadCache(cachePath: string, embeddingModel: string): Promise<CacheData>;
+export declare function saveCache(cachePath: string, data: CacheData): Promise<void>;
+export declare function getCachedSkill(cache: CacheData, location: string): CachedSkill | undefined;
+export declare function setCachedSkill(cache: CacheData, location: string, skill: CachedSkill): void;
+export declare function removeCachedSkill(cache: CacheData, location: string): void;
+export declare function toCachedSkill(skill: IndexedSkill, mtime: number): CachedSkill;
+export declare function fromCachedSkill(location: string, cached: CachedSkill): IndexedSkill;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIvE,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAY7F;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAU7E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,CAUnF"}

package/dist/cache.js

@@ -0,0 +1,57 @@
+import { randomBytes } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+const CACHE_VERSION = 2;
+export async function loadCache(cachePath, embeddingModel) {
+    const empty = { version: CACHE_VERSION, embeddingModel, skills: {} };
+    try {
+        const raw = await readFile(cachePath, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.version !== CACHE_VERSION || data.embeddingModel !== embeddingModel) {
+            return empty;
+        }
+        return data;
+    }
+    catch {
+        return empty;
+    }
+}
+export async function saveCache(cachePath, data) {
+    const dir = dirname(cachePath);
+    await mkdir(dir, { recursive: true });
+    const tmpPath = `${cachePath}.${randomBytes(4).toString("hex")}.tmp`;
+    await writeFile(tmpPath, JSON.stringify(data), "utf-8");
+    await rename(tmpPath, cachePath);
+}
+export function getCachedSkill(cache, location) {
+    return cache.skills[location];
+}
+export function setCachedSkill(cache, location, skill) {
+    cache.skills[location] = skill;
+}
+export function removeCachedSkill(cache, location) {
+    delete cache.skills[location];
+}
+export function toCachedSkill(skill, mtime) {
+    return {
+        name: skill.name,
+        description: skill.description,
+        queries: skill.queries,
+        embeddings: skill.embeddings,
+        mtime,
+        type: skill.type,
+        oneLiner: skill.oneLiner,
+    };
+}
+export function fromCachedSkill(location, cached) {
+    return {
+        name: cached.name,
+        description: cached.description,
+        location,
+        type: cached.type,
+        embeddings: cached.embeddings,
+        queries: cached.queries,
+        oneLiner: cached.oneLiner,
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,aAAa,GAAG,CAAU,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,cAAsB;IACvE,MAAM,KAAK,GAAc,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QAC1C,IAAI,IAAI,CAAC,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,cAAc,KAAK,cAAc,EAAE,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,IAAe;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IACrE,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,QAAgB;IAC/D,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,QAAgB,EAAE,KAAkB;IACnF,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAgB,EAAE,QAAgB;IAClE,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAmB,EAAE,KAAa;IAC9D,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAmB;IACnE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+import type { MemexCoreConfig } from "./types.js";
+export declare const DEFAULT_CORE_CONFIG: MemexCoreConfig;
+/**
+ * Resolve a core config from a partial runtime config dict.
+ * Merges with defaults, validating types.
+ */
+export declare function resolveCoreConfig(partial?: Partial<MemexCoreConfig>): MemexCoreConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,mBAAmB,EAAE,eAajC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAiCrF"}

package/dist/config.js

@@ -0,0 +1,47 @@
+export const DEFAULT_CORE_CONFIG = {
+    enabled: true,
+    embeddingModel: "Xenova/all-MiniLM-L6-v2",
+    embeddingBackend: "local",
+    cacheTimeMs: 300_000, // 5 min
+    topK: 3,
+    threshold: 0.35, // floor: best match must clear this to inject anything
+    scoringMode: "relative",
+    maxDropoff: 0.1, // in relative mode, drop results scoring > this below the best match
+    maxInjectedChars: 8000,
+    types: ["skill", "memory", "workflow", "session-learning", "rule"],
+    skillDirs: [],
+    memoryDirs: [],
+};
+/**
+ * Resolve a core config from a partial runtime config dict.
+ * Merges with defaults, validating types.
+ */
+export function resolveCoreConfig(partial) {
+    if (!partial)
+        return { ...DEFAULT_CORE_CONFIG };
+    return {
+        enabled: typeof partial.enabled === "boolean" ? partial.enabled : DEFAULT_CORE_CONFIG.enabled,
+        embeddingModel: typeof partial.embeddingModel === "string"
+            ? partial.embeddingModel
+            : DEFAULT_CORE_CONFIG.embeddingModel,
+        embeddingBackend: partial.embeddingBackend === "openai" ? "openai" : DEFAULT_CORE_CONFIG.embeddingBackend,
+        cacheTimeMs: typeof partial.cacheTimeMs === "number"
+            ? partial.cacheTimeMs
+            : DEFAULT_CORE_CONFIG.cacheTimeMs,
+        topK: typeof partial.topK === "number" ? partial.topK : DEFAULT_CORE_CONFIG.topK,
+        threshold: typeof partial.threshold === "number" ? partial.threshold : DEFAULT_CORE_CONFIG.threshold,
+        scoringMode: partial.scoringMode === "absolute" ? "absolute" : DEFAULT_CORE_CONFIG.scoringMode,
+        maxDropoff: typeof partial.maxDropoff === "number" ? partial.maxDropoff : DEFAULT_CORE_CONFIG.maxDropoff,
+        maxInjectedChars: typeof partial.maxInjectedChars === "number"
+            ? partial.maxInjectedChars
+            : DEFAULT_CORE_CONFIG.maxInjectedChars,
+        types: Array.isArray(partial.types) ? partial.types : DEFAULT_CORE_CONFIG.types,
+        skillDirs: Array.isArray(partial.skillDirs)
+            ? partial.skillDirs.map(String)
+            : DEFAULT_CORE_CONFIG.skillDirs,
+        memoryDirs: Array.isArray(partial.memoryDirs)
+            ? partial.memoryDirs.map(String)
+            : DEFAULT_CORE_CONFIG.memoryDirs,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,yBAAyB;IACzC,gBAAgB,EAAE,OAAO;IACzB,WAAW,EAAE,OAAO,EAAE,QAAQ;IAC9B,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,IAAI,EAAE,uDAAuD;IACxE,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,GAAG,EAAE,qEAAqE;IACtF,gBAAgB,EAAE,IAAI;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAC;IAClE,SAAS,EAAE,EAAE;IACb,UAAU,EAAE,EAAE;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAkC;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAChD,OAAO;QACL,OAAO,EAAE,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO;QAC7F,cAAc,EACZ,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ;YACxC,CAAC,CAAC,OAAO,CAAC,cAAc;YACxB,CAAC,CAAC,mBAAmB,CAAC,cAAc;QACxC,gBAAgB,EACd,OAAO,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,gBAAgB;QACzF,WAAW,EACT,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;YACrC,CAAC,CAAC,OAAO,CAAC,WAAW;YACrB,CAAC,CAAC,mBAAmB,CAAC,WAAW;QACrC,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI;QAChF,SAAS,EACP,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS;QAC3F,WAAW,EACT,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW;QACnF,UAAU,EACR,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,UAAU;QAC9F,gBAAgB,EACd,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ;YAC1C,CAAC,CAAC,OAAO,CAAC,gBAAgB;YAC1B,CAAC,CAAC,mBAAmB,CAAC,gBAAgB;QAC1C,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK;QAC/E,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;YACzC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAC/B,CAAC,CAAC,mBAAmB,CAAC,SAAS;QACjC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAChC,CAAC,CAAC,mBAAmB,CAAC,UAAU;KACnC,CAAC;AACJ,CAAC"}

package/dist/embeddings.d.ts

@@ -0,0 +1,24 @@
+export interface EmbeddingProvider {
+    embed(texts: string[]): Promise<number[][]>;
+}
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    private model;
+    private apiKey;
+    constructor(model: string, apiKey: string);
+    embed(texts: string[]): Promise<number[][]>;
+}
+export declare class LocalEmbeddingProvider implements EmbeddingProvider {
+    private model;
+    private cacheDir?;
+    private extractorPromise;
+    constructor(model?: string, cacheDir?: string);
+    embed(texts: string[]): Promise<number[][]>;
+    private getExtractor;
+    private initExtractor;
+}
+/**
+ * Cosine similarity between two vectors.
+ * Optimized: detects pre-normalized vectors (norm ≈ 1.0) and uses dot product directly.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC7C;AAUD,qBAAa,uBAAwB,YAAW,iBAAiB;IAE7D,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;gBADN,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAGlB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CA8BlD;AAMD,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAiC;gBAE7C,KAAK,GAAE,MAAkC,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAqBnC,YAAY;YAOZ,aAAa;CAoD5B;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAuBjE"}

package/dist/embeddings.js

@@ -0,0 +1,143 @@
+// ---------------------------------------------------------------------------
+// Embedding provider interface + implementations
+// ---------------------------------------------------------------------------
+export class OpenAIEmbeddingProvider {
+    model;
+    apiKey;
+    constructor(model, apiKey) {
+        this.model = model;
+        this.apiKey = apiKey;
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const BATCH_SIZE = 2048;
+        const results = new Array(texts.length);
+        for (let offset = 0; offset < texts.length; offset += BATCH_SIZE) {
+            const batch = texts.slice(offset, offset + BATCH_SIZE);
+            const response = await fetch("https://api.openai.com/v1/embeddings", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({ model: this.model, input: batch }),
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`OpenAI embeddings API error ${response.status}: ${text}`);
+            }
+            const json = (await response.json());
+            for (const item of json.data) {
+                results[offset + item.index] = item.embedding;
+            }
+        }
+        return results;
+    }
+}
+// ---------------------------------------------------------------------------
+// Local ONNX provider (requires @huggingface/transformers as optional dep)
+// ---------------------------------------------------------------------------
+export class LocalEmbeddingProvider {
+    model;
+    cacheDir;
+    extractorPromise = null;
+    constructor(model = "Xenova/all-MiniLM-L6-v2", cacheDir) {
+        this.model = model;
+        this.cacheDir = cacheDir;
+    }
+    async embed(texts) {
+        if (texts.length === 0)
+            return [];
+        const extractor = await this.getExtractor();
+        const output = await extractor(texts, {
+            pooling: "mean",
+            normalize: true,
+        });
+        const data = output.data;
+        const dims = output.dims;
+        const dim = dims[dims.length - 1];
+        const results = [];
+        for (let i = 0; i < texts.length; i++) {
+            results.push(Array.from(data.slice(i * dim, (i + 1) * dim)));
+        }
+        return results;
+    }
+    async getExtractor() {
+        if (!this.extractorPromise) {
+            this.extractorPromise = this.initExtractor();
+        }
+        return this.extractorPromise;
+    }
+    async initExtractor() {
+        let transformers;
+        const { join, dirname } = await import("node:path");
+        const { fileURLToPath } = await import("node:url");
+        // Dynamic import for createRequire — types may not expose it on the namespace
+        const moduleMod = await import("node:module");
+        const createRequire = moduleMod.createRequire || moduleMod.default?.createRequire;
+        let pluginDir;
+        try {
+            pluginDir = dirname(fileURLToPath(import.meta.url));
+        }
+        catch {
+            pluginDir = typeof __dirname !== "undefined" ? __dirname : process.cwd();
+        }
+        try {
+            transformers = (await import("@huggingface/transformers"));
+        }
+        catch {
+            try {
+                const require = createRequire(join(pluginDir, "package.json"));
+                const resolvedPath = require.resolve("@huggingface/transformers");
+                transformers = (await import(resolvedPath));
+            }
+            catch {
+                try {
+                    const absolutePath = join(pluginDir, "..", "node_modules", "@huggingface", "transformers", "src", "transformers.js");
+                    transformers = (await import(absolutePath));
+                }
+                catch {
+                    throw new Error("Local embedding backend requires @huggingface/transformers. " +
+                        "Install it: npm install @huggingface/transformers");
+                }
+            }
+        }
+        if (this.cacheDir) {
+            transformers.env.cacheDir = this.cacheDir;
+        }
+        return transformers.pipeline("feature-extraction", this.model, {
+            dtype: "q8",
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Cosine similarity (shared utility)
+// ---------------------------------------------------------------------------
+/**
+ * Cosine similarity between two vectors.
+ * Optimized: detects pre-normalized vectors (norm ≈ 1.0) and uses dot product directly.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+    }
+    // Fast path: normalized vectors (norm ≈ 1.0) — just return dot product.
+    let normSqA = 0;
+    let normSqB = 0;
+    for (let i = 0; i < a.length; i++) {
+        normSqA += a[i] * a[i];
+        normSqB += b[i] * b[i];
+    }
+    if (Math.abs(normSqA - 1.0) < 1e-6 && Math.abs(normSqB - 1.0) < 1e-6) {
+        return dot;
+    }
+    const denom = Math.sqrt(normSqA) * Math.sqrt(normSqB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

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

package/dist/file-lock.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Acquire an advisory file lock using mkdir (atomic on all platforms).
+ * Returns an unlock function.
+ */
+export declare function acquireLock(filePath: string): Promise<() => Promise<void>>;
+/**
+ * Execute a callback while holding a file lock.
+ * The lock is released after the callback completes (or throws).
+ */
+export declare function withFileLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../src/file-lock.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuChF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxF"}

package/dist/file-lock.js

@@ -0,0 +1,63 @@
+import { mkdir, rmdir, stat } from "node:fs/promises";
+const LOCK_TIMEOUT_MS = 5_000;
+const LOCK_RETRY_MS = 50;
+const STALE_LOCK_MS = 30_000;
+/**
+ * Acquire an advisory file lock using mkdir (atomic on all platforms).
+ * Returns an unlock function.
+ */
+export async function acquireLock(filePath) {
+    const lockDir = filePath + ".lock";
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        try {
+            await mkdir(lockDir);
+            return async () => {
+                try {
+                    await rmdir(lockDir);
+                }
+                catch {
+                    // Lock already released or cleaned up
+                }
+            };
+        }
+        catch {
+            // Lock exists — check if stale
+            try {
+                const lockStat = await stat(lockDir);
+                if (Date.now() - lockStat.mtimeMs > STALE_LOCK_MS) {
+                    // Stale lock — force remove and retry
+                    try {
+                        await rmdir(lockDir);
+                    }
+                    catch {
+                        // Another process beat us to it
+                    }
+                    continue;
+                }
+            }
+            catch {
+                // Lock was released between our mkdir and stat — retry immediately
+                continue;
+            }
+            // Wait before retrying
+            await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_MS));
+        }
+    }
+    // Timeout — proceed without lock (best-effort)
+    return async () => { };
+}
+/**
+ * Execute a callback while holding a file lock.
+ * The lock is released after the callback completes (or throws).
+ */
+export async function withFileLock(filePath, fn) {
+    const unlock = await acquireLock(filePath);
+    try {
+        return await fn();
+    }
+    finally {
+        await unlock();
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/file-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../src/file-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC;IAE9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,KAAK,IAAI,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;YAC/B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,aAAa,EAAE,CAAC;oBAClD,sCAAsC;oBACtC,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;oBACvB,CAAC;oBAAC,MAAM,CAAC;wBACP,gCAAgC;oBAClC,CAAC;oBACD,SAAS;gBACX,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;gBACnE,SAAS;YACX,CAAC;YAED,uBAAuB;YACvB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,OAAO,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,EAAoB;IAC1E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./types.js";
+export * from "./version.js";
+export * from "./file-lock.js";
+export * from "./path-encoder.js";
+export * from "./embeddings.js";
+export * from "./cache.js";
+export * from "./config.js";
+export * from "./session.js";
+export * from "./telemetry.js";
+export * from "./project-mapping.js";
+export * from "./project-registry.js";
+export { autoResolveMarkdownConflict, initSyncRepo, syncPull, syncCommitAndPush, getSyncScanDirs } from "./sync.js";
+export * from "./traces.js";
+export { SkillIndex, parseFrontmatter, parseMemoryFile } from "./skill-index.js";
+export type { ScanDirs } from "./skill-index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACpH,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjF,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from "./types.js";
+export * from "./version.js";
+export * from "./file-lock.js";
+export * from "./path-encoder.js";
+export * from "./embeddings.js";
+export * from "./cache.js";
+export * from "./config.js";
+export * from "./session.js";
+export * from "./telemetry.js";
+export * from "./project-mapping.js";
+export * from "./project-registry.js";
+export { autoResolveMarkdownConflict, initSyncRepo, syncPull, syncCommitAndPush, getSyncScanDirs } from "./sync.js";
+export * from "./traces.js";
+export { SkillIndex, parseFrontmatter, parseMemoryFile } from "./skill-index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACpH,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/path-encoder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Encode an absolute path to a project directory name.
+ * `/home/user/.myproject` → `-home-user--myproject`
+ *
+ * Rules:
+ * - `/` becomes `-`
+ * - `.` becomes `-`
+ * - `_` becomes `-`
+ * - Consecutive `-` are preserved (they encode dots/separators)
+ */
+export declare function encodeProjectPath(cwd: string): string;
+//# sourceMappingURL=path-encoder.d.ts.map

package/dist/path-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-encoder.d.ts","sourceRoot":"","sources":["../src/path-encoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/path-encoder.js

@@ -0,0 +1,14 @@
+/**
+ * Encode an absolute path to a project directory name.
+ * `/home/user/.myproject` → `-home-user--myproject`
+ *
+ * Rules:
+ * - `/` becomes `-`
+ * - `.` becomes `-`
+ * - `_` becomes `-`
+ * - Consecutive `-` are preserved (they encode dots/separators)
+ */
+export function encodeProjectPath(cwd) {
+    return cwd.replace(/\//g, "-").replace(/\./g, "-").replace(/_/g, "-");
+}
+//# sourceMappingURL=path-encoder.js.map

package/dist/path-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-encoder.js","sourceRoot":"","sources":["../src/path-encoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACxE,CAAC"}

package/dist/project-mapping.d.ts

@@ -0,0 +1,29 @@
+import type { SyncConfig } from "./types.js";
+/**
+ * Normalize a git remote URL to a canonical path segment.
+ * Handles SSH, HTTPS, and .git suffix variations.
+ *
+ * Examples:
+ *   git@github.com:jim80net/repo.git → github.com/jim80net/repo
+ *   https://github.com/jim80net/repo.git → github.com/jim80net/repo
+ */
+export declare function normalizeGitUrl(url: string): string;
+/**
+ * Resolve the canonical project identifier for a given cwd.
+ *
+ * Resolution cascade:
+ * 1. Manual mapping from config (explicit override)
+ * 2. Git remote URL → normalized to host/owner/repo
+ * 3. Encoded cwd path → stored under _local/
+ */
+export declare function resolveProjectId(cwd: string, syncConfig: SyncConfig): Promise<string>;
+/**
+ * Find all project memory directories in the sync repo that match the current cwd.
+ * Multiple matches are possible (e.g., same project stored under both URL and encoded path).
+ */
+export declare function findMatchingProjectMemoryDirs(cwd: string, syncRepoPath: string, syncConfig: SyncConfig): Promise<string[]>;
+/**
+ * Get the sync repo's memory directory path for the canonical project ID.
+ */
+export declare function getSyncProjectMemoryDir(cwd: string, syncRepoPath: string, syncConfig: SyncConfig): Promise<string>;
+//# sourceMappingURL=project-mapping.d.ts.map

package/dist/project-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mapping.d.ts","sourceRoot":"","sources":["../src/project-mapping.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBnD;AAkBD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3F;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBnB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/project-mapping.js

@@ -0,0 +1,106 @@
+import { execFile } from "node:child_process";
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { encodeProjectPath } from "./path-encoder.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Normalize a git remote URL to a canonical path segment.
+ * Handles SSH, HTTPS, and .git suffix variations.
+ *
+ * Examples:
+ *   git@github.com:jim80net/repo.git → github.com/jim80net/repo
+ *   https://github.com/jim80net/repo.git → github.com/jim80net/repo
+ */
+export function normalizeGitUrl(url) {
+    let normalized = url.trim();
+    // Strip trailing .git
+    normalized = normalized.replace(/\.git$/, "");
+    // SSH format: git@host:owner/repo
+    const sshMatch = normalized.match(/^[\w-]+@([^:]+):(.+)$/);
+    if (sshMatch) {
+        return `${sshMatch[1]}/${sshMatch[2]}`;
+    }
+    // HTTPS format: https://host/owner/repo
+    try {
+        const parsed = new URL(normalized);
+        return `${parsed.host}${parsed.pathname}`.replace(/^\//, "").replace(/\/$/, "");
+    }
+    catch {
+        return normalized;
+    }
+}
+/**
+ * Get the git remote origin URL for a directory, if it's a git repo.
+ */
+async function getGitRemoteUrl(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["remote", "get-url", "origin"], {
+            cwd,
+            timeout: 5000,
+        });
+        const url = stdout.trim();
+        return url || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the canonical project identifier for a given cwd.
+ *
+ * Resolution cascade:
+ * 1. Manual mapping from config (explicit override)
+ * 2. Git remote URL → normalized to host/owner/repo
+ * 3. Encoded cwd path → stored under _local/
+ */
+export async function resolveProjectId(cwd, syncConfig) {
+    // 1. Manual mapping
+    if (syncConfig.projectMappings[cwd]) {
+        return syncConfig.projectMappings[cwd];
+    }
+    // 2. Git remote URL
+    const remoteUrl = await getGitRemoteUrl(cwd);
+    if (remoteUrl) {
+        return normalizeGitUrl(remoteUrl);
+    }
+    // 3. Encoded path fallback
+    return `_local/${encodeProjectPath(cwd)}`;
+}
+/**
+ * Find all project memory directories in the sync repo that match the current cwd.
+ * Multiple matches are possible (e.g., same project stored under both URL and encoded path).
+ */
+export async function findMatchingProjectMemoryDirs(cwd, syncRepoPath, syncConfig) {
+    const projectsDir = join(syncRepoPath, "projects");
+    const matches = [];
+    const canonicalId = await resolveProjectId(cwd, syncConfig);
+    const canonicalMemDir = join(projectsDir, canonicalId, "memory");
+    try {
+        await stat(canonicalMemDir);
+        matches.push(canonicalMemDir);
+    }
+    catch {
+        // doesn't exist yet
+    }
+    const encodedPath = encodeProjectPath(cwd);
+    const localMemDir = join(projectsDir, "_local", encodedPath, "memory");
+    if (localMemDir !== canonicalMemDir) {
+        try {
+            await stat(localMemDir);
+            matches.push(localMemDir);
+        }
+        catch {
+            // doesn't exist
+        }
+    }
+    return matches;
+}
+/**
+ * Get the sync repo's memory directory path for the canonical project ID.
+ */
+export async function getSyncProjectMemoryDir(cwd, syncRepoPath, syncConfig) {
+    const canonicalId = await resolveProjectId(cwd, syncConfig);
+    return join(syncRepoPath, "projects", canonicalId, "memory");
+}
+//# sourceMappingURL=project-mapping.js.map

package/dist/project-mapping.js.map

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