@0xmaxma/claude-gateway 1.6.8 → 1.7.0

package/dist/agent/dreaming/compactor.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Deterministic memory compactor (issue #337, approach #3) — the non-LLM shrink
+ * lever for append-only PR/issue logs in MEMORY.md.
+ *
+ * The problem: agents accumulate a `## Active PR` / `## Issues` style log where
+ * every entry is a full changelog line (description, review score, commit hash).
+ * Entries marked `MERGED` / `CLOSED` are terminal — the work is done — yet they
+ * are never removed, so the file grows unbounded (meguri: ~78 KB vs an 8 KB
+ * budget, ~50% of it these two log sections). The LLM reviewer can't see them
+ * (it is anchored to the recent transcript), so nothing ever prunes them.
+ *
+ * The fix, deterministically and WITHOUT losing recall: move each terminal-state
+ * entry's FULL text into a `memory/archive/*.md` file — which the knowledge
+ * indexer already walks (`indexer.ts` → `walkMarkdown('memory')`), so the
+ * archived record stays searchable via `memory_search` — and leave a compact
+ * one-line pointer in MEMORY.md. The agent still "remembers" everything; it just
+ * recalls the completed items on demand instead of carrying them in-prompt.
+ *
+ * Design constraints (this mutates real agent memory, so it is conservative):
+ *   - Terminal markers are the UPPERCASE status words `MERGED` / `CLOSED` only.
+ *     Prose like "Closes #1857" or "merged into develop" is NOT matched, so an
+ *     open/active entry is never archived by accident.
+ *   - Only top-level list bullets (`- ` / `* ` at column 0) plus their contiguous
+ *     continuation lines form an archivable block. Headers and other structure
+ *     are left untouched.
+ *   - Idempotent: a pointer this pass emits (which links to the archive file) is
+ *     never re-archived on the next run.
+ *   - Nothing is ever dropped: an archived block is appended to the archive file
+ *     BEFORE MEMORY.md is rewritten, and every removed block leaves a pointer.
+ */
+/** Where archived completed-log entries are stored (indexed + searchable). */
+export declare const ARCHIVE_REL_PATH = "memory/archive/completed.md";
+/** Result of the pure planning step — no I/O. */
+export interface CompactionPlan {
+    /** New MEMORY.md content (terminal blocks replaced by pointers). */
+    nextMemory: string;
+    /** Text to append to the archive file ('' when nothing is archived). */
+    archiveAppend: string;
+    /** How many blocks were archived. */
+    archivedCount: number;
+    /** Net chars removed from MEMORY.md (before − after). */
+    charsRemoved: number;
+}
+/** Applied result — includes the archive path actually written. */
+export interface CompactionResult {
+    archivedCount: number;
+    charsRemoved: number;
+    archivePath: string | null;
+}
+/**
+ * Plan a compaction over `memory`. Pure (no I/O) so it is exhaustively testable.
+ * Terminal-state blocks (bullets or h3+ entry headers) are replaced with a
+ * one-line pointer; their full original text is collected into `archiveAppend`.
+ */
+export declare function planCompaction(memory: string, now: number): CompactionPlan;
+/**
+ * Run the deterministic compaction against an agent's MEMORY.md. Never throws;
+ * on any error the memory file is left untouched.
+ *
+ * Ordering is crash-safe: the archive file is appended FIRST, then MEMORY.md is
+ * rewritten. A crash between the two leaves the entries in BOTH files (a harmless
+ * duplicate), never lost. A CAS re-read guards against clobbering a concurrent
+ * agent edit.
+ */
+export declare function compactCompletedEntries(workspaceDir: string, now?: number): CompactionResult;
+//# sourceMappingURL=compactor.d.ts.map

package/dist/agent/dreaming/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/agent/dreaming/compactor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAgC9D,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAmGD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CA0C1E;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,GAAG,GAAE,MAAmB,GACvB,gBAAgB,CAsClB"}

package/dist/agent/dreaming/compactor.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * Deterministic memory compactor (issue #337, approach #3) — the non-LLM shrink
+ * lever for append-only PR/issue logs in MEMORY.md.
+ *
+ * The problem: agents accumulate a `## Active PR` / `## Issues` style log where
+ * every entry is a full changelog line (description, review score, commit hash).
+ * Entries marked `MERGED` / `CLOSED` are terminal — the work is done — yet they
+ * are never removed, so the file grows unbounded (meguri: ~78 KB vs an 8 KB
+ * budget, ~50% of it these two log sections). The LLM reviewer can't see them
+ * (it is anchored to the recent transcript), so nothing ever prunes them.
+ *
+ * The fix, deterministically and WITHOUT losing recall: move each terminal-state
+ * entry's FULL text into a `memory/archive/*.md` file — which the knowledge
+ * indexer already walks (`indexer.ts` → `walkMarkdown('memory')`), so the
+ * archived record stays searchable via `memory_search` — and leave a compact
+ * one-line pointer in MEMORY.md. The agent still "remembers" everything; it just
+ * recalls the completed items on demand instead of carrying them in-prompt.
+ *
+ * Design constraints (this mutates real agent memory, so it is conservative):
+ *   - Terminal markers are the UPPERCASE status words `MERGED` / `CLOSED` only.
+ *     Prose like "Closes #1857" or "merged into develop" is NOT matched, so an
+ *     open/active entry is never archived by accident.
+ *   - Only top-level list bullets (`- ` / `* ` at column 0) plus their contiguous
+ *     continuation lines form an archivable block. Headers and other structure
+ *     are left untouched.
+ *   - Idempotent: a pointer this pass emits (which links to the archive file) is
+ *     never re-archived on the next run.
+ *   - Nothing is ever dropped: an archived block is appended to the archive file
+ *     BEFORE MEMORY.md is rewritten, and every removed block leaves a pointer.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARCHIVE_REL_PATH = void 0;
+exports.planCompaction = planCompaction;
+exports.compactCompletedEntries = compactCompletedEntries;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Where archived completed-log entries are stored (indexed + searchable). */
+exports.ARCHIVE_REL_PATH = 'memory/archive/completed.md';
+const STATUS_WORDS = 'MERGED|CLOSED|DONE|COMPLETED|FINISHED|RESOLVED|CANCELLED|CANCELED|ARCHIVED|SUPERSEDED|OBSOLETE|DEPRECATED|EXPIRED|SHIPPED';
+/**
+ * A "done / terminal" marker, domain-agnostic (not just dev): an UPPERCASE status
+ * word (case-sensitive, so prose like "Closes #12" or lowercase "closed early"
+ * never matches), a checked task box `[x]`/`[X]`, a ✅ check mark, or a
+ * ~~strikethrough~~. Covers any topic the agent marks done while keeping false
+ * positives low.
+ */
+const TERMINAL_RE = new RegExp(`(?:\\b(?:${STATUS_WORDS})\\b|✅|\\[[xX]\\]|~~[^~]+~~)`);
+/** Leading done-marker to strip from a pointer label (checkbox / check / strike open). */
+const LEAD_MARKER_RE = /^(?:✅|\[[xX]\]|~~)\s*/;
+const TOP_BULLET_RE = /^[-*] /;
+const HEADER_RE = /^#{1,6} /;
+/** h1/h2 are structural sections; h3–h6 can be a completed *entry* header. */
+const SECTION_RE = /^#{1,2} /;
+const ENTRY_HEADER_RE = /^#{3,6} /;
+const BLANK_RE = /^\s*$/;
+/** True when this bullet line marks a terminal (done) entry we should archive. */
+function isTerminalHead(head) {
+    // Never re-archive a pointer we already emitted (it links to the archive file).
+    if (head.includes(exports.ARCHIVE_REL_PATH))
+        return false;
+    return TERMINAL_RE.test(head);
+}
+/**
+ * Extract a compact identity label for the pointer line, from a lead line whose
+ * bullet/header prefix has already been stripped (`body`). Preference order:
+ *   1. An existing markdown link `[text](url)` — kept verbatim so the entry's own
+ *      per-record memory/*.md link (if any) survives.
+ *   2. The identity text BEFORE the terminal marker, so status/detail stays in the
+ *      archive and only the name lands in the pointer.
+ *   3. The first ~70 chars, markdown stripped.
+ */
+function extractLabel(body) {
+    const trimmed = body.replace(LEAD_MARKER_RE, '').trim();
+    const link = trimmed.match(/\[[^\]]+\]\([^)]+\)/);
+    if (link)
+        return link[0];
+    // Everything from the terminal marker onward is detail bound for the archive.
+    const cut = trimmed.search(TERMINAL_RE);
+    let ident = (cut > 0 ? trimmed.slice(0, cut) : trimmed).trim();
+    ident = ident
+        .replace(/[\s—–\-:,(~]+$/, '') // trailing separators / open strike left by the cut
+        .replace(/[*_`~]/g, '') // markdown emphasis / strike marks
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!ident)
+        ident = trimmed.replace(/[*_`~]/g, '').replace(/\s+/g, ' ').trim();
+    return ident.length > 70 ? ident.slice(0, 70).replace(/\s+\S*$/, '') + '…' : ident;
+}
+/** Which terminal marker matched (for the pointer suffix); non-word markers ⇒ DONE. */
+function statusOf(head) {
+    const m = head.match(TERMINAL_RE);
+    if (!m)
+        return 'DONE';
+    return /^[A-Z]+$/.test(m[0]) ? m[0] : 'DONE';
+}
+function parseItems(memory) {
+    const lines = memory.split('\n');
+    const items = [];
+    let section = '';
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // h1/h2 = structural section title (updates provenance, never a block).
+        if (SECTION_RE.test(line)) {
+            section = line.replace(/^#{1,6}\s+/, '').trim();
+            items.push({ kind: 'raw', line });
+            continue;
+        }
+        // h3–h6 = a completed-entry header candidate; absorb its body until the next
+        // header (any level) or a blank line.
+        if (ENTRY_HEADER_RE.test(line)) {
+            const blockLines = [line];
+            let j = i + 1;
+            while (j < lines.length && !BLANK_RE.test(lines[j]) && !HEADER_RE.test(lines[j])) {
+                blockLines.push(lines[j]);
+                j++;
+            }
+            const headerPrefix = (line.match(/^#{3,6}\s+/) ?? ['### '])[0];
+            items.push({ kind: 'block', block: { lines: blockLines, section, lead: 'header', headerPrefix } });
+            i = j - 1;
+            continue;
+        }
+        if (TOP_BULLET_RE.test(line)) {
+            const blockLines = [line];
+            // Absorb continuation lines: non-blank lines that are neither a header nor
+            // the next top-level bullet.
+            let j = i + 1;
+            while (j < lines.length &&
+                !BLANK_RE.test(lines[j]) &&
+                !HEADER_RE.test(lines[j]) &&
+                !TOP_BULLET_RE.test(lines[j])) {
+                blockLines.push(lines[j]);
+                j++;
+            }
+            items.push({ kind: 'block', block: { lines: blockLines, section, lead: 'bullet', headerPrefix: '' } });
+            i = j - 1;
+            continue;
+        }
+        items.push({ kind: 'raw', line });
+    }
+    return items;
+}
+/**
+ * Plan a compaction over `memory`. Pure (no I/O) so it is exhaustively testable.
+ * Terminal-state blocks (bullets or h3+ entry headers) are replaced with a
+ * one-line pointer; their full original text is collected into `archiveAppend`.
+ */
+function planCompaction(memory, now) {
+    const items = parseItems(memory);
+    const date = new Date(now).toISOString().slice(0, 10);
+    const outLines = [];
+    const archiveChunks = [];
+    let archivedCount = 0;
+    for (const item of items) {
+        if (item.kind === 'raw') {
+            outLines.push(item.line);
+            continue;
+        }
+        const block = item.block;
+        const head = block.lines[0];
+        if (!isTerminalHead(head)) {
+            outLines.push(...block.lines);
+            continue;
+        }
+        // Archive the full original block; leave a compact pointer behind. The pointer
+        // keeps the block's lead form (a bullet, or the same `### ` header level).
+        const original = block.lines.join('\n');
+        const prefix = block.lead === 'header' ? block.headerPrefix : '- ';
+        const body = head.replace(block.lead === 'header' ? ENTRY_HEADER_RE : TOP_BULLET_RE, '').trim();
+        const label = extractLabel(body);
+        const status = statusOf(head);
+        outLines.push(`${prefix}${label} — ${status}, archived ${date} → ${exports.ARCHIVE_REL_PATH}`);
+        archiveChunks.push(`<!-- archived ${date} from MEMORY.md · ## ${block.section} -->\n${original.trim()}\n`);
+        archivedCount++;
+    }
+    if (archivedCount === 0) {
+        return { nextMemory: memory, archiveAppend: '', archivedCount: 0, charsRemoved: 0 };
+    }
+    const nextMemory = outLines.join('\n');
+    return {
+        nextMemory,
+        archiveAppend: archiveChunks.join('\n'),
+        archivedCount,
+        charsRemoved: Math.max(0, memory.length - nextMemory.length),
+    };
+}
+/** Write `content` to `filePath` atomically (temp in same dir + rename). */
+function atomicWrite(filePath, content) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = path.join(dir, `.tmp-compact-${process.pid}-${process.hrtime.bigint().toString(36)}`);
+    try {
+        fs.writeFileSync(tmp, content, 'utf8');
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch {
+            /* best-effort cleanup */
+        }
+        throw err;
+    }
+}
+function readOnDisk(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Write a rollback pre-image of MEMORY.md before the compaction rewrite. */
+function writeBackup(workspaceDir, original, now) {
+    try {
+        const dir = path.join(workspaceDir, '.dreaming', 'backups');
+        fs.mkdirSync(dir, { recursive: true });
+        atomicWrite(path.join(dir, `MEMORY.md.${now}.compact.bak`), original);
+    }
+    catch {
+        /* best-effort — a failed backup must not block the (archive-first) compaction */
+    }
+}
+/**
+ * Run the deterministic compaction against an agent's MEMORY.md. Never throws;
+ * on any error the memory file is left untouched.
+ *
+ * Ordering is crash-safe: the archive file is appended FIRST, then MEMORY.md is
+ * rewritten. A crash between the two leaves the entries in BOTH files (a harmless
+ * duplicate), never lost. A CAS re-read guards against clobbering a concurrent
+ * agent edit.
+ */
+function compactCompletedEntries(workspaceDir, now = Date.now()) {
+    const none = { archivedCount: 0, charsRemoved: 0, archivePath: null };
+    try {
+        const memPath = path.join(workspaceDir, 'MEMORY.md');
+        const original = readOnDisk(memPath);
+        if (!original.trim())
+            return none;
+        const plan = planCompaction(original, now);
+        if (plan.archivedCount === 0)
+            return none;
+        // Early CAS: if a live agent edited MEMORY.md since we read it, abort BEFORE
+        // touching the archive — otherwise we would append entries that then can't be
+        // removed from MEMORY.md (the late CAS below would block the rewrite), and the
+        // next run would archive them again. Concurrent edits are rare (dreams run in a
+        // quiet window) but this keeps the common case duplicate-free.
+        const memPathNow = readOnDisk(memPath);
+        if (memPathNow !== original)
+            return none;
+        // 1) Archive first (append to the searchable archive file). If a crash happens
+        // between this and the rewrite below, entries live in BOTH files (a harmless
+        // duplicate), never lost.
+        const archivePath = path.join(workspaceDir, exports.ARCHIVE_REL_PATH);
+        const existingArchive = readOnDisk(archivePath);
+        const header = existingArchive
+            ? existingArchive.replace(/\s*$/, '') + '\n\n'
+            : '# Archived completed log entries\n\nMoved out of MEMORY.md by nightly compaction (#337). Still searchable via `memory_search`.\n\n';
+        atomicWrite(archivePath, header + plan.archiveAppend);
+        // 2) Late CAS: re-check immediately before the rewrite (guards the tiny window
+        // between the early check and here).
+        if (readOnDisk(memPath) !== original)
+            return { ...none, archivePath };
+        writeBackup(workspaceDir, original, now);
+        atomicWrite(memPath, plan.nextMemory);
+        return { archivedCount: plan.archivedCount, charsRemoved: plan.charsRemoved, archivePath };
+    }
+    catch {
+        return none;
+    }
+}
+//# sourceMappingURL=compactor.js.map

package/dist/agent/dreaming/compactor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.js","sourceRoot":"","sources":["../../../src/agent/dreaming/compactor.ts"],"names":[],"mappings":"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"}

package/dist/agent/dreaming/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve the effective dreaming config for one agent.
+ *
+ * Precedence mirrors `resolveSkillLearningConfig`: a per-agent override wins over
+ * the global gateway default, which wins over the built-in default. The timezone
+ * is normalized once here (invalid → UTC, lesson #310) so the scheduler never
+ * re-guards.
+ */
+import type { DreamingConfig, ResolvedDreamingCfg, ResolvedStalenessCfg, StalenessConfig } from './types';
+/** Built-in staleness-GC defaults (planning-66). */
+export declare const STALENESS_DEFAULTS: ResolvedStalenessCfg;
+export declare const DREAMING_DEFAULTS: ResolvedDreamingCfg;
+/**
+ * Resolve the staleness-GC sub-config (planning-66). Booleans fall back to the
+ * default when absent/non-boolean; numerics are sanitized like the parent config.
+ */
+export declare function resolveStalenessConfig(agentCfg?: StalenessConfig, globalCfg?: StalenessConfig): ResolvedStalenessCfg;
+export declare function resolveDreamingConfig(agentCfg?: DreamingConfig, globalCfg?: DreamingConfig): ResolvedDreamingCfg;
+//# sourceMappingURL=config.d.ts.map

package/dist/agent/dreaming/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/agent/dreaming/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1G,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,EAAE,oBAOhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,mBAe/B,CAAC;AAsBF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,eAAe,EAC1B,SAAS,CAAC,EAAE,eAAe,GAC1B,oBAAoB,CActB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,cAAc,EACzB,SAAS,CAAC,EAAE,cAAc,GACzB,mBAAmB,CA+BrB"}

package/dist/agent/dreaming/config.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Resolve the effective dreaming config for one agent.
+ *
+ * Precedence mirrors `resolveSkillLearningConfig`: a per-agent override wins over
+ * the global gateway default, which wins over the built-in default. The timezone
+ * is normalized once here (invalid → UTC, lesson #310) so the scheduler never
+ * re-guards.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DREAMING_DEFAULTS = exports.STALENESS_DEFAULTS = void 0;
+exports.resolveStalenessConfig = resolveStalenessConfig;
+exports.resolveDreamingConfig = resolveDreamingConfig;
+const config_1 = require("../skill-learning/config");
+/** Built-in staleness-GC defaults (planning-66). */
+exports.STALENESS_DEFAULTS = {
+    enabled: true,
+    staleTtlDays: 90,
+    keepImportance: 7,
+    minRetrievalKeep: 1,
+    supersession: true,
+    recordRetrievals: true,
+};
+exports.DREAMING_DEFAULTS = {
+    enabled: true,
+    mode: 'auto', // apply consolidation to memory; gated by the K4 applier (#330). Set 'propose' for dry-run.
+    dreamHour: 3,
+    dreamMinute: 0,
+    dreamTimezone: 'UTC',
+    quietMinutes: 30,
+    lookbackDays: 3,
+    maxChangesPerRun: 3,
+    reviewModel: 'claude-haiku-4-5-20251001',
+    promotionThreshold: 0.6,
+    minRecallCount: 2,
+    autoRouteOut: true,
+    staggerWindowMinutes: 30,
+    staleness: exports.STALENESS_DEFAULTS,
+};
+/** Pick the first defined value in precedence order, else the default. */
+function pick(agent, global, fallback) {
+    if (agent !== undefined)
+        return agent;
+    if (global !== undefined)
+        return global;
+    return fallback;
+}
+/**
+ * Sanitize a resolved numeric config value: fall back to the default on
+ * anything non-finite (string/null/NaN/Infinity from untyped JSON config) or
+ * out of [min, max]. Critical for `dreamHour`, which feeds the scheduler delay —
+ * a NaN there would make `setTimeout` fire immediately and the async reviewer
+ * fan out in a tight reschedule loop.
+ */
+function numOr(value, fallback, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    if (value < min || value > max)
+        return fallback;
+    return value;
+}
+/**
+ * Resolve the staleness-GC sub-config (planning-66). Booleans fall back to the
+ * default when absent/non-boolean; numerics are sanitized like the parent config.
+ */
+function resolveStalenessConfig(agentCfg, globalCfg) {
+    const d = exports.STALENESS_DEFAULTS;
+    const bool = (a, g, fb = false) => {
+        const v = pick(a, g, fb);
+        return typeof v === 'boolean' ? v : fb;
+    };
+    return {
+        enabled: bool(agentCfg?.enabled, globalCfg?.enabled, d.enabled),
+        staleTtlDays: numOr(pick(agentCfg?.staleTtlDays, globalCfg?.staleTtlDays, d.staleTtlDays), d.staleTtlDays, 0, Infinity),
+        keepImportance: numOr(pick(agentCfg?.keepImportance, globalCfg?.keepImportance, d.keepImportance), d.keepImportance, 0, 10),
+        minRetrievalKeep: numOr(pick(agentCfg?.minRetrievalKeep, globalCfg?.minRetrievalKeep, d.minRetrievalKeep), d.minRetrievalKeep, 0, Infinity),
+        supersession: bool(agentCfg?.supersession, globalCfg?.supersession, d.supersession),
+        recordRetrievals: bool(agentCfg?.recordRetrievals, globalCfg?.recordRetrievals, d.recordRetrievals),
+    };
+}
+function resolveDreamingConfig(agentCfg, globalCfg) {
+    const d = exports.DREAMING_DEFAULTS;
+    const rawTz = pick(agentCfg?.dreamTimezone, globalCfg?.dreamTimezone, d.dreamTimezone);
+    const mode = pick(agentCfg?.mode, globalCfg?.mode, d.mode);
+    return {
+        enabled: pick(agentCfg?.enabled, globalCfg?.enabled, d.enabled),
+        mode: mode === 'auto' ? 'auto' : 'propose', // anything but 'auto' is 'propose'
+        // dreamHour feeds the scheduler delay — must be a finite hour 0..23.
+        dreamHour: numOr(pick(agentCfg?.dreamHour, globalCfg?.dreamHour, d.dreamHour), d.dreamHour, 0, 23),
+        // dreamMinute pairs with dreamHour for minute-level scheduling — clamp 0..59.
+        dreamMinute: numOr(pick(agentCfg?.dreamMinute, globalCfg?.dreamMinute, d.dreamMinute), d.dreamMinute, 0, 59),
+        dreamTimezone: (0, config_1.isValidTimezone)(rawTz) ? rawTz : 'UTC',
+        quietMinutes: numOr(pick(agentCfg?.quietMinutes, globalCfg?.quietMinutes, d.quietMinutes), d.quietMinutes, 0, Infinity),
+        lookbackDays: numOr(pick(agentCfg?.lookbackDays, globalCfg?.lookbackDays, d.lookbackDays), d.lookbackDays, 0, Infinity),
+        maxChangesPerRun: numOr(pick(agentCfg?.maxChangesPerRun, globalCfg?.maxChangesPerRun, d.maxChangesPerRun), d.maxChangesPerRun, 0, Infinity),
+        reviewModel: pick(agentCfg?.reviewModel, globalCfg?.reviewModel, d.reviewModel),
+        promotionThreshold: numOr(pick(agentCfg?.promotionThreshold, globalCfg?.promotionThreshold, d.promotionThreshold), d.promotionThreshold, 0, 1),
+        minRecallCount: numOr(pick(agentCfg?.minRecallCount, globalCfg?.minRecallCount, d.minRecallCount), d.minRecallCount, 0, Infinity),
+        // planning-67: boolean-safe (ignore non-boolean JSON), default true.
+        autoRouteOut: [agentCfg?.autoRouteOut, globalCfg?.autoRouteOut].find((v) => typeof v === 'boolean') ??
+            d.autoRouteOut,
+        // planning-68: clamp to [0,55] so the jitter never crosses into the next hour.
+        staggerWindowMinutes: numOr(pick(agentCfg?.staggerWindowMinutes, globalCfg?.staggerWindowMinutes, d.staggerWindowMinutes), d.staggerWindowMinutes, 0, 55),
+        staleness: resolveStalenessConfig(agentCfg?.staleness, globalCfg?.staleness),
+    };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/agent/dreaming/config.ts"],"names":[],"mappings":"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"}

package/dist/agent/dreaming/episodic.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Episodic note writer (planning-65) — routes task-log OUT of the injected core
+ * (MEMORY.md) into the searchable `memory/<topic>.md` archive tier.
+ *
+ * MEMORY.md is injected into every prompt (expensive); episodic records of "what
+ * happened" belong in `memory/*.md`, which the knowledge indexer already walks
+ * (`indexer.ts` → `walkMarkdown('memory')`) so the note stays retrievable via
+ * `memory_search` — recall is preserved, the prompt stays small.
+ *
+ * Security: the transcript that drives the dreaming reviewer is untrusted
+ * (prompt-injection surface), so the topic slug is validated against a strict
+ * regex AND the resolved path is realpath-confined under `<ws>/<episodicDir>/`.
+ * A topic that fails validation or escapes the directory is rejected — never
+ * written. Append-only (a dated bullet); never rewrites existing content, so it
+ * cannot destroy prior notes.
+ */
+/** Lowercase-kebab slug, 1..64 chars. No slashes/dots ⇒ cannot escape the dir. */
+export declare const EPISODIC_SLUG_RE: RegExp;
+/** Default episodic archive directory (relative to the agent workspace). */
+export declare const DEFAULT_EPISODIC_DIR = "memory";
+export declare function isValidTopicSlug(topic: unknown): topic is string;
+/**
+ * Resolve `<ws>/<episodicDir>/<topic>.md`, confined under `<ws>/<episodicDir>`.
+ * Returns null for an invalid slug or any path that would escape the base dir
+ * (defense-in-depth on top of the slug regex).
+ */
+export declare function resolveEpisodicPath(workspaceDir: string, episodicDir: string, topic: string): string | null;
+export interface EpisodicWriteResult {
+    topic: string;
+    /** Absolute path written, or '' when the write was rejected/failed. */
+    path: string;
+    ok: boolean;
+    bytesAppended: number;
+}
+/**
+ * Append a dated bullet to `memory/<topic>.md` (creating dir + file on first
+ * write). One entry per line — internal newlines are collapsed so a note stays a
+ * single searchable bullet. Never throws; a rejected/failed write returns
+ * `ok:false` and touches nothing.
+ */
+export declare function appendEpisodicNote(workspaceDir: string, episodicDir: string, topic: string, content: string, now: number): EpisodicWriteResult;
+//# sourceMappingURL=episodic.d.ts.map

package/dist/agent/dreaming/episodic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"episodic.d.ts","sourceRoot":"","sources":["../../../src/agent/dreaming/episodic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,QAA+B,CAAC;AAG7D,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAQf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,mBAAmB,CAqBrB"}