specweave 0.6.8 → 0.7.0

package/src/adapters/adapter-loader.ts

@@ -1,256 +0,0 @@
-/**
- * Adapter Loader
- *
- * Loads adapters from registry, detects tools, and provides API for init command.
- * Enables SpecWeave to work with ANY AI coding tool.
- */
-
-import fs from 'fs-extra';
-import * as path from 'path';
-import * as YAML from 'yaml';
-import { execSync } from 'child_process';
-import { IAdapter } from './adapter-interface.js';
-import { CursorAdapter } from './cursor/adapter.js';
-import { GeminiAdapter } from './gemini/adapter.js';
-import { CodexAdapter } from './codex/adapter.js';
-import { GenericAdapter } from './generic/adapter.js';
-import { getDirname } from '../utils/esm-helpers.js';
-
-const __dirname = getDirname(import.meta.url);
-
-export interface AdapterRegistry {
-  version: number;
-  last_updated: string;
-  adapters: Array<{
-    name: string;
-    description: string;
-    automation_level: string;
-    status: string;
-    directory: string;
-    market_share: string;
-    priority: string;
-  }>;
-}
-
-/**
- * Adapter Loader - Main API for working with adapters
- */
-export class AdapterLoader {
-  private adapters: Map<string, IAdapter> = new Map();
-  private registry: AdapterRegistry | null = null;
-
-  constructor() {
-    this.initializeAdapters();
-  }
-
-  /**
-   * Initialize all adapters
-   *
-   * NOTE: Claude Code is NOT an adapter - it's the native/default experience!
-   * Adapters only exist for tools that need to APPROXIMATE Claude's native capabilities.
-   */
-  private initializeAdapters(): void {
-    // Note: No ClaudeAdapter - Claude is the baseline, not an adaptation!
-    this.adapters.set('cursor', new CursorAdapter());
-    this.adapters.set('gemini', new GeminiAdapter());
-    this.adapters.set('codex', new CodexAdapter());
-    this.adapters.set('generic', new GenericAdapter());
-  }
-
-  /**
-   * Load registry.yaml
-   */
-  async loadRegistry(): Promise<AdapterRegistry> {
-    if (this.registry) {
-      return this.registry;
-    }
-
-    // Try dist first, then fall back to src (for development)
-    let registryPath = path.join(__dirname, 'registry.yaml');
-    if (!await fs.pathExists(registryPath)) {
-      registryPath = path.join(__dirname, '../../src/adapters/registry.yaml');
-    }
-
-    const content = await fs.readFile(registryPath, 'utf-8');
-    this.registry = YAML.parse(content) as AdapterRegistry;
-
-    return this.registry;
-  }
-
-  /**
-   * Get all available adapters
-   */
-  getAllAdapters(): IAdapter[] {
-    return Array.from(this.adapters.values());
-  }
-
-  /**
-   * Get adapter by name
-   */
-  getAdapter(name: string): IAdapter | undefined {
-    return this.adapters.get(name);
-  }
-
-  /**
-   * Auto-detect which tool is being used
-   *
-   * Detection priority (based on market share and probability):
-   * 1. Claude Code (DEFAULT - best experience, native support)
-   * 2. Cursor (if cursor CLI or .cursor/ or .cursorrules exists)
-   * 3. Gemini CLI (if gemini CLI found)
-   * 4. Codex (if codex CLI found)
-   * 5. Generic (only if explicitly requested via --adapter generic)
-   *
-   * @returns Promise<string> Detected tool name (not adapter - Claude has no adapter!)
-   */
-  async detectTool(): Promise<string> {
-    console.log('🔍 Detecting AI coding tool...\n');
-
-    // Check other tools first (if they have specific indicators)
-    const detectionOrder = ['cursor', 'gemini', 'codex'];
-
-    for (const adapterName of detectionOrder) {
-      const adapter = this.adapters.get(adapterName);
-      if (!adapter) continue;
-
-      const detected = await adapter.detect();
-      if (detected) {
-        console.log(`✅ Detected: ${adapter.name} (${adapter.automationLevel} automation)`);
-        return adapterName;
-      }
-    }
-
-    // Default to Claude Code (best experience, native support)
-    // Users can override with --adapter flag if they want a different tool
-    console.log(`✅ Detected: claude (native - full automation)`);
-    return 'claude';
-  }
-
-  /**
-   * Helper: Check if a command exists in PATH
-   * Cross-platform: uses 'where' on Windows, 'which' on Unix
-   */
-  private async commandExists(command: string): Promise<boolean> {
-    try {
-      const isWindows = process.platform === 'win32';
-      const checkCommand = isWindows ? 'where' : 'which';
-      execSync(`${checkCommand} ${command}`, { stdio: 'ignore' });
-      return true;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * Helper: Check if a file exists
-   */
-  private async fileExists(filePath: string): Promise<boolean> {
-    try {
-      await fs.access(filePath);
-      return true;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * Check requirements for a specific adapter
-   */
-  async checkRequirements(adapterName: string): Promise<void> {
-    const adapter = this.adapters.get(adapterName);
-    if (!adapter) {
-      throw new Error(`Adapter not found: ${adapterName}`);
-    }
-
-    const result = await adapter.checkRequirements();
-
-    if (!result.met) {
-      console.error('\n❌ Requirements not met:\n');
-      result.missing.forEach(req => console.error(`  - ${req}`));
-      throw new Error('System requirements not met');
-    }
-
-    if (result.warnings.length > 0) {
-      console.warn('\n⚠️  Warnings:\n');
-      result.warnings.forEach(warning => console.warn(`  - ${warning}`));
-    }
-  }
-
-  /**
-   * List all available adapters with details
-   */
-  async listAdapters(): Promise<void> {
-    const registry = await this.loadRegistry();
-
-    console.log('\n📋 SpecWeave Tool Support:\n');
-    console.log('━'.repeat(70));
-    console.log('');
-
-    // Show Claude first (baseline, not an adapter)
-    const claudeInfo = registry.adapters.find(a => a.name === 'claude');
-    if (claudeInfo) {
-      console.log(`🚀 CLAUDE CODE (Baseline - No Adapter Needed)`);
-      console.log(`   ${claudeInfo.description}`);
-      console.log(`   Native: skills, agents, hooks, slash commands | Market: ${claudeInfo.market_share}`);
-      console.log('');
-    }
-
-    console.log('📦 Adapters (For Other Tools):\n');
-
-    // Show other adapters
-    for (const adapterInfo of registry.adapters) {
-      if (adapterInfo.name === 'claude') continue; // Skip Claude, already shown
-
-      const adapter = this.adapters.get(adapterInfo.name);
-      if (!adapter) continue;
-
-      console.log(`${this.getAutomationIcon(adapter.automationLevel)} ${adapter.name.toUpperCase()}`);
-      console.log(`   ${adapter.description}`);
-      console.log(`   Automation: ${adapter.automationLevel} | Market: ${adapterInfo.market_share}`);
-      console.log('');
-    }
-
-    console.log('━'.repeat(70));
-    console.log('\nTotal Market Coverage: 100%');
-    console.log('SpecWeave works with ANY AI coding tool!');
-    console.log('\n💡 Claude Code = Native experience (no adapter)');
-    console.log('   Other tools = Adapters approximate Claude\'s capabilities\n');
-  }
-
-  /**
-   * Get icon for automation level
-   */
-  private getAutomationIcon(level: string): string {
-    switch (level) {
-      case 'full': return '🚀';
-      case 'semi': return '⚡';
-      case 'basic': return '📝';
-      case 'manual': return '📖';
-      default: return '❓';
-    }
-  }
-
-  /**
-   * Get recommended adapter based on detection and user preference
-   */
-  async getRecommendedAdapter(explicitChoice?: string): Promise<IAdapter> {
-    // If user explicitly chose an adapter, use it
-    if (explicitChoice) {
-      const adapter = this.adapters.get(explicitChoice);
-      if (!adapter) {
-        throw new Error(`Invalid adapter: ${explicitChoice}. Use 'claude', 'cursor', or 'generic'`);
-      }
-      return adapter;
-    }
-
-    // Otherwise, auto-detect
-    const detectedName = await this.detectTool();
-    const adapter = this.adapters.get(detectedName);
-
-    if (!adapter) {
-      throw new Error(`Detected adapter not found: ${detectedName}`);
-    }
-
-    return adapter;
-  }
-}

package/src/adapters/agents-md-generator.ts

@@ -1,228 +0,0 @@
-/**
- * AGENTS.md Generator
- *
- * Generates a universal AGENTS.md file for ALL AI coding tools EXCEPT Claude Code.
- * Follows the agents.md standard: https://agents.md/
- *
- * IMPORTANT:
- * - Claude Code does NOT read this file - it only reads CLAUDE.md
- * - This file is for: Cursor, GitHub Copilot, ChatGPT, Gemini, and ANY other AI tool
- *
- * This ONE file replaces:
- * - .cursorrules (Cursor - legacy)
- * - .github/copilot/instructions.md (Copilot - no longer needed, Copilot reads AGENTS.md)
- * - Any other tool-specific configuration files
- */
-
-import { DocGenerator } from './doc-generator.js';
-import * as path from 'path';
-import fs from 'fs-extra';
-import { getDirname } from '../utils/esm-helpers.js';
-
-const __dirname = getDirname(import.meta.url);
-
-/**
- * Find the package root by walking up the directory tree looking for package.json
- * This works reliably on all platforms including Windows with UNC paths
- */
-function findPackageRoot(startDir: string): string | null {
-  let currentDir = startDir;
-  const root = path.parse(currentDir).root;
-
-  while (currentDir !== root) {
-    const packageJsonPath = path.join(currentDir, 'package.json');
-    if (fs.existsSync(packageJsonPath)) {
-      try {
-        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-        // Verify this is the specweave package
-        if (packageJson.name === 'specweave') {
-          return currentDir;
-        }
-      } catch (error) {
-        // Not a valid package.json, continue searching
-      }
-    }
-    const parentDir = path.dirname(currentDir);
-    if (parentDir === currentDir) break; // Reached root
-    currentDir = parentDir;
-  }
-
-  return null;
-}
-
-/**
- * Find template file using package root detection
- */
-function findTemplateFile(filename: string): string | null {
-  const packageRoot = findPackageRoot(__dirname);
-
-  if (packageRoot) {
-    // Try src/templates/ first (for npm installs)
-    const srcPath = path.normalize(path.join(packageRoot, 'src', 'templates', filename));
-    if (fs.existsSync(srcPath)) {
-      return srcPath;
-    }
-
-    // Try dist/templates/ (shouldn't exist but try anyway)
-    const distPath = path.normalize(path.join(packageRoot, 'dist', 'templates', filename));
-    if (fs.existsSync(distPath)) {
-      return distPath;
-    }
-
-    // Try templates/ directly in package root
-    const rootPath = path.normalize(path.join(packageRoot, 'templates', filename));
-    if (fs.existsSync(rootPath)) {
-      return rootPath;
-    }
-  }
-
-  return null;
-}
-
-export interface AgentsMdOptions {
-  projectName: string;
-  projectPath: string;
-  templatePath?: string;
-}
-
-/**
- * Generate universal AGENTS.md file
- */
-export class AgentsMdGenerator {
-  private docGen: DocGenerator;
-
-  constructor(
-    skillsDir?: string,
-    agentsDir?: string,
-    commandsDir?: string
-  ) {
-    this.docGen = new DocGenerator(skillsDir, agentsDir, commandsDir);
-  }
-
-  /**
-   * Generate complete AGENTS.md content
-   */
-  async generate(options: AgentsMdOptions): Promise<string> {
-    // Read template - use provided path or find it via package root
-    let templatePath = options.templatePath;
-
-    if (!templatePath || !await fs.pathExists(templatePath)) {
-      // Fallback: try to find template using package root detection
-      const foundPath = findTemplateFile('AGENTS.md.template');
-      if (foundPath) {
-        templatePath = foundPath;
-      } else {
-        const errorMsg = options.templatePath
-          ? `AGENTS.md template not found at: ${options.templatePath}\nAlso tried package root detection but failed.`
-          : `AGENTS.md template not found. Tried:\n  - Package root detection\n  - __dirname: ${__dirname}\n  - Default: ${path.join(__dirname, '../templates/AGENTS.md.template')}`;
-        throw new Error(errorMsg);
-      }
-    }
-
-    let content = await fs.readFile(templatePath, 'utf-8');
-
-    // Extract agents and skills
-    const skills = await this.docGen.extractSkills();
-    const agents = await this.docGen.extractAgents();
-
-    // Replace placeholders
-    content = content.replace(/\{PROJECT_NAME\}/g, options.projectName);
-    content = content.replace('{AGENTS_SECTION}', this.generateAgentsSection(agents));
-    content = content.replace('{SKILLS_SECTION}', this.generateSkillsSection(skills));
-    content = content.replace('{TIMESTAMP}', new Date().toISOString().split('T')[0]);
-
-    return content;
-  }
-
-  /**
-   * Generate agents section as simple Markdown
-   */
-  private generateAgentsSection(agents: any[]): string {
-    let section = '';
-
-    for (const agent of agents) {
-      section += `### ${agent.role}\n`;
-      section += `**Purpose**: ${agent.description}\n`;
-      section += `**When to use**: ${this.getAgentActivation(agent.name)}\n`;
-      section += `**Location**: \`.claude/agents/${agent.name}/AGENT.md\`\n\n`;
-    }
-
-    return section;
-  }
-
-  /**
-   * Get agent activation guidance
-   */
-  private getAgentActivation(agentName: string): string {
-    const activations: Record<string, string> = {
-      'pm': 'Creating requirements, user stories, product specs (WHAT/WHY)',
-      'architect': 'System design, architecture decisions, technical plans (HOW)',
-      'devops': 'Infrastructure, deployment, CI/CD pipelines',
-      'qa-lead': 'Test strategy, test cases, quality assurance',
-      'security': 'Threat modeling, security review, vulnerability assessment',
-      'tech-lead': 'Code review, best practices, refactoring',
-      'frontend': 'UI components, React/Vue/Angular implementation',
-      'nodejs-backend': 'Node.js/Express/NestJS backend APIs',
-      'python-backend': 'FastAPI/Django backend APIs',
-      'nextjs': 'Next.js App Router applications',
-      'dotnet-backend': 'ASP.NET Core backend APIs',
-      'sre': 'Incident response, troubleshooting, runbooks',
-      'docs-writer': 'Technical documentation, API docs, guides',
-      'performance': 'Performance optimization, profiling, benchmarking'
-    };
-
-    return activations[agentName] || 'Specialized tasks requiring this expertise';
-  }
-
-  /**
-   * Generate skills section as simple Markdown
-   */
-  private generateSkillsSection(skills: any[]): string {
-    let section = '';
-
-    for (const skill of skills) {
-      section += `### ${skill.name}\n`;
-      section += `**Purpose**: ${skill.description}\n`;
-      section += `**When to use**: ${this.getSkillActivation(skill.name)}\n`;
-      section += `**Location**: \`.claude/skills/${skill.name}/SKILL.md\`\n\n`;
-    }
-
-    return section;
-  }
-
-  /**
-   * Get skill activation guidance
-   */
-  private getSkillActivation(skillName: string): string {
-    const activations: Record<string, string> = {
-      'specweave-detector': 'User asks about SpecWeave commands or workflows',
-      'increment-planner': 'Creating new feature increments (/inc command)',
-      'context-loader': 'Working on increments, need to load relevant context',
-      'skill-router': 'Ambiguous requests that need routing to specific skills',
-      'spec-driven-debugging': 'Bug investigation, test failures, unexpected behavior',
-      'spec-driven-brainstorming': 'Brainstorming ideas, refining concepts, design thinking',
-      'brownfield-analyzer': 'Analyzing existing projects for SpecWeave migration',
-      'brownfield-onboarder': 'Onboarding existing projects to SpecWeave',
-      'nodejs-backend': 'Node.js/Express/NestJS backend development',
-      'python-backend': 'Python/FastAPI/Django backend development',
-      'nextjs': 'Next.js App Router application development',
-      'frontend': 'React/Vue/Angular frontend development',
-      'dotnet-backend': 'ASP.NET Core backend development',
-      'e2e-playwright': 'End-to-end testing with Playwright',
-      'jira-sync': 'JIRA integration and synchronization',
-      'github-sync': 'GitHub issues/milestones synchronization',
-      'ado-sync': 'Azure DevOps synchronization',
-      'hetzner-provisioner': 'Hetzner Cloud infrastructure provisioning',
-      'cost-optimizer': 'Cloud cost optimization and platform comparison',
-      'figma-mcp-connector': 'Figma design integration via MCP',
-      'design-system-architect': 'Design system and Atomic Design methodology',
-      'figma-designer': 'Figma design creation and design tokens',
-      'figma-implementer': 'Converting Figma designs to code',
-      'figma-to-code': 'Figma to React/Angular code generation',
-      'role-orchestrator': 'Multi-agent orchestration for complex tasks',
-      'increment-quality-judge': 'AI-powered quality assessment of specs and plans'
-    };
-
-    return activations[skillName] || 'Specialized tasks';
-  }
-}