release-skill 0.9.18 → 0.9.19

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 (55) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codebuddy-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +2 -2
  4. package/.cursor-plugin/plugin.json +1 -1
  5. package/.kimi-plugin/plugin.json +1 -1
  6. package/.qoder-plugin/plugin.json +1 -1
  7. package/CHANGELOG.md +34 -0
  8. package/INSTALL.md +12 -2
  9. package/INSTALL.zh-CN.md +10 -3
  10. package/README.md +27 -17
  11. package/README.zh-CN.md +19 -17
  12. package/adapters/claude/.claude-plugin/plugin.json +1 -1
  13. package/adapters/claude/bin/release-skill.bundle.mjs +924 -378
  14. package/adapters/claude/skills/release-finish/SKILL.md +30 -4
  15. package/adapters/claude/skills/release-help/SKILL.md +44 -101
  16. package/adapters/claude/skills/release-verify/SKILL.md +2 -2
  17. package/adapters/codex/.codex-plugin/plugin.json +2 -2
  18. package/adapters/codex/bin/release-skill.bundle.mjs +924 -378
  19. package/adapters/codex/skills/release-finish/SKILL.md +30 -4
  20. package/adapters/codex/skills/release-help/SKILL.md +46 -103
  21. package/adapters/codex/skills/release-verify/SKILL.md +2 -2
  22. package/adapters/cursor/.cursor-plugin/plugin.json +1 -1
  23. package/adapters/cursor/bin/release-skill.bundle.mjs +924 -378
  24. package/adapters/cursor/skills/release-finish/SKILL.md +30 -4
  25. package/adapters/cursor/skills/release-help/SKILL.md +46 -103
  26. package/adapters/cursor/skills/release-verify/SKILL.md +2 -2
  27. package/adapters/kimi/.kimi-plugin/plugin.json +1 -1
  28. package/adapters/kimi/bin/release-skill.bundle.mjs +924 -378
  29. package/adapters/kimi/skills/release-finish/SKILL.md +30 -4
  30. package/adapters/kimi/skills/release-help/SKILL.md +46 -103
  31. package/adapters/kimi/skills/release-verify/SKILL.md +2 -2
  32. package/adapters/qoder/.qoder-plugin/plugin.json +1 -1
  33. package/adapters/qoder/bin/release-skill.bundle.mjs +924 -378
  34. package/adapters/qoder/skills/release-finish/SKILL.md +30 -4
  35. package/adapters/qoder/skills/release-help/SKILL.md +46 -103
  36. package/adapters/qoder/skills/release-verify/SKILL.md +2 -2
  37. package/adapters/workbuddy/.codebuddy-plugin/plugin.json +1 -1
  38. package/adapters/workbuddy/bin/release-skill.bundle.mjs +924 -378
  39. package/adapters/workbuddy/skills/release-finish/SKILL.md +30 -4
  40. package/adapters/workbuddy/skills/release-help/SKILL.md +44 -101
  41. package/adapters/workbuddy/skills/release-verify/SKILL.md +2 -2
  42. package/bin/release-skill-cli.mjs +90 -14
  43. package/bin/release-skill.bundle.mjs +924 -378
  44. package/package.json +1 -1
  45. package/platform-manifest.json +4 -4
  46. package/references/02-project-config.md +4 -0
  47. package/skills/release-finish/SKILL.md +30 -4
  48. package/skills/release-help/SKILL.md +44 -101
  49. package/skills/release-verify/SKILL.md +2 -2
  50. package/skills-src/release-finish/SKILL.md +30 -4
  51. package/skills-src/release-help/SKILL.md +44 -101
  52. package/skills-src/release-verify/SKILL.md +2 -2
  53. package/src/commands/post-release-finish.mjs +448 -0
  54. package/src/commands/post-release-local.mjs +22 -2
  55. package/src/commands/ship.mjs +1 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -19,7 +19,7 @@
19
19
  ],
20
20
  "defaultPrompt": [
21
21
  "Assess this project for release readiness.",
22
- "Prepare a release plan for version 0.9.18.",
22
+ "Prepare a release plan for version 0.9.19.",
23
23
  "Help me understand the release workflow."
24
24
  ]
25
25
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"
package/CHANGELOG.md CHANGED
@@ -1,5 +1,39 @@
1
1
  # Changelog
2
2
 
3
+ <!-- release-skill:changelog:start version=0.9.19 locale=en baseline=sha256:e0f2dd2aca0b1ca36bb2a95feded3fb291e176c31357f8ba2d390bed4a10184f -->
4
+ ## [0.9.19] - 2026-09-14
5
+
6
+ 0.9.19 is a local source candidate that completes the verified-release workflow with a deterministic local finish orchestrator. After publication and postVerify, maintainers can use one public entry to select the source branch outcome, update supported hosts, confirm that each host loaded the target plugin, run the configured setup Skill, and verify the source workspace without changing the release status. The three Foundation dependencies remain pinned to the exact 0.21.0 release. This note is not evidence of publication, real-host acceptance, consumer installation verification, or independent acceptance.
7
+
8
+ ### Security
9
+
10
+ - Finish feedback is bound to the current plugin version, project root, selected host, request identity, and execution environment; changing an update decision invalidates earlier setup evidence.
11
+ - No host is considered loaded from filesystem installation alone, and no configured setup is considered complete until its real result is returned through the bound feedback contract.
12
+ - Hub publication remains a compare-and-swap operation. A partial Hub publication is never rolled back or force-pushed automatically.
13
+
14
+ ### Added
15
+
16
+ - The local finish entry now accepts `--finish` and emits an ordered plan for branch handling, host updates, load confirmation, configured setup execution, and final source checks.
17
+ - Bound feedback can resume the same finish operation after real host loading and setup execution; JSON and text output expose the same pending, blocked, and complete decisions.
18
+ - The release-finish Skill documents the end-to-end VERIFIED-to-COMPLETE handoff, including the exact request and feedback boundaries used by an agent.
19
+
20
+ ### Changed
21
+
22
+ - Finish completion is now separate from the release lifecycle: a successful local finish preserves VERIFIED and reports `releaseStatusChanged: false`.
23
+ - The release help entry is shorter and routes specialized publishing, verification, documentation, marketplace, and finish details to their owning Skills.
24
+ - Skill Family Hub remains the central marketplace, and its release entry continues to use the existing GitHub Git Data API after release verification.
25
+
26
+ ### Fixed
27
+
28
+ - Ambiguous setup-plugin selection, missing host candidates, stale setup feedback, and incomplete next-action lists now fail closed instead of producing a false COMPLETE result.
29
+ - Read-only Git observations disable optional index locking and retain exact argv, exit code, stdout, and stderr when a command fails.
30
+
31
+ ### Upgrade Notes
32
+
33
+ Upgrade from 0.9.18 to use the new `post-release --finish` orchestration. Remove the old release-skill standalone marketplace; use the ifoohoo/skill-family-hub repository and Hub-qualified plugin id release-skill@skill-family-hub. Complete the normal publish and postVerify stages first, run the finish entry, perform every requested host load and setup action, then pass the bound feedback file to the same entry until it returns COMPLETE.
34
+ <!-- release-skill:changelog:end version=0.9.19 locale=en -->
35
+
36
+
3
37
  <!-- release-skill:changelog:start version=0.9.18 locale=en baseline=sha256:486d52ac38ecb11f043c79661728004fb1c1593089915741867cdc0f449be275 -->
4
38
  ## [0.9.18] - 2026-09-11
5
39
 
package/INSTALL.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [简体中文](INSTALL.zh-CN.md)
4
4
 
5
- <!-- release-skill:release-version: 0.9.18 -->
5
+ <!-- release-skill:release-version: 0.9.19 -->
6
6
  ## Prerequisites
7
7
 
8
8
  - Node.js 22.0.0 or later
@@ -125,12 +125,22 @@ tag pinned to the exact version (never the bare repository URL, which installs
125
125
  the latest release or default branch), confirm the trust prompt, then reload:
126
126
 
127
127
  ```
128
- /plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.18
128
+ /plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.19
129
129
  /plugins reload
130
130
  ```
131
131
 
132
132
  After the release has reached `VERIFIED`, the optional `release-finish` workflow
133
133
  can perform the same TUI interaction only after explicit user confirmation. It
134
+ starts from the public `release-skill post-release --root <root> --plan <plan> --run
135
+ <postverify-run> --finish` entry. The command reports the fixed merge, host-update,
136
+ host-load, setup, and source-branch steps. A pending load or setup observation
137
+ exits `2`; an operational failure exits `1`; only a fully closed checklist exits
138
+ `0`. Agent-observed host loading and the invoked `release-setup` result return
139
+ through an absolute `--finish-feedback` file bound to the plan digest,
140
+ configuration digest, and project root. An update result alone never proves that
141
+ the host loaded the release.
142
+
143
+ The workflow
134
144
  requires the package name, version, release tag, installed revision, and managed
135
145
  root to match the frozen plan. An exact current installation is checked before
136
146
  returning `ALREADY_CURRENT`. When an installation or migration occurs, the
package/INSTALL.zh-CN.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](INSTALL.md)
4
4
 
5
- <!-- release-skill:release-version: 0.9.18 -->
5
+ <!-- release-skill:release-version: 0.9.19 -->
6
6
  ## 前置条件
7
7
 
8
8
  - Node.js 22.0.0 或更高版本
@@ -113,12 +113,19 @@ release-skill 当前只采用并验证 Kimi Code 的交互式 TUI 路径,**无
113
113
  (切勿使用裸仓库地址,它会安装最新 release 或默认分支),确认信任提示后重新加载:
114
114
 
115
115
  ```
116
- /plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.18
116
+ /plugins install https://github.com/ifoohoo/release-skill/releases/tag/release-skill-v0.9.19
117
117
  /plugins reload
118
118
  ```
119
119
 
120
120
  发布达到 `VERIFIED` 后,可选的 `release-finish` 工作流可以在用户明确同意后执行
121
- 同一套 TUI 操作。包名、版本、发布标签、已安装修订号和受管安装根都必须与冻结计划
121
+ 同一套 TUI 操作。其公共入口是 `release-skill post-release --root <root> --plan <plan>
122
+ --run <postverify-run> --finish`,固定汇总合并、本机宿主更新、宿主加载、setup 和源码
123
+ 分支五步。仍缺加载或 setup 观察时退出码为 `2`,操作失败时为 `1`,只有全部收尾才为
124
+ `0`。智能体观察到的宿主加载结果和实际调用 `release-setup` 的结果,必须通过绝对路径的
125
+ `--finish-feedback` 文件回传,并绑定计划摘要、配置摘要和项目根;更新成功本身不证明新版
126
+ 已经加载。
127
+
128
+ 包名、版本、发布标签、已安装修订号和受管安装根都必须与冻结计划
122
129
  一致。精确当前安装会在返回 `ALREADY_CURRENT` 前核对;发生安装或迁移时,只在操作
123
130
  完成后核对结果。`.git` 目录只提供附加诊断,不是通过条件。发生安装或迁移后,
124
131
  release-finish 会重新读取 Kimi 的受管安装根,不复用操作前的观察;随后核对最终身份与
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [简体中文](README.zh-CN.md) · Installation: [English](INSTALL.md) / [简体中文](INSTALL.zh-CN.md)
4
4
 
5
- <!-- release-skill:release-version: 0.9.18 -->
5
+ <!-- release-skill:release-version: 0.9.19 -->
6
6
  Release preparation for Claude Code, CodeBuddy, WorkBuddy, Codex, and Kimi Code, with human-edited files kept intact.
7
7
 
8
8
  release-skill helps a maintainer answer three questions: what will be released,
@@ -14,40 +14,40 @@ Setup surfaces only the deterministic `compactSummary` review view; the full
14
14
  report stays in a temporary session directory.
15
15
 
16
16
  <!-- release-skill:managed:start id=latest-release -->
17
- **0.9.18** (2026-09-11)
17
+ **0.9.19** (2026-09-14)
18
18
 
19
- 0.9.18 is a local source candidate that adds first-class Cursor packaging, Foundation-backed host verification, and a final local distribution path for Claude, Codex, Kimi, CodeBuddy, WorkBuddy, Qoder, and Cursor. The three Foundation dependencies remain pinned to the exact 0.21.0 release. This note is not evidence of publication, real-host acceptance, consumer installation verification, or independent acceptance.
19
+ 0.9.19 is a local source candidate that completes the verified-release workflow with a deterministic local finish orchestrator. After publication and postVerify, maintainers can use one public entry to select the source branch outcome, update supported hosts, confirm that each host loaded the target plugin, run the configured setup Skill, and verify the source workspace without changing the release status. The three Foundation dependencies remain pinned to the exact 0.21.0 release. This note is not evidence of publication, real-host acceptance, consumer installation verification, or independent acceptance.
20
20
 
