@xopcai/xopc 0.0.25 → 0.0.27

package/dist/src/agent/memory/dreaming/light-sweep.js

@@ -0,0 +1,328 @@
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.js";
+import { DREAMING_DIR_RELATIVE } from "./constants.js";
+import { buildEntryKey, isoDay, normalizeMemoryPath, normalizeSnippetForHash, snippetHash } from "./utils.js";
+import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore } from "./short-term-store.js";
+import "./last-run.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region src/agent/memory/dreaming/light-sweep.ts
+init_logger();
+const log = createLogger("Dreaming:Light");
+function isDailyMemoryFile(filename) {
+	return /^\d{4}-\d{2}-\d{2}\.md$/i.test(filename);
+}
+/**
+* Cosine-ish similarity via character n-gram overlap.
+* Fast and deterministic — no embeddings required.
+*/
+function trigramSimilarity(textA, textB) {
+	const normalizedA = normalizeSnippetForHash(textA);
+	const normalizedB = normalizeSnippetForHash(textB);
+	if (!normalizedA || !normalizedB) return 0;
+	if (normalizedA === normalizedB) return 1;
+	const gramsA = buildTrigramSet(normalizedA);
+	const gramsB = buildTrigramSet(normalizedB);
+	if (gramsA.size === 0 || gramsB.size === 0) return 0;
+	let intersection = 0;
+	for (const gram of gramsA) if (gramsB.has(gram)) intersection += 1;
+	return intersection / Math.sqrt(gramsA.size * gramsB.size);
+}
+function buildTrigramSet(text) {
+	const grams = /* @__PURE__ */ new Set();
+	for (let i = 0; i <= text.length - 3; i++) grams.add(text.slice(i, i + 3));
+	return grams;
+}
+function resolveConfig(overrides) {
+	return {
+		enabled: overrides?.enabled === true,
+		cron: typeof overrides?.cron === "string" ? overrides.cron : "0 */6 * * *",
+		lookbackDays: Math.max(1, Math.floor(Number(overrides?.lookbackDays) || 2)),
+		limit: Math.max(0, Math.floor(Number(overrides?.limit) || 100)),
+		dedupeSimilarity: Math.max(0, Math.min(1, Number(overrides?.dedupeSimilarity) || .9))
+	};
+}
+/**
+* Scan recent daily memory files (memory/YYYY-MM-DD.md) and collect signal
+* entries into the short-term store. Deduplicates near-identical snippets
+* using trigram similarity.
+*
+* This is the "light sleep" phase: fast, frequent, cheap.
+*/
+async function runLightSweep(params) {
+	const cfg = resolveConfig(params.config);
+	const now = params.now ?? /* @__PURE__ */ new Date();
+	const startedAt = now.toISOString();
+	const runId = `light:${startedAt}:${process.pid}`;
+	const startMs = Date.now();
+	if (!cfg.enabled) {
+		await writeLastRun(params.workspaceDir, {
+			runId,
+			startedAt,
+			cfg,
+			ok: true,
+			reason: "light sweep disabled",
+			startMs,
+			light: {
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			}
+		});
+		return {
+			ok: true,
+			reason: "light sweep disabled",
+			scannedEntries: 0,
+			newSignals: 0,
+			deduped: 0
+		};
+	}
+	try {
+		const recentFiles = await listRecentDailyFiles(path.join(params.workspaceDir, "memory"), cfg.lookbackDays, now);
+		if (recentFiles.length === 0) {
+			await writeLastRun(params.workspaceDir, {
+				runId,
+				startedAt,
+				cfg,
+				ok: true,
+				reason: "no recent daily files",
+				startMs,
+				light: {
+					scannedEntries: 0,
+					newSignals: 0,
+					deduped: 0
+				}
+			});
+			return {
+				ok: true,
+				reason: "no recent daily files",
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			};
+		}
+		const allChunks = [];
+		for (const filePath of recentFiles) {
+			const chunks = await parseFileChunks(filePath, params.workspaceDir);
+			allChunks.push(...chunks);
+		}
+		if (allChunks.length === 0) {
+			await writeLastRun(params.workspaceDir, {
+				runId,
+				startedAt,
+				cfg,
+				ok: true,
+				reason: "no chunks found in daily files",
+				startMs,
+				light: {
+					scannedEntries: 0,
+					newSignals: 0,
+					deduped: 0
+				}
+			});
+			return {
+				ok: true,
+				reason: "no chunks found in daily files",
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			};
+		}
+		const { unique, deduped } = deduplicateChunks(allChunks, cfg.dedupeSimilarity);
+		const capped = unique.slice(0, cfg.limit);
+		const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+		let newSignals = 0;
+		const dayBucket = isoDay(now);
+		const nowIso = now.toISOString();
+		for (const chunk of capped) {
+			const key = buildEntryKey({
+				path: chunk.path,
+				startLine: chunk.startLine,
+				endLine: chunk.endLine
+			});
+			const existing = store.entries[key];
+			if (existing) {
+				bumpEntryPhaseSignal(existing, "lightHits");
+				bumpEntryPhaseSignal(existing, "dailyCount");
+				existing.snippet = chunk.text.slice(0, 360);
+				existing.lastRecalledAt = nowIso;
+			} else {
+				store.entries[key] = {
+					key,
+					path: chunk.path,
+					startLine: chunk.startLine,
+					endLine: chunk.endLine,
+					snippet: chunk.text.slice(0, 360),
+					recallCount: 0,
+					dailyCount: 1,
+					groundedCount: 0,
+					lightHits: 1,
+					remHits: 0,
+					phaseHitCount: 1,
+					totalSignalCount: 1,
+					totalScore: 0,
+					maxScore: 0,
+					queryHashes: [],
+					recallDays: [dayBucket],
+					firstRecalledAt: nowIso,
+					lastRecalledAt: nowIso
+				};
+				newSignals += 1;
+			}
+		}
+		store.updatedAt = nowIso;
+		await saveDreamingStore({
+			workspaceDir: params.workspaceDir,
+			store
+		});
+		log.info({
+			workspaceDir: params.workspaceDir,
+			scanned: allChunks.length,
+			newSignals,
+			deduped
+		}, "Light sweep complete");
+		await writeLastRun(params.workspaceDir, {
+			runId,
+			startedAt,
+			cfg,
+			ok: true,
+			reason: "light sweep complete",
+			startMs,
+			light: {
+				scannedEntries: allChunks.length,
+				newSignals,
+				deduped
+			}
+		});
+		return {
+			ok: true,
+			reason: "light sweep complete",
+			scannedEntries: allChunks.length,
+			newSignals,
+			deduped
+		};
+	} catch (err) {
+		const errorMessage = err instanceof Error ? err.message : String(err);
+		log.error({
+			err,
+			errorMessage,
+			workspaceDir: params.workspaceDir
+		}, `Light sweep failed: ${errorMessage}`);
+		await writeLastRun(params.workspaceDir, {
+			runId,
+			startedAt,
+			cfg,
+			ok: false,
+			reason: `light sweep error: ${errorMessage}`,
+			startMs,
+			light: {
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			},
+			errorMessage
+		}).catch(() => void 0);
+		return {
+			ok: false,
+			reason: errorMessage,
+			scannedEntries: 0,
+			newSignals: 0,
+			deduped: 0
+		};
+	}
+}
+async function listRecentDailyFiles(memoryDir, lookbackDays, now) {
+	let entries;
+	try {
+		entries = await fs.readdir(memoryDir);
+	} catch (err) {
+		if (err?.code === "ENOENT") return [];
+		throw err;
+	}
+	const cutoff = new Date(now);
+	cutoff.setDate(cutoff.getDate() - lookbackDays);
+	const cutoffDay = isoDay(cutoff);
+	return entries.filter((name) => isDailyMemoryFile(name)).filter((name) => {
+		return name.replace(/\.md$/i, "") >= cutoffDay;
+	}).sort().map((name) => path.join(memoryDir, name));
+}
+async function parseFileChunks(filePath, workspaceDir) {
+	let raw;
+	try {
+		raw = await fs.readFile(filePath, "utf-8");
+	} catch {
+		return [];
+	}
+	const relativePath = normalizeMemoryPath(path.relative(workspaceDir, filePath));
+	const lines = raw.split(/\r?\n/);
+	const chunks = [];
+	let chunkStartLine = 1;
+	let currentLines = [];
+	for (let i = 0; i < lines.length; i++) {
+		const trimmed = lines[i].trim();
+		if (trimmed.length === 0) {
+			if (currentLines.length > 0) {
+				const text = currentLines.join(" ").replace(/\s+/g, " ").trim();
+				if (text.length >= 20) chunks.push({
+					path: relativePath,
+					startLine: chunkStartLine,
+					endLine: chunkStartLine + currentLines.length - 1,
+					text: text.slice(0, 360),
+					hash: snippetHash(text)
+				});
+				currentLines = [];
+			}
+			chunkStartLine = i + 2;
+		} else {
+			if (currentLines.length === 0) chunkStartLine = i + 1;
+			currentLines.push(trimmed);
+		}
+	}
+	if (currentLines.length > 0) {
+		const text = currentLines.join(" ").replace(/\s+/g, " ").trim();
+		if (text.length >= 20) chunks.push({
+			path: relativePath,
+			startLine: chunkStartLine,
+			endLine: chunkStartLine + currentLines.length - 1,
+			text: text.slice(0, 360),
+			hash: snippetHash(text)
+		});
+	}
+	return chunks;
+}
+function deduplicateChunks(chunks, threshold) {
+	const unique = [];
+	let deduped = 0;
+	for (const chunk of chunks) if (unique.some((existing) => existing.hash === chunk.hash || trigramSimilarity(existing.text, chunk.text) >= threshold)) deduped += 1;
+	else unique.push(chunk);
+	return {
+		unique,
+		deduped
+	};
+}
+async function writeLastRun(workspaceDir, params) {
+	const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const durationMs = Math.max(0, Date.now() - params.startMs);
+	const lastRun = {
+		version: 2,
+		phase: "light",
+		runId: params.runId,
+		startedAt: params.startedAt,
+		finishedAt,
+		durationMs,
+		ok: params.ok,
+		reason: params.reason,
+		config: params.cfg,
+		light: params.light,
+		...params.errorMessage ? { errorMessage: params.errorMessage } : {}
+	};
+	const lastRunPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE, "last-run-light.json");
+	await fs.mkdir(path.dirname(lastRunPath), { recursive: true });
+	const tmp = `${lastRunPath}.${process.pid}.${Date.now()}.tmp`;
+	await fs.writeFile(tmp, `${JSON.stringify(lastRun, null, 2)}\n`, "utf-8");
+	await fs.rename(tmp, lastRunPath);
+}
+//#endregion
+export { runLightSweep };
+
+//# sourceMappingURL=light-sweep.js.map

