@best-agent/cli 0.0.2-beta.8 → 0.0.3-beta.1

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

@@ -1,198 +1,61 @@
 # @best-agent/cli
 
-Terminal entrypoint for `best-agent`.
+v3 的本地 Application composition 与终端入口。
 
-## Commands
+## 安装与发布
 
-- `best-agent server`
-- `best-agent serve`
-- `best-agent daemon`
-- `best-agent acp`
-- `best-agent run`
-- `best-agent chat`
+- `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` 后依次发布六个平台包和根包。
 
-## Features
+发布包不含普通 CLI JavaScript、声明文件或 source map。根包只含平台选择 launcher；Harness、CLI 和 TUI 位于 minified/mangled Node SEA code cache 中。
 
-- loads `.env` from `--cwd` or the current working directory
-- starts `app-server` or `acp-server`
-- starts a REST + SSE server over the shared runtime
-- starts a long-lived local daemon over a native socket or named pipe
-- runs direct one-shot prompts through the daemon-backed app-server path with foreground approval prompts; `run` and non-TTY `chat` daemons exit after 10 seconds idle unless `BEST_AGENT_DAEMON_IDLE_EXIT_MS` is set
-- runs TTY chat through the goatagent `DimSdk` TUI backed by the `best-agent` runtime
-- runs the non-TTY interactive chat loop through `sdk-ts -> daemon client -> local daemon -> runtime`
-- exposes project-memory, plan mode, diagnostics, compaction, research, fork/resume, and thread lifecycle commands
+## 当前命令
 
-## Key Flags
+- `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。
 
-- `--cwd <path>`
-- `--storage-root <path>`
-- `--extensions-root <path>`
-- `--agent <name>`
-- `--plan`
-- `--resume <threadId>`
-- `--latest`
-- `--provider <openai|anthropic|google>`
-- `--model <id>`
-- `--base-url <url>`
-- `--compatibility <auto|native|compatible>`
-- `--approval-timeout-ms <ms>`
-- `--guardian-enabled <true|false>`
-- `--guardian-model <id>`
-- `--guardian-threshold <0-100>`
-- `--guardian-timeout-ms <ms>`
+`server`、`daemon`、`serve`、`acp` 尚未完成 v3 product composition，会明确失败；CLI 不调用旧
+Server、SDK、Engine 或 native bridge。
 
-## Examples
+## Composition 输入
 
-Start the server:
-
-```bash
-best-agent server --cwd /path/to/repo
-```
-
-Start the local daemon:
-
-```bash
-best-agent daemon --cwd /path/to/repo
-```
-
-Start the HTTP+SSE server:
-
-```bash
-best-agent serve --host 127.0.0.1 --port 3000 --cwd /path/to/repo
-```
-
-HTTP auth:
-
-- loopback hosts (`127.0.0.1`, `::1`, `localhost`) keep the existing no-auth default
-- non-loopback hosts require `BEST_AGENT_HTTP_TOKEN`
-- when `BEST_AGENT_HTTP_TOKEN` is set, JSON routes require `Authorization: Bearer <token>`
-- SSE also accepts `?access_token=<token>`
-
-Run a single prompt:
-
-```bash
-best-agent run --agent verify 'tool:read-file {"path":"package.json"}'
-```
-
-Start chat with a provider:
-
-```bash
-OPENAI_API_KEY=your_key \
-OPENAI_MODEL=gpt-5-mini \
-best-agent chat --cwd /path/to/repo
-```
-
-Start the migrated local CLI from the repo root:
-
-```bash
-pnpm chat -- --cwd /path/to/repo
-```
-
-Start a planning session:
-
-```bash
-best-agent chat --plan
-```
-
-Run the TTY smoke check:
-
-```bash
-pnpm smoke:cli-tui
+```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> # 可重复
 ```
 
