release-skill 0.9.1 → 0.9.3

package/bin/rules.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "kind": "skill-family.contracts.rules",
-  "contractsVersion": "1.14.0",
+  "contractsVersion": "1.15.0",
   "budget": {
     "firstVersionMax": 20,
     "absoluteMax": 30,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "release-skill",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
   "author": {
     "name": "广州市风荷科技有限公司"
@@ -55,7 +55,7 @@
   "scripts": {
     "build": "node --check src/**/*.mjs && node scripts/build-bundle.mjs",
     "test": "node --test $(ls test/*.test.mjs | grep -v -E 'artifacts-safe-fs-native-seam')",
-    "test:no-dogfood": "node --test $(ls test/*.test.mjs | grep -v -E 'dogfood|artifacts-safe-fs-native-seam|setup-live-samples|reference-configs')",
+    "test:no-dogfood": "node --test $(ls test/*.test.mjs | grep -v -E 'dogfood|artifacts-safe-fs-native-seam|setup-live-samples|reference-configs|readme-contract') && node --test test/readme-contract.test.mjs",
     "test:cli-contract": "node --test test/cli-contract.test.mjs",
     "typecheck": "node --check src/**/*.mjs bin/*.mjs",
     "sync:skills": "node scripts/sync-skills.mjs",
@@ -79,9 +79,9 @@
     "ajv-formats": "3.0.1",
     "libnpmpublish": "11.2.0",
     "npm-registry-fetch": "18.0.2",
-    "skill-family-contracts": "0.14.0",
-    "skill-family-engineering-kit": "0.14.0",
-    "skill-family-harness-node": "0.14.0",
+    "skill-family-contracts": "0.15.0",
+    "skill-family-engineering-kit": "0.15.0",
+    "skill-family-harness-node": "0.15.0",
     "yaml": "2.9.0"
   },
   "devDependencies": {

package/platform-manifest.json

@@ -2,11 +2,11 @@
   "schemaVersion": "1.0.0",
   "platformId": "release-skill",
   "platformName": "release-skill Plugin Platform",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "logicalRoot": "skills-src/",
-  "logicalRootDigest": "428ed8875967a80e989d2712113cf0a0a2f6f8cd9ba510cbe07ba372298c430f",
-  "projectionDigest": "ee43d5a11aa41b122c3d03e67d3a7ad179425d0dcbd2bf7dfec544f184f3ed02",
-  "projectionId": "release-skill:platform:0.9.1",
+  "logicalRootDigest": "be294a1ed865d99841b78b60039136ab28b13ceaedf28570b2fbd91febd1ef65",
+  "projectionDigest": "fbd95e66fe7183c9cfd34eb83fa084e259a00806b3f129734cf866de632723cf",
+  "projectionId": "release-skill:platform:0.9.3",
   "manifestRequired": true,
   "projectionSources": {
     "skills-src-root": {

package/references/01-state-machine.md

@@ -152,7 +152,22 @@ postPublish hooks 分两个阶段，各自对应独立的 distribute run：
 
 失效后系统回退到 PREPARED 状态，要求重新批准。
 
-### 4.5 发布检查点失败
+### 4.5 路由诊断与当前恢复
+
+`route` 负责选择 workflow 和展示 diagnostics，不承担发布授权。传入
+`--target-version <ver>` 时，只有既有校验器确认 `release-run.json`、绑定 plan、摘要
+身份和 lineage 完整，且计划目标等于该版本、仍有未完成动作的记录，才可生成
+`reconcile`、`distribute` 或 `verify` 建议。目录名、mtime、producer 版本、`summary.json`、
+错误文案和旧阶段名只能进入 diagnostics。
+
+未传 target 时，route 始终依据当前 diff/baseline 选择 workflow。历史 `PARTIAL`、
+`DIAGNOSE` 或损坏记录保持可见，但不能把 workflow 改成恢复阶段或诊断入口。多个当前
+有效候选必须保留候选列表并要求明确选择，不生成猜测命令。
+
+这些路由规则不改变状态机的发布门。`publish`、`reconcile` 和 `verify` 仍必须校验
+plan、approval、冻结制品身份、远端状态、检查点和 `PARTIAL` 血缘。
+
+### 4.6 发布检查点失败
 
 发布按以下检查点顺序执行（详见 `06-adapter-contract.md`）：
 

package/references/05-evidence-and-errors.md

@@ -95,7 +95,7 @@ v2 的顶层结构封闭（`additionalProperties: false`），只接受 Schema
 
 ### 2.4 摘要输出
 
-`summary.json` 只是 evidence 的有界诊断投影：它必须可由 `evidence.jsonl` 重建，**不参与发布事实判断**。`route` 等发布判断只消费经过 Schema、摘要与血缘校验的 `release-run.json`；summary 丢失、损坏或被改写不能改变发布状态。
+`summary.json` 只是 evidence 的有界诊断投影：它必须可由 `evidence.jsonl` 重建，**不参与发布事实判断**。`route` 等发布判断只消费经过 Schema、digest/binding、计划和 lineage 校验的 `release-run.json` 与其绑定 plan；summary 丢失、损坏或被改写不能改变发布状态。
 
 每次执行结束时产生一个面向用户的中文摘要，包含：
 
@@ -115,7 +115,7 @@ v2 的顶层结构封闭（`additionalProperties: false`），只接受 Schema
 | `producer` | 生产者名称和版本，只用于归因 |
 | `recoveryActionCode` | 恢复建议码（见下），只供展示；不持久化可执行 shell 命令字符串 |
 
-恢复建议以本次 `readRunRecovery` 对运行、计划、血缘、检查点和批准的校验结果为准，不能只按成功检查点数量判断阶段。冲突、认证未知或批准问题优先诊断；没有证据或旧生产者输入返回 `unknown`。
+恢复建议以本次 `readRunRecovery` 对运行、计划、digest/binding、血缘、检查点和批准的校验结果为准，不能只按成功检查点数量、目录名、mtime、producer 版本、summary 或错误文案判断阶段。显式 target 下，只有计划目标一致且仍有未完成动作的完整校验记录才能生成当前恢复建议；其他版本、无法绑定、legacy 或损坏记录只进入 diagnostics。未传 target 时，route 按 diff/baseline 选择 workflow，历史恢复码只作展示。
 
 0.8.0 候选已接齐恢复建议输出，仍待独立验收，尚未发布。有本次证据且 FAILED 摘要收到明确的领域建议时，顶层采用同一次计算结果。兼容 `details` 和返回错误如保留建议，只镜像同一结果。未提供领域建议时保留原通用回退，无证据时仍为 `unknown`，成功 verify 的 `null` 不得改成重试建议。不得从磁盘摘要或历史 `details` 反向读取授权事实。
 

package/schemas/release-project.schema.json

@@ -791,6 +791,10 @@
           "items": {
             "type": "string"
           }
+        },
+        "preHookPublicSurfaceCheck": {
+          "type": "boolean",
+          "description": "Run the ephemeral public-surface closure gate before declared hooks"
         }
       }
     }

package/schemas/release-run.schema.json

@@ -601,7 +601,47 @@
           "foundationStatus": { "const": "observed" },
           "payloadMatches": { "const": true },
           "observationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
-          "observedAt": { "type": "string", "format": "date-time" }
+          "observedAt": { "type": "string", "format": "date-time" },
+          "extraInstalledPaths": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^(?!/)(?!\\.\\/)(?!.*\\\\)(?!.*:)(?!.*(?:^|/)\\.\\.?(?:/|$))(?!.*\\/\\/)(?!.*\\u0000)(?!.*\\/$).+$"
+            }
+          },
+          "extraInstalledLinks": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["path", "targetBase64", "bytes", "statMode"],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^(?!/)(?!\\.\\/)(?!.*\\\\)(?!.*:)(?!.*(?:^|/)\\.\\.?(?:/|$))(?!.*\\/\\/)(?!.*\\u0000)(?!.*\\/$).+$"
+                },
+                "targetBase64": {
+                  "type": "string",
+                  "minLength": 4,
+                  "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 9007199254740991
+                },
+                "statMode": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 65535
+                }
+              }
+            }
+          }
         }
       }
     },

