@qfeius/everyline-cli 0.1.0

package/README.md

@@ -0,0 +1,81 @@
+# everyline-cli
+
+智审开放平台 V3 的 Go 命令行客户端。覆盖接口文档中的 25 个远端 operation 映射：Profile/tenant token、合同审查工作流、审查清单以及规则分组/规则管理；其中 21 项已开放真实调用，4 项缺字段级详情的批量写操作失败关闭。文件快照和字段捷径接口按当前 CLI 范围暂不纳入同步。
+
+## 构建
+
+需要 Go 1.24 或更高版本。
+
+```bash
+make test
+make build
+./bin/everyline-cli version
+```
+
+## 快速开始
+
+```bash
+everyline-cli config add dev \
+  --env dev \
+  --app-id cli_xxx
+
+export EVERYLINE_APP_SECRET='replace-me'
+everyline-cli auth login
+
+everyline-cli review run --input review-run.json --output json
+```
+
+URL 来源的一键审查输入还需提供 `businessId` 与对应文件内容的 SHA-256 `fileHash`，因为标准 URL 上传接口的响应只返回 `fileId`。
+
+`appType=CLM` 时，本地文件上传也必须提供 `businessId`；CLI 会在上传前校验这一条件。
+
+也可以使用内置环境地址创建 `test`、`blue` 或线上 `prod` Profile（`app-id` 仍需替换为该环境的应用 ID）：
+
+```bash
+everyline-cli config add test --env test --app-id cli_test_xxx
+everyline-cli config add blue --env blue --app-id cli_blue_xxx
+everyline-cli config add prod --env prod --app-id cli_prod_xxx
+```
+
+`app_secret` 不写入 Profile，也不提供明文命令行参数。可使用 `EVERYLINE_APP_SECRET`、Profile 专用变量或 `auth login --app-secret-stdin`。专用变量以 `EVERYLINE_APP_SECRET_` 开头；常见的小写字母映射为大写，数字保持不变，其他 UTF-8 字节（包括原始大写字母）编码为 `_XX`，因此后缀可逆且不会因大小写或符号碰撞。例如 `prod-eu`、`prod.eu`、`prod_eu` 分别对应 `EVERYLINE_APP_SECRET_PROD_2DEU`、`EVERYLINE_APP_SECRET_PROD_2EEU`、`EVERYLINE_APP_SECRET_PROD_5FEU`。token 缓存在权限为 `0600` 的 `~/.everyline-cli/tokens.json`；CI 可用 `EVERYLINE_ACCESS_TOKEN` 覆盖。
+
+CLI 同时支持 `app` 和 `user` 两种身份。`--env` 会自动写入每个环境对应的智审自有认证页面：dev 为 `https://dev-contract-agent.qtech.cn`、test 为 `https://test-contract-agent.qtech.cn`、blue 为 `https://blue-contract-agent.qtech.cn`、prod 为 `https://contract-agent.qfei.cn`。用户在页面完成认证后，将页面交接的 access token 通过 stdin 或 `EVERYLINE_USER_ACCESS_TOKEN` 注入 CLI：
+
+```bash
+everyline-cli auth login --as user --access-token-stdin
+everyline-cli auth use --as user
+everyline-cli review run --as user --input review-run.json --output json
+```
+
+`auth login --as user` 缺少 token 时会输出当前 Profile 的自有认证页面地址；CLI 不猜测页面内部协议。app/user token 在本地缓存中隔离保存。
+
+## 一键审查输入
+
+```json
+{
+  "source": {
+    "type": "file",
+    "path": "./contract.pdf",
+    "name": "采购合同.pdf"
+  },
+  "businessId": "biz-001",
+  "appType": "THIRD_PARTY",
+  "config": {},
+  "extractSubjects": true,
+  "wait": true
+}
+```
+
+完整命令和 25 项接口映射见 [命令参考](docs/command-reference.md) 与 [API 映射](docs/api-mapping.md)。清单、规则分组和规则的所有删除操作都要求显式 `--yes`；`--dry-run` 不调用远端。
+
+可通过 `everyline-cli completion bash|fish|powershell|zsh` 生成 shell 补全脚本。四个尚缺字段级详情页的批量创建/更新命令仅开放 `--dry-run`，真实请求会失败关闭，具体清单见 API 映射。
+
+## npm/npx 包装
+
+Node 包只负责启动对应平台的 Go 二进制，CLI 本体没有 Node 运行时依赖。发布前运行 `scripts/build-release-assets.sh` 生成六个平台架构的 `bin/<platform>-<arch>/everyline-cli`。CI 会把 tag 或提交版本规范化为 SemVer、同步到 npm manifest，并产出带正确版本号的 `.tgz` 制品。
+
+安装 scoped npm 包后，执行文件名仍为 `everyline-cli`：
+
+```bash
+npx @qfeius/everyline-cli version
+```

package/bin/checksums.txt

@@ -0,0 +1,6 @@
+dfdda90355f81c7664bac25259861a37b6b6aaf8ee992e3a1a840325fc2976ba  bin/darwin-amd64/everyline-cli
+f787c5d8b54cf14535539adc776bee653562e334a0cf144706cd0cb248d25367  bin/darwin-arm64/everyline-cli
+8a2dfb62c84e525c74cc6da27ff68e216c5e58c26b9cbb152053fbc1cf565d15  bin/linux-amd64/everyline-cli
+fe8cef0cbee70134643aaf3785a8ab86c6f4b25327e9e6ec0b89d29285e6f80c  bin/linux-arm64/everyline-cli
+4517cf530bb5471c1564a9e93b7edf6ff963055d9b38cd9b16bb1b87a20a807e  bin/windows-amd64/everyline-cli.exe
+e1634c4036ca5c67e6d1ccabe24bfd3baba55d0858f98b61d10ece0471ba6db0  bin/windows-arm64/everyline-cli.exe

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@qfeius/everyline-cli",
+  "version": "0.1.0",
+  "description": "智审开放平台 V3 命令行客户端的 npm/npx 薄包装",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yuwenGueen/everyline-cli.git"
+  },
+  "bin": {
+    "everyline-cli": "scripts/run.js"
+  },
+  "files": [
+    "bin/checksums.txt",
+    "bin/darwin-amd64/",
+    "bin/darwin-arm64/",
+    "bin/linux-amd64/",
+    "bin/linux-arm64/",
+    "bin/windows-amd64/",
+    "bin/windows-arm64/",
+    "scripts/install.js",
+    "scripts/package-version.js",
+    "scripts/platform.js",
+    "scripts/run.js",
+    "scripts/verify-package-version.js"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "prepack": "node scripts/verify-package-version.js",
+    "test": "node --test tests/release/platform.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+const { chmodSync, existsSync } = require("node:fs");
+const { join } = require("node:path");
+const { resolvePlatformTarget } = require("./platform");
+
+// npm 安装必须确认当前平台产物真实存在，防止留下“安装成功但无法运行”的包。
+const executable = process.platform === "win32" ? "everyline-cli.exe" : "everyline-cli";
+const binary = join(__dirname, "..", "bin", resolvePlatformTarget(), executable);
+if (!existsSync(binary)) {
+  throw new Error(`npm 包缺少当前平台二进制: ${binary}`);
+}
+if (process.platform !== "win32") {
+  chmodSync(binary, 0o755);
+}

package/scripts/package-version.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * normalizePackageVersion 将 Git tag 或提交描述转换为 npm 可接受且可追溯的 SemVer。
+ * 入参：value string，为发布 tag、CI 版本或 git describe 结果。
+ * 返回值：string；合法 SemVer 保留并去掉前导 v，其他值映射为 0.0.0-build-* 预发布版本。
+ */
+function normalizePackageVersion(value) {
+  const source = String(value || "").trim();
+  const candidate = source.replace(/^v(?=\d)/, "");
+  const semver = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+  if (semver.test(candidate)) {
+    return candidate;
+  }
+  const normalized = source
+    .toLowerCase()
+    .replace(/[^0-9a-z-]+/g, "-")
+    .replace(/^-+|-+$/g, "") || "development";
+  return `0.0.0-build-${normalized}`;
+}
+
+if (require.main === module) {
+  process.stdout.write(normalizePackageVersion(process.argv[2]));
+}
+
+module.exports = { normalizePackageVersion };

package/scripts/platform.js

@@ -0,0 +1,20 @@
+"use strict";
+
+const platformMap = Object.freeze({ darwin: "darwin", linux: "linux", win32: "windows" });
+const architectureMap = Object.freeze({ x64: "amd64", arm64: "arm64" });
+
+/**
+ * resolvePlatformTarget 将 Node 平台名映射为 GoReleaser/npm 产物目录名。
+ * 入参：platform string 为 Node process.platform；architecture string 为 Node process.arch。
+ * 返回值：string，格式为 goos-goarch；不支持的平台或架构会抛出 Error。
+ */
+function resolvePlatformTarget(platform = process.platform, architecture = process.arch) {
+  const targetPlatform = platformMap[platform];
+  const targetArchitecture = architectureMap[architecture];
+  if (!targetPlatform || !targetArchitecture) {
+    throw new Error(`不支持的平台或架构: ${platform}/${architecture}`);
+  }
+  return `${targetPlatform}-${targetArchitecture}`;
+}
+
+module.exports = { resolvePlatformTarget };

package/scripts/run.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { dirname, join } = require("node:path");
+const { resolvePlatformTarget } = require("./platform");
+
+/**
+ * resolveBinary 根据 Node 平台和架构定位 npm 包内的原生二进制。
+ * 入参：无，读取 process.platform/process.arch 和可选 EVERYLINE_CLI_BINARY。
+ * 返回值：string，可执行文件路径；找不到时抛出 Error。
+ */
+function resolveBinary() {
+  if (process.env.EVERYLINE_CLI_BINARY) {
+    return process.env.EVERYLINE_CLI_BINARY;
+  }
+  const executable = process.platform === "win32" ? "everyline-cli.exe" : "everyline-cli";
+  const packageRoot = join(dirname(__filename), "..");
+  const binary = join(packageRoot, "bin", resolvePlatformTarget(), executable);
+  if (!existsSync(binary)) {
+    throw new Error(
+      `当前 npm 包缺少 ${process.platform}/${process.arch} 二进制；请使用原生发布包，或设置 EVERYLINE_CLI_BINARY`,
+    );
+  }
+  return binary;
+}
+
+try {
+  const result = spawnSync(resolveBinary(), process.argv.slice(2), { stdio: "inherit" });
+  if (result.error) {
+    throw result.error;
+  }
+  process.exitCode = result.status ?? 1;
+} catch (error) {
+  process.stderr.write(`everyline-cli: ${error.message}\n`);
+  process.exitCode = 1;
+}

package/scripts/verify-package-version.js

@@ -0,0 +1,11 @@
+"use strict";
+
+const { readFileSync } = require("node:fs");
+const { join } = require("node:path");
+const { normalizePackageVersion } = require("./package-version");
+
+const packagePath = join(__dirname, "..", "package.json");
+const packageData = JSON.parse(readFileSync(packagePath, "utf8"));
+if (packageData.version === "0.0.0-development" || normalizePackageVersion(packageData.version) !== packageData.version) {
+  throw new Error(`拒绝打包未同步的 npm 版本: ${packageData.version}`);
+}