@lark-apaas/miaoda-cli 0.1.28 → 0.1.29

package/dist/api/db/sql-keywords.js

@@ -70,6 +70,7 @@ exports.SQL_KEYWORDS = [
     // DDL
     'CREATE',
     'ALTER',
+    'ENABLE',
     'DROP',
     'TRUNCATE',
     'RENAME',

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

@@ -411,6 +411,19 @@ const ISO_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?
 const SYNTAX_RE = /syntax error at or near "([^"]+)"/i;
 const RELATION_RE = /relation "([^"]+)" does not exist/i;
 const COLUMN_RE = /column "([^"]+)"(?: of relation "([^"]+)")? does not exist/i;
+const KEYWORD_TYPO_IGNORE_WORDS = new Set([
+    // Legal PostgreSQL terms that are not useful keyword typo candidates.
+    'ROW',
+    'LEVEL',
+    'SECURITY',
+    // Common index access methods used after `USING`.
+    'BTREE',
+    'HASH',
+    'GIST',
+    'SPGIST',
+    'GIN',
+    'BRIN',
+]);
 /**
  * 在错误抛出前富化 next_actions（最多 1 条 hint），按 PG 报错形态分发：
  *
@@ -540,6 +553,8 @@ function findKeywordTypo(sql) {
         const upper = tok.toUpperCase();
         if (sql_keywords_1.SQL_KEYWORDS.includes(upper))
             continue; // 写对的关键字
+        if (KEYWORD_TYPO_IGNORE_WORDS.has(upper))
+            continue;
         const guess = (0, fuzzy_match_1.suggest)(upper, sql_keywords_1.SQL_KEYWORDS);
         if (guess && guess !== upper) {
             return { input: tok, suggest: guess };

package/dist/cli/program.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+const commander_1 = require("commander");
+const index_1 = require("../cli/commands/index");
+const shared_1 = require("../cli/commands/shared");
+const help_1 = require("../cli/help");
+const version_option_1 = require("../cli/version-option");
+const config_1 = require("../utils/config");
+const log_id_1 = require("../utils/log_id");
+const package_json_1 = __importDefault(require("../../package.json"));
+// 副作用：MiaodaHelp 对齐 CLI 规范（描述置顶 / Flags / Global Flags / 段顺序）。
+// 在 Command.prototype 上 patch createHelp，让所有命令实例（含动态注册的子命令）统一走
+// MiaodaHelp 渲染，避免在每个子命令上重复 configureHelp。
+commander_1.Command.prototype.createHelp = function () {
+    return Object.assign(new help_1.MiaodaHelp(), this.configureHelp());
+};
+/**
+ * 装配 root program（命令树 + 全局参数 + preAction hook）。
+ *
+ * 抽成工厂而非写在 main.ts 里，是为了让接线可测 —— main.ts 在 import 期就会 parseAsync，
+ * 测试无法 import 它，只能复刻装配，那测到的就不是生产代码。
+ * 见 test/cli/program-version-wiring.test.ts。
+ *
+ * @param argv 供 `--version` 归属判定使用的 argv（process.argv 形态）。显式传入而非直接读
+ *             process.argv，同样是为了可测。
+ */
+function createProgram(argv = process.argv) {
+    const program = new commander_1.Command();
+    const { version } = package_json_1.default;
+    program.name('miaoda');
+    // 命令树必须先建：shouldExposeRootVersion 要从树上反推「哪些命令自己声明了 --version」。
+    (0, index_1.registerCommands)(program);
+    program
+        .description('妙搭平台 CLI，提供数据服务、文件存储等命令行操作。')
+        .usage('<command> [flags]');
+    // 条件注册：仅当本次 argv 未命中「声明了 --version 的命令路径」时，root 才接管 --version。
+    // 注册位置保持在 option 链首位，否则 -v, --version 会从 Global Flags 第一行掉到末尾。
+    // 详见 src/cli/version-option.ts。
+    if ((0, version_option_1.shouldExposeRootVersion)(program, argv)) {
+        program.version(version, '-v, --version', '显示版本号');
+    }
+    program
+        .option('--json [fields]', 'JSON 输出，可选字段级选择')
+        .addOption(new commander_1.Option('--output <format>', '输出格式（pretty | json，大小写不敏感）')
+        .choices(['pretty', 'json'])
+        .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
+        .default('pretty'))
+        .option('--verbose', 'debug 日志到 stderr')
+        // 全局接受 -y/--yes：作为 root 全局 option 下发到所有子命令解析（同 --json/--verbose），
+        // 让任意命令带 --yes 都不报 unknown option。对有确认门的破坏性命令生效，其余命令忽略。
+        .option('-y, --yes', '跳过确认提示（对有确认门的命令生效，其余命令忽略）')
+        .helpOption('-h, --help', '显示帮助信息')
+        .hook('preAction', (_thisCmd, actionCmd) => {
+        (0, log_id_1.generateLogId)();
+        const opts = actionCmd.optsWithGlobals();
+        (0, config_1.initConfigFromOpts)(opts);
+    });
+    return program;
+}

package/dist/cli/version-option.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldExposeRootVersion = shouldExposeRootVersion;
+/**
+ * root 是否应该注册 `-v, --version`。
+ *
+ * 背景：Commander 13 默认关闭 positional options，root 的 parseOptions 会扫描整个 argv
+ * （这也正是 `--json` / `--verbose` 写在子命令之后仍生效的机制）。因此 root 一旦声明
+ * `--version`，任何位置的 `--version` 都会先被 root 的 version listener 命中、打印版本并
+ * exit 0，导致 `skills sync --version <ver>` 这类子命令 flag 永远拿不到值。
+ *
+ * 解法：仅当本次 argv 连续命中「某条自己声明了 --version 的命令路径」时才不注册，把
+ * `--version` 让给叶子；其余一切情况照常注册，行为与历史完全一致（例如
+ * `miaoda app get --version` 仍打印 CLI 版本）。
+ *
+ * 路径集从命令树反推，不硬编码 —— 以后任何叶子加 `--version` 都自动纳入。
+ *
+ * 设计与行为矩阵见
+ * docs/superpowers/specs/2026-07-29-root-version-option-collision-design.md。
+ */
+function shouldExposeRootVersion(root, argv) {
+    const tokens = argv.slice(2);
+    if (tokens.length === 0)
+        return true;
+    return !collectVersionOwningPaths(root).some((path) => containsPath(tokens, path));
+}
+/**
+ * 收集自己声明了 `--version` 的命令路径。
+ *
+ * 每条路径是一个「段」数组，每段是该层可接受的 token 名（正名 + 全部 alias）。
+ * 例如 `skills sync` → `[['skills'], ['sync']]`。
+ */
+function collectVersionOwningPaths(root) {
+    const paths = [];
+    const walk = (cmd, trail) => {
+        for (const sub of cmd.commands) {
+            const here = [...trail, [sub.name(), ...sub.aliases()]];
+            if (sub.options.some((o) => o.long === '--version'))
+                paths.push(here);
+            walk(sub, here);
+        }
+    };
+    walk(root, []);
+    return paths;
+}
+/** tokens 里是否存在一段连续子序列，逐位命中 path 各段的正名或 alias。 */
+function containsPath(tokens, path) {
+    outer: for (let i = 0; i + path.length <= tokens.length; i++) {
+        for (let j = 0; j < path.length; j++) {
+            if (!path[j].includes(tokens[i + j]))
+                continue outer;
+        }
+        return true;
+    }
+    return false;
+}

package/dist/main.js

@@ -1,45 +1,8 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const index_1 = require("./cli/commands/index");
-const shared_1 = require("./cli/commands/shared");
-const help_1 = require("./cli/help");
-const config_1 = require("./utils/config");
-const log_id_1 = require("./utils/log_id");
+const program_1 = require("./cli/program");
 const output_1 = require("./utils/output");
-const package_json_1 = __importDefault(require("../package.json"));
-// MiaodaHelp 对齐 CLI 规范（描述置顶 / Flags / Global Flags / 段顺序）：
-// 在 Command.prototype 上 patch createHelp，让所有命令实例（含动态注册的
-// 子命令）统一走 MiaodaHelp 渲染，避免在每个子命令上重复 configureHelp。
-commander_1.Command.prototype.createHelp = function () {
-    return Object.assign(new help_1.MiaodaHelp(), this.configureHelp());
-};
-const program = new commander_1.Command();
-const { version } = package_json_1.default;
-program
-    .name('miaoda')
-    .description('妙搭平台 CLI，提供数据服务、文件存储等命令行操作。')
-    .usage('<command> [flags]')
-    .version(version, '-v, --version', '显示版本号')
-    .option('--json [fields]', 'JSON 输出，可选字段级选择')
-    .addOption(new commander_1.Option('--output <format>', '输出格式（pretty | json，大小写不敏感）')
-    .choices(['pretty', 'json'])
-    .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
-    .default('pretty'))
-    .option('--verbose', 'debug 日志到 stderr')
-    // 全局接受 -y/--yes：作为 root 全局 option 下发到所有子命令解析（同 --json/--verbose），
-    // 让任意命令带 --yes 都不报 unknown option。对有确认门的破坏性命令生效，其余命令忽略。
-    .option('-y, --yes', '跳过确认提示（对有确认门的命令生效，其余命令忽略）')
-    .helpOption('-h, --help', '显示帮助信息')
-    .hook('preAction', (_thisCmd, actionCmd) => {
-    (0, log_id_1.generateLogId)();
-    const opts = actionCmd.optsWithGlobals();
-    (0, config_1.initConfigFromOpts)(opts);
-});
-(0, index_1.registerCommands)(program);
+const program = (0, program_1.createProgram)();
 program.parseAsync(process.argv).catch((err) => {
     (0, output_1.emitError)(err);
     process.exitCode = 1;

package/dist/services/deploy/modern/patch/source-scan.js

@@ -19,14 +19,32 @@ exports.EXCLUDES = new Set([
     'yarn.lock',
     '.gitignore',
     '.npmrc',
+    // agent / 编辑器配置目录与指令文件：只服务本地开发，不属于应用资产。
+    // 注意 .claude/skills 在 flat layout 下是指向 ../.agents/skills 的软链，而 listSourceFiles
+    // 会 follow 软链，所以必须按 basename 把 .claude 整个排掉，否则 skills 会从软链侧被带进产物。
     '.agent',
     '.agents',
+    '.claude',
+    '.codex',
+    '.cursor',
+    '.gemini',
+    '.trae',
+    '.windsurf',
+    '.vscode',
+    '.idea',
+    'AGENTS.md',
+    'CLAUDE.md',
+    'GEMINI.md',
     'skills',
     '.env',
     '.env.local',
     'README.md',
     '.DS_Store',
     '.spark',
+    // 本地开发的临时/运行时目录：tmp 里的 .html 是草稿或中间产物，logs 是本地日志，
+    // 两者既不进产物也不该出现在 routes.json。
+    'tmp',
+    'logs',
 ]);
 /**
  * 递归列出 root 下所有文件的相对 posix 路径，跳过 EXCLUDES（任意层级 basename），

package/package.json

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