speccrew 0.1.1 → 0.1.3

package/lib/commands/init.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 const {
   copyDirRecursive,
   isSpeccrewFile,
@@ -9,7 +10,7 @@ const {
   getWorkspaceTemplatePath,
   ensureDirectories,
 } = require('../utils');
-const { resolveIDE } = require('../ide-adapters');
+const { resolveIDE, transformAgentForIDE, transformSkillForIDE } = require('../ide-adapters');
 
 // 解析命令行参数
 function parseArgs() {
@@ -35,8 +36,22 @@ function checkNodeVersion() {
   }
 }
 
+// 进度显示辅助函数
+function printProgress(step, total, message) {
+  process.stdout.write(`[${step}/${total}] ${message}... `);
+}
+
+function printDone() {
+  console.log('done');
+}
+
+// 获取 npm 包根目录
+function getPackageRoot() {
+  return path.resolve(__dirname, '..', '..');
+}
+
 // 复制 agents（speccrew-* 前缀文件，总是覆盖）
-function copyAgents(sourceDir, destDir) {
+function copyAgents(sourceDir, destDir, ideConfig) {
   if (!fs.existsSync(sourceDir)) return { copied: 0, skipped: 0 };
   
   fs.mkdirSync(destDir, { recursive: true });
@@ -52,7 +67,14 @@ function copyAgents(sourceDir, destDir) {
     const srcPath = path.join(sourceDir, entry.name);
     const destPath = path.join(destDir, entry.name);
     
-    fs.copyFileSync(srcPath, destPath);
+    // 如果 IDE 需要转换 frontmatter 且是 .md 文件
+    if (ideConfig && ideConfig.transformFrontmatter && entry.name.endsWith('.md')) {
+      const originalContent = fs.readFileSync(srcPath, 'utf8');
+      const transformedContent = transformAgentForIDE(originalContent, ideConfig);
+      fs.writeFileSync(destPath, transformedContent, 'utf8');
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
     copied++;
   }
   
@@ -60,7 +82,7 @@ function copyAgents(sourceDir, destDir) {
 }
 
 // 复制 skills（speccrew-* 前缀目录，递归复制，总是覆盖）
-function copySkills(sourceDir, destDir) {
+function copySkills(sourceDir, destDir, ideConfig) {
   if (!fs.existsSync(sourceDir)) return { copied: 0, skipped: 0 };
   
   let copied = 0, skipped = 0;
@@ -76,7 +98,18 @@ function copySkills(sourceDir, destDir) {
     const destPath = path.join(destDir, entry.name);
     
     if (entry.isDirectory()) {
-      const result = copyDirRecursive(srcPath, destPath);
+      // 构建 contentTransform 回调：只对 SKILL.md 文件转化
+      let contentTransform = null;
+      if (ideConfig && ideConfig.transformFrontmatter) {
+        contentTransform = (content, fileName, filePath) => {
+          if (fileName === 'SKILL.md') {
+            return transformSkillForIDE(content, ideConfig);
+          }
+          // 其他文件返回 null，表示按原方式复制
+          return null;
+        };
+      }
+      const result = copyDirRecursive(srcPath, destPath, null, contentTransform);
       copied += result.copied;
       skipped += result.skipped;
     } else {
@@ -143,23 +176,148 @@ function copyWorkspaceTemplate(templateDir, workspaceDir) {
   return { copied, skipped };
 }
 
-// 主函数
-function run() {
+// 复制文档文件（仅复制不存在的文件）
+function copyDocs(packageRoot, workspaceDir) {
+  let copied = 0;
+  
+  // 复制 GETTING-STARTED*.md 到 workspace/docs/
+  const docsSourceDir = path.join(packageRoot, 'docs');
+  const docsDestDir = path.join(workspaceDir, 'docs');
+  
+  if (fs.existsSync(docsSourceDir)) {
+    const entries = fs.readdirSync(docsSourceDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith('GETTING-STARTED') && entry.name.endsWith('.md')) {
+        const srcPath = path.join(docsSourceDir, entry.name);
+        const destPath = path.join(docsDestDir, entry.name);
+        
+        if (!fs.existsSync(destPath)) {
+          fs.copyFileSync(srcPath, destPath);
+          copied++;
+        }
+      }
+    }
+  }
+  
+  // 复制 README*.md 到 workspace/
+  const entries = fs.readdirSync(packageRoot, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name.startsWith('README') && entry.name.endsWith('.md')) {
+      const srcPath = path.join(packageRoot, entry.name);
+      const destPath = path.join(workspaceDir, entry.name);
+      
+      if (!fs.existsSync(destPath)) {
+        fs.copyFileSync(srcPath, destPath);
+        copied++;
+      }
+    }
+  }
+  
+  return { copied };
+}
+
+// 迁移旧的 .speccrewrc 到 workspace 目录
+function migrateOldSpeccrewRC(projectRoot, workspaceDir) {
+  const oldRcPath = path.join(projectRoot, '.speccrewrc');
+  const newRcPath = path.join(workspaceDir, '.speccrewrc');
+  
+  if (fs.existsSync(oldRcPath) && !fs.existsSync(newRcPath)) {
+    fs.renameSync(oldRcPath, newRcPath);
+    return true;
+  }
+  return false;
+}
+
+// 统计 agents 和 skills 数量
+function countAgentsAndSkills(sourceRoot) {
+  let agentCount = 0;
+  let skillCount = 0;
+  
+  const agentsSourceDir = path.join(sourceRoot, 'agents');
+  const skillsSourceDir = path.join(sourceRoot, 'skills');
+  
+  if (fs.existsSync(agentsSourceDir)) {
+    const entries = fs.readdirSync(agentsSourceDir, { withFileTypes: true });
+    agentCount = entries.filter(e => isSpeccrewFile(e.name)).length;
+  }
+  
+  if (fs.existsSync(skillsSourceDir)) {
+    const entries = fs.readdirSync(skillsSourceDir, { withFileTypes: true });
+    skillCount = entries.filter(e => isSpeccrewFile(e.name)).length;
+  }
+  
+  return { agentCount, skillCount };
+}
+
+// 询问用户确认
+function askConfirm(message) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    
+    rl.question(message, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      resolve(normalized === '' || normalized === 'y' || normalized === 'yes');
+    });
+  });
+}
+
+// 核心安装逻辑
+async function runInit(options = {}) {
+  const {
+    projectRoot = process.cwd(),
+    ideArg = null,
+    silent = false,
+    skipConfirm = false,
+  } = options;
+  
+  const log = silent ? () => {} : console.log;
+  
   try {
-    // 1. 解析参数
-    const { ide: cliIdeArg } = parseArgs();
+    // 1. 检查 Node.js 版本
+    checkNodeVersion();
+    
+    // 2. 确定源文件路径
+    const sourceRoot = getSourceRoot();
+    const packageRoot = getPackageRoot();
     
-    // 2. 确定项目根目录
-    const projectRoot = process.cwd();
+    // 3. 解析 IDE
+    if (!silent) printProgress(1, 5, 'Detecting IDE environment');
+    const ideConfigs = resolveIDE(projectRoot, ideArg);
+    if (!silent) printDone();
     
-    // 3. 检查 Node.js 版本
-    checkNodeVersion();
+    // 4. 统计 agents 和 skills 数量
+    const { agentCount, skillCount } = countAgentsAndSkills(sourceRoot);
     
-    // 4. 解析 IDE
-    const ideConfigs = resolveIDE(projectRoot, cliIdeArg);
+    // 5. 显示安装摘要并确认
+    const version = getPackageVersion();
+    const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
     
-    // 5. 确定源文件路径
-    const sourceRoot = getSourceRoot();
+    if (!skipConfirm && !silent) {
+      log(`\nSpecCrew v${version}\n`);
+      log('Installation Summary:');
+      if (ideConfigs.length === 1) {
+        log(`  IDE:       ${ideConfigs[0].name} (${ideConfigs[0].baseDir}/)`);
+      } else {
+        log(`  IDE:       ${ideConfigs.map(c => c.name).join(', ')}`);
+      }
+      log(`  Agents:    ${agentCount} agents`);
+      log(`  Skills:    ${skillCount} skills`);
+      log(`  Workspace: speccrew-workspace/\n`);
+      
+      const confirmed = await askConfirm('Proceed with installation? (Y/n) ');
+      if (!confirmed) {
+        log('Installation cancelled.');
+        return { cancelled: true };
+      }
+      log('');
+    }
+    
+    // 6. 迁移旧的 .speccrewrc（如果存在）
+    migrateOldSpeccrewRC(projectRoot, workspaceDir);
     
     // 统计信息
     const stats = {
@@ -167,17 +325,19 @@ function run() {
       totalAgents: 0,
       totalSkills: 0,
       workspaceCreated: false,
+      docsInstalled: 0,
     };
     
-    // 6. 对每个检测到的 IDE 复制 agents 和 skills
+    // 7. 复制 agents 和 skills
+    if (!silent) printProgress(2, 5, `Installing agents (${agentCount})`);
     for (const ideConfig of ideConfigs) {
       const agentsSourceDir = path.join(sourceRoot, 'agents');
       const skillsSourceDir = path.join(sourceRoot, 'skills');
       const agentsDestDir = path.join(projectRoot, ideConfig.agentsDir);
       const skillsDestDir = path.join(projectRoot, ideConfig.skillsDir);
       
-      const agentsResult = copyAgents(agentsSourceDir, agentsDestDir);
-      const skillsResult = copySkills(skillsSourceDir, skillsDestDir);
+      const agentsResult = copyAgents(agentsSourceDir, agentsDestDir, ideConfig);
+      const skillsResult = copySkills(skillsSourceDir, skillsDestDir, ideConfig);
       
       stats.ides.push({
         name: ideConfig.name,
@@ -188,44 +348,81 @@ function run() {
       stats.totalAgents += agentsResult.copied;
       stats.totalSkills += skillsResult.copied;
     }
+    if (!silent) printDone();
     
-    // 7. 创建 speccrew-workspace 目录结构
-    const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
+    // 8. 复制 skills（显示进度）
+    if (!silent) printProgress(3, 5, `Installing skills (${skillCount})`);
+    // skills 已经在上面复制完成，这里只是显示进度
+    if (!silent) printDone();
+    
+    // 9. 创建 speccrew-workspace 目录结构
+    if (!silent) printProgress(4, 5, 'Creating workspace structure');
     createWorkspaceStructure(workspaceDir);
     stats.workspaceCreated = true;
+    if (!silent) printDone();
     
-    // 8. 复制 workspace 模板
+    // 10. 复制 workspace 模板
     const templateDir = getWorkspaceTemplatePath();
     copyWorkspaceTemplate(templateDir, workspaceDir);
     
-    // 9. 写入 .speccrewrc
-    const version = getPackageVersion();
+    // 11. 复制文档
+    if (!silent) printProgress(5, 5, 'Installing documentation');
+    const docsResult = copyDocs(packageRoot, workspaceDir);
+    stats.docsInstalled = docsResult.copied;
+    if (!silent) printDone();
+    
+    // 12. 写入 .speccrewrc 到 workspace 目录
     const rcConfig = {
       ide: ideConfigs.length === 1 ? ideConfigs[0].id : ideConfigs.map(c => c.id),
       version: version,
       installedAt: new Date().toISOString(),
     };
-    writeSpeccrewRC(projectRoot, rcConfig);
+    writeSpeccrewRC(workspaceDir, rcConfig);
     
-    // 10. 输出安装摘要
-    console.log(`SpecCrew v${version} installed successfully!\n`);
-    
-    for (const ide of stats.ides) {
-      console.log(`IDE: ${ide.name} (${ide.baseDir}/)`);
-      console.log(`Agents: ${ide.agents} installed`);
-      console.log(`Skills: ${ide.skills} installed`);
-    }
-    
-    if (stats.workspaceCreated) {
-      console.log('Workspace: speccrew-workspace/ created');
+    // 13. 输出安装摘要
+    if (!silent) {
+      log(`\nSpecCrew v${version} installed successfully!\n`);
+      
+      if (ideConfigs.length === 1) {
+        log(`  IDE:       ${ideConfigs[0].name} (${ideConfigs[0].baseDir}/)`);
+      } else {
+        log(`  IDE:       ${ideConfigs.map(c => c.name).join(', ')}`);
+      }
+      log(`  Agents:    ${stats.totalAgents} installed`);
+      log(`  Skills:    ${stats.totalSkills} installed`);
+      log(`  Workspace: speccrew-workspace/ created`);
+      log(`  Docs:      ${stats.docsInstalled} files installed`);
+      
+      log(`\nRun 'speccrew doctor' to verify your installation.`);
     }
     
-    console.log('\nGet started: Ask your AI agent to help with your project!');
+    return {
+      success: true,
+      version,
+      stats,
+      ideConfigs,
+    };
     
   } catch (error) {
-    console.error(`Error: ${error.message}`);
-    process.exit(1);
+    if (!silent) {
+      console.error(`Error: ${error.message}`);
+    }
+    throw error;
   }
 }
 
-module.exports = { run };
+// CLI 入口
+function run() {
+  const { ide: cliIdeArg } = parseArgs();
+  
+  runInit({
+    projectRoot: process.cwd(),
+    ideArg: cliIdeArg,
+    silent: false,
+    skipConfirm: false,
+  }).catch(() => {
+    process.exit(1);
+  });
+}
+
+module.exports = { runInit, run };

package/lib/commands/uninstall.js

@@ -1,32 +1,141 @@
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline');
 const { readSpeccrewRC, isSpeccrewFile, removeDirRecursive } = require('../utils');
 
 function run(projectRoot, args) {
-  // 检查是否已初始化
-  const rc = readSpeccrewRC(projectRoot);
+  // 检查是否已初始化（兼容新旧两个路径）
+  let rc = readSpeccrewRC(projectRoot);
+  const newRcPath = path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
+  
+  // 如果旧路径没有配置文件，检查新路径
+  if (!rc && fs.existsSync(newRcPath)) {
+    try {
+      rc = JSON.parse(fs.readFileSync(newRcPath, 'utf8'));
+    } catch (e) {
+      // 忽略解析错误
+    }
+  }
+  
   if (!rc) {
     console.log('SpecCrew is not initialized in this project.');
     console.log('Run "speccrew init" to initialize.');
     return false;
   }
 
-  console.log('SpecCrew Uninstall\n');
-
   const isAll = args.includes('--all');
-  let removedAgents = 0;
-  let removedSkills = 0;
-  const removedItems = [];
 
   // 获取 IDE 配置
   const ides = rc.ide ? (Array.isArray(rc.ide) ? rc.ide : [rc.ide]) : [];
 
-  // 删除每个 IDE 目录下的 speccrew-* agents 和 skills
+  // 扫描将要删除的内容（不实际删除）
+  let totalAgents = 0;
+  let totalSkills = 0;
+  const idePaths = [];
+
   for (const ideId of ides) {
     const ideConfig = getIDEConfig(ideId);
     if (!ideConfig) continue;
 
-    // 删除 agents
+    let agentCount = 0;
+    let skillCount = 0;
+
+    // 统计 agents
+    const agentsDir = path.join(projectRoot, ideConfig.agentsDir);
+    if (fs.existsSync(agentsDir)) {
+      const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (isSpeccrewFile(entry.name)) {
+          agentCount++;
+        }
+      }
+    }
+
+    // 统计 skills
+    const skillsDir = path.join(projectRoot, ideConfig.skillsDir);
+    if (fs.existsSync(skillsDir)) {
+      const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (isSpeccrewFile(entry.name)) {
+          skillCount++;
+        }
+      }
+    }
+
+    totalAgents += agentCount;
+    totalSkills += skillCount;
+    idePaths.push({ ideConfig, agentCount, skillCount });
+  }
+
+  // 检查配置文件是否存在（新路径和旧路径）
+  const oldRcPath = path.join(projectRoot, '.speccrewrc');
+  const hasNewRc = fs.existsSync(newRcPath);
+  const hasOldRc = fs.existsSync(oldRcPath);
+  const hasRcFile = hasNewRc || hasOldRc;
+
+  // 检查 workspace 是否存在
+  const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
+  const hasWorkspace = fs.existsSync(workspaceDir);
+
+  // 显示将要删除的内容
+  console.log('SpecCrew Uninstall\n');
+  console.log('The following will be removed:');
+
+  for (const { ideConfig, agentCount, skillCount } of idePaths) {
+    if (agentCount > 0) {
+      console.log(`  - ${agentCount} agent(s) from ${ideConfig.baseDir}/agents/`);
+    }
+    if (skillCount > 0) {
+      console.log(`  - ${skillCount} skill(s) from ${ideConfig.baseDir}/skills/`);
+    }
+  }
+
+  if (hasRcFile) {
+    console.log('  - SpecCrew configuration (speccrew-workspace/.speccrewrc)');
+  }
+
+  if (isAll && hasWorkspace) {
+    console.log('  - speccrew-workspace/ (including all iterations, docs and knowledge base)');
+    console.log('\nWARNING: This will permanently delete your workspace data!');
+  }
+
+  // 询问用户确认
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question('\nProceed with uninstall? (Y/n) ', (answer) => {
+      rl.close();
+
+      const confirmed = answer.toLowerCase() === 'y' || answer === '' || answer.toLowerCase() === 'yes';
+
+      if (!confirmed) {
+        console.log('Uninstall cancelled.');
+        resolve(false);
+        return;
+      }
+
+      // 执行卸载
+      const result = performUninstall(projectRoot, idePaths, isAll, hasOldRc);
+      resolve(result);
+    });
+  });
+}
+
+function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
+  let removedAgents = 0;
+  let removedSkills = 0;
+
+  // 计算总步骤数
+  const totalSteps = isAll ? 4 : 3;
+  let currentStep = 0;
+
+  // 删除 agents
+  currentStep++;
+  process.stdout.write(`[${currentStep}/${totalSteps}] Removing agents... `);
+  for (const { ideConfig } of idePaths) {
     const agentsDir = path.join(projectRoot, ideConfig.agentsDir);
     if (fs.existsSync(agentsDir)) {
       const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
@@ -39,12 +148,16 @@ function run(projectRoot, args) {
             fs.unlinkSync(fullPath);
           }
           removedAgents++;
-          removedItems.push(`${ideConfig.baseDir}/agents/${entry.name}`);
         }
       }
     }
+  }
+  console.log(`done (${removedAgents} removed)`);
 
-    // 删除 skills
+  // 删除 skills
+  currentStep++;
+  process.stdout.write(`[${currentStep}/${totalSteps}] Removing skills... `);
+  for (const { ideConfig } of idePaths) {
     const skillsDir = path.join(projectRoot, ideConfig.skillsDir);
     if (fs.existsSync(skillsDir)) {
       const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
@@ -57,39 +170,44 @@ function run(projectRoot, args) {
             fs.unlinkSync(fullPath);
           }
           removedSkills++;
-          removedItems.push(`${ideConfig.baseDir}/skills/${entry.name}`);
         }
       }
     }
   }
