dsh-plugin-dev-kb 1.3.0 → 1.4.0

package/kb/extra/persistence-changes/releases/dsh-v0.1.5-alpha.1.zh.md

@@ -0,0 +1,139 @@
+---
+description: "回溯 dsh-v0.1.5-alpha.1 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.5-alpha.1
+
+[English](dsh-v0.1.5-alpha.1.md) | 中文
+
+## 概述
+
+写入格式从 2 升至 3：新增 system/message，EpochHeader 删除 system。SurfaceOp 替换操作的字段从 start/end 改为 startSeq/endSeq，tool/code-dispatch 事件键改为 tool/ptc-dispatch 事件键。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.5-alpha.1` |
+| 源码日期 | 2026-09-08T15:25:45.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.3-alpha.2](dsh-v0.1.3-alpha.2.zh.md) |
+| Session 写入版本 | 3 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->57 个根类型 / 443 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.5-alpha.1.schema.json](dsh-v0.1.5-alpha.1.schema.json) |
+
+写入版本常量在该 tag 中的源码证据：
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-alpha.1
+previous: dsh-v0.1.3-alpha.2
+sessionFormatVersion: 3
+changes:
+  - root: SessionEventEnvelope
+    before: 04184edc061905410cc7e3db8d5c7cf393d739c89eb523ba8bad3831fb23ba95
+    after: 5776e5553ff2dfe3f5bc202dbb1e7c9f93e35a531aebb7764c23b2b6153b2ccc
+  - root: SessionHeader
+    before: 15918d785bdccedf0dba204622c75591bfb833bbf107ae0894bbc44cfbd73c1d
+    after: 2a8b114637e66faab5fae1c6e2fba65320db6224c80f5f36c5bf32f937154d03
+  - root: event:assistant/message
+    before: 83f26c7a856f772e6ffd9a5a144e5aaccf771ac54cef41948f99eed99e1a25a7
+    after: a58ca1bed502d425a8b65cac02f59717498cd296de9513c6f81b83b791c20e9b
+  - root: event:request/context
+    before: f6b733e38d46dde3f8ab1ade2be3362abb6642eb97982a98ee64a57ff60d0c28
+    after: 37cbc9cf06d494cfe5c67f078af1605eacb8e4c2c853e9e26455b73de0ee7ccf
+  - root: event:request/header
+    before: 1de6c9c8764045ea9a1357bae6ccbbd57c19f6f337f8f25697c919c7cc9abf16
+    after: 8ea13bcd983eab596dbfd41c5c2b62a0b318b71cd2a987a6fd752c6ced7e4489
+  - root: event:system/message
+    before: null
+    after: 0ae7ccdc1cc5d9d43772ebd5c7357ff509011c3a6ba188d9c274d33df2542c42
+  - root: event:tool/code-dispatch
+    before: f8dc5624cd0c942a069063ae0d90a61d821b4fddd1d967dcded91cf17933e708
+    after: null
+  - root: event:tool/code-dispatch-start
+    before: 9eb21c10fc675e1fa4184e5eecc9697aa87054ffd836d49428174897f0e64b62
+    after: null
+  - root: event:tool/ptc-dispatch
+    before: null
+    after: da807583a19f4ebe2bc9115c9686016e1521e405bdfaced296ae652b91e8e5f6
+  - root: event:tool/ptc-dispatch-start
+    before: null
+    after: ec38b5949af8eacaf00df002f4acbe344f934f8a061e9cdc65a52a48e5f6dd93
+  - root: event:tool/result
+    before: eacefd48000720582725ccfc6ff7a0ac02755a1a3c57a8f9754125f99aab6c1b
+    after: cc3e270ab982cbafff602b753647b6f056decb7fe4fd523afd2f157a65c3d622
+  - root: event:user/message
+    before: a57a77f18de7b37b724293830a57064696895d69f2afcd2c0264f41cd13ba980
+    after: 2e49ede7fb3a592cce8919ebe982f6ca1c1f67abe4def359ffc028c85e6d1ad8
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+检测到 12 个根类型变化、25 项结构差异。下表的最低要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
+
+| 路径 | 变化 | 当前最低要求 |
+|---|---|---|
+| `SessionEventEnvelope` | `union-variants-changed` | `version-bump` |
+| `SessionHeader.version` | `type-changed` | `version-bump` |
+| `event:assistant/message.sourceEventSeqs` | `property-removed` | `version-bump` |
+| `event:assistant/message.surfaceOp` | `property-made-required` | `version-bump` |
+| `event:assistant/message.surfaceOp.end` | `property-removed` | `version-bump` |
+| `event:assistant/message.surfaceOp.start` | `property-removed` | `version-bump` |
+| `event:assistant/message.surfaceOp.endSeq` | `required-property-added` | `version-bump` |
+| `event:assistant/message.surfaceOp.startSeq` | `required-property-added` | `version-bump` |
+| `event:request/context.data.systemPromptUpdate` | `optional-property-added` | `same-version` |
+| `event:request/header.data.header.system` | `property-removed` | `version-bump` |
+| `event:system/message` | `root-added` | `version-bump` |
+| `event:tool/code-dispatch` | `root-removed` | `version-bump` |
+| `event:tool/code-dispatch-start` | `root-removed` | `version-bump` |
+| `event:tool/ptc-dispatch` | `root-added` | `same-version` |
+| `event:tool/ptc-dispatch-start` | `root-added` | `same-version` |
+| `event:tool/result.surfaceOp` | `property-made-required` | `version-bump` |
+| `event:tool/result.surfaceOp.end` | `property-removed` | `version-bump` |
+| `event:tool/result.surfaceOp.start` | `property-removed` | `version-bump` |
+| `event:tool/result.surfaceOp.endSeq` | `required-property-added` | `version-bump` |
+| `event:tool/result.surfaceOp.startSeq` | `required-property-added` | `version-bump` |
+| `event:user/message.surfaceOp` | `property-made-required` | `version-bump` |
+| `event:user/message.surfaceOp.end` | `property-removed` | `version-bump` |
+| `event:user/message.surfaceOp.start` | `property-removed` | `version-bump` |
+| `event:user/message.surfaceOp.endSeq` | `required-property-added` | `version-bump` |
+| `event:user/message.surfaceOp.startSeq` | `required-property-added` | `version-bump` |
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## 校验
+
+提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 `surfaceOp`。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/kb/extra/persistence-changes/releases/dsh-v0.1.5-alpha.2.md

@@ -0,0 +1,95 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.5-alpha.2."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.5-alpha.2
+
+English | [中文](dsh-v0.1.5-alpha.2.zh.md)
+
+## Summary
+
+deliverables/presented and subagent/catalog are added. Feedback records gain optional category, feedback/record text becomes optional, and the writer format remains 3.
+
+## 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.1.5-alpha.2` |
+| Source date | 2026-09-09T14:13:03.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.5-alpha.1](dsh-v0.1.5-alpha.1.md) |
+| Session writer version | 3 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->59 roots / 462 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.5-alpha.2.schema.json](dsh-v0.1.5-alpha.2.schema.json) |
+
+Source evidence for the writer version constant at this tag:
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-alpha.2
+previous: dsh-v0.1.5-alpha.1
+sessionFormatVersion: 3
+changes:
+  - root: event:deliverables/presented
+    before: null
+    after: 13d3d180f977bf78081d487ffa0ecb75857349bcab29a5a3fb48189fca2a6176
+  - root: event:feedback/message-put
+    before: 3b04fde0dc763cf84fbde7b6611b3194dd56d95d0c0bf0204311640468d586e1
+    after: b5086d249e8502e9ead1d39156bb8d559bde7951cac0f14ce150345b4e42a2bf
+  - root: event:feedback/record
+    before: fb9df8180a202f3c845d5aa6a81697b2f7213f6735abc17535a55656be60a575
+    after: b54940ff095c17e874c5be03815f4c2145a256cf3a1d34dae4ab2f7769dfffe8
+  - root: event:subagent/catalog
+    before: null
+    after: ae1f7110feeec697b8cab42b68f7709aa7b3279764099dfb53c25890d2e5c871
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+Detected 4 changed roots and 5 structural differences. The minimum below is calculated using current rules for comparison only; it does not assert historical compliance, migration correctness, or runtime compatibility.
+
+| Path | Change | Current minimum |
+|---|---|---|
+| `event:deliverables/presented` | `root-added` | `same-version` |
+| `event:feedback/message-put.data.item.category` | `optional-property-added` | `same-version` |
+| `event:feedback/record.data.text` | `property-made-optional` | `same-version` |
+| `event:feedback/record.data.category` | `optional-property-added` | `same-version` |
+| `event:subagent/catalog` | `root-added` | `same-version` |
+
+<!-- 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.1.5-alpha.2.zh.md

