release-skill 0.9.32 → 0.9.34

package/adapters/claude/schemas/.render-manifest.json

@@ -26,16 +26,20 @@
       "bytes": 1744
     },
     "release-plan.schema.json": {
-      "digest": "3d24cb908cdfbfd5d89551b7c6fed5140f6f1448b9920f114264291ca4cf1c52",
-      "bytes": 55905
+      "digest": "a1e748edeb36b00aa59cbcce893141a30b5c96e75d7fbdbc85b932cde9cc413c",
+      "bytes": 68944
     },
     "release-project.schema.json": {
-      "digest": "b0ba3c46692622f734a80d3f4e3904180bbfd1096ca2d9b6d6fd957917e96f73",
-      "bytes": 47688
+      "digest": "e996238c58067fbe1228ab012da53e8edde1b9d3c8f135d4d5848349f4392148",
+      "bytes": 57111
     },
     "release-run.schema.json": {
       "digest": "4a041b8f6488e7d61b7eb271ebdbc2e043731df41c4437783ef63e77f664c192",
       "bytes": 19002
+    },
+    "test-intake.schema.json": {
+      "digest": "654e91ce518cb2b8aca84947d0c3bb8c4262ab047d86081e7e93dc07a9c6c739",
+      "bytes": 6982
     }
   }
 }

package/adapters/claude/schemas/release-plan.schema.json

@@ -1170,6 +1170,9 @@
         }
       }
     },
+    "testAcceptance": {
+      "$ref": "#/definitions/testAcceptance"
+    },
     "createdAt": {
       "type": "string",
       "format": "date-time"
@@ -1371,6 +1374,58 @@
     }
   },
   "definitions": {
+    "testFileRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*/$).+$"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "anchor": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "testAcceptance": {
+      "type": "object",
+      "description": "Binding-layer acceptance of pre-freeze test requirements. Included in the plan digest. Not a record-layer field.",
+      "additionalProperties": false,
+      "required": [
+        "formatVersion",
+        "subjectDigest",
+        "requirements",
+        "result",
+        "acceptedRequirementIds",
+        "deferredRequirementIds"
+      ],
+      "properties": {
+        "formatVersion": { "const": 1 },
+        "subjectDigest": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "requirements": { "$ref": "#/definitions/testFileRef" },
+        "result": { "$ref": "#/definitions/testFileRef" },
+        "acceptedRequirementIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "deferredRequirementIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
     "verificationGate": {
       "type": "object",
       "required": [
@@ -2221,6 +2276,36 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "production": {
+            "required": ["mode"]
+          }
+        },
+        "required": ["production"]
+      },
+      "then": {
+        "properties": {
+          "units": {
+            "items": {
+              "properties": {
+                "frozenSnapshot": {
+                  "required": [
+                    "gitObjectDir",
+                    "branch",
+                    "branchStrategy",
+                    "commit",
+                    "tree",
+                    "commitTimestamp"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

package/adapters/claude/schemas/release-project.schema.json

@@ -62,6 +62,24 @@
         }
       }
     },
+    "testIntake": {
+      "type": "object",
+      "description": "Optional explicit test intake. When present, both files are required project-relative ordinary paths. Production prepare only. Undeclared projects keep the existing release path.",
+      "additionalProperties": false,
+      "required": ["requirementsFile", "resultFile"],
+      "properties": {
+        "requirementsFile": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*/$).+$"
+        },
+        "resultFile": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*/$).+$"
+        }
+      }
+    },
     "publicSourceAuthorityReceipt": {
       "type": "object",
       "description": "Optional public source-authority receipt uploaded to one coordinator GitHub Release after all subject npm tarballs are frozen.",

package/adapters/claude/schemas/test-intake.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://release-skill.dev/schemas/test-intake/v1",
+  "title": "Release test intake documents",
+  "description": "Requirements, results, candidate, and testAcceptance documents for an explicit testIntake release. Unknown fields are rejected.",
+  "$ref": "#/definitions/candidate",
+  "definitions": {
+    "fileRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*\\\\)(?!.*\\u0000)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*/$).+$"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "anchor": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "source", "criterion", "owner", "scope", "phase", "acceptor"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "source": { "$ref": "#/definitions/fileRef" },
+        "criterion": { "$ref": "#/definitions/fileRef" },
+        "owner": { "type": "string", "minLength": 1 },
+        "scope": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind"],
+              "properties": { "kind": { "const": "project" } }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "unitId"],
+              "properties": {
+                "kind": { "const": "unit" },
+                "unitId": { "type": "string", "minLength": 1 }
+              }
+            }
+          ]
+        },
+        "phase": {
+          "type": "string",
+          "enum": ["pre-freeze", "consumer-verify", "postverify", "finish"]
+        },
+        "acceptor": { "type": "string", "minLength": 1 },
+        "handoff": { "$ref": "#/definitions/handoff" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "phase": { "const": "pre-freeze" } },
+            "required": ["phase"]
+          },
+          "then": { "not": { "required": ["handoff"] } }
+        },
+        {
+          "if": {
+            "properties": { "phase": { "enum": ["consumer-verify", "postverify", "finish"] } },
+            "required": ["phase"]
+          },
+          "then": { "required": ["handoff"] }
+        }
+      ]
+    },
+    "handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["gate", "hook", "finish"] },
+        "id": { "type": "string", "minLength": 1 }
+      }
+    },
+    "requirementsDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["formatVersion", "requirements"],
+      "properties": {
+        "formatVersion": { "const": 1 },
+        "requirements": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/definitions/requirement" }
+        }
+      }
+    },
+    "resultItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requirementId",
+        "disposition",
+        "verdict",
+        "acceptedBy",
+        "decision",
+        "evidence",
+        "applicability",
+        "limitations"
+      ],
+      "properties": {
+        "requirementId": { "type": "string", "minLength": 1 },
+        "disposition": {
+          "type": "string",
+          "enum": ["executed", "reused", "not-applicable", "failed", "incomplete", "uncovered"]
+        },
+        "verdict": {
+          "type": "string",
+          "enum": ["passed", "failed", "not-evaluated"]
+        },
+        "acceptedBy": { "type": "string", "minLength": 1 },
+        "decision": { "$ref": "#/definitions/fileRef" },
+        "evidence": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/fileRef" }
+        },
+        "applicability": { "$ref": "#/definitions/fileRef" },
+        "limitations": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/fileRef" }
+        }
+      }
+    },
+    "resultDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["formatVersion", "subjectDigest", "requirementsSha256", "results"],
+      "properties": {
+        "formatVersion": { "const": 1 },
+        "subjectDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "requirementsSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "results": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/resultItem" }
+        }
+      }
+    },
+    "testAcceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "formatVersion",
+        "subjectDigest",
+        "requirements",
+        "result",
+        "acceptedRequirementIds",
+        "deferredRequirementIds"
+      ],
+      "properties": {
+        "formatVersion": { "const": 1 },
+        "subjectDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "requirements": { "$ref": "#/definitions/fileRef" },
+        "result": { "$ref": "#/definitions/fileRef" },
+        "acceptedRequirementIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "deferredRequirementIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidateVersion", "writerVersion", "prepareOptions", "requirements", "prepared"],
+      "properties": {
+        "candidateVersion": { "const": 1 },
+        "writerVersion": { "type": "string", "minLength": 1 },
+        "prepareOptions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["workflow", "offline", "production", "unitIds", "unitVersions"],
+          "properties": {
+            "workflow": { "type": "string", "enum": ["full", "docs", "config", "marketplace"] },
+            "offline": { "type": "boolean" },
+            "production": { "const": true },
+            "unitIds": {
+              "type": "array",
+              "items": { "type": "string", "minLength": 1 }
+            },
+            "unitVersions": {
+              "type": "object",
+              "additionalProperties": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "requirements": { "$ref": "#/definitions/fileRef" },
+        "prepared": {
+          "type": "object",
+          "properties": {
+            "status": false,
+            "digest": false,
+            "testAcceptance": false
+          }
+        }
+      }
+    }
+  }
+}

package/adapters/claude/skills/release-assess/SKILL.md

@@ -19,6 +19,17 @@ description: "Read-only release governance diagnosis: adoption, project readines
 
 检查请求结束于结构化结果、实际检查范围、未覆盖项和下一入口，不自动继续 prepare。
 
