@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.08ca9fb

package/dist/utils/render.js

@@ -1,4 +1,14 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSize = formatSize;
+exports.formatTime = formatTime;
+exports.visibleWidth = visibleWidth;
+exports.renderAlignedTable = renderAlignedTable;
+exports.renderTsv = renderTsv;
+exports.renderKeyValue = renderKeyValue;
+exports.isStdoutTty = isStdoutTty;
+exports.parseDuration = parseDuration;
+exports.parseSize = parseSize;
 /**
  * CLI 渲染 / 解析工具：跨域共用的格式化、表格渲染、字符串解析。
  *
@@ -9,18 +19,12 @@
  *   - 终端探测：isStdoutTty
  *   - 字符串解析：parseDuration / parseSize
  *
+ * 彩色高亮的语义层封装见 ./colors.ts。表头 / key 标签等结构性元素由本文件
+ * 主动调用 colors.c 染色；业务文案的染色（成功/失败 prefix 等）由 handler 自治。
+ *
  * JSON envelope 输出（emit / emitOk / emitPaged / emitError）见 ./output.ts。
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatSize = formatSize;
-exports.formatTime = formatTime;
-exports.visibleWidth = visibleWidth;
-exports.renderAlignedTable = renderAlignedTable;
-exports.renderTsv = renderTsv;
-exports.renderKeyValue = renderKeyValue;
-exports.isStdoutTty = isStdoutTty;
-exports.parseDuration = parseDuration;
-exports.parseSize = parseSize;
+const colors_1 = require("./colors");
 /** 将字节数格式化为人类可读（`24 KB` / `2.1 MB` / `1.5 GB`）。 */
 function formatSize(bytes) {
     if (!Number.isFinite(bytes) || bytes < 0)
@@ -77,20 +81,21 @@ const ANSI_SGR_RE = /\[[0-9;]*m/g;
  * 不实现合字 / 零宽字符（ZWJ / 变体选择符）等极端情况，CLI 表格场景够用。
  */
 function charWidth(cp) {
-    if ((cp >= 0x1100 && cp <= 0x115F) || // Hangul Jamo
-        cp === 0x2329 || cp === 0x232A ||
-        (cp >= 0x2E80 && cp <= 0x303E) || // CJK Radicals / Punctuation
-        (cp >= 0x3041 && cp <= 0x33FF) || // Hiragana / Katakana / CJK Symbols
-        (cp >= 0x3400 && cp <= 0x4DBF) || // CJK Ext A
-        (cp >= 0x4E00 && cp <= 0x9FFF) || // CJK Unified
-        (cp >= 0xA000 && cp <= 0xA4CF) || // Yi
-        (cp >= 0xAC00 && cp <= 0xD7A3) || // Hangul Syllables
-        (cp >= 0xF900 && cp <= 0xFAFF) || // CJK Compat Ideographs
-        (cp >= 0xFE30 && cp <= 0xFE4F) || // CJK Compat Forms
-        (cp >= 0xFF00 && cp <= 0xFF60) || // Fullwidth Forms
-        (cp >= 0xFFE0 && cp <= 0xFFE6) ||
-        (cp >= 0x20000 && cp <= 0x2FFFD) || // CJK Ext B-F
-        (cp >= 0x30000 && cp <= 0x3FFFD) // CJK Ext G-H
+    if ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        cp === 0x2329 ||
+        cp === 0x232a ||
+        (cp >= 0x2e80 && cp <= 0x303e) || // CJK Radicals / Punctuation
+        (cp >= 0x3041 && cp <= 0x33ff) || // Hiragana / Katakana / CJK Symbols
+        (cp >= 0x3400 && cp <= 0x4dbf) || // CJK Ext A
+        (cp >= 0x4e00 && cp <= 0x9fff) || // CJK Unified
+        (cp >= 0xa000 && cp <= 0xa4cf) || // Yi
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul Syllables
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK Compat Ideographs
+        (cp >= 0xfe30 && cp <= 0xfe4f) || // CJK Compat Forms
+        (cp >= 0xff00 && cp <= 0xff60) || // Fullwidth Forms
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x20000 && cp <= 0x2fffd) || // CJK Ext B-F
+        (cp >= 0x30000 && cp <= 0x3fffd) // CJK Ext G-H
     ) {
         return 2;
     }
@@ -109,7 +114,8 @@ function padVisibleEnd(s, targetWidth) {
     const w = visibleWidth(s);
     return w >= targetWidth ? s : s + " ".repeat(targetWidth - w);
 }
-/** 渲染 TTY 对齐表格（多行，列宽按最长内容；ANSI 转义不计入列宽）。 */
+/** 渲染 TTY 对齐表格（多行，列宽按最长内容；ANSI 转义不计入列宽）。
+ *  表头按 spec 用 bold + cyan 染色；ANSI 序列由 visibleWidth 剥离不影响列宽。 */
 function renderAlignedTable(headers, rows) {
     const colWidths = headers.map((h, i) => {
         let w = visibleWidth(h);
@@ -121,9 +127,15 @@ function renderAlignedTable(headers, rows) {
         return w;
     });
     const lines = [];
-    lines.push(headers.map((h, i) => padVisibleEnd(h, colWidths[i])).join("  ").trimEnd());
+    lines.push(headers
+        .map((h, i) => colors_1.c.header(padVisibleEnd(h, colWidths[i])))
+        .join("  ")
+        .trimEnd());
     for (const row of rows) {
-        lines.push(row.map((cell, i) => padVisibleEnd(cell || "", colWidths[i])).join("  ").trimEnd());
+        lines.push(row
+            .map((cell, i) => padVisibleEnd(cell || "", colWidths[i]))
+            .join("  ")
+            .trimEnd());
     }
     return lines.join("\n");
 }
@@ -136,7 +148,7 @@ function renderTsv(headers, rows) {
     }
     return lines.join("\n");
 }
-/** 渲染 key-value 多行（用于 stat 等单条详情）。key 右对齐。 */
+/** 渲染 key-value 多行（用于 stat 等单条详情）。key 右对齐 + bold cyan 染色。 */
 function renderKeyValue(pairs, isTty) {
     if (pairs.length === 0)
         return "";
@@ -144,9 +156,7 @@ function renderKeyValue(pairs, 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");
+    return pairs.map(([k, v]) => `${colors_1.c.header(k.padStart(keyWidth))}:  ${v}`).join("\n");
 }
 /** 通用 isTTY 判定（stdout 是否交互终端）。Node 运行时 isTTY 为 true 或 undefined；TS 类型上 tty.WriteStream 定义为固定 true，绕开做运行时判断。 */
 function isStdoutTty() {
@@ -162,11 +172,16 @@ function parseDuration(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;
+        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` → 字节。 */
@@ -178,10 +193,15 @@ function parseSize(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);
+        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/utils/time.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMESTAMP_HELP = void 0;
+exports.parseTimeToMs = parseTimeToMs;
+exports.msToNs = msToNs;
+exports.msToSec = msToSec;
+exports.parseToMs = parseToMs;
+exports.parseToNs = parseToNs;
+exports.parseToSec = parseToSec;
+exports.floorMsToBucket = floorMsToBucket;
+exports.ceilMsToBucket = ceilMsToBucket;
+const error_1 = require("./error");
+exports.TIMESTAMP_HELP = "支持格式：" +
+    "相对时间 30m/1h/2d/1w；" +
+    "日期 2026-04-01（本地时区当日 00:00:00）；" +
+    "本地日期+时间 2026-04-01T10:00:00（按本地时区，T 分隔）；" +
+    "带时区 ISO 2026-04-01T10:00:00Z（UTC）或 2026-04-01T10:00:00+08:00（指定偏移）。" +
+    "禁止用空格分隔：'YYYY-MM-DD HH:mm:ss' 不带引号会被 shell 拆成两个参数。";
+/**
+ * 解析时间字符串到毫秒时间戳；不匹配任一支持格式抛 ARGS_INVALID。
+ *
+ * 时区约定（重要）：
+ *   - 不带显式时区的形式（YYYY-MM-DD、YYYY-MM-DDTHH:mm:ss）一律按
+ *     **本地时区**解释，与 pretty 输出（output.ts:renderDate 用 getFullYear 等本地方法）形成
+ *     输入/输出闭环：用户复制输出文本作为 --since 不会差时区。
+ *   - 带显式时区（结尾 Z 或 ±HH:MM / ±HHMM）按显式时区解析，跨机器一致。
+ *   - 因此跨机器同步使用时建议带显式时区；同机器复制粘贴 pretty 输出更省事。
+ *
+ * 拒绝 Date.parse 松散接受的形式：YYYY/MM/DD、自然语言（'April 1 2026'）、单独年份等。
+ *
+ * 失败抛 AppError("ARGS_INVALID", ...)；CLI 层用 withHelp 自动转 exit 2 + help。
+ */
+function parseTimeToMs(input, now = new Date()) {
+    // 1. 相对时间：30m / 1h / 2d / 1w
+    const relative = /^(\d+)([mhdw])$/.exec(input);
+    if (relative) {
+        const n = Number(relative[1]);
+        const unit = relative[2];
+        const factor = unit === "m"
+            ? 60_000
+            : unit === "h"
+                ? 3_600_000
+                : unit === "d"
+                    ? 86_400_000
+                    : /* w */ 604_800_000;
+        return now.getTime() - n * factor;
+    }
+    // 2. 纯日期：YYYY-MM-DD → 本地当日 00:00:00
+    const date = /^(\d{4})-(\d{2})-(\d{2})$/.exec(input);
+    if (date) {
+        return localDateMs(input, date[1], date[2], date[3], "00", "00", "00", "0");
+    }
+    // 3. 本地日期+时间：YYYY-MM-DDTHH:mm:ss[.SSS]（不带时区，T 分隔）。
+    //    不接受空格分隔——'YYYY-MM-DD HH:mm:ss' 不带引号会被 shell 拆成两个参数，
+    //    宁可不支持也不要让 agent 踩"看起来传了 since 实际只传了一半"的坑。
+    const localDt = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,3}))?$/.exec(input);
+    if (localDt) {
+        // capture 7 是可选 .SSS 组，运行时可能 undefined；TS lib 的 RegExp match 索引
+        // 类型把它标成 string，所以这里显式 cast 让 ?? 在 lint 视角下也"必要"。
+        const msPart = localDt[7] ?? "0";
+        return localDateMs(input, localDt[1], localDt[2], localDt[3], localDt[4], localDt[5], localDt[6], msPart);
+    }
+    // 4. 带显式时区的 ISO 8601：YYYY-MM-DDTHH:mm:ss[.SSS](Z|±HH:MM|±HHMM)
+    const iso = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.\d{1,9})?(Z|[+-](\d{2}):?(\d{2}))$/.exec(input);
+    if (iso) {
+        validateDateTimeParts(input, iso[1], iso[2], iso[3], iso[4], iso[5], iso[6]);
+        if (iso[7] !== "Z")
+            validateOffset(input, iso[8], iso[9]);
+        const ms = Date.parse(input);
+        if (Number.isNaN(ms))
+            failInvalidTimestamp(input);
+        return ms;
+    }
+    failInvalidTimestamp(input);
+}
+function localDateMs(input, y, mo, d, h, mi, s, msPart) {
+    validateDateTimeParts(input, y, mo, d, h, mi, s);
+    // 毫秒位补齐到 3 位再截断（"5" → 500，"12" → 120，"123" → 123）
+    const ms = Number(msPart.padEnd(3, "0").slice(0, 3));
+    const date = new Date(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s), ms);
+    if (date.getFullYear() !== Number(y) ||
+        date.getMonth() !== Number(mo) - 1 ||
+        date.getDate() !== Number(d) ||
+        date.getHours() !== Number(h) ||
+        date.getMinutes() !== Number(mi) ||
+        date.getSeconds() !== Number(s) ||
+        date.getMilliseconds() !== ms) {
+        failInvalidTimestamp(input);
+    }
+    return date.getTime();
+}
+function validateDateTimeParts(input, y, mo, d, h, mi, s) {
+    const year = Number(y);
+    const month = Number(mo);
+    const day = Number(d);
+    const hour = Number(h);
+    const minute = Number(mi);
+    const second = Number(s);
+    if (month < 1 || month > 12 || hour > 23 || minute > 59 || second > 59) {
+        failInvalidTimestamp(input);
+    }
+    const utc = new Date(Date.UTC(year, month - 1, day));
+    if (utc.getUTCFullYear() !== year ||
+        utc.getUTCMonth() !== month - 1 ||
+        utc.getUTCDate() !== day) {
+        failInvalidTimestamp(input);
+    }
+}
+function validateOffset(input, h, mi) {
+    if (h === undefined || mi === undefined)
+        failInvalidTimestamp(input);
+    const hour = Number(h);
+    const minute = Number(mi);
+    if (hour > 23 || minute > 59)
+        failInvalidTimestamp(input);
+}
+function failInvalidTimestamp(input) {
+    throw new error_1.AppError("ARGS_INVALID", `无法解析时间 '${input}'。${exports.TIMESTAMP_HELP}`);
+}
+/** 毫秒 → 纳秒（字符串，避免 JS Number 精度丢失） */
+function msToNs(ms) {
+    return `${String(ms)}000000`;
+}
+/** 毫秒 → 秒（字符串，向下取整） */
+function msToSec(ms) {
+    return String(Math.floor(ms / 1000));
+}
+/** 解析到毫秒数；input 为空返回 undefined */
+function parseToMs(input, now) {
+    if (!input)
+        return undefined;
+    return parseTimeToMs(input, now);
+}
+/** 解析到纳秒字符串；input 为空返回 undefined */
+function parseToNs(input, now) {
+    if (!input)
+        return undefined;
+    return msToNs(parseTimeToMs(input, now));
+}
+/** 解析到秒字符串；input 为空返回 undefined */
+function parseToSec(input, now) {
+    if (!input)
+        return undefined;
+    return msToSec(parseTimeToMs(input, now));
+}
+// ── 桶边界对齐 ──
+//
+// metric 的 down-sample 与 analytics 的 timeAggregationUnit 都按 UTC 桶切片。
+// 当用户传的 since/until 落在桶中间，服务端可能返回不到该桶（边界数据丢失）。
+// 约定：since 向下取整、until 向上取整，把 since/until 各自所在桶完整纳入。
+//
+// 周界以 ISO 周（周一为周首，UTC）；月按 UTC 月初对齐。
+const MS_MIN = 60_000;
+const MS_HOUR = 3_600_000;
+const MS_DAY = 86_400_000;
+/** 把 ms 向下对齐到桶起点（UTC）。未识别的 bucket 原样返回。 */
+function floorMsToBucket(ms, bucket) {
+    switch (bucket) {
+        case "1m":
+            return Math.floor(ms / MS_MIN) * MS_MIN;
+        case "1h":
+            return Math.floor(ms / MS_HOUR) * MS_HOUR;
+        case "1d":
+        case "DAY": {
+            const d = new Date(ms);
+            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+        }
+        case "WEEK": {
+            const d = new Date(ms);
+            const offsetDays = (d.getUTCDay() + 6) % 7; // 距上一个周一的天数
+            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - offsetDays);
+        }
+        case "MONTH": {
+            const d = new Date(ms);
+            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1);
+        }
+        default:
+            return ms;
+    }
+}
+/** 把 ms 向上对齐到下一个桶起点（UTC）；恰在边界则不变。 */
+function ceilMsToBucket(ms, bucket) {
+    const floor = floorMsToBucket(ms, bucket);
+    if (floor === ms)
+        return ms;
+    switch (bucket) {
+        case "1m":
+            return floor + MS_MIN;
+        case "1h":
+            return floor + MS_HOUR;
+        case "1d":
+        case "DAY":
+            return floor + MS_DAY;
+        case "WEEK":
+            return floor + 7 * MS_DAY;
+        case "MONTH": {
+            const d = new Date(floor);
+            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1);
+        }
+        default:
+            return ms;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.1",
+  "version": "0.1.2-alpha.08ca9fb",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -26,7 +26,9 @@
   },
   "dependencies": {
     "@lark-apaas/http-client": "^0.1.5",
-    "commander": "^13.1.0"
+    "commander": "^13.1.0",
+    "ora": "^5.4.1",
+    "picocolors": "^1.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",
@@ -34,7 +36,12 @@
     "@typescript-eslint/parser": "^8.58.2",
     "@vitest/coverage-v8": "^4.1.4",
     "eslint": "^9.25.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-boundaries": "^6.0.2",
+    "eslint-plugin-import": "^2.32.0",
     "husky": "^9.1.7",
+    "prettier": "^3.8.3",
     "tsc-alias": "^1.8.11",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
@@ -45,9 +52,12 @@
     "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"
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "test": "vitest run --project=unit",
+    "test:watch": "vitest --project=unit",
+    "test:integration": "vitest run --project=integration",
+    "dev": "node --import tsx src/main.ts",
+    "cli": "node --env-file-if-exists=integration/.env --import tsx src/main.ts"
   }
 }