@agent_forge/forge-darwin-x64 2.0.4 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/README.md CHANGED
@@ -305,6 +305,82 @@ rm -rf ~/.forge/skills-backup ~/.forge/.init-suggested
305
305
  (2.1.277 起)在没有 `CLAUDE.md` 时会直接读 `AGENTS.md`;不确定自己的版本是否支持时,
306
306
  跑 `forge change agents --pointers claude` 生成 `CLAUDE.md` 指针最稳妥。
307
307
 
308
+ ## ⬆️ 从 1.85–1.9x 升级到 2.0
309
+
310
+ 2.0 是破坏性版本:门禁从三道降为两道、change 产物从五份改成三份,并删掉十项检查
311
+ (文档闸门、产物链、未用导出扫描、覆盖率回扣、变异抽样、方案先行、二次验证、
312
+ 自检、需求覆盖、技能决策——以上均已删除,具体命令见下表)。**老仓库不会自动损坏,
313
+ 但旧流程里的命令、CI 步骤和脚本会失效**,升级时按下面清单改。
314
+
315
+ ### 命令面的破坏性变化
316
+
317
+ | 旧用法 | 2.0 之后 |
318
+ | --- | --- |
319
+ | `forge task gate task-verify` | 门禁已删除;验收只跑 `forge task verify-acceptance` |
320
+ | `forge task doc-review --passed … --score …` | 命令已删除;文档回检并入评审,结论记在 `forge review pass --score N --reviewer <id>` |
321
+ | `forge task mutation` | 命令已删除;抽样变异不再由 forge 做 |
322
+ | `forge task artifact …` / `forge task chain-init` | 命令已删除;产物就是 change 里的 `goal.md` / `change.md` / `acceptance.md` |
323
+ | `forge selfcheck` | 该子命令已删除;用 `forge docs lint <文件>` + `forge change check` |
324
+ | `forge eval artifact-drill` | 子命令已删除;用 `scripts/checks/release-smoke.sh <forge 二进制>`(发布冒烟)或 `forge change check` |
325
+ | `forge review pass --note "…"` 刷新基线 | 必须换**新的**只读 reviewer:`--reviewer <新 id>`;同一 reviewer 自证会被拒 |
326
+ | 五份产物(proposal/design/tasks + acceptance + goal) | 三份:`goal.md`(三段)+ `change.md` + `acceptance.md`;`clarify.md` 记人确认,`tasks.md` 可选 |
327
+
328
+ `forge init` / `forge integrations` / `forge hook` / `forge freeze` / `forge doctor` 已在 1.85 删除,
329
+ 宿主层(用户级 CLAUDE.md / AGENTS.md 注入、hook 执行、插件、skills 分发)整体不存在了;
330
+ 升级前如果还留着那些注入,按上一节「从 1.84 及更早版本升级」清掉。
331
+
332
+ ### 每个老项目要做的
333
+
334
+ ```bash
335
+ # 0) 先升级二进制
336
+ npm i -g @agent_forge/forge@2.0.4 --include=optional --registry=https://registry.npmjs.org
337
+ forge version # 应 >= 2.0.4
338
+
339
+ # 1) 仓库里:搬旧 runtime state(.forge/ 里有历史 task/checklog 时)
340
+ cd <your-repo>
341
+ forge migrate --dry-run # 预览要搬的文件
342
+ forge migrate
343
+
344
+ # 2) 刷新仓库的 AGENTS.md 托管块(老块的硬规则还是三道门禁的旧文案)
345
+ forge change agents
346
+
347
+ # 3) 看进行中的 change 和任务
348
+ forge change list
349
+ forge status
350
+
351
+ # 4) 需要全局面板时再显式登记(2.0 起 init 不再自登记)
352
+ forge registry add
353
+ ```
354
+
355
+ 进行中的老 change(proposal/design/tasks 布局)**可以继续按老规则跑完**:
356
+ `forge change verify` / `forge change gate` 对老布局仍按老判据走,不需要补三份。
357
+ 想换新布局就新建一个 change 重开(`forge change new <id>` → 填三份 → `clarify --by-human`)。
358
+ 新布局的 change 缺 `clarify.md` 时 `verify` 与 `gate` 都会拒绝(`forge change clarify <id> --by-human` 补)。
359
+
360
+ ### 清掉旧版本留下的机器级垃圾
361
+
362
+ ```bash
363
+ # 旧宿主层的运行时残留(1.85 起已无用;只是历史文件,删掉不影响任何命令)
364
+ find ~/.forge/projects -maxdepth 2 -name hooks -type d -exec rm -rf {} +
365
+ find ~/.forge/projects -maxdepth 2 -name protocol.yml -delete
366
+
367
+ # 注册表里的死路径与孤儿数据目录
368
+ forge registry prune # 移除路径已不存在的条目
369
+ forge registry audit # 看 key 漂移 / 孤儿目录 / 非法 ID
370
+ forge registry gc --prune # 孤儿数据目录移入 ~/.forge/backups/gc-<时间戳>/
371
+ ```
372
+
373
+ `forge registry gc` 默认演练,`--prune` 才动手;备份目录确认无需恢复后可以手动删。
374
+
375
+ ### 升级后的自检
376
+
377
+ ```bash
378
+ forge change check # 每个仓库:契约与证据自洽,退出码 0/2
379
+ forge status # 任务管道:应显示两道门禁
380
+ ```
381
+
382
+ 再在 CI 脚本里搜一遍上一节表格左列的旧命令名,应当没有残留;有的话按表格换成对应替代命令。
383
+
308
384
  ## 🤝 贡献
309
385
 
310
386
  欢迎提 Issue 和 PR。开发时注意:
package/bin/forge CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent_forge/forge-darwin-x64",
3
- "version": "2.0.4",
3
+ "version": "2.1.1",
4
4
  "description": "Forge native binary for darwin-x64. Auto-installed via optionalDependencies of @agent_forge/forge; do not depend on directly.",
5
5
  "os": [
6
6
  "darwin"