package/skills/release-config/SKILL.md

@@ -46,7 +46,7 @@ prepare 的真实输出是 plan 内的 `workflowDecision`。
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类；已知目标版本时显式传入，route 只是工作流建议
 2. 若推荐 `workflowKind === 'config-only'`，则使用本技能
 3. 执行步骤②：运行 `release-skill assess --root <path> --offline --json` 进行 schema validation
 4. 执行步骤③：运行 `release-skill prepare --offline --workflow config --target-version <ver> --json`
@@ -61,8 +61,10 @@ prepare 的真实输出是 plan 内的 `workflowDecision`。
 ## 确定性脚本调用
 
 ```bash
-# Step 1: Diff classification confirmation (config-only)
+# Step 1: Diff classification confirmation (config-only; pass the known target)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <path> --target-version <version> --json
 
 # Step 2: Assess with schema validation
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" assess --root <path> --offline --json
@@ -96,7 +98,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" verify \
 | prepare 检测到基线漂移 | BASELINE_DRIFT_DETECTED | 人工审查 drift 后决定是否继续或回滚 |
 | workflowDecision 不可判定（无对比 plan） | indeterminable | fail-safe 到 publish-needed，走场景 B |
 | approval expired | APPROVAL_EXPIRED | 重新执行 approve，digest 必须匹配 |
-| remote conflict at publish | REMOTE_CONFLICT | 人工决策：force override 或 cancel |
+| remote conflict at publish | REMOTE_CONFLICT | 人工决策；不得 force override 或覆盖远端状态 |
 
 ## 决策树 (Step 4)
 

package/skills/release-docs/SKILL.md

@@ -36,7 +36,7 @@ plan 记录 `workflowKind: 'docs'` 与 `workflowDecision`（绑定进 plan diges
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类和工作流推荐
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类和工作流建议；已知目标版本时显式传入，route 不承担发布授权
 2. 若推荐 `workflowKind === 'docs-only'`，则使用本技能
 3. 执行步骤②：调用 `check-style.mjs <doc-path>...` 执行事实/可读性/风格检查
 4. 执行步骤③：调用 `render-public-site.mjs --check [--repo <name>]` 验证渲染无漂移
@@ -49,8 +49,10 @@ plan 记录 `workflowKind: 'docs'` 与 `workflowDecision`（绑定进 plan diges
 ## 确定性脚本调用
 
 ```bash
