@lark-apaas/miaoda-cli 0.1.17-alpha.ddef3e9 → 0.1.17

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

@@ -166,7 +166,6 @@ function registerAppInit(parent) {
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
-        .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
         .addOption((0, shared_1.appIdOption)())
         .addHelpText('after', `
 幂等
@@ -195,31 +194,17 @@ function registerAppInit(parent) {
     为空都会 fallback npm install。
   JSON 模式下子进程 stdout 重定向到 stderr，避免污染最终 emit 的 JSON。
 
-异步安装（--async-install）
-  跳过同步 npm install，派发一个 detached 后台进程装依赖后立即返回。
-  .spark/meta.json 在返回前写出（= 脚手架就绪），install 真实结果由 event marker 表达。
-  仅沙箱（SANDBOX_ID 非空）写 marker（presence 定成败，content 给排障）：
-    成功 → /tmp/event/WORKSPACE_READY
-    失败 → /tmp/event/WORKSPACE_FAILED
-  安装日志：/tmp/async_install_dep.std.log
-  失败恢复：靠后续 'miaoda app sync'（dev.sh 入口 / 沙箱 pod 启动会跑）兜底，init 不重试。
-  与 --skip-install 互斥。
-
 JSON 输出
   已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
   新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
                      "appId": "...", "platformStackFound": true, "platformSyncedFiles": [...],
                      "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
-  async 模式：{"data": {"initialized": true, "asyncInstall": true, "installed": false,
-                      "installSource": "async", "installPid": 123, "installLogPath": "...",
-                      "eventReadyPath": "...", "eventFailedPath": "..."}}
 
 示例
   $ miaoda app init --template vite-react
   $ miaoda app init --template nestjs-react-fullstack --app-id app_xxx
   $ miaoda app init --template vite-react --conf '{"version": "0.1.0"}'
   $ miaoda app init --template vite-react --skip-install
-  $ miaoda app init --template vite-react --async-install
   $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
@@ -229,7 +214,6 @@ JSON 输出
             conf,
             skipInstall: rawOpts.skipInstall,
             appId: rawOpts.appId,
-            asyncInstall: rawOpts.asyncInstall,
         });
     }));
 }

package/dist/cli/handlers/app/init.js

@@ -60,9 +60,6 @@ async function handleAppInit(opts) {
             next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
         });
     }
-    if (opts.asyncInstall && opts.skipInstall) {
-        throw new error_1.AppError('ARGS_INVALID', '--async-install 与 --skip-install 互斥');
-    }
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
@@ -89,17 +86,13 @@ async function handleAppInit(opts) {
         (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
         steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
     }
-    // 依赖安装：async 模式留到 meta 落盘后派发后台进程（不等装完），同步模式当场装。
-    // 同步：装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
+    // 装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
     // —— "升管控包到 latest" 是 sync 的职责,在 dev.sh 入口跑 `miaoda app sync` 时触发。
-    let installResult;
-    if (!opts.asyncInstall) {
-        installResult = (0, index_1.installDependencies)({
-            targetDir,
-            skip: opts.skipInstall,
-            quietStdout: (0, output_1.isJsonMode)(),
-        });
-    }
+    const installResult = (0, index_1.installDependencies)({
+        targetDir,
+        skip: opts.skipInstall,
+        quietStdout: (0, output_1.isJsonMode)(),
+    });
     // template 自带 .githooks/pre-commit；如果用户项目已 git init,顺便设上 core.hooksPath。
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
     (0, index_1.writeSparkMeta)(targetDir, {
@@ -108,18 +101,8 @@ async function handleAppInit(opts) {
         archType: tplResult.archType,
         app_id: opts.appId,
     });
-    // async 模式：meta 已落盘（= 脚手架就绪），再派发后台安装并立即返回（不等装完）。
-    let asyncDispatch;
-    if (opts.asyncInstall) {
-        asyncDispatch = (0, index_1.dispatchAsyncInstall)({ targetDir });
-    }
     if (!(0, output_1.isJsonMode)()) {
-        if (opts.asyncInstall && asyncDispatch) {
-            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install dispatched in background pid ${String(asyncDispatch.pid)}) in ${targetDir}\n`);
-        }
-        else if (installResult) {
-            process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
-        }
+        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
     }
     (0, output_1.emit)({
         data: {
@@ -134,23 +117,11 @@ async function handleAppInit(opts) {
             techSynced: steeringResult.techSynced,
             steeringError,
             gitHooks: hookActivation.action,
-            ...(opts.asyncInstall && asyncDispatch
-                ? {
-                    asyncInstall: true,
-                    installed: false,
-                    installSource: 'async',
-                    installPid: asyncDispatch.pid,
-                    installLogPath: asyncDispatch.logPath,
-                    eventReadyPath: asyncDispatch.eventReadyPath,
-                    eventFailedPath: asyncDispatch.eventFailedPath,
-                }
-                : {
-                    installed: installResult?.installed,
-                    installSource: installResult?.source,
-                    installHash: installResult?.hash,
-                    cacheZip: installResult?.cacheZip,
-                    installError: installResult?.error,
-                }),
+            installed: installResult.installed,
+            installSource: installResult.source,
+            installHash: installResult.hash,
+            cacheZip: installResult.cacheZip,
+            installError: installResult.error,
         },
     });
 }

