|
| 1 | +--- |
| 2 | +{ |
| 3 | + "schema": "shadow-dev/v1", |
| 4 | + "name": "20261009-chore-manifest-version-sync", |
| 5 | + "type": "chore", |
| 6 | + "scope": "packaging", |
| 7 | + "status": "published", |
| 8 | + "baseBranch": "main", |
| 9 | + "branch": "chore/20261009-chore-manifest-version-sync", |
| 10 | + "files": [ |
| 11 | + ".claude-plugin/plugin.json", |
| 12 | + ".codex-plugin/plugin.json", |
| 13 | + "package.json" |
| 14 | + ], |
| 15 | + "github": { |
| 16 | + "repository": "stack-wuh/shadow-dev-workflow", |
| 17 | + "issue": null, |
| 18 | + "issueUrl": null, |
| 19 | + "pullRequest": 38, |
| 20 | + "pullRequestUrl": "https://github.com/stack-wuh/shadow-dev-workflow/pull/38" |
| 21 | + }, |
| 22 | + "review": { |
| 23 | + "conclusion": "passed", |
| 24 | + "verifiedCommit": "a2ec8723c3f3639e60b095ed17cb942ec47b51d8", |
| 25 | + "verifiedAt": "2026-10-09T15:05:39.668Z" |
| 26 | + }, |
| 27 | + "workflow": { |
| 28 | + "operation": null, |
| 29 | + "checkpoint": "pr:38", |
| 30 | + "planHash": "a7fe9c8867a8f77085d7e8864636a885f78a76e3cd0116fee3333de1ab9907f6", |
| 31 | + "updatedAt": null, |
| 32 | + "lastError": null, |
| 33 | + "release": { |
| 34 | + "files": [ |
| 35 | + "shadow-docs/changes/20261009-chore-manifest-version-sync/brief.md" |
| 36 | + ], |
| 37 | + "message": "docs(shadow): manifest change 结果记录(publish 需重传参数,改走 release 轨)", |
| 38 | + "title": "[chore] 清单版本对齐 v6.5.1(pack 机检判红封口)", |
| 39 | + "body": "" |
| 40 | + }, |
| 41 | + "commit": { |
| 42 | + "files": [ |
| 43 | + "shadow-docs/changes/20261009-chore-manifest-version-sync/brief.md" |
| 44 | + ], |
| 45 | + "message": "docs(shadow): manifest 同步 change 的 review 与结果记录" |
| 46 | + } |
| 47 | + }, |
| 48 | + "knowledge": { |
| 49 | + "action": "无需变更", |
| 50 | + "target": null, |
| 51 | + "reason": "版本号一致性修复,由既有 pack 机检保证,无新增长期事实" |
| 52 | + } |
| 53 | +} |
| 54 | +--- |
| 55 | + |
| 56 | +# 清单版本与 package.json 对齐(v6.5.0 发版漏同步的机检抓到我自己) |
| 57 | + |
| 58 | +## 动机 |
| 59 | +上一批把 `package.json` 升到 6.5.0 却没同步 plugin 清单,被本仓既有测试 `pack: 三处 manifest 版本与 package.json 对齐(发版漏同步的机检)` 判红——这条机检正是第一轮复盘说的「manifest 漏同步」缺陷的解法,这次它抓的是我。已发布的 v6.5.0 产物内清单版本不一致,需以 6.5.1 覆盖发布。 |
| 60 | + |
| 61 | +## 复杂度评级 |
| 62 | +- **评级:** S |
| 63 | +- **理由:** ①无行为契约变更(纯版本号一致性);②只碰清单与 manifest;③既有测试当场判红,可发现性最高。 |
| 64 | +- **期望验证深度:** code-read + `npm test` 全绿 + 产物解包核对 |
| 65 | + |
| 66 | +## 引用规范 |
| 67 | +- `norms/knowledge-cards.md`;本仓 `test/pack.test.mjs` 的三清单同源断言(既有契约,不得绕过) |
| 68 | +- `knowledge/distribution-capability-contract.md`:pin/声明/清单三处同源,任何一处变化都要有机检判红——本次由既有门判出,属机制生效 |
| 69 | + |
| 70 | +## 决策 |
| 71 | +- **选型:** `package.json` + 全部 plugin 清单一次升到 **6.5.1**,重发产物;不改测试迁就漏同步。 |
| 72 | +- **对比方案:** 直接改 v6.5.0 release 的资产——未选,release 资产与 tag 已分发,覆盖式修补不可追溯。 |
| 73 | +- **理由:** 版本号一致性靠机检保证,破口必须用新版本封口。 |
| 74 | + |
| 75 | +## 任务 |
| 76 | +### Phase 1 |
| 77 | +- [x] 清单版本对齐 — `package.json`, `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json` — 全部升 6.5.1;`npm test` 两文件全绿 |
| 78 | +- [x] 覆盖发布 — `.agents/plugins/marketplace.json` — `node scripts/pack.mjs` 后发 v6.5.1,解包核对三处版本一致且 `requiresCommands` 存在 |
| 79 | + |
| 80 | +## 非目标 |
| 81 | +- 不动门逻辑与命令行为;不加 CI |
| 82 | + |
| 83 | +## 结果 |
| 84 | +- 实际耗时: — |
| 85 | +- 验证: — |
| 86 | + |
| 87 | +## 知识评估 |
| 88 | +- **预期影响:** 无需变更 |
| 89 | +- **候选卡片:** 无 |
| 90 | +- **理由:** 「清单版本必须与 package.json 同步且由机检保证」已在 `test/pack.test.mjs` 断言与 distribution 卡片的同源约束里;本次是该约束的正常执行结果,不是新事实。 |
0 commit comments