21
21
  **Security**
22
22
 
23
- - Cursor must be closed before its plugin tree is scanned or replaced. Failed upgrades preserve or restore a complete old or new directory instead of publishing a mixed tree.
24
- - Host verification receives only caller-declared roots and records mechanism observations separately from release-domain publication and verification state.
23
+ - Finish feedback is bound to the current plugin version, project root, selected host, request identity, and execution environment; changing an update decision invalidates earlier setup evidence.
24
+ - No host is considered loaded from filesystem installation alone, and no configured setup is considered complete until its real result is returned through the bound feedback contract.
25
25
  - Hub publication remains a compare-and-swap operation. A partial Hub publication is never rolled back or force-pushed automatically.
26
26
 
27
27
  **Added**
28
28
 
29
- - The npm package now includes `.cursor-plugin/plugin.json` and a self-contained `adapters/cursor/` projection with all release-skill Skills and runtime resources.
30
- - Release verification can invoke Foundation 0.21.0 host verification with explicit executable and user-state roots, including Cursor project-level plugin verification.
31
- - The final local updater can distribute the verified release to the declared Claude, Codex, Kimi, CodeBuddy, WorkBuddy, Qoder, and Cursor installations.
32
- - Skill Family Hub remains the central marketplace. Its release entry is published through the existing Git Data API after release verification.
29
+ - The local finish entry now accepts `--finish` and emits an ordered plan for branch handling, host updates, load confirmation, configured setup execution, and final source checks.
30
+ - Bound feedback can resume the same finish operation after real host loading and setup execution; JSON and text output expose the same pending, blocked, and complete decisions.
31
+ - The release-finish Skill documents the end-to-end VERIFIED-to-COMPLETE handoff, including the exact request and feedback boundaries used by an agent.
33
32
 
34
33
  **Changed**
35
34
 
36
- - Local host updates verify the frozen snapshot and manifest identity before installation, and Cursor updates use Foundation fixed-set publication for first install and atomic full-directory replacement for upgrades.
37
- - Platform generation, public-file projection, package allowlists, schemas, and release-finish guidance now treat Cursor as a declared host and adapter.
35
+ - Finish completion is now separate from the release lifecycle: a successful local finish preserves VERIFIED and reports `releaseStatusChanged: false`.
36
+ - The release help entry is shorter and routes specialized publishing, verification, documentation, marketplace, and finish details to their owning Skills.
37
+ - Skill Family Hub remains the central marketplace, and its release entry continues to use the existing GitHub Git Data API after release verification.
38
38
 
39
39
  **Fixed**
40
40
 
41
- - Cursor plugin names reject underscores so generated local plugin directories remain compatible with Cursor's manifest requirements.
42
- - The package's native prebuild allowlist and fixed resource-closure checks now include every generated adapter, including Cursor.
41
+ - Ambiguous setup-plugin selection, missing host candidates, stale setup feedback, and incomplete next-action lists now fail closed instead of producing a false COMPLETE result.
42
+ - Read-only Git observations disable optional index locking and retain exact argv, exit code, stdout, and stderr when a command fails.
43
43
 
44
44
  **Upgrade Notes**
45
45
 
46
- Upgrade from 0.9.17 to obtain Cursor packaging and local installation, the Foundation-backed host verification bridge, and the unified seven-host local finish path. Remove the old release-skill standalone marketplace; use the ifoohoo/skill-family-hub repository and Hub-qualified plugin id release-skill@skill-family-hub. Reload each host after updating; an `UPDATED` filesystem result alone does not prove that the running host loaded the new version.
46
+ Upgrade from 0.9.18 to use the new `post-release --finish` orchestration. Remove the old release-skill standalone marketplace; use the ifoohoo/skill-family-hub repository and Hub-qualified plugin id release-skill@skill-family-hub. Complete the normal publish and postVerify stages first, run the finish entry, perform every requested host load and setup action, then pass the bound feedback file to the same entry until it returns COMPLETE.
47
47
  <!-- release-skill:managed:end id=latest-release -->
48
48
 
49
49
  <!-- release-skill:capability:external-write-boundary -->
50
- > **Current boundary:** v0.9.18 is the current source candidate. This README
50
+ > **Current boundary:** v0.9.19 is the current source candidate. This README
51
51
  > records intended scope and verification boundaries; it is not evidence of
