@agent_forge/forge-darwin-arm64 1.32.0 → 1.34.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.
package/bin/README.md CHANGED
@@ -205,7 +205,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
205
205
  | **tool-track** | Read 后 | 静默记录 Read 调用到 toollog,供 task-verify 的 read-before-edit 门禁判断(agent 是否先读代码再改) |
206
206
  | **task-verify** | 会话结束 | advisory:任务门禁/主分支保护到 stderr+checklog(不阻塞会话结束) |
207
207
  | **review-stop** | 会话结束 | code-review-gate 自动挡:未审源码变更 block 会话结束。task 模式不重复拦(task-complete 门禁 ReviewPassed 硬前置已强制),非 task 模式按 diff stamp 决策;并发会话检测——其他 session 有活跃任务时放行(调研 session 不被拦) |
208
- | **skill-scan** | 会话开始 | advisory:扫描 ~/.claude/skills 安全性(forge audit 19 规则),补 install 门控缺口(手动 clone/junction/git pull 进入的 skill),全局 hook 不依赖 forge project |
208
+ | **skill-scan** | 会话开始 | advisory:扫描 ~/.claude/skills 安全性(forge audit 22 规则),补 install 门控缺口(手动 clone/junction/git pull 进入的 skill),全局 hook 不依赖 forge project |
209
209
  | **mcp-scan** | 会话开始 | advisory:扫描项目级 `.mcp.json` 的 server 配置(管道执行/任意包执行 npx·uvx·dlx·bunx/内联代码/非 https URL/env 明文凭证),补 skill-scan 盲区(攻击者可经 PR 植入恶意 server,clone 即自动连接);只审 config 层,runtime tool description 注入(Tool Poisoning)不在能力内,全局 hook |
210
210
  | **init-suggest** | 会话开始 | advisory:检测到未启用 forge 的 git 项目时,首次提示 agent 询问是否启用(用户拒绝→`forge suggest decline` 永久静默;设 `FORGE_AUTO_INIT=1` 处处自动 init——v1.22 起 init 零项目写入,不再对项目产生任何文件变更),全局 hook,补"每项目手动 init"缺口,实现一次安装后项目自动登记 |
211
211
  | **task-resume** | 会话开始 | advisory:自动注入活跃任务的接续上下文(目标/计划/决策/阻塞/门禁进度/git 已改未提交)+ 锚定当前 session——接手方冷启动即知任务在哪一步,无需手动 forge task resume;无活跃任务静默;项目级 hook |
@@ -227,7 +227,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
227
227
  | `forge update [--plugin]` | 自更新到最新版本;加 `--plugin` 在 binary 更新后打印 plugin marketplace 重装指引(marketplace 镜像同步 hook 时建议重装) |
228
228
  | `forge suggest decline/status/reset` | 管理 init-suggest hook 的项目 init 提示状态(decline 永久静默当前项目 / status 查看 / reset 清除重新提示) |
229
229
  | `forge uninstall [--restore]` | 一键反装:剥除全部用户级 hooks(claude/codex/cursor/windsurf/opencode/kimi/reasonix)+ 用户级指令段(CLAUDE.md/AGENTS.md/global_rules.md)+ forge-quality skill + 清 npm global `@agent_forge/forge` + 删 init-suggest 标记(默认 `~/.forge/.init-suggested/`,设 `FORGE_DATA_HOME` 时落该根下);`--restore` 把用户级文件回滚到 forge 修改前字节(备份在 `~/.forge/backups/`);plugin 卸载须在 agent CLI 内交互运行(不可脚本化) |
230
- | `forge migrate [--dry-run] [--force]` | 把旧 `.forge/` runtime state(tasks/gates/checklog/toollog/act/sessions/quarantine/active-task-ref 等)迁到用户级 DataDir(`~/.forge/projects/<key>/`)——升级到 runtime state 外迁版本后的迁移路径;未改过的 `.forge/protocol.yml` 由 autoSync 自动迁 DataDir,用户改过的保留为团队共享覆盖层;幂等,`--dry-run` 预览,`--force` 覆盖 DataDir 已有同名 |
230
+ | `forge migrate [--dry-run] [--force]` | 把旧 `.forge/` runtime state(tasks/gates/checklog/toollog/act/sessions/quarantine/active-task-ref 等)迁到用户级 DataDir(`~/.forge/projects/<key>/`)——升级到 runtime state 外迁版本后的迁移路径;未改过的 `.forge/protocol.yml` 由 autoSync 自动迁 DataDir,用户改过的保留为团队共享覆盖层;迁移的 task 文件落地即剥离外来门禁信号(review/验收/评分/完成/逃生舱/generic 须本机重挣,验收命令带外来标记);幂等,`--dry-run` 预览,`--force` 覆盖 DataDir 已有同名 |
231
231
  | `forge registry prune` | 精简全局注册表 `~/.forge/projects.json`——移除项目目录已不存在的死路径与重复条目(项目移走/删除/测试残留),原子写回。registry.List 读时惰性精简但只在 `forge dashboard` 启动时触发(启 web 阻塞),本命令给不启 web 的主动清理入口 |