package/dist/cli/handlers/app/migrate.js

@@ -139,13 +139,9 @@ async function handleAppMigrate(opts) {
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,
     // 新进程用新 deps + 新 scripts,正常进入 fullstack 模式。
     //   - 只在 SANDBOX_ID 非空时做(本地环境用户进程混杂,主动 pkill 风险大)
-    //   - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
-    //     留着旧进程让用户先处理 installError
     //   - 软失败:pkill 无匹配进程退出 1,catch 吞掉
     let devRestarted = false;
-    if (installError === undefined &&
-        process.env.SANDBOX_ID !== undefined &&
-        process.env.SANDBOX_ID !== '') {
+    if (process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '') {
         (0, logger_1.log)('migrate', '沙箱环境,重启 dev process(平台 supervisor 会自动拉起)...');
         try {
             (0, node_child_process_1.execFileSync)('pkill', ['-f', 'node.*scripts/dev\\.js'], { stdio: 'ignore' });

package/dist/services/app/init/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ASYNC_INSTALL_LOG = exports.isSandboxEnv = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
@@ -11,8 +11,3 @@ Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: functi
 var install_1 = require("./install");
 Object.defineProperty(exports, "installDependencies", { enumerable: true, get: function () { return install_1.installDependencies; } });
 Object.defineProperty(exports, "resolveNpmInstallRegistry", { enumerable: true, get: function () { return install_1.resolveNpmInstallRegistry; } });
-var async_install_1 = require("./async-install");
-Object.defineProperty(exports, "dispatchAsyncInstall", { enumerable: true, get: function () { return async_install_1.dispatchAsyncInstall; } });
-Object.defineProperty(exports, "runAsyncInstallWorker", { enumerable: true, get: function () { return async_install_1.runAsyncInstallWorker; } });
-Object.defineProperty(exports, "isSandboxEnv", { enumerable: true, get: function () { return async_install_1.isSandboxEnv; } });
-Object.defineProperty(exports, "ASYNC_INSTALL_LOG", { enumerable: true, get: function () { return async_install_1.ASYNC_INSTALL_LOG; } });

package/package.json

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

package/upgrade/templates/design-stack/templates/scripts/dev-local.js

@@ -5,10 +5,9 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件
-//   3. skills sync —— 同步当前 stack 的 agent skills
-//   4. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   5. 起单进程 dev server（design-stack 单进程，无 server/client 拆分）
+//   2. skills sync —— 同步当前 stack 的 agent skills
+//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
+//   4. 起单进程 dev server（design-stack 单进程，无 server/client 拆分）
 //
 // 设计同 nestjs-react-fullstack/dev-local.js,SDK 包不需要自己 require('dotenv'),
 // env 加载收敛在启动脚本单点。SUDA_WEBUSER 适配同 nrf 那份。
@@ -27,7 +26,7 @@ function warn(msg) {
 if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '4';
 process.env.MIAODA_LOCAL_DEV = '1';
 
-console.log('[dev-local] (1/5) env pull...');
+console.log('[dev-local] (1/4) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -48,23 +47,15 @@ if (hasLarkCli) {
   warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
 }
 
-// action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件。
-console.log('[dev-local] (2/5) action-plugin init...');
-try {
-  execSync('npx -y @lark-apaas/fullstack-cli@latest action-plugin init', { stdio: 'inherit' });
-} catch {
-  warn('action-plugin init 失败，继续启动');
-}
-
 // skills sync —— --local 切 flat layout;不传 --version,handler 默认 coding-steering@latest。
-console.log('[dev-local] (3/5) miaoda skills sync...');
+console.log('[dev-local] (2/4) miaoda skills sync...');
 try {
   execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
 } catch {
   console.log('  (skills sync 失败，继续启动)');
 }
 
-console.log('[dev-local] (4/5) loading .env / .env.local...');
+console.log('[dev-local] (3/4) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -84,7 +75,7 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-console.log('[dev-local] (5/5) npm run dev');
+console.log('[dev-local] (4/4) npm run dev');
 const child = spawn('npm', ['run', 'dev'], { stdio: 'inherit', env: process.env });
 child.on('exit', (code) => process.exit(code ?? 0));
 child.on('error', (err) => {

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/dev-local.js

@@ -5,10 +5,9 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件
-//   3. skills sync —— 同步当前 stack 的 agent skills
-//   4. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   5. 并发起 dev:server + dev:client（子进程继承 process.env）
+//   2. skills sync —— 同步当前 stack 的 agent skills
+//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
+//   4. 并发起 dev:server + dev:client（子进程继承 process.env）
 //
 // 关键设计：本脚本在 spawn 子进程之前先把 .env / .env.local 加载到 process.env，
 // 然后 spawn 的 server / client 进程通过 env 继承直接拿到——SDK（fullstack-nestjs-core
@@ -35,7 +34,7 @@ if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '3';
 process.env.MIAODA_LOCAL_DEV = '1';
 
 // 1. env pull
-console.log('[dev-local] (1/5) env pull...');
+console.log('[dev-local] (1/4) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -56,28 +55,20 @@ if (hasLarkCli) {
   warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
 }
 
-// 2. action-plugin init —— 装 user app 在 package.json.actionPlugins 里声明的插件。
-console.log('[dev-local] (2/5) action-plugin init...');
-try {
-  execSync('npx -y @lark-apaas/fullstack-cli@latest action-plugin init', { stdio: 'inherit' });
-} catch {
-  warn('action-plugin init 失败，继续启动');
-}
-
-// 3. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
+// 2. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
 // 跟沙箱 nested layout 区分。不传 --version,handler 默认拉 coding-steering@latest,
 // 保证每次本地 npm run dev 都把 skills 升到最新。
-console.log('[dev-local] (3/5) miaoda skills sync...');
+console.log('[dev-local] (2/4) miaoda skills sync...');
 try {
   execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
 } catch {
   console.log('  (skills sync 失败，继续启动)');
 }
 
-// 4. 加载 .env / .env.local 到 process.env
+// 3. 加载 .env / .env.local 到 process.env
 // dotenv 默认 override:false，先到先得 → 先 .env.local 让它优先于 .env；
 // shell env 已在 process.env，两次 config 都不会覆盖。
-console.log('[dev-local] (4/5) loading .env / .env.local...');
+console.log('[dev-local] (3/4) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -98,8 +89,8 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-// 5. 并发起前后端 dev server
-console.log('[dev-local] (5/5) 并发起 dev:server + dev:client');
+// 4. 并发起前后端 dev server
+console.log('[dev-local] (4/4) 并发起 dev:server + dev:client');
 const child = spawn(
   'npx',
   [

package/dist/services/app/init/async-install.js

@@ -1,116 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ASYNC_INSTALL_LOG = void 0;
-exports.isSandboxEnv = isSandboxEnv;
-exports.runAsyncInstallWorker = runAsyncInstallWorker;
-exports.dispatchAsyncInstall = dispatchAsyncInstall;
-const node_child_process_1 = require("node:child_process");
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const install_1 = require("./install");
-/** event marker 目录，写死；写前 mkdir -p。沙箱里 code server 轮询此目录。 */
-const EVENT_DIR = '/tmp/event';
-/** 安装成功 marker 名 */
-const MARKER_READY = 'WORKSPACE_READY';
-/** 安装失败 marker 名 */
-const MARKER_FAILED = 'WORKSPACE_FAILED';
-/** 后台 worker stdout/stderr 落盘路径 */
-exports.ASYNC_INSTALL_LOG = '/tmp/async_install_dep.std.log';
-/** 沙箱判定：SANDBOX_ID 非空。与 init handler 的 outputLayout 分流口径一致。 */
-function isSandboxEnv() {
-    return process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '';
-}
-function nowIso() {
-    return new Date().toISOString();
-}
-function clearStaleMarkers(eventDir) {
-    for (const name of [MARKER_READY, MARKER_FAILED]) {
-        const p = node_path_1.default.join(eventDir, name);
-        if (node_fs_1.default.existsSync(p))
-            node_fs_1.default.rmSync(p, { force: true });
-    }
-}
-function writeMarker(eventDir, name, content) {
-    node_fs_1.default.mkdirSync(eventDir, { recursive: true });
-    node_fs_1.default.writeFileSync(node_path_1.default.join(eventDir, name), JSON.stringify(content) + '\n', 'utf-8');
-}
-/**
- * 后台 install worker 体：跑 installDependencies，按结果写 marker（仅沙箱）。
- * 由 dispatchAsyncInstall 通过 `node -e` 在 detached 子进程里调用（见下）。
- * presence 定成败：成功写 WORKSPACE_READY，失败写 WORKSPACE_FAILED；content 给排障。
- */
-function runAsyncInstallWorker(opts) {
-    const eventDir = opts.eventDir ?? EVENT_DIR;
-    const sandbox = isSandboxEnv();
-    if (sandbox)
-        clearStaleMarkers(eventDir);
-    const start = Date.now();
-    let result;
-    try {
-        result = (0, install_1.installDependencies)({ targetDir: opts.targetDir, quietStdout: false });
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (sandbox) {
-            writeMarker(eventDir, MARKER_FAILED, {
-                ts: nowIso(),
-                error: msg,
-                logPath: exports.ASYNC_INSTALL_LOG,
-            });
-        }
-        return;
-    }
-    if (!sandbox)
-        return;
-    if (result.source === 'failed') {
-        writeMarker(eventDir, MARKER_FAILED, {
-            ts: nowIso(),
-            error: result.error ?? 'npm install failed',
-            logPath: exports.ASYNC_INSTALL_LOG,
-        });
-    }
-    else {
-        writeMarker(eventDir, MARKER_READY, {
-            ts: nowIso(),
-            durationMs: Date.now() - start,
-            source: result.source,
-        });
-    }
-}
-/**
- * 派发 detached 后台进程跑依赖安装并立即返回。
- * 用 `node -e` 直接 require 本模块（编译产物）调 runAsyncInstallWorker，
- * 不挂任何 CLI 子命令、对外不暴露；worker 内复用 installDependencies（cache / registry / fallback）。
- * 沙箱下派发前清旧 marker；stdout/stderr 重定向到 logPath。
- */
-function dispatchAsyncInstall(opts) {
-    const eventDir = opts.eventDir ?? EVENT_DIR;
-    const logPath = opts.logPath ?? exports.ASYNC_INSTALL_LOG;
-    const sandbox = isSandboxEnv();
-    if (sandbox)
-        clearStaleMarkers(eventDir);
-    // targetDir 走 argv 传，不拼进代码串（免转义）；只把本模块路径 JSON 内联进去。
-    const workerCode = `require(${JSON.stringify(__filename)}).runAsyncInstallWorker({ targetDir: process.argv[1] })`;
-    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logPath), { recursive: true });
-    const fd = node_fs_1.default.openSync(logPath, 'w');
-    try {
-        const child = (0, node_child_process_1.spawn)(process.execPath, ['-e', workerCode, opts.targetDir], {
-            detached: true,
-            stdio: ['ignore', fd, fd],
-        });
-        child.unref();
-        return {
-            pid: child.pid,
-            logPath,
-            eventReadyPath: sandbox ? node_path_1.default.join(eventDir, MARKER_READY) : undefined,
-            eventFailedPath: sandbox ? node_path_1.default.join(eventDir, MARKER_FAILED) : undefined,
-        };
-    }
-    finally {
-        // 父进程关掉自己那份 fd；子进程已通过 stdio dup 持有独立副本。
-        node_fs_1.default.closeSync(fd);
-    }
-}