package/dist/src/agent/memory/dreaming/light-sweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-sweep.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/light-sweep.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { DREAMING_DIR_RELATIVE } from './constants.js';\nimport type { DreamingLightConfig } from './config.js';\nimport {\n  bumpEntryPhaseSignal,\n  loadDreamingStore,\n  saveDreamingStore,\n} from './short-term-store.js';\nimport {\n  buildEntryKey,\n  isoDay,\n  normalizeMemoryPath,\n  normalizeSnippetForHash,\n  snippetHash,\n} from './utils.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  type DreamingLightLastRun,\n} from './last-run.js';\n\nconst log = createLogger('Dreaming:Light');\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction isDailyMemoryFile(filename: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}\\.md$/i.test(filename);\n}\n\n/**\n * Cosine-ish similarity via character n-gram overlap.\n * Fast and deterministic — no embeddings required.\n */\nfunction trigramSimilarity(textA: string, textB: string): number {\n  const normalizedA = normalizeSnippetForHash(textA);\n  const normalizedB = normalizeSnippetForHash(textB);\n  if (!normalizedA || !normalizedB) return 0;\n  if (normalizedA === normalizedB) return 1;\n\n  const gramsA = buildTrigramSet(normalizedA);\n  const gramsB = buildTrigramSet(normalizedB);\n  if (gramsA.size === 0 || gramsB.size === 0) return 0;\n\n  let intersection = 0;\n  for (const gram of gramsA) {\n    if (gramsB.has(gram)) intersection += 1;\n  }\n  return intersection / Math.sqrt(gramsA.size * gramsB.size);\n}\n\nfunction buildTrigramSet(text: string): Set<string> {\n  const grams = new Set<string>();\n  for (let i = 0; i <= text.length - 3; i++) {\n    grams.add(text.slice(i, i + 3));\n  }\n  return grams;\n}\n\n// ── Light sweep config defaults ────────────────────────────────────────\n\nfunction resolveConfig(overrides?: Partial<DreamingLightConfig>): DreamingLightConfig {\n  return {\n    enabled: overrides?.enabled === true,\n    cron: typeof overrides?.cron === 'string' ? overrides.cron : '0 */6 * * *',\n    lookbackDays: Math.max(1, Math.floor(Number(overrides?.lookbackDays) || 2)),\n    limit: Math.max(0, Math.floor(Number(overrides?.limit) || 100)),\n    dedupeSimilarity: Math.max(0, Math.min(1, Number(overrides?.dedupeSimilarity) || 0.9)),\n  };\n}\n\n// ── Core light sweep ───────────────────────────────────────────────────\n\ntype LightSweepChunk = {\n  path: string;\n  startLine: number;\n  endLine: number;\n  text: string;\n  hash: string;\n};\n\n/**\n * Scan recent daily memory files (memory/YYYY-MM-DD.md) and collect signal\n * entries into the short-term store. Deduplicates near-identical snippets\n * using trigram similarity.\n *\n * This is the \"light sleep\" phase: fast, frequent, cheap.\n */\nexport async function runLightSweep(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingLightConfig>;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  scannedEntries: number;\n  newSignals: number;\n  deduped: number;\n}> {\n  const cfg = resolveConfig(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `light:${startedAt}:${process.pid}`;\n  const startMs = Date.now();\n\n  if (!cfg.enabled) {\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: true, reason: 'light sweep disabled', startMs,\n      light: { scannedEntries: 0, newSignals: 0, deduped: 0 },\n    });\n    return { ok: true, reason: 'light sweep disabled', scannedEntries: 0, newSignals: 0, deduped: 0 };\n  }\n\n  try {\n    const memoryDir = path.join(params.workspaceDir, 'memory');\n    const recentFiles = await listRecentDailyFiles(memoryDir, cfg.lookbackDays, now);\n\n    if (recentFiles.length === 0) {\n      await writeLastRun(params.workspaceDir, {\n        runId, startedAt, cfg, ok: true, reason: 'no recent daily files', startMs,\n        light: { scannedEntries: 0, newSignals: 0, deduped: 0 },\n      });\n      return { ok: true, reason: 'no recent daily files', scannedEntries: 0, newSignals: 0, deduped: 0 };\n    }\n\n    // Parse chunks from daily files.\n    const allChunks: LightSweepChunk[] = [];\n    for (const filePath of recentFiles) {\n      const chunks = await parseFileChunks(filePath, params.workspaceDir);\n      allChunks.push(...chunks);\n    }\n\n    if (allChunks.length === 0) {\n      await writeLastRun(params.workspaceDir, {\n        runId, startedAt, cfg, ok: true, reason: 'no chunks found in daily files', startMs,\n        light: { scannedEntries: 0, newSignals: 0, deduped: 0 },\n      });\n      return { ok: true, reason: 'no chunks found in daily files', scannedEntries: 0, newSignals: 0, deduped: 0 };\n    }\n\n    // Deduplicate chunks by trigram similarity.\n    const { unique, deduped } = deduplicateChunks(allChunks, cfg.dedupeSimilarity);\n    const capped = unique.slice(0, cfg.limit);\n\n    // Merge into the short-term store, bumping lightHits + dailyCount.\n    const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n    let newSignals = 0;\n    const dayBucket = isoDay(now);\n    const nowIso = now.toISOString();\n\n    for (const chunk of capped) {\n      const key = buildEntryKey({ path: chunk.path, startLine: chunk.startLine, endLine: chunk.endLine });\n      const existing = store.entries[key];\n\n      if (existing) {\n        bumpEntryPhaseSignal(existing, 'lightHits');\n        bumpEntryPhaseSignal(existing, 'dailyCount');\n        existing.snippet = chunk.text.slice(0, 360);\n        existing.lastRecalledAt = nowIso;\n      } else {\n        store.entries[key] = {\n          key,\n          path: chunk.path,\n          startLine: chunk.startLine,\n          endLine: chunk.endLine,\n          snippet: chunk.text.slice(0, 360),\n          recallCount: 0,\n          dailyCount: 1,\n          groundedCount: 0,\n          lightHits: 1,\n          remHits: 0,\n          phaseHitCount: 1,\n          totalSignalCount: 1,\n          totalScore: 0,\n          maxScore: 0,\n          queryHashes: [],\n          recallDays: [dayBucket],\n          firstRecalledAt: nowIso,\n          lastRecalledAt: nowIso,\n        };\n        newSignals += 1;\n      }\n    }\n\n    store.updatedAt = nowIso;\n    await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n    log.info(\n      { workspaceDir: params.workspaceDir, scanned: allChunks.length, newSignals, deduped },\n      'Light sweep complete',\n    );\n\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: true, reason: 'light sweep complete', startMs,\n      light: { scannedEntries: allChunks.length, newSignals, deduped },\n    });\n\n    return { ok: true, reason: 'light sweep complete', scannedEntries: allChunks.length, newSignals, deduped };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.error({ err, errorMessage, workspaceDir: params.workspaceDir }, `Light sweep failed: ${errorMessage}`);\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: false, reason: `light sweep error: ${errorMessage}`, startMs,\n      light: { scannedEntries: 0, newSignals: 0, deduped: 0 }, errorMessage,\n    }).catch(() => undefined);\n    return { ok: false, reason: errorMessage, scannedEntries: 0, newSignals: 0, deduped: 0 };\n  }\n}\n\n// ── File scanning ──────────────────────────────────────────────────────\n\nasync function listRecentDailyFiles(memoryDir: string, lookbackDays: number, now: Date): Promise<string[]> {\n  let entries: string[];\n  try {\n    entries = await fs.readdir(memoryDir);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return [];\n    throw err;\n  }\n\n  const cutoff = new Date(now);\n  cutoff.setDate(cutoff.getDate() - lookbackDays);\n  const cutoffDay = isoDay(cutoff);\n\n  return entries\n    .filter((name) => isDailyMemoryFile(name))\n    .filter((name) => {\n      const day = name.replace(/\\.md$/i, '');\n      return day >= cutoffDay;\n    })\n    .sort()\n    .map((name) => path.join(memoryDir, name));\n}\n\nasync function parseFileChunks(filePath: string, workspaceDir: string): Promise<LightSweepChunk[]> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(filePath, 'utf-8');\n  } catch {\n    return [];\n  }\n\n  const relativePath = normalizeMemoryPath(path.relative(workspaceDir, filePath));\n  const lines = raw.split(/\\r?\\n/);\n  const chunks: LightSweepChunk[] = [];\n\n  // Split into paragraph-level chunks (separated by blank lines).\n  let chunkStartLine = 1;\n  let currentLines: string[] = [];\n\n  for (let i = 0; i < lines.length; i++) {\n    const trimmed = lines[i]!.trim();\n    if (trimmed.length === 0) {\n      if (currentLines.length > 0) {\n        const text = currentLines.join(' ').replace(/\\s+/g, ' ').trim();\n        if (text.length >= 20) {\n          chunks.push({\n            path: relativePath,\n            startLine: chunkStartLine,\n            endLine: chunkStartLine + currentLines.length - 1,\n            text: text.slice(0, 360),\n            hash: snippetHash(text),\n          });\n        }\n        currentLines = [];\n      }\n      chunkStartLine = i + 2; // next non-blank line (1-indexed)\n    } else {\n      if (currentLines.length === 0) chunkStartLine = i + 1;\n      currentLines.push(trimmed);\n    }\n  }\n\n  // Flush remaining.\n  if (currentLines.length > 0) {\n    const text = currentLines.join(' ').replace(/\\s+/g, ' ').trim();\n    if (text.length >= 20) {\n      chunks.push({\n        path: relativePath,\n        startLine: chunkStartLine,\n        endLine: chunkStartLine + currentLines.length - 1,\n        text: text.slice(0, 360),\n        hash: snippetHash(text),\n      });\n    }\n  }\n\n  return chunks;\n}\n\n// ── Deduplication ──────────────────────────────────────────────────────\n\nfunction deduplicateChunks(\n  chunks: LightSweepChunk[],\n  threshold: number,\n): { unique: LightSweepChunk[]; deduped: number } {\n  const unique: LightSweepChunk[] = [];\n  let deduped = 0;\n\n  for (const chunk of chunks) {\n    const isDuplicate = unique.some(\n      (existing) => existing.hash === chunk.hash || trigramSimilarity(existing.text, chunk.text) >= threshold,\n    );\n    if (isDuplicate) {\n      deduped += 1;\n    } else {\n      unique.push(chunk);\n    }\n  }\n\n  return { unique, deduped };\n}\n\n// ── Last-run writer ────────────────────────────────────────────────────\n\nasync function writeLastRun(\n  workspaceDir: string,\n  params: {\n    runId: string;\n    startedAt: string;\n    cfg: DreamingLightConfig;\n    ok: boolean;\n    reason: string;\n    startMs: number;\n    light: DreamingLightLastRun['light'];\n    errorMessage?: string;\n  },\n): Promise<void> {\n  const finishedAt = new Date().toISOString();\n  const durationMs = Math.max(0, Date.now() - params.startMs);\n\n  const lastRun: DreamingLightLastRun = {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'light',\n    runId: params.runId,\n    startedAt: params.startedAt,\n    finishedAt,\n    durationMs,\n    ok: params.ok,\n    reason: params.reason,\n    config: params.cfg,\n    light: params.light,\n    ...(params.errorMessage ? { errorMessage: params.errorMessage } : {}),\n  };\n\n  const lastRunPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE, 'last-run-light.json');\n  await fs.mkdir(path.dirname(lastRunPath), { recursive: true });\n  const tmp = `${lastRunPath}.${process.pid}.${Date.now()}.tmp`;\n  await fs.writeFile(tmp, `${JSON.stringify(lastRun, null, 2)}\\n`, 'utf-8');\n  await fs.rename(tmp, lastRunPath);\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/dreaming/preview.d.ts

