@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.2a09432

package/dist/cli/handlers/db/schema.js

@@ -39,15 +39,14 @@ const api = __importStar(require("../../../api/index"));
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
-const shared_1 = require("../../../cli/commands/shared");
 const colors_1 = require("../../../utils/colors");
 const index_1 = require("../../../api/db/index");
 // ── schema list ──
 async function handleDbSchemaList(opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const resp = await api.db.getSchema({
         appId,
-        format: "schema",
+        format: 'schema',
         includeStats: true,
         dbBranch: opts.env,
     });
@@ -57,30 +56,30 @@ async function handleDbSchemaList(opts) {
         return;
     }
     if (tables.length === 0) {
-        (0, output_1.emit)("No tables found.");
+        (0, output_1.emit)('No tables found.');
         return;
     }
     const tty = (0, render_1.isStdoutTty)();
     // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）。
     // updated_at 暂时不展示——PG pg_catalog 不存真实表时间，详见 renderDetail 注释。
     const headers = [
-        "name",
-        "description",
-        "estimated_row_count",
-        tty ? "size" : "size_bytes",
-        "columns",
+        'name',
+        'description',
+        'estimated_row_count',
+        tty ? 'size' : 'size_bytes',
+        'columns',
     ];
     const rows = tables.map((t) => [
         t.name,
-        t.description ?? "—",
-        t.estimated_row_count === null ? "—" : String(t.estimated_row_count),
-        t.size_bytes === null ? "—" : tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes),
+        t.description ?? '—',
+        t.estimated_row_count === null ? '—' : String(t.estimated_row_count),
+        t.size_bytes === null ? '—' : tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes),
         String(t.columns),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
 }
 async function handleDbSchemaGet(table, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const tty = (0, render_1.isStdoutTty)();
     const forceDdl = Boolean(opts.ddl);
     const wantsStructured = (0, output_1.isJsonMode)() || (tty && !forceDdl);
@@ -88,13 +87,13 @@ async function handleDbSchemaGet(table, opts) {
         // non-TTY 或 --ddl：直接取完整 DDL 输出
         const ddlResp = await api.db.getSchema({
             appId,
-            format: "ddl",
+            format: 'ddl',
             tableNames: table,
             dbBranch: opts.env,
         });
         const sql = ddlResp.ddl?.[table];
         if (!sql) {
-            throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
+            throw new error_1.AppError('TABLE_NOT_FOUND', `Table '${table}' does not exist`, {
                 next_actions: [
                     `Did you mean another table? Run "miaoda db schema list" to see all tables.`,
                 ],
@@ -106,14 +105,14 @@ async function handleDbSchemaGet(table, opts) {
     // TTY / JSON：取结构化
     const resp = await api.db.getSchema({
         appId,
-        format: "schema",
+        format: 'schema',
         tableNames: table,
         includeStats: true,
         dbBranch: opts.env,
     });
     const detail = (0, index_1.pickTableDetail)(resp.schema, table);
     if (!detail) {
-        throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
+        throw new error_1.AppError('TABLE_NOT_FOUND', `Table '${table}' does not exist`, {
             next_actions: [`Did you mean another table? Run "miaoda db schema list" to see all tables.`],
         });
     }
@@ -124,54 +123,54 @@ async function handleDbSchemaGet(table, opts) {
     (0, output_1.emit)(renderDetail(detail, tty));
 }
 function renderDetail(d, tty) {
-    const systemFields = d.columns.filter((c) => c.name.startsWith("_"));
-    const userFields = d.columns.filter((c) => !c.name.startsWith("_"));
+    const systemFields = d.columns.filter((c) => c.name.startsWith('_'));
+    const userFields = d.columns.filter((c) => !c.name.startsWith('_'));
     // header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size。
     // 不展示 Created / Updated：PG pg_catalog 不存表创建时间，dataloom 用 OID
     // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
     // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
     const header = [
         // 表名做 cyan 强调（spec：spec 里的"命令名/表名"类强调值都走 highlight）
-        ["Name", tty ? colors_1.c.highlight(d.name) : d.name],
-        ["Description", d.description ?? "—"],
+        ['Name', tty ? colors_1.c.highlight(d.name) : d.name],
+        ['Description', d.description ?? '—'],
         [
-            "Columns",
+            'Columns',
             systemFields.length > 0
                 ? `${String(userFields.length)} (+ ${String(systemFields.length)} system)`
                 : String(userFields.length),
         ],
-        ["Estimated Rows", d.estimated_row_count === null ? "—" : String(d.estimated_row_count)],
-        ["Size", d.size_bytes === null ? "—" : (0, render_1.formatSize)(d.size_bytes)],
+        ['Estimated Rows', d.estimated_row_count === null ? '—' : String(d.estimated_row_count)],
+        ['Size', d.size_bytes === null ? '—' : (0, render_1.formatSize)(d.size_bytes)],
     ];
-    const colHeaders = ["column", "type", "nullable", "default", "comment"];
+    const colHeaders = ['column', 'type', 'nullable', 'default', 'comment'];
     const colRows = userFields.map((c) => [
         c.name,
         c.type,
-        c.nullable ? "yes" : "no",
-        c.default ?? "—",
-        c.comment ?? "—",
+        c.nullable ? 'yes' : 'no',
+        c.default ?? '—',
+        c.comment ?? '—',
     ]);
     const parts = [];
     parts.push((0, render_1.renderKeyValue)(header, tty));
-    parts.push("");
+    parts.push('');
     parts.push(tty ? (0, render_1.renderAlignedTable)(colHeaders, colRows) : (0, render_1.renderTsv)(colHeaders, colRows));
     // Constraints 段（PRIMARY KEY / UNIQUE）：表级约束独立成段，与普通索引分离展示
     if (d.constraints.length > 0) {
-        parts.push("");
-        parts.push(tty ? "  Constraints:" : "Constraints:");
+        parts.push('');
+        parts.push(tty ? '  Constraints:' : 'Constraints:');
         for (const c of d.constraints) {
-            const line = `${c.type} (${c.columns.join(", ")})`;
+            const line = `${c.type} (${c.columns.join(', ')})`;
             parts.push(tty ? `    ${line}` : line);
         }
     }
     // Indexes 段：普通索引，格式 "<name> ON <col1, col2> USING <method>"
     if (d.indexes.length > 0) {
-        parts.push("");
-        parts.push(tty ? "  Indexes:" : "Indexes:");
+        parts.push('');
+        parts.push(tty ? '  Indexes:' : 'Indexes:');
         for (const idx of d.indexes) {
-            const line = `${idx.name} ON ${idx.columns.join(", ")} USING ${idx.method}`;
+            const line = `${idx.name} ON ${idx.columns.join(', ')} USING ${idx.method}`;
             parts.push(tty ? `    ${line}` : line);
         }
     }
-    return parts.join("\n");
+    return parts.join('\n');
 }

package/dist/cli/handlers/db/sql.js

@@ -42,7 +42,6 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const config_1 = require("../../../utils/config");
 const logger_1 = require("../../../utils/logger");
-const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
 const colors_1 = require("../../../utils/colors");
 const fuzzy_match_1 = require("../../../utils/fuzzy-match");
@@ -62,10 +61,10 @@ const node_path_1 = __importDefault(require("node:path"));
  *   末尾汇总，--json 输出 data 数组。
  */
 async function handleDbSql(query, opts) {
-    const appId = (0, shared_1.resolveAppId)(opts);
+    const appId = opts.appId;
     const sql = await readSql(query);
     if (!sql.trim()) {
-        throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");
+        throw new error_1.AppError('ARGS_INVALID', 'Empty SQL (no inline query and stdin is empty)');
     }
     let results;
     try {
@@ -87,7 +86,7 @@ async function handleDbSql(query, opts) {
             (0, output_1.emit)({ data: [] });
             return;
         }
-        (0, output_1.emit)("✓ No results");
+        (0, output_1.emit)((0, render_1.isStdoutTty)() ? colors_1.c.success('✓ No results') : 'OK No results');
         return;
     }
     if (results.length === 1) {
@@ -122,7 +121,7 @@ async function handleDbSql(query, opts) {
  * statement 都执行成功，无需再校验逐条状态。
  */
 /** agent runtime 中固定的项目根目录；放在此处便于以后调整。 */
-const AGENT_PROJECT_ROOT = "/home/gem/workspace/code";
+const AGENT_PROJECT_ROOT = '/home/gem/workspace/code';
 /** drain 子进程 pipe stream：默认静默模式下消费 chunk 防止缓冲区反压。 */
 function drainChunk(_chunk) {
     // 显式接 chunk 参数让 ESLint 不再当成 empty function；不做任何处理
@@ -132,7 +131,7 @@ async function maybeSyncAgentSchema(results) {
         return;
     const projectRoot = await resolveAgentProjectRoot();
     if (!projectRoot) {
-        (0, logger_1.debug)("[db sql] agent project root not found or missing gen:db-schema script, skip schema sync");
+        (0, logger_1.debug)('[db sql] agent project root not found or missing gen:db-schema script, skip schema sync');
         return;
     }
     const verbose = (0, config_1.getConfig)().verbose;
@@ -141,8 +140,8 @@ async function maybeSyncAgentSchema(results) {
     (0, logger_1.debug)(`[db sql] DDL detected, running \`npm run gen:db-schema\` in ${projectRoot}`);
     try {
         await new Promise((resolve) => {
-            const proc = (0, node_child_process_1.spawn)("npm", ["run", "gen:db-schema"], {
-                stdio: ["ignore", "pipe", "pipe"],
+            const proc = (0, node_child_process_1.spawn)('npm', ['run', 'gen:db-schema'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
                 cwd: projectRoot,
             });
             // --verbose：实时透传到 stderr 看进度；默认完全静默丢弃。
@@ -153,15 +152,15 @@ async function maybeSyncAgentSchema(results) {
                 proc.stderr.pipe(process.stderr);
             }
             else {
-                proc.stdout.on("data", drainChunk);
-                proc.stderr.on("data", drainChunk);
+                proc.stdout.on('data', drainChunk);
+                proc.stderr.on('data', drainChunk);
             }
             let timedOut = false;
             const timer = setTimeout(() => {
                 timedOut = true;
-                proc.kill("SIGKILL");
+                proc.kill('SIGKILL');
             }, TIMEOUT_MS);
-            proc.on("close", (code) => {
+            proc.on('close', (code) => {
                 clearTimeout(timer);
                 if (timedOut) {
                     (0, logger_1.debug)(`[db sql] gen:db-schema timed out after ${String(TIMEOUT_MS / 1000)}s, killed`);
@@ -170,11 +169,11 @@ async function maybeSyncAgentSchema(results) {
                     (0, logger_1.debug)(`[db sql] gen:db-schema exited with code ${String(code)}`);
                 }
                 else {
-                    (0, logger_1.debug)("[db sql] gen:db-schema completed");
+                    (0, logger_1.debug)('[db sql] gen:db-schema completed');
                 }
                 resolve();
             });
-            proc.on("error", (err) => {
+            proc.on('error', (err) => {
                 clearTimeout(timer);
                 (0, logger_1.debug)(`[db sql] gen:db-schema spawn error: ${err.message}`);
                 resolve();
@@ -194,10 +193,10 @@ async function maybeSyncAgentSchema(results) {
  */
 async function resolveAgentProjectRoot() {
     try {
-        const pkgPath = node_path_1.default.join(AGENT_PROJECT_ROOT, "package.json");
-        const raw = await node_fs_1.promises.readFile(pkgPath, "utf8");
+        const pkgPath = node_path_1.default.join(AGENT_PROJECT_ROOT, 'package.json');
+        const raw = await node_fs_1.promises.readFile(pkgPath, 'utf8');
         const pkg = JSON.parse(raw);
-        if (pkg.scripts?.["gen:db-schema"])
+        if (pkg.scripts?.['gen:db-schema'])
             return AGENT_PROJECT_ROOT;
     }
     catch {
@@ -207,7 +206,7 @@ async function resolveAgentProjectRoot() {
 }
 /** 是否有任意一条 statement 是 DDL（CREATE / ALTER / DROP / GRANT / TRUNCATE / COMMENT 等）。 */
 function hasDdl(results) {
-    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === "ddl");
+    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === 'ddl');
 }
 /** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
 async function readSql(inline) {
@@ -215,17 +214,17 @@ async function readSql(inline) {
         return inline;
     const stdin = process.stdin;
     if (stdin.isTTY)
-        return "";
+        return '';
     return new Promise((resolve, reject) => {
-        let data = "";
-        process.stdin.setEncoding("utf8");
-        process.stdin.on("data", (chunk) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
             data += chunk;
         });
-        process.stdin.on("end", () => {
+        process.stdin.on('end', () => {
             resolve(data);
         });
-        process.stdin.on("error", reject);
+        process.stdin.on('error', reject);
     });
 }
 function renderSingle(raw) {
@@ -235,9 +234,9 @@ function renderSingle(raw) {
         (0, output_1.emit)(toJson(parsed));
         return;
     }
-    if (parsed.kind === "select") {
+    if (parsed.kind === 'select') {
         if (parsed.rows.length === 0) {
-            (0, output_1.emit)("(0 rows)");
+            (0, output_1.emit)('(0 rows)');
             return;
         }
         const cols = collectColumns(parsed.rows);
@@ -245,22 +244,22 @@ function renderSingle(raw) {
         (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(cols, rows) : (0, render_1.renderTsv)(cols, rows));
         return;
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         const verb = dmlVerb(parsed.sqlType);
         (0, output_1.emit)(tty
-            ? colors_1.c.success(`✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? "" : "s"} ${verb}`)
+            ? colors_1.c.success(`✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? '' : 's'} ${verb}`)
             : `OK ${String(parsed.affectedRows)} rows ${verb}`);
         return;
     }
     // DDL
-    (0, output_1.emit)(tty ? colors_1.c.success("✓ DDL executed") : "OK DDL executed");
+    (0, output_1.emit)(tty ? colors_1.c.success('✓ DDL executed') : 'OK DDL executed');
 }
 function toJson(parsed) {
-    if (parsed.kind === "select") {
+    if (parsed.kind === 'select') {
         // PRD 单 SELECT：data 直接是行数组（按 --json 字段投影裁剪）
         return { data: projectRows(parsed.rows) };
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         // PRD 单 DML：data = {command, rows_affected}
         return {
             data: {
@@ -278,10 +277,10 @@ function toJson(parsed) {
  * {command:"SELECT", rows:[...]}（PRD 约定，避免数组里嵌套数组造成歧义）。
  */
 function toMultiElement(parsed) {
-    if (parsed.kind === "select") {
-        return { command: "SELECT", rows: projectRows(parsed.rows) };
+    if (parsed.kind === 'select') {
+        return { command: 'SELECT', rows: projectRows(parsed.rows) };
     }
-    if (parsed.kind === "dml") {
+    if (parsed.kind === 'dml') {
         return { command: parsed.sqlType, rows_affected: parsed.affectedRows };
     }
     // DDL：用后端给的细粒度 command
@@ -307,10 +306,10 @@ function projectRows(rows) {
 /** 读取 --json [fields]：返回字段列表；boolean true 或 undefined 返回 null（不裁剪）。 */
 function parseJsonFields() {
     const v = (0, config_1.getConfig)().json;
-    if (typeof v !== "string" || v === "")
+    if (typeof v !== 'string' || v === '')
         return null;
     return v
-        .split(",")
+        .split(',')
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
@@ -321,9 +320,9 @@ function renderMultiPretty(results) {
     for (let i = 0; i < results.length; i++) {
         const parsed = (0, index_1.parseSqlResult)(results[i]);
         const idx = i + 1;
-        if (parsed.kind === "select") {
+        if (parsed.kind === 'select') {
             const n = parsed.rows.length;
-            lines.push(`Statement ${String(idx)}: SELECT (${String(n)} row${n === 1 ? "" : "s"})`);
+            lines.push(`Statement ${String(idx)}: SELECT (${String(n)} row${n === 1 ? '' : 's'})`);
             if (n > 0) {
                 const cols = collectColumns(parsed.rows);
                 const tbl = parsed.rows.map((r) => cols.map((col) => formatCell(r[col], tty)));
@@ -331,37 +330,37 @@ function renderMultiPretty(results) {
             }
             // 块间空行（最后一条不留）
             if (i < results.length - 1)
-                lines.push("");
+                lines.push('');
             continue;
         }
-        if (parsed.kind === "dml") {
+        if (parsed.kind === 'dml') {
             const verb = dmlVerb(parsed.sqlType);
             const n = parsed.affectedRows;
-            const body = `${String(n)} row${n === 1 ? "" : "s"} ${verb}`;
-            lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success("✓ " + body) : body}`);
+            const body = `${String(n)} row${n === 1 ? '' : 's'} ${verb}`;
+            lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success('✓ ' + body) : body}`);
             continue;
         }
         // DDL
-        lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success("✓ DDL executed") : "DDL executed"}`);
+        lines.push(`Statement ${String(idx)}: ${tty ? colors_1.c.success('✓ DDL executed') : 'DDL executed'}`);
     }
     // 汇总行：所有 statement 都跑完了
     lines.push(tty
         ? colors_1.c.success(`✓ ${String(results.length)} statements executed`)
         : `OK ${String(results.length)} statements executed`);
-    (0, output_1.emit)(lines.join("\n"));
+    (0, output_1.emit)(lines.join('\n'));
 }
 function dmlVerb(type) {
     switch (type) {
-        case "INSERT":
-            return "inserted";
-        case "UPDATE":
-            return "updated";
-        case "DELETE":
-            return "deleted";
-        case "MERGE":
-            return "merged";
-        case "DML":
-            return "affected"; // 未识别子类的兜底
+        case 'INSERT':
+            return 'inserted';
+        case 'UPDATE':
+            return 'updated';
+        case 'DELETE':
+            return 'deleted';
+        case 'MERGE':
+            return 'merged';
+        case 'DML':
+            return 'affected'; // 未识别子类的兜底
     }
 }
 /** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
@@ -381,9 +380,9 @@ function collectColumns(rows) {
  */
 function formatCell(v, tty) {
     if (v === null || v === undefined) {
-        return tty ? colors_1.c.muted("NULL") : "NULL";
+        return tty ? colors_1.c.muted('NULL') : 'NULL';
     }
-    if (typeof v === "string") {
+    if (typeof v === 'string') {
         // TTY 下检测到 ISO 8601 时间字符串 → 转成相对时间（"3h ago" / "2d ago" /
         // "2026-03-15"），方便 _created_at / _updated_at 等列直观可读
         if (tty && ISO_TIMESTAMP_RE.test(v) && !Number.isNaN(Date.parse(v))) {
@@ -391,7 +390,7 @@ function formatCell(v, tty) {
         }
         return v;
     }
-    if (typeof v === "number" || typeof v === "boolean")
+    if (typeof v === 'number' || typeof v === 'boolean')
         return String(v);
     // object / array → JSON
     return JSON.stringify(v);
@@ -488,7 +487,7 @@ async function loadTableMap(ctx) {
     try {
         const resp = await api.db.getSchema({
             appId: ctx.appId,
-            format: "schema",
+            format: 'schema',
             dbBranch: ctx.env,
         });
         return extractTableFieldMap(resp.schema);
@@ -501,7 +500,7 @@ function enrichRelationNotExist(err, relation, tableMap) {
     const guess = (0, fuzzy_match_1.suggest)(relation, Object.keys(tableMap));
     err.next_actions.push(guess
         ? `Did you mean '${guess}'? Run \`miaoda db schema list\` to see all tables.`
-        : "Run `miaoda db schema list` to see all tables.");
+        : 'Run `miaoda db schema list` to see all tables.');
 }
 function enrichColumnNotExist(err, colMatch, tableMap) {
     const colName = colMatch[1];
@@ -523,7 +522,7 @@ function enrichColumnNotExist(err, colMatch, tableMap) {
     const guess = (0, fuzzy_match_1.suggest)(colName, allCols);
     err.next_actions.push(guess
         ? `Did you mean '${guess}'? Run \`miaoda db schema get <table>\` to see columns.`
-        : "Run `miaoda db schema get <table>` to see all columns.");
+        : 'Run `miaoda db schema get <table>` to see all columns.');
 }
 /**
  * 扫整段 SQL 找一个看似"拼错的关键字"token：纯字母 + 长度 ≥ 3 + 不是已知 keyword
@@ -594,7 +593,7 @@ function enrichMultiStatementError(err, sql) {
     }
     // rolled_back=true 时追加 spec hint："Transaction rolled back; no changes persisted."
     if (err.rolled_back) {
-        err.next_actions.push("Transaction rolled back; no changes persisted.");
+        err.next_actions.push('Transaction rolled back; no changes persisted.');
     }
 }
 /**
@@ -606,9 +605,9 @@ function enrichMultiStatementError(err, sql) {
 function inferRolledBack(completed) {
     let depth = 0;
     for (const e of completed) {
-        if (e.command === "BEGIN")
+        if (e.command === 'BEGIN')
             depth++;
-        else if (e.command === "COMMIT" || e.command === "ROLLBACK")
+        else if (e.command === 'COMMIT' || e.command === 'ROLLBACK')
             depth--;
     }
     return depth > 0;
@@ -631,25 +630,25 @@ function writeMultiStatementBreakdown(err, completed) {
     const lines = [];
     for (let i = 0; i < completed.length; i++) {
         const e = completed[i];
-        const verb = e.command === "BEGIN" || e.command === "COMMIT" || e.command === "ROLLBACK"
+        const verb = e.command === 'BEGIN' || e.command === 'COMMIT' || e.command === 'ROLLBACK'
             ? e.command
             : describeCompleted(e);
-        lines.push(`Statement ${String(i + 1)}: ${tty ? colors_1.c.success("✓ ") : "✓ "}${verb}`);
+        lines.push(`Statement ${String(i + 1)}: ${tty ? colors_1.c.success('✓ ') : '✓ '}${verb}`);
     }
     // 失败那条
     const failedIdx = err.statement_index ?? completed.length;
-    lines.push(`Statement ${String(failedIdx + 1)}: ${tty ? colors_1.c.fail("✗ ") : "✗ "}${err.message}`);
-    process.stderr.write(lines.join("\n") + "\n\n");
+    lines.push(`Statement ${String(failedIdx + 1)}: ${tty ? colors_1.c.fail('✗ ') : '✗ '}${err.message}`);
+    process.stderr.write(lines.join('\n') + '\n\n');
 }
 /** completed 单条结果的人类可读描述（用于 stderr breakdown 行尾）。 */
 function describeCompleted(e) {
     const r = e;
-    if (r.command === "SELECT" && Array.isArray(r.rows)) {
-        return `SELECT (${String(r.rows.length)} row${r.rows.length === 1 ? "" : "s"})`;
+    if (r.command === 'SELECT' && Array.isArray(r.rows)) {
+        return `SELECT (${String(r.rows.length)} row${r.rows.length === 1 ? '' : 's'})`;
     }
-    if (typeof r.rows_affected === "number") {
+    if (typeof r.rows_affected === 'number') {
         const verb = dmlVerb(r.command);
-        return `${String(r.rows_affected)} row${r.rows_affected === 1 ? "" : "s"} ${verb}`;
+        return `${String(r.rows_affected)} row${r.rows_affected === 1 ? '' : 's'} ${verb}`;
     }
     return `${r.command} executed`;
 }

package/dist/cli/handlers/deploy/deploy.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeploy = handleDeploy;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/deploy/index");
+const polling_1 = require("./polling");
+const format_1 = require("./format");
+/** miaoda deploy [--branch ...] [--wait] [--timeout 300] */
+async function handleDeploy(opts) {
+    const appID = opts.appId;
+    const resp = await api.deploy.createRelease({ appID, branch: opts.branch });
+    const pipelineTaskID = resp.pipelineTaskID ?? '';
+    if (!opts.wait) {
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`✓ Deployment triggered. (deploy-id: ${pipelineTaskID})\n`);
+            process.stdout.write(`  hint: No terminal status yet. Poll every 2s with \`miaoda deploy get ${pipelineTaskID} --json\`; if no deploy-id is visible, first get it from \`miaoda deploy history --limit 1 --json\`.\n`);
+        }
+        (0, output_1.emit)({
+            data: { pipelineTaskID },
+            next_cursor: null,
+            has_more: false,
+        });
+        return;
+    }
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write(`Waiting for deployment to complete... (deploy-id: ${pipelineTaskID})\n`);
+    }
+    const detail = await (0, polling_1.waitForPipeline)({
+        appID,
+        pipelineTaskID,
+        timeoutSec: opts.timeout ?? 300,
+    });
+    if (!(0, output_1.isJsonMode)()) {
+        if (detail.status === index_1.NodeStatus.SUCCESS) {
+            process.stdout.write('✓ 发布成功\n');
+        }
+        else if (detail.status === index_1.NodeStatus.FAILED) {
+            process.stdout.write('✗ 发布失败\n');
+            process.stdout.write(`  hint: Run \`miaoda deploy error-log ${pipelineTaskID}\` to view error logs\n`);
+        }
+        else {
+            process.stdout.write('• 发布已取消\n');
+        }
+    }
+    (0, output_1.emit)({
+        data: { pipelineTaskID, detail: (0, format_1.formatPipelineInstance)(detail) },
+        next_cursor: null,
+        has_more: false,
+    });
+}