adspecs 0.1.18 → 0.1.20

package/src/commands/doctor.js

@@ -1,197 +1,197 @@
-'use strict';
-
-const { execSync } = require('child_process');
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
-
-/**
- * 环境依赖检查
- *
- * 检查 adspecs 运行所需的各工具是否可用，输出状态报告。
- * 不阻断 init 执行，仅作提示。
- */
-module.exports = async function doctor() {
-  console.log(chalk.cyan('🩺 adspecs 环境检查'));
-  console.log('');
-
-  const checks = [
-    checkNode(),
-    checkGit(),
-    checkClaudeCli(),
-    checkPython(),
-    checkPowerShell(),
-    checkPluginIntegrity(),
-  ];
-
-  const maxNameLen = Math.max(...checks.map((c) => c.name.length));
-
-  for (const check of checks) {
-    const icon = check.ok ? chalk.green('✅') : check.required ? chalk.red('❌') : chalk.yellow('⚠');
-    const paddedName = check.name.padEnd(maxNameLen);
-    const version = check.version ? chalk.gray(`(${check.version})`) : '';
-    const status = check.ok
-      ? chalk.green(check.message || '可用')
-      : check.required
-        ? chalk.red(check.message || '未找到（必需）')
-        : chalk.yellow(check.message || '未找到（可选）');
-    console.log(`   ${icon} ${paddedName}  ${status} ${version}`);
-  }
-
-  console.log('');
-
-  const failed = checks.filter((c) => !c.ok);
-  const requiredFailed = failed.filter((c) => c.required);
-
-  if (requiredFailed.length > 0) {
-    console.log(chalk.red.bold(`❌ ${requiredFailed.length} 个必需依赖缺失，部分功能不可用`));
-    console.log('');
-    console.log('   安装指南：');
-    for (const c of requiredFailed) {
-      if (c.installHint) {
-        console.log(`   - ${c.name}: ${c.installHint}`);
-      }
-    }
-  } else if (failed.length > 0) {
-    console.log(chalk.yellow(`⚠ ${failed.length} 个可选依赖缺失，部分功能受限`));
-  } else {
-    console.log(chalk.green.bold('✅ 所有依赖检查通过'));
-  }
-
-  console.log('');
-};
-
-// ============================================================
-// 各项检查
-// ============================================================
-
-function checkNode() {
-  try {
-    const version = process.version;
-    const major = parseInt(version.slice(1).split('.')[0], 10);
-    const ok = major >= 18;
-    return {
-      name: 'Node.js',
-      ok,
-      required: true,
-      version,
-      message: ok ? '可用' : '版本过低（需要 >=18.0.0）',
-      installHint: '访问 https://nodejs.org 下载最新版本',
-    };
-  } catch {
-    return { name: 'Node.js', ok: false, required: true, message: '未找到' };
-  }
-}
-
-function checkGit() {
-  try {
-    const output = execSync('git --version', { stdio: 'pipe' }).toString().trim();
-    const version = output.match(/[\d.]+/)?.[0] || '';
-    return { name: 'Git', ok: true, required: false, version, message: '可用' };
-  } catch {
-    return {
-      name: 'Git',
-      ok: false,
-      required: false,
-      message: '未找到（git 扩展功能不可用）',
-      installHint: '访问 https://git-scm.com 下载',
-    };
-  }
-}
-
-function checkClaudeCli() {
-  try {
-    const output = execSync('claude --version', { stdio: 'pipe' }).toString().trim();
-    const version = output.match(/[\d.]+/)?.[0] || '';
-    return { name: 'Claude CLI', ok: true, required: false, version, message: '可用' };
-  } catch {
-    return {
-      name: 'Claude CLI',
-      ok: false,
-      required: false,
-      message: '未找到（plugin install 命令不可用）',
-      installHint: 'npm install -g @anthropic-ai/claude-code',
-    };
-  }
-}
-
-function checkPython() {
-  try {
-    const output = execSync('python3 --version 2>&1 || python --version 2>&1', {
-      stdio: 'pipe',
-      shell: true,
-    })
-      .toString()
-      .trim();
-    const version = output.match(/[\d.]+/)?.[0] || '';
-    return { name: 'Python', ok: true, required: false, version, message: '可用' };
-  } catch {
-    return {
-      name: 'Python',
-      ok: false,
-      required: false,
-      message: '未找到（Python 脚本不可用）',
-      installHint: '访问 https://www.python.org 下载',
-    };
-  }
-}
-
-function checkPowerShell() {
-  try {
-    // 尝试 PowerShell Core (pwsh)
-    const output = execSync('pwsh --version', { stdio: 'pipe' }).toString().trim();
-    const version = output.match(/[\d.]+/)?.[0] || '';
-    return { name: 'PowerShell', ok: true, required: false, version, message: '可用 (pwsh)' };
-  } catch {
-    try {
-      // 退而尝试 Windows PowerShell
-      if (process.platform === 'win32') {
-        execSync('powershell -Command "echo ok"', { stdio: 'pipe' });
-        return {
-          name: 'PowerShell',
-          ok: true,
-          required: false,
-          version: 'Windows PowerShell',
-          message: '可用 (Windows PowerShell)',
-        };
-      }
-    } catch {
-      // ignore
-    }
-    return {
-      name: 'PowerShell',
-      ok: false,
-      required: false,
-      message: '未找到（PowerShell 脚本不可用）',
-      installHint: '访问 https://github.com/PowerShell/PowerShell 安装 pwsh',
-    };
-  }
-}
-
-function checkPluginIntegrity() {
-  const pluginDir = path.resolve(__dirname, '../..');
-  const requiredPaths = [
-    '.claude-plugin/plugin.json',
-    '.adspecs/feature.json',
-    'skills/project-init/SKILL.md',
-    'hooks/hooks.json',
-  ];
-
-  const missing = requiredPaths.filter((p) => !fs.existsSync(path.join(pluginDir, p)));
-
-  if (missing.length === 0) {
-    return {
-      name: '插件完整性',
-      ok: true,
-      required: true,
-      message: `所有核心文件存在 (${pluginDir})`,
-    };
-  }
-
-  return {
-    name: '插件完整性',
-    ok: false,
-    required: true,
-    message: `缺失文件: ${missing.join(', ')}`,
-  };
-}
+'use strict';
+
+const { execSync } = require('child_process');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * 环境依赖检查
+ *
+ * 检查 adspecs 运行所需的各工具是否可用，输出状态报告。
+ * 不阻断 init 执行，仅作提示。
+ */
+module.exports = async function doctor() {
+  console.log(chalk.cyan('🩺 adspecs 环境检查'));
+  console.log('');
+
+  const checks = [
+    checkNode(),
+    checkGit(),
+    checkClaudeCli(),
+    checkPython(),
+    checkPowerShell(),
+    checkPluginIntegrity(),
+  ];
+
+  const maxNameLen = Math.max(...checks.map((c) => c.name.length));
+
+  for (const check of checks) {
+    const icon = check.ok ? chalk.green('✅') : check.required ? chalk.red('❌') : chalk.yellow('⚠');
+    const paddedName = check.name.padEnd(maxNameLen);
+    const version = check.version ? chalk.gray(`(${check.version})`) : '';
+    const status = check.ok
+      ? chalk.green(check.message || '可用')
+      : check.required
+        ? chalk.red(check.message || '未找到（必需）')
+        : chalk.yellow(check.message || '未找到（可选）');
+    console.log(`   ${icon} ${paddedName}  ${status} ${version}`);
+  }
+
+  console.log('');
+
+  const failed = checks.filter((c) => !c.ok);
+  const requiredFailed = failed.filter((c) => c.required);
+
+  if (requiredFailed.length > 0) {
+    console.log(chalk.red.bold(`❌ ${requiredFailed.length} 个必需依赖缺失，部分功能不可用`));
+    console.log('');
+    console.log('   安装指南：');
+    for (const c of requiredFailed) {
+      if (c.installHint) {
+        console.log(`   - ${c.name}: ${c.installHint}`);
+      }
+    }
+  } else if (failed.length > 0) {
+    console.log(chalk.yellow(`⚠ ${failed.length} 个可选依赖缺失，部分功能受限`));
+  } else {
+    console.log(chalk.green.bold('✅ 所有依赖检查通过'));
+  }
+
+  console.log('');
+};
+
+// ============================================================
+// 各项检查
+// ============================================================
+
+function checkNode() {
+  try {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0], 10);
+    const ok = major >= 18;
+    return {
+      name: 'Node.js',
+      ok,
+      required: true,
+      version,
+      message: ok ? '可用' : '版本过低（需要 >=18.0.0）',
+      installHint: '访问 https://nodejs.org 下载最新版本',
+    };
+  } catch {
+    return { name: 'Node.js', ok: false, required: true, message: '未找到' };
+  }
+}
+
+function checkGit() {
+  try {
+    const output = execSync('git --version', { stdio: 'pipe' }).toString().trim();
+    const version = output.match(/[\d.]+/)?.[0] || '';
+    return { name: 'Git', ok: true, required: false, version, message: '可用' };
+  } catch {
+    return {
+      name: 'Git',
+      ok: false,
+      required: false,
+      message: '未找到（git 扩展功能不可用）',
+      installHint: '访问 https://git-scm.com 下载',
+    };
+  }
+}
+
+function checkClaudeCli() {
+  try {
+    const output = execSync('claude --version', { stdio: 'pipe' }).toString().trim();
+    const version = output.match(/[\d.]+/)?.[0] || '';
+    return { name: 'Claude CLI', ok: true, required: false, version, message: '可用' };
+  } catch {
+    return {
+      name: 'Claude CLI',
+      ok: false,
+      required: false,
+      message: '未找到（plugin install 命令不可用）',
+      installHint: 'npm install -g @anthropic-ai/claude-code',
+    };
+  }
+}
+
+function checkPython() {
+  try {
+    const output = execSync('python3 --version 2>&1 || python --version 2>&1', {
+      stdio: 'pipe',
+      shell: true,
+    })
+      .toString()
+      .trim();
+    const version = output.match(/[\d.]+/)?.[0] || '';
+    return { name: 'Python', ok: true, required: false, version, message: '可用' };
+  } catch {
+    return {
+      name: 'Python',
+      ok: false,
+      required: false,
+      message: '未找到（Python 脚本不可用）',
+      installHint: '访问 https://www.python.org 下载',
+    };
+  }
+}
+
+function checkPowerShell() {
+  try {
+    // 尝试 PowerShell Core (pwsh)
+    const output = execSync('pwsh --version', { stdio: 'pipe' }).toString().trim();
+    const version = output.match(/[\d.]+/)?.[0] || '';
+    return { name: 'PowerShell', ok: true, required: false, version, message: '可用 (pwsh)' };
+  } catch {
+    try {
+      // 退而尝试 Windows PowerShell
+      if (process.platform === 'win32') {
+        execSync('powershell -Command "echo ok"', { stdio: 'pipe' });
+        return {
+          name: 'PowerShell',
+          ok: true,
+          required: false,
+          version: 'Windows PowerShell',
+          message: '可用 (Windows PowerShell)',
+        };
+      }
+    } catch {
+      // ignore
+    }
+    return {
+      name: 'PowerShell',
+      ok: false,
+      required: false,
+      message: '未找到（PowerShell 脚本不可用）',
+      installHint: '访问 https://github.com/PowerShell/PowerShell 安装 pwsh',
+    };
+  }
+}
+
+function checkPluginIntegrity() {
+  const pluginDir = path.resolve(__dirname, '../..');
+  const requiredPaths = [
+    '.claude-plugin/plugin.json',
+    '.adspecs/feature.json',
+    'skills/project-init/SKILL.md',
+    'hooks/hooks.json',
+  ];
+
+  const missing = requiredPaths.filter((p) => !fs.existsSync(path.join(pluginDir, p)));
+
+  if (missing.length === 0) {
+    return {
+      name: '插件完整性',
+      ok: true,
+      required: true,
+      message: `所有核心文件存在 (${pluginDir})`,
+    };
+  }
+
+  return {
+    name: '插件完整性',
+    ok: false,
+    required: true,
+    message: `缺失文件: ${missing.join(', ')}`,
+  };
+}

