dsh-plugin-dev-kb 1.3.0 → 1.5.1

package/kb/extra/persistence-changes/releases/dsh-v0.1.2-alpha.3.zh.md

@@ -0,0 +1,75 @@
+---
+description: "回溯 dsh-v0.1.2-alpha.3 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.2-alpha.3
+
+[English](dsh-v0.1.2-alpha.3.md) | 中文
+
+## 概述
+
+重建的所有持久化根类型摘要均与上一个 alpha 标签一致。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.2-alpha.3` |
+| 源码日期 | 2026-08-31T15:53:17.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.2-alpha.2](dsh-v0.1.2-alpha.2.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->54 个根类型 / 417 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.2-alpha.3.schema.json](dsh-v0.1.2-alpha.3.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.1.2-alpha.3
+previous: dsh-v0.1.2-alpha.2
+sessionFormatVersion: 0
+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.2-alpha.4.md

@@ -0,0 +1,95 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.2-alpha.4."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.2-alpha.4
+
+English | [中文](dsh-v0.1.2-alpha.4.zh.md)
+
+## Summary
+
+The logical SessionHeader replaces optional seedLength with required isSeeded, while the physical JSONL header still declares seedLength. The subagent-report and coordinator user-message source variants become agent-message. The writer format remains 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.1.2-alpha.4` |
+| Source date | 2026-09-01T15:37:26.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.2-alpha.3](dsh-v0.1.2-alpha.3.md) |
+| Session writer version | 0 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->54 roots / 415 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.2-alpha.4.schema.json](dsh-v0.1.2-alpha.4.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.1.2-alpha.4
+previous: dsh-v0.1.2-alpha.3
+sessionFormatVersion: 0
+changes:
+  - root: SessionHeader
+    before: a50373168c4935222b1681223d919a56d095ce37ad45c5ba2c20d75235adf937
+    after: 001ed6f66d67fac9cb9594b55f13557db94174fe5d5954789bb5a2d6d5927226
+  - root: event:agent/inbox/spliced
+    before: ee796690277eafbcda4437478de7a8f01d983424d6238fe472df9b3b0d97a89f
+    after: 15cdff6391d58ea00d7e2fe113b663d5479cbb3fd1af26717ad933c770bca081
+  - root: event:session/title-llm-request
+    before: 61651f4ca07ab9ebef773d82fafbcb74d39190a255c69ecc36084046123a9cb4
+    after: 2cfb71f7819bc88a6bccbffa8b7ae5664233af6f6e1dfb068db25e2e17ddd8c7
+  - root: event:user/message
+    before: e23368db1646a9ac10d2bd4629084fdff583a1db2c83ffaa3f2f201d0c45f3e4
+    after: e950c87ba49bd8175b8a670b319a599d5ed14cde996540d5ba91a141fad68781
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+Detected 4 changed roots and 5 structural differences. The review requirement below is calculated using current rules for comparison only; it does not assert historical compliance, migration correctness, or runtime compatibility.
+
+| Path | Change | Review requirement |
+|---|---|---|
+| `SessionHeader.seedLength` | `property-removed` | `review-required` |
+| `SessionHeader.isSeeded` | `required-property-added` | `review-required` |
+| `event:agent/inbox/spliced.data.inserted[].source` | `union-variants-changed` | `review-required` |
+| `event:session/title-llm-request.data.messages[].source` | `union-variants-changed` | `review-required` |
+| `event:user/message.data.source` | `union-variants-changed` | `review-required` |
+
+<!-- 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.2-alpha.4.zh.md

@@ -0,0 +1,95 @@
+---
+description: "回溯 dsh-v0.1.2-alpha.4 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.2-alpha.4
+
+[English](dsh-v0.1.2-alpha.4.md) | 中文
+
+## 概述
+
+逻辑 SessionHeader 以必需字段 isSeeded 替代可选字段 seedLength，但物理 JSONL 头仍声明 seedLength。用户消息来源变体 subagent-report 和 coordinator 改为 agent-message。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.2-alpha.4` |
+| 源码日期 | 2026-09-01T15:37:26.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.2-alpha.3](dsh-v0.1.2-alpha.3.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->54 个根类型 / 415 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.2-alpha.4.schema.json](dsh-v0.1.2-alpha.4.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.1.2-alpha.4
+previous: dsh-v0.1.2-alpha.3
+sessionFormatVersion: 0
+changes:
+  - root: SessionHeader
+    before: a50373168c4935222b1681223d919a56d095ce37ad45c5ba2c20d75235adf937
+    after: 001ed6f66d67fac9cb9594b55f13557db94174fe5d5954789bb5a2d6d5927226
+  - root: event:agent/inbox/spliced
+    before: ee796690277eafbcda4437478de7a8f01d983424d6238fe472df9b3b0d97a89f
+    after: 15cdff6391d58ea00d7e2fe113b663d5479cbb3fd1af26717ad933c770bca081
+  - root: event:session/title-llm-request
+    before: 61651f4ca07ab9ebef773d82fafbcb74d39190a255c69ecc36084046123a9cb4
+    after: 2cfb71f7819bc88a6bccbffa8b7ae5664233af6f6e1dfb068db25e2e17ddd8c7
+  - root: event:user/message
+    before: e23368db1646a9ac10d2bd4629084fdff583a1db2c83ffaa3f2f201d0c45f3e4
+    after: e950c87ba49bd8175b8a670b319a599d5ed14cde996540d5ba91a141fad68781
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+检测到 4 个根类型变化、5 项结构差异。下表的审查要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
+
+| 路径 | 变化 | 审查要求 |
+|---|---|---|
+| `SessionHeader.seedLength` | `property-removed` | `review-required` |
+| `SessionHeader.isSeeded` | `required-property-added` | `review-required` |
+| `event:agent/inbox/spliced.data.inserted[].source` | `union-variants-changed` | `review-required` |
+| `event:session/title-llm-request.data.messages[].source` | `union-variants-changed` | `review-required` |
+| `event:user/message.data.source` | `union-variants-changed` | `review-required` |
+
+<!-- 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.2-alpha.5.md

@@ -0,0 +1,75 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.2-alpha.5."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.2-alpha.5
+
+English | [中文](dsh-v0.1.2-alpha.5.zh.md)
+
+## Summary
+
+All reconstructed persistence root digests match the preceding alpha/rc tag. The writer format remains 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.1.2-alpha.5` |
+| Source date | 2026-09-02T07:57:43.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.2-alpha.4](dsh-v0.1.2-alpha.4.md) |
+| Session writer version | 0 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->54 roots / 415 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.2-alpha.5.schema.json](dsh-v0.1.2-alpha.5.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.1.2-alpha.5
+previous: dsh-v0.1.2-alpha.4
+sessionFormatVersion: 0
+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.2-alpha.5.zh.md

@@ -0,0 +1,75 @@
+---
+description: "回溯 dsh-v0.1.2-alpha.5 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.2-alpha.5
+
+[English](dsh-v0.1.2-alpha.5.md) | 中文
+
+## 概述
+
+重建的所有持久化根类型摘要均与上一个 alpha/rc 标签一致。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.2-alpha.5` |
+| 源码日期 | 2026-09-02T07:57:43.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.2-alpha.4](dsh-v0.1.2-alpha.4.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->54 个根类型 / 415 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.2-alpha.5.schema.json](dsh-v0.1.2-alpha.5.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.1.2-alpha.5
+previous: dsh-v0.1.2-alpha.4
+sessionFormatVersion: 0
+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.2-rc.1.md

@@ -0,0 +1,75 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.2-rc.1."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.2-rc.1
+
+English | [中文](dsh-v0.1.2-rc.1.zh.md)
+
+## Summary
+
+All reconstructed persistence root digests match the preceding alpha/rc tag. The writer format remains 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.1.2-rc.1` |
+| Source date | 2026-09-03T02:35:15.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.2-alpha.5](dsh-v0.1.2-alpha.5.md) |
+| Session writer version | 0 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->54 roots / 415 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.2-rc.1.schema.json](dsh-v0.1.2-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.1.2-rc.1
+previous: dsh-v0.1.2-alpha.5
+sessionFormatVersion: 0
+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.2-rc.1.zh.md

@@ -0,0 +1,75 @@
+---
+description: "回溯 dsh-v0.1.2-rc.1 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.2-rc.1
+
+[English](dsh-v0.1.2-rc.1.md) | 中文
+
+## 概述
+
+重建的所有持久化根类型摘要均与上一个 alpha/rc 标签一致。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.2-rc.1` |
+| 源码日期 | 2026-09-03T02:35:15.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.2-alpha.5](dsh-v0.1.2-alpha.5.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->54 个根类型 / 415 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.2-rc.1.schema.json](dsh-v0.1.2-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.1.2-rc.1
+previous: dsh-v0.1.2-alpha.5
+sessionFormatVersion: 0
+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>
+## 开发备注
+
+无。