adspecs 0.1.19 → 0.1.21

package/src/commands/plugin.js

@@ -1,165 +1,165 @@
-'use strict';
-
-const { execSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-const chalk = require('chalk');
-
-/**
- * 插件根目录（即 adspecs/ 目录）
- * bin/adspecs.js 在 bin/ 下，src/commands/ 在 src/commands/ 下
- * 所以 __dirname/../../ 指向插件根目录
- */
-const PLUGIN_DIR = path.resolve(__dirname, '../..');
-
-/**
- * 检查 claude CLI 是否可用
- */
-function checkClaudeCli() {
-  try {
-    execSync('claude --version', { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 读取 plugin.json 获取插件名
- */
-function getPluginName() {
-  const pluginJsonPath = path.join(PLUGIN_DIR, '.claude-plugin', 'plugin.json');
-  if (!fs.existsSync(pluginJsonPath)) {
-    throw new Error(`未找到插件清单文件: ${pluginJsonPath}`);
-  }
-  const pluginJson = JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8'));
-  return pluginJson.name || 'adspecs';
-}
-
-/**
- * 安装（注册）插件到 Claude Code
- *
- * Claude Code 的 marketplace 命令期望路径指向包含 `.claude-plugin/marketplace.json`
- * 的目录，因此传入 PLUGIN_DIR（而非 PLUGIN_DIR/.claude-plugin）。
- *
- * @param {object} options
- * @param {string} options.scope - 安装范围: user|project
- */
-exports.install = async function install(options) {
-  const scope = options.scope || 'user';
-  const pluginName = getPluginName();
-
-  // marketplace.json 必须存在，否则无法注册
-  const marketplaceJson = path.join(PLUGIN_DIR, '.claude-plugin', 'marketplace.json');
-  if (!fs.existsSync(marketplaceJson)) {
-    throw new Error(`未找到 marketplace 清单: ${marketplaceJson}`);
-  }
-
-  console.log(chalk.cyan('🔌 adspecs 插件注册'));
-  console.log('');
-  console.log(`   插件目录:  ${PLUGIN_DIR}`);
-  console.log(`   插件名称:  ${pluginName}`);
-  console.log(`   安装范围:  ${scope}`);
-  console.log('');
-
-  // 1. 检查 claude CLI
-  if (!checkClaudeCli()) {
-    console.error(chalk.red('❌ 未检测到 claude CLI'));
-    console.error('');
-    console.error('   请先安装 Claude Code:');
-    console.error('   npm install -g @anthropic-ai/claude-code');
-    console.error('');
-    console.error('   或访问: https://claude.ai/code');
-    process.exit(1);
-  }
-
-  // 2. 注册 marketplace
-  //    注意：传入 PLUGIN_DIR，claude 会去找 <PLUGIN_DIR>/.claude-plugin/marketplace.json
-  console.log(chalk.gray('   → 注册 marketplace...'));
-  let marketplaceRegistered = false;
-  try {
-    execSync(
-      `claude plugins marketplace add "${PLUGIN_DIR}" --scope ${scope}`,
-      { stdio: 'pipe' }
-    );
-    console.log(chalk.green('   ✅ marketplace 注册成功'));
-    marketplaceRegistered = true;
-  } catch (err) {
-    const stderr = err.stderr ? err.stderr.toString() : '';
-    const stdout = err.stdout ? err.stdout.toString() : '';
-    const combined = stderr + stdout;
-    if (combined.includes('already exists') || combined.includes('already registered')) {
-      console.log(chalk.yellow('   ⏭ marketplace 已存在，跳过'));
-      marketplaceRegistered = true; // 已存在也视为可用
-    } else {
-      // 把真实错误输出，方便排查，不再静默吞掉
-      console.log(chalk.red(`   ❌ marketplace 注册失败: ${combined.trim() || err.message}`));
-    }
-  }
-
-  // 3. 安装插件
-  //    只有 marketplace 注册成功（或已存在）时，才能按名称安装
-  console.log(chalk.gray('   → 安装插件...'));
-  if (!marketplaceRegistered) {
-    throw new Error('marketplace 未注册成功，无法按名称安装插件，请检查上方错误');
-  }
-  try {
-    execSync(`claude plugins install ${pluginName} --scope ${scope}`, {
-      stdio: 'pipe',
-    });
-    console.log(chalk.green(`   ✅ ${pluginName} 插件安装成功`));
-  } catch (err) {
-    const stderr = err.stderr ? err.stderr.toString() : '';
-    const stdout = err.stdout ? err.stdout.toString() : '';
-    const combined = stderr + stdout;
-    if (combined.includes('already installed')) {
-      console.log(chalk.yellow(`   ⏭ ${pluginName} 已安装，跳过`));
-    } else {
-      throw new Error(`插件安装失败: ${combined.trim() || err.message}`);
-    }
-  }
-
-  console.log('');
-  console.log(chalk.green.bold(`✅ adspecs 插件已注册到 Claude Code (scope=${scope})`));
-  console.log('');
-  console.log('   现在可以在 Claude Code 中使用以下技能：');
-  console.log('   /adspecs-prd          — 生成 PRD');
-  console.log('   /adspecs-plan         — 后端系统设计');
-  console.log('   /adspecs-tasks        — TDD 任务清单');
-  console.log('   /adspecs-utest        — 生成单元测试');
-  console.log('   ...（共 19 个技能）');
-  console.log('');
-};
-
-/**
- * 卸载插件
- *
- * @param {object} options
- * @param {string} options.scope - 卸载范围: user|project
- */
-exports.uninstall = async function uninstall(options) {
-  const scope = options.scope || 'user';
-  const pluginName = getPluginName();
-
-  console.log(chalk.cyan('🔌 adspecs 插件卸载'));
-  console.log('');
-
-  if (!checkClaudeCli()) {
-    console.error(chalk.red('❌ 未检测到 claude CLI'));
-    process.exit(1);
-  }
-
-  try {
-    execSync(`claude plugins uninstall ${pluginName} --scope ${scope}`, {
-      stdio: 'pipe',
-    });
-    console.log(chalk.green(`✅ ${pluginName} 插件已卸载 (scope=${scope})`));
-  } catch (err) {
-    const stderr = err.stderr ? err.stderr.toString() : '';
-    if (stderr.includes('not installed') || stderr.includes('not found')) {
-      console.log(chalk.yellow(`⏭ ${pluginName} 未安装，无需卸载`));
-    } else {
-      throw new Error(`插件卸载失败: ${stderr || err.message}`);
-    }
-  }
-};
+'use strict';
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const chalk = require('chalk');
+
+/**
+ * 插件根目录（即 adspecs/ 目录）
+ * bin/adspecs.js 在 bin/ 下，src/commands/ 在 src/commands/ 下
+ * 所以 __dirname/../../ 指向插件根目录
+ */
+const PLUGIN_DIR = path.resolve(__dirname, '../..');
+
+/**
+ * 检查 claude CLI 是否可用
+ */
+function checkClaudeCli() {
+  try {
+    execSync('claude --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 读取 plugin.json 获取插件名
+ */
+function getPluginName() {
+  const pluginJsonPath = path.join(PLUGIN_DIR, '.claude-plugin', 'plugin.json');
+  if (!fs.existsSync(pluginJsonPath)) {
+    throw new Error(`未找到插件清单文件: ${pluginJsonPath}`);
+  }
+  const pluginJson = JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8'));
+  return pluginJson.name || 'adspecs';
+}
+
+/**
+ * 安装（注册）插件到 Claude Code
+ *
+ * Claude Code 的 marketplace 命令期望路径指向包含 `.claude-plugin/marketplace.json`
+ * 的目录，因此传入 PLUGIN_DIR（而非 PLUGIN_DIR/.claude-plugin）。
+ *
+ * @param {object} options
+ * @param {string} options.scope - 安装范围: user|project
+ */
+exports.install = async function install(options) {
+  const scope = options.scope || 'user';
+  const pluginName = getPluginName();
+
+  // marketplace.json 必须存在，否则无法注册
+  const marketplaceJson = path.join(PLUGIN_DIR, '.claude-plugin', 'marketplace.json');
+  if (!fs.existsSync(marketplaceJson)) {
+    throw new Error(`未找到 marketplace 清单: ${marketplaceJson}`);
+  }
+
+  console.log(chalk.cyan('🔌 adspecs 插件注册'));
+  console.log('');
+  console.log(`   插件目录:  ${PLUGIN_DIR}`);
+  console.log(`   插件名称:  ${pluginName}`);
+  console.log(`   安装范围:  ${scope}`);
+  console.log('');
+
+  // 1. 检查 claude CLI
+  if (!checkClaudeCli()) {
+    console.error(chalk.red('❌ 未检测到 claude CLI'));
+    console.error('');
+    console.error('   请先安装 Claude Code:');
+    console.error('   npm install -g @anthropic-ai/claude-code');
+    console.error('');
+    console.error('   或访问: https://claude.ai/code');
+    process.exit(1);
+  }
+
+  // 2. 注册 marketplace
+  //    注意：传入 PLUGIN_DIR，claude 会去找 <PLUGIN_DIR>/.claude-plugin/marketplace.json
+  console.log(chalk.gray('   → 注册 marketplace...'));
+  let marketplaceRegistered = false;
+  try {
+    execSync(
+      `claude plugins marketplace add "${PLUGIN_DIR}" --scope ${scope}`,
+      { stdio: 'pipe' }
+    );
+    console.log(chalk.green('   ✅ marketplace 注册成功'));
+    marketplaceRegistered = true;
+  } catch (err) {
+    const stderr = err.stderr ? err.stderr.toString() : '';
+    const stdout = err.stdout ? err.stdout.toString() : '';
+    const combined = stderr + stdout;
+    if (combined.includes('already exists') || combined.includes('already registered')) {
+      console.log(chalk.yellow('   ⏭ marketplace 已存在，跳过'));
+      marketplaceRegistered = true; // 已存在也视为可用
+    } else {
+      // 把真实错误输出，方便排查，不再静默吞掉
+      console.log(chalk.red(`   ❌ marketplace 注册失败: ${combined.trim() || err.message}`));
+    }
+  }
+
+  // 3. 安装插件
+  //    只有 marketplace 注册成功（或已存在）时，才能按名称安装
+  console.log(chalk.gray('   → 安装插件...'));
+  if (!marketplaceRegistered) {
+    throw new Error('marketplace 未注册成功，无法按名称安装插件，请检查上方错误');
+  }
+  try {
+    execSync(`claude plugins install ${pluginName} --scope ${scope}`, {
+      stdio: 'pipe',
+    });
+    console.log(chalk.green(`   ✅ ${pluginName} 插件安装成功`));
+  } catch (err) {
+    const stderr = err.stderr ? err.stderr.toString() : '';
+    const stdout = err.stdout ? err.stdout.toString() : '';
+    const combined = stderr + stdout;
+    if (combined.includes('already installed')) {
+      console.log(chalk.yellow(`   ⏭ ${pluginName} 已安装，跳过`));
+    } else {
+      throw new Error(`插件安装失败: ${combined.trim() || err.message}`);
+    }
+  }
+
+  console.log('');
+  console.log(chalk.green.bold(`✅ adspecs 插件已注册到 Claude Code (scope=${scope})`));
+  console.log('');
+  console.log('   现在可以在 Claude Code 中使用以下技能：');
+  console.log('   /adspecs-prd          — 生成 PRD');
+  console.log('   /adspecs-plan         — 后端系统设计');
+  console.log('   /adspecs-tasks        — TDD 任务清单');
+  console.log('   /adspecs-utest        — 生成单元测试');
+  console.log('   ...（共 19 个技能）');
+  console.log('');
+};
+
+/**
+ * 卸载插件
+ *
+ * @param {object} options
+ * @param {string} options.scope - 卸载范围: user|project
+ */
+exports.uninstall = async function uninstall(options) {
+  const scope = options.scope || 'user';
+  const pluginName = getPluginName();
+
+  console.log(chalk.cyan('🔌 adspecs 插件卸载'));
+  console.log('');
+
+  if (!checkClaudeCli()) {
+    console.error(chalk.red('❌ 未检测到 claude CLI'));
+    process.exit(1);
+  }
+
+  try {
+    execSync(`claude plugins uninstall ${pluginName} --scope ${scope}`, {
+      stdio: 'pipe',
+    });
+    console.log(chalk.green(`✅ ${pluginName} 插件已卸载 (scope=${scope})`));
+  } catch (err) {
+    const stderr = err.stderr ? err.stderr.toString() : '';
+    if (stderr.includes('not installed') || stderr.includes('not found')) {
+      console.log(chalk.yellow(`⏭ ${pluginName} 未安装，无需卸载`));
+    } else {
+      throw new Error(`插件卸载失败: ${stderr || err.message}`);
+    }
+  }
+};

package/src/commands/update.js

@@ -1,87 +1,87 @@
-'use strict';
-
-const { execSync, spawn } = require('child_process');
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
-
-/**
- * adspecs update 命令
- *
- * 便捷命令：一条命令完成 adspecs 升级 + Claude Code 插件刷新。
- *
- * 流程：
- * 1. 检查当前版本
- * 2. 执行 `npm install -g adspecs@latest`（或 `npm update -g adspecs`）
- * 3. postinstall 钩子会自动刷新 Claude Code 插件注册
- * 4. 显示升级前后版本
- */
-module.exports = async function update(options) {
-  const pluginDir = path.resolve(__dirname, '../..');
-  const pkgPath = path.join(pluginDir, 'package.json');
-
-  // 读取升级前版本
-  let oldVersion = 'unknown';
-  try {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    oldVersion = pkg.version;
-  } catch {
-    // ignore
-  }
-
-  console.log(chalk.cyan('🔄 adspecs 升级'));
-  console.log('');
-  console.log(`   当前版本: ${chalk.yellow(oldVersion)}`);
-  console.log(`   目标版本: ${options.version || 'latest'}`);
-  console.log('');
-
-  // 确定要安装的版本
-  const targetVersion = options.version ? `adspecs@${options.version}` : 'adspecs@latest';
-
-  // 执行 npm install -g
-  console.log(chalk.gray(`   → 执行: npm install -g ${targetVersion}`));
-  console.log('');
-
-  try {
-    // 使用 spawn 以实时显示 npm 输出
-    await new Promise((resolve, reject) => {
-      const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-      const child = spawn(npmCmd, ['install', '-g', targetVersion], {
-        stdio: 'inherit',
-        shell: true,
-      });
-      child.on('close', (code) => {
-        if (code === 0) resolve();
-        else reject(new Error(`npm install 退出码: ${code}`));
-      });
-      child.on('error', reject);
-    });
-  } catch (err) {
-    console.error('');
-    console.error(chalk.red(`❌ 升级失败: ${err.message}`));
-    console.error('');
-    console.error('   请检查网络连接或手动执行：');
-    console.error('   npm install -g adspecs@latest');
-    process.exit(1);
-  }
-
-  // 读取升级后版本
-  let newVersion = 'unknown';
-  try {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    newVersion = pkg.version;
-  } catch {
-    // ignore
-  }
-
-  console.log('');
-  if (oldVersion === newVersion) {
-    console.log(chalk.green(`✅ 已是最新版本 (${newVersion})`));
-  } else {
-    console.log(chalk.green.bold(`✅ 升级完成: ${oldVersion} → ${newVersion}`));
-  }
-  console.log('');
-  console.log('   Claude Code 插件注册已通过 postinstall 钩子自动刷新。');
-  console.log(`   验证: ${chalk.gray('adspecs --version')}`);
-  console.log('');
-};
+'use strict';
+
+const { execSync, spawn } = require('child_process');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+
+/**
+ * adspecs update 命令
+ *
+ * 便捷命令：一条命令完成 adspecs 升级 + Claude Code 插件刷新。
+ *
+ * 流程：
+ * 1. 检查当前版本
+ * 2. 执行 `npm install -g adspecs@latest`（或 `npm update -g adspecs`）
+ * 3. postinstall 钩子会自动刷新 Claude Code 插件注册
+ * 4. 显示升级前后版本
+ */
+module.exports = async function update(options) {
+  const pluginDir = path.resolve(__dirname, '../..');
+  const pkgPath = path.join(pluginDir, 'package.json');
+
+  // 读取升级前版本
+  let oldVersion = 'unknown';
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    oldVersion = pkg.version;
+  } catch {
+    // ignore
+  }
+
+  console.log(chalk.cyan('🔄 adspecs 升级'));
+  console.log('');
+  console.log(`   当前版本: ${chalk.yellow(oldVersion)}`);
+  console.log(`   目标版本: ${options.version || 'latest'}`);
+  console.log('');
+
+  // 确定要安装的版本
+  const targetVersion = options.version ? `adspecs@${options.version}` : 'adspecs@latest';
+
+  // 执行 npm install -g
+  console.log(chalk.gray(`   → 执行: npm install -g ${targetVersion}`));
+  console.log('');
+
+  try {
+    // 使用 spawn 以实时显示 npm 输出
+    await new Promise((resolve, reject) => {
+      const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+      const child = spawn(npmCmd, ['install', '-g', targetVersion], {
+        stdio: 'inherit',
+        shell: true,
+      });
+      child.on('close', (code) => {
+        if (code === 0) resolve();
+        else reject(new Error(`npm install 退出码: ${code}`));
+      });
+      child.on('error', reject);
+    });
+  } catch (err) {
+    console.error('');
+    console.error(chalk.red(`❌ 升级失败: ${err.message}`));
+    console.error('');
+    console.error('   请检查网络连接或手动执行：');
+    console.error('   npm install -g adspecs@latest');
+    process.exit(1);
+  }
+
+  // 读取升级后版本
+  let newVersion = 'unknown';
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    newVersion = pkg.version;
+  } catch {
+    // ignore
+  }
+
+  console.log('');
+  if (oldVersion === newVersion) {
+    console.log(chalk.green(`✅ 已是最新版本 (${newVersion})`));
+  } else {
+    console.log(chalk.green.bold(`✅ 升级完成: ${oldVersion} → ${newVersion}`));
+  }
+  console.log('');
+  console.log('   Claude Code 插件注册已通过 postinstall 钩子自动刷新。');
+  console.log(`   验证: ${chalk.gray('adspecs --version')}`);
+  console.log('');
+};