@springbrand/cli 0.1.0

package/README.md

@@ -0,0 +1,167 @@
+# SpringBrand CLI
+
+把 AI 编码客户端连接到 SpringBrand Gateway 的命令行工具。
+
+**当前定位：只做两件事** —— 往客户端写 MCP 配置，以及安装随 CLI 分发的 SpringBrand Skill 集合。集合以 `use-springbrand` 为通用入口，并包含 Platform、Action API、Connector、GTM 的业务指导；其他能力（Web 搜索、抓取、浏览器自动化等）暂不提供，见文末 TODO。
+
+包名 `@springbrand/cli`，命令名 `sp`。
+
+## 安装
+
+```bash
+cd cli
+npm install
+npm run build
+npm link
+```
+
+## 命令
+
+```bash
+sp connect [client]        # 把 SpringBrand 写入客户端的 MCP 配置并安装 Skill 集合
+sp doctor                  # 诊断安装状态，输出 JSON 报告与修复建议
+sp auth login|set|status|logout   # 管理 API key
+sp auth status --verify    # 额外拿这把 key 探一次 /mcp，报告账号、keyId 与环境
+sp upgrade                 # 更新 CLI 并刷新随包分发的 Skill 集合
+sp check-version           # 报告是否需要升级，供 agent 调用
+```
+
+`config-claude` 已从命令列表中取消注册，原因见 TODO。
+
+### sp connect
+
+```bash
+sp connect                       # 从本机检测到的客户端里挑一个
+sp connect cursor                # 指定客户端
+sp connect --all                 # 连接本机所有支持的客户端
+sp connect --all --dry-run       # 只打印将要写入什么，不落盘
+sp connect --all --uninstall     # 移除 connect 写入的条目
+sp connect cursor --url http://127.0.0.1:8789/mcp   # 覆盖端点（本地开发）
+```
+
+支持 10 个客户端。Gateway 同时提供 OAuth 与 API key，实际可用情况分三档：
+
+| 客户端 | 状态 | 验证方式 |
+|---|---|---|
+| `cursor` | 可用 | 真实写入 `~/.cursor/mcp.json` + skill，OAuth 与 API key 两种形态 |
+| `claude-code` | 可用 | 真实 `claude mcp add`，条目落入 `~/.claude/.claude.json`，OAuth 由客户端接手 |
+| `codex` | 可用 | 真实 `codex mcp add`，条目落入 `~/.codex/config.toml` |
+| `pi` | 可用 | 真实写入 `~/.pi/agent/mcp.json` + skill |
+| `omp` | 可用 | 真实写入 `~/.omp/mcp.json`（不装 skill） |
+| `opencode` | 可用 | stub 校验命令构造：`mcp add <name> --url ...` 与 `mcp auth` |
+| `grok` | 可用 | stub 校验命令构造：`mcp remove` 后 `mcp add --transport http` |
+| `openclaw` | MCP 可用，skill 失败 | skill 需 ClawHub 包 `@springbrand/springbrand`，尚未发布 |
+| `command-code` | 可用 | `keyRequired`，只接受 API key；端到端断言 `mcp add-json` 的 Bearer 请求头 |
+| `hermes` | 不可用 | `keyRequired`，且插件仓库不存在 |
+
+`hermes` 仍被插件仓库阻塞，见 TODO。
+
+两种认证形态由客户端能力决定：
+
+- **OAuth（不带 key）**：写入的条目只有 URL，由客户端自己走 OAuth 授权。
+- **API key**：CLI 把 key 写进 `Authorization: Bearer`，客户端不再需要浏览器登录。需要 `--api-key` 或已保存的 key。
+
+**`Authorization: Bearer` 是 Gateway 唯一读取 key 的位置**（`src/mcp-api-key.ts` 的 `classifyMcpAuthorization`），key 写进别的请求头等于没带凭据，客户端会被推回 OAuth。Codex 与 Grok 例外地传环境变量名而非 key 本身：前者用 `--bearer-token-env-var`，后者在加载时展开 `${SPRINGBRAND_API_KEY}`，两者都由客户端自己拼成 Bearer，key 因此不进 argv 与配置文件。
+
+key 形态是 `sbk_v1_<dev|production>_<id>_<secret>`，环境段决定它能用在哪个端点：生产端点 `connector.springbrand.ai` 只收 production key，其余（dev、本机）只收 dev key。不匹配的组合在写任何配置之前就被拒绝，不必等服务端的 401。
+
+写入前会把原配置备份成带时间戳的副本。`claude-code` 和 `codex` 不由 CLI 直接改文件，而是调用它们各自的 `mcp add` 命令。
+
+### sp doctor
+
+输出机器可读的 JSON，包含逐项检查、每个客户端的注册状态，以及可执行的修复命令。退出码非 0 表示存在需要处理的问题。
+
+## 端点与配置
+
+MCP 端点默认 `https://connector.springbrand.ai/mcp`。写入客户端配置时的服务名固定为 `springbrand`，与 Gateway 声明的服务别名一致。
+
+| 环境变量 | 作用 |
+|---|---|
+| `SPRINGBRAND_API_KEY` | API key，优先级高于已保存的配置 |
+| `SPRINGBRAND_API_URL` | 覆盖端点，必须是 https 或 loopback http |
+| `SPRINGBRAND_WEB_URL` | 覆盖 `sp auth login` 打开的网页地址；与端点覆盖相互独立 |
+| `SPRINGBRAND_DEBUG=1` | 打印 HTTP 请求与响应到 stderr（等同 `--debug`） |
+
+### 版本提示
+
+`sp check-version` 查询 `GET /api/cli/version`，输出结构化结果供 agent 解析：
+
+```json
+{"current":"0.1.0","latest":"0.9.0","minimum":null,"update":"recommended"}
+```
+
+`update` 为 `null`、`recommended` 或 `required`。**退出码承载强制语义**：`required` 退 `1`，其余退 `0`，agent 与脚本无需解析文案即可判断。结果在 `~/.springbrand/version-check.json` 缓存 6 小时（`--force` 跳过），因为它设计上会被 agent 在每次任务收尾时调用。查不到版本时输出 `update: null` 并退 `0`——检查版本绝不能挡住用户干活。
+
+另有一条被动通道：`connect` 期间会向所连接端点的 `/api/cli/connect-event` 上报六次安装进度，并从响应头 `x-sp-notice` 系列读取版本提示，`doctor` 与 `upgrade` 同样会读。但用户装完就不再跑这些命令，触达有限，所以主动通道才是主要手段。Gateway 已实现该端点（见 `src/cli-events.ts`）：事件不落库，作用是承载版本通告——CLI 装在用户机器上，服务端只能借它主动发起的请求把「该升级了」捎回去。版本门槛由 Wrangler 的 `CLI_LATEST_VERSION`（与可选的 `CLI_MIN_VERSION`）配置，**发布新版 CLI 后需同步该变量**，否则老版本收不到提示。
+
+CLI 自己的配置在 `~/.springbrand/config.json`。
+
+skill 的安装位置随客户端而定：默认 `~/.agents/skills/`，`claude-code` 用 `~/.claude/skills/`，`pi` 用 `~/.pi/agent/skills/`，`command-code` 用 `~/.commandcode/skills/`，`hermes` 用 `~/.hermes/skills/`。`openclaw` 例外，走它自己的 ClawHub 包管理器。
+
+## 代码来源
+
+`src/` 复刻自 `@tiny-fish/cli@0.43.0` 的编译产物：`dist/**/*.js`（实现）与 `dist/**/*.d.ts`（类型声明）合并成 TypeScript，再替换品牌标识。`scripts/` 下是这条管线，可重跑：
+
+```bash
+node scripts/convert-libs.ts       # 合并 .d.ts + .impl.js 成 .ts
+node scripts/rebrand.ts            # 替换品牌标识（命令名/服务名/端点/环境变量分层处理）
+node scripts/apply-signatures.ts   # 从 .d.ts 套回导出函数与常量的类型
+node scripts/check-imports.ts      # 校验相对导入
+```
+
+重跑管线会覆盖手工修改，重跑后需要重新应用。
+
+## 开发
+
+```bash
+npm run build      # tsc
+npm run dev        # tsc --watch
+npm run typecheck  # tsc --noEmit，当前 strict 全绿
+```
+
+## 测试
+
+```bash
+npm test           # 先编译，再跑全部用例（含端到端，约 10 秒）
+npm run test:unit  # 只跑单元用例，秒级，不需要编译
+npm run test:watch
+```
+
+端到端用例会真的执行 `sp connect <client>`，覆盖 cursor、pi、omp、claude-code、codex、opencode、grok 与 command-code，OAuth 与 API key 两种形态都断言写出的配置内容或传给客户端的命令参数。**不需要本机装任何客户端，也不会碰你的真实配置**，靠三点做到：
+
+- `HOME` 指向临时目录，配置写进沙箱
+- `PATH` 前置 stub 目录，用假的 harness 命令记录收到的参数；`open` 也被顶掉，否则会真的弹浏览器
+- `--url` 指向 `127.0.0.1:1`，凭证探测立即失败，不访问外网
+
+改动安装流程后跑 `npm test` 即可，不必再逐个平台手工装一遍。Hermes 与 OpenClaw 依赖尚未就绪的外部资源，不在覆盖范围内。
+
+给 stub 加能力时注意：各客户端的能力探测用的是锚定行首的正则（如 `^\s*add(?:\s|\[)`），子命令名必须各占一行。`--header` 与 `--bearer-token-env-var` 决定 key 形态是否可用——stub 的 `--help` 里缺了它们，`--api-key` 会被无声降级成 OAuth 或直接拒绝。
+
+## TODO
+
+以下能力尚未支持，按需要程度排列。
+
+### 会影响现有安装流程
+
+- [x] **`--launch` 的引导语引用了不存在的工具**。`connect-clients.ts` 里的 `DEFAULT_ONBOARDING_PROMPT` 曾让 agent 调用上游的 `guide_next_step`，`OPENCLAW_ONBOARDING_PROMPT` 引用了已移除的 Search / Fetch / Agent 能力；`connect-all.ts` 的 `FIRST_TASK_PROMPT` 也还在让 agent 使用不存在的「SpringBrand search/fetch tool」。三处均已按 `search_tools` → `get_tool_schemas` →（需要时）`manage_connections` → `execute_tools` → `get_execution` 的元工具流程重写，并有 `branding.test.ts` 锁定。
+- [x] **`config-claude` 已取消注册**。它的作用是改写 `~/.claude/CLAUDE.md` 与 `~/.claude/settings.json`，把 Claude Code 内置的 `WebSearch`/`WebFetch` 引导到 `sp search` / `sp fetch`，而这两个命令已随业务能力一并移除；写入的权限规则 `Bash(springbrand:*)` 里的名字也不是实际的 bin 名 `sp`。已从 `program.ts` 的命令表移除，`commands/config-claude.ts` 与 `lib/claude-config.ts` 保留，等 Web 能力落地后改掉命令名即可重新挂上。
+
+### 外部资源未就绪
+
+- [ ] **Hermes 插件仓库不存在**。`hermes-plugin.ts` 会从 `springbrand-lab/springbrand-web-agent-integrations.git` 克隆插件，并锚定着上游的 commit SHA `496cd63`。仓库建立前，`sp connect hermes` 的插件安装步骤必然失败。
+- [ ] **OpenClaw skill 包未发布**。OpenClaw 不接受外部往目录里写 skill，只能通过 ClawHub 安装 `@springbrand/springbrand`。该包尚未发布，`sp connect openclaw` 的 skill 步骤会失败。内容可直接复用 `skill/use-springbrand/`。
+
+### 能力待补
+
+- [ ] **`onboard` 命令**（首次使用引导）。上游版本的主体是 Search → Fetch 的现场演示，依赖已移除的业务模块。Gateway 的能力在 MCP 层、只有 agent 能调用，CLI 自身无法当场演示，因此引导流程需要重新设计——要么把演示交给 agent 完成，要么退化成「检测 → 连接 → 启动」。与上面的引导语重写是同一件事。
+- [ ] **key 管理页地址未定**。`sp auth login` 需要打开一个网页让用户创建并复制 key，那个页面属于 sp-platform 的 Web 应用，路径尚未确定。当前 `constants.ts` 用占位值 `https://springbrand.ai/account-settings`，可由 `SPRINGBRAND_WEB_URL` 覆盖；页面上线后改这一个常量即可。`sp auth set`（手动粘贴或管道输入）不受影响。
+- [ ] **其他工具命令**。上游的 `search`、`fetch`、`browser`、`run`、`runs`、`batch`、`profile`、`vault`、`wallet` 均未复刻。按当前定位不做，后续按需增加。
+
+### 工程链路
+
+- [x] **自动化测试**。已覆盖配置写入安全、品牌标识回归、key 格式与错误分类，以及 8 个客户端在 OAuth 与 API key 两种形态下的端到端安装（见「测试」一节）。尚未覆盖：Hermes 与 OpenClaw（外部资源未就绪）、与真实平台验钥的联调。
+- [ ] **缺少 lint / format 脚本**，也没有发布流程，`@springbrand/cli` 尚未发布。
+
+### 文档
+
+早期自动生成的一批文档与脚本已清理（描述的命令与路径均不存在），本 README 为唯一权威入口。仓库根目录下的 `PROJECT-OVERVIEW.md`、`TASK-COMPLETE.md` 与 `docs/cli-*.md` 出自同一批生成，尚待确认是否保留。

