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

package/dist/api/deploy/index.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.LocalReleaseStatus = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
 Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
 Object.defineProperty(exports, "getErrorLog", { enumerable: true, get: function () { return api_1.getErrorLog; } });
 Object.defineProperty(exports, "queryPipelineInstance", { enumerable: true, get: function () { return api_1.queryPipelineInstance; } });
+var modern_1 = require("./modern");
+Object.defineProperty(exports, "preRelease", { enumerable: true, get: function () { return modern_1.preRelease; } });
+Object.defineProperty(exports, "createLocalRelease", { enumerable: true, get: function () { return modern_1.createLocalRelease; } });
+Object.defineProperty(exports, "updateLocalRelease", { enumerable: true, get: function () { return modern_1.updateLocalRelease; } });
+Object.defineProperty(exports, "createModernRelease", { enumerable: true, get: function () { return modern_1.createRelease; } });
+Object.defineProperty(exports, "getModernReleaseStatus", { enumerable: true, get: function () { return modern_1.getReleaseStatus; } });
+Object.defineProperty(exports, "getModernLastPublishedVersion", { enumerable: true, get: function () { return modern_1.getLastPublishedVersion; } });
+var modern_types_1 = require("./modern-types");
+Object.defineProperty(exports, "LocalReleaseStatus", { enumerable: true, get: function () { return modern_types_1.LocalReleaseStatus; } });
 var schemas_1 = require("./schemas");
 Object.defineProperty(exports, "deployHistorySchema", { enumerable: true, get: function () { return schemas_1.deployHistorySchema; } });
 Object.defineProperty(exports, "deployGetSchema", { enumerable: true, get: function () { return schemas_1.deployGetSchema; } });

package/dist/api/deploy/modern-types.js

@@ -0,0 +1,23 @@
+"use strict";
+// modern deploy 接口的请求 / 响应类型（与服务端发布编排接口对齐）。
+// 第一期落地的链路：本地构建 + 本地部署。
+//
+// 接口分两类：
+//   - preRelease：所有"本地构建"链路共用，签发动态配置（含 pre-signed TOS upload URL）
+//   - localPublish：本地构建 + 本地部署专用（createReleaseLocalPublish + updateReleaseLocalPublish）
+//
+// 远端部署链路（B/C）所需的 release 接口先预留类型骨架，待 B/C 落地时启用。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalReleaseStatus = void 0;
+/**
+ * localPublish 状态枚举（数值，与服务端 IDL 对齐）。
+ * CLI updateLocalRelease 只翻 Finished / Failed 两个终态；其它由后端流转。
+ */
+exports.LocalReleaseStatus = {
+    Unspecified: 0,
+    Publishing: 1,
+    Finished: 2,
+    Failed: 3,
+    Canceled: 4,
+    Rollback: 5,
+};

package/dist/api/deploy/modern.js

@@ -0,0 +1,70 @@
+"use strict";
+// modern deploy 接口客户端。统一走管理端 innerapi（postInnerApi 信封解析）。
+//
+// 第一期落地（本地构建 + 本地部署）：
+//   - preRelease：拿 pre_release_id + version + 动态配置 data
+//   - createLocalRelease / updateLocalRelease：完整本地部署生命周期
+//
+// 远端部署（本地构建+远端部署、远端构建+远端部署）需要 createRelease + getReleaseStatus，
+// 后续 commit 接入；本文件已预留 endpoint 骨架但暂不导出。
+//
+// 约定：所有接口的 appID 走 URL :appID 路径参数，body 不再冗余携带 appID。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preRelease = preRelease;
+exports.createLocalRelease = createLocalRelease;
+exports.updateLocalRelease = updateLocalRelease;
+exports.createRelease = createRelease;
+exports.getReleaseStatus = getReleaseStatus;
+exports.getLastPublishedVersion = getLastPublishedVersion;
+const http_1 = require("../../utils/http");
+const devops_error_1 = require("../../utils/devops-error");
+const DEFAULT_ERR_CODE = 'INTERNAL_DEVOPS_ERROR';
+function envelopeOpts(errPrefix) {
+    // modern deploy 接口与 default deploy / app 走同一个 lark.apaas.devops PSM，
+    // 业务错误码命名空间共享，直接复用 mapDevopsError 把 BAM 码翻为 AppError。
+    return {
+        errPrefix,
+        defaultErrCode: DEFAULT_ERR_CODE,
+        mapErr: devops_error_1.mapDevopsError,
+    };
+}
+// ── preRelease ──
+/** POST /v1/devops/app/:appID/pre_release */
+async function preRelease(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/pre_release`;
+    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to pre-release'));
+}
+// ── localPublish ──
+/** POST /v1/devops/app/:appID/local_publish/release */
+async function createLocalRelease(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/local_publish/release`;
+    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to create local release'));
+}
+/** POST /v1/devops/app/:appID/local_publish/update_release */
+async function updateLocalRelease(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/local_publish/update_release`;
+    await (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to update local release'));
+}
+// ── release（远端部署，B / C 链路；本期不导出，类型骨架已就绪） ──
+/** POST /v1/devops/app/:appID/remote_publish/release */
+async function createRelease(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/remote_publish/release`;
+    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to create release'));
+}
+/** POST /v1/devops/app/:appID/release/status */
+async function getReleaseStatus(req) {
+    const { appID, ...body } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/release/status`;
+    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to query release status'));
+}
+// ── getLastPublishedVersion（URL path 待文档补充） ──
+/** POST /v1/devops/app/:appID/last_published_version（path 待后端确认） */
+async function getLastPublishedVersion(req) {
+    const { appID } = req;
+    const url = `/v1/devops/app/${encodeURIComponent(appID)}/last_published_version`;
+    return (0, http_1.postInnerApi)(url, {}, envelopeOpts('Failed to get last published version'));
+}

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

@@ -3,8 +3,12 @@ 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();
     });
@@ -15,6 +19,9 @@ function registerAppCommands(program) {
 `);
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
+    if (opts.includeInit) {
+        registerAppInit(appCmd);
+    }
 }
 function registerAppGet(parent) {
     const cmd = parent
@@ -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);
+}