-# Step 1: Diff classification (from release-skill route)
+# Step 1: Diff classification (from release-skill route; pass the known target)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <path> --target-version <version> --json
 
 # Step 2: Style-guard three gates (check-style.mjs takes file paths only)
 node "${WORKBUDDY_ROOT}/adapters/workbuddy/skills/skill-family-docs-style-guard/scripts/check-style.mjs" \

package/skills/release-finish/SKILL.md

@@ -21,6 +21,7 @@ description: 发布达到 VERIFIED 后处理可选的本地收尾：按发布分
 
 ```bash
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
+  --root <project-root> \
   --plan <plan-path> \
   --run <verified-run-path> \
   --json
@@ -42,6 +43,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 
 ```bash
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
+  --root <project-root> \
   --plan <plan-path> \
   --run <verified-run-path> \
   --update-local-hosts \

package/skills/release-help/SKILL.md

@@ -17,6 +17,12 @@ description: "Discoverable entry point for release-skill: dependency and environ
 - 只读诊断：运行 dry-run 检查，不修改任何文件
 - 故障引导：根据错误码指向对应的修复 Skill
 
+## 0.9.3 候选边界
+
+当前源码候选已接入四项工作流保护、Hook cache v2 和稳定隔离安装树记录。三项 Foundation 依赖精确使用 0.15.0 的公开包根 API。Hook cache 只复用绝对路径或经真实 cwd 校验的 cwd-relative executable identity；裸 PATH、PATHEXT、Windows 和观察不可用时，Hook 仍冷执行，缓存复用失败关闭且不写入 v2 cache。缓存没有 TTL。
+
+稳定隔离安装树记录只在宿主命令退出、目录已隔离且扫描期间没有并发写入时执行；宿主附加链接只记录、不跟随，声明载荷中的 symlink 失败关闭，legacy 全树语义保持不变。0.9.3 仍是源码候选，不能从本说明推断已批准、发布或验证。
+
 **阶段通过规则**: `status` 与 `readiness.localPreparation.status` 只判断本地 help/assess/prepare；其充要条件是 `READY` 且 exit code 为 0。`missingRequired` 列出缺失的 Node/Git。生产发布必须另外读取 `readiness.productionPublish`：缺少 npm/gh 时为 `NOT_READY`，依赖存在时仍是 `AUTH_CHECK_REQUIRED`，因为 help 不访问网络、不验证认证。Agent 无权把本地就绪解释为生产就绪。
 
 **边界**: help 不修改文件系统、不执行外部写操作、不生成发布计划。优先探测 PATH 上的全局安装命令 `release-skill`，不可用时回退到源码路径。每个 unit 必须配置 `previousPublicBaseline`：首次发布且确认无前序版本用 none，已有版本用 bound + repo/ref/commit；none 不是绕过 publish 唯一性预检的开关。v0.1.1 已完成 GitHub/npm 真实生产发布、冻结 Git ref 的 Claude/Codex 消费者安装、精确 npm 安装 smoke 与最终 VERIFIED；生产等价本地协议套件继续覆盖 fake gh/npm/Claude/Codex 和本地 bare Git。测试未做 OS 级禁网，且一次成功发布不能证明其他项目的认证、权限、限流或最终一致性行为；每个项目的首次生产发布仍应作为受监控 canary。