+已配置项目用本技能做增量诊断，不调用 `setup --write` 覆盖。Foundation 建议不是发布批准，也不能替代 `requiredPublicFiles` 或禁路径检查。
+
+## 工程材料角色
+
+只读诊断按现有字段核对四类材料。字段坐标如下：
+
+- 正式可公开资源：`releaseUnits[].publicFiles`。`from` 是仓根相对输入路径，`to` 是冻结快照目标路径。接入评估入口 `setup --assess-adoption` 检查 `from` 是否存在，缺失记为 `PUBLIC_FILE_MISSING`。普通 `assess` 与 `verify-records` 不使用该接入评估码。
+- 必需运行文件：`releaseUnits[].requiredPublicFiles` 是字符串快照目标路径，必须被同一单元 `publicFiles[].to` 精确覆盖。接入评估按 `to` 找到对应 `from`，再检查仓根相对输入是否存在；缺失记为 `REQUIRED_PUBLIC_FILE_MISSING`。该码只属于接入评估。后续 `prepare` 仍使用自身原生错误（例如 `PUBLIC_FILE_MISSING`、`CONFIG_INVALID`），不以接入评估码代替。文档完整性缺口（如 `LICENSE_MISSING`）不能代替该角色。覆盖失败由配置加载以 `CONFIG_INVALID` 失败关闭。
+- 私有正式设计、非正式日志与运行记录：不要写入 `publicFiles`。需要挡住时，用 `policy.forbiddenPaths` / `forbiddenContentPatterns`。`forbiddenPaths` 按快照目标路径配置，不能把源目录名直接当作任意重命名后的禁路径。分类文字本身不会机械识别全部私有内容；未列入映射或禁路径的材料，不因这段说明自动排除。后续 prepare 扫描命中禁路径或禁内容时拒绝。
+- `delivery.include/exclude` 只描述宿主选择，不能当作文件包含或排除。排除策略不得覆盖运行必需资源。
+
 ## 只读边界
 
 治理诊断只运行 release-skill 自身的只读检查程序，不运行目标 Skill、业务脚本或构建，不执行目标 hook，也不调用 `prepare`、`verify` 或 `release-finish`。请求中即使出现 `smokeBin`、`invoke-setup` 或生产发布线索，也不能据此启动对应动作；这些属于另一个产品动作场景。

package/adapters/claude/skills/release-config/SKILL.md

@@ -38,6 +38,12 @@ prepare 的真实输出是 plan 内的 `workflowDecision`。
   - 场景 B：`publishPath === 'publish-needed'`（公开 surface 变化或不可判定）→ 运行
     轻链 (approve→publish→verify)
 
+存量增量只改本轮目标映射。已有合法字段、历史发行记录与精确授权保持不变，不要重建 `.release-skill/project.yaml`。
+
+正式可公开资源写入 `releaseUnits[].publicFiles`：`from` 为仓根相对输入，`to` 为快照目标。必需运行文件写入 `releaseUnits[].requiredPublicFiles`，该项是快照目标路径，必须被同一单元 `publicFiles[].to` 覆盖。私有正式设计与非正式日志不得进入公开映射；需要挡住时，`policy.forbiddenPaths` 按快照目标路径配置，`forbiddenContentPatterns` 按内容扫描。
+
+`delivery.include/exclude` 不是文件包含或排除。排除不得覆盖 `requiredPublicFiles`。互相冲突的配置必须失败关闭。Foundation 建议不能作为发布批准。未经精确批准不产生远端动作。分类文字不会机械识别全部私有内容。接入评估缺失码 `REQUIRED_PUBLIC_FILE_MISSING` 不属于本技能的 prepare 路径；config-only prepare 仍走 `release-prepare` 原生错误。
+
 **授权边界**: 命令调用本身即授权执行配置的 hooks/gates。config-only 工作流的远程写操作受标准 approval 机制约束，不 bypass 安全 gate。
 
 **阶段通过规则**:

package/adapters/claude/skills/release-help/SKILL.md

@@ -29,24 +29,39 @@ description: "Discoverable entry point for release-skill: dependency and environ
 
 治理诊断只运行 release-skill 自己的只读检查程序，不运行目标 Skill、业务脚本、构建、hook 或发布动作，也不把 `prepare`、`verify`、`release-finish` 当作静态治理入口。用户要求实际接入或发布时，把已有授权带到对应原业务入口；各入口继续执行原有确认、副作用和状态机合同。
 
-## 0.9.32 能力与证据边界
+## 0.9.34 能力与证据边界
 
-0.9.32 修复了 Kimi 2.2.0 移除菜单移动后，适配器因等待完整标题而失败的问题。真实终端只重绘变动的菜单行，不重发插件标题，末行也没有换行。适配器在移动后必须先重新观察选中项，确认唯一选中 `Remove plugin` 后才允许提交操作。读取帧前先核实初始精确插件 ID，读完该帧后才发送方向键，再读取完整增量帧并核对唯一选中项，完整标题重绘时仍核对精确 ID。未知、歧义、未移动、帧未完成、timeout、EOF 均导致失败关闭，不继续安装。 移除确认页仍采用 `Remove <displayName> (<id>)?`，包含 Cancel 和 Remove plugin 选项；已选中 `Remove plugin` 时无需方向键。显示名含 Confirm 或 Sure，或标题分块到达，仍核对精确身份，不触发旧宽泛正则路径。
+四类工程材料接到现有 `release-project` 字段。公开正式材料写入 `publicFiles`（`sourceScope` / `from` / `to` / `mode`）。运行必需资源写入 `requiredPublicFiles`，必须被同一单元 `publicFiles[].to` 精确覆盖。私有正式材料与非正式运行材料不列入 `publicFiles`，需要挡住时使用 `forbiddenPaths` / `forbiddenContentPatterns`。正式不等于公开。是否进入公开快照由 `publicFiles` 是否列出决定。npm 是载荷渠道。`package.json` 的 `files` 与入口闭包和公开映射同时约束。`delivery.include` / `delivery.exclude` 只选择宿主，不是文件包含或排除。排除不得拿掉运行必需资源。互相冲突的配置必须失败关闭。
 