package/dist/cli/commands/deploy/modern.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDeployCommandsModern = registerDeployCommandsModern;
+const shared_1 = require("../../../cli/commands/shared");
+const modern_1 = require("../../../cli/handlers/deploy/modern");
+/**
+ * modern scene (MIAODA_APP_TYPE=7) 专用 deploy 注册。
+ * 仅披露顶层 `miaoda deploy`，CLI 表面对齐 openclaw-cli：`--dir / --skip-build`。
+ *
+ * 与 default 的 registerDeployCommands 完全平行：两套实现 100% 隔离，
+ * 不共享分支、不互相依赖。后端调用与编排在 src/services/deploy/modern/。
+ */
+function registerDeployCommandsModern(program) {
+    const deployCmd = program
+        .command('deploy')
+        .description('触发 modern 应用发布：本地构建 + 本地部署（preRelease + localPublish）')
+        .option('--dir <path>', '项目目录', '.')
+        .option('--skip-build', '跳过 build 步骤（已构建好时使用）', false)
+        .addHelpText('after', `
+不要用异步模式或后台模式调用 deploy，否则调用可能提前结束，Agent 会误判发布已完成。
+
+前置要求
+  - 项目已 init（.spark/meta.json 含 appId / template）
+  - node_modules 已安装
+  - package.json 含 build script
+  - 沙箱内预装 tosutil（用于把构建产物上传到 TOS）
+
+流程概览（stderr 进度提示）
+  1. prepareContext  2. preRelease   3. build
+  4. createLocalRelease              5. uploadArtifacts
+  6. finalizeLocalRelease(Success|Failed)
+
+JSON 输出（stdout）
+  {"data": {"appId": "...", "version": <n>, "url": "...", "releaseID": "...", "preReleaseID": "..."}}
+
+示例
+  $ miaoda deploy
+  $ miaoda deploy --dir ./my-app
+  $ miaoda deploy --skip-build
+`);
+    deployCmd.action((0, shared_1.withHelp)(deployCmd, async (rawOpts) => {
+        await (0, modern_1.handleDeployModern)({
+            dir: rawOpts.dir ?? '.',
+            skipBuild: rawOpts.skipBuild,
+        });
+    }));
+}

package/dist/cli/commands/index.js

@@ -1,15 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveScene = resolveScene;
 exports.registerCommands = registerCommands;
 const index_1 = require("../../cli/commands/file/index");
 const index_2 = require("../../cli/commands/db/index");
 const index_3 = require("../../cli/commands/observability/index");
 const index_4 = require("../../cli/commands/app/index");
 const index_5 = require("../../cli/commands/deploy/index");
