@lark-apaas/fullstack-cli 1.1.59-alpha.20260818125424 → 1.1.59-beta.0

package/dist/index.js

@@ -7698,7 +7698,7 @@ function sanitizeStructuredLog(value) {
   delete sanitized.pid;
   return sanitized;
 }
-var TRANSIENT_CONNECTION_ERROR_PATTERN = /ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENETUNREACH|proxy error|\[Proxy\] (?:Error:\s*$|Error during|Connection error|Non-connection error|Headers already sent|Service (?:recovered|did not recover))/i;
+var TRANSIENT_CONNECTION_ERROR_PATTERN = /ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENETUNREACH|socket hang up|proxy error|\[Proxy\] (?:Error:\s*$|Error during|Connection error|Non-connection error|Headers already sent|Service (?:recovered|did not recover))/i;
 function hasErrorInStdLines(lines) {
   const filtered = lines.filter((line) => !TRANSIENT_CONNECTION_ERROR_PATTERN.test(line));
   const combined = filtered.join("\n");

package/package.json

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

package/templates/scripts/dev.js

@@ -252,24 +252,20 @@ process.on('SIGTERM', cleanup);
 process.on('SIGINT', cleanup);
 process.on('SIGHUP', cleanup);
 
-// Track A / P0 #5 保守版实现: 不再无脑 rm -rf dist/, 改成定向保留可复用产物 + 只清
-// 「build:client 污染的部分」。收益: nest --watch 增量编译起点 (8-13s) + routes JSON。
-//
-// 逻辑抽到 lib/preserve-dev-cache.js 便于单测; 见该文件头部注释。
-// 与 fullstack-vite-preset/html-output-plugin.ts 的 injectHtmlModeMarker 配套:
-// preset 写盘时打 marker, 这里按 marker 决定要不要保留 dist/client。
-//
-// Escape hatch: FORCE_CLEAN_DIST=true 走 lib 里的全清路径,
-// preserveDevCache 逻辑有 bug 或 nest --watch 因保留的 dist/server 出 stale 时降级用。
-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/scripts/lint.js

@@ -76,13 +76,34 @@ function isStylelintTarget(filePath) {
   return filePath.endsWith('.css');
 }
 
+const STYLELINT_CONFIG_FILES = [
+  '.stylelintrc',
+  '.stylelintrc.js',
+  '.stylelintrc.cjs',
+  '.stylelintrc.json',
+  'stylelint.config.js',
+];
+
+/**
+ * 老模板（fullstack-nestjs-template 1.x 时代）的应用没有 stylelint 配置，跑 stylelint 会以
+ * "ConfigurationError: No configuration provided" 挂掉、把 pre-commit 卡死。没配置就跳过。
+ */
+function hasStylelintConfig() {
+  return STYLELINT_CONFIG_FILES.some(file => fs.existsSync(path.join(cwd, file)));
+}
+
 async function runDefaultLint() {
   const taskSpecs = [
     [getBinName('npm'), ['run', 'eslint']],
     [getBinName('npm'), ['run', 'type:check']],
-    [getBinName('npm'), ['run', 'stylelint']],
   ];
 
+  if (hasStylelintConfig()) {
+    taskSpecs.push([getBinName('npm'), ['run', 'stylelint']]);
+  } else {
+    console.warn('[lint] Skip stylelint: no stylelint config found');
+  }
+
   process.exit(await runTasksSerially(taskSpecs));
 }
 
@@ -120,7 +141,9 @@ async function runSelectiveLint(inputFiles) {
     taskSpecs.push([getBinName('npx'), ['eslint', '--quiet', ...eslintFiles]]);
   }
 
-  if (stylelintFiles.length > 0) {
+  if (stylelintFiles.length > 0 && !hasStylelintConfig()) {
+    console.warn('[lint] Skip stylelint: no stylelint config found');
+  } else if (stylelintFiles.length > 0) {
     taskSpecs.push([getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]]);
   }
 

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

@@ -1,168 +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, detectHtmlMode } = require('../preserve-dev-cache.cjs');
-
-interface LogEntry {
-  level: string;
-  msg: string;
-}
-
-function makeLogger(entries: LogEntry[]) {
-  return (level: string, msg: string) => {
-    entries.push({ level, msg });
-  };
-}
-
-const DEV_HTML =
-  '<html><head><meta name="miaoda-html-mode" content="dev"><title>x</title></head><body></body></html>';
-const PROD_HTML =
-  '<html><head><meta name="miaoda-html-mode" content="prod"><title>x</title></head><body></body></html>';
-const UNMARKED_HTML = '<html><head><title>x</title></head><body></body></html>';
-
-describe('detectHtmlMode', () => {
-  it('reads dev marker', () => {
-    expect(detectHtmlMode(DEV_HTML)).toBe('dev');
-  });
-
-  it('reads prod marker', () => {
-    expect(detectHtmlMode(PROD_HTML)).toBe('prod');
-  });
-
-  it('returns unknown when no marker', () => {
-    expect(detectHtmlMode(UNMARKED_HTML)).toBe('unknown');
-  });
-});
-
-describe('preserveDevCache', () => {
-  let tmpRoot: string;
-  let logs: LogEntry[];
-
-  function setupDist(
-    files: Record<string, string | null> = {}
-  ): { distPath: string; clientDir: string; serverDir: string } {
-    const distPath = path.join(tmpRoot, 'dist');
-    const clientDir = path.join(distPath, 'client');
-    const serverDir = path.join(distPath, 'server');
-    fs.mkdirSync(clientDir, { recursive: true });
-    fs.mkdirSync(serverDir, { recursive: true });
-    // 默认放个 nest 编译产物 + routes JSON, 用来验证保留策略
-    fs.writeFileSync(path.join(serverDir, 'main.js'), '/* nest bundle */');
-    fs.writeFileSync(
-      path.join(distPath, 'api-routes.json'),
-      JSON.stringify([])
-    );
-    for (const [rel, content] of Object.entries(files)) {
-      if (content === null) continue;
-      const abs = path.join(distPath, rel);
-      fs.mkdirSync(path.dirname(abs), { recursive: true });
-      fs.writeFileSync(abs, content);
-    }
-    return { distPath, clientDir, serverDir };
-  }
-
-  beforeEach(() => {
-    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'preserve-dev-cache-'));
-    logs = [];
-    delete process.env.FORCE_CLEAN_DIST;
-  });
-
-  afterEach(() => {
-    fs.rmSync(tmpRoot, { recursive: true, force: true });
-    delete process.env.FORCE_CLEAN_DIST;
-  });
-
-  it('no-op when dist/ does not exist', () => {
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('no_dist');
-    expect(fs.existsSync(path.join(tmpRoot, 'dist'))).toBe(false);
-    expect(logs[0].msg).toMatch(/no dist/);
-  });
-
-  it('preserves entire dist/client when index.html has dev marker', () => {
-    const { clientDir, serverDir } = setupDist({
-      'client/index.html': DEV_HTML,
-      'client/assets/foo.js': '/* dev asset */',
-    });
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('preserved');
-    expect(result.mode).toBe('dev');
-    expect(fs.existsSync(path.join(clientDir, 'index.html'))).toBe(true);
-    expect(fs.existsSync(path.join(clientDir, 'assets', 'foo.js'))).toBe(true);
-    expect(fs.existsSync(path.join(serverDir, 'main.js'))).toBe(true);
-  });
-
-  it('cleans index.html + assets/ but preserves server/ when marker=prod', () => {
-    const { distPath, clientDir, serverDir } = setupDist({
-      'client/index.html': PROD_HTML,
-      'client/assets/index-abc.js': '/* build product */',
-      'client/assets/index-def.css': '/* build product */',
-    });
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('cleaned_polluted');
-    expect(result.mode).toBe('prod');
-    expect(fs.existsSync(path.join(clientDir, 'index.html'))).toBe(false);
-    expect(fs.existsSync(path.join(clientDir, 'assets'))).toBe(false);
-    // dist/server + routes JSON 保留
-    expect(fs.existsSync(path.join(serverDir, 'main.js'))).toBe(true);
-    expect(fs.existsSync(path.join(distPath, 'api-routes.json'))).toBe(true);
-  });
-
-  it('cleans same way when marker is missing (treats as pollution)', () => {
-    const { clientDir, serverDir } = setupDist({
-      'client/index.html': UNMARKED_HTML,
-      'client/assets/foo.js': '/* whatever */',
-    });
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('cleaned_polluted');
-    expect(result.mode).toBe('unknown');
-    expect(fs.existsSync(path.join(clientDir, 'index.html'))).toBe(false);
-    expect(fs.existsSync(path.join(clientDir, 'assets'))).toBe(false);
-    expect(fs.existsSync(path.join(serverDir, 'main.js'))).toBe(true);
-  });
-
-  it('no-op when dist/client/index.html is missing (nest --watch has partial dist)', () => {
-    const { distPath, serverDir } = setupDist();
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('no_index');
-    expect(fs.existsSync(distPath)).toBe(true);
-    expect(fs.existsSync(path.join(serverDir, 'main.js'))).toBe(true);
-  });
-
-  it('FORCE_CLEAN_DIST=true wipes entire dist regardless of marker', () => {
-    const { distPath } = setupDist({
-      'client/index.html': DEV_HTML,
-      'client/assets/foo.js': 'x',
-    });
-    const result = preserveDevCache(tmpRoot, {
-      log: makeLogger(logs),
-      forceClean: true,
-    });
-    expect(result.action).toBe('force_cleaned');
-    expect(fs.existsSync(distPath)).toBe(false);
-  });
-
-  it('FORCE_CLEAN_DIST env var enables force clean path', () => {
-    process.env.FORCE_CLEAN_DIST = 'true';
-    const { distPath } = setupDist({
-      'client/index.html': DEV_HTML,
-    });
-    const result = preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    expect(result.action).toBe('force_cleaned');
-    expect(fs.existsSync(distPath)).toBe(false);
-  });
-
-  it('emits INFO log with mode and action', () => {
-    setupDist({
-      'client/index.html': PROD_HTML,
-      'client/assets/foo.js': 'x',
-    });
-    preserveDevCache(tmpRoot, { log: makeLogger(logs) });
-    const msgs = logs.map((l) => l.msg).join('\n');
-    expect(msgs).toContain('prod');
-    expect(msgs).toContain('cleaned');
-  });
-});

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