-保留 Kimi 0.40.1 的实际确认措辞 `Confirm remove plugin "<id>"?`、括号粘贴与 CSI Enter 输入方式。冻结的安装 URL/ref/sha、安装后 name/version 与载荷核对规则未变。 真实 Kimi 2.2.0 已完成确认前的精确身份、移动及选中项观察，随后按 Esc 取消并退出，未执行移除、安装或更新。47 项聚焦测试通过，独立代码审阅无发现；真实消费者的完整更新与加载验收仍待执行。修复面向真实更新流程，提供方升级不扩大宿主授权，也无需重发原领域插件。
+首次接线使用 `release-setup`。已有 `.release-skill/project.yaml` 返回 `ALREADY_CONFIGURED` / `CONFIG_EXISTS`，不覆盖。存量增量由 `release-assess` 诊断，再由已有 `release-config` Skill 处理。`release-config` 不是新增 CLI。必须先 `route`：实际为 `config-only` 才执行 `prepare --workflow config`；`full-happy-end` 或混合走普通 full。不得无条件触发 `prepare --workflow config`。
+
+`REQUIRED_PUBLIC_FILE_MISSING` 只属于 `setup --assess-adoption`。接入评估按 `requiredPublicFiles` 的快照目标找到对应 `publicFiles[].to`，再检查仓根相对 `from` 是否存在；缺失记该码。普通 `assess` 与 `verify-records` 不使用该码。`prepare` 仍使用自身原生错误，例如 `PUBLIC_FILE_MISSING`、`CONFIG_INVALID`。`LICENSE_MISSING` 不能代替运行必需资源。Foundation 建议不能作为发布批准。
+
+Skill Family Hub 保持统一市场。GitHub Git Data API 机制延续，写入采用 `compare-and-swap` 语义；不自动回滚或覆盖已完成步骤。这是已有机制，不是本轮新实现的 Hub，也不表示已经完成发布。本轮未变更远端写入授权。确认边界、冻结安装 URL/ref/sha、安装后 name/version 与载荷核对规则仍有效。Hub 门禁失败将阻止 GitHub Git Data API 写入。写入绑定已观察的分支头并比较后写入；部分发布不回滚、不覆盖已完成步骤、不自动强推。独立检查点批准、历史冻结计划不重放、`ALREADY_CURRENT` 仍强制执行。
+
+继续采用 Foundation 0.25.0 精确依赖，不能因为邻仓版本较新就升级。空白项目走 `release-setup`；已有配置保留合法字段，用 `release-assess` / `release-config` 做增量。仅禁路径一类的 `config-only` 增量，离线非生产 `prepare` 可为 `PREPARED`，`workflowDecision` 为 `indeterminable` / `publish-needed`，这是合法结果。npm 入口缺失时失败关闭，错误为 `GATE_FAILED` / `npm-entry-closure` / `entry_missing`。旧版独立的 `release-skill` 市场已弃用，使用 `ifoohoo/skill-family-hub` 与 `release-skill@skill-family-hub`。
+
+**0.9.32 历史事实**  
+Kimi 2.2.0 移除菜单移动后，真实终端只重绘变动的菜单行，不重发插件标题，末行也没有换行；适配器曾因等待完整标题失败。适配器在移动后必须先重新观察选中项，确认唯一选中 `Remove plugin` 后才允许提交操作。读取帧前先核实初始精确插件 ID，读完该帧后才发送方向键，再读取完整增量帧并核对唯一选中项，完整标题重绘时仍核对精确 ID。未知、歧义、未移动、帧未完成、timeout、EOF 均导致失败关闭，不继续安装。移除确认页仍采用 `Remove <displayName> (<id>)?`，包含 Cancel 和 Remove plugin 选项；已选中 `Remove plugin` 时无需方向键。显示名含 Confirm 或 Sure，或标题分块到达，仍核对精确身份，不触发旧宽泛正则路径。保留 Kimi 0.40.1 实际确认措辞 `Confirm remove plugin "<id>"?`、括号粘贴与 CSI Enter 输入方式。该修复面向真实更新流程，提供方升级不扩大宿主授权，也无需重发原领域插件。真实 Kimi 2.2.0 已完成确认前的精确身份、移动及选中项观察，随后按 Esc 取消并退出，未执行移除、安装或更新。47 项聚焦测试通过，独立代码审阅无发现；真实消费者的完整更新与加载验收仍待执行。
 
 同一 `unitId/plugin/version` 的共享环境 setup 按单元、插件、版本归并，Claude/Codex 不同物理 `skillFile` 路径不再视为多个 setup 归属。仅需一个已加载宿主的精确 setup 反馈即可满足共享环境检查要求。各宿主的安装、加载及专属配置仍需分别核实，反馈继续绑定 `host/unit/path/plan/config/root`；真正多插件归属仍需消歧，Kimi 失败或其他宿主失败均导致收尾状态为 FAILED，不改变 `VERIFIED`/`DISTRIBUTED` 发布状态。
 
