@xopcai/xopc 0.0.124 → 0.0.125

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

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/events.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE, type DreamingPhaseId } from './constants.js';\n\n// ── Event types ────────────────────────────────────────────────────────\n\nexport type DreamingEventBase = {\n  timestamp: string;\n  phase: DreamingPhaseId;\n  ok: boolean;\n  reason: string;\n  durationMs: number;\n};\n\nexport type DreamingLightEvent = DreamingEventBase & {\n  phase: 'light';\n  scannedEntries: number;\n  newSignals: number;\n  deduped: number;\n};\n\nexport type DreamingDeepEvent = DreamingEventBase & {\n  phase: 'deep';\n  candidates: number;\n  applied: number;\n};\n\nexport type DreamingRemEvent = DreamingEventBase & {\n  phase: 'rem';\n  patternsDiscovered: number;\n  entriesAnalyzed: number;\n};\n\nexport type DreamingEvent = DreamingLightEvent | DreamingDeepEvent | DreamingRemEvent;\n\n// ── Write ──────────────────────────────────────────────────────────────\n\n/**\n * Append a single event line to `memory/.dreams/events.jsonl`.\n * Creates the directory and file if they don't exist.\n * Failures are silently ignored so audit logging never blocks execution.\n */\nexport async function appendDreamingEvent(workspaceDir: string, event: DreamingEvent): Promise<void> {\n  try {\n    const dirPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE);\n    await fs.mkdir(dirPath, { recursive: true });\n    const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);\n    const line = JSON.stringify(event) + '\\n';\n    await fs.appendFile(filePath, line, 'utf-8');\n  } catch {\n    // Audit logging must not block or throw.\n  }\n}\n\n// ── Read ───────────────────────────────────────────────────────────────\n\n/**\n * Read the most recent N events from the events log.\n * Returns newest-first. If the file doesn't exist, returns an empty array.\n */\nexport async function readDreamingEvents(\n  workspaceDir: string,\n  limit = 50,\n): Promise<DreamingEvent[]> {\n  const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);\n  let raw: string;\n  try {\n    raw = await fs.readFile(filePath, 'utf-8');\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return [];\n    throw err;\n  }\n\n  const lines = raw\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter(Boolean);\n\n  // Take the last `limit` lines (newest entries are at the end).\n  const tail = lines.slice(-Math.abs(limit));\n\n  const events: DreamingEvent[] = [];\n  for (const line of tail) {\n    try {\n      const parsed = JSON.parse(line) as DreamingEvent;\n      if (parsed && typeof parsed === 'object' && parsed.timestamp && parsed.phase) {\n        events.push(parsed);\n      }\n    } catch {\n      // Skip malformed lines.\n    }\n  }\n\n  // Return newest first.\n  events.reverse();\n  return events;\n}\n"],"mappings":";;;;;;;;;AA2CA,eAAsB,oBAAoB,cAAsB,OAAqC;AACnG,KAAI;EACF,MAAM,UAAU,KAAK,KAAK,cAAc,sBAAsB;AAC9D,QAAM,GAAG,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;EAC5C,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;EACtE,MAAM,OAAO,KAAK,UAAU,MAAM,GAAG;AACrC,QAAM,GAAG,WAAW,UAAU,MAAM,QAAQ;SACtC;;;;;;AAWV,eAAsB,mBACpB,cACA,QAAQ,IACkB;CAC1B,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;CACtE,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,GAAG,SAAS,UAAU,QAAQ;UACnC,KAAK;AAEZ,MADc,KAA2C,SAC5C,SAAU,QAAO,EAAE;AAChC,QAAM;;CASR,MAAM,OANQ,IACX,MAAM,KAAK,CACX,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAGQ,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;CAE1C,MAAM,SAA0B,EAAE;AAClC,MAAK,MAAM,QAAQ,KACjB,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,UAAU,OAAO,WAAW,YAAY,OAAO,aAAa,OAAO,MACrE,QAAO,KAAK,OAAO;SAEf;AAMV,QAAO,SAAS;AAChB,QAAO"}
+{"version":3,"file":"events.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/events.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE, type DreamingPhaseId } from './constants.js';\n\n// ── Event types ────────────────────────────────────────────────────────\n\nexport type DreamingEventBase = {\n  timestamp: string;\n  phase: DreamingPhaseId;\n  ok: boolean;\n  reason: string;\n  durationMs: number;\n};\n\nexport type DreamingLightEvent = DreamingEventBase & {\n  phase: 'light';\n  scannedEntries: number;\n  newSignals: number;\n  deduped: number;\n};\n\nexport type DreamingDeepEvent = DreamingEventBase & {\n  phase: 'deep';\n  candidates: number;\n  applied: number;\n};\n\nexport type DreamingRemEvent = DreamingEventBase & {\n  phase: 'rem';\n  patternsDiscovered: number;\n  entriesAnalyzed: number;\n};\n\nexport type DreamingEvent = DreamingLightEvent | DreamingDeepEvent | DreamingRemEvent;\n\n// ── Write ──────────────────────────────────────────────────────────────\n\n/**\n * Append a single event line to an agent's `memories/.dreams/events.jsonl`.\n * Creates the directory and file if they don't exist.\n * Failures are silently ignored so audit logging never blocks execution.\n */\nexport async function appendDreamingEvent(dreamingRoot: string, event: DreamingEvent): Promise<void> {\n  try {\n    const dirPath = path.join(dreamingRoot, DREAMING_DIR_RELATIVE);\n    await fs.mkdir(dirPath, { recursive: true });\n    const filePath = path.join(dreamingRoot, DREAMING_EVENTS_LOG_RELATIVE);\n    const line = JSON.stringify(event) + '\\n';\n    await fs.appendFile(filePath, line, 'utf-8');\n  } catch {\n    // Audit logging must not block or throw.\n  }\n}\n\n// ── Read ───────────────────────────────────────────────────────────────\n\n/**\n * Read the most recent N events from the events log.\n * Returns newest-first. If the file doesn't exist, returns an empty array.\n */\nexport async function readDreamingEvents(\n  dreamingRoot: string,\n  limit = 50,\n): Promise<DreamingEvent[]> {\n  const filePath = path.join(dreamingRoot, DREAMING_EVENTS_LOG_RELATIVE);\n  let raw: string;\n  try {\n    raw = await fs.readFile(filePath, 'utf-8');\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return [];\n    throw err;\n  }\n\n  const lines = raw\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter(Boolean);\n\n  // Take the last `limit` lines (newest entries are at the end).\n  const tail = lines.slice(-Math.abs(limit));\n\n  const events: DreamingEvent[] = [];\n  for (const line of tail) {\n    try {\n      const parsed = JSON.parse(line) as DreamingEvent;\n      if (parsed && typeof parsed === 'object' && parsed.timestamp && parsed.phase) {\n        events.push(parsed);\n      }\n    } catch {\n      // Skip malformed lines.\n    }\n  }\n\n  // Return newest first.\n  events.reverse();\n  return events;\n}\n"],"mappings":";;;;;;;;;AA2CA,eAAsB,oBAAoB,cAAsB,OAAqC;AACnG,KAAI;EACF,MAAM,UAAU,KAAK,KAAK,cAAc,sBAAsB;AAC9D,QAAM,GAAG,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;EAC5C,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;EACtE,MAAM,OAAO,KAAK,UAAU,MAAM,GAAG;AACrC,QAAM,GAAG,WAAW,UAAU,MAAM,QAAQ;SACtC;;;;;;AAWV,eAAsB,mBACpB,cACA,QAAQ,IACkB;CAC1B,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;CACtE,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,GAAG,SAAS,UAAU,QAAQ;UACnC,KAAK;AAEZ,MADc,KAA2C,SAC5C,SAAU,QAAO,EAAE;AAChC,QAAM;;CASR,MAAM,OANQ,IACX,MAAM,KAAK,CACX,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAGQ,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;CAE1C,MAAM,SAA0B,EAAE;AAClC,MAAK,MAAM,QAAQ,KACjB,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,UAAU,OAAO,WAAW,YAAY,OAAO,aAAa,OAAO,MACrE,QAAO,KAAK,OAAO;SAEf;AAMV,QAAO,SAAS;AAChB,QAAO"}

package/dist/src/agent/memory/dreaming/last-run.d.ts

@@ -8,7 +8,7 @@ export type DreamingDeepPhaseSkipped = {
     hashDuplicate: number;
 };
 /**
- * On-disk / API shape for `memory/.dreams/last-run.json` (deep promotion sweep).
+ * On-disk / API shape for an agent's `memories/.dreams/last-run.json`.
  */
 export type DreamingDeepLastRun = {
     version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;
@@ -75,6 +75,6 @@ export type DreamingLastRun = DreamingDeepLastRun | DreamingLightLastRun | Dream
 export declare function parseDreamingLastRunFile(raw: unknown): DreamingDeepLastRun | null;
 export declare function emptyDeepPhaseSkipped(): DreamingDeepPhaseSkipped;
 export declare function writeDreamingDeepLastRun(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
     lastRun: DreamingDeepLastRun;
 }): Promise<void>;

package/dist/src/agent/memory/dreaming/last-run.js

