release-skill 0.9.1 → 0.9.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.codebuddy-plugin/plugin.json +1 -1
  4. package/.codex-plugin/plugin.json +2 -2
  5. package/.kimi-plugin/plugin.json +1 -1
  6. package/CHANGELOG.md +78 -0
  7. package/INSTALL.md +2 -2
  8. package/INSTALL.zh-CN.md +2 -2
  9. package/README.md +56 -26
  10. package/README.zh-CN.md +47 -23
  11. package/adapters/claude/.claude-plugin/marketplace.json +1 -1
  12. package/adapters/claude/.claude-plugin/plugin.json +1 -1
  13. package/adapters/claude/bin/consumer-contract-vectors.json +7 -7
  14. package/adapters/claude/bin/error-codes.json +1 -1
  15. package/adapters/claude/bin/foundation-resource-binding.json +1 -1
  16. package/adapters/claude/bin/registry.json +22 -1
  17. package/adapters/claude/bin/release-skill.bundle.mjs +4564 -1997
  18. package/adapters/claude/bin/rules.json +1 -1
  19. package/adapters/claude/schemas/release-project.schema.json +4 -0
  20. package/adapters/claude/schemas/release-run.schema.json +41 -1
  21. package/adapters/claude/skills/release-config/SKILL.md +5 -3
  22. package/adapters/claude/skills/release-docs/SKILL.md +4 -2
  23. package/adapters/claude/skills/release-finish/SKILL.md +2 -0
  24. package/adapters/claude/skills/release-help/SKILL.md +18 -3
  25. package/adapters/claude/skills/release-marketplace/SKILL.md +3 -1
  26. package/adapters/claude/skills/release-prepare/SKILL.md +12 -2
  27. package/adapters/claude/skills/release-publish/SKILL.md +17 -10
  28. package/adapters/claude/skills/release-verify/SKILL.md +2 -0
  29. package/adapters/claude/src/schemas/executable-identity-observation.schema.json +162 -0
  30. package/adapters/claude/src/schemas/filesystem-tree-observation.schema.json +18 -2
  31. package/adapters/claude/src/schemas/plugin-verification-request.schema.json +147 -22
  32. package/adapters/claude/src/schemas/plugin-verification-result.schema.json +436 -18
  33. package/adapters/claude/src/schemas/skill-family-directory-verification-request.schema.json +100 -0
  34. package/adapters/claude/src/schemas/skill-family-directory-verification-result.schema.json +193 -0
  35. package/adapters/codex/.codex-plugin/plugin.json +2 -2
  36. package/adapters/codex/bin/consumer-contract-vectors.json +7 -7
  37. package/adapters/codex/bin/error-codes.json +1 -1
  38. package/adapters/codex/bin/foundation-resource-binding.json +1 -1
  39. package/adapters/codex/bin/registry.json +22 -1
  40. package/adapters/codex/bin/release-skill.bundle.mjs +4564 -1997
  41. package/adapters/codex/bin/rules.json +1 -1
  42. package/adapters/codex/schemas/release-project.schema.json +4 -0
  43. package/adapters/codex/schemas/release-run.schema.json +41 -1
  44. package/adapters/codex/skills/release-config/SKILL.md +5 -3
  45. package/adapters/codex/skills/release-docs/SKILL.md +4 -2
  46. package/adapters/codex/skills/release-finish/SKILL.md +2 -0
  47. package/adapters/codex/skills/release-help/SKILL.md +18 -3
  48. package/adapters/codex/skills/release-marketplace/SKILL.md +3 -1
  49. package/adapters/codex/skills/release-prepare/SKILL.md +12 -2
  50. package/adapters/codex/skills/release-publish/SKILL.md +17 -10
  51. package/adapters/codex/skills/release-verify/SKILL.md +2 -0
  52. package/adapters/codex/src/schemas/executable-identity-observation.schema.json +162 -0
  53. package/adapters/codex/src/schemas/filesystem-tree-observation.schema.json +18 -2
  54. package/adapters/codex/src/schemas/plugin-verification-request.schema.json +147 -22
  55. package/adapters/codex/src/schemas/plugin-verification-result.schema.json +436 -18
  56. package/adapters/codex/src/schemas/skill-family-directory-verification-request.schema.json +100 -0
  57. package/adapters/codex/src/schemas/skill-family-directory-verification-result.schema.json +193 -0
  58. package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
  59. package/adapters/kimi/bin/consumer-contract-vectors.json +7 -7
  60. package/adapters/kimi/bin/error-codes.json +1 -1
  61. package/adapters/kimi/bin/foundation-resource-binding.json +1 -1
  62. package/adapters/kimi/bin/registry.json +22 -1
  63. package/adapters/kimi/bin/release-skill.bundle.mjs +4564 -1997
  64. package/adapters/kimi/bin/rules.json +1 -1
  65. package/adapters/kimi/schemas/release-project.schema.json +4 -0
  66. package/adapters/kimi/schemas/release-run.schema.json +41 -1
  67. package/adapters/kimi/skills/release-config/SKILL.md +5 -3
  68. package/adapters/kimi/skills/release-docs/SKILL.md +4 -2
  69. package/adapters/kimi/skills/release-finish/SKILL.md +2 -0
  70. package/adapters/kimi/skills/release-help/SKILL.md +18 -3
  71. package/adapters/kimi/skills/release-marketplace/SKILL.md +3 -1
  72. package/adapters/kimi/skills/release-prepare/SKILL.md +12 -2
  73. package/adapters/kimi/skills/release-publish/SKILL.md +17 -10
  74. package/adapters/kimi/skills/release-verify/SKILL.md +2 -0
  75. package/adapters/kimi/src/schemas/executable-identity-observation.schema.json +162 -0
  76. package/adapters/kimi/src/schemas/filesystem-tree-observation.schema.json +18 -2
  77. package/adapters/kimi/src/schemas/plugin-verification-request.schema.json +147 -22
  78. package/adapters/kimi/src/schemas/plugin-verification-result.schema.json +436 -18
  79. package/adapters/kimi/src/schemas/skill-family-directory-verification-request.schema.json +100 -0
  80. package/adapters/kimi/src/schemas/skill-family-directory-verification-result.schema.json +193 -0
  81. package/adapters/workbuddy/.codebuddy-plugin/plugin.json +1 -1
  82. package/adapters/workbuddy/bin/consumer-contract-vectors.json +7 -7
  83. package/adapters/workbuddy/bin/error-codes.json +1 -1
  84. package/adapters/workbuddy/bin/foundation-resource-binding.json +1 -1
  85. package/adapters/workbuddy/bin/registry.json +22 -1
  86. package/adapters/workbuddy/bin/release-skill.bundle.mjs +4564 -1997
  87. package/adapters/workbuddy/bin/rules.json +1 -1
  88. package/adapters/workbuddy/schemas/release-project.schema.json +4 -0
  89. package/adapters/workbuddy/schemas/release-run.schema.json +41 -1
  90. package/adapters/workbuddy/skills/release-config/SKILL.md +5 -3
  91. package/adapters/workbuddy/skills/release-docs/SKILL.md +4 -2
  92. package/adapters/workbuddy/skills/release-finish/SKILL.md +2 -0
  93. package/adapters/workbuddy/skills/release-help/SKILL.md +18 -3
  94. package/adapters/workbuddy/skills/release-marketplace/SKILL.md +3 -1
  95. package/adapters/workbuddy/skills/release-prepare/SKILL.md +12 -2
  96. package/adapters/workbuddy/skills/release-publish/SKILL.md +17 -10
  97. package/adapters/workbuddy/skills/release-verify/SKILL.md +2 -0
  98. package/adapters/workbuddy/src/schemas/executable-identity-observation.schema.json +162 -0
  99. package/adapters/workbuddy/src/schemas/filesystem-tree-observation.schema.json +18 -2
  100. package/adapters/workbuddy/src/schemas/plugin-verification-request.schema.json +147 -22
  101. package/adapters/workbuddy/src/schemas/plugin-verification-result.schema.json +436 -18
  102. package/adapters/workbuddy/src/schemas/skill-family-directory-verification-request.schema.json +100 -0
  103. package/adapters/workbuddy/src/schemas/skill-family-directory-verification-result.schema.json +193 -0
  104. package/bin/consumer-contract-vectors.json +7 -7
  105. package/bin/error-codes.json +1 -1
  106. package/bin/foundation-resource-binding.json +1 -1
  107. package/bin/registry.json +22 -1
  108. package/bin/release-skill-cli.mjs +58 -2
  109. package/bin/release-skill.bundle.mjs +4564 -1997
  110. package/bin/rules.json +1 -1
  111. package/package.json +5 -5
  112. package/platform-manifest.json +4 -4
  113. package/references/.render-manifest.json +4 -4
  114. package/references/01-state-machine.md +34 -1
  115. package/references/02-project-config.md +20 -0
  116. package/references/05-evidence-and-errors.md +2 -2
  117. package/schemas/release-project.schema.json +4 -0
  118. package/schemas/release-run.schema.json +41 -1
  119. package/skills/release-config/SKILL.md +5 -3
  120. package/skills/release-docs/SKILL.md +4 -2
  121. package/skills/release-finish/SKILL.md +2 -0
  122. package/skills/release-help/SKILL.md +18 -3
  123. package/skills/release-marketplace/SKILL.md +3 -1
  124. package/skills/release-prepare/SKILL.md +12 -2
  125. package/skills/release-publish/SKILL.md +17 -10
  126. package/skills/release-verify/SKILL.md +2 -0
  127. package/skills-src/release-config/SKILL.md +5 -3
  128. package/skills-src/release-docs/SKILL.md +4 -2
  129. package/skills-src/release-finish/SKILL.md +2 -0
  130. package/skills-src/release-help/SKILL.md +18 -3
  131. package/skills-src/release-marketplace/SKILL.md +3 -1
  132. package/skills-src/release-prepare/SKILL.md +12 -2
  133. package/skills-src/release-publish/SKILL.md +17 -10
  134. package/skills-src/release-verify/SKILL.md +2 -0
  135. package/src/commands/post-release-local.mjs +169 -16
  136. package/src/commands/prepare.mjs +321 -11
  137. package/src/commands/route.mjs +597 -18
  138. package/src/commands/setup.mjs +2 -0
  139. package/src/commands/ship.mjs +183 -2
  140. package/src/commands/verify.mjs +21 -0
  141. package/src/core/adoption-assessment.mjs +59 -0
  142. package/src/core/foundation-plugin-verification.mjs +233 -1
  143. package/src/core/hook-cache.mjs +318 -26
  144. package/src/core/hooks.mjs +8 -1
  145. package/src/producers/foundation-resource-projection.mjs +3 -3
  146. package/src/schemas/executable-identity-observation.schema.json +162 -0
  147. package/src/schemas/filesystem-tree-observation.schema.json +18 -2
  148. package/src/schemas/plugin-verification-request.schema.json +147 -22
  149. package/src/schemas/plugin-verification-result.schema.json +436 -18
  150. package/src/schemas/skill-family-directory-verification-request.schema.json +100 -0
  151. package/src/schemas/skill-family-directory-verification-result.schema.json +193 -0
@@ -44,7 +44,7 @@ byte、platform manifest 是核心 gate,由 workspace 自己的生成器与
44
44
 
45
45
  ## 正向执行路径
46
46
 
47
- 1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
47
+ 1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类;已知目标版本时显式传入,route 只是工作流建议
48
48
  2. 若推荐 `workflowKind === 'marketplace-only'`,则使用本技能
49
49
  3. 执行步骤②:手动审查并更新 `plugins.mjs`(唯一 truth source)
50
50
  4. 执行步骤③:调用 workspace 自己的生成器再生成 `public-snapshot/`
@@ -59,6 +59,8 @@ byte、platform manifest 是核心 gate,由 workspace 自己的生成器与
59
59
  # Step 1: Diff classification confirmation (marketplace-only)
60
60
  node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
61
61
  --root <workspace-root> --json
62
+ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
63
+ --root <workspace-root> --target-version <version> --json
62
64
 
63
65
  # Step 2: Manual review and update plugins.mjs
64
66
  # Human-in-the-loop: entry is the sole truth source
@@ -13,6 +13,10 @@ description: Freeze an immutable release plan with local configuration, document
13
13
 
14
14
  运行项目构建/测试 hook,生成公开快照并扫描泄漏,冻结不可变发布计划。prepare 自身不调用发布 adapter,但会执行用户配置的 hook。
