specweave 0.6.7 → 0.7.0

package/src/adapters/adapter-interface.ts

@@ -1,166 +0,0 @@
-/**
- * Adapter Interface for Multi-Tool Support
- *
- * Defines the contract that all SpecWeave adapters must implement.
- * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot, etc.)
- */
-
-import type { Plugin } from '../core/types/plugin.js';
-
-export interface AdapterOptions {
-  projectPath: string;
-  projectName: string;
-  techStack?: {
-    language: string;
-    framework?: string;
-  };
-  docsApproach?: 'comprehensive' | 'incremental';
-}
-
-export interface RequirementsResult {
-  met: boolean;
-  missing: string[];
-  warnings: string[];
-}
-
-export interface AdapterFile {
-  sourcePath: string;      // Path in src/adapters/{adapter-name}/
-  targetPath: string;       // Path in user's project (relative to project root)
-  description: string;      // What this file does
-}
-
-export type AutomationLevel = 'full' | 'semi' | 'basic' | 'manual';
-
-/**
- * Base Adapter Interface
- *
- * All adapters (Claude, Cursor, Copilot, Generic) must implement this interface.
- */
-export interface IAdapter {
-  /**
-   * Adapter name (e.g., 'claude', 'cursor', 'copilot', 'generic')
-   */
-  name: string;
-
-  /**
-   * Human-readable description of what this adapter provides
-   */
-  description: string;
-
-  /**
-   * Automation level this adapter provides
-   * - full: Complete automation (skills, agents, hooks auto-activate)
-   * - semi: Semi-automated (context shortcuts, multi-file editing)
-   * - basic: Basic automation (workspace instructions, suggestions)
-   * - manual: Manual workflow (step-by-step guide)
-   */
-  automationLevel: AutomationLevel;
-
-  /**
-   * Detect if this adapter's tool is present in the environment
-   *
-   * Examples:
-   * - Claude: Check for Claude Code CLI
-   * - Cursor: Check for .cursor/ directory or Cursor process
-   * - Copilot: Check for .github/copilot/ or Copilot extension
-   *
-   * @returns Promise<boolean> True if tool detected
-   */
-  detect(): Promise<boolean>;
-
-  /**
-   * Check if system requirements are met for this adapter
-   *
-   * Examples:
-   * - Node.js version >= 18
-   * - Git installed
-   * - Tool-specific requirements
-   *
-   * @returns Promise<RequirementsResult> Requirements check result
-   */
-  checkRequirements(): Promise<RequirementsResult>;
-
-  /**
-   * Get list of files this adapter will install
-   *
-   * @returns AdapterFile[] Array of files to install
-   */
-  getFiles(): AdapterFile[];
-
-  /**
-   * Install this adapter to a project
-   *
-   * Creates tool-specific files (e.g., .cursorrules, .github/copilot/instructions.md)
-   * Installs relevant skills/agents if applicable
-   *
-   * @param options Installation options
-   * @returns Promise<void>
-   */
-  install(options: AdapterOptions): Promise<void>;
-
-  /**
-   * Post-installation actions
-   *
-   * Examples:
-   * - Create symlinks
-   * - Update config files
-   * - Display setup instructions to user
-   *
-   * @param options Installation options
-   * @returns Promise<void>
-   */
-  postInstall(options: AdapterOptions): Promise<void>;
-
-  /**
-   * Get human-readable instructions for using this adapter
-   *
-   * Displayed to user after installation
-   *
-   * @returns string Markdown-formatted instructions
-   */
-  getInstructions(): string;
-
-  /**
-   * Check if this adapter supports plugins
-   *
-   * Returns true if the adapter can install and compile plugins
-   * (Claude native, Cursor AGENTS.md, Copilot instructions.md)
-   * Returns false for generic/manual adapters
-   *
-   * @returns boolean True if plugins are supported
-   */
-  supportsPlugins(): boolean;
-
-  /**
-   * Compile and install a plugin for this adapter
-   *
-   * Transforms plugin content (skills/agents/commands) to tool-specific format:
-   * - Claude: Copy to .claude/skills/, .claude/agents/, .claude/commands/
-   * - Cursor: Compile to AGENTS.md + team commands JSON
-   * - Copilot: Compile to .github/copilot/instructions.md
-   * - Generic: Generate manual copy-paste instructions
-   *
-   * @param plugin Plugin to compile and install
-   * @returns Promise<void>
-   */
-  compilePlugin(plugin: Plugin): Promise<void>;
-
-  /**
-   * Unload (disable) a plugin for this adapter
-   *
-   * Removes plugin-specific files and restores previous state
-   *
-   * @param pluginName Name of plugin to unload
-   * @returns Promise<void>
-   */
-  unloadPlugin(pluginName: string): Promise<void>;
-
-  /**
-   * Get plugin installation status
-   *
-   * Returns information about which plugins are currently installed
-   *
-   * @returns Promise<string[]> Array of installed plugin names
-   */
-  getInstalledPlugins(): Promise<string[]>;
-}

package/src/adapters/adapter-loader.ts

@@ -1,259 +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 { CopilotAdapter } from './copilot/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('copilot', new CopilotAdapter());
-    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. Copilot (if .github/copilot/ exists)
-   * 6. 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', 'copilot'];
-
-    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', 'copilot', 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, Gemini CLI, Codex, GitHub Copilot, and ANY other AI tool
- *
- * This ONE file replaces:
- * - .cursorrules (Cursor)
- * - .github/copilot/instructions.md (Copilot)
- * - 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';
-  }
-}