@lark-apaas/miaoda-cli 0.1.3 → 0.1.4-alpha.8b6506a

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/spark-meta.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSparkMeta = readSparkMeta;
+exports.writeSparkMeta = writeSparkMeta;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const SPARK_DIR = '.spark';
+const SPARK_META_FILE = 'meta.json';
+function readSparkMeta(appDir) {
+    const metaPath = node_path_1.default.join(appDir, SPARK_DIR, SPARK_META_FILE);
+    if (!node_fs_1.default.existsSync(metaPath))
+        return {};
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * merge 写入：已有字段保留，undefined 不覆盖；不再维护时间戳。
+ */
+function writeSparkMeta(appDir, meta) {
+    const sparkDir = node_path_1.default.join(appDir, SPARK_DIR);
+    node_fs_1.default.mkdirSync(sparkDir, { recursive: true });
+    const metaPath = node_path_1.default.join(sparkDir, SPARK_META_FILE);
+    let existing = {};
+    if (node_fs_1.default.existsSync(metaPath)) {
+        try {
+            existing = JSON.parse(node_fs_1.default.readFileSync(metaPath, 'utf-8'));
+        }
+        catch {
+            /* 读不出就当空 */
+        }
+    }
+    const defined = Object.fromEntries(Object.entries(meta).filter(([, v]) => v !== undefined));
+    const merged = { ...existing, ...defined };
+    node_fs_1.default.writeFileSync(metaPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+}

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

@@ -10,45 +10,48 @@ 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'）、单独年份等。
+ * 时间格式简短说明，对齐 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. 相对时间：30m / 1h / 2d / 1w
-    const relative = /^(\d+)([mhdw])$/.exec(input);
+    // 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 === "m"
-            ? 60_000
-            : unit === "h"
-                ? 3_600_000
-                : unit === "d"
-                    ? 86_400_000
-                    : /* w */ 604_800_000;
+        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");
+        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 拆成两个参数，
@@ -57,14 +60,14 @@ function parseTimeToMs(input, now = new Date()) {
     if (localDt) {
         // capture 7 是可选 .SSS 组，运行时可能 undefined；TS lib 的 RegExp match 索引
         // 类型把它标成 string，所以这里显式 cast 让 ?? 在 lint 视角下也"必要"。
-        const msPart = localDt[7] ?? "0";
+        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")
+        if (iso[7] !== 'Z')
             validateOffset(input, iso[8], iso[9]);
         const ms = Date.parse(input);
         if (Number.isNaN(ms))
@@ -76,7 +79,7 @@ function parseTimeToMs(input, now = new Date()) {
 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 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 ||
@@ -115,7 +118,9 @@ function validateOffset(input, h, mi) {
         failInvalidTimestamp(input);
 }
 function failInvalidTimestamp(input) {
-    throw new error_1.AppError("ARGS_INVALID", `无法解析时间 '${input}'。${exports.TIMESTAMP_HELP}`);
+    throw new error_1.AppError('ARGS_INVALID', `Invalid timestamp '${input}'`, {
+        next_actions: [exports.TIMESTAMP_HELP],
+    });
 }
 /** 毫秒 → 纳秒（字符串，避免 JS Number 精度丢失） */
 function msToNs(ms) {
@@ -156,21 +161,21 @@ const MS_DAY = 86_400_000;
 /** 把 ms 向下对齐到桶起点（UTC）。未识别的 bucket 原样返回。 */
 function floorMsToBucket(ms, bucket) {
     switch (bucket) {
-        case "1m":
+        case '1m':
             return Math.floor(ms / MS_MIN) * MS_MIN;
-        case "1h":
+        case '1h':
             return Math.floor(ms / MS_HOUR) * MS_HOUR;
-        case "1d":
-        case "DAY": {
+        case '1d':
+        case 'DAY': {
             const d = new Date(ms);
             return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
         }
-        case "WEEK": {
+        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": {
+        case 'MONTH': {
             const d = new Date(ms);
             return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1);
         }
@@ -184,16 +189,16 @@ function ceilMsToBucket(ms, bucket) {
     if (floor === ms)
         return ms;
     switch (bucket) {
-        case "1m":
+        case '1m':
             return floor + MS_MIN;
-        case "1h":
+        case '1h':
             return floor + MS_HOUR;
-        case "1d":
-        case "DAY":
+        case '1d':
+        case 'DAY':
             return floor + MS_DAY;
-        case "WEEK":
+        case 'WEEK':
             return floor + 7 * MS_DAY;
-        case "MONTH": {
+        case 'MONTH': {
             const d = new Date(floor);
             return Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.3",
+  "version": "0.1.4-alpha.8b6506a",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {