@agent_forge/forge-darwin-x64 1.88.1 → 2.0.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 +11 -11
  2. package/bin/forge +0 -0
  3. package/package.json +1 -1
package/bin/README.md CHANGED
@@ -37,7 +37,7 @@ forge task verify-acceptance # 实跑验收标准 → 不可伪造的 determi
37
37
  forge trace feat/demo # 查看任务的完整证据链
38
38
  ```
39
39
 
40
- 跑 `forge eval wedge-drill` 可在任何机器上自检这条首证据路径(隔离环境,60 秒);`forge eval artifact-drill` 自检产物链分档执法全链。两者是发版 workflow 的行为级冒烟门禁与 nightly 的每日行为回归。
40
+ 跑 `forge eval wedge-drill` 可在任何机器上自检这条首证据路径(隔离环境,60 秒),它是发版 workflow 的行为级冒烟门禁与 nightly 的每日行为回归。
41
41
 
42
42
  ## 🎯 它补的是哪一层
43
43
 
@@ -58,7 +58,7 @@ Forge 是 deterministic 的——范围是 "deterministic where code can verify"
58
58
  ▼
59
59
  ┌──────────────────────────────────────────────────┐
60
60
  │ 任务门禁 · change 验证 │
61
- │ task-implement → task-verify → task-complete │
61
+ │ task-implement → task-complete │
62
62
  │ 可执行判据 · 证据封印 · 持久化状态 │
63
63
  └────────────────────┬─────────────────────────────┘
64
64
  │
@@ -72,7 +72,7 @@ Forge 是 deterministic 的——范围是 "deterministic where code can verify"
72
72
 
73
73
  <table>
74
74
  <tr>
75
- <td width="50%" valign="top"><strong>🚦 任务级门禁</strong><br/>每个开发任务走 3 道门禁:实现 → 验证 → 完成,门禁之间有活动检查防止跳阶段。</td>
75
+ <td width="50%" valign="top"><strong>🚦 任务级门禁</strong><br/>每个开发任务走 2 道门禁:实现 → 完成(验收在两者之间用 `forge task verify-acceptance` 实跑)。</td>
76
76
  <td width="50%" valign="top"><strong>🔧 显式命令驱动</strong><br/>forge 没有实时拦截层:门禁由 agent 显式跑 forge task / forge change 命令触发,状态与证据落盘可审计。</td>
77
77
  </tr>
78
78
  <tr>
@@ -98,7 +98,7 @@ forge next # 从当前 git/任务状态推导恰好一条下一
98
98
  ```bash
99
99
  forge task start --ref feat/fix-typo --branch --title "修正文案"
100
100
  # 做完依次跑:task gate task-implement → task verify-acceptance
101
- # → task gate task-verify → review pass → task gate task-complete → task complete
101
+ # → review pass --reviewer <id> → task gate task-complete → task complete
102
102
  ```
103
103
 
104
104
  **场景 B:想留可评审记录——先立 change,再钉契约开工**
@@ -106,9 +106,9 @@ forge task start --ref feat/fix-typo --branch --title "修正文案"
106
106
  ```bash
107
107
  git checkout main # --branch 只能从 main/master 建分支
108
108
  forge change new my-feature --title "一句话说清要做什么"
109
- # 填 goal.md 五段,问人「边界/非目标」后:
109
+ # 填 goal.md 三段(Objective / Out of Scope / Check),问人「边界/非目标」后:
110
110
  forge change clarify my-feature --by-human --note "只改 A.txt 的文案,不动 B 模块与接口"
111
- # 补齐 proposal.md / design.md / tasks.md(每条绑判据编号)/ acceptance.md
111
+ # 补齐 goal.md(三段)/ change.md(改动·影响·验证)/ acceptance.md
112
112
  forge change phase my-feature # 每补一份看一次,直到 ready
113
113
  forge task start --ref feat/my-feature --branch --change my-feature
114
114
  ```
@@ -154,9 +154,9 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
154
154
  |------|------|
155
155
  | `forge init` | 在仓库里声明 forge 契约:写 `spec/forge.yaml`、`spec/changes/`、AGENTS.md 托管块,并按默认规则维护已存在的入口指针;不写 `~/.forge`(`--profile mini\|standard\|full`,`--project` 已废弃为 no-op) |
156
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|
157
+ | `forge change init/new/list/phase/clarify/verify/status/gate/check/agents` | 仓库内 change 生命周期:`spec/changes/<id>/` 三份产物(`goal.md` 三段目标 + `change.md` 改动/影响/验证 + `acceptance.md`;tasks.md 可选,老 change 兼容)+ 可执行判据 + 证据封印(绑定 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` 与普通 change 同布局(goal + change + acceptance)+ clarify 的人确认,且必须带 `--by-human`(agent 不得自批);`phase <id>` 按产物报阶段(specify→clarify→plan→tasks→ready;三份产物布局下 plan/tasks 合并到 change.md/acceptance 检查),`clarify --by-human --note` 记录边界与非目标;`task start` 不带 `--change` 也可以开工(任务是一等入口;带 `--change` 才要求该 change 已 ready;一句话小修可加 `--kind task`);`goal.md` 随 git 走,`task start --change <id>` 启动时钉 `Path+SHA256`,启动后改 goal 即让 implement 门禁 BLOCKED|
158
158
  | `forge task start --ref <type/desc> --branch --accept "run :: expected"` | 建任务 + 建分支 + 登记验收标准 |
