@lark-apaas/fullstack-cli 1.1.62-alpha.20260824081932 → 1.1.62-alpha.20260824095126

package/dist/index.js

@@ -2617,7 +2617,23 @@ function emptyProfile() {
 }
 function viteReactProfile() {
   return {
-    sync: [],
+    sync: [
+      // 覆盖 scripts/build.sh（回溯 public/* → dist/output/ 的修复）
+      {
+        from: "templates/vite-react/build.sh",
+        to: "scripts/build.sh",
+        type: "file",
+        overwrite: true
+      },
+      // 补 upgrade 脚本：沙箱启动主动调 `fullstack-cli sync`（镜像必带，裸命令，与 postinstall 口径一致）。
+      // 存量应用首次由沙箱直接 `fullstack-cli sync` 兜到，本 add-script 保证脚本存在 + 后续一致。
+      {
+        type: "add-script",
+        name: "upgrade",
+        command: "fullstack-cli sync",
+        overwrite: false
+      }
+    ],
     permissions: {},
     activateGitHooks: true
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.62-alpha.20260824081932",
+  "version": "1.1.62-alpha.20260824095126",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",

package/templates/.gitignore.append

@@ -5,3 +5,4 @@
 # scripts/ directory is auto-generated
 # DO NOT modify manually
 scripts/
+

package/templates/scripts/build.sh

@@ -149,16 +149,12 @@ if [ -d "$DIST_DIR/client" ]; then
   find "$DIST_DIR/client" -maxdepth 1 -name "*.html" -exec mv {} "$DIST_DIR/dist/client/" \;
 fi
 
-# 拷贝 shared/static → dist/shared/static
-# Nest server 生产从 process.cwd() + shared/static 读 (nestjs-core static.controller.ts:100),
-# 生产 cwd = dist/, 所以目标是 dist/shared/static。coding-preset 的 static-assets plugin
-# 之前 closeBundle 拷贝, 现在删除后交给 build.sh 显式做 (跟 jsPage 的 output_static rsync 对齐)。
-# 排除 .ts/.tsx/.js/.jsx: 避免 shared/static/ 里若有开发脚本被误传到生产。
-if [ -d "$ROOT_DIR/shared/static" ]; then
-  mkdir -p "$DIST_DIR/shared/static"
-  rsync -a --exclude='*.ts' --exclude='*.tsx' --exclude='*.js' --exclude='*.jsx' \
-    "$ROOT_DIR/shared/static/" "$DIST_DIR/shared/static/"
-  echo "   Static → dist/shared/static/"
+# 拷贝 client/public → 产物根 public/：供 nestjs-core 的 public 中间件在应用根同源 serve
+# （修 nestjs-fullstack 的 public 线上 404：同源 fetch('/x') / resolveAppUrl('/x')）。
+# 运行时 cwd=DIST_DIR，中间件读 process.cwd()/public。
+if [ -d "$ROOT_DIR/client/public" ]; then
+  mkdir -p "$DIST_DIR/public"
+  cp -R "$ROOT_DIR/client/public/." "$DIST_DIR/public/"
 fi
 
 # server 相关产物准备（only_frontend_change=true 时跳过）

package/templates/scripts/dev.js

@@ -252,22 +252,20 @@ process.on('SIGTERM', cleanup);
 process.on('SIGINT', cleanup);
 process.on('SIGHUP', cleanup);
 
-// dist 缓存策略:
-//   沙箱首次启动 → 保留 dist/, 让 nest --watch 复用上次编译产物
-//   后续启动 (agent 主动触发 npm run dev) → 全清 dist/, 让模型面对新鲜产物避免 stale
-//   依赖升级 (lockfile hash 变) → 同后续启动 (清 dist), log 里点出 "deps changed"
-//   FORCE_CLEAN_DIST=true → escape hatch, 强清
-// marker 放 os.tmpdir()/.miaoda-dev-boot (跟沙箱容器 lifecycle 同, 沙箱重启会清空,
-// 语义对齐"沙箱首次启动"); 具体逻辑抽到 lib/preserve-dev-cache.cjs 便于单测。
-const { preserveDevCache } = require('./lib/preserve-dev-cache.cjs');
+// Stale dist makes nest --watch skip missing files; watcher won't self-heal.
+function cleanStaleDist() {
+  const distPath = path.join(PROJECT_ROOT, 'dist');
+  if (fs.existsSync(distPath)) {
+    fs.rmSync(distPath, { recursive: true, force: true });
+    logEvent('INFO', 'main', 'Cleaned dist/ to force full rebuild');
+  }
+}
 
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
   logEvent('INFO', 'main', '========== Dev session started ==========');
 
-  preserveDevCache(PROJECT_ROOT, {
-    log: (level, msg) => logEvent(level, 'main', msg),
-  });
+  cleanStaleDist();
 
   // Initialize action plugins
   writeOutput('\n🔌 Initializing action plugins...\n');

package/templates/vite-react/build.sh

@@ -0,0 +1,61 @@
+#!/bin/bash
+set -e
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+OUTPUT="$ROOT/dist/output"
+OUTPUT_RESOURCE="$ROOT/dist/output_resource"
+OUTPUT_STATIC="$ROOT/dist/output_static"
+
+# 映射平台环境变量到 preset 期望的变量名
+#   MIAODA_APP_ID            → /app/<appId> 作为客户端 base path
+#   MIAODA_RESOURCE_CDN_PREFIX → assets (JS/CSS) 的 CDN 前缀
+# CLI 注入约定见 miaoda-cli src/services/deploy/modern/atoms/build.ts
+export CLIENT_BASE_PATH="${MIAODA_APP_ID:+/app/$MIAODA_APP_ID}"
+export ASSETS_CDN_PATH="${MIAODA_RESOURCE_CDN_PREFIX:-/}"
+export STATIC_ASSETS_BASE_URL="${MIAODA_STATIC_CDN_PREFIX}"
+export NODE_ENV="${NODE_ENV:-production}"
+
+# 清理
+rm -rf "$ROOT/dist"
+
+# 1. Vite 构建 → dist/client/（相对于项目根目录输出）
+npx vite build --outDir "$ROOT/dist/client" --emptyOutDir
+
+# 2. public/ 静态资源 + HTML → dist/output/（模型 B：public = 应用根目录，同源 /app/<appId>/*）
+mkdir -p "$OUTPUT"
+# 2a. public/*：vite copyPublicDir 已把 public/* 平铺进 dist/client，但下面白名单只取
+#     *.html/routes.json，其余（favicon / 图片 / 运行时 fetch 的数据文件）会随 dist/client 被删。
+#     从源 public/ 补拷到 output/（同源根），让 fetch('/x') / resolveAppUrl('/x') 线上可用。
+#     先拷 public、再拷 HTML，保证构建产出的 index.html/routes.json 覆盖 public 里的同名文件（若有）。
+if [ -d "$ROOT/public" ]; then
+  cp -R "$ROOT/public/." "$OUTPUT/"
+fi
+# 2b. HTML + routes.json（构建产物）
+find "$ROOT/dist/client" -maxdepth 1 \( -name '*.html' -o -name 'routes.json' \) -exec cp {} "$OUTPUT/" \;
+
+# 3. assets/ → dist/output_resource/（JS/CSS/字体，上传到 CDN）
+if [ -d "$ROOT/dist/client/assets" ]; then
+  mkdir -p "$OUTPUT_RESOURCE"
+  cp -r "$ROOT/dist/client/assets" "$OUTPUT_RESOURCE/"
+fi
+
+# 4. 私有静态资源 → dist/output_static/（排除代码文件）
+if [ -d "$ROOT/shared/static" ]; then
+  mkdir -p "$OUTPUT_STATIC"
+  rsync -a --exclude='*.ts' --exclude='*.tsx' --exclude='*.js' --exclude='*.jsx' "$ROOT/shared/static/" "$OUTPUT_STATIC/"
+fi
+
+# 5. capability 配置 → dist/output_capabilities/
+if [ -d "$ROOT/shared/capabilities" ]; then
+  mkdir -p "$ROOT/dist/output_capabilities"
+  cp -r "$ROOT/shared/capabilities/." "$ROOT/dist/output_capabilities/"
+fi
+
+# 清理中间产物
+rm -rf "$ROOT/dist/client"
+
+echo "Build complete"
+echo "  HTML         → dist/output/"
+[ -d "$OUTPUT_RESOURCE" ] && echo "  Resource     → dist/output_resource/" || true
+[ -d "$OUTPUT_STATIC" ] && echo "  Static       → dist/output_static/" || true
+[ -d "$ROOT/dist/output_capabilities" ] && echo "  Capabilities → dist/output_capabilities/" || true

package/templates/scripts/lib/__test__/preserve-dev-cache.test.ts

@@ -1,308 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-const { preserveDevCache } = require('../preserve-dev-cache.cjs');
-
-interface LogEntry {
-  level: string;
-  msg: string;
-}
-
-function makeLogger(entries: LogEntry[]) {
-  return (level: string, msg: string) => {
-    entries.push({ level, msg });
-  };
-}
-
-describe('preserveDevCache', () => {
-  let tmpDir: string;
-  let markerPath: string;
-
-  beforeEach(() => {
-    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'preserve-dev-cache-'));
-    markerPath = path.join(tmpDir, '.miaoda-dev-boot-marker');
-  });
-
-  afterEach(() => {
-    try {
-      fs.rmSync(tmpDir, { recursive: true, force: true });
-    } catch {
-      // ignore
-    }
-  });
-
-  describe('FORCE_CLEAN_DIST escape hatch', () => {
-    it('cleans dist and writes marker regardless of state', () => {
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'lock-content');
-      const logs: LogEntry[] = [];
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: true,
-        markerPath,
-      });
-
-      expect(r.action).toBe('force_cleaned');
-      expect(fs.existsSync(path.join(tmpDir, 'dist'))).toBe(false);
-      expect(fs.existsSync(markerPath)).toBe(true);
-      expect(logs[0].msg).toContain('FORCE_CLEAN_DIST');
-    });
-  });
-
-  describe('first boot (no marker)', () => {
-    it('preserves existing dist and writes marker', () => {
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(
-        path.join(tmpDir, 'dist', 'server', 'main.js'),
-        'compiled-content'
-      );
-      const logs: LogEntry[] = [];
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_preserved');
-      expect(fs.existsSync(path.join(tmpDir, 'dist', 'server', 'main.js'))).toBe(true);
-      expect(fs.existsSync(markerPath)).toBe(true);
-      expect(logs[0].msg).toContain('first boot');
-    });
-
-    it('handles no dist as first_boot_no_dist', () => {
-      const logs: LogEntry[] = [];
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_no_dist');
-      expect(fs.existsSync(markerPath)).toBe(true);
-      expect(logs[0].msg).toContain('no dist/');
-    });
-
-    it('marker stores current lockfile hash', () => {
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'initial-lock');
-
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      const raw = fs.readFileSync(markerPath, 'utf-8');
-      const data = JSON.parse(raw);
-      expect(typeof data.lockfileHash).toBe('string');
-      expect(data.lockfileHash.length).toBeGreaterThan(0);
-    });
-  });
-
-  describe('subsequent boot (marker exists)', () => {
-    it('cleans dist and rewrites marker when lockfile unchanged', () => {
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'lock-content');
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'server', 'stale.js'), 'stale');
-
-      const logs: LogEntry[] = [];
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('subsequent_boot_cleaned');
-      expect(fs.existsSync(path.join(tmpDir, 'dist'))).toBe(false);
-      expect(fs.existsSync(markerPath)).toBe(true);
-      expect(logs[0].msg).toContain('subsequent boot');
-    });
-
-    it('reports deps_changed when lockfile hash mismatches marker', () => {
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'lock-v1');
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'lock-v2');
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-
-      const logs: LogEntry[] = [];
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('deps_changed_cleaned');
-      expect(fs.existsSync(path.join(tmpDir, 'dist'))).toBe(false);
-      expect(logs[0].msg).toContain('deps changed');
-    });
-
-    it('reports subsequent_boot_no_dist when marker exists but no dist', () => {
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      const logs: LogEntry[] = [];
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('subsequent_boot_no_dist');
-      expect(fs.existsSync(markerPath)).toBe(true);
-      expect(logs[0].msg).toContain('no dist/');
-    });
-  });
-
-  describe('lockfile detection', () => {
-    it('supports package-lock.json', () => {
-      fs.writeFileSync(path.join(tmpDir, 'package-lock.json'), '{}');
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      const raw = fs.readFileSync(markerPath, 'utf-8');
-      expect(JSON.parse(raw).lockfileHash).not.toBeNull();
-    });
-
-    it('supports pnpm-lock.yaml', () => {
-      fs.writeFileSync(path.join(tmpDir, 'pnpm-lock.yaml'), 'lockfileVersion: 9');
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      const raw = fs.readFileSync(markerPath, 'utf-8');
-      expect(JSON.parse(raw).lockfileHash).not.toBeNull();
-    });
-
-    it('stores null lockfileHash when no lockfile present', () => {
-      preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      const raw = fs.readFileSync(markerPath, 'utf-8');
-      expect(JSON.parse(raw).lockfileHash).toBeNull();
-    });
-  });
-
-  describe('first boot + deps changed (lockfile newer than buildinfo)', () => {
-    // 制造"lockfile mtime > buildinfo mtime": 先建 dist + buildinfo,sleep 20ms,再 touch lockfile
-    // 20ms 是保守值,避免 macOS/APFS mtime 精度问题让两个时间戳相等
-    function makeStaleDist() {
-      fs.mkdirSync(path.join(tmpDir, 'dist'), { recursive: true });
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'server', 'main.js'), 'compiled');
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'tsconfig.node.tsbuildinfo'), '{}');
-    }
-
-    it('cleans dist when lockfile mtime > buildinfo mtime', async () => {
-      makeStaleDist();
-      await new Promise((r) => setTimeout(r, 20));
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'newer-lock');
-
-      const logs: LogEntry[] = [];
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_deps_changed_cleaned');
-      expect(fs.existsSync(path.join(tmpDir, 'dist'))).toBe(false);
-      expect(logs[0].msg).toContain('deps changed');
-    });
-
-    it('preserves dist when lockfile mtime <= buildinfo mtime', async () => {
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'older-lock');
-      await new Promise((r) => setTimeout(r, 20));
-      makeStaleDist();
-
-      const logs: LogEntry[] = [];
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger(logs),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_preserved');
-      expect(fs.existsSync(path.join(tmpDir, 'dist', 'server', 'main.js'))).toBe(true);
-    });
-
-    it('cleans dist when buildinfo is missing (dist exists but never compiled)', () => {
-      fs.writeFileSync(path.join(tmpDir, 'yarn.lock'), 'lock');
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'server', 'main.js'), 'compiled');
-      // 故意不建 tsconfig.node.tsbuildinfo
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_deps_changed_cleaned');
-      expect(fs.existsSync(path.join(tmpDir, 'dist'))).toBe(false);
-    });
-
-    it('preserves dist when no lockfile present (cannot judge staleness)', () => {
-      // dist 有 buildinfo 但没 lockfile
-      fs.mkdirSync(path.join(tmpDir, 'dist'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'tsconfig.node.tsbuildinfo'), '{}');
-      fs.mkdirSync(path.join(tmpDir, 'dist', 'server'), { recursive: true });
-      fs.writeFileSync(path.join(tmpDir, 'dist', 'server', 'main.js'), 'compiled');
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-        markerPath,
-      });
-
-      expect(r.action).toBe('first_boot_preserved');
-      expect(fs.existsSync(path.join(tmpDir, 'dist', 'server', 'main.js'))).toBe(true);
-    });
-  });
-
-  describe('marker path (sandbox lifecycle alignment)', () => {
-    it('defaults markerPath to os.tmpdir()/.miaoda-dev-boot when not passed', () => {
-      // 不传 markerPath, 走默认路径
-      const defaultMarker = path.join(os.tmpdir(), '.miaoda-dev-boot');
-      // 清理默认位置的残留 marker (可能来自其他测试),避免干扰本用例
-      try { fs.unlinkSync(defaultMarker); } catch { /* noop */ }
-
-      const r = preserveDevCache(tmpDir, {
-        log: makeLogger([]),
-        forceClean: false,
-      });
-
-      expect(r.action).toBe('first_boot_no_dist');
-      expect(fs.existsSync(defaultMarker)).toBe(true);
-
-      // cleanup
-      try { fs.unlinkSync(defaultMarker); } catch { /* noop */ }
-    });
-  });
-});

