dsh-plugin-dev-kb 1.3.0 → 1.5.1

package/kb/extra/persistence-changes/releases/README.md

@@ -0,0 +1,103 @@
+---
+description: "Browse Session persistence-type changes across every captured DSH alpha/RC tag and validate the historical snapshots offline."
+---
+
+# Persistence changes across DSH prereleases
+
+English | [中文](README.zh.md)
+
+## Summary
+
+This archive provides an approximate historical view of 26 DSH alpha/RC tags and their 25 adjacent transitions. Each release includes a short explanation, source tag, before/after digests, and complete snapshots of changed types for reading and format validation. It does not establish historical runtime compatibility or replace [current-source acknowledgements](../README.md).
+
+## Table of Contents
+
+- [Archived releases](#releases)
+- [Files and scope](#files)
+- [Extraction and limitations](#extraction)
+- [Verification](#verification)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="releases"></a>
+## Archived releases
+
+The [manifest](manifest.json) records every DSH alpha/RC tag captured on 2026-09-12: 16 have release records, and the earliest 10 are tag-only. Entries follow semantic-version order; absent tags are not invented. The first entry establishes the historical starting point, so its change count includes every root.
+
+<!-- persistence-release-index:start -->
+
+| Tag | Source date (UTC) | Session version | Roots / types | Changed roots |
+|---|---|---|---|---|
+| [dsh-v0.0.1-rc.1](dsh-v0.0.1-rc.1.md) | 2026-08-10 | 0 | 42 / 341 | 42 |
+| [dsh-v0.0.1-rc.2](dsh-v0.0.1-rc.2.md) | 2026-08-11 | 0 | 47 / 374 | 45 |
+| [dsh-v0.0.1-rc.3](dsh-v0.0.1-rc.3.md) | 2026-08-12 | 0 | 47 / 374 | 12 |
+| [dsh-v0.0.1-rc.4](dsh-v0.0.1-rc.4.md) | 2026-08-12 | 0 | 47 / 374 | 0 |
+| [dsh-v0.0.1-rc.5](dsh-v0.0.1-rc.5.md) | 2026-08-12 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.1](dsh-v0.1.0-rc.1.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.2](dsh-v0.1.0-rc.2.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.3](dsh-v0.1.0-rc.3.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.5](dsh-v0.1.0-rc.5.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.6](dsh-v0.1.0-rc.6.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.7](dsh-v0.1.0-rc.7.md) | 2026-08-17 | 0 | 47 / 376 | 1 |
+| [dsh-v0.1.0-rc.8](dsh-v0.1.0-rc.8.md) | 2026-08-19 | 0 | 51 / 403 | 8 |
+| [dsh-v0.1.1-rc.1](dsh-v0.1.1-rc.1.md) | 2026-08-21 | 0 | 51 / 407 | 1 |
+| [dsh-v0.1.1-rc.2](dsh-v0.1.1-rc.2.md) | 2026-08-21 | 0 | 51 / 404 | 10 |
+| [dsh-v0.1.2-alpha.1](dsh-v0.1.2-alpha.1.md) | 2026-08-27 | 0 | 54 / 417 | 52 |
+| [dsh-v0.1.2-alpha.2](dsh-v0.1.2-alpha.2.md) | 2026-08-30 | 0 | 54 / 417 | 52 |
+| [dsh-v0.1.2-alpha.3](dsh-v0.1.2-alpha.3.md) | 2026-08-31 | 0 | 54 / 417 | 0 |
+| [dsh-v0.1.2-alpha.4](dsh-v0.1.2-alpha.4.md) | 2026-09-01 | 0 | 54 / 415 | 4 |
+| [dsh-v0.1.2-alpha.5](dsh-v0.1.2-alpha.5.md) | 2026-09-02 | 0 | 54 / 415 | 0 |
+| [dsh-v0.1.2-rc.1](dsh-v0.1.2-rc.1.md) | 2026-09-03 | 0 | 54 / 415 | 0 |
+| [dsh-v0.1.3-alpha.1](dsh-v0.1.3-alpha.1.md) | 2026-09-04 | 2 | 54 / 425 | 17 |
+| [dsh-v0.1.3-alpha.2](dsh-v0.1.3-alpha.2.md) | 2026-09-07 | 2 | 56 / 435 | 2 |
+| [dsh-v0.1.5-alpha.1](dsh-v0.1.5-alpha.1.md) | 2026-09-08 | 3 | 57 / 443 | 12 |
+| [dsh-v0.1.5-alpha.2](dsh-v0.1.5-alpha.2.md) | 2026-09-09 | 3 | 59 / 462 | 4 |
+| [dsh-v0.1.5-rc.1](dsh-v0.1.5-rc.1.md) | 2026-09-10 | 3 | 59 / 462 | 0 |
+| [dsh-v0.1.5-rc.2](dsh-v0.1.5-rc.2.md) | 2026-09-10 | 3 | 59 / 462 | 0 |
+
+<!-- persistence-release-index:end -->
+
+<a id="files"></a>
+## Files and scope
+
+Each tag has an English/Chinese record with `kind: persistence-release`, a pairing sidecar, and `.schema.json`. Its machine declaration contains the tag, immediate predecessor, observed writer version, and each changed root’s before/after digest. The first snapshot contains every root; later snapshots retain only changed roots that remain present and all their reachable types. Deletions use a null after value; unchanged releases retain empty changes and snapshots.
+
+Snapshots cover the logical Session header, physical JSONL header, event envelope, and every first-party event and transitive reference at that tag. Type counts include only definitions reachable after normalization. Historical source references retain file paths without line numbers.
+
+These retrospective records are validated separately from the current acknowledgement chain in the parent directory. Current-rule classifications of old changes are reading aids: historical version 0 did contain structural changes without version increases. A backfilled record cannot authorize a current PR to omit acknowledgement or a required version increase.
+
+<a id="extraction"></a>
+## Extraction and limitations
+
+Reconstruction used source at each tag, TypeScript 6.0.3, and the merged [schema extractor](../../../scripts/persistence-schema.ts). The only extraction adaptation omits a redundant `object` member from intersections of early concrete event records. Existing `any` / `unknown` remain opaque; no additional opaque types were substituted for unresolved references. Release schema JSON retains historical identifiers; terminology checks still apply to authored records and current schemas.
+
+The first 22 tags legitimately declare optional `surfaceOp` on surface events. Historical parsing preserves that optionality; current-source parsing still requires the field. Earlier `SessionHeader.version: number` declarations also remain intact, with actual writer version constants recorded separately. A broad `number` declaration cannot supply that constant.
+
+The captured tags use writer versions 0, 2, and 3; no tag uses writer version 1.
+
+Digests describe normalized reconstructed types, not verbatim source text or reproduction of the original toolchain. Summaries provide rough structural context; old applications were not replayed, complete codec behavior was not validated, and migration safety was not proved. An unchanged digest does not establish unchanged behavior.
+
+<a id="verification"></a>
+## Verification
+
+All 26 snapshots passed canonical-graph, root-digest, and reachable-type-digest validation. The release-archive check reads only the manifest, records, and snapshots in this tree, without Git, network access, or old-version checkouts; it validates manifest coverage, predecessors, before/after values, snapshot type completeness, and bilingual machine declarations.
+
+```sh
+pnpm run verify-persistence-releases
+pnpm run doc-sync
+```
+
+The marker-delimited index, inventory cells, and structural-change facts are generated from the snapshots. Default verification rejects stale facts. Run `pnpm run verify-persistence-releases --write` to refresh those regions and pairing records after validating all machine data; authored summaries, source evidence, machine declarations, and schema files are preserved.
+
+Tag completeness is relative to the manifest’s captured scope; offline checks do not discover later tags automatically. Standard documentation checks validate pairing records and Markdown links. The [format template](../../../.agents/skills/dsh-doc/templates/persistence-release.md) defines each record’s fields.
+
+<a id="dev-note"></a>
+## Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/kb/extra/persistence-changes/releases/README.zh.md

@@ -0,0 +1,103 @@
+---
+description: "浏览全部已捕获 DSH alpha/RC tag 之间的 Session 持久化类型变化，并离线校验历史快照。"
+---
+
+# DSH 预发行版本的持久化变化
+
+[English](README.md) | 中文
+
+## 概述
+
+本归档提供 26 个 DSH alpha/RC tag 及其 25 次相邻转换的近似历史视图。每个版本包含简要说明、源码 tag、before/after 摘要以及变化类型的完整快照，供阅读和格式校验使用。它不确认历史运行时兼容性，也不替代[当前源码的确认记录](../README.zh.md)。
+
+## 目录
+
+- [已归档版本](#releases)
+- [文件与范围](#files)
+- [提取与限制](#extraction)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="releases"></a>
+## 已归档版本
+
+[清单](manifest.json)记录了 2026-09-12 捕获的全部 DSH alpha/RC tag：16 个有发行记录，最早的 10 个只有 tag。版本按语义版本顺序排列；不存在的 tag 不补造。首条记录是历史起点，变化数包含其所有根。
+
+<!-- persistence-release-index:start -->
+
+| Tag | 源码日期（UTC） | Session 版本 | 根 / 类型 | 变化根 |
+|---|---|---|---|---|
+| [dsh-v0.0.1-rc.1](dsh-v0.0.1-rc.1.zh.md) | 2026-08-10 | 0 | 42 / 341 | 42 |
+| [dsh-v0.0.1-rc.2](dsh-v0.0.1-rc.2.zh.md) | 2026-08-11 | 0 | 47 / 374 | 45 |
+| [dsh-v0.0.1-rc.3](dsh-v0.0.1-rc.3.zh.md) | 2026-08-12 | 0 | 47 / 374 | 12 |
+| [dsh-v0.0.1-rc.4](dsh-v0.0.1-rc.4.zh.md) | 2026-08-12 | 0 | 47 / 374 | 0 |
+| [dsh-v0.0.1-rc.5](dsh-v0.0.1-rc.5.zh.md) | 2026-08-12 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.1](dsh-v0.1.0-rc.1.zh.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.2](dsh-v0.1.0-rc.2.zh.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.3](dsh-v0.1.0-rc.3.zh.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.5](dsh-v0.1.0-rc.5.zh.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.6](dsh-v0.1.0-rc.6.zh.md) | 2026-08-13 | 0 | 47 / 374 | 0 |
+| [dsh-v0.1.0-rc.7](dsh-v0.1.0-rc.7.zh.md) | 2026-08-17 | 0 | 47 / 376 | 1 |
+| [dsh-v0.1.0-rc.8](dsh-v0.1.0-rc.8.zh.md) | 2026-08-19 | 0 | 51 / 403 | 8 |
+| [dsh-v0.1.1-rc.1](dsh-v0.1.1-rc.1.zh.md) | 2026-08-21 | 0 | 51 / 407 | 1 |
+| [dsh-v0.1.1-rc.2](dsh-v0.1.1-rc.2.zh.md) | 2026-08-21 | 0 | 51 / 404 | 10 |
+| [dsh-v0.1.2-alpha.1](dsh-v0.1.2-alpha.1.zh.md) | 2026-08-27 | 0 | 54 / 417 | 52 |
+| [dsh-v0.1.2-alpha.2](dsh-v0.1.2-alpha.2.zh.md) | 2026-08-30 | 0 | 54 / 417 | 52 |
+| [dsh-v0.1.2-alpha.3](dsh-v0.1.2-alpha.3.zh.md) | 2026-08-31 | 0 | 54 / 417 | 0 |
+| [dsh-v0.1.2-alpha.4](dsh-v0.1.2-alpha.4.zh.md) | 2026-09-01 | 0 | 54 / 415 | 4 |
+| [dsh-v0.1.2-alpha.5](dsh-v0.1.2-alpha.5.zh.md) | 2026-09-02 | 0 | 54 / 415 | 0 |
+| [dsh-v0.1.2-rc.1](dsh-v0.1.2-rc.1.zh.md) | 2026-09-03 | 0 | 54 / 415 | 0 |
+| [dsh-v0.1.3-alpha.1](dsh-v0.1.3-alpha.1.zh.md) | 2026-09-04 | 2 | 54 / 425 | 17 |
+| [dsh-v0.1.3-alpha.2](dsh-v0.1.3-alpha.2.zh.md) | 2026-09-07 | 2 | 56 / 435 | 2 |
+| [dsh-v0.1.5-alpha.1](dsh-v0.1.5-alpha.1.zh.md) | 2026-09-08 | 3 | 57 / 443 | 12 |
+| [dsh-v0.1.5-alpha.2](dsh-v0.1.5-alpha.2.zh.md) | 2026-09-09 | 3 | 59 / 462 | 4 |
+| [dsh-v0.1.5-rc.1](dsh-v0.1.5-rc.1.zh.md) | 2026-09-10 | 3 | 59 / 462 | 0 |
+| [dsh-v0.1.5-rc.2](dsh-v0.1.5-rc.2.zh.md) | 2026-09-10 | 3 | 59 / 462 | 0 |
+
+<!-- persistence-release-index:end -->
+
+<a id="files"></a>
+## 文件与范围
+
+每个 tag 对应 `kind: persistence-release` 的中英记录、配对 sidecar 和 `.schema.json`。机器声明包含 tag、直接前驱、实际写入版本以及每个变化根的 before/after 摘要。首条快照包含全部根；后续快照只保存仍然存在的变化根及其所有可达类型。删除使用空 after，未变的版本保留空变化和空快照。
+
+快照覆盖逻辑 Session header、物理 JSONL header、事件信封以及该 tag 的所有第一方事件及传递引用。类型数仅统计规范化后仍可达的定义。历史源码引用仅保留文件路径，不包含行号。
+
+这些回溯记录与上层目录的当前确认链分开校验。当前规则对旧变化的分类只是阅读提示：历史上的 version 0 确实出现过不升版本的结构变化。不得把回填记录作为当前 PR 省略确认或版本提升的依据。
+
+<a id="extraction"></a>
+## 提取与限制
+
+重建使用各 tag 中的源码、TypeScript 6.0.3 和已合入的 [schema 提取器](../../../scripts/persistence-schema.ts)。唯一提取适配是省略早期具体事件记录交叉类型中冗余的 `object` 成员。原有 `any` / `unknown` 保持不透明；没有为缺失引用额外替换不透明类型。发行快照 JSON 保留历史标识符；术语检查仍适用于人工记录和当前 schema。
+
+前 22 个 tag 的 surface 事件合法地带有可选 `surfaceOp`。历史解析保留此可选性；当前源码解析仍要求该字段必需。旧版 `SessionHeader.version: number` 也按原声明保留，实际写入版本常量另行记录。不能从宽泛的 `number` 声明推导它。
+
+本批 tag 的写入版本为 0、2 和 3，没有写入版本 1 的 tag。
+
+摘要对应规范化后的重建类型，不是原始源码文本或当时工具链的逐字重现。说明仅提供结构变化的粗略理解；未重放旧应用、验证完整编解码行为或证明迁移安全。摘要未变也不能证明行为未变。
+
+<a id="verification"></a>
+## 校验
+
+全部 26 个快照已通过规范图、根摘要和可达类型摘要校验。发行归档检查只读取本树中的清单、记录和快照，不访问 Git、网络或旧版本 checkout；它校验清单覆盖、前驱、before/after、快照类型完整性和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+pnpm run doc-sync
+```
+
+标记区间内的索引、清单单元格和结构变化事实由快照生成。默认校验会拒绝陈旧事实。运行 `pnpm run verify-persistence-releases --write` 可在全部机器数据校验通过后刷新这些区间和配对记录；人工概述、源码证据、机器声明和 schema 文件保持不变。
+
+tag 的完整性以清单的捕获范围为准；离线检查不会自动发现后续新 tag。配对记录及 Markdown 链接由常规文档检查校验。[格式模板](../../../.agents/skills/dsh-doc/templates/persistence-release.md)规定单条记录的字段。
+
+<a id="dev-note"></a>
+## 开发备注
+
+<details>
+<summary>维护者工作上下文 — 点击展开</summary>
+
+无。
+
+</details>

package/kb/extra/persistence-changes/releases/dsh-v0.0.1-rc.1.md

@@ -0,0 +1,201 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.0.1-rc.1."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.0.1-rc.1
+
+English | [中文](dsh-v0.0.1-rc.1.zh.md)
+
+## Summary
+
+This is the earliest available DSH alpha/rc tag and establishes the historical baseline: 42 persistence roots and writer format 0.
+
+## Table of Contents
+
+- [Release evidence](#evidence)
+- [Declaration](#declaration)
+- [Structural changes](#changes)
+- [Verification](#verification)
+- [Dev Note](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## Release evidence
+
+This approximate backfill supports reading and format validation; it is not a contemporaneous compatibility acknowledgement. See the [archive reference](README.md) for extraction and coverage limits.
+
+| Item | Recorded value |
+|---|---|
+| Source tag | `dsh-v0.0.1-rc.1` |
+| Source date | 2026-08-10T19:25:09.000Z |
+| Release record | Tag only; no release object. |
+| Previous release | Earliest available prerelease tag; no earlier comparison input. |
+| Session writer version | 0 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->42 roots / 341 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.0.1-rc.1.schema.json](dsh-v0.0.1-rc.1.schema.json) |
+
+Source evidence for the writer version constant at this tag:
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 0`
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.0.1-rc.1
+previous: null
+sessionFormatVersion: 0
+changes:
+  - root: JsonlHeaderLine
+    before: null
+    after: 63496702a393356d64638beb7939468c1ba039ba3b5492327b2fe074d6cdac93
+  - root: SessionEventEnvelope
+    before: null
+    after: 75af2f6612424c13f0e4e215925c3520923c85f2774c1c505490cff6c4747bc2
+  - root: SessionHeader
+    before: null
+    after: a50373168c4935222b1681223d919a56d095ce37ad45c5ba2c20d75235adf937
+  - root: event:agent-preset/selected
+    before: null
+    after: dcfce00f7b4db0ec0d652c4f4a4cdfe00b728da9ce132efefb1393c3943782f7
+  - root: event:agent/inbox/spliced
+    before: null
+    after: 264e11c61f93de1be14d4c515b517ca4d201eb539d5148c7e2973f26a50c7e23
+  - root: event:approval/asked
+    before: null
+    after: 976f2c5f972f5af8f96c4e8ab19383bd64ef4bb8b14bcf8c8d94f4df1e762e9c
+  - root: event:approval/decided
+    before: null
+    after: 1bf7832b6c2b95f3555dac19d34065fae19999c81d25f7d6cf04fe9c77552b48
+  - root: event:approval/policy
+    before: null
+    after: cce8f654f2885f425de9f235c1a03794b5ff4937d1ad304f7721a97e364cc601
+  - root: event:assistant/chunk
+    before: null
+    after: 6941f6ed08c5a5e296852ce6d3661bf063fb8923ab3b7f1614bcafd7aa11b15d
+  - root: event:assistant/message
+    before: null
+    after: ed8be09ea84f4ae65e1f90b54b16f571f221d8591780ea02c86fb47a326a2ea9
+  - root: event:command/done
+    before: null
+    after: ef2a4328b90be1b415bcce88b7abd27e6d2e18f4a6f2fe0f4e7ee5542a7674be
+  - root: event:command/run
+    before: null
+    after: 83bc42948e1c7da398e1b596a0fab808e2b410457498b90a47466a73ad5299d5
+  - root: event:compact/end
+    before: null
+    after: 2d716a572add9ecf56c7ddcaaf38e919f562ff9dd3f01889c44594635152d84e
+  - root: event:compact/prune
+    before: null
+    after: b489c09d9067a6312a1b61f955f0d86aabbd4a103bf6a10fe145e3c75ad65a9c
+  - root: event:compact/start
+    before: null
+    after: 3bec49e3d40a344b64b6a0d445d2e19f179b7d0ad23b5f00d90612fa260d6b27
+  - root: event:compact/summary
+    before: null
+    after: 0a3551284c84ff0f8b1040698ece64513c136a4c1b504d13192057a083e523b3
+  - root: event:feedback/record
+    before: null
+    after: d342dd39f6eab7565340782afccb4c66dea52744f17e9d3b267f7666319ece63
+  - root: event:goal/change
+    before: null
+    after: 7e0b8a5bf14c5709d8645c9022fb1835fb9de915ff94b3c7276ac86a03912ab0
+  - root: event:hook/invoked
+    before: null
+    after: 47aba122c2eba565fca03e4433586b00b75edc7c9c15cc970419d261b75ec748
+  - root: event:hook/result
+    before: null
+    after: c50ce5176c069912b904fcc832153e3db0c95545d1eb015bd45222eb84f8c664
+  - root: event:llm/retry
+    before: null
+    after: 562f0f8138cfdf4b6f7c7d23c95d4c0b30f1a4ccb4db118c2978d8828fb42eb7
+  - root: event:llm/retry-started
+    before: null
+    after: c2d00a5b35a0a648f97f14d855ca23af9feec1a4d1e5e05548adc0352ba234b5
+  - root: event:permission/preset
+    before: null
+    after: d2a5c0f253863c7fa956d483f71d6c013862f91c1458bbc741417c597230478b
+  - root: event:plan/mode
+    before: null
+    after: 67cc5900f3194024998a4f65f7fb50e6c8b30c3393d52e545dbca89c731dc096
+  - root: event:request/context
+    before: null
+    after: af86fda2262cdb5e047091edb5f402c2e66eb06c8c68783654e6da987feae05c
+  - root: event:request/header
+    before: null
+    after: d075d9d331ec389bd1a2796f87348556f15ee799b60d4307712b06ec0bd50daa
+  - root: event:sandbox/mode
+    before: null
+    after: e0d0bdff25ad9be31aee94770baf1d83c8950110f80d8cb0dfd8a143465fe290
+  - root: event:session/end-seed
+    before: null
+    after: ed81f8c485d16e2717a65c7b6feab7b6552bd79a6634ea9e7deb2bd958940320
+  - root: event:session/title
+    before: null
+    after: a0c63e3dcf542a4a8bef65f90e015178933a13eb63cfb838d59399081f635ce1
+  - root: event:session/title-llm-request
+    before: null
+    after: a968ab9ddc4489b5c84f9302c58b5070b1379dd98b9aff8d22e076d55c707647
+  - root: event:step/end
+    before: null
+    after: 0168132589f5214805264d9d2eb016047562c262925d8f3cec3587e9327c27b8
+  - root: event:step/start
+    before: null
+    after: 5d4bdc47d480625d4b36ce563dcbdf5e1cf69a5f2126cc21104f78e057a954d0
+  - root: event:subagent/descriptor
+    before: null
+    after: 10a830802d3a4128b275c72e4752f371398a8f235b4f6d9695b473895566df06
+  - root: event:todo/write
+    before: null
+    after: bb8e5c7b55601a8ce4b2e83768cb1ea2a6bd406d5a4b803802ff1d99a232d984
+  - root: event:tool/call
+    before: null
+    after: 0442fcc4f0ed6a21c9b68206e7e2728ca8f0ff4da0e5d8cf18a7dd73dca9258e
+  - root: event:tool/code-dispatch
+    before: null
+    after: 3a992ae57f950015c1269216c186c1c57ce0ebecf4d3296a09864ae9395d0cec
+  - root: event:tool/code-dispatch-start
+    before: null
+    after: 151dda92d52dfe13512e9c84717b8f65e031287f0a64893f08bc915cf7ecf101
+  - root: event:tool/result
+    before: null
+    after: 356b0c7f439cdc3d5cba9873c8dbe472bead730b8cde27481be094004a4f1327
+  - root: event:turn/end
+    before: null
+    after: 2a844951f204be73862c15fe3cf82c074ad718f12b9aa8a0e7d3efdd23c20530
+  - root: event:turn/start
+    before: null
+    after: 5aee351286dccded87a8af1af1678ef38f407617cf12d2dc754ed8a61b9a7d09
+  - root: event:user/message
+    before: null
+    after: c4b5e355b7c7ce538ccb1210b5c042d4bbfe33dd57a910ccd34c7afa11cde648
+  - root: event:web/deepseek-search-llm-request
+    before: null
+    after: 0c5c79711e02bd8faed288bb89a39c77af15ad28010a0ee3d5c98adb1e5c3fe5
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+This entry establishes the historical comparison starting point. Its declaration lists every extracted root; it makes no compatibility judgment about earlier versions.
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## Verification
+
+Extraction passed canonical-graph, root-digest, and reachable-type-digest validation, permitting the original optional `surfaceOp` only for historical surface events. The in-tree check reconstructs each tag from its predecessor and verifies before/after values, snapshot coverage, and bilingual machine declarations.
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.

package/kb/extra/persistence-changes/releases/dsh-v0.0.1-rc.1.zh.md

@@ -0,0 +1,201 @@
+---
+description: "回溯 dsh-v0.0.1-rc.1 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.0.1-rc.1
+
+[English](dsh-v0.0.1-rc.1.md) | 中文
+
+## 概述
+
+这是现有 DSH alpha/rc 标签中最早的版本，作为历史基线：包含 42 个持久化根类型，写入格式为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.0.1-rc.1` |
+| 源码日期 | 2026-08-10T19:25:09.000Z |
+| 发行记录 | 只有 tag，没有 release 对象。 |
+| 前一版本 | 最早可用的预发行 tag；没有更早的比较输入。 |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->42 个根类型 / 341 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.0.1-rc.1.schema.json](dsh-v0.0.1-rc.1.schema.json) |
+
+写入版本常量在该 tag 中的源码证据：
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 0`
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.0.1-rc.1
+previous: null
+sessionFormatVersion: 0
+changes:
+  - root: JsonlHeaderLine
+    before: null
+    after: 63496702a393356d64638beb7939468c1ba039ba3b5492327b2fe074d6cdac93
+  - root: SessionEventEnvelope
+    before: null
+    after: 75af2f6612424c13f0e4e215925c3520923c85f2774c1c505490cff6c4747bc2
+  - root: SessionHeader
+    before: null
+    after: a50373168c4935222b1681223d919a56d095ce37ad45c5ba2c20d75235adf937
+  - root: event:agent-preset/selected
+    before: null
+    after: dcfce00f7b4db0ec0d652c4f4a4cdfe00b728da9ce132efefb1393c3943782f7
+  - root: event:agent/inbox/spliced
+    before: null
+    after: 264e11c61f93de1be14d4c515b517ca4d201eb539d5148c7e2973f26a50c7e23
+  - root: event:approval/asked
+    before: null
+    after: 976f2c5f972f5af8f96c4e8ab19383bd64ef4bb8b14bcf8c8d94f4df1e762e9c
+  - root: event:approval/decided
+    before: null
+    after: 1bf7832b6c2b95f3555dac19d34065fae19999c81d25f7d6cf04fe9c77552b48
+  - root: event:approval/policy
+    before: null
+    after: cce8f654f2885f425de9f235c1a03794b5ff4937d1ad304f7721a97e364cc601
+  - root: event:assistant/chunk
+    before: null
+    after: 6941f6ed08c5a5e296852ce6d3661bf063fb8923ab3b7f1614bcafd7aa11b15d
+  - root: event:assistant/message
+    before: null
+    after: ed8be09ea84f4ae65e1f90b54b16f571f221d8591780ea02c86fb47a326a2ea9
+  - root: event:command/done
+    before: null
+    after: ef2a4328b90be1b415bcce88b7abd27e6d2e18f4a6f2fe0f4e7ee5542a7674be
+  - root: event:command/run
+    before: null
+    after: 83bc42948e1c7da398e1b596a0fab808e2b410457498b90a47466a73ad5299d5
+  - root: event:compact/end
+    before: null
+    after: 2d716a572add9ecf56c7ddcaaf38e919f562ff9dd3f01889c44594635152d84e
+  - root: event:compact/prune
+    before: null
+    after: b489c09d9067a6312a1b61f955f0d86aabbd4a103bf6a10fe145e3c75ad65a9c
+  - root: event:compact/start
+    before: null
+    after: 3bec49e3d40a344b64b6a0d445d2e19f179b7d0ad23b5f00d90612fa260d6b27
+  - root: event:compact/summary
+    before: null
+    after: 0a3551284c84ff0f8b1040698ece64513c136a4c1b504d13192057a083e523b3
+  - root: event:feedback/record
+    before: null
+    after: d342dd39f6eab7565340782afccb4c66dea52744f17e9d3b267f7666319ece63
+  - root: event:goal/change
+    before: null
+    after: 7e0b8a5bf14c5709d8645c9022fb1835fb9de915ff94b3c7276ac86a03912ab0
+  - root: event:hook/invoked
+    before: null
+    after: 47aba122c2eba565fca03e4433586b00b75edc7c9c15cc970419d261b75ec748
+  - root: event:hook/result
+    before: null
+    after: c50ce5176c069912b904fcc832153e3db0c95545d1eb015bd45222eb84f8c664
+  - root: event:llm/retry
+    before: null
+    after: 562f0f8138cfdf4b6f7c7d23c95d4c0b30f1a4ccb4db118c2978d8828fb42eb7
+  - root: event:llm/retry-started
+    before: null
+    after: c2d00a5b35a0a648f97f14d855ca23af9feec1a4d1e5e05548adc0352ba234b5
+  - root: event:permission/preset
+    before: null
+    after: d2a5c0f253863c7fa956d483f71d6c013862f91c1458bbc741417c597230478b
+  - root: event:plan/mode
+    before: null
+    after: 67cc5900f3194024998a4f65f7fb50e6c8b30c3393d52e545dbca89c731dc096
+  - root: event:request/context
+    before: null
+    after: af86fda2262cdb5e047091edb5f402c2e66eb06c8c68783654e6da987feae05c
+  - root: event:request/header
+    before: null
+    after: d075d9d331ec389bd1a2796f87348556f15ee799b60d4307712b06ec0bd50daa
+  - root: event:sandbox/mode
+    before: null
+    after: e0d0bdff25ad9be31aee94770baf1d83c8950110f80d8cb0dfd8a143465fe290
+  - root: event:session/end-seed
+    before: null
+    after: ed81f8c485d16e2717a65c7b6feab7b6552bd79a6634ea9e7deb2bd958940320
+  - root: event:session/title
+    before: null
+    after: a0c63e3dcf542a4a8bef65f90e015178933a13eb63cfb838d59399081f635ce1
+  - root: event:session/title-llm-request
+    before: null
+    after: a968ab9ddc4489b5c84f9302c58b5070b1379dd98b9aff8d22e076d55c707647
+  - root: event:step/end
+    before: null
+    after: 0168132589f5214805264d9d2eb016047562c262925d8f3cec3587e9327c27b8
+  - root: event:step/start
+    before: null
+    after: 5d4bdc47d480625d4b36ce563dcbdf5e1cf69a5f2126cc21104f78e057a954d0
+  - root: event:subagent/descriptor
+    before: null
+    after: 10a830802d3a4128b275c72e4752f371398a8f235b4f6d9695b473895566df06
+  - root: event:todo/write
+    before: null
+    after: bb8e5c7b55601a8ce4b2e83768cb1ea2a6bd406d5a4b803802ff1d99a232d984
+  - root: event:tool/call
+    before: null
+    after: 0442fcc4f0ed6a21c9b68206e7e2728ca8f0ff4da0e5d8cf18a7dd73dca9258e
+  - root: event:tool/code-dispatch
+    before: null
+    after: 3a992ae57f950015c1269216c186c1c57ce0ebecf4d3296a09864ae9395d0cec
+  - root: event:tool/code-dispatch-start
+    before: null
+    after: 151dda92d52dfe13512e9c84717b8f65e031287f0a64893f08bc915cf7ecf101
+  - root: event:tool/result
+    before: null
+    after: 356b0c7f439cdc3d5cba9873c8dbe472bead730b8cde27481be094004a4f1327
+  - root: event:turn/end
+    before: null
+    after: 2a844951f204be73862c15fe3cf82c074ad718f12b9aa8a0e7d3efdd23c20530
+  - root: event:turn/start
+    before: null
+    after: 5aee351286dccded87a8af1af1678ef38f407617cf12d2dc754ed8a61b9a7d09
+  - root: event:user/message
+    before: null
+    after: c4b5e355b7c7ce538ccb1210b5c042d4bbfe33dd57a910ccd34c7afa11cde648
+  - root: event:web/deepseek-search-llm-request
+    before: null
+    after: 0c5c79711e02bd8faed288bb89a39c77af15ad28010a0ee3d5c98adb1e5c3fe5
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+本条记录建立历史比较起点。机器声明列出所有提取的根类型，不对更早版本作兼容性判断。
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## 校验
+
+提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 `surfaceOp`。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。