@agent_forge/forge-darwin-x64 1.86.0 → 1.87.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
@@ -87,9 +87,35 @@ Forge 是 deterministic 的——范围是 "deterministic where code can verify"
87
87
 
88
88
  ```bash
89
89
  cd your-project
90
- forge init # 在仓库里声明契约:只写仓库内产物
90
+ forge init # 在仓库里声明契约:只写仓库内产物
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
91
94
  ```
92
95
 
96
+ **场景 A:小修——任务是一等入口,直接开工**(change 可以事后补)
97
+
98
+ ```bash
99
+ forge task start --ref feat/fix-typo --branch --title "修正文案"
100
+ # 做完依次跑:task gate task-implement → task verify-acceptance
101
+ # → task gate task-verify → review pass → task gate task-complete → task complete
102
+ ```
103
+
104
+ **场景 B:想留可评审记录——先立 change,再钉契约开工**
105
+
106
+ ```bash
107
+ git checkout main # --branch 只能从 main/master 建分支
108
+ forge change new my-feature --title "一句话说清要做什么"
109
+ # 填 goal.md 五段,问人「边界/非目标」后:
110
+ forge change clarify my-feature --by-human --note "只改 A.txt 的文案,不动 B 模块与接口"
111
+ # 补齐 proposal.md / design.md / tasks.md(每条绑判据编号)/ acceptance.md
112
+ forge change phase my-feature # 每补一份看一次,直到 ready
113
+ forge task start --ref feat/my-feature --branch --change my-feature
114
+ ```
115
+
116
+ 带 `--change` 时那个 change 必须已 `ready`(阶段机只读文件,不写状态);不带
117
+ `--change` 则随时可以开工——change 可以事后补,`forge change verify` 才是它的封口。
118
+
93
119
  `forge init` **只在仓库里写文件**(随 git 提交,不会被误当成用户级状态):
94
120
 
95
121
  | 路径 | 说明 |
@@ -127,8 +153,8 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
127
153
  | 命令 | 用途 |
128
154
  |------|------|
129
155
  | `forge init` | 在仓库里声明 forge 契约:写 `spec/forge.yaml`、`spec/changes/`、AGENTS.md 托管块,并按默认规则维护已存在的入口指针;不写 `~/.forge`(`--profile mini\|standard\|full`,`--project` 已废弃为 no-op) |
130
- | `forge next` | 从 git/任务状态推导**恰好一条**下一步命令——agent 不自选下一步 |
131
- | `forge change init/new/list/verify/status/gate/check/agents` | 仓库内 change 生命周期:`spec/changes/<id>/` 五份产物(`goal.md` 五段目标 + proposal/design/tasks/acceptance)+ 可执行判据 + 证据封印(绑定 commit;工作区有未提交改动时另记每个文件的 sha256——不依赖 forge 接管,产物随仓库走)。`status` 是循环里唯一该看的下一步来源(同因失败 3 次就停下交给人;`prior_attempts` 列出最近失败的证据,返工前先读);`gate --task N` 只跑某条任务的判据;`check` 是 CI 与 pre-commit 共用的证据闸门(未封印/失效/失败 → 退出 2,`--staged` 只查暂存区碰到的 change);`agents` 重同步 AGENTS.md 的 forge 托管块并维护 `CLAUDE.md` / `.cursor/rules/forge.mdc` 指针(有块只改块内、无块末尾追加;`CLAUDE.md` 不存在默认不建,`.cursor/rules/` 目录已存在时补 forge.mdc,要凭空创建用 `--pointers`,`none` 完全不碰);`change init` 会在仓库根写 `spec/` 与 AGENTS.md,并按默认规则维护已存在的入口指针(已有 `CLAUDE.md` 追加指针、已有 `.cursor/rules/` 目录补 `forge.mdc`;随 git 提交;与 `forge init` 同源,都是仓库内产物);`new --fast` 只要求 goal.md + proposal + acceptance,且必须带 `--by-human`(agent 不得自批);`goal.md` 随 git 走,`task start --change <id>` 启动时钉 `Path+SHA256`,启动后改 goal 即让 implement 门禁 BLOCKED|
156
+ | `forge next` | 从 git/任务状态推导**恰好一条**下一步命令——agent 不自选下一步;声明了 spec 的仓库脏树会建议推进已有 change、立 change,或给出可直接粘贴的 `task start --change <id>` |
157
+ | `forge change init/new/list/phase/clarify/verify/status/gate/check/agents` | 仓库内 change 生命周期:`spec/changes/<id>/` 五份产物(`goal.md` 五段目标 + proposal/design/tasks/acceptance)+ 可执行判据 + 证据封印(绑定 commit;工作区有未提交改动时另记每个文件的 sha256——不依赖 forge 接管,产物随仓库走)。`status` 是循环里唯一该看的下一步来源(同因失败 3 次就停下交给人;`prior_attempts` 列出最近失败的证据,返工前先读);`gate --task N` 只跑某条任务的判据;`check` 是 CI 与 pre-commit 共用的证据闸门(未封印/失效/失败 → 退出 2,`--staged` 只查暂存区碰到的 change);`agents` 重同步 AGENTS.md 的 forge 托管块并维护 `CLAUDE.md` / `.cursor/rules/forge.mdc` 指针(有块只改块内、无块末尾追加;`CLAUDE.md` 不存在默认不建,`.cursor/rules/` 目录已存在时补 forge.mdc,要凭空创建用 `--pointers`,`none` 完全不碰);`change init` 会在仓库根写 `spec/` 与 AGENTS.md,并按默认规则维护已存在的入口指针(已有 `CLAUDE.md` 追加指针、已有 `.cursor/rules/` 目录补 `forge.mdc`;随 git 提交;与 `forge init` 同源,都是仓库内产物);`new --fast` 只要求 goal.md + proposal + acceptance + clarify 的人确认,且必须带 `--by-human`(agent 不得自批);`phase <id>` 按产物报阶段(specify→clarify→plan→tasks→ready),`clarify --by-human --note` 记录边界与非目标;`task start` 不带 `--change` 也可以开工(任务是一等入口;带 `--change` 才要求该 change 已 ready;一句话小修可加 `--kind task`);`goal.md` 随 git 走,`task start --change <id>` 启动时钉 `Path+SHA256`,启动后改 goal 即让 implement 门禁 BLOCKED|
132
158
  | `forge task start --ref <type/desc> --branch --accept "run :: expected"` | 建任务 + 建分支 + 登记验收标准 |