52
52
  > publication, consumer-installation verification, or independent acceptance.
53
53
  > Release availability must be established from the corresponding release records
@@ -71,7 +71,7 @@ Upgrade from 0.9.17 to obtain Cursor packaging and local installation, the Found
71
71
  > publish global preflight.
72
72
 
73
73
  <!-- release-skill:capability:safe-first-command -->
74
- > **Production path verified since the v0.1.1 milestone; v0.9.18 is the current
74
+ > **Production path verified since the v0.1.1 milestone; v0.9.19 is the current
75
75
  > source candidate. Its README does not establish publication,
76
76
  > consumer-installation verification, or independent acceptance.**
77
77
  > The npm-installed CLI is the supported user entry. Source checkout
@@ -100,7 +100,7 @@ checkpoints remain intact and use matching-version recovery. Evidence v1 stays
100
100
  read-only; v2 uses a closed top level with phase extensions in `details`.
101
101
  Summaries and recovery suggestions are diagnostic, never publication authority.
102
102
 
103
- The current 0.9.18 candidate includes the narrow R-05 Hook cache v2 consumer
103
+ The current 0.9.19 candidate includes the narrow R-05 Hook cache v2 consumer
104
104
  path, the public `postverify` path, and the stable isolated install-tree record
105
105
  path (A2/A3). It also adds the explicit-input `verify-records` command and a
106
106
  self-contained Qoder projection, first-class Cursor packaging, and the
@@ -577,6 +577,16 @@ a shell command. After host updates, release-finish runs that setup entry
577
577
  against the current release project root passed through `--root`; it does not
578
578
  request a separate project directory. The two settings are independent.
579
579
 
580
+ Use `release-skill post-release --finish` for the complete local finish. It
581
+ always reports merge, host update, actual host loading, setup, and source-branch
582
+ steps. Exit 0 means every applicable step completed or was explicitly skipped;
583
+ exit 2 means caller work remains; exit 1 means a deterministic failure. Pass
584
+ agent observations back through an absolute `--finish-feedback` JSON file bound
585
+ to the reported plan digest, config digest, and canonical project root. Feedback
586
+ is data only: the command does not execute its strings or treat it as new write
587
+ authority. `--skip-local-hosts` explicitly skips host update, loading, and setup
588
+ and cannot be combined with `--hosts` or `--update-local-hosts`.
589
+
580
590
  `distributions` is required but may be an explicit empty array. Use
581
591
  `distributions: []` when release-skill should publish only the unit's GitHub
582
592
  snapshot, tag, and GitHub Release, with no npm publish or marketplace consumer
package/README.zh-CN.md CHANGED
@@ -2,46 +2,46 @@
2
2
 
3
3
  [English](README.md) · 安装指南:[中文](INSTALL.zh-CN.md) / [English](INSTALL.md)
4
4
 
5
- <!-- release-skill:release-version: 0.9.18 -->
5
+ <!-- release-skill:release-version: 0.9.19 -->
6
6
  面向 Claude Code、CodeBuddy、WorkBuddy、Codex 和 Kimi Code 的发布准备工具,完整保留人工维护的文件内容。
7
7
 
8
8
  release-skill 帮助维护者回答三个问题:准备发布什么、还有哪些检查未通过、最终发布的内容是什么。它不重新生成、也不回写项目源文件。`prepare` 把每个配置的公开文件复制到隔离快照并验证字节——先冻结并供人工审阅,再从同一份冻结产物发布。`setup` 只显示确定性的 `compactSummary` 审阅视图,完整报告保留在临时会话目录中。
9
9
 
10
10
  <!-- release-skill:managed:start id=latest-release -->
11
- **0.9.18** (2026-09-11)
11
+ **0.9.19** (2026-09-14)
12
12
 
13
- 0.9.18 是一个本地源码候选。本版本增加 Cursor 的正式打包与分发、基于 Foundation 的宿主核验,以及覆盖 Claude、Codex、Kimi、CodeBuddy、WorkBuddy、Qoder 和 Cursor 的最终本机分发路径。三项 Foundation 依赖继续精确固定在已发布的 0.21.0。本说明不代表已经发布、完成真实宿主验收、完成消费者安装验证或通过独立验收。
13
+ 0.9.19 是一个本地源码候选。本版本补齐已验证发布后的本机收尾编排。发布和 postVerify 完成后,维护者可以通过同一个公共入口决定源码分支去向、更新受支持宿主、确认各宿主实际加载目标插件、运行项目配置的 setup Skill,并检查源码工作区;整个过程不会改写发布状态。三项 Foundation 依赖继续精确固定在已发布的 0.21.0。本说明不代表已经发布、完成真实宿主验收、完成消费者安装验证或通过独立验收。
14
14
 