@@ -0,0 +1,95 @@
+---
+description: "回溯 dsh-v0.1.5-alpha.2 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.5-alpha.2
+
+[English](dsh-v0.1.5-alpha.2.md) | 中文
+
+## 概述
+
+新增 deliverables/presented 和 subagent/catalog。反馈记录新增可选字段 category，feedback/record 的 text 改为可选字段；写入格式仍为 3。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.5-alpha.2` |
+| 源码日期 | 2026-09-09T14:13:03.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.5-alpha.1](dsh-v0.1.5-alpha.1.zh.md) |
+| Session 写入版本 | 3 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->59 个根类型 / 462 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.5-alpha.2.schema.json](dsh-v0.1.5-alpha.2.schema.json) |
+
+写入版本常量在该 tag 中的源码证据：
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-alpha.2
+previous: dsh-v0.1.5-alpha.1
+sessionFormatVersion: 3
+changes:
+  - root: event:deliverables/presented
+    before: null
+    after: 13d3d180f977bf78081d487ffa0ecb75857349bcab29a5a3fb48189fca2a6176
+  - root: event:feedback/message-put
+    before: 3b04fde0dc763cf84fbde7b6611b3194dd56d95d0c0bf0204311640468d586e1
+    after: b5086d249e8502e9ead1d39156bb8d559bde7951cac0f14ce150345b4e42a2bf
+  - root: event:feedback/record
+    before: fb9df8180a202f3c845d5aa6a81697b2f7213f6735abc17535a55656be60a575
+    after: b54940ff095c17e874c5be03815f4c2145a256cf3a1d34dae4ab2f7769dfffe8
+  - root: event:subagent/catalog
+    before: null
+    after: ae1f7110feeec697b8cab42b68f7709aa7b3279764099dfb53c25890d2e5c871
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+检测到 4 个根类型变化、5 项结构差异。下表的最低要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
+
+| 路径 | 变化 | 当前最低要求 |
+|---|---|---|
+| `event:deliverables/presented` | `root-added` | `same-version` |
+| `event:feedback/message-put.data.item.category` | `optional-property-added` | `same-version` |
+| `event:feedback/record.data.text` | `property-made-optional` | `same-version` |
+| `event:feedback/record.data.category` | `optional-property-added` | `same-version` |
+| `event:subagent/catalog` | `root-added` | `same-version` |
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## 校验
+
+提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 `surfaceOp`。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

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

@@ -0,0 +1,75 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.5-rc.1."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.5-rc.1
+
+English | [中文](dsh-v0.1.5-rc.1.zh.md)
+
+## Summary
+
+All reconstructed persistence root digests match the preceding alpha/rc tag. The writer format remains 3.
+
+## 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.1.5-rc.1` |
+| Source date | 2026-09-10T01:36:48.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.5-alpha.2](dsh-v0.1.5-alpha.2.md) |
+| Session writer version | 3 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->59 roots / 462 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.5-rc.1.schema.json](dsh-v0.1.5-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 = 3`
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-rc.1
+previous: dsh-v0.1.5-alpha.2
+sessionFormatVersion: 3
+changes: []
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+Normalized root types and their transitive digests are unchanged from the preceding tag.
+
+<!-- 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.1.5-rc.1.zh.md

@@ -0,0 +1,75 @@
+---
+description: "回溯 dsh-v0.1.5-rc.1 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.5-rc.1
+
+[English](dsh-v0.1.5-rc.1.md) | 中文
+
+## 概述
+
+重建的所有持久化根类型摘要均与上一个 alpha/rc 标签一致。写入格式仍为 3。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.5-rc.1` |
+| 源码日期 | 2026-09-10T01:36:48.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.5-alpha.2](dsh-v0.1.5-alpha.2.zh.md) |
+| Session 写入版本 | 3 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->59 个根类型 / 462 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.5-rc.1.schema.json](dsh-v0.1.5-rc.1.schema.json) |
+
+写入版本常量在该 tag 中的源码证据：
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-rc.1
+previous: dsh-v0.1.5-alpha.2
+sessionFormatVersion: 3
+changes: []
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+规范化后的根类型及其传递引用摘要与前一 tag 相同。
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## 校验
+
+提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 `surfaceOp`。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/kb/extra/persistence-changes/releases/dsh-v0.1.5-rc.2.md

