@xopcai/xopc 0.0.140 → 0.0.142

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  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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"}
+{"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  withDreamingStoreLock,\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 { activateDreamingPromotion } from './promotion-lifecycle.js';\nimport { inferMemorySensitivity } from '../sensitivity.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  agentId: string;\n  workspaceDir: string;\n  dreamingRoot: string;\n  config?: Partial<DreamingDeepConfig>;\n  sensitiveWritePolicy?: 'deny' | 'confirm' | 'allow';\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 withDreamingStoreLock(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        sensitivity: ReturnType<typeof inferMemorySensitivity>;\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 sensitivity = inferMemorySensitivity(rehydrated.snippet);\n        if (sensitivity !== 'normal' && params.sensitiveWritePolicy !== 'allow') {\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          sensitivity,\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      for (const c of appliedCandidates) {\n        activateDreamingPromotion({\n          agentId: params.agentId,\n          workspaceId: params.workspaceDir,\n          candidateKey: c.key,\n          content: c.snippet,\n          sourcePath: c.path,\n          lineStart: c.startLine,\n          lineEnd: c.endLine,\n          score: c.score,\n          recallCount: c.recallCount,\n          observedAt: now.toISOString(),\n          sensitivity: c.sensitivity,\n        });\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/light-sweep.d.ts

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

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

@@ -1,4 +1,6 @@
 import { DREAMING_DIR_RELATIVE } from "./constants.js";
+import { buildEntryKey, normalizeMemoryPath } from "./utils.js";
+import { bumpEntryPhaseSignal, loadDreamingStore, saveDreamingStore, withDreamingStoreLock } from "./short-term-store.js";
 import "./last-run.js";
 import path from "node:path";
 import fs from "node:fs/promises";
@@ -14,29 +16,195 @@ function resolveConfig(overrides) {
 }
 async function runLightSweep(params) {
 	const cfg = resolveConfig(params.config);
-	const startedAt = (params.now ?? /* @__PURE__ */ new Date()).toISOString();
+	const now = params.now ?? /* @__PURE__ */ new Date();
+	const startedAt = now.toISOString();
 	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.dreamingRoot, {
-		runId,
-		startedAt,
-		cfg,
-		ok: true,
-		reason,
-		startMs,
-		light: {
+	if (!cfg.enabled) {
+		const reason = "light sweep disabled";
+		await writeLastRun(params.dreamingRoot, {
+			runId,
+			startedAt,
+			cfg,
+			ok: true,
+			reason,
+			startMs,
+			light: {
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			}
+		});
+		return {
+			ok: true,
+			reason,
 			scannedEntries: 0,
 			newSignals: 0,
 			deduped: 0
+		};
+	}
+	try {
+		const result = await withDreamingStoreLock(params.dreamingRoot, async () => {
+			const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });
+			const candidates = await scanRecentMemoryLines(params.workspaceDir, cfg.lookbackDays, now);
+			let scannedEntries = 0;
+			let newSignals = 0;
+			let deduped = 0;
+			for (const candidate of candidates.slice(0, cfg.limit)) {
+				scannedEntries += 1;
+				const key = buildEntryKey(candidate);
+				const existing = store.entries[key];
+				if (existing) {
+					if (observedAtOrZero(existing) >= candidate.observedAtMs) {
+						deduped += 1;
+						continue;
+					}
+					existing.snippet = candidate.snippet;
+					existing.lastObservedAt = candidate.observedAt;
+					bumpEntryPhaseSignal(existing, "sourceCount");
+					bumpEntryPhaseSignal(existing, "lightHits");
+					continue;
+				}
+				const duplicate = Object.values(store.entries).find((entry) => similarity(entry.snippet, candidate.snippet) >= cfg.dedupeSimilarity);
+				if (duplicate) {
+					if (observedAtOrZero(duplicate) < candidate.observedAtMs) {
+						duplicate.lastObservedAt = candidate.observedAt;
+						bumpEntryPhaseSignal(duplicate, "sourceCount");
+						bumpEntryPhaseSignal(duplicate, "lightHits");
+					}
+					deduped += 1;
+					continue;
+				}
+				store.entries[key] = newLightEntry(candidate);
+				newSignals += 1;
+			}
+			if (scannedEntries > 0) {
+				store.updatedAt = startedAt;
+				await saveDreamingStore({
+					dreamingRoot: params.dreamingRoot,
+					store
+				});
+			}
+			return {
+				scannedEntries,
+				newSignals,
+				deduped
+			};
+		});
+		await writeLastRun(params.dreamingRoot, {
+			runId,
+			startedAt,
+			cfg,
+			ok: true,
+			reason: "light sweep complete",
+			startMs,
+			light: result
+		});
+		return {
+			ok: true,
+			reason: "light sweep complete",
+			...result
+		};
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		await writeLastRun(params.dreamingRoot, {
+			runId,
+			startedAt,
+			cfg,
+			ok: false,
+			reason: `light error: ${errorMessage}`,
+			startMs,
+			light: {
+				scannedEntries: 0,
+				newSignals: 0,
+				deduped: 0
+			},
+			errorMessage
+		}).catch(() => void 0);
+		return {
+			ok: false,
+			reason: errorMessage,
+			scannedEntries: 0,
+			newSignals: 0,
+			deduped: 0
+		};
+	}
+}
+async function scanRecentMemoryLines(workspaceDir, lookbackDays, now) {
+	const root = path.join(workspaceDir, "memory");
+	const cutoffMs = now.getTime() - lookbackDays * 24 * 60 * 60 * 1e3;
+	const files = await listMarkdownFiles(root);
+	const out = [];
+	for (const filePath of files) {
+		const stat = await fs.stat(filePath).catch(() => null);
+		if (!stat || stat.mtimeMs < cutoffMs) continue;
+		const content = await fs.readFile(filePath, "utf-8").catch(() => "");
+		const relativePath = normalizeMemoryPath(path.relative(workspaceDir, filePath));
+		let inFence = false;
+		for (const [index, rawLine] of content.split(/\r?\n/).entries()) {
+			if (/^\s*```/.test(rawLine)) {
+				inFence = !inFence;
+				continue;
+			}
+			if (inFence) continue;
+			const snippet = rawLine.replace(/^\s*[-*]\s+/, "").trim();
+			if (snippet.length < 8 || snippet.startsWith("#") || snippet.startsWith("<!--")) continue;
+			out.push({
+				path: relativePath,
+				startLine: index + 1,
+				endLine: index + 1,
+				snippet: snippet.slice(0, 360),
+				observedAt: stat.mtime.toISOString(),
+				observedAtMs: stat.mtimeMs
+			});
 		}
-	});
+	}
+	return out.sort((left, right) => right.observedAtMs - left.observedAtMs || left.path.localeCompare(right.path) || left.startLine - right.startLine);
+}
+async function listMarkdownFiles(root) {
+	const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
+	const out = [];
+	for (const entry of entries) {
+		const fullPath = path.join(root, entry.name);
+		if (entry.isDirectory()) out.push(...await listMarkdownFiles(fullPath));
+		else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) out.push(fullPath);
+	}
+	return out;
+}
+function similarity(left, right) {
+	const tokens = (value) => new Set(value.toLocaleLowerCase().match(/[\p{L}\p{N}]+/gu) ?? []);
+	const a = tokens(left);
+	const b = tokens(right);
+	if (a.size === 0 || b.size === 0) return 0;
+	let intersection = 0;
+	for (const token of a) if (b.has(token)) intersection += 1;
+	return intersection / (a.size + b.size - intersection);
+}
+function observedAtOrZero(entry) {
+	const parsed = entry.lastObservedAt ? Date.parse(entry.lastObservedAt) : 0;
+	return Number.isFinite(parsed) ? parsed : 0;
+}
+function newLightEntry(candidate) {
 	return {
-		ok: true,
-		reason,
-		scannedEntries: 0,
-		newSignals: 0,
-		deduped: 0
+		key: buildEntryKey(candidate),
+		path: candidate.path,
+		startLine: candidate.startLine,
+		endLine: candidate.endLine,
+		snippet: candidate.snippet,
+		recallCount: 0,
+		sourceCount: 1,
+		groundedCount: 0,
+		lightHits: 1,
+		remHits: 0,
+		phaseHitCount: 2,
+		totalSignalCount: 2,
+		totalScore: 0,
+		maxScore: 0,
+		queryHashes: [],
+		recallDays: [],
+		firstRecalledAt: candidate.observedAt,
+		lastRecalledAt: candidate.observedAt,
+		lastObservedAt: candidate.observedAt
 	};
 }
 async function writeLastRun(dreamingRoot, params) {

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  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"}
+{"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  bumpEntryPhaseSignal,\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingStoreLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport { buildEntryKey, normalizeMemoryPath } from './utils.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  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  if (!cfg.enabled) {\n    const reason = 'light sweep disabled';\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  try {\n    const result = await withDreamingStoreLock(params.dreamingRoot, async () => {\n      const { store } = await loadDreamingStore({ dreamingRoot: params.dreamingRoot });\n      const candidates = await scanRecentMemoryLines(params.workspaceDir, cfg.lookbackDays, now);\n      let scannedEntries = 0;\n      let newSignals = 0;\n      let deduped = 0;\n      for (const candidate of candidates.slice(0, cfg.limit)) {\n        scannedEntries += 1;\n        const key = buildEntryKey(candidate);\n        const existing = store.entries[key];\n        if (existing) {\n          if (observedAtOrZero(existing) >= candidate.observedAtMs) {\n            deduped += 1;\n            continue;\n          }\n          existing.snippet = candidate.snippet;\n          existing.lastObservedAt = candidate.observedAt;\n          bumpEntryPhaseSignal(existing, 'sourceCount');\n          bumpEntryPhaseSignal(existing, 'lightHits');\n          continue;\n        }\n        const duplicate = Object.values(store.entries).find((entry) =>\n          similarity(entry.snippet, candidate.snippet) >= cfg.dedupeSimilarity,\n        );\n        if (duplicate) {\n          if (observedAtOrZero(duplicate) < candidate.observedAtMs) {\n            duplicate.lastObservedAt = candidate.observedAt;\n            bumpEntryPhaseSignal(duplicate, 'sourceCount');\n            bumpEntryPhaseSignal(duplicate, 'lightHits');\n          }\n          deduped += 1;\n          continue;\n        }\n        store.entries[key] = newLightEntry(candidate);\n        newSignals += 1;\n      }\n      if (scannedEntries > 0) {\n        store.updatedAt = startedAt;\n        await saveDreamingStore({ dreamingRoot: params.dreamingRoot, store });\n      }\n      return { scannedEntries, newSignals, deduped };\n    });\n    await writeLastRun(params.dreamingRoot, {\n      runId, startedAt, cfg, ok: true, reason: 'light sweep complete', startMs, light: result,\n    });\n    return { ok: true, reason: 'light sweep complete', ...result };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    await writeLastRun(params.dreamingRoot, {\n      runId, startedAt, cfg, ok: false, reason: `light error: ${errorMessage}`, startMs,\n      light: { scannedEntries: 0, newSignals: 0, deduped: 0 }, errorMessage,\n    }).catch(() => undefined);\n    return { ok: false, reason: errorMessage, scannedEntries: 0, newSignals: 0, deduped: 0 };\n  }\n}\n\ntype LightCandidate = {\n  path: string;\n  startLine: number;\n  endLine: number;\n  snippet: string;\n  observedAt: string;\n  observedAtMs: number;\n};\n\nasync function scanRecentMemoryLines(workspaceDir: string, lookbackDays: number, now: Date): Promise<LightCandidate[]> {\n  const root = path.join(workspaceDir, 'memory');\n  const cutoffMs = now.getTime() - lookbackDays * 24 * 60 * 60 * 1_000;\n  const files = await listMarkdownFiles(root);\n  const out: LightCandidate[] = [];\n  for (const filePath of files) {\n    const stat = await fs.stat(filePath).catch(() => null);\n    if (!stat || stat.mtimeMs < cutoffMs) continue;\n    const content = await fs.readFile(filePath, 'utf-8').catch(() => '');\n    const relativePath = normalizeMemoryPath(path.relative(workspaceDir, filePath));\n    let inFence = false;\n    for (const [index, rawLine] of content.split(/\\r?\\n/).entries()) {\n      if (/^\\s*```/.test(rawLine)) {\n        inFence = !inFence;\n        continue;\n      }\n      if (inFence) continue;\n      const snippet = rawLine.replace(/^\\s*[-*]\\s+/, '').trim();\n      if (snippet.length < 8 || snippet.startsWith('#') || snippet.startsWith('<!--')) continue;\n      out.push({\n        path: relativePath,\n        startLine: index + 1,\n        endLine: index + 1,\n        snippet: snippet.slice(0, 360),\n        observedAt: stat.mtime.toISOString(),\n        observedAtMs: stat.mtimeMs,\n      });\n    }\n  }\n  return out.sort((left, right) =>\n    right.observedAtMs - left.observedAtMs\n    || left.path.localeCompare(right.path)\n    || left.startLine - right.startLine,\n  );\n}\n\nasync function listMarkdownFiles(root: string): Promise<string[]> {\n  const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);\n  const out: string[] = [];\n  for (const entry of entries) {\n    const fullPath = path.join(root, entry.name);\n    if (entry.isDirectory()) out.push(...await listMarkdownFiles(fullPath));\n    else if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) out.push(fullPath);\n  }\n  return out;\n}\n\nfunction similarity(left: string, right: string): number {\n  const tokens = (value: string) => new Set(value.toLocaleLowerCase().match(/[\\p{L}\\p{N}]+/gu) ?? []);\n  const a = tokens(left);\n  const b = tokens(right);\n  if (a.size === 0 || b.size === 0) return 0;\n  let intersection = 0;\n  for (const token of a) if (b.has(token)) intersection += 1;\n  return intersection / (a.size + b.size - intersection);\n}\n\nfunction observedAtOrZero(entry: DreamingStoreEntry): number {\n  const parsed = entry.lastObservedAt ? Date.parse(entry.lastObservedAt) : 0;\n  return Number.isFinite(parsed) ? parsed : 0;\n}\n\nfunction newLightEntry(candidate: LightCandidate): DreamingStoreEntry {\n  const key = buildEntryKey(candidate);\n  return {\n    key,\n    path: candidate.path,\n    startLine: candidate.startLine,\n    endLine: candidate.endLine,\n    snippet: candidate.snippet,\n    recallCount: 0,\n    sourceCount: 1,\n    groundedCount: 0,\n    lightHits: 1,\n    remHits: 0,\n    phaseHitCount: 2,\n    totalSignalCount: 2,\n    totalScore: 0,\n    maxScore: 0,\n    queryHashes: [],\n    recallDays: [],\n    firstRecalledAt: candidate.observedAt,\n    lastRecalledAt: candidate.observedAt,\n    lastObservedAt: candidate.observedAt,\n  };\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":"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"}

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

@@ -0,0 +1,30 @@
+import type { MemoryRecord, MemorySensitivity } from '../types.js';
+export interface DreamingPromotionInput {
+    agentId: string;
+    workspaceId: string;
+    candidateKey: string;
+    content: string;
+    sourcePath: string;
+    lineStart: number;
+    lineEnd: number;
+    score: number;
+    recallCount: number;
+    observedAt: string;
+    sensitivity: MemorySensitivity;
+}
+/** Persist a promoted Dreaming insight as the authoritative structured record. */
+export declare function activateDreamingPromotion(input: DreamingPromotionInput): MemoryRecord;
+export interface RemInsightInput {
+    agentId: string;
+    workspaceId: string;
+    memberKeys: string[];
+    representative: string;
+    distinctPaths: string[];
+    strength: number;
+    observedAt: string;
+    evidence: string[];
+    sensitivity: MemorySensitivity;
+}
+export declare function remPatternKey(memberKeys: string[]): string;
+/** Persist a REM cluster as a stable, recallable derived insight. */
+export declare function activateRemInsight(input: RemInsightInput): MemoryRecord;

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

@@ -0,0 +1,85 @@
+import { upsertMemoryRecord } from "../../../storage/sqlite/memory-records-repository.js";
+import "../../../storage/sqlite/index.js";
+import { createHash } from "node:crypto";
+//#region src/agent/memory/dreaming/promotion-lifecycle.ts
+/** Persist a promoted Dreaming insight as the authoritative structured record. */
+function activateDreamingPromotion(input) {
+	return upsertMemoryRecord({
+		id: `dreaming:${createHash("sha256").update(`${input.agentId}\0${input.candidateKey}`).digest("hex").slice(0, 32)}`,
+		providerId: "local",
+		kind: "project_context",
+		agentId: input.agentId,
+		workspaceId: input.workspaceId,
+		content: input.content,
+		source: {
+			provider: "dreaming",
+			path: input.sourcePath,
+			lineStart: input.lineStart,
+			lineEnd: input.lineEnd
+		},
+		confidence: input.score,
+		status: "active",
+		sensitivity: input.sensitivity,
+		canonicalKey: `dreaming:${input.candidateKey}`,
+		explicitness: "observed",
+		durability: "durable",
+		importance: input.score,
+		disclosurePolicy: "referenceable",
+		evidence: [{
+			relation: "derived_from",
+			sourceText: input.content,
+			observedAt: input.observedAt,
+			confidence: input.score
+		}],
+		tags: [
+			"dreaming",
+			"promoted",
+			`recalls:${input.recallCount}`
+		]
+	});
+}
+function remPatternKey(memberKeys) {
+	return createHash("sha256").update([...memberKeys].sort().join("\0")).digest("hex").slice(0, 24);
+}
+/** Persist a REM cluster as a stable, recallable derived insight. */
+function activateRemInsight(input) {
+	const patternKey = remPatternKey(input.memberKeys);
+	const content = `Recurring context across ${input.distinctPaths.length} memory sources: ${input.representative}`;
+	return upsertMemoryRecord({
+		id: `dreaming-rem:${input.agentId}:${patternKey}`,
+		providerId: "local",
+		kind: "derived_insight",
+		agentId: input.agentId,
+		workspaceId: input.workspaceId,
+		content,
+		source: {
+			provider: "dreaming",
+			path: "DREAMS.md"
+		},
+		confidence: input.strength,
+		status: "active",
+		sensitivity: input.sensitivity,
+		canonicalKey: `dreaming-rem:${patternKey}`,
+		explicitness: "inferred",
+		durability: "recurring",
+		importance: input.strength,
+		disclosurePolicy: "referenceable",
+		evidence: input.evidence.slice(0, 8).map((sourceText) => ({
+			relation: "derived_from",
+			sourceText,
+			observedAt: input.observedAt,
+			confidence: input.strength
+		})),
+		tags: [
+			"dreaming",
+			"rem",
+			"derived-insight",
+			`strength:${input.strength.toFixed(2)}`,
+			`sources:${input.distinctPaths.length}`
+		]
+	});
+}
+//#endregion
+export { activateDreamingPromotion, activateRemInsight, remPatternKey };
+
+//# sourceMappingURL=promotion-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-lifecycle.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/promotion-lifecycle.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport { upsertMemoryRecord } from '../../../storage/sqlite/index.js';\nimport type { MemoryRecord, MemorySensitivity } from '../types.js';\n\nexport interface DreamingPromotionInput {\n  agentId: string;\n  workspaceId: string;\n  candidateKey: string;\n  content: string;\n  sourcePath: string;\n  lineStart: number;\n  lineEnd: number;\n  score: number;\n  recallCount: number;\n  observedAt: string;\n  sensitivity: MemorySensitivity;\n}\n\n/** Persist a promoted Dreaming insight as the authoritative structured record. */\nexport function activateDreamingPromotion(input: DreamingPromotionInput): MemoryRecord {\n  const stableId = createHash('sha256')\n    .update(`${input.agentId}\\0${input.candidateKey}`)\n    .digest('hex')\n    .slice(0, 32);\n  return upsertMemoryRecord({\n    id: `dreaming:${stableId}`,\n    providerId: 'local',\n    kind: 'project_context',\n    agentId: input.agentId,\n    workspaceId: input.workspaceId,\n    content: input.content,\n    source: {\n      provider: 'dreaming',\n      path: input.sourcePath,\n      lineStart: input.lineStart,\n      lineEnd: input.lineEnd,\n    },\n    confidence: input.score,\n    status: 'active',\n    sensitivity: input.sensitivity,\n    canonicalKey: `dreaming:${input.candidateKey}`,\n    explicitness: 'observed',\n    durability: 'durable',\n    importance: input.score,\n    disclosurePolicy: 'referenceable',\n    evidence: [{\n      relation: 'derived_from',\n      sourceText: input.content,\n      observedAt: input.observedAt,\n      confidence: input.score,\n    }],\n    tags: ['dreaming', 'promoted', `recalls:${input.recallCount}`],\n  });\n}\n\nexport interface RemInsightInput {\n  agentId: string;\n  workspaceId: string;\n  memberKeys: string[];\n  representative: string;\n  distinctPaths: string[];\n  strength: number;\n  observedAt: string;\n  evidence: string[];\n  sensitivity: MemorySensitivity;\n}\n\nexport function remPatternKey(memberKeys: string[]): string {\n  return createHash('sha256').update([...memberKeys].sort().join('\\0')).digest('hex').slice(0, 24);\n}\n\n/** Persist a REM cluster as a stable, recallable derived insight. */\nexport function activateRemInsight(input: RemInsightInput): MemoryRecord {\n  const patternKey = remPatternKey(input.memberKeys);\n  const content = `Recurring context across ${input.distinctPaths.length} memory sources: ${input.representative}`;\n  return upsertMemoryRecord({\n    id: `dreaming-rem:${input.agentId}:${patternKey}`,\n    providerId: 'local',\n    kind: 'derived_insight',\n    agentId: input.agentId,\n    workspaceId: input.workspaceId,\n    content,\n    source: { provider: 'dreaming', path: 'DREAMS.md' },\n    confidence: input.strength,\n    status: 'active',\n    sensitivity: input.sensitivity,\n    canonicalKey: `dreaming-rem:${patternKey}`,\n    explicitness: 'inferred',\n    durability: 'recurring',\n    importance: input.strength,\n    disclosurePolicy: 'referenceable',\n    evidence: input.evidence.slice(0, 8).map((sourceText) => ({\n      relation: 'derived_from',\n      sourceText,\n      observedAt: input.observedAt,\n      confidence: input.strength,\n    })),\n    tags: [\n      'dreaming',\n      'rem',\n      'derived-insight',\n      `strength:${input.strength.toFixed(2)}`,\n      `sources:${input.distinctPaths.length}`,\n    ],\n  });\n}\n"],"mappings":";;;;;AAoBA,SAAgB,0BAA0B,OAA6C;AAKrF,QAAO,mBAAmB;EACxB,IAAI,YALW,WAAW,SAAS,CAClC,OAAO,GAAG,MAAM,QAAQ,IAAI,MAAM,eAAe,CACjD,OAAO,MAAM,CACb,MAAM,GAAG,GAEc;EACxB,YAAY;EACZ,MAAM;EACN,SAAS,MAAM;EACf,aAAa,MAAM;EACnB,SAAS,MAAM;EACf,QAAQ;GACN,UAAU;GACV,MAAM,MAAM;GACZ,WAAW,MAAM;GACjB,SAAS,MAAM;GAChB;EACD,YAAY,MAAM;EAClB,QAAQ;EACR,aAAa,MAAM;EACnB,cAAc,YAAY,MAAM;EAChC,cAAc;EACd,YAAY;EACZ,YAAY,MAAM;EAClB,kBAAkB;EAClB,UAAU,CAAC;GACT,UAAU;GACV,YAAY,MAAM;GAClB,YAAY,MAAM;GAClB,YAAY,MAAM;GACnB,CAAC;EACF,MAAM;GAAC;GAAY;GAAY,WAAW,MAAM;GAAc;EAC/D,CAAC;;AAeJ,SAAgB,cAAc,YAA8B;AAC1D,QAAO,WAAW,SAAS,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;AAIlG,SAAgB,mBAAmB,OAAsC;CACvE,MAAM,aAAa,cAAc,MAAM,WAAW;CAClD,MAAM,UAAU,4BAA4B,MAAM,cAAc,OAAO,mBAAmB,MAAM;AAChG,QAAO,mBAAmB;EACxB,IAAI,gBAAgB,MAAM,QAAQ,GAAG;EACrC,YAAY;EACZ,MAAM;EACN,SAAS,MAAM;EACf,aAAa,MAAM;EACnB;EACA,QAAQ;GAAE,UAAU;GAAY,MAAM;GAAa;EACnD,YAAY,MAAM;EAClB,QAAQ;EACR,aAAa,MAAM;EACnB,cAAc,gBAAgB;EAC9B,cAAc;EACd,YAAY;EACZ,YAAY,MAAM;EAClB,kBAAkB;EAClB,UAAU,MAAM,SAAS,MAAM,GAAG,EAAE,CAAC,KAAK,gBAAgB;GACxD,UAAU;GACV;GACA,YAAY,MAAM;GAClB,YAAY,MAAM;GACnB,EAAE;EACH,MAAM;GACJ;GACA;GACA;GACA,YAAY,MAAM,SAAS,QAAQ,EAAE;GACrC,WAAW,MAAM,cAAc;GAChC;EACF,CAAC"}

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

@@ -10,8 +10,12 @@ import type { DreamingRemConfig } from './config.js';
  * Runs weekly; expensive but insightful.
  */
 export declare function runRemPatterns(params: {
+    agentId: string;
+    workspaceDir: string;
     dreamingRoot: string;
     config?: Partial<DreamingRemConfig>;
+    sensitiveWritePolicy?: 'deny' | 'confirm' | 'allow';
+    promotionWritePolicy?: 'deny' | 'confirm' | 'allow';
     now?: Date;
 }): Promise<{
     ok: boolean;