@xopcai/xopc 0.0.123 → 0.0.125

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport { resolveDefaultAgentId } from '../../agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_LIGHT_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DEFAULT_REM_CRON,\n  type DreamingPhaseId,\n} from './constants.js';\n\n// ── Phase config types ─────────────────────────────────────────────────\n\nexport type DreamingLightConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  dedupeSimilarity: number;\n};\n\nexport type DreamingDeepConfig = {\n  enabled: boolean;\n  cron: string;\n  minScore: number;\n  minRecallCount: number;\n  minUniqueQueries: number;\n  limit: number;\n  recencyHalfLifeDays: number;\n  maxAgeDays: number;\n};\n\nexport type DreamingRemConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  minPatternStrength: number;\n};\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  phases: {\n    light: DreamingLightConfig;\n    deep: DreamingDeepConfig;\n    rem: DreamingRemConfig;\n  };\n  deep: DreamingDeepConfig;\n};\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction trimmedStringOr(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\nfunction optionalTrimmedString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\n// ── Resolver ───────────────────────────────────────────────────────────\n\n/** Resolve the full three-phase dreaming config from the default agent manifest. */\nexport function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig {\n  const agentId = cfg ? resolveDefaultAgentId(cfg) : undefined;\n  const manifest = cfg && agentId ? resolveEffectiveAgentManifestForAgent(cfg, agentId) : undefined;\n  const dreaming = manifest?.memory.dreaming;\n  const enabled = dreaming?.enabled === true && manifest?.memory.mode !== 'off';\n\n  const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);\n  const timezone = optionalTrimmedString(dreaming?.timezone);\n\n  // ── Light phase ────────────────────────────────────────────────────\n  const lightRaw = dreaming?.phases?.light ?? {};\n  const light: DreamingLightConfig = {\n    enabled: enabled && lightRaw?.enabled !== false,\n    cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),\n    lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),\n    limit: toNonNegInt(lightRaw?.limit, 100),\n    dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), 0.9),\n  };\n\n  // ── Deep phase ─────────────────────────────────────────────────────\n  const deepRaw = dreaming?.phases?.deep ?? {};\n  const deep: DreamingDeepConfig = {\n    enabled: enabled && deepRaw?.enabled !== false,\n    cron: trimmedStringOr(deepRaw?.cron, frequency),\n    minScore: clampScore(Number(deepRaw?.minScore), 0.8),\n    minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),\n    limit: toNonNegInt(deepRaw?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n\n  // ── REM phase ──────────────────────────────────────────────────────\n  const remRaw = dreaming?.phases?.rem ?? {};\n  const rem: DreamingRemConfig = {\n    enabled: enabled && remRaw?.enabled !== false,\n    cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),\n    lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),\n    limit: toNonNegInt(remRaw?.limit, 10),\n    minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), 0.75),\n  };\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    phases: { light, deep, rem },\n    deep,\n  };\n}\n\n/** Get the cron expression for a specific phase from resolved config. */\nexport function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string {\n  return config.phases[phase].cron;\n}\n\n/** Check if a specific phase is enabled (global + phase-level). */\nexport function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean {\n  return config.enabled && config.phases[phase].enabled;\n}\n"],"mappings":";;;;kBAC6D;AAsD7D,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,gBAAgB,OAAgB,UAA0B;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;AAGpE,SAAS,sBAAsB,OAAoC;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;;AAMpE,SAAgB,sBAAsB,KAAiD;CACrF,MAAM,UAAU,MAAM,sBAAsB,IAAI,GAAG,KAAA;CACnD,MAAM,WAAW,OAAO,UAAU,sCAAsC,KAAK,QAAQ,GAAG,KAAA;CACxF,MAAM,WAAW,UAAU,OAAO;CAClC,MAAM,UAAU,UAAU,YAAY,QAAQ,UAAU,OAAO,SAAS;CAExE,MAAM,YAAY,gBAAgB,UAAU,WAAW,kBAAkB;CACzE,MAAM,WAAW,sBAAsB,UAAU,SAAS;CAG1D,MAAM,WAAW,UAAU,QAAQ,SAAS,EAAE;CAC9C,MAAM,QAA6B;EACjC,SAAS,WAAW,UAAU,YAAY;EAC1C,MAAM,gBAAgB,UAAU,MAAM,mBAAmB;EACzD,cAAc,cAAc,UAAU,cAAc,EAAE;EACtD,OAAO,YAAY,UAAU,OAAO,IAAI;EACxC,kBAAkB,WAAW,OAAO,UAAU,iBAAiB,EAAE,GAAI;EACtE;CAGD,MAAM,UAAU,UAAU,QAAQ,QAAQ,EAAE;CAC5C,MAAM,OAA2B;EAC/B,SAAS,WAAW,SAAS,YAAY;EACzC,MAAM,gBAAgB,SAAS,MAAM,UAAU;EAC/C,UAAU,WAAW,OAAO,SAAS,SAAS,EAAE,GAAI;EACpD,gBAAgB,cAAc,SAAS,gBAAgB,EAAE;EACzD,kBAAkB,cAAc,SAAS,kBAAkB,EAAE;EAC7D,OAAO,YAAY,SAAS,OAAO,GAAG;EACtC,qBAAqB,cAAc,SAAS,qBAAA,GAAoD;EAChG,YAAY,cAAc,SAAS,YAAA,GAAiC;EACrE;CAGD,MAAM,SAAS,UAAU,QAAQ,OAAO,EAAE;CAC1C,MAAM,MAAyB;EAC7B,SAAS,WAAW,QAAQ,YAAY;EACxC,MAAM,gBAAgB,QAAQ,MAAM,iBAAiB;EACrD,cAAc,cAAc,QAAQ,cAAc,EAAE;EACpD,OAAO,YAAY,QAAQ,OAAO,GAAG;EACrC,oBAAoB,WAAW,OAAO,QAAQ,mBAAmB,EAAE,IAAK;EACzE;AAED,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,QAAQ;GAAE;GAAO;GAAM;GAAK;EAC5B;EACD;;;AAIH,SAAgB,aAAa,QAAgC,OAAgC;AAC3F,QAAO,OAAO,OAAO,OAAO;;;AAI9B,SAAgB,eAAe,QAAgC,OAAiC;AAC9F,QAAO,OAAO,WAAW,OAAO,OAAO,OAAO"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport { resolveDefaultAgentId } from '../../agent-scope.js';\nimport { resolveEffectiveAgentManifestForAgent } from '../../../config/agent-profile.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_LIGHT_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DEFAULT_REM_CRON,\n  type DreamingPhaseId,\n} from './constants.js';\n\n// ── Phase config types ─────────────────────────────────────────────────\n\nexport type DreamingLightConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  dedupeSimilarity: number;\n};\n\nexport type DreamingDeepConfig = {\n  enabled: boolean;\n  cron: string;\n  minScore: number;\n  minRecallCount: number;\n  minUniqueQueries: number;\n  limit: number;\n  recencyHalfLifeDays: number;\n  maxAgeDays: number;\n};\n\nexport type DreamingRemConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  minPatternStrength: number;\n};\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  phases: {\n    light: DreamingLightConfig;\n    deep: DreamingDeepConfig;\n    rem: DreamingRemConfig;\n  };\n  deep: DreamingDeepConfig;\n};\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction trimmedStringOr(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\nfunction optionalTrimmedString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\n// ── Resolver ───────────────────────────────────────────────────────────\n\n/** Resolve the full three-phase dreaming config from an agent manifest. */\nexport function resolveDreamingConfig(cfg: Config | undefined, requestedAgentId?: string | null): DreamingResolvedConfig {\n  const agentId = cfg ? (requestedAgentId?.trim() || resolveDefaultAgentId(cfg)) : undefined;\n  const manifest = cfg && agentId ? resolveEffectiveAgentManifestForAgent(cfg, agentId) : undefined;\n  const dreaming = manifest?.memory.dreaming;\n  const enabled = dreaming?.enabled === true && manifest?.memory.mode !== 'off';\n\n  const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);\n  const timezone = optionalTrimmedString(dreaming?.timezone);\n\n  // ── Light phase ────────────────────────────────────────────────────\n  const lightRaw = dreaming?.phases?.light ?? {};\n  const light: DreamingLightConfig = {\n    enabled: enabled && lightRaw?.enabled !== false,\n    cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),\n    lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),\n    limit: toNonNegInt(lightRaw?.limit, 100),\n    dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), 0.9),\n  };\n\n  // ── Deep phase ─────────────────────────────────────────────────────\n  const deepRaw = dreaming?.phases?.deep ?? {};\n  const deep: DreamingDeepConfig = {\n    enabled: enabled && deepRaw?.enabled !== false,\n    cron: trimmedStringOr(deepRaw?.cron, frequency),\n    minScore: clampScore(Number(deepRaw?.minScore), 0.8),\n    minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),\n    limit: toNonNegInt(deepRaw?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n\n  // ── REM phase ──────────────────────────────────────────────────────\n  const remRaw = dreaming?.phases?.rem ?? {};\n  const rem: DreamingRemConfig = {\n    enabled: enabled && remRaw?.enabled !== false,\n    cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),\n    lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),\n    limit: toNonNegInt(remRaw?.limit, 10),\n    minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), 0.75),\n  };\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    phases: { light, deep, rem },\n    deep,\n  };\n}\n\n/** Get the cron expression for a specific phase from resolved config. */\nexport function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string {\n  return config.phases[phase].cron;\n}\n\n/** Check if a specific phase is enabled (global + phase-level). */\nexport function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean {\n  return config.enabled && config.phases[phase].enabled;\n}\n"],"mappings":";;;;kBAC6D;AAsD7D,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,gBAAgB,OAAgB,UAA0B;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;AAGpE,SAAS,sBAAsB,OAAoC;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;;AAMpE,SAAgB,sBAAsB,KAAyB,kBAA0D;CACvH,MAAM,UAAU,MAAO,kBAAkB,MAAM,IAAI,sBAAsB,IAAI,GAAI,KAAA;CACjF,MAAM,WAAW,OAAO,UAAU,sCAAsC,KAAK,QAAQ,GAAG,KAAA;CACxF,MAAM,WAAW,UAAU,OAAO;CAClC,MAAM,UAAU,UAAU,YAAY,QAAQ,UAAU,OAAO,SAAS;CAExE,MAAM,YAAY,gBAAgB,UAAU,WAAW,kBAAkB;CACzE,MAAM,WAAW,sBAAsB,UAAU,SAAS;CAG1D,MAAM,WAAW,UAAU,QAAQ,SAAS,EAAE;CAC9C,MAAM,QAA6B;EACjC,SAAS,WAAW,UAAU,YAAY;EAC1C,MAAM,gBAAgB,UAAU,MAAM,mBAAmB;EACzD,cAAc,cAAc,UAAU,cAAc,EAAE;EACtD,OAAO,YAAY,UAAU,OAAO,IAAI;EACxC,kBAAkB,WAAW,OAAO,UAAU,iBAAiB,EAAE,GAAI;EACtE;CAGD,MAAM,UAAU,UAAU,QAAQ,QAAQ,EAAE;CAC5C,MAAM,OAA2B;EAC/B,SAAS,WAAW,SAAS,YAAY;EACzC,MAAM,gBAAgB,SAAS,MAAM,UAAU;EAC/C,UAAU,WAAW,OAAO,SAAS,SAAS,EAAE,GAAI;EACpD,gBAAgB,cAAc,SAAS,gBAAgB,EAAE;EACzD,kBAAkB,cAAc,SAAS,kBAAkB,EAAE;EAC7D,OAAO,YAAY,SAAS,OAAO,GAAG;EACtC,qBAAqB,cAAc,SAAS,qBAAA,GAAoD;EAChG,YAAY,cAAc,SAAS,YAAA,GAAiC;EACrE;CAGD,MAAM,SAAS,UAAU,QAAQ,OAAO,EAAE;CAC1C,MAAM,MAAyB;EAC7B,SAAS,WAAW,QAAQ,YAAY;EACxC,MAAM,gBAAgB,QAAQ,MAAM,iBAAiB;EACrD,cAAc,cAAc,QAAQ,cAAc,EAAE;EACpD,OAAO,YAAY,QAAQ,OAAO,GAAG;EACrC,oBAAoB,WAAW,OAAO,QAAQ,mBAAmB,EAAE,IAAK;EACzE;AAED,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,QAAQ;GAAE;GAAO;GAAM;GAAK;EAC5B;EACD;;;AAIH,SAAgB,aAAa,QAAgC,OAAgC;AAC3F,QAAO,OAAO,OAAO,OAAO;;;AAI9B,SAAgB,eAAe,QAAgC,OAAiC;AAC9F,QAAO,OAAO,WAAW,OAAO,OAAO,OAAO"}

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

