@membank/core 0.7.0 → 0.9.0

package/dist/index.cjs

@@ -33,6 +33,20 @@ 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/config/loader.ts
+function loadConfig() {
+	const configPath = (0, node_path.join)((0, node_os.homedir)(), ".membank", "config.json");
+	try {
+		const raw = (0, node_fs.readFileSync)(configPath, "utf8");
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+function isSynthesisEnabled() {
+	return loadConfig()?.synthesis?.enabled === true;
+}
+//#endregion
 //#region src/db/errors.ts
 var MembankError = class extends Error {
 	constructor(message, options) {
@@ -49,7 +63,8 @@ var DatabaseError = class extends MembankError {
 //#endregion
 //#region src/db/manager.ts
 const DEFAULT_DB_PATH = (0, node_path.join)((0, node_os.homedir)(), ".membank", "memory.db");
-const MIGRATIONS$1 = [[1, `
+const MIGRATIONS$1 = [
+	[1, `
 CREATE TABLE IF NOT EXISTS memories (
   id           TEXT PRIMARY KEY,
   content      TEXT NOT NULL,
@@ -67,7 +82,8 @@ CREATE TABLE IF NOT EXISTS memories (
 CREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(
   embedding FLOAT[384]
 );
-`], [2, `
+`],
+	[2, `
 CREATE TABLE IF NOT EXISTS projects (
   id         TEXT PRIMARY KEY,
   name       TEXT NOT NULL,
@@ -100,7 +116,46 @@ JOIN projects p ON p.scope_hash = m.scope
 WHERE m.scope != 'global';
 
 ALTER TABLE memories DROP COLUMN scope;
-`]];
+`],
+	[3, `
+CREATE TABLE IF NOT EXISTS memory_review_events (
+  id                        TEXT PRIMARY KEY,
+  memory_id                 TEXT NOT NULL REFERENCES memories(id) ON DELETE CASCADE,
+  conflicting_memory_id     TEXT REFERENCES memories(id) ON DELETE SET NULL,
+  similarity                REAL NOT NULL,
+  conflict_content_snapshot TEXT NOT NULL,
+  reason                    TEXT NOT NULL,
+  created_at                TEXT NOT NULL,
+  resolved_at               TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_review_events_memory_open
+  ON memory_review_events(memory_id) WHERE resolved_at IS NULL;
+
+ALTER TABLE memories DROP COLUMN needs_review;
+`],
+	[4, `
+CREATE TABLE IF NOT EXISTS syntheses (
+  id                  TEXT PRIMARY KEY,
+  scope               TEXT NOT NULL,
+  content             TEXT NOT NULL,
+  source_memory_hash  TEXT NOT NULL,
+  synthesized_at      TEXT NOT NULL,
+  expires_at          TEXT NOT NULL,
+  in_flight_since     TEXT,
+  created_at          TEXT NOT NULL,
+  updated_at          TEXT NOT NULL,
+  UNIQUE(scope),
+  CHECK(expires_at > synthesized_at)
+);
+
+CREATE INDEX IF NOT EXISTS idx_syntheses_expires_at
+  ON syntheses(expires_at);
+
+CREATE INDEX IF NOT EXISTS idx_syntheses_scope_inflight
+  ON syntheses(scope) WHERE in_flight_since IS NOT NULL;
+`]
+];
 var DatabaseManager = class DatabaseManager {
 	#db;
 	constructor(db) {
@@ -174,6 +229,27 @@ const ProjectSchema = zod.z.object({
 	createdAt: zod.z.string(),
 	updatedAt: zod.z.string()
 });
+const ReviewReasonSchema = zod.z.enum(["similarity_dedup"]);
+const ReviewEventSchema = zod.z.object({
+	id: zod.z.string(),
+	memoryId: zod.z.string(),
+	conflictingMemoryId: zod.z.string().nullable(),
+	similarity: zod.z.number(),
+	conflictContentSnapshot: zod.z.string(),
+	reason: ReviewReasonSchema,
+	createdAt: zod.z.string(),
+	resolvedAt: zod.z.string().nullable()
+});
+const ReviewEventRowSchema = zod.z.object({
+	id: zod.z.string(),
+	memory_id: zod.z.string(),
+	conflicting_memory_id: zod.z.string().nullable(),
+	similarity: zod.z.number(),
+	conflict_content_snapshot: zod.z.string(),
+	reason: ReviewReasonSchema,
+	created_at: zod.z.string(),
+	resolved_at: zod.z.string().nullable()
+});
 const MemorySchema = zod.z.object({
 	id: zod.z.string(),
 	content: zod.z.string(),
@@ -183,7 +259,7 @@ const MemorySchema = zod.z.object({
 	sourceHarness: zod.z.string().nullable(),
 	accessCount: zod.z.number().int().nonnegative(),
 	pinned: zod.z.boolean(),
-	needsReview: zod.z.boolean(),
+	reviewEvents: zod.z.array(ReviewEventSchema),
 	createdAt: zod.z.string(),
 	updatedAt: zod.z.string()
 });
@@ -206,12 +282,25 @@ const SaveOptionsSchema = zod.z.object({
 });
 const MemoryPatchSchema = zod.z.object({
 	content: zod.z.string().min(1).optional(),
-	tags: zod.z.array(zod.z.string()).optional()
+	tags: zod.z.array(zod.z.string()).optional(),
+	type: MemoryTypeSchema.optional()
+});
+const SynthesisSchema = zod.z.object({
+	id: zod.z.string(),
+	scope: zod.z.string(),
+	content: zod.z.string(),
+	sourceMemoryHash: zod.z.string(),
+	synthesizedAt: zod.z.string(),
+	expiresAt: zod.z.string(),
+	inFlightSince: zod.z.string().nullable(),
+	createdAt: zod.z.string(),
+	updatedAt: zod.z.string()
 });
 const SessionContextSchema = zod.z.object({
 	stats: zod.z.record(MemoryTypeSchema, zod.z.number()),
 	pinnedGlobal: zod.z.array(MemorySchema),
-	pinnedProject: zod.z.array(MemorySchema)
+	pinnedProject: zod.z.array(MemorySchema),
+	synthesis: zod.z.string().optional()
 });
 const MemoryRowSchema = zod.z.object({
 	id: zod.z.string(),
@@ -221,7 +310,6 @@ const MemoryRowSchema = zod.z.object({
 	source: zod.z.string().nullable(),
 	access_count: zod.z.number(),
 	pinned: zod.z.number(),
-	needs_review: zod.z.number(),
 	created_at: zod.z.string(),
 	updated_at: zod.z.string()
 });
@@ -234,7 +322,7 @@ const ProjectRowSchema = zod.z.object({
 });
 //#endregion
 //#region src/db/row-types.ts
-function rowToMemory(row, projects) {
+function rowToMemory(row, projects, reviewEvents = []) {
 	return {
 		id: row.id,
 		content: row.content,
@@ -244,11 +332,24 @@ function rowToMemory(row, projects) {
 		sourceHarness: row.source,
 		accessCount: row.access_count,
 		pinned: row.pinned !== 0,
-		needsReview: row.needs_review !== 0,
+		reviewEvents,
 		createdAt: row.created_at,
 		updatedAt: row.updated_at
 	};
 }
+function rowToReviewEvent(row) {
+	const parsed = ReviewEventRowSchema.parse(row);
+	return {
+		id: parsed.id,
+		memoryId: parsed.memory_id,
+		conflictingMemoryId: parsed.conflicting_memory_id,
+		similarity: parsed.similarity,
+		conflictContentSnapshot: parsed.conflict_content_snapshot,
+		reason: parsed.reason,
+		createdAt: parsed.created_at,
+		resolvedAt: parsed.resolved_at
+	};
+}
 function rowToProject(row) {
 	return {
 		id: row.id,
@@ -285,6 +386,7 @@ var EmbeddingService = class {
 };
 //#endregion
 //#region src/memory/repository.ts
+const PIN_BUDGET_THRESHOLD = 8e3;
 var MemoryRepository = class {
 	#db;
 	#embedding;
@@ -314,21 +416,26 @@ var MemoryRepository = class {
 		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);
-			return rowToMemory(MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(top.id)), this.#projects.getProjectsForMemories([top.id]).get(top.id) ?? []);
+			const updated = MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(top.id));
+			const projectMap = this.#projects.getProjectsForMemories([top.id]);
+			const events = this.#getEventsForMemories([top.id]);
+			return rowToMemory(updated, projectMap.get(top.id) ?? [], events.get(top.id) ?? []);
 		}
-		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, source, access_count, pinned, needs_review, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, 0, 0, 0, ?, ?)`).run(id, content, type, JSON.stringify(tags), sourceHarness ?? null, now, now);
+		this.#db.db.prepare(`INSERT INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, 0, 0, ?, ?)`).run(id, content, type, JSON.stringify(tags), sourceHarness ?? null, now, now);
+		if (top !== void 0 && top.similarity >= .75) this.#db.db.prepare(`INSERT INTO memory_review_events
+             (id, memory_id, conflicting_memory_id, similarity, conflict_content_snapshot, reason, created_at)
+           VALUES (?, ?, ?, ?, ?, 'similarity_dedup', ?)`).run((0, node_crypto.randomUUID)(), top.id, id, top.similarity, content, now);
 		this.#db.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(embeddingBlob, id);
 		if (projectScope !== void 0) {
 			const project = this.#projects.upsertByHash(projectScope.hash, projectScope.name);
 			this.#projects.addAssociation(id, project.id);
 		}
-		return rowToMemory(MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id)), this.#projects.getProjectsForMemories([id]).get(id) ?? []);
+		return rowToMemory(MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id)), this.#projects.getProjectsForMemories([id]).get(id) ?? [], []);
 	}
 	async update(id, patch) {
-		const { content, tags } = MemoryPatchSchema.parse(patch);
+		const { content, tags, type } = MemoryPatchSchema.parse(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();
@@ -342,6 +449,10 @@ var MemoryRepository = class {
 			sets.push("tags = ?");
 			values.push(JSON.stringify(tags));
 		}
+		if (type !== void 0) {
+			sets.push("type = ?");
+			values.push(type);
+		}
 		values.push(id);
 		this.#db.db.prepare(`UPDATE memories SET ${sets.join(", ")} WHERE id = ?`).run(...values);
 		if (content !== void 0) {
@@ -349,7 +460,10 @@ var MemoryRepository = class {
 			const embeddingBlob = Buffer.from(embedding.buffer);
 			this.#db.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(embeddingBlob, existing.rowid);
 		}
-		return rowToMemory(MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id)), this.#projects.getProjectsForMemories([id]).get(id) ?? []);
+		const updated = MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id));
+		const projectMap = this.#projects.getProjectsForMemories([id]);
+		const events = this.#getEventsForMemories([id]);
+		return rowToMemory(updated, projectMap.get(id) ?? [], events.get(id) ?? []);
 	}
 	delete(id) {
 		const row = this.#db.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(id);
@@ -371,7 +485,48 @@ var MemoryRepository = class {
 		if (rows.length === 0) return [];
 		const ids = rows.map((r) => r.id);
 		const projectMap = this.#projects.getProjectsForMemories(ids);
-		return rows.map((row) => rowToMemory(row, projectMap.get(row.id) ?? []));
+		const eventMap = this.#getEventsForMemories(ids);
+		return rows.map((row) => rowToMemory(row, projectMap.get(row.id) ?? [], eventMap.get(row.id) ?? []));
+	}
+	listFlagged() {
+		const rows = this.#db.db.prepare(`SELECT * FROM memories
+         WHERE EXISTS (
+           SELECT 1 FROM memory_review_events e
+           WHERE e.memory_id = memories.id AND e.resolved_at IS NULL
+         )
+         ORDER BY created_at DESC`).all();
+		if (rows.length === 0) return [];
+		const ids = rows.map((r) => r.id);
+		const projectMap = this.#projects.getProjectsForMemories(ids);
+		const eventMap = this.#getEventsForMemories(ids, { unresolvedOnly: true });
+		return rows.map((row) => rowToMemory(row, projectMap.get(row.id) ?? [], eventMap.get(row.id) ?? []));
+	}
+	listReviewEvents(memoryId, opts) {
+		const where = opts?.unresolvedOnly === true ? "WHERE memory_id = ? AND resolved_at IS NULL" : "WHERE memory_id = ?";
+		return this.#db.db.prepare(`SELECT * FROM memory_review_events ${where} ORDER BY created_at DESC`).all(memoryId).map((r) => rowToReviewEvent(ReviewEventRowSchema.parse(r)));
+	}
+	resolveReviewEvents(memoryId) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		this.#db.db.prepare(`UPDATE memory_review_events SET resolved_at = ? WHERE memory_id = ? AND resolved_at IS NULL`).run(now, memoryId);
+	}
+	#getEventsForMemories(ids, opts) {
+		if (ids.length === 0) return /* @__PURE__ */ new Map();
+		const placeholders = ids.map(() => "?").join(", ");
+		const unresolvedClause = opts?.unresolvedOnly === true ? "AND resolved_at IS NULL" : "";
+		const rows = this.#db.db.prepare(`SELECT * FROM memory_review_events
+         WHERE memory_id IN (${placeholders}) ${unresolvedClause}
+         ORDER BY created_at DESC`).all(...ids);
+		const map = /* @__PURE__ */ new Map();
+		for (const row of rows) {
+			const event = rowToReviewEvent(ReviewEventRowSchema.parse(row));
+			const existing = map.get(event.memoryId) ?? [];
+			existing.push(event);
+			map.set(event.memoryId, existing);
+		}
+		return map;
+	}
+	getPinnedCharCount() {
+		return (this.#db.db.prepare(`SELECT COALESCE(SUM(LENGTH(content)), 0) as total FROM memories WHERE pinned = 1`).get() ?? { total: 0 }).total;
 	}
 	stats() {
 		const byType = Object.fromEntries(MEMORY_TYPE_VALUES.map((t) => [t, 0]));
@@ -380,21 +535,27 @@ var MemoryRepository = class {
 			const parsed = MemoryTypeSchema.safeParse(row.type);
 			if (parsed.success) byType[parsed.data] = row.count;
 		}
-		const totals = this.#db.db.prepare(`SELECT COUNT(*) as total, SUM(needs_review) as needsReview FROM memories`).get() ?? {
+		const aggregates = this.#db.db.prepare(`SELECT COUNT(*) as total, SUM(pinned) as pinned FROM memories`).get() ?? {
 			total: 0,
-			needsReview: 0
+			pinned: 0
 		};
+		const reviewRow = this.#db.db.prepare(`SELECT COUNT(DISTINCT memory_id) as needsReview FROM memory_review_events WHERE resolved_at IS NULL`).get() ?? { needsReview: 0 };
 		return {
 			byType,
-			total: totals.total,
-			needsReview: totals.needsReview ?? 0
+			total: aggregates.total,
+			pinned: aggregates.pinned ?? 0,
+			needsReview: reviewRow.needsReview,
+			pinBudgetChars: this.getPinnedCharCount()
 		};
 	}
 	setPin(id, pinned) {
 		if (this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id) === void 0) throw new Error(`Memory not found: ${id}`);
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		this.#db.db.prepare(`UPDATE memories SET pinned = ?, updated_at = ? WHERE id = ?`).run(pinned ? 1 : 0, now, id);
-		return rowToMemory(MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id)), this.#projects.getProjectsForMemories([id]).get(id) ?? []);
+		const updated = MemoryRowSchema.parse(this.#db.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(id));
+		const projectMap = this.#projects.getProjectsForMemories([id]);
+		const events = this.#getEventsForMemories([id]);
+		return rowToMemory(updated, projectMap.get(id) ?? [], events.get(id) ?? []);
 	}
 	incrementAccessCount(id) {
 		this.#db.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(id);
@@ -558,7 +719,7 @@ var QueryEngine = class {
 		const now = Date.now();
 		const scored = rows.filter((row) => row.cosine_sim > 0).map((row) => {
 			const memory = rowToMemory(row, []);
-			const score = this.#computeScore(memory, now);
+			const score = this.#computeScore(memory, row.cosine_sim, now);
 			return {
 				...memory,
 				score
@@ -569,12 +730,12 @@ var QueryEngine = class {
 		for (const result of results) this.#repo.incrementAccessCount(result.id);
 		return results;
 	}
-	#computeScore(memory, now) {
+	#computeScore(memory, cosine_sim, 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;
+		return cosine_sim * .4 + typeWeight * .25 + accessCountNorm * .2 + recencyNorm * .1 + pinned * .05;
 	}
 };
 //#endregion
@@ -587,28 +748,139 @@ var SessionContextBuilder = class {
 	constructor(db) {
 		this.#db = db;
 	}
-	getSessionContext(projectHash) {
-		const pinnedGlobal = this.#db.db.prepare(`SELECT * FROM memories
-         WHERE id NOT IN (SELECT memory_id FROM memory_projects)
-         AND pinned = 1`).all().map((row) => rowToMemory(row, []));
-		const pinnedProject = this.#db.db.prepare(`SELECT m.* FROM memories m
-         JOIN memory_projects mp ON mp.memory_id = m.id
-         JOIN projects p ON p.id = mp.project_id
-         WHERE p.scope_hash = ? AND m.pinned = 1`).all(projectHash).map((row) => rowToMemory(row, []));
+	getSessionContext(projectHash, synthesis) {
 		const typeCounts = this.#db.db.prepare("SELECT type, COUNT(*) as count FROM memories GROUP BY type").all();
 		const stats = Object.fromEntries(MEMORY_TYPE_VALUES.map((t) => [t, 0]));
 		for (const row of typeCounts) {
 			const parsed = MemoryTypeSchema.safeParse(row.type);
 			if (parsed.success) stats[parsed.data] = row.count;
 		}
+		if (synthesis !== void 0 && synthesis.length > 0) return {
+			stats,
+			pinnedGlobal: [],
+			pinnedProject: [],
+			synthesis
+		};
 		return {
 			stats,
-			pinnedGlobal,
-			pinnedProject
+			pinnedGlobal: this.#db.db.prepare(`SELECT * FROM memories
+         WHERE id NOT IN (SELECT memory_id FROM memory_projects)
+         AND pinned = 1`).all().map((row) => rowToMemory(row, [])),
+			pinnedProject: this.#db.db.prepare(`SELECT m.* FROM memories m
+         JOIN memory_projects mp ON mp.memory_id = m.id
+         JOIN projects p ON p.id = mp.project_id
+         WHERE p.scope_hash = ? AND m.pinned = 1`).all(projectHash).map((row) => rowToMemory(row, []))
 		};
 	}
 };
 //#endregion
+//#region src/synthesis/repository.ts
+function rowToSynthesis(row) {
+	return SynthesisSchema.parse({
+		id: row.id,
+		scope: row.scope,
+		content: row.content,
+		sourceMemoryHash: row.source_memory_hash,
+		synthesizedAt: row.synthesized_at,
+		expiresAt: row.expires_at,
+		inFlightSince: row.in_flight_since,
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	});
+}
+const STALENESS_DAYS = 30;
+var SynthesisRepository = class {
+	#db;
+	constructor(db) {
+		this.#db = db;
+	}
+	saveSynthesis(scope, content, sourceHash) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const expiresAt = new Date(Date.now() + STALENESS_DAYS * 24 * 60 * 60 * 1e3).toISOString();
+		if (this.#db.db.prepare("SELECT id FROM syntheses WHERE scope = ?").get(scope) !== void 0) this.#db.db.prepare(`UPDATE syntheses
+           SET content = ?, source_memory_hash = ?, synthesized_at = ?, expires_at = ?,
+               in_flight_since = NULL, updated_at = ?
+           WHERE scope = ?`).run(content, sourceHash, now, expiresAt, now, scope);
+		else {
+			const id = (0, node_crypto.randomUUID)();
+			this.#db.db.prepare(`INSERT INTO syntheses
+             (id, scope, content, source_memory_hash, synthesized_at, expires_at,
+              in_flight_since, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(id, scope, content, sourceHash, now, expiresAt, now, now);
+		}
+		const row = this.#db.db.prepare("SELECT * FROM syntheses WHERE scope = ?").get(scope);
+		if (row === void 0) throw new Error(`Failed to save synthesis for scope: ${scope}`);
+		return rowToSynthesis(row);
+	}
+	getSynthesis(scope) {
+		const row = this.#db.db.prepare("SELECT * FROM syntheses WHERE scope = ?").get(scope);
+		return row !== void 0 ? rowToSynthesis(row) : void 0;
+	}
+	markInFlight(scope) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		if (this.#db.db.prepare("SELECT id FROM syntheses WHERE scope = ?").get(scope) !== void 0) this.#db.db.prepare("UPDATE syntheses SET in_flight_since = ?, updated_at = ? WHERE scope = ?").run(now, now, scope);
+		else {
+			const id = (0, node_crypto.randomUUID)();
+			const placeholder = "pending";
+			const future = new Date(Date.now() + STALENESS_DAYS * 24 * 60 * 60 * 1e3).toISOString();
+			this.#db.db.prepare(`INSERT INTO syntheses
+             (id, scope, content, source_memory_hash, synthesized_at, expires_at,
+              in_flight_since, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, scope, placeholder, "", now, future, now, now, now);
+		}
+	}
+	clearInFlight(scope) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		this.#db.db.prepare("UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE scope = ?").run(now, scope);
+	}
+	computeSourceMemoryHash(scope) {
+		let contents;
+		if (scope === "global") contents = this.#db.db.prepare(`SELECT content FROM memories
+           WHERE id NOT IN (SELECT memory_id FROM memory_projects)
+           ORDER BY id`).all();
+		else contents = this.#db.db.prepare(`SELECT m.content FROM memories m
+           JOIN memory_projects mp ON mp.memory_id = m.id
+           JOIN projects p ON p.id = mp.project_id
+           WHERE p.scope_hash = ?
+           ORDER BY m.id`).all(scope);
+		return (0, node_crypto.createHash)("sha256").update(JSON.stringify(contents.map((r) => r.content))).digest("hex");
+	}
+	getExpiredOrDirtyScopes() {
+		const allScopes = this.getAllActiveScopes();
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const results = [];
+		for (const scope of allScopes) {
+			const row = this.#db.db.prepare("SELECT * FROM syntheses WHERE scope = ?").get(scope);
+			if (row === void 0 || row.content === "pending" && row.source_memory_hash === "") {
+				results.push({
+					scope,
+					reason: "missing"
+				});
+				continue;
+			}
+			if (row.expires_at <= now) {
+				results.push({
+					scope,
+					reason: "expired"
+				});
+				continue;
+			}
+			if (this.computeSourceMemoryHash(scope) !== row.source_memory_hash) results.push({
+				scope,
+				reason: "dirty"
+			});
+		}
+		return results;
+	}
+	getAllActiveScopes() {
+		return ["global", ...this.#db.db.prepare("SELECT DISTINCT scope_hash FROM projects").all().map((r) => r.scope_hash)];
+	}
+	expireStale() {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		this.#db.db.prepare("DELETE FROM syntheses WHERE expires_at < ?").run(now);
+	}
+};
+//#endregion
 exports.DatabaseError = DatabaseError;
 exports.DatabaseManager = DatabaseManager;
 exports.EmbeddingService = EmbeddingService;
@@ -620,15 +892,22 @@ exports.MemoryRepository = MemoryRepository;
 exports.MemoryRowSchema = MemoryRowSchema;
 exports.MemorySchema = MemorySchema;
 exports.MemoryTypeSchema = MemoryTypeSchema;
+exports.PIN_BUDGET_THRESHOLD = PIN_BUDGET_THRESHOLD;
 exports.ProjectRepository = ProjectRepository;
 exports.ProjectRowSchema = ProjectRowSchema;
 exports.ProjectSchema = ProjectSchema;
 exports.QueryEngine = QueryEngine;
 exports.QueryOptionsSchema = QueryOptionsSchema;
+exports.ReviewEventRowSchema = ReviewEventRowSchema;
+exports.ReviewEventSchema = ReviewEventSchema;
+exports.ReviewReasonSchema = ReviewReasonSchema;
 exports.SaveOptionsSchema = SaveOptionsSchema;
 exports.SessionContextBuilder = SessionContextBuilder;
 exports.SessionContextSchema = SessionContextSchema;
+exports.SynthesisRepository = SynthesisRepository;
+exports.SynthesisSchema = SynthesisSchema;
 exports.TagsJsonSchema = TagsJsonSchema;
+exports.isSynthesisEnabled = isSynthesisEnabled;
 exports.listMemoryTypes = listMemoryTypes;
 exports.resolveProject = resolveProject;
 exports.resolveScope = resolveScope;