@phuetz/code-buddy 1.2.0 → 1.3.0

package/dist/daemon/autonomous-loop.js

@@ -23,6 +23,45 @@
 import { chooseAutonomousModel, } from '../agent/model-tier.js';
 import { beginFleetWork, isFleetSaturated } from '../fleet/fleet-load.js';
 import { DEFAULT_COLAB_GOAL_MAX_TURNS } from './colab-goal.js';
+/**
+ * Default idle self-improvement: author tools for any seed scenario NOT yet in the
+ * evolutionary archive (so it stops once the seed benchmark is covered, and the
+ * bound persists across restarts). Auto-apply; gated by the caller on idle +
+ * CODEBUDDY_SELF_IMPROVE + cooldown.
+ */
+async function defaultSelfImproveHook() {
+    const { EvolutionaryArchive } = await import('../agent/self-improvement/evolutionary-archive.js');
+    const archived = new Set(new EvolutionaryArchive().list().map((e) => e.targetScenarioId));
+    // Tools first.
+    const { ToolImprovementEngine } = await import('../agent/self-improvement/tool-engine.js');
+    const { LlmToolProposer } = await import('../agent/self-improvement/llm-tool-proposer.js');
+    const { SEED_TOOL_SCENARIOS } = await import('../agent/self-improvement/tool-benchmark.js');
+    const uncoveredTools = SEED_TOOL_SCENARIOS.filter((s) => !archived.has(s.id));
+    if (uncoveredTools.length > 0) {
+        const r = await new ToolImprovementEngine({
+            scenarios: uncoveredTools,
+            proposer: new LlmToolProposer(),
+            autonomy: 'auto-apply',
+        }).runCycle();
+        if (r.applied)
+            return { applied: true, detail: `authored tool ${r.gate?.appliedRef}` };
+    }
+    // Then skills.
+    const { SkillImprovementEngine } = await import('../agent/self-improvement/skill-engine.js');
+    const { LlmSkillProposer } = await import('../agent/self-improvement/skill-proposer.js');
+    const { SEED_SKILL_SCENARIOS } = await import('../agent/self-improvement/skill-benchmark.js');
+    const uncoveredSkills = SEED_SKILL_SCENARIOS.filter((s) => !archived.has(s.id));
+    if (uncoveredSkills.length > 0) {
+        const r = await new SkillImprovementEngine({
+            scenarios: uncoveredSkills,
+            proposer: new LlmSkillProposer(),
+            autonomy: 'auto-apply',
+        }).runCycle();
+        if (r.applied)
+            return { applied: true, detail: `authored skill ${r.gate?.appliedRef}` };
+    }
+    return { applied: false, detail: 'all seed tool + skill scenarios already covered (or no proposal)' };
+}
 function resolveGoalMaxTurns(raw) {
     return typeof raw === 'number' && Number.isSafeInteger(raw) && raw > 0
         ? raw
@@ -45,6 +84,10 @@ export class FleetAutonomousLoop {
      */
     failures = new Map();
     goalJudge;
+    selfImprove;
+    selfImproveCooldownMs;
+    now;
+    lastSelfImproveAt = Number.NEGATIVE_INFINITY;
     constructor(config) {
         this.store = config.store;
         this.tierConfig = config.tierConfig;
@@ -52,6 +95,40 @@ export class FleetAutonomousLoop {
         this.policy = config.policy ?? {};
         this.enabled = config.enabled ?? (() => true);
         this.goalJudge = config.goalJudge;
+        this.selfImprove = config.selfImprove ?? defaultSelfImproveHook;
+        this.selfImproveCooldownMs = config.selfImproveCooldownMs ?? 15 * 60 * 1000;
+        this.now = config.now ?? (() => Date.now());
+    }
+    /**
+     * Idle hook: when the queue is empty and self-improvement is opted in, run one
+     * bounded, cooldown-gated improvement cycle instead of sitting fully idle.
+     * Double-gated (idle + CODEBUDDY_SELF_IMPROVE) and bounded (cooldown + the
+     * engine no-ops once seed scenarios are covered). Never throws.
+     */
+    async maybeSelfImprove() {
+        if (process.env.CODEBUDDY_SELF_IMPROVE !== 'true') {
+            this.store.updatePresence({ status: 'idle', currentTask: null });
+            return { outcome: 'idle' };
+        }
+        const now = this.now();
+        if (now - this.lastSelfImproveAt < this.selfImproveCooldownMs) {
+            this.store.updatePresence({ status: 'idle', currentTask: null });
+            return { outcome: 'idle', detail: 'self-improve on cooldown' };
+        }
+        this.lastSelfImproveAt = now;
+        this.store.updatePresence({ status: 'active', currentTask: 'self-improvement' });
+        const doneLoad = beginFleetWork('autonomy.task');
+        try {
+            const r = await this.selfImprove();
+            return { outcome: r.applied ? 'self_improved' : 'idle', detail: r.detail };
+        }
+        catch (err) {
+            return { outcome: 'idle', detail: `self-improve error: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        finally {
+            doneLoad();
+            this.store.updatePresence({ status: 'idle', currentTask: null });
+        }
     }
     /** Run a single autonomous tick. Never throws — failures are logged + reported. */
     async tick() {
@@ -71,8 +148,9 @@ export class FleetAutonomousLoop {
         this.store.updatePresence({ status: 'active' });
         const next = this.store.nextClaimable();
         if (!next) {
-            this.store.updatePresence({ status: 'idle', currentTask: null });
-            return { outcome: 'idle' };
+            // No real work — use the idle moment for one bounded self-improvement
+            // cycle (opt-in + cooldown), otherwise sit idle.
+            return this.maybeSelfImprove();
         }
         // Claim. If another agent won the race between read and claim, treat it as
         // idle for this tick rather than crashing.

package/dist/harness/contract.d.ts

@@ -139,6 +139,7 @@ export declare const runSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     status: "cancelled" | "running" | "completed" | "failed" | "queued" | "waiting_approval";
     id: string;
+    schemaVersion: 1;
     objective: string;
     kind: "run";
     actor: {
@@ -146,7 +147,6 @@ export declare const runSchema: z.ZodObject<{
         id: string;
         provider?: string | undefined;
     };
-    schemaVersion: 1;
     startedAt: number;
     metadata?: {
         tags: string[];
@@ -169,6 +169,7 @@ export declare const runSchema: z.ZodObject<{
 }, {
     status: "cancelled" | "running" | "completed" | "failed" | "queued" | "waiting_approval";
     id: string;
+    schemaVersion: 1;
     objective: string;
     kind: "run";
     actor: {
@@ -176,7 +177,6 @@ export declare const runSchema: z.ZodObject<{
         id: string;
         provider?: string | undefined;
     };
-    schemaVersion: 1;
     startedAt: number;
     metadata?: {
         sessionId?: string | undefined;
@@ -245,8 +245,8 @@ export declare const proofSchema: z.ZodObject<{
     id: string;
     summary: string;
     createdAt: number;
-    kind: "proof";
     schemaVersion: 1;
+    kind: "proof";
     runId: string;
     producedBy: {
         type: "agent" | "human";
@@ -259,8 +259,8 @@ export declare const proofSchema: z.ZodObject<{
     id: string;
     summary: string;
     createdAt: number;
-    kind: "proof";
     schemaVersion: 1;
+    kind: "proof";
     runId: string;
     producedBy: {
         type: "agent" | "human";
@@ -283,17 +283,17 @@ export declare const sensitiveActionSchema: z.ZodObject<{
     name: string;
     id: string;
     scope: string[];
+    schemaVersion: 1;
     kind: "sensitive-action";
     requires: "autonomous" | "dry-run-required" | "approval-required";
-    schemaVersion: 1;
     riskLevel: "low" | "medium" | "high";
     defaultDryRun: boolean;
 }, {
     name: string;
     id: string;
+    schemaVersion: 1;
     kind: "sensitive-action";
     requires: "autonomous" | "dry-run-required" | "approval-required";
-    schemaVersion: 1;
     riskLevel: "low" | "medium" | "high";
     scope?: string[] | undefined;
     defaultDryRun?: boolean | undefined;
@@ -364,6 +364,7 @@ export declare const workflowSchema: z.ZodObject<{
     id: string;
     version: number;
     summary: string;
+    schemaVersion: 1;
     kind: "workflow";
     nodes: {
         id: string;
@@ -371,7 +372,6 @@ export declare const workflowSchema: z.ZodObject<{
         canvasKind: "action" | "trigger" | "logic";
         role?: "edit" | "analysis" | "handoff" | "approval" | "verification" | "gate" | undefined;
     }[];
-    schemaVersion: 1;
     edges: {
         source: string;
         target: string;
@@ -381,6 +381,7 @@ export declare const workflowSchema: z.ZodObject<{
     id: string;
     version: number;
     summary: string;
+    schemaVersion: 1;
     kind: "workflow";
     nodes: {
         id: string;
@@ -388,7 +389,6 @@ export declare const workflowSchema: z.ZodObject<{
         canvasKind: "action" | "trigger" | "logic";
         role?: "edit" | "analysis" | "handoff" | "approval" | "verification" | "gate" | undefined;
     }[];
-    schemaVersion: 1;
     edges?: {
         source: string;
         target: string;
@@ -413,8 +413,8 @@ export declare const approvalSchema: z.ZodObject<{
     id: string;
     target: string;
     decision: "rejected" | "approved";
-    kind: "approval";
     schemaVersion: 1;
+    kind: "approval";
     reviewer: string;
     decidedAt: number;
     scope?: string | undefined;
@@ -425,8 +425,8 @@ export declare const approvalSchema: z.ZodObject<{
     id: string;
     target: string;
     decision: "rejected" | "approved";
-    kind: "approval";
     schemaVersion: 1;
+    kind: "approval";
     reviewer: string;
     decidedAt: number;
     scope?: string | undefined;
@@ -453,17 +453,17 @@ export declare const lessonSchema: z.ZodObject<{
     tags: string[];
     createdAt: number;
     policy: "none" | "lessons" | "handoff";
+    schemaVersion: 1;
     kind: "lesson";
     tier: "technical" | "experience";
-    schemaVersion: 1;
     sourceRunId: string;
 }, {
     content: string;
     id: string;
     createdAt: number;
+    schemaVersion: 1;
     kind: "lesson";
     tier: "technical" | "experience";
-    schemaVersion: 1;
     sourceRunId: string;
     tags?: string[] | undefined;
     policy?: "none" | "lessons" | "handoff" | undefined;
@@ -483,8 +483,8 @@ export declare const capabilitySchema: z.ZodObject<{
     level: "read" | "sensitive" | "reversible-write";
     id: string;
     policy: "autonomous" | "dry-run-required" | "approval-required";
-    kind: "capability";
     schemaVersion: 1;
+    kind: "capability";
     fleetPolicy: "none" | "read-only-help" | "delegated-slices";
     description?: string | undefined;
 }, {
@@ -492,8 +492,8 @@ export declare const capabilitySchema: z.ZodObject<{
     level: "read" | "sensitive" | "reversible-write";
     id: string;
     policy: "autonomous" | "dry-run-required" | "approval-required";
-    kind: "capability";
     schemaVersion: 1;
+    kind: "capability";
     description?: string | undefined;
     fleetPolicy?: "none" | "read-only-help" | "delegated-slices" | undefined;
 }>;
@@ -567,6 +567,7 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
 }, "strict", z.ZodTypeAny, {
     status: "cancelled" | "running" | "completed" | "failed" | "queued" | "waiting_approval";
     id: string;
+    schemaVersion: 1;
     objective: string;
     kind: "run";
     actor: {
@@ -574,7 +575,6 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
         id: string;
         provider?: string | undefined;
     };
-    schemaVersion: 1;
     startedAt: number;
     metadata?: {
         tags: string[];
@@ -597,6 +597,7 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
 }, {
     status: "cancelled" | "running" | "completed" | "failed" | "queued" | "waiting_approval";
     id: string;
+    schemaVersion: 1;
     objective: string;
     kind: "run";
     actor: {
@@ -604,7 +605,6 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
         id: string;
         provider?: string | undefined;
     };
-    schemaVersion: 1;
     startedAt: number;
     metadata?: {
         sessionId?: string | undefined;
@@ -651,8 +651,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     summary: string;
     createdAt: number;
-    kind: "proof";
     schemaVersion: 1;
+    kind: "proof";
     runId: string;
     producedBy: {
         type: "agent" | "human";
@@ -665,8 +665,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     summary: string;
     createdAt: number;
-    kind: "proof";
     schemaVersion: 1;
+    kind: "proof";
     runId: string;
     producedBy: {
         type: "agent" | "human";
@@ -687,17 +687,17 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     name: string;
     id: string;
     scope: string[];
+    schemaVersion: 1;
     kind: "sensitive-action";
     requires: "autonomous" | "dry-run-required" | "approval-required";
-    schemaVersion: 1;
     riskLevel: "low" | "medium" | "high";
     defaultDryRun: boolean;
 }, {
     name: string;
     id: string;
+    schemaVersion: 1;
     kind: "sensitive-action";
     requires: "autonomous" | "dry-run-required" | "approval-required";
-    schemaVersion: 1;
     riskLevel: "low" | "medium" | "high";
     scope?: string[] | undefined;
     defaultDryRun?: boolean | undefined;
@@ -738,6 +738,7 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     version: number;
     summary: string;
+    schemaVersion: 1;
     kind: "workflow";
     nodes: {
         id: string;
@@ -745,7 +746,6 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
         canvasKind: "action" | "trigger" | "logic";
         role?: "edit" | "analysis" | "handoff" | "approval" | "verification" | "gate" | undefined;
     }[];
-    schemaVersion: 1;
     edges: {
         source: string;
         target: string;
@@ -755,6 +755,7 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     version: number;
     summary: string;
+    schemaVersion: 1;
     kind: "workflow";
     nodes: {
         id: string;
@@ -762,7 +763,6 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
         canvasKind: "action" | "trigger" | "logic";
         role?: "edit" | "analysis" | "handoff" | "approval" | "verification" | "gate" | undefined;
     }[];
-    schemaVersion: 1;
     edges?: {
         source: string;
         target: string;
@@ -785,8 +785,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     target: string;
     decision: "rejected" | "approved";
-    kind: "approval";
     schemaVersion: 1;
+    kind: "approval";
     reviewer: string;
     decidedAt: number;
     scope?: string | undefined;
@@ -797,8 +797,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     id: string;
     target: string;
     decision: "rejected" | "approved";
-    kind: "approval";
     schemaVersion: 1;
+    kind: "approval";
     reviewer: string;
     decidedAt: number;
     scope?: string | undefined;
@@ -820,17 +820,17 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     tags: string[];
     createdAt: number;
     policy: "none" | "lessons" | "handoff";
+    schemaVersion: 1;
     kind: "lesson";
     tier: "technical" | "experience";
-    schemaVersion: 1;
     sourceRunId: string;
 }, {
     content: string;
     id: string;
     createdAt: number;
+    schemaVersion: 1;
     kind: "lesson";
     tier: "technical" | "experience";
-    schemaVersion: 1;
     sourceRunId: string;
     tags?: string[] | undefined;
     policy?: "none" | "lessons" | "handoff" | undefined;
@@ -848,8 +848,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     level: "read" | "sensitive" | "reversible-write";
     id: string;
     policy: "autonomous" | "dry-run-required" | "approval-required";
-    kind: "capability";
     schemaVersion: 1;
+    kind: "capability";
     fleetPolicy: "none" | "read-only-help" | "delegated-slices";
     description?: string | undefined;
 }, {
@@ -857,8 +857,8 @@ export declare const harnessArtifactSchema: z.ZodDiscriminatedUnion<"kind", [z.Z
     level: "read" | "sensitive" | "reversible-write";
     id: string;
     policy: "autonomous" | "dry-run-required" | "approval-required";
-    kind: "capability";
     schemaVersion: 1;
+    kind: "capability";
     description?: string | undefined;
     fleetPolicy?: "none" | "read-only-help" | "delegated-slices" | undefined;
 }>]>;

package/dist/identity/identity-manager.js

@@ -16,13 +16,14 @@ import { logger } from '../utils/logger.js';
 // ============================================================================
 // Defaults
 // ============================================================================
+// AGENTS.md and INSTRUCTIONS.md are intentionally NOT here — they are owned by
+// the unified project-context loader (src/context/project-context.ts). Identity
+// covers only the soul/identity tier.
 const DEFAULT_IDENTITY_FILES = [
     'SOUL.md',
     'USER.md',
-    'AGENTS.md',
     'TOOLS.md',
     'IDENTITY.md',
-    'INSTRUCTIONS.md',
     'BOOT.md',
     'BOOTSTRAP.md',
     'HEARTBEAT.md',

package/dist/index.js

@@ -825,7 +825,11 @@ async function applyCustomAgentToolFilter(agentConfig) {
 async function processPromptHeadless(prompt, apiKey, baseURL, model, maxToolRounds, selfHealEnabled = true, outputFormat = 'json', outputSchemaPath, agentName) {
     const previousDisableMCP = process.env.CODEBUDDY_DISABLE_MCP;
     const previousHeadless = process.env.CODEBUDDY_HEADLESS;
-    process.env.CODEBUDDY_DISABLE_MCP = 'true';
+    // Headless defaults MCP OFF (startup cost / determinism), but respect an
+    // explicit opt-in so `CODEBUDDY_DISABLE_MCP=false buddy -p …` can use MCP
+    // servers (e.g. the Code Explorer / gitnexus bridge, or the benchmark's
+    // "with graph" condition). Mirrors the opt-in pattern in goal-cli.ts.
+    process.env.CODEBUDDY_DISABLE_MCP = process.env.CODEBUDDY_DISABLE_MCP ?? 'true';
     process.env.CODEBUDDY_HEADLESS = 'true';
     try {
         const customAgentConfig = await loadCustomAgentForCli(agentName, false);
@@ -834,6 +838,18 @@ async function processPromptHeadless(prompt, apiKey, baseURL, model, maxToolRoun
         const agent = new CodeBuddyAgent(apiKey, baseURL, modelToUse, maxToolRounds);
         await applyActiveLlmFailover(agent);
         await agent.systemPromptReady;
+        // When MCP is opted in for this headless run, wait for the servers to finish
+        // connecting so their tools (e.g. the Code Explorer / gitnexus bridge) are
+        // registered before the first turn — otherwise the one-shot turn races init
+        // and the agent never sees the MCP tools.
+        if (process.env.CODEBUDDY_DISABLE_MCP !== 'true') {
+            try {
+                await agent.getMCPReady();
+            }
+            catch (e) {
+                logger.debug('MCP readiness wait failed (continuing without MCP tools)', { error: String(e) });
+            }
+        }
         if (customAgentConfig?.systemPrompt) {
             agent.setSystemPrompt(customAgentConfig.systemPrompt);
         }

package/dist/mcp/mcp-resources.js

@@ -17,9 +17,8 @@ export function registerResources(server) {
         mimeType: 'text/markdown',
     }, async () => {
         try {
-            const { loadContext, formatContextForPrompt } = await import('../context/context-files.js');
-            const context = await loadContext(process.cwd());
-            let text = formatContextForPrompt(context);
+            const { resolveProjectContext } = await import('../context/project-context.js');
+            let text = resolveProjectContext({ cwd: process.cwd() }).text;
             // Append git status
             try {
                 const { execSync } = await import('child_process');

package/dist/sensory/dreaming.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Dreaming — heartbeat-paced memory consolidation. Every N beats, the short-term
+ * sensory buffer is drained and consolidated into a compact "dream" summary
+ * (counts by kind, salient events, time window, average load) appended to a
+ * long-term dream journal. The heartbeat-paced analogue of OpenClaw's dreaming
+ * (short-term recall → consolidated long-term memory).
+ *
+ * @module sensory/dreaming
+ */
+import type { Perception } from './reactions.js';
+export interface DreamSummary {
+    dreamedAt: number;
+    windowStartMs: number | null;
+    windowEndMs: number | null;
+    total: number;
+    /** "audio/speech_start" → count, "vital/heartbeat" → count, … */
+    byKind: Record<string, number>;
+    salient: Array<{
+        modality?: string;
+        kind?: string;
+        salience?: number;
+        tsMs?: number;
+    }>;
+    avgLoad: number | null;
+}
+/** Pure consolidation: summarize a window of perceptions into a dream. */
+export declare function consolidate(perceptions: Perception[], now: number): DreamSummary;
+export interface DreamingOptions {
+    cwd?: string;
+    now?: number;
+    /** Injectable promotion (tests); defaults to promoteSalientDream. */
+    promote?: (summary: DreamSummary) => Promise<void>;
+}
+/**
+ * One dreaming pass: drain the short-term buffer, consolidate, append to the
+ * dream journal, and promote a SALIENT dream into long-term persistent memory.
+ * Returns the summary, or null if there was nothing to consolidate.
+ */
+export declare function runDreamingPass(options?: DreamingOptions): Promise<DreamSummary | null>;
+/**
+ * Promote a salient dream into Code Buddy's persistent memory under a STABLE key
+ * (`dream:recent`) so repeated promotions UPDATE rather than accumulate (stays
+ * within the memory char budget). Never throws.
+ */
+export declare function promoteSalientDream(summary: DreamSummary): Promise<void>;

package/dist/sensory/dreaming.js

@@ -0,0 +1,114 @@
+/**
+ * Dreaming — heartbeat-paced memory consolidation. Every N beats, the short-term
+ * sensory buffer is drained and consolidated into a compact "dream" summary
+ * (counts by kind, salient events, time window, average load) appended to a
+ * long-term dream journal. The heartbeat-paced analogue of OpenClaw's dreaming
+ * (short-term recall → consolidated long-term memory).
+ *
+ * @module sensory/dreaming
+ */
+import { appendFile, mkdir, stat, rename } from 'fs/promises';
+import path from 'path';
+import { getSensoryMemory } from './sensory-memory.js';
+import { logger } from '../utils/logger.js';
+const SALIENT_THRESHOLD = 128;
+/** Pure consolidation: summarize a window of perceptions into a dream. */
+export function consolidate(perceptions, now) {
+    const byKind = {};
+    const salient = [];
+    let loadSum = 0;
+    let loadN = 0;
+    let minTs = null;
+    let maxTs = null;
+    for (const p of perceptions) {
+        const key = `${p.modality}/${p.kind}`;
+        byKind[key] = (byKind[key] ?? 0) + 1;
+        if ((p.salience ?? 0) >= SALIENT_THRESHOLD) {
+            salient.push({ modality: p.modality, kind: p.kind, salience: p.salience, tsMs: p.tsMs });
+        }
+        const load = p.payload?.load1;
+        if (typeof load === 'number') {
+            loadSum += load;
+            loadN += 1;
+        }
+        // Window on the ingest wall-clock (consistent across senses), not the
+        // sense-relative tsMs (frame-relative for audio vs unix for vital).
+        if (typeof p.receivedAt === 'number') {
+            minTs = minTs === null ? p.receivedAt : Math.min(minTs, p.receivedAt);
+            maxTs = maxTs === null ? p.receivedAt : Math.max(maxTs, p.receivedAt);
+        }
+    }
+    return {
+        dreamedAt: now,
+        windowStartMs: minTs,
+        windowEndMs: maxTs,
+        total: perceptions.length,
+        byKind,
+        salient: salient.slice(0, 20),
+        avgLoad: loadN > 0 ? loadSum / loadN : null,
+    };
+}
+/**
+ * One dreaming pass: drain the short-term buffer, consolidate, append to the
+ * dream journal, and promote a SALIENT dream into long-term persistent memory.
+ * Returns the summary, or null if there was nothing to consolidate.
+ */
+export async function runDreamingPass(options = {}) {
+    const perceptions = getSensoryMemory().drain();
+    if (perceptions.length === 0)
+        return null;
+    const summary = consolidate(perceptions, options.now ?? Date.now());
+    try {
+        const dir = path.join(options.cwd ?? process.cwd(), '.codebuddy', 'companion');
+        await mkdir(dir, { recursive: true });
+        const file = path.join(dir, 'dreams.jsonl');
+        // Rotate when large (the disk-guard lesson): keep one .1 backup, never grow unbounded.
+        try {
+            const info = await stat(file);
+            if (info.size > 512 * 1024)
+                await rename(file, `${file}.1`);
+        }
+        catch {
+            /* no file yet */
+        }
+        await appendFile(file, `${JSON.stringify(summary)}\n`, 'utf8');
+    }
+    catch (err) {
+        logger.warn(`[dreaming] could not persist dream: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Deep consolidation — salient dreams become long-term memory the agent reads.
+    if (summary.salient.length > 0) {
+        await (options.promote ?? promoteSalientDream)(summary);
+    }
+    logger.info(`[dreaming] consolidated ${summary.total} perception(s) → ${Object.keys(summary.byKind).length} kind(s), ${summary.salient.length} salient, avg load ${summary.avgLoad ?? '?'}`);
+    return summary;
+}
+/**
+ * Promote a salient dream into Code Buddy's persistent memory under a STABLE key
+ * (`dream:recent`) so repeated promotions UPDATE rather than accumulate (stays
+ * within the memory char budget). Never throws.
+ */
+export async function promoteSalientDream(summary) {
+    try {
+        const { getMemoryManager } = await import('../memory/persistent-memory.js');
+        const manager = getMemoryManager();
+        await manager.initialize();
+        // Cap the kinds string (a daemon could emit many distinct kinds → an
+        // oversized write that the memory char-limit would reject).
+        const kindEntries = Object.entries(summary.byKind).sort((a, b) => b[1] - a[1]);
+        const kinds = kindEntries
+            .slice(0, 12)
+            .map(([k, n]) => `${k}×${n}`)
+            .join(', ') + (kindEntries.length > 12 ? `, +${kindEntries.length - 12} more` : '');
+        const top = summary.salient
+            .slice(0, 5)
+            .map((s) => `${s.modality}/${s.kind}`)
+            .join(', ');
+        const value = `Recent salient perception: ${summary.total} events (${kinds}); salient: ${top}; avg load ${summary.avgLoad ?? '?'}.`;
+        await manager.remember('dream:recent', value, { scope: 'project', category: 'context', tags: ['dream', 'sensory'] });
+    }
+    catch (err) {
+        logger.warn(`[dreaming] could not promote dream to memory: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=dreaming.js.map