@@ -20,7 +20,7 @@ export declare const REINFORCEMENT_WEIGHT = 0.12;
 export declare const DIVERSITY_WEIGHT = 0.08;
 /** Number of signal dimensions used for diversity calculation. */
 export declare const DIVERSITY_DIMENSION_COUNT = 4;
-export declare const DREAMING_DIR_RELATIVE: string;
+export declare const DREAMING_DIR_RELATIVE = ".dreams";
 export declare const SHORT_TERM_RECALL_STORE_RELATIVE: string;
 export declare const SHORT_TERM_PROMOTION_LOCK_RELATIVE: string;
 export declare const DREAMING_LAST_RUN_RELATIVE: string;

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

@@ -25,7 +25,7 @@ const REINFORCEMENT_WEIGHT = .12;
 const DIVERSITY_WEIGHT = .08;
 /** Number of signal dimensions used for diversity calculation. */
 const DIVERSITY_DIMENSION_COUNT = 4;
-const DREAMING_DIR_RELATIVE = path.join("memory", ".dreams");
+const DREAMING_DIR_RELATIVE = ".dreams";
 const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "short-term-recall.json");
 const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "short-term-promotion.lock");
 const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "last-run.json");

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/constants.ts"],"sourcesContent":["import path from 'node:path';\n\n// ── Phase identifiers ──────────────────────────────────────────────────\n\nexport type DreamingPhaseId = 'light' | 'deep' | 'rem';\n\nexport const DREAMING_PHASES: readonly DreamingPhaseId[] = ['light', 'deep', 'rem'] as const;\n\n// ── Sweep tokens (used in cron payloads to trigger each phase) ─────────\n\nexport const DREAMING_SWEEP_TOKEN = '__xopc_memory_dreaming_sweep__';\nexport const DREAMING_LIGHT_SWEEP_TOKEN = '__xopc_memory_dreaming_light_sweep__';\nexport const DREAMING_REM_SWEEP_TOKEN = '__xopc_memory_dreaming_rem_sweep__';\n\n// ── Cron job metadata ──────────────────────────────────────────────────\n\nexport const DREAMING_CRON_TAG = '[managed-by=xopc.memory.dreaming]';\n\nexport const DREAMING_CRON_NAME = 'Memory Dreaming - Deep Promotion';\nexport const DREAMING_LIGHT_CRON_NAME = 'Memory Dreaming - Light Sweep';\nexport const DREAMING_REM_CRON_NAME = 'Memory Dreaming - REM Patterns';\n\n// ── Default cron schedules ─────────────────────────────────────────────\n\nexport const DEFAULT_DEEP_CRON = '0 3 * * *';\nexport const DEFAULT_LIGHT_CRON = '0 */6 * * *';\nexport const DEFAULT_REM_CRON = '0 5 * * 0';\n\n// ── Time-decay defaults ────────────────────────────────────────────────\n\nexport const DEFAULT_RECENCY_HALF_LIFE_DAYS = 14;\nexport const DEFAULT_MAX_AGE_DAYS = 30;\n\n// ── Scoring weights ────────────────────────────────────────────────────\n\n/** Milliseconds in one day (used for time-decay calculations). */\nexport const MS_PER_DAY = 86_400_000;\n\n/** Weight applied to recall-count reinforcement (logarithmic boost). */\nexport const REINFORCEMENT_WEIGHT = 0.12;\n\n/** Weight applied to signal-diversity bonus. */\nexport const DIVERSITY_WEIGHT = 0.08;\n\n/** Number of signal dimensions used for diversity calculation. */\nexport const DIVERSITY_DIMENSION_COUNT = 4;\n\n// ── File paths ─────────────────────────────────────────────────────────\n\nexport const DREAMING_DIR_RELATIVE = path.join('memory', '.dreams');\nexport const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'short-term-recall.json');\nexport const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(\n  DREAMING_DIR_RELATIVE,\n  'short-term-promotion.lock',\n);\nexport const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'last-run.json');\nexport const DREAMING_EVENTS_LOG_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'events.jsonl');\n\nexport const MEMORY_MD_FILENAME = 'MEMORY.md';\nexport const DREAMS_MD_FILENAME = 'DREAMS.md';\n\n"],"mappings":";;AAMA,MAAa,kBAA8C;CAAC;CAAS;CAAQ;CAAM;AAInF,MAAa,uBAAuB;AACpC,MAAa,6BAA6B;AAC1C,MAAa,2BAA2B;AAIxC,MAAa,oBAAoB;AAEjC,MAAa,qBAAqB;AAClC,MAAa,2BAA2B;AACxC,MAAa,yBAAyB;AAItC,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAClC,MAAa,mBAAmB;AAIhC,MAAa,iCAAiC;AAC9C,MAAa,uBAAuB;;AAKpC,MAAa,aAAa;;AAG1B,MAAa,uBAAuB;;AAGpC,MAAa,mBAAmB;;AAGhC,MAAa,4BAA4B;AAIzC,MAAa,wBAAwB,KAAK,KAAK,UAAU,UAAU;AACnE,MAAa,mCAAmC,KAAK,KAAK,uBAAuB,yBAAyB;AAC1G,MAAa,qCAAqC,KAAK,KACrD,uBACA,4BACD;AACD,MAAa,6BAA6B,KAAK,KAAK,uBAAuB,gBAAgB;AAC3F,MAAa,+BAA+B,KAAK,KAAK,uBAAuB,eAAe;AAE5F,MAAa,qBAAqB;AAClC,MAAa,qBAAqB"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/constants.ts"],"sourcesContent":["import path from 'node:path';\n\n// ── Phase identifiers ──────────────────────────────────────────────────\n\nexport type DreamingPhaseId = 'light' | 'deep' | 'rem';\n\nexport const DREAMING_PHASES: readonly DreamingPhaseId[] = ['light', 'deep', 'rem'] as const;\n\n// ── Sweep tokens (used in cron payloads to trigger each phase) ─────────\n\nexport const DREAMING_SWEEP_TOKEN = '__xopc_memory_dreaming_sweep__';\nexport const DREAMING_LIGHT_SWEEP_TOKEN = '__xopc_memory_dreaming_light_sweep__';\nexport const DREAMING_REM_SWEEP_TOKEN = '__xopc_memory_dreaming_rem_sweep__';\n\n// ── Cron job metadata ──────────────────────────────────────────────────\n\nexport const DREAMING_CRON_TAG = '[managed-by=xopc.memory.dreaming]';\n\nexport const DREAMING_CRON_NAME = 'Memory Dreaming - Deep Promotion';\nexport const DREAMING_LIGHT_CRON_NAME = 'Memory Dreaming - Light Sweep';\nexport const DREAMING_REM_CRON_NAME = 'Memory Dreaming - REM Patterns';\n\n// ── Default cron schedules ─────────────────────────────────────────────\n\nexport const DEFAULT_DEEP_CRON = '0 3 * * *';\nexport const DEFAULT_LIGHT_CRON = '0 */6 * * *';\nexport const DEFAULT_REM_CRON = '0 5 * * 0';\n\n// ── Time-decay defaults ────────────────────────────────────────────────\n\nexport const DEFAULT_RECENCY_HALF_LIFE_DAYS = 14;\nexport const DEFAULT_MAX_AGE_DAYS = 30;\n\n// ── Scoring weights ────────────────────────────────────────────────────\n\n/** Milliseconds in one day (used for time-decay calculations). */\nexport const MS_PER_DAY = 86_400_000;\n\n/** Weight applied to recall-count reinforcement (logarithmic boost). */\nexport const REINFORCEMENT_WEIGHT = 0.12;\n\n/** Weight applied to signal-diversity bonus. */\nexport const DIVERSITY_WEIGHT = 0.08;\n\n/** Number of signal dimensions used for diversity calculation. */\nexport const DIVERSITY_DIMENSION_COUNT = 4;\n\n// ── File paths ─────────────────────────────────────────────────────────\n\nexport const DREAMING_DIR_RELATIVE = '.dreams';\nexport const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'short-term-recall.json');\nexport const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(\n  DREAMING_DIR_RELATIVE,\n  'short-term-promotion.lock',\n);\nexport const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'last-run.json');\nexport const DREAMING_EVENTS_LOG_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'events.jsonl');\n\nexport const MEMORY_MD_FILENAME = 'MEMORY.md';\nexport const DREAMS_MD_FILENAME = 'DREAMS.md';\n"],"mappings":";;AAMA,MAAa,kBAA8C;CAAC;CAAS;CAAQ;CAAM;AAInF,MAAa,uBAAuB;AACpC,MAAa,6BAA6B;AAC1C,MAAa,2BAA2B;AAIxC,MAAa,oBAAoB;AAEjC,MAAa,qBAAqB;AAClC,MAAa,2BAA2B;AACxC,MAAa,yBAAyB;AAItC,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAClC,MAAa,mBAAmB;AAIhC,MAAa,iCAAiC;AAC9C,MAAa,uBAAuB;;AAKpC,MAAa,aAAa;;AAG1B,MAAa,uBAAuB;;AAGpC,MAAa,mBAAmB;;AAGhC,MAAa,4BAA4B;AAIzC,MAAa,wBAAwB;AACrC,MAAa,mCAAmC,KAAK,KAAK,uBAAuB,yBAAyB;AAC1G,MAAa,qCAAqC,KAAK,KACrD,uBACA,4BACD;AACD,MAAa,6BAA6B,KAAK,KAAK,uBAAuB,gBAAgB;AAC3F,MAAa,+BAA+B,KAAK,KAAK,uBAAuB,eAAe;AAE5F,MAAa,qBAAqB;AAClC,MAAa,qBAAqB"}