+const modern_1 = require("../../cli/commands/deploy/modern");
+function resolveScene(appType, _archType) {
+    if (appType === '7')
+        return 'modern';
+    return 'default';
+}
+const SCENE_REGISTRARS = {
+    default: (p) => {
+        (0, index_4.registerAppCommands)(p);
+        (0, index_5.registerDeployCommands)(p);
+        (0, index_2.registerDbCommands)(p);
+        (0, index_1.registerFileCommands)(p);
+        (0, index_3.registerObservabilityCommands)(p);
+    },
+    modern: (p) => {
+        (0, index_4.registerAppCommands)(p, { includeInit: true });
+        (0, modern_1.registerDeployCommandsModern)(p);
+    },
+};
+function readEnv(name) {
+    const v = process.env[name]?.trim();
+    return v !== undefined && v !== '' ? v : undefined;
+}
 function registerCommands(program) {
-    (0, index_1.registerFileCommands)(program);
-    (0, index_2.registerDbCommands)(program);
-    (0, index_3.registerObservabilityCommands)(program);
-    (0, index_4.registerAppCommands)(program);
-    (0, index_5.registerDeployCommands)(program);
+    const appType = readEnv('MIAODA_APP_TYPE');
+    const archType = readEnv('MIAODA_APP_ARCH_TYPE');
+    const scene = resolveScene(appType, archType);
+    SCENE_REGISTRARS[scene](program);
+    if (process.env.MIAODA_VERBOSE === '1' || process.argv.includes('--verbose')) {
+        process.stderr.write(`[miaoda] scene=${scene} app_type=${appType ?? '-'} arch_type=${archType ?? '-'}\n`);
+    }
 }

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

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
 Object.defineProperty(exports, "handleAppUpdate", { enumerable: true, get: function () { return update_1.handleAppUpdate; } });