@@ -0,0 +1,75 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.5-rc.2."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.5-rc.2
+
+English | [中文](dsh-v0.1.5-rc.2.zh.md)
+
+## Summary
+
+All reconstructed persistence root digests match the preceding alpha/rc tag. The writer format remains 3.
+
+## 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.1.5-rc.2` |
+| Source date | 2026-09-10T13:50:19.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.5-rc.1](dsh-v0.1.5-rc.1.md) |
+| Session writer version | 3 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->59 roots / 462 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.5-rc.2.schema.json](dsh-v0.1.5-rc.2.schema.json) |
+
+Source evidence for the writer version constant at this tag:
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-rc.2
+previous: dsh-v0.1.5-rc.1
+sessionFormatVersion: 3
+changes: []
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+Normalized root types and their transitive digests are unchanged from the preceding tag.
+
+<!-- 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.1.5-rc.2.zh.md

@@ -0,0 +1,75 @@
+---
+description: "回溯 dsh-v0.1.5-rc.2 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.5-rc.2
+
+[English](dsh-v0.1.5-rc.2.md) | 中文
+
+## 概述
+
+重建的所有持久化根类型摘要均与上一个 alpha/rc 标签一致。写入格式仍为 3。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.5-rc.2` |
+| 源码日期 | 2026-09-10T13:50:19.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.5-rc.1](dsh-v0.1.5-rc.1.zh.md) |
+| Session 写入版本 | 3 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->59 个根类型 / 462 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.5-rc.2.schema.json](dsh-v0.1.5-rc.2.schema.json) |
+
+写入版本常量在该 tag 中的源码证据：
+
+- `packages/core/session/src/types.ts`: `export const SESSION_FORMAT_VERSION = 3`
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-release
+schemaVersion: 1
+tag: dsh-v0.1.5-rc.2
+previous: dsh-v0.1.5-rc.1
+sessionFormatVersion: 3
+changes: []
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+规范化后的根类型及其传递引用摘要与前一 tag 相同。
+
+<!-- persistence-release-changes:end -->
+
+<a id="verification"></a>
+## 校验
+
+提取结果已通过规范图、根摘要和全部可达类型摘要校验；仅对历史 surface 事件允许源码原有的可选 `surfaceOp`。仓库内检查从前驱重建每个 tag，核对 before/after、快照覆盖和双语机器声明。
+
+```sh
+pnpm run verify-persistence-releases
+```
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/kb/extra/rescope.md

@@ -23,7 +23,7 @@ Subpath exports keep their path: `@cordisjs/plugin-loader/repository` becomes `@
 ## What the rename does not touch
 
 - **Directory names and upstream source versions.** `vendor/hmr/` stays `vendor/hmr/`, and the table records the upstream version of the pinned source snapshot, so the manifest reads as an upstream snapshot; the vendored `package.json`'s own `version` field is the harness's released manifest version, which `pnpm run release:vendor` bumps and a re-sync restores to the upstream version.
