dsh-plugin-guide 0.3.15 → 0.3.17

package/references/official-docs/docs/persistence-changes/2026-09-11-initial.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/2026-09-11-initial.md
+2026-09-11-initial.md: a919aba314a7e94242ab831a588e2112997edd8f
+2026-09-11-initial.zh.md: e37d0c48219e8ac4d5d30d84cca441c150210a0b

package/references/official-docs/docs/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.