@lark-apaas/miaoda-cli 0.1.13 → 0.1.15

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

@@ -10,16 +10,25 @@ const index_1 = require("../../../services/app/init/index");
 const coding_steering_1 = require("../../../utils/coding-steering");
 const logger_1 = require("../../../utils/logger");
 const githooks_1 = require("../../../utils/githooks");
-const sync_1 = require("../../../cli/handlers/app/sync");
 const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 /**
  * miaoda app init
  *
- * 一站式本地脚手架：render template → upgrade/templates sync → skills sync → install deps，把
+ * 一站式本地脚手架：render template → skills sync → install deps，把
  * {stack, version, archType, app_id?} 写入 .spark/meta.json。--app-id（或 MIAODA_APP_ID）提供时
  * 持久化 app_id；运行端命令仍优先读 env，未设置时回退到 meta.json。
  *
+ * init 不跑 `miaoda app sync` 的任何子动作（SyncRule 应用 / 平台脚本覆盖 / patches /
+ * 升管控包到 latest）。原因：
+ *   - 本地 `npm run dev` 入口 dev.sh 已经会先跑 `miaoda app sync` 再起服务（看 templates
+ *     /scripts/dev.sh），sync 在用户真正用 app 之前必然跑过一次
+ *   - 沙箱 pod 启动阶段平台侧也会做同步（dev.sh 注释明文："脚本同步由平台 pod 启动阶段做过"）
+ *   - 两条路径都不依赖 init 时的 sync，init 重跑一遍是冗余
+ * 副作用：init 完到首次 dev/sync 之间，user app 的 scripts/ 模板文件是 template 包发版时
+ * 的版本（没经 sync 覆盖）；首次 install 装的也是 template 钉的版本（没升 latest），
+ * package.json 跟 template 完全一致。dev.sh 入口的 sync 会修正这些 drift。
+ *
  * 幂等：.spark/meta.json 存在即表示已完整成功一次，直接退出，不重跑任何子步骤。
  * 半渲染状态（package.json 在但 meta.json 不在）会重新跑完整流程。
  */
