Merge remote-tracking branch 'origin/master' into worktree/process-plugin-streaming-72f9b3

# Conflicts: # .agents/notes/archived/manifest.json # .agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.i18n.yaml # .agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md # .agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.zh.md # .agents/notes/implemented/bug-fix/2026-09-05-nested-terminal-cards.i18n.yaml # .agents/notes/implemented/feature/2026-08-11-background-job-completion-wakes-an-idle-owner.i18n.yaml # .agents/notes/implemented/testing/2026-09-06-standard-hosted-benchmark-runner.i18n.yaml # docs/architecture.i18n.yaml # docs/capability-seams.i18n.yaml # docs/config-catalog.i18n.yaml # docs/cookbook/adding-a-tool.i18n.yaml # docs/event-producer-consumer.i18n.yaml # docs/module-graph.i18n.yaml # docs/persistence-catalog.i18n.yaml # docs/subsystems/shell.i18n.yaml # packages/client/ui-primitives/README.i18n.yaml # packages/jobs/jobs-local/README.i18n.yaml # packages/jobs/jobs/README.i18n.yaml # packages/jobs/jobs/README.md # packages/jobs/jobs/README.zh.md # packages/jobs/tool-jobs/README.i18n.yaml # packages/shell/tool-bash/README.i18n.yaml # packages/shell/tool-pwsh/README.i18n.yaml
2026-09-07 10:39:56 +08:00
commit bf91cd855e
@@ -2,5 +2,5 @@
 # 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 .agents/notes/README.md
-README.md: ae8e4724d610c97d74910d7dec5c95af69e93281
-README.zh.md: 8cecc7068d9efc5e2ebb78d2301d03633f70f137
+README.md: 8bf1adf875b54eb4580b4d189dfeed07c9f671c0
+README.zh.md: ff9bdb358d584d4f4ad0aea295c31d8d8fff9376
@@ -20,7 +20,7 @@ The active lifecycle tree is the working inventory: browse its lifecycle/class f

 ## Classification

-Each Agent Note belongs to one path-encoded class from the closed set in `scripts/agent-note-tree.ts`; the classification gate rejects other folders. Adding a class requires updating the canonical set and this section. See the [classification Agent Note](implemented/process/2026-06-20-agent-note-classification.md).
+Each Agent Note belongs to one path-encoded class from the closed set in `scripts/agent-note-tree.ts`; the classification gate rejects other folders. Adding a class requires updating the canonical set and this section.

 | Class | What it covers |
 |---|---|
@@ -22,7 +22,7 @@

 ## 分类

-每份 Agent Note 属于 `scripts/agent-note-tree.ts` 中封闭集合里的一个路径编码类别；分类门禁拒绝其他文件夹。新增类别需要同时更新规范集合与本节。见[分类 Agent Note](implemented/process/2026-06-20-agent-note-classification.zh.md)。
+每份 Agent Note 属于 `scripts/agent-note-tree.ts` 中封闭集合里的一个路径编码类别；分类门禁拒绝其他文件夹。新增类别需要同时更新规范集合与本节。

 | 类别 | 覆盖范围 |
 |---|---|
@@ -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 .agents/notes/archived/architecture/2026-06-11-runtime-arg-validation.md
+2026-06-11-runtime-arg-validation.md: 22283c76719a26f733a8125bf263810d53a92c3c
+2026-06-11-runtime-arg-validation.zh.md: f748b7e01b233edb8b3303898cc339dfacd16967
@@ -1,6 +1,7 @@
 # Agent Note: Runtime arg validation at the model boundary

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-11-runtime-arg-validation.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 模型边界处的运行时参数校验

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-11-runtime-arg-validation.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-06-11-structured-error-taxonomy.md
+2026-06-11-structured-error-taxonomy.md: a5c1c6e6120eefd3bc96090cfa4536fb83afa796
+2026-06-11-structured-error-taxonomy.zh.md: 54a937c5595aa5645e4cc0f66a6d1a2efc232588
@@ -1,6 +1,7 @@
 # Agent Note: Structured error taxonomy

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-11-structured-error-taxonomy.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 结构化错误分类体系

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-11-structured-error-taxonomy.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-06-17-filesystem-capability-seam.md
+2026-06-17-filesystem-capability-seam.md: a0c898c1d127a7828037b3a59d04ff73c82e31ba
+2026-06-17-filesystem-capability-seam.zh.md: 0442333a0a7cbc4fcae0f4b02db1700ce6aafc9e
@@ -1,6 +1,7 @@
 # Agent Note: Filesystem capability seam — ctx.fs, local backend, and model-facing filesystem tools

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-17-filesystem-capability-seam.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 文件系统能力 seam——ctx.fs、本地后端与面向模型的文件系统工具

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-17-filesystem-capability-seam.md) | 中文

@@ -1,6 +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 .agents/notes/implemented/bug-fix/2026-07-30-approval-panel-command-cap.md
-2026-07-30-approval-panel-command-cap.md: 0bfdc2d00fa4a0f9fa9ee71400d6f3cc2350e617
-2026-07-30-approval-panel-command-cap.zh.md: a086888b12c0164b931019f4d73102bd11bccf4b
+#   pnpm run verify-translation-pairing --write .agents/notes/archived/architecture/2026-06-18-agent-lifecycle-and-ownership-contracts.md
+2026-06-18-agent-lifecycle-and-ownership-contracts.md: 012346d9e5b8bf4fd661423b3c398e93e513659d
+2026-06-18-agent-lifecycle-and-ownership-contracts.zh.md: 4f8aaac32dfa3d84a449f12441c23371f1a3a27d
@@ -1,6 +1,7 @@
 # Agent Note: Agent lifecycle and ownership contracts

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-18-agent-lifecycle-and-ownership-contracts.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: Agent 生命周期与所有权约定

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-18-agent-lifecycle-and-ownership-contracts.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-06-20-branded-ids.md
+2026-06-20-branded-ids.md: 3078ebc7035c8c5a86c7a743a0452b0ebddf6c7d
+2026-06-20-branded-ids.zh.md: 3a7d7c319c9fc14724af306b8c601afa759a18e7
@@ -1,6 +1,7 @@
 # Agent Note: Branded IDs everywhere they belong

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-20-branded-ids.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 在所有应有之处使用 branded ID

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-20-branded-ids.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-06-30-bash-stdin-env-trusted-plugin-api.md
+2026-06-30-bash-stdin-env-trusted-plugin-api.md: b9883c88d091e6e932da7c65b8b7fe4d107c0fa4
+2026-06-30-bash-stdin-env-trusted-plugin-api.zh.md: 884b83de21243e27fa39f7840adfffebc398a9b0
@@ -1,6 +1,7 @@
 # Agent Note: stdin + extra env on the bash seam

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-06-30-bash-stdin-env-trusted-plugin-api.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 在 bash seam 上支持 stdin 与额外 env

 Status: implemented
+Archived: 2026-09-04

 [English](2026-06-30-bash-stdin-env-trusted-plugin-api.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-02-fs-per-session-cwd.md
+2026-07-02-fs-per-session-cwd.md: 81dafda9ba71bd2746926e8baa0f4eaf76748429
+2026-07-02-fs-per-session-cwd.zh.md: aa05ed41615f29d580595a66d4743d4baf02b1a9
@@ -1,6 +1,7 @@
 # Agent Note: Resolve filesystem paths against the caller's session cwd

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-02-fs-per-session-cwd.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 相对文件系统路径按调用方的会话 cwd 解析

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-02-fs-per-session-cwd.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-05-subagent-provider-lifecycle-events.md
+2026-07-05-subagent-provider-lifecycle-events.md: a15c3e6faee993902547174fe9ea235d07d9ec2f
+2026-07-05-subagent-provider-lifecycle-events.zh.md: 49e55a3b148775ed7e676b5f55058ef1427a86c6
@@ -1,6 +1,7 @@
 # Agent Note: Subagent provider-lifecycle events — `subagent/provider-added` / `subagent/provider-removed`

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-05-subagent-provider-lifecycle-events.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: Subagent 提供方生命周期事件——`subagent/provider-added` / `subagent/provider-removed`

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-05-subagent-provider-lifecycle-events.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-06-tool-result-retention-library.md
+2026-07-06-tool-result-retention-library.md: 5ac8547036ed0b45ec6e55e6fb213a98b7c3df8f
+2026-07-06-tool-result-retention-library.zh.md: b18fdd60f529f9e6df6b8fc7e3c90f9a39e65fc8
@@ -1,6 +1,7 @@
 # Agent Note: Tool result retention library

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-06-tool-result-retention-library.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 工具结果保留库

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-06-tool-result-retention-library.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-12-scoped-layers-store.md
+2026-07-12-scoped-layers-store.md: d3060696ef54c8d06cd0724179dec49682c721e1
+2026-07-12-scoped-layers-store.zh.md: f5482a5a76724128fb445fbd7c21a2f61b8634c1
@@ -1,6 +1,7 @@
 # Agent Note: Shared scoped-layer storage

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-12-scoped-layers-store.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 共享作用域分层存储

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-12-scoped-layers-store.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-15-llm-model-catalog-and-acp-selection.md
+2026-07-15-llm-model-catalog-and-acp-selection.md: c5f6644d4746a8a962e7ab843493fda3862a8c0a
+2026-07-15-llm-model-catalog-and-acp-selection.zh.md: 539f2f9a2f9d3d7b48b3ecabca4b401e32c5702c
@@ -1,6 +1,7 @@
 # Agent Note: Advisory LLM catalogs and per-session ACP model selection

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-15-llm-model-catalog-and-acp-selection.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 建议性 LLM 目录与 ACP 会话级模型选择

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-15-llm-model-catalog-and-acp-selection.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-15-lsp-capability-seam.md
+2026-07-15-lsp-capability-seam.md: 3cce6eb3c7d8afef53aa675440c7eea1e990721d
+2026-07-15-lsp-capability-seam.zh.md: c424a794a6662a655565dde6337c49543c5a8085
@@ -1,6 +1,7 @@
 # Agent Note: LSP capability seam and model-facing query tool

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-15-lsp-capability-seam.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: LSP 能力 seam 与面向模型的查询工具

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-15-lsp-capability-seam.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-15-replay-token-meter-service.md
+2026-07-15-replay-token-meter-service.md: 1e6832f1bd049a9568b3af3b925211f0665de288
+2026-07-15-replay-token-meter-service.zh.md: 6d00d5e1511aa66818689ccec7d4b023c291f9aa
@@ -1,6 +1,7 @@
 # Agent Note: Replay token meter service

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-15-replay-token-meter-service.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 回放式 token 计量服务

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-15-replay-token-meter-service.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-17-local-spill-startup-cleanup.md
+2026-07-17-local-spill-startup-cleanup.md: c9567cab8b1193b9ea6dbc0ad3fae2bc18af9656
+2026-07-17-local-spill-startup-cleanup.zh.md: 97f6d641ab7e09da401c5632804f6e27ad78d850
@@ -1,6 +1,7 @@
 # Agent Note: One-shot startup cleanup for local spill files

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-17-local-spill-startup-cleanup.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 本地 spill 文件的一次性启动清理

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-17-local-spill-startup-cleanup.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-19-package-owned-invariant-service.md
+2026-07-19-package-owned-invariant-service.md: 6ebdd0edbe04766280fb9aae7067ba861b2ce010
+2026-07-19-package-owned-invariant-service.zh.md: dde72faed7249d64b939aaca1bc5d452eeed7bde
@@ -1,6 +1,7 @@
 # Agent Note: Package-owned invariant service contract

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-19-package-owned-invariant-service.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 包拥有的不变式服务约定

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-19-package-owned-invariant-service.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-20-todo-event-ownership.md
+2026-07-20-todo-event-ownership.md: 3dfcd604393d05265eb895fa50647338830bd38f
+2026-07-20-todo-event-ownership.zh.md: 8dabf8f0cde4ad8af325b00eb1be9d7b7011233f
@@ -1,6 +1,7 @@
 # Agent Note: todo event types belong to their producer

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-20-todo-event-ownership.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: todo 事件类型归其生产方所有

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-20-todo-event-ownership.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-22-unified-send-and-coalesced-user-messages.md
+2026-07-22-unified-send-and-coalesced-user-messages.md: d2e39f4efd122d9e0dbb45a082779afa2ff42941
+2026-07-22-unified-send-and-coalesced-user-messages.zh.md: 37c43fcb7bfa81b177e8ed00876e913e3ddf6ad6
@@ -1,6 +1,7 @@
 # Agent Note: Unify agent delivery on send(target × wakeup) and coalesce injected context into user/message

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-22-unified-send-and-coalesced-user-messages.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 将 agent 投递统一到 send(target × wakeup) 并把注入的上下文合并进 user/message

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-22-unified-send-and-coalesced-user-messages.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-23-toolview-dissolution.md
+2026-07-23-toolview-dissolution.md: d84255f697886556a46c0511aa89f2c4bfd886d8
+2026-07-23-toolview-dissolution.zh.md: 9ae339361193a9b97f7bba44904af0c01e7f3fa0
@@ -1,6 +1,7 @@
 # Agent Note: Toolview dissolution — tool rows are per-view keyed slots

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-23-toolview-dissolution.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: toolview 溶解——工具行即 per-view keyed slot

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-23-toolview-dissolution.md) | 中文

@@ -1,6 +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 .agents/notes/implemented/architecture/2026-08-04-credentials-yaml-and-user-environment-layer.md
-2026-08-04-credentials-yaml-and-user-environment-layer.md: 44bdea243671093b34a6338ed1c95bf25bcc78f4
-2026-08-04-credentials-yaml-and-user-environment-layer.zh.md: 4d2893c57bfdf8bbd1529cc0ba8336dbc3ecd233
+#   pnpm run verify-translation-pairing --write .agents/notes/archived/architecture/2026-07-24-adapter-owned-reasoning-effort-capabilities.md
+2026-07-24-adapter-owned-reasoning-effort-capabilities.md: f5c240145dc7f405f8bc1f66b6b5f7f68991eb80
+2026-07-24-adapter-owned-reasoning-effort-capabilities.zh.md: 81994d4908bd9531cc7db35634bf768372ace1d7
@@ -1,6 +1,7 @@
 # Agent Note: Adapter-owned reasoning effort capabilities

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-24-adapter-owned-reasoning-effort-capabilities.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 适配器持有的推理强度能力

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-24-adapter-owned-reasoning-effort-capabilities.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-25-web-command-surfaces-and-assembly.md
+2026-07-25-web-command-surfaces-and-assembly.md: bfb7d2697a979efc8101581d42f4ab223d1b1e97
+2026-07-25-web-command-surfaces-and-assembly.zh.md: d81f70403d22efb2203bbe221a45035fc3d6503f
@@ -1,6 +1,7 @@
 # Agent Note: Web command business surfaces and assembly (ui-commands / ui-skill / ui-subagent)

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-25-web-command-surfaces-and-assembly.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: Web 命令业务面与装配（ui-commands / ui-skill / ui-subagent）

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-25-web-command-surfaces-and-assembly.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-25-web-input-machine-and-slash-pipeline.md
+2026-07-25-web-input-machine-and-slash-pipeline.md: b6d485d495717770ebb5148880b3c8c1cb23b948
+2026-07-25-web-input-machine-and-slash-pipeline.zh.md: 69ed9a40f4dd9a316f147e3077c9167e1ee46eeb
@@ -1,6 +1,7 @@
 # Agent Note: Web input state machine, composer slots, and the slash pipeline (ui-conversation input / ui-input-trigger)

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-25-web-input-machine-and-slash-pipeline.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: Web 输入状态机、composer slot 与 slash 流水线（ui-conversation input / ui-input-trigger）

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-25-web-input-machine-and-slash-pipeline.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-26-job-registry-seam.md
+2026-07-26-job-registry-seam.md: d1a8cfb7bc4f1a8e313dfa8d59a5d0e5f8106190
+2026-07-26-job-registry-seam.zh.md: 1624a410407d8e6ac8cc85a6fe1480e0867eef6d
@@ -1,6 +1,7 @@
 # Agent Note: The job registry is a capability seam (`dsh-jobs` / `dsh-jobs-local`)

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-26-job-registry-seam.zh.md)

@@ -12,13 +13,13 @@ The [background-job runtime](2026-06-20-generic-long-running-tool-runtime.md) sh

 `jobs/` is now a three-package capability family in the bash-trio shape:

- **`@deepseek-ai/dsh-jobs` (Service Definition)** — the abstract `JobRegistry extends Service` owning `ctx.jobs`, the contract (`start`, the caller-bound `forCaller` view with `list`, `get`, `read`, `readAt`, `kill`, and `wait`, the `events` stream, and `attachController`), all vocabulary types (`JobId`, `JobKindMap`, `JobSpec`, `JobHandle`, `JobHooks`, `JobOutcome`, `JobView`, `JobRead`, `JobEvent`), and the event-protocol invariant companion. The class-level JSDoc states the semantics every Service Provider owes: registrations outlive producer and controller fibers, owned access is session-fenced, settlement is first-wins with contained listeners, and `start` refuses work while no attached job controller serves the spec's owner (controllers and event subscriptions are scope-layered, so one process-wide registry answers both questions per owner).
+- **`@deepseek-ai/dsh-jobs` (Service Definition)** — the abstract `JobRegistry extends Service` owning `ctx.jobs`, the nine-method contract (`start`, `list`, `get`, `read`, `kill`, `wait`, `onJobDone`, `onJobsChanged`, `attachController`), all vocabulary types (`JobId`, `JobKindMap`, `JobStart`, `JobHooks`, `JobOutcome`, `JobSnapshot`, `JobRead`, `JobDoneListener`), and the snapshot invariant companion. The class-level JSDoc states the semantics every Service Provider owes: registrations outlive producer and controller fibers, owned access is session-fenced, settlement is first-wins with contained listeners, and `start` refuses work while no attached job controller serves the spec's owner (controllers and listeners are scope-layered, so one process-wide registry answers both questions per owner).
 - **`@deepseek-ai/dsh-jobs-local` (Service Provider)** — `LocalJobRegistry`, the process-local registry: the in-memory store, per-kind id counters, waiter bookkeeping, `TASK_WAIT_TIMEOUT` deadline code, owner-cleanup effects, force-fail teardown, and the default-10 configurable admission policy. Admission derives `running` plus `stopping` capacity from the same records per exact owner, with one unowned bucket; it adds no public count or second state owner. The `dsh-timeout` dependency and Schemastery-owned provider config live here; the Service Definition package has no provider dependencies.
 - **`@deepseek-ai/dsh-tool-jobs` (Consumer)** — unchanged; it injects `'jobs'` and never imports provider types.

 Compositions load `dsh-jobs-local` where they previously loaded `dsh-jobs` (`dsh-base`, `sdk-minimal`, test harnesses, and the tool-catalog generator boot). Producer misconfiguration diagnostics ("background jobs unavailable: load …") name `dsh-jobs` — the Service Definition package that declares the absent `ctx.jobs` service — and the Service Definition package's own APIs (its README and the direct-mount fence) point at Service Providers, so the producer message stays correct when another backend becomes the recommended default. Producers, `JobKindMap` declaration merges, and the controller keep importing `@deepseek-ai/dsh-jobs` only.

-The seam keeps the in-process contract semantics unchanged: `JobSpec.run()` still returns in-process hooks and pushes output through an in-process `JobHandle`, and `JobSpec.owner` names a session whose live `Agent` the registry resolves in-process, so a durable or cross-process backend still has design work to do before it can satisfy this Service Definition (identity, restart, ownership, observation). The split moves that future work out of every Consumer's dependency graph; it does not pre-design the backend.
+The seam keeps the in-process contract semantics unchanged: `JobStart.run()` still passes callbacks and exact `Agent` objects, so a durable or cross-process backend still has design work to do before it can satisfy this Service Definition (identity, restart, ownership, observation). The split moves that future work out of every Consumer's dependency graph; it does not pre-design the backend.

 ## Alternatives considered

@@ -1,6 +1,7 @@
 # Agent Note: 任务注册表是一个能力 seam（`dsh-jobs` / `dsh-jobs-local`）

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-26-job-registry-seam.md) | 中文

@@ -12,13 +13,13 @@ Status: implemented

 `jobs/` 如今是一个 bash 三件套形态的三包能力家族：

- **`@deepseek-ai/dsh-jobs`（Service Definition）**——抽象的 `JobRegistry extends Service`，拥有 `ctx.jobs`、约定（`start`、绑定调用方的 `forCaller` 视图及其 `list`、`get`、`read`、`readAt`、`kill`、`wait`、`events` 事件流，以及 `attachController`）、全部词汇类型（`JobId`、`JobKindMap`、`JobSpec`、`JobHandle`、`JobHooks`、`JobOutcome`、`JobView`、`JobRead`、`JobEvent`），以及事件协议不变式配套插件。类级 JSDoc 陈述了每个 Service Provider 都必须兑现的语义：注册的存续期长于生产方与控制器的 fiber，有所有者的访问以会话为界，结算遵循首次结果优先且监听器错误被隔离，并且当没有任何已附加的任务控制器服务于 spec 的所有者时 `start` 拒绝启动工作（控制器与事件订阅按 scope 分层，因此一个进程级注册表能逐所有者地回答这两个问题）。
+- **`@deepseek-ai/dsh-jobs`（Service Definition）**——抽象的 `JobRegistry extends Service`，拥有 `ctx.jobs`、九个方法的约定（`start`、`list`、`get`、`read`、`kill`、`wait`、`onJobDone`、`onJobsChanged`、`attachController`）、全部词汇类型（`JobId`、`JobKindMap`、`JobStart`、`JobHooks`、`JobOutcome`、`JobSnapshot`、`JobRead`、`JobDoneListener`），以及快照不变式配套插件。类级 JSDoc 陈述了每个 Service Provider 都必须兑现的语义：注册的存续期长于生产方与控制器的 fiber，有所有者的访问以会话为界，结算遵循首次结果优先且监听器错误被隔离，并且当没有任何已附加的任务控制器服务于 spec 的所有者时 `start` 拒绝启动工作（控制器与监听器按 scope 分层，因此一个进程级注册表能逐所有者地回答这两个问题）。
 - **`@deepseek-ai/dsh-jobs-local`（Service Provider）**——`LocalJobRegistry`，即进程内注册表：内存存储、按 kind 划分的 id 计数器、等待方簿记、`TASK_WAIT_TIMEOUT` deadline 代码、所有者清理 effect、强制失败的拆除，以及默认值为 10 且可配置的准入策略。准入从同一组记录中按确切 owner 派生 `running` 加 `stopping` 容量，并为无 owner 任务使用一个共享桶；它不新增公开计数或第二个状态 owner。`dsh-timeout` 依赖与由 Schemastery 管理的 Service Provider 配置都位于此包；Service Definition 包不含任何提供方依赖。
 - **`@deepseek-ai/dsh-tool-jobs`（Consumer）**——保持不变；它注入 `'jobs'`，从不导入提供方类型。

 各组合在原先加载 `dsh-jobs` 的位置改为加载 `dsh-jobs-local`：`dsh-base`、`sdk-minimal`、各测试 harness，以及工具目录生成器的启动流程。生产方的配置错误诊断信息（「background jobs unavailable: load …」）点名 `dsh-jobs`——即声明缺失的 `ctx.jobs` 服务的 Service Definition 包；Service Definition 包自身的 API（其 README 与直接挂载防线）会指向各 Service Provider，因此当另一个后端日后成为推荐默认时，生产方的消息依旧正确。生产方、`JobKindMap` 声明合并和控制器仍然只导入 `@deepseek-ai/dsh-jobs`。