@@ -86,7 +86,7 @@ function emptyDeepPhaseSkipped() {
 	return { ...EMPTY_SKIPPED };
 }
 async function writeDreamingDeepLastRun(params) {
-	const fullPath = path.join(params.workspaceDir, DREAMING_LAST_RUN_RELATIVE);
+	const fullPath = path.join(params.dreamingRoot, DREAMING_LAST_RUN_RELATIVE);
 	await fs.mkdir(path.dirname(fullPath), { recursive: true });
 	const tmp = `${fullPath}.${process.pid}.${Date.now()}.tmp`;
 	await fs.writeFile(tmp, `${JSON.stringify(params.lastRun, null, 2)}\n`, "utf-8");

package/dist/src/agent/memory/dreaming/last-run.js.map

@@ -1 +1 @@
-{"version":3,"file":"last-run.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/last-run.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { DREAMING_LAST_RUN_RELATIVE } from './constants.js';\nimport type { DreamingDeepConfig, DreamingLightConfig, DreamingRemConfig } from './config.js';\n\nexport const DREAMING_LAST_RUN_FORMAT_VERSION = 2 as const;\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingDeepPhaseSkipped = {\n  alreadyPromotedKey: number;\n  rehydrateFailed: number;\n  contaminated: number;\n  hashDuplicate: number;\n};\n\n/**\n * On-disk / API shape for `memory/.dreams/last-run.json` (deep promotion sweep).\n */\nexport type DreamingDeepLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'deep';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: {\n    candidatesRanked: number;\n    applied: number;\n    skipped: DreamingDeepPhaseSkipped;\n  };\n};\n\n/**\n * On-disk shape for light sweep last-run.\n */\nexport type DreamingLightLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'light';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingLightConfig;\n  light: {\n    scannedEntries: number;\n    newSignals: number;\n    deduped: number;\n  };\n  errorMessage?: string;\n};\n\n/**\n * On-disk shape for REM pattern last-run.\n */\nexport type DreamingRemLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'rem';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingRemConfig;\n  rem: {\n    patternsDiscovered: number;\n    entriesAnalyzed: number;\n  };\n  errorMessage?: string;\n};\n\n/** Union of all phase last-run shapes. */\nexport type DreamingLastRun = DreamingDeepLastRun | DreamingLightLastRun | DreamingRemLastRun;\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return v !== null && typeof v === 'object' && !Array.isArray(v);\n}\n\nfunction asNonNegInt(v: unknown): number {\n  if (typeof v === 'number' && Number.isFinite(v)) return Math.max(0, Math.floor(v));\n  if (typeof v === 'string' && v.trim() && Number.isFinite(Number(v))) {\n    return Math.max(0, Math.floor(Number(v)));\n  }\n  return 0;\n}\n\nfunction asDreamingDeepConfig(v: unknown): DreamingDeepConfig | null {\n  if (!isRecord(v)) return null;\n  return {\n    enabled: v.enabled === true,\n    cron: typeof v.cron === 'string' ? v.cron : '0 3 * * *',\n    minScore: typeof v.minScore === 'number' && Number.isFinite(v.minScore) ? v.minScore : 0,\n    minRecallCount: asNonNegInt(v.minRecallCount) || 1,\n    minUniqueQueries: asNonNegInt(v.minUniqueQueries) || 3,\n    limit: asNonNegInt(v.limit),\n    recencyHalfLifeDays: asNonNegInt(v.recencyHalfLifeDays) || 14,\n    maxAgeDays: asNonNegInt(v.maxAgeDays) || 30,\n  };\n}\n\nconst EMPTY_SKIPPED: DreamingDeepPhaseSkipped = {\n  alreadyPromotedKey: 0,\n  rehydrateFailed: 0,\n  contaminated: 0,\n  hashDuplicate: 0,\n};\n\nfunction parseSkippedStrict(raw: unknown): DreamingDeepPhaseSkipped | null {\n  if (!isRecord(raw)) return null;\n  if (\n    typeof raw.alreadyPromotedKey !== 'number' ||\n    !Number.isFinite(raw.alreadyPromotedKey) ||\n    typeof raw.rehydrateFailed !== 'number' ||\n    !Number.isFinite(raw.rehydrateFailed) ||\n    typeof raw.contaminated !== 'number' ||\n    !Number.isFinite(raw.contaminated) ||\n    typeof raw.hashDuplicate !== 'number' ||\n    !Number.isFinite(raw.hashDuplicate)\n  ) {\n    return null;\n  }\n  return {\n    alreadyPromotedKey: Math.max(0, Math.floor(raw.alreadyPromotedKey)),\n    rehydrateFailed: Math.max(0, Math.floor(raw.rehydrateFailed)),\n    contaminated: Math.max(0, Math.floor(raw.contaminated)),\n    hashDuplicate: Math.max(0, Math.floor(raw.hashDuplicate)),\n  };\n}\n\n/**\n * Parse `last-run.json`. Only the current on-disk format (`version: 2`, `phase: 'deep'`) is accepted.\n */\nexport function parseDreamingLastRunFile(raw: unknown): DreamingDeepLastRun | null {\n  if (!isRecord(raw)) return null;\n  if (raw.version !== DREAMING_LAST_RUN_FORMAT_VERSION || raw.phase !== 'deep') return null;\n\n  if (typeof raw.runId !== 'string' || !raw.runId.trim()) return null;\n  if (typeof raw.startedAt !== 'string' || typeof raw.finishedAt !== 'string') return null;\n  if (!raw.startedAt.trim() || !raw.finishedAt.trim()) return null;\n\n  if (typeof raw.durationMs !== 'number' || !Number.isFinite(raw.durationMs) || raw.durationMs < 0) {\n    return null;\n  }\n  if (raw.ok !== true && raw.ok !== false) return null;\n  if (typeof raw.reason !== 'string') return null;\n\n  const config = asDreamingDeepConfig(raw.config);\n  if (!config) return null;\n  if (typeof raw.memoryPath !== 'string' || !raw.memoryPath.trim()) return null;\n\n  const deepRaw = raw.deep;\n  if (!isRecord(deepRaw)) return null;\n  if (typeof deepRaw.candidatesRanked !== 'number' || !Number.isFinite(deepRaw.candidatesRanked)) {\n    return null;\n  }\n  if (typeof deepRaw.applied !== 'number' || !Number.isFinite(deepRaw.applied)) return null;\n  const skipped = parseSkippedStrict(deepRaw.skipped);\n  if (!skipped) return null;\n\n  const err = raw.errorMessage;\n  const errMsg = typeof err === 'string' && err.trim() ? err.trim() : undefined;\n\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: raw.runId.trim(),\n    startedAt: raw.startedAt,\n    finishedAt: raw.finishedAt,\n    durationMs: Math.max(0, Math.floor(raw.durationMs)),\n    ok: raw.ok === true,\n    reason: raw.reason,\n    config,\n    memoryPath: raw.memoryPath,\n    ...(errMsg ? { errorMessage: errMsg } : {}),\n    deep: {\n      candidatesRanked: Math.max(0, Math.floor(deepRaw.candidatesRanked)),\n      applied: Math.max(0, Math.floor(deepRaw.applied)),\n      skipped,\n    },\n  };\n}\n\nexport function emptyDeepPhaseSkipped(): DreamingDeepPhaseSkipped {\n  return { ...EMPTY_SKIPPED };\n}\n\nexport async function writeDreamingDeepLastRun(params: {\n  workspaceDir: string;\n  lastRun: DreamingDeepLastRun;\n}): Promise<void> {\n  const fullPath = path.join(params.workspaceDir, DREAMING_LAST_RUN_RELATIVE);\n  await fs.mkdir(path.dirname(fullPath), { recursive: true });\n  const tmp = `${fullPath}.${process.pid}.${Date.now()}.tmp`;\n  await fs.writeFile(tmp, `${JSON.stringify(params.lastRun, null, 2)}\\n`, 'utf-8');\n  await fs.rename(tmp, fullPath);\n}\n"],"mappings":"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"}
+{"version":3,"file":"last-run.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/last-run.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { DREAMING_LAST_RUN_RELATIVE } from './constants.js';\nimport type { DreamingDeepConfig, DreamingLightConfig, DreamingRemConfig } from './config.js';\n\nexport const DREAMING_LAST_RUN_FORMAT_VERSION = 2 as const;\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingDeepPhaseSkipped = {\n  alreadyPromotedKey: number;\n  rehydrateFailed: number;\n  contaminated: number;\n  hashDuplicate: number;\n};\n\n/**\n * On-disk / API shape for an agent's `memories/.dreams/last-run.json`.\n */\nexport type DreamingDeepLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'deep';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: {\n    candidatesRanked: number;\n    applied: number;\n    skipped: DreamingDeepPhaseSkipped;\n  };\n};\n\n/**\n * On-disk shape for light sweep last-run.\n */\nexport type DreamingLightLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'light';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingLightConfig;\n  light: {\n    scannedEntries: number;\n    newSignals: number;\n    deduped: number;\n  };\n  errorMessage?: string;\n};\n\n/**\n * On-disk shape for REM pattern last-run.\n */\nexport type DreamingRemLastRun = {\n  version: typeof DREAMING_LAST_RUN_FORMAT_VERSION;\n  phase: 'rem';\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  durationMs: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingRemConfig;\n  rem: {\n    patternsDiscovered: number;\n    entriesAnalyzed: number;\n  };\n  errorMessage?: string;\n};\n\n/** Union of all phase last-run shapes. */\nexport type DreamingLastRun = DreamingDeepLastRun | DreamingLightLastRun | DreamingRemLastRun;\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return v !== null && typeof v === 'object' && !Array.isArray(v);\n}\n\nfunction asNonNegInt(v: unknown): number {\n  if (typeof v === 'number' && Number.isFinite(v)) return Math.max(0, Math.floor(v));\n  if (typeof v === 'string' && v.trim() && Number.isFinite(Number(v))) {\n    return Math.max(0, Math.floor(Number(v)));\n  }\n  return 0;\n}\n\nfunction asDreamingDeepConfig(v: unknown): DreamingDeepConfig | null {\n  if (!isRecord(v)) return null;\n  return {\n    enabled: v.enabled === true,\n    cron: typeof v.cron === 'string' ? v.cron : '0 3 * * *',\n    minScore: typeof v.minScore === 'number' && Number.isFinite(v.minScore) ? v.minScore : 0,\n    minRecallCount: asNonNegInt(v.minRecallCount) || 1,\n    minUniqueQueries: asNonNegInt(v.minUniqueQueries) || 3,\n    limit: asNonNegInt(v.limit),\n    recencyHalfLifeDays: asNonNegInt(v.recencyHalfLifeDays) || 14,\n    maxAgeDays: asNonNegInt(v.maxAgeDays) || 30,\n  };\n}\n\nconst EMPTY_SKIPPED: DreamingDeepPhaseSkipped = {\n  alreadyPromotedKey: 0,\n  rehydrateFailed: 0,\n  contaminated: 0,\n  hashDuplicate: 0,\n};\n\nfunction parseSkippedStrict(raw: unknown): DreamingDeepPhaseSkipped | null {\n  if (!isRecord(raw)) return null;\n  if (\n    typeof raw.alreadyPromotedKey !== 'number' ||\n    !Number.isFinite(raw.alreadyPromotedKey) ||\n    typeof raw.rehydrateFailed !== 'number' ||\n    !Number.isFinite(raw.rehydrateFailed) ||\n    typeof raw.contaminated !== 'number' ||\n    !Number.isFinite(raw.contaminated) ||\n    typeof raw.hashDuplicate !== 'number' ||\n    !Number.isFinite(raw.hashDuplicate)\n  ) {\n    return null;\n  }\n  return {\n    alreadyPromotedKey: Math.max(0, Math.floor(raw.alreadyPromotedKey)),\n    rehydrateFailed: Math.max(0, Math.floor(raw.rehydrateFailed)),\n    contaminated: Math.max(0, Math.floor(raw.contaminated)),\n    hashDuplicate: Math.max(0, Math.floor(raw.hashDuplicate)),\n  };\n}\n\n/**\n * Parse `last-run.json`. Only the current on-disk format (`version: 2`, `phase: 'deep'`) is accepted.\n */\nexport function parseDreamingLastRunFile(raw: unknown): DreamingDeepLastRun | null {\n  if (!isRecord(raw)) return null;\n  if (raw.version !== DREAMING_LAST_RUN_FORMAT_VERSION || raw.phase !== 'deep') return null;\n\n  if (typeof raw.runId !== 'string' || !raw.runId.trim()) return null;\n  if (typeof raw.startedAt !== 'string' || typeof raw.finishedAt !== 'string') return null;\n  if (!raw.startedAt.trim() || !raw.finishedAt.trim()) return null;\n\n  if (typeof raw.durationMs !== 'number' || !Number.isFinite(raw.durationMs) || raw.durationMs < 0) {\n    return null;\n  }\n  if (raw.ok !== true && raw.ok !== false) return null;\n  if (typeof raw.reason !== 'string') return null;\n\n  const config = asDreamingDeepConfig(raw.config);\n  if (!config) return null;\n  if (typeof raw.memoryPath !== 'string' || !raw.memoryPath.trim()) return null;\n\n  const deepRaw = raw.deep;\n  if (!isRecord(deepRaw)) return null;\n  if (typeof deepRaw.candidatesRanked !== 'number' || !Number.isFinite(deepRaw.candidatesRanked)) {\n    return null;\n  }\n  if (typeof deepRaw.applied !== 'number' || !Number.isFinite(deepRaw.applied)) return null;\n  const skipped = parseSkippedStrict(deepRaw.skipped);\n  if (!skipped) return null;\n\n  const err = raw.errorMessage;\n  const errMsg = typeof err === 'string' && err.trim() ? err.trim() : undefined;\n\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: raw.runId.trim(),\n    startedAt: raw.startedAt,\n    finishedAt: raw.finishedAt,\n    durationMs: Math.max(0, Math.floor(raw.durationMs)),\n    ok: raw.ok === true,\n    reason: raw.reason,\n    config,\n    memoryPath: raw.memoryPath,\n    ...(errMsg ? { errorMessage: errMsg } : {}),\n    deep: {\n      candidatesRanked: Math.max(0, Math.floor(deepRaw.candidatesRanked)),\n      applied: Math.max(0, Math.floor(deepRaw.applied)),\n      skipped,\n    },\n  };\n}\n\nexport function emptyDeepPhaseSkipped(): DreamingDeepPhaseSkipped {\n  return { ...EMPTY_SKIPPED };\n}\n\nexport async function writeDreamingDeepLastRun(params: {\n  dreamingRoot: string;\n  lastRun: DreamingDeepLastRun;\n}): Promise<void> {\n  const fullPath = path.join(params.dreamingRoot, DREAMING_LAST_RUN_RELATIVE);\n  await fs.mkdir(path.dirname(fullPath), { recursive: true });\n  const tmp = `${fullPath}.${process.pid}.${Date.now()}.tmp`;\n  await fs.writeFile(tmp, `${JSON.stringify(params.lastRun, null, 2)}\\n`, 'utf-8');\n  await fs.rename(tmp, fullPath);\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/dreaming/light-sweep.d.ts

@@ -1,6 +1,6 @@
 import type { DreamingLightConfig } from './config.js';
 export declare function runLightSweep(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
     config?: Partial<DreamingLightConfig>;
     now?: Date;
 }): Promise<{

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

@@ -18,7 +18,7 @@ async function runLightSweep(params) {
 	const runId = `light:${startedAt}:${process.pid}`;
 	const startMs = Date.now();
 	const reason = cfg.enabled ? "light sweep disabled: no implicit file source" : "light sweep disabled";
-	await writeLastRun(params.workspaceDir, {
+	await writeLastRun(params.dreamingRoot, {
 		runId,
 		startedAt,
 		cfg,
@@ -39,7 +39,7 @@ async function runLightSweep(params) {
 		deduped: 0
 	};
 }
-async function writeLastRun(workspaceDir, params) {
+async function writeLastRun(dreamingRoot, params) {
 	const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
 	const durationMs = Math.max(0, Date.now() - params.startMs);
 	const lastRun = {
@@ -55,7 +55,7 @@ async function writeLastRun(workspaceDir, params) {
 		light: params.light,
 		...params.errorMessage ? { errorMessage: params.errorMessage } : {}
 	};
-	const lastRunPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE, "last-run-light.json");
+	const lastRunPath = path.join(dreamingRoot, 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");

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

@@ -1 +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 { DREAMING_DIR_RELATIVE } from './constants.js';\nimport type { DreamingLightConfig } from './config.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  type DreamingLightLastRun,\n} from './last-run.js';\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\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  const reason = cfg.enabled\n    ? 'light sweep disabled: no implicit file source'\n    : 'light sweep disabled';\n\n  await writeLastRun(params.workspaceDir, {\n    runId, startedAt, cfg, ok: true, reason, startMs,\n    light: { scannedEntries: 0, newSignals: 0, deduped: 0 },\n  });\n  return { ok: true, reason, scannedEntries: 0, newSignals: 0, deduped: 0 };\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":";;;;;AAUA,SAAS,cAAc,WAA+D;AACpF,QAAO;EACL,SAAS,WAAW,YAAY;EAChC,MAAM,OAAO,WAAW,SAAS,WAAW,UAAU,OAAO;EAC7D,cAAc,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,WAAW,aAAa,IAAI,EAAE,CAAC;EAC3E,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC;EAC/D,kBAAkB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,OAAO,WAAW,iBAAiB,IAAI,GAAI,CAAC;EACvF;;AAGH,eAAsB,cAAc,QAUjC;CACD,MAAM,MAAM,cAAc,OAAO,OAAO;CAExC,MAAM,aADM,OAAO,uBAAO,IAAI,MAAM,EACd,aAAa;CACnC,MAAM,QAAQ,SAAS,UAAU,GAAG,QAAQ;CAC5C,MAAM,UAAU,KAAK,KAAK;CAC1B,MAAM,SAAS,IAAI,UACf,kDACA;AAEJ,OAAM,aAAa,OAAO,cAAc;EACtC;EAAO;EAAW;EAAK,IAAI;EAAM;EAAQ;EACzC,OAAO;GAAE,gBAAgB;GAAG,YAAY;GAAG,SAAS;GAAG;EACxD,CAAC;AACF,QAAO;EAAE,IAAI;EAAM;EAAQ,gBAAgB;EAAG,YAAY;EAAG,SAAS;EAAG;;AAK3E,eAAe,aACb,cACA,QAUe;CACf,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;CAC3C,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,GAAG,OAAO,QAAQ;CAE3D,MAAM,UAAgC;EACpC,SAAA;EACA,OAAO;EACP,OAAO,OAAO;EACd,WAAW,OAAO;EAClB;EACA;EACA,IAAI,OAAO;EACX,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,OAAO,OAAO;EACd,GAAI,OAAO,eAAe,EAAE,cAAc,OAAO,cAAc,GAAG,EAAE;EACrE;CAED,MAAM,cAAc,KAAK,KAAK,cAAc,uBAAuB,sBAAsB;AACzF,OAAM,GAAG,MAAM,KAAK,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;CAC9D,MAAM,MAAM,GAAG,YAAY,GAAG,QAAQ,IAAI,GAAG,KAAK,KAAK,CAAC;AACxD,OAAM,GAAG,UAAU,KAAK,GAAG,KAAK,UAAU,SAAS,MAAM,EAAE,CAAC,KAAK,QAAQ;AACzE,OAAM,GAAG,OAAO,KAAK,YAAY"}
+{"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 { DREAMING_DIR_RELATIVE } from './constants.js';\nimport type { DreamingLightConfig } from './config.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  type DreamingLightLastRun,\n} from './last-run.js';\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\nexport async function runLightSweep(params: {\n  dreamingRoot: 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  const reason = cfg.enabled\n    ? 'light sweep disabled: no implicit file source'\n    : 'light sweep disabled';\n\n  await writeLastRun(params.dreamingRoot, {\n    runId, startedAt, cfg, ok: true, reason, startMs,\n    light: { scannedEntries: 0, newSignals: 0, deduped: 0 },\n  });\n  return { ok: true, reason, scannedEntries: 0, newSignals: 0, deduped: 0 };\n}\n\n// ── Last-run writer ────────────────────────────────────────────────────\n\nasync function writeLastRun(\n  dreamingRoot: 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(dreamingRoot, 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":";;;;;AAUA,SAAS,cAAc,WAA+D;AACpF,QAAO;EACL,SAAS,WAAW,YAAY;EAChC,MAAM,OAAO,WAAW,SAAS,WAAW,UAAU,OAAO;EAC7D,cAAc,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,WAAW,aAAa,IAAI,EAAE,CAAC;EAC3E,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC;EAC/D,kBAAkB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,OAAO,WAAW,iBAAiB,IAAI,GAAI,CAAC;EACvF;;AAGH,eAAsB,cAAc,QAUjC;CACD,MAAM,MAAM,cAAc,OAAO,OAAO;CAExC,MAAM,aADM,OAAO,uBAAO,IAAI,MAAM,EACd,aAAa;CACnC,MAAM,QAAQ,SAAS,UAAU,GAAG,QAAQ;CAC5C,MAAM,UAAU,KAAK,KAAK;CAC1B,MAAM,SAAS,IAAI,UACf,kDACA;AAEJ,OAAM,aAAa,OAAO,cAAc;EACtC;EAAO;EAAW;EAAK,IAAI;EAAM;EAAQ;EACzC,OAAO;GAAE,gBAAgB;GAAG,YAAY;GAAG,SAAS;GAAG;EACxD,CAAC;AACF,QAAO;EAAE,IAAI;EAAM;EAAQ,gBAAgB;EAAG,YAAY;EAAG,SAAS;EAAG;;AAK3E,eAAe,aACb,cACA,QAUe;CACf,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;CAC3C,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,GAAG,OAAO,QAAQ;CAE3D,MAAM,UAAgC;EACpC,SAAA;EACA,OAAO;EACP,OAAO,OAAO;EACd,WAAW,OAAO;EAClB;EACA;EACA,IAAI,OAAO;EACX,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,OAAO,OAAO;EACd,GAAI,OAAO,eAAe,EAAE,cAAc,OAAO,cAAc,GAAG,EAAE;EACrE;CAED,MAAM,cAAc,KAAK,KAAK,cAAc,uBAAuB,sBAAsB;AACzF,OAAM,GAAG,MAAM,KAAK,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;CAC9D,MAAM,MAAM,GAAG,YAAY,GAAG,QAAQ,IAAI,GAAG,KAAK,KAAK,CAAC;AACxD,OAAM,GAAG,UAAU,KAAK,GAAG,KAAK,UAAU,SAAS,MAAM,EAAE,CAAC,KAAK,QAAQ;AACzE,OAAM,GAAG,OAAO,KAAK,YAAY"}

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

@@ -16,6 +16,7 @@ type PreviewItem = {
 };
 export declare function previewDreamingDeepPromotion(params: {
     workspaceDir: string;
+    dreamingRoot: string;
     config?: Partial<DreamingDeepConfig>;
     limit?: number;
     now?: Date;

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

@@ -6,14 +6,14 @@ import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/preview.ts
 async function previewDreamingDeepPromotion(params) {
 	const cfg = resolveDeepDefaults(params.config);
-	const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);
+	const memoryPath = path.join(params.dreamingRoot, MEMORY_MD_FILENAME);
 	if (!cfg.enabled) return {
 		ok: true,
 		reason: "dreaming disabled",
 		items: [],
 		memoryPath
 	};
-	const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+	const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });
 	const nowMs = (params.now ?? /* @__PURE__ */ new Date()).getTime();
 	const ranked = Object.values(store.entries ?? {}).filter((e) => {
 		if (!e || typeof e !== "object") return false;

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';\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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"}
+{"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  dreamingRoot: 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.dreamingRoot, MEMORY_MD_FILENAME);\n  if (!cfg.enabled) return { ok: true, reason: 'dreaming disabled', items: [], memoryPath };\n\n  const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });\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

@@ -10,7 +10,7 @@ import type { DreamingRemConfig } from './config.js';
  * Runs weekly; expensive but insightful.
  */
 export declare function runRemPatterns(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
     config?: Partial<DreamingRemConfig>;
     now?: Date;
 }): Promise<{

package/dist/src/agent/memory/dreaming/rem-patterns.js

@@ -36,7 +36,7 @@ async function runRemPatterns(params) {
 	const startMs = Date.now();
 	const nowMs = now.getTime();
 	if (!cfg.enabled) {
-		await writeLastRun(params.workspaceDir, {
+		await writeLastRun(params.dreamingRoot, {
 			runId,
 			startedAt,
 			cfg,
@@ -56,7 +56,7 @@ async function runRemPatterns(params) {
 		};
 	}
 	try {
-		const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+		const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });
 		const cutoffMs = nowMs - cfg.lookbackDays * MS_PER_DAY;
 		const recentEntries = Object.values(store.entries ?? {}).filter((entry) => {
 			if (!entry || typeof entry !== "object") return false;
@@ -65,7 +65,7 @@ async function runRemPatterns(params) {
 			return Number.isFinite(lastMs) && lastMs >= cutoffMs;
 		});
 		if (recentEntries.length < 2) {
-			await writeLastRun(params.workspaceDir, {
+			await writeLastRun(params.dreamingRoot, {
 				runId,
 				startedAt,
 				cfg,
@@ -93,17 +93,17 @@ async function runRemPatterns(params) {
 		}
 		store.updatedAt = now.toISOString();
 		await saveDreamingStore({
-			workspaceDir: params.workspaceDir,
+			dreamingRoot: params.dreamingRoot,
 			store
 		});
-		if (topClusters.length > 0) await appendPatternSummary(params.workspaceDir, topClusters, now);
+		if (topClusters.length > 0) await appendPatternSummary(params.dreamingRoot, topClusters, now);
 		log.info({
-			workspaceDir: params.workspaceDir,
+			dreamingRoot: params.dreamingRoot,
 			patterns: topClusters.length,
 			entriesAnalyzed: recentEntries.length,
 			touched: touchedKeys.size
 		}, "REM pattern discovery complete");
-		await writeLastRun(params.workspaceDir, {
+		await writeLastRun(params.dreamingRoot, {
 			runId,
 			startedAt,
 			cfg,
@@ -126,9 +126,9 @@ async function runRemPatterns(params) {
 		log.error({
 			err,
 			errorMessage,
-			workspaceDir: params.workspaceDir
+			dreamingRoot: params.dreamingRoot
 		}, `REM pattern discovery failed: ${errorMessage}`);
-		await writeLastRun(params.workspaceDir, {
+		await writeLastRun(params.dreamingRoot, {
 			runId,
 			startedAt,
 			cfg,
@@ -230,8 +230,8 @@ function discoverPatternClusters(entries, minStrength) {
 	});
 	return scoredClusters;
 }
-async function appendPatternSummary(workspaceDir, clusters, now) {
-	const dreamsPath = path.join(workspaceDir, DREAMS_MD_FILENAME);
+async function appendPatternSummary(dreamingRoot, clusters, now) {
+	const dreamsPath = path.join(dreamingRoot, DREAMS_MD_FILENAME);
 	const existing = await fs.readFile(dreamsPath, "utf-8").catch((err) => {
 		if (err?.code === "ENOENT") return "";
 		throw err;
@@ -258,7 +258,7 @@ async function appendPatternSummary(workspaceDir, clusters, now) {
 	const next = `${existing}${existing.trim().length > 0 && !existing.endsWith("\n") ? "\n" : ""}${lines.join("\n")}`;
 	await fs.writeFile(dreamsPath, next, "utf-8");
 }
-async function writeLastRun(workspaceDir, params) {
+async function writeLastRun(dreamingRoot, params) {
 	const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
 	const durationMs = Math.max(0, Date.now() - params.startMs);
 	const lastRun = {
@@ -274,7 +274,7 @@ async function writeLastRun(workspaceDir, params) {
 		rem: params.rem,
 		...params.errorMessage ? { errorMessage: params.errorMessage } : {}
 	};
-	const lastRunPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE, "last-run-rem.json");
+	const lastRunPath = path.join(dreamingRoot, DREAMING_DIR_RELATIVE, "last-run-rem.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");

package/dist/src/agent/memory/dreaming/rem-patterns.js.map

@@ -1 +1 @@
-{"version":3,"file":"rem-patterns.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/rem-patterns.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from './constants.js';\nimport type { DreamingRemConfig } from './config.js';\nimport {\n  bumpEntryPhaseSignal,\n  loadDreamingStore,\n  saveDreamingStore,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport { isoDay } from './utils.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  type DreamingRemLastRun,\n} from './last-run.js';\n\nconst log = createLogger('Dreaming:REM');\n\n// ── Pattern types ──────────────────────────────────────────────────────\n\ntype PatternCluster = {\n  representative: DreamingStoreEntry;\n  members: DreamingStoreEntry[];\n  strength: number;\n  /** Shared query hashes across members. */\n  sharedQueries: string[];\n  /** Distinct source files involved. */\n  distinctPaths: string[];\n};\n\n// ── Config defaults ────────────────────────────────────────────────────\n\nfunction resolveConfig(overrides?: Partial<DreamingRemConfig>): DreamingRemConfig {\n  return {\n    enabled: overrides?.enabled === true,\n    cron: typeof overrides?.cron === 'string' ? overrides.cron : '0 5 * * 0',\n    lookbackDays: Math.max(1, Math.floor(Number(overrides?.lookbackDays) || 7)),\n    limit: Math.max(0, Math.floor(Number(overrides?.limit) || 10)),\n    minPatternStrength: Math.max(0, Math.min(1, Number(overrides?.minPatternStrength) || 0.75)),\n  };\n}\n\n// ── Core REM pattern discovery ─────────────────────────────────────────\n\n/**\n * REM phase: cross-session pattern discovery.\n *\n * Scans the short-term store for entries that share query hashes or\n * appear across multiple indexed memory sources, then clusters them to identify\n * recurring themes/patterns. Bumps `remHits` on touched entries and\n * optionally writes a pattern summary to DREAMS.md.\n *\n * Runs weekly; expensive but insightful.\n */\nexport async function runRemPatterns(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingRemConfig>;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  patternsDiscovered: number;\n  entriesAnalyzed: number;\n}> {\n  const cfg = resolveConfig(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `rem:${startedAt}:${process.pid}`;\n  const startMs = Date.now();\n  const nowMs = now.getTime();\n\n  if (!cfg.enabled) {\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: true, reason: 'REM patterns disabled', startMs,\n      rem: { patternsDiscovered: 0, entriesAnalyzed: 0 },\n    });\n    return { ok: true, reason: 'REM patterns disabled', patternsDiscovered: 0, entriesAnalyzed: 0 };\n  }\n\n  try {\n    const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n\n    // Filter entries within the lookback window.\n    const cutoffMs = nowMs - cfg.lookbackDays * MS_PER_DAY;\n    const recentEntries = Object.values(store.entries ?? {}).filter(\n      (entry): entry is DreamingStoreEntry => {\n        if (!entry || typeof entry !== 'object') return false;\n        if (!entry.lastRecalledAt) return false;\n        const lastMs = Date.parse(entry.lastRecalledAt);\n        return Number.isFinite(lastMs) && lastMs >= cutoffMs;\n      },\n    );\n\n    if (recentEntries.length < 2) {\n      await writeLastRun(params.workspaceDir, {\n        runId, startedAt, cfg, ok: true, reason: 'not enough recent entries for pattern analysis', startMs,\n        rem: { patternsDiscovered: 0, entriesAnalyzed: recentEntries.length },\n      });\n      return {\n        ok: true,\n        reason: 'not enough recent entries for pattern analysis',\n        patternsDiscovered: 0,\n        entriesAnalyzed: recentEntries.length,\n      };\n    }\n\n    // Discover patterns by clustering entries that share query hashes.\n    const clusters = discoverPatternClusters(recentEntries, cfg.minPatternStrength);\n    const topClusters = clusters.slice(0, cfg.limit);\n\n    // Bump remHits on all entries that belong to a discovered pattern.\n    const touchedKeys = new Set<string>();\n    for (const cluster of topClusters) {\n      for (const member of cluster.members) {\n        if (!touchedKeys.has(member.key)) {\n          touchedKeys.add(member.key);\n          const storeEntry = store.entries[member.key];\n          if (storeEntry) {\n            bumpEntryPhaseSignal(storeEntry, 'remHits');\n          }\n        }\n      }\n    }\n\n    store.updatedAt = now.toISOString();\n    await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n    // Write pattern summary to DREAMS.md (append).\n    if (topClusters.length > 0) {\n      await appendPatternSummary(params.workspaceDir, topClusters, now);\n    }\n\n    log.info(\n      {\n        workspaceDir: params.workspaceDir,\n        patterns: topClusters.length,\n        entriesAnalyzed: recentEntries.length,\n        touched: touchedKeys.size,\n      },\n      'REM pattern discovery complete',\n    );\n\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: true, reason: 'REM patterns complete', startMs,\n      rem: { patternsDiscovered: topClusters.length, entriesAnalyzed: recentEntries.length },\n    });\n\n    return {\n      ok: true,\n      reason: 'REM patterns complete',\n      patternsDiscovered: topClusters.length,\n      entriesAnalyzed: recentEntries.length,\n    };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.error({ err, errorMessage, workspaceDir: params.workspaceDir }, `REM pattern discovery failed: ${errorMessage}`);\n    await writeLastRun(params.workspaceDir, {\n      runId, startedAt, cfg, ok: false, reason: `REM error: ${errorMessage}`, startMs,\n      rem: { patternsDiscovered: 0, entriesAnalyzed: 0 }, errorMessage,\n    }).catch(() => undefined);\n    return { ok: false, reason: errorMessage, patternsDiscovered: 0, entriesAnalyzed: 0 };\n  }\n}\n\n// ── Pattern clustering ─────────────────────────────────────────────────\n\n/**\n * Build an inverted index of queryHash → entries, then form clusters\n * where multiple entries share overlapping query hashes. Each cluster's\n * \"strength\" is the ratio of shared queries to total unique queries.\n */\nfunction discoverPatternClusters(\n  entries: DreamingStoreEntry[],\n  minStrength: number,\n): PatternCluster[] {\n  // Build inverted index: queryHash → entry keys.\n  const hashToEntries = new Map<string, DreamingStoreEntry[]>();\n  for (const entry of entries) {\n    for (const queryHash of entry.queryHashes ?? []) {\n      const group = hashToEntries.get(queryHash);\n      if (group) {\n        group.push(entry);\n      } else {\n        hashToEntries.set(queryHash, [entry]);\n      }\n    }\n  }\n\n  // Find query hashes that appear in 2+ distinct entries from different paths.\n  const significantHashes: Array<{ hash: string; entries: DreamingStoreEntry[] }> = [];\n  for (const [hash, group] of hashToEntries) {\n    const uniquePaths = new Set(group.map((e) => e.path));\n    if (group.length >= 2 && uniquePaths.size >= 2) {\n      significantHashes.push({ hash, entries: group });\n    }\n  }\n\n  if (significantHashes.length === 0) return [];\n\n  // Merge overlapping groups into clusters using union-find.\n  const keyToCluster = new Map<string, Set<string>>();\n  const keyToEntry = new Map<string, DreamingStoreEntry>();\n\n  for (const entry of entries) {\n    keyToEntry.set(entry.key, entry);\n  }\n\n  for (const { entries: groupEntries } of significantHashes) {\n    const keys = groupEntries.map((e) => e.key);\n    // Find or create the cluster for the first key.\n    let mergedCluster = keyToCluster.get(keys[0]!);\n    if (!mergedCluster) {\n      mergedCluster = new Set<string>();\n      mergedCluster.add(keys[0]!);\n      keyToCluster.set(keys[0]!, mergedCluster);\n    }\n    // Merge all other keys into this cluster.\n    for (const key of keys.slice(1)) {\n      const existingCluster = keyToCluster.get(key);\n      if (existingCluster && existingCluster !== mergedCluster) {\n        for (const existingKey of existingCluster) {\n          mergedCluster.add(existingKey);\n          keyToCluster.set(existingKey, mergedCluster);\n        }\n      } else {\n        mergedCluster.add(key);\n        keyToCluster.set(key, mergedCluster);\n      }\n    }\n  }\n\n  // Deduplicate cluster sets.\n  const seenClusters = new Set<Set<string>>();\n  const rawClusters: Set<string>[] = [];\n  for (const cluster of keyToCluster.values()) {\n    if (!seenClusters.has(cluster) && cluster.size >= 2) {\n      seenClusters.add(cluster);\n      rawClusters.push(cluster);\n    }\n  }\n\n  // Score each cluster.\n  const scoredClusters: PatternCluster[] = [];\n  for (const clusterKeys of rawClusters) {\n    const members: DreamingStoreEntry[] = [];\n    for (const key of clusterKeys) {\n      const entry = keyToEntry.get(key);\n      if (entry) members.push(entry);\n    }\n    if (members.length < 2) continue;\n\n    // Shared queries: hashes that appear in 2+ members.\n    const hashCounts = new Map<string, number>();\n    for (const member of members) {\n      for (const hash of member.queryHashes ?? []) {\n        hashCounts.set(hash, (hashCounts.get(hash) ?? 0) + 1);\n      }\n    }\n    const sharedQueries = [...hashCounts.entries()]\n      .filter(([, count]) => count >= 2)\n      .map(([hash]) => hash);\n\n    const allUniqueHashes = new Set<string>();\n    for (const member of members) {\n      for (const hash of member.queryHashes ?? []) allUniqueHashes.add(hash);\n    }\n\n    const strength = allUniqueHashes.size > 0 ? sharedQueries.length / allUniqueHashes.size : 0;\n    if (strength < minStrength) continue;\n\n    const distinctPaths = [...new Set(members.map((m) => m.path))];\n\n    // Representative: the member with the highest totalSignalCount.\n    const representative = members.reduce((best, current) =>\n      (current.totalSignalCount ?? 0) > (best.totalSignalCount ?? 0) ? current : best,\n    );\n\n    scoredClusters.push({\n      representative,\n      members,\n      strength,\n      sharedQueries,\n      distinctPaths,\n    });\n  }\n\n  // Sort by strength descending, then by member count.\n  scoredClusters.sort((a, b) => {\n    if (b.strength !== a.strength) return b.strength - a.strength;\n    return b.members.length - a.members.length;\n  });\n\n  return scoredClusters;\n}\n\n// ── DREAMS.md writer ───────────────────────────────────────────────────\n\nasync function appendPatternSummary(\n  workspaceDir: string,\n  clusters: PatternCluster[],\n  now: Date,\n): Promise<void> {\n  const dreamsPath = path.join(workspaceDir, DREAMS_MD_FILENAME);\n  const existing = await fs.readFile(dreamsPath, 'utf-8').catch((err: unknown) => {\n    if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return '';\n    throw err;\n  });\n\n  const day = isoDay(now);\n  const lines: string[] = [];\n\n  if (existing.trim().length === 0) {\n    lines.push('# Dream Diary', '');\n  }\n\n  lines.push(`## REM Pattern Discovery — ${day}`, '');\n  lines.push(`*${now.toISOString()}*`, '');\n\n  for (let i = 0; i < clusters.length; i++) {\n    const cluster = clusters[i]!;\n    lines.push(\n      `### Pattern ${i + 1}: ${cluster.distinctPaths.length} files, strength=${cluster.strength.toFixed(2)}`,\n    );\n    lines.push('');\n    lines.push(`**Files involved:** ${cluster.distinctPaths.join(', ')}`);\n    lines.push(`**Shared query themes:** ${cluster.sharedQueries.length} overlapping queries`);\n    lines.push(`**Members:** ${cluster.members.length} snippets`);\n    lines.push('');\n    // Include the representative snippet.\n    const rep = cluster.representative;\n    lines.push(`> ${rep.snippet?.slice(0, 200) ?? '(no snippet)'}`);\n    lines.push(`> — ${rep.path}:${rep.startLine}-${rep.endLine}`);\n    lines.push('');\n  }\n\n  lines.push('---', '');\n\n  const separator = existing.trim().length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  const next = `${existing}${separator}${lines.join('\\n')}`;\n  await fs.writeFile(dreamsPath, next, 'utf-8');\n}\n\n// ── Last-run writer ────────────────────────────────────────────────────\n\nasync function writeLastRun(\n  workspaceDir: string,\n  params: {\n    runId: string;\n    startedAt: string;\n    cfg: DreamingRemConfig;\n    ok: boolean;\n    reason: string;\n    startMs: number;\n    rem: DreamingRemLastRun['rem'];\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: DreamingRemLastRun = {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'rem',\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    rem: params.rem,\n    ...(params.errorMessage ? { errorMessage: params.errorMessage } : {}),\n  };\n\n  const lastRunPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE, 'last-run-rem.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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"}
+{"version":3,"file":"rem-patterns.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/rem-patterns.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { DREAMING_DIR_RELATIVE, DREAMS_MD_FILENAME, MS_PER_DAY } from './constants.js';\nimport type { DreamingRemConfig } from './config.js';\nimport {\n  bumpEntryPhaseSignal,\n  loadDreamingStore,\n  saveDreamingStore,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport { isoDay } from './utils.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  type DreamingRemLastRun,\n} from './last-run.js';\n\nconst log = createLogger('Dreaming:REM');\n\n// ── Pattern types ──────────────────────────────────────────────────────\n\ntype PatternCluster = {\n  representative: DreamingStoreEntry;\n  members: DreamingStoreEntry[];\n  strength: number;\n  /** Shared query hashes across members. */\n  sharedQueries: string[];\n  /** Distinct source files involved. */\n  distinctPaths: string[];\n};\n\n// ── Config defaults ────────────────────────────────────────────────────\n\nfunction resolveConfig(overrides?: Partial<DreamingRemConfig>): DreamingRemConfig {\n  return {\n    enabled: overrides?.enabled === true,\n    cron: typeof overrides?.cron === 'string' ? overrides.cron : '0 5 * * 0',\n    lookbackDays: Math.max(1, Math.floor(Number(overrides?.lookbackDays) || 7)),\n    limit: Math.max(0, Math.floor(Number(overrides?.limit) || 10)),\n    minPatternStrength: Math.max(0, Math.min(1, Number(overrides?.minPatternStrength) || 0.75)),\n  };\n}\n\n// ── Core REM pattern discovery ─────────────────────────────────────────\n\n/**\n * REM phase: cross-session pattern discovery.\n *\n * Scans the short-term store for entries that share query hashes or\n * appear across multiple indexed memory sources, then clusters them to identify\n * recurring themes/patterns. Bumps `remHits` on touched entries and\n * optionally writes a pattern summary to DREAMS.md.\n *\n * Runs weekly; expensive but insightful.\n */\nexport async function runRemPatterns(params: {\n  dreamingRoot: string;\n  config?: Partial<DreamingRemConfig>;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  patternsDiscovered: number;\n  entriesAnalyzed: number;\n}> {\n  const cfg = resolveConfig(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `rem:${startedAt}:${process.pid}`;\n  const startMs = Date.now();\n  const nowMs = now.getTime();\n\n  if (!cfg.enabled) {\n    await writeLastRun(params.dreamingRoot, {\n      runId, startedAt, cfg, ok: true, reason: 'REM patterns disabled', startMs,\n      rem: { patternsDiscovered: 0, entriesAnalyzed: 0 },\n    });\n    return { ok: true, reason: 'REM patterns disabled', patternsDiscovered: 0, entriesAnalyzed: 0 };\n  }\n\n  try {\n    const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });\n\n    // Filter entries within the lookback window.\n    const cutoffMs = nowMs - cfg.lookbackDays * MS_PER_DAY;\n    const recentEntries = Object.values(store.entries ?? {}).filter(\n      (entry): entry is DreamingStoreEntry => {\n        if (!entry || typeof entry !== 'object') return false;\n        if (!entry.lastRecalledAt) return false;\n        const lastMs = Date.parse(entry.lastRecalledAt);\n        return Number.isFinite(lastMs) && lastMs >= cutoffMs;\n      },\n    );\n\n    if (recentEntries.length < 2) {\n      await writeLastRun(params.dreamingRoot, {\n        runId, startedAt, cfg, ok: true, reason: 'not enough recent entries for pattern analysis', startMs,\n        rem: { patternsDiscovered: 0, entriesAnalyzed: recentEntries.length },\n      });\n      return {\n        ok: true,\n        reason: 'not enough recent entries for pattern analysis',\n        patternsDiscovered: 0,\n        entriesAnalyzed: recentEntries.length,\n      };\n    }\n\n    // Discover patterns by clustering entries that share query hashes.\n    const clusters = discoverPatternClusters(recentEntries, cfg.minPatternStrength);\n    const topClusters = clusters.slice(0, cfg.limit);\n\n    // Bump remHits on all entries that belong to a discovered pattern.\n    const touchedKeys = new Set<string>();\n    for (const cluster of topClusters) {\n      for (const member of cluster.members) {\n        if (!touchedKeys.has(member.key)) {\n          touchedKeys.add(member.key);\n          const storeEntry = store.entries[member.key];\n          if (storeEntry) {\n            bumpEntryPhaseSignal(storeEntry, 'remHits');\n          }\n        }\n      }\n    }\n\n    store.updatedAt = now.toISOString();\n    await saveDreamingStore({ dreamingRoot: params.dreamingRoot, store });\n\n    // Write pattern summary to DREAMS.md (append).\n    if (topClusters.length > 0) {\n      await appendPatternSummary(params.dreamingRoot, topClusters, now);\n    }\n\n    log.info(\n      {\n        dreamingRoot: params.dreamingRoot,\n        patterns: topClusters.length,\n        entriesAnalyzed: recentEntries.length,\n        touched: touchedKeys.size,\n      },\n      'REM pattern discovery complete',\n    );\n\n    await writeLastRun(params.dreamingRoot, {\n      runId, startedAt, cfg, ok: true, reason: 'REM patterns complete', startMs,\n      rem: { patternsDiscovered: topClusters.length, entriesAnalyzed: recentEntries.length },\n    });\n\n    return {\n      ok: true,\n      reason: 'REM patterns complete',\n      patternsDiscovered: topClusters.length,\n      entriesAnalyzed: recentEntries.length,\n    };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    log.error({ err, errorMessage, dreamingRoot: params.dreamingRoot }, `REM pattern discovery failed: ${errorMessage}`);\n    await writeLastRun(params.dreamingRoot, {\n      runId, startedAt, cfg, ok: false, reason: `REM error: ${errorMessage}`, startMs,\n      rem: { patternsDiscovered: 0, entriesAnalyzed: 0 }, errorMessage,\n    }).catch(() => undefined);\n    return { ok: false, reason: errorMessage, patternsDiscovered: 0, entriesAnalyzed: 0 };\n  }\n}\n\n// ── Pattern clustering ─────────────────────────────────────────────────\n\n/**\n * Build an inverted index of queryHash → entries, then form clusters\n * where multiple entries share overlapping query hashes. Each cluster's\n * \"strength\" is the ratio of shared queries to total unique queries.\n */\nfunction discoverPatternClusters(\n  entries: DreamingStoreEntry[],\n  minStrength: number,\n): PatternCluster[] {\n  // Build inverted index: queryHash → entry keys.\n  const hashToEntries = new Map<string, DreamingStoreEntry[]>();\n  for (const entry of entries) {\n    for (const queryHash of entry.queryHashes ?? []) {\n      const group = hashToEntries.get(queryHash);\n      if (group) {\n        group.push(entry);\n      } else {\n        hashToEntries.set(queryHash, [entry]);\n      }\n    }\n  }\n\n  // Find query hashes that appear in 2+ distinct entries from different paths.\n  const significantHashes: Array<{ hash: string; entries: DreamingStoreEntry[] }> = [];\n  for (const [hash, group] of hashToEntries) {\n    const uniquePaths = new Set(group.map((e) => e.path));\n    if (group.length >= 2 && uniquePaths.size >= 2) {\n      significantHashes.push({ hash, entries: group });\n    }\n  }\n\n  if (significantHashes.length === 0) return [];\n\n  // Merge overlapping groups into clusters using union-find.\n  const keyToCluster = new Map<string, Set<string>>();\n  const keyToEntry = new Map<string, DreamingStoreEntry>();\n\n  for (const entry of entries) {\n    keyToEntry.set(entry.key, entry);\n  }\n\n  for (const { entries: groupEntries } of significantHashes) {\n    const keys = groupEntries.map((e) => e.key);\n    // Find or create the cluster for the first key.\n    let mergedCluster = keyToCluster.get(keys[0]!);\n    if (!mergedCluster) {\n      mergedCluster = new Set<string>();\n      mergedCluster.add(keys[0]!);\n      keyToCluster.set(keys[0]!, mergedCluster);\n    }\n    // Merge all other keys into this cluster.\n    for (const key of keys.slice(1)) {\n      const existingCluster = keyToCluster.get(key);\n      if (existingCluster && existingCluster !== mergedCluster) {\n        for (const existingKey of existingCluster) {\n          mergedCluster.add(existingKey);\n          keyToCluster.set(existingKey, mergedCluster);\n        }\n      } else {\n        mergedCluster.add(key);\n        keyToCluster.set(key, mergedCluster);\n      }\n    }\n  }\n\n  // Deduplicate cluster sets.\n  const seenClusters = new Set<Set<string>>();\n  const rawClusters: Set<string>[] = [];\n  for (const cluster of keyToCluster.values()) {\n    if (!seenClusters.has(cluster) && cluster.size >= 2) {\n      seenClusters.add(cluster);\n      rawClusters.push(cluster);\n    }\n  }\n\n  // Score each cluster.\n  const scoredClusters: PatternCluster[] = [];\n  for (const clusterKeys of rawClusters) {\n    const members: DreamingStoreEntry[] = [];\n    for (const key of clusterKeys) {\n      const entry = keyToEntry.get(key);\n      if (entry) members.push(entry);\n    }\n    if (members.length < 2) continue;\n\n    // Shared queries: hashes that appear in 2+ members.\n    const hashCounts = new Map<string, number>();\n    for (const member of members) {\n      for (const hash of member.queryHashes ?? []) {\n        hashCounts.set(hash, (hashCounts.get(hash) ?? 0) + 1);\n      }\n    }\n    const sharedQueries = [...hashCounts.entries()]\n      .filter(([, count]) => count >= 2)\n      .map(([hash]) => hash);\n\n    const allUniqueHashes = new Set<string>();\n    for (const member of members) {\n      for (const hash of member.queryHashes ?? []) allUniqueHashes.add(hash);\n    }\n\n    const strength = allUniqueHashes.size > 0 ? sharedQueries.length / allUniqueHashes.size : 0;\n    if (strength < minStrength) continue;\n\n    const distinctPaths = [...new Set(members.map((m) => m.path))];\n\n    // Representative: the member with the highest totalSignalCount.\n    const representative = members.reduce((best, current) =>\n      (current.totalSignalCount ?? 0) > (best.totalSignalCount ?? 0) ? current : best,\n    );\n\n    scoredClusters.push({\n      representative,\n      members,\n      strength,\n      sharedQueries,\n      distinctPaths,\n    });\n  }\n\n  // Sort by strength descending, then by member count.\n  scoredClusters.sort((a, b) => {\n    if (b.strength !== a.strength) return b.strength - a.strength;\n    return b.members.length - a.members.length;\n  });\n\n  return scoredClusters;\n}\n\n// ── DREAMS.md writer ───────────────────────────────────────────────────\n\nasync function appendPatternSummary(\n  dreamingRoot: string,\n  clusters: PatternCluster[],\n  now: Date,\n): Promise<void> {\n  const dreamsPath = path.join(dreamingRoot, DREAMS_MD_FILENAME);\n  const existing = await fs.readFile(dreamsPath, 'utf-8').catch((err: unknown) => {\n    if ((err as NodeJS.ErrnoException)?.code === 'ENOENT') return '';\n    throw err;\n  });\n\n  const day = isoDay(now);\n  const lines: string[] = [];\n\n  if (existing.trim().length === 0) {\n    lines.push('# Dream Diary', '');\n  }\n\n  lines.push(`## REM Pattern Discovery — ${day}`, '');\n  lines.push(`*${now.toISOString()}*`, '');\n\n  for (let i = 0; i < clusters.length; i++) {\n    const cluster = clusters[i]!;\n    lines.push(\n      `### Pattern ${i + 1}: ${cluster.distinctPaths.length} files, strength=${cluster.strength.toFixed(2)}`,\n    );\n    lines.push('');\n    lines.push(`**Files involved:** ${cluster.distinctPaths.join(', ')}`);\n    lines.push(`**Shared query themes:** ${cluster.sharedQueries.length} overlapping queries`);\n    lines.push(`**Members:** ${cluster.members.length} snippets`);\n    lines.push('');\n    // Include the representative snippet.\n    const rep = cluster.representative;\n    lines.push(`> ${rep.snippet?.slice(0, 200) ?? '(no snippet)'}`);\n    lines.push(`> — ${rep.path}:${rep.startLine}-${rep.endLine}`);\n    lines.push('');\n  }\n\n  lines.push('---', '');\n\n  const separator = existing.trim().length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  const next = `${existing}${separator}${lines.join('\\n')}`;\n  await fs.writeFile(dreamsPath, next, 'utf-8');\n}\n\n// ── Last-run writer ────────────────────────────────────────────────────\n\nasync function writeLastRun(\n  dreamingRoot: string,\n  params: {\n    runId: string;\n    startedAt: string;\n    cfg: DreamingRemConfig;\n    ok: boolean;\n    reason: string;\n    startMs: number;\n    rem: DreamingRemLastRun['rem'];\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: DreamingRemLastRun = {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'rem',\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    rem: params.rem,\n    ...(params.errorMessage ? { errorMessage: params.errorMessage } : {}),\n  };\n\n  const lastRunPath = path.join(dreamingRoot, DREAMING_DIR_RELATIVE, 'last-run-rem.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/scope.d.ts

@@ -0,0 +1,14 @@
+import type { Config } from '../../../config/schema.js';
+import { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';
+import type { DreamingResolvedConfig } from './config.js';
+export type DreamingAgentScope = {
+    agentId: string;
+    workspaceDir: string;
+    memoriesDir: string;
+    memoryPath: string;
+    dreamsPath: string;
+    config: DreamingResolvedConfig;
+    memory: ReturnType<typeof resolveEffectiveAgentManifestForAgent>['memory'];
+};
+export declare function resolveDreamingRootForAgent(config: Config, agentId: string): string;
+export declare function resolveDreamingAgentScope(config: Config, requestedAgentId?: string | null): DreamingAgentScope;

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

@@ -0,0 +1,27 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentHomeDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../agent-scope.js";
+import { resolveEffectiveAgentManifestForAgent } from "../../../config/agent-profile.js";
+import { resolveDreamingConfig } from "./config.js";
+import path from "node:path";
+//#region src/agent/memory/dreaming/scope.ts
+init_agent_scope();
+function resolveDreamingRootForAgent(config, agentId) {
+	return path.join(resolveAgentHomeDir(config, agentId), "memories");
+}
+function resolveDreamingAgentScope(config, requestedAgentId) {
+	const agentId = normalizeAgentId(requestedAgentId || resolveDefaultAgentId(config));
+	const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);
+	const memoriesDir = resolveDreamingRootForAgent(config, agentId);
+	return {
+		agentId,
+		workspaceDir: resolveAgentWorkspaceDir(config, agentId),
+		memoriesDir,
+		memoryPath: path.join(memoriesDir, "MEMORY.md"),
+		dreamsPath: path.join(memoriesDir, "DREAMS.md"),
+		config: resolveDreamingConfig(config, agentId),
+		memory: manifest.memory
+	};
+}
+//#endregion
+export { resolveDreamingAgentScope, resolveDreamingRootForAgent };
+
+//# sourceMappingURL=scope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/scope.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Config } from '../../../config/schema.js';\nimport {\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n} from '../../agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport type { DreamingResolvedConfig } from './config.js';\nimport { resolveDreamingConfig } from './config.js';\n\nexport type DreamingAgentScope = {\n  agentId: string;\n  workspaceDir: string;\n  memoriesDir: string;\n  memoryPath: string;\n  dreamsPath: string;\n  config: DreamingResolvedConfig;\n  memory: ReturnType<typeof resolveEffectiveAgentManifestForAgent>['memory'];\n};\n\nexport function resolveDreamingRootForAgent(config: Config, agentId: string): string {\n  return path.join(resolveAgentHomeDir(config, agentId), 'memories');\n}\n\nexport function resolveDreamingAgentScope(config: Config, requestedAgentId?: string | null): DreamingAgentScope {\n  const agentId = normalizeAgentId(requestedAgentId || resolveDefaultAgentId(config));\n  const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);\n  const memoriesDir = resolveDreamingRootForAgent(config, agentId);\n  return {\n    agentId,\n    workspaceDir: resolveAgentWorkspaceDir(config, agentId),\n    memoriesDir,\n    memoryPath: path.join(memoriesDir, 'MEMORY.md'),\n    dreamsPath: path.join(memoriesDir, 'DREAMS.md'),\n    config: resolveDreamingConfig(config, agentId),\n    memory: manifest.memory,\n  };\n}\n"],"mappings":";;;;;kBAQ8B;AAe9B,SAAgB,4BAA4B,QAAgB,SAAyB;AACnF,QAAO,KAAK,KAAK,oBAAoB,QAAQ,QAAQ,EAAE,WAAW;;AAGpE,SAAgB,0BAA0B,QAAgB,kBAAsD;CAC9G,MAAM,UAAU,iBAAiB,oBAAoB,sBAAsB,OAAO,CAAC;CACnF,MAAM,WAAW,sCAAsC,QAAQ,QAAQ;CACvE,MAAM,cAAc,4BAA4B,QAAQ,QAAQ;AAChE,QAAO;EACL;EACA,cAAc,yBAAyB,QAAQ,QAAQ;EACvD;EACA,YAAY,KAAK,KAAK,aAAa,YAAY;EAC/C,YAAY,KAAK,KAAK,aAAa,YAAY;EAC/C,QAAQ,sBAAsB,QAAQ,QAAQ;EAC9C,QAAQ,SAAS;EAClB"}

package/dist/src/agent/memory/dreaming/short-term-store.d.ts

@@ -34,7 +34,7 @@ export type DreamingStore = {
 };
 type MemoryMatch = Awaited<ReturnType<typeof import('../../prompt/memory/index.js').memorySearch>>[number];
 export declare function recordDreamingRecalls(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
     query: string;
     matches: MemoryMatch[];
     options?: MemorySearchOptions;
@@ -44,15 +44,15 @@ export declare function recordDreamingRecalls(params: {
     skipped: number;
     storePath: string;
 }>;
-export declare function withDreamingPromotionLock<T>(workspaceDir: string, task: () => Promise<T>): Promise<T>;
+export declare function withDreamingPromotionLock<T>(dreamingRoot: string, task: () => Promise<T>): Promise<T>;
 export declare function loadDreamingStore(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
 }): Promise<{
     store: DreamingStore;
     storePath: string;
 }>;
 export declare function saveDreamingStore(params: {
-    workspaceDir: string;
+    dreamingRoot: string;
     store: DreamingStore;
 }): Promise<void>;
 type PhaseSignalField = 'sourceCount' | 'groundedCount' | 'lightHits' | 'remHits';

package/dist/src/agent/memory/dreaming/short-term-store.js

@@ -31,13 +31,13 @@ function emptyStore(nowIso) {
 		entries: {}
 	};
 }
-async function ensureDreamDir(workspaceDir) {
-	const dir = path.join(workspaceDir, path.dirname(SHORT_TERM_RECALL_STORE_RELATIVE));
+async function ensureDreamDir(dreamingRoot) {
+	const dir = path.join(dreamingRoot, path.dirname(SHORT_TERM_RECALL_STORE_RELATIVE));
 	await fs.mkdir(dir, { recursive: true });
 	return dir;
 }
-async function readStore(workspaceDir, nowIso) {
-	const storePath = path.join(workspaceDir, SHORT_TERM_RECALL_STORE_RELATIVE);
+async function readStore(dreamingRoot, nowIso) {
+	const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);
 	try {
 		const raw = await fs.readFile(storePath, "utf-8");
 		const parsed = JSON.parse(raw);
@@ -53,22 +53,22 @@ async function readStore(workspaceDir, nowIso) {
 		if (err?.code === "ENOENT") return emptyStore(nowIso);
 		log.warn({
 			err,
-			workspaceDir
+			dreamingRoot
 		}, "Failed to read dreaming store; resetting");
 		return emptyStore(nowIso);
 	}
 }
-async function writeStore(workspaceDir, store) {
-	await ensureDreamDir(workspaceDir);
-	const storePath = path.join(workspaceDir, SHORT_TERM_RECALL_STORE_RELATIVE);
+async function writeStore(dreamingRoot, store) {
+	await ensureDreamDir(dreamingRoot);
+	const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);
 	const tmp = `${storePath}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;
 	await fs.writeFile(tmp, `${JSON.stringify(store, null, 2)}\n`, "utf-8");
 	await fs.rename(tmp, storePath);
 }
 async function recordDreamingRecalls(params) {
-	const workspaceDir = params.workspaceDir.trim();
+	const dreamingRoot = params.dreamingRoot.trim();
 	const query = params.query.trim();
-	if (!workspaceDir || !query) return {
+	if (!dreamingRoot || !query) return {
 		recorded: 0,
 		skipped: params.matches.length,
 		storePath: SHORT_TERM_RECALL_STORE_RELATIVE
@@ -77,7 +77,7 @@ async function recordDreamingRecalls(params) {
 	const nowIso = now.toISOString();
 	const dayBucket = isoDay(now);
 	const qHash = hashQuery(query);
-	const store = await readStore(workspaceDir, nowIso);
+	const store = await readStore(dreamingRoot, nowIso);
 	let recorded = 0;
 	let skipped = 0;
 	for (const match of params.matches) {
@@ -142,7 +142,7 @@ async function recordDreamingRecalls(params) {
 	}
 	if (recorded > 0) {
 		store.updatedAt = nowIso;
-		await writeStore(workspaceDir, store);
+		await writeStore(dreamingRoot, store);
 	}
 	return {
 		recorded,
@@ -150,9 +150,9 @@ async function recordDreamingRecalls(params) {
 		storePath: SHORT_TERM_RECALL_STORE_RELATIVE
 	};
 }
-async function withDreamingPromotionLock(workspaceDir, task) {
-	const lockPath = path.join(workspaceDir, SHORT_TERM_PROMOTION_LOCK_RELATIVE);
-	await ensureDreamDir(workspaceDir);
+async function withDreamingPromotionLock(dreamingRoot, task) {
+	const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);
+	await ensureDreamDir(dreamingRoot);
 	const startedAt = Date.now();
 	const timeoutMs = 1e4;
 	const retryDelayMs = 50;
@@ -174,12 +174,12 @@ async function withDreamingPromotionLock(workspaceDir, task) {
 async function loadDreamingStore(params) {
 	const nowIso = (/* @__PURE__ */ new Date()).toISOString();
 	return {
-		store: await readStore(params.workspaceDir, nowIso),
+		store: await readStore(params.dreamingRoot, nowIso),
 		storePath: SHORT_TERM_RECALL_STORE_RELATIVE
 	};
 }
 async function saveDreamingStore(params) {
-	await writeStore(params.workspaceDir, params.store);
+	await writeStore(params.dreamingRoot, params.store);
 }
 /**
 * Increment a phase-specific signal counter on an existing store entry.