dsh-memoir 0.6.0 → 0.6.2

package/README.en.md

@@ -12,10 +12,10 @@
 No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH peers are supplied by the host.
 
 > [!IMPORTANT]
-> `dsh-memoir@0.6.0` is the formal plugin release for the npm-published DSH `0.1.2-alpha.2` line and requires `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`. Upgrade DSH first. Users remaining on `0.1.1-rc.2` should pin `dsh-memoir@0.5.6`.
+> npm `latest` is `dsh-memoir@0.6.2` for `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`, validated against DSH alpha.4, alpha.5, and 0.1.2-rc.1. Users remaining on `0.1.1-rc.2` should pin `dsh-memoir@0.5.6`.
 
 ```bash
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.2-rc.1
 dsh plugin --profile web add dsh-memoir@latest
 ```
 
@@ -35,7 +35,7 @@ Restart `dsh web`. Memory remains local and is not automatically deleted when th
 
 It fits personal and local development workflows where a new agent should continue understanding a project. It is not a raw chat backup, multi-user cloud sync service, or vector-semantic knowledge base.
 
-![dsh-memoir native Settings and agent-language selection on DSH alpha.2](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-settings-zh.png)
+![dsh-memoir v0.6.1 global memory grouped and collapsed by project](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-global-project-groups-zh.png)
 
 ## How it works
 
@@ -77,6 +77,10 @@ Similar-memory governance starts with BM25 candidates, then combines title simil
 
 ## Automatic distillation
 
+v0.6.2 diagnostics show the latest decision and process-local counters. Turns calling `memoir_record` or `memoir_update` skip reminders; submitting a reminder does not confirm persistence. Agent disposal clears gate state, with a fallback cap of 1024 recently active agents (eviction also forgets their turn watermark and cooldown). Manual recording remains available when automatic distillation is disabled.
+
+The current validated baseline is DSH `0.1.2-rc.1`. The next `0.1.3-alpha.2` line is not yet declared compatible; use the pinned installation command. BM25 is lexical retrieval and does not guarantee cross-language semantic matches without shared terms. Distillation guidance does not replace fact checking.
+
 Automatic distillation is an observable agent turn-end reminder, not silent background scraping of every chat. The default `1 / 0 / 1` means every eligible worked turn, no extra cooldown, and at least one tool call.
 
 `autoDistillEvery`, `autoDistillCooldownMin`, and `autoDistillMinTools` are AND conditions isolated per agent. Idle, aborted, subagent, and already-recorded turns do not trigger. Cooldown advances only after a successful reminder. All cadence parameters are live-editable in the GUI.
@@ -98,17 +102,26 @@ Top-5 recall on the fixed quality set is 100%; the repository gate requires at l
 
 Installing into a DSH-alpha `web` profile registers a native Memory Conversation view and Memory Settings section through official slots. The DSH shell owns layout, navigation, and unload lifecycle; Memoir no longer takes over the legacy sidebar through DOM selectors.
 
-- Project memory and all-project global memory;
+- Project memory and all-project global memory, with project groups collapsed by default and complete lifecycle totals;
 - status, section, and keyword filters with BM25 scores;
 - add, edit, pin, archive, restore, and supersede;
 - copy and best-effort navigation for session/turn provenance;
 - Hot Memory Inspector: what the next session will inherit;
 - Retrieval Diagnostics: index, query cache, last query, and session snapshot;
-- one vertical scroll owner, so expanded settings, Hot Memory, and diagnostics remain continuously scrollable;
+- permanent `Browse / Settings / Hot Memory / Diagnostics` navigation with an independent bounded scroll position per surface;
+- progressive batches of 20 entries or projects, plus a controlled six-line preview for long memory bodies;
+- the native DSH composer-overlay contract, keeping the final memory visible above the conversation composer while the list scrolls fully;
+- arrow-key, Home, and End navigation for surface tabs, plus `aria-expanded` project disclosures and visible focus states;
 - live GUI Chinese/English switching from `<html lang>`, with a separate `language` setting for agent-facing copy.
 
 <details>