+  console.log(`done (${removedSkills} removed)`);
+
+  // 删除配置文件
+  currentStep++;
+  process.stdout.write(`[${currentStep}/${totalSteps}] Removing configuration... `);
+
+  // 删除新路径的配置文件
+  const newRcPath = path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
+  if (fs.existsSync(newRcPath)) {
+    fs.unlinkSync(newRcPath);
+  }
+
+  // 兼容处理：删除旧路径的配置文件
+  const oldRcPath = path.join(projectRoot, '.speccrewrc');
+  if (fs.existsSync(oldRcPath)) {
+    fs.unlinkSync(oldRcPath);
+  }
+
+  console.log('done');
 
   // 如果 --all，删除 workspace
-  let workspaceRemoved = false;
   if (isAll) {
+    currentStep++;
+    process.stdout.write(`[${currentStep}/${totalSteps}] Removing workspace... `);
     const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
     if (fs.existsSync(workspaceDir)) {
       removeDirRecursive(workspaceDir);
-      workspaceRemoved = true;
-      removedItems.push('speccrew-workspace/');
     }
-  }
+    console.log('done');
 
-  // 删除 .speccrewrc
-  const rcPath = path.join(projectRoot, '.speccrewrc');
-  if (fs.existsSync(rcPath)) {
-    fs.unlinkSync(rcPath);
-    removedItems.push('.speccrewrc');
-  }
-
-  // 输出摘要
-  console.log(`Removed ${removedAgents} agent(s) and ${removedSkills} skill(s)`);
-  if (workspaceRemoved) {
-    console.log('Removed speccrew-workspace/');
-  }
-  console.log('Removed .speccrewrc');
-  console.log('\nSpecCrew has been uninstalled.');
-  if (!isAll) {
-    console.log('Workspace data preserved. Use --all to remove everything.');
+    console.log('\nSpecCrew has been completely uninstalled.');
+  } else {
+    console.log('\nSpecCrew has been uninstalled.');
+    console.log('Workspace data preserved in speccrew-workspace/');
   }
 
   return true;