-- **Dependency ranges.** A dependency entry changes its key, never its range: `"cordis": "^4.0.0-rc.7"` becomes `"@deepseek-ai/cordis": "^4.0.0-rc.7"`. `linkWorkspacePackages` resolves those preserved ranges to the pinned workspaces.
+- **Dependency ranges.** Renaming changes dependency keys without changing ranges. Workspace manifests use the `workspace:` protocol; [repository rules](../AGENTS.md#conventions) distinguish exact DSH references from vendor/native tilde ranges.
 - **The Loader's `cordis:` builtin prefix.** `cordis:include` and `cordis:group` are a protocol prefix, not a package name.
 - **The `cordis.yml` configuration family**, including `*.cordis.yml`, `*.cordis.snapshot.yml`, and `cordis.patch.yml`.
 - **Harness packages whose own names contain the word**, such as `@deepseek-ai/dsh-tool-cordis`.

package/kb/extra/rescope.zh.md

@@ -23,7 +23,7 @@ Cordis 框架及其基础库以源码形式 vendored 在 [`vendor/`](../vendor/R
 ## 改名不碰什么
 
 - **目录名与上游源码版本。** `vendor/hmr/` 仍是 `vendor/hmr/`，清单表记录的是所钉住源码快照的上游版本，因此清单读作一份上游快照；而每个 vendored 包 `package.json` 自身的 `version` 字段是 harness 发布的清单版本，`pnpm run release:vendor` 会提升它，重新 sync 时会恢复成上游版本。
-- **依赖 range。** 依赖条目只换键、不换范围：`"cordis": "^4.0.0-rc.7"` 变成 `"@deepseek-ai/cordis": "^4.0.0-rc.7"`；`linkWorkspacePackages` 靠这些保留下来的范围把它们解析到固定的 workspace。
+- **依赖 range。** 改名只修改依赖键，不改变范围。Workspace 清单使用 `workspace:` 协议；[仓库规则](../AGENTS.md#conventions)区分精确的 DSH 引用与 vendor/native tilde 范围。
 - **Loader 的 `cordis:` 内建前缀。** `cordis:include`、`cordis:group` 是协议前缀，不是包名。
 - **`cordis.yml` 配置文件家族**，包括 `*.cordis.yml`、`*.cordis.snapshot.yml`、`cordis.patch.yml`。
 - **名字里带这个词的 harness 包**，例如 `@deepseek-ai/dsh-tool-cordis`。