@@ -26,7 +32,7 @@ description: "Discoverable entry point for release-skill: dependency and environ
 1. 使用插件根相对路径运行 CLI：`node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" help --json`
 2. 检查 `readiness.localPreparation`；需要生产发布时再检查 `readiness.productionPublish`
 3. 若环境就绪且缺少 `.release-skill/project.yaml`，先路由 `release-setup`；配置已存在才运行 `release-assess`
-4. 默认在审阅本地计划和快照后停止；只有用户明确要求且完成摘要审批时才路由到 `release-publish`
+4. 默认在审阅本地计划和快照后停止；只有用户明确要求且完成摘要审批时才进入 `release-publish`。已持有合法批准的 production plan 时，publish 自行完成权威校验，不把 route 当作授权门
 
 ## 确定性脚本调用
 
@@ -76,7 +82,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 | CLI 入口不存在 | 确认 `${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs` 存在；不存在时重新安装插件 |
 | 项目配置不存在 | 路由 `release-setup`，默认只读；不得直接生成或覆盖 README/配置 |
 | assess 失败 | 运行 `node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" assess --offline --json` 获取详情 |
-| 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后再路由 `release-publish` |
+| 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后直接调用 `release-publish`，由 publish 自行完成计划、approval、digest、远端冲突和 `PARTIAL` 校验 |
 | RELEASE_DOCS_INVALID | 配置或说明源语义非法（重复键、alias、未知字段、版本漂移等）；修正配置或说明源后重新演练 |
 | RELEASE_DOCS_TRANSLATION_MISSING | 配置语种缺失或多余；补齐说明源语种，与 `releaseDocuments.locales` 完全一致，不得回退 |
 