15
15
 
16
+ 0.9.4 候选允许多发布单元项目在冻结前显式选择本轮范围。`--unit <id>` 可以重复传入;未传时仍选择全部单元。显式选择只跳过延期单元的单元级工作,完整配置校验、生成物新鲜度和顶层 Hook 仍全部执行。计划冻结后以 `plan.units` 为唯一范围权威,publish、reconcile、verify 和 distribute 不接受单元选择。
17
+
18
+ 0.9.3 引入的 Hook cache v2 继续只复用有完整身份和输入证据的成功 Hook 结果。裸 PATH、PATHEXT、Windows、TTL、损坏记录或 Foundation 观察不可用时,缓存保持失败关闭,Hook 仍按完整路径冷执行;该机制不改变 prepare 的计划、批准和发布权威。
19
+
16
20
  **Hook 授权契约(配置时刻即授权,FM-16 处置 A)**: hook 是任意本地进程——在 `.release-skill/project.yaml` 中配置 hook 命令即完成授权,构成「配置时刻即授权」的显式契约。hook 不提供沙箱、无文件系统/网络隔离、触发前无确认点,命令调用本身即授权执行已配置的 hook 和 gate,不再设置额外人工授权环节;hook 可能产生项目目录外的副作用或远端写入,配置者须对其内容负责。旧参数 `--acknowledge-hook-side-effects` 和 `--acknowledge-gate-side-effects` 仍可解析,但只作为无效果的兼容输入,不能改变授权或执行语义。恢复「触发前强制确认门」属于后续加固项(属设计变更,需随新版本引入),当前版本不提供该确认门。
17
21
 
18
22
  **阶段通过规则**: 本阶段的通过只能由 CLI exit code 0 和结构化状态码 `PREPARED` 确认。Agent 无权自行宣布计划冻结成功。