232
232
 
233
233
  </details>
@@ -242,7 +242,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
242
242
  | `forge task list` | 列出所有任务 |
243
243
  | `forge task mine [--agent <agent>] [--role <role>] [--all-projects] [--blocked] [--json]` | 列出分派给当前/指定 agent 的任务(`--all-projects` 全仓扫描按项目分组;`--blocked` 仅被依赖阻塞的,标注卡在哪环 [status, gate 进度 passed/total]) |
244
244
  | `forge task gate <gate-id>` | 验证单道任务门禁 |
245
- | `forge task verify-acceptance` | 实跑验收标准(task start --accept 登记),记 deterministic 证据 |
245
+ | `forge task verify-acceptance [--trust-foreign]` | 实跑验收标准(task start --accept 登记),记 deterministic 证据;验收命令来自 task import / .forge migrate(外来标记)时首跑须 `--trust-foreign`(人工审阅命令清单后显式受信,防外来命令串直接执行) |
246
246
  | `forge task scope add <glob>` | 追加计划改动文件到白名单(支持中途迭代) |
247
247
  | `forge task scope show` | 查看声明的白名单 + 实时 scope-drift(advisory,不阻塞) |
248
248
  | `forge task complete` | 标记任务完成(自动评分) |
@@ -315,16 +315,26 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
315
315
  |------|------|
316
316
  | `forge skills install` | 分发 skill 到全局/项目目标目录(link/copy) |
317
317
  | `forge skills list` | 列出 canonical skill 库中的 skill |
318
- | `forge skills audit` | 19 条安全规则审查(prompt 注入/数据外发/危险代码) |
318
+ | `forge skills audit` | 22 条安全规则审查(prompt 注入/数据外发/危险代码/供应链执行向量;任一 CRITICAL finding 即阻断 install/--gate) |
319
319
  | `forge skills drift-check` | 检测分发分叉(dry-run,不写) |
320
320
  | `forge skills validate` | R1-R9 规范校验 |
321
321
  | `forge skills adapters` | 部署 skill-routing adapter(pi/claude/cursor/routes.json) |
322
322
  | `forge skills usage` | 使用度量分析(热门 skill + undertrigger 候选) |
323
323
  | `forge skills effectiveness` | 技能命中×任务成效关联(命中数/task数/avg分/弱占比,agent-neutral) |
324
+ | `forge skills --dir <path>` | eval 命令族公共 flag:指定 eval 数据目录(默认 `~/.forge/evals`,`FORGE_EVAL_DIR` 可覆盖;首次默认解析自动从旧 `~/.pi/research/skill-eval` 一次性迁移。仓库内 `evals/` 或 CI 用) |
324
325
  | `forge skills eval-gen [--save] [--cases-only]` | 生成 eval 清单;`--save`/`--cases-only` 额外落结构化 case 集(回归闭环基准) |
326
+ | `forge skills eval-cases --skill X [--blind]` | 输出 case 集 JSON(agent dispatch 跑 prompt 的输入);`--blind` 盲测模式:每条 prompt 前置全库 name+description 清单(各截断 200 rune,渐进披露 L1 模拟),问「该触发哪个」而非「是否触发 X」,actual ≠ target 的行即误路由混淆数据 |
325
327
  | `forge skills eval-record --skill X --from <file/->` | 回填一次 eval run(agent dispatch 跑完每个 prompt 后整批提交,归一化+判定+算 health) |
326
328
  | `forge skills eval-report --skill X` | latest run vs baseline 回归报告(regression 三态 + pass-rate delta + 可比性) |
327
329
  | `forge skills eval-baseline --skill X` | 标记 baseline run(回归基准,显式人工决策) |