-本版保留 Foundation 0.25.0 精确依赖、可选宿主覆盖诊断输入 `--host-coverage <file>` 与 `--observe-hosts`、Codex 0.154.0 对 11 份真实生成 Skill 的原字节静态检查能力。静态检查不证明安装、会话选择或业务执行通过，批准、发布和验证状态以对应计划、批准及执行记录为准。Qoder 本机更新路径处理维持既有能力，支持 `./adapters/qoder/skills/` 与 `./skills/` 两种布局，仍核对安装 name/version/skills、路径包含性与实际载荷。私有 Hub 的 `RELEASE_SKILL_HUB_RELEASE_EVIDENCE` 环境变量继续要求原始描述符指向的已有普通文件绝对路径（拒绝符号链接），交由 `npm run release:check -- --release-evidence <file>` 验证。实际版本能力不能等同于发布状态或真实宿主验收。
+可选宿主覆盖诊断输入 `--host-coverage <file>` 与 `--observe-hosts`、Codex 0.154.0 对 11 份真实生成 Skill 的原字节静态检查能力未变。静态检查不证明安装、会话选择或业务执行通过，批准、发布和验证状态以对应计划、批准及执行记录为准。
+
+Qoder 本机更新路径处理维持既有能力，支持 `./adapters/qoder/skills/` 与 `./skills/` 两种布局，仍核对安装 name/version/skills、路径包含性与实际载荷。私有 Hub 的 `RELEASE_SKILL_HUB_RELEASE_EVIDENCE` 环境变量继续要求原始描述符指向的已有普通文件绝对路径（拒绝符号链接），交由 `npm run release:check -- --release-evidence <file>` 验证。
 
 在冻结前，`prepare` 或新建 `ship` 状态时可重复传入 `--unit <id>`；未传入则默认选择全部单元。延期单元不进入发布计划，亦不获得发布状态。完整配置、生成物新鲜度检查及顶层 Hook 仍作用于全项目范围。`publicSourceAuthorityReceipt` 的 coordinator 与全部 subjects 必须共同选择。
 
+可选 `testIntake` 只在生产 prepare 生效。首次准备返回 `NEEDS_INPUT` 和一份非正式候选，退出码 13；同一候选用 `prepare --candidate <path>` 续接，接受后才有正式计划。候选不能批准或发布，也不能清除 `PARTIAL`、`PUBLISHED` 或 `VERIFIED`。未声明的项目、原有 hook 和完整门保持不变。轻量工作流和单元选择都不免除项目级要求。非生产 prepare 遇到 `testIntake` 返回 `CONFIG_INVALID`。
+
 冻结后，发布流程（publish、reconcile、verify、distribute）不再接受 `--unit` 参数，仅以 `plan.units` 为唯一有效范围。
 
 每个单元必须声明 `previousPublicBaseline`：只有确认没有前序公开版本时，才使用 `none`；否则必须提供 `bound`，并包含 `repo/ref/commit` 信息。`none` 不绕过 publish 阶段的唯一性预检。
 
 Hook 缓存 v2 仅复用绝对路径，或已通过真实 cwd 核验的 cwd-relative 可执行文件身份；若依赖裸 PATH、PATHEXT、Windows 环境或观察不可用，将触发冷执行并失败关闭。稳定隔离安装树仅在宿主命令退出、目录隔离且扫描期间无并发写入时记录；附加链接仅记录，不跟随；声明载荷中出现 symlink 将导致失败关闭。
 
+实际版本能力不能等同于发布状态或真实宿主验收。
+
 ## 最短路径
 
 1. 从插件根运行 `help --json`，检查本地准备度；生产发布再检查生产准备度。
@@ -103,6 +118,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill-local-finish.mjs" \
 - 项目配置缺失：进入 `release-setup` 的只读发现，不直接生成或覆盖 README/配置。
 - assess 失败：运行 `release-assess` 的离线诊断并按错误码处理。
 - `PARTIAL` 或远端冲突：进入 `release-reconcile`，保留已经成功的 checkpoint。
+- `testIntake` 返回 `NEEDS_INPUT`：停留在给出的候选上补齐结果，再用 `--candidate` 续接。不要把候选文件交给 approve 或 publish。
 - 文档、Cursor、宿主更新或本机收尾失败：转到上节对应专用 Skill，不在 help 中猜测恢复步骤。
 
 ## 后续引导

