@lark-apaas/miaoda-cli 0.1.17 → 0.1.18-alpha.5fd4656

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

@@ -5,9 +5,11 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. skills sync —— 同步当前 stack 的 agent skills
-//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   4. 起单进程 dev server（design-stack 单进程，无 server/client 拆分）
+//   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 拆分），
+//      stdout/stderr 整体 tee 到 logs/dev.std.log
 //
 // 设计同 nestjs-react-fullstack/dev-local.js,SDK 包不需要自己 require('dotenv'),
 // env 加载收敛在启动脚本单点。SUDA_WEBUSER 适配同 nrf 那份。
@@ -26,7 +28,11 @@ 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/4) env pull...');
+// 先建 logs/,防止任何步骤(尤其是 spawn 子进程前的 shell redirect)因父目录不存在挂掉
+const LOG_DIR = process.env.LOG_DIR || 'logs';
+fs.mkdirSync(LOG_DIR, { recursive: true });
+
+console.log('[dev-local] (1/5) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -47,15 +53,23 @@ 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] (2/4) miaoda skills sync...');
+console.log('[dev-local] (3/5) 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] (3/4) loading .env / .env.local...');
+console.log('[dev-local] (4/5) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -75,10 +89,55 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-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));
+const devLogPath = path.join(LOG_DIR, 'dev.std.log');
+console.log('[dev-local] (5/5) npm run dev');
+console.log(`[dev-local] 日志: ${devLogPath}`);
+
+const logFd = fs.openSync(devLogPath, 'a');
+const child = spawn('npm', ['run', 'dev'], {
+  stdio: ['ignore', 'pipe', 'pipe'],
+  env: process.env,
+});
+
+const tee = (src) =>
+  src.on('data', (chunk) => {
+    try {
+      process.stdout.write(chunk);
+    } catch {
+      /* terminal gone */
+    }
+    try {
+      fs.writeSync(logFd, chunk);
+    } catch {
+      /* log fd closed */
+    }
+  });
+tee(child.stdout);
+tee(child.stderr);
+
+// 外部 SIGTERM/SIGHUP 转发给 npm,避免本进程死了 nest 变孤儿
+// (SIGINT 在 TTY 下 shell 直接发给整个前台进程组,不需要转发)
+const forward = (sig) => () => {
+  try {
+    child.kill(sig);
+  } catch {
+    /* already gone */
+  }
+};
+process.on('SIGTERM', forward('SIGTERM'));
+process.on('SIGHUP', forward('SIGHUP'));
+
+// 'close' 而非 'exit':等 child 的 stdio stream drain 完才触发,
+// 保证 tee 把最后一批 chunk 写进 logFd 再关闭,不丢尾。
+child.on('close', (code) => {
+  try {
+    fs.closeSync(logFd);
+  } catch {
+    /* already closed */
+  }
+  process.exit(code ?? 0);
+});
 child.on('error', (err) => {
-  console.error(err);
+  console.error('[dev-local] 启动失败:', err.message);
   process.exit(1);
 });

package/upgrade/templates/design-stack/templates/scripts/hooks/run-precommit.js

@@ -6,6 +6,10 @@ const { spawnSync } = require('node:child_process');
 
 const SEP = '  ' + '─'.repeat(36);
 
+// package-lock.json 锁内网镜像源 → 线上构建无法访问,改用公共镜像源。
+// 后续如有其它内网域名需要拦截,在这里加 pattern 即可。
+const INTERNAL_REGISTRY_PATTERNS = [/bnpm\.byted\.org/];
+
 function failAndExit(step, body) {
   process.stderr.write('\n✗ pre-commit failed: ' + step + '\n');
   process.stderr.write(SEP + '\n');
@@ -17,6 +21,37 @@ function failAndExit(step, body) {
   process.exit(1);
 }
 
+function checkLockfileRegistry() {
+  const res = spawnSync(
+    'git',
+    ['diff', '--cached', '--diff-filter=ACMR', '--', 'package-lock.json'],
+    { stdio: ['ignore', 'pipe', 'pipe'], env: process.env },
+  );
+  // git 不可用 / 不在 git 仓库 → 静默放行,交给 lint 步骤报错
+  if (res.error || res.status !== 0) return;
+  const diff = res.stdout ? res.stdout.toString() : '';
+  // 只看本次新增行(`+` 开头但排除 `+++` 文件头)
+  const hit = diff
+    .split('\n')
+    .some(
+      (line) =>
+        line.startsWith('+') &&
+        !line.startsWith('+++') &&
+        INTERNAL_REGISTRY_PATTERNS.some((p) => p.test(line)),
+    );
+  if (!hit) return;
+  failAndExit(
+    'package-lock.json 使用了内网镜像源',
+    [
+      '线上构建环境无法访问内网镜像源，将导致部署阶段 npm install 失败。',
+      '请使用公共镜像源重新生成 lockfile：',
+      '',
+      '  rm -rf node_modules package-lock.json',
+      '  npm install --registry=https://registry.npmmirror.com',
+    ].join('\n'),
+  );
+}
+
 function runLint() {
   const cwd = process.cwd();
   const res = spawnSync('npm', ['run', 'lint'], {
@@ -34,4 +69,5 @@ function runLint() {
   }
 }
 
+checkLockfileRegistry();
 runLint();

package/upgrade/templates/nestjs-react-fullstack/templates/.githooks/pre-commit

@@ -1,4 +1,5 @@
 #!/usr/bin/env sh
 [ "$SKIP_GIT_HOOKS" = "1" ] && exit 0
+
 export PATH="node_modules/.bin:$PATH"
 npm run precommit

package/upgrade/templates/nestjs-react-fullstack/templates/.spark_project

@@ -1,5 +1,5 @@
 run = ["npm", "run", "dev"] # 默认 spark-cli dev
-hidden = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]
+hidden = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", ".claude", "tmp", ".spark_project", ".playwright-cli"]
 lint = ["npm", "run", "lint"]
 test = ["npm", "run", "test"]
 genDbSchema = ["npm", "run", "gen:db-schema"]
@@ -13,4 +13,4 @@ run = ["npm", "run", "start"]
 [files.restrict]
 pathPatterns = ["client/src/api/gen", "package.json", ".spark_project", ".gitignore"]
 [files.hidden]
-pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]
+pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", ".claude", "tmp", ".spark_project", ".playwright-cli"]

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

@@ -5,9 +5,12 @@
 //
 // 流程:
 //   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. skills sync —— 同步当前 stack 的 agent skills
-//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   4. 并发起 dev:server + dev:client（子进程继承 process.env）
+//   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. concurrently 并发起 dev:server + dev:client,整体 stdout/stderr tee 到
+//      logs/dev.std.log;server / client 输出靠 concurrently 自带 [server]/[client]
+//      前缀区分,`grep '\[server\]' logs/dev.std.log` 拿单边日志
 //
 // 关键设计：本脚本在 spawn 子进程之前先把 .env / .env.local 加载到 process.env，
 // 然后 spawn 的 server / client 进程通过 env 继承直接拿到——SDK（fullstack-nestjs-core
@@ -33,8 +36,12 @@ function warn(msg) {
 if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '3';
 process.env.MIAODA_LOCAL_DEV = '1';
 
+// 先建 logs/,防止任何步骤(尤其是 spawn 子进程前的 shell redirect)因父目录不存在挂掉
+const LOG_DIR = process.env.LOG_DIR || 'logs';
+fs.mkdirSync(LOG_DIR, { recursive: true });
+
 // 1. env pull
-console.log('[dev-local] (1/4) env pull...');
+console.log('[dev-local] (1/5) env pull...');
 const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
 if (hasLarkCli) {
   let appId = '';
@@ -55,20 +62,28 @@ if (hasLarkCli) {
   warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
 }
 
-// 2. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
+// 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 软链),
 // 跟沙箱 nested layout 区分。不传 --version,handler 默认拉 coding-steering@latest,
 // 保证每次本地 npm run dev 都把 skills 升到最新。
-console.log('[dev-local] (2/4) miaoda skills sync...');
+console.log('[dev-local] (3/5) miaoda skills sync...');
 try {
   execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
 } catch {
   console.log('  (skills sync 失败，继续启动)');
 }
 
-// 3. 加载 .env / .env.local 到 process.env
+// 4. 加载 .env / .env.local 到 process.env
 // dotenv 默认 override:false，先到先得 → 先 .env.local 让它优先于 .env；
 // shell env 已在 process.env，两次 config 都不会覆盖。
-console.log('[dev-local] (3/4) loading .env / .env.local...');
+console.log('[dev-local] (4/5) loading .env / .env.local...');
 const dotenv = require('dotenv');
 dotenv.config({ path: '.env.local' });
 dotenv.config({ path: '.env' });
@@ -89,8 +104,12 @@ if (process.env.SUDA_WEBUSER) {
   }
 }
 
-// 4. 并发起前后端 dev server
-console.log('[dev-local] (4/4) 并发起 dev:server + dev:client');
+// 5. 并发起前后端 dev server,整体 tee 到 logs/dev.std.log
+const devLogPath = path.join(LOG_DIR, 'dev.std.log');
+console.log('[dev-local] (5/5) 并发起 dev:server + dev:client');
+console.log(`[dev-local] 日志: ${devLogPath}`);
+
+const logFd = fs.openSync(devLogPath, 'a');
 const child = spawn(
   'npx',
   [
@@ -104,10 +123,49 @@ const child = spawn(
     'npm run dev:server',
     'npm run dev:client',
   ],
-  { stdio: 'inherit', env: process.env },
+  { stdio: ['ignore', 'pipe', 'pipe'], env: process.env },
 );
-child.on('exit', (code) => process.exit(code ?? 0));
+
+const tee = (src) =>
+  src.on('data', (chunk) => {
+    try {
+      process.stdout.write(chunk);
+    } catch {
+      /* terminal gone */
+    }
+    try {
+      fs.writeSync(logFd, chunk);
+    } catch {
+      /* log fd closed */
+    }
+  });
+tee(child.stdout);
+tee(child.stderr);
+
+// 外部 SIGTERM/SIGHUP 转发给 concurrently,避免本进程死了 server/client 变孤儿
+// (SIGINT 在 TTY 下 shell 直接发给整个前台进程组,不需要转发)
+const forward = (sig) => () => {
+  try {
+    child.kill(sig);
+  } catch {
+    /* already gone */
+  }
+};
+process.on('SIGTERM', forward('SIGTERM'));
+process.on('SIGHUP', forward('SIGHUP'));
+
+// 'close' 而非 'exit':等 child 的 stdio stream drain 完才触发,
+// 保证 tee 把最后一批 chunk 写进 logFd 再关闭,不丢尾。
+child.on('close', (code) => {
+  try {
+    fs.closeSync(logFd);
+  } catch {
+    /* already closed */
+  }
+  process.exit(code ?? 0);
+});
 child.on('error', (err) => {
-  console.error(err);
+  console.error('[dev-local] 启动失败:', err.message);
+  console.error('[dev-local] 如缺 concurrently,运行: npm install');
   process.exit(1);
 });

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/hooks/run-precommit.js

@@ -6,6 +6,10 @@ const { spawnSync } = require('node:child_process');
 
 const SEP = '  ' + '─'.repeat(36);
 
+// package-lock.json 锁内网镜像源 → 线上构建无法访问,改用公共镜像源。
+// 后续如有其它内网域名需要拦截,在这里加 pattern 即可。
+const INTERNAL_REGISTRY_PATTERNS = [/bnpm\.byted\.org/];
+
 function failAndExit(step, body) {
   process.stderr.write('\n✗ pre-commit failed: ' + step + '\n');
   process.stderr.write(SEP + '\n');
@@ -17,6 +21,37 @@ function failAndExit(step, body) {
   process.exit(1);
 }
 
+function checkLockfileRegistry() {
+  const res = spawnSync(
+    'git',
+    ['diff', '--cached', '--diff-filter=ACMR', '--', 'package-lock.json'],
+    { stdio: ['ignore', 'pipe', 'pipe'], env: process.env },
+  );
+  // git 不可用 / 不在 git 仓库 → 静默放行,交给 lint 步骤报错
+  if (res.error || res.status !== 0) return;
+  const diff = res.stdout ? res.stdout.toString() : '';
+  // 只看本次新增行(`+` 开头但排除 `+++` 文件头)
+  const hit = diff
+    .split('\n')
+    .some(
+      (line) =>
+        line.startsWith('+') &&
+        !line.startsWith('+++') &&
+        INTERNAL_REGISTRY_PATTERNS.some((p) => p.test(line)),
+    );
+  if (!hit) return;
+  failAndExit(
+    'package-lock.json 使用了内网镜像源',
+    [
+      '线上构建环境无法访问内网镜像源，将导致部署阶段 npm install 失败。',
+      '请使用公共镜像源重新生成 lockfile：',
+      '',
+      '  rm -rf node_modules package-lock.json',
+      '  npm install --registry=https://registry.npmmirror.com',
+    ].join('\n'),
+  );
+}
+
 function runLint() {
   const cwd = process.cwd();
   const res = spawnSync('npm', ['run', 'lint'], {
@@ -34,4 +69,5 @@ function runLint() {
   }
 }
 
+checkLockfileRegistry();
 runLint();