@massa-ai/core 1.2.1

package/dist/services/jobs/memory-consolidation-job.js

@@ -0,0 +1,312 @@
+/**
+ * Background consolidation for long-running memory quality (Phase 1).
+ *
+ * Phase-1 changes vs the legacy Postgres-only job:
+ *   - Removed the `isPostgresEnabled()` short-circuit. The job is now
+ *     backend-polymorphic via `getMemoryRepository()` (mirror of the
+ *     memory-repository-factory dispatch) and `getGraphStore()`.
+ *   - Decay now delegates to the pure `decayScore` (services/memory/decay.ts)
+ *     for BOTH backends; pinned memories are exempt.
+ *   - Prune is now SOFT-delete (`deleted_at` tombstone) instead of hard DELETE,
+ *     and is pinned-aware + deleted_at-aware.
+ *   - New merge phase: clusters near-duplicates via `consolidateWindow` and,
+ *     for each batch, inserts a new memory + a SUPERSEDES edge per source.
+ *   - Emits `memory:consolidated` via EventBus per batch.
+ *   - `ConsolidationStats` extended with `{ merged, batchesCreated }`.
+ *   - LLM-gated + silent-degrade: when the LLM is disabled or fails, the merge
+ *     phase is skipped and the rule-based (decay + prune) path completes with
+ *     `merged=0, batchesCreated=0` and no error propagated.
+ */
+import { logger, MemoryLevel, MemoryRelationType } from "@massa-ai/shared";
+import { randomUUID } from "crypto";
+import { getMemoryRepository } from "../../data/memory/memory-repository-factory.js";
+import { getGraphStore } from "../graph/graph-store-factory.js";
+import { eventBus } from "../events/event-bus.js";
+import { decayScore, DEFAULT_DECAY_PARAMS } from "../memory/decay.js";
+import { consolidateWindow, rowsToCandidates } from "../memory/consolidator.js";
+import { llm as defaultLlmSurface } from "../memory/llm-client.js";
+const DAY = 24 * 60 * 60 * 1000;
+/**
+ * Add a SUPERSEDES edge polymorphically via the unified `IGraphStore` contract.
+ * Both backends accept the same async single-object `createEdge` signature
+ * (structural gap #14), so no duck-typed dispatch is needed.
+ */
+async function addSupercedesEdge(store, newId, sourceId, batchId) {
+    const evidence = JSON.stringify({ batchId, consolidated: true });
+    await store.createEdge({
+        sourceId: newId,
+        targetId: sourceId,
+        relationType: MemoryRelationType.SUPERSEDES,
+        weight: 1.0,
+        evidence,
+        autoExtracted: true,
+    });
+}
+/**
+ * Insert a new memory polymorphically (PostgreSQL insert is sync, PG is async).
+ */
+async function insertMemoryAsync(repo, input) {
+    await Promise.resolve(repo.insert(input));
+}
+export class MemoryConsolidationJob {
+    running = false;
+    lastRunAt = 0;
+    runCount = 0;
+    minIntervalMs = 5 * 60 * 1000;
+    llm;
+    constructor(opts = {}) {
+        // Injectable for tests; defaults to the shared llm-client so production
+        // picks up config + silent-degrade behavior without extra wiring.
+        this.llm = opts.llm ?? defaultLlmSurface;
+    }
+    maybeRun(trigger = "store") {
+        const now = Date.now();
+        if (this.running || now - this.lastRunAt < this.minIntervalMs) {
+            return;
+        }
+        this.lastRunAt = now;
+        void this.runOnce(trigger);
+    }
+    async runOnce(trigger) {
+        this.running = true;
+        this.runCount++;
+        const startedAt = Date.now();
+        try {
+            const stats = await this.consolidate();
+            logger.info("Memory consolidation completed", {
+                trigger,
+                cycle: this.runCount,
+                ...stats,
+                durationMs: Date.now() - startedAt,
+            });
+        }
+        catch (error) {
+            // Defensive: the inner phases swallow their own errors, but a top-level
+            // guard ensures a job-cycle failure never crashes the host process.
+            logger.warn("Memory consolidation skipped", {
+                trigger,
+                error: error.message,
+            });
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /**
+     * Run one consolidation cycle against the active backend. Exposed for tests.
+     */
+    async consolidate() {
+        const now = Date.now();
+        const staleSinceMs = now - 7 * DAY;
+        const repo = getMemoryRepository();
+        // Phase 1: decay — read candidates, compute decayScore, write back.
+        const decayed = await this.decayStaleMemories(repo, staleSinceMs, now);
+        // Phase 1: prune — soft-delete cold + old + low-access memories.
+        const pruned = await this.pruneColdMemories(repo, now);
+        // Phase 0 behavior preserved (session→user promotion) on PG; PostgreSQL no-op.
+        const promoted = await this.promoteSessionMemories(repo, now).catch(() => 0);
+        // Phase 1: merge — cluster + LLM-summarize + SUPERSEDES edges.
+        const graphStore = getGraphStore();
+        const { merged, batchesCreated } = await this.mergeMemories(repo, graphStore, staleSinceMs, now);
+        return { promoted, decayed, pruned, edgesCleaned: 0, merged, batchesCreated };
+    }
+    /**
+     * Decay: for each candidate, compute the pure decayScore and write it back
+     * as the new importance. Pinned + soft-deleted rows are excluded by the
+     * candidate query. Errors per-row are swallowed.
+     */
+    async decayStaleMemories(repo, staleSinceMs, now) {
+        let candidates = [];
+        try {
+            candidates = await Promise.resolve(repo.listConsolidationCandidates(staleSinceMs, 500));
+        }
+        catch (e) {
+            logger.warn("consolidation: candidate list failed (decay)", {
+                error: e.message,
+            });
+            return 0;
+        }
+        let decayed = 0;
+        for (const row of candidates) {
+            const score = decayScore({
+                importance: row.importance,
+                accessCount: row.access_count,
+                createdAt: row.created_at,
+                lastAccessed: row.last_accessed,
+                pinned: row.pinned,
+            }, DEFAULT_DECAY_PARAMS, now);
+            // Only write when the score actually changed (avoid churn).
+            if (Math.abs(score - row.importance) < 1e-6)
+                continue;
+            try {
+                const updated = await Promise.resolve(repo.update(row.id, { importance: score }));
+                if (updated)
+                    decayed++;
+            }
+            catch (e) {
+                logger.warn("consolidation: decay write failed", {
+                    id: row.id,
+                    error: e.message,
+                });
+            }
+        }
+        return decayed;
+    }
+    /**
+     * Prune: soft-delete memories that are old + cold + low-access. Pinned and
+     * already-tombstoned rows are excluded. Uses the soft-delete path so rows
+     * remain restorable; a future ops job can hard-purge long-tombstoned rows.
+     */
+    async pruneColdMemories(repo, now) {
+        const cutoff = now - 45 * DAY;
+        let pruned = 0;
+        // Reuse the candidate list shape but query for cold/old/low-access.
+        // Both repos expose softDeleteById; we drive pruning off a small SQL scan.
+        try {
+            const rows = await Promise.resolve(repo.listConsolidationCandidates(now, 500));
+            for (const row of rows) {
+                if (row.created_at >= cutoff)
+                    continue;
+                const score = decayScore({
+                    importance: row.importance,
+                    accessCount: row.access_count,
+                    createdAt: row.created_at,
+                    lastAccessed: row.last_accessed,
+                    pinned: row.pinned,
+                }, DEFAULT_DECAY_PARAMS, now);
+                if (score < DEFAULT_DECAY_PARAMS.coldThreshold && (row.access_count ?? 0) < 2) {
+                    try {
+                        const ok = await Promise.resolve(repo.softDeleteById(row.id));
+                        if (ok)
+                            pruned++;
+                    }
+                    catch (e) {
+                        logger.warn("consolidation: soft-delete failed", {
+                            id: row.id,
+                            error: e.message,
+                        });
+                    }
+                }
+            }
+        }
+        catch (e) {
+            logger.warn("consolidation: prune scan failed", {
+                error: e.message,
+            });
+        }
+        return pruned;
+    }
+    /**
+     * Merge: cluster near-duplicates and, via the LLM, produce a consolidated
+     * memory that SUPERSEDES its sources. LLM-gated + silent-degrade.
+     */
+    async mergeMemories(repo, graphStore, staleSinceMs, now) {
+        let candidates = [];
+        try {
+            candidates = await Promise.resolve(repo.listConsolidationCandidates(staleSinceMs, 200));
+        }
+        catch (e) {
+            logger.warn("consolidation: candidate list failed (merge)", {
+                error: e.message,
+            });
+            return { merged: 0, batchesCreated: 0 };
+        }
+        const batch = await consolidateWindow(rowsToCandidates(candidates), this.llm, { idFactory: () => `batch-${now}-${randomUUID().slice(0, 8)}` }).catch(() => null);
+        if (!batch)
+            return { merged: 0, batchesCreated: 0 };
+        // Build the new memory from the batch.
+        const sourceRows = candidates.filter((c) => batch.sourceIds.includes(c.id));
+        const newId = `mem-${now}-${randomUUID().slice(0, 8)}`;
+        const importance = sourceRows.length
+            ? Math.min(1, Math.max(...sourceRows.map((r) => r.importance)))
+            : 0.7;
+        const projectId = sourceRows.find((r) => r.project_id)?.project_id ?? null;
+        try {
+            await insertMemoryAsync(repo, {
+                id: newId,
+                content: batch.summary,
+                type: batch.type,
+                level: batch.level,
+                projectId,
+                importance,
+                tags: [],
+                embedding: [], // no embedding for the summary; recall is graph-driven
+                metadata: { batchId: batch.id, consolidated: true, rationale: batch.rationale },
+            });
+        }
+        catch (e) {
+            logger.warn("consolidation: merge insert failed", {
+                batchId: batch.id,
+                error: e.message,
+            });
+            return { merged: 0, batchesCreated: 0 };
+        }
+        // Add a SUPERSEDES edge per source.
+        let edgesAdded = 0;
+        for (const sourceId of batch.sourceIds) {
+            try {
+                await addSupercedesEdge(graphStore, newId, sourceId, batch.id);
+                edgesAdded++;
+            }
+            catch (e) {
+                logger.warn("consolidation: addSupercedesEdge failed", {
+                    newId,
+                    sourceId,
+                    error: e.message,
+                });
+            }
+        }
+        eventBus.publish("memory:consolidated", {
+            batchId: batch.id,
+            sourceIds: batch.sourceIds,
+            newMemoryId: newId,
+            projectId: projectId ?? undefined,
+            stats: { merged: batch.sourceIds.length, batchesCreated: 1 },
+        });
+        return { merged: batch.sourceIds.length, batchesCreated: 1 };
+    }
+    /**
+     * Phase-0 session→user promotion. Preserved for PG; on PostgreSQL this is a
+     * no-op (the original raw-SQL used Postgres `NOW()`/CTE features). Soft-fail.
+     */
+    async promoteSessionMemories(repo, now) {
+        // The PG path used prisma raw SQL; PostgreSQL repo has no equivalent. To keep
+        // this backend-polymorphic without duplicating logic, we skip promotion on
+        // PostgreSQL (candidates already decay via decayScore). PG promotion remains
+        // available via the prisma client if needed in a future phase.
+        const isPg = process.env.DATABASE_URL?.startsWith("postgresql");
+        if (!isPg)
+            return 0;
+        try {
+            // Lazy-import to avoid pulling prisma into the PostgreSQL path.
+            const { getPrismaClient } = await import("../query/prisma-client.js");
+            const prisma = getPrismaClient();
+            const cutoff = new Date(now - DAY);
+            const result = await prisma.$executeRaw `
+        UPDATE memories
+        SET   level      = ${MemoryLevel.USER},
+              importance = LEAST(1.0, importance + 0.08),
+              updated_at = NOW()
+        WHERE id IN (
+          SELECT id FROM memories
+          WHERE level        = ${MemoryLevel.SESSION}
+            AND type         IN ('conversation', 'decision', 'pattern')
+            AND created_at   < ${cutoff}
+            AND importance  >= 0.7
+            AND access_count >= 3
+            AND deleted_at IS NULL
+          LIMIT 120
+        )
+      `;
+            return result;
+        }
+        catch (e) {
+            logger.warn("consolidation: promote (PG) failed", {
+                error: e.message,
+            });
+            return 0;
+        }
+    }
+}
+export const memoryConsolidationJob = new MemoryConsolidationJob();
+//# sourceMappingURL=memory-consolidation-job.js.map

package/dist/services/jobs/memory-consolidation-job.js.map

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

package/dist/services/jobs/observation-consolidation-job.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ObservationConsolidationJob — Phase 3 consolidation bridge.
+ *
+ * Summarizes windows of raw observations (per projectId, by recency) into a
+ * structured memory using the Phase-1 llm-client + consolidator. Reuses
+ * MemoryRepository.insert for the output memory.
+ *
+ * Contract (spec.md R7):
+ *  - Trigger-driven with a debounce (every minObservations OR minIntervalMs),
+ *    fired from the HookService writer turn. Fire-and-forget; never throws.
+ *  - Silent degradation: when !isLlmEnabled(), or consolidateWindow returns
+ *    null (LLM {ok:false}/timeout/empty), the bridge is a no-op. Observations
+ *    are ALWAYS retained (the bridge never deletes them).
+ *
+ * Observations are not memory rows, so the SUPERSEDES edge targets a memory
+ * (the freshly stored summary) only when a prior summary exists for the same
+ * project; sourceIds in the event payload are observation ids (informational).
+ */
+import { type LlmSurface } from "../memory/consolidator.js";
+import type { ObservationStore } from "../../data/memory/observation-repository.js";
+export interface ObservationConsolidationResult {
+    consolidated: boolean;
+    batchesCreated: number;
+}
+export interface ObservationConsolidationJobOptions {
+    llm?: LlmSurface;
+    store?: ObservationStore;
+    /** Override the memory repository (tests). Defaults to getMemoryRepository(). */
+    memoryRepo?: {
+        insert(input: unknown): void | Promise<void>;
+    };
+    /** Override config (tests). */
+    minObservations?: number;
+    minIntervalMs?: number;
+    maxWindow?: number;
+}
+export declare class ObservationConsolidationJob {
+    private readonly llm;
+    private readonly store;
+    private readonly memoryRepo;
+    private readonly minObservations;
+    private readonly minIntervalMs;
+    private readonly maxWindow;
+    private lastRunAt;
+    private newSinceRun;
+    /** Calls observed by tests. */
+    runCalls: number;
+    constructor(opts?: ObservationConsolidationJobOptions);
+    /**
+     * Debounce-gated trigger from the ingest path. Never awaits; never throws.
+     * Resets counters and fires `runOnce` (fire-and-forget) when either threshold
+     * is crossed.
+     */
+    maybeRun(projectId: string): void;
+    /**
+     * Run one consolidation pass for `projectId`. Silent-skip when LLM off or the
+     * window returns no batch. Never throws.
+     */
+    runOnce(projectId: string): Promise<ObservationConsolidationResult>;
+}
+/** Singleton. Tests construct a fresh instance with injected deps. */
+export declare const observationConsolidationJob: ObservationConsolidationJob;
+//# sourceMappingURL=observation-consolidation-job.d.ts.map

package/dist/services/jobs/observation-consolidation-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-consolidation-job.d.ts","sourceRoot":"","sources":["../../../src/services/jobs/observation-consolidation-job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,6CAA6C,CAAC;AAGjG,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kCAAkC;IACjD,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC9D,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6BD,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAC9E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,+BAA+B;IACxB,QAAQ,SAAK;gBAER,IAAI,GAAE,kCAAuC;IAczD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAiCjC;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;CA8G1E;AAED,sEAAsE;AACtE,eAAO,MAAM,2BAA2B,6BAAoC,CAAC"}

package/dist/services/jobs/observation-consolidation-job.js

@@ -0,0 +1,253 @@
+/**
+ * ObservationConsolidationJob — Phase 3 consolidation bridge.
+ *
+ * Summarizes windows of raw observations (per projectId, by recency) into a
+ * structured memory using the Phase-1 llm-client + consolidator. Reuses
+ * MemoryRepository.insert for the output memory.
+ *
+ * Contract (spec.md R7):
+ *  - Trigger-driven with a debounce (every minObservations OR minIntervalMs),
+ *    fired from the HookService writer turn. Fire-and-forget; never throws.
+ *  - Silent degradation: when !isLlmEnabled(), or consolidateWindow returns
+ *    null (LLM {ok:false}/timeout/empty), the bridge is a no-op. Observations
+ *    are ALWAYS retained (the bridge never deletes them).
+ *
+ * Observations are not memory rows, so the SUPERSEDES edge targets a memory
+ * (the freshly stored summary) only when a prior summary exists for the same
+ * project; sourceIds in the event payload are observation ids (informational).
+ */
+import { logger } from "@massa-ai/shared";
+import { randomUUID } from "crypto";
+import { config } from "@massa-ai/shared";
+import { getMemoryRepository } from "../../data/memory/memory-repository-factory.js";
+import { eventBus } from "../events/event-bus.js";
+import { ConsolidatedBatchSchema, } from "../memory/consolidator.js";
+import { llm as defaultLlmSurface } from "../memory/llm-client.js";
+import { getObservationStore } from "../../data/memory/observation-repository.js";
+// Defensive config (mirrors Phase-2 QueryUnderstandingService): real config
+// always has the hooks.bridge block; some test files mock shared config
+// process-wide and omit it. Fall back to spec defaults.
+const FALLBACK_BRIDGE = {
+    enabled: true,
+    minObservations: 8,
+    minIntervalMs: 5 * 60 * 1000,
+    maxWindow: 8,
+};
+function readBridgeConfig() {
+    try {
+        const c = config.get("hooks")?.bridge;
+        if (c && typeof c === "object") {
+            return {
+                enabled: c.enabled ?? FALLBACK_BRIDGE.enabled,
+                minObservations: c.minObservations ?? FALLBACK_BRIDGE.minObservations,
+                minIntervalMs: c.minIntervalMs ?? FALLBACK_BRIDGE.minIntervalMs,
+                maxWindow: c.maxWindow ?? FALLBACK_BRIDGE.maxWindow,
+            };
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return FALLBACK_BRIDGE;
+}
+export class ObservationConsolidationJob {
+    llm;
+    store;
+    memoryRepo;
+    minObservations;
+    minIntervalMs;
+    maxWindow;
+    lastRunAt = 0;
+    newSinceRun = 0;
+    /** Calls observed by tests. */
+    runCalls = 0;
+    constructor(opts = {}) {
+        this.llm = opts.llm ?? defaultLlmSurface;
+        this.store = opts.store ?? getObservationStore();
+        // Lazy getter so the repo is resolved at run-time (not ctor time), unless
+        // a test injects one. This avoids touching the process-wide singleton
+        // during construction (test isolation).
+        const injected = opts.memoryRepo;
+        this.memoryRepo = injected ?? { insert: (i) => getMemoryRepository().insert(i) };
+        const cfg = readBridgeConfig();
+        this.minObservations = opts.minObservations ?? cfg.minObservations;
+        this.minIntervalMs = opts.minIntervalMs ?? cfg.minIntervalMs;
+        this.maxWindow = opts.maxWindow ?? cfg.maxWindow;
+    }
+    /**
+     * Debounce-gated trigger from the ingest path. Never awaits; never throws.
+     * Resets counters and fires `runOnce` (fire-and-forget) when either threshold
+     * is crossed.
+     */
+    maybeRun(projectId) {
+        try {
+            const cfg = readBridgeConfig();
+            if (!cfg.enabled)
+                return;
+            this.newSinceRun++;
+            const now = Date.now();
+            // Fire when EITHER threshold is crossed:
+            //   - enough new observations since last run, OR
+            //   - enough time elapsed since last run (only meaningful after the
+            //     first run — lastRunAt=0 means "never run", so the interval gate is
+            //     not considered satisfied just because (now - 0) is large).
+            const countThresholdMet = this.newSinceRun >= this.minObservations;
+            const intervalThresholdMet = this.lastRunAt !== 0 && now - this.lastRunAt >= this.minIntervalMs;
+            if (!countThresholdMet && !intervalThresholdMet) {
+                return;
+            }
+            this.newSinceRun = 0;
+            this.lastRunAt = now;
+            void this.runOnce(projectId).catch((e) => {
+                logger.warn("observation consolidation: runOnce failed (silent)", {
+                    projectId,
+                    error: e.message,
+                });
+            });
+        }
+        catch (e) {
+            logger.warn("observation consolidation: maybeRun swallowed", {
+                projectId,
+                error: e.message,
+            });
+        }
+    }
+    /**
+     * Run one consolidation pass for `projectId`. Silent-skip when LLM off or the
+     * window returns no batch. Never throws.
+     */
+    async runOnce(projectId) {
+        this.runCalls++;
+        const noop = {
+            consolidated: false,
+            batchesCreated: 0,
+        };
+        // R7 silent-skip: trust the injected surface's enabled flag. The default
+        // surface reads the real config (llm.enabled / RLM_LLM_ENABLED); a test
+        // injects a fake surface whose isEnabled() is authoritative. This avoids
+        // depending on the process-wide shared-config singleton (test-isolation).
+        let llmOn = false;
+        try {
+            llmOn = this.llm.isEnabled();
+        }
+        catch {
+            llmOn = false;
+        }
+        if (!llmOn)
+            return noop;
+        let observations = [];
+        try {
+            observations = this.store.listRecent(projectId, this.maxWindow);
+        }
+        catch (e) {
+            logger.warn("observation consolidation: listRecent failed", {
+                projectId,
+                error: e.message,
+            });
+            return noop;
+        }
+        if (observations.length < 2)
+            return noop;
+        // Observations have no embeddings (they are raw telemetry, not semantic
+        // content), so the cosine-based `consolidateWindow` prefilter cannot seed
+        // a cluster. Instead build a recency window (most-recent N) and call the
+        // LLM object surface directly with the SAME zod schema the memory
+        // consolidator uses (ConsolidatedBatchSchema), reusing the LlmSurface
+        // contract. This keeps the bridge LLM-only (no embedding dependency) and
+        // consistent with the Phase-1 batch shape.
+        const window = observations.slice(0, this.maxWindow);
+        const batchId = `obs-batch-${Date.now()}-${randomUUID().slice(0, 8)}`;
+        const prompt = buildObservationPrompt(window);
+        let batch;
+        try {
+            const res = await this.llm.object(prompt, ConsolidatedBatchSchema);
+            if (!res.ok || !res.value) {
+                return noop; // {ok:false} / timeout / invalid → silent skip
+            }
+            const v = res.value;
+            batch = {
+                id: batchId,
+                sourceIds: v.sourceIds,
+                summary: v.summary,
+                type: v.type,
+                level: v.level,
+                rationale: v.rationale,
+            };
+        }
+        catch (e) {
+            logger.warn("observation consolidation: llm.object threw (silent)", {
+                projectId,
+                error: e.message,
+            });
+            return noop;
+        }
+        if (!batch)
+            return noop;
+        // Store the summary as a memory. Reuse the polymorphic repository.
+        const newId = `mem-${Date.now()}-${randomUUID().slice(0, 8)}`;
+        // Consolidated observations land at a fixed 0.7 importance (above the 0.5
+        // event-scan floor, below hand-curated decisions). No config knob yet — the
+        // prior min/max clamped a literal to itself, so this is equivalent.
+        const importance = 0.7;
+        try {
+            await Promise.resolve(this.memoryRepo.insert({
+                id: newId,
+                content: batch.summary,
+                type: batch.type,
+                level: batch.level,
+                projectId,
+                importance,
+                tags: ["observation-consolidated"],
+                embedding: [],
+                metadata: {
+                    batchId: batch.id,
+                    consolidated: true,
+                    source: "observations",
+                    rationale: batch.rationale,
+                    sourceObservationIds: batch.sourceIds,
+                },
+            }));
+        }
+        catch (e) {
+            logger.warn("observation consolidation: summary insert failed", {
+                batchId: batch.id,
+                error: e.message,
+            });
+            return noop;
+        }
+        eventBus.publish("memory:consolidated", {
+            batchId: batch.id,
+            sourceIds: batch.sourceIds,
+            newMemoryId: newId,
+            projectId: projectId ?? undefined,
+            stats: { merged: batch.sourceIds.length, batchesCreated: 1 },
+        });
+        return { consolidated: true, batchesCreated: 1 };
+    }
+}
+/** Singleton. Tests construct a fresh instance with injected deps. */
+export const observationConsolidationJob = new ObservationConsolidationJob();
+// ── Prompt builder ──────────────────────────────────────────────────────────
+/**
+ * Build the LLM prompt for an observation-consolidation window. Reuses the
+ * Phase-1 ConsolidatedBatchSchema (same {summary,type,level,rationale,sourceIds}
+ * shape) so downstream consumers are uniform. Observations carry their payload
+ * JSON (capped at ingestion) as the only content signal.
+ */
+function buildObservationPrompt(window) {
+    const items = window
+        .map((o, i) => `[${i}] id=${o.id} source=${o.source} importance=${o.importance.toFixed(2)}\n${o.payloadJson}`)
+        .join("\n");
+    return [
+        "You are consolidating a window of passive lifecycle observations (agent telemetry)",
+        "into one structured summary memory. Identify the common theme/work and produce a",
+        "single memory that subsumes the sources. The new memory's type and level must be",
+        "one of the allowed enum values. sourceIds MUST be exactly the provided ids.",
+        "",
+        "Observations:",
+        items,
+        "",
+        "Return JSON: { summary, type, level, rationale, sourceIds }.",
+    ].join("\n");
+}
+//# sourceMappingURL=observation-consolidation-job.js.map

package/dist/services/jobs/observation-consolidation-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-consolidation-job.js","sourceRoot":"","sources":["../../../src/services/jobs/observation-consolidation-job.ts"],"names":[],"mappings":"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"}