package/adapters/claude/skills/release-prepare/SKILL.md

@@ -19,8 +19,12 @@ description: Freeze an immutable release plan with local configuration, document
 
 **Hook 授权契约（配置时刻即授权，FM-16 处置 A）**: hook 是任意本地进程——在 `.release-skill/project.yaml` 中配置 hook 命令即完成授权，构成「配置时刻即授权」的显式契约。hook 不提供沙箱、无文件系统/网络隔离、触发前无确认点，命令调用本身即授权执行已配置的 hook 和 gate，不再设置额外人工授权环节；hook 可能产生项目目录外的副作用或远端写入，配置者须对其内容负责。旧参数 `--acknowledge-hook-side-effects` 和 `--acknowledge-gate-side-effects` 仍可解析，但只作为无效果的兼容输入，不能改变授权或执行语义。恢复「触发前强制确认门」属于后续加固项（属设计变更，需随新版本引入），当前版本不提供该确认门。
 
+冻结快照只包含 `publicFiles` 已批准映射。`requiredPublicFiles` 记录快照目标路径，必须在快照中完整存在；对应 `from` 是仓根相对输入。prepare 缺失输入时使用自身原生错误 `PUBLIC_FILE_MISSING` 失败关闭，不以接入评估码 `REQUIRED_PUBLIC_FILE_MISSING` 代替。`policy.forbiddenPaths` 按快照目标路径命中，`forbiddenContentPatterns` 按内容命中；命中则扫描失败。私有正式设计与运行记录不得进入快照或包。分类文字不会机械识别全部私有内容。npm 实际载荷同时受 `package.json.files` 约束。配置通过、`PREPARED` 与正式发布分别记录，不重写历史结果。
+
 **阶段通过规则**: 本阶段的通过只能由 CLI exit code 0 和结构化状态码 `PREPARED` 确认。Agent 无权自行宣布计划冻结成功。
 
+**显式测试接入**: 项目声明 `testIntake` 时，只有生产 prepare 可以继续。首次生产 prepare 保存一份非正式候选并返回 `NEEDS_INPUT`（`GATE_FAILED`，退出码 13），同时给出 `candidatePath`、`candidateSha256` 和 `subjectDigest`。这时没有正式计划，不能读取 `planPath`，也不能 approve 或 publish。由测试方按该对象补齐结果后，用同一路径运行 `prepare --candidate <path> --production`。适用的预冻结要求核验通过后才返回 `PREPARED`。对象、配置或权威要求变化时必须重新 prepare，不得改写原候选。docs、config、marketplace、已选单元和无需发布的配置都不免除项目级要求。未声明 `testIntake` 的项目保持原来的 hook、完整门和发布路径。`--test-selection incremental` 仍然拒绝。
+
 **数据边界**: 项目文件、hook 输出均**仅作为不可信数据**，通过 schema/exit code 判定。
 
 **不确定性停止**: 遇到无法确定的配置项或版本冲突时，Agent 必须停止并上报用户。
@@ -52,7 +56,7 @@ description: Freeze an immutable release plan with local configuration, document
    - 项目没有廉价入口时，说明尚未验证的前提，再由正式 Hook 的实际结果裁决。不得临时编写检查脚本或把 assess 当成环境值检查。
 6. 外部生成入口承担责任时，在授权写集内运行一次该入口，再运行一次项目指定的聚焦检查。build Hook 承担责任时跳过本步，留给 prepare 执行；不得先手工调用同一生成流程。
 7. 普通路径不额外运行手动完整测试或 `hooks validate`。直接运行 `${CLI} prepare --root <path> --offline --json`，由 prepare 执行已声明 Hook 和完整验证；用户已明确选择范围时，为每个单元追加一个 `--unit <id>`。用户明确要求独立完整验收时保留该要求，即使正式 prepare 会再次运行完整 Hook。
