@membank/core 0.0.0-dev-20260427133418

package/dist/index.cjs

@@ -0,0 +1,377 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs = require("node:fs");
+let node_os = require("node:os");
+let node_path = require("node:path");
+let better_sqlite3 = require("better-sqlite3");
+better_sqlite3 = __toESM(better_sqlite3, 1);
+let sqlite_vec = require("sqlite-vec");
+sqlite_vec = __toESM(sqlite_vec, 1);
+let _huggingface_transformers = require("@huggingface/transformers");
+let node_crypto = require("node:crypto");
+let node_child_process = require("node:child_process");
+let node_util = require("node:util");
+//#region src/db/errors.ts
+var MembankError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MembankError";
+	}
+};
+var DatabaseError = class extends MembankError {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "DatabaseError";
+	}
+};
+//#endregion
+//#region src/db/manager.ts
+const DEFAULT_DB_PATH = (0, node_path.join)((0, node_os.homedir)(), ".membank", "memory.db");
+const MIGRATIONS = [[1, `
+CREATE TABLE IF NOT EXISTS memories (
+  id           TEXT PRIMARY KEY,
+  content      TEXT NOT NULL,
+  type         TEXT NOT NULL,
+  tags         TEXT NOT NULL DEFAULT '[]',
+  scope        TEXT NOT NULL,
+  source       TEXT,
+  access_count INTEGER NOT NULL DEFAULT 0,
+  pinned       INTEGER NOT NULL DEFAULT 0,
+  needs_review INTEGER NOT NULL DEFAULT 0,
+  created_at   TEXT NOT NULL,
+  updated_at   TEXT NOT NULL
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(
+  embedding FLOAT[384]
+);
+`]];
+var DatabaseManager = class DatabaseManager {
+	#db;
+	constructor(db) {
+		this.#db = db;
+	}
+	static open(dbPath) {
+		const resolvedPath = dbPath ?? DEFAULT_DB_PATH;
+		(0, node_fs.mkdirSync)((0, node_path.dirname)(resolvedPath), { recursive: true });
+		const db = new better_sqlite3.default(resolvedPath);
+		return DatabaseManager.#init(db, sqlite_vec.load);
+	}
+	static openInMemory() {
+		return DatabaseManager.#initInMemory(sqlite_vec.load);
+	}
+	/** For testing: inject a custom vec loader (e.g. a throwing stub). */
+	static _openInMemoryWithLoader(loader) {
+		return DatabaseManager.#initInMemory(loader);
+	}
+	static #initInMemory(loader) {
+		const db = new better_sqlite3.default(":memory:");
+		return DatabaseManager.#init(db, loader);
+	}
+	static #init(db, loader) {
+		try {
+			loader(db);
+		} catch (err) {
+			throw new DatabaseError("Failed to load sqlite-vec extension", { cause: err });
+		}
+		db.pragma("journal_mode = WAL");
+		const manager = new DatabaseManager(db);
+		manager.#runMigrations();
+		return manager;
+	}
+	#runMigrations() {
+		this.#db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key   TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+		const row = this.#db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
+		const currentVersion = row ? Number.parseInt(row.value, 10) : 0;
+		for (const [targetVersion, sql] of MIGRATIONS) if (currentVersion < targetVersion) {
+			this.#db.exec(sql);
+			this.#db.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)").run(String(targetVersion));
+		}
+	}
+	get db() {
+		return this.#db;
+	}
+	close() {
+		this.#db.close();
+	}
+};
+//#endregion
+//#region src/embedding/service.ts
+var EmbeddingService = class {
+	modelCachePath;
+	onProgress;
+	pipelineInstance = null;
+	constructor(modelCachePath, onProgress) {
+		this.modelCachePath = modelCachePath ?? (0, node_path.join)((0, node_os.homedir)(), ".membank", "models");
+		this.onProgress = onProgress;
+	}
+	async getPipeline() {
+		if (this.pipelineInstance === null) this.pipelineInstance = await (0, _huggingface_transformers.pipeline)("feature-extraction", "Xenova/bge-small-en-v1.5", {
+			cache_dir: this.modelCachePath,
+			progress_callback: this.onProgress
+		});
+		return this.pipelineInstance;
+	}
+	async embed(text) {
+		const flat = (await (await this.getPipeline())(text, {
+			pooling: "mean",
+			normalize: true
+		})).data;
+		return flat instanceof Float32Array ? flat : new Float32Array(flat);
+	}
+};
+//#endregion
+//#region src/memory/repository.ts
+var MemoryRepository = class {
+	#db;
+	#embedding;
+	constructor(db, embeddingService) {
+		this.#db = db;
+		this.#embedding = embeddingService;
+	}
+	async save(options) {
+		const { content, type, tags = [], scope = "global", sourceHarness } = options;
+		const embedding = await this.#embedding.embed(content);
+		const embeddingBlob = Buffer.from(embedding.buffer);
+		const top = this.#db.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
+         FROM memories m JOIN embeddings e ON e.rowid = m.rowid
+         WHERE m.type = ? AND m.scope = ?
+         ORDER BY similarity DESC LIMIT 1`).get(embeddingBlob, type, scope);
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		if (top !== void 0 && top.similarity > .92) {
+			this.#db.db.prepare(`UPDATE memories SET content = ?, updated_at = ? WHERE id = ?`).run(content, now, top.id);
+			this.#db.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(embeddingBlob, top.rowid);
+			const updated = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(top.id);
+			return this.#rowToMemory(updated);
+		}
+		if (top !== void 0 && top.similarity >= .75) this.#db.db.prepare(`UPDATE memories SET needs_review = 1 WHERE id = ?`).run(top.id);
+		const id = (0, node_crypto.randomUUID)();
+		this.#db.db.prepare(`INSERT INTO memories (id, content, type, tags, scope, source, access_count, pinned, needs_review, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, 0, 0, 0, ?, ?)`).run(id, content, type, JSON.stringify(tags), scope, sourceHarness ?? null, now, now);
+		this.#db.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(embeddingBlob, id);
+		const row = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id);
+		return this.#rowToMemory(row);
+	}
+	async update(id, patch) {
+		const existing = this.#db.db.prepare(`SELECT m.rowid, m.* FROM memories m WHERE m.id = ?`).get(id);
+		if (existing === void 0) throw new Error(`Memory not found: ${id}`);
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const sets = ["updated_at = ?"];
+		const values = [now];
+		if (patch.content !== void 0) {
+			sets.push("content = ?");
+			values.push(patch.content);
+		}
+		if (patch.tags !== void 0) {
+			sets.push("tags = ?");
+			values.push(JSON.stringify(patch.tags));
+		}
+		values.push(id);
+		this.#db.db.prepare(`UPDATE memories SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+		if (patch.content !== void 0) {
+			const embedding = await this.#embedding.embed(patch.content);
+			const embeddingBlob = Buffer.from(embedding.buffer);
+			this.#db.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(embeddingBlob, existing.rowid);
+		}
+		const updated = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id);
+		return this.#rowToMemory(updated);
+	}
+	delete(id) {
+		const row = this.#db.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(id);
+		if (row !== void 0) this.#db.db.prepare(`DELETE FROM embeddings WHERE rowid = ?`).run(row.rowid);
+		this.#db.db.prepare(`DELETE FROM memories WHERE id = ?`).run(id);
+		return Promise.resolve();
+	}
+	incrementAccessCount(id) {
+		this.#db.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(id);
+	}
+	#rowToMemory(row) {
+		return {
+			id: row.id,
+			content: row.content,
+			type: row.type,
+			tags: JSON.parse(row.tags),
+			scope: row.scope,
+			sourceHarness: row.source,
+			accessCount: row.access_count,
+			pinned: row.pinned !== 0,
+			needsReview: row.needs_review !== 0,
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		};
+	}
+};
+//#endregion
+//#region src/query/engine.ts
+const TYPE_WEIGHTS = {
+	correction: 1,
+	preference: .8,
+	decision: .6,
+	learning: .4,
+	fact: .2
+};
+var QueryEngine = class {
+	#db;
+	#embedding;
+	#repo;
+	constructor(db, embeddingService, repo) {
+		this.#db = db;
+		this.#embedding = embeddingService;
+		this.#repo = repo;
+	}
+	async query(options) {
+		const { query, type, scope, limit = 10 } = options;
+		const queryEmbedding = await this.#embedding.embed(query);
+		const queryBlob = Buffer.from(queryEmbedding.buffer);
+		const whereClauses = [];
+		const params = [queryBlob];
+		if (type !== void 0) {
+			whereClauses.push("m.type = ?");
+			params.push(type);
+		}
+		if (scope !== void 0) {
+			whereClauses.push("m.scope = ?");
+			params.push(scope);
+		}
+		const sql = `
+      SELECT m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS cosine_sim
+      FROM memories m JOIN embeddings e ON e.rowid = m.rowid
+      ${whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : ""}
+    `;
+		const rows = this.#db.db.prepare(sql).all(...params);
+		const now = Date.now();
+		const scored = rows.filter((row) => row.cosine_sim > 0).map((row) => {
+			const memory = this.#rowToMemory(row);
+			const score = this.#computeScore(memory, now);
+			return {
+				...memory,
+				score
+			};
+		});
+		scored.sort((a, b) => b.score - a.score);
+		const results = scored.slice(0, limit);
+		for (const result of results) this.#repo.incrementAccessCount(result.id);
+		return results;
+	}
+	#computeScore(memory, now) {
+		const typeWeight = TYPE_WEIGHTS[memory.type];
+		const accessCountNorm = memory.accessCount / (memory.accessCount + 10);
+		const recencyNorm = 1 / (1 + (now - new Date(memory.updatedAt).getTime()) / 864e5);
+		const pinned = memory.pinned ? 1 : 0;
+		return typeWeight * .4 + accessCountNorm * .3 + recencyNorm * .2 + pinned * .1;
+	}
+	#rowToMemory(row) {
+		return {
+			id: row.id,
+			content: row.content,
+			type: row.type,
+			tags: JSON.parse(row.tags),
+			scope: row.scope,
+			sourceHarness: row.source,
+			accessCount: row.access_count,
+			pinned: row.pinned !== 0,
+			needsReview: row.needs_review !== 0,
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		};
+	}
+};
+//#endregion
+//#region src/scope/resolver.ts
+const execFileAsync = (0, node_util.promisify)(node_child_process.execFile);
+function sha256Truncated(input) {
+	return (0, node_crypto.createHash)("sha256").update(input).digest("hex").slice(0, 16);
+}
+async function resolveScope() {
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"remote",
+			"get-url",
+			"origin"
+		]);
+		const url = stdout.trim();
+		if (url) return sha256Truncated(url);
+	} catch {}
+	return sha256Truncated(process.cwd());
+}
+//#endregion
+//#region src/session/builder.ts
+const MEMORY_TYPES = [
+	"correction",
+	"preference",
+	"decision",
+	"learning",
+	"fact"
+];
+function rowToMemory(row) {
+	return {
+		id: row.id,
+		content: row.content,
+		type: row.type,
+		tags: JSON.parse(row.tags),
+		scope: row.scope,
+		sourceHarness: row.source,
+		accessCount: row.access_count,
+		pinned: row.pinned !== 0,
+		needsReview: row.needs_review !== 0,
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	};
+}
+function listMemoryTypes() {
+	return [...MEMORY_TYPES];
+}
+var SessionContextBuilder = class {
+	#db;
+	constructor(db) {
+		this.#db = db;
+	}
+	getSessionContext(projectScope) {
+		const pinnedGlobal = this.#db.db.prepare("SELECT * FROM memories WHERE scope = 'global' AND pinned = 1").all().map(rowToMemory);
+		const pinnedProject = this.#db.db.prepare("SELECT * FROM memories WHERE scope = ? AND pinned = 1").all(projectScope).map(rowToMemory);
+		const typeCounts = this.#db.db.prepare("SELECT type, COUNT(*) as count FROM memories GROUP BY type").all();
+		const stats = Object.fromEntries(MEMORY_TYPES.map((t) => [t, 0]));
+		for (const row of typeCounts) if (stats[row.type] !== void 0) stats[row.type] = row.count;
+		return {
+			stats,
+			pinnedGlobal,
+			pinnedProject
+		};
+	}
+};
+//#endregion
+exports.DatabaseError = DatabaseError;
+exports.DatabaseManager = DatabaseManager;
+exports.EmbeddingService = EmbeddingService;
+exports.MembankError = MembankError;
+exports.MemoryRepository = MemoryRepository;
+exports.QueryEngine = QueryEngine;
+exports.SessionContextBuilder = SessionContextBuilder;
+exports.listMemoryTypes = listMemoryTypes;
+exports.resolveScope = resolveScope;

