dsh-plugin-guide 0.3.10 → 0.3.16

package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.0-rc.8.zh.md

@@ -0,0 +1,110 @@
+---
+description: "回溯 dsh-v0.1.0-rc.8 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.0-rc.8
+
+[English](dsh-v0.1.0-rc.8.md) | 中文
+
+## 概述
+
+新增四种 team/* 事件及用户消息来源变体 team-message；assistant/message 新增可选字段 interrupted。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.0-rc.8` |
+| 源码日期 | 2026-08-19T15:11:50.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.0-rc.7](dsh-v0.1.0-rc.7.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->51 个根类型 / 403 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.0-rc.8.schema.json](dsh-v0.1.0-rc.8.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.0-rc.8
+previous: dsh-v0.1.0-rc.7
+sessionFormatVersion: 0
+changes:
+  - root: event:agent/inbox/spliced
+    before: dea3a1d5640e0306a486f92b725a01b57e69439277978ca09dc246fb40016b90
+    after: 7a0b347ba6a465a7813490036bde98bdc658609c6de9545ba58be26c372c5030
+  - root: event:assistant/message
+    before: 390aeb83383643633a1935f09f84fe19d2aee8d4f500a8de70f88d388562cc50
+    after: fb7d974e1945b4c8e72ee540daf64eb9e81984030ff52e1a97a4e1f71b9dd2f9
+  - root: event:session/title-llm-request
+    before: 796a77af2c1452392f0cc62b99fba2d404d1c9eb10a8a2510a808fba6053cf24
+    after: ee6c879669bb83325e4cd3011227f238bf51765744990fc4bb12089d6dd6563a
+  - root: event:team/member
+    before: null
+    after: 31d13edbb5fe2f8b7a38056320a8a06275ee4426e0abf12d4741818beda5a9c9
+  - root: event:team/message/delivered
+    before: null
+    after: c53bff743470c8bf11be698ced047072744ef088cce663a774b456d7a8982516
+  - root: event:team/message/queued
+    before: null
+    after: 577054184d5f038bd96d6db70b76983a2bb62a8eea8eeed8ca3b0d47af0f462a
+  - root: event:team/task
+    before: null
+    after: 1688a2451eef9da19eaf45f12c8a27df07b1a6e56fa57ba603118f5201bb435b
+  - root: event:user/message
+    before: 18c8d77777545808f232cd8d7730ce270cb1b737edd3eaa45e0da9436fd37a13
+    after: e7eec68e39f9f44b2e53d799e5d5dd08f559558a27e93eb2a272782f040be50a
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+检测到 8 个根类型变化、8 项结构差异。下表的最低要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
+
+| 路径 | 变化 | 当前最低要求 |
+|---|---|---|
+| `event:agent/inbox/spliced.data.inserted[].source` | `union-variants-changed` | `version-bump` |
+| `event:assistant/message.data.interrupted` | `optional-property-added` | `same-version` |
+| `event:session/title-llm-request.data.messages[].source` | `union-variants-changed` | `version-bump` |
+| `event:team/member` | `root-added` | `same-version` |
+| `event:team/message/delivered` | `root-added` | `same-version` |
+| `event:team/message/queued` | `root-added` | `same-version` |
+| `event:team/task` | `root-added` | `same-version` |
+| `event:user/message.data.source` | `union-variants-changed` | `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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-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.1-rc.1.md
+dsh-v0.1.1-rc.1.md: 6b598f1c614e7538d0687e68b7397b362bd9f801
+dsh-v0.1.1-rc.1.zh.md: eca10c509ef0bd0c64433ee62200ae6a4bbd161e

package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.md

@@ -0,0 +1,82 @@
+---
+description: "Retrospective Session persistence types and adjacent-release changes for dsh-v0.1.1-rc.1."
+kind: persistence-release
+---
+
+# Persistence release: dsh-v0.1.1-rc.1
+
+English | [中文](dsh-v0.1.1-rc.1.zh.md)
+
+## Summary
+
+permission/preset gains optional origin with default, selection, and inferred values. 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.1-rc.1` |
+| Source date | 2026-08-21T06:21:44.000Z |
+| Release record | Release object present. |
+| Previous release | [dsh-v0.1.0-rc.8](dsh-v0.1.0-rc.8.md) |
+| Session writer version | 0 |
+| Reconstructed inventory | <!-- persistence-release-inventory:start -->51 roots / 407 types<!-- persistence-release-inventory:end --> |
+| This snapshot | [dsh-v0.1.1-rc.1.schema.json](dsh-v0.1.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.1.1-rc.1
+previous: dsh-v0.1.0-rc.8
+sessionFormatVersion: 0
+changes:
+  - root: event:permission/preset
+    before: 5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b
+    after: 7271e4b771406aaf06014c2269edd6cb68055bb8b8686571730813ce0ababc22
+```
+
+<a id="changes"></a>
+## Structural changes
+
+<!-- persistence-release-changes:start -->
+
+Detected 1 changed root and 1 structural difference. 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:permission/preset.data.origin` | `optional-property-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/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.schema.json

@@ -0,0 +1,417 @@
+{
+  "formatVersion": 1,
+  "roots": [
+    {
+      "key": "event:permission/preset",
+      "kind": "event",
+      "event": "permission/preset",
+      "surface": false,
+      "digest": "7271e4b771406aaf06014c2269edd6cb68055bb8b8686571730813ce0ababc22",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "data",
+                "type": 1,
+                "optional": false
+              },
+              {
+                "name": "ignorable",
+                "type": 7,
+                "optional": true
+              },
+              {
+                "name": "seq",
+                "type": 8,
+                "optional": false
+              },
+              {
+                "name": "time",
+                "type": 8,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 9,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "origin",
+                "type": 2,
+                "optional": true
+              },
+              {
+                "name": "preset",
+                "type": 6,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "union",
+            "types": [
+              3,
+              4,
+              5
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "default"
+          },
+          {
+            "kind": "literal",
+            "value": "inferred"
+          },
+          {
+            "kind": "literal",
+            "value": "selection"
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          },
+          {
+            "kind": "literal",
+            "value": true
+          },
+          {
+            "kind": "primitive",
+            "type": "number"
+          },
+          {
+            "kind": "literal",
+            "value": "permission/preset"
+          }
+        ]
+      }
+    }
+  ],
+  "types": [
+    {
+      "digest": "0657d3ca5ac4e7bf79b00bcf860b1c7159d01a9da137497221ec2f1776e365f7",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "primitive",
+            "type": "number"
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "19a9088b778dbc75c9c3158d0145b3e1d3b9bba253821e249f869db82e98b713",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "literal",
+            "value": "inferred"
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "4cd48f3e5108bd6ebedf7301c3638839b8b2b9db8dbd493974177fbdeb91a01b",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "primitive",
+            "type": "string"
+          }
+        ]
+      },
+      "names": [
+        "packages/attachment/attachment/src/brand.ts#AttachmentId",
+        "packages/compaction/compaction/src/brand.ts#CompactionId",
+        "packages/core/session/src/types.ts#SessionId",
+        "packages/experimental/agent-team/src/types.ts#TeamId",
+        "packages/experimental/agent-team/src/types.ts#TeamMessageId",
+        "packages/experimental/agent-team/src/types.ts#TeamTaskId",
+        "packages/goal/goal/src/types.ts#GoalId",
+        "packages/host/apiproxy/src/api/rpc.ts#RpcId",
+        "packages/interaction/commands/src/brand.ts#CommandId",
+        "packages/interaction/user-approval/src/types.ts#ApprovalRequestId",
+        "packages/llm/llm-retry/src/brand.ts#RetryId",
+        "packages/llm/llm/src/brand.ts#CallId",
+        "packages/llm/llm/src/brand.ts#MessageId",
+        "packages/llm/llm/src/brand.ts#ProviderRequestId",
+        "packages/llm/llm/src/brand.ts#ReasoningEffortId",
+        "packages/schedule/schedule/src/types.ts#ScheduleId",
+        "packages/session/session-title/src/index.ts#SessionTitleProviderId",
+        "packages/workflow/workflow/src/types.ts#WorkflowRunId"
+      ],
+      "sources": [
+        "packages/attachment/attachment/src/brand.ts",
+        "packages/compaction/compaction/src/brand.ts",
+        "packages/core/session/src/types.ts",
+        "packages/experimental/agent-team/src/types.ts",
+        "packages/goal/goal/src/types.ts",
+        "packages/host/apiproxy/src/api/rpc.ts",
+        "packages/interaction/commands/src/brand.ts",
+        "packages/interaction/user-approval/src/types.ts",
+        "packages/llm/llm-retry/src/brand.ts",
+        "packages/llm/llm/src/brand.ts",
+        "packages/schedule/schedule/src/types.ts",
+        "packages/session/session-title/src/index.ts",
+        "packages/workflow/workflow/src/types.ts"
+      ]
+    },
+    {
+      "digest": "6c5d5215ad72616561350f3be63f968e321e75360d9de2a9408994d45d3be76f",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "union",
+            "types": [
+              1,
+              2,
+              3
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "default"
+          },
+          {
+            "kind": "literal",
+            "value": "inferred"
+          },
+          {
+            "kind": "literal",
+            "value": "selection"
+          }
+        ]
+      },
+      "names": [
+        "event:permission/preset[0].data.origin"
+      ],
+      "sources": []
+    },
+    {
+      "digest": "7271e4b771406aaf06014c2269edd6cb68055bb8b8686571730813ce0ababc22",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "data",
+                "type": 1,
+                "optional": false
+              },
+              {
+                "name": "ignorable",
+                "type": 7,
+                "optional": true
+              },
+              {
+                "name": "seq",
+                "type": 8,
+                "optional": false
+              },
+              {
+                "name": "time",
+                "type": 8,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 9,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "origin",
+                "type": 2,
+                "optional": true
+              },
+              {
+                "name": "preset",
+                "type": 6,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "union",
+            "types": [
+              3,
+              4,
+              5
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "default"
+          },
+          {
+            "kind": "literal",
+            "value": "inferred"
+          },
+          {
+            "kind": "literal",
+            "value": "selection"
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          },
+          {
+            "kind": "literal",
+            "value": true
+          },
+          {
+            "kind": "primitive",
+            "type": "number"
+          },
+          {
+            "kind": "literal",
+            "value": "permission/preset"
+          }
+        ]
+      },
+      "names": [
+        "event:permission/preset",
+        "event:permission/preset[0]"
+      ],
+      "sources": [
+        "packages/core/session/src/types.ts"
+      ]
+    },
+    {
+      "digest": "78d7455eb6b3c8da4d70c104eadd69d4a60df1c449e855517a60673b889e03fa",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "literal",
+            "value": "selection"
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "ae63d9d1080ed8945031594d93f8d96651d7101b848719cc3e1475875cd3d649",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "literal",
+            "value": "permission/preset"
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "d66ba5eb62ddba9fc264067c47d1152ca3bd8c2bdf2ededb66695e04ab588550",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "literal",
+            "value": "default"
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "dacf3d5f3e4ff619c1320e64a48dec5e7ecd7870bece65fbd449a0e63adfa521",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "literal",
+            "value": true
+          }
+        ]
+      },
+      "names": [],
+      "sources": []
+    },
+    {
+      "digest": "ebaac53bc4e8eb2ef8870c1ac58976a8a54987e3e412126b9f617f42bcd49829",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "origin",
+                "type": 1,
+                "optional": true
+              },
+              {
+                "name": "preset",
+                "type": 5,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "union",
+            "types": [
+              2,
+              3,
+              4
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "default"
+          },
+          {
+            "kind": "literal",
+            "value": "inferred"
+          },
+          {
+            "kind": "literal",
+            "value": "selection"
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          }
+        ]
+      },
+      "names": [
+        "event:permission/preset[0].data"
+      ],
+      "sources": [
+        "packages/interaction/permission-presets/src/index.ts"
+      ]
+    }
+  ]
+}

package/references/official-docs/docs/persistence-changes/releases/dsh-v0.1.1-rc.1.zh.md

@@ -0,0 +1,82 @@
+---
+description: "回溯 dsh-v0.1.1-rc.1 的已声明 Session 持久化类型及相邻版本变化。"
+kind: persistence-release
+---
+
+# 持久化版本回溯: dsh-v0.1.1-rc.1
+
+[English](dsh-v0.1.1-rc.1.md) | 中文
+
+## 概述
+
+permission/preset 新增可选字段 origin，可取 default、selection 或 inferred。写入格式仍为 0。
+
+## 目录
+
+- [发行来源](#evidence)
+- [声明](#declaration)
+- [结构变化](#changes)
+- [校验](#verification)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="evidence"></a>
+## 发行来源
+
+这是供阅读和格式校验的近似回填，不是当时的兼容性确认。提取方法和覆盖限制见[归档说明](README.zh.md)。
+
+| 项目 | 记录值 |
+|---|---|
+| 源码 tag | `dsh-v0.1.1-rc.1` |
+| 源码日期 | 2026-08-21T06:21:44.000Z |
+| 发行记录 | 有 release 对象。 |
+| 前一版本 | [dsh-v0.1.0-rc.8](dsh-v0.1.0-rc.8.zh.md) |
+| Session 写入版本 | 0 |
+| 完整重建清单 | <!-- persistence-release-inventory:start -->51 个根类型 / 407 种类型<!-- persistence-release-inventory:end --> |
+| 本条快照 | [dsh-v0.1.1-rc.1.schema.json](dsh-v0.1.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.1.1-rc.1
+previous: dsh-v0.1.0-rc.8
+sessionFormatVersion: 0
+changes:
+  - root: event:permission/preset
+    before: 5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b
+    after: 7271e4b771406aaf06014c2269edd6cb68055bb8b8686571730813ce0ababc22
+```
+
+<a id="changes"></a>
+## 结构变化
+
+<!-- persistence-release-changes:start -->
+
+检测到 1 个根类型变化、1 项结构差异。下表的最低要求按当前规则计算，只用于比较；不表示旧版本曾遵守这些规则，也不证明迁移或运行时兼容性。
+
+| 路径 | 变化 | 当前最低要求 |
+|---|---|---|
+| `event:permission/preset.data.origin` | `optional-property-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>
+## 开发备注
+
+无。