@@ -1,4 +1,4 @@
-import type { DreamingDeepConfig } from './deep-promotion.js';
+import type { DreamingDeepConfig } from './config.js';
 type PreviewItem = {
     key: string;
     hash: string;
@@ -9,6 +9,7 @@ type PreviewItem = {
     score: number;
     avgScore: number;
     recallCount: number;
+    recencyDecay: number;
     alreadyPromotedByKey: boolean;
     alreadyPromotedByHash: boolean;
     skippedReason: string | null;
@@ -17,6 +18,7 @@ export declare function previewDreamingDeepPromotion(params: {
     workspaceDir: string;
     config?: Partial<DreamingDeepConfig>;
     limit?: number;
+    now?: Date;
 }): Promise<{
     ok: boolean;
     reason: string;

package/dist/src/agent/memory/dreaming/preview.js

@@ -1,95 +1,11 @@
 import { MEMORY_MD_FILENAME } from "./constants.js";
+import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore } from "./short-term-store.js";
 import path from "node:path";
 import fs from "node:fs/promises";
-import { createHash } from "node:crypto";
 //#region src/agent/memory/dreaming/preview.ts
-function clamp01(value) {
-	if (!Number.isFinite(value)) return 0;
-	return Math.max(0, Math.min(1, value));
-}
-function compare(a, b) {
-	if (b.score !== a.score) return b.score - a.score;
-	if (b.recallCount !== a.recallCount) return b.recallCount - a.recallCount;
-	const aMs = Date.parse(a.lastRecalledAt);
-	const bMs = Date.parse(b.lastRecalledAt);
-	if (Number.isFinite(aMs) || Number.isFinite(bMs)) {
-		if (bMs !== aMs) return bMs - aMs;
-	}
-	return a.path.localeCompare(b.path);
-}
-async function readFileLines(fullPath) {
-	try {
-		return (await fs.readFile(fullPath, "utf-8")).split(/\r?\n/);
-	} catch (err) {
-		if (err?.code === "ENOENT") return null;
-		throw err;
-	}
-}
-function sliceRange(lines, startLine, endLine) {
-	const startIdx = Math.max(0, startLine - 1);
-	const endIdx = Math.min(lines.length, endLine);
-	if (startIdx >= endIdx) return "";
-	return lines.slice(startIdx, endIdx).map((l) => l.trim()).filter(Boolean).join(" ").replace(/\s+/g, " ").trim().slice(0, 360);
-}
-function normalizeSnippetForHash(snippet) {
-	return snippet.trim().replace(/\s+/g, " ").replace(/[“”]/g, "\"").replace(/[‘’]/g, "'").toLowerCase().slice(0, 512);
-}
-function snippetHash(snippet) {
-	return createHash("sha1").update(normalizeSnippetForHash(snippet)).digest("hex").slice(0, 12);
-}
-function extractPromotionMarkers(memoryText) {
-	const keys = /* @__PURE__ */ new Set();
-	const hashes = /* @__PURE__ */ new Set();
-	for (const match of memoryText.matchAll(/<!--\s*xopc-memory-promotion\b([\s\S]*?)-->/gi)) {
-		const body = match[1] ?? "";
-		const k = body.match(/\bkey\s*=\s*"([^"]+)"/i)?.[1]?.trim();
-		const h = body.match(/\bhash\s*=\s*"([^"]+)"/i)?.[1]?.trim();
-		if (k) keys.add(k);
-		if (h) hashes.add(h);
-	}
-	for (const match of memoryText.matchAll(/<!--\s*xopc-memory-promotion:([^\n]+?)\s*-->/gi)) {
-		const key = match[1]?.trim();
-		if (key) keys.add(key);
-	}
-	return {
-		keys,
-		hashes
-	};
-}
-function isContaminatedSnippet(snippet) {
-	const s = snippet.trim();
-	if (!s) return true;
-	const lower = s.toLowerCase();
-	if ([
-		/\b(system|assistant|tool)\s*:/i,
-		/<\s*(system|assistant|tool)\b/i,
-		/<!--\s*xopc-memory-promotion\b/i,
-		/tool_call_id|toolcallid|function_call|arguments\s*:\s*\{/i,
-		/"tool"\s*:\s*|\btool_name\b|\btool\b\s*results?/i,
-		/you are (an|a)\s+(ai|assistant)|follow these instructions/i,
-		/begin\s+(system prompt|instructions)|end\s+(system prompt|instructions)/i,
-		/```/i,
-		/\b__xopc_/i
-	].some((p) => p.test(s))) return true;
-	if ((s.match(/[{}[\]]/g) ?? []).length >= 12) return true;
-	if ((lower.match(/https?:\/\//g) ?? []).length >= 3) return true;
-	return false;
-}
-function resolveDefaultConfig(overrides) {
-	const enabled = overrides?.enabled === true;
-	const minScore = typeof overrides?.minScore === "number" ? overrides.minScore : .8;
-	const minRecallCount = typeof overrides?.minRecallCount === "number" ? overrides.minRecallCount : 3;
-	const limit = typeof overrides?.limit === "number" ? overrides.limit : 10;
-	return {
-		enabled,
-		minScore: clamp01(minScore),
-		minRecallCount: Math.max(1, Math.floor(minRecallCount)),
-		limit: Math.max(0, Math.floor(limit))
-	};
-}
 async function previewDreamingDeepPromotion(params) {
-	const cfg = resolveDefaultConfig(params.config);
+	const cfg = resolveDeepDefaults(params.config);
 	const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);
 	if (!cfg.enabled) return {
 		ok: true,
@@ -98,21 +14,24 @@ async function previewDreamingDeepPromotion(params) {
 		memoryPath
 	};
 	const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+	const nowMs = (params.now ?? /* @__PURE__ */ new Date()).getTime();
 	const ranked = Object.values(store.entries ?? {}).filter((e) => {
 		if (!e || typeof e !== "object") return false;
 		if (e.promotedAt) return false;
 		if (!e.path || !e.path.startsWith("memory/")) return false;
 		if (e.recallCount < cfg.minRecallCount) return false;
+		if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;
+		if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;
 		return clamp01(e.recallCount > 0 ? e.totalScore / e.recallCount : 0) >= cfg.minScore;
 	}).map((e) => {
-		const avgScore = e.recallCount > 0 ? clamp01(e.totalScore / e.recallCount) : 0;
-		const score = clamp01(avgScore + clamp01(Math.log1p(e.recallCount) / Math.log1p(10)) * .12);
+		const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);
 		return {
 			...e,
 			avgScore,
-			score
+			score,
+			recencyDecay
 		};
-	}).sort(compare);
+	}).sort(compareCandidatesByScore);
 	const markers = extractPromotionMarkers(await fs.readFile(memoryPath, "utf-8").catch((err) => {
 		if (err?.code === "ENOENT") return "";
 		throw err;
@@ -132,6 +51,7 @@ async function previewDreamingDeepPromotion(params) {
 				score: candidate.score,
 				avgScore: candidate.avgScore,
 				recallCount: candidate.recallCount,
+				recencyDecay: candidate.recencyDecay,
 				alreadyPromotedByKey: true,
 				alreadyPromotedByHash: false,
 				skippedReason: "already promoted (key)"
@@ -157,6 +77,7 @@ async function previewDreamingDeepPromotion(params) {
 			score: candidate.score,
 			avgScore: candidate.avgScore,
 			recallCount: candidate.recallCount,
+			recencyDecay: candidate.recencyDecay,
 			alreadyPromotedByKey: false,
 			alreadyPromotedByHash,
 			skippedReason: alreadyPromotedByHash ? "already promoted (hash)" : null

package/dist/src/agent/memory/dreaming/preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/preview.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { createHash } from 'node:crypto';\n\nimport type { DreamingDeepConfig } from './deep-promotion.js';\nimport { loadDreamingStore, type DreamingStoreEntry } from './short-term-store.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\n\ntype PreviewItem = {\n  key: string;\n  hash: string;\n  snippet: string;\n  path: string;\n  startLine: number;\n  endLine: number;\n  score: number;\n  avgScore: number;\n  recallCount: number;\n  alreadyPromotedByKey: boolean;\n  alreadyPromotedByHash: boolean;\n  skippedReason: string | null;\n};\n\nfunction clamp01(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction compare(a: { score: number; recallCount: number; lastRecalledAt: string; path: string }, b: { score: number; recallCount: number; lastRecalledAt: string; path: string }): number {\n  if (b.score !== a.score) return b.score - a.score;\n  if (b.recallCount !== a.recallCount) return b.recallCount - a.recallCount;\n  const aMs = Date.parse(a.lastRecalledAt);\n  const bMs = Date.parse(b.lastRecalledAt);\n  if (Number.isFinite(aMs) || Number.isFinite(bMs)) {\n    if (bMs !== aMs) return bMs - aMs;\n  }\n  return a.path.localeCompare(b.path);\n}\n\nasync function readFileLines(fullPath: string): Promise<string[] | null> {\n  try {\n    const raw = await fs.readFile(fullPath, 'utf-8');\n    return raw.split(/\\r?\\n/);\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\nfunction sliceRange(lines: string[], startLine: number, endLine: number): string {\n  const startIdx = Math.max(0, startLine - 1);\n  const endIdx = Math.min(lines.length, endLine);\n  if (startIdx >= endIdx) return '';\n  return lines\n    .slice(startIdx, endIdx)\n    .map((l) => l.trim())\n    .filter(Boolean)\n    .join(' ')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, 360);\n}\n\nfunction normalizeSnippetForHash(snippet: string): string {\n  return snippet\n    .trim()\n    .replace(/\\s+/g, ' ')\n    .replace(/[“”]/g, '\"')\n    .replace(/[‘’]/g, \"'\")\n    .toLowerCase()\n    .slice(0, 512);\n}\n\nfunction snippetHash(snippet: string): string {\n  return createHash('sha1').update(normalizeSnippetForHash(snippet)).digest('hex').slice(0, 12);\n}\n\nfunction extractPromotionMarkers(memoryText: string): { keys: Set<string>; hashes: Set<string> } {\n  const keys = new Set<string>();\n  const hashes = new Set<string>();\n  for (const match of memoryText.matchAll(/<!--\\s*xopc-memory-promotion\\b([\\s\\S]*?)-->/gi)) {\n    const body = match[1] ?? '';\n    const k = body.match(/\\bkey\\s*=\\s*\"([^\"]+)\"/i)?.[1]?.trim();\n    const h = body.match(/\\bhash\\s*=\\s*\"([^\"]+)\"/i)?.[1]?.trim();\n    if (k) keys.add(k);\n    if (h) hashes.add(h);\n  }\n  for (const match of memoryText.matchAll(/<!--\\s*xopc-memory-promotion:([^\\n]+?)\\s*-->/gi)) {\n    const key = match[1]?.trim();\n    if (key) keys.add(key);\n  }\n  return { keys, hashes };\n}\n\nfunction isContaminatedSnippet(snippet: string): boolean {\n  const s = snippet.trim();\n  if (!s) return true;\n  const lower = s.toLowerCase();\n  const patterns: RegExp[] = [\n    /\\b(system|assistant|tool)\\s*:/i,\n    /<\\s*(system|assistant|tool)\\b/i,\n    /<!--\\s*xopc-memory-promotion\\b/i,\n    /tool_call_id|toolcallid|function_call|arguments\\s*:\\s*\\{/i,\n    /\"tool\"\\s*:\\s*|\\btool_name\\b|\\btool\\b\\s*results?/i,\n    /you are (an|a)\\s+(ai|assistant)|follow these instructions/i,\n    /begin\\s+(system prompt|instructions)|end\\s+(system prompt|instructions)/i,\n    /```/i,\n    /\\b__xopc_/i,\n  ];\n  if (patterns.some((p) => p.test(s))) return true;\n  const braceCount = (s.match(/[{}[\\]]/g) ?? []).length;\n  if (braceCount >= 12) return true;\n  const urlCount = (lower.match(/https?:\\/\\//g) ?? []).length;\n  if (urlCount >= 3) return true;\n  return false;\n}\n\nfunction resolveDefaultConfig(overrides?: Partial<DreamingDeepConfig>): DreamingDeepConfig {\n  const enabled = overrides?.enabled === true;\n  const minScore = typeof overrides?.minScore === 'number' ? overrides.minScore : 0.8;\n  const minRecallCount = typeof overrides?.minRecallCount === 'number' ? overrides.minRecallCount : 3;\n  const limit = typeof overrides?.limit === 'number' ? overrides.limit : 10;\n  return {\n    enabled,\n    minScore: clamp01(minScore),\n    minRecallCount: Math.max(1, Math.floor(minRecallCount)),\n    limit: Math.max(0, Math.floor(limit)),\n  };\n}\n\nexport async function previewDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  limit?: number;\n}): Promise<{ ok: boolean; reason: string; items: PreviewItem[]; memoryPath: string }> {\n  const cfg = resolveDefaultConfig(params.config);\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  if (!cfg.enabled) return { ok: true, reason: 'dreaming disabled', items: [], memoryPath };\n\n  const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n  const all = Object.values(store.entries ?? {}).filter((e): e is DreamingStoreEntry => {\n    if (!e || typeof e !== 'object') return false;\n    if (e.promotedAt) return false;\n    if (!e.path || !e.path.startsWith('memory/')) return false;\n    if (e.recallCount < cfg.minRecallCount) return false;\n    const avg = e.recallCount > 0 ? e.totalScore / e.recallCount : 0;\n    return clamp01(avg) >= cfg.minScore;\n  });\n\n  const ranked = all\n    .map((e) => {\n      const avgScore = e.recallCount > 0 ? clamp01(e.totalScore / e.recallCount) : 0;\n      const reinforcement = clamp01(Math.log1p(e.recallCount) / Math.log1p(10)) * 0.12;\n      const score = clamp01(avgScore + reinforcement);\n      return { ...e, avgScore, score };\n    })\n    .sort(compare);\n\n  const existing = await fs.readFile(memoryPath, 'utf-8').catch((err: unknown) => {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return '';\n    throw err;\n  });\n  const markers = extractPromotionMarkers(existing);\n\n  const limit = Math.min(Math.max(params.limit ?? 20, 1), 50);\n  const out: PreviewItem[] = [];\n\n  // Scan more than limit so filtering doesn’t yield empty previews.\n  const scanCap = Math.min(ranked.length, Math.max(limit * 3, limit));\n  for (const candidate of ranked.slice(0, scanCap)) {\n    const alreadyPromotedByKey = markers.keys.has(candidate.key);\n    if (alreadyPromotedByKey) {\n      out.push({\n        key: candidate.key,\n        hash: '',\n        snippet: '',\n        path: candidate.path,\n        startLine: candidate.startLine,\n        endLine: candidate.endLine,\n        score: candidate.score,\n        avgScore: candidate.avgScore,\n        recallCount: candidate.recallCount,\n        alreadyPromotedByKey: true,\n        alreadyPromotedByHash: false,\n        skippedReason: 'already promoted (key)',\n      });\n      continue;\n    }\n\n    const fullPath = path.join(params.workspaceDir, candidate.path);\n    const lines = await readFileLines(fullPath);\n    if (!lines) continue;\n    const startLine = Math.max(1, Math.floor(candidate.startLine));\n    const endLine = Math.max(startLine, Math.floor(candidate.endLine));\n    const snippet = sliceRange(lines, startLine, endLine);\n    if (!snippet) continue;\n    if (isContaminatedSnippet(snippet)) continue;\n    const hash = snippetHash(snippet);\n    const alreadyPromotedByHash = markers.hashes.has(hash);\n    out.push({\n      key: candidate.key,\n      hash,\n      snippet,\n      path: candidate.path,\n      startLine,\n      endLine,\n      score: candidate.score,\n      avgScore: candidate.avgScore,\n      recallCount: candidate.recallCount,\n      alreadyPromotedByKey: false,\n      alreadyPromotedByHash,\n      skippedReason: alreadyPromotedByHash ? 'already promoted (hash)' : null,\n    });\n    if (out.filter((x) => !x.skippedReason).length >= limit) break;\n  }\n\n  return { ok: true, reason: 'ok', items: out, memoryPath };\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"preview.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/preview.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type { DreamingDeepConfig } from './config.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport { loadDreamingStore, type DreamingStoreEntry } from './short-term-store.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\ntype PreviewItem = {\n  key: string;\n  hash: string;\n  snippet: string;\n  path: string;\n  startLine: number;\n  endLine: number;\n  score: number;\n  avgScore: number;\n  recallCount: number;\n  recencyDecay: number;\n  alreadyPromotedByKey: boolean;\n  alreadyPromotedByHash: boolean;\n  skippedReason: string | null;\n};\n\nexport async function previewDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  limit?: number;\n  now?: Date;\n}): Promise<{ ok: boolean; reason: string; items: PreviewItem[]; memoryPath: string }> {\n  const cfg = resolveDeepDefaults(params.config);\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  if (!cfg.enabled) return { ok: true, reason: 'dreaming disabled', items: [], memoryPath };\n\n  const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n  const nowMs = (params.now ?? new Date()).getTime();\n\n  const all = Object.values(store.entries ?? {}).filter((e): e is DreamingStoreEntry => {\n    if (!e || typeof e !== 'object') return false;\n    if (e.promotedAt) return false;\n    if (!e.path || !e.path.startsWith('memory/')) return false;\n    if (e.recallCount < cfg.minRecallCount) return false;\n    if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n    if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;\n    const avg = e.recallCount > 0 ? e.totalScore / e.recallCount : 0;\n    return clamp01(avg) >= cfg.minScore;\n  });\n\n  const ranked = all\n    .map((e) => {\n      const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);\n      return { ...e, avgScore, score, recencyDecay };\n    })\n    .sort(compareCandidatesByScore);\n\n  const existing = await fs.readFile(memoryPath, 'utf-8').catch((err: unknown) => {\n    if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return '';\n    throw err;\n  });\n  const markers = extractPromotionMarkers(existing);\n\n  const limit = Math.min(Math.max(params.limit ?? 20, 1), 50);\n  const out: PreviewItem[] = [];\n\n  // Scan more than limit so filtering doesn't yield empty previews.\n  const scanCap = Math.min(ranked.length, Math.max(limit * 3, limit));\n  for (const candidate of ranked.slice(0, scanCap)) {\n    const alreadyPromotedByKey = markers.keys.has(candidate.key);\n    if (alreadyPromotedByKey) {\n      out.push({\n        key: candidate.key,\n        hash: '',\n        snippet: '',\n        path: candidate.path,\n        startLine: candidate.startLine,\n        endLine: candidate.endLine,\n        score: candidate.score,\n        avgScore: candidate.avgScore,\n        recallCount: candidate.recallCount,\n        recencyDecay: candidate.recencyDecay,\n        alreadyPromotedByKey: true,\n        alreadyPromotedByHash: false,\n        skippedReason: 'already promoted (key)',\n      });\n      continue;\n    }\n\n    const fullPath = path.join(params.workspaceDir, candidate.path);\n    const lines = await readFileLines(fullPath);\n    if (!lines) continue;\n    const startLine = Math.max(1, Math.floor(candidate.startLine));\n    const endLine = Math.max(startLine, Math.floor(candidate.endLine));\n    const snippet = sliceRange(lines, startLine, endLine);\n    if (!snippet) continue;\n    if (isContaminatedSnippet(snippet)) continue;\n    const hash = snippetHash(snippet);\n    const alreadyPromotedByHash = markers.hashes.has(hash);\n    out.push({\n      key: candidate.key,\n      hash,\n      snippet,\n      path: candidate.path,\n      startLine,\n      endLine,\n      score: candidate.score,\n      avgScore: candidate.avgScore,\n      recallCount: candidate.recallCount,\n      recencyDecay: candidate.recencyDecay,\n      alreadyPromotedByKey: false,\n      alreadyPromotedByHash,\n      skippedReason: alreadyPromotedByHash ? 'already promoted (hash)' : null,\n    });\n    if (out.filter((x) => !x.skippedReason).length >= limit) break;\n  }\n\n  return { ok: true, reason: 'ok', items: out, memoryPath };\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/dreaming/rem-patterns.d.ts

@@ -0,0 +1,21 @@
+import type { DreamingRemConfig } from './config.js';
+/**
+ * REM phase: cross-session pattern discovery.
+ *
+ * Scans the short-term store for entries that share query hashes or
+ * appear across multiple daily files, then clusters them to identify
+ * recurring themes/patterns. Bumps `remHits` on touched entries and
+ * optionally writes a pattern summary to DREAMS.md.
+ *
+ * Runs weekly; expensive but insightful.
+ */
+export declare function runRemPatterns(params: {
+    workspaceDir: string;
+    config?: Partial<DreamingRemConfig>;
+    now?: Date;
+}): Promise<{
+    ok: boolean;
+    reason: string;
+    patternsDiscovered: number;
+    entriesAnalyzed: number;
+}>;