sino-bc-cli 1.8.1 → 1.8.3

package/dist/skills/sino-bc-shared/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: sino-bc-shared
+description: >
+  Use for sino-bc-cli 配置、鉴权头、JSON 信封、写操作确认门、禁止拼 HTTP、
+  以及 /init / /get-config / /set-config。
+  其他 sino-bc-* 技能执行前先读本文件。
+metadata:
+  requires:
+    bins: ["sino-bc-cli"]
+---
+
+# sino-bc-cli 共享规则
+
+业务线意图走 [`../sino-bc-biz-line/SKILL.md`](../sino-bc-biz-line/SKILL.md)。本文件只管横切约定。
+
+## 通用准则
+
+1. **直接用本 CLI 执行**，不要自己拼网关 HTTP。地址、`/sino-opti-hive`、`Authorization`、`X-GATEWAY-TYPE: A2C-CLI` 都由 CLI 注入。
+2. **判断成功看 `ok == true` 或退出码 0**，不要看上游 `code`。信封与分流 → [`references/output-contract.md`](references/output-contract.md)。
+3. **退出码 10 是写操作待确认，不是错误**。停下向用户确认环境和意图，得到同意后在原命令末尾追加 `--yes`。**不要自行补 `--yes`**。→ [`references/write-approval.md`](references/write-approval.md)。
+4. **完整 API_KEY 不要回显。**
+
+## 环境与配置
+
+环境、`API_KEY` 在 `~/.sino-bc-cli/config.json`，由 `/init` 创建、`/set-config` 修改。默认环境 `prod`。详情 → [`references/config-and-env.md`](references/config-and-env.md)。
+
+```bash
+sino-bc-cli /init
+sino-bc-cli /get-config --json
+sino-bc-cli /set-config env prod
+```
+
+升级 CLI 后重新执行 `/init`，以刷新本机技能树。
+
+## 不要用本技能处理
+
+本仓库源码开发、扩展命令、npm 发版（见仓库 `README.md` / `ReleaseSteps.md`）。

package/dist/skills/sino-bc-shared/references/config-and-env.md

@@ -0,0 +1,12 @@
+# 环境与变量配置
+
+| 项 | 规则 |
+| --- | --- |
+| 环境 | `test` / `pre` / `prod`，取自 `~/.sino-bc-cli/config.json`，默认 `prod` |
+| 网关 | `https://test-agent.beyondclick.com`（当前三环境同一地址；由 CLI 请求，不直连服务地址） |
+| 业务线前缀 | `/sino-opti-hive` |
+| 鉴权 | `Authorization: Bearer <API_KEY>`；由 CLI 注入 |
+| 来源头 | `X-GATEWAY-TYPE: A2C-CLI`（固定写入，不开放配置） |
+
+`/get-config --json` 查看生效取值（密钥默认打码，加 `--show-secret` 才是明文）。
+修改：`sino-bc-cli /set-config env test` 或 `/set-config api-key <值>`。

package/dist/skills/sino-bc-shared/references/output-contract.md

@@ -0,0 +1,20 @@
+# JSON 输出契约
+
+非 TTY 默认 `--format json`；TTY 默认 `table`。可用 `--format json|table` 覆盖。
+
+成功写 **stdout**，退出码 `0`：
+
+```json
+{ "ok": true, "env": "prod", "command": "biz-line +list", "data": [], "meta": { "count": 0 } }
+```
+
+失败写 **stderr**，退出码非 0：
+
+```json
+{ "ok": false, "env": "prod", "command": "biz-line +delete", "error": { "type": "validation", "message": "...", "hint": "..." } }
+```
+
+- `data` 只放上游 `result`。判断成功只看 `ok` 或进程退出码，**不要**用上游 `code == 0`。
+- `error.type`：`validation` / `config` / `api` / `confirmation_required`。
+- `confirmation_required` 的退出码是 `10`，不是失败。
+- 提示与进度走 stderr，避免污染信封。

package/dist/skills/sino-bc-shared/references/write-approval.md

@@ -0,0 +1,18 @@
+# 写操作确认门
+
+描述含 ⚠️ 的 Shortcut 与 `biz-line api <name>` 都走同一道门。
+
+```text
+--dry-run     只打印 method / url / body，不发请求
+无 --yes      TTY：展示 env + 动作 + 关键参数，交互确认
+              非 TTY：exit 10，error.type = confirmation_required
+--yes         直接发起请求
+```
+
+Agent 收到退出码 `10` 时：
+
+1. 停下，向用户展示环境、动作和关键参数。
+2. 取得**用户显式同意**后，把 `--yes` **追加到原命令末尾**再执行。
+3. **不要**自行补 `--yes` 绕过。
+
+禁止把文档示例里的 `bizLineId: 1251` 当真实数据提交。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sino-bc-cli",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "description": "BeyondClick CLI - 命令行工具集合，提供快捷访问 BeyondClick 平台的命令行接口",
   "preferGlobal": true,
   "bin": {
@@ -21,6 +21,8 @@
     "build": "node --experimental-strip-types scripts/build.ts",
     "build:no-mangle": "node --experimental-strip-types scripts/build.ts --no-mangle",
     "typecheck": "tsc --noEmit",
+    "test": "node --require ts-node/register --test \"tests/**/*.test.ts\"",
+    "sync-api-doc": "node --require ts-node/register src/apifox/run-sync.ts",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
     "clean": "rimraf dist",