+var init_1 = require("./init");
+Object.defineProperty(exports, "handleAppInit", { enumerable: true, get: function () { return init_1.handleAppInit; } });
+// commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
+var index_1 = require("../../../services/app/init/index");
+Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });

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

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppInit = handleAppInit;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/app/init/index");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/** miaoda app init [--template <stack>] [--conf <json>] */
+async function handleAppInit(opts) {
+    await Promise.resolve();
+    const targetDir = opts.targetDir ?? process.cwd();
+    const metaPath = node_path_1.default.join(targetDir, '.spark', 'meta.json');
+    // 幂等：.spark/meta.json 是 init 流程最后才写的，存在即代表"已完整成功一次"。
+    // 用 package.json 判幂等会让 install 失败、CWD 留下半渲染状态的应用永远 init 不了。
+    if (node_fs_1.default.existsSync(metaPath)) {
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`Already initialized: ${metaPath}\n`);
+        }
+        (0, output_1.emit)({
+            data: {
+                initialized: false,
+                reason: 'already_initialized',
+                targetDir,
+            },
+        });
+        return;
+    }
+    const stack = opts.template;
+    if (!stack) {
+        throw new error_1.AppError('ARGS_INVALID', '缺少 --template <stack>', {
+            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
+        });
+    }
+    if (!index_1.SUPPORTED_STACKS.includes(stack)) {
+        throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${stack}`, {
+            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
+        });
+    }
+    const version = opts.conf?.version;
+    const projectName = node_path_1.default.basename(targetDir);
+    const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
+    const steeringResult = (0, index_1.syncSteering)({
+        stack,
+        targetDir,
+        version: opts.conf?.steeringVersion,
+    });
+    const installResult = (0, index_1.installDependencies)({
+        targetDir,
+        skip: opts.skipInstall,
+        quietStdout: (0, output_1.isJsonMode)(),
+    });
+    (0, index_1.writeSparkMeta)(targetDir, {
+        appId: opts.appId,
+        template: stack,
+        templatePackage: tplResult.packageName,
+        templateVersion: tplResult.version,
+        steeringVersion: steeringResult.version,
+        archType: tplResult.archType,
+        installSource: installResult.source,
+        installHash: installResult.hash,
+    });
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+    }
+    (0, output_1.emit)({
+        data: {
+            initialized: true,
+            appId: opts.appId,
+            template: stack,
+            templatePackage: tplResult.packageName,
+            templateVersion: tplResult.version,
+            steeringVersion: steeringResult.version,
+            archType: tplResult.archType,
+            syncedSkills: steeringResult.syncedSkills,
+            techSynced: steeringResult.techSynced,
+            installed: installResult.installed,
+            installSource: installResult.source,
+            installHash: installResult.hash,
+            cacheZip: installResult.cacheZip,
+        },
+    });
+}

package/dist/cli/handlers/deploy/modern.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeployModern = handleDeployModern;
+const node_path_1 = __importDefault(require("node:path"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../services/deploy/modern/index");
+/**
+ * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
+ *
+ * 进程信息走 stderr（log_id / step），最终结果通过 emit 输出 envelope 到 stdout。
+ */
+async function handleDeployModern(opts) {
+    const projectDir = node_path_1.default.resolve(opts.dir);
+    const result = await (0, index_1.runModernDeploy)({
+        projectDir,
+        skipBuild: opts.skipBuild ?? false,
+    });
+    (0, output_1.emit)({
+        data: {
+            appId: result.appId,
+            version: result.version,
+            url: result.url,
+            releaseID: result.releaseID,
+            preReleaseID: result.preReleaseID,
+        },
+        next_cursor: null,
+        has_more: false,
+    });
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.syncSteering = 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; } });
+Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
+var steering_1 = require("./steering");
+Object.defineProperty(exports, "syncSteering", { enumerable: true, get: function () { return steering_1.syncSteering; } });
+var spark_meta_1 = require("../../../utils/spark-meta");
+Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: function () { return spark_meta_1.readSparkMeta; } });
+Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: function () { return spark_meta_1.writeSparkMeta; } });
+var install_1 = require("./install");
+Object.defineProperty(exports, "installDependencies", { enumerable: true, get: function () { return install_1.installDependencies; } });

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

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependencies = installDependencies;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const error_1 = require("../../../utils/error");
+const logger_1 = require("../../../utils/logger");
+const DEP_CACHE_ENV = 'MIAODA_DEP_CACHE_DIR';
+/**
+ * 依赖安装。
+ *
+ * 优先级：
+ *   1. skip=true → 直接返回 source=skipped
+ *   2. MIAODA_DEP_CACHE_DIR 设了 + 目标目录有 package.json：
+ *        - 算 md5(package.json)（与 CI 生产端 dep-cache pipeline 一致）
+ *        - 若 ${cache}/${hash}.zip 存在 → unzip 到目标目录
+ *           - 校验 node_modules/ 非空：通过则 source=cache，否则 fallback npm install
+ *        - zip 不存在 → fallback npm install，但 hash 仍记录
+ *   3. `npm install --no-audit --no-fund`
+ *
+ * 不做 cache 回写（read-only）。
+ */
+function installDependencies(opts) {
+    if (opts.skip) {
+        (0, logger_1.log)('init', 'Skipping dependency install (--skip-install)');
+        return { installed: false, source: 'skipped' };
+    }
+    const childStdio = stdioFor(opts.quietStdout);
+    const cacheDir = process.env[DEP_CACHE_ENV];
+    const pkgJsonPath = node_path_1.default.join(opts.targetDir, 'package.json');
+    const hasPkg = node_fs_1.default.existsSync(pkgJsonPath);
+    if (cacheDir && hasPkg) {
+        const hash = md5File(pkgJsonPath);
+        const cacheZip = node_path_1.default.join(cacheDir, `${hash}.zip`);
+        if (node_fs_1.default.existsSync(cacheZip)) {
+            (0, logger_1.log)('init', `Cache hit: ${cacheZip}`);
+            extractZip(cacheZip, opts.targetDir, childStdio);
+            if (nodeModulesUsable(opts.targetDir)) {
+                return { installed: true, source: 'cache', hash, cacheZip };
+            }
+            (0, logger_1.log)('init', 'Cache zip extracted but node_modules/ missing or empty; falling back to npm install');
+            runNpmInstall(opts.targetDir, childStdio);
+            return { installed: true, source: 'npm', hash };
+        }
+        (0, logger_1.log)('init', `Cache miss for ${hash}.zip, falling back to npm install`);
+        runNpmInstall(opts.targetDir, childStdio);
+        return { installed: true, source: 'npm', hash };
+    }
+    if (cacheDir && !hasPkg) {
+        (0, logger_1.log)('init', `${DEP_CACHE_ENV} set but no package.json in target; running npm install`);
+    }
+    runNpmInstall(opts.targetDir, childStdio);
+    return { installed: true, source: 'npm' };
+}
+function nodeModulesUsable(targetDir) {
+    const nm = node_path_1.default.join(targetDir, 'node_modules');
+    if (!node_fs_1.default.existsSync(nm))
+        return false;
+    try {
+        return node_fs_1.default.readdirSync(nm).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function stdioFor(quietStdout) {
+    // quietStdout=true：子进程 stdout 重定向到 fd 2（父进程 stderr），
+    // 保留 stderr 直出 → 终端仍能看到 npm install 进度，但父进程 stdout 干净，
+    // 后续 emit(JSON) 不会被污染。
+    return quietStdout ? ['ignore', 2, 'inherit'] : ['ignore', 'inherit', 'inherit'];
+}
+function md5File(filePath) {
+    const buf = node_fs_1.default.readFileSync(filePath);
+    return node_crypto_1.default.createHash('md5').update(buf).digest('hex');
+}
+function extractZip(zipPath, targetDir, stdio) {
+    try {
+        (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', zipPath, '-d', targetDir], { stdio });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('DEP_CACHE_EXTRACT_FAILED', `解压依赖缓存失败 (${zipPath}): ${msg}`, {
+            next_actions: [`确认 ${zipPath} 是合法 zip`, `或 unset ${DEP_CACHE_ENV} 走 npm install`],
+        });
+    }
+}
+function runNpmInstall(targetDir, stdio) {
+    (0, logger_1.log)('init', `npm install in ${targetDir}...`);
+    try {
+        (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund'], { cwd: targetDir, stdio });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('NPM_INSTALL_FAILED', `npm install 失败: ${msg}`);
+    }
+}

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

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncSteering = syncSteering;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const npm_pack_1 = require("../../../utils/npm-pack");
+const logger_1 = require("../../../utils/logger");
+const STEERING_PACKAGE = '@lark-apaas/coding-steering';
+function syncSteering(opts) {
+    (0, logger_1.log)('init', `Fetching ${STEERING_PACKAGE}@${opts.version ?? 'latest'}...`);
+    const fetched = (0, npm_pack_1.fetchNpmPackage)({
+        packageName: STEERING_PACKAGE,
+        version: opts.version,
+    });
+    try {
+        const steeringRoot = node_path_1.default.join(fetched.extractDir, 'steering');
+        const stackDir = node_path_1.default.join(steeringRoot, opts.stack);
+        const commonSkillsDir = node_path_1.default.join(steeringRoot, '_common', 'skills');
+        const dstRoot = node_path_1.default.join(opts.targetDir, '.agent', 'steering');
+        const dstSkillsDir = node_path_1.default.join(dstRoot, 'skills');
+        node_fs_1.default.mkdirSync(dstSkillsDir, { recursive: true });
+        let techSynced = false;
+        const techSrc = node_path_1.default.join(stackDir, 'tech.md');
+        if (node_fs_1.default.existsSync(techSrc)) {
+            node_fs_1.default.copyFileSync(techSrc, node_path_1.default.join(dstRoot, 'tech.md'));
+            techSynced = true;
+        }
+        const synced = [];
+        // 先拷 _common/skills/，再拷 <stack>/skills/。stack 同名覆盖 common（设计 §8.4）
+        if (node_fs_1.default.existsSync(commonSkillsDir)) {
+            for (const name of node_fs_1.default.readdirSync(commonSkillsDir)) {
+                const src = node_path_1.default.join(commonSkillsDir, name);
+                if (!node_fs_1.default.statSync(src).isDirectory())
+                    continue;
+                copyDir(src, node_path_1.default.join(dstSkillsDir, name));
+                synced.push(`_common/skills/${name}`);
+            }
+        }
+        const stackSkillsDir = node_path_1.default.join(stackDir, 'skills');
+        if (node_fs_1.default.existsSync(stackSkillsDir)) {
+            for (const name of node_fs_1.default.readdirSync(stackSkillsDir)) {
+                const src = node_path_1.default.join(stackSkillsDir, name);
+                if (!node_fs_1.default.statSync(src).isDirectory())
+                    continue;
+                const dst = node_path_1.default.join(dstSkillsDir, name);
+                if (node_fs_1.default.existsSync(dst))
+                    node_fs_1.default.rmSync(dst, { recursive: true, force: true });
+                copyDir(src, dst);
+                synced.push(`${opts.stack}/skills/${name}`);
+            }
+        }
+        (0, logger_1.log)('init', `Steering synced: ${String(synced.length)} skill(s), tech.md ${techSynced ? 'yes' : 'no'}`);
+        return { version: fetched.version, syncedSkills: synced, techSynced };
+    }
+    finally {
+        fetched.cleanup();
+    }
+}
+function copyDir(src, dest) {
+    node_fs_1.default.mkdirSync(dest, { recursive: true });
+    for (const entry of node_fs_1.default.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = node_path_1.default.join(src, entry.name);
+        const destPath = node_path_1.default.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            node_fs_1.default.copyFileSync(srcPath, destPath);
+        }
+    }
+}