@devflow-tools/memory-engine 0.14.4 → 0.16.0

package/README.md

@@ -1,6 +1,6 @@
 # @devflow-tools/memory-engine
 
-DevFlow 记忆引擎 — 从 tool call events 自动提取项目约定、错误教训和技术栈信息，支持审核、搜索和分层管理。
+DevFlow 记忆引擎存储 session tool events、结构化 observations 和已审核记忆，并为宿主模型驱动的 MCP 提炼流程提供持久化与搜索能力。
 
 ## Installation
 
@@ -11,47 +11,48 @@ npm install @devflow-tools/memory-engine
 ## Usage
 
 ```typescript
-import { MemoryEngine } from '@devflow-tools/memory-engine';
-
-const engine = new MemoryEngine({ projectRoot: '/path/to/project' });
-
-// 记录 tool call 事件（触达自动提取）
-await engine.recordEvent({
-  tool: 'bash',
-  command: 'npm install',
-  exitCode: 0,
-  stderr: null,
+import { MemoryGate } from '@devflow-tools/memory-engine';
+
+const memory = new MemoryGate('/path/to/project');
+await memory.forceWarmUp();
+
+// Hook producers record events for next-session MCP distillation.
+await memory.recordEvent({
+  id: 'event-1',
+  sessionId: 'session-1',
+  tool: 'Bash',
+  command: 'npm test',
+  exitCode: 1,
+  stderr: 'Tests: 1 failed',
   durationMs: 3200,
+  createdAt: Date.now(),
 });
 
-// 提取记忆（L1 错误学习 + L2 修正检测）
-const memories = await engine.extractMemories('session:my-project');
-
-// 查看候选记忆
-const candidates = await engine.getCandidates();
-
-// 审核候选
-await engine.approveCandidate('mem:123');
-await engine.rejectCandidate('mem:456');
+// On the next session, the host calls the MCP tool memory_request_distill.
+// The host model summarizes the leased events and saves observations through
+// memory_save_distilled. No local model service is required.
 ```
 
 ## Features
 
-- **L1 错误学习** — 从 tool call 的 exitCode、stderr 和 command 关键词自动提取失败教训
-- **L2 修正检测** — 识别"失败→随后成功"的命令修正模式
-- **候选审核** — AI 提取的记忆以 `pending` 状态入队，用户 approve/reject 后生效
+- **Session event storage** — 持久化 hook tool events，供下一会话按批次租约读取
+- **Host-model distillation** — `memory_request_distill` 返回待处理事件，宿主模型生成 observations
+- **Signal analysis** — 规则评分用于缓冲和分组，不生成 LLM 记忆
+- **候选审核** — 结构化记忆支持 approve/reject 生命周期
 - **分层管理** — 项目层（技术栈、约定）、用户层（偏好）、全局层（最佳实践）
 - **BM25 搜索** — 按内容和类型搜索已审核记忆
 
 ## API
 
-- `new MemoryEngine({ projectRoot })` — 构造函数
+- `new MemoryGate(projectRoot)` — 创建项目记忆入口
+- `.forceWarmUp()` — 初始化项目存储
 - `.getAll()` — 获取所有已审核记忆
 - `.getCandidates()` — 获取待审核的候选记忆
 - `.approveCandidate(id)` — 批准候选记忆
 - `.rejectCandidate(id)` — 拒绝候选记忆（标记为 rejected）
-- `.recordEvent(event)` — 记录 tool call event，供提取器分析
-- `.extractMemories(sessionId)` — 从 session 中提取记忆并生成候选
+- `.recordEvent(event)` — 将 hook event 写入 `session_events`
+- `.getPendingDistillData()` — 为 MCP `memory_request_distill` 租约并返回待处理事件
+- `.saveDistilledObservationsByBatch(batchId, observations)` — 保存宿主模型提炼结果
 - `.search(query, options?)` — 搜索记忆（支持 category/source 过滤）
 - `.listMemories(filter?)` — 按条件列出记忆
 - `.getUserPreferences()` — 获取用户偏好

