dsh-plugin-dev-kb 1.3.0 → 1.5.1

package/kb/extra/persistence-changes/2026-09-11-initial.md

@@ -0,0 +1,280 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# Initial persistence type baseline
+
+English | [中文](2026-09-11-initial.zh.md)
+
+## Summary
+
+This baseline records the complete persistence type inventory declared by the current source and gives later transitions a starting point stored in this tree.
+
+## 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-11-initial
+baseline: true
+changes:
+  - root: "JsonlHeaderLine"
+    previous: null
+    after: "18ee62b8900a4c3d046700f05d7a4d49d6cab2a660a020c87481d1603dd8bd4f"
+    decision: same-version
+  - root: "SessionEventEnvelope"
+    previous: null
+    after: "5776e5553ff2dfe3f5bc202dbb1e7c9f93e35a531aebb7764c23b2b6153b2ccc"
+    decision: same-version
+  - root: "SessionHeader"
+    previous: null
+    after: "2a8b114637e66faab5fae1c6e2fba65320db6224c80f5f36c5bf32f937154d03"
+    decision: same-version
+  - root: "event:agent-preset/selected"
+    previous: null
+    after: "a10c17474eaf2ddab7095a099e0fe3d046fc18e56c3e344fc8894c05ff9ef97b"
+    decision: same-version
+  - root: "event:agent/inbox/spliced"
+    previous: null
+    after: "f757322e25914d63799c6235af4ed4b4f36d7d083fef40d6873a45e94fe6ad65"
+    decision: same-version
+  - root: "event:approval/asked"
+    previous: null
+    after: "3bfeb47b58606f4661904bc723da612782214c463d01e6d61cd6d6193d7374e1"
+    decision: same-version
+  - root: "event:approval/decided"
+    previous: null
+    after: "bb1ab3d08f49a9f3b265f844cd78d5c49813062a7b34b54904b426f85d0ff6e3"
+    decision: same-version
+  - root: "event:approval/policy"
+    previous: null
+    after: "26718e15e7e395bce9642dba5bbe09b3b1a4ce2213d20d566cd9207d7fc5fb78"
+    decision: same-version
+  - root: "event:assistant/attempt"
+    previous: null
+    after: "3516f54b427775f483febe8e938e4e10f9afd3583610861547bbe2999ed4d8d9"
+    decision: same-version
+  - root: "event:assistant/message"
+    previous: null
+    after: "a58ca1bed502d425a8b65cac02f59717498cd296de9513c6f81b83b791c20e9b"
+    decision: same-version
+  - root: "event:command/done"
+    previous: null
+    after: "15196447222782e773eb943c92b18316ce96b9af0f0cfddb6e57ba8274ecc5ff"
+    decision: same-version
+  - root: "event:command/run"
+    previous: null
+    after: "37184378c6439257d105c4e2022d80fc9c3a3f7c7f6ac661b00bc9f18d871006"
+    decision: same-version
+  - root: "event:compaction/end"
+    previous: null
+    after: "b0127044ab31a702bddfd785d345f5abd7a70876746e895ce443afa3e60ddf2d"
+    decision: same-version
+  - root: "event:compaction/prune"
+    previous: null
+    after: "7f7fd5a6b0064f597534b29ff62ef26e786dffccf5e14f654a7d4fcea2c35f04"
+    decision: same-version
+  - root: "event:compaction/start"
+    previous: null
+    after: "db874d463b0fdec77e9da1c4568f37cb70bd6596781eb93800db44fb8a116965"
+    decision: same-version
+  - root: "event:compaction/summary"
+    previous: null
+    after: "eb1d32dcd3d76833392f351e039dcbd40686a1ab24b252a7a5003426f9cf4c89"
+    decision: same-version
+  - root: "event:deliverables/presented"
+    previous: null
+    after: "13d3d180f977bf78081d487ffa0ecb75857349bcab29a5a3fb48189fca2a6176"
+    decision: same-version
+  - root: "event:feedback/message-delete"
+    previous: null
+    after: "3ee93b06f3a125850337602bcdf155d2538c43a5c944ec55b1b3c365152d6796"
+    decision: same-version
+  - root: "event:feedback/message-put"
+    previous: null
+    after: "b5086d249e8502e9ead1d39156bb8d559bde7951cac0f14ce150345b4e42a2bf"
+    decision: same-version
+  - root: "event:feedback/record"
+    previous: null
+    after: "b54940ff095c17e874c5be03815f4c2145a256cf3a1d34dae4ab2f7769dfffe8"
+    decision: same-version
+  - root: "event:goal/change"
+    previous: null
+    after: "763c8a20af487263a0080548274f7437ef4a86e0ba8769127d1ced10a72c664d"
+    decision: same-version
+  - root: "event:hook/invoked"
+    previous: null
+    after: "8a6e1ec9e8db346b0e02f027db73c07a94f067a26d40c1aef1abd09c47ce7ba0"
+    decision: same-version
+  - root: "event:hook/result"
+    previous: null
+    after: "e75916628f3f10c2d50658bd143052a46285fbf1a9a700ba54947614603d26b4"
+    decision: same-version
+  - root: "event:llm/retry"
+    previous: null
+    after: "91c397f8f870e812e1dc5ac69c2745f9f105be9dc97dadc980d19ef415a65145"
+    decision: same-version
+  - root: "event:llm/retry-started"
+    previous: null
+    after: "48e5c9861f16ac07e78cb7b5ae9dabdf7bb85c58baed5a51b4ad275050ea58e3"
+    decision: same-version
+  - root: "event:model/selection"
+    previous: null
+    after: "35203ba7ad5ef6f97d556b85df20ae98f04f09c65748cecdf8eefdb8b6405ffc"
+    decision: same-version
+  - root: "event:permission/preset"
+    previous: null
+    after: "5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b"
+    decision: same-version
+  - root: "event:plan/mode"
+    previous: null
+    after: "a7cf43ce7c2a4c038feed1885cd7a00d5c6ee2d90a7e0d56b46f78a3e1ca327f"
+    decision: same-version
+  - root: "event:request/context"
+    previous: null
+    after: "37cbc9cf06d494cfe5c67f078af1605eacb8e4c2c853e9e26455b73de0ee7ccf"
+    decision: same-version
+  - root: "event:request/header"
+    previous: null
+    after: "8ea13bcd983eab596dbfd41c5c2b62a0b318b71cd2a987a6fd752c6ced7e4489"
+    decision: same-version
+  - root: "event:sandbox/mode"
+    previous: null
+    after: "516da4cdd6d2f1e5ce488e648578ca51f40e458f707b803e5b24de870e799415"
+    decision: same-version
+  - root: "event:schedule/change"
+    previous: null
+    after: "2a7f86849ae54b3398ee49661a757c4fcb59a6192b7036ee2ff514617e13fb42"
+    decision: same-version
+  - root: "event:session-log-deepseek/delivery-accepted"
+    previous: null
+    after: "d63b8b8ffad9c02fd80c43a17df4f240c1fe8118ecca9de34f9d5871838ab5b9"
+    decision: same-version
+  - root: "event:session/end-seed"
+    previous: null
+    after: "5e6db6e24948d4a853c71cb9fabd252ad051ce93d4672c1266cf837c1c17b84e"
+    decision: same-version
+  - root: "event:session/title"
+    previous: null
+    after: "1b912703e2d64f91c99c675b8f805b01076c8325b905c1218ad81ef0b24909d5"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: null
+    after: "6091f64d426ada2adc646094a6fe662a1b81d9ee5770929fe76800524e2c89a8"
+    decision: same-version
+  - root: "event:step/end"
+    previous: null
+    after: "e0a787e6ec76c7c94fecbc501b489164ab0293db05bc947914077ad01e674f05"
+    decision: same-version
+  - root: "event:step/start"
+    previous: null
+    after: "4513e088d43e6c68425be30451b9f961cc264fe7318ca62681c41d4d78615986"
+    decision: same-version
+  - root: "event:subagent/catalog"
+    previous: null
+    after: "ae1f7110feeec697b8cab42b68f7709aa7b3279764099dfb53c25890d2e5c871"
+    decision: same-version
+  - root: "event:subagent/descriptor"
+    previous: null
+    after: "b79ada42962cad0190a9d465805260567621fa3a4abd757eb31e6016b52d5ab5"
+    decision: same-version
+  - root: "event:subagent/model-selection-policy"
+    previous: null
+    after: "a6567ccb2e530606b775371eb4fa31468d72084339968e8b0440a516a23b39dc"
+    decision: same-version
+  - root: "event:system/message"
+    previous: null
+    after: "0ae7ccdc1cc5d9d43772ebd5c7357ff509011c3a6ba188d9c274d33df2542c42"
+    decision: same-version
+  - root: "event:team/member"
+    previous: null
+    after: "4fb59762612c3e3ac3a3bd4f84c9c148d3c3893bd422ba2b201cc039fabd49bc"
+    decision: same-version
+  - root: "event:team/message/delivered"
+    previous: null
+    after: "48f9c19417a1abbedfa59f4667bba36b93ac2db407adf5e84cb3ba0de30942cb"
+    decision: same-version
+  - root: "event:team/message/queued"
+    previous: null
+    after: "2ffcad547cb840f462eb1849fa5f6cb0e17eb93f5d07cc88b61d749b1b78d632"
+    decision: same-version
+  - root: "event:team/task"
+    previous: null
+    after: "d595ec73b32b016a6055333c67a5d646032b22e672da1d4a09c5b1ae398a093a"
+    decision: same-version
+  - root: "event:todo/write"
+    previous: null
+    after: "b978cff734e62143eb56c9125423ec275405eda969802d42aaf73ecb987d3b26"
+    decision: same-version
+  - root: "event:tool-workflow/agent-end"
+    previous: null
+    after: "babf9ee4d1af62bf6c3a8103737f7a5e4e78ce179be835ce05a38803e15884b7"
+    decision: same-version
+  - root: "event:tool-workflow/agent-start"
+    previous: null
+    after: "5f26a6c20b37632f8f57729d171c671def4683d994ac6257a8dffcd855101627"
+    decision: same-version
+  - root: "event:tool-workflow/run-end"
+    previous: null
+    after: "42e0916e0dda5f6d1e7bb05d8514717147c036a79c9f36085683469516c1fd3f"
+    decision: same-version
+  - root: "event:tool-workflow/run-start"
+    previous: null
+    after: "c1f9e0405de6d18cabb9ee70782a027f9bbdc57e5abec9dcccdd56119e2e9058"
+    decision: same-version
+  - root: "event:tool/call"
+    previous: null
+    after: "3b1be838223869fe0a08210db85bf773796ed3f2373ac16555dff227cade0c48"
+    decision: same-version
+  - root: "event:tool/ptc-dispatch"
+    previous: null
+    after: "da807583a19f4ebe2bc9115c9686016e1521e405bdfaced296ae652b91e8e5f6"
+    decision: same-version
+  - root: "event:tool/ptc-dispatch-start"
+    previous: null
+    after: "ec38b5949af8eacaf00df002f4acbe344f934f8a061e9cdc65a52a48e5f6dd93"
+    decision: same-version
+  - root: "event:tool/result"
+    previous: null
+    after: "cc3e270ab982cbafff602b753647b6f056decb7fe4fd523afd2f157a65c3d622"
+    decision: same-version
+  - root: "event:turn/end"
+    previous: null
+    after: "84c24f1209fc3e0153de6ac85d58fd6968b851f955e0e761b92321053956609e"
+    decision: same-version
+  - root: "event:turn/start"
+    previous: null
+    after: "aa0957eca50aeb28bcd2e6930b95809926edacb550c8c340ba526ba6b861b3d8"
+    decision: same-version
+  - root: "event:user/message"
+    previous: null
+    after: "2e49ede7fb3a592cce8919ebe982f6ca1c1f67abe4def359ffc028c85e6d1ad8"
+    decision: same-version
+  - root: "event:web/deepseek-search-llm-request"
+    previous: null
+    after: "cf6e3aaf1e2de6480aa0157730a41b9a492108a55304100b0f7e112711dd4331"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+This record initializes type history without asserting relationships to earlier formats or changing the Session writer version or runtime behavior. Each root starts without a predecessor and retains its complete normalized schema; successor records reference its after schema.
+
+<a id="verification"></a>
+## Verification
+
+Ran `pnpm exec tsx scripts/gen-persistence-catalog.ts` to generate the current inventory and `pnpm run persistence-changes --baseline 2026-09-11-initial` to create this baseline and its schema snapshot.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.