133
159
  | `forge task gate <gate-id>` | 推进门禁:task-implement → task-verify → task-complete |
134
160
  | `forge task verify-acceptance` | 实跑验收标准,落 deterministic 证据 |
@@ -142,7 +168,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
142
168
 
143
169
  其余命令族(`skills`、`enforcement`、`eval`、`act`、`workspace`、`project`、`registry`(含 `registry add` 显式登记)、`harness`、`compat`、`conventions`、`policy`、`selfcheck`、`migrate`、`update`、`node`、`bridge`、`docs`、`worktree`、`on`/`off`、`config`、`verify`、`trust`)见同一份[完整命令表](docs/reference/cli.md)。
144
170
 
145
- **回环怎么跑**:agent 每个回合先 `forge change status <id>`,只执行它给出的下一步——补产物、跑 verify、读失败证据、重跑,acceptance 的判据全部通过才归档。判断标准来自仓库里的文件与证据,不来自对话记忆;in-loop 不需要宿主插件(`forge change status/verify` 仍是 forge 二进制提供的命令,所以「零安装」指不用装宿主插件,不是不用装 forge)。逐节点推进用 `forge change gate <id> --task N`:只跑该任务引用的判据,节点证据不封印整条 change。
171
+ **回环怎么跑**:agent 每个回合先 `forge change status <id>`,把它给出的下一步当建议执行——补产物、跑 verify、读失败证据、重跑,acceptance 的判据全部通过才归档。判断标准来自仓库里的文件与证据,不来自对话记忆;in-loop 不需要宿主插件(`forge change status/verify` 仍是 forge 二进制提供的命令,所以「零安装」指不用装宿主插件,不是不用装 forge)。逐节点推进用 `forge change gate <id> --task N`:只跑该任务引用的判据,节点证据不封印整条 change。
146
172
 
147
173
  **证据怎么变成合并前提**:`forge change check` 给 CI 与 pre-commit 同一套判据——每个未归档 change 都得有一份与当前代码和判据一致的封印证据。仓库里带两份接线示例:
148
174
 
@@ -151,7 +177,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
151
177
 
152
178
  `--json` 在所有路径上输出同一份 `{checked,problems,skipped}`(空列表是 `[]`,跳过时退出码 0)。信任边界:`change check` 只把未归档 change 当作待交付物,已归档的是历史;把未封印的 change 手工 `git mv` 进 `archive/` 等于人宣布它已交付——工具不再检查,这一步只能靠 review。
153
179
 
154
- 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 goal + proposal + acceptance 三份产物,且 `--fast` 必须带 `--by-human`(人已同意)。
180
+ 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 goal + proposal + acceptance 三份产物外加 clarify 的人确认,且 `--fast` 必须带 `--by-human`(人已同意)。
155
181
 
156
182
  ## 📦 安装
157
183
 
@@ -168,7 +194,7 @@ npm install -g @agent_forge/forge
168
194
  ## ⬆️ 从 1.84 及更早版本升级
169
195
 
170
196
  1.85 删除了宿主层:hook 执法、用户级 `CLAUDE.md` / `AGENTS.md` 注入、插件、skills 分发都不再存在,
171
- `forge uninstall` 也随宿主层一起删了。旧版本留在用户目录里的东西不会自动消失,需要手工清理
197
+ forge 的 `uninstall` 子命令也随宿主层一起删了。旧版本留在用户目录里的东西不会自动消失,需要手工清理
172
198
  (删除前先备份)。下面命令按 bash 写,Windows 请用 Git Bash / MSYS 执行。
173
199
 
174
200
  旧版会写的位置(按你用过的宿主看):
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": "1.86.0",
3
+ "version": "1.87.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"