@@ -85,8 +91,10 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 对于不清楚如何开始的用户，推荐使用 `release-skill route` 命令进行自动化工作流选择：
 
 ```bash
-# 快速分类变更并推荐工作流
+# 快速分类变更并推荐工作流；已知目标版本时显式传入，未知时省略
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> \
+  --target-version <version> --json
 
 # JSON 输出包含 classification 和 recommendation 字段
 {

package/skills/release-marketplace/SKILL.md

@@ -44,7 +44,7 @@ byte、platform manifest 是核心 gate，由 workspace 自己的生成器与
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类；已知目标版本时显式传入，route 只是工作流建议
 2. 若推荐 `workflowKind === 'marketplace-only'`，则使用本技能
 3. 执行步骤②：手动审查并更新 `plugins.mjs`（唯一 truth source）
 4. 执行步骤③：调用 workspace 自己的生成器再生成 `public-snapshot/`
@@ -59,6 +59,8 @@ byte、platform manifest 是核心 gate，由 workspace 自己的生成器与
 # Step 1: Diff classification confirmation (marketplace-only)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
   --root <workspace-root> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <workspace-root> --target-version <version> --json
 
 # Step 2: Manual review and update plugins.mjs
 # Human-in-the-loop: entry is the sole truth source

package/skills/release-prepare/SKILL.md

@@ -13,6 +13,8 @@ description: Freeze an immutable release plan with local configuration, document
 
 运行项目构建/测试 hook，生成公开快照并扫描泄漏，冻结不可变发布计划。prepare 自身不调用发布 adapter，但会执行用户配置的 hook。
 
+0.9.3 候选的 Hook cache v2 只复用有完整身份和输入证据的成功 Hook 结果。裸 PATH、PATHEXT、Windows、TTL、损坏记录或 Foundation 观察不可用时，缓存保持失败关闭，Hook 仍按完整路径冷执行；该机制不改变 prepare 的计划、批准和发布权威。
+
 **Hook 授权契约（配置时刻即授权，FM-16 处置 A）**: hook 是任意本地进程——在 `.release-skill/project.yaml` 中配置 hook 命令即完成授权，构成「配置时刻即授权」的显式契约。hook 不提供沙箱、无文件系统/网络隔离、触发前无确认点，命令调用本身即授权执行已配置的 hook 和 gate，不再设置额外人工授权环节；hook 可能产生项目目录外的副作用或远端写入，配置者须对其内容负责。旧参数 `--acknowledge-hook-side-effects` 和 `--acknowledge-gate-side-effects` 仍可解析，但只作为无效果的兼容输入，不能改变授权或执行语义。恢复「触发前强制确认门」属于后续加固项（属设计变更，需随新版本引入），当前版本不提供该确认门。
 
 **阶段通过规则**: 本阶段的通过只能由 CLI exit code 0 和结构化状态码 `PREPARED` 确认。Agent 无权自行宣布计划冻结成功。

package/skills/release-publish/SKILL.md

@@ -21,16 +21,23 @@ description: "从已批准的生产计划发布冻结 Git branch/tag、npm tarba
 
 ## 前置条件：工作流选择
 
-在运行 `release-publish` 之前，必须先完成快速入门决策路由（§4.3 Workflow Profile Support）：
-
-1. 使用 `release-skill route --root <path> --json` 确定变更类型
-2. 根据推荐的 `workflowKind` 选择对应路径：
-   - `docs-only` → 先执行 `release-docs` 完整流程
-   - `config-only` → 先执行 `release-config`，仅在 public surface 变化时进入 publish
-   - `marketplace-only` → 先执行 `release-marketplace`，然后由 workspace exclusive skill 接管
-   - `full-happy-end` → 直接进入标准完整流程：`prepare → approve → publish → verify`
-   - `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
-   - `help` → 无变更，无需 publish
+调用方持有合法、未过期且绑定当前 production plan 的 approval record 时，
+`release-publish` 直接执行自身的计划、批准、冻结制品身份和远端预检。`route` 只提供
+工作流建议，不是已批准 production plan 的授权门。
+
+尚未形成计划时，可以先使用 `release-skill route --root <path> --json` 确定变更类型。
+已知目标版本时一并传入 `--target-version <version>`，使恢复建议只读取与该目标绑定的
+完整运行血缘。未传目标时，route 仍按 diff/baseline 选择工作流；历史 diagnostics 只作
+报告，不得覆盖当前建议。
+
+根据推荐的 `workflowKind` 选择对应路径：
+
+- `docs-only` → 先执行 `release-docs` 完整流程
+- `config-only` → 先执行 `release-config`，仅在 public surface 变化时进入 publish
+- `marketplace-only` → 先执行 `release-marketplace`，然后由 workspace exclusive skill 接管
+- `full-happy-end` → 直接进入标准完整流程：`prepare → approve → publish → verify`
+- `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
+- `help` → 无变更，无需 publish
 
 **注意**: `release-publish` 是标准工作流中的第⑦步，必须在以下步骤之后：
 - 步骤⑤: `release-prepare` (或轻量级 prepare)

package/skills/release-verify/SKILL.md

@@ -29,6 +29,8 @@ verify 只接受 `PUBLISHED` 状态的源 run；`VERIFIED` 是终态，不会再
 
 验证远端所有自动化 action 的实际状态与冻结计划一致。执行精确 `<package>@<version>` npm 安装到隔离目录，验证包名、版本、静态入口闭包，并在配置时验证 bin 路径安全和 CLI 烟雾输出。对 Claude/Codex marketplace distribution 执行全新隔离消费者安装验证。新计划中的 Kimi/CodeBuddy 安装只返回 `manualFollowUps`，明确标记 `verifiedBySystem: false`，不阻塞 `VERIFIED`；缺少该策略字段的旧冻结计划继续走历史 attestation 兼容路径。
 
+0.9.3 的稳定隔离安装树记录只消费宿主命令退出后的隔离树观察：宿主附加 link 记录自身但不跟随，声明载荷 symlink 失败关闭，legacy 全树语义保持不变。该观察属于安装树事实，不替代远端状态、发布计划或 `VERIFIED` 判断。
+
 **attestation 证明力边界**: `attest` 命令记录的旧计划兼容人工证明（`humanConfirmed: true` → `PASSED_MANUAL`）是本地自声明收据，不是签名见证：`--actor` 仅做非空字符串校验，无外部签名或身份核验，任何能运行 CLI 的进程都能自称任意 actor；伪造收据需写 `.release-skill` authority 目录，与直接改写收据文件属同一信任边界。因此旧兼容路径的人工证明只用于旧冻结计划收尾，不构成独立可审计的人工见证。新计划的 Kimi/CodeBuddy 安装一律走 `manualFollowUps`（`verifiedBySystem: false`），不参与 `VERIFIED` 终态判定。
 
 **阶段通过规则**: 只有 CLI exit code 0 和结构化状态码 `VERIFIED` 才是完整终态。

package/skills-src/release-config/SKILL.md

@@ -46,7 +46,7 @@ prepare 的真实输出是 plan 内的 `workflowDecision`。
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类；已知目标版本时显式传入，route 只是工作流建议
 2. 若推荐 `workflowKind === 'config-only'`，则使用本技能
 3. 执行步骤②：运行 `release-skill assess --root <path> --offline --json` 进行 schema validation
 4. 执行步骤③：运行 `release-skill prepare --offline --workflow config --target-version <ver> --json`
@@ -61,8 +61,10 @@ prepare 的真实输出是 plan 内的 `workflowDecision`。
 ## 确定性脚本调用
 
 ```bash
