@agent_forge/forge-darwin-arm64 1.53.0 → 1.55.0

package/bin/README.md

@@ -251,6 +251,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
 | `forge uninstall [--restore]` | 一键反装：剥除全部用户级 hooks（claude/codex/cursor/windsurf/opencode/kimi/reasonix/cline/codebuddy/zcode；dsh 无用户级 hook 文件可剥——其 translator 是刻意 no-op，卸载即移除 plugin）+ 用户级指令段（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 内交互运行（不可脚本化） |
 | `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 已有同名 |
 | `forge registry prune` | 精简全局注册表 `~/.forge/projects.json`——移除项目目录已不存在的死路径与重复条目（项目移走/删除/测试残留），原子写回。registry.List 读时惰性精简但只在 `forge dashboard` 启动时触发（启 web 阻塞），本命令给不启 web 的主动清理入口 |
+| `forge registry remove <path>` | 按路径移除单条注册表条目（精确匹配、不做前缀；路径形态与大小写归一容忍——8.3 短名/符号链接解析形态/大小写变体命中同一条）。与 prune 分工：prune 只能清**死**路径，活着的伪根（如误注册的用户 home/临时根——此类条目 registry.Add 已有保留根守卫拒绝再入册）只能具名移除 |
 | `forge registry gc [--prune]` | 回收孤儿项目数据目录（`~/.forge/projects/<key>/` 下不在注册表内的目录，测试泄漏/项目注销残留的无界增长收口）：默认 dry-run 只报告；`--prune` 执行——空目录树删除，最新文件超过 14 天的非空目录移入 `~/.forge/backups/gc-<时间戳>/`（移动而非删除，可恢复），14 天内有活动的未登记项目数据与已登记项目永不触碰 |
 | `forge registry audit [--json]` | 只读一致性审计：key-drift（注册表 key ≠ 当前派生 key 且旧数据目录有载荷，提示 `forge project adopt` 迁移）/ orphan-datadir（数据目录有载荷但注册表无条目，备份壳除外）/ id-collision（两个路径派生同一 key——复制粘贴共享 `.forge-project-id` 的检出器）/ invalid-id（ID 文件格式非法，Key() fail-open 回落的唯一暴露面） |
 | `forge registry rekey --from <key> --to <key> [--dry-run]` | 把 from key 的项目数据目录并入 to key（修复身份分裂的存量数据；合并语义与 project import 共享 datamerge） |
@@ -327,7 +328,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
 | `forge task decide --content` | 记录已确认决策（持久化进 task，跨会话/跨工具不再推翻） |
 | `forge task next <step>` | 追加下一步（可多条） |
 | `forge task block --content/--resolve <id>` | 登记阻塞或解决阻塞（open→resolved） |
-| `forge task finding --content/--resolve <id>` | 记录跨工具发现（带来源工具）或标 fixed |
+| `forge task finding --content/--resolve <id>` \| `--reset-loop --note` | 记录跨工具发现（带来源工具）、标 fixed（指纹入 ResolvedPrints 记忆）；**审查回环**（回边语义，docs/design/artifact-chain-workflow.md）：open finding 跨过 schema 回边 max_rounds 次复核、或已解决 finding 同指纹再登记（复活）→ 回环耗尽，complete 被拦升级人工；人工裁决 `--reset-loop --note` 重开（审计行落地）。耗尽后唯一出口是人——终止权外置 |
 | `forge task attach --ref --tool` | 锚定 session+工具到 task（跨工具多向锚定：pi 起、claude-code 接） |
 | `forge task assign --ref <ref> --to <agent> [--role] [--by]` | 把任务分派给指定 agent（offered 起步，编排器侧；未知 agent 警告但接受） |
 | `forge task claim --ref <ref> [--as <agent>]` | 工作方认领分派给自己的任务（offered→claimed，自动锚定 session） |
@@ -379,6 +380,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
 | `forge act show [--ref <ref>]` | 查看最新（或指定）任务结论（含 skill 触达画像——该 task 期间触发了哪些 skill） |
 | `forge act list [--json]` | 列出所有任务结论 |
 | `forge act nudge` | 最新结论有回顾 nudge 时输出一行（否则静默）——供 task-verify 会话结束 hook 消费 |
+| `forge act retro-done --ref <ref> --carrier <memory/skill/claudemd/code/hook/ci/none> [--lesson <教训>]` | 证据式 ack：session-retrospective 沉淀完经验后记录「回顾已发生」，被 ack 的 nudge 退出面板告警（`--lesson` 一句话教训；忘调用则 nudge 留面板——错过的回顾可见） |
 | `forge act rebuild` | 从 tasks/*.json 重建 conclusions.jsonl（迁移 act 上线前的旧任务） |
 
 </details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent_forge/forge-darwin-arm64",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "description": "Forge native binary for darwin-arm64. Auto-installed via optionalDependencies of @agent_forge/forge; do not depend on directly.",
   "os": [
     "darwin"