@@ -23,11 +27,13 @@ description: Freeze an immutable release plan with local configuration, document
23
27
 
24
28
  **发布文档新鲜度门**: 配置了 `releaseDocuments` 的单元在 hook 授权门前先执行同一只读规划器:`clean` 继续;`changes` 抛 `RELEASE_DOCS_STALE`,详情列出相对路径、语种、`refreshDigest` 和精确演练/写入参数数组。prepare 只检查、不写工作树。正式 prepare 前先运行只读演练;有变化时向用户展示文件/语种/版本/`refreshDigest`,只有在用户明确授权"本地发布文档写入"后,才执行带 `--write --confirm-refresh <refreshDigest> --ack-local-document-write` 三项绑定的写入,随后运行聚焦校验,要求维护者审阅并提交刷新结果,再重新 prepare。该授权不扩展为 hook、提交、push 或 publish 授权。
25
29
 
30
+ **显式发布范围**: 只有用户已经指出本轮要发布哪些单元时,才把这些 ID 逐个传给 `--unit`。release-skill 不根据失败自动排除单元。选择命中 `publicSourceAuthorityReceipt` 的 coordinator 或 subject 时,必须包含收据声明的完整单元闭包;缺少单元时按命令返回的精确 argv 重新选择,不自动扩选。成功后展示 `releaseScope.selectedUnitIds`、`releaseScope.deferredUnitIds` 和批准摘要。延期仅表示没有进入本轮计划,不表示通过或失败。
31
+
26
32
  ## 正向执行路径
27
33
 
28
34
  1. 使用插件根相对路径运行 CLI:`CLI="node ${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs"`
29
35
  2. 配置含 `releaseDocuments` 时,先运行只读演练 `${CLI} docs refresh --unit <id> --json`;`status: "changes"` 时展示逐文件路径/语种/版本/`refreshDigest`,取得"本地发布文档写入"明确授权后才执行 `nextCommand.argv` 写入,审阅并提交刷新结果后再继续;`status: "clean"` 时直接进入 prepare
30
- 3. 运行 `${CLI} prepare --root <path> --offline --json`
36
+ 3. 运行 `${CLI} prepare --root <path> --offline --json`;用户已明确选择范围时,为每个单元追加一个 `--unit <id>`
31
37
  4. 检查 exit code 0,读取 JSON 返回的 immutable `planPath=plans/<planDigest>.json`,再从该文件读取 `status`、`units`、`externalActions`
32
38
  5. 向用户展示可读的 `approvalSummary`:版本、公开仓库、分支策略、branch/tag、npm 与 GitHub Release 目标、全部外部动作、例外,以及需要独立 checkpoint 批准的 postPublish hook。`planDigest` 仅作为内部绑定字段,不要求用户复制或确认。后续 approve/publish 只能使用该 immutable planPath,等待确认后再 approve。计划批准不包含受限 postPublish hook 的 checkpoint 批准
33
39
 
@@ -62,6 +68,9 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> --js
62
68
  node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
63
69
  --write --confirm-refresh <refreshDigest> --ack-local-document-write --json
64
70
  node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --offline --json
71
+ # 显式选择发布范围;未传 --unit 时仍准备全部配置单元
72
+ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --offline \
73
+ --unit <unit-a> --unit <unit-b> --json
65
74
  # 生产 happy end:bound 基线必须 online;远端目标唯一性仍由 publish 全局预检
66
75
  node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --online --production --json
