@agent_forge/forge-darwin-arm64 2.1.3 → 2.2.0

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.
Files changed (3) hide show
  1. package/bin/README.md +18 -10
  2. package/bin/forge +0 -0
  3. package/package.json +1 -1
package/bin/README.md CHANGED
@@ -89,16 +89,18 @@ Forge 是 deterministic 的——范围是 "deterministic where code can verify"
89
89
  cd your-project
90
90
  forge init # 在仓库里声明契约:只写仓库内产物
91
91
  git add -A && git commit -m "chore: forge init" # 让 next 看到干净工作区
92
- forge next # 从当前 git/任务状态推导恰好一条下一步,按建议执行(小修也可直接 task start)
93
- # 干净工作区没有任务时:声明了 spec 的仓库直接给 task start(落后远端先给 git pull --ff-only);未声明 spec 的仓库只给 forge status
92
+ # 有了新需求就直接开工(见场景 A/B);不必先跑 forge next
93
+ # forge next 只回答「接着做手上这件事该怎么走」——它在有 bug/改动时给还原命令,
94
+ # 无任务且干净时给下一条任务入口;陈旧的 ready change 只出现在 stale_changes 里,
95
+ # 不会把你拖回三天没动的旧活
94
96
  ```
95
97
 
96
98
  **场景 A:小修——任务是一等入口,直接开工**(change 可以事后补)
97
99
 
98
100
  ```bash
99
- forge task start --ref feat/fix-typo --branch --title "修正文案"
101
+ forge task start --ref feat/fix-typo --branch --title "修正文案" --agent <实现者 id>
100
102
  # 做完依次跑:task gate task-implement → task verify-acceptance
101
- # → review pass --reviewer <id> → task gate task-complete → task complete
103
+ # → review pass --reviewer <该任务绑定的评审者 id> → task gate task-complete → task complete
102
104
  ```
103
105
 
104
106
  **场景 B:想留可评审记录——先立 change,再钉契约开工**
@@ -110,9 +112,14 @@ forge change new my-feature --title "一句话说清要做什么"
110
112
  forge change clarify my-feature --by-human --note "只改 A.txt 的文案,不动 B 模块与接口"
111
113
  # 补齐 goal.md(三段)/ change.md(改动·影响·验证)/ acceptance.md
112
114
  forge change phase my-feature # 每补一份看一次,直到 ready
113
- forge task start --ref feat/my-feature --branch --change my-feature
115
+ forge task start --ref feat/my-feature --branch --change my-feature --agent <实现者 id> \
116
+ --accept "test -f A.txt" --accept-red "test -f A.txt" # --accept-red:开工时它应当失败
114
117
  ```
115
118
 
119
+ 两条 2.1 起的新默认:**实现者身份**(`--agent`)让 `review pass` 能拒绝自批;**先失败证明**
120
+ (`--accept-red`)让 `task complete` 能证明判据在实现前确实红过(没有可失败的场景可不登记,
121
+ 交付单会如实写「未登记」)。
122
+
116
123
  带 `--change` 时那个 change 必须已 `ready`(阶段机只读文件,不写状态);不带
117
124
  `--change` 则随时可以开工——change 可以事后补,`forge change verify` 才是它的封口。
118
125
 
@@ -322,19 +329,20 @@ rm -rf ~/.forge/skills-backup ~/.forge/.init-suggested
322
329
  | `forge task artifact …` / `forge task chain-init` | 命令已删除;产物就是 change 里的 `goal.md` / `change.md` / `acceptance.md` |
323
330
  | `forge selfcheck` | 该子命令已删除;用 `forge docs lint <文件>` + `forge change check` |
324
331
  | `forge eval artifact-drill` | 子命令已删除;用 `scripts/checks/release-smoke.sh <forge 二进制>`(发布冒烟)或 `forge change check` |
325
- | `forge review pass --note "…"` 刷新基线 | 必须换**新的**只读 reviewer:`--reviewer <新 id>`;同一 reviewer 自证会被拒 |
332
+ | `forge review pass --note "…"` 刷新基线 / 每轮换新 reviewer | 2.1 起改为**评审者复用**:首轮 `--reviewer <id>` 绑定,之后每轮用同一 id(换新 id 会把旧问题丢掉、永远收敛不了);确实要换人用 `--rotate-reviewer --reason "…"` 留痕;上一轮未闭合项用 `--findings <清单>` 承接 |
326
333
  | 五份产物(proposal/design/tasks + acceptance + goal) | 三份:`goal.md`(三段)+ `change.md` + `acceptance.md`;`clarify.md` 记人确认,`tasks.md` 可选 |
327
334
 
328
- `forge init` / `forge integrations` / `forge hook` / `forge freeze` / `forge doctor` 已在 1.85 删除,
335
+ `forge integrations` / `forge hook` / `forge freeze` / `forge doctor` 已在 1.85 删除,
329
336
  宿主层(用户级 CLAUDE.md / AGENTS.md 注入、hook 执行、插件、skills 分发)整体不存在了;
330
- 升级前如果还留着那些注入,按上一节「从 1.84 及更早版本升级」清掉。
337
+ 升级前如果还留着那些注入,按上一节「从 1.84 及更早版本升级」清掉。`forge init` 仍然存在,
338
+ 但它现在只写仓库内产物(契约 / changes 目录 / AGENTS 托管块 / 已存在的指针文件),不碰用户目录。
331
339
 
332
340
  ### 每个老项目要做的
333
341
 
334
342
  ```bash
335
343
  # 0) 先升级二进制
336
- npm i -g @agent_forge/forge@2.0.4 --include=optional --registry=https://registry.npmjs.org
337
- forge version # 应 >= 2.0.4
344
+ npm i -g @agent_forge/forge@2.1.3 --include=optional --registry=https://registry.npmjs.org
345
+ forge version # 应 >= 2.1.3
338
346
 
339
347
  # 1) 仓库里:搬旧 runtime state(.forge/ 里有历史 task/checklog 时)
340
348
  cd <your-repo>
package/bin/forge CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent_forge/forge-darwin-arm64",
3
- "version": "2.1.3",
3
+ "version": "2.2.0",
4
4
  "description": "Forge native binary for darwin-arm64. Auto-installed via optionalDependencies of @agent_forge/forge; do not depend on directly.",
5
5
  "os": [
6
6
  "darwin"