package/kb/extra/persistence-changes/2026-09-11-initial.zh.md

@@ -0,0 +1,280 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 初始持久化类型基线
+
+[English](2026-09-11-initial.md) | 中文
+
+## 概述
+
+此基线记录当前源码声明的完整持久化类型目录，为后续类型转换提供保存在本源码树内的起点。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-09-11-initial
+baseline: true
+changes:
+  - root: "JsonlHeaderLine"
+    previous: null
+    after: "18ee62b8900a4c3d046700f05d7a4d49d6cab2a660a020c87481d1603dd8bd4f"
+    decision: same-version
+  - root: "SessionEventEnvelope"
+    previous: null
+    after: "5776e5553ff2dfe3f5bc202dbb1e7c9f93e35a531aebb7764c23b2b6153b2ccc"
+    decision: same-version
+  - root: "SessionHeader"
+    previous: null
+    after: "2a8b114637e66faab5fae1c6e2fba65320db6224c80f5f36c5bf32f937154d03"
+    decision: same-version
+  - root: "event:agent-preset/selected"
+    previous: null
+    after: "a10c17474eaf2ddab7095a099e0fe3d046fc18e56c3e344fc8894c05ff9ef97b"
+    decision: same-version
+  - root: "event:agent/inbox/spliced"
+    previous: null
+    after: "f757322e25914d63799c6235af4ed4b4f36d7d083fef40d6873a45e94fe6ad65"
+    decision: same-version
+  - root: "event:approval/asked"
+    previous: null
+    after: "3bfeb47b58606f4661904bc723da612782214c463d01e6d61cd6d6193d7374e1"
+    decision: same-version
+  - root: "event:approval/decided"
+    previous: null
+    after: "bb1ab3d08f49a9f3b265f844cd78d5c49813062a7b34b54904b426f85d0ff6e3"
+    decision: same-version
+  - root: "event:approval/policy"
+    previous: null
+    after: "26718e15e7e395bce9642dba5bbe09b3b1a4ce2213d20d566cd9207d7fc5fb78"
+    decision: same-version
+  - root: "event:assistant/attempt"
+    previous: null
+    after: "3516f54b427775f483febe8e938e4e10f9afd3583610861547bbe2999ed4d8d9"
+    decision: same-version
+  - root: "event:assistant/message"
+    previous: null
+    after: "a58ca1bed502d425a8b65cac02f59717498cd296de9513c6f81b83b791c20e9b"
+    decision: same-version
+  - root: "event:command/done"
+    previous: null
+    after: "15196447222782e773eb943c92b18316ce96b9af0f0cfddb6e57ba8274ecc5ff"
+    decision: same-version
+  - root: "event:command/run"
+    previous: null
+    after: "37184378c6439257d105c4e2022d80fc9c3a3f7c7f6ac661b00bc9f18d871006"
+    decision: same-version
+  - root: "event:compaction/end"
+    previous: null
+    after: "b0127044ab31a702bddfd785d345f5abd7a70876746e895ce443afa3e60ddf2d"
+    decision: same-version
+  - root: "event:compaction/prune"
+    previous: null
+    after: "7f7fd5a6b0064f597534b29ff62ef26e786dffccf5e14f654a7d4fcea2c35f04"
+    decision: same-version
+  - root: "event:compaction/start"
+    previous: null
+    after: "db874d463b0fdec77e9da1c4568f37cb70bd6596781eb93800db44fb8a116965"
+    decision: same-version
+  - root: "event:compaction/summary"
+    previous: null
+    after: "eb1d32dcd3d76833392f351e039dcbd40686a1ab24b252a7a5003426f9cf4c89"
+    decision: same-version
+  - root: "event:deliverables/presented"
+    previous: null
+    after: "13d3d180f977bf78081d487ffa0ecb75857349bcab29a5a3fb48189fca2a6176"
+    decision: same-version
+  - root: "event:feedback/message-delete"
+    previous: null
+    after: "3ee93b06f3a125850337602bcdf155d2538c43a5c944ec55b1b3c365152d6796"
+    decision: same-version
+  - root: "event:feedback/message-put"
+    previous: null
+    after: "b5086d249e8502e9ead1d39156bb8d559bde7951cac0f14ce150345b4e42a2bf"
+    decision: same-version
+  - root: "event:feedback/record"
+    previous: null
+    after: "b54940ff095c17e874c5be03815f4c2145a256cf3a1d34dae4ab2f7769dfffe8"
+    decision: same-version
+  - root: "event:goal/change"
+    previous: null
+    after: "763c8a20af487263a0080548274f7437ef4a86e0ba8769127d1ced10a72c664d"
+    decision: same-version
+  - root: "event:hook/invoked"
+    previous: null
+    after: "8a6e1ec9e8db346b0e02f027db73c07a94f067a26d40c1aef1abd09c47ce7ba0"
+    decision: same-version
+  - root: "event:hook/result"
+    previous: null
+    after: "e75916628f3f10c2d50658bd143052a46285fbf1a9a700ba54947614603d26b4"
+    decision: same-version
+  - root: "event:llm/retry"
+    previous: null
+    after: "91c397f8f870e812e1dc5ac69c2745f9f105be9dc97dadc980d19ef415a65145"
+    decision: same-version
+  - root: "event:llm/retry-started"
+    previous: null
+    after: "48e5c9861f16ac07e78cb7b5ae9dabdf7bb85c58baed5a51b4ad275050ea58e3"
+    decision: same-version
+  - root: "event:model/selection"
+    previous: null
+    after: "35203ba7ad5ef6f97d556b85df20ae98f04f09c65748cecdf8eefdb8b6405ffc"
+    decision: same-version
+  - root: "event:permission/preset"
+    previous: null
+    after: "5c45bf4c544a7211dcd8ba6ba7e5f1bc39b49e7a9df9d5cbdc8e87c22771b37b"
+    decision: same-version
+  - root: "event:plan/mode"
+    previous: null
+    after: "a7cf43ce7c2a4c038feed1885cd7a00d5c6ee2d90a7e0d56b46f78a3e1ca327f"
+    decision: same-version
+  - root: "event:request/context"
+    previous: null
+    after: "37cbc9cf06d494cfe5c67f078af1605eacb8e4c2c853e9e26455b73de0ee7ccf"
+    decision: same-version
+  - root: "event:request/header"
+    previous: null
+    after: "8ea13bcd983eab596dbfd41c5c2b62a0b318b71cd2a987a6fd752c6ced7e4489"
+    decision: same-version
+  - root: "event:sandbox/mode"
+    previous: null
+    after: "516da4cdd6d2f1e5ce488e648578ca51f40e458f707b803e5b24de870e799415"
+    decision: same-version
+  - root: "event:schedule/change"
+    previous: null
+    after: "2a7f86849ae54b3398ee49661a757c4fcb59a6192b7036ee2ff514617e13fb42"
+    decision: same-version
+  - root: "event:session-log-deepseek/delivery-accepted"
+    previous: null
+    after: "d63b8b8ffad9c02fd80c43a17df4f240c1fe8118ecca9de34f9d5871838ab5b9"
+    decision: same-version
+  - root: "event:session/end-seed"
+    previous: null
+    after: "5e6db6e24948d4a853c71cb9fabd252ad051ce93d4672c1266cf837c1c17b84e"
+    decision: same-version
+  - root: "event:session/title"
+    previous: null
+    after: "1b912703e2d64f91c99c675b8f805b01076c8325b905c1218ad81ef0b24909d5"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: null
+    after: "6091f64d426ada2adc646094a6fe662a1b81d9ee5770929fe76800524e2c89a8"
+    decision: same-version
+  - root: "event:step/end"
+    previous: null
+    after: "e0a787e6ec76c7c94fecbc501b489164ab0293db05bc947914077ad01e674f05"
+    decision: same-version
+  - root: "event:step/start"
+    previous: null
+    after: "4513e088d43e6c68425be30451b9f961cc264fe7318ca62681c41d4d78615986"
+    decision: same-version
+  - root: "event:subagent/catalog"
+    previous: null
+    after: "ae1f7110feeec697b8cab42b68f7709aa7b3279764099dfb53c25890d2e5c871"
+    decision: same-version
+  - root: "event:subagent/descriptor"
+    previous: null
+    after: "b79ada42962cad0190a9d465805260567621fa3a4abd757eb31e6016b52d5ab5"
+    decision: same-version
+  - root: "event:subagent/model-selection-policy"
+    previous: null
+    after: "a6567ccb2e530606b775371eb4fa31468d72084339968e8b0440a516a23b39dc"
+    decision: same-version
+  - root: "event:system/message"
+    previous: null
+    after: "0ae7ccdc1cc5d9d43772ebd5c7357ff509011c3a6ba188d9c274d33df2542c42"
+    decision: same-version
+  - root: "event:team/member"
+    previous: null
+    after: "4fb59762612c3e3ac3a3bd4f84c9c148d3c3893bd422ba2b201cc039fabd49bc"
+    decision: same-version
+  - root: "event:team/message/delivered"
+    previous: null
+    after: "48f9c19417a1abbedfa59f4667bba36b93ac2db407adf5e84cb3ba0de30942cb"
+    decision: same-version
+  - root: "event:team/message/queued"
+    previous: null
+    after: "2ffcad547cb840f462eb1849fa5f6cb0e17eb93f5d07cc88b61d749b1b78d632"
+    decision: same-version
+  - root: "event:team/task"
+    previous: null
+    after: "d595ec73b32b016a6055333c67a5d646032b22e672da1d4a09c5b1ae398a093a"
+    decision: same-version
+  - root: "event:todo/write"
+    previous: null
+    after: "b978cff734e62143eb56c9125423ec275405eda969802d42aaf73ecb987d3b26"
+    decision: same-version
+  - root: "event:tool-workflow/agent-end"
+    previous: null
+    after: "babf9ee4d1af62bf6c3a8103737f7a5e4e78ce179be835ce05a38803e15884b7"
+    decision: same-version
+  - root: "event:tool-workflow/agent-start"
+    previous: null
+    after: "5f26a6c20b37632f8f57729d171c671def4683d994ac6257a8dffcd855101627"
+    decision: same-version
+  - root: "event:tool-workflow/run-end"
+    previous: null
+    after: "42e0916e0dda5f6d1e7bb05d8514717147c036a79c9f36085683469516c1fd3f"
+    decision: same-version
+  - root: "event:tool-workflow/run-start"
+    previous: null
+    after: "c1f9e0405de6d18cabb9ee70782a027f9bbdc57e5abec9dcccdd56119e2e9058"
+    decision: same-version
+  - root: "event:tool/call"
+    previous: null
+    after: "3b1be838223869fe0a08210db85bf773796ed3f2373ac16555dff227cade0c48"
+    decision: same-version
+  - root: "event:tool/ptc-dispatch"
+    previous: null
+    after: "da807583a19f4ebe2bc9115c9686016e1521e405bdfaced296ae652b91e8e5f6"
+    decision: same-version
+  - root: "event:tool/ptc-dispatch-start"
+    previous: null
+    after: "ec38b5949af8eacaf00df002f4acbe344f934f8a061e9cdc65a52a48e5f6dd93"
+    decision: same-version
+  - root: "event:tool/result"
+    previous: null
+    after: "cc3e270ab982cbafff602b753647b6f056decb7fe4fd523afd2f157a65c3d622"
+    decision: same-version
+  - root: "event:turn/end"
+    previous: null
+    after: "84c24f1209fc3e0153de6ac85d58fd6968b851f955e0e761b92321053956609e"
+    decision: same-version
+  - root: "event:turn/start"
+    previous: null
+    after: "aa0957eca50aeb28bcd2e6930b95809926edacb550c8c340ba526ba6b861b3d8"
+    decision: same-version
+  - root: "event:user/message"
+    previous: null
+    after: "2e49ede7fb3a592cce8919ebe982f6ca1c1f67abe4def359ffc028c85e6d1ad8"
+    decision: same-version
+  - root: "event:web/deepseek-search-llm-request"
+    previous: null
+    after: "cf6e3aaf1e2de6480aa0157730a41b9a492108a55304100b0f7e112711dd4331"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## 兼容性
+
+该记录初始化类型历史，不声明更早版本的类型关系，也不改变 Session writer 版本或运行时行为。每个根类型从空前驱开始，并保留完整的规范化 schema；后续记录引用本记录的 after schema。
+
+<a id="verification"></a>
+## 验证
+
+已运行 `pnpm exec tsx scripts/gen-persistence-catalog.ts` 生成当前目录，并运行 `pnpm run persistence-changes --baseline 2026-09-11-initial` 创建此基线及其 schema 快照。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/kb/extra/persistence-changes/2026-09-12-auto-review-error-metadata.md