330
+ | `evals/golden/<skill>/cases.json`(数据约定,非命令) | 人工策展黄金 case 集(真实话语改写,非 description 派生;进 VCS 可评审)。eval-cases/eval-record 加载时 golden 优先、派生补充,同 ID golden 胜出;策展 ID 前缀 `g-`,`origin: "curated"`,不带 desc_hash(description 变更不过期) |
331
+ | `forge skills battery [--gate]` | 全库回归电池:逐 skill latest vs baseline 判回归(JudgeSkillAccept 单一判源),`--gate` 任一回归即阻断(exit 4);无 baseline/陈旧锚点降级 advisory |
332
+ | `forge skills mutex-gen` | 生成跨 skill 互斥 case 集(从 description SKIP 段的(用 X)让渡边派生:B 域 prompt 必须路由到 B、不得路由回声明让渡的 A;落盘 mutex/cases.json) |
333
+ | `forge skills mutex-record --from <file/->` | 回填一次互斥集 run(actual==Positive 才 pass;`--agent-model`/`--forge-version` 盖章防跨模型/版本假回归) |
334
+ | `forge skills mutex-report [--gate] [--json]` | 互斥集混淆矩阵(actual==Negative 为头号混淆行;`--gate` 任一混淆即 BLOCKED(stderr)+exit 4) |
335
+ | `forge skills analyze [--json]` | 弱点挖掘报告(只读):低分维度聚簇/验证盲区率/从未触发 skill/低成效 skill + 数据 caveat,供人选题 |
336
+ | `forge skills decide --prediction <p>` | 记录 skill 决策四元组;`--prediction` 声明可检验预测(哪个可观测信号应改善),供验证闭环回扣 |
337
+ | `forge skills verify --skill X --decision <id> --result <r>` | 回填决策验证结果(预测→验证闭环第二步;`--at` 指定时间、`--history`/`--history-json` 查全量可证伪台账) |
328
338
 
329
339
  </details>
330
340
 
@@ -334,6 +344,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
334
344
  | 命令 | 说明 |
335
345
  |------|------|
336
346
  | `forge health [--json]` | 项目级质量趋势——聚合所有任务结论(分数走势/证据盲区率/复发低分维度,task→project 粒度联动) |
347
+ | `forge doctor [--json]` | 跨 agent 环境一致性审计(只读)——扫 9 个 agent host 的 forge hook 接线、解析各 host hook 实际调用的 forge 二进制并对照版本(ok/drift/nover/missing 四态),并列出 PATH 上全部 forge 可执行文件(多个并存 = 游离 exe/shim 抢路,PATHEXT 事故形状);copilot 无稳定配置路径约定,刻意不在列 |
337
348
  | `forge trace <task-ref>` | 查看任务的完整质量事件时间线(checklog + toollog + token) |
338
349
  | `forge dashboard [--port <n>] [--no-open]` | 本地全局质量看板(Pulse 面板)——在任意目录运行都聚合 `~/.forge/projects.json` 登记的全部项目(`forge init` 自登记),渲染事件流(任务/gate/skill 触发/结论)、任务评分与证据链、skills 聚合(localhost 只读,自动开浏览器,Ctrl+C 退出,面板内按项目过滤);项目目录被移走/删除后注册表条目自动淡出(读时惰性精简),不留幽灵路径 |
339
350
  | `forge sync [--force]` | 同步 forge 资产到当前二进制版本(用户级 hooks/指令/skill 重生成 + 存量项目级残留收敛) |
@@ -366,7 +377,7 @@ npm install -g @agent_forge/forge
366
377
  /plugin install forge@forge
367
378
  ```
368
379
 
369
- 仍需 `npm install -g @agent_forge/forge` 装二进制(hooks 都 spawn forge),并在每个项目 `forge init` 登记(v1.22 起零项目写入——协议与 runtime state 全在用户级 `~/.forge/projects/<key>/`,只对用户级配置生效)。plugin 已装时 hooks 由 plugin.json 全机器接管,`forge init` 跳过自己的 settings.json 注册;存量老项目残留的旧版项目级写入(`.forge/hooks/`、`.claude/settings.local.json` 的 forge hooks、CLAUDE.md/AGENTS.md 的 forge 段)由 autoSync 与 init-suggest SessionStart hook 自动收敛。完整三步与各 host 差异见 `plugins/forge/README.md`。
380
+ 仍需 `npm install -g @agent_forge/forge` 装二进制(hooks 都 spawn forge)。项目登记无需手动:plugin 已装(= 显式 opt-in)时,init-suggest SessionStart hook 会在任意 git 项目首次会话静默自动 `forge init`(v1.22 起零项目写入——协议与 runtime state 全在用户级 `~/.forge/projects/<key>/`,只对用户级配置生效;`forge suggest decline` 可按项目退出)。hooks 由 plugin.json 全机器接管,`forge init` 跳过自己的 settings.json 注册;存量老项目残留的旧版项目级写入(`.forge/hooks/`、`.claude/settings.local.json` 的 forge hooks、CLAUDE.md/AGENTS.md 的 forge 段)由 autoSync 与 init-suggest SessionStart hook 自动收敛。完整三步与各 host 差异见 `plugins/forge/README.md`。
370
381
 
371
382
  </details>
372
383
 
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": "1.32.0",
3
+ "version": "1.34.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"