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

package/dist/utils/time.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+const TIMESTAMP_HELP = "支持格式：相对时间 1h/2d/1w；日期 2026-04-01；ISO 2026-04-01T10:00:00Z";
+/**
+ * 解析 PRD 时间格式。返回毫秒时间戳。
+ *   - 相对时间：`1h`、`2d`、`1w`、`30m`（h=小时, d=天, w=周, m=分钟）
+ *   - 日期：`2026-04-01`（按当日 00:00:00 UTC）
+ *   - ISO 8601：`2026-04-01T10:00:00Z`
+ *
+ * 失败抛 AppError("ARGS_INVALID", ...)；CLI 层用 withHelp 自动转 exit 2 + help。
+ */
+function parseTimeToMs(input, now = new Date()) {
+    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;
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+        const ms = Date.parse(input + "T00:00:00Z");
+        if (Number.isNaN(ms))
+            failInvalidTimestamp(input);
+        return ms;
+    }
+    const ms = Date.parse(input);
+    if (Number.isNaN(ms))
+        failInvalidTimestamp(input);
+    return ms;
+}
+function failInvalidTimestamp(input) {
+    throw new error_1.AppError("ARGS_INVALID", `无法解析时间 '${input}'。${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.b2b5ae5",
   "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"
   }
 }