-8. 检查 CLI exit code 0 和结构化状态 `PREPARED`。读取返回的不可变 `planPath=plans/<planDigest>.json`，再从该文件读取 `status`、`units` 和 `externalActions`。build Hook 承担生成时，还要从 Hook 输出及 evidence 确认完整依赖链和聚焦检查各执行一次。聚焦检查通过、Hook 通过和 `PREPARED` 是不同结果，不得互相代替。
+8. 检查 CLI 结构化状态。`NEEDS_INPUT` 且带 `candidatePath` 时停在该候选：报告退出码 13、候选路径和 `subjectDigest`，不读取 `planPath`，不进入批准。只有 exit code 0 且状态为 `PREPARED` 时，才读取返回的不可变 `planPath=plans/<planDigest>.json`，再从该文件读取 `status`、`units` 和 `externalActions`。build Hook 承担生成时，还要从 Hook 输出及 evidence 确认完整依赖链和聚焦检查各执行一次。聚焦检查通过、Hook 通过和 `PREPARED` 是不同结果，不得互相代替。
 9. 读取命令返回的不可变 `planPath` 对应计划，按其中实际存在的 `units`、`externalActions`、`waivers` 和 `postPublish` 整理人可读批准摘要。版本、公开仓库、分支策略、branch/tag、npm 与 GitHub Release 目标、全部外部动作、例外，以及需要独立 checkpoint 批准的 postPublish hook，只展示计划里已经写下的值；没有的字段保持缺失，不猜测。prepare 成功时返回不可变 `planPath`、`planDigest` 等字段，批准摘要来自该计划文件。`planDigest` 仅作为内部绑定字段，不要求用户复制或确认。后续 approve/publish 只能使用该 immutable planPath，等待确认后再 approve。计划批准不包含受限 postPublish hook 的 checkpoint 批准。
 
 报告调用次数时，以本轮请求开始到取得结果或停止为计数窗口。分别列出生成命令、聚焦检查、正式 Hook 前提检查和昂贵测试。`prepare` 不是生成命令；一次 Hook 启动也不能证明昂贵测试已经进入测试体。优先使用工具转录、项目夹具输出和 CLI evidence，不能用模型自报替代实际记录。
@@ -101,6 +105,9 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --offli
   --unit <unit-a> --unit <unit-b> --json
 # 生产 happy end：bound 基线必须 online；远端目标唯一性仍由 publish 全局预检
 node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --online --production --json