@@ -54,22 +63,14 @@ async function handleAppInit(opts) {
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
-    // sync 紧跟 template 渲染之后，赶在 install 之前：
-    // 这样 directory / merge-json / add-script 等 rule 都已落地，install 出来的 lockfile
-    // 与最终态对齐；patches 还能覆盖 template 提供的同名文件。
-    const syncRunResult = (0, sync_1.runStackSync)(stack, targetDir, 'init');
-    const syncSummary = (0, sync_1.summarizeSyncResults)(syncRunResult);
-    // template 渲染下来的 @lark-apaas/* 版本可能落后 MANAGED_PLATFORM_PACKAGES 白名单，赶在
-    // install 之前统一指 latest，这样一次 npm install 就直接装最新版本，不需要 install 完再补。
-    const upgradedPackages = (0, sync_1.upgradePlatformDeps)(targetDir, 'init');
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
     // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
-    // 按 stack 分流 outputLayout:
-    //   - nestjs-react-fullstack:本地主战场,用 flat 布局
-    //     (.agents/skills + .claude/skills 软链),不再创建 .agent/ 老目录
-    //   - 其他 stack:仍走默认 nested (.agent/skills/steering/<stack>/skills/),
-    //     跟沙箱端 update-skills.sh 老链路对齐,避免破坏
-    const outputLayout = stack === 'nestjs-react-fullstack' ? 'flat' : 'nested';
+    // 按运行环境（SANDBOX_ID）分流 outputLayout，不绑 stack:
+    //   - 沙箱内（SANDBOX_ID 非空）→ nested (.agent/skills/steering/<stack>/skills/),
+    //     跟沙箱端 update-skills.sh 链路对齐
+    //   - 本地（SANDBOX_ID 空）→ flat (.agents/skills + .claude/skills 软链),
+    //     Agent / Claude Code 用同一份;nrf 在本地是主战场,vite-react 等也一样适用
+    const outputLayout = process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '' ? 'nested' : 'flat';
     let steeringResult;
     let steeringError;
     try {
@@ -85,6 +86,8 @@ async function handleAppInit(opts) {
         (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
         steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
     }
+    // 装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
+    // —— "升管控包到 latest" 是 sync 的职责,在 dev.sh 入口跑 `miaoda app sync` 时触发。
     const installResult = (0, index_1.installDependencies)({
         targetDir,
         skip: opts.skipInstall,
@@ -98,13 +101,8 @@ async function handleAppInit(opts) {
         archType: tplResult.archType,
         app_id: opts.appId,
     });
-    const syncedSummary = syncRunResult.stackFound
-        ? syncRunResult.rulesApplied.length > 0
-            ? `${syncRunResult.rulesApplied.length.toString()} rule(s)`
-            : 'legacy'
-        : 'skipped';
     if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, sync ${syncedSummary}, 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: {
@@ -118,14 +116,6 @@ async function handleAppInit(opts) {
             syncedSkills: steeringResult.syncedSkills,
             techSynced: steeringResult.techSynced,
             steeringError,
-            // sync 流程的产出：rule-driven 时 appliedRules + 一系列汇总字段；fallback 到旧 platform-sync
-            // 时只填 platformSyncedFiles / platformMergedJsonFiles；stack 不识别时全空且 platformStackFound=false。
-            platformStackFound: syncRunResult.stackFound,
-            appliedRules: syncSummary.appliedRules,
-            platformSyncedFiles: syncSummary.syncedFiles,
-            platformMergedJsonFiles: syncSummary.mergedJsonFiles,
-            patchedScripts: syncSummary.patchedScripts,
-            upgradedPackages,
             gitHooks: hookActivation.action,
             installed: installResult.installed,
             installSource: installResult.source,

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

@@ -7,8 +7,8 @@ exports.handleAppUpgrade = void 0;
 exports.handleAppSync = handleAppSync;
 exports.runStackSync = runStackSync;
 exports.summarizeSyncResults = summarizeSyncResults;
-exports.listManagedDeps = listManagedDeps;
-exports.upgradePlatformDeps = upgradePlatformDeps;
+exports.snapshotManagedDepSpecs = snapshotManagedDepSpecs;
+exports.diffManagedSpecs = diffManagedSpecs;
 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"));
@@ -79,17 +79,13 @@ async function handleAppSync(opts) {
             ],
         });
     }
-    // 2. @lark-apaas/* dep 统一指 latest（按 MANAGED_PLATFORM_PACKAGES 白名单，user app 已装才升）
-    const upgradedPackages = upgradePlatformDeps(targetDir, 'sync');
-    // 3. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
+    // 2. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
+    // 3. snapshot 当前 user app 装的管控包版本，供 install 后 diff 用
+    const beforeSpecs = snapshotManagedDepSpecs(targetDir);
     // 4. npm install —— 跟 init 一样软失败,install 挂了不该阻断 emit / sync 总结输出。
-    // 把 user app 装着的**所有**管控包显式作为位置参数传给 npm install,强制 npm 重新
-    // resolve lockfile entry。原因:
-    //   - 即便 package.json spec 已经是 "latest"(没有 from→to 变化),user app 老 lockfile
-    //     可能锁着具体老版本 (如 fullstack-vite-preset@1.0.9),纯 `npm install` 会按 lockfile
-    //     拉老版,绕过 spec "latest" 的解析意图
-    //   - 显式 `npm install foo@latest bar@latest` 让 npm 重新解析,lockfile 跟着更新到当前 latest
+    // 把 user app 装着的**所有**管控包显式作为 `<pkg>@latest` 位置参数传给 npm install:
+    //   - npm 自然会把 spec 改写成 ^具体最新版,lockfile 同步更新 → 不需要 sync 主动改 spec
     //   - 没装的管控包不动 (sync 的职责是对齐,不是塞依赖)
     // --ignore-scripts 绕开 action-plugin postinstall 在缺平台 env 时的 ENOENT。
     // --registry 跟 init 钉同一份 npmmirror,避免 user 全局 ~/.npmrc 把 sync 拉到另一个源
@@ -102,7 +98,7 @@ async function handleAppSync(opts) {
         '--registry',
         (0, install_1.resolveNpmInstallRegistry)(),
     ];
-    for (const name of listManagedDeps(targetDir)) {
+    for (const name of Object.keys(beforeSpecs)) {
         installArgs.push(`${name}@${MANAGED_PLATFORM_PACKAGES[name]}`);
     }
     (0, logger_1.log)('sync', `Running npm ${installArgs.join(' ')}...`);
@@ -117,6 +113,9 @@ async function handleAppSync(opts) {
         installError = err instanceof Error ? err.message : String(err);
         (0, logger_1.log)('sync', `⚠ npm install failed (continuing): ${installError}`);
     }
+    // 5. install 之后再读一次 package.json，diff 出 npm 实际改写的 spec
+    const afterSpecs = snapshotManagedDepSpecs(targetDir);
+    const upgradedPackages = diffManagedSpecs(beforeSpecs, afterSpecs, 'sync');
     (0, output_1.emit)({
         data: {
             stack: meta.stack,
@@ -203,64 +202,39 @@ function readPackageJson(pkgJsonPath) {
         return null;
     return JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath, 'utf-8'));
 }
-/**
- * 列出 user app 装着的 @lark-apaas/* 管控包 (在 MANAGED_PLATFORM_PACKAGES 白名单内的)。
- * sync handler 用来给 `npm install` 显式列管控包名 + @latest,强制 npm 重新 resolve
- * lockfile entry —— 即便 package.json spec 已经是 "latest" 没 from→to 变化,
- * 老 lockfile 锁的具体老版本(如 fullstack-vite-preset@1.0.9)也会被刷掉。
- */
-function listManagedDeps(targetDir) {
+function snapshotManagedDepSpecs(targetDir) {
     const pkg = readPackageJson(node_path_1.default.join(targetDir, 'package.json'));
     if (!pkg)
-        return [];
-    const names = new Set();
+        return {};
+    const snap = {};
     for (const section of ['dependencies', 'devDependencies']) {
         const deps = pkg[section];
         if (!deps || typeof deps !== 'object')
             continue;
-        for (const name of Object.keys(deps)) {
-            if (Object.prototype.hasOwnProperty.call(MANAGED_PLATFORM_PACKAGES, name)) {
-                names.add(name);
-            }
+        for (const [name, spec] of Object.entries(deps)) {
+            if (!Object.prototype.hasOwnProperty.call(MANAGED_PLATFORM_PACKAGES, name))
+                continue;
+            if (Object.prototype.hasOwnProperty.call(snap, name))
+                continue; // dependencies 优先
+            snap[name] = { spec, section };
         }
     }
-    return [...names];
+    return snap;
 }
 /**
- * 把 user app package.json 里已装的 @lark-apaas/* 平台包改写成 MANAGED_PLATFORM_PACKAGES
- * 表里的目标 spec（缺省 `"latest"`）。由 `miaoda app sync` 和 `miaoda app init`（template
- * 渲染后、install 之前）共用。
- *
- * - user app 已装的管控包 → 写表里的目标 spec（默认 latest，紧急止血时可改具体版本）
- * - user app 未装的管控包 → 不引入（sync 的职责是对齐，不是塞依赖）
- * - 装着但不在白名单的 @lark-apaas/* 包 → 完全不动
- *
- * @param logPrefix 用于 `[<prefix>]   deps.xxx: a → b` 日志前缀；sync 流程传 'sync'，init 流程传 'init'。
+ * 对比 install 前后的管控包 spec snapshot，得到 `npm install` 实际改写了哪些 spec。
+ * sync 和 init 共用：把"主动改 package.json"完全交给 npm，本函数只做事后观测。
  */
-function upgradePlatformDeps(targetDir, logPrefix = 'sync') {
-    const pkgJsonPath = node_path_1.default.join(targetDir, 'package.json');
-    const pkg = readPackageJson(pkgJsonPath);
-    if (!pkg)
-        return [];
-    const updated = [];
-    for (const section of ['dependencies', 'devDependencies']) {
-        const deps = pkg[section];
-        if (!deps || typeof deps !== 'object')
+function diffManagedSpecs(before, after, logPrefix) {
+    const bumps = [];
+    for (const [name, b] of Object.entries(before)) {
+        if (!Object.prototype.hasOwnProperty.call(after, name))
             continue;
-        for (const name of Object.keys(deps)) {
-            if (!Object.prototype.hasOwnProperty.call(MANAGED_PLATFORM_PACKAGES, name))
-                continue;
-            const target = MANAGED_PLATFORM_PACKAGES[name];
-            const from = deps[name];
-            if (from === target)
-                continue;
-            deps[name] = target;
-            updated.push({ name, from, to: target, section });
-            (0, logger_1.log)(logPrefix, `  ${section}.${name}: ${from} → ${target}`);
-        }
-    }
-    if (updated.length > 0) {
-        node_fs_1.default.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+        const a = after[name];
+        if (a.spec === b.spec)
+            continue;
+        bumps.push({ name, from: b.spec, to: a.spec, section: b.section });
+        (0, logger_1.log)(logPrefix, `  ${b.section}.${name}: ${b.spec} → ${a.spec}`);
     }
-    return updated;
+    return bumps;
 }

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

@@ -45,24 +45,24 @@ function installDependencies(opts) {
                 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');
-            return runInstallSoft(opts.targetDir, childStdio, hash);
+            return runInstallSoft(opts.targetDir, childStdio, opts.extraPackages, hash);
         }
         (0, logger_1.log)('init', `Cache miss for ${hash}.zip, falling back to npm install`);
-        return runInstallSoft(opts.targetDir, childStdio, hash);
+        return runInstallSoft(opts.targetDir, childStdio, opts.extraPackages, hash);
     }
     if (cacheDir && !hasPkg) {
         (0, logger_1.log)('init', `${DEP_CACHE_ENV} set but no package.json in target; running npm install`);
     }
-    return runInstallSoft(opts.targetDir, childStdio);
+    return runInstallSoft(opts.targetDir, childStdio, opts.extraPackages);
 }
 /**
  * 跑 npm install；失败不抛错，返回 source='failed' 让上层 init handler 继续走 writeSparkMeta
  * 等后续步骤（避免 install 挂了 .spark/meta.json 没写出来，下次 init 看到半渲染状态又得重跑全套）。
  * 失败信息通过 stderr 直出 + emit data.installError 透传给用户。
  */
-function runInstallSoft(targetDir, stdio, hash) {
+function runInstallSoft(targetDir, stdio, extraPackages, hash) {
     try {
-        runNpmInstall(targetDir, stdio);
+        runNpmInstall(targetDir, stdio, extraPackages);
         return { installed: true, source: 'npm', hash };
     }
     catch (err) {
@@ -123,10 +123,11 @@ const NPM_INSTALL_REGISTRY_DEFAULT = 'https://registry.npmmirror.com/';
 function resolveNpmInstallRegistry() {
     return process.env.MIAODA_NPM_REGISTRY ?? NPM_INSTALL_REGISTRY_DEFAULT;
 }
-function runNpmInstall(targetDir, stdio) {
-    (0, logger_1.log)('init', `npm install in ${targetDir}...`);
-    (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund', '--registry', resolveNpmInstallRegistry()], {
-        cwd: targetDir,
-        stdio,
-    });
+function runNpmInstall(targetDir, stdio, extraPackages) {
+    const args = ['install', '--no-audit', '--no-fund', '--registry', resolveNpmInstallRegistry()];
+    if (extraPackages !== undefined && extraPackages.length > 0) {
+        args.push(...extraPackages);
+    }
+    (0, logger_1.log)('init', `npm ${args.join(' ')} in ${targetDir}...`);
+    (0, node_child_process_1.execFileSync)('npm', args, { cwd: targetDir, stdio });
 }

package/package.json

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