-# Step 1: Diff classification confirmation (config-only)
+# Step 1: Diff classification confirmation (config-only; pass the known target)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <path> --target-version <version> --json
 
 # Step 2: Assess with schema validation
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" assess --root <path> --offline --json
@@ -96,7 +98,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" verify \
 | prepare 检测到基线漂移 | BASELINE_DRIFT_DETECTED | 人工审查 drift 后决定是否继续或回滚 |
 | workflowDecision 不可判定（无对比 plan） | indeterminable | fail-safe 到 publish-needed，走场景 B |
 | approval expired | APPROVAL_EXPIRED | 重新执行 approve，digest 必须匹配 |
-| remote conflict at publish | REMOTE_CONFLICT | 人工决策：force override 或 cancel |
+| remote conflict at publish | REMOTE_CONFLICT | 人工决策；不得 force override 或覆盖远端状态 |
 
 ## 决策树 (Step 4)
 

package/skills-src/release-docs/SKILL.md

@@ -36,7 +36,7 @@ plan 记录 `workflowKind: 'docs'` 与 `workflowDecision`（绑定进 plan diges
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类和工作流推荐
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类和工作流建议；已知目标版本时显式传入，route 不承担发布授权
 2. 若推荐 `workflowKind === 'docs-only'`，则使用本技能
 3. 执行步骤②：调用 `check-style.mjs <doc-path>...` 执行事实/可读性/风格检查
 4. 执行步骤③：调用 `render-public-site.mjs --check [--repo <name>]` 验证渲染无漂移
@@ -49,8 +49,10 @@ plan 记录 `workflowKind: 'docs'` 与 `workflowDecision`（绑定进 plan diges
 ## 确定性脚本调用
 
 ```bash
-# Step 1: Diff classification (from release-skill route)
+# Step 1: Diff classification (from release-skill route; pass the known target)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <path> --target-version <version> --json
 
 # Step 2: Style-guard three gates (check-style.mjs takes file paths only)
 node "${WORKBUDDY_ROOT}/adapters/workbuddy/skills/skill-family-docs-style-guard/scripts/check-style.mjs" \

package/skills-src/release-finish/SKILL.md

@@ -21,6 +21,7 @@ description: 发布达到 VERIFIED 后处理可选的本地收尾：按发布分
 
 ```bash
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
+  --root <project-root> \
   --plan <plan-path> \
   --run <verified-run-path> \
   --json
@@ -42,6 +43,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 
 ```bash
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
+  --root <project-root> \
   --plan <plan-path> \
   --run <verified-run-path> \
   --update-local-hosts \

package/skills-src/release-help/SKILL.md

@@ -17,6 +17,12 @@ description: "Discoverable entry point for release-skill: dependency and environ
 - 只读诊断：运行 dry-run 检查，不修改任何文件
 - 故障引导：根据错误码指向对应的修复 Skill
 
+## 0.9.3 候选边界
+
+当前源码候选已接入四项工作流保护、Hook cache v2 和稳定隔离安装树记录。三项 Foundation 依赖精确使用 0.15.0 的公开包根 API。Hook cache 只复用绝对路径或经真实 cwd 校验的 cwd-relative executable identity；裸 PATH、PATHEXT、Windows 和观察不可用时，Hook 仍冷执行，缓存复用失败关闭且不写入 v2 cache。缓存没有 TTL。
+
+稳定隔离安装树记录只在宿主命令退出、目录已隔离且扫描期间没有并发写入时执行；宿主附加链接只记录、不跟随，声明载荷中的 symlink 失败关闭，legacy 全树语义保持不变。0.9.3 仍是源码候选，不能从本说明推断已批准、发布或验证。
+
 **阶段通过规则**: `status` 与 `readiness.localPreparation.status` 只判断本地 help/assess/prepare；其充要条件是 `READY` 且 exit code 为 0。`missingRequired` 列出缺失的 Node/Git。生产发布必须另外读取 `readiness.productionPublish`：缺少 npm/gh 时为 `NOT_READY`，依赖存在时仍是 `AUTH_CHECK_REQUIRED`，因为 help 不访问网络、不验证认证。Agent 无权把本地就绪解释为生产就绪。
 
 **边界**: help 不修改文件系统、不执行外部写操作、不生成发布计划。优先探测 PATH 上的全局安装命令 `release-skill`，不可用时回退到源码路径。每个 unit 必须配置 `previousPublicBaseline`：首次发布且确认无前序版本用 none，已有版本用 bound + repo/ref/commit；none 不是绕过 publish 唯一性预检的开关。v0.1.1 已完成 GitHub/npm 真实生产发布、冻结 Git ref 的 Claude/Codex 消费者安装、精确 npm 安装 smoke 与最终 VERIFIED；生产等价本地协议套件继续覆盖 fake gh/npm/Claude/Codex 和本地 bare Git。测试未做 OS 级禁网，且一次成功发布不能证明其他项目的认证、权限、限流或最终一致性行为；每个项目的首次生产发布仍应作为受监控 canary。
@@ -26,7 +32,7 @@ description: "Discoverable entry point for release-skill: dependency and environ
 1. 使用插件根相对路径运行 CLI：`node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" help --json`
 2. 检查 `readiness.localPreparation`；需要生产发布时再检查 `readiness.productionPublish`
 3. 若环境就绪且缺少 `.release-skill/project.yaml`，先路由 `release-setup`；配置已存在才运行 `release-assess`
