@agent_forge/forge-linux-x64 1.39.1 → 1.40.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 +4 -1
- package/bin/forge +0 -0
- package/package.json +1 -1
package/bin/README.md
CHANGED
|
@@ -226,7 +226,7 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
226
226
|
| `forge init` | 初始化项目(默认**零项目写入**:登记全局注册表 `~/.forge/projects.json`,hooks/指令/skill 全在用户级,protocol.yml + runtime state 在 `~/.forge/projects/<key>/`;`--project` 团队模式把指令资产写项目目录供 git 共享;旧的 `--mode` 标志已废弃为 no-op) |
|
|
227
227
|
| `forge status [--json] [--system]` | 查看项目状态(任务管道 + 质量信号);`--system` 跑系统级健康检查(~/.forge、PATH、孤儿 hook、skills manifest) |
|
|
228
228
|
| `forge verify` | 项目完整性检查 + 回归测试 |
|
|
229
|
-
| `forge update [--plugin]` |
|
|
229
|
+
| `forge update [--plugin]` | 检查并更新到最新版本(按安装通道分流:npm 安装自动检测包管理器 npm/pnpm/yarn,查 npm registry 并打印对应更新命令——npm 包不可变,原地替换会被下次 install 还原,故不代下载,可用 `FORGE_NPM_REGISTRY` 覆盖 registry;GitHub Release/手动安装从 GitHub 下载自替换);加 `--plugin` 在更新后打印 plugin marketplace 重装指引(marketplace 镜像同步 hook 时建议重装) |
|
|
230
230
|
| `forge suggest decline/status/reset` | 管理 init-suggest hook 的项目 init 提示状态(decline 永久静默当前项目 / status 查看 / reset 清除重新提示) |
|
|
231
231
|
| `forge uninstall [--restore]` | 一键反装:剥除全部用户级 hooks(claude/codex/cursor/windsurf/opencode/kimi/reasonix/cline)+ 用户级指令段(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 内交互运行(不可脚本化) |
|
|
232
232
|
| `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 已有同名 |
|
|
@@ -236,6 +236,9 @@ Agent 无法通过 `node -e "fs.writeFileSync()"`、`cat > file`、直接编辑
|
|
|
236
236
|
| `forge project adopt [--dry-run] [--regenerate]` | 采纳 repo-born 项目 ID:在主 worktree 根生成 `.forge-project-id`(`fpid_<32hex>`,建议 commit 进 git),并把本机数据从路径 key 迁到 ID key(先迁数据再翻身份,复用 rekey 合并语义)+ 注册表同步。另一台机器 `git pull` 拿到 ID 后跑一次 adopt 即对齐——两台机器对同一 clone 推导同一 key,跨机器同步免重映射;`--regenerate` 给共享/污染 ID 换新(其他机器需重跑 adopt 处理 key 不匹配) |
|
|
237
237
|
| `forge project export [--out <file>] [--include quarantine,hazards]` | 把项目记录打包为跨机器 bundle(tar.gz + 逐文件 sha256 的 manifest):allowlist 默认拒绝——只带 tasks/checklog/toollog/sessions/act/stamps(除 hook-deploy)/protocol.yml,quarantine 源码全文与 hazards 命令行等敏感 store 须 `--include` 显式选入,会话锚/sentinel/freeze 等机器本地文件一律排除;manifest 记录来源身份(key/key_mode/project_id)供导入侧 lineage 判定 |
|
|
238
238
|
| `forge project import <bundle> [--dry-run] [--untrusted] [--trust-foreign] [--force] [--adopt-id]` | 校验(sha256+版本守卫+路径安全)并合并 bundle 到本机:同 key = 同身份 lineage 默认保留结果字段(评分/完成/门禁历史经单调合并收敛),session 链接恒幽灵化;key 不匹配默认剥离外来门禁信号(`--trust-foreign` 显式放行);bundle 来自 ID 身份而本机是路径身份时默认拒绝给指引,`--adopt-id` 直接采纳其 ID(本机数据先迁移);账本 `imports.jsonl` 保证同 bundle 重复导入跳过,jsonl 精确行去重保证重叠导出不重复——双向同步收敛 |
|
|
239
|
+
| `forge node show [--json]` | 显示本机节点身份(node-identity:多机器同步的机器归因地基):`node_id` = ed25519 公钥指纹(`fnode_<32hex>`,身份即公钥——验签即身份证明),密钥对存于用户级 `~/.forge/node.json`(私钥 0600,永不外泄也不进 bundle),`rotation_chain` 轮换证书链格式预留(v1 恒空);输出只含 node_id + 公钥,绝不打印私钥 |
|
|
240
|
+
| `forge project sync <init\|push\|pull\|status>` | 多机器持续同步(git 传输通道):`init <remote>` 绑定任意 git remote(固定 `forge-sync` 分支,免疫各机默认分支漂移);`push` 导出 bundle 到 `nodes/<node_id>/<key>/bundle.tar.gz` 并推送(每节点只写自己前缀,git 写权限即权限层;同时写 `.sig` 签名 sidecar);`pull` 拉取后经标准 `project import` 导入全部他机 bundle(账本幂等,重复 pull 免费;lineage 裁决信任;逐节点容错 + 节点目录形态校验);`status` 显示绑定与最近操作时间。机器本地绑定存 `DataDir/sync-remote.json`(allowlist 默认拒绝,不随 bundle 旅行),缓存仓库在 `~/.forge/sync-cache/` |
|
|
241
|
+
| `forge trust <list\|add\|remove\|require-signed>` | 节点信任 store(TOFU,node-identity §3):`add <node_id> <pubkey> [--label <备注>] [--profile personal\|team]` 带外核对指纹后登记对端(node_id 与公钥一致性强制校验);`require-signed on` 切团队档——bundle 必须带有效签名且签名者已登记,否则导入硬拒;签名无效(篡改/公钥不符)任何档位都硬拒。store 存 `~/.forge/trust.json`(0600,永不随 bundle 旅行) |
|
|
239
242
|
|
|
240
243
|
</details>
|
|
241
244
|
|
package/bin/forge
CHANGED
|
Binary file
|
package/package.json
CHANGED