-<summary>More stable GUI screenshots</summary>
+<summary>More GUI screenshots</summary>
+
+![v0.6.2 automatic distillation lifecycle diagnostics](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.2/picture/v0.6.2-distill-diagnostics-zh.png)
+
+![v0.6.1 permanent surface navigation and live settings](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
+
+![v0.6.1 conversation view scrolled to the end above the composer](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
 
 ![Native Memory Conversation view on DSH alpha.2](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-native-zh.png)
 
@@ -124,11 +137,11 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.6.0`) | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | Current formal release for the npm alpha line |
+| npm `latest` (`0.6.2`) | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | Current release validated on 0.1.2-rc.1 |
 | pinned npm `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 compatibility line |
-| GitHub `main` | `>=0.1.2-alpha.2 <0.1.3` | source clone + `link:` | 0.6.x development line |
+| GitHub `main` (`0.6.2`) | `>=0.1.2-alpha.2 <0.1.3` | source clone + `link:` | Development and debugging |
 
-Node.js `^22.19.0 || >=24.0.0` is required. v0.6.0 uses the native DSH-alpha `conversation.view` / `settings.section` slots and the Remote-era client module architecture. A formal plugin version means Memoir itself is released; it does not imply compatibility with the older rc2 host. `dsh.engines.dsh` rejects incompatible hosts.
+Node.js `^22.19.0 || >=24.0.0` is required. v0.6.x uses the native DSH-alpha `conversation.view` / `settings.section` slots and the Remote-era client module architecture. v0.6.1 supports both the public `session.events` surface in alpha.2/alpha.3 and `session.snapshotEvents()` in alpha.4+. `dsh.engines.dsh` rejects incompatible hosts.
 
 <details>
 <summary>Install from source</summary>
@@ -140,7 +153,7 @@ git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.2-rc.1
 dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 ```
 
@@ -197,7 +210,7 @@ v0.5.6 benchmark (Node 24.19, 900/1200-token budget; full data in [`bench/report
 
 Numbers vary by machine and corpus. The important properties are that injection remains bounded and the cache-hit path is independent of total memory size.
 
-v0.6.0 has 182 automated tests covering store/settings migration and locks, Hot Memory, BM25 quality/cache, lifecycle, provenance anti-spoofing, similar-memory governance, automatic distillation, bilingual agent and GUI surfaces, scrolling, DSH alpha.2 integration, and release automation.
+v0.6.2 passes 192 automated tests and type checking, covering lifecycle, BM25, Hot Memory, writing and injection, provenance, and GUI. An isolated DSH 0.1.2-rc.1 + dsh-web-all 0.3.18 profile passes bilingual diagnostics browser regression. Earlier alpha.2–alpha.5 compatibility evidence is recorded in the v0.6.1 changelog.
 
 ## FAQ
 
@@ -226,6 +239,6 @@ pnpm test
 npm run bench
 ```
 
-Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current release is [v0.6.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.0).
+Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current npm release is [v0.6.2](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.2), and `main` is synchronized with it.
 
 Apache-2.0

package/README.md

@@ -11,10 +11,10 @@
 无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
 
 > [!IMPORTANT]
-> `dsh-memoir@0.6.0` 是面向 npm 已发布 DSH `0.1.2-alpha.2` 的正式插件版本，要求 `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`。请先升级 DSH；仍使用 `0.1.1-rc.2` 的用户应固定安装 `dsh-memoir@0.5.6`。
+> npm `latest` 为 `dsh-memoir@0.6.2`，适用于 `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`，已验证 DSH alpha.4、alpha.5 与 0.1.2-rc.1。仍使用 `0.1.1-rc.2` 的用户应固定安装 `dsh-memoir@0.5.6`。
 
 ```bash
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.2-rc.1
 dsh plugin --profile web add dsh-memoir@latest
 ```
 
@@ -34,7 +34,7 @@ dsh plugin --profile web add dsh-memoir@latest
 
 适合需要“新 Agent 接手时继续理解项目”的个人或本地开发工作流。它不是原始聊天记录备份、多人云同步服务或向量语义知识库。
 
-![dsh-memoir 在 DSH alpha.2 中的原生设置与 Agent 语言选择](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-settings-zh.png)
+![dsh-memoir v0.6.1 按项目折叠的全局记忆](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-global-project-groups-zh.png)
 
 ## 工作原理
 
@@ -76,6 +76,10 @@ memoir_record / memoir_update
 
 ## 自动蒸馏
 
+v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已经调用 `memoir_record` 或 `memoir_update` 的回合不再提醒；提交提醒不代表写入已完成。Agent 销毁会清理门控状态，最多保留 1024 个最近活动 Agent（淘汰后不再保留其回合水位和冷却）。关闭自动蒸馏后仍可手动记录。
+
+当前验证基线为 DSH `0.1.2-rc.1`；`0.1.3-alpha.2` 属于下一版本线，尚不声明兼容，请使用下方固定版本安装命令。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
+
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
 `autoDistillEvery`、`autoDistillCooldownMin`、`autoDistillMinTools` 三个条件按 AND 判定并按 Agent 隔离。idle、aborted、subagent 和已调用 `memoir_record` 的回合不会触发；冷却只在提醒成功后更新。所有频率参数都可在 GUI 中即时修改。
@@ -97,17 +101,26 @@ memoir_record / memoir_update
 
 安装到 DSH alpha 的 `web` profile 后，Memoir 通过官方 slot 注册原生「记忆」会话视图和「记忆」Settings 分区；布局、导航与卸载生命周期均由 DSH shell 管理，不再通过 DOM 选择器接管旧侧边栏。
 
-- 项目记忆与所有项目的全局记忆；
+- 项目记忆与所有项目的全局记忆；全局视图按项目默认折叠并显示完整生命周期计数；
 - 状态、分类和关键词筛选，BM25 分数展示；
 - 新增、编辑、置顶、归档、恢复和替代；
 - session/turn 来源复制与尽力跳转；
 - Hot Memory Inspector：下一会话将继承什么；
 - Retrieval Diagnostics：索引、查询缓存、最近查询和会话快照；
-- 单一纵向滚动区，展开设置、Hot Memory 与诊断后仍可连续浏览；
+- 常驻 `记忆浏览 / 记忆设置 / Hot Memory / 诊断` 二级导航，各功能区拥有独立有界滚动位置；
+- 每批渐进展示 20 条记忆或 20 个项目，长正文默认折叠为六行并可显式展开；
+- 使用 DSH 原生 composer-overlay 契约，长列表可完整滚动且最后一项不会被对话输入框遮挡；
+- 页签支持方向键、Home、End，项目折叠具备 `aria-expanded` 与清晰焦点状态；
 - GUI 跟随 `<html lang>` 在中文和英文间即时切换；Agent 侧语言由独立的 `language` 设置控制。
 
 <details>
-<summary>查看更多稳定版 GUI 截图</summary>
+<summary>查看更多 GUI 截图</summary>
+
+![v0.6.2 自动蒸馏生命周期诊断](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.2/picture/v0.6.2-distill-diagnostics-zh.png)
+
+![v0.6.1 常驻功能导航与实时设置](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
+
+![v0.6.1 对话视图滚动到底且避让输入框](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
 
 ![DSH alpha.2 原生记忆会话视图](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-native-zh.png)
 
@@ -123,11 +136,11 @@ memoir_record / memoir_update
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.6.0`） | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | 当前正式版，适配 npm alpha |
+| npm `latest`（`0.6.2`） | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | 当前发布版本；基于 0.1.2-rc.1 验证 |
 | npm 固定版 `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 兼容线 |
-| GitHub `main` | `>=0.1.2-alpha.2 <0.1.3` | 源码 clone + `link:` | 0.6.x 开发线 |
+| GitHub `main`（`0.6.2`） | `>=0.1.2-alpha.2 <0.1.3` | 源码 clone + `link:` | 开发和调试使用 |
 
-需要 Node.js `^22.19.0 || >=24.0.0`。`0.6.0` 使用 DSH alpha 的原生 `conversation.view` / `settings.section` 与 Remote 时代客户端模块；正式版本号表示插件自身完成发布，不表示它兼容旧 rc2。manifest 的 `dsh.engines.dsh` 会拒绝不兼容宿主。
+需要 Node.js `^22.19.0 || >=24.0.0`。`0.6.x` 使用 DSH alpha 的原生 `conversation.view` / `settings.section` 与 Remote 时代客户端模块；`0.6.1` 同时兼容 alpha.2/alpha.3 的公开 `session.events` 与 alpha.4+ 的 `session.snapshotEvents()`。manifest 的 `dsh.engines.dsh` 会拒绝不兼容宿主。
 
 <details>
 <summary>从源码安装</summary>
@@ -139,7 +152,7 @@ git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
-npm install --global @deepseek-ai/dsh@alpha
+npm install --global @deepseek-ai/dsh@0.1.2-rc.1
 dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 ```
 
@@ -196,7 +209,7 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
 
-v0.6.0 有 182 项自动化测试，覆盖存储/设置迁移与锁、Hot Memory、BM25 质量/缓存、生命周期、来源防伪、相似治理、自动蒸馏、Agent 侧与 GUI 双语、滚动布局、DSH alpha.2 集成和发布工作流。
+v0.6.2 的 192 项自动化测试与类型检查通过，覆盖生命周期、BM25、Hot Memory、写入与注入、来源和 GUI。当前隔离 DSH 0.1.2-rc.1 + dsh-web-all 0.3.18 已完成双语诊断页浏览器回归；alpha.2–alpha.5 的旧版兼容证据见 v0.6.1 更新日志。
 
 ## 常见问题
 
@@ -225,6 +238,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.6.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.0)。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.6.2](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.2)，`main` 与该版本同步。
 
 Apache-2.0

package/lib/autodistill.d.ts

@@ -27,6 +27,16 @@ export interface TurnActivity {
     recorded: boolean;
     toolCalls: number;
 }
+/**
+ * Session-log compatibility surface. DSH <= alpha.3 exposed `events` while
+ * alpha.4+ keeps the log private and exposes an immutable snapshot method.
+ */
+export interface SessionEventSource {
+    readonly events?: readonly TurnEventLike[];
+    snapshotEvents?: () => readonly TurnEventLike[];
+}
+/** Read a stable session event snapshot across the old and new DSH APIs. */
+export declare function sessionEventSnapshot(session: SessionEventSource | undefined): readonly TurnEventLike[];
 /** Scan the tail of a session log for one turn's tool activity. */
 export declare function turnActivity(events: readonly TurnEventLike[], turn: number): TurnActivity;
 /** The agent surface the turn-stopping listener needs. */
@@ -37,7 +47,8 @@ export interface AutoDistillAgentLike {
             origin?: string;
             delegationDepth?: number;
         };
-        events: readonly TurnEventLike[];
+        readonly events?: readonly TurnEventLike[];
+        snapshotEvents?: () => readonly TurnEventLike[];
     };
     steer(message: UserMessage): void;
 }
@@ -51,6 +62,10 @@ export interface AutoDistillPolicy {
 /** Per-agent frequency, cooldown, and duplicate-turn state (with pruning). */
 export declare class AutoDistillGate {
     private states;
+    readonly capacity = 1024;
+    reason: 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'ready';
+    get size(): number;
+    clear(): void;
     /**
      * Consume one eligible worked turn and decide whether all policy conditions
      * are ready. Duplicate events never advance the worked-turn counter.
@@ -61,6 +76,39 @@ export declare class AutoDistillGate {
     /** Drop all state for one agent (disposal hygiene). */
     forget(agentId: string): void;
 }
+export type DistillOutcome = 'disabled' | 'subagent' | 'aborted' | 'idle' | 'recorded' | 'duplicate' | 'interval' | 'tools' | 'cooldown' | 'steered' | 'failed';
+/** Process-local counters only; never retains message content or credentials. */
+export declare class DistillDiagnostics {
+    private counts;
+    private last;
+    private workedTurns;
+    private agents;
+    record(outcome: DistillOutcome, at: number, turn: number, toolCalls: number, agents: number): void;
+    snapshot(): {
+        counts: {
+            subagent?: number | undefined;
+            duplicate?: number | undefined;
+            interval?: number | undefined;
+            tools?: number | undefined;
+            cooldown?: number | undefined;
+            disabled?: number | undefined;
+            aborted?: number | undefined;
+            idle?: number | undefined;
+            recorded?: number | undefined;
+            steered?: number | undefined;
+            failed?: number | undefined;
+        };
+        workedTurns: number;
+        agents: number;
+        last: {
+            outcome: DistillOutcome;
+            at: number;
+            turn: number;
+            toolCalls: number;
+        } | null;
+    };
+    setAgents(agents: number): void;
+}
 export interface TurnStoppingPayload {
     agent: AutoDistillAgentLike;
     turn: number;
@@ -69,6 +117,7 @@ export interface TurnStoppingPayload {
 /** The event-wire surface the installer needs (satisfied by ctx.on). */
 export interface AutoDistillWire {
     on(name: 'agent/turn-stopping', listener: (payload: TurnStoppingPayload) => void): () => void;
+    onDisposed?(listener: (agentId: string) => void): () => void;
 }
 /**
  * Install the turn-end listener. The returned disposer removes the listener.
@@ -89,4 +138,5 @@ export declare function installAutoDistill(wire: AutoDistillWire, options: {
     /** Optional live language source for the steering instruction. */
     language?: () => MemoirLanguage;
     now?: () => number;
+    diagnostics?: DistillDiagnostics;
 }): () => void;

package/lib/autodistill.js

@@ -19,6 +19,12 @@ export function distillPrompt(language = DEFAULT_MEMOIR_LANGUAGE) {
 export const DISTILL_PROMPT = distillPrompt();
 /** Plugin identity stamped on the steering message source. */
 export const AUTO_DISTILL_PLUGIN = 'dsh-memoir';
+/** Read a stable session event snapshot across the old and new DSH APIs. */
+export function sessionEventSnapshot(session) {
+    if (typeof session?.snapshotEvents === 'function')
+        return session.snapshotEvents();
+    return session?.events ?? [];
+}
 /** Scan the tail of a session log for one turn's tool activity. */
 export function turnActivity(events, turn) {
     let recorded = false;
@@ -34,7 +40,7 @@ export function turnActivity(events, turn) {
             continue;
         if (event.type === 'tool/call') {
             toolCalls += 1;
-            if (data.name === 'memoir_record')
+            if (data.name === 'memoir_record' || data.name === 'memoir_update')
                 recorded = true;
         }
     }
@@ -47,6 +53,10 @@ export function isSubagentSession(agent) {
 /** Per-agent frequency, cooldown, and duplicate-turn state (with pruning). */
 export class AutoDistillGate {
     states = new Map();
+    capacity = 1024;
+    reason = 'ready';
+    get size() { return this.states.size; }
+    clear() { this.states.clear(); }
     /**
      * Consume one eligible worked turn and decide whether all policy conditions
      * are ready. Duplicate events never advance the worked-turn counter.
@@ -54,21 +64,24 @@ export class AutoDistillGate {
     consume(agentId, turn, toolCalls, policy, now) {
         let state = this.states.get(agentId);
         if (state === undefined) {
-            state = { processedTurns: new Set(), workedSinceSteer: 0 };
+            state = { lastTurn: -Infinity, workedSinceSteer: 0 };
             this.states.set(agentId, state);
+            if (this.states.size > this.capacity)
+                this.states.delete(this.states.keys().next().value);
         }
-        if (state.processedTurns.has(turn))
+        if (turn <= state.lastTurn) {
+            this.reason = 'duplicate';
             return false;
-        state.processedTurns.add(turn);
-        for (const value of [...state.processedTurns]) {
-            if (value < turn - 100)
-                state.processedTurns.delete(value);
         }
+        state.lastTurn = turn;
+        this.states.delete(agentId);
+        this.states.set(agentId, state);
         state.workedSinceSteer += 1;
         const intervalReady = state.workedSinceSteer >= policy.every;
         const activityReady = toolCalls >= policy.minTools;
         const cooldownReady = state.lastSteeredAt === undefined || now - state.lastSteeredAt >= policy.cooldownMs;
-        return intervalReady && activityReady && cooldownReady;
+        this.reason = !intervalReady ? 'interval' : !activityReady ? 'tools' : !cooldownReady ? 'cooldown' : 'ready';
+        return this.reason === 'ready';
     }
     /** Record a successful steer; failed steer attempts do not start cooldown. */
     recordSteer(agentId, now) {
@@ -83,6 +96,22 @@ export class AutoDistillGate {
         this.states.delete(agentId);
     }
 }
+/** Process-local counters only; never retains message content or credentials. */
+export class DistillDiagnostics {
+    counts = {};
+    last = null;
+    workedTurns = 0;
+    agents = 0;
+    record(outcome, at, turn, toolCalls, agents) {
+        this.counts[outcome] = (this.counts[outcome] ?? 0) + 1;
+        if (['interval', 'tools', 'cooldown', 'steered', 'failed'].includes(outcome))
+            this.workedTurns += 1;
+        this.last = { outcome, at, turn, toolCalls };
+        this.agents = agents;
+    }
+    snapshot() { return { counts: { ...this.counts }, workedTurns: this.workedTurns, agents: this.agents, last: this.last === null ? null : { ...this.last } }; }
+    setAgents(agents) { this.agents = agents; }
+}
 /**
  * Install the turn-end listener. The returned disposer removes the listener.
  * @param wire - the event wire (the cordis context).
@@ -92,30 +121,50 @@ export function installAutoDistill(wire, options) {
     const gate = new AutoDistillGate();
     const integerAtLeast = (value, fallback, minimum) => typeof value === 'number' && Number.isFinite(value) ? Math.max(minimum, Math.floor(value)) : fallback;
     const numberAtLeast = (value, fallback, minimum) => typeof value === 'number' && Number.isFinite(value) ? Math.max(minimum, value) : fallback;
-    return wire.on('agent/turn-stopping', (payload) => {
-        if (!options.enabled())
-            return;
+    const dispose = wire.on('agent/turn-stopping', (payload) => {
         const { agent, turn, signal } = payload;
-        if (isSubagentSession(agent))
+        const now = options.now?.() ?? Date.now();
+        const report = (outcome, tools = 0) => options.diagnostics?.record(outcome, now, turn, tools, gate.size);
+        if (!options.enabled()) {
+            report('disabled');
             return;
-        if (signal.aborted)
+        }
+        if (isSubagentSession(agent)) {
+            report('subagent');
             return;
-        const { worked, recorded, toolCalls } = turnActivity(agent.session.events, turn);
-        if (!worked || recorded)
+        }
+        if (signal.aborted) {
+            report('aborted');
             return;
+        }
+        const { worked, recorded, toolCalls } = turnActivity(sessionEventSnapshot(agent.session), turn);
+        if (!worked || recorded) {
+            report(recorded ? 'recorded' : 'idle', toolCalls);
+            return;
+        }
         const live = options.policy?.();
         const policy = {
             every: integerAtLeast(live?.every ?? options.every, 1, 1),
             cooldownMs: numberAtLeast(live?.cooldownMin ?? options.cooldownMin, 0, 0) * 60_000,
             minTools: integerAtLeast(live?.minTools ?? options.minTools, 1, 1),
         };
-        const now = options.now?.() ?? Date.now();
-        if (!gate.consume(agent.id, turn, toolCalls, policy, now))
+        if (!gate.consume(agent.id, turn, toolCalls, policy, now)) {
+            report(gate.reason === 'ready' ? 'duplicate' : gate.reason, toolCalls);
             return;
-        agent.steer(createUserMessage({
-            content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
-            source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
-        }));
+        }
+        try {
+            agent.steer(createUserMessage({
+                content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
+                source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
+            }));
+        }
+        catch (error) {
+            report('failed', toolCalls);
+            throw error;
+        }
         gate.recordSteer(agent.id, now);
+        report('steered', toolCalls);
     });
+    const disposeAgent = wire.onDisposed?.((agentId) => { gate.forget(agentId); options.diagnostics?.setAgents(gate.size); });
+    return () => { dispose(); disposeAgent?.(); gate.clear(); options.diagnostics?.setAgents(0); };
 }