-4. 默认在审阅本地计划和快照后停止；只有用户明确要求且完成摘要审批时才路由到 `release-publish`
+4. 默认在审阅本地计划和快照后停止；只有用户明确要求且完成摘要审批时才进入 `release-publish`。已持有合法批准的 production plan 时，publish 自行完成权威校验，不把 route 当作授权门
 
 ## 确定性脚本调用
 
@@ -76,7 +82,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 | CLI 入口不存在 | 确认 `${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs` 存在；不存在时重新安装插件 |
 | 项目配置不存在 | 路由 `release-setup`，默认只读；不得直接生成或覆盖 README/配置 |
 | assess 失败 | 运行 `node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" assess --offline --json` 获取详情 |
-| 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后再路由 `release-publish` |
+| 请求生产发布 | 已有公开版本先调用 `release-prepare --online --production` 观察 bound 基线；人工审阅后直接调用 `release-publish`，由 publish 自行完成计划、approval、digest、远端冲突和 `PARTIAL` 校验 |
 | RELEASE_DOCS_INVALID | 配置或说明源语义非法（重复键、alias、未知字段、版本漂移等）；修正配置或说明源后重新演练 |
 | RELEASE_DOCS_TRANSLATION_MISSING | 配置语种缺失或多余；补齐说明源语种，与 `releaseDocuments.locales` 完全一致，不得回退 |
 
