@cleocode/core 2026.4.31 → 2026.4.36

package/dist/memory/mental-model-queue.js.map

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

package/dist/memory/observer-reflector.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Observer/Reflector — LLM-driven session compression for CLEO BRAIN.
+ *
+ * Implements the Mastra-style two-agent compression pattern that achieves
+ * 3-6x context compression on text and 5-40x on tool-call-heavy workloads.
+ *
+ * ## Architecture
+ *
+ * **Observer** (runs after each task or when observation count ≥ threshold):
+ * - Takes raw brain observations from the current session
+ * - Produces 3-5 dense, dated, prioritized observation notes (≤ 300 chars each)
+ * - Compresses verbose tool outputs into 1-line summaries
+ * - Stored as brain_observations with source='observer-compressed'
+ * - Linked to original observation IDs via brain_memory_links table
+ *
+ * **Reflector** (runs at session end when observation count ≥ threshold):
+ * - Takes accumulated observation notes from the current session
+ * - Restructures: combines related items, identifies cross-cutting patterns,
+ *   drops superseded observations
+ * - Outputs stored as brain_patterns and brain_learnings via existing store fns
+ * - Source tagged as 'reflector-synthesized'
+ *
+ * ## LLM Backend
+ *
+ * Calls the Anthropic Messages API directly via native fetch (no SDK dep).
+ * Uses the cheapest available model (`claude-haiku-4-5` or env override).
+ * When `ANTHROPIC_API_KEY` is not set, both functions silently no-op — the
+ * rest of the memory pipeline still runs normally.
+ *
+ * ## Configuration
+ *
+ * Add to `config.json` under `brain.observer`:
+ * ```json
+ * {
+ *   "brain": {
+ *     "observer": {
+ *       "enabled": true,
+ *       "threshold": 10
+ *     },
+ *     "reflector": {
+ *       "enabled": true
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @task T554
+ * @epic T549
+ * @see .cleo/agent-outputs/R-llm-memory-systems-research.md §7 (Observer/Reflector Pattern)
+ */
+/** A single compressed observation produced by the Observer. */
+export interface ObserverNote {
+    /** ISO date string when the original events occurred. */
+    date: string;
+    /**
+     * Priority 1 (highest, architectural) through 5 (lowest, routine).
+     * Maps to the research's RED/YELLOW/GREEN scale.
+     */
+    priority: 1 | 2 | 3 | 4 | 5;
+    /** Dense observation text, ≤ 300 characters. */
+    observation: string;
+    /** IDs of the original observations this note compresses. */
+    source_ids: string[];
+}
+/** Output of `runObserver`. */
+export interface ObserverResult {
+    /** Whether the LLM was invoked (false when no API key or disabled). */
+    ran: boolean;
+    /** Number of new compressed observation entries stored. */
+    stored: number;
+    /** IDs of original observations that were compressed. */
+    compressedIds: string[];
+    /** The raw notes produced by the LLM (for testing/debugging). */
+    notes: ObserverNote[];
+}
+/** A single pattern extracted by the Reflector. */
+export interface ReflectorPattern {
+    pattern: string;
+    context: string;
+}
+/** A single learning extracted by the Reflector. */
+export interface ReflectorLearning {
+    insight: string;
+    confidence: number;
+}
+/** Output of `runReflector`. */
+export interface ReflectorResult {
+    /** Whether the LLM was invoked (false when no API key or disabled). */
+    ran: boolean;
+    /** Number of new patterns stored. */
+    patternsStored: number;
+    /** Number of new learnings stored. */
+    learningsStored: number;
+    /** IDs of observations marked as superseded. */
+    supersededIds: string[];
+}
+/**
+ * Observer configuration resolved from `brain.observer` in config.json,
+ * with safe defaults.
+ */
+export interface ObserverConfig {
+    enabled: boolean;
+    threshold: number;
+}
+/**
+ * Reflector configuration resolved from `brain.reflector` in config.json,
+ * with safe defaults.
+ */
+export interface ReflectorConfig {
+    enabled: boolean;
+}
+/**
+ * Run the Observer on current session observations.
+ *
+ * Triggered when:
+ * 1. `brain.observer.enabled` is true (default)
+ * 2. Uncompressed observation count ≥ `brain.observer.threshold` (default: 10)
+ * 3. `ANTHROPIC_API_KEY` is set in the environment
+ *
+ * Steps:
+ * 1. Fetch up to OBSERVER_BATCH_LIMIT recent uncompressed observations
+ * 2. Call Anthropic LLM with Observer prompt
+ * 3. Parse response as ObserverNote[]
+ * 4. Store each note as brain_observation with source='observer-compressed'
+ * 5. Add graph edges linking compressed notes → source observation IDs
+ *
+ * Always best-effort — errors are caught and logged, never thrown.
+ *
+ * @param projectRoot - Absolute path to project root.
+ * @param sessionId - Current CLEO session ID (used to scope observation query).
+ * @returns ObserverResult with counts and note details.
+ */
+export declare function runObserver(projectRoot: string, sessionId?: string): Promise<ObserverResult>;
+/**
+ * Run the Reflector on accumulated session observation notes.
+ *
+ * Triggered at session end when:
+ * 1. `brain.reflector.enabled` is true (default)
+ * 2. Sufficient observations exist to reflect on (≥ 3)
+ * 3. `ANTHROPIC_API_KEY` is set in the environment
+ *
+ * Steps:
+ * 1. Fetch recent observations (raw + observer-compressed) for the session
+ * 2. Call Anthropic LLM with Reflector prompt
+ * 3. Parse response as { patterns, learnings, superseded }
+ * 4. Store patterns via storePattern()
+ * 5. Store learnings via storeLearning()
+ * 6. Mark superseded observations as invalid (soft-evict)
+ *
+ * Always best-effort — errors are caught and logged, never thrown.
+ *
+ * @param projectRoot - Absolute path to project root.
+ * @param sessionId - Current CLEO session ID.
+ * @returns ReflectorResult with counts.
+ */
+export declare function runReflector(projectRoot: string, sessionId?: string): Promise<ReflectorResult>;
+//# sourceMappingURL=observer-reflector.d.ts.map

package/dist/memory/observer-reflector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-reflector.d.ts","sourceRoot":"","sources":["../../src/memory/observer-reflector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAiDH,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,GAAG,EAAE,OAAO,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,GAAG,EAAE,OAAO,CAAC;IACb,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAkWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CA2EzB;AA2BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAmJ1B"}