release-skill 0.5.0 → 0.6.0

package/bin/rules.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "release-skill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Safe preparation and frozen GitHub/npm production publishing with full happy end verification",
   "author": {
     "name": "广州市风荷科技有限公司"
@@ -35,6 +35,7 @@
     "adapters/",
     "references/",
     "schemas/",
+    "platform-manifest.json",
     "native/",
     "!native/safe-write/build/",
     "scripts/build-bundle.mjs",
@@ -52,7 +53,7 @@
   ],
   "scripts": {
     "build": "node --check src/**/*.mjs && node scripts/build-bundle.mjs",
-    "test": "node --test test/*.test.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:cli-contract": "node --test test/cli-contract.test.mjs",
     "typecheck": "node --check src/**/*.mjs bin/*.mjs",
@@ -76,8 +77,8 @@
     "ajv-formats": "3.0.1",
     "libnpmpublish": "11.1.0",
     "npm-registry-fetch": "18.0.2",
-    "skill-family-contracts": "0.4.0",
-    "skill-family-harness-node": "0.4.0",
+    "skill-family-contracts": "0.5.0",
+    "skill-family-harness-node": "0.5.0",
     "yaml": "2.9.0"
   },
   "devDependencies": {

package/platform-manifest.json

@@ -0,0 +1,359 @@
+{
+  "schemaVersion": "1.0.0",
+  "platformId": "release-skill",
+  "platformName": "release-skill Plugin Platform",
+  "version": "0.6.0",
+  "logicalRoot": "skills-src/",
+  "logicalRootDigest": "6d504094e1bf7d38beb6d886ff48ea442e7563b6061a7145a14c2d71a60292f5",
+  "projectionDigest": "2ca5c5d0b71e10622911426d3abf9c0dfae72237ee6001d4eaaada90acb7a0d7",
+  "projectionId": "release-skill:platform:0.6.0",
+  "manifestRequired": true,
+  "projectionSources": {
+    "skills-src-root": {
+      "type": "logical-source",
+      "path": "skills-src/",
+      "description": "Unique logical source for all skills. All SKILL.md files and associated resources originate here.",
+      "generator": null,
+      "artifacts": [
+        "skills-src/release-assess/SKILL.md",
+        "skills-src/release-config/SKILL.md",
+        "skills-src/release-docs/SKILL.md",
+        "skills-src/release-help/SKILL.md",
+        "skills-src/release-marketplace/SKILL.md",
+        "skills-src/release-prepare/SKILL.md",
+        "skills-src/release-publish/SKILL.md",
+        "skills-src/release-reconcile/SKILL.md",
+        "skills-src/release-setup/SKILL.md",
+        "skills-src/release-verify/SKILL.md"
+      ]
+    }
+  },
+  "projectedArtifacts": [
+    {
+      "name": "skills-projected",
+      "type": "skill-projection",
+      "targetPath": "skills",
+      "generator": "scripts/sync-skills.mjs",
+      "generatorDescription": "Deterministic sync from skills-src/ to skills/ (SKILL.md byte-identical projection).",
+      "relationship": "projection",
+      "projectionNotes": "skills/ 是 skills-src/ 的逐字节投影，由 sync-skills 产出；修改必须回到 skills-src/。",
+      "artifacts": [
+        "skills/release-assess/SKILL.md",
+        "skills/release-config/SKILL.md",
+        "skills/release-docs/SKILL.md",
+        "skills/release-help/SKILL.md",
+        "skills/release-marketplace/SKILL.md",
+        "skills/release-prepare/SKILL.md",
+        "skills/release-publish/SKILL.md",
+        "skills/release-reconcile/SKILL.md",
+        "skills/release-setup/SKILL.md",
+        "skills/release-verify/SKILL.md"
+      ]
+    },
+    {
+      "name": "adapters-claude-skills",
+      "type": "adapter-skill-projection",
+      "targetPath": "adapters/claude/skills",
+      "generator": "scripts/build-adapters.mjs",
+      "generatorDescription": "Claude 平台适配器投影：由 skills-src/ 经 build-adapters 产出。",
+      "relationship": "projection",
+      "projectionNotes": "adapters/*/skills/ 是各平台适配投影，由 build-adapters 产出；修改必须回到 skills-src/。",
+      "artifacts": [
+        "adapters/claude/skills/release-assess/SKILL.md",
+        "adapters/claude/skills/release-config/SKILL.md",
+        "adapters/claude/skills/release-docs/SKILL.md",
+        "adapters/claude/skills/release-help/SKILL.md",
+        "adapters/claude/skills/release-marketplace/SKILL.md",
+        "adapters/claude/skills/release-prepare/SKILL.md",
+        "adapters/claude/skills/release-publish/SKILL.md",
+        "adapters/claude/skills/release-reconcile/SKILL.md",
+        "adapters/claude/skills/release-setup/SKILL.md",
+        "adapters/claude/skills/release-verify/SKILL.md"
+      ]
+    },
+    {
+      "name": "adapters-codex-skills",
+      "type": "adapter-skill-projection",
+      "targetPath": "adapters/codex/skills",
+      "generator": "scripts/build-adapters.mjs",
+      "generatorDescription": "Codex 平台适配器投影：由 skills-src/ 经 build-adapters 产出。",
+      "relationship": "projection",
+      "projectionNotes": "adapters/*/skills/ 是各平台适配投影，由 build-adapters 产出；修改必须回到 skills-src/。",
+      "artifacts": [
+        "adapters/codex/skills/release-assess/SKILL.md",
+        "adapters/codex/skills/release-config/SKILL.md",
+        "adapters/codex/skills/release-docs/SKILL.md",
+        "adapters/codex/skills/release-help/SKILL.md",
+        "adapters/codex/skills/release-marketplace/SKILL.md",
+        "adapters/codex/skills/release-prepare/SKILL.md",
+        "adapters/codex/skills/release-publish/SKILL.md",
+        "adapters/codex/skills/release-reconcile/SKILL.md",
+        "adapters/codex/skills/release-setup/SKILL.md",
+        "adapters/codex/skills/release-verify/SKILL.md"
+      ]
+    },
+    {
+      "name": "adapters-kimi-skills",
+      "type": "adapter-skill-projection",
+      "targetPath": "adapters/kimi/skills",
+      "generator": "scripts/build-adapters.mjs",
+      "generatorDescription": "Kimi 平台适配器投影：由 skills-src/ 经 build-adapters 产出。",
+      "relationship": "projection",
+      "projectionNotes": "adapters/*/skills/ 是各平台适配投影，由 build-adapters 产出；修改必须回到 skills-src/。",
+      "artifacts": [
+        "adapters/kimi/skills/release-assess/SKILL.md",
+        "adapters/kimi/skills/release-config/SKILL.md",
+        "adapters/kimi/skills/release-docs/SKILL.md",
+        "adapters/kimi/skills/release-help/SKILL.md",
+        "adapters/kimi/skills/release-marketplace/SKILL.md",
+        "adapters/kimi/skills/release-prepare/SKILL.md",
+        "adapters/kimi/skills/release-publish/SKILL.md",
+        "adapters/kimi/skills/release-reconcile/SKILL.md",
+        "adapters/kimi/skills/release-setup/SKILL.md",
+        "adapters/kimi/skills/release-verify/SKILL.md"
+      ]
+    },
+    {
+      "name": "adapters-workbuddy-skills",
+      "type": "adapter-skill-projection",
+      "targetPath": "adapters/workbuddy/skills",
+      "generator": "scripts/build-adapters.mjs",
+      "generatorDescription": "Workbuddy 平台适配器投影（build-only）：由 skills-src/ 经 build-adapters 产出。",
+      "relationship": "projection",
+      "projectionNotes": "adapters/*/skills/ 是各平台适配投影，由 build-adapters 产出；修改必须回到 skills-src/。",
+      "artifacts": [
+        "adapters/workbuddy/skills/release-assess/SKILL.md",
+        "adapters/workbuddy/skills/release-config/SKILL.md",
+        "adapters/workbuddy/skills/release-docs/SKILL.md",
+        "adapters/workbuddy/skills/release-help/SKILL.md",
+        "adapters/workbuddy/skills/release-marketplace/SKILL.md",
+        "adapters/workbuddy/skills/release-prepare/SKILL.md",
+        "adapters/workbuddy/skills/release-publish/SKILL.md",
+        "adapters/workbuddy/skills/release-reconcile/SKILL.md",
+        "adapters/workbuddy/skills/release-setup/SKILL.md",
+        "adapters/workbuddy/skills/release-verify/SKILL.md"
+      ]
+    }
+  ],
+  "logicalMappings": [
+    {
+      "logicalName": "release-assess",
+      "path": "adapters/claude/skills/release-assess/SKILL.md"
+    },
+    {
+      "logicalName": "release-assess",
+      "path": "adapters/codex/skills/release-assess/SKILL.md"
+    },
+    {
+      "logicalName": "release-assess",
+      "path": "adapters/kimi/skills/release-assess/SKILL.md"
+    },
+    {
+      "logicalName": "release-assess",
+      "path": "adapters/workbuddy/skills/release-assess/SKILL.md"
+    },
+    {
+      "logicalName": "release-assess",
+      "path": "skills/release-assess/SKILL.md"
+    },
+    {
+      "logicalName": "release-config",
+      "path": "adapters/claude/skills/release-config/SKILL.md"
+    },
+    {
+      "logicalName": "release-config",
+      "path": "adapters/codex/skills/release-config/SKILL.md"
+    },
+    {
+      "logicalName": "release-config",
+      "path": "adapters/kimi/skills/release-config/SKILL.md"
+    },
+    {
+      "logicalName": "release-config",
+      "path": "adapters/workbuddy/skills/release-config/SKILL.md"
+    },
+    {
+      "logicalName": "release-config",
+      "path": "skills/release-config/SKILL.md"
+    },
+    {
+      "logicalName": "release-docs",
+      "path": "adapters/claude/skills/release-docs/SKILL.md"
+    },
+    {
+      "logicalName": "release-docs",
+      "path": "adapters/codex/skills/release-docs/SKILL.md"
+    },
+    {
+      "logicalName": "release-docs",
+      "path": "adapters/kimi/skills/release-docs/SKILL.md"
+    },
+    {
+      "logicalName": "release-docs",
+      "path": "adapters/workbuddy/skills/release-docs/SKILL.md"
+    },
+    {
+      "logicalName": "release-docs",
+      "path": "skills/release-docs/SKILL.md"
+    },
+    {
+      "logicalName": "release-help",
+      "path": "adapters/claude/skills/release-help/SKILL.md"
+    },
+    {
+      "logicalName": "release-help",
+      "path": "adapters/codex/skills/release-help/SKILL.md"
+    },
+    {
+      "logicalName": "release-help",
+      "path": "adapters/kimi/skills/release-help/SKILL.md"
+    },
+    {
+      "logicalName": "release-help",
+      "path": "adapters/workbuddy/skills/release-help/SKILL.md"
+    },
+    {
+      "logicalName": "release-help",
+      "path": "skills/release-help/SKILL.md"
+    },
+    {
+      "logicalName": "release-marketplace",
+      "path": "adapters/claude/skills/release-marketplace/SKILL.md"
+    },
+    {
+      "logicalName": "release-marketplace",
+      "path": "adapters/codex/skills/release-marketplace/SKILL.md"
+    },
+    {
+      "logicalName": "release-marketplace",
+      "path": "adapters/kimi/skills/release-marketplace/SKILL.md"
+    },
+    {
+      "logicalName": "release-marketplace",
+      "path": "adapters/workbuddy/skills/release-marketplace/SKILL.md"
+    },
+    {
+      "logicalName": "release-marketplace",
+      "path": "skills/release-marketplace/SKILL.md"
+    },
+    {
+      "logicalName": "release-prepare",
+      "path": "adapters/claude/skills/release-prepare/SKILL.md"
+    },
+    {
+      "logicalName": "release-prepare",
+      "path": "adapters/codex/skills/release-prepare/SKILL.md"
+    },
+    {
+      "logicalName": "release-prepare",
+      "path": "adapters/kimi/skills/release-prepare/SKILL.md"
+    },
+    {
+      "logicalName": "release-prepare",
+      "path": "adapters/workbuddy/skills/release-prepare/SKILL.md"
+    },
+    {
+      "logicalName": "release-prepare",
+      "path": "skills/release-prepare/SKILL.md"
+    },
+    {
+      "logicalName": "release-publish",
+      "path": "adapters/claude/skills/release-publish/SKILL.md"
+    },
+    {
+      "logicalName": "release-publish",
+      "path": "adapters/codex/skills/release-publish/SKILL.md"
+    },
+    {
+      "logicalName": "release-publish",
+      "path": "adapters/kimi/skills/release-publish/SKILL.md"
+    },
+    {
+      "logicalName": "release-publish",
+      "path": "adapters/workbuddy/skills/release-publish/SKILL.md"
+    },
+    {
+      "logicalName": "release-publish",
+      "path": "skills/release-publish/SKILL.md"
+    },
+    {
+      "logicalName": "release-reconcile",
+      "path": "adapters/claude/skills/release-reconcile/SKILL.md"
+    },
+    {
+      "logicalName": "release-reconcile",
+      "path": "adapters/codex/skills/release-reconcile/SKILL.md"
+    },
+    {
+      "logicalName": "release-reconcile",
+      "path": "adapters/kimi/skills/release-reconcile/SKILL.md"
+    },
+    {
+      "logicalName": "release-reconcile",
+      "path": "adapters/workbuddy/skills/release-reconcile/SKILL.md"
+    },
+    {
+      "logicalName": "release-reconcile",
+      "path": "skills/release-reconcile/SKILL.md"
+    },
+    {
+      "logicalName": "release-setup",
+      "path": "adapters/claude/skills/release-setup/SKILL.md"
+    },
+    {
+      "logicalName": "release-setup",
+      "path": "adapters/codex/skills/release-setup/SKILL.md"
+    },
+    {
+      "logicalName": "release-setup",
+      "path": "adapters/kimi/skills/release-setup/SKILL.md"
+    },
+    {
+      "logicalName": "release-setup",
+      "path": "adapters/workbuddy/skills/release-setup/SKILL.md"
+    },
+    {
+      "logicalName": "release-setup",
+      "path": "skills/release-setup/SKILL.md"
+    },
+    {
+      "logicalName": "release-verify",
+      "path": "adapters/claude/skills/release-verify/SKILL.md"
+    },
+    {
+      "logicalName": "release-verify",
+      "path": "adapters/codex/skills/release-verify/SKILL.md"
+    },
+    {
+      "logicalName": "release-verify",
+      "path": "adapters/kimi/skills/release-verify/SKILL.md"
+    },
+    {
+      "logicalName": "release-verify",
+      "path": "adapters/workbuddy/skills/release-verify/SKILL.md"
+    },
+    {
+      "logicalName": "release-verify",
+      "path": "skills/release-verify/SKILL.md"
+    }
+  ],
+  "governanceNotes": {
+    "duplicatePrevention": "This platform-manifest.json eliminates DUPLICATE_LOGICAL_SKILL_ID audit blocking by providing an authoritative claim of projection vs original. Each projected SKILL.md is listed in logicalMappings and is therefore excluded from the family_source logical-skill scan; only skills-src/ is scanned as logical source.",
+    "auditCompliance": "The manifest declares skills-src/ as the unique logical root. All other skill locations (skills/, adapters/*/skills/) are projected artifacts derived via documented generators.",
+    "versionOwnership": "本文件 version 与 package.json 版本字段确定性对齐（生成时读取）。0.6.0 特性（route/lineage/workflow profiles/三新技能）当前在 version 0.5.1 下开发；版本边界归属待用户裁决后统一，不得擅自 bump。",
+    "projectionInvariants": [
+      "Skills defined in skills-src/ cannot be manually modified; modifications must occur in skills-src/ and propagate via generators",
+      "Generator scripts are deterministic; --check mode verifies no drift between source and projection",
+      "Adapter projections include platform-specific metadata but preserve core skill semantics"
+    ]
+  },
+  "managedBy": {
+    "generator": "scripts/generate-platform-manifest.mjs",
+    "entry": "node scripts/generate-platform-manifest.mjs [--check]",
+    "note": "受管生成物：本文件由生成器从当前工作树字节（skills-src/ 逻辑源与 skills/、adapters/*/skills/ 投影位置的实际文件）确定性产出。skills-src/ 或任一投影位置新增/删除/改名技能后，必须重跑生成器（写模式）或 --check 验证，不得手工编辑。"
+  },
+  "status": "active",
+  "specLifecycle": "production",
+  "familyId": "release-skill",
+  "owner": "广州市风荷科技有限公司"
+}

package/references/.render-manifest.json

@@ -1,17 +1,17 @@
 {
-  "source": "standards",
+  "source": "references",
   "files": {
     "00-target-state.md": {
       "digest": "d66f8c33b2df2bbcb235ce123f786c18c19b3a797197495793d9af566618099d",
       "bytes": 6335
     },
     "01-state-machine.md": {
-      "digest": "f09a91b69cd7ba27bf5fe5d57deafb58aeb2edc3f69637020f573b06e190a0dd",
-      "bytes": 8840
+      "digest": "4698e3763f76774798e269ae163fcf87ba8ca358a9638c5bff693f5921455f9f",
+      "bytes": 9114
     },
     "02-project-config.md": {
-      "digest": "0cff13ebb270f3515290e0ce60b91303143777d1a4948db28cf2c69612ceff8e",
-      "bytes": 19029
+      "digest": "f866490d5897c2baf38fd3a6770964c052bea4418f034b75965ecfe49c2f4387",
+      "bytes": 21212
     },
     "03-readme-quality.md": {
       "digest": "d74e41052592443ebbd450d0ace5f9b9b19c7a94db50f952b17c1c5a4c5dc230",
@@ -22,12 +22,12 @@
       "bytes": 4682
     },
     "05-evidence-and-errors.md": {
-      "digest": "ebcb4940ff2a25ce6945c3b11cfcafe751f4a1f515276b7e021717ea5844eebf",
-      "bytes": 9688
+      "digest": "3df7644a6db614ee5f67689834f97227752834cf6c27762dee66650675c34168",
+      "bytes": 11592
     },
     "06-adapter-contract.md": {
-      "digest": "39f0271bc06eae38dade518ece8f7e16a18f53099a433e3ae07e9d20ff7a142e",
-      "bytes": 8716
+      "digest": "4b1ec9ba843345df47c1d133a8bf1aa644bf12a4ecf760cb1d566a43f1e9a9d2",
+      "bytes": 17282
     }
   }
 }

package/references/02-project-config.md

@@ -89,6 +89,32 @@ hooks:                      # 可选，命令 hooks
   typecheck: <hook>
   lint: <hook>
 
+postPublish:                # 可选；发布后分发配置（W2 closure）
+  distribute:               # 分发行动数组
+    - actionType: <string>      # "distribute-mirror" | "distribute-marketplace-index"
+      adapter: <string>         # "distribute-git" | "distribute-marketplace"
+      kind: <string>            # "payload-mirror" | "marketplace-index-form"
+      targetId: <string>        # 目标标识
+      remoteUrl: <string>       # file:// 或 https://；禁止 ssh
+      branch: <string>          # 分支名，不得以 '-' 开头
+      tag: <string>             # tag 模板，用于版本验证
+      commitIdentity:           # 冻结提交身份
+        name: <string>          # 禁止以 '-' 开头
+        email: <string>         # RFC 5322 valid
+      payloadDir: <string>      # 相对路径
+      dryRun?: boolean          # 可选；只本地执行
+      materialize?: {          # 可选；分发前钩子
+        command: <string>       # 可执行文件
+        args: [<string>]        # 参数数组，禁止 shell 字符串
+        outputMarker?: <string> # 输出标记，用于验证
+        requireReport: {}       # 前置报告要求
+        urlDependsOn: [<string>]> # 依赖动作完成
+      onConflict?: <string>     # "FAIL" (默认) | "RETRY"
+      retryPolicy?: {          # 可选；重试策略
+        maxAttempts: number
+        backoffMs: number
+      }
+
 policy:                     # 可选，安全策略
   forbiddenPaths: [<string>]
   forbiddenContentPatterns: [<string>]
@@ -114,6 +140,15 @@ policy:                     # 可选，安全策略
   `commit`。生产 prepare 必须使用 `--online --production`，逐 unit 观察
   ref→commit mapping；offline production 不得冻结未观察的 bound 基线。
 
+发布到达 `VERIFIED` 后，`verify` 会把每个 `mode: bound` unit 的
+`previousPublicBaseline` 自动推进到本次已发布并验证通过的提交（commit、tree、
+manifestDigest），数值一律取自冻结计划里该 unit 的 `push-snapshot` 绑定，绝不从
+工作区状态重新计算，从而保证推进值与公开仓库一致。该推进只写本地 `project.yaml`，
+不产生任何远端写入；写回后会重新走一遍配置校验，校验失败则原样还原。若写回前该
+文件在工作区中是干净的，`verify` 会用单独一次提交只包含该文件的改动；否则只落盘、
+留给人工提交，绝不把在途改动卷进自动提交。推进失败不会降级 `VERIFIED`，只在证据
+中记录并提示人工处理。
+
 本地 human-owned 文件是下一轮发布内容的权威源；前序公开基线是冲突检测输入；
 冻结 snapshot 是本轮审批和发布的唯一字节来源。默认 Git observer 只调用
 `git ls-remote` 取得 ref→commit 映射，因此 commit 不一致时可提供 mapping diff，

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

@@ -33,6 +33,14 @@
 | `CONTENT_MISMATCH` | 远端默认分支缺少冻结源码内容 | README、版本源、公开映射输入的内容或 mode 不一致 | 人工 merge/adopt/reject；接受的内容进入默认分支后重试 publish |
 | `DIRTY_SOURCE_INPUT` | 源码输入闭包存在未提交变化 | `publicFiles.from` 或 `version.source` 有 staged、unstaged、untracked 变化 | 提交或撤销这些具体输入的变化后重新 prepare；无关 dirty 不受影响 |
 
+**动作状态码** (adapter execute/observe/verify):
+
+- `NO_CHANGE`: 幂等时 payload 无差异，不创建 commit/tag/push。
+- `PENDING`: 预检查阶段等待前置动作完成。
+- `DISTRIBUTING`: 分发执行中。
+- `DISTRIBUTED`: 分发已完成检查点（commit+tag+push）。
+- `VERIFIED`: 分发的 verify 阶段通过最终验证。
+
 ---
 
 ## 2. JSON/JSONL 事件格式
@@ -169,6 +177,42 @@
 - 事件和摘要中通过相对路径引用命令记录文件。
 - 存储的输出内容经过第 4 节脱敏规则处理。
 
+### 5.3 分发证据
+
+postPublish 阶段的 distribute action 产生独立的证据目录：
+
+```text
+.runs/<runId>/
+└── distribute/
+    ├── <actionId>-preflight.json   # preflight 验证结果
+    ├── <actionId>-execute.json     # execute 观察结果
+    ├── <actionId>-observe.json     # observe 状态确认
+    └── <actionId>-verify.json      # verify 最终验证
+```
+
+每个 JSON 文件包含：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| `actionId` | 字符串 | 动作唯一标识 |
+| `actionType` | 字符串 | "distribute-mirror" / "distribute-marketplace-index" |
+| `status` | 字符串 | NO_CHANGE / PENDING / DISTRIBUTING / DISTRIBUTED / VERIFIED / EXECUTE_FAILED |
+| `observation` | 对象 | 阶段特定观察数据（pushedCommit, tagOid, payloadFileCount 等） |
+| `details.code` | 字符串 | 失败时包含错误码（REMOTE_CONFLICT, AUTH_MISSING 等） |
+| `timestamp` | 字符串 | ISO 8601 UTC 时间戳 |
+
+checkpoint 状态语义：
+
+- `NO_CHANGE`: payload tree 与当前分支 tip 相同，不创建任何 git ref。
+- `DISTRIBUTED`: commit+tag+push 已成功，branchTip === pushedCommit && tagOid === pushedCommit。
+- `VERIFIED`: observe + content diff 验证全部通过。
+
+计划变更后的恢复流程：
+
+- PARTIAL 状态下 reconcile 读取已有的 distribute/*.json 文件重建状态。
+- 对于已成功的 checkpoint (DISTRIBUTED)，跳过该步骤；仅重试未完成或未达标的检查点。
+- remote state 冲突（如 tag move）必须人工决策，不得自动修复。
+
 ---
 
 ## 6. 跨标准引用

package/references/06-adapter-contract.md

@@ -90,6 +90,19 @@
 
 工具：`git` CLI 和 `gh` CLI，使用 `execFile` 参数数组调用。
 
+### 2.4.1 Distribute Adapter（postPublish）
+
+| 操作 | 方法 | 说明 | 幂等规则 |
+|---|---|---|---|
+| 预检远端分支 | preflight | 检查 branch 存在性、协议合法性 | 禁止 SSH URL，必须 file:// 或 https:// |
+| 克隆→wipe→write→commit | execute | 写入 payload，创建 bot identity 提交 + tag | NO_CHANGE 若 tree 相同；REMOTE_CONFLICT 若 tag move |
+| 观察远端 refs | observe | 检查 branch tip 与 tag OID 一致性 | CONSISTENT / MISSING / CONFLICTING |
+| 验证 content diff | verify | 二次 fetch 确认 payload 字节一致 | VERIFIED / FAILED |
+
+**never-force rule**: distribute adapter **永远不使用 force push**。即使是在追加模式，也仅允许普通快进；tag 移动视为冲突，要求人工决策。
+
+工具：`git` CLI via `distribute-git.mjs` adapter，参数数组调用。
+
 ### 2.2 npm Adapter
 
 | 操作 | 方法 | 说明 |

package/schemas/.render-manifest.json

@@ -22,16 +22,16 @@
       "bytes": 2390
     },
     "release-plan.schema.json": {
-      "digest": "01c96659223918b5ce0e2d0d01d1ce5095baeb056de401babb8928add4d2a221",
-      "bytes": 35256
+      "digest": "5e988a5301b89b3d3260154ffae12669af0e4d6ec7f9db8c44df21037ea0eaf6",
+      "bytes": 46948
     },
     "release-project.schema.json": {
-      "digest": "7ac18070ac41327a330ca35e32f466e3f2a8eb2b7df3a5755568e00f991ffdc1",
-      "bytes": 32497
+      "digest": "546e05845cd83a3b1db0a54036f9555081420337e9df961d783d2d2630800ef7",
+      "bytes": 41898
     },
     "release-run.schema.json": {
-      "digest": "bf3c8fb4ca2fc078272a45a6ee6bf663fd2420a722b2f995dbaabf2635e2179e",
-      "bytes": 14824
+      "digest": "6dd239c59f7045df11d13d6ba2027610d3c55c27a6af5bc87676b0eaad9600fd",
+      "bytes": 17663
     }
   }
 }