-该 seam 保持进程内约定语义不变：`JobSpec.run()` 仍然返回进程内钩子并经进程内的 `JobHandle` 推送输出，`JobSpec.owner` 指向一个由注册表在进程内解析其存活 `Agent` 的会话，因此持久化或跨进程后端在能满足此 Service Definition 之前仍有设计工作要做（身份、重启、所有权、观察）。这次拆分把该项未来工作移出了每个 Consumer 的依赖图；它并不预先设计后端。
+该 seam 保持进程内约定语义不变：`JobStart.run()` 仍然传入回调和确切的 `Agent` 对象，因此持久化或跨进程后端在能满足此 Service Definition 之前仍有设计工作要做（身份、重启、所有权、观察）。这次拆分把该项未来工作移出了每个 Consumer 的依赖图；它并不预先设计后端。

 ## 曾考虑的替代方案

@@ -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 .agents/notes/archived/architecture/2026-07-26-subprocess-seam.md
+2026-07-26-subprocess-seam.md: bd8cba2197a56acef2ab12e9b43e254fbc744ee5
+2026-07-26-subprocess-seam.zh.md: ba23649e9e68f578bdc9ba26a026981d0afe981f
@@ -1,6 +1,7 @@
 # Agent Note: The subprocess service is its own seam under the bash executors (`dsh-subprocess` / `dsh-subprocess-local`)

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-26-subprocess-seam.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 进程服务是 bash 执行器之下的独立 seam（`dsh-subprocess` / `dsh-subprocess-local`）

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-26-subprocess-seam.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-27-dispose-ladder-to-consumer.md
+2026-07-27-dispose-ladder-to-consumer.md: 7e1b189c1d3a32c6f812bba5d5f06f7a6a89c29b
+2026-07-27-dispose-ladder-to-consumer.zh.md: 6c61cad5d4a62c5c976894f72d0ff5e9c69184bc
@@ -1,6 +1,7 @@
 # Agent Note: The dispose ladder belongs to its consumer, not the subprocess seam

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-27-dispose-ladder-to-consumer.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: dispose 阶梯归其消费方所有，而非 subprocess seam

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-27-dispose-ladder-to-consumer.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-28-directory-picker-capability-seam.md
+2026-07-28-directory-picker-capability-seam.md: e2f3312b7429078eb81cba62ab1727e71fe67b74
+2026-07-28-directory-picker-capability-seam.zh.md: 41a05febe58c353242cc389e20bbf84b3620b7c9
@@ -1,6 +1,7 @@
 # Agent Note: A capability-discriminated directory-picker seam for the web-GUI host

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-28-directory-picker-capability-seam.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: web GUI 宿主的能力可辨识目录选择 seam

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-28-directory-picker-capability-seam.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-28-user-settings-seam.md
+2026-07-28-user-settings-seam.md: 75fef5ed976d80acb4e26133c2b98d8504042121
+2026-07-28-user-settings-seam.zh.md: 9797e5a3288a7709f3541784778c514890015410
@@ -1,6 +1,7 @@
 # Agent Note: user-settings seam (`ctx.settings`) and the file provider

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-28-user-settings-seam.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 用户设置 seam（`ctx.settings`）与文件提供方

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-28-user-settings-seam.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-29-package-regrouping.md
+2026-07-29-package-regrouping.md: 7073d868fe73f75477cf9a6fa2c5f7c425d014a8
+2026-07-29-package-regrouping.zh.md: b33ecf1600ce9c9796e932c14c5df9782bb3a94b
@@ -1,6 +1,7 @@
 # Agent Note: Regroup packages/ by measured clustering

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-29-package-regrouping.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 按实测聚类重新划分 packages/ 分组

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-29-package-regrouping.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-29-request-level-llm-config-credentials.md
+2026-07-29-request-level-llm-config-credentials.md: dda5cd6710ad432a25bce1214078098f4e797559
+2026-07-29-request-level-llm-config-credentials.zh.md: e521920586c8fe9d3a498e0369d1693096562973
@@ -1,6 +1,7 @@
 # Agent Note: request-level LLM configuration and the credential seam

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-29-request-level-llm-config-credentials.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 请求级 LLM 配置与凭据 seam

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-29-request-level-llm-config-credentials.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-30-adapter-owned-max-token-defaults.md
+2026-07-30-adapter-owned-max-token-defaults.md: 30b1840a9ff80092609698e63d061a7d82503e5d
+2026-07-30-adapter-owned-max-token-defaults.zh.md: 770c61ce1514fa8e16d4cbabed4dd97b5b7b40fb
@@ -1,6 +1,7 @@
 # Agent Note: Adapter-owned max-token defaults

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-30-adapter-owned-max-token-defaults.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 适配器持有的最大 token 默认值

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-30-adapter-owned-max-token-defaults.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-30-client-locale-full-rollout.md
+2026-07-30-client-locale-full-rollout.md: 381a0ed642d7452cb4be2c9a755bf33c120cba76
+2026-07-30-client-locale-full-rollout.zh.md: 81ae013e86c6ecb608a15c3664c5203233e27e40
@@ -1,6 +1,7 @@
 # Agent Note: Full client copy rollout onto the typed locale seat

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-30-client-locale-full-rollout.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: client 文案全量接入 typed locale 席位

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-30-client-locale-full-rollout.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-30-command-row-copy-contract.md
+2026-07-30-command-row-copy-contract.md: e5f1828e433015a1381ae4f7951c518bb6040107
+2026-07-30-command-row-copy-contract.zh.md: 7efe1aa65ddd992e64807e229b1da682f5bc320b
@@ -1,6 +1,7 @@
 # Agent Note: Command row copy is split between the row and the handler

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-30-command-row-copy-contract.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 命令条目文案分别由条目与 handler 负责

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-30-command-row-copy-contract.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-30-config-plane-boundaries.md
+2026-07-30-config-plane-boundaries.md: 6c1f0c8643e9f1b1879b213e01bb8555b6980afe
+2026-07-30-config-plane-boundaries.zh.md: 16b05a45afbb944e3ed9f1121e067d8d2bbf1f48
@@ -1,6 +1,7 @@
 # Agent Note: what the configuration plane exposes, and who may overwrite what

 Status: implemented
+Archived: 2026-09-04

 English | [中文](2026-07-30-config-plane-boundaries.zh.md)

@@ -1,6 +1,7 @@
 # Agent Note: 配置面暴露什么，以及谁有权覆盖什么

 Status: implemented
+Archived: 2026-09-04

 [English](2026-07-30-config-plane-boundaries.md) | 中文

@@ -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 .agents/notes/archived/architecture/2026-07-30-settings-write-path-integrity.md
+2026-07-30-settings-write-path-integrity.md: 00e9639bc3f2bec8d4f10d3ba30611c822d3d966
+2026-07-30-settings-write-path-integrity.zh.md: 887941a8bcfadc7f8745b77f2c650452df5df0b9