@lark-apaas/miaoda-cli 0.1.3 → 0.1.4-alpha.9153b4c

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

@@ -3,25 +3,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAppCommands = registerAppCommands;
 const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../cli/handlers/app/index");
-function registerAppCommands(program) {
-    const appCmd = program.command("app").description("应用元数据管理：查看 / 修改");
+const error_1 = require("../../../utils/error");
+function registerAppCommands(program, opts = {}) {
+    const description = opts.includeInit
+        ? '应用元数据管理：查看 / 修改 / 初始化'
+        : '应用元数据管理：查看 / 修改';
+    const appCmd = program.command('app').description(description);
     appCmd.action(() => {
         appCmd.outputHelp();
     });
-    appCmd.addHelpText("after", `
+    appCmd.addHelpText('after', `
 作用范围
   仅供 Agent 在妙搭沙箱内调用。
   应用上下文：沙箱内的默认应用。
 `);
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
+    if (opts.includeInit) {
+        registerAppInit(appCmd);
+    }
 }
 function registerAppGet(parent) {
     const cmd = parent
-        .command("get")
-        .description("查看应用元数据（status / type / mode / branch / 时间戳 等）")
+        .command('get')
+        .description('查看应用元数据（status / type / mode / branch / 时间戳 等）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .addHelpText("after", `
+        .addHelpText('after', `
 JSON 输出
   {"data": {"appID": "...", "name": "...", ...}}
 
@@ -30,7 +37,7 @@ JSON 输出
   $ miaoda app get --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleAppGet)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
         });
@@ -38,12 +45,12 @@ JSON 输出
 }
 function registerAppUpdate(parent) {
     const cmd = parent
-        .command("update")
-        .description("修改应用名称 / 描述（至少传 --name 或 --description）")
+        .command('update')
+        .description('修改应用名称 / 描述（至少传 --name 或 --description）')
         .addOption((0, shared_1.appIdOption)().hideHelp())
-        .option("--name <name>", "新应用名称")
-        .option("--description <desc>", "新应用描述")
-        .addHelpText("after", `
+        .option('--name <name>', '新应用名称')
+        .option('--description <desc>', '新应用描述')
+        .addHelpText('after', `
 JSON 输出
   与 'app get' 一致：{"data": {...新 meta...}}
 
@@ -52,7 +59,7 @@ JSON 输出
   $ miaoda app update --description "在线商城应用"
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        (0, shared_1.rejectCliOverride)(cmd, "appId");
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
         await (0, index_1.handleAppUpdate)({
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             name: rawOpts.name,
@@ -60,3 +67,77 @@ JSON 输出
         });
     }));
 }
+function registerAppInit(parent) {
+    const cmd = parent
+        .command('init')
+        .description('初始化应用代码：抓 template 渲染、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
+        .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"} / {"steeringVersion": "<steering 版本>"}，均默认 latest')
+        .option('--skip-install', '跳过依赖安装', false)
+        .addHelpText('after', `
+幂等
+  .spark/meta.json 已存在时直接退出（initialized=false, reason=already_initialized），
+  不再触发 template 渲染、不重新拉 skills、不安装依赖。
+  meta.json 在 init 流程最后才写，写了 = 已完整成功一次；
+  上一次失败留下半渲染状态时（package.json 在但 meta.json 没在）允许重跑。
+
+依赖安装
+  默认：npm install --no-audit --no-fund
+  --skip-install: 跳过
+  MIAODA_DEP_CACHE_DIR 环境变量：
+    若设了且 CWD 含 package.json，先算 md5(package.json)，
+    命中 \${MIAODA_DEP_CACHE_DIR}/\${hash}.zip 则 unzip 复用缓存；未命中或解压后 node_modules
+    为空都会 fallback npm install。
+  JSON 模式下子进程 stdout 重定向到 stderr，避免污染最终 emit 的 JSON。
+
+JSON 输出
+  已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
+  新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
+                     "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
+
+示例
+  $ miaoda app init --template vite-react
+  $ miaoda app init --template vite-react --conf '{"version": "0.1.0-alpha.1"}'
+  $ miaoda app init --template vite-react --conf '{"steeringVersion": "0.1.0"}'
+  $ miaoda app init --template vite-react --skip-install
+  $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
+        const conf = parseInitConf(rawOpts.conf);
+        await (0, index_1.handleAppInit)({
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
+            template: rawOpts.template,
+            conf,
+            skipInstall: rawOpts.skipInstall,
+        });
+    }));
+}
+function parseInitConf(raw) {
+    if (raw === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('ARGS_INVALID', `--conf 必须是合法 JSON：${msg}`);
+    }
+    if (!isPlainObject(parsed)) {
+        throw new error_1.AppError('ARGS_INVALID', '--conf 必须是 JSON 对象');
+    }
+    const version = parsed.version;
+    if (version !== undefined && typeof version !== 'string') {
+        throw new error_1.AppError('ARGS_INVALID', '--conf.version 必须是字符串');
+    }
+    const steeringVersion = parsed.steeringVersion;
+    if (steeringVersion !== undefined && typeof steeringVersion !== 'string') {
+        throw new error_1.AppError('ARGS_INVALID', '--conf.steeringVersion 必须是字符串');
+    }
+    return { version, steeringVersion };
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}