+# 已声明 testIntake：同一候选补齐结果后续接，不重新生成候选
+node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --online --production \
+  --candidate <candidate-path> --json
 ```
 
 ## 执行顺序
@@ -121,7 +128,9 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" prepare --root <path> --onlin
 | RELEASE_DOCS_STALE | 文档相对说明源已陈旧；按详情运行只读演练，展示文件/语种/版本/摘要，经用户授权“本地发布文档写入”后执行写入，审阅提交再重新 prepare |
 | RELEASE_DOCS_INVALID / TRANSLATION_MISSING / CONFLICT / REFRESH_STALE | 修复配置/说明源/目标或重新演练取得新 `refreshDigest`；不得扩大写入范围绕过 |
 | SECRET_DETECTED | 移除密钥并更新 allowlist |
-| CONFIG_INVALID | 先用 assess 定位结构化配置错误；检查 version.source、package.json、环境白名单是否为合法大写名称，以及 `--unit` 是否为空、重复或不在 `releaseUnits[]` 中。修复须使用已知合法值和明确写入授权 |
+| CONFIG_INVALID | 先用 assess 定位结构化配置错误；检查 version.source、package.json、环境白名单是否为合法大写名称，以及 `--unit` 是否为空、重复或不在 `releaseUnits[]` 中。修复须使用已知合法值和明确写入授权。非生产 prepare 上的 `testIntake` 属于不支持，不要改成生产命令来绕过未授权的发布 |
+| GATE_FAILED (`TEST_INTAKE_NEEDS_INPUT`) | 候选已保存但结果尚未接受。保持该 `candidatePath`，补齐绑定 `subjectDigest` 的结果后，用 `--candidate` 续接。不要把候选交给 approve 或 publish，也不要重建第二份候选 |
+| GATE_FAILED (`TEST_CANDIDATE_REPREPARE`) | 候选绑定的对象、配置或权威要求已变化。保留原候选字节，重新做一次生产 prepare |
 
 ## 后续引导
 

package/adapters/claude/skills/release-setup/SKILL.md

@@ -7,7 +7,7 @@ description: "首次接入 release-skill：只读发现发布单元与个性化
 
 ## 适用场景
 
-项目尚无 `.release-skill/project.yaml`，或用户要求初始化、接入、校准发布规则时使用。配置已存在时只审计并路由到 `release-assess`，不得重新生成。
+项目尚未存在 `.release-skill/project.yaml`，或需初始化、接入、校准发布规则时使用。已有配置只审计并转交至 `release-assess`，不得重新生成。
 
 ## 硬边界
 
@@ -20,6 +20,19 @@ description: "首次接入 release-skill：只读发现发布单元与个性化
 - 写入只允许 create-once（仅创建一次），必须同时提供 answers 与精确 `setupDigest`；无安全原生写入能力时失败关闭。
 - Agent 的多次 shell 调用彼此独立；只能用首轮打印的会话目录绝对路径续接，不得假设变量仍存在。
 
+## 工程材料角色
+
+正式不等于公开。首次只对已确认材料向现有字段提案，不新造配置键，不自动写入。`delivery.include/exclude` 选择宿主，不能决定文件是否进入发布包。
+
+| 材料角色 | 现有字段 | 首次接入约束 |
+|---|---|---|
+| 正式可公开资源 | `releaseUnits[].publicFiles`（`sourceScope/from/to/mode`） | `from` 为仓根相对输入，`to` 为快照目标；仅提案已确认映射，不得自动写入 |
+| 必需运行文件 | `releaseUnits[].requiredPublicFiles` | 快照目标路径须被同一单元 `publicFiles[].to` 覆盖。接入评估按目标找 `from` 再查仓根输入。排除不得拿掉这些资源 |
+| 私有正式设计 | 不列入 `publicFiles`；挡住时用 `policy.forbiddenPaths` | `forbiddenPaths` 按快照目标配置，不得将源目录名误作重命名后的禁路径 |
+| 非正式日志与运行记录 | 不列入 `publicFiles`；使用 `policy.forbiddenPaths` / `forbiddenContentPatterns` | 不进入公开快照或发布包 |
+
+Foundation 建议不构成发布批准。冲突必须失败关闭。分类文字无法机械识别全部私有内容，未配置的材料不会因文字说明自动排除。
+
 ## 首次接入
 
 1. 检查入口：
@@ -108,7 +121,7 @@ node "${CLAUDE_PLUGIN_ROOT}/bin/release-skill.mjs" setup --assess-adoption --roo
 - findings 分四类：`mandatory-gap`（必选缺口，阻断接入）、`satisfied`（已满足）、`optional-suggestion`（可选建议）、`not-applicable`（不适用）；每条带 `code`、`fieldPath`、`evidence` 与 `action`。
 - `gateSuggestions` 只列可执行且尚未登记的配置草案。无法安全形成草案的脚本保留在 `gateDiagnostics`，不计入建议数量，也不把状态改成 `ADOPTED_WITH_SUGGESTIONS`。
 - 建议边界：hook 缓存候选只提示 `cacheInputs` 必须由项目自己声明并证明完整，评估不代猜、不代写；hook 耗时只从描述匹配且生产者可信的 started/completed 事件对推导，`timeoutMs` 不是实际成本；任何建议都不改变接入状态。
-- 必选缺口存在时先修复并重跑 `setup --assess-adoption`，再进入发布流程。
+- 必选缺口存在时须先修复并重跑 `setup --assess-adoption`，再进入发布流程。`REQUIRED_PUBLIC_FILE_MISSING` 表示快照目标对应的仓根相对 `from` 不存在；`LICENSE_MISSING` 不能代替。该码只属于本入口；prepare 用自身原生错误。
 - 覆盖请求在配置缺失或无效时也要出现在报告里，不得把未知或接线不足写成已完成。专业结论使用最终 `status`。
 
 ## publisher 字段与个人片段泄漏策略

package/adapters/claude/skills/release-verify/SKILL.md

@@ -38,6 +38,8 @@ ship state；hook approval 缺失、错误或过期时，在 hook 执行前失
 
 **attestation 证明力边界**: `attest` 命令记录的旧计划兼容人工证明（`humanConfirmed: true` → `PASSED_MANUAL`）是本地自声明收据，不是签名见证：`--actor` 仅做非空字符串校验，无外部签名或身份核验，任何能运行 CLI 的进程都能自称任意 actor；伪造收据需写 `.release-skill` authority 目录，与直接改写收据文件属同一信任边界。因此旧兼容路径的人工证明只用于旧冻结计划收尾，不构成独立可审计的人工见证。新计划的 Kimi/CodeBuddy 安装一律走 `manualFollowUps`（`verifiedBySystem: false`），不参与 `VERIFIED` 终态判定。
 
+本阶段核对已发布渠道的实际载荷。漏失必需文件、禁路径误入、npm 实际遗漏保持失败。`requiredPublicFiles` 是快照目标路径；`forbiddenPaths` 按快照目标核对，不能把源目录名直接当作重命名后的禁路径。未使用渠道不得写成已完成。`VERIFIED`、`PUBLISHED`、配置通过与 `PREPARED` 分别记录，不重写历史结果。分类文字不会机械识别全部私有内容。
+
 **阶段通过规则**: 只有 CLI exit code 0 和结构化状态码 `VERIFIED` 才是完整终态。
 
 **源 run 要求**: `--run` 必需；源 run 的所有 checkpoint 必须为 succeeded 或 skipped。

package/adapters/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "release-skill",
-  "version": "0.9.32",
+  "version": "0.9.34",
   "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
   "author": {
     "name": "广州市风荷科技有限公司"
@@ -19,7 +19,7 @@
     ],
     "defaultPrompt": [
       "Assess this project for release readiness.",
-      "Prepare a release plan for version 0.9.32.",
+      "Prepare a release plan for version 0.9.34.",
       "Help me understand the release workflow."
     ]
   }