package/dist/src/agent/memory/dreaming/deep-promotion.d.ts

@@ -11,6 +11,7 @@ export type DreamingPromotionCandidate = DreamingStoreEntry & {
 };
 export declare function runDreamingDeepPromotion(params: {
     workspaceDir: string;
+    dreamingRoot: string;
     config?: Partial<DreamingDeepConfig>;
     memoryManager?: MemoryManager;
     now?: Date;

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -47,14 +47,14 @@ async function runDreamingDeepPromotion(params) {
 	const now = params.now ?? /* @__PURE__ */ new Date();
 	const startedAt = now.toISOString();
 	const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;
-	const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);
+	const memoryPath = path.join(params.dreamingRoot, MEMORY_MD_FILENAME);
 	const t0 = Date.now();
 	const earlyExitReason = !cfg.enabled ? "dreaming disabled" : cfg.limit === 0 ? "dreaming limit=0" : null;
 	if (earlyExitReason) {
 		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
 		const empty = emptyDeepPhaseSkipped();
 		await writeDreamingDeepLastRun({
-			workspaceDir: params.workspaceDir,
+			dreamingRoot: params.dreamingRoot,
 			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,
@@ -80,8 +80,8 @@ async function runDreamingDeepPromotion(params) {
 		};
 	}
 	try {
-		const result = await withDreamingPromotionLock(params.workspaceDir, async () => {
-			const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+		const result = await withDreamingPromotionLock(params.dreamingRoot, async () => {
+			const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });
 			const nowMs = now.getTime();
 			const ranked = Object.values(store.entries ?? {}).filter((e) => {
 				if (!e || typeof e !== "object") return false;
@@ -155,7 +155,7 @@ async function runDreamingDeepPromotion(params) {
 			}
 			if (appliedCandidates.length === 0) {
 				await saveDreamingStore({
-					workspaceDir: params.workspaceDir,
+					dreamingRoot: params.dreamingRoot,
 					store
 				});
 				return {
@@ -181,23 +181,13 @@ async function runDreamingDeepPromotion(params) {
 			}
 			sectionLines.push("");
 			const next = `${header}${existing.endsWith("\n") || existing.length === 0 ? existing : `${existing}\n`}${sectionLines.join("\n")}`;
+			await fs.mkdir(path.dirname(memoryPath), { recursive: true });
 			await fs.writeFile(memoryPath, next, "utf-8");
 			const nowIso = now.toISOString();
 			for (const c of appliedCandidates) {
-				const writeResult = await params.memoryManager?.write({
-					kind: "derived_insight",
-					content: c.snippet,
-					source: {
-						provider: "dreaming",
-						path: c.path,
-						lineStart: c.startLine,
-						lineEnd: c.endLine
-					},
-					tags: ["dreaming", "promoted"]
-				});
 				params.memoryManager?.recordSignal({
 					source: "dreaming",
-					recordId: writeResult?.record?.id,
+					recordId: `dreaming:${c.key}`,
 					score: c.score,
 					content: c.snippet,
 					metadata: {
@@ -218,11 +208,12 @@ async function runDreamingDeepPromotion(params) {
 			}
 			store.updatedAt = nowIso;
 			await saveDreamingStore({
-				workspaceDir: params.workspaceDir,
+				dreamingRoot: params.dreamingRoot,
 				store
 			});
 			log.info({
 				workspaceDir: params.workspaceDir,
+				dreamingRoot: params.dreamingRoot,
 				candidates: ranked.length,
 				applied: appliedCandidates.length
 			}, "Dreaming deep promotion complete");
@@ -239,7 +230,7 @@ async function runDreamingDeepPromotion(params) {
 		const empty = emptyDeepPhaseSkipped();
 		const resultSkipped = "skipped" in result ? result.skipped : empty;
 		await writeDreamingDeepLastRun({
-			workspaceDir: params.workspaceDir,
+			dreamingRoot: params.dreamingRoot,
 			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,
@@ -268,7 +259,7 @@ async function runDreamingDeepPromotion(params) {
 		const em = err instanceof Error ? err.message : String(err);
 		const z = emptyDeepPhaseSkipped();
 		await writeDreamingDeepLastRun({
-			workspaceDir: params.workspaceDir,
+			dreamingRoot: params.dreamingRoot,
 			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,

package/dist/src/agent/memory/dreaming/deep-promotion.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-promotion.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/deep-promotion.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport {\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingPromotionLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  emptyDeepPhaseSkipped,\n  writeDreamingDeepLastRun,\n  type DreamingDeepLastRun,\n  type DreamingDeepPhaseSkipped,\n} from './last-run.js';\nimport type { DreamingDeepConfig } from './config.js';\nimport type { MemoryManager } from '../manager.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  isoDay,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\nconst log = createLogger('Dreaming:Deep');\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingPromotionCandidate = DreamingStoreEntry & {\n  avgScore: number;\n  /** Time-decay-adjusted final score used for ranking. */\n  score: number;\n  /** Raw recency decay multiplier (0–1). */\n  recencyDecay: number;\n};\n\n\nfunction markerForPromotion(key: string, hash: string): string {\n  // Quote values to allow spaces/colons in key.\n  return `<!-- xopc-memory-promotion key=\"${key}\" hash=\"${hash}\" -->`;\n}\n\n\nasync function rehydrateSnippet(params: {\n  workspaceDir: string;\n  candidate: DreamingPromotionCandidate;\n}): Promise<{ snippet: string; startLine: number; endLine: number } | null> {\n  const fullPath = path.join(params.workspaceDir, params.candidate.path);\n  const lines = await readFileLines(fullPath);\n  if (!lines) return null;\n\n  const startLine = Math.max(1, Math.floor(params.candidate.startLine));\n  const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));\n  const snippet = sliceRange(lines, startLine, endLine);\n  if (!snippet) return null;\n  return { snippet, startLine, endLine };\n}\n\n\nfunction buildDeepLastRun(base: {\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  t0: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: DreamingDeepLastRun['deep'];\n}): DreamingDeepLastRun {\n  const durationMs = Math.max(0, Date.now() - base.t0);\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: base.runId,\n    startedAt: base.startedAt,\n    finishedAt: base.finishedAt,\n    durationMs,\n    ok: base.ok,\n    reason: base.reason,\n    config: base.config,\n    memoryPath: base.memoryPath,\n    ...(base.errorMessage ? { errorMessage: base.errorMessage } : {}),\n    deep: base.deep,\n  };\n}\n\nexport async function runDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  memoryManager?: MemoryManager;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  candidates: number;\n  applied: number;\n  memoryPath: string;\n}> {\n  const cfg = resolveDeepDefaults(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  const t0 = Date.now();\n\n  // Early exit for disabled or zero-limit configurations.\n  const earlyExitReason = !cfg.enabled ? 'dreaming disabled' : cfg.limit === 0 ? 'dreaming limit=0' : null;\n  if (earlyExitReason) {\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: true,\n        reason: earlyExitReason,\n        config: cfg,\n        memoryPath,\n        deep: { candidatesRanked: 0, applied: 0, skipped: empty },\n      }),\n    }).catch(() => undefined);\n    return { ok: true, reason: earlyExitReason, candidates: 0, applied: 0, memoryPath };\n  }\n\n  try {\n    const result = await withDreamingPromotionLock(params.workspaceDir, async () => {\n      const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n\n      const nowMs = now.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        // Require minimum unique queries to avoid single-query inflation.\n        if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n        // Expire entries older than maxAgeDays since last recall.\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: DreamingPromotionCandidate[] = 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        .slice(0, cfg.limit);\n\n      if (ranked.length === 0) {\n        const z = emptyDeepPhaseSkipped();\n        return { ok: true, reason: 'no eligible candidates', candidates: 0, applied: 0, memoryPath, skipped: z };\n      }\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 existingMarkers = extractPromotionMarkers(existing);\n\n      const appliedCandidates: Array<{\n        key: string;\n        hash: string;\n        snippet: string;\n        path: string;\n        startLine: number;\n        endLine: number;\n        score: number;\n        recallCount: number;\n        avgScore: number;\n      }> = [];\n\n      const skipped: DreamingDeepPhaseSkipped = emptyDeepPhaseSkipped();\n      for (const candidate of ranked) {\n        if (existingMarkers.keys.has(candidate.key)) {\n          skipped.alreadyPromotedKey += 1;\n          // Treat as already applied; mark promotedAt for idempotency and keep going.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        const rehydrated = await rehydrateSnippet({ workspaceDir: params.workspaceDir, candidate });\n        if (!rehydrated) {\n          skipped.rehydrateFailed += 1;\n          continue;\n        }\n        if (isContaminatedSnippet(rehydrated.snippet)) {\n          skipped.contaminated += 1;\n          continue;\n        }\n        const hash = snippetHash(rehydrated.snippet);\n        if (existingMarkers.hashes.has(hash)) {\n          skipped.hashDuplicate += 1;\n          // Already promoted (possibly from a different key/line range). Mark promoted for idempotency.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        appliedCandidates.push({\n          key: candidate.key,\n        hash,\n          snippet: rehydrated.snippet,\n          path: candidate.path,\n          startLine: rehydrated.startLine,\n          endLine: rehydrated.endLine,\n          score: candidate.score,\n          recallCount: candidate.recallCount,\n          avgScore: candidate.avgScore,\n        });\n      }\n\n      if (appliedCandidates.length === 0) {\n        await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n        return {\n          ok: true,\n          reason: 'candidates were stale or already applied',\n          candidates: ranked.length,\n          applied: 0,\n          memoryPath,\n          skipped,\n        };\n      }\n\n      const day = isoDay(now);\n      const header = existing.trim().length > 0 ? '' : '# Long-Term Memory\\n\\n';\n      const sectionLines: string[] = ['', `## Promoted From Short-Term Memory (${day})`, ''];\n      for (const c of appliedCandidates) {\n        const src = `${c.path}:${c.startLine}-${c.endLine}`;\n        sectionLines.push(markerForPromotion(c.key, c.hash));\n        sectionLines.push(\n          `- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`,\n        );\n      }\n      sectionLines.push('');\n\n      const next = `${header}${existing.endsWith('\\n') || existing.length === 0 ? existing : `${existing}\\n`}${sectionLines.join('\\n')}`;\n      await fs.writeFile(memoryPath, next, 'utf-8');\n\n      const nowIso = now.toISOString();\n      for (const c of appliedCandidates) {\n        const writeResult = await params.memoryManager?.write({\n          kind: 'derived_insight',\n          content: c.snippet,\n          source: {\n            provider: 'dreaming',\n            path: c.path,\n            lineStart: c.startLine,\n            lineEnd: c.endLine,\n          },\n          tags: ['dreaming', 'promoted'],\n        });\n        params.memoryManager?.recordSignal({\n          source: 'dreaming',\n          recordId: writeResult?.record?.id,\n          score: c.score,\n          content: c.snippet,\n          metadata: {\n            path: c.path,\n            startLine: c.startLine,\n            endLine: c.endLine,\n            recallCount: c.recallCount,\n            avgScore: c.avgScore,\n          },\n        });\n        const entry = store.entries[c.key];\n        if (entry) {\n          entry.promotedAt = nowIso;\n          entry.snippet = c.snippet;\n          entry.startLine = c.startLine;\n          entry.endLine = c.endLine;\n        }\n      }\n      store.updatedAt = nowIso;\n      await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n      log.info(\n        { workspaceDir: params.workspaceDir, candidates: ranked.length, applied: appliedCandidates.length },\n        'Dreaming deep promotion complete',\n      );\n\n      return {\n        ok: true,\n        reason: 'applied promotions',\n        candidates: ranked.length,\n        applied: appliedCandidates.length,\n        memoryPath,\n        skipped,\n      };\n    });\n\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    const resultSkipped = 'skipped' in result ? result.skipped : empty;\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: result.ok,\n        reason: result.reason,\n        config: cfg,\n        memoryPath: result.memoryPath,\n        deep: {\n          candidatesRanked: result.candidates,\n          applied: result.applied,\n          skipped: resultSkipped,\n        },\n      }),\n    }).catch(() => undefined);\n\n    return {\n      ok: result.ok,\n      reason: result.reason,\n      candidates: result.candidates,\n      applied: result.applied,\n      memoryPath: result.memoryPath,\n    };\n  } catch (err) {\n    const finishedAt = new Date().toISOString();\n    const em = err instanceof Error ? err.message : String(err);\n    const z = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: false,\n        reason: 'error',\n        config: cfg,\n        memoryPath,\n        errorMessage: em,\n        deep: { candidatesRanked: 0, applied: 0, skipped: z },\n      }),\n    }).catch(() => undefined);\n    throw err;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"deep-promotion.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/deep-promotion.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport {\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingPromotionLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  emptyDeepPhaseSkipped,\n  writeDreamingDeepLastRun,\n  type DreamingDeepLastRun,\n  type DreamingDeepPhaseSkipped,\n} from './last-run.js';\nimport type { DreamingDeepConfig } from './config.js';\nimport type { MemoryManager } from '../manager.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  isoDay,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\nconst log = createLogger('Dreaming:Deep');\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingPromotionCandidate = DreamingStoreEntry & {\n  avgScore: number;\n  /** Time-decay-adjusted final score used for ranking. */\n  score: number;\n  /** Raw recency decay multiplier (0–1). */\n  recencyDecay: number;\n};\n\n\nfunction markerForPromotion(key: string, hash: string): string {\n  // Quote values to allow spaces/colons in key.\n  return `<!-- xopc-memory-promotion key=\"${key}\" hash=\"${hash}\" -->`;\n}\n\n\nasync function rehydrateSnippet(params: {\n  workspaceDir: string;\n  candidate: DreamingPromotionCandidate;\n}): Promise<{ snippet: string; startLine: number; endLine: number } | null> {\n  const fullPath = path.join(params.workspaceDir, params.candidate.path);\n  const lines = await readFileLines(fullPath);\n  if (!lines) return null;\n\n  const startLine = Math.max(1, Math.floor(params.candidate.startLine));\n  const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));\n  const snippet = sliceRange(lines, startLine, endLine);\n  if (!snippet) return null;\n  return { snippet, startLine, endLine };\n}\n\n\nfunction buildDeepLastRun(base: {\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  t0: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: DreamingDeepLastRun['deep'];\n}): DreamingDeepLastRun {\n  const durationMs = Math.max(0, Date.now() - base.t0);\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: base.runId,\n    startedAt: base.startedAt,\n    finishedAt: base.finishedAt,\n    durationMs,\n    ok: base.ok,\n    reason: base.reason,\n    config: base.config,\n    memoryPath: base.memoryPath,\n    ...(base.errorMessage ? { errorMessage: base.errorMessage } : {}),\n    deep: base.deep,\n  };\n}\n\nexport async function runDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  dreamingRoot: string;\n  config?: Partial<DreamingDeepConfig>;\n  memoryManager?: MemoryManager;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  candidates: number;\n  applied: number;\n  memoryPath: string;\n}> {\n  const cfg = resolveDeepDefaults(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;\n  const memoryPath = path.join(params.dreamingRoot, MEMORY_MD_FILENAME);\n  const t0 = Date.now();\n\n  // Early exit for disabled or zero-limit configurations.\n  const earlyExitReason = !cfg.enabled ? 'dreaming disabled' : cfg.limit === 0 ? 'dreaming limit=0' : null;\n  if (earlyExitReason) {\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      dreamingRoot: params.dreamingRoot,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: true,\n        reason: earlyExitReason,\n        config: cfg,\n        memoryPath,\n        deep: { candidatesRanked: 0, applied: 0, skipped: empty },\n      }),\n    }).catch(() => undefined);\n    return { ok: true, reason: earlyExitReason, candidates: 0, applied: 0, memoryPath };\n  }\n\n  try {\n    const result = await withDreamingPromotionLock(params.dreamingRoot, async () => {\n      const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });\n\n      const nowMs = now.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        // Require minimum unique queries to avoid single-query inflation.\n        if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n        // Expire entries older than maxAgeDays since last recall.\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: DreamingPromotionCandidate[] = 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        .slice(0, cfg.limit);\n\n      if (ranked.length === 0) {\n        const z = emptyDeepPhaseSkipped();\n        return { ok: true, reason: 'no eligible candidates', candidates: 0, applied: 0, memoryPath, skipped: z };\n      }\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 existingMarkers = extractPromotionMarkers(existing);\n\n      const appliedCandidates: Array<{\n        key: string;\n        hash: string;\n        snippet: string;\n        path: string;\n        startLine: number;\n        endLine: number;\n        score: number;\n        recallCount: number;\n        avgScore: number;\n      }> = [];\n\n      const skipped: DreamingDeepPhaseSkipped = emptyDeepPhaseSkipped();\n      for (const candidate of ranked) {\n        if (existingMarkers.keys.has(candidate.key)) {\n          skipped.alreadyPromotedKey += 1;\n          // Treat as already applied; mark promotedAt for idempotency and keep going.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        const rehydrated = await rehydrateSnippet({ workspaceDir: params.workspaceDir, candidate });\n        if (!rehydrated) {\n          skipped.rehydrateFailed += 1;\n          continue;\n        }\n        if (isContaminatedSnippet(rehydrated.snippet)) {\n          skipped.contaminated += 1;\n          continue;\n        }\n        const hash = snippetHash(rehydrated.snippet);\n        if (existingMarkers.hashes.has(hash)) {\n          skipped.hashDuplicate += 1;\n          // Already promoted (possibly from a different key/line range). Mark promoted for idempotency.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        appliedCandidates.push({\n          key: candidate.key,\n          hash,\n          snippet: rehydrated.snippet,\n          path: candidate.path,\n          startLine: rehydrated.startLine,\n          endLine: rehydrated.endLine,\n          score: candidate.score,\n          recallCount: candidate.recallCount,\n          avgScore: candidate.avgScore,\n        });\n      }\n\n      if (appliedCandidates.length === 0) {\n        await saveDreamingStore({ dreamingRoot: params.dreamingRoot, store });\n        return {\n          ok: true,\n          reason: 'candidates were stale or already applied',\n          candidates: ranked.length,\n          applied: 0,\n          memoryPath,\n          skipped,\n        };\n      }\n\n      const day = isoDay(now);\n      const header = existing.trim().length > 0 ? '' : '# Long-Term Memory\\n\\n';\n      const sectionLines: string[] = ['', `## Promoted From Short-Term Memory (${day})`, ''];\n      for (const c of appliedCandidates) {\n        const src = `${c.path}:${c.startLine}-${c.endLine}`;\n        sectionLines.push(markerForPromotion(c.key, c.hash));\n        sectionLines.push(\n          `- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`,\n        );\n      }\n      sectionLines.push('');\n\n      const next = `${header}${existing.endsWith('\\n') || existing.length === 0 ? existing : `${existing}\\n`}${sectionLines.join('\\n')}`;\n      await fs.mkdir(path.dirname(memoryPath), { recursive: true });\n      await fs.writeFile(memoryPath, next, 'utf-8');\n\n      const nowIso = now.toISOString();\n      for (const c of appliedCandidates) {\n        params.memoryManager?.recordSignal({\n          source: 'dreaming',\n          recordId: `dreaming:${c.key}`,\n          score: c.score,\n          content: c.snippet,\n          metadata: {\n            path: c.path,\n            startLine: c.startLine,\n            endLine: c.endLine,\n            recallCount: c.recallCount,\n            avgScore: c.avgScore,\n          },\n        });\n        const entry = store.entries[c.key];\n        if (entry) {\n          entry.promotedAt = nowIso;\n          entry.snippet = c.snippet;\n          entry.startLine = c.startLine;\n          entry.endLine = c.endLine;\n        }\n      }\n      store.updatedAt = nowIso;\n      await saveDreamingStore({ dreamingRoot: params.dreamingRoot, store });\n\n      log.info(\n        {\n          workspaceDir: params.workspaceDir,\n          dreamingRoot: params.dreamingRoot,\n          candidates: ranked.length,\n          applied: appliedCandidates.length,\n        },\n        'Dreaming deep promotion complete',\n      );\n\n      return {\n        ok: true,\n        reason: 'applied promotions',\n        candidates: ranked.length,\n        applied: appliedCandidates.length,\n        memoryPath,\n        skipped,\n      };\n    });\n\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    const resultSkipped = 'skipped' in result ? result.skipped : empty;\n    await writeDreamingDeepLastRun({\n      dreamingRoot: params.dreamingRoot,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: result.ok,\n        reason: result.reason,\n        config: cfg,\n        memoryPath: result.memoryPath,\n        deep: {\n          candidatesRanked: result.candidates,\n          applied: result.applied,\n          skipped: resultSkipped,\n        },\n      }),\n    }).catch(() => undefined);\n\n    return {\n      ok: result.ok,\n      reason: result.reason,\n      candidates: result.candidates,\n      applied: result.applied,\n      memoryPath: result.memoryPath,\n    };\n  } catch (err) {\n    const finishedAt = new Date().toISOString();\n    const em = err instanceof Error ? err.message : String(err);\n    const z = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      dreamingRoot: params.dreamingRoot,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: false,\n        reason: 'error',\n        config: cfg,\n        memoryPath,\n        errorMessage: em,\n        deep: { candidatesRanked: 0, applied: 0, skipped: z },\n      }),\n    }).catch(() => undefined);\n    throw err;\n  }\n}\n"],"mappings":"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"}

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

@@ -24,13 +24,13 @@ export type DreamingRemEvent = DreamingEventBase & {
 };
 export type DreamingEvent = DreamingLightEvent | DreamingDeepEvent | DreamingRemEvent;
 /**
- * Append a single event line to `memory/.dreams/events.jsonl`.
+ * Append a single event line to an agent's `memories/.dreams/events.jsonl`.
  * Creates the directory and file if they don't exist.
  * Failures are silently ignored so audit logging never blocks execution.
  */
-export declare function appendDreamingEvent(workspaceDir: string, event: DreamingEvent): Promise<void>;
+export declare function appendDreamingEvent(dreamingRoot: string, event: DreamingEvent): Promise<void>;
 /**
  * Read the most recent N events from the events log.
  * Returns newest-first. If the file doesn't exist, returns an empty array.
  */
-export declare function readDreamingEvents(workspaceDir: string, limit?: number): Promise<DreamingEvent[]>;
+export declare function readDreamingEvents(dreamingRoot: string, limit?: number): Promise<DreamingEvent[]>;

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

@@ -3,15 +3,15 @@ import path from "node:path";
 import fs from "node:fs/promises";
 //#region src/agent/memory/dreaming/events.ts
 /**
-* Append a single event line to `memory/.dreams/events.jsonl`.
+* Append a single event line to an agent's `memories/.dreams/events.jsonl`.
 * Creates the directory and file if they don't exist.
 * Failures are silently ignored so audit logging never blocks execution.
 */
-async function appendDreamingEvent(workspaceDir, event) {
+async function appendDreamingEvent(dreamingRoot, event) {
 	try {
-		const dirPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE);
+		const dirPath = path.join(dreamingRoot, DREAMING_DIR_RELATIVE);
 		await fs.mkdir(dirPath, { recursive: true });
-		const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);
+		const filePath = path.join(dreamingRoot, DREAMING_EVENTS_LOG_RELATIVE);
 		const line = JSON.stringify(event) + "\n";
 		await fs.appendFile(filePath, line, "utf-8");
 	} catch {}
@@ -20,8 +20,8 @@ async function appendDreamingEvent(workspaceDir, event) {
 * Read the most recent N events from the events log.
 * Returns newest-first. If the file doesn't exist, returns an empty array.
 */
-async function readDreamingEvents(workspaceDir, limit = 50) {
-	const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);
+async function readDreamingEvents(dreamingRoot, limit = 50) {
+	const filePath = path.join(dreamingRoot, DREAMING_EVENTS_LOG_RELATIVE);
 	let raw;
 	try {
 		raw = await fs.readFile(filePath, "utf-8");

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<{