@best-agent/cli-darwin-arm64 0.0.3-beta.3 → 0.0.3-beta.30

package/README.md

@@ -1,61 +1,40 @@
 # @best-agent/cli
 
-v3 的本地 Application composition 与终端入口。
+Best-Agent v3 的本地 CLI、TUI 与 Application composition 入口。产品合同见：
 
-## 安装与发布
-
-- `npm install -g @best-agent/cli@beta`：根包按 `os`/`cpu`/`libc` 安装一个 SEA 平台包；
-- `pnpm pack:tui`：构建、打包并安装 smoke-test 当前平台的根包和平台包；
-- `pnpm release:cli --artifact-root .tmp/sea --tag beta --dry-run`：验证六个平台产物；去掉 `--dry-run` 后依次发布六个平台包和根包。
-
-发布包不含普通 CLI JavaScript、声明文件或 source map。根包只含平台选择 launcher；Harness、CLI 和 TUI 位于 minified/mangled Node SEA code cache 中。
+- [Composition](../../docs/product-v3/composition.md)
+- [Task and Session](../../docs/product-v3/task-session.md)
+- [Orchestration](../../docs/product-v3/orchestration.md)
+- [Context](../../docs/product-v3/context.md)
+- [Presentation](../../docs/product-v3/presentation.md)
+- [External Services](../../docs/product-v3/external-services.md)
 
 ## 当前命令
 
-- `best-agent run ... <prompt>`：创建一个 frozen Plan、一个 Session 和一个 Run；
-- `best-agent chat ...`：创建一个 frozen Plan 和一个 Session，普通输入开始新 Run，`/stop` 请求停止当前
-  Run，`/quit` 关闭本地 Application 资源；terminal assistant text 中的 `[[approval:<prompt>]]` 仅创建
-  Application 等待态，`/approve yes|no` 会提交同 Session 的**新 Run**。
-- `best-agent subagent ... <task>`：使用 Application-owned coordinator 启动独立 child Agent/Session/Run；`--json` 输出 terminal snapshot 摘要。
-- `best-agent workflow --workflow <steps.json> ...`：按 `{"steps":[{"prompt":"... {{previous}}"}]}` 顺序运行，每步均是前一步 terminal 后的新 Run。
-
-`server`、`daemon`、`serve`、`acp` 尚未完成 v3 product composition，会明确失败；CLI 不调用旧
-Server、SDK、Engine 或 native bridge。
-
-## Composition 输入
-
-```text
---provider <openai|anthropic|google>
---model <id>
---base-url <http(s)-url>
---compatibility <native|compatible>
---system-prompt <text>
---instruction-file <absolute-path>   # 可重复，顺序显式
---skill coding
---workspace <absolute-path>
---memory-dir <absolute-path>             # Application-owned bounded JSON memory store
---compact-dir <absolute-path>            # Rolling compact 与两槽 Session epoch artifact
---compact-debug-dir <absolute-path>      # Metadata-only compact rotation evidence (no raw transcript)
---workspace-grant <read|write|exec>  # 可重复
---exec-alias <alias>=<absolute-executable> # 可重复
+```bash
+best-agent run [options] <prompt>
+best-agent chat [options]
+best-agent subagent [options] <task>
+best-agent workflow --workflow <steps.json> [options] <prompt>
+best-agent server --stdio [options]
+best-agent serve [options]
+best-agent daemon [options]
+best-agent acp [options]
+best-agent --version | -version | -v | version
 ```
 
-开启 `--compact-debug-dir` 后，每次 manual/预算触发的 Session rotation 会写一个不含原文的 bounded JSON 记录，包含 source/epoch ref、SHA-256、
-字节数、group 选择/省略 ordinal、budget 与 cache usage。按记录中的 ref 可在 `<compact-dir>/compact/`（未指定时为 storage root 下的
-`compact/compact/`）检查 rolling source 与 frozen epoch artifact；该模式不会额外复制原始 terminal Transcript。
+运行 `best-agent --help` 查看当前 composition 与 transport 参数。
 
-argv、environment、文件和 backend 配置在 C0 只是 candidate；CLI 在 C1 验证并构造 private
-provider/sandbox，在 C2 显式选择 contributions 与 policy，Composer 在 C3 freeze Plan，CLI 在 C4
-创建 immutable Session admission。运行后只有 AgentKernel 可以写 Harness-local facts。
+`best-agent --version`（等价 `-version`、`-v`、`version`）是只读查询：不进入任何 composition，只在 stdout 打印一行 CLI 版本后退出
+（安装态 npm 包读自身 package manifest，SEA 单文件读构建时注入的版本；无法解析时打印 `dev`），便于在外部脚本或终端里确认当前安装的版本。
 
-Workspace grant 只能来自显式 CLI composition。Skill、prompt、Tool input、model output 和 sandbox 都不能
-增加 grant；sandbox 只可进一步收窄 Kernel 已授权的 exact Tool call。
+`b8` 是同一入口的短别名（`b` + 省略的 8 个字母）：安装该包后 `b8 <subcommand>` 与
+`best-agent <subcommand>` 等价，帮助文本中的命令名仍为 `best-agent`。
 
-## 不拥有
+## 安装与发布
 
-- Kernel transition、Runtime facts 或 current-Run next-action authority；
-- Provider、Tool 或 sandbox 返回值的外部事实；
-- retry、resume、suspended Run、recovery 或 compact lifecycle；
-- Server、SDK、Channel 或外部资源恢复。
+- `npm install -g @best-agent/cli@beta`：安装当前平台的 CLI 包；
+- `pnpm pack:tui`：构建并 smoke-test 当前平台包；
+- `pnpm release:cli --artifact-root .tmp/sea --tag beta --dry-run`：验证发布产物。
 
-最终状态只来自 direct `ApplicationHost.snapshot`；event 仅用于 bounded preview/early read。
+本地开发使用仓库根目录的 `pnpm build`、`pnpm test:cli` 与相关 capability 测试。

package/bin/best-agent

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/bin/best-agent
-size: 139289728 bytes
-sha256: eedb8dbfd57be263ab4693534ad20c4e289d878a9525aee70b19d5c552f97452
+size: 139158400 bytes
+sha256: 655456dff0de645c39c87455602f3ecb1726ae0f757d28301fc2a103bb928ee4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@best-agent/cli-darwin-arm64",
-  "version": "0.0.3-beta.3",
+  "version": "0.0.3-beta.30",
   "description": "best-agent CLI native executable for darwin-arm64",
   "os": [
     "darwin"
@@ -17,7 +17,6 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@arcships/light-ocr": "0.5.7",
-    "node-notifier": "10.0.1"
+    "@modelcontextprotocol/sdk": "1.28.0"
   }
 }