-## Web Search Configuration
-
-`web-search` is exposed by capability, not just by the presence of one vendor key.
-
-- if the active provider supports native web search, no external search key is required
-- if the active provider does not support native web search, the CLI can build an external search adapter from the persisted DimSdk tool settings
-- if neither capability exists, the runtime hides `web-search` from model-visible tools for that turn
-
-The CLI persists external search settings in:
-
-- `DIMCODE_HOME/tools.json` when `DIMCODE_HOME` is set
-- otherwise `~/.dimcode/tools.json`
-
-Relevant fields:
-
-```json
-{
-  "version": 1,
-  "updatedAt": 0,
-  "settings": {
-    "websearch": {
-      "apiKey": "serper-key",
-      "apiEndpoint": "https://google.serper.dev/search?format=json",
-      "numResults": 10
-    }
-  }
-}
-```
-
-You can provide the key in either of these ways:
-
-- before starting chat, by writing the `tools.json` values above
-- during an existing chat, by updating the same search settings through the DimSdk settings flow
-
-Dynamic updates apply on the next turn:
-
-- if the conversation is already open and the user adds the missing search key, the next user message re-evaluates capability
-- a new thread is not required just to pick up the new key
-- endpoint and result-count changes follow the same next-turn behavior in the current CLI implementation
-
-For the deeper runtime contract, see `/Users/Simon/Github/best-agent/docs/architecture/web-search-capability-and-configuration.md`.
-
-## Chat Commands
-
-- `/threads`, `/resume`, `/new`
-- `/archive`, `/unarchive`, `/delete`
-- `/memory show|set|add|edit|clear`
-- `/agent`, `/agents`
-- `/plan on|off|status|show|todos|approve|reject|export`
-- `/tools`, `/skills`, `/use-skill`, `/drop-skill`
-- `/diagnostics`, `/compact`
-- `/research`, `/evidence`, `/handoff`
-- `/fork`, `/forks`
-
-`/memory show` displays both user-authored manual memory and auto-extracted workspace memory. `/memory edit`, `/memory set`, and `/memory add` edit manual memory only. `/memory clear` clears both manual and auto memory.
-
-## Does Not Own
-
-- protocol definitions
-- runtime policy
-- tool implementations
-
-The CLI stays intentionally thin. Runtime behavior belongs in `packages/engine`.
-
-## Migration Notes
-
-- `best-agent run` now goes through `sdk-ts -> daemon client -> local daemon -> runtime` and no longer creates an in-process runtime for one-shot execution.
-- `best-agent serve` now exposes the same runtime through a thin HTTP+SSE surface for local integrations and e2e coverage.
-- `best-agent chat` now loads a bundled `DimSdk` runtime from `dist/dimsdk-tui.bundle.js`.
-- The bundle resolves `@simon_he/vue-tui` from the installed package in `node_modules`, so `best-agent chat` keeps the real goatagent shell and swaps only the runtime/backend bridge.
-- Provider/model changes now sync back into the `best-agent` runtime and persist through `cli-state.json`.
-- Session rename and `metadata.ui` persistence now round-trip through runtime/server/sdk/CLI bridge and survive restart.
-- Existing non-TTY CLI e2e remains the baseline acceptance path, `apps/cli/test/native-stream-runner.test.ts` covers the runtime bridge, the DimSdk tests live in `apps/cli/test`, and `pnpm smoke:cli-tui` is the manual TTY acceptance path.
-
-## Known Gaps
-
-- The bundled TUI still depends on external package compatibility, but [package.json](/Users/Simon/Github/best-agent/package.json) no longer hardcodes a machine-specific `link:` path for `@simon_he/vue-tui`.
-- We now cover provider persistence, session metadata hydration, and session list view-model compatibility in `apps/cli/test`, but we have not yet ported the heaviest full-terminal DimSdk interaction tests such as transcript rendering order, tool call expansion/collapse, and approval overlays.
-
-## Follow-up Plan
-
-### 1. Keep External TUI Dependency Pinned
+开启 `--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。
 
-- Keep `@simon_he/vue-tui` pinned to the exact published version used by the bundle.
-- If the package API changes, update the bundle and test suite together instead of relinking a sibling repo path.
+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。
 
-Acceptance:
-- `pnpm build` and `pnpm chat -- --cwd ...` work on a clean machine without a sibling `goatagent` checkout.
+Workspace grant 只能来自显式 CLI composition。Skill、prompt、Tool input、model output 和 sandbox 都不能
+增加 grant；sandbox 只可进一步收窄 Kernel 已授权的 exact Tool call。
 
-### 2. Port Heavier DimSdk Terminal Tests
+## 不拥有
 
-- Continue with bridge-compatible tests that exercise transcript ordering, tool call rendering, and approval overlays.
-- Prefer real shell tests when they are stable; otherwise keep the current compatibility-layer tests that directly target DimSdk persistence and view-model logic.
+- Kernel transition、Runtime facts 或 current-Run next-action authority；
+- Provider、Tool 或 sandbox 返回值的外部事实；
+- retry、resume、suspended Run、recovery 或 compact lifecycle；
+- Server、SDK、Channel 或外部资源恢复。
 
-Acceptance:
-- The acceptance baseline remains: `pnpm test` and `pnpm smoke:cli-tui` both green.
+最终状态只来自 direct `ApplicationHost.snapshot`；event 仅用于 bounded preview/early read。

package/dist/launcher.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+
+const targets = [{"id":"darwin-arm64","platform":"darwin","arch":"arm64","binary":"best-agent","packageName":"@best-agent/cli-darwin-arm64"},{"id":"darwin-x64","platform":"darwin","arch":"x64","binary":"best-agent","packageName":"@best-agent/cli-darwin-x64"},{"id":"linux-arm64-gnu","platform":"linux","arch":"arm64","libc":"glibc","binary":"best-agent","packageName":"@best-agent/cli-linux-arm64-gnu"},{"id":"linux-x64-gnu","platform":"linux","arch":"x64","libc":"glibc","binary":"best-agent","packageName":"@best-agent/cli-linux-x64-gnu"},{"id":"win32-arm64","platform":"win32","arch":"arm64","binary":"best-agent.exe","packageName":"@best-agent/cli-win32-arm64"},{"id":"win32-x64","platform":"win32","arch":"x64","binary":"best-agent.exe","packageName":"@best-agent/cli-win32-x64"}];
+const target = targets.find((candidate) => candidate.platform === process.platform && candidate.arch === process.arch);
+if (!target || (target.libc === "glibc" && !process.report?.getReport().header.glibcVersionRuntime)) {
+  process.stderr.write(`best-agent: unsupported platform ${process.platform}-${process.arch}.\n`);
+  process.exit(1);
+}
+
+let executable;
+try {
+  executable = createRequire(import.meta.url).resolve(`${target.packageName}/bin/${target.binary}`);
+} catch {
+  process.stderr.write(`best-agent: missing optional platform package ${target.packageName}; reinstall @best-agent/cli.\n`);
+  process.exit(1);
+}
+
+const result = spawnSync(executable, process.argv.slice(2), {
+  env: process.env,
+  stdio: "inherit",
+  windowsHide: false,
+});
+if (result.error) {
+  process.stderr.write(`best-agent: ${result.error.message}\n`);
+  process.exit(1);
+}
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,37 +1,25 @@
 {
   "name": "@best-agent/cli",
-  "version": "0.0.2-beta.8",
+  "version": "0.0.3-beta.1",
+  "description": "best-agent v3 CLI and TUI",
+  "type": "module",
   "bin": {
-    "best-agent": "./dist/index.js"
+    "best-agent": "./dist/launcher.js"
   },
   "files": [
+    "dist/launcher.js",
     "README.md",
-    "dist/**/*.d.ts",
-    "dist/**/*.js",
-    "dist/dimsdk-tui.bundle-size.json",
-    "!dist/**/*.map",
-    "!dist/**/*.tsbuildinfo",
-    "!dist/dimsdk-tui.bundle.metafile.json"
+    "LICENSE"
   ],
-  "type": "module",
-  "imports": {
-    "#cli/*": "./src/dimsdk/*"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "dotenv": "^17.4.2",
-    "node-notifier": "^10.0.1",
-    "@best-agent/engine": "0.0.2-beta.8",
-    "@best-agent/foundation": "0.0.2-beta.8",
-    "@best-agent/extensions": "0.0.2-beta.8",
-    "@best-agent/protocol": "0.0.2-beta.8",
-    "@best-agent/sdk-ts": "0.0.2-beta.8",
-    "@best-agent/server": "0.0.2-beta.8"
+  "engines": {
+    "node": ">=24.15.0"
   },
-  "scripts": {
-    "dev:server": "node ./dist/index.js server",
-    "release": "pnpm -w build && bumpp -r --no-commit --no-tag --no-push --no-verify && pnpm publish --access public --no-git-checks"
+  "optionalDependencies": {
+    "@best-agent/cli-darwin-arm64": "0.0.3-beta.1",
+    "@best-agent/cli-darwin-x64": "0.0.3-beta.1",
+    "@best-agent/cli-linux-arm64-gnu": "0.0.3-beta.1",
+    "@best-agent/cli-linux-x64-gnu": "0.0.3-beta.1",
+    "@best-agent/cli-win32-arm64": "0.0.3-beta.1",
+    "@best-agent/cli-win32-x64": "0.0.3-beta.1"
   }
 }