67
76
  ```
@@ -79,11 +88,12 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --onlin
79
88
  | GATE_FAILED (bound + offline) | 改用 `--online --production`,不得把 unobserved-offline plan 交给 publish |
80
89
  | GATE_FAILED (前序基线漂移) | 先取得并比较实际远端内容;人工选择 merge/adopt/reject。merge/adopt 都必须把接受内容落回 human-owned 权威源,并把 `previousPublicBaseline` 更新为接受状态的精确 repo/ref/commit 后重新 online production prepare;reject 停止调查,禁止改 `mode: none` 绕过 |
81
90
  | GATE_FAILED (`npm-entry-closure`) | 修复打包内容或入口声明后重新 prepare;不得用 `requiredPublicFiles`/`smokeBin` 缺省绕过 |
91
+ | GATE_FAILED(发布范围依赖闭包不完整) | 按详情补齐 `publicSourceAuthorityReceipt` 声明涉及的 coordinator 和全部 subjects,再重新 prepare;不得自动扩选或忽略收据 |
82
92
  | GATE_FAILED (其他) | 修复门失败原因后重试;以 CLI exit code 为准 |
83
93
  | RELEASE_DOCS_STALE | 文档相对说明源已陈旧;按详情运行只读演练,展示文件/语种/版本/摘要,经用户授权“本地发布文档写入”后执行写入,审阅提交再重新 prepare |
84
94
  | RELEASE_DOCS_INVALID / TRANSLATION_MISSING / CONFLICT / REFRESH_STALE | 修复配置/说明源/目标或重新演练取得新 `refreshDigest`;不得扩大写入范围绕过 |
85
95
  | SECRET_DETECTED | 移除密钥并更新 allowlist |
86
- | CONFIG_INVALID | 检查 version.sourcepackage.json |
96
+ | CONFIG_INVALID | 检查 version.sourcepackage.json,以及 `--unit` 是否为空、重复或不在 `releaseUnits[]` 中 |
87
97
 
88
98
  重试时只保留最新结构化错误码和失败门,不沿用早期猜测;重跑确定性命令获得新证据。
89
99
 
@@ -21,16 +21,23 @@ description: "从已批准的生产计划发布冻结 Git branch/tag、npm tarba
21
21
 
22
22
  ## 前置条件:工作流选择
23
23
 
24
- 在运行 `release-publish` 之前,必须先完成快速入门决策路由(§4.3 Workflow Profile Support):
25
-
26
- 1. 使用 `release-skill route --root <path> --json` 确定变更类型
27
- 2. 根据推荐的 `workflowKind` 选择对应路径:
28
- - `docs-only` 先执行 `release-docs` 完整流程
29
- - `config-only` → 先执行 `release-config`,仅在 public surface 变化时进入 publish
30
- - `marketplace-only` 先执行 `release-marketplace`,然后由 workspace exclusive skill 接管
31
- - `full-happy-end` → 直接进入标准完整流程:`prepare → approve → publish → verify`
32
- - `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
33
- - `help` → 无变更,无需 publish
24
+ 调用方持有合法、未过期且绑定当前 production plan approval record 时,
25
+ `release-publish` 直接执行自身的计划、批准、冻结制品身份和远端预检。`route` 只提供
26
+ 工作流建议,不是已批准 production plan 的授权门。
27
+
28
+ 尚未形成计划时,可以先使用 `release-skill route --root <path> --json` 确定变更类型。
29
+ 已知目标版本时一并传入 `--target-version <version>`,使恢复建议只读取与该目标绑定的
30
+ 完整运行血缘。未传目标时,route 仍按 diff/baseline 选择工作流;历史 diagnostics 只作
31
+ 报告,不得覆盖当前建议。
32
+
33
+ 根据推荐的 `workflowKind` 选择对应路径:
34
+
35
+ - `docs-only` → 先执行 `release-docs` 完整流程
36
+ - `config-only` → 先执行 `release-config`,仅在 public surface 变化时进入 publish
37
+ - `marketplace-only` → 先执行 `release-marketplace`,然后由 workspace exclusive skill 接管
38
+ - `full-happy-end` → 直接进入标准完整流程:`prepare → approve → publish → verify`
39
+ - `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
40
+ - `help` → 无变更,无需 publish
34
41
 
35
42
  **注意**: `release-publish` 是标准工作流中的第⑦步,必须在以下步骤之后:
36
43
  - 步骤⑤: `release-prepare` (或轻量级 prepare)
@@ -29,6 +29,8 @@ verify 只接受 `PUBLISHED` 状态的源 run;`VERIFIED` 是终态,不会再
29
29
 
30
30
  验证远端所有自动化 action 的实际状态与冻结计划一致。执行精确 `<package>@<version>` npm 安装到隔离目录,验证包名、版本、静态入口闭包,并在配置时验证 bin 路径安全和 CLI 烟雾输出。对 Claude/Codex marketplace distribution 执行全新隔离消费者安装验证。新计划中的 Kimi/CodeBuddy 安装只返回 `manualFollowUps`,明确标记 `verifiedBySystem: false`,不阻塞 `VERIFIED`;缺少该策略字段的旧冻结计划继续走历史 attestation 兼容路径。
31
31
 
32
+ 0.9.3 的稳定隔离安装树记录只消费宿主命令退出后的隔离树观察:宿主附加 link 记录自身但不跟随,声明载荷 symlink 失败关闭,legacy 全树语义保持不变。该观察属于安装树事实,不替代远端状态、发布计划或 `VERIFIED` 判断。
33
+
32
34
  **attestation 证明力边界**: `attest` 命令记录的旧计划兼容人工证明(`humanConfirmed: true` → `PASSED_MANUAL`)是本地自声明收据,不是签名见证:`--actor` 仅做非空字符串校验,无外部签名或身份核验,任何能运行 CLI 的进程都能自称任意 actor;伪造收据需写 `.release-skill` authority 目录,与直接改写收据文件属同一信任边界。因此旧兼容路径的人工证明只用于旧冻结计划收尾,不构成独立可审计的人工见证。新计划的 Kimi/CodeBuddy 安装一律走 `manualFollowUps`(`verifiedBySystem: false`),不参与 `VERIFIED` 终态判定。
33
35
 
34
36
  **阶段通过规则**: 只有 CLI exit code 0 和结构化状态码 `VERIFIED` 才是完整终态。
@@ -35,6 +35,16 @@ const SAFE_ENV_KEYS = Object.freeze([
35
35
  'SSL_CERT_FILE', 'SSL_CERT_DIR', 'NODE_EXTRA_CA_CERTS',
36
36
  'CLAUDE_CONFIG_DIR', 'CODEX_HOME', 'KIMI_CONFIG_DIR',
37
37
  ]);
38
+ const CODEBUDDY_PLUGIN_LIST_ARGS = Object.freeze(['plugin', 'list', '--json']);
39
+ const CODEBUDDY_MARKETPLACE_LIST_ARGS = Object.freeze(['plugin', 'marketplace', 'list']);
40
+
41
+ function attachFoundationFailure(error, { envelope, stdout }) {
42
+ Object.defineProperties(error, {
43
+ foundationEnvelope: { value: envelope, enumerable: false },
44
+ foundationStdout: { value: stdout, enumerable: false },
45
+ });
46
+ return error;
47
+ }
38
48
 
39
49
  function actionTarget(plan, action, host) {
40
50
  const parameters = action.parameters ?? {};
@@ -259,7 +269,7 @@ async function defaultRun(command, args, options = {}) {
259
269
  watchdogReason: envelope.watchdogReason,
260
270
  ...(envelope.evidence?.spawnError ? { spawnError: envelope.evidence.spawnError } : {}),
261
271
  };
262
- throw error;
272
+ throw attachFoundationFailure(error, { envelope, stdout });
263
273
  }
264
274
  return { stdout, stderr };
265
275
  }, { prefix: 'release-skill-host-command-' });
@@ -303,6 +313,96 @@ function parseJson(stdout, label) {
303
313
  }
304
314
  }
305
315
 
316
+ function foundationEnvelopeFromError(error) {
317
+ return error?.foundationEnvelope ?? null;
318
+ }
319
+
320
+ function foundationStdoutFromError(error) {
321
+ return error?.foundationStdout ?? null;
322
+ }
323
+
324
+ function isCodeBuddyResidualEnvelope(error) {
325
+ const envelope = foundationEnvelopeFromError(error);
326
+ const evidence = envelope?.evidence;
327
+ const signals = evidence?.signalSequence;
328
+ const signal = signals?.[0];
329
+ return envelope?.ok === false
330
+ && envelope.exitStatus === 124
331
+ && envelope.processStatus === 'TERMINATED'
332
+ && envelope.terminationReason === 'child_exit'
333
+ && envelope.watchdogReason === 'residual_process_group'
334
+ && evidence?.childExitCode === 0
335
+ && (evidence.childSignal === null || evidence.childSignal === undefined)
336
+ && evidence.residualGroupCleanupCompleted === true
337
+ && evidence.forcedKill === false
338
+ && evidence.outputLimitExceeded === null
339
+ && Array.isArray(signals)
340
+ && signals.length === 1
341
+ && signal?.signal === 'SIGTERM'
342
+ && signal.requestedMode === 'process_group'
343
+ && signal.successfulMode === 'process_group';
344
+ }
345
+
346
+ function isCodeBuddyReadCommand(target, command, args) {
347
+ return target.host === 'codebuddy'
348
+ && (command === 'codebuddy' || command === 'cbc' || command === CODEBUDDY_MACOS_PATH)
349
+ && Array.isArray(args)
350
+ && (
351
+ args.every((value, index) => value === CODEBUDDY_PLUGIN_LIST_ARGS[index])
352
+ && args.length === CODEBUDDY_PLUGIN_LIST_ARGS.length
353
+ || args.every((value, index) => value === CODEBUDDY_MARKETPLACE_LIST_ARGS[index])
354
+ && args.length === CODEBUDDY_MARKETPLACE_LIST_ARGS.length
355
+ );
356
+ }
357
+
358
+ function isCodeBuddyWriteCommand(target, command, args, kind) {
359
+ if (target.host !== 'codebuddy' || !['codebuddy', 'cbc', CODEBUDDY_MACOS_PATH].includes(command)) return false;
360
+ const expected = kind === 'marketplace-update'
361
+ ? ['plugin', 'marketplace', 'update', target.marketplace]
362
+ : ['plugin', 'update', `${target.plugin}@${target.marketplace}`, '--scope', 'user'];
363
+ return Array.isArray(args) && args.length === expected.length && args.every((value, index) => value === expected[index]);
364
+ }
365
+
366
+ async function runCodeBuddyRead(target, command, args, label, env, run) {
367
+ try {
368
+ return { output: await run(command, [...args], { env }), recovered: false };
369
+ } catch (error) {
370
+ if (!isCodeBuddyReadCommand(target, command, args) || !isCodeBuddyResidualEnvelope(error)) throw error;
371
+ const residualStdout = foundationStdoutFromError(error);
372
+ if (typeof residualStdout !== 'string') throw error;
373
+ parseJson(residualStdout, label);
374
+ return {
375
+ output: { stdout: residualStdout, stderr: '' },
376
+ recovered: true,
377
+ };
378
+ }
379
+ }
380
+
381
+ function exactCodeBuddyMarketplaceObservation(target, stdout) {
382
+ const parsed = parseJson(stdout, `${target.host} marketplace list`);
383
+ if (!Array.isArray(parsed)) throw new Error(`${target.host} marketplace list did not return an array`);
384
+ const matches = parsed.filter((entry) => entry?.name === target.marketplace);
385
+ if (matches.length !== 1) {
386
+ throw new Error(`${target.host} marketplace list did not contain exactly one ${target.marketplace}`);
387
+ }
388
+ if (matches[0].type !== 'git') {
389
+ throw new Error(`${target.host} marketplace ${target.marketplace} is not a git marketplace`);
390
+ }
391
+ return { installed: true, exact: true, found: matches[0] };
392
+ }
393
+
394
+ async function observeCodeBuddyMarketplaceAfterResidual(target, command, env, run) {
395
+ const observed = await runCodeBuddyRead(
396
+ target,
397
+ command,
398
+ CODEBUDDY_MARKETPLACE_LIST_ARGS,
399
+ `${target.host} marketplace list`,
400
+ env,
401
+ run,
402
+ );
403
+ return exactCodeBuddyMarketplaceObservation(target, observed.output.stdout);
404
+ }
405
+
306
406
  function exactPluginObservation(target, stdout) {
307
407
  const selector = `${target.plugin}@${target.marketplace}`;
308
408
  const parsed = parseJson(stdout, `${target.host} plugin list`);
@@ -433,7 +533,10 @@ async function runStructuredUpdate(target, detected, run, {
433
533
  }) {
434
534
  if (target.host === 'codebuddy' || target.host === 'workbuddy') {
435
535
  const env = hostEnvironment(target.host);
436
- const listed = await run(detected.command, ['plugin', 'list', '--json'], { env });
536
+ const listedObservation = target.host === 'codebuddy'
537
+ ? await runCodeBuddyRead(target, detected.command, CODEBUDDY_PLUGIN_LIST_ARGS, `${target.host} plugin list`, env, run)
538
+ : { output: await run(detected.command, [...CODEBUDDY_PLUGIN_LIST_ARGS], { env }), recovered: false };
539
+ const listed = listedObservation.output;
437
540
  const observed = exactPluginObservation(target, listed.stdout);
438
541
  if (
439
542
  target.sourceForm !== 'bundled-family'
@@ -445,7 +548,13 @@ async function runStructuredUpdate(target, detected, run, {
445
548
  reason: `${target.host} source identity is not eligible for a frozen bundled-family update`,
446
549
  };
447
550
  }
448
- if (observed.exact) return { status: 'ALREADY_CURRENT', version: target.version };
551
+ if (observed.exact) {
552
+ return {
553
+ status: 'ALREADY_CURRENT',
554
+ version: target.version,
555
+ ...(listedObservation.recovered ? { residualRecovery: true } : {}),
556
+ };
557
+ }
449
558
  if (!observed.installed) {
450
559
  return {
451
560
  status: 'MANUAL_REQUIRED',
@@ -471,14 +580,51 @@ async function runStructuredUpdate(target, detected, run, {
471
580
  reason: `${target.host} frozen tag and mutable ref do not both resolve to ${target.pluginCommit}`,
472
581
  };
473
582
  }
474
- await run(detected.command, ['plugin', 'marketplace', 'update', target.marketplace], { env });
475
- await run(detected.command, [
476
- 'plugin', 'update', `${target.plugin}@${target.marketplace}`, '--scope', 'user',
477
- ], { env });
478
- const afterList = await run(detected.command, ['plugin', 'list', '--json'], { env });
479
- const after = exactPluginObservation(target, afterList.stdout);
583
+ let marketplaceRecovered = false;
584
+ try {
585
+ await run(detected.command, ['plugin', 'marketplace', 'update', target.marketplace], { env });
586
+ } catch (error) {
587
+ if (!isCodeBuddyWriteCommand(target, detected.command, ['plugin', 'marketplace', 'update', target.marketplace], 'marketplace-update')
588
+ || !isCodeBuddyResidualEnvelope(error)) throw error;
589
+ await observeCodeBuddyMarketplaceAfterResidual(target, detected.command, env, run);
590
+ marketplaceRecovered = true;
591
+ }
592
+ let after;
593
+ let pluginRecovered = false;
594
+ try {
595
+ await run(detected.command, [
596
+ 'plugin', 'update', `${target.plugin}@${target.marketplace}`, '--scope', 'user',
597
+ ], { env });
598
+ } catch (error) {
599
+ if (!isCodeBuddyWriteCommand(target, detected.command, [
600
+ 'plugin', 'update', `${target.plugin}@${target.marketplace}`, '--scope', 'user',
601
+ ], 'plugin-update') || !isCodeBuddyResidualEnvelope(error)) throw error;
602
+ const afterList = await runCodeBuddyRead(
603
+ target,
604
+ detected.command,
605
+ CODEBUDDY_PLUGIN_LIST_ARGS,
606
+ `${target.host} plugin list`,
607
+ env,
608
+ run,
609
+ );
610
+ after = exactPluginObservation(target, afterList.output.stdout);
611
+ pluginRecovered = true;
612
+ }
613
+ if (!pluginRecovered) {
614
+ const afterList = target.host === 'codebuddy'
615
+ ? await runCodeBuddyRead(target, detected.command, CODEBUDDY_PLUGIN_LIST_ARGS, `${target.host} plugin list`, env, run)
616
+ : { output: await run(detected.command, [...CODEBUDDY_PLUGIN_LIST_ARGS], { env }), recovered: false };
617
+ after = exactPluginObservation(target, afterList.output.stdout);
618
+ }
480
619
  if (!after.exact) throw new Error(`${target.host} did not update to the frozen plugin identity`);
481
- return { status: 'UPDATED', version: target.version, restartRequired: true };
620
+ return {
621
+ status: 'UPDATED',
622
+ version: target.version,
623
+ restartRequired: true,
624
+ ...(marketplaceRecovered || listedObservation.recovered || pluginRecovered
625
+ ? { residualRecovery: true }
626
+ : {}),
627
+ };
482
628
  }
483
629
 
484
630
  const command = detected.command;
@@ -566,9 +712,9 @@ expect {
566
712
  timeout { exit 95 }
567
713
  eof { exit 96 }
568
714
  }
569
- expect -re {> $}
715
+ expect -re $promptPattern
570
716
  }
571
- -re {> $} {}
717
+ -re $promptPattern {}
572
718
  timeout { exit 93 }
573
719
  eof { exit 94 }
574
720
  }
@@ -581,8 +727,9 @@ foreach variable {RELEASE_SKILL_KIMI_COMMAND RELEASE_SKILL_KIMI_INSTALL_URL RELE
581
727
  set kimiCommand $env(RELEASE_SKILL_KIMI_COMMAND)
582
728
  set installUrl $env(RELEASE_SKILL_KIMI_INSTALL_URL)
583
729
  set removePlugin $env(RELEASE_SKILL_KIMI_REMOVE_PLUGIN)
730
+ set promptPattern {(?:(?:^|\\r|\\n)> |(?:^|\\r|\\n)(?:\\033\\[[0-9;?]*[ -/]*[@-~])*│[ \\t]*>[ \\t]*│(?:\\033\\[[0-9;?]*[ -/]*[@-~])*)(?![^\\n]|\\n)}
584
731
  spawn $kimiCommand
585
- expect -re {> $}
732
+ expect -re $promptPattern
586
733
  ${removeCommand}send -- "/plugins install $installUrl\\r"
587
734
  expect {
588
735
  -nocase -re {trust and install} {
@@ -595,9 +742,9 @@ expect {
595
742
  timeout { exit 91 }
596
743
  eof { exit 92 }
597
744
  }
598
- expect -re {> $}
745
+ expect -re $promptPattern
599
746
  send -- "/reload\\r"
600
- expect -re {> $}
747
+ expect -re $promptPattern
601
748
  send -- "/exit\\r"
602
749
  expect eof
603
750
  `;
@@ -730,6 +877,12 @@ function aggregateStatus(results) {
730
877
 
731
878
  function failedHostResult(target, error) {
732
879
  const message = error?.message ?? String(error);
880
+ const details = error?.details;
881
+ const publicDetails = details && typeof details === 'object' && !Array.isArray(details)
882
+ ? Object.fromEntries(Object.entries(details).filter(([key]) => (
883
+ key !== 'foundationEnvelope' && key !== 'foundationStdout' && key !== 'foundationStderr'
884
+ )))
885
+ : details;
733
886
  return {
734
887
  host: target.host,
735
888
  unitId: target.unitId,
@@ -737,7 +890,7 @@ function failedHostResult(target, error) {
737
890
  error: message,
738
891
  reason: typeof error?.reason === 'string' ? error.reason : message,
739
892
  ...(error?.code !== undefined ? { code: error.code } : {}),
740
- ...(error?.details !== undefined ? { details: error.details } : {}),
893
+ ...(publicDetails !== undefined ? { details: publicDetails } : {}),
741
894
  };
742
895
  }
743
896