15
15
  **安全**
16
16
 
17
- - 扫描或替换 Cursor 插件树前必须关闭 Cursor。升级失败时保留或恢复完整的旧目录或新目录,不会发布混合目录。
18
- - 宿主核验只接收调用方声明的根目录,并把机制观察结果与 release-skill 的发布、验证状态分别记录。
17
+ - 收尾反馈绑定当前插件版本、项目根目录、选定宿主、请求身份和运行环境;宿主更新决定变化后,旧 setup 证据自动失效。
18
+ - 仅完成文件安装不能证明宿主已经加载插件;已配置的 setup 也只有在真实结果通过绑定反馈返回后才算完成。
19
19
  - Hub 发布继续绑定已观察的分支头执行比较后写入。部分发布时不回滚、不覆盖已经成功的远端步骤。
20
20
 
21
21
  **新增**
22
22
 
23
- - npm 包新增 `.cursor-plugin/plugin.json` 和自包含的 `adapters/cursor/` 投影,包含 release-skill 的全部 Skill 与运行资源。
24
- - 发布验证可通过显式的可执行文件根目录和用户状态根目录调用 Foundation 0.21.0 宿主核验,其中包括 Cursor 项目级插件核验。
25
- - 最终本机更新入口可以把已验证版本分发到声明的 Claude、Codex、Kimi、CodeBuddy、WorkBuddy、Qoder 和 Cursor 安装位置。
26
- - Skill Family Hub 继续作为中央市场。发布完成验证后,release-skill 通过既有 GitHub Git Data API 更新 Hub 条目。
23
+ - 本机收尾入口新增 `--finish`,按固定顺序给出分支处理、宿主更新、加载确认、setup 执行和源码终检计划。
24
+ - 真实完成宿主加载和 setup 后,可以把绑定反馈交回同一入口继续执行;JSON 与文本输出对待处理、阻断和完成状态给出一致裁决。
25
+ - release-finish Skill 补充从 VERIFIED 到 COMPLETE 的完整交接,并明确智能体执行请求与回传反馈的边界。
27
26
 
28
27
  **变更**
29
28
 
30
- - 本机宿主更新会先核对冻结快照、manifest 身份和版本。Cursor 首次安装使用 Foundation 固定集合发布,升级使用整个目录的原子替换。
31
- - 平台生成、公开文件投影、包内容许可清单、Schema 与 release-finish 指引现在统一把 Cursor 视为正式宿主和适配器。
29
+ - 本机收尾完成与发布生命周期分离:成功结果继续保留 VERIFIED,并明确返回 `releaseStatusChanged: false`。
30
+ - release-help 入口缩短,把发布、验证、文档、市场和收尾细节路由到各自负责的 Skill。
31
+ - Skill Family Hub 继续作为中央市场;发布完成验证后,release-skill 仍通过既有 GitHub Git Data API 更新 Hub 条目。
32
32
 
33
33
  **修复**
34
34
 
35
- - Cursor 插件名不再接受下划线,生成的本机插件目录符合 Cursor manifest 的名称约束。
36
- - npm 包原生预构建许可清单和固定资源闭包检查现已覆盖包括 Cursor 在内的全部生成适配器。
35
+ - setup 插件选择不唯一、没有宿主候选、setup 反馈过期或后续动作缺失时,流程现在会失败关闭,不再错误返回 COMPLETE。
36
+ - 只读 Git 观察关闭可选索引锁;命令失败时保留精确参数、退出码、标准输出和标准错误。
37
37
 
38
38
  **升级说明**
39
39
 
