@lark-apaas/miaoda-cli 0.1.0-alpha.097a394

package/dist/cli/handlers/shared.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSize = formatSize;
+exports.formatTime = formatTime;
+exports.renderAlignedTable = renderAlignedTable;
+exports.renderTsv = renderTsv;
+exports.renderKeyValue = renderKeyValue;
+exports.emitOk = emitOk;
+exports.emitPaged = emitPaged;
+exports.isStdoutTty = isStdoutTty;
+exports.parseDuration = parseDuration;
+exports.parseSize = parseSize;
+const output_1 = require("../../utils/output");
+/** 将字节数格式化为人类可读（`24 KB` / `2.1 MB` / `1.5 GB`）。 */
+function formatSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return "—";
+    if (bytes >= 1 << 30)
+        return `${(bytes / (1 << 30)).toFixed(1)} GB`;
+    if (bytes >= 1 << 20)
+        return `${(bytes / (1 << 20)).toFixed(1)} MB`;
+    if (bytes >= 1 << 10)
+        return `${(bytes / (1 << 10)).toFixed(0)} KB`;
+    return `${String(bytes)} bytes`;
+}
+/** 将 ISO 时间转为 TTY 下更友好的相对时间；non-TTY 保持 ISO 原值。 */
+function formatTime(iso, isTty) {
+    if (!iso)
+        return "—";
+    if (!isTty)
+        return iso;
+    const ts = Date.parse(iso);
+    if (Number.isNaN(ts))
+        return iso;
+    const diff = Date.now() - ts;
+    const minute = 60_000;
+    const hour = 60 * minute;
+    const day = 24 * hour;
+    if (diff < hour) {
+        const m = Math.max(1, Math.round(diff / minute));
+        return `${String(m)}m ago`;
+    }
+    if (diff < day) {
+        const h = Math.round(diff / hour);
+        return `${String(h)}h ago`;
+    }
+    if (diff < 7 * day) {
+        const d = Math.round(diff / day);
+        return `${String(d)}d ago`;
+    }
+    // 超过 7 天，用 YYYY-MM-DD
+    const date = new Date(ts);
+    const y = String(date.getFullYear());
+    const mo = String(date.getMonth() + 1).padStart(2, "0");
+    const da = String(date.getDate()).padStart(2, "0");
+    return `${y}-${mo}-${da}`;
+}
+/** 渲染 TTY 对齐表格（多行，列宽按最长内容）。 */
+function renderAlignedTable(headers, rows) {
+    const colWidths = headers.map((h, i) => {
+        let w = h.length;
+        for (const row of rows) {
+            const cell = row[i] || "";
+            if (cell.length > w)
+                w = cell.length;
+        }
+        return w;
+    });
+    const lines = [];
+    lines.push(headers.map((h, i) => h.padEnd(colWidths[i])).join("  ").trimEnd());
+    for (const row of rows) {
+        lines.push(row.map((cell, i) => (cell || "").padEnd(colWidths[i])).join("  ").trimEnd());
+    }
+    return lines.join("\n");
+}
+/** 渲染 non-TTY tab 分隔（字段原值，ISO 时间）。 */
+function renderTsv(headers, rows) {
+    const lines = [];
+    lines.push(headers.join("\t"));
+    for (const row of rows) {
+        lines.push(row.join("\t"));
+    }
+    return lines.join("\n");
+}
+/** 渲染 key-value 多行（用于 stat 等单条详情）。key 右对齐。 */
+function renderKeyValue(pairs, isTty) {
+    if (!isTty) {
+        return pairs.map(([k, v]) => `${k}\t${v}`).join("\n");
+    }
+    const keyWidth = Math.max(...pairs.map(([k]) => k.length));
+    return pairs
+        .map(([k, v]) => `${k.padStart(keyWidth)}:  ${v}`)
+        .join("\n");
+}
+/** 发送成功 JSON envelope（非分页）。 */
+function emitOk(data) {
+    (0, output_1.emit)({ data });
+}
+/** 发送成功 JSON envelope（分页信封：data + next_cursor + has_more）。 */
+function emitPaged(items, nextCursor, hasMore) {
+    (0, output_1.emit)({ data: items, next_cursor: nextCursor, has_more: hasMore });
+}
+/** 通用 isTTY 判定（stdout 是否交互终端）。Node 运行时 isTTY 为 true 或 undefined；TS 类型上 tty.WriteStream 定义为固定 true，绕开做运行时判断。 */
+function isStdoutTty() {
+    const isTTY = process.stdout.isTTY;
+    return isTTY === true;
+}
+/** 解析时长字符串 `7d` / `24h` / `30m` → 秒。无后缀按秒。 */
+function parseDuration(input) {
+    const m = /^(\d+)([smhd]?)$/.exec(input.trim());
+    if (!m) {
+        throw new Error(`Invalid duration: ${input}`);
+    }
+    const n = Number(m[1]);
+    const unit = m[2] || "s";
+    switch (unit) {
+        case "s": return n;
+        case "m": return n * 60;
+        case "h": return n * 3600;
+        case "d": return n * 86400;
+        default: return n;
+    }
+}
+/** 解析 size 字符串 `1MB` / `500KB` / `1GB` → 字节。 */
+function parseSize(input) {
+    const m = /^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?$/i.exec(input.trim());
+    if (!m) {
+        throw new Error(`Invalid size: ${input}`);
+    }
+    const n = Number(m[1]);
+    const unit = (m[2] || "B").toUpperCase();
+    switch (unit) {
+        case "B": return Math.round(n);
+        case "KB": return Math.round(n * 1024);
+        case "MB": return Math.round(n * 1024 * 1024);
+        case "GB": return Math.round(n * 1024 * 1024 * 1024);
+        default: return Math.round(n);
+    }
+}

