@agent_forge/forge-darwin-x64 1.85.1 → 1.86.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 +116 -2
  2. package/bin/forge +0 -0
  3. package/package.json +1 -1
package/bin/README.md CHANGED
@@ -128,7 +128,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
128
128
  |------|------|
129
129
  | `forge init` | 在仓库里声明 forge 契约:写 `spec/forge.yaml`、`spec/changes/`、AGENTS.md 托管块,并按默认规则维护已存在的入口指针;不写 `~/.forge`(`--profile mini\|standard\|full`,`--project` 已废弃为 no-op) |
130
130
  | `forge next` | 从 git/任务状态推导**恰好一条**下一步命令——agent 不自选下一步 |
131
- | `forge change init/new/list/verify/status/gate/check/agents` | 仓库内 change 生命周期:`spec/changes/<id>/` 四份产物(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` 只要求 proposal + acceptance |
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|
132
132
  | `forge task start --ref <type/desc> --branch --accept "run :: expected"` | 建任务 + 建分支 + 登记验收标准 |
133
133
  | `forge task gate <gate-id>` | 推进门禁:task-implement → task-verify → task-complete |
134
134
  | `forge task verify-acceptance` | 实跑验收标准,落 deterministic 证据 |
@@ -151,7 +151,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
151
151
 
152
152
  `--json` 在所有路径上输出同一份 `{checked,problems,skipped}`(空列表是 `[]`,跳过时退出码 0)。信任边界:`change check` 只把未归档 change 当作待交付物,已归档的是历史;把未封印的 change 手工 `git mv` 进 `archive/` 等于人宣布它已交付——工具不再检查,这一步只能靠 review。
153
153
 
154
- 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 proposal + acceptance 两份产物。
154
+ 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 goal + proposal + acceptance 三份产物,且 `--fast` 必须带 `--by-human`(人已同意)。
155
155
 
156
156
  ## 📦 安装
157
157
 
@@ -165,6 +165,120 @@ npm install -g @agent_forge/forge
165
165
  # 支持平台:macOS (x86_64/ARM64)、Linux (x86_64/ARM64)、Windows (x86_64)
166
166
  ```
167
167
 
168
+ ## ⬆️ 从 1.84 及更早版本升级
169
+
170
+ 1.85 删除了宿主层:hook 执法、用户级 `CLAUDE.md` / `AGENTS.md` 注入、插件、skills 分发都不再存在,
171
+ `forge uninstall` 也随宿主层一起删了。旧版本留在用户目录里的东西不会自动消失,需要手工清理
172
+ (删除前先备份)。下面命令按 bash 写,Windows 请用 Git Bash / MSYS 执行。
173
+
174
+ 旧版会写的位置(按你用过的宿主看):
175
+
176
+ | 宿主 | 全局注入 | hook 配置 | 插件 / skills |
177
+ | --- | --- | --- | --- |
178
+ | Claude Code | `~/.claude/CLAUDE.md`(`FORGE:START/END` 段) | `~/.claude/settings.json` 的 hooks 段 | `~/.claude/plugins/{marketplaces,cache}/forge`、`~/.claude/skills/*` 里的链接 |
179
+ | Codex | `~/.codex/AGENTS.md`(`FORGE:START/END` 段) | `~/.codex/hooks.json`,以及 `~/.codex/config.toml` 的 `[features] hooks` | `~/.codex/skills/*` 里的链接 |
180
+ | Windsurf | `~/.codeium/windsurf/memories/global_rules.md`(`FORGE:START/END` 段) | `~/.codeium/windsurf/hooks.json` 的 forge 条目 | 本版代码未见 skills 落点,如用过请检查 `~/.codeium/windsurf` |
181
+ | Cursor | — | `~/.cursor/hooks.json` | `~/.cursor/skills/*` 里的链接 |
182
+ | Kimi | `~/.kimi-code/config.toml`(`# FORGE:START` 注释段) | — | `~/.kimi-code/plugins/installed.json` 的 forge 条目 |
183
+
184
+ > 1.84 的用户级接线名册还有 cline / codebuddy / zcode / opencode 等宿主;它们在各自
185
+ > hooks 目录写文件,本表不逐一列出。不确定时先 `grep -rl "forge hook"
186
+ > ~/.claude/settings.json ~/.codex/hooks.json ~/.codeium/windsurf/hooks.json ~/.cursor/hooks.json`
187
+ > 以及这些宿主的 hooks 目录,再删。
188
+
189
+ 这些段里最要命的一句是「只有看到 `[forge-session]` 横幅或 forge hook 输出才按 forge 行事,
190
+ 否则忽略并不要运行 forge 命令」——1.85 没有横幅也没有 hook,这个条件恒假,Claude 会主动无视 forge。
191
+
192
+ ```bash
193
+ # 0) 备份(按宿主分目录:codex 与 kimi 都有 config.toml,平铺会互相覆盖)
194
+ base=~/forge-backup/upgrade-1.84
195
+ mkdir -p "$base"/claude "$base"/codex "$base"/windsurf "$base"/cursor "$base"/kimi
196
+ backup() {
197
+ dir=$1; shift
198
+ for f in "$@"; do
199
+ if [ -f "$f" ]; then cp "$f" "$base/$dir/"; fi
200
+ done
201
+ }
202
+ backup claude ~/.claude/CLAUDE.md ~/.claude/settings.json ~/.claude/plugins/installed_plugins.json
203
+ backup codex ~/.codex/AGENTS.md ~/.codex/hooks.json ~/.codex/config.toml
204
+ backup windsurf ~/.codeium/windsurf/memories/global_rules.md ~/.codeium/windsurf/hooks.json
205
+ backup cursor ~/.cursor/hooks.json
206
+ backup kimi ~/.kimi-code/config.toml ~/.kimi-code/plugins/installed.json
207
+ # 链接清单无法用 cp 备份,先落盘一份再动(`find -maxdepth` 在 macOS 上不存在,
208
+ # 所以用 shell glob;`readlink` 把目标也记下来,恢复时有据可查):
209
+ for d in ~/.claude/skills ~/.cursor/skills ~/.codex/skills ~/.copilot/skills ~/.agents/skills; do
210
+ [ -d "$d" ] || continue
211
+ for l in "$d"/*; do
212
+ if [ -L "$l" ]; then echo "$l -> $(readlink "$l")"; fi
213
+ done
214
+ done > "$base"/skills-links.txt
215
+
216
+ # 1) 定位 FORGE:START
217
+ grep -l 'FORGE:START' ~/.claude/CLAUDE.md ~/.codex/AGENTS.md \
218
+ ~/.codeium/windsurf/memories/global_rules.md ~/.kimi-code/config.toml 2>/dev/null
219
+ # 有就删掉整段(含标记行);如果文件只剩这一段,直接删文件。
220
+ # 同一文件里 forge 段之外的内容(团队规范、你自己的偏好)保留不动。
221
+
222
+ # 2) Codex hook 配置:只删 forge 条目,别删整个文件
223
+ # 编辑 ~/.codex/hooks.json,删掉 command 里带 "forge hook" 的条目;
224
+ # 再把 ~/.codex/config.toml 里 [features] hooks = true 改回 false(或删掉该行)。
225
+ # 如果 config.toml 里有 # FORGE:START … # FORGE:END 整块(旧版没有 [features] 表时
226
+ # 自动追加的),整块删掉,否则会留下孤立标记。
227
+
228
+ # 3) Claude settings / Windsurf / Cursor hooks:同样只删带 "forge hook" 的条目
229
+ # 编辑 ~/.claude/settings.json 的 hooks 段;
230
+ # 编辑 ~/.codeium/windsurf/hooks.json,删 forge 条目;
231
+ # 编辑 ~/.cursor/hooks.json,删 forge 条目(旧版写过 user-level hook)。
232
+
233
+ # 4) 旧插件与插件登记
234
+ rm -rf ~/.claude/plugins/marketplaces/forge ~/.claude/plugins/cache/forge
235
+ # 再编辑 ~/.claude/plugins/installed_plugins.json,删掉 forge@… 条目
236
+ # (或直接跑 claude plugin uninstall forge,如果这个版本的 CLI 还认识它)
237
+ # Kimi:编辑 ~/.kimi-code/plugins/installed.json 删 forge 条目,并删 ~/.kimi-code/plugins/managed/forge。
238
+
239
+ # 5) skills 分发:只删指向 skills-cache 的链接,再删缓存,否则会留下悬空链接
240
+ # 先预览(应全是 .../skills-cache/embedded/...):
241
+ for d in ~/.claude/skills ~/.cursor/skills ~/.codex/skills ~/.copilot/skills ~/.agents/skills; do
242
+ [ -d "$d" ] || continue
243
+ for l in "$d"/*; do
244
+ if [ -L "$l" ]; then case "$(readlink "$l")" in *skills-cache*) echo "$l";; esac; fi
245
+ done
246
+ done
247
+ # 确认无误后把上面的 echo 换成 rm -f 再跑一遍(用户自己 ln -s 的链接不受影响)。
248
+ # 旧版还会写真实目录 forge-quality(里面那句「只在横幅出现时才生效」正是要清掉的
249
+ # 文案);它不在链接清单里,需要单独删。1.84 同时写 claude 与 ~/.agents 两处:
250
+ rm -rf ~/.claude/skills/forge-quality ~/.agents/skills/forge-quality
251
+ # Reasonix 用户再加 ~/.reasonix/skills/forge-quality。
252
+ rm -rf ~/.forge/skills-cache
253
+ rm -f ~/.forge/skills-manifest.json
254
+
255
+ # 6) 自检:下面都应为空
256
+ grep -l 'FORGE:START' ~/.claude/CLAUDE.md ~/.codex/AGENTS.md \
257
+ ~/.codeium/windsurf/memories/global_rules.md ~/.kimi-code/config.toml 2>/dev/null
258
+ grep -rl 'forge hook' ~/.claude/settings.json ~/.codex/hooks.json \
259
+ ~/.codeium/windsurf/hooks.json ~/.cursor/hooks.json 2>/dev/null
260
+ grep -l 'forge' ~/.claude/plugins/installed_plugins.json ~/.kimi-code/plugins/installed.json 2>/dev/null
261
+ ls ~/.forge/skills-cache 2>/dev/null
262
+ ls -d ~/.claude/skills/forge-quality ~/.agents/skills/forge-quality 2>/dev/null
263
+ for d in ~/.claude/skills ~/.cursor/skills ~/.codex/skills ~/.copilot/skills ~/.agents/skills; do
264
+ [ -d "$d" ] || continue
265
+ for l in "$d"/*; do
266
+ if [ -L "$l" ]; then case "$(readlink "$l")" in *skills-cache*) echo "$l";; esac; fi
267
+ done
268
+ done
269
+
270
+ # 7) 确认上面都干净后,最后再删这些历史目录(它们是最后的回滚点)
271
+ rm -rf ~/.forge/skills-backup ~/.forge/.init-suggested
272
+ ```
273
+
274
+ > 说明:第 5 步按 `readlink` 的目标里是否含 `skills-cache` 来判定,只匹配 forge 装的链接,
275
+ > 用户自己 `ln -s` 的不受影响;链接清单已在第 0 步落盘到 `~/forge-backup/upgrade-1.84/skills-links.txt`。
276
+ > 第 7 步放在自检之后,是因为 `skills-backup` 是旧版本留下的回滚副本。
277
+
278
+ 清理后在仓库里跑 `forge status`,应看到 `spec/forge.yaml` 契约。较新的 Claude Code
279
+ (2.1.277 起)在没有 `CLAUDE.md` 时会直接读 `AGENTS.md`;不确定自己的版本是否支持时,
280
+ 跑 `forge change agents --pointers claude` 生成 `CLAUDE.md` 指针最稳妥。
281
+
168
282
  ## 🤝 贡献
169
283
 
170
284
  欢迎提 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": "1.85.1",
3
+ "version": "1.86.0",
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"