@@ -0,0 +1,52 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-09-12-auto-review-error-metadata
+
+English | [中文](2026-09-12-auto-review-error-metadata.zh.md)
+
+## Summary
+
+Adds optional structured error metadata to persisted PTC dispatches and an optional user-facing reason to persisted native tool errors. Both additions retain the Session format version.
+
+## 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-12-auto-review-error-metadata
+baseline: false
+changes:
+  - root: "event:tool/ptc-dispatch"
+    previous: "2026-09-11-initial"
+    after: "b5d66eaebed4da391b13498623b11142222149fbf5e025975dbc6d94f0d06796"
+    decision: same-version
+  - root: "event:tool/result"
+    previous: "2026-09-11-initial"
+    after: "3a803805bdeb805f32b229e399fb7258be8e32a89f89063a7c99957cfea942f7"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+Existing tool/ptc-dispatch events can omit error, and existing tool/result errors can omit reason. PTC dispatch events do not enter model history; native tool-result replay projects data.message and does not include error metadata. Older readers can ignore these additions without changing model replay. Current Web readers accept absent reasons and only display Auto review denial details when the recorded error identity matches. Permission mode remains a string in the existing event; selecting auto introduces no declared persistence-type change. No header, event envelope, or existing value type changes, and no adjacent migration is required.
+
+<a id="verification"></a>
+## Verification
+
+pnpm exec vitest run scripts/persistence-changes.spec.ts scripts/persistence-schema.spec.ts passed 64 tests. Focused permission, Auto review, tool execution, agent-loop, subagent inheritance, and TypeScript SDK owner tests passed 390 tests across 10 files, including native and PTC denial metadata. uv run --python 3.10 --group test --project python/sdk pytest python/sdk/tests/test_client.py -k preserves_auto_review_errors passed 1 test. The persistence preview classified only the two optional additions and required no version bump.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.

package/kb/extra/persistence-changes/2026-09-12-auto-review-error-metadata.zh.md

@@ -0,0 +1,52 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 2026-09-12-auto-review-error-metadata
+
+[English](2026-09-12-auto-review-error-metadata.md) | 中文
+
+## 概述
+
+为持久化的 PTC dispatch 增加可选的结构化错误元数据，并为持久化的原生工具错误增加可选的用户可见理由。两项新增字段均保持 Session 格式版本。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-09-12-auto-review-error-metadata
+baseline: false
+changes:
+  - root: "event:tool/ptc-dispatch"
+    previous: "2026-09-11-initial"
+    after: "b5d66eaebed4da391b13498623b11142222149fbf5e025975dbc6d94f0d06796"
+    decision: same-version
+  - root: "event:tool/result"
+    previous: "2026-09-11-initial"
+    after: "3a803805bdeb805f32b229e399fb7258be8e32a89f89063a7c99957cfea942f7"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## 兼容性
+
+已有 tool/ptc-dispatch 事件可以省略 error，已有 tool/result 错误可以省略 reason。PTC dispatch 事件不进入模型历史；原生工具结果回放只投影 data.message，不包含错误元数据。旧读取方可以忽略新增字段，不改变模型回放。当前 Web 读取方接受缺失的理由，并且只有记录中的错误标识匹配时才显示 Auto review 拒绝详情。权限模式在已有事件中仍为字符串；选择 auto 不引入已声明持久化类型的变更。Session header、事件信封和已有值类型均未改变，无需相邻迁移。
+
+<a id="verification"></a>
+## 验证
+
+pnpm exec vitest run scripts/persistence-changes.spec.ts scripts/persistence-schema.spec.ts 通过 64 个测试。权限、Auto review、工具执行、agent loop（智能体循环）、subagent 继承和 TypeScript SDK 的定向测试共 10 个文件、390 个测试通过，覆盖原生与 PTC 拒绝元数据。uv run --python 3.10 --group test --project python/sdk pytest python/sdk/tests/test_client.py -k preserves_auto_review_errors 通过 1 个测试。持久化预览仅识别出这两项可选字段新增，均无需提升版本。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。