159
- | `forge task gate <gate-id>` | 推进门禁:task-implement → task-verify → task-complete |
159
+ | `forge task gate <gate-id>` | 推进门禁:task-implement → task-complete |
160
160
  | `forge task verify-acceptance` | 实跑验收标准,落 deterministic 证据 |
161
161
  | `forge task complete` | 完结任务:自动评分 + Act 结论 + 清 active ref |
162
162
  | `forge task report` | 交付验收单(考卷逐条结果 + 证据强度 + 未验证面) |
@@ -166,7 +166,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
166
166
  | `forge trace <ref>` / `forge health` / `forge dashboard` | 证据链时间线 / 质量趋势 / 全局看板(Pulse) |
167
167
  | `forge status` | 项目状态 |
168
168
 
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)。
169
+ 其余命令族(`skills`、`enforcement`、`eval`、`act`、`workspace`、`project`、`registry`(含 `registry add` 显式登记)、`harness`、`compat`、`conventions`、`policy`、`migrate`、`update`、`node`、`bridge`、`docs`、`worktree`、`on`/`off`、`config`、`verify`、`trust`)见同一份[完整命令表](docs/reference/cli.md)。
170
170
 
171
171
  **回环怎么跑**:agent 每个回合先 `forge change status <id>`,把它给出的下一步当建议执行——补产物、跑 verify、读失败证据、重跑,acceptance 的判据全部通过才归档。判断标准来自仓库里的文件与证据,不来自对话记忆;in-loop 不需要宿主插件(`forge change status/verify` 仍是 forge 二进制提供的命令,所以「零安装」指不用装宿主插件,不是不用装 forge)。逐节点推进用 `forge change gate <id> --task N`:只跑该任务引用的判据,节点证据不封印整条 change。
172
172
 
@@ -177,7 +177,7 @@ hooks: off # 兼容字段:保留只为老契约可解析,不启用
177
177
 
178
178
  `--json` 在所有路径上输出同一份 `{checked,problems,skipped}`(空列表是 `[]`,跳过时退出码 0)。信任边界:`change check` 只把未归档 change 当作待交付物,已归档的是历史;把未封印的 change 手工 `git mv` 进 `archive/` 等于人宣布它已交付——工具不再检查,这一步只能靠 review。
179
179
 
180
- 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 goal + proposal + acceptance 三份产物外加 clarify 的人确认,且 `--fast` 必须带 `--by-human`(人已同意)。
180
+ 「同一个原因」指每次 verify/gate 的**第一条失败命令**:换一条命令、或中间有一次通过,就重新计数。连续 3 次同因失败 → `blocked`,此时 `next_steps` 不再给任何可执行命令,恢复命令放在 `handoff` 字段里,由人执行。fast change(`new --fast`)的判据与证据规则和普通 change 完全一样,只是只要求 goal + change + acceptance 三份产物外加 clarify 的人确认,且 `--fast` 必须带 `--by-human`(人已同意)。
181
181
 
182
182
  ## 📦 安装
183
183
 
@@ -309,7 +309,7 @@ rm -rf ~/.forge/skills-backup ~/.forge/.init-suggested
309
309
 
310
310
  欢迎提 Issue 和 PR。开发时注意:
311
311
 
312
- 1. **门禁先行** —— 任何源码变更走 `forge task` 三门禁(implement → verify → complete),不经任务的改动不被质量评分追踪。
312
+ 1. **门禁先行** —— 任何源码变更走 `forge task` 两道门禁(implement → complete,`review pass` 是 complete 的硬前置);不经任务的改动不被质量评分追踪。
313
313
  2. **注释双语** —— Go godoc 采用形式 A(英文段 → 空 `//` → 中文段),中文不删、不单语;行内注释与字符串字面量不动。
314
314
  3. **审查闭环** —— 提交前派独立只读子 agent 跑 code-review-gate 双轨(AI 作弊 + 工程规范),`forge review pass` 标记后才能过 task-complete 门禁。
315
315
  4. **提交纪律** —— 提交源码与手维护文档(`docs/reference/` 下的参考文档是测试硬依赖,
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.88.1",
3
+ "version": "2.0.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"