@lark-apaas/miaoda-cli 0.1.0 → 0.1.1

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

@@ -0,0 +1,367 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbSql = handleDbSql;
+const api = __importStar(require("../../../api/index"));
+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 index_1 = require("../../../api/db/index");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * miaoda db sql <query> — 执行任意 SQL。
+ *
+ * - query 为空时读 stdin
+ * - --env 透传给后端 admin-inner（dbBranch 参数），不传时由后端按 workspace
+ *   多环境状态兜底（多环境 → dev / 单环境 → main）；后端检测到环境不存在
+ *   会返 k_dl_1600000 + "Invalid DB Branch:..."，CLI 侧映射为 MULTI_ENV_NOT_INITIALIZED
+ * - 多语句行为对齐 PRD：每条 statement 一个独立结果元素，pretty 逐条 +
+ *   末尾汇总，--json 输出 data 数组。
+ */
+async function handleDbSql(query, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const sql = await readSql(query);
+    if (!sql.trim()) {
+        throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");
+    }
+    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    if (results.length === 0) {
+        // 后端未返回任何结果，通常不会发生
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emit)({ data: [] });
+            return;
+        }
+        (0, output_1.emit)("✓ No results");
+        return;
+    }
+    if (results.length === 1) {
+        renderSingle(results[0]);
+        await maybeSyncAgentSchema(results);
+        return;
+    }
+    // 多语句：每条 statement 独立结果
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: results.map((r) => toMultiElement((0, index_1.parseSqlResult)(r))) });
+    }
+    else {
+        renderMultiPretty(results);
+    }
+    await maybeSyncAgentSchema(results);
+}
+/**
+ * 当本次 SQL 包含成功执行的 DDL 时，触发 `npm run gen:db-schema`（实质执行
+ * fullstack-cli gen-db-schema → drizzle-kit introspect）同步 agent 项目的
+ * schema.ts。**弱依赖**：失败不阻塞主流程退出码。
+ *
+ * 行为细节：
+ *   - 仅当 cwd/package.json 定义了 gen:db-schema 脚本时才尝试运行；非 agent
+ *     项目静默跳过
+ *   - 默认静默捕获子进程 stdout/stderr，成功只打一行 "Agent schema synced"，
+ *     失败时把捕获的输出回放给用户排查；--verbose 实时透传方便看进度
+ *   - 加 60s 兜底超时：drizzle-kit introspect 通常 < 30s，超时直接 SIGKILL，
+ *     避免 DB 慢或网络抖动时把 CLI 挂死
+ *   - 子进程的 stdout / stderr 都不会进入当前 CLI 的 stdout，--json 输出干净
+ *
+ * 调用时机：在 SQL 主输出 emit 完成之后；execSql 已经返回意味着所有
+ * statement 都执行成功，无需再校验逐条状态。
+ */
+/** agent runtime 中固定的项目根目录；放在此处便于以后调整。 */
+const AGENT_PROJECT_ROOT = "/home/gem/workspace/code";
+/** drain 子进程 pipe stream：默认静默模式下消费 chunk 防止缓冲区反压。 */
+function drainChunk(_chunk) {
+    // 显式接 chunk 参数让 ESLint 不再当成 empty function；不做任何处理
+}
+async function maybeSyncAgentSchema(results) {
+    if (!hasDdl(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");
+        return;
+    }
+    const verbose = (0, config_1.getConfig)().verbose;
+    // drizzle-kit introspect 通常 < 30s；60s 兜底，超过即认为卡住
+    const TIMEOUT_MS = 60_000;
+    (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"],
+                cwd: projectRoot,
+            });
+            // --verbose：实时透传到 stderr 看进度；默认完全静默丢弃。
+            // 任何路径下子进程输出都不会进入当前 CLI 的 stdout，--json 模式安全。
+            // 注：默认路径必须 attach 监听器，否则 pipe 缓冲区写满会反压子进程。
+            if (verbose) {
+                proc.stdout.pipe(process.stderr);
+                proc.stderr.pipe(process.stderr);
+            }
+            else {
+                proc.stdout.on("data", drainChunk);
+                proc.stderr.on("data", drainChunk);
+            }
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                proc.kill("SIGKILL");
+            }, TIMEOUT_MS);
+            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`);
+                }
+                else if (code !== 0 && code !== null) {
+                    (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");
+                }
+                resolve();
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                (0, logger_1.debug)(`[db sql] gen:db-schema spawn error: ${err.message}`);
+                resolve();
+            });
+        });
+    }
+    catch (err) {
+        (0, logger_1.debug)(`[db sql] gen:db-schema unexpected error: ${String(err)}`);
+    }
+}
+/**
+ * 校验 AGENT_PROJECT_ROOT 是否是一个有效的 agent 项目（package.json 含
+ * `gen:db-schema` 脚本）。命中返回路径；缺失任一条件返 null，让调用方静默跳过。
+ *
+ * 这里不再从 process.cwd() 向上查找：agent runtime 里项目根是固定路径，
+ * 在 CLI 之外（本地手动跑 miaoda db sql）也不应触发同步。
+ */
+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 pkg = JSON.parse(raw);
+        if (pkg.scripts?.["gen:db-schema"])
+            return AGENT_PROJECT_ROOT;
+    }
+    catch {
+        // 路径不存在 / 不可读 / 不是 agent 项目 → 静默跳过
+    }
+    return null;
+}
+/** 是否有任意一条 statement 是 DDL（CREATE / ALTER / DROP / GRANT / TRUNCATE / COMMENT 等）。 */
+function hasDdl(results) {
+    return results.some((r) => (0, index_1.parseSqlResult)(r).kind === "ddl");
+}
+/** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
+async function readSql(inline) {
+    if (inline !== undefined && inline.length > 0)
+        return inline;
+    const stdin = process.stdin;
+    if (stdin.isTTY)
+        return "";
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => {
+            resolve(data);
+        });
+        process.stdin.on("error", reject);
+    });
+}
+function renderSingle(raw) {
+    const parsed = (0, index_1.parseSqlResult)(raw);
+    const tty = (0, render_1.isStdoutTty)();
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)(toJson(parsed));
+        return;
+    }
+    if (parsed.kind === "select") {
+        if (parsed.rows.length === 0) {
+            (0, output_1.emit)("(0 rows)");
+            return;
+        }
+        const cols = collectColumns(parsed.rows);
+        const rows = parsed.rows.map((r) => cols.map((c) => formatCell(r[c], tty)));
+        (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(cols, rows) : (0, render_1.renderTsv)(cols, rows));
+        return;
+    }
+    if (parsed.kind === "dml") {
+        const verb = dmlVerb(parsed.sqlType);
+        (0, output_1.emit)(tty
+            ? `✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? "" : "s"} ${verb}`
+            : `OK ${String(parsed.affectedRows)} rows ${verb}`);
+        return;
+    }
+    // DDL
+    (0, output_1.emit)(tty ? "✓ DDL executed" : "OK DDL executed");
+}
+function toJson(parsed) {
+    if (parsed.kind === "select") {
+        // PRD 单 SELECT：data 直接是行数组（按 --json 字段投影裁剪）
+        return { data: projectRows(parsed.rows) };
+    }
+    if (parsed.kind === "dml") {
+        // PRD 单 DML：data = {command, rows_affected}
+        return {
+            data: {
+                command: parsed.sqlType,
+                rows_affected: parsed.affectedRows,
+            },
+        };
+    }
+    // PRD 单 DDL：data = {command, target?}。command 直接用后端给的细粒度
+    // （CREATE_TABLE / DROP_TABLE / ...），target 待后端给对象名后再加。
+    return { data: { command: parsed.sqlType } };
+}
+/**
+ * 多语句 --json 元素：与单 DDL/DML 形状一致，但 SELECT 包成
+ * {command:"SELECT", rows:[...]}（PRD 约定，避免数组里嵌套数组造成歧义）。
+ */
+function toMultiElement(parsed) {
+    if (parsed.kind === "select") {
+        return { command: "SELECT", rows: projectRows(parsed.rows) };
+    }
+    if (parsed.kind === "dml") {
+        return { command: parsed.sqlType, rows_affected: parsed.affectedRows };
+    }
+    // DDL：用后端给的细粒度 command
+    return { command: parsed.sqlType };
+}
+/**
+ * PRD：`--json id,name` 字段投影。--json 不带值（boolean true）等价于不裁剪。
+ * 字段不存在时按 undefined 处理（JSON.stringify 会忽略 undefined value 的 key），
+ * 这样 Agent 拿到的 row 永远只含请求过的列。
+ */
+function projectRows(rows) {
+    const fields = parseJsonFields();
+    if (!fields)
+        return rows;
+    return rows.map((r) => {
+        const out = {};
+        for (const f of fields) {
+            out[f] = r[f];
+        }
+        return out;
+    });
+}
+/** 读取 --json [fields]：返回字段列表；boolean true 或 undefined 返回 null（不裁剪）。 */
+function parseJsonFields() {
+    const v = (0, config_1.getConfig)().json;
+    if (typeof v !== "string" || v === "")
+        return null;
+    return v.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+}
+/** 多语句 pretty：逐条 `Statement N: ...` + 末尾 `✓ N statements executed`。 */
+function renderMultiPretty(results) {
+    const tty = (0, render_1.isStdoutTty)();
+    const lines = [];
+    for (let i = 0; i < results.length; i++) {
+        const parsed = (0, index_1.parseSqlResult)(results[i]);
+        const idx = i + 1;
+        if (parsed.kind === "select") {
+            const n = parsed.rows.length;
+            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((c) => formatCell(r[c], tty)));
+                lines.push(tty ? (0, render_1.renderAlignedTable)(cols, tbl) : (0, render_1.renderTsv)(cols, tbl));
+            }
+            // 块间空行（最后一条不留）
+            if (i < results.length - 1)
+                lines.push("");
+            continue;
+        }
+        if (parsed.kind === "dml") {
+            const verb = dmlVerb(parsed.sqlType);
+            const n = parsed.affectedRows;
+            lines.push(`Statement ${String(idx)}: ${tty ? "✓ " : ""}${String(n)} row${n === 1 ? "" : "s"} ${verb}`);
+            continue;
+        }
+        // DDL
+        lines.push(`Statement ${String(idx)}: ${tty ? "✓ " : ""}DDL executed`);
+    }
+    // 汇总行：所有 statement 都跑完了
+    lines.push(tty
+        ? `✓ ${String(results.length)} statements executed`
+        : `OK ${String(results.length)} statements executed`);
+    (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"; // 未识别子类的兜底
+    }
+}
+/** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
+function collectColumns(rows) {
+    if (rows.length === 0)
+        return [];
+    return Object.keys(rows[0]);
+}
+/**
+ * SQL 单元格 → 字符串：
+ * - null / undefined → "NULL"（TTY 下用 dim+gray ANSI 弱化，对齐 mysql/DuckDB；
+ *   non-TTY 用裸字面量，避免被 cat / 管道吞掉样式；JSON 模式不会走到这里，
+ *   走 toJson 直接用 parsed.rows，JSON.stringify 输出 `null` 字面）
+ * - string → 原样
+ * - number / boolean → toString
+ * - object / array → JSON.stringify
+ */
+function formatCell(v, tty) {
+    if (v === null || v === undefined) {
+        return tty ? "\u001b[2;90mNULL\u001b[0m" : "NULL";
+    }
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    // object / array → JSON
+    return JSON.stringify(v);
+}

package/dist/cli/handlers/file/cp.js

@@ -0,0 +1,220 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFileCp = handleFileCp;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
+/**
+ * 判断 src 是本地文件还是远程引用：
+ * - src 本地 fs 可访问 → upload（dst 当 remote）
+ * - 其他 → download（src 是 /path 或 file_name，由 resolveRemotePath 解析）
+ *
+ * `cp` 语义要求 src 必须存在；本地不存在就认为用户指向远程。不需要给 dst 猜方向。
+ */
+function isLocalSrc(src) {
+    const expanded = expandHome(src);
+    try {
+        return node_fs_1.default.existsSync(expanded);
+    }
+    catch {
+        return false;
+    }
+}
+function expandHome(p) {
+    if (p.startsWith("~/"))
+        return node_path_1.default.join(node_os_1.default.homedir(), p.slice(2));
+    return p;
+}
+function detectMime(filePath) {
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    const map = {
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".gif": "image/gif",
+        ".webp": "image/webp",
+        ".svg": "image/svg+xml",
+        ".pdf": "application/pdf",
+        ".json": "application/json",
+        ".csv": "text/csv",
+        ".txt": "text/plain",
+        ".html": "text/html",
+        ".zip": "application/zip",
+        ".tar": "application/x-tar",
+        ".gz": "application/gzip",
+        ".mp4": "video/mp4",
+        ".mp3": "audio/mpeg",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+/** 把 src 的远程形式（`/path` / `file_name`）解析成后端 sign 可用的 remote path。 */
+async function resolveRemotePath(appId, input) {
+    if (input.startsWith("/"))
+        return input;
+    const [resolved] = await api.file.resolveInputs({ appId, inputs: [input] });
+    if (resolved.status === "error") {
+        throw new error_1.AppError(resolved.error.code, resolved.error.message, {
+            next_actions: resolved.error.hint ? [resolved.error.hint] : undefined,
+        });
+    }
+    return resolved.file.path;
+}
+async function handleUpload(appId, localRaw, remoteRaw, rename) {
+    const localPath = expandHome(localRaw);
+    if (!node_fs_1.default.existsSync(localPath) || !node_fs_1.default.statSync(localPath).isFile()) {
+        throw new error_1.AppError("FILE_SRC_NOT_FOUND", `Local file '${localRaw}' does not exist`);
+    }
+    const stat = node_fs_1.default.statSync(localPath);
+    if (stat.size > MAX_UPLOAD_BYTES) {
+        throw new error_1.AppError("FILE_SIZE_EXCEEDED", `File size ${(0, render_1.formatSize)(stat.size)} exceeds the 100 MB upload limit`, {
+            next_actions: [
+                "Split the file, or use the web console for large uploads.",
+            ],
+        });
+    }
+    const fileName = rename ?? node_path_1.default.basename(localPath);
+    let remotePath = remoteRaw;
+    if (remoteRaw.endsWith("/")) {
+        remotePath = remoteRaw + fileName;
+    }
+    else if (remoteRaw === "/") {
+        remotePath = "/" + fileName;
+    }
+    const contentType = detectMime(localPath);
+    const result = await api.file.uploadFile({
+        appId,
+        localPath,
+        remotePath,
+        fileName,
+        fileSize: stat.size,
+        contentType,
+        readFile: async () => node_fs_1.default.promises.readFile(localPath),
+    });
+    if ((0, output_1.isJsonMode)()) {
+        const payload = {
+            file_name: result.file_name,
+            path: result.path,
+            size_bytes: result.size,
+            type: result.type,
+        };
+        if (result.download_url)
+            payload.download_url = result.download_url;
+        (0, output_1.emitOk)(payload);
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const lines = [];
+    if (tty) {
+        lines.push(`✓ Uploaded ${node_path_1.default.basename(localPath)} → ${result.path}`);
+        lines.push(`   file_name:     ${result.file_name}`);
+        lines.push(`   path:          ${result.path}`);
+        lines.push(`   size:          ${(0, render_1.formatSize)(result.size)} (${String(result.size)} bytes)`);
+        lines.push(`   type:          ${result.type}`);
+        if (result.download_url) {
+            lines.push(`   download_url:  ${result.download_url}`);
+        }
+    }
+    else {
+        lines.push(`OK Uploaded ${node_path_1.default.basename(localPath)} -> ${result.path}`);
+        lines.push(`file_name\t${result.file_name}`);
+        lines.push(`path\t${result.path}`);
+        lines.push(`size\t${String(result.size)}`);
+        lines.push(`type\t${result.type}`);
+        if (result.download_url) {
+            lines.push(`download_url\t${result.download_url}`);
+        }
+    }
+    (0, output_1.emit)(lines.join("\n"));
+}
+async function handleDownload(appId, remoteRaw, localRaw) {
+    const filePath = await resolveRemotePath(appId, remoteRaw);
+    const sign = await api.file.signDownload({
+        appId,
+        filePath,
+        expiresIn: 300,
+    });
+    const baseName = node_path_1.default.basename(filePath);
+    let localTarget = expandHome(localRaw);
+    if (localTarget === "./" || localTarget === "." || localTarget.endsWith("/")) {
+        localTarget = node_path_1.default.join(localTarget, baseName);
+    }
+    else if (node_fs_1.default.existsSync(localTarget) && node_fs_1.default.statSync(localTarget).isDirectory()) {
+        localTarget = node_path_1.default.join(localTarget, baseName);
+    }
+    let writtenBytes = 0;
+    await api.file.downloadFile({
+        signedURL: sign.signed_url,
+        writeFile: async (buf) => {
+            await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(node_path_1.default.resolve(localTarget)), {
+                recursive: true,
+            });
+            await node_fs_1.default.promises.writeFile(localTarget, buf);
+            writtenBytes = buf.length;
+        },
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)({
+            path: filePath,
+            local_path: localTarget,
+            size: writtenBytes,
+        });
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    if (tty) {
+        (0, output_1.emit)(`✓ Downloaded ${baseName} → ${localTarget} (${(0, render_1.formatSize)(writtenBytes)})`);
+    }
+    else {
+        (0, output_1.emit)(`OK Downloaded ${baseName} -> ${localTarget} (${String(writtenBytes)} bytes)`);
+    }
+}
+async function handleFileCp(src, dst, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // src 本地存在 → upload；其他情况（file_ref / `/path` / 裸文件名）→ download
+    if (isLocalSrc(src)) {
+        return handleUpload(appId, src, dst, opts.rename);
+    }
+    return handleDownload(appId, src, dst);
+}

package/dist/cli/handlers/file/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
+var ls_1 = require("./ls");
+Object.defineProperty(exports, "handleFileLs", { enumerable: true, get: function () { return ls_1.handleFileLs; } });
+var stat_1 = require("./stat");
+Object.defineProperty(exports, "handleFileStat", { enumerable: true, get: function () { return stat_1.handleFileStat; } });
+var cp_1 = require("./cp");
+Object.defineProperty(exports, "handleFileCp", { enumerable: true, get: function () { return cp_1.handleFileCp; } });
+var rm_1 = require("./rm");
+Object.defineProperty(exports, "handleFileRm", { enumerable: true, get: function () { return rm_1.handleFileRm; } });
+var sign_1 = require("./sign");
+Object.defineProperty(exports, "handleFileSign", { enumerable: true, get: function () { return sign_1.handleFileSign; } });