@best-agent/cli-darwin-arm64 0.0.2-beta.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simon He
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @best-agent/cli
+
+v3 的本地 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 中。
+
+## 当前命令
+
+- `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> # 可重复
+```
+
+开启 `--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。
+
+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。
+
+Workspace grant 只能来自显式 CLI composition。Skill、prompt、Tool input、model output 和 sandbox 都不能
+增加 grant；sandbox 只可进一步收窄 Kernel 已授权的 exact Tool call。
+
+## 不拥有
+
+- Kernel transition、Runtime facts 或 current-Run next-action authority；
+- Provider、Tool 或 sandbox 返回值的外部事实；
+- retry、resume、suspended Run、recovery 或 compact lifecycle；
+- Server、SDK、Channel 或外部资源恢复。
+
+最终状态只来自 direct `ApplicationHost.snapshot`；event 仅用于 bounded preview/early read。

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@best-agent/cli-darwin-arm64",
+  "version": "0.0.2-beta.9",
+  "description": "best-agent CLI native executable for darwin-arm64",
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "bin": {
+    "best-agent-darwin-arm64": "./bin/best-agent"
+  },
+  "files": [
+    "bin/best-agent",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@arcships/light-ocr": "0.5.7",
+    "node-notifier": "10.0.1"
+  }
+}