@lark-apaas/miaoda-cli 0.1.0-alpha.097a394

package/dist/cli/commands/plugin/index.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPluginCommands = registerPluginCommands;
+const index_1 = require("../../../cli/handlers/plugin/index");
+function registerPluginCommands(program) {
+    const pluginCmd = program
+        .command("plugin")
+        .description("插件管理：安装/更新/移除插件包，查询 capability 实例");
+    pluginCmd.action(() => {
+        pluginCmd.outputHelp();
+    });
+    pluginCmd.addHelpText("after", `
+概念
+  - 插件包 (plugin package)：.tgz 包，释放到 ./node_modules/<name>
+  - actionPlugins：./package.json 里的字段，记录 { "@scope/name": "version" }，作为
+                   当前应用项目依赖的插件清单；install/update/remove/init 读写此字段
+  - capability 实例：./server/capabilities/<id>.json，描述该应用下具体使用的
+                    插件实例（pluginKey + formValue + paramsSchema）
+  - 充血 (hydrate)：读取插件 manifest.json，把 capability 与 manifest 的
+                    inputSchema/outputSchema 合并输出完整 action 定义
+
+作用范围
+  本地落点统一为 cwd 下的 package.json / node_modules / server/capabilities。
+  - install / update / init：通过 platform HTTP 拉取插件版本与 .tgz
+  - remove / list / list-packages：纯本地 FS，不走网络
+`);
+    pluginCmd
+        .command("install")
+        .description("拉取插件包并安装到当前应用项目")
+        .argument("<names...>", "插件名，格式 @scope/name 或 @scope/name@version；未带版本默认 latest")
+        .addHelpText("after", `
+行为
+  - 拉取 .tgz 到本地缓存，解压到 ./node_modules/<name>
+  - 在 ./package.json 的 actionPlugins 字段记录 <name>: <version>
+  - 自动补齐插件声明的 peerDependencies
+  - 同版本已安装则跳过（幂等）
+
+前置
+  - 当前工作目录必须包含 package.json
+
+JSON 输出
+  {
+    "installed": ["@demo/example-plugin@1.2.3", ...],
+    "skipped":   ["@demo/existing-plugin", ...],
+    "failed":    [{"name": "@demo/bad", "error": "..."}]
+  }
+
+退出码
+  0：全部成功；1：至少一个失败（其余仍会尝试）
+
+示例
+  $ miaoda plugin install @demo/example-plugin
+  $ miaoda plugin install @demo/example-plugin@1.2.3 @demo/other-plugin --json
+
+  # 报错：包名格式不合法
+  $ miaoda plugin install bad-name
+  Error: Invalid plugin name format: bad-name. Expected: @scope/name or @scope/name@version
+    hint: 示例：@demo/example-plugin 或 @demo/example-plugin@1.2.3
+`)
+        .action(async (names) => { await (0, index_1.handlePluginInstall)({ names }); });
+    pluginCmd
+        .command("update")
+        .description("把已安装插件升级到 latest 版本")
+        .argument("<names...>", "插件名，格式 @scope/name；带 @version 也只取 name 部分")
+        .addHelpText("after", `
+行为
+  - 仅对已在 actionPlugins 里的插件生效；未安装的插件返回 notInstalled
+  - 拉取 latest 版本 .tgz，覆盖安装到 ./node_modules/<name>
+  - 版本一致则跳过（幂等）；版本变化时同步写回 actionPlugins
+
+前置
+  - 当前工作目录必须包含 package.json
+
+JSON 输出
+  {
+    "updated":      [{"name": "...", "from": "1.0.0", "to": "1.2.3"}],
+    "skipped":      ["..."],            // 已是 latest
+    "notInstalled": ["..."],            // 未安装，未尝试
+    "failed":       [{"name": "...", "error": "..."}]
+  }
+
+退出码
+  0：全部成功或仅有 notInstalled；1：至少一个 failed
+
+示例
+  $ miaoda plugin update @demo/example-plugin
+  $ miaoda plugin update @demo/a @demo/b --json
+
+  # 场景：插件未登记（非抛错，出现在返回的 notInstalled）
+  $ miaoda plugin update @demo/not-installed --json
+  {"updated":[],"skipped":[],"notInstalled":["@demo/not-installed"],"failed":[]}
+`)
+        .action(async (names) => { await (0, index_1.handlePluginUpdate)({ names }); });
+    pluginCmd
+        .command("remove")
+        .description("从当前项目移除一个已安装的插件")
+        .argument("<name>", "插件名，格式 @scope/name")
+        .addHelpText("after", `
+行为
+  - 删除 ./node_modules/<name> 目录
+  - 从 ./package.json 的 actionPlugins 字段移除对应条目
+
+前置
+  - 插件必须已登记在 actionPlugins 中，否则抛 NOT_FOUND
+
+JSON 输出
+  {"removed": "@demo/example-plugin"}
+
+示例
+  $ miaoda plugin remove @demo/example-plugin
+
+  # 报错：插件未登记
+  $ miaoda plugin remove @demo/not-installed
+  Error: Plugin @demo/not-installed is not installed
+    hint: 运行 miaoda plugin list-packages 查看已安装插件
+`)
+        .action((name) => { (0, index_1.handlePluginRemove)({ name }); });
+    pluginCmd
+        .command("init")
+        .description("按 package.json 的 actionPlugins 批量安装所有插件")
+        .addHelpText("after", `
+行为
+  - 读取 ./package.json 的 actionPlugins，对每个条目按固定版本安装
+  - 已经是目标版本的跳过（幂等），用于 clone 项目后首次同步 / CI
+
+前置
+  - 当前工作目录必须包含 package.json
+
+JSON 输出
+  {
+    "installed": ["@demo/a@1.0.0", ...],
+    "skipped":   ["@demo/b", ...],
+    "failed":    [{"name": "...", "error": "..."}]
+  }
+  当 actionPlugins 为空时输出 {"message": "No plugins found in package.json", "installed": [], "skipped": []}
+
+退出码
+  0：全部成功；1：至少一个 failed
+
+示例
+  $ miaoda plugin init --json
+
+  # 报错：当前目录没有 package.json
+  $ miaoda plugin init
+  Error: package.json not found in current directory
+    hint: 在应用项目根目录运行
+`)
+        .action(async () => { await (0, index_1.handlePluginInit)(); });
+    pluginCmd
+        .command("list")
+        .description("列出当前项目的 capability 实例（./server/capabilities/*.json）")
+        .option("--summary", "不 hydrate（不充血），直接返回 capability 文件的原始 JSON")
+        .option("--id <id>", "只查询指定 id 的单个 capability")
+        .addHelpText("after", `
+行为
+  - 扫描 ./server/capabilities/*.json（排除 capabilities.json）
+  - 默认对每条 capability 做 hydrate：读取 ./node_modules/<pluginKey>/manifest.json，
+    合并得到每个 action 的最终 inputSchema / outputSchema
+  - hydrate 失败不抛错，每条结果上带 _hydrateError 字段
+
+前置
+  - ./server/capabilities 目录必须存在，否则抛 NOT_FOUND
+  - 充血模式下需要对应插件已安装在 ./node_modules，否则该条 _hydrateError
+
+JSON 输出
+  - 无 --id：数组，元素为 hydrate 后的 capability，含 actions[].inputSchema 等
+  - 带 --id：单个对象
+  - 带 --summary：不做 hydrate，返回原始 RawCapability 结构
+
+示例
+  $ miaoda plugin list --json
+  $ miaoda plugin list --id cap_demo_xxx --json
+  $ miaoda plugin list --summary --json
+
+  # 报错：capability 目录不存在
+  $ miaoda plugin list
+  Error: server/capabilities directory not found
+    hint: 当前目录必须是含 server/capabilities/ 的应用项目
+`)
+        .action(async (opts) => { await (0, index_1.handlePluginList)(opts); });
+    pluginCmd
+        .command("list-packages")
+        .description("列出 package.json actionPlugins 里已声明的插件包")
+        .addHelpText("after", `
+行为
+  - 读取 ./package.json 的 actionPlugins 字段
+  - 只看声明，不校验 ./node_modules 下是否实际存在
+
+JSON 输出
+  {
+    "plugins": [{"name": "@demo/example-plugin", "version": "1.2.3"}, ...],
+    "total":   <number>
+  }
+
+示例
+  $ miaoda plugin list-packages --json
+
+  # 报错：当前目录没有 package.json
+  $ miaoda plugin list-packages
+  Error: package.json not found in current directory
+    hint: 在应用项目根目录运行
+`)
+        .action(() => { (0, index_1.handlePluginListPlugins)(); });
+}

package/dist/cli/commands/shared.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appIdOption = appIdOption;
+exports.softRequiredOption = softRequiredOption;
+exports.resolveAppId = resolveAppId;
+exports.withHelp = withHelp;
+exports.failArgs = failArgs;
+const commander_1 = require("commander");
+const error_1 = require("../../utils/error");
+/** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption()) */
+function appIdOption() {
+    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
+}
+/**
+ * soft-required: Commander 类型上 optional，runtime 校验必填。
+ */
+function softRequiredOption(name, desc) {
+    return new commander_1.Option(name, desc);
+}
+/** 解析 appId，CLI flag > env > 抛错 */
+function resolveAppId(opts) {
+    const id = opts.appId ?? process.env.MIAODA_APP_ID;
+    if (!id) {
+        throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
+            next_actions: [
+                "传入 --app-id <id>",
+                "设置 export MIAODA_APP_ID=<id>",
+            ],
+        });
+    }
+    return id;
+}
+/** 包裹 handler，缺 soft-required 参数时打 help 并退出 */
+function withHelp(cmd, handler) {
+    return async (opts) => {
+        try {
+            await handler(opts);
+        }
+        catch (err) {
+            if (err instanceof error_1.AppError && err.code === "ARGS_INVALID") {
+                process.stderr.write(`Error: ${err.message}\n`);
+                cmd.outputHelp();
+                process.exitCode = 2;
+                return;
+            }
+            throw err;
+        }
+    };
+}
+/** 参数校验失败时抛出，配合 withHelp 自动打 help */
+function failArgs(message) {
+    throw new error_1.AppError("ARGS_INVALID", message);
+}

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

@@ -0,0 +1,167 @@
+"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.handleDbDataImport = handleDbDataImport;
+exports.handleDbDataExport = handleDbDataExport;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const shared_1 = require("../../../cli/commands/shared");
+const shared_2 = require("../../../cli/handlers/shared");
+// P0 规格（对齐技术方案关键决策 2）
+const MAX_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
+const MAX_ROWS = 5000;
+async function handleDbDataImport(file, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ext = path.extname(file).toLowerCase();
+    const format = resolveFormat(opts.format, ext, "import");
+    let body;
+    try {
+        body = await fs.readFile(file);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            throw new error_1.AppError("IMPORT_FILE_NOT_FOUND", `Local file '${file}' does not exist`, { next_actions: ["Check the file path."] });
+        }
+        throw err;
+    }
+    if (body.length > MAX_SIZE_BYTES) {
+        throw new error_1.AppError("IMPORT_SIZE_EXCEEDED", `Import exceeds 1 MB limit (file is ${String(body.length)} bytes)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+    }
+    const rowCount = countRows(body, format);
+    if (rowCount > MAX_ROWS) {
+        throw new error_1.AppError("IMPORT_ROWS_EXCEEDED", `Import exceeds 5000 rows limit (file has ${String(rowCount)} rows)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+    }
+    const tableName = opts.table ?? path.basename(file, ext);
+    if (!tableName) {
+        throw new error_1.AppError("ARGS_INVALID", "Cannot infer target table from file name; specify --table");
+    }
+    const result = await api.db.importData({
+        appId,
+        tableName,
+        format,
+        body,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({
+            data: {
+                file,
+                table: result.tableName,
+                rows: result.rows,
+            },
+        });
+        return;
+    }
+    const tty = (0, shared_2.isStdoutTty)();
+    (0, output_1.emit)(tty
+        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.rows)} rows)`
+        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.rows)} rows)`);
+}
+async function handleDbDataExport(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const format = resolveFormat(opts.format, undefined, "export", "csv");
+    const outputPath = opts.file ?? `${table}.${format}`;
+    const limit = opts.limit ? Number(opts.limit) : MAX_ROWS;
+    if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_ROWS) {
+        throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer ≤ ${String(MAX_ROWS)}`);
+    }
+    const result = await api.db.exportData({
+        appId,
+        tableName: table,
+        format,
+        limit,
+    });
+    if (result.body.length > MAX_SIZE_BYTES) {
+        throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, { next_actions: [`Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`] });
+    }
+    await fs.writeFile(outputPath, result.body);
+    const rows = countRows(result.body, format);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({
+            data: {
+                table,
+                file: outputPath,
+                format,
+                rows,
+            },
+        });
+        return;
+    }
+    const tty = (0, shared_2.isStdoutTty)();
+    (0, output_1.emit)(tty
+        ? `✓ Exported ${table} → ${outputPath} (${String(rows)} rows)`
+        : `OK Exported ${table} -> ${outputPath} (${String(rows)} rows)`);
+}
+// ── 共用辅助 ──
+function resolveFormat(explicit, ext, scope, fallback) {
+    const raw = (explicit ?? ext ?? fallback ?? "").replace(/^\./, "").toLowerCase();
+    if (raw === "csv")
+        return "csv";
+    if (raw === "json")
+        return "json";
+    const code = scope === "import" ? "IMPORT_FORMAT_UNSUPPORTED" : "EXPORT_FORMAT_UNSUPPORTED";
+    throw new error_1.AppError(code, `Unrecognized format '${raw || "(unspecified)"}'`, {
+        next_actions: [
+            scope === "import"
+                ? "Supported formats: .csv, .json. Convert the file first, or rename with the correct extension."
+                : "Supported formats: csv, json. Pass --format csv|json.",
+        ],
+    });
+}
+function countRows(body, format) {
+    if (format === "csv") {
+        // 粗估：非空行数 - 表头 1 行
+        let lines = 0;
+        const text = body.toString("utf8");
+        for (const line of text.split(/\r?\n/)) {
+            if (line.length > 0)
+                lines += 1;
+        }
+        return Math.max(0, lines - 1);
+    }
+    // JSON：期望是顶层数组
+    try {
+        const parsed = JSON.parse(body.toString("utf8"));
+        if (Array.isArray(parsed))
+            return parsed.length;
+        return 1;
+    }
+    catch {
+        return 0;
+    }
+}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbDataExport = exports.handleDbDataImport = exports.handleDbSchemaGet = exports.handleDbSchemaList = exports.handleDbSql = void 0;
+var sql_1 = require("./sql");
+Object.defineProperty(exports, "handleDbSql", { enumerable: true, get: function () { return sql_1.handleDbSql; } });
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "handleDbSchemaList", { enumerable: true, get: function () { return schema_1.handleDbSchemaList; } });
+Object.defineProperty(exports, "handleDbSchemaGet", { enumerable: true, get: function () { return schema_1.handleDbSchemaGet; } });
+var data_1 = require("./data");
+Object.defineProperty(exports, "handleDbDataImport", { enumerable: true, get: function () { return data_1.handleDbDataImport; } });
+Object.defineProperty(exports, "handleDbDataExport", { enumerable: true, get: function () { return data_1.handleDbDataExport; } });

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

@@ -0,0 +1,161 @@
+"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.handleDbSchemaList = handleDbSchemaList;
+exports.handleDbSchemaGet = handleDbSchemaGet;
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const shared_1 = require("../../../cli/commands/shared");
+const shared_2 = require("../../../cli/handlers/shared");
+const index_1 = require("../../../api/db/index");
+// ── schema list ──
+async function handleDbSchemaList(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const resp = await api.db.getSchema({ appId, format: "schema", includeStats: true });
+    const tables = (0, index_1.flattenSchemaList)(resp.schema);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: tables });
+        return;
+    }
+    if (tables.length === 0) {
+        (0, output_1.emit)("No tables found.");
+        return;
+    }
+    const tty = (0, shared_2.isStdoutTty)();
+    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）
+    const headers = [
+        "name",
+        "description",
+        "estimated_row_count",
+        tty ? "size" : "size_bytes",
+        "columns",
+        "updated_at",
+    ];
+    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, shared_2.formatSize)(t.size_bytes) : String(t.size_bytes)),
+        String(t.columns),
+        (0, shared_2.formatTime)(t.updated_at, tty),
+    ]);
+    (0, output_1.emit)(tty ? (0, shared_2.renderAlignedTable)(headers, rows) : (0, shared_2.renderTsv)(headers, rows));
+}
+async function handleDbSchemaGet(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const tty = (0, shared_2.isStdoutTty)();
+    const forceDdl = Boolean(opts.ddl);
+    const wantsStructured = (0, output_1.isJsonMode)() || (tty && !forceDdl);
+    if (!wantsStructured) {
+        // non-TTY 或 --ddl：直接取完整 DDL 输出
+        const ddlResp = await api.db.getSchema({
+            appId,
+            format: "ddl",
+            tableNames: table,
+        });
+        const sql = ddlResp.ddl?.[table];
+        if (!sql) {
+            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.`,
+                ],
+            });
+        }
+        (0, output_1.emit)(sql.trimEnd());
+        return;
+    }
+    // TTY / JSON：取结构化
+    const resp = await api.db.getSchema({
+        appId,
+        format: "schema",
+        tableNames: table,
+        includeStats: true,
+    });
+    const detail = (0, index_1.pickTableDetail)(resp.schema, table);
+    if (!detail) {
+        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.`,
+            ],
+        });
+    }
+    if ((0, output_1.isJsonMode)()) {
+        (0, shared_2.emitOk)(detail);
+        return;
+    }
+    (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("_"));
+    // PRD 的 header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size / Created / Updated
+    const header = [
+        ["Name", d.name],
+        ["Description", d.description ?? "—"],
+        [
+            "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, shared_2.formatSize)(d.size_bytes)],
+        ["Created", (0, shared_2.formatTime)(d.created_at, tty)],
+        ["Updated", (0, shared_2.formatTime)(d.updated_at, tty)],
+    ];
+    const colHeaders = ["column", "type", "nullable", "default", "comment"];
+    const colRows = userFields.map((c) => [
+        c.name,
+        c.type,
+        c.nullable ? "yes" : "no",
+        c.default ?? "—",
+        c.comment ?? "—",
+    ]);
+    const parts = [];
+    parts.push((0, shared_2.renderKeyValue)(header, tty));
+    parts.push("");
+    parts.push(tty ? (0, shared_2.renderAlignedTable)(colHeaders, colRows) : (0, shared_2.renderTsv)(colHeaders, colRows));
+    if (d.indexes.length > 0) {
+        parts.push("");
+        parts.push(tty ? "  Indexes:" : "Indexes:");
+        // PRD 格式: "TYPE (col1, col2)"，不展示索引名
+        for (const idx of d.indexes) {
+            const line = `${idx.type} (${idx.columns.join(", ")})`;
+            parts.push(tty ? `    ${line}` : line);
+        }
+    }
+    return parts.join("\n");
+}