package/src/commands/init.js

@@ -1,83 +1,83 @@
-'use strict';
-
-const path = require('path');
-const chalk = require('chalk');
-const { scaffold } = require('../lib/scaffolder');
-const {
-  collectProjectInfo,
-  collectDecisions,
-  collectSubDecisions,
-  detectModeUpgrade,
-  confirmExecution,
-} = require('../lib/prompts');
-const { deriveShortName } = require('../lib/short-name');
-const { scanAreaStates } = require('../lib/area-scanner');
-const { printPlanSummary, printFinalReport } = require('../lib/report');
-
-/**
- * init 命令实现
- *
- * 10 步流程：
- *  1. 收集项目信息
- *  2. 扫描各区域存在状态
- *  3. 收集每区域决策（3 选项：recreate/update/skip）
- *  4. 收集子目录决策（conventions/templates）
- *  5. 模式升级检测
- *  6. 输出计划摘要
- *  7. 等待用户确认
- *  8. 执行脚手架（带实时状态输出）
- *  9. 输出详细最终报告
- *
- * @param {object} options - CLI 选项（来自 commander）
- */
-module.exports = async function init(options) {
-  console.log(chalk.cyan('🚀 adspecs 项目初始化'));
-  console.log('');
-
-  const pluginDir = path.resolve(__dirname, '../..');
-
-  // === Step 1: 收集项目信息 ===
-  const info = await collectProjectInfo(options);
-  info.project_short_name = deriveShortName(info.project_name, info.project_dir);
-
-  const targetDir = info.project_dir
-    ? path.resolve(process.cwd(), info.project_dir)
-    : process.cwd();
-
-  // === Step 2: 扫描区域状态 ===
-  const areaStates = scanAreaStates(targetDir, info.mode);
-
-  // === Step 3: 收集每区域决策 ===
-  const decisions = await collectDecisions(areaStates, options);
-
-  // === Step 4: 收集子目录决策 ===
-  const subDecisions = await collectSubDecisions(decisions, targetDir, options);
-
-  // === Step 5: 模式升级检测 ===
-  const modeUpgrade = detectModeUpgrade(decisions, info.mode, targetDir);
-
-  // === Step 6: 输出计划摘要 ===
-  printPlanSummary(info, decisions, subDecisions, modeUpgrade, targetDir);
-
-  // === Step 7: 等待用户确认 ===
-  const confirmed = await confirmExecution(options);
-  if (!confirmed) {
-    console.log(chalk.yellow('⏹ 已取消初始化'));
-    return;
-  }
-  console.log('');
-
-  // === Step 8: 执行脚手架（带实时状态输出） ===
-  const report = await scaffold({
-    targetDir,
-    pluginDir,
-    ...info,
-    decisions,
-    subDecisions,
-    modeUpgrade,
-    logger: (msg) => console.log(`   ${msg}`),
-  });
-
-  // === Step 9: 输出详细最终报告 ===
-  printFinalReport(report, info, decisions, subDecisions, modeUpgrade);
-};
+'use strict';
+
+const path = require('path');
+const chalk = require('chalk');
+const { scaffold } = require('../lib/scaffolder');
+const {
+  collectProjectInfo,
+  collectDecisions,
+  collectSubDecisions,
+  detectModeUpgrade,
+  confirmExecution,
+} = require('../lib/prompts');
+const { deriveShortName } = require('../lib/short-name');
+const { scanAreaStates } = require('../lib/area-scanner');
+const { printPlanSummary, printFinalReport } = require('../lib/report');
+
+/**
+ * init 命令实现
+ *
+ * 10 步流程：
+ *  1. 收集项目信息
+ *  2. 扫描各区域存在状态
+ *  3. 收集每区域决策（3 选项：recreate/update/skip）
+ *  4. 收集子目录决策（conventions/templates）
+ *  5. 模式升级检测
+ *  6. 输出计划摘要
+ *  7. 等待用户确认
+ *  8. 执行脚手架（带实时状态输出）
+ *  9. 输出详细最终报告
+ *
+ * @param {object} options - CLI 选项（来自 commander）
+ */
+module.exports = async function init(options) {
+  console.log(chalk.cyan('🚀 adspecs 项目初始化'));
+  console.log('');
+
+  const pluginDir = path.resolve(__dirname, '../..');
+
+  // === Step 1: 收集项目信息 ===
+  const info = await collectProjectInfo(options);
+  info.project_short_name = deriveShortName(info.project_name, info.project_dir);
+
+  const targetDir = info.project_dir
+    ? path.resolve(process.cwd(), info.project_dir)
+    : process.cwd();
+
+  // === Step 2: 扫描区域状态 ===
+  const areaStates = scanAreaStates(targetDir, info.mode);
+
+  // === Step 3: 收集每区域决策 ===
+  const decisions = await collectDecisions(areaStates, options);
+
+  // === Step 4: 收集子目录决策 ===
+  const subDecisions = await collectSubDecisions(decisions, targetDir, options);
+
+  // === Step 5: 模式升级检测 ===
+  const modeUpgrade = detectModeUpgrade(decisions, info.mode, targetDir);
+
+  // === Step 6: 输出计划摘要 ===
+  printPlanSummary(info, decisions, subDecisions, modeUpgrade, targetDir);
+
+  // === Step 7: 等待用户确认 ===
+  const confirmed = await confirmExecution(options);
+  if (!confirmed) {
+    console.log(chalk.yellow('⏹ 已取消初始化'));
+    return;
+  }
+  console.log('');
+
+  // === Step 8: 执行脚手架（带实时状态输出） ===
+  const report = await scaffold({
+    targetDir,
+    pluginDir,
+    ...info,
+    decisions,
+    subDecisions,
+    modeUpgrade,
+    logger: (msg) => console.log(`   ${msg}`),
+  });
+
+  // === Step 9: 输出详细最终报告 ===
+  printFinalReport(report, info, decisions, subDecisions, modeUpgrade);
+};