40
- 从 0.9.17 升级后,可获得 Cursor 打包与本机安装、基于 Foundation 的宿主核验桥,以及统一的七宿主本机收尾路径。请移除独立的 `release-skill` 市场,改用 ifoohoo/skill-family-hub 仓库与 Hub 限定插件名 release-skill@skill-family-hub。更新后仍需重新加载各宿主;文件系统返回 `UPDATED` 并不单独证明运行中的宿主已经加载新版。
40
+ 从 0.9.18 升级后可使用新的 `post-release --finish` 编排。请移除独立的 `release-skill` 市场,改用 ifoohoo/skill-family-hub 仓库与 Hub 限定插件名 release-skill@skill-family-hub。先完成正常发布与 postVerify,再运行收尾入口,实际完成其请求的宿主加载和 setup 动作,并把绑定反馈交回同一入口,直至结果为 COMPLETE。
41
41
  <!-- release-skill:managed:end id=latest-release -->
42
42
 
43
43
  <!-- release-skill:capability:external-write-boundary -->
44
- > **当前边界:** v0.9.18 只是当前源码候选。本 README 记录预期范围与验证边界,
44
+ > **当前边界:** v0.9.19 只是当前源码候选。本 README 记录预期范围与验证边界,
45
45
  > 不代表已经发布、完成消费者安装验证或通过独立验收。
46
46
  > 版本可用性以对应发布记录及发布后验证结果为准。
47
47
  > v0.4.1 是更早的已发布里程碑(v0.2.2 曾处于已发布状态,后因平台验证收敛修复而更新)。
@@ -57,7 +57,7 @@ release-skill 帮助维护者回答三个问题:准备发布什么、还有哪
57
57
  > 远端唯一性检查在 `publish` 全局预检执行。
58
58
 
59
59
  <!-- release-skill:capability:safe-first-command -->
60
- > **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.9.18 是当前源码候选,本 README 不证明该候选已经发布、完成消费者安装验证或通过独立验收。**
60
+ > **生产路径自 v0.1.1 里程碑起已完成真实生产验证;v0.9.19 是当前源码候选,本 README 不证明该候选已经发布、完成消费者安装验证或通过独立验收。**
61
61
  > npm 安装的 CLI 是受支持的用户入口;源码 checkout 保留为开发/贡献者路径。
62
62
  >
63
63
  > **第一条命令:**
@@ -75,7 +75,7 @@ marketplace 委托目标工作区发布的边界不变。
75
75
 
76
76
  旧 production 计划缺少 `sourceAuthority` 时,在外部写入前拒绝。未发生外部写入的计划必须重新 prepare 并批准新摘要,不能补写旧计划或迁移批准。已有 `PARTIAL` 保留检查点,走匹配版本的恢复路径。evidence v1 只读;v2 顶层封闭,阶段扩展放在 `details`。摘要和恢复建议只作诊断,不构成发布权威。
77
77
 
78
- 当前 0.9.18 候选包含窄范围的 R-05 Hook cache v2 消费路径、公开 `postverify`
78
+ 当前 0.9.19 候选包含窄范围的 R-05 Hook cache v2 消费路径、公开 `postverify`
79
79
  路径和稳定隔离安装树记录路径(A2/A3),并增加只接受显式输入的 `verify-records`
80
80
  命令、自包含 Qoder 投影、Cursor 正式打包,以及基于 Foundation 的宿主核验桥。
81
81
  Skill Family Hub 仍是唯一市场来源。
@@ -486,6 +486,8 @@ releaseUnits:
486
486
  release-finish 在 `--root` 指定的当前发布项目根目录调用该入口,不再要求另行提供项目目录。
487
487
  两个配置彼此独立。
488
488
 
489
+ 完整的本地收尾使用 `release-skill post-release --finish`。命令固定报告分支决定、宿主更新、实际加载、setup 和源码分支检查:全部适用步骤完成或明确跳过时退出 0,仍有待办时退出 2,确定失败时退出 1。智能体通过绝对路径的 `--finish-feedback` JSON 文件回传观察,文件必须绑定当前计划摘要、配置摘要和规范项目根目录。反馈只作为数据:脚本不执行其中字符串,也不把反馈当成新的写入授权。`--skip-local-hosts` 显示跳过宿主更新、加载和 setup,不得与 `--hosts` 或 `--update-local-hosts` 同时使用。
490
+
489
491
  `distributions` 是必填字段,但可以显式设为空数组。使用
490
492
  `distributions: []` 时,release-skill 只发布该单元的 GitHub 快照、标签和
491
493
  GitHub Release,不生成 npm 发布或市场消费者动作。单元的 `postPublish` 声明仍会
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "release-skill",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
5
5
  "author": {
6
6
  "name": "广州市风荷科技有限公司"