package/dist/consolidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidator.d.ts","sourceRoot":"","sources":["../src/consolidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BrD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAuK7B"}
+{"version":3,"file":"consolidator.d.ts","sourceRoot":"","sources":["../src/consolidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,kBAAkB,CAAC,CA6E7B"}

package/dist/consolidator.js

@@ -1,23 +1,3 @@
-import { callLLM } from './llm-provider.js';
-// ── Prompt ──────────────────────────────────────────────
-const CONSOLIDATOR_SYSTEM = `You are a knowledge consolidator for DevFlow.
-Given multiple observations about the same concept from different coding sessions,
-produce ONE consolidated memory entry.
-
-Output JSON:
-{
-  "type": "semantic" | "pattern" | "constraint" | "preference" | "lesson",
-  "title": "≤80 chars",
-  "content": "1-2 sentence consolidated knowledge",
-  "confidence": 0.0-1.0,
-  "supersedes_observation_ids": ["obs:...", ...]
-}
-
-Rules:
-- Merge complementary facts; discard contradictory outliers
-- Higher confidence when observations are consistent across sessions
-- If observations disagree, pick the majority view and note uncertainty in content
-- Return ONLY the JSON object`;
 // ── Consolidator ────────────────────────────────────────
 export async function consolidate(store, projectRoot, options) {
     const start = Date.now();
@@ -46,139 +26,44 @@ export async function consolidate(store, projectRoot, options) {
             .map(id => store.getObservation(id))
             .filter(Boolean),
     }));
-    // 3. LLM aggregation (1 call for all clusters)
-    let provider = 'rules';
+    // 3. Rule-based: pick highest-importance observation per cluster as representative
     let consolidated = 0;
-    try {
-        const userPrompt = buildConsolidationPrompt(clusterData);
-        const response = await callLLM(CONSOLIDATOR_SYSTEM, userPrompt);
-        provider = response.provider;
-        if (response.provider !== 'rules') {
-            const results = JSON.parse(response.content);
-            const entries = Array.isArray(results) ? results : [results];
-            for (const entry of entries) {
-                if (!entry.type || !entry.content)
-                    continue;
-                // 4. Write memory
-                const memId = `mem:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
-                store.add({
-                    id: memId,
-                    type: entry.type,
-                    content: entry.content,
-                    title: entry.title,
-                    source: 'consolidation',
-                    status: 'active',
-                    confidence: entry.confidence ?? 0.7,
-                });
-                // 5. Link observations to memory
-                const obsIds = entry.supersedes_observation_ids ?? [];
-                for (const obsId of obsIds) {
-                    store.linkObservationToMemory(obsId, memId);
-                }
-                // 6. Add evidence
-                store.addEvidence({
-                    memoryId: memId,
-                    type: 'consolidation',
-                    weight: entry.confidence ?? 0.7,
-                    sourceObservationIds: obsIds,
-                    summary: `Consolidated from ${obsIds.length} observations about "${entry.title ?? entry.type}"`,
-                });
-                // 7. Audit
-                store.recordHistory({
-                    memoryId: memId,
-                    event: 'ADD',
-                    newContent: entry.content,
-                    reason: 'consolidation',
-                });
-                consolidated++;
-            }
-        }
-        else {
-            // Rule fallback: pick highest-importance observation per cluster as representative
-            for (const cluster of clusterData) {
-                const best = cluster.observations.reduce((a, b) => (a?.importance ?? 0) >= (b?.importance ?? 0) ? a : b);
-                if (!best)
-                    continue;
-                const memId = `mem:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
-                store.add({
-                    id: memId,
-                    type: 'semantic',
-                    content: best.narrative || best.title,
-                    title: best.title,
-                    source: 'consolidation',
-                    status: 'active',
-                    confidence: best.confidence,
-                });
-                store.linkObservationToMemory(best.id, memId);
-                store.addEvidence({
-                    memoryId: memId,
-                    type: 'consolidation',
-                    weight: best.confidence,
-                    sourceObservationIds: [best.id],
-                    summary: `Rule-based consolidation from observation about "${cluster.concept}"`,
-                });
-                store.recordHistory({
-                    memoryId: memId,
-                    event: 'ADD',
-                    newContent: best.narrative ?? best.title,
-                    reason: 'consolidation_rule_fallback',
-                });
-                consolidated++;
-            }
-        }
-    }
-    catch (err) {
-        console.warn('[Consolidator] Consolidation failed', { error: err.message });
-        // Rule fallback on error
-        for (const cluster of clusterData) {
-            const best = cluster.observations.reduce((a, b) => (a?.importance ?? 0) >= (b?.importance ?? 0) ? a : b);
-            if (!best)
-                continue;
-            const memId = `mem:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
-            store.add({
-                id: memId,
-                type: 'semantic',
-                content: best.narrative || best.title,
-                title: best.title,
-                source: 'consolidation',
-                status: 'active',
-                confidence: best.confidence,
-            });
-            store.linkObservationToMemory(best.id, memId);
-            store.addEvidence({
-                memoryId: memId,
-                type: 'consolidation',
-                weight: best.confidence,
-                sourceObservationIds: [best.id],
-                summary: `Error-fallback consolidation from observation about "${cluster.concept}"`,
-            });
-            store.recordHistory({
-                memoryId: memId,
-                event: 'ADD',
-                newContent: best.narrative ?? best.title,
-                reason: 'consolidation_error_fallback',
-            });
-            consolidated++;
-        }
+    for (const cluster of clusterData) {
+        const best = cluster.observations.reduce((a, b) => (a?.importance ?? 0) >= (b?.importance ?? 0) ? a : b);
+        if (!best)
+            continue;
+        const memId = `mem:${Date.now()}:${Math.random().toString(36).slice(2, 10)}`;
+        store.add({
+            id: memId,
+            type: 'semantic',
+            content: best.narrative || best.title,
+            title: best.title,
+            source: 'consolidation',
+            status: 'active',
+            confidence: best.confidence,
+        });
+        store.linkObservationToMemory(best.id, memId);
+        store.addEvidence({
+            memoryId: memId,
+            type: 'consolidation',
+            weight: best.confidence,
+            sourceObservationIds: [best.id],
+            summary: `Consolidation from observation about "${cluster.concept}"`,
+        });
+        store.recordHistory({
+            memoryId: memId,
+            event: 'ADD',
+            newContent: best.narrative ?? best.title,
+            reason: 'consolidation',
+        });
+        consolidated++;
     }
     const latencyMs = Date.now() - start;
     console.log('[Consolidator] Consolidation complete', {
         consolidated,
         skipped: clusters.length - consolidated,
-        provider,
         latencyMs,
     });
-    return { consolidated, skipped: clusters.length - consolidated, provider, latencyMs };
-}
-// ── Helpers ─────────────────────────────────────────────
-function buildConsolidationPrompt(clusters) {
-    const parts = clusters.map((c, i) => {
-        const obsText = c.observations
-            .filter(Boolean)
-            .map(o => `  - [${o.type}] ${o.title}: ${o.narrative || 'no narrative'} (importance: ${o.importance}, session: ${o.session_id}, id: ${o.id})`)
-            .join('\n');
-        return `Cluster ${i + 1}: Concept "${c.concept}" (${c.observationCount} observations across ${c.sessionCount} sessions)\n${obsText}`;
-    });
-    return `Consolidate the following observation clusters into memory entries. Return a JSON array with one entry per cluster.\n\n${parts.join('\n\n')}`;
+    return { consolidated, skipped: clusters.length - consolidated, provider: 'rules', latencyMs };
 }
 //# sourceMappingURL=consolidator.js.map

package/dist/consolidator.js.map

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

package/dist/embedding-provider.d.ts

@@ -1,8 +1,28 @@
+export type EmbeddingStatus = "idle" | "warming" | "ready" | "failed";
+type EmbeddingPipeline = (texts: string[]) => Promise<Array<{
+    data: Float32Array;
+}>>;
 export declare class EmbeddingProvider {
-    private ready;
+    private readonly pipelineLoader;
+    private status;
+    private lastError;
+    private initializationPromise;
+    private pipeline;
+    private errorLogPath;
+    constructor(pipelineLoader?: () => Promise<EmbeddingPipeline>);
     isReady(): boolean;
+    getStatus(): EmbeddingStatus;
+    getLastError(): string | null;
     initialize(): Promise<void>;
+    warmup(options?: {
+        timeoutMs?: number;
+        errorLogPath?: string;
+    }): Promise<boolean>;
     embed(text: string): Promise<Float32Array>;
     embedBatch(texts: string[]): Promise<Float32Array[]>;
+    private markReady;
+    private recordFailure;
+    private logFailure;
 }
+export {};
 //# sourceMappingURL=embedding-provider.d.ts.map

package/dist/embedding-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAaA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,IAAI,OAAO;IAIZ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAK3D"}
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,KAAK,iBAAiB,GAAG,CACvB,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAAC;AA0E5C,qBAAa,iBAAiB;IAa1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAZjC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,YAAY,CAKlB;gBAGiB,cAAc,GAAE,MAAM,OAAO,CAAC,iBAAiB,CAC5C;IAGtB,OAAO,IAAI,OAAO;IAIlB,SAAS,IAAI,eAAe;IAI5B,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,MAAM,CAAC,OAAO,GAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BnB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAY1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1D,OAAO,CAAC,SAAS;YAKH,aAAa;YAOb,UAAU;CAazB"}

package/dist/embedding-provider.js

@@ -1,35 +1,168 @@
-let pipe = null;
-async function getPipeline() {
-    if (pipe)
-        return pipe;
-    const { pipeline: transformersPipeline } = await import('@xenova/transformers');
-    const raw = await transformersPipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
-    pipe = async (texts) => {
-        const result = await raw(texts, { pooling: 'mean', normalize: true });
-        return Array.isArray(result) ? result : [result];
-    };
-    return pipe;
+import { appendFile, chmod, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+function splitBatchTensor(result, expectedCount) {
+    const [batchSize, embeddingSize] = result.dims ?? [];
+    if (batchSize === expectedCount
+        && Number.isInteger(embeddingSize)
+        && embeddingSize > 0
+        && result.data.length === batchSize * embeddingSize) {
+        return Array.from({ length: batchSize }, (_, index) => ({
+            data: result.data.slice(index * embeddingSize, (index + 1) * embeddingSize),
+        }));
+    }
+    return [{ data: result.data }];
+}
+let sharedPipeline = null;
+let sharedPipelinePromise = null;
+function loadSharedPipeline() {
+    if (sharedPipeline)
+        return Promise.resolve(sharedPipeline);
+    if (sharedPipelinePromise)
+        return sharedPipelinePromise;
+    sharedPipelinePromise = (async () => {
+        const { pipeline: transformersPipeline, env: transformersEnv, } = await import("@xenova/transformers");
+        const remoteHost = process.env.DEVFLOW_HF_ENDPOINT ?? process.env.HF_ENDPOINT;
+        if (remoteHost) {
+            transformersEnv.remoteHost = remoteHost.endsWith("/")
+                ? remoteHost
+                : `${remoteHost}/`;
+        }
+        const raw = await transformersPipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+        const loaded = async (texts) => {
+            const result = await raw(texts, { pooling: "mean", normalize: true });
+            return Array.isArray(result)
+                ? result
+                : splitBatchTensor(result, texts.length);
+        };
+        sharedPipeline = loaded;
+        return loaded;
+    })().catch((error) => {
+        sharedPipelinePromise = null;
+        throw error;
+    });
+    return sharedPipelinePromise;
+}
+function errorMessage(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const cause = error.cause instanceof Error ? error.cause.message : null;
+    return cause && cause !== error.message
+        ? `${error.message}: ${cause}`
+        : error.message;
 }
 export class EmbeddingProvider {
-    ready = false;
+    pipelineLoader;
+    status = "idle";
+    lastError = null;
+    initializationPromise = null;
+    pipeline = null;
+    errorLogPath = join(homedir(), ".devflow", "errors", "embedder.log");
+    constructor(pipelineLoader = loadSharedPipeline) {
+        this.pipelineLoader = pipelineLoader;
+    }
     isReady() {
-        return this.ready;
+        return this.status === "ready";
+    }
+    getStatus() {
+        return this.status;
     }
-    async initialize() {
-        if (this.ready)
-            return;
-        await getPipeline();
-        this.ready = true;
+    getLastError() {
+        return this.lastError;
+    }
+    initialize() {
+        if (this.pipeline) {
+            this.markReady();
+            return Promise.resolve();
+        }
+        if (this.initializationPromise)
+            return this.initializationPromise;
+        this.status = "warming";
+        const initialization = this.pipelineLoader()
+            .then((pipeline) => {
+            this.pipeline = pipeline;
+            this.status = "ready";
+            this.lastError = null;
+        })
+            .catch(async (error) => {
+            await this.recordFailure(error);
+            if (this.initializationPromise === initialization) {
+                this.initializationPromise = null;
+            }
+            throw error;
+        });
+        this.initializationPromise = initialization;
+        return this.initializationPromise;
+    }
+    async warmup(options = {}) {
+        const timeoutMs = options.timeoutMs ?? 30_000;
+        if (options.errorLogPath)
+            this.errorLogPath = options.errorLogPath;
+        let timeout;
+        try {
+            await Promise.race([
+                this.initialize(),
+                new Promise((_, reject) => {
+                    timeout = setTimeout(() => reject(new Error(`Embedding model warmup timed out after ${timeoutMs}ms`)), timeoutMs);
+                }),
+            ]);
+            return this.status === "ready";
+        }
+        catch (error) {
+            const message = errorMessage(error);
+            if (this.lastError !== message) {
+                await this.recordFailure(error);
+            }
+            return false;
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+        }
     }
     async embed(text) {
-        const p = await getPipeline();
-        const results = await p([text]);
-        return results[0].data;
+        await this.initialize();
+        try {
+            const results = await this.pipeline([text]);
+            this.markReady();
+            return results[0].data;
+        }
+        catch (error) {
+            await this.recordFailure(error);
+            throw error;
+        }
     }
     async embedBatch(texts) {
-        const p = await getPipeline();
-        const results = await p(texts);
-        return results.map(r => r.data);
+        await this.initialize();
+        try {
+            const results = await this.pipeline(texts);
+            this.markReady();
+            return results.map((result) => result.data);
+        }
+        catch (error) {
+            await this.recordFailure(error);
+            throw error;
+        }
+    }
+    markReady() {
+        this.status = "ready";
+        this.lastError = null;
+    }
+    async recordFailure(error) {
+        const message = errorMessage(error);
+        this.status = "failed";
+        this.lastError = message;
+        await this.logFailure(message);
+    }
+    async logFailure(message) {
+        try {
+            await mkdir(dirname(this.errorLogPath), { recursive: true, mode: 0o700 });
+            await appendFile(this.errorLogPath, `[${new Date().toISOString()}] ${message}\n`, { encoding: "utf8", mode: 0o600 });
+            await chmod(this.errorLogPath, 0o600);
+        }
+        catch {
+            // Failure telemetry must not replace the original embedding error.
+        }
     }
 }
 //# sourceMappingURL=embedding-provider.js.map

package/dist/embedding-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-provider.js","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"AAAA,IAAI,IAAI,GAAyE,IAAI,CAAC;AAEtF,KAAK,UAAU,WAAW;IACxB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAChF,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;IACxF,IAAI,GAAG,KAAK,EAAE,KAAe,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAuC,CAAC,CAAC,CAAC,CAAC,MAAgC,CAAC,CAAC;IAC9G,CAAC,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,iBAAiB;IACpB,KAAK,GAAG,KAAK,CAAC;IAEtB,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,MAAM,WAAW,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"embedding-provider.js","sourceRoot":"","sources":["../src/embedding-provider.ts"],"names":[],"mappings":"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"}

package/dist/event-grouper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-grouper.d.ts","sourceRoot":"","sources":["../src/event-grouper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAKlD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,CA4D5D;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,SAAS,SAAI,GAAG,UAAU,EAAE,CAqC9E"}
+{"version":3,"file":"event-grouper.d.ts","sourceRoot":"","sources":["../src/event-grouper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,CAiE5D;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,SAAS,SAAI,GAAG,UAAU,EAAE,CAqC9E"}

package/dist/event-grouper.js

@@ -44,6 +44,12 @@ export function groupEvents(events) {
                 }
             }
             if (fixGroup.length > 1) {
+                const prefix = currentGroup.slice(0, -1);
+                if (prefix.length > 0) {
+                    const prefixGroup = buildGroup(prefix, groupIdx++);
+                    if (prefixGroup)
+                        groups.push(prefixGroup);
+                }
                 const group = buildGroup(fixGroup, groupIdx++);
                 if (group)
                     groups.push(group);
@@ -127,10 +133,46 @@ function buildGroup(events, idx) {
         primaryTool,
         hasError,
         hasFix,
-        signalTypes: [],
+        signalTypes: collectSignalTypes(events),
         summary: summary || `${events.length} tool calls with ${primaryTool}`,
     };
 }
+function collectSignalTypes(events) {
+    const signalTypes = new Set();
+    for (const event of events) {
+        const payload = parsePayload(event.payload);
+        const explicitTypes = payload.signalTypes ?? payload.signal_types;
+        if (Array.isArray(explicitTypes)) {
+            for (const signalType of explicitTypes) {
+                if (typeof signalType === 'string' && signalType.trim())
+                    signalTypes.add(signalType);
+            }
+        }
+        if (typeof payload.signalType === 'string' && payload.signalType.trim()) {
+            signalTypes.add(payload.signalType);
+        }
+        // Event rows retain aggregate analyzer scores even when signal rows are not
+        // available to this grouping boundary. Preserve those triage signals.
+        if (event.l1_score > 0)
+            signalTypes.add('l1');
+        if (event.dialog_score > 0)
+            signalTypes.add('dialog');
+    }
+    return [...signalTypes];
+}
+function parsePayload(raw) {
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
 function isErrorEvent(e) {
     return e.exit_code !== null && e.exit_code !== undefined && e.exit_code !== 0;
 }