@@ -1,122 +0,0 @@
-'use strict';
-
-// Track A / P0 #5 保守版实现所在。跟 fullstack-vite-preset/html-output-plugin.ts
-// 的 detectHtmlMode / injectHtmlModeMarker 是配套的一对: preset 写盘时打 marker,
-// dev.js 启动时按 marker 决定要不要保留 dist/client。
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 从 HTML 里回读 <meta name="miaoda-html-mode" content="dev|prod"> marker。
- * 与 packages/tools/fullstack-vite-preset/src/vite-plugins/html-output-plugin.ts
- * 的 detectHtmlMode 同源, 为了让 dev.js 模板脚本零依赖跑起来这里重复一份。
- */
-function detectHtmlMode(htmlContent) {
-  const match = htmlContent.match(
-    /<meta\s+name=["']miaoda-html-mode["']\s+content=["'](dev|prod)["'][^>]*>/i
-  );
-  return (match && match[1]) || 'unknown';
-}
-
-/**
- * 定向清理 dist/ 的可复用副本, 替代 dev.js 之前无脑 `rm -rf dist/` 的 cleanStaleDist。
- *
- * 决策规则:
- *  - FORCE_CLEAN_DIST=true → 走 escape hatch 全清 (preserveDevCache 逻辑 / 保留的
- *    dist/server 出 stale 时兜底)
- *  - dist/ 不存在 → 无动作
- *  - dist/client/index.html 存在且 marker=dev → 整个 dist/client/ 保留 (dev cache hit)
- *  - 存在但 marker=prod 或缺失 → 只清 dist/client/index.html + dist/client/assets/
- *    (build 污染部分), dist/server/ 与 routes JSON 保留
- *  - 不存在 → 无动作, htmlOutputPlugin 稍后会写入
- *
- * @param {string} projectRoot 项目根目录
- * @param {object} [options]
- * @param {(level: string, msg: string) => void} [options.log] 日志回调, 默认 console.log
- * @param {boolean} [options.forceClean] 覆盖 FORCE_CLEAN_DIST env var 判断 (给测试用)
- * @returns {{ action: 'no_dist' | 'force_cleaned' | 'no_index' | 'preserved' | 'cleaned_polluted' | 'read_failed_cleaned' | 'cleanup_failed', mode: string }}
- */
-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 distPath = path.join(projectRoot, 'dist');
-  if (!fs.existsSync(distPath)) {
-    log('INFO', 'preserveDevCache: no dist/, will be created by vite/nest');
-    return { action: 'no_dist', mode: 'unknown' };
-  }
-
-  if (forceClean) {
-    fs.rmSync(distPath, { recursive: true, force: true });
-    log(
-      'INFO',
-      'preserveDevCache: FORCE_CLEAN_DIST=true, cleaned entire dist/'
-    );
-    return { action: 'force_cleaned', mode: 'unknown' };
-  }
-
-  const clientDir = path.join(distPath, 'client');
-  const indexHtml = path.join(clientDir, 'index.html');
-
-  if (!fs.existsSync(indexHtml)) {
-    log(
-      'INFO',
-      'preserveDevCache: no dist/client/index.html, other artifacts preserved'
-    );
-    return { action: 'no_index', mode: 'unknown' };
-  }
-
-  let mode = 'unknown';
-  let readFailed = false;
-  try {
-    const content = fs.readFileSync(indexHtml, 'utf-8');
-    mode = detectHtmlMode(content);
-  } catch (e) {
-    log(
-      'WARN',
-      `preserveDevCache: read dist/client/index.html failed: ${e.message}, treating as polluted`
-    );
-    readFailed = true;
-    mode = 'unknown';
-  }
-
-  if (mode === 'dev') {
-    log('INFO', 'preserveDevCache: dist/client preserved (dev cache hit)');
-    return { action: 'preserved', mode: 'dev' };
-  }
-
-  // marker=prod 或 unknown → build:client 污染 (或人为放的产物), 定向清 index.html + assets/
-  // dist/server/, dist/*.json 保留
-  try {
-    fs.rmSync(indexHtml, { force: true });
-    const assetsDir = path.join(clientDir, 'assets');
-    if (fs.existsSync(assetsDir)) {
-      fs.rmSync(assetsDir, { recursive: true, force: true });
-    }
-    log(
-      'INFO',
-      `preserveDevCache: dist/client/index.html was ${mode}, cleaned index.html + assets/ (dist/server preserved)`
-    );
-    return {
-      action: readFailed ? 'read_failed_cleaned' : 'cleaned_polluted',
-      mode,
-    };
-  } catch (e) {
-    log(
-      'WARN',
-      `preserveDevCache: cleanup failed: ${e.message}, continuing anyway (index.html / assets may still be polluted)`
-    );
-    return { action: 'cleanup_failed', mode };
-  }
-}
-
-function defaultLogger(level, msg) {
-  // eslint-disable-next-line no-console
-  console.log(`[${level}] [main] ${msg}`);
-}
-
-module.exports = { detectHtmlMode, preserveDevCache };