package/dist/commands/auth.d.ts

@@ -0,0 +1,4 @@
+/** 复刻自 tiny-fish CLI 编译产物：auth.d.ts + auth.impl.js */
+import type { Command } from 'commander';
+export declare function registerAuth(program: Command): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8HzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsHnD"}

package/dist/commands/auth.js

@@ -0,0 +1,241 @@
+/** 复刻自 tiny-fish CLI 编译产物：auth.d.ts + auth.impl.js */
+import { spawn } from 'child_process';
+import * as readline from 'readline';
+import { Option } from 'commander';
+import { CONNECT_ATTEMPT_ENV, KEY_FORMAT_HINT, clearConfig, configFile, getDashboardUrl, loadConfig, maskKey, parseKeyIdentity, savePendingConnectAttempt, saveConfig, validateKeyFormat, } from '../lib/auth.js';
+import { SPRINGBRAND_API_KEY_VAR } from '../lib/constants.js';
+import { err, errLine, out, outLine, warnLine } from '../lib/output.js';
+import { verifyMcpAuth } from '../lib/verify.js';
+/**
+ * Read a key from stdin without echoing it to the terminal.
+ * Uses setRawMode on TTY so characters are never written to the screen.
+ * Falls back to plain readline when stdin is not a TTY (piped CI/CD input).
+ */
+async function readKeyHidden(prompt) {
+    process.stderr.write(prompt);
+    if (!process.stdin.isTTY) {
+        // Non-interactive (piped): read stdin line as-is — no echo suppression needed
+        const rl = readline.createInterface({ input: process.stdin, terminal: false });
+        return new Promise((resolve) => {
+            rl.once('line', (line) => {
+                rl.close();
+                resolve(line.trim());
+            });
+        });
+    }
+    // Interactive TTY: use raw mode so keystrokes are never echoed
+    return new Promise((resolve) => {
+        let input = '';
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onData = (char) => {
+            if (char === '\r' || char === '\n') {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeListener('data', onData);
+                process.stderr.write('\n');
+                resolve(input);
+            }
+            else if (char === '\u0003') {
+                // Ctrl+C — restore terminal state before exiting
+                process.stdin.setRawMode(false);
+                process.exit(130);
+            }
+            else if (char === '\u007f' || char === '\b') {
+                // Backspace / Delete
+                input = input.slice(0, -1);
+            }
+            else {
+                input += char;
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+/**
+ * Read key from piped stdin (CI/CD) or hidden TTY prompt (interactive).
+ * Never reads from a positional arg — avoids shell history / process list exposure.
+ */
+async function readKeyFromStdinOrPrompt() {
+    if (!process.stdin.isTTY) {
+        // Piped input: echo $KEY | sp auth set
+        return new Promise((resolve) => {
+            let data = '';
+            process.stdin.setEncoding('utf8');
+            process.stdin.on('data', (chunk) => (data += chunk));
+            process.stdin.on('end', () => resolve(data.trim()));
+        });
+    }
+    return readKeyHidden('Paste your API key: ');
+}
+// Sign-in and the connect that follows are separate copied commands, so a page-minted id
+// handed to this process has to outlive it.
+function parkSeedAttempt() {
+    const seed = process.env[CONNECT_ATTEMPT_ENV];
+    if (seed)
+        savePendingConnectAttempt(seed);
+}
+// Env var wins every later lookup; a silent save misleads.
+function warnIfEnvShadows(savedKey) {
+    const envKey = process.env[SPRINGBRAND_API_KEY_VAR];
+    if (!envKey || envKey === savedKey)
+        return;
+    warnLine(`Warning: ${SPRINGBRAND_API_KEY_VAR} is set in your environment and overrides the key just saved. ` +
+        `Unset it or update your shell profile, then check with 'sp auth status'.`);
+}
+function keyFromConfig() {
+    const stored = loadConfig().api_key;
+    return stored ? { key: stored, source: 'config', where: configFile() } : undefined;
+}
+/** `--verify` only: says the endpoint accepts the key, never that an agent has loaded SpringBrand. */
+async function checkKey(key) {
+    const result = await verifyMcpAuth(key);
+    if (result.ok) {
+        return {
+            verified: 'ok',
+            ...(result.identity
+                ? { account_id: result.identity.accountId, verified_environment: result.identity.environment }
+                : {}),
+        };
+    }
+    return {
+        verified: result.kind ?? 'retryable',
+        verify_detail: result.code ?? 'the authenticated call failed',
+        ...(result.errorCode ? { verify_code: result.errorCode } : {}),
+    };
+}
+function renderStatus(where, key, identity, verified) {
+    const lines = [`Source:  ${where}`, `Key:     ${maskKey(key)}`];
+    if (identity) {
+        lines.push(`Env:     ${identity.environment}`, `Key ID:  ${identity.keyId}`);
+    }
+    if (verified?.verified === 'ok') {
+        const account = verified.account_id ? ` (account ${verified.account_id})` : '';
+        lines.push(`Checked: SpringBrand accepted this key${account}`);
+    }
+    else if (verified) {
+        lines.push(`Checked: ${verified.verify_detail}`);
+    }
+    return lines.join('\n');
+}
+export function registerAuth(program) {
+    const auth = program.command('auth').description('Manage your SpringBrand API key');
+    auth
+        .command('login')
+        .description('Open the API keys page and save your key interactively')
+        .addOption(new Option('--source <source>', 'API keys page source attribution').default('cli').hideHelp())
+        .action(async (options) => {
+        const dashboardUrl = getDashboardUrl(options.source);
+        errLine(`Opening ${dashboardUrl} in your browser...`);
+        try {
+            // Use spawn with an explicit args array — no shell, no interpolation
+            let cmd;
+            let args;
+            if (process.platform === 'darwin') {
+                cmd = 'open';
+                args = [dashboardUrl];
+            }
+            else if (process.platform === 'win32') {
+                // "start" treats the first quoted arg as a window title — empty string avoids it
+                cmd = 'cmd';
+                args = ['/c', 'start', '', dashboardUrl];
+            }
+            else {
+                cmd = 'xdg-open';
+                args = [dashboardUrl];
+            }
+            const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+            child.unref();
+            child.on('error', () => { }); // headless — ignore
+        }
+        catch {
+            // headless — ignore
+        }
+        process.stderr.write(`If the browser didn't open, visit: ${dashboardUrl}\n\n`);
+        const key = await readKeyHidden('Paste your API key: ');
+        if (!key) {
+            err('API key cannot be empty');
+            process.exit(1);
+        }
+        if (!validateKeyFormat(key)) {
+            err(`Invalid key format. ${KEY_FORMAT_HINT}`);
+            process.exit(1);
+        }
+        saveConfig(key);
+        parkSeedAttempt();
+        out({ status: 'ok', message: 'API key saved', key_preview: maskKey(key) });
+        warnIfEnvShadows(key);
+    });
+    auth
+        .command('set')
+        .description('Save an API key. Pass via stdin: echo $KEY | sp auth set (safe for CI/CD)')
+        .action(async () => {
+        // Read from stdin pipe (CI/CD) or hidden TTY prompt (interactive)
+        const key = await readKeyFromStdinOrPrompt();
+        if (!key) {
+            // `echo $KEY | sp auth set` with KEY unset pipes a blank line, not a key.
+            err(process.stdin.isTTY
+                ? 'API key cannot be empty'
+                : "No key received on stdin. Example: echo 'sbk_v1_production_...' | sp auth set");
+            process.exit(1);
+        }
+        if (!validateKeyFormat(key)) {
+            err(`Invalid key format. ${KEY_FORMAT_HINT}`);
+            process.exit(1);
+        }
+        saveConfig(key);
+        parkSeedAttempt();
+        out({ status: 'ok', message: 'API key saved', key_preview: maskKey(key) });
+        warnIfEnvShadows(key);
+    });
+    auth
+        .command('status')
+        .description('Show which API key is active and its source')
+        .option('--pretty', 'Human-readable output')
+        .option('--verify', 'Also check the key against the SpringBrand MCP endpoint')
+        .action(async (opts) => {
+        const envKey = process.env[SPRINGBRAND_API_KEY_VAR];
+        const active = envKey
+            ? { key: envKey, source: 'env', where: `environment variable (${SPRINGBRAND_API_KEY_VAR})` }
+            : keyFromConfig();
+        if (!active) {
+            const result = { source: 'none', key_preview: null, authenticated: false };
+            if (opts.pretty)
+                outLine('No API key configured. Run: sp auth login');
+            else
+                out(result);
+            process.exit(1);
+        }
+        const authenticated = validateKeyFormat(active.key);
+        const identity = parseKeyIdentity(active.key);
+        // Local shape only unless --verify: a status query must not cost a round-trip.
+        const verified = opts.verify ? await checkKey(active.key) : undefined;
+        const result = {
+            source: active.source,
+            key_preview: maskKey(active.key),
+            authenticated,
+            ...(identity ? { environment: identity.environment, key_id: identity.keyId } : {}),
+            ...(verified ?? {}),
+        };
+        if (opts.pretty) {
+            outLine(renderStatus(active.where, active.key, identity, verified));
+        }
+        else {
+            out(result);
+        }
+        if (verified?.verified === 'credential_rejected')
+            process.exit(1);
+    });
+    auth
+        .command('logout')
+        .description('Remove stored API key')
+        .action(() => {
+        if (!clearConfig()) {
+            out({ status: 'ok', message: 'No API key stored' });
+            return;
+        }
+        out({ status: 'ok', message: 'API key removed' });
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"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"}

package/dist/commands/check-version.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCheckVersion(program: Command): void;
+//# sourceMappingURL=check-version.d.ts.map

package/dist/commands/check-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-version.d.ts","sourceRoot":"","sources":["../../src/commands/check-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6FzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B3D"}

package/dist/commands/check-version.js

@@ -0,0 +1,112 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { configDir } from '../lib/auth.js';
+import { BASE_URL, CLI_VERSION } from '../lib/constants.js';
+import { out } from '../lib/output.js';
+/**
+ * `sp check-version` 供 agent 在任务收尾时调用。
+ *
+ * 独立于 connect / doctor 的通告：那条路搭在安装上报上，而用户装完就不再跑安装
+ * 命令，触达不到。这条由 skill 指引 agent 主动调用，不依赖用户的主动性，也不需要
+ * 改 MCP 契约。
+ *
+ * 因此必须便宜：结果带本地缓存，否则 agent 每完成一次任务就给 Gateway 加一次请求。
+ */
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000;
+const REQUEST_TIMEOUT_MS = 3_000;
+function cacheFile() {
+    return path.join(configDir(), 'version-check.json');
+}
+function readCache() {
+    try {
+        const raw = JSON.parse(fs.readFileSync(cacheFile(), 'utf8'));
+        if (typeof raw.checkedAt !== 'number')
+            return undefined;
+        return {
+            checkedAt: raw.checkedAt,
+            latest: typeof raw.latest === 'string' ? raw.latest : null,
+            minimum: typeof raw.minimum === 'string' ? raw.minimum : null,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeCache(entry) {
+    try {
+        fs.mkdirSync(configDir(), { recursive: true });
+        fs.writeFileSync(cacheFile(), JSON.stringify(entry));
+    }
+    catch {
+        // 缓存写不进去不影响结论，静默即可
+    }
+}
+const PLAIN_VERSION = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/;
+function compareVersions(left, right) {
+    const a = left.split('.').map(Number);
+    const b = right.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return (a[i] ?? 0) < (b[i] ?? 0) ? -1 : 1;
+    }
+    return 0;
+}
+function verdict(latest, minimum) {
+    if (!PLAIN_VERSION.test(CLI_VERSION))
+        return null;
+    if (minimum && PLAIN_VERSION.test(minimum) && compareVersions(CLI_VERSION, minimum) < 0)
+        return 'required';
+    if (latest && PLAIN_VERSION.test(latest) && compareVersions(CLI_VERSION, latest) < 0)
+        return 'recommended';
+    return null;
+}
+async function fetchVersions(baseUrl) {
+    const response = await fetch(new URL('/api/cli/version', baseUrl), {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`the endpoint returned HTTP ${response.status}`);
+    const body = (await response.json());
+    return {
+        latest: typeof body.latest === 'string' ? body.latest : null,
+        minimum: typeof body.minimum === 'string' ? body.minimum : null,
+    };
+}
+export function registerCheckVersion(program) {
+    program
+        .command('check-version')
+        .description('Report whether this CLI is current; exits 1 only when an upgrade is required')
+        .option('--force', 'Skip the local cache and query the server')
+        .option('--url <baseUrl>', 'Gateway base URL override')
+        .action(async (options) => {
+        const cached = options.force ? undefined : readCache();
+        if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+            const update = verdict(cached.latest, cached.minimum);
+            report({ current: CLI_VERSION, latest: cached.latest, minimum: cached.minimum, update, cached: true });
+            return;
+        }
+        try {
+            const { latest, minimum } = await fetchVersions(options.url ?? BASE_URL);
+            writeCache({ checkedAt: Date.now(), latest, minimum });
+            report({ current: CLI_VERSION, latest, minimum, update: verdict(latest, minimum) });
+        }
+        catch (e) {
+            // 查不到版本绝不能挡住用户干活，也不该让 agent 以为需要升级
+            report({
+                current: CLI_VERSION,
+                latest: null,
+                minimum: null,
+                update: null,
+                unavailable: e instanceof Error ? e.message : String(e),
+            });
+        }
+    });
+}
+/** 退出码承载强制语义，agent 与脚本都能据此判断，无需解析文案 */
+function report(result) {
+    out(result);
+    if (result.update === 'required')
+        process.exit(1);
+}
+//# sourceMappingURL=check-version.js.map

package/dist/commands/check-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-version.js","sourceRoot":"","sources":["../../src/commands/check-version.ts"],"names":[],"mappings":"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"}

package/dist/commands/config-claude.d.ts

@@ -0,0 +1,4 @@
+/** 复刻自 tiny-fish CLI 编译产物：config-claude.d.ts + config-claude.impl.js */
+import type { Command } from 'commander';
+export declare function registerConfigureClaude(program: Command): void;
+//# sourceMappingURL=config-claude.d.ts.map

package/dist/commands/config-claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-claude.d.ts","sourceRoot":"","sources":["../../src/commands/config-claude.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc9D"}

package/dist/commands/config-claude.js

@@ -0,0 +1,78 @@
+/** 复刻自 tiny-fish CLI 编译产物：config-claude.d.ts + config-claude.impl.js */
+import { err, errLine, out } from '../lib/output.js';
+import { validatedApiKey } from '../lib/auth.js';
+import { readSettingsJson, writeSettingsJson, readClaudeMd, writeClaudeMd, mergeSettings, removeFromSettings, mergeClaudeMd, removeFromClaudeMd, claudeSettingsPath, claudeMdPath, isSpringbrandConfiguredInSettings, isSpringbrandConfiguredInClaudeMd, } from '../lib/claude-config.js';
+function loadExistingConfig() {
+    let settings;
+    try {
+        settings = readSettingsJson();
+    }
+    catch (e) {
+        err({
+            error: `Cannot read ${claudeSettingsPath()}: ${e instanceof Error ? e.message : String(e)}. Fix it manually before running this command.`,
+        });
+        process.exit(1);
+    }
+    let claudeMd;
+    try {
+        claudeMd = readClaudeMd();
+    }
+    catch (e) {
+        err({
+            error: `Cannot read ${claudeMdPath()}: ${e instanceof Error ? e.message : String(e)}`,
+        });
+        process.exit(1);
+    }
+    return { settings, claudeMd };
+}
+function isSignedIn() {
+    return !!validatedApiKey();
+}
+function install(settings, claudeMd) {
+    errLine('Configuring Claude Code to use SpringBrand...\n');
+    writeSettingsJson(mergeSettings(settings));
+    errLine('  Updated settings.json (permission + hooks)');
+    const { content, replaced } = mergeClaudeMd(claudeMd);
+    writeClaudeMd(content);
+    errLine(replaced
+        ? '  Updated CLAUDE.md (replaced existing SpringBrand block)'
+        : '  Updated CLAUDE.md (added SpringBrand instructions)');
+    errLine('\nClaude Code is now configured to use SpringBrand for web search and fetch! 🚀');
+    const signedIn = isSignedIn();
+    if (!signedIn) {
+        errLine('\nNote: You are not signed in to SpringBrand yet. The configuration is in place,');
+        errLine('but search and fetch will not work until you sign in. Run:\n');
+        errLine('  sp auth login');
+    }
+    out({ status: 'ok', action: 'configured', signed_in: signedIn });
+}
+function remove(settings, claudeMd) {
+    if (!isSpringbrandConfiguredInSettings(settings) && !isSpringbrandConfiguredInClaudeMd(claudeMd)) {
+        errLine('SpringBrand is not configured in Claude Code. Nothing to remove.');
+        out({ status: 'ok', action: 'noop' });
+        return;
+    }
+    errLine('Removing SpringBrand configuration from Claude Code...\n');
+    writeSettingsJson(removeFromSettings(settings));
+    errLine('  Cleaned settings.json');
+    writeClaudeMd(removeFromClaudeMd(claudeMd));
+    errLine('  Cleaned CLAUDE.md');
+    errLine('\nSpringBrand configuration removed from Claude Code.');
+    out({ status: 'ok', action: 'removed' });
+}
+export function registerConfigureClaude(program) {
+    program
+        .command('config-claude')
+        .description('Configure Claude Code to use SpringBrand for web search and fetch')
+        .option('--remove', 'Remove SpringBrand configuration from Claude Code')
+        .action(async (opts) => {
+        const { settings, claudeMd } = loadExistingConfig();
+        if (opts.remove) {
+            remove(settings, claudeMd);
+        }
+        else {
+            install(settings, claudeMd);
+        }
+    });
+}
+//# sourceMappingURL=config-claude.js.map