@@ -85,8 +91,10 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" docs refresh --unit <id> \
 对于不清楚如何开始的用户，推荐使用 `release-skill route` 命令进行自动化工作流选择：
 
 ```bash
-# 快速分类变更并推荐工作流
+# 快速分类变更并推荐工作流；已知目标版本时显式传入，未知时省略
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route --root <path> \
+  --target-version <version> --json
 
 # JSON 输出包含 classification 和 recommendation 字段
 {

package/skills-src/release-marketplace/SKILL.md

@@ -44,7 +44,7 @@ byte、platform manifest 是核心 gate，由 workspace 自己的生成器与
 
 ## 正向执行路径
 
-1. 运行 `release-skill route --root <path> --json` 获取 diff 分类
+1. 运行 `release-skill route --root <path> [--target-version <ver>] --json` 获取 diff 分类；已知目标版本时显式传入，route 只是工作流建议
 2. 若推荐 `workflowKind === 'marketplace-only'`，则使用本技能
 3. 执行步骤②：手动审查并更新 `plugins.mjs`（唯一 truth source）
 4. 执行步骤③：调用 workspace 自己的生成器再生成 `public-snapshot/`
@@ -59,6 +59,8 @@ byte、platform manifest 是核心 gate，由 workspace 自己的生成器与
 # Step 1: Diff classification confirmation (marketplace-only)
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
   --root <workspace-root> --json
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" route \
+  --root <workspace-root> --target-version <version> --json
 
 # Step 2: Manual review and update plugins.mjs
 # Human-in-the-loop: entry is the sole truth source

package/skills-src/release-prepare/SKILL.md

@@ -13,6 +13,8 @@ description: Freeze an immutable release plan with local configuration, document
 
 运行项目构建/测试 hook，生成公开快照并扫描泄漏，冻结不可变发布计划。prepare 自身不调用发布 adapter，但会执行用户配置的 hook。
 
+0.9.3 候选的 Hook cache v2 只复用有完整身份和输入证据的成功 Hook 结果。裸 PATH、PATHEXT、Windows、TTL、损坏记录或 Foundation 观察不可用时，缓存保持失败关闭，Hook 仍按完整路径冷执行；该机制不改变 prepare 的计划、批准和发布权威。
+
 **Hook 授权契约（配置时刻即授权，FM-16 处置 A）**: hook 是任意本地进程——在 `.release-skill/project.yaml` 中配置 hook 命令即完成授权，构成「配置时刻即授权」的显式契约。hook 不提供沙箱、无文件系统/网络隔离、触发前无确认点，命令调用本身即授权执行已配置的 hook 和 gate，不再设置额外人工授权环节；hook 可能产生项目目录外的副作用或远端写入，配置者须对其内容负责。旧参数 `--acknowledge-hook-side-effects` 和 `--acknowledge-gate-side-effects` 仍可解析，但只作为无效果的兼容输入，不能改变授权或执行语义。恢复「触发前强制确认门」属于后续加固项（属设计变更，需随新版本引入），当前版本不提供该确认门。
 
 **阶段通过规则**: 本阶段的通过只能由 CLI exit code 0 和结构化状态码 `PREPARED` 确认。Agent 无权自行宣布计划冻结成功。

package/skills-src/release-publish/SKILL.md

@@ -21,16 +21,23 @@ description: "从已批准的生产计划发布冻结 Git branch/tag、npm tarba
 
 ## 前置条件：工作流选择
 
-在运行 `release-publish` 之前，必须先完成快速入门决策路由（§4.3 Workflow Profile Support）：
-
-1. 使用 `release-skill route --root <path> --json` 确定变更类型
-2. 根据推荐的 `workflowKind` 选择对应路径：
-   - `docs-only` → 先执行 `release-docs` 完整流程
-   - `config-only` → 先执行 `release-config`，仅在 public surface 变化时进入 publish
-   - `marketplace-only` → 先执行 `release-marketplace`，然后由 workspace exclusive skill 接管
-   - `full-happy-end` → 直接进入标准完整流程：`prepare → approve → publish → verify`
-   - `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
-   - `help` → 无变更，无需 publish
+调用方持有合法、未过期且绑定当前 production plan 的 approval record 时，
+`release-publish` 直接执行自身的计划、批准、冻结制品身份和远端预检。`route` 只提供
+工作流建议，不是已批准 production plan 的授权门。
+
+尚未形成计划时，可以先使用 `release-skill route --root <path> --json` 确定变更类型。
+已知目标版本时一并传入 `--target-version <version>`，使恢复建议只读取与该目标绑定的
+完整运行血缘。未传目标时，route 仍按 diff/baseline 选择工作流；历史 diagnostics 只作
+报告，不得覆盖当前建议。
+
+根据推荐的 `workflowKind` 选择对应路径：
+
+- `docs-only` → 先执行 `release-docs` 完整流程
+- `config-only` → 先执行 `release-config`，仅在 public surface 变化时进入 publish
+- `marketplace-only` → 先执行 `release-marketplace`，然后由 workspace exclusive skill 接管
+- `full-happy-end` → 直接进入标准完整流程：`prepare → approve → publish → verify`
+- `reconcile` → 先执行 `release-reconcile` 恢复 PARTIAL 状态
+- `help` → 无变更，无需 publish
 
 **注意**: `release-publish` 是标准工作流中的第⑦步，必须在以下步骤之后：
 - 步骤⑤: `release-prepare` (或轻量级 prepare)

package/skills-src/release-verify/SKILL.md

@@ -29,6 +29,8 @@ verify 只接受 `PUBLISHED` 状态的源 run；`VERIFIED` 是终态，不会再
 
 验证远端所有自动化 action 的实际状态与冻结计划一致。执行精确 `<package>@<version>` npm 安装到隔离目录，验证包名、版本、静态入口闭包，并在配置时验证 bin 路径安全和 CLI 烟雾输出。对 Claude/Codex marketplace distribution 执行全新隔离消费者安装验证。新计划中的 Kimi/CodeBuddy 安装只返回 `manualFollowUps`，明确标记 `verifiedBySystem: false`，不阻塞 `VERIFIED`；缺少该策略字段的旧冻结计划继续走历史 attestation 兼容路径。
 
+0.9.3 的稳定隔离安装树记录只消费宿主命令退出后的隔离树观察：宿主附加 link 记录自身但不跟随，声明载荷 symlink 失败关闭，legacy 全树语义保持不变。该观察属于安装树事实，不替代远端状态、发布计划或 `VERIFIED` 判断。
+
 **attestation 证明力边界**: `attest` 命令记录的旧计划兼容人工证明（`humanConfirmed: true` → `PASSED_MANUAL`）是本地自声明收据，不是签名见证：`--actor` 仅做非空字符串校验，无外部签名或身份核验，任何能运行 CLI 的进程都能自称任意 actor；伪造收据需写 `.release-skill` authority 目录，与直接改写收据文件属同一信任边界。因此旧兼容路径的人工证明只用于旧冻结计划收尾，不构成独立可审计的人工见证。新计划的 Kimi/CodeBuddy 安装一律走 `manualFollowUps`（`verifiedBySystem: false`），不参与 `VERIFIED` 终态判定。
 
 **阶段通过规则**: 只有 CLI exit code 0 和结构化状态码 `VERIFIED` 才是完整终态。