dsh-plugin-guide 0.3.15 → 0.3.17

package/references/official-docs/docs/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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/persistence-changes/releases/dsh-v0.1.5-rc.1.md
+dsh-v0.1.5-rc.1.md: e34e7f37ebb69cb59d1f4385c18f0669c8c8457f
+dsh-v0.1.5-rc.1.zh.md: 9bf09e21a18d01bf1e55412901fe84ad741c3258

package/references/official-docs/docs/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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.1.schema.json

@@ -0,0 +1,5 @@
+{
+  "formatVersion": 1,
+  "roots": [],
+  "types": []
+}

package/references/official-docs/docs/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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/persistence-changes/releases/dsh-v0.1.5-rc.2.md
+dsh-v0.1.5-rc.2.md: 6922fe63dd1239cad10793df47b0f26e431d2aed
+dsh-v0.1.5-rc.2.zh.md: ec3c16c6663ae60b88dc847921dde20bca6da097

package/references/official-docs/docs/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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.5-rc.2.schema.json

@@ -0,0 +1,5 @@
+{
+  "formatVersion": 1,
+  "roots": [],
+  "types": []
+}

package/references/official-docs/docs/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/references/official-docs/docs/persistence-changes/releases/manifest.json

@@ -0,0 +1,162 @@
+{
+  "schemaVersion": 1,
+  "capturedAt": "2026-09-12",
+  "releases": [
+    {
+      "tag": "dsh-v0.0.1-rc.1",
+      "sourceDate": "2026-08-10T19:25:09.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.0.1-rc.2",
+      "sourceDate": "2026-08-11T15:04:55.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.0.1-rc.3",
+      "sourceDate": "2026-08-12T20:18:26.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.0.1-rc.4",
+      "sourceDate": "2026-08-12T21:29:23.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.0.1-rc.5",
+      "sourceDate": "2026-08-12T22:18:58.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.1",
+      "sourceDate": "2026-08-13T08:51:36.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.2",
+      "sourceDate": "2026-08-13T09:23:52.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.3",
+      "sourceDate": "2026-08-13T10:40:08.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.5",
+      "sourceDate": "2026-08-13T11:38:46.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.6",
+      "sourceDate": "2026-08-13T11:56:40.000Z",
+      "publishedAt": null,
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.7",
+      "sourceDate": "2026-08-17T11:03:17.000Z",
+      "publishedAt": "2026-08-17T11:48:11Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.0-rc.8",
+      "sourceDate": "2026-08-19T15:11:50.000Z",
+      "publishedAt": "2026-08-19T15:30:55Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.1-rc.1",
+      "sourceDate": "2026-08-21T06:21:44.000Z",
+      "publishedAt": "2026-08-21T06:36:49Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.1-rc.2",
+      "sourceDate": "2026-08-21T12:03:37.000Z",
+      "publishedAt": "2026-08-21T12:26:22Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-alpha.1",
+      "sourceDate": "2026-08-27T16:57:43.000Z",
+      "publishedAt": "2026-08-27T16:59:17Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-alpha.2",
+      "sourceDate": "2026-08-30T13:37:53.000Z",
+      "publishedAt": "2026-08-30T13:40:23Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-alpha.3",
+      "sourceDate": "2026-08-31T15:53:17.000Z",
+      "publishedAt": "2026-08-31T15:55:32Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-alpha.4",
+      "sourceDate": "2026-09-01T15:37:26.000Z",
+      "publishedAt": "2026-09-01T15:39:10Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-alpha.5",
+      "sourceDate": "2026-09-02T07:57:43.000Z",
+      "publishedAt": "2026-09-02T08:14:34Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.2-rc.1",
+      "sourceDate": "2026-09-03T02:35:15.000Z",
+      "publishedAt": "2026-09-03T05:42:52Z",
+      "sessionFormatVersion": 0
+    },
+    {
+      "tag": "dsh-v0.1.3-alpha.1",
+      "sourceDate": "2026-09-04T09:16:23.000Z",
+      "publishedAt": "2026-09-04T09:42:12Z",
+      "sessionFormatVersion": 2
+    },
+    {
+      "tag": "dsh-v0.1.3-alpha.2",
+      "sourceDate": "2026-09-07T11:45:35.000Z",
+      "publishedAt": "2026-09-07T12:49:54Z",
+      "sessionFormatVersion": 2
+    },
+    {
+      "tag": "dsh-v0.1.5-alpha.1",
+      "sourceDate": "2026-09-08T15:25:45.000Z",
+      "publishedAt": "2026-09-08T15:56:47Z",
+      "sessionFormatVersion": 3
+    },
+    {
+      "tag": "dsh-v0.1.5-alpha.2",
+      "sourceDate": "2026-09-09T14:13:03.000Z",
+      "publishedAt": "2026-09-09T14:19:39Z",
+      "sessionFormatVersion": 3
+    },
+    {
+      "tag": "dsh-v0.1.5-rc.1",
+      "sourceDate": "2026-09-10T01:36:48.000Z",
+      "publishedAt": "2026-09-10T02:04:45Z",
+      "sessionFormatVersion": 3
+    },
+    {
+      "tag": "dsh-v0.1.5-rc.2",
+      "sourceDate": "2026-09-10T13:50:19.000Z",
+      "publishedAt": "2026-09-10T14:31:28Z",
+      "sessionFormatVersion": 3
+    }
+  ]
+}