release-skill 0.9.32 → 0.9.34

package/package.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": "广州市风荷科技有限公司"

package/platform-manifest.json

@@ -2,11 +2,11 @@
   "schemaVersion": "1.0.0",
   "platformId": "release-skill",
   "platformName": "release-skill Plugin Platform",
-  "version": "0.9.32",
+  "version": "0.9.34",
   "logicalRoot": "skills-src/",
-  "logicalRootDigest": "a1e30e490fe705ec8c4b1a60597cc30e2d85b136d74100fec0202327333d14d0",
-  "projectionDigest": "38de97ff9a7e11c1e1b3b50b9ab392dfef5312b05271abc7503a482aeefb210c",
-  "projectionId": "release-skill:platform:0.9.32",
+  "logicalRootDigest": "14d6ec1067ce115107d04fa9165d774d8bea711549e2b3f652601d83f6cdd2ae",
+  "projectionDigest": "fce9e9871760b1a6ea47469a463ff1c40502a16197bc24c5fda18c2a9a300e21",
+  "projectionId": "release-skill:platform:0.9.34",
   "manifestRequired": true,
   "projectionSources": {
     "skills-src-root": {

package/references/.render-manifest.json

@@ -6,12 +6,12 @@
       "bytes": 6335
     },
     "01-state-machine.md": {
-      "digest": "85e20f4ba60a833325516b9ced9351f9e324cd7b386460d3fb108b79b8875265",
-      "bytes": 14857
+      "digest": "75a34b3e8bcf196e6ccde20717b8f2aba9eb848a2a6a67aa914e5444f82d6b29",
+      "bytes": 16742
     },
     "02-project-config.md": {
-      "digest": "50f9b775a4864270642b752d040546f6c365f0b49bf1bfe8a3aacefe88eae702",
-      "bytes": 26033
+      "digest": "f0df7c1c22b8e853fc7cefecc8ee963958b2984ecb94416934674c1b95fdf419",
+      "bytes": 33622
     },
     "03-readme-quality.md": {
       "digest": "d74e41052592443ebbd450d0ace5f9b9b19c7a94db50f952b17c1c5a4c5dc230",
@@ -22,8 +22,8 @@
       "bytes": 4682
     },
     "05-evidence-and-errors.md": {
-      "digest": "f1352256e3b9e2c96c1aa6689fa921a909ab41f80832c5a3356a10590b640929",
-      "bytes": 12014
+      "digest": "90a3e7de1cc3edc6cfb55f03b060158db819fe211c0c7a4af41977466fe7f27b",
+      "bytes": 20537
     },
     "06-adapter-contract.md": {
       "digest": "fd58e8a438aaa9a7a4a939ac190dbdd5d11c3fcaca08feaced4a612a6d6dcf3f",

package/references/01-state-machine.md

@@ -102,6 +102,14 @@ postPublish hooks 分两个阶段，各自对应独立的 distribute run：
 外部写入开始后不得缩小范围。任一检查点成功后出现失败，仍进入 PARTIAL，并由
 `reconcile` 在原冻结计划内向前恢复；延期单元需要另行 prepare、审阅和批准。
 
+### 2.4 显式测试接入的同候选续接
+
+声明 `testIntake` 的生产 prepare 不新增状态。首次准备在冻结适用快照和 tarball 后保存一份非正式候选，命令返回 `NEEDS_INPUT`（`GATE_FAILED`，退出码 13）。这一步不写正式计划，不进入 `PREPARED`，也不写 `FROZEN`。
+
+同一候选通过 `prepare --candidate <path>` 续接。适用的预冻结要求核验通过后，才写入正式计划并进入 `PREPARED`。续接使用新的运行目录，不覆盖旧证据，也不再生成第二份候选。对象、配置或权威要求等实质输入变化时拒绝续接，原候选保持不变；只补齐仍绑定该对象的结果不算漂移。
+
+候选不是计划。它不能进入批准或发布，也不能把 `PARTIAL`、`PUBLISHED`、`VERIFIED` 或任何已成功的外部检查点改成完成。`ship` 在接受前保持持久状态 `NEW`，并带上同一个 `testCandidate`。未声明 `testIntake` 的项目仍按原转换进入 `PREPARED`。
+
 ---
 
 ## 3. 禁止转换
@@ -141,6 +149,7 @@ postPublish hooks 分两个阶段，各自对应独立的 distribute run：
 - 系统必须明确列出缺失的输入项、影响范围和可选方案。
 - NEEDS_INPUT 不能被静默转换为 VERIFIED。
 - 用户提供输入后，系统从 DISCOVERED 或 ASSESSED 重新开始。
+- 显式测试接入的 `NEEDS_INPUT` 只补齐同一候选的结果。`ship` 保持 `NEW` 与原 `testCandidate`，不重建候选，也不读取正式 `planPath`。结果满足后，同一次续接才进入 `PREPARED`。
 
 ### 4.2 BLOCKED 处理
 
@@ -160,7 +169,7 @@ postPublish hooks 分两个阶段，各自对应独立的 distribute run：
 
 批准记录绑定到发布计划 hash。以下任何变化均导致批准自动失效：
 
-- 发布计划绑定层内容变化（plan digest 不匹配）。planVersion 2 的 digest 只绑定信任边界：冻结产物身份（git commit/tree、manifestDigest、npm tarball 摘要）、外部动作列表（不含运行时 status）、目标版本、配置摘要、校验门。
+- 发布计划绑定层内容变化（plan digest 不匹配）。planVersion 2 的 digest 只绑定信任边界：冻结产物身份（git commit/tree、manifestDigest、npm tarball 摘要）、外部动作列表（不含运行时 status）、目标版本、配置摘要、校验门。当前计划版本上的可选 `testAcceptance` 属于绑定层，记录层剥离不移除它。替换结果、准则、范围或允许的限制会改变 plan digest，原批准不再适用。不改变这些原件的注释不会使批准失效。没有 `testAcceptance` 的计划保持原绑定范围。planVersion 1 与未声明该字段的 planVersion 2 摘要含义不变。
 - 目标版本变化。
 - 已批准的 action 列表变化。
 
@@ -170,6 +179,8 @@ postPublish hooks 分两个阶段，各自对应独立的 distribute run：
 
 失效后系统回退到 PREPARED 状态，要求重新批准。
 
+approve、publish 和 reconcile 在任何外部动作前复核 `testAcceptance` 指向的要求文件和结果原件。原件缺失或摘要不符时失败关闭，不重新批准，也不重放已经成功的外部检查点。未带 `testAcceptance` 的计划跳过这项复核。
+
 ### 4.5 路由诊断与当前恢复
 
 `route` 负责选择 workflow 和展示 diagnostics，不承担发布授权。传入

package/references/02-project-config.md

@@ -31,6 +31,10 @@ releaseFinish:                   # 可选；仅控制本地发布收尾
   sourceBranchCheck: remind      # remind（缺省）或 skip
   setupSkill: <plugin:skill>     # 可选；已加载目标插件提供的 setup 入口
 
+testIntake:                      # 可选；生产 prepare 才接受。未声明则保持原路径
+  requirementsFile: intake/requirements.json
+  resultFile: intake/result.json
+
 publicSourceAuthorityReceipt:    # 可选；把源码坐标与多个 npm tarball 绑定为公开 Release asset
   coordinatorUnitId: <release-unit-id>
   subjectUnitIds: [<release-unit-id>]
@@ -118,6 +122,22 @@ policy:                     # 可选，安全策略
 
 `distributions: []` 表示该发布单元不生成 npm 或插件市场动作，不表示跳过公开发布。
 
+### 2.0 显式测试接入
+
+`testIntake` 可选。只含两个项目相对普通文件路径：`requirementsFile` 与 `resultFile`。两者归一化后必须不同；`a/./b` 与 `a/b` 视为同一路径。未知字段、绝对路径、`..` 和结尾斜杠在配置加载时拒绝。
+
+未声明 `testIntake` 的项目保持原有 hook、完整门、缓存和发布路径，不因此增加 TEST、Graph 或 Registry 依赖。`--test-selection incremental` 仍在冻结时拒绝。
+
+声明之后只允许生产 `prepare`。非生产 prepare 返回 `CONFIG_INVALID`，原因 `TEST_INTAKE_NON_PRODUCTION`。assess 等其他命令仍可加载这份配置。docs、config、marketplace 轻量工作流、`selectedUnits` 和无需发布的配置分支都不免除项目级要求：未选中单元的单元级要求可以不进入本轮，项目级要求始终适用。
+
+要求文件与结果文件的字段以 `schemas/test-intake.schema.json` 为准。release 只核收原件：预冻结项必须有一条可核验结果，处置为 `executed`、`reused`，或由 owner 确认的 `not-applicable`；结论为 `passed`；`acceptedBy` 与声明的 acceptor 一致，`not-applicable` 时与 owner 一致；引用文件可读且摘要一致；结果里的 `subjectDigest` 与 `requirementsSha256` 绑定当前对象。退出码 0、全局 PASS、空证据、`failed` / `incomplete` / `uncovered`、未知字段，或把后续阶段项提前标成完成，都不能通过。未知失败原因保持 `unknown`。安装、加载和业务证据继续分开保存，不合并成一个类别。
+
+首次生产 prepare 生成适用快照和 tarball 后，只保存一份非正式候选 `.release-skill/runs/<run>/test-candidate.json`，返回 `NEEDS_INPUT`（`GATE_FAILED`，退出码 13），并给出 `candidatePath`、`candidateSha256`、`subjectDigest`。此时不写正式计划，也不进入 `PREPARED` 或 `FROZEN`。之后用 `prepare --candidate <path>` 续接：新的运行目录，不覆盖旧运行目录、旧证据或旧候选。结果补齐并核验通过后才写正式计划。对象、配置、权威要求或其他实质输入变化时返回 `TEST_CANDIDATE_REPREPARE`，原候选字节保持不变。只往结果文件补入仍绑定该对象的有效内容，不算输入漂移。
+
+候选不能传给 approve 或 publish，也不能把 `PARTIAL`、`PUBLISHED`、`VERIFIED` 或任何已成功的外部检查点改成完成。`ship` 在接受前保持持久状态 `NEW` 与 `testCandidate`，不重建候选。没有 `testCandidate` 的 `NEW` 记录仍走原来的准备路径。
+
+正式计划上的可选 `testAcceptance` 进入当前计划版本的绑定摘要，记录层剥离不移除它。替换结果、准则、范围或允许的限制会改变 plan digest，原批准不再适用。不改变这些原件的注释不会使批准失效。没有 `testAcceptance` 的计划保持原摘要路径。approve、publish 和 reconcile 在动作前复核绑定原件；原件缺失或被改写时失败关闭，不重新批准，也不重放已经成功的外部检查点。
+
 ### 2.1 本地发布收尾
 
 `releaseFinish` 只控制 `release-finish` 的本地收尾，不改写冻结计划、发布状态或宿主范围。

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

@@ -34,6 +34,34 @@
 | `DIRTY_SOURCE_INPUT` | 源码输入闭包存在未提交变化 | `publicFiles.from` 或 `version.source` 有 staged、unstaged、untracked 变化 | 提交或撤销这些具体输入的变化后重新 prepare；无关 dirty 不受影响 |
 | `BUNDLE_STALE` | bundle 与其源码输入失步（fail-closed 前置门禁） | `bin/release-skill.bundle.mjs` 内嵌的源码摘要与当前 `src/` 摘要不一致，或 bundle/内嵌摘要缺失；在 prepare 加载 config 后的早期阶段检测，任何 workflow 均不可豁免 | 按错误提示在 release-skill 包根运行 `node scripts/build-bundle.mjs`（或 `pnpm build`）重建 bundle 后重新 prepare |
 
+显式测试接入不新增顶层错误码。配置和结构问题仍是 `CONFIG_INVALID`（退出码 10），覆盖和续接问题仍是 `GATE_FAILED`（退出码 13）。稳定原因写在 `details.reason`，未知失败保持 `unknown`，不另造原因。
+
+| `details.reason` | 错误码 | 含义 |
+|---|---|---|
+| `TEST_INTAKE_NON_PRODUCTION` | `CONFIG_INVALID` | 非生产 prepare 声明了 `testIntake` |
+| `TEST_INTAKE_PATH` | `CONFIG_INVALID` | 接入路径不合法，或两个文件归一化后相同 |
+| `TEST_CANDIDATE_WITHOUT_INTAKE` | `CONFIG_INVALID` | 未声明 `testIntake` 却传入候选路径 |
+| `TEST_CANDIDATE_NOT_PLAN` | `GATE_FAILED` | 把候选文件交给 approve 或 publish |
+| `TEST_INTAKE_NEEDS_INPUT` | `GATE_FAILED` | 候选已保存，预冻结结果尚未接受 |
+| `TEST_REQUIREMENT_MISSING` | `GATE_FAILED` | 结果文件或某条适用要求缺失 |
+| `TEST_EVIDENCE_EMPTY` | `GATE_FAILED` | `executed` 或 `reused` 没有可核验证据 |
+| `TEST_ACCEPTOR_MISMATCH` | `GATE_FAILED` | `acceptedBy` 与 acceptor 或 owner 不一致 |
+| `TEST_RESULT_EARLY_PHASE` | `GATE_FAILED` | 后续阶段项在冻结前被标成完成 |
+| `TEST_SUBJECT_MISMATCH` | `GATE_FAILED` | 结果没有绑定当前对象 |
+| `TEST_REQUIREMENTS_DIGEST_MISMATCH` | `GATE_FAILED` | 结果没有绑定当前要求文件 |
+| `TEST_CANDIDATE_REPREPARE` | `GATE_FAILED` | 候选所绑定的实质输入已变化，须重新准备 |
+| `TEST_CANDIDATE_DIGEST_MISMATCH` | `GATE_FAILED` | 候选字节与 ship 记录或证据摘要不一致 |
+| `TEST_CANDIDATE_EVIDENCE_MISSING` | `GATE_FAILED` | 找不到保存候选时的证据摘要 |
+| `TEST_CANDIDATE_CONFIG_CONFLICT` | `GATE_FAILED` | ship 续接时配置摘要已变化 |
+| `TEST_CANDIDATE_UNIT_CONFLICT` | `GATE_FAILED` | ship 续接时单元选择已变化 |
+| `TEST_ACCEPTANCE_MISSING` | `GATE_FAILED` | 计划绑定的原件缺失 |
+| `TEST_ACCEPTANCE_TAMPERED` | `GATE_FAILED` | 计划绑定的原件与摘要不符 |
+| `TEST_ACCEPTANCE_SUBJECT` | `GATE_FAILED` | `testAcceptance.subjectDigest` 与计划对象不一致 |
+| `TEST_ACCEPTANCE_ROOT` | `GATE_FAILED` | 无法从计划路径确定项目根 |
+| `unknown` | `GATE_FAILED` | 失败、未完成或未覆盖，且没有更具体的稳定原因 |
+
+安装证据、加载证据和业务证据继续按原字段分开保存。测试接入不把它们收成一个全局 PASS 或单一证据类别。
+
 **动作状态码** (adapter execute/observe/verify):
 
 - `NO_CHANGE`: 幂等时 payload 无差异，不创建 commit/tag/push。
@@ -205,6 +233,8 @@ v2 的顶层结构封闭（`additionalProperties: false`），只接受 Schema
 
 冻结计划存放在 `.release-skill/plans/<planDigest>.json`；批准记录存放在 `.release-skill/approvals/<planDigest>/<approvalDigest>.json`，均不在运行目录内。
 
+声明 `testIntake` 时，首次生产 prepare 在该次运行目录写入 `test-candidate.json`。它不是正式计划。证据流用 `phase: test-candidate`、`status: saved` 记录这次保存，候选摘要放在 `details.candidateSha256`。续接另开运行目录，不改写这份候选，也不改写当时的证据。正式计划只在接受之后出现。
+
 ### 5.1 文件保留
 
 - 不得手工删除运行证据。生产 prepare 保留 `.release-skill/runs/` 中已有的运行目录，包括封口失败的 prepare 和已经结束的谱系。

package/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/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/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/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/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/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。
 
 **阶段通过规则**: