adspecs 0.1.19 → 0.1.21

package/src/lib/prompts.js

@@ -1,347 +1,428 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { input, select, confirm } = require('@inquirer/prompts');
-const { hasAnyFile, isEmptyDirectoryTree } = require('./dir-utils');
-const { areaDisplayName } = require('./area-scanner');
-
-/**
- * 交互式提示封装
- *
- * 处理三种模式：
- * - 交互模式（默认）：通过 inquirer 提示用户输入
- * - 非交互模式（--non-interactive）：所有未提供的参数使用默认值
- * - 强制模式（--force）：所有已存在区域直接 recreate
- */
-
-// ============================================================
-// 项目信息收集
-// ============================================================
-
-/**
- * 收集项目信息（5 个字段）
- *
- * @param {object} options - CLI 传入的选项
- * @returns {Promise<object>} 完整的项目信息对象
- */
-async function collectProjectInfo(options) {
-  const nonInteractive = options.nonInteractive || false;
-
-  // === 第一次收集：核心信息 ===
-  const projectName =
-    options.projectName ||
-    (nonInteractive ? 'my-project' : await input({ message: '请输入项目名称：' }));
-
-  const projectDir =
-    options.projectDir ??
-    (nonInteractive
-      ? ''
-      : await input({ message: '请输入项目目录名（留空=当前目录）：', default: '' }));
-
-  // === 初始化模式 ===
-  const mode =
-    options.mode ||
-    (nonInteractive
-      ? 'simple'
-      : await select({
-        message: '请选择初始化模式：',
-        choices: [
-          { name: '简易模式 — 仅文档目录 (docs + wiki)', value: 'simple' },
-          { name: '经典模式 — 文档 + 前端演示 (+ front-demo)', value: 'classic' },
-          { name: '完整模式 — 所有目录 (+ web-ui + service)', value: 'full' },
-          { name: '轻量模式 — Python+React 全栈 demo', value: 'demo' },
-        ],
-      }));
-
-  // === 前端技术栈（仅 classic/full 模式需要选择） ===
-  let frontDemo = options.frontDemo;
-  if ((mode === 'classic' || mode === 'full') && !frontDemo && !nonInteractive) {
-    frontDemo = await select({
-      message: '请选择前端演示技术栈：',
-      choices: [
-        { name: 'Vue（Vue 3 + Vite + TypeScript + Element Plus）', value: 'vue' },
-        { name: 'Ant Design React（React + Ant Design 6）', value: 'antd' },
-        { name: '跳过 — 不创建前端演示项目', value: 'skip' },
-      ],
-    });
-  }
-  if (mode === 'demo') {
-    frontDemo = 'antd'; // 轻量模式固定 Ant Design React
-  }
-  // 兜底默认：非交互模式 / simple 模式 / 用户未选时 → vue
-  frontDemo = frontDemo || 'vue';
-
-  // === 第二次收集：补充信息 ===
-  const companyName =
-    options.company ||
-    (nonInteractive
-      ? 'XX有限公司'
-      : await input({
-        message: '请输入公司名称（不填默认"XX有限公司"）：',
-        default: 'XX有限公司',
-      }));
-
-  const confidentiality =
-    options.confidentiality && options.confidentiality !== '内部资料'
-      ? options.confidentiality
-      : nonInteractive
-        ? '内部资料'
-        : await select({
-          message: '请选择文件密级（不选默认"内部资料"）：',
-          choices: [
-            { name: '内部资料（默认） — 仅限公司内部使用', value: '内部资料' },
-            { name: '公开 — 可对外公开', value: '公开' },
-            { name: '机密 — 限授权人员访问', value: '机密' },
-            { name: '绝密 — 最高保密等级', value: '绝密' },
-          ],
-        });
-
-  return {
-    project_name: projectName,
-    project_dir: projectDir,
-    company_name: companyName,
-    confidentiality,
-    mode,
-    frontDemo,
-    modules: options.modules || '3100-crm-mdm:mdm,3103-crm-contract:contract',
-  };
-}
-
-// ============================================================
-// 冲突决策（每区域 3 选项）
-// ============================================================
-
-/**
- * 收集每区域的冲突决策
- *
- * @param {object} areaStates - 区域状态映射（来自 scanAreaStates）
- * @param {object} options - CLI 选项
- * @returns {Promise<object>} 决策映射 { areaKey: 'create'|'recreate'|'update'|'skip' }
- */
-async function collectDecisions(areaStates, options) {
-  const force = options.force || false;
-  const nonInteractive = options.nonInteractive || false;
-
-  // --force：所有已存在区域直接 recreate
-  if (force) {
-    const decisions = {};
-    for (const [key, state] of Object.entries(areaStates)) {
-      decisions[key] = state.exists ? 'recreate' : 'create';
-    }
-    return decisions;
-  }
-
-  // --non-interactive：所有已存在区域 skip（保留现有）
-  if (nonInteractive) {
-    const decisions = {};
-    for (const [key, state] of Object.entries(areaStates)) {
-      decisions[key] = state.exists ? 'skip' : 'create';
-    }
-    return decisions;
-  }
-
-  // 交互模式：对每个已存在区域调用 3 选项 prompt
-  const decisions = {};
-  const existingAreas = Object.entries(areaStates).filter(([, state]) => state.exists);
-
-  if (existingAreas.length === 0) {
-    // 所有区域都不存在 → 全部 create
-    for (const key of Object.keys(areaStates)) {
-      decisions[key] = 'create';
-    }
-    return decisions;
-  }
-
-  // 提示用户是否要逐个确认
-  if (existingAreas.length >= 2) {
-    const bulkChoice = await select({
-      message: `检测到 ${existingAreas.length} 个区域已存在，如何统一处理？`,
-      choices: [
-        { name: '逐个确认 — 对每个区域分别选择处理方式', value: 'ask-each' },
-        { name: '全部重新创建 — 删除并重建所有已存在区域', value: 'recreate-all' },
-        { name: '全部跳过 — 保留所有已存在区域', value: 'skip-all' },
-      ],
-    });
-
-    if (bulkChoice === 'recreate-all') {
-      for (const [key, state] of Object.entries(areaStates)) {
-        decisions[key] = state.exists ? 'recreate' : 'create';
-      }
-      return decisions;
-    }
-    if (bulkChoice === 'skip-all') {
-      for (const [key, state] of Object.entries(areaStates)) {
-        decisions[key] = state.exists ? 'skip' : 'create';
-      }
-      return decisions;
-    }
-    // ask-each: 继续逐个询问
-  }
-
-  // 逐个询问
-  for (const [key, state] of Object.entries(areaStates)) {
-    if (!state.exists) {
-      decisions[key] = 'create';
-    } else {
-      decisions[key] = await askAreaDecision(areaDisplayName(key));
-    }
-  }
-
-  return decisions;
-}
-
-/**
- * 3 选项冲突决策
- *
- * @param {string} areaName - 区域显示名（如 'docs'）
- * @returns {Promise<'recreate'|'update'|'skip'>}
- */
-async function askAreaDecision(areaName) {
-  return await select({
-    message: `${areaName}/ 已存在，如何处理？`,
-    choices: [
-      { name: '重新创建 — 删除现有目录，使用最新模板重建', value: 'recreate' },
-      { name: '更新 — 保留现有目录，按新内容覆盖（保留本地修改之外的文件）', value: 'update' },
-      { name: '跳过 — 保留现有目录，不做任何修改', value: 'skip' },
-    ],
-  });
-}
-
-// ============================================================
-// 子目录决策
-// ============================================================
-
-/**
- * 收集子目录决策（仅当父目录 skip 时）
- *
- * @param {object} decisions - 区域决策
- * @param {string} targetDir - 目标目录
- * @param {object} options - CLI 选项
- * @returns {Promise<object>} 子决策 { conventions, templates }
- */
-async function collectSubDecisions(decisions, targetDir, options) {
-  const sub = { conventions: 'skip', templates: 'skip' };
-  const nonInteractive = options.nonInteractive || false;
-  const force = options.force || false;
-
-  // --force 模式：全部 skip（因为 recreate 已经完整重建了）
-  if (force) return sub;
-
-  // --non-interactive 模式：全部 skip
-  if (nonInteractive) return sub;
-
-  // conventions_decision：docs/ skip 且 40-project_conventions/ 有文件
-  if (decisions.docs === 'skip') {
-    const convDir = path.join(targetDir, 'docs/40-project_conventions');
-    if (fs.existsSync(convDir) && hasAnyFile(convDir)) {
-      sub.conventions = await askSubDecision('docs/40-project_conventions');
-    }
-  }
-
-  // templates_decision：.adspecs/ skip 且 templates/ 有文件
-  if (decisions.adspecs === 'skip') {
-    const tmplDir = path.join(targetDir, '.adspecs/templates');
-    if (fs.existsSync(tmplDir) && hasAnyFile(tmplDir)) {
-      sub.templates = await askSubDecision('.adspecs/templates');
-    }
-  }
-
-  return sub;
-}
-
-/**
- * 子目录更新决策（2 选项）
- *
- * @param {string} subDirName - 子目录显示名
- * @returns {Promise<'update'|'skip'>}
- */
-async function askSubDecision(subDirName) {
-  return await select({
-    message: `${subDirName}/ 目录已存在且包含文件，是否使用最新规范文件更新？`,
-    choices: [
-      { name: '更新 — 使用最新文件覆盖现有内容', value: 'update' },
-      { name: '跳过 — 保留现有内容，不做任何修改', value: 'skip' },
-    ],
-  });
-}
-
-// ============================================================
-// 模式升级检测
-// ============================================================
-
-/**
- * 检测模式升级场景（simple → classic/full/demo）
- *
- * 当 docs/ 已存在且 skip，且当前模式为 classic/full/demo，
- * 检查 40-project_conventions/frontend-standard/ 是否为空（简易模式产物特征）。
- * 如果是，则需要自动补充 frontend-standard/ 文件。
- *
- * 简易模式会在 40-project_conventions/ 下生成 README.md 并创建空子目录
- * frontend-standard/ 和 end-standard/，因此不能检查整个 40 目录，而要检查
- * frontend-standard/ 子目录是否为空。
- *
- * @param {object} decisions - 区域决策
- * @param {string} mode - 当前模式
- * @param {string} targetDir - 目标目录
- * @returns {object} { detected, emptyDirs }
- */
-function detectModeUpgrade(decisions, mode, targetDir) {
-  // 仅 classic/full/demo 模式需要检测
-  if (mode === 'simple') {
-    return { detected: false, emptyDirs: [] };
-  }
-
-  // 仅当 docs/ 为 skip 时才有意义
-  if (decisions.docs !== 'skip') {
-    return { detected: false, emptyDirs: [] };
-  }
-
-  const frontendStdDir = path.join(targetDir, 'docs/40-project_conventions/frontend-standard');
-  if (!fs.existsSync(frontendStdDir)) {
-    return { detected: false, emptyDirs: [] };
-  }
-
-  // 检查 frontend-standard/ 是否为空（无任何文件）
-  // 注意：不使用 isEmptyDirectoryTree，因为我们要检查的是这个特定子目录
-  if (!hasAnyFile(frontendStdDir)) {
-    return {
-      detected: true,
-      emptyDirs: ['40-project_conventions/frontend-standard/'],
-    };
-  }
-
-  return { detected: false, emptyDirs: [] };
-}
-
-// ============================================================
-// 执行前确认
-// ============================================================
-
-/**
- * 执行前确认
- *
- * @param {object} options - CLI 选项
- * @returns {Promise<boolean>}
- */
-async function confirmExecution(options) {
-  // --force / --non-interactive / --yes 自动确认
-  if (options.force || options.nonInteractive || options.yes) {
-    return true;
-  }
-
-  return await confirm({
-    message: '是否继续执行以上计划？',
-    default: true,
-  });
-}
-
-module.exports = {
-  collectProjectInfo,
-  collectDecisions,
-  collectSubDecisions,
-  detectModeUpgrade,
-  confirmExecution,
-  askAreaDecision,
-  askSubDecision,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { input, select, confirm } = require('@inquirer/prompts');
+const { hasAnyFile, isEmptyDirectoryTree, listFiles } = require('./dir-utils');
+const { areaDisplayName } = require('./area-scanner');
+
+/**
+ * 交互式提示封装
+ *
+ * 处理三种模式：
+ * - 交互模式（默认）：通过 inquirer 提示用户输入
+ * - 非交互模式（--non-interactive）：所有未提供的参数使用默认值
+ * - 强制模式（--force）：所有已存在区域直接 recreate
+ */
+
+// ============================================================
+// 项目信息收集
+// ============================================================
+
+/**
+ * 收集项目信息（5 个字段）
+ *
+ * @param {object} options - CLI 传入的选项
+ * @returns {Promise<object>} 完整的项目信息对象
+ */
+async function collectProjectInfo(options) {
+  const nonInteractive = options.nonInteractive || false;
+
+  // === 第一次收集：核心信息 ===
+  const projectName =
+    options.projectName ||
+    (nonInteractive ? 'my-project' : await input({ message: '请输入项目名称：' }));
+
+  const projectDir =
+    options.projectDir ??
+    (nonInteractive
+      ? ''
+      : await input({ message: '请输入项目目录名（留空=当前目录）：', default: '' }));
+
+  // === 初始化模式 ===
+  const mode =
+    options.mode ||
+    (nonInteractive
+      ? 'simple'
+      : await select({
+        message: '请选择初始化模式：',
+        choices: [
+          { name: '简易模式 — 仅文档目录 (docs + wiki)', value: 'simple' },
+          { name: '经典模式 — 文档 + 前端演示 (+ front-demo)', value: 'classic' },
+          { name: '完整模式 — 所有目录 (+ web-ui + service)', value: 'full' },
+          { name: '轻量模式 — Python+React 全栈 demo', value: 'demo' },
+        ],
+      }));
+
+  // === 前端技术栈（仅 classic/full 模式需要选择） ===
+  let frontDemo = options.frontDemo;
+  if ((mode === 'classic' || mode === 'full') && !frontDemo && !nonInteractive) {
+    frontDemo = await select({
+      message: '请选择前端演示技术栈：',
+      choices: [
+        { name: 'Vue（Vue 3 + Vite + TypeScript + Element Plus）', value: 'vue' },
+        { name: 'Ant Design React（React + Ant Design 6）', value: 'antd' },
+        { name: '跳过 — 不创建前端演示项目', value: 'skip' },
+      ],
+    });
+  }
+  if (mode === 'demo') {
+    frontDemo = 'antd'; // 轻量模式固定 Ant Design React
+  }
+  // 兜底默认：非交互模式 / simple 模式 / 用户未选时 → vue
+  frontDemo = frontDemo || 'vue';
+
+  // === 第二次收集：补充信息 ===
+  const companyName =
+    options.company ||
+    (nonInteractive
+      ? 'XX有限公司'
+      : await input({
+        message: '请输入公司名称（不填默认"XX有限公司"）：',
+        default: 'XX有限公司',
+      }));
+
+  const confidentiality =
+    options.confidentiality && options.confidentiality !== '内部资料'
+      ? options.confidentiality
+      : nonInteractive
+        ? '内部资料'
+        : await select({
+          message: '请选择文件密级（不选默认"内部资料"）：',
+          choices: [
+            { name: '内部资料（默认） — 仅限公司内部使用', value: '内部资料' },
+            { name: '公开 — 可对外公开', value: '公开' },
+            { name: '机密 — 限授权人员访问', value: '机密' },
+            { name: '绝密 — 最高保密等级', value: '绝密' },
+          ],
+        });
+
+  return {
+    project_name: projectName,
+    project_dir: projectDir,
+    company_name: companyName,
+    confidentiality,
+    mode,
+    frontDemo,
+    modules: options.modules || '3100-crm-mdm:mdm,3103-crm-contract:contract',
+  };
+}
+
+// ============================================================
+// 冲突决策（每区域 3 选项）
+// ============================================================
+
+/**
+ * 收集每区域的冲突决策
+ *
+ * @param {object} areaStates - 区域状态映射（来自 scanAreaStates）
+ * @param {object} options - CLI 选项
+ * @returns {Promise<object>} 决策映射 { areaKey: 'create'|'recreate'|'update'|'skip' }
+ */
+async function collectDecisions(areaStates, options) {
+  const force = options.force || false;
+  const nonInteractive = options.nonInteractive || false;
+
+  // --force：所有已存在区域直接 recreate
+  if (force) {
+    const decisions = {};
+    for (const [key, state] of Object.entries(areaStates)) {
+      decisions[key] = state.exists ? 'recreate' : 'create';
+    }
+    return decisions;
+  }
+
+  // --non-interactive：所有已存在区域 skip（保留现有）
+  if (nonInteractive) {
+    const decisions = {};
+    for (const [key, state] of Object.entries(areaStates)) {
+      decisions[key] = state.exists ? 'skip' : 'create';
+    }
+    return decisions;
+  }
+
+  // 交互模式：对每个已存在区域调用 3 选项 prompt
+  const decisions = {};
+  const existingAreas = Object.entries(areaStates).filter(([, state]) => state.exists);
+
+  if (existingAreas.length === 0) {
+    // 所有区域都不存在 → 全部 create
+    for (const key of Object.keys(areaStates)) {
+      decisions[key] = 'create';
+    }
+    return decisions;
+  }
+
+  // 提示用户是否要逐个确认
+  if (existingAreas.length >= 2) {
+    const bulkChoice = await select({
+      message: `检测到 ${existingAreas.length} 个区域已存在，如何统一处理？`,
+      choices: [
+        { name: '逐个确认 — 对每个区域分别选择处理方式', value: 'ask-each' },
+        { name: '全部重新创建 — 删除并重建所有已存在区域', value: 'recreate-all' },
+        { name: '全部跳过 — 保留所有已存在区域', value: 'skip-all' },
+      ],
+    });
+
+    if (bulkChoice === 'recreate-all') {
+      for (const [key, state] of Object.entries(areaStates)) {
+        decisions[key] = state.exists ? 'recreate' : 'create';
+      }
+      return decisions;
+    }
+    if (bulkChoice === 'skip-all') {
+      for (const [key, state] of Object.entries(areaStates)) {
+        decisions[key] = state.exists ? 'skip' : 'create';
+      }
+      return decisions;
+    }
+    // ask-each: 继续逐个询问
+  }
+
+  // 逐个询问
+  for (const [key, state] of Object.entries(areaStates)) {
+    if (!state.exists) {
+      decisions[key] = 'create';
+    } else {
+      decisions[key] = await askAreaDecision(areaDisplayName(key));
+    }
+  }
+
+  return decisions;
+}
+
+/**
+ * 3 选项冲突决策
+ *
+ * @param {string} areaName - 区域显示名（如 'docs'）
+ * @returns {Promise<'recreate'|'update'|'skip'>}
+ */
+async function askAreaDecision(areaName) {
+  return await select({
+    message: `${areaName}/ 已存在，如何处理？`,
+    choices: [
+      { name: '重新创建 — 删除现有目录，使用最新模板重建', value: 'recreate' },
+      { name: '更新 — 保留现有目录，按新内容覆盖（保留本地修改之外的文件）', value: 'update' },
+      { name: '跳过 — 保留现有目录，不做任何修改', value: 'skip' },
+    ],
+  });
+}
+
+// ============================================================
+// 子目录决策
+// ============================================================
+
+/**
+ * 收集子目录决策（仅当父目录 skip 时）
+ *
+ * @param {object} decisions - 区域决策
+ * @param {string} targetDir - 目标目录
+ * @param {object} options - CLI 选项
+ * @returns {Promise<object>} 子决策 { conventions, templates }
+ */
+async function collectSubDecisions(decisions, targetDir, pluginDir, options) {
+  const sub = { conventions: 'skip', templates: {} };
+  const nonInteractive = options.nonInteractive || false;
+  const force = options.force || false;
+
+  // --force 模式：全部 skip（因为 recreate 已经完整重建了）
+  if (force) return sub;
+
+  // --non-interactive 模式：全部 skip
+  if (nonInteractive) return sub;
+
+  // conventions_decision：docs/ skip 且 40-project_conventions/ 有文件
+  if (decisions.docs === 'skip') {
+    const convDir = path.join(targetDir, 'docs/40-project_conventions');
+    if (fs.existsSync(convDir) && hasAnyFile(convDir)) {
+      sub.conventions = await askSubDecision('docs/40-project_conventions');
+    }
+  }
+
+  // templates_decision：.adspecs/ skip 且 templates/ 有文件 → 逐文件确认
+  if (decisions.adspecs === 'skip') {
+    const tmplDir = path.join(targetDir, '.adspecs/templates');
+    const pluginTmplDir = path.join(pluginDir, '.adspecs/templates');
+    if (fs.existsSync(tmplDir) && hasAnyFile(tmplDir)) {
+      sub.templates = await collectTemplatesDecision(tmplDir, pluginTmplDir);
+    }
+  }
+
+  return sub;
+}
+
+/**
+ * 子目录更新决策（2 选项）
+ *
+ * @param {string} subDirName - 子目录显示名
+ * @returns {Promise<'update'|'skip'>}
+ */
+async function askSubDecision(subDirName) {
+  return await select({
+    message: `${subDirName}/ 目录已存在且包含文件，是否使用最新规范文件更新？`,
+    choices: [
+      { name: '更新 — 使用最新文件覆盖现有内容', value: 'update' },
+      { name: '跳过 — 保留现有内容，不做任何修改', value: 'skip' },
+    ],
+  });
+}
+
+/**
+ * 逐文件确认模板文件是否替换
+ *
+ * 扫描目标目录和插件根目录的模板文件，自动识别新增文件（直接复制），
+ * 对共有文件提供批量快捷选项 + 逐文件确认。
+ *
+ * @param {string} targetTmplDir - 目标项目 templates 目录
+ * @param {string} pluginTmplDir - 插件根目录 templates 目录
+ * @returns {Promise<Object<string, 'replace'|'keep'>>} 逐文件决策映射
+ */
+async function collectTemplatesDecision(targetTmplDir, pluginTmplDir) {
+  const targetFiles = listFiles(targetTmplDir).filter((f) => f.endsWith('.md'));
+  const pluginFiles = listFiles(pluginTmplDir).filter((f) => f.endsWith('.md'));
+
+  const targetSet = new Set(targetFiles);
+  const pluginSet = new Set(pluginFiles);
+
+  // 新增文件（插件有，目标没有）→ 直接复制，无需确认
+  const newFiles = pluginFiles.filter((f) => !targetSet.has(f));
+  // 共有文件 → 需要逐文件确认
+  const commonFiles = pluginFiles.filter((f) => targetSet.has(f));
+
+  if (commonFiles.length === 0) {
+    // 没有共有文件，无需确认
+    return {};
+  }
+
+  // 批量快捷选项
+  const bulkChoice = await select({
+    message: `.adspecs/templates/ 目录已存在且包含 ${targetFiles.length} 个模板文件（其中 ${commonFiles.length} 个为已有，${newFiles.length} 个为新增），如何处理已有文件？`,
+    choices: [
+      { name: '逐文件确认 — 对每个已有模板文件逐一询问是否替换（推荐）', value: 'ask-each' },
+      { name: '全部保留现有 — 保留所有已有模板文件不做修改', value: 'keep-all' },
+      { name: '全部替换为最新 — 使用插件根目录中的最新版本覆盖所有已有模板文件', value: 'replace-all' },
+    ],
+  });
+
+  if (bulkChoice === 'keep-all') {
+    const decision = {};
+    for (const f of commonFiles) {
+      decision[f] = 'keep';
+    }
+    return decision;
+  }
+
+  if (bulkChoice === 'replace-all') {
+    const decision = {};
+    for (const f of commonFiles) {
+      decision[f] = 'replace';
+    }
+    return decision;
+  }
+
+  // 逐文件询问（每批最多 4 个文件，避免 inquirer 单次问题过多）
+  const decision = {};
+  const BATCH_SIZE = 4;
+  for (let i = 0; i < commonFiles.length; i += BATCH_SIZE) {
+    const batch = commonFiles.slice(i, i + BATCH_SIZE);
+    const batchNum = Math.floor(i / BATCH_SIZE) + 1;
+    const totalBatches = Math.ceil(commonFiles.length / BATCH_SIZE);
+
+    console.log('');
+    console.log(`--- 模板文件确认（第 ${batchNum}/${totalBatches} 批，共 ${commonFiles.length} 个） ---`);
+
+    for (const file of batch) {
+      const choice = await select({
+        message: `模板文件 ${file} 已存在，是否使用最新版本替换？`,
+        choices: [
+          { name: '保留现有 — 保留当前项目中的版本（用户可能已按项目实际情况调整过）', value: 'keep' },
+          { name: '替换为最新 — 使用插件根目录中的最新版本覆盖现有文件', value: 'replace' },
+        ],
+      });
+      decision[file] = choice;
+    }
+  }
+
+  return decision;
+}
+
+// ============================================================
+// 模式升级检测
+// ============================================================
+
+/**
+ * 检测模式升级场景（simple → classic/full/demo）
+ *
+ * 当 docs/ 已存在且 skip，且当前模式为 classic/full/demo，
+ * 检查 40-project_conventions/frontend-standard/ 是否为空（简易模式产物特征）。
+ * 如果是，则需要自动补充 frontend-standard/ 文件。
+ *
+ * 简易模式会在 40-project_conventions/ 下生成 README.md 并创建空子目录
+ * frontend-standard/ 和 end-standard/，因此不能检查整个 40 目录，而要检查
+ * frontend-standard/ 子目录是否为空。
+ *
+ * @param {object} decisions - 区域决策
+ * @param {string} mode - 当前模式
+ * @param {string} targetDir - 目标目录
+ * @returns {object} { detected, emptyDirs }
+ */
+function detectModeUpgrade(decisions, mode, targetDir) {
+  // 仅 classic/full/demo 模式需要检测
+  if (mode === 'simple') {
+    return { detected: false, emptyDirs: [] };
+  }
+
+  // 仅当 docs/ 为 skip 时才有意义
+  if (decisions.docs !== 'skip') {
+    return { detected: false, emptyDirs: [] };
+  }
+
+  const frontendStdDir = path.join(targetDir, 'docs/40-project_conventions/frontend-standard');
+  if (!fs.existsSync(frontendStdDir)) {
+    return { detected: false, emptyDirs: [] };
+  }
+
+  // 检查 frontend-standard/ 是否为空（无任何文件）
+  // 注意：不使用 isEmptyDirectoryTree，因为我们要检查的是这个特定子目录
+  if (!hasAnyFile(frontendStdDir)) {
+    return {
+      detected: true,
+      emptyDirs: ['40-project_conventions/frontend-standard/'],
+    };
+  }
+
+  return { detected: false, emptyDirs: [] };
+}
+
+// ============================================================
+// 执行前确认
+// ============================================================
+
+/**
+ * 执行前确认
+ *
+ * @param {object} options - CLI 选项
+ * @returns {Promise<boolean>}
+ */
+async function confirmExecution(options) {
+  // --force / --non-interactive / --yes 自动确认
+  if (options.force || options.nonInteractive || options.yes) {
+    return true;
+  }
+
+  return await confirm({
+    message: '是否继续执行以上计划？',
+    default: true,
+  });
+}
+
+module.exports = {
+  collectProjectInfo,
+  collectDecisions,
+  collectSubDecisions,
+  collectTemplatesDecision,
+  detectModeUpgrade,
+  confirmExecution,
+  askAreaDecision,
+  askSubDecision,
+};