package/templates/scripts/lib/preserve-dev-cache.cjs

@@ -1,178 +0,0 @@
-'use strict';
-
-// dev.js 启动时的 dist 缓存策略:
-//  - 沙箱首次启动 (marker 不存在) + dist 未过期: 保留 dist/, 让 nest --watch 复用上次编译产物
-//  - 沙箱首次启动 + dist 过期 (lockfile mtime > buildinfo mtime): 清 dist/, 避免 stale binding
-//  - 后续启动 (agent 主动触发 npm run dev): 全清 dist/, 让模型面对新鲜产物避免 stale
-//  - 依赖升级 (marker 里 lockfile hash 变): 后续启动分支自然覆盖 (清 dist), log 里点出原因
-//  - FORCE_CLEAN_DIST=true: escape hatch, 强清
-//
-// marker 位置放 os.tmpdir()(通常是 /tmp), 跟沙箱容器 lifecycle 同 —— 沙箱重启时
-// /tmp 会清空, marker 消失, 下次进 dev 视为"首次启动"复用 dist; 应用工作目录是
-// persistent volume 会跨沙箱重启保留, 放这里的 marker 无法反映"沙箱首次启动"语义。
-//
-// dist 过期判定 (仅首次启动分支需要): lockfile mtime > dist/tsconfig.node.tsbuildinfo mtime
-// 意味着依赖变动之后 dist 未重新编译, 保留会 stale binding。后续启动分支反正全清不需要判。
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const crypto = require('crypto');
-
-const MARKER_FILENAME = '.miaoda-dev-boot';
-
-/**
- * @param {string} projectRoot 项目根目录
- * @param {object} [options]
- * @param {(level: string, msg: string) => void} [options.log]
- * @param {boolean} [options.forceClean]
- * @param {string} [options.markerPath] 覆盖 marker 文件路径 (单测用; 生产默认 /tmp/.miaoda-dev-boot)
- * @returns {{ action: 'force_cleaned' | 'first_boot_preserved' | 'first_boot_deps_changed_cleaned' | 'first_boot_no_dist' | 'subsequent_boot_cleaned' | 'deps_changed_cleaned' | 'subsequent_boot_no_dist' }}
- */
-function preserveDevCache(projectRoot, options) {
-  const log = (options && options.log) || defaultLogger;
-  const forceClean =
-    options && typeof options.forceClean === 'boolean'
-      ? options.forceClean
-      : process.env.FORCE_CLEAN_DIST === 'true';
-  const markerPath =
-    (options && options.markerPath) ||
-    path.join(os.tmpdir(), MARKER_FILENAME);
-
-  const distPath = path.join(projectRoot, 'dist');
-  const currentLockfileHash = computeLockfileHash(projectRoot);
-
-  if (forceClean) {
-    if (fs.existsSync(distPath)) {
-      fs.rmSync(distPath, { recursive: true, force: true });
-    }
-    writeMarker(markerPath, currentLockfileHash);
-    log('INFO', 'preserveDevCache: FORCE_CLEAN_DIST=true, cleaned dist/');
-    return { action: 'force_cleaned' };
-  }
-
-  const markerExists = fs.existsSync(markerPath);
-  const distExists = fs.existsSync(distPath);
-
-  if (!markerExists) {
-    writeMarker(markerPath, currentLockfileHash);
-    if (distExists) {
-      if (distIsStaleVsLockfile(projectRoot)) {
-        fs.rmSync(distPath, { recursive: true, force: true });
-        log(
-          'INFO',
-          'preserveDevCache: first boot but deps changed (lockfile newer than buildinfo), cleaned dist/'
-        );
-        return { action: 'first_boot_deps_changed_cleaned' };
-      }
-      log('INFO', 'preserveDevCache: first boot, dist/ preserved');
-      return { action: 'first_boot_preserved' };
-    }
-    log('INFO', 'preserveDevCache: first boot, no dist/ (will be created)');
-    return { action: 'first_boot_no_dist' };
-  }
-
-  // 后续启动: 无脑清 dist
-  const prevLockfileHash = readMarkerHash(markerPath);
-  const depsChanged =
-    prevLockfileHash !== null &&
-    currentLockfileHash !== null &&
-    prevLockfileHash !== currentLockfileHash;
-
-  if (distExists) {
-    fs.rmSync(distPath, { recursive: true, force: true });
-  }
-  writeMarker(markerPath, currentLockfileHash);
-
-  if (depsChanged) {
-    log('INFO', 'preserveDevCache: deps changed (lockfile hash), cleaned dist/');
-    return { action: 'deps_changed_cleaned' };
-  }
-  if (distExists) {
-    log('INFO', 'preserveDevCache: subsequent boot, cleaned dist/');
-    return { action: 'subsequent_boot_cleaned' };
-  }
-  log('INFO', 'preserveDevCache: subsequent boot, no dist/ to clean');
-  return { action: 'subsequent_boot_no_dist' };
-}
-
-/**
- * 判定当前 dist 是否 stale (相对当前 lockfile)。
- *
- * 依据: 依赖变动会更新 lockfile mtime; tsc --watch 编译完更新 buildinfo mtime。
- * lockfile mtime > buildinfo mtime → dist 是"依赖变动前"编译的 → stale。
- *
- * 边界:
- *  - lockfile 不存在 → 返回 false (无法判断, 保守认为不 stale, 保留 dist)
- *  - buildinfo 不存在 → 返回 true (dist 里没编译过 → 保守清)
- *  - `git checkout` 之类 touch lockfile 但内容没改 → 误判 stale 多清一次 (可接受, 安全方向)
- */
-function distIsStaleVsLockfile(projectRoot) {
-  const lockfiles = ['yarn.lock', 'package-lock.json', 'pnpm-lock.yaml'];
-  let lockMtime = 0;
-  for (const name of lockfiles) {
-    try {
-      lockMtime = Math.max(
-        lockMtime,
-        fs.statSync(path.join(projectRoot, name)).mtimeMs
-      );
-    } catch {
-      // lockfile 不存在,跳过
-    }
-  }
-  if (lockMtime === 0) return false;
-
-  try {
-    const buildinfoMtime = fs.statSync(
-      path.join(projectRoot, 'dist', 'tsconfig.node.tsbuildinfo')
-    ).mtimeMs;
-    return lockMtime > buildinfoMtime;
-  } catch {
-    return true;
-  }
-}
-
-function computeLockfileHash(projectRoot) {
-  const candidates = ['yarn.lock', 'package-lock.json', 'pnpm-lock.yaml'];
-  for (const name of candidates) {
-    const p = path.join(projectRoot, name);
-    if (fs.existsSync(p)) {
-      try {
-        const content = fs.readFileSync(p);
-        return crypto.createHash('sha1').update(content).digest('hex');
-      } catch {
-        return null;
-      }
-    }
-  }
-  return null;
-}
-
-function readMarkerHash(markerPath) {
-  try {
-    const raw = fs.readFileSync(markerPath, 'utf-8');
-    const data = JSON.parse(raw);
-    return typeof data.lockfileHash === 'string' ? data.lockfileHash : null;
-  } catch {
-    return null;
-  }
-}
-
-function writeMarker(markerPath, lockfileHash) {
-  try {
-    fs.writeFileSync(
-      markerPath,
-      JSON.stringify({ lockfileHash: lockfileHash || null }),
-      'utf-8'
-    );
-  } catch {
-    // marker 写失败下次会重试, 不阻塞 dev 启动
-  }
-}
-
-function defaultLogger(level, msg) {
-  // eslint-disable-next-line no-console
-  console.log(`[${level}] [main] ${msg}`);
-}
-
-module.exports = { preserveDevCache };