package/dist/index.d.cts

@@ -0,0 +1,115 @@
+import BetterSqlite3 from "better-sqlite3";
+
+//#region src/db/errors.d.ts
+declare class MembankError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare class DatabaseError extends MembankError {
+  constructor(message: string, options?: ErrorOptions);
+}
+//#endregion
+//#region src/db/manager.d.ts
+type VecLoader = (db: BetterSqlite3.Database) => void;
+declare class DatabaseManager {
+  #private;
+  private constructor();
+  static open(dbPath?: string): DatabaseManager;
+  static openInMemory(): DatabaseManager;
+  /** For testing: inject a custom vec loader (e.g. a throwing stub). */
+  static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
+  get db(): BetterSqlite3.Database;
+  close(): void;
+}
+//#endregion
+//#region src/embedding/service.d.ts
+type ProgressCallback = (progress: {
+  status: string;
+  progress?: number;
+}) => void;
+declare class EmbeddingService {
+  private readonly modelCachePath;
+  private readonly onProgress;
+  private pipelineInstance;
+  constructor(modelCachePath?: string, onProgress?: ProgressCallback);
+  private getPipeline;
+  embed(text: string): Promise<Float32Array>;
+}
+//#endregion
+//#region src/types.d.ts
+type MemoryType = "correction" | "preference" | "decision" | "learning" | "fact";
+interface Memory {
+  id: string;
+  content: string;
+  type: MemoryType;
+  tags: string[];
+  scope: string;
+  sourceHarness: string | null;
+  accessCount: number;
+  pinned: boolean;
+  needsReview: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+interface QueryOptions {
+  query: string;
+  type?: MemoryType;
+  scope?: string;
+  limit?: number;
+}
+interface SaveOptions {
+  content: string;
+  type: MemoryType;
+  tags?: string[];
+  scope?: string;
+  sourceHarness?: string;
+}
+interface SessionContext {
+  stats: Record<MemoryType, number>;
+  pinnedGlobal: Memory[];
+  pinnedProject: Memory[];
+}
+//#endregion
+//#region src/memory/repository.d.ts
+declare class MemoryRepository {
+  #private;
+  constructor(db: DatabaseManager, embeddingService: EmbeddingService);
+  save(options: SaveOptions): Promise<Memory>;
+  update(id: string, patch: {
+    content?: string;
+    tags?: string[];
+  }): Promise<Memory>;
+  delete(id: string): Promise<void>;
+  list(opts?: {
+    type?: MemoryType;
+    pinned?: boolean;
+  }): Memory[];
+  stats(): {
+    byType: Record<MemoryType, number>;
+    total: number;
+    needsReview: number;
+  };
+  incrementAccessCount(id: string): void;
+}
+//#endregion
+//#region src/query/engine.d.ts
+declare class QueryEngine {
+  #private;
+  constructor(db: DatabaseManager, embeddingService: EmbeddingService, repo: MemoryRepository);
+  query(options: QueryOptions): Promise<Array<Memory & {
+    score: number;
+  }>>;
+}
+//#endregion
+//#region src/scope/resolver.d.ts
+declare function resolveScope(): Promise<string>;
+//#endregion
+//#region src/session/builder.d.ts
+declare function listMemoryTypes(): MemoryType[];
+declare class SessionContextBuilder {
+  #private;
+  constructor(db: DatabaseManager);
+  getSessionContext(projectScope: string): SessionContext;
+}
+//#endregion
+export { DatabaseError, DatabaseManager, EmbeddingService, MembankError, Memory, MemoryRepository, MemoryType, ProgressCallback, QueryEngine, QueryOptions, SaveOptions, SessionContext, SessionContextBuilder, listMemoryTypes, resolveScope };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/db/errors.ts","../src/db/manager.ts","../src/embedding/service.ts","../src/types.ts","../src/memory/repository.ts","../src/query/engine.ts","../src/scope/resolver.ts","../src/session/builder.ts"],"mappings":";;;cAAa,YAAA,SAAqB,KAAA;cACpB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;AAAA,cAM5B,aAAA,SAAsB,YAAA;cACrB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;;KCCpC,SAAA,IAAa,EAAA,EAAI,aAAA,CAAc,QAAA;AAAA,cA4BvB,eAAA;EAAA;UAGJ,WAAA,CAAA;EAAA,OAIA,IAAA,CAAK,MAAA,YAAkB,eAAA;EAAA,OAOvB,YAAA,CAAA,GAAgB,eAAA;EDnDS;EAAA,OCwDzB,uBAAA,CAAwB,MAAA,EAAQ,SAAA,GAAY,eAAA;EAAA,IAkD/C,EAAA,CAAA,GAAM,aAAA,CAAc,QAAA;EAIxB,KAAA,CAAA;AAAA;;;KC1GU,gBAAA,IAAoB,QAAA;EAAY,MAAA;EAAgB,QAAA;AAAA;AAAA,cAE/C,gBAAA;EAAA,iBACM,cAAA;EAAA,iBACA,UAAA;EAAA,QACT,gBAAA;cAEI,cAAA,WAAyB,UAAA,GAAa,gBAAA;EAAA,QAKpC,WAAA;EAUR,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,YAAA;AAAA;;;KC1BzB,UAAA;AAAA,UAEK,MAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA,EAAM,UAAA;EACN,IAAA;EACA,KAAA;EACA,aAAA;EACA,WAAA;EACA,MAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA;AAAA;AAAA,UAGe,YAAA;EACf,KAAA;EACA,IAAA,GAAO,UAAA;EACP,KAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,IAAA,EAAM,UAAA;EACN,IAAA;EACA,KAAA;EACA,aAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA,EAAO,MAAA,CAAO,UAAA;EACd,YAAA,EAAc,MAAA;EACd,aAAA,EAAe,MAAA;AAAA;;;cCVJ,gBAAA;EAAA;cAIC,EAAA,EAAI,eAAA,EAAiB,gBAAA,EAAkB,gBAAA;EAK7C,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,MAAA;EAgEpC,MAAA,CAAO,EAAA,UAAY,KAAA;IAAS,OAAA;IAAkB,IAAA;EAAA,IAAoB,OAAA,CAAQ,MAAA;EA2ChF,MAAA,CAAO,EAAA,WAAa,OAAA;EAcpB,IAAA,CAAK,IAAA;IAAS,IAAA,GAAO,UAAA;IAAY,MAAA;EAAA,IAAqB,MAAA;EAqBtD,KAAA,CAAA;IAAW,MAAA,EAAQ,MAAA,CAAO,UAAA;IAAqB,KAAA;IAAe,WAAA;EAAA;EA2B9D,oBAAA,CAAqB,EAAA;AAAA;;;cC9KV,WAAA;EAAA;cAKC,EAAA,EAAI,eAAA,EAAiB,gBAAA,EAAkB,gBAAA,EAAkB,IAAA,EAAM,gBAAA;EAMrE,KAAA,CAAM,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,KAAA,CAAM,MAAA;IAAW,KAAA;EAAA;AAAA;;;iBC7BzC,YAAA,CAAA,GAAgB,OAAA;;;iBC8BtB,eAAA,CAAA,GAAmB,UAAA;AAAA,cAItB,qBAAA;EAAA;cAGC,EAAA,EAAI,eAAA;EAIhB,iBAAA,CAAkB,YAAA,WAAuB,cAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,115 @@
+import BetterSqlite3 from "better-sqlite3";
+
+//#region src/db/errors.d.ts
+declare class MembankError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare class DatabaseError extends MembankError {
+  constructor(message: string, options?: ErrorOptions);
+}
+//#endregion
+//#region src/db/manager.d.ts
+type VecLoader = (db: BetterSqlite3.Database) => void;
+declare class DatabaseManager {
+  #private;
+  private constructor();
+  static open(dbPath?: string): DatabaseManager;
+  static openInMemory(): DatabaseManager;
+  /** For testing: inject a custom vec loader (e.g. a throwing stub). */
+  static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
+  get db(): BetterSqlite3.Database;
+  close(): void;
+}
+//#endregion
+//#region src/embedding/service.d.ts
+type ProgressCallback = (progress: {
+  status: string;
+  progress?: number;
+}) => void;
+declare class EmbeddingService {
+  private readonly modelCachePath;
+  private readonly onProgress;
+  private pipelineInstance;
+  constructor(modelCachePath?: string, onProgress?: ProgressCallback);
+  private getPipeline;
+  embed(text: string): Promise<Float32Array>;
+}
+//#endregion
+//#region src/types.d.ts
+type MemoryType = "correction" | "preference" | "decision" | "learning" | "fact";
+interface Memory {
+  id: string;
+  content: string;
+  type: MemoryType;
+  tags: string[];
+  scope: string;
+  sourceHarness: string | null;
+  accessCount: number;
+  pinned: boolean;
+  needsReview: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+interface QueryOptions {
+  query: string;
+  type?: MemoryType;
+  scope?: string;
+  limit?: number;
+}
+interface SaveOptions {
+  content: string;
+  type: MemoryType;
+  tags?: string[];
+  scope?: string;
+  sourceHarness?: string;
+}
+interface SessionContext {
+  stats: Record<MemoryType, number>;
+  pinnedGlobal: Memory[];
+  pinnedProject: Memory[];
+}
+//#endregion
+//#region src/memory/repository.d.ts
+declare class MemoryRepository {
+  #private;
+  constructor(db: DatabaseManager, embeddingService: EmbeddingService);
+  save(options: SaveOptions): Promise<Memory>;
+  update(id: string, patch: {
+    content?: string;
+    tags?: string[];
+  }): Promise<Memory>;
+  delete(id: string): Promise<void>;
+  list(opts?: {
+    type?: MemoryType;
+    pinned?: boolean;
+  }): Memory[];
+  stats(): {
+    byType: Record<MemoryType, number>;
+    total: number;
+    needsReview: number;
+  };
+  incrementAccessCount(id: string): void;
+}
+//#endregion
+//#region src/query/engine.d.ts
+declare class QueryEngine {
+  #private;
+  constructor(db: DatabaseManager, embeddingService: EmbeddingService, repo: MemoryRepository);
+  query(options: QueryOptions): Promise<Array<Memory & {
+    score: number;
+  }>>;
+}
+//#endregion
+//#region src/scope/resolver.d.ts
+declare function resolveScope(): Promise<string>;
+//#endregion
+//#region src/session/builder.d.ts
+declare function listMemoryTypes(): MemoryType[];
+declare class SessionContextBuilder {
+  #private;
+  constructor(db: DatabaseManager);
+  getSessionContext(projectScope: string): SessionContext;
+}
+//#endregion
+export { DatabaseError, DatabaseManager, EmbeddingService, MembankError, Memory, MemoryRepository, MemoryType, ProgressCallback, QueryEngine, QueryOptions, SaveOptions, SessionContext, SessionContextBuilder, listMemoryTypes, resolveScope };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/db/errors.ts","../src/db/manager.ts","../src/embedding/service.ts","../src/types.ts","../src/memory/repository.ts","../src/query/engine.ts","../src/scope/resolver.ts","../src/session/builder.ts"],"mappings":";;;cAAa,YAAA,SAAqB,KAAA;cACpB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;AAAA,cAM5B,aAAA,SAAsB,YAAA;cACrB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;;KCCpC,SAAA,IAAa,EAAA,EAAI,aAAA,CAAc,QAAA;AAAA,cA4BvB,eAAA;EAAA;UAGJ,WAAA,CAAA;EAAA,OAIA,IAAA,CAAK,MAAA,YAAkB,eAAA;EAAA,OAOvB,YAAA,CAAA,GAAgB,eAAA;EDnDS;EAAA,OCwDzB,uBAAA,CAAwB,MAAA,EAAQ,SAAA,GAAY,eAAA;EAAA,IAkD/C,EAAA,CAAA,GAAM,aAAA,CAAc,QAAA;EAIxB,KAAA,CAAA;AAAA;;;KC1GU,gBAAA,IAAoB,QAAA;EAAY,MAAA;EAAgB,QAAA;AAAA;AAAA,cAE/C,gBAAA;EAAA,iBACM,cAAA;EAAA,iBACA,UAAA;EAAA,QACT,gBAAA;cAEI,cAAA,WAAyB,UAAA,GAAa,gBAAA;EAAA,QAKpC,WAAA;EAUR,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,YAAA;AAAA;;;KC1BzB,UAAA;AAAA,UAEK,MAAA;EACf,EAAA;EACA,OAAA;EACA,IAAA,EAAM,UAAA;EACN,IAAA;EACA,KAAA;EACA,aAAA;EACA,WAAA;EACA,MAAA;EACA,WAAA;EACA,SAAA;EACA,SAAA;AAAA;AAAA,UAGe,YAAA;EACf,KAAA;EACA,IAAA,GAAO,UAAA;EACP,KAAA;EACA,KAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,IAAA,EAAM,UAAA;EACN,IAAA;EACA,KAAA;EACA,aAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA,EAAO,MAAA,CAAO,UAAA;EACd,YAAA,EAAc,MAAA;EACd,aAAA,EAAe,MAAA;AAAA;;;cCVJ,gBAAA;EAAA;cAIC,EAAA,EAAI,eAAA,EAAiB,gBAAA,EAAkB,gBAAA;EAK7C,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,MAAA;EAgEpC,MAAA,CAAO,EAAA,UAAY,KAAA;IAAS,OAAA;IAAkB,IAAA;EAAA,IAAoB,OAAA,CAAQ,MAAA;EA2ChF,MAAA,CAAO,EAAA,WAAa,OAAA;EAcpB,IAAA,CAAK,IAAA;IAAS,IAAA,GAAO,UAAA;IAAY,MAAA;EAAA,IAAqB,MAAA;EAqBtD,KAAA,CAAA;IAAW,MAAA,EAAQ,MAAA,CAAO,UAAA;IAAqB,KAAA;IAAe,WAAA;EAAA;EA2B9D,oBAAA,CAAqB,EAAA;AAAA;;;cC9KV,WAAA;EAAA;cAKC,EAAA,EAAI,eAAA,EAAiB,gBAAA,EAAkB,gBAAA,EAAkB,IAAA,EAAM,gBAAA;EAMrE,KAAA,CAAM,OAAA,EAAS,YAAA,GAAe,OAAA,CAAQ,KAAA,CAAM,MAAA;IAAW,KAAA;EAAA;AAAA;;;iBC7BzC,YAAA,CAAA,GAAgB,OAAA;;;iBC8BtB,eAAA,CAAA,GAAmB,UAAA;AAAA,cAItB,qBAAA;EAAA;cAGC,EAAA,EAAI,eAAA;EAIhB,iBAAA,CAAkB,YAAA,WAAuB,cAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,377 @@
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import BetterSqlite3 from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { pipeline } from "@huggingface/transformers";
+import { createHash, randomUUID } from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+//#region src/db/errors.ts
+var MembankError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "MembankError";
+	}
+};
+var DatabaseError = class extends MembankError {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "DatabaseError";
+	}
+};
+//#endregion
+//#region src/db/manager.ts
+const DEFAULT_DB_PATH = join(homedir(), ".membank", "memory.db");
+const MIGRATIONS = [[1, `
+CREATE TABLE IF NOT EXISTS memories (
+  id           TEXT PRIMARY KEY,
+  content      TEXT NOT NULL,
+  type         TEXT NOT NULL,
+  tags         TEXT NOT NULL DEFAULT '[]',
+  scope        TEXT NOT NULL,
+  source       TEXT,
+  access_count INTEGER NOT NULL DEFAULT 0,
+  pinned       INTEGER NOT NULL DEFAULT 0,
+  needs_review INTEGER NOT NULL DEFAULT 0,
+  created_at   TEXT NOT NULL,
+  updated_at   TEXT NOT NULL
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(
+  embedding FLOAT[384]
+);
+`]];
+var DatabaseManager = class DatabaseManager {
+	#db;
+	constructor(db) {
+		this.#db = db;
+	}
+	static open(dbPath) {
+		const resolvedPath = dbPath ?? DEFAULT_DB_PATH;
+		mkdirSync(dirname(resolvedPath), { recursive: true });
+		const db = new BetterSqlite3(resolvedPath);
+		return DatabaseManager.#init(db, sqliteVec.load);
+	}
+	static openInMemory() {
+		return DatabaseManager.#initInMemory(sqliteVec.load);
+	}
+	/** For testing: inject a custom vec loader (e.g. a throwing stub). */
+	static _openInMemoryWithLoader(loader) {
+		return DatabaseManager.#initInMemory(loader);
+	}
+	static #initInMemory(loader) {
+		const db = new BetterSqlite3(":memory:");
+		return DatabaseManager.#init(db, loader);
+	}
+	static #init(db, loader) {
+		try {
+			loader(db);
+		} catch (err) {
+			throw new DatabaseError("Failed to load sqlite-vec extension", { cause: err });
+		}
+		db.pragma("journal_mode = WAL");
+		const manager = new DatabaseManager(db);
+		manager.#runMigrations();
+		return manager;
+	}
+	#runMigrations() {
+		this.#db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key   TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+		const row = this.#db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
+		const currentVersion = row ? Number.parseInt(row.value, 10) : 0;
+		for (const [targetVersion, sql] of MIGRATIONS) if (currentVersion < targetVersion) {
+			this.#db.exec(sql);
+			this.#db.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)").run(String(targetVersion));
+		}
+	}
+	get db() {
+		return this.#db;
+	}
+	close() {
+		this.#db.close();
+	}
+};
+//#endregion
+//#region src/embedding/service.ts
+var EmbeddingService = class {
+	modelCachePath;
+	onProgress;
+	pipelineInstance = null;
+	constructor(modelCachePath, onProgress) {
+		this.modelCachePath = modelCachePath ?? join(homedir(), ".membank", "models");
+		this.onProgress = onProgress;
+	}
+	async getPipeline() {
+		if (this.pipelineInstance === null) this.pipelineInstance = await pipeline("feature-extraction", "Xenova/bge-small-en-v1.5", {
+			cache_dir: this.modelCachePath,
+			progress_callback: this.onProgress
+		});
+		return this.pipelineInstance;
+	}
+	async embed(text) {
+		const flat = (await (await this.getPipeline())(text, {
+			pooling: "mean",
+			normalize: true
+		})).data;
+		return flat instanceof Float32Array ? flat : new Float32Array(flat);
+	}
+};
+//#endregion
+//#region src/memory/repository.ts
+var MemoryRepository = class {
+	#db;
+	#embedding;
+	constructor(db, embeddingService) {
+		this.#db = db;
+		this.#embedding = embeddingService;
+	}
+	async save(options) {
+		const { content, type, tags = [], scope = "global", sourceHarness } = options;
+		const embedding = await this.#embedding.embed(content);
+		const embeddingBlob = Buffer.from(embedding.buffer);
+		const top = this.#db.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
+         FROM memories m JOIN embeddings e ON e.rowid = m.rowid
+         WHERE m.type = ? AND m.scope = ?
+         ORDER BY similarity DESC LIMIT 1`).get(embeddingBlob, type, scope);
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		if (top !== void 0 && top.similarity > .92) {
+			this.#db.db.prepare(`UPDATE memories SET content = ?, updated_at = ? WHERE id = ?`).run(content, now, top.id);
+			this.#db.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(embeddingBlob, top.rowid);
+			const updated = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(top.id);
+			return this.#rowToMemory(updated);
+		}
+		if (top !== void 0 && top.similarity >= .75) this.#db.db.prepare(`UPDATE memories SET needs_review = 1 WHERE id = ?`).run(top.id);
+		const id = randomUUID();
+		this.#db.db.prepare(`INSERT INTO memories (id, content, type, tags, scope, source, access_count, pinned, needs_review, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, 0, 0, 0, ?, ?)`).run(id, content, type, JSON.stringify(tags), scope, sourceHarness ?? null, now, now);
+		this.#db.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(embeddingBlob, id);
+		const row = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id);
+		return this.#rowToMemory(row);
+	}
+	async update(id, patch) {
+		const existing = this.#db.db.prepare(`SELECT m.rowid, m.* FROM memories m WHERE m.id = ?`).get(id);
+		if (existing === void 0) throw new Error(`Memory not found: ${id}`);
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const sets = ["updated_at = ?"];
+		const values = [now];
+		if (patch.content !== void 0) {
+			sets.push("content = ?");
+			values.push(patch.content);
+		}
+		if (patch.tags !== void 0) {
+			sets.push("tags = ?");
+			values.push(JSON.stringify(patch.tags));
+		}
+		values.push(id);
+		this.#db.db.prepare(`UPDATE memories SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+		if (patch.content !== void 0) {
+			const embedding = await this.#embedding.embed(patch.content);
+			const embeddingBlob = Buffer.from(embedding.buffer);
+			this.#db.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(embeddingBlob, existing.rowid);
+		}
+		const updated = this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id);
+		return this.#rowToMemory(updated);
+	}
+	delete(id) {
+		const row = this.#db.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(id);
+		if (row !== void 0) this.#db.db.prepare(`DELETE FROM embeddings WHERE rowid = ?`).run(row.rowid);
+		this.#db.db.prepare(`DELETE FROM memories WHERE id = ?`).run(id);
+		return Promise.resolve();
+	}
+	list(opts) {
+		const conditions = [];
+		const params = [];
+		if (opts?.type !== void 0) {
+			conditions.push("type = ?");
+			params.push(opts.type);
+		}
+		if (opts?.pinned === true) conditions.push("pinned = 1");
+		const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+		return this.#db.db.prepare(`SELECT * FROM memories ${where} ORDER BY created_at DESC`).all(...params).map((r) => this.#rowToMemory(r));
+	}
+	stats() {
+		const byType = Object.fromEntries([
+			"correction",
+			"preference",
+			"decision",
+			"learning",
+			"fact"
+		].map((t) => [t, 0]));
+		const typeRows = this.#db.db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`).all();
+		for (const row of typeRows) if (row.type in byType) byType[row.type] = row.count;
+		const totals = this.#db.db.prepare(`SELECT COUNT(*) as total, SUM(needs_review) as needsReview FROM memories`).get() ?? {
+			total: 0,
+			needsReview: 0
+		};
+		return {
+			byType,
+			total: totals.total,
+			needsReview: totals.needsReview ?? 0
+		};
+	}
+	incrementAccessCount(id) {
+		this.#db.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(id);
+	}
+	#rowToMemory(row) {
+		return {
+			id: row.id,
+			content: row.content,
+			type: row.type,
+			tags: JSON.parse(row.tags),
+			scope: row.scope,
+			sourceHarness: row.source,
+			accessCount: row.access_count,
+			pinned: row.pinned !== 0,
+			needsReview: row.needs_review !== 0,
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		};
+	}
+};
+//#endregion
+//#region src/query/engine.ts
+const TYPE_WEIGHTS = {
+	correction: 1,
+	preference: .8,
+	decision: .6,
+	learning: .4,
+	fact: .2
+};
+var QueryEngine = class {
+	#db;
+	#embedding;
+	#repo;
+	constructor(db, embeddingService, repo) {
+		this.#db = db;
+		this.#embedding = embeddingService;
+		this.#repo = repo;
+	}
+	async query(options) {
+		const { query, type, scope, limit = 10 } = options;
+		const queryEmbedding = await this.#embedding.embed(query);
+		const queryBlob = Buffer.from(queryEmbedding.buffer);
+		const whereClauses = [];
+		const params = [queryBlob];
+		if (type !== void 0) {
+			whereClauses.push("m.type = ?");
+			params.push(type);
+		}
+		if (scope !== void 0) {
+			whereClauses.push("m.scope = ?");
+			params.push(scope);
+		}
+		const sql = `
+      SELECT m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS cosine_sim
+      FROM memories m JOIN embeddings e ON e.rowid = m.rowid
+      ${whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : ""}
+    `;
+		const rows = this.#db.db.prepare(sql).all(...params);
+		const now = Date.now();
+		const scored = rows.filter((row) => row.cosine_sim > 0).map((row) => {
+			const memory = this.#rowToMemory(row);
+			const score = this.#computeScore(memory, now);
+			return {
+				...memory,
+				score
+			};
+		});
+		scored.sort((a, b) => b.score - a.score);
+		const results = scored.slice(0, limit);
+		for (const result of results) this.#repo.incrementAccessCount(result.id);
+		return results;
+	}
+	#computeScore(memory, now) {
+		const typeWeight = TYPE_WEIGHTS[memory.type];
+		const accessCountNorm = memory.accessCount / (memory.accessCount + 10);
+		const recencyNorm = 1 / (1 + (now - new Date(memory.updatedAt).getTime()) / 864e5);
+		const pinned = memory.pinned ? 1 : 0;
+		return typeWeight * .4 + accessCountNorm * .3 + recencyNorm * .2 + pinned * .1;
+	}
+	#rowToMemory(row) {
+		return {
+			id: row.id,
+			content: row.content,
+			type: row.type,
+			tags: JSON.parse(row.tags),
+			scope: row.scope,
+			sourceHarness: row.source,
+			accessCount: row.access_count,
+			pinned: row.pinned !== 0,
+			needsReview: row.needs_review !== 0,
+			createdAt: row.created_at,
+			updatedAt: row.updated_at
+		};
+	}
+};
+//#endregion
+//#region src/scope/resolver.ts
+const execFileAsync = promisify(execFile);
+function sha256Truncated(input) {
+	return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+async function resolveScope() {
+	try {
+		const { stdout } = await execFileAsync("git", [
+			"remote",
+			"get-url",
+			"origin"
+		]);
+		const url = stdout.trim();
+		if (url) return sha256Truncated(url);
+	} catch {}
+	return sha256Truncated(process.cwd());
+}
+//#endregion
+//#region src/session/builder.ts
+const MEMORY_TYPES = [
+	"correction",
+	"preference",
+	"decision",
+	"learning",
+	"fact"
+];
+function rowToMemory(row) {
+	return {
+		id: row.id,
+		content: row.content,
+		type: row.type,
+		tags: JSON.parse(row.tags),
+		scope: row.scope,
+		sourceHarness: row.source,
+		accessCount: row.access_count,
+		pinned: row.pinned !== 0,
+		needsReview: row.needs_review !== 0,
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	};
+}
+function listMemoryTypes() {
+	return [...MEMORY_TYPES];
+}
+var SessionContextBuilder = class {
+	#db;
+	constructor(db) {
+		this.#db = db;
+	}
+	getSessionContext(projectScope) {
+		const pinnedGlobal = this.#db.db.prepare("SELECT * FROM memories WHERE scope = 'global' AND pinned = 1").all().map(rowToMemory);
+		const pinnedProject = this.#db.db.prepare("SELECT * FROM memories WHERE scope = ? AND pinned = 1").all(projectScope).map(rowToMemory);
+		const typeCounts = this.#db.db.prepare("SELECT type, COUNT(*) as count FROM memories GROUP BY type").all();
+		const stats = Object.fromEntries(MEMORY_TYPES.map((t) => [t, 0]));
+		for (const row of typeCounts) if (stats[row.type] !== void 0) stats[row.type] = row.count;
+		return {
+			stats,
+			pinnedGlobal,
+			pinnedProject
+		};
+	}
+};
+//#endregion
+export { DatabaseError, DatabaseManager, EmbeddingService, MembankError, MemoryRepository, QueryEngine, SessionContextBuilder, listMemoryTypes, resolveScope };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["#db","#init","#initInMemory","#runMigrations","#db","#embedding","#rowToMemory","#db","#embedding","#repo","#rowToMemory","#computeScore","#db"],"sources":["../src/db/errors.ts","../src/db/manager.ts","../src/embedding/service.ts","../src/memory/repository.ts","../src/query/engine.ts","../src/scope/resolver.ts","../src/session/builder.ts"],"sourcesContent":["export class MembankError extends Error {\r\n  constructor(message: string, options?: ErrorOptions) {\r\n    super(message, options);\r\n    this.name = \"MembankError\";\r\n  }\r\n}\r\n\r\nexport class DatabaseError extends MembankError {\r\n  constructor(message: string, options?: ErrorOptions) {\r\n    super(message, options);\r\n    this.name = \"DatabaseError\";\r\n  }\r\n}\r\n","import { mkdirSync } from \"node:fs\";\r\nimport { homedir } from \"node:os\";\r\nimport { dirname, join } from \"node:path\";\r\nimport BetterSqlite3 from \"better-sqlite3\";\r\nimport * as sqliteVec from \"sqlite-vec\";\r\nimport { DatabaseError } from \"./errors.js\";\r\n\r\nconst DEFAULT_DB_PATH = join(homedir(), \".membank\", \"memory.db\");\r\n\r\ntype VecLoader = (db: BetterSqlite3.Database) => void;\r\n\r\n// Each entry is [targetVersion, sql]. Migrations are applied in ascending order.\r\nconst MIGRATIONS: [number, string][] = [\r\n  [\r\n    1,\r\n    `\r\nCREATE TABLE IF NOT EXISTS memories (\r\n  id           TEXT PRIMARY KEY,\r\n  content      TEXT NOT NULL,\r\n  type         TEXT NOT NULL,\r\n  tags         TEXT NOT NULL DEFAULT '[]',\r\n  scope        TEXT NOT NULL,\r\n  source       TEXT,\r\n  access_count INTEGER NOT NULL DEFAULT 0,\r\n  pinned       INTEGER NOT NULL DEFAULT 0,\r\n  needs_review INTEGER NOT NULL DEFAULT 0,\r\n  created_at   TEXT NOT NULL,\r\n  updated_at   TEXT NOT NULL\r\n);\r\n\r\nCREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(\r\n  embedding FLOAT[384]\r\n);\r\n`,\r\n  ],\r\n];\r\n\r\nexport class DatabaseManager {\r\n  readonly #db: BetterSqlite3.Database;\r\n\r\n  private constructor(db: BetterSqlite3.Database) {\r\n    this.#db = db;\r\n  }\r\n\r\n  static open(dbPath?: string): DatabaseManager {\r\n    const resolvedPath = dbPath ?? DEFAULT_DB_PATH;\r\n    mkdirSync(dirname(resolvedPath), { recursive: true });\r\n    const db = new BetterSqlite3(resolvedPath);\r\n    return DatabaseManager.#init(db, sqliteVec.load);\r\n  }\r\n\r\n  static openInMemory(): DatabaseManager {\r\n    return DatabaseManager.#initInMemory(sqliteVec.load);\r\n  }\r\n\r\n  /** For testing: inject a custom vec loader (e.g. a throwing stub). */\r\n  static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager {\r\n    return DatabaseManager.#initInMemory(loader);\r\n  }\r\n\r\n  static #initInMemory(loader: VecLoader): DatabaseManager {\r\n    const db = new BetterSqlite3(\":memory:\");\r\n    return DatabaseManager.#init(db, loader);\r\n  }\r\n\r\n  static #init(db: BetterSqlite3.Database, loader: VecLoader): DatabaseManager {\r\n    try {\r\n      loader(db);\r\n    } catch (err) {\r\n      throw new DatabaseError(\"Failed to load sqlite-vec extension\", {\r\n        cause: err,\r\n      });\r\n    }\r\n\r\n    db.pragma(\"journal_mode = WAL\");\r\n\r\n    const manager = new DatabaseManager(db);\r\n    manager.#runMigrations();\r\n    return manager;\r\n  }\r\n\r\n  #runMigrations(): void {\r\n    // Bootstrap the meta table before reading schema_version from it\r\n    this.#db.exec(`\r\n      CREATE TABLE IF NOT EXISTS meta (\r\n        key   TEXT PRIMARY KEY,\r\n        value TEXT NOT NULL\r\n      );\r\n    `);\r\n\r\n    const row = this.#db\r\n      .prepare<[], { value: string }>(\"SELECT value FROM meta WHERE key = 'schema_version'\")\r\n      .get();\r\n\r\n    const currentVersion = row ? Number.parseInt(row.value, 10) : 0;\r\n\r\n    for (const [targetVersion, sql] of MIGRATIONS) {\r\n      if (currentVersion < targetVersion) {\r\n        this.#db.exec(sql);\r\n        this.#db\r\n          .prepare(\"INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)\")\r\n          .run(String(targetVersion));\r\n      }\r\n    }\r\n  }\r\n\r\n  get db(): BetterSqlite3.Database {\r\n    return this.#db;\r\n  }\r\n\r\n  close(): void {\r\n    this.#db.close();\r\n  }\r\n}\r\n","import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { pipeline } from \"@huggingface/transformers\";\n\nexport type ProgressCallback = (progress: { status: string; progress?: number }) => void;\n\nexport class EmbeddingService {\n  private readonly modelCachePath: string;\n  private readonly onProgress: ProgressCallback | undefined;\n  private pipelineInstance: Awaited<ReturnType<typeof pipeline>> | null = null;\n\n  constructor(modelCachePath?: string, onProgress?: ProgressCallback) {\n    this.modelCachePath = modelCachePath ?? join(homedir(), \".membank\", \"models\");\n    this.onProgress = onProgress;\n  }\n\n  private async getPipeline(): Promise<Awaited<ReturnType<typeof pipeline>>> {\n    if (this.pipelineInstance === null) {\n      this.pipelineInstance = await pipeline(\"feature-extraction\", \"Xenova/bge-small-en-v1.5\", {\n        cache_dir: this.modelCachePath,\n        progress_callback: this.onProgress,\n      });\n    }\n    return this.pipelineInstance;\n  }\n\n  async embed(text: string): Promise<Float32Array> {\n    const pipe = await this.getPipeline();\n    // Shape: [1, seq_len, 384]. Cast to any to bypass the non-unified pipeline union signature.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const output = await (\n      pipe as (input: string, opts: Record<string, unknown>) => Promise<unknown>\n    )(text, { pooling: \"mean\", normalize: true });\n\n    // @huggingface/transformers Tensor has a .data property with the flat array\n    const tensor = output as { data: Float32Array | number[] };\n    const flat = tensor.data;\n\n    return flat instanceof Float32Array ? flat : new Float32Array(flat);\n  }\n}\n","import { randomUUID } from \"node:crypto\";\r\nimport type { DatabaseManager } from \"../db/manager.js\";\r\nimport type { EmbeddingService } from \"../embedding/service.js\";\r\nimport type { Memory, MemoryType, SaveOptions } from \"../types.js\";\r\n\r\ninterface MemoryRow {\r\n  id: string;\r\n  content: string;\r\n  type: string;\r\n  tags: string;\r\n  scope: string;\r\n  source: string | null;\r\n  access_count: number;\r\n  pinned: number;\r\n  needs_review: number;\r\n  created_at: string;\r\n  updated_at: string;\r\n}\r\n\r\ninterface SimilarityRow extends MemoryRow {\r\n  rowid: number;\r\n  similarity: number;\r\n}\r\n\r\nexport class MemoryRepository {\r\n  readonly #db: DatabaseManager;\r\n  readonly #embedding: EmbeddingService;\r\n\r\n  constructor(db: DatabaseManager, embeddingService: EmbeddingService) {\r\n    this.#db = db;\r\n    this.#embedding = embeddingService;\r\n  }\r\n\r\n  async save(options: SaveOptions): Promise<Memory> {\r\n    const { content, type, tags = [], scope = \"global\", sourceHarness } = options;\r\n\r\n    const embedding = await this.#embedding.embed(content);\r\n    const embeddingBlob = Buffer.from(embedding.buffer);\r\n\r\n    const top = this.#db.db\r\n      .prepare<[Buffer, string, string], SimilarityRow>(\r\n        `SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity\r\n         FROM memories m JOIN embeddings e ON e.rowid = m.rowid\r\n         WHERE m.type = ? AND m.scope = ?\r\n         ORDER BY similarity DESC LIMIT 1`\r\n      )\r\n      .get(embeddingBlob, type, scope);\r\n\r\n    const now = new Date().toISOString();\r\n\r\n    if (top !== undefined && top.similarity > 0.92) {\r\n      // Overwrite existing record\r\n      this.#db.db\r\n        .prepare(`UPDATE memories SET content = ?, updated_at = ? WHERE id = ?`)\r\n        .run(content, now, top.id);\r\n\r\n      this.#db.db\r\n        .prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`)\r\n        .run(embeddingBlob, top.rowid);\r\n\r\n      const updated = this.#db.db\r\n        .prepare<[string], MemoryRow>(`SELECT * FROM memories WHERE id = ?`)\r\n        .get(top.id);\r\n\r\n      // updated is guaranteed to exist since we just updated it\r\n      return this.#rowToMemory(updated as MemoryRow);\r\n    }\r\n\r\n    if (top !== undefined && top.similarity >= 0.75) {\r\n      // Flag existing as needs_review\r\n      this.#db.db.prepare(`UPDATE memories SET needs_review = 1 WHERE id = ?`).run(top.id);\r\n    }\r\n\r\n    // Insert new record\r\n    const id = randomUUID();\r\n    this.#db.db\r\n      .prepare(\r\n        `INSERT INTO memories (id, content, type, tags, scope, source, access_count, pinned, needs_review, created_at, updated_at)\r\n         VALUES (?, ?, ?, ?, ?, ?, 0, 0, 0, ?, ?)`\r\n      )\r\n      .run(id, content, type, JSON.stringify(tags), scope, sourceHarness ?? null, now, now);\r\n\r\n    // sqlite-vec v0.1.9 does not accept parameterized rowid on INSERT into vec0 tables.\r\n    // Use a SELECT subquery to copy the rowid from the memories row we just inserted.\r\n    this.#db.db\r\n      .prepare(\r\n        `INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`\r\n      )\r\n      .run(embeddingBlob, id);\r\n\r\n    const row = this.#db.db\r\n      .prepare<[string], MemoryRow>(`SELECT * FROM memories WHERE id = ?`)\r\n      .get(id) as MemoryRow;\r\n\r\n    return this.#rowToMemory(row);\r\n  }\r\n\r\n  async update(id: string, patch: { content?: string; tags?: string[] }): Promise<Memory> {\r\n    const existing = this.#db.db\r\n      .prepare<[string], MemoryRow & { rowid: number }>(\r\n        `SELECT m.rowid, m.* FROM memories m WHERE m.id = ?`\r\n      )\r\n      .get(id);\r\n\r\n    if (existing === undefined) {\r\n      throw new Error(`Memory not found: ${id}`);\r\n    }\r\n\r\n    const now = new Date().toISOString();\r\n    const sets: string[] = [\"updated_at = ?\"];\r\n    const values: string[] = [now];\r\n\r\n    if (patch.content !== undefined) {\r\n      sets.push(\"content = ?\");\r\n      values.push(patch.content);\r\n    }\r\n\r\n    if (patch.tags !== undefined) {\r\n      sets.push(\"tags = ?\");\r\n      values.push(JSON.stringify(patch.tags));\r\n    }\r\n\r\n    values.push(id);\r\n    this.#db.db.prepare(`UPDATE memories SET ${sets.join(\", \")} WHERE id = ?`).run(...values);\r\n\r\n    if (patch.content !== undefined) {\r\n      const embedding = await this.#embedding.embed(patch.content);\r\n      const embeddingBlob = Buffer.from(embedding.buffer);\r\n      this.#db.db\r\n        .prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`)\r\n        .run(embeddingBlob, existing.rowid);\r\n    }\r\n\r\n    const updated = this.#db.db\r\n      .prepare<[string], MemoryRow>(`SELECT * FROM memories WHERE id = ?`)\r\n      .get(id) as MemoryRow;\r\n\r\n    return this.#rowToMemory(updated);\r\n  }\r\n\r\n  delete(id: string): Promise<void> {\r\n    const row = this.#db.db\r\n      .prepare<[string], { rowid: number }>(`SELECT rowid FROM memories WHERE id = ?`)\r\n      .get(id);\r\n\r\n    if (row !== undefined) {\r\n      this.#db.db.prepare(`DELETE FROM embeddings WHERE rowid = ?`).run(row.rowid);\r\n    }\r\n\r\n    this.#db.db.prepare(`DELETE FROM memories WHERE id = ?`).run(id);\r\n\r\n    return Promise.resolve();\r\n  }\r\n\r\n  list(opts?: { type?: MemoryType; pinned?: boolean }): Memory[] {\r\n    const conditions: string[] = [];\r\n    const params: (string | number)[] = [];\r\n\r\n    if (opts?.type !== undefined) {\r\n      conditions.push(\"type = ?\");\r\n      params.push(opts.type);\r\n    }\r\n\r\n    if (opts?.pinned === true) {\r\n      conditions.push(\"pinned = 1\");\r\n    }\r\n\r\n    const where = conditions.length > 0 ? `WHERE ${conditions.join(\" AND \")}` : \"\";\r\n    const rows = this.#db.db\r\n      .prepare<(string | number)[], MemoryRow>(`SELECT * FROM memories ${where} ORDER BY created_at DESC`)\r\n      .all(...params);\r\n\r\n    return rows.map((r) => this.#rowToMemory(r));\r\n  }\r\n\r\n  stats(): { byType: Record<MemoryType, number>; total: number; needsReview: number } {\r\n    const allTypes: MemoryType[] = [\"correction\", \"preference\", \"decision\", \"learning\", \"fact\"];\r\n    const byType = Object.fromEntries(allTypes.map((t) => [t, 0])) as Record<MemoryType, number>;\r\n\r\n    const typeRows = this.#db.db\r\n      .prepare<[], { type: string; count: number }>(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`)\r\n      .all();\r\n\r\n    for (const row of typeRows) {\r\n      if (row.type in byType) {\r\n        byType[row.type as MemoryType] = row.count;\r\n      }\r\n    }\r\n\r\n    const totals = this.#db.db\r\n      .prepare<[], { total: number; needsReview: number }>(\r\n        `SELECT COUNT(*) as total, SUM(needs_review) as needsReview FROM memories`\r\n      )\r\n      .get() ?? { total: 0, needsReview: 0 };\r\n\r\n    return {\r\n      byType,\r\n      total: totals.total,\r\n      needsReview: totals.needsReview ?? 0,\r\n    };\r\n  }\r\n\r\n  incrementAccessCount(id: string): void {\r\n    this.#db.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(id);\r\n  }\r\n\r\n  #rowToMemory(row: MemoryRow): Memory {\r\n    return {\r\n      id: row.id,\r\n      content: row.content,\r\n      type: row.type as MemoryType,\r\n      tags: JSON.parse(row.tags) as string[],\r\n      scope: row.scope,\r\n      sourceHarness: row.source,\r\n      accessCount: row.access_count,\r\n      pinned: row.pinned !== 0,\r\n      needsReview: row.needs_review !== 0,\r\n      createdAt: row.created_at,\r\n      updatedAt: row.updated_at,\r\n    };\r\n  }\r\n}\r\n","import type { DatabaseManager } from \"../db/manager.js\";\nimport type { EmbeddingService } from \"../embedding/service.js\";\nimport type { MemoryRepository } from \"../memory/repository.js\";\nimport type { Memory, MemoryType, QueryOptions } from \"../types.js\";\n\ninterface MemoryRow {\n  id: string;\n  content: string;\n  type: string;\n  tags: string;\n  scope: string;\n  source: string | null;\n  access_count: number;\n  pinned: number;\n  needs_review: number;\n  created_at: string;\n  updated_at: string;\n  cosine_sim: number;\n}\n\nconst TYPE_WEIGHTS: Record<MemoryType, number> = {\n  correction: 1.0,\n  preference: 0.8,\n  decision: 0.6,\n  learning: 0.4,\n  fact: 0.2,\n};\n\nexport class QueryEngine {\n  readonly #db: DatabaseManager;\n  readonly #embedding: EmbeddingService;\n  readonly #repo: MemoryRepository;\n\n  constructor(db: DatabaseManager, embeddingService: EmbeddingService, repo: MemoryRepository) {\n    this.#db = db;\n    this.#embedding = embeddingService;\n    this.#repo = repo;\n  }\n\n  async query(options: QueryOptions): Promise<Array<Memory & { score: number }>> {\n    const { query, type, scope, limit = 10 } = options;\n\n    const queryEmbedding = await this.#embedding.embed(query);\n    const queryBlob = Buffer.from(queryEmbedding.buffer);\n\n    const whereClauses: string[] = [];\n    const params: unknown[] = [queryBlob];\n\n    if (type !== undefined) {\n      whereClauses.push(\"m.type = ?\");\n      params.push(type);\n    }\n\n    if (scope !== undefined) {\n      whereClauses.push(\"m.scope = ?\");\n      params.push(scope);\n    }\n\n    const whereSQL = whereClauses.length > 0 ? `WHERE ${whereClauses.join(\" AND \")}` : \"\";\n\n    const sql = `\n      SELECT m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS cosine_sim\n      FROM memories m JOIN embeddings e ON e.rowid = m.rowid\n      ${whereSQL}\n    `;\n\n    const rows = this.#db.db.prepare<unknown[], MemoryRow>(sql).all(...params);\n\n    const now = Date.now();\n\n    const scored = rows\n      .filter((row) => row.cosine_sim > 0)\n      .map((row) => {\n        const memory = this.#rowToMemory(row);\n        const score = this.#computeScore(memory, now);\n        return { ...memory, score };\n      });\n\n    scored.sort((a, b) => b.score - a.score);\n\n    const results = scored.slice(0, limit);\n\n    for (const result of results) {\n      this.#repo.incrementAccessCount(result.id);\n    }\n\n    return results;\n  }\n\n  #computeScore(memory: Memory, now: number): number {\n    const typeWeight = TYPE_WEIGHTS[memory.type];\n    const accessCountNorm = memory.accessCount / (memory.accessCount + 10);\n    const daysSinceUpdate = (now - new Date(memory.updatedAt).getTime()) / 86400000;\n    const recencyNorm = 1 / (1 + daysSinceUpdate);\n    const pinned = memory.pinned ? 1.0 : 0.0;\n\n    return typeWeight * 0.4 + accessCountNorm * 0.3 + recencyNorm * 0.2 + pinned * 0.1;\n  }\n\n  #rowToMemory(row: MemoryRow): Memory {\n    return {\n      id: row.id,\n      content: row.content,\n      type: row.type as MemoryType,\n      tags: JSON.parse(row.tags) as string[],\n      scope: row.scope,\n      sourceHarness: row.source,\n      accessCount: row.access_count,\n      pinned: row.pinned !== 0,\n      needsReview: row.needs_review !== 0,\n      createdAt: row.created_at,\n      updatedAt: row.updated_at,\n    };\n  }\n}\n","import { execFile } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\nfunction sha256Truncated(input: string): string {\n  return createHash(\"sha256\").update(input).digest(\"hex\").slice(0, 16);\n}\n\nexport async function resolveScope(): Promise<string> {\n  try {\n    const { stdout } = await execFileAsync(\"git\", [\"remote\", \"get-url\", \"origin\"]);\n    const url = stdout.trim();\n    if (url) {\n      return sha256Truncated(url);\n    }\n  } catch {\n    // git not available, not a repo, or no remote — fall through to cwd fallback\n  }\n\n  return sha256Truncated(process.cwd());\n}\n","import type { DatabaseManager } from \"../db/manager.js\";\nimport type { Memory, MemoryType, SessionContext } from \"../types.js\";\n\ninterface MemoryRow {\n  id: string;\n  content: string;\n  type: string;\n  tags: string;\n  scope: string;\n  source: string | null;\n  access_count: number;\n  pinned: number;\n  needs_review: number;\n  created_at: string;\n  updated_at: string;\n}\n\ninterface TypeCountRow {\n  type: string;\n  count: number;\n}\n\nconst MEMORY_TYPES: MemoryType[] = [\"correction\", \"preference\", \"decision\", \"learning\", \"fact\"];\n\nfunction rowToMemory(row: MemoryRow): Memory {\n  return {\n    id: row.id,\n    content: row.content,\n    type: row.type as MemoryType,\n    tags: JSON.parse(row.tags) as string[],\n    scope: row.scope,\n    sourceHarness: row.source,\n    accessCount: row.access_count,\n    pinned: row.pinned !== 0,\n    needsReview: row.needs_review !== 0,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  };\n}\n\nexport function listMemoryTypes(): MemoryType[] {\n  return [...MEMORY_TYPES];\n}\n\nexport class SessionContextBuilder {\n  readonly #db: DatabaseManager;\n\n  constructor(db: DatabaseManager) {\n    this.#db = db;\n  }\n\n  getSessionContext(projectScope: string): SessionContext {\n    const pinnedGlobal = this.#db.db\n      .prepare<[], MemoryRow>(\"SELECT * FROM memories WHERE scope = 'global' AND pinned = 1\")\n      .all()\n      .map(rowToMemory);\n\n    const pinnedProject = this.#db.db\n      .prepare<[string], MemoryRow>(\"SELECT * FROM memories WHERE scope = ? AND pinned = 1\")\n      .all(projectScope)\n      .map(rowToMemory);\n\n    const typeCounts = this.#db.db\n      .prepare<[], TypeCountRow>(\"SELECT type, COUNT(*) as count FROM memories GROUP BY type\")\n      .all();\n\n    const stats = Object.fromEntries(MEMORY_TYPES.map((t) => [t, 0])) as Record<MemoryType, number>;\n    for (const row of typeCounts) {\n      if (stats[row.type as MemoryType] !== undefined) {\n        stats[row.type as MemoryType] = row.count;\n      }\n    }\n\n    return { stats, pinnedGlobal, pinnedProject };\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@membank/core",
+  "version": "0.0.0-dev-20260427133418",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "better-sqlite3": "^12.9.0",
+    "sqlite-vec": "^0.1.9"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check ./src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --reporter=verbose src/**/*.integration.test.ts",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}