package/dist/main.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const index_1 = require("./cli/commands/index");
+const config_1 = require("./utils/config");
+const log_id_1 = require("./utils/log_id");
+const output_1 = require("./utils/output");
+const package_json_1 = __importDefault(require("../package.json"));
+const program = new commander_1.Command();
+const { version } = package_json_1.default;
+program
+    .name("miaoda")
+    .description("妙搭平台命令行工具")
+    .version(version, "-v, --version", "显示版本号")
+    .option("--json [fields]", "JSON 输出，可选字段级选择")
+    .option("--output <format>", "输出格式（pretty|json）", "pretty")
+    .option("--verbose", "debug 日志到 stderr")
+    .helpOption("-h, --help", "显示帮助信息")
+    .hook("preAction", (_thisCmd, actionCmd) => {
+    (0, log_id_1.generateLogId)();
+    const opts = actionCmd.optsWithGlobals();
+    (0, config_1.initConfigFromOpts)(opts);
+});
+(0, index_1.registerCommands)(program);
+program.parseAsync(process.argv).catch((err) => {
+    (0, output_1.emitError)(err);
+    process.exitCode = 1;
+});

package/dist/utils/config.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+exports.resetConfig = resetConfig;
+exports.initConfigFromOpts = initConfigFromOpts;
+const defaults = {
+    json: false,
+    output: "pretty",
+    verbose: false,
+};
+let config = { ...defaults };
+function getConfig() {
+    return config;
+}
+function setConfig(partial) {
+    config = { ...config, ...partial };
+}
+function resetConfig() {
+    config = { ...defaults };
+}
+/** 从 CLI 全局 option 初始化 config */
+function initConfigFromOpts(opts) {
+    const json = opts.json;
+    const output = opts.output;
+    setConfig({
+        json: json ?? defaults.json,
+        output: output === "json" || json ? "json" : defaults.output,
+        verbose: opts.verbose ?? defaults.verbose,
+    });
+}

package/dist/utils/error.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.AppError = void 0;
+class AppError extends Error {
+    code;
+    retryable;
+    next_actions;
+    constructor(code, message, opts) {
+        super(message);
+        this.name = "AppError";
+        this.code = code;
+        this.retryable = opts?.retryable ?? false;
+        this.next_actions = opts?.next_actions ?? [];
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            retryable: this.retryable,
+            next_actions: this.next_actions,
+        };
+    }
+}
+exports.AppError = AppError;
+class HttpError extends AppError {
+    status;
+    url;
+    constructor(status, url, message, opts) {
+        super(`HTTP_${String(status)}`, message, opts ?? { retryable: status >= 500 || status === 429 });
+        this.name = "HttpError";
+        this.status = status;
+        this.url = url;
+    }
+}
+exports.HttpError = HttpError;

package/dist/utils/http.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHttpClient = getHttpClient;
+exports.resetHttpClient = resetHttpClient;
+exports.setHttpClient = setHttpClient;
+exports.applyCanaryHeader = applyCanaryHeader;
+const http_client_1 = require("@lark-apaas/http-client");
+let client;
+/** 获取单例 HttpClient，首次调用时初始化 */
+function getHttpClient() {
+    client ??= createClient();
+    return client;
+}
+/** 重建客户端 */
+function resetHttpClient() {
+    client = undefined;
+}
+/** 替换为自定义 HttpClient 实例（用于测试 mock） */
+function setHttpClient(custom) {
+    client = custom;
+}
+function createClient() {
+    const config = {
+        timeout: 30_000,
+        platform: {
+            enabled: true,
+            tokenProvider: { type: "file" },
+        },
+        security: {
+            strictMode: true,
+        },
+    };
+    const instance = new http_client_1.HttpClient(config);
+    instance.interceptors.request.use(applyCanaryHeader);
+    return instance;
+}
+/** 若 MIAODA_CANARY_HEADER 已设置，注入 x-tt-env 小流量头 */
+function applyCanaryHeader(reqConfig) {
+    const canary = process.env.MIAODA_CANARY_HEADER;
+    if (!canary)
+        return reqConfig;
+    const headers = new Headers(reqConfig.headers);
+    headers.set("x-tt-env", canary);
+    reqConfig.headers = headers;
+    return reqConfig;
+}

package/dist/utils/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setHttpClient = exports.resetHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.isJsonMode = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
+var error_1 = require("./error");
+Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return error_1.AppError; } });
+Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return error_1.HttpError; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getConfig; } });
+Object.defineProperty(exports, "setConfig", { enumerable: true, get: function () { return config_1.setConfig; } });
+Object.defineProperty(exports, "resetConfig", { enumerable: true, get: function () { return config_1.resetConfig; } });
+Object.defineProperty(exports, "initConfigFromOpts", { enumerable: true, get: function () { return config_1.initConfigFromOpts; } });
+var log_id_1 = require("./log_id");
+Object.defineProperty(exports, "generateLogId", { enumerable: true, get: function () { return log_id_1.generateLogId; } });
+Object.defineProperty(exports, "getLogId", { enumerable: true, get: function () { return log_id_1.getLogId; } });
+var output_1 = require("./output");
+Object.defineProperty(exports, "emit", { enumerable: true, get: function () { return output_1.emit; } });
+Object.defineProperty(exports, "emitError", { enumerable: true, get: function () { return output_1.emitError; } });
+Object.defineProperty(exports, "isJsonMode", { enumerable: true, get: function () { return output_1.isJsonMode; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return logger_1.debug; } });
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return logger_1.log; } });
+var http_1 = require("./http");
+Object.defineProperty(exports, "getHttpClient", { enumerable: true, get: function () { return http_1.getHttpClient; } });
+Object.defineProperty(exports, "resetHttpClient", { enumerable: true, get: function () { return http_1.resetHttpClient; } });
+Object.defineProperty(exports, "setHttpClient", { enumerable: true, get: function () { return http_1.setHttpClient; } });

package/dist/utils/log_id.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLogId = generateLogId;
+exports.getLogId = getLogId;
+const node_crypto_1 = require("node:crypto");
+let current;
+function generateLogId() {
+    current = (0, node_crypto_1.randomUUID)();
+    return current;
+}
+function getLogId() {
+    return current ?? generateLogId();
+}

package/dist/utils/logger.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debug = debug;
+exports.log = log;
+const config_1 = require("./config");
+/** verbose 模式下输出 debug 日志到 stderr */
+function debug(msg) {
+    if ((0, config_1.getConfig)().verbose) {
+        process.stderr.write(`[debug] ${msg}\n`);
+    }
+}
+/** 始终输出到 stderr 的进度日志 */
+function log(prefix, msg) {
+    process.stderr.write(`[${prefix}] ${msg}\n`);
+}

package/dist/utils/output.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJsonMode = isJsonMode;
+exports.emit = emit;
+exports.emitError = emitError;
+const config_1 = require("./config");
+const error_1 = require("./error");
+function isJsonMode() {
+    const cfg = (0, config_1.getConfig)();
+    return cfg.output === "json" || Boolean(cfg.json);
+}
+/**
+ * 输出数据
+ * - pretty 模式：格式化文本到 stdout
+ * - json 模式：裸 JSON 到 stdout
+ */
+function emit(data) {
+    if (isJsonMode()) {
+        process.stdout.write(JSON.stringify(data) + "\n");
+    }
+    else {
+        if (typeof data === "string") {
+            process.stdout.write(data + "\n");
+        }
+        else {
+            process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+        }
+    }
+}
+/**
+ * 输出错误（写入 stderr）
+ * - pretty 模式：Error: message\n  hint: ...
+ * - json 模式：{"error_code": "...", "message": "...", "hint": "..."}
+ */
+function emitError(err) {
+    const info = toErrorInfo(err);
+    if (isJsonMode()) {
+        const jsonErr = {
+            error_code: info.code,
+            message: info.message,
+        };
+        if (info.next_actions && info.next_actions.length > 0) {
+            jsonErr.hint = info.next_actions.join(" ");
+        }
+        process.stderr.write(JSON.stringify(jsonErr) + "\n");
+    }
+    else {
+        process.stderr.write(`Error: ${info.message}\n`);
+        if (info.next_actions && info.next_actions.length > 0) {
+            process.stderr.write(`  hint: ${info.next_actions.join(" ")}\n`);
+        }
+    }
+}
+function toErrorInfo(err) {
+    if (err instanceof error_1.AppError)
+        return err.toJSON();
+    const message = err instanceof Error ? err.message : String(err);
+    return { code: "UNKNOWN", message, retryable: false, next_actions: [] };
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@lark-apaas/miaoda-cli",
+  "version": "0.1.0-alpha.097a394",
+  "description": "Miaoda 平台命令行工具，面向 Agent 调用",
+  "type": "commonjs",
+  "bin": {
+    "miaoda": "bin/miaoda.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "miaoda",
+    "cli",
+    "agent"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@lark-apaas/http-client": "^0.1.3",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "@typescript-eslint/eslint-plugin": "^8.58.2",
+    "@typescript-eslint/parser": "^8.58.2",
+    "@vitest/coverage-v8": "^4.1.4",
+    "eslint": "^9.25.1",
+    "husky": "^9.1.7",
+    "tsc-alias": "^1.8.11",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.4",
+    "xml2js": "^0.6.2"
+  },
+  "scripts": {
+    "build": "bash scripts/build.sh",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src/ --max-warnings 0",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "dev": "node --import tsx src/main.ts"
+  }
+}