@mcp-graph-workflow/mcp-graph 5.29.1 → 5.31.0

package/dist/core/dream/dream-engine.js

@@ -0,0 +1,192 @@
+/**
+ * DreamEngine — Central orchestrator for REM-inspired knowledge consolidation.
+ *
+ * Runs a three-phase "sleep cycle":
+ *   Phase 1 (NREM): Replay + Decay + Prune
+ *   Phase 2 (REM):  Priority + Merge + Associate
+ *   Phase 3 (Wake): Report + Synthesize + Cache Invalidation
+ *
+ * Emits events via GraphEventBus at each phase boundary.
+ * Persists results via dream-store.
+ */
+import { DreamCycleConfigSchema, DEFAULT_DREAM_CONFIG } from "./dream-types.js";
+import { saveDreamCycle, updateDreamCycle } from "./dream-store.js";
+import { runNremPhase } from "./phases/nrem-phase.js";
+import { runRemPhase } from "./phases/rem-phase.js";
+import { runWakeReadyPhase } from "./phases/wake-ready-phase.js";
+import { generateId } from "../utils/id.js";
+import { logger } from "../utils/logger.js";
+export class DreamEngine {
+    db;
+    eventBus;
+    running = false;
+    currentPhase;
+    currentCycleId;
+    cancelled = false;
+    constructor(db, eventBus) {
+        this.db = db;
+        this.eventBus = eventBus;
+    }
+    /**
+     * Run a complete dream cycle (NREM → REM → Wake).
+     */
+    async runCycle(configOverrides) {
+        const config = DreamCycleConfigSchema.parse({ ...DEFAULT_DREAM_CONFIG, ...configOverrides });
+        const cycleId = generateId("dream");
+        this.running = true;
+        this.currentCycleId = cycleId;
+        this.cancelled = false;
+        const startedAt = new Date().toISOString();
+        // Capture before-metrics
+        const beforeMetrics = this.getBeforeMetrics();
+        // Persist initial cycle record
+        const initialResult = {
+            id: cycleId,
+            startedAt,
+            completedAt: "",
+            status: "running",
+            config,
+            phases: {
+                nrem: { replayed: 0, scoresDecayed: 0, pruned: 0, archived: 0, durationMs: 0 },
+                rem: { priorityProcessed: 0, urgencyDecayed: 0, merged: 0, clustersFormed: 0, associationsCreated: 0, durationMs: 0 },
+                wakeReady: { freedTokens: 0, signalToNoise: 0, newGeneralizations: 0, durationMs: 0 },
+            },
+            summary: {
+                totalDocsBefore: beforeMetrics.totalDocs,
+                totalDocsAfter: 0,
+                avgQualityBefore: beforeMetrics.avgQuality,
+                avgQualityAfter: 0,
+                totalPruned: 0,
+                totalMerged: 0,
+                totalAssociations: 0,
+                freedCapacityEstimate: 0,
+            },
+        };
+        if (!config.dryRun) {
+            saveDreamCycle(this.db, initialResult);
+        }
+        this.emitEvent("dream:cycle_started", { cycleId, config: config });
+        try {
+            // ── Phase 1: NREM ──────────────────────────────────
+            this.currentPhase = "nrem";
+            this.emitEvent("dream:phase_started", { cycleId, phase: "nrem" });
+            const nremResult = runNremPhase(this.db, config, cycleId);
+            this.emitEvent("dream:phase_completed", { cycleId, phase: "nrem", durationMs: nremResult.durationMs });
+            if (this.cancelled)
+                return this.buildCancelledResult(cycleId, startedAt, config, nremResult, initialResult);
+            // ── Phase 2: REM ───────────────────────────────────
+            this.currentPhase = "rem";
+            this.emitEvent("dream:phase_started", { cycleId, phase: "rem" });
+            const remResult = runRemPhase(this.db, config, cycleId);
+            this.emitEvent("dream:phase_completed", { cycleId, phase: "rem", durationMs: remResult.durationMs });
+            if (this.cancelled)
+                return this.buildCancelledResult(cycleId, startedAt, config, nremResult, initialResult);
+            // ── Phase 3: Wake Ready ────────────────────────────
+            this.currentPhase = "wake-ready";
+            this.emitEvent("dream:phase_started", { cycleId, phase: "wake-ready" });
+            const wakeResult = runWakeReadyPhase(this.db, {
+                totalDocsBefore: beforeMetrics.totalDocs,
+                avgQualityBefore: beforeMetrics.avgQuality,
+            });
+            this.emitEvent("dream:phase_completed", { cycleId, phase: "wake-ready", durationMs: wakeResult.durationMs });
+            // ── Build final result ─────────────────────────────
+            const afterMetrics = this.getBeforeMetrics();
+            const completedAt = new Date().toISOString();
+            const totalDurationMs = nremResult.durationMs + remResult.durationMs + wakeResult.durationMs;
+            const result = {
+                id: cycleId,
+                startedAt,
+                completedAt,
+                status: "completed",
+                config,
+                phases: { nrem: nremResult, rem: remResult, wakeReady: wakeResult },
+                summary: {
+                    totalDocsBefore: beforeMetrics.totalDocs,
+                    totalDocsAfter: afterMetrics.totalDocs,
+                    avgQualityBefore: beforeMetrics.avgQuality,
+                    avgQualityAfter: afterMetrics.avgQuality,
+                    totalPruned: nremResult.pruned,
+                    totalMerged: remResult.merged,
+                    totalAssociations: remResult.associationsCreated,
+                    freedCapacityEstimate: wakeResult.freedTokens,
+                },
+            };
+            if (!config.dryRun) {
+                updateDreamCycle(this.db, result);
+            }
+            this.emitEvent("dream:cycle_completed", {
+                cycleId,
+                totalPruned: nremResult.pruned,
+                totalMerged: remResult.merged,
+                durationMs: totalDurationMs,
+            });
+            logger.info("dream:cycle:complete", { cycleId, durationMs: totalDurationMs });
+            return result;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            this.emitEvent("dream:cycle_failed", { cycleId, errorMessage });
+            logger.error("dream:cycle:failed", { cycleId, error: errorMessage });
+            throw err;
+        }
+        finally {
+            this.running = false;
+            this.currentPhase = undefined;
+            this.currentCycleId = undefined;
+        }
+    }
+    /**
+     * Cancel a running cycle. The cycle will stop after the current phase.
+     */
+    cancelCycle() {
+        this.cancelled = true;
+        logger.info("dream:cycle:cancel_requested", { cycleId: this.currentCycleId });
+    }
+    /**
+     * Get current engine status.
+     */
+    getStatus() {
+        return {
+            running: this.running,
+            currentPhase: this.currentPhase,
+            progress: this.running ? this.estimateProgress() : undefined,
+            cycleId: this.currentCycleId,
+        };
+    }
+    // ── Private helpers ────────────────────────────────────
+    getBeforeMetrics() {
+        const row = this.db
+            .prepare("SELECT COUNT(*) as cnt, COALESCE(AVG(quality_score), 0) as avg_q FROM knowledge_documents")
+            .get();
+        return { totalDocs: row.cnt, avgQuality: row.avg_q };
+    }
+    estimateProgress() {
+        if (!this.currentPhase)
+            return 0;
+        const phaseProgress = {
+            "nrem": 0.33,
+            "rem": 0.66,
+            "wake-ready": 0.9,
+        };
+        return phaseProgress[this.currentPhase] ?? 0;
+    }
+    emitEvent(type, payload) {
+        this.eventBus.emit({
+            type,
+            timestamp: new Date().toISOString(),
+            payload,
+        });
+    }
+    buildCancelledResult(cycleId, startedAt, config, nremResult, initial) {
+        return {
+            ...initial,
+            id: cycleId,
+            startedAt,
+            completedAt: new Date().toISOString(),
+            status: "cancelled",
+            config,
+            phases: { ...initial.phases, nrem: nremResult },
+        };
+    }
+}
+//# sourceMappingURL=dream-engine.js.map

package/dist/core/dream/dream-engine.js.map

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

package/dist/core/dream/dream-store.d.ts

@@ -0,0 +1,19 @@
+import type Database from "better-sqlite3";
+import type { DreamCycleResult } from "./dream-types.js";
+export interface DreamArchiveEntry {
+    id: string;
+    originalDocId: string;
+    title: string;
+    sourceType: string;
+    qualityScore: number | null;
+    reason: "pruned" | "merged" | "archived";
+    archivedAt: string;
+    cycleId: string;
+}
+export declare function saveDreamCycle(db: Database.Database, cycle: DreamCycleResult): void;
+export declare function updateDreamCycle(db: Database.Database, cycle: DreamCycleResult): void;
+export declare function getDreamCycle(db: Database.Database, id: string): DreamCycleResult | null;
+export declare function listDreamCycles(db: Database.Database, limit?: number): DreamCycleResult[];
+export declare function archiveDreamDoc(db: Database.Database, entry: DreamArchiveEntry): void;
+export declare function listDreamArchive(db: Database.Database, cycleId: string): DreamArchiveEntry[];
+//# sourceMappingURL=dream-store.d.ts.map

package/dist/core/dream/dream-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-store.d.ts","sourceRoot":"","sources":["../../../src/core/dream/dream-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKzD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2BD,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAenF;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAcrF;AAID,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAIxF;AAID,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAE,MAAW,GAAG,gBAAgB,EAAE,CAK7F;AAID,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAgBrF;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAK5F"}

package/dist/core/dream/dream-store.js

@@ -0,0 +1,86 @@
+import { logger } from "../utils/logger.js";
+// ─── Save a new dream cycle ───
+export function saveDreamCycle(db, cycle) {
+    const stmt = db.prepare(`
+    INSERT INTO dream_cycles (id, status, config, result, started_at, completed_at, error_message)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
+  `);
+    stmt.run(cycle.id, cycle.status, JSON.stringify(cycle.config), JSON.stringify({ phases: cycle.phases, summary: cycle.summary }), cycle.startedAt, cycle.completedAt || null, null);
+    logger.debug("dream-store:save", { cycleId: cycle.id, status: cycle.status });
+}
+// ─── Update an existing dream cycle ───
+export function updateDreamCycle(db, cycle) {
+    const stmt = db.prepare(`
+    UPDATE dream_cycles
+    SET status = ?, result = ?, completed_at = ?, error_message = ?
+    WHERE id = ?
+  `);
+    stmt.run(cycle.status, JSON.stringify({ phases: cycle.phases, summary: cycle.summary }), cycle.completedAt || null, null, cycle.id);
+    logger.debug("dream-store:update", { cycleId: cycle.id, status: cycle.status });
+}
+// ─── Get a single dream cycle by ID ───
+export function getDreamCycle(db, id) {
+    const row = db.prepare("SELECT * FROM dream_cycles WHERE id = ?").get(id);
+    if (!row)
+        return null;
+    return rowToCycleResult(row);
+}
+// ─── List dream cycles (most recent first) ───
+export function listDreamCycles(db, limit = 50) {
+    const rows = db
+        .prepare("SELECT * FROM dream_cycles ORDER BY started_at DESC LIMIT ?")
+        .all(limit);
+    return rows.map(rowToCycleResult);
+}
+// ─── Archive a document (soft-delete tracking) ───
+export function archiveDreamDoc(db, entry) {
+    const stmt = db.prepare(`
+    INSERT INTO dream_archive (id, original_doc_id, title, source_type, quality_score, reason, archived_at, cycle_id)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    stmt.run(entry.id, entry.originalDocId, entry.title, entry.sourceType, entry.qualityScore, entry.reason, entry.archivedAt, entry.cycleId);
+    logger.debug("dream-store:archive", { docId: entry.originalDocId, reason: entry.reason });
+}
+// ─── List archived docs for a cycle ───
+export function listDreamArchive(db, cycleId) {
+    const rows = db
+        .prepare("SELECT * FROM dream_archive WHERE cycle_id = ? ORDER BY archived_at ASC")
+        .all(cycleId);
+    return rows.map(rowToArchiveEntry);
+}
+// ─── Internal converters ───
+function rowToCycleResult(row) {
+    const config = JSON.parse(row.config);
+    const resultData = row.result ? JSON.parse(row.result) : null;
+    return {
+        id: row.id,
+        startedAt: row.started_at,
+        completedAt: row.completed_at ?? "",
+        status: row.status,
+        config,
+        phases: resultData?.phases ?? {
+            nrem: { replayed: 0, scoresDecayed: 0, pruned: 0, archived: 0, durationMs: 0 },
+            rem: { priorityProcessed: 0, urgencyDecayed: 0, merged: 0, clustersFormed: 0, associationsCreated: 0, durationMs: 0 },
+            wakeReady: { freedTokens: 0, signalToNoise: 0, newGeneralizations: 0, durationMs: 0 },
+        },
+        summary: resultData?.summary ?? {
+            totalDocsBefore: 0, totalDocsAfter: 0,
+            avgQualityBefore: 0, avgQualityAfter: 0,
+            totalPruned: 0, totalMerged: 0,
+            totalAssociations: 0, freedCapacityEstimate: 0,
+        },
+    };
+}
+function rowToArchiveEntry(row) {
+    return {
+        id: row.id,
+        originalDocId: row.original_doc_id,
+        title: row.title,
+        sourceType: row.source_type,
+        qualityScore: row.quality_score,
+        reason: row.reason,
+        archivedAt: row.archived_at,
+        cycleId: row.cycle_id,
+    };
+}
+//# sourceMappingURL=dream-store.js.map

package/dist/core/dream/dream-store.js.map

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

package/dist/core/dream/dream-types.d.ts

@@ -0,0 +1,128 @@
+import { z } from "zod/v4";
+export declare const DreamPhaseSchema: z.ZodEnum<{
+    nrem: "nrem";
+    rem: "rem";
+    "wake-ready": "wake-ready";
+}>;
+export type DreamPhase = z.infer<typeof DreamPhaseSchema>;
+export declare const DreamCycleStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    idle: "idle";
+    running: "running";
+    completed: "completed";
+    cancelled: "cancelled";
+}>;
+export type DreamCycleStatus = z.infer<typeof DreamCycleStatusSchema>;
+export declare const DreamCycleConfigSchema: z.ZodObject<{
+    pruneThreshold: z.ZodDefault<z.ZodNumber>;
+    decayFactor: z.ZodDefault<z.ZodNumber>;
+    urgencyDecayFactor: z.ZodDefault<z.ZodNumber>;
+    maxReplayBatch: z.ZodDefault<z.ZodNumber>;
+    mergeSimThreshold: z.ZodDefault<z.ZodNumber>;
+    associationBoostFactor: z.ZodDefault<z.ZodNumber>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DreamCycleConfig = z.infer<typeof DreamCycleConfigSchema>;
+export declare const DEFAULT_DREAM_CONFIG: DreamCycleConfig;
+export declare const NremPhaseResultSchema: z.ZodObject<{
+    replayed: z.ZodNumber;
+    scoresDecayed: z.ZodNumber;
+    pruned: z.ZodNumber;
+    archived: z.ZodNumber;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type NremPhaseResult = z.infer<typeof NremPhaseResultSchema>;
+export declare const RemPhaseResultSchema: z.ZodObject<{
+    priorityProcessed: z.ZodNumber;
+    urgencyDecayed: z.ZodNumber;
+    merged: z.ZodNumber;
+    clustersFormed: z.ZodNumber;
+    associationsCreated: z.ZodNumber;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type RemPhaseResult = z.infer<typeof RemPhaseResultSchema>;
+export declare const WakeReadyResultSchema: z.ZodObject<{
+    freedTokens: z.ZodNumber;
+    signalToNoise: z.ZodNumber;
+    newGeneralizations: z.ZodNumber;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export type WakeReadyResult = z.infer<typeof WakeReadyResultSchema>;
+export declare const DreamSummarySchema: z.ZodObject<{
+    totalDocsBefore: z.ZodNumber;
+    totalDocsAfter: z.ZodNumber;
+    avgQualityBefore: z.ZodNumber;
+    avgQualityAfter: z.ZodNumber;
+    totalPruned: z.ZodNumber;
+    totalMerged: z.ZodNumber;
+    totalAssociations: z.ZodNumber;
+    freedCapacityEstimate: z.ZodNumber;
+}, z.core.$strip>;
+export type DreamSummary = z.infer<typeof DreamSummarySchema>;
+export declare const DreamCycleResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    startedAt: z.ZodString;
+    completedAt: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        idle: "idle";
+        running: "running";
+        completed: "completed";
+        cancelled: "cancelled";
+    }>;
+    config: z.ZodObject<{
+        pruneThreshold: z.ZodDefault<z.ZodNumber>;
+        decayFactor: z.ZodDefault<z.ZodNumber>;
+        urgencyDecayFactor: z.ZodDefault<z.ZodNumber>;
+        maxReplayBatch: z.ZodDefault<z.ZodNumber>;
+        mergeSimThreshold: z.ZodDefault<z.ZodNumber>;
+        associationBoostFactor: z.ZodDefault<z.ZodNumber>;
+        dryRun: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    phases: z.ZodObject<{
+        nrem: z.ZodObject<{
+            replayed: z.ZodNumber;
+            scoresDecayed: z.ZodNumber;
+            pruned: z.ZodNumber;
+            archived: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        rem: z.ZodObject<{
+            priorityProcessed: z.ZodNumber;
+            urgencyDecayed: z.ZodNumber;
+            merged: z.ZodNumber;
+            clustersFormed: z.ZodNumber;
+            associationsCreated: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        wakeReady: z.ZodObject<{
+            freedTokens: z.ZodNumber;
+            signalToNoise: z.ZodNumber;
+            newGeneralizations: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        totalDocsBefore: z.ZodNumber;
+        totalDocsAfter: z.ZodNumber;
+        avgQualityBefore: z.ZodNumber;
+        avgQualityAfter: z.ZodNumber;
+        totalPruned: z.ZodNumber;
+        totalMerged: z.ZodNumber;
+        totalAssociations: z.ZodNumber;
+        freedCapacityEstimate: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DreamCycleResult = z.infer<typeof DreamCycleResultSchema>;
+export declare const DreamStatusSchema: z.ZodObject<{
+    running: z.ZodBoolean;
+    currentPhase: z.ZodOptional<z.ZodEnum<{
+        nrem: "nrem";
+        rem: "rem";
+        "wake-ready": "wake-ready";
+    }>>;
+    progress: z.ZodOptional<z.ZodNumber>;
+    cycleId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DreamStatus = z.infer<typeof DreamStatusSchema>;
+//# sourceMappingURL=dream-types.d.ts.map

package/dist/core/dream/dream-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-types.d.ts","sourceRoot":"","sources":["../../../src/core/dream/dream-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,gBAAgB;;;;EAAwC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,sBAAsB;;;;;;EAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,sBAAsB;;;;;;;;iBAejC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB,EAAE,gBAAmD,CAAC;AAIvF,eAAO,MAAM,qBAAqB;;;;;;iBAWhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;iBAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,kBAAkB;;;;;;;;;iBAS7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/core/dream/dream-types.js

@@ -0,0 +1,99 @@
+import { z } from "zod/v4";
+// ─── Dream Phase (maps to biological sleep phases) ───
+export const DreamPhaseSchema = z.enum(["nrem", "rem", "wake-ready"]);
+// ─── Dream Cycle Status ───
+export const DreamCycleStatusSchema = z.enum([
+    "idle",
+    "running",
+    "completed",
+    "failed",
+    "cancelled",
+]);
+// ─── Dream Cycle Config (tunable parameters) ───
+export const DreamCycleConfigSchema = z.object({
+    /** Quality score below which docs are pruned (0-1) */
+    pruneThreshold: z.number().min(0).max(1).default(0.15),
+    /** Proportional downscale factor per cycle (0-1) */
+    decayFactor: z.number().min(0).max(1).default(0.85),
+    /** Separate urgency decay factor (0-1) */
+    urgencyDecayFactor: z.number().min(0).max(1).default(0.7),
+    /** Max docs to replay per NREM phase */
+    maxReplayBatch: z.number().int().positive().default(200),
+    /** Cosine similarity threshold for merging (0-1) */
+    mergeSimThreshold: z.number().min(0).max(1).default(0.92),
+    /** Co-access association strength boost (0-0.5) */
+    associationBoostFactor: z.number().min(0).max(0.5).default(0.1),
+    /** Preview mode — no mutations */
+    dryRun: z.boolean().default(false),
+});
+export const DEFAULT_DREAM_CONFIG = DreamCycleConfigSchema.parse({});
+// ─── Phase Results ───
+export const NremPhaseResultSchema = z.object({
+    /** Docs replayed (recordAccess called) */
+    replayed: z.number().int().min(0),
+    /** Docs with quality scores downscaled */
+    scoresDecayed: z.number().int().min(0),
+    /** Docs below threshold removed */
+    pruned: z.number().int().min(0),
+    /** Docs archived (soft-deleted) */
+    archived: z.number().int().min(0),
+    /** Phase duration in milliseconds */
+    durationMs: z.number().min(0),
+});
+export const RemPhaseResultSchema = z.object({
+    /** Error/blocker tagged items re-consolidated */
+    priorityProcessed: z.number().int().min(0),
+    /** Urgency signals decayed */
+    urgencyDecayed: z.number().int().min(0),
+    /** Similar entries merged */
+    merged: z.number().int().min(0),
+    /** Re-clustering result */
+    clustersFormed: z.number().int().min(0),
+    /** Co-access links strengthened */
+    associationsCreated: z.number().int().min(0),
+    /** Phase duration in milliseconds */
+    durationMs: z.number().min(0),
+});
+export const WakeReadyResultSchema = z.object({
+    /** Estimated tokens freed */
+    freedTokens: z.number().min(0),
+    /** Before/after quality ratio */
+    signalToNoise: z.number().min(0),
+    /** Cross-memory synthesis docs created */
+    newGeneralizations: z.number().int().min(0),
+    /** Phase duration in milliseconds */
+    durationMs: z.number().min(0),
+});
+// ─── Dream Summary ───
+export const DreamSummarySchema = z.object({
+    totalDocsBefore: z.number().int().min(0),
+    totalDocsAfter: z.number().int().min(0),
+    avgQualityBefore: z.number().min(0).max(1),
+    avgQualityAfter: z.number().min(0).max(1),
+    totalPruned: z.number().int().min(0),
+    totalMerged: z.number().int().min(0),
+    totalAssociations: z.number().int().min(0),
+    freedCapacityEstimate: z.number().min(0),
+});
+// ─── Dream Cycle Result ───
+export const DreamCycleResultSchema = z.object({
+    id: z.string(),
+    startedAt: z.string(),
+    completedAt: z.string(),
+    status: DreamCycleStatusSchema,
+    config: DreamCycleConfigSchema,
+    phases: z.object({
+        nrem: NremPhaseResultSchema,
+        rem: RemPhaseResultSchema,
+        wakeReady: WakeReadyResultSchema,
+    }),
+    summary: DreamSummarySchema,
+});
+// ─── Dream Status (runtime state) ───
+export const DreamStatusSchema = z.object({
+    running: z.boolean(),
+    currentPhase: DreamPhaseSchema.optional(),
+    progress: z.number().min(0).max(1).optional(),
+    cycleId: z.string().optional(),
+});
+//# sourceMappingURL=dream-types.js.map

package/dist/core/dream/dream-types.js.map

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

package/dist/core/dream/phases/nrem-phase.d.ts

@@ -0,0 +1,21 @@
+/**
+ * NREM Phase — Memory Replay + Synaptic Homeostasis + Pruning
+ *
+ * Biological basis:
+ * - Memory Replay (Wilson & McNaughton 1994): hippocampal neurons replay
+ *   experiences during sleep, strengthening important traces.
+ * - Synaptic Homeostasis (Tononi & Cirelli 2014): proportional downscaling
+ *   of all synaptic strengths during slow-wave sleep.
+ * - Synaptic Pruning: weak connections below threshold are eliminated.
+ */
+import type Database from "better-sqlite3";
+import type { DreamCycleConfig, NremPhaseResult } from "../dream-types.js";
+/**
+ * Run the NREM phase of a dream cycle.
+ *
+ * 1. Replay: refresh access timestamps on recent high-quality docs
+ * 2. Decay: proportionally downscale all quality scores
+ * 3. Prune: archive + delete docs below threshold
+ */
+export declare function runNremPhase(db: Database.Database, config: DreamCycleConfig, cycleId: string): NremPhaseResult;
+//# sourceMappingURL=nrem-phase.d.ts.map

package/dist/core/dream/phases/nrem-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nrem-phase.d.ts","sourceRoot":"","sources":["../../../../src/core/dream/phases/nrem-phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAc3E;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,GACd,eAAe,CAgBjB"}