dsh-plugin-guide 0.3.42 → 0.4.0

package/references/official-docs/docs/persistence-changes/2026-09-21-user-question-reply.zh.md

@@ -1,60 +0,0 @@
----
-description: "记录持久化类型更改及其兼容性确认。"
-kind: persistence-change
----
-
-# 2026-09-21-user-question-reply
-
-[English](2026-09-21-user-question-reply.md) | 中文
-
-## 概述
-
-新增受限定的 user-question-reply 消息来源，将已继续的 ask_user_question 调用的迟到回答送入 agent inbox。
-
-## 目录
-
-- [声明](#declaration)
-- [兼容性](#compatibility)
-- [验证](#verification)
-- [开发备注](#dev-note)
-
-<a id="declaration"></a>
-## 声明
-
-```yaml persistence-change
-schemaVersion: 1
-id: 2026-09-21-user-question-reply
-baseline: false
-changes:
-  - root: "event:agent/inbox/spliced"
-    previous: "2026-09-16-session-format-v4"
-    after: "6178f1edcb23f361f2a6cb2c859b1c2187220d5695ece4a3400e0d92845a7178"
-    decision: same-version
-  - root: "event:developer/message"
-    previous: "2026-09-16-session-format-v4"
-    after: "186159f5f6f67a0b8cd095b8fe55bef42d4f25ca1a1c248f859867af2ece0467"
-    decision: same-version
-  - root: "event:session/title-llm-request"
-    previous: "2026-09-16-session-format-v4"
-    after: "ae84c5e493f94acc63cfb70389073ba616ed7ae7aa4fadde048bdcc64d49bb46"
-    decision: same-version
-  - root: "event:user/message"
-    previous: "2026-09-16-session-format-v4"
-    after: "b83ed1b1cfffbd7bd5cca06ea72e44be57beb68b39e5a96660ce42a9e21aa411"
-    decision: same-version
-```
-
-<a id="compatibility"></a>
-## 兼容性
-
-已有日志不含该来源，仍然有效。新来源是普通用户消息上的受限定归属；没有 dsh-user-questions 的读取方保留消息，并从内容推导历史。只有 userQuestions projection 读取该来源，关闭指定的问题并记录答案。answer RPC 是唯一生产方，只写入 outcome answered；关闭 Client 面板不会持久化回复。不新增事件类型，也不改变 Session header。
-
-<a id="verification"></a>
-## 验证
-
-pnpm exec vitest run packages/interaction/user-questions/tests packages/interaction/tool-ask-user/tests：81 个测试通过。projection、reply、view 和 process-group 的定向测试共 70 个通过。pnpm run typecheck 通过。pnpm run doc-sync 的 42 项检查全部通过，包括持久化历史和翻译配对。
-
-<a id="dev-note"></a>
-## 开发备注
-
-无。

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.i18n.yaml

@@ -1,28 +0,0 @@
-# Bilingual-pair consistency record for 2026-09-30-job-session-lifecycle.md (docs/i18n/README.md): per heading
-# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
-# After editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write docs/persistence-changes/2026-09-30-job-session-lifecycle.md
-/:
-  en: 3d5a424ae7d7e46b
-  zh: c22a8e4a62d8cc1a
-/2026-09-30-job-session-lifecycle:
-  en: 9be8dc8cb5ce646a
-  zh: 6ce0040813c36e92
-/2026-09-30-job-session-lifecycle/summary:
-  en: 7d98020db3395e2e
-  zh: abe692ef42327e49
-/2026-09-30-job-session-lifecycle/table-of-contents:
-  en: 6cf314a069ceb451
-  zh: 9adff678e9ecab3b
-/2026-09-30-job-session-lifecycle/declaration:
-  en: 6907136f28e48c90
-  zh: 02f8298485f3d8e7
-/2026-09-30-job-session-lifecycle/compatibility:
-  en: 546fe003ad5293b6
-  zh: 86d78c9704a03718
-/2026-09-30-job-session-lifecycle/verification:
-  en: e9660a31a43378fc
-  zh: e97fbe31ff47ea2e
-/2026-09-30-job-session-lifecycle/dev-note:
-  en: b75c8458928b72b9
-  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.md

@@ -1,52 +0,0 @@
----
-description: "Records a persistence type transition and its compatibility acknowledgement."
-kind: persistence-change
----
-
-# 2026-09-30-job-session-lifecycle
-
-English | [中文](2026-09-30-job-session-lifecycle.zh.md)
-
-## Summary
-
-Records owned job registration and settlement with one unique JobId, original timestamps, creating tool calls, and producer completion reports.
-
-## Table of Contents
-
-- [Declaration](#declaration)
-- [Compatibility](#compatibility)
-- [Verification](#verification)
-- [Dev Note](#dev-note)
-
-<a id="declaration"></a>
-## Declaration
-
-```yaml persistence-change
-schemaVersion: 1
-id: 2026-09-30-job-session-lifecycle
-baseline: false
-changes:
-  - root: "event:job/registered"
-    previous: null
-    after: "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1"
-    decision: same-version
-  - root: "event:job/settled"
-    previous: null
-    after: "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf"
-    decision: same-version
-```
-
-<a id="compatibility"></a>
-## Compatibility
-
-Adds required job event kinds without changing the Session envelope. New JobIds use a kind-prefixed UUID for both live controls and durable pairing; historical sessions receive no fabricated job history. Older builds reject unknown required events. producerReported describes completion-promise fulfillment, not verified resource release.
-
-<a id="verification"></a>
-## Verification
-
-Registry and snapshot-normalizer tests cover causal order and unique JobIds. CLI and SDK snapshots verify registration, settlement, and notices during execution; the [job lifecycle contract](../subsystems/jobs.md#session-lifecycle-records) allows incomplete terminal history during application teardown.
-
-<a id="dev-note"></a>
-## Dev Note
-
-None.

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.schema.json

@@ -1,297 +0,0 @@
-{
-  "formatVersion": 2,
-  "roots": [
-    {
-      "key": "event:job/registered",
-      "kind": "event",
-      "event": "job/registered",
-      "surface": false,
-      "digest": "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1",
-      "schema": {
-        "root": 0,
-        "nodes": [
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "data",
-                "type": 1,
-                "optional": false
-              },
-              {
-                "name": "ignorable",
-                "type": 5,
-                "optional": true
-              },
-              {
-                "name": "seq",
-                "type": 3,
-                "optional": false
-              },
-              {
-                "name": "time",
-                "type": 3,
-                "optional": false
-              },
-              {
-                "name": "type",
-                "type": 6,
-                "optional": false
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "jobId",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "kind",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "label",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "owner",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "startedAt",
-                "type": 3,
-                "optional": false
-              },
-              {
-                "name": "toolCall",
-                "type": 4,
-                "optional": true
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "primitive",
-            "type": "string"
-          },
-          {
-            "kind": "primitive",
-            "type": "number"
-          },
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "callId",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "rootCallId",
-                "type": 2,
-                "optional": false
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "literal",
-            "value": true
-          },
-          {
-            "kind": "literal",
-            "value": "job/registered"
-          }
-        ]
-      }
-    },
-    {
-      "key": "event:job/settled",
-      "kind": "event",
-      "event": "job/settled",
-      "surface": false,
-      "digest": "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf",
-      "schema": {
-        "root": 0,
-        "nodes": [
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "data",
-                "type": 1,
-                "optional": false
-              },
-              {
-                "name": "ignorable",
-                "type": 14,
-                "optional": true
-              },
-              {
-                "name": "seq",
-                "type": 7,
-                "optional": false
-              },
-              {
-                "name": "time",
-                "type": 7,
-                "optional": false
-              },
-              {
-                "name": "type",
-                "type": 15,
-                "optional": false
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "cause",
-                "type": 2,
-                "optional": false
-              },
-              {
-                "name": "detail",
-                "type": 6,
-                "optional": true
-              },
-              {
-                "name": "finishedAt",
-                "type": 7,
-                "optional": false
-              },
-              {
-                "name": "jobId",
-                "type": 6,
-                "optional": false
-              },
-              {
-                "name": "kind",
-                "type": 6,
-                "optional": false
-              },
-              {
-                "name": "label",
-                "type": 6,
-                "optional": false
-              },
-              {
-                "name": "owner",
-                "type": 6,
-                "optional": false
-              },
-              {
-                "name": "producerReported",
-                "type": 8,
-                "optional": false
-              },
-              {
-                "name": "startedAt",
-                "type": 7,
-                "optional": false
-              },
-              {
-                "name": "status",
-                "type": 9,
-                "optional": false
-              },
-              {
-                "name": "toolCall",
-                "type": 13,
-                "optional": true
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "union",
-            "types": [
-              3,
-              4,
-              5
-            ]
-          },
-          {
-            "kind": "literal",
-            "value": "producer"
-          },
-          {
-            "kind": "literal",
-            "value": "teardown"
-          },
-          {
-            "kind": "literal",
-            "value": "kill"
-          },
-          {
-            "kind": "primitive",
-            "type": "string"
-          },
-          {
-            "kind": "primitive",
-            "type": "number"
-          },
-          {
-            "kind": "primitive",
-            "type": "boolean"
-          },
-          {
-            "kind": "union",
-            "types": [
-              10,
-              11,
-              12
-            ]
-          },
-          {
-            "kind": "literal",
-            "value": "completed"
-          },
-          {
-            "kind": "literal",
-            "value": "failed"
-          },
-          {
-            "kind": "literal",
-            "value": "killed"
-          },
-          {
-            "kind": "object",
-            "properties": [
-              {
-                "name": "callId",
-                "type": 6,
-                "optional": false
-              },
-              {
-                "name": "rootCallId",
-                "type": 6,
-                "optional": false
-              }
-            ],
-            "indices": []
-          },
-          {
-            "kind": "literal",
-            "value": true
-          },
-          {
-            "kind": "literal",
-            "value": "job/settled"
-          }
-        ]
-      }
-    }
-  ],
-  "types": []
-}

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.zh.md

@@ -1,52 +0,0 @@
----
-description: "记录持久化类型更改及其兼容性确认。"
-kind: persistence-change
----
-
-# 2026-09-30-job-session-lifecycle
-
-[English](2026-09-30-job-session-lifecycle.md) | 中文
-
-## 概述
-
-以唯一 JobId 将有所有者 job 的注册与结算记录为 Session 事件，包含原始时间戳、创建工具调用和生产方完成报告。
-
-## 目录
-
-- [声明](#declaration)
-- [兼容性](#compatibility)
-- [验证](#verification)
-- [开发备注](#dev-note)
-
-<a id="declaration"></a>
-## 声明
-
-```yaml persistence-change
-schemaVersion: 1
-id: 2026-09-30-job-session-lifecycle
-baseline: false
-changes:
-  - root: "event:job/registered"
-    previous: null
-    after: "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1"
-    decision: same-version
-  - root: "event:job/settled"
-    previous: null
-    after: "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf"
-    decision: same-version
-```
-
-<a id="compatibility"></a>
-## 兼容性
-
-增加必需的 job 事件类型，不改变 Session 封装。新 JobId 用带 kind 前缀的 UUID 同时进行运行期控制与持久化配对；不为历史会话补造 job 事件。旧构建拒绝未知的必需事件。producerReported 表示完成 promise 兑现，不确认资源已释放。
-
-<a id="verification"></a>
-## 验证
-
-注册表和快照归一化测试覆盖因果顺序与唯一 JobId。CLI 和 SDK 快照验证运行中的注册、结算和通知；[job 生命周期约定](../subsystems/jobs.zh.md#session-lifecycle-records)允许应用销毁时留下不完整的终态历史。
-
-<a id="dev-note"></a>
-## 开发备注
-
-无。

package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.i18n.yaml

@@ -1,28 +0,0 @@
-# Bilingual-pair consistency record for 2026-10-05-ptc-operation-metadata.md (docs/i18n/README.md): per heading
-# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
-# After editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write docs/persistence-changes/2026-10-05-ptc-operation-metadata.md
-/:
-  en: 3d5a424ae7d7e46b
-  zh: c22a8e4a62d8cc1a
-/2026-10-05-ptc-operation-metadata:
-  en: 1dead83b6553cd1a
-  zh: 9b6177c2b132640f
-/2026-10-05-ptc-operation-metadata/summary:
-  en: 515119ce4f93c34d
-  zh: 36f42e64c69945cf
-/2026-10-05-ptc-operation-metadata/table-of-contents:
-  en: 6cf314a069ceb451
-  zh: 9adff678e9ecab3b
-/2026-10-05-ptc-operation-metadata/declaration:
-  en: 6907136f28e48c90
-  zh: 02f8298485f3d8e7
-/2026-10-05-ptc-operation-metadata/compatibility:
-  en: e9737c6c28ee0ab0
-  zh: 468a046ccd51d95b
-/2026-10-05-ptc-operation-metadata/verification:
-  en: a6d2fb4553a4f895
-  zh: bb2367ad270ee0bc
-/2026-10-05-ptc-operation-metadata/dev-note:
-  en: b75c8458928b72b9
-  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-10-05-ptc-operation-metadata.md

@@ -1,48 +0,0 @@
----
-description: "Records a persistence type transition and its compatibility acknowledgement."
-kind: persistence-change
----
-
-# 2026-10-05-ptc-operation-metadata
-
-English | [中文](2026-10-05-ptc-operation-metadata.zh.md)
-
-## Summary
-
-Adds optional pure presentation metadata to persisted nested PTC tool results so history retains operation-time directories and file targets.
-
-## Table of Contents
-
-- [Declaration](#declaration)
-- [Compatibility](#compatibility)
-- [Verification](#verification)
-- [Dev Note](#dev-note)
-
-<a id="declaration"></a>
-## Declaration
-
-```yaml persistence-change
-schemaVersion: 1
-id: 2026-10-05-ptc-operation-metadata
-baseline: false
-changes:
-  - root: "event:tool/ptc-dispatch"
-    previous: "2026-09-16-session-format-v4"
-    after: "d66e11dddf5dfa3c71547e2cbd7b0608824cd8d6243fc16f532017ff28e8fba5"
-    decision: same-version
-```
-
-<a id="compatibility"></a>
-## Compatibility
-
-Existing tool/ptc-dispatch records without meta remain valid. The optional JsonValue field does not change canonical program values, model-visible content, tool identities or message ordering. Historical calls without a recorded relative target keep safe unavailable navigation. The writer and accepted baseline stay at V4.
-
-<a id="verification"></a>
-## Verification
-
-963 focused tests passed with per-file 100% coverage of the six affected runtime/UI sources; actual nested shell and relative filesystem regressions, frozen metadata controls, TypeScript SDK 45 tests, Python SDK 29 tests and three owning keyless refresh/replays passed.
-
-<a id="dev-note"></a>
-## Dev Note
-
-None.