@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.09899c4

package/dist/utils/poll.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pollUntilDone = pollUntilDone;
+const error_1 = require("../utils/error");
+const spinner_1 = require("../utils/spinner");
+async function pollUntilDone(opts) {
+    const interval = opts.intervalMs ?? 1000;
+    const timeout = opts.timeoutMs ?? 300_000;
+    const deadline = Date.now() + timeout;
+    // 仅当传 spinnerLabel 时启动 spinner；非 TTY / JSON 模式内部自动 noop
+    const stopSpinner = opts.spinnerLabel ? (0, spinner_1.startSpinner)(opts.spinnerLabel) : () => undefined;
+    try {
+        // 立即拉一次（绝大多数轻量任务在 dataloom 端已是同步语义，第一次 fetch 就能拿到 success）
+        for (;;) {
+            const cur = await opts.fetch();
+            const verdict = opts.isDone(cur);
+            if (verdict.done)
+                return verdict.value;
+            if (Date.now() + interval > deadline) {
+                throw new error_1.AppError('TASK_TIMEOUT', `${opts.label} did not complete within ${String(Math.round(timeout / 1000))}s`, {
+                    next_actions: [
+                        'The task may still be running server-side. Retry the command, or check `miaoda db migration diff` to verify final state.',
+                    ],
+                });
+            }
+            await sleep(interval);
+        }
+    }
+    finally {
+        stopSpinner();
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/utils/render.js

@@ -28,7 +28,7 @@ const colors_1 = require("./colors");
 /** 将字节数格式化为人类可读（`24 KB` / `2.1 MB` / `1.5 GB`）。 */
 function formatSize(bytes) {
     if (!Number.isFinite(bytes) || bytes < 0)
-        return "—";
+        return '—';
     if (bytes >= 1 << 30)
         return `${(bytes / (1 << 30)).toFixed(1)} GB`;
     if (bytes >= 1 << 20)
@@ -40,7 +40,7 @@ function formatSize(bytes) {
 /** 将 ISO 时间转为 TTY 下更友好的相对时间；non-TTY 保持 ISO 原值。 */
 function formatTime(iso, isTty) {
     if (!iso)
-        return "—";
+        return '—';
     if (!isTty)
         return iso;
     const ts = Date.parse(iso);
@@ -65,8 +65,8 @@ function formatTime(iso, isTty) {
     // 超过 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");
+    const mo = String(date.getMonth() + 1).padStart(2, '0');
+    const da = String(date.getDate()).padStart(2, '0');
     return `${y}-${mo}-${da}`;
 }
 /**
@@ -103,7 +103,7 @@ function charWidth(cp) {
 }
 /** cell 可见字符宽度：剥离 ANSI 转义后按终端列宽逐字符累加（CJK 算 2 列）。 */
 function visibleWidth(s) {
-    const stripped = s.replace(ANSI_SGR_RE, "");
+    const stripped = s.replace(ANSI_SGR_RE, '');
     let w = 0;
     for (const c of stripped) {
         w += charWidth(c.codePointAt(0) ?? 0);
@@ -112,7 +112,7 @@ function visibleWidth(s) {
 }
 function padVisibleEnd(s, targetWidth) {
     const w = visibleWidth(s);
-    return w >= targetWidth ? s : s + " ".repeat(targetWidth - w);
+    return w >= targetWidth ? s : s + ' '.repeat(targetWidth - w);
 }
 /** 渲染 TTY 对齐表格（多行，列宽按最长内容；ANSI 转义不计入列宽）。
  *  表头按 spec 用 bold + cyan 染色；ANSI 序列由 visibleWidth 剥离不影响列宽。 */
@@ -120,7 +120,7 @@ function renderAlignedTable(headers, rows) {
     const colWidths = headers.map((h, i) => {
         let w = visibleWidth(h);
         for (const row of rows) {
-            const cw = visibleWidth(row[i] || "");
+            const cw = visibleWidth(row[i] || '');
             if (cw > w)
                 w = cw;
         }
@@ -129,34 +129,34 @@ function renderAlignedTable(headers, rows) {
     const lines = [];
     lines.push(headers
         .map((h, i) => colors_1.c.header(padVisibleEnd(h, colWidths[i])))
-        .join("  ")
+        .join('  ')
         .trimEnd());
     for (const row of rows) {
         lines.push(row
-            .map((cell, i) => padVisibleEnd(cell || "", colWidths[i]))
-            .join("  ")
+            .map((cell, i) => padVisibleEnd(cell || '', colWidths[i]))
+            .join('  ')
             .trimEnd());
     }
-    return lines.join("\n");
+    return lines.join('\n');
 }
 /** 渲染 non-TTY tab 分隔（字段原值，ISO 时间）。 */
 function renderTsv(headers, rows) {
     const lines = [];
-    lines.push(headers.join("\t"));
+    lines.push(headers.join('\t'));
     for (const row of rows) {
-        lines.push(row.join("\t"));
+        lines.push(row.join('\t'));
     }
-    return lines.join("\n");
+    return lines.join('\n');
 }
 /** 渲染 key-value 多行（用于 stat 等单条详情）。key 右对齐 + bold cyan 染色。 */
 function renderKeyValue(pairs, isTty) {
     if (pairs.length === 0)
-        return "";
+        return '';
     if (!isTty) {
-        return pairs.map(([k, v]) => `${k}\t${v}`).join("\n");
+        return pairs.map(([k, v]) => `${k}\t${v}`).join('\n');
     }
     const keyWidth = Math.max(...pairs.map(([k]) => k.length));
-    return pairs.map(([k, v]) => `${colors_1.c.header(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() {
@@ -170,15 +170,15 @@ function parseDuration(input) {
         throw new Error(`Invalid duration: ${input}`);
     }
     const n = Number(m[1]);
-    const unit = m[2] || "s";
+    const unit = m[2] || 's';
     switch (unit) {
-        case "s":
+        case 's':
             return n;
-        case "m":
+        case 'm':
             return n * 60;
-        case "h":
+        case 'h':
             return n * 3600;
-        case "d":
+        case 'd':
             return n * 86400;
         default:
             return n;
@@ -191,15 +191,15 @@ function parseSize(input) {
         throw new Error(`Invalid size: ${input}`);
     }
     const n = Number(m[1]);
-    const unit = (m[2] || "B").toUpperCase();
+    const unit = (m[2] || 'B').toUpperCase();
     switch (unit) {
-        case "B":
+        case 'B':
             return Math.round(n);
-        case "KB":
+        case 'KB':
             return Math.round(n * 1024);
-        case "MB":
+        case 'MB':
             return Math.round(n * 1024 * 1024);
-        case "GB":
+        case 'GB':
             return Math.round(n * 1024 * 1024 * 1024);
         default:
             return Math.round(n);

package/dist/utils/spinner.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startSpinner = startSpinner;
+const config_1 = require("./config");
+/**
+ * TTY 友好的 loading 指示器，写到 stderr 上避免污染 stdout（保证 --json 输出干净）。
+ *
+ * 设计：
+ *   - 仅 stderr.isTTY 且非 --json 模式启用；其他情况静默（CI / 管道 / JSON 输出场景）
+ *   - 80ms 一帧 braille 旋转字符 + 累计 elapsed 秒数
+ *   - 返回 stop() 函数；调用方 finally 里调用，无论成功失败都清掉 spinner 行
+ *
+ * 用法：
+ *   const stop = startSpinner('Applying migration to online');
+ *   try { await someLongTask(); } finally { stop(); }
+ */
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const HIDE_CURSOR = '[?25l';
+const SHOW_CURSOR = '[?25h';
+const CLEAR_LINE = '\r';
+function startSpinner(label) {
+    // 非 TTY / JSON 模式：静默 noop，避免污染管道与结构化输出
+    if (!process.stderr.isTTY || (0, config_1.getConfig)().json) {
+        return () => {
+            /* noop */
+        };
+    }
+    let frame = 0;
+    const start = Date.now();
+    process.stderr.write(HIDE_CURSOR);
+    const render = () => {
+        const elapsedSec = Math.round((Date.now() - start) / 1000);
+        process.stderr.write(`${CLEAR_LINE}${FRAMES[frame]} ${label}... ${String(elapsedSec)}s`);
+        frame = (frame + 1) % FRAMES.length;
+    };
+    render();
+    const timer = setInterval(render, 80);
+    let stopped = false;
+    return () => {
+        if (stopped)
+            return;
+        stopped = true;
+        clearInterval(timer);
+        process.stderr.write(`${CLEAR_LINE}${SHOW_CURSOR}`);
+    };
+}

package/dist/utils/time.js

@@ -0,0 +1,208 @@
+"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");
+/**
+ * 时间格式简短说明，对齐 Supabase / fly.io 等主流 CLI 的「简洁但严格」风格。
+ *
+ * - 不接受 YYYY/MM/DD、'April 1 2026' 这类松散 / 区域性形式（Date.parse 会误吞）
+ * - 不接受空格分隔的 'YYYY-MM-DD HH:mm:ss'：不带引号会被 shell 拆成两个参数，
+ *   宁可拒绝也不让用户踩「看起来传了 since 实际只传了一半」的坑
+ * - 不带显式时区的 (YYYY-MM-DD / YYYY-MM-DDTHH:mm:ss) 一律按**本地时区**解释，
+ *   跟 pretty 输出（renderDate 用 getFullYear 等本地方法）形成输入/输出闭环
+ *   ——用户复制 pretty 输出的时间字符串当 --since 不会差时区
+ */
+exports.TIMESTAMP_HELP = 'Accepted formats: ' +
+    'relative (30s / 5m / 2h / 3d / 1w); ' +
+    'date YYYY-MM-DD (local 00:00:00); ' +
+    'local datetime YYYY-MM-DDTHH:mm:ss (local timezone, T-separated); ' +
+    'ISO 8601 with timezone YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss+08:00.';
+/**
+ * 解析时间字符串到毫秒时间戳；不匹配任一支持格式抛 ARGS_INVALID。
+ * 失败抛 AppError("ARGS_INVALID", ...)；CLI 层用 withHelp 自动转 exit 2 + help。
+ */
+function parseTimeToMs(input, now = new Date()) {
+    // 1. 相对时间：30s / 30m / 1h / 2d / 1w
+    const relative = /^(\d+)([smhdw])$/.exec(input);
+    if (relative) {
+        const n = Number(relative[1]);
+        if (n <= 0)
+            failInvalidTimestamp(input);
+        const unit = relative[2];
+        const factor = unit === 's'
+            ? 1_000
+            : 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', `Invalid timestamp '${input}'`, {
+        next_actions: [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.2",
+  "version": "0.1.3-alpha.09899c4",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -27,6 +27,7 @@
   "dependencies": {
     "@lark-apaas/http-client": "^0.1.5",
     "commander": "^13.1.0",
+    "ora": "^5.4.1",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
@@ -53,9 +54,10 @@
     "lint": "eslint src/ --max-warnings 0",
     "format": "prettier --write src/",
     "format:check": "prettier --check src/",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:integration": "vitest run --config vitest.integration.config.ts",
-    "dev": "node --import tsx src/main.ts"
+    "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"
   }
 }