specweave 0.6.7 → 0.7.0

package/plugins/specweave/commands/list-increments.md

@@ -1,180 +0,0 @@
-# /list-increments - View All Increments
-
-**Command**: `/list-increments [options]`
-
-**Purpose**: View all increments with status, completion, and WIP tracking
-
-**Framework**: Framework-agnostic (works with all tech stacks)
-
----
-
-## Usage
-
-```bash
-/list-increments                          # All increments
-/list-increments --status in-progress     # Filter by status
-/list-increments --priority P1            # Filter by priority
-/list-increments --verbose                # Include task details
-```
-
-## Arguments
-
-- `--status` (optional): Filter by status (backlog, planned, in-progress, completed, closed)
-- `--priority` (optional): Filter by priority (P1, P2, P3)
-- `--verbose` (optional): Show task breakdown
-- `--wip-only` (optional): Show only in-progress increments
-
----
-
-## Output
-
-### Default View
-
-```
-📊 SpecWeave Increments Overview
-
-WIP Status: 2/2 (at limit) ⚠️
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Status: in-progress (2)
-
-├── 001-core-framework [P1]
-│   ├── Progress: 88% (44/50 tasks)
-│   ├── Started: 2025-02-01 (8 months ago)
-│   ├── P1: 100% (30/30) ✅
-│   ├── P2: 80% (12/15) - 3 remaining
-│   ├── P3: 40% (2/5) - 3 remaining
-│   └── Ready to close (all P1 complete)
-│
-└── 003-jira-integration [P1]
-    ├── Progress: 40% (8/20 tasks)
-    ├── Started: 2025-09-15 (1 month ago)
-    ├── P1: 50% (5/10) ⏳
-    ├── P2: 30% (3/10)
-    └── In progress
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Status: planned (3)
-
-├── 002-enhancements [P2] - Ready to start
-│   └── 15 tasks (transferred from 001)
-│
-├── 004-github-sync [P2] - Ready to start
-│   └── 18 tasks
-│
-└── 005-cost-optimizer-v2 [P3] - Ready to start
-    └── 10 tasks
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Status: backlog (10 ideas)
-
-├── Design system improvements
-├── Performance optimizations
-├── Mobile app support
-├── Advanced analytics
-└── ... (6 more)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Status: closed (1)
-
-└── 000-project-setup [P1]
-    ├── Closed: 2025-01-15
-    ├── Completion: 100% (10/10 tasks)
-    └── Duration: 2 weeks
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-⚠️  Action needed:
-→ WIP limit reached (2/2)
-→ Close 001-core-framework to free WIP slot (88% complete, ready)
-→ Run: /close-increment 001
-
-Next steps:
-1. Close 001 to free WIP slot
-2. Start 002-enhancements
-```
-
-### Verbose View
-
-```bash
-/list-increments --verbose --status in-progress
-
-📊 In-Progress Increments (Verbose)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-001-core-framework [P1]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Title: SpecWeave Core Framework
-Status: in-progress
-Priority: P1
-Started: 2025-02-01 (8 months ago)
-Progress: 88% (44/50 tasks)
-WIP Slot: 1
-
-Task Breakdown:
-  P1 (Critical): 100% (30/30) ✅
-    ✅ T001-T030: All complete
-
-  P2 (Important): 80% (12/15)
-    ✅ T031-T042: Complete
-    ⏳ T043: In progress
-    ❌ T044-T045: Not started
-
-  P3 (Nice-to-have): 40% (2/5)
-    ✅ T046-T047: Complete
-    ❌ T048-T050: Not started
-
-Dependencies: None
-Dependent increments: 002-enhancements, 004-github-sync
-
-Ready to close: YES (all P1 complete)
-Leftover tasks: 6 (3 P2, 3 P3)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-```
-
-### Filtered Views
-
-```bash
-# Only P1 increments
-/list-increments --priority P1
-
-📊 P1 (Critical) Increments
-
-in-progress (2):
-  - 001-core-framework: 88% complete
-  - 003-jira-integration: 40% complete
-
-planned (0): None
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-# Only WIP increments
-/list-increments --wip-only
-
-📊 WIP Increments (2/2 - at limit)
-
-001-core-framework [P1]: 88% → Ready to close
-003-jira-integration [P1]: 40% → In progress
-
-⚠️ At WIP limit - close 001 to start new work
-```
-
----
-
-## Related Documentation
-
-- [CLAUDE.md](../../CLAUDE.md#increment-lifecycle-management) - Lifecycle guide
-- [.specweave/increments/README.md](../../.specweave/increments/README.md) - Increments overview
-
----
-
-**Command Type**: Status reporting
-**Framework Support**: All
-**Output**: Summary of all increments with actionable recommendations

package/src/adapters/README.md

@@ -1,311 +0,0 @@
-# SpecWeave Adapters
-
-**Version**: 0.2.0 (Multi-Tool Support)
-
-## Overview
-
-SpecWeave adapters enable the framework to work with **ANY AI coding tool**, not just Claude Code. This directory contains all adapter implementations that provide tool-specific enhancements while maintaining a tool-agnostic core.
-
-## Architecture
-
-```
-SpecWeave
-├── Core (Tool-Agnostic)
-│   └── .specweave/              # Plain Markdown + YAML
-│       ├── increments/
-│       └── docs/
-│
-└── Adapters (Optional)
-    ├── Claude                    # Full automation
-    │   ├── .claude/skills/
-    │   ├── .claude/agents/
-    │   └── .claude/hooks/
-    │
-    ├── Cursor                    # Semi-automation
-    │   └── .cursorrules
-    │
-    ├── Copilot                   # Basic automation
-    │   └── .github/copilot/instructions.md
-    │
-    └── Generic                   # Manual workflow
-        └── SPECWEAVE.md
-```
-
-## Available Adapters
-
-| Adapter | Automation | Market Share | Status |
-|---------|------------|--------------|--------|
-| **Claude** | Full (skills, agents, hooks) | 10% | ✅ Active |
-| **Cursor** | Semi (.cursorrules, @ shortcuts) | 30% | ✅ Active |
-| **Copilot** | Basic (workspace instructions) | 40% | ✅ Active |
-| **Generic** | Manual (step-by-step guide) | 20% (other tools) | ✅ Active |
-
-**Total Market Coverage**: 100% (works with ANY AI tool)
-
-## Adapter Interface
-
-All adapters implement the `IAdapter` interface defined in `adapter-interface.ts`:
-
-```typescript
-interface IAdapter {
-  name: string;
-  description: string;
-  automationLevel: 'full' | 'semi' | 'basic' | 'manual';
-
-  detect(): Promise<boolean>;
-  checkRequirements(): Promise<RequirementsResult>;
-  getFiles(): AdapterFile[];
-  install(options: AdapterOptions): Promise<void>;
-  postInstall(options: AdapterOptions): Promise<void>;
-  getInstructions(): string;
-}
-```
-
-## How Adapters Work
-
-### 1. Claude Adapter (Full Automation)
-
-**Files Installed**:
-- `.claude/skills/` - Auto-activating skills (specweave-detector, skill-router, etc.)
-- `.claude/agents/` - Specialized agents (PM, Architect, DevOps, QA, Security)
-- `.claude/commands/` - Slash commands (/create-increment, /sync-docs, etc.)
-- `.claude/hooks/` - Auto-update hooks (post-task-completion, etc.)
-
-**Features**:
-- Skills auto-activate based on user requests
-- Agents coordinate complex workflows
-- Hooks auto-update documentation
-- Slash commands for quick actions
-- Best-in-class experience
-
-**Detection**: Checks for Claude Code CLI
-
----
-
-### 2. Cursor Adapter (Semi-Automation)
-
-**Files Installed**:
-- `.cursorrules` - Workflow instructions for Cursor AI
-- `.cursor/context/` - Context shortcut files
-
-**Features**:
-- @ shortcuts: `@increments`, `@docs`, `@strategy`
-- Composer multi-file editing guided by .cursorrules
-- Context manifests work via manual reference
-
-**Workflow Instructions** (in .cursorrules):
-```markdown
-# SpecWeave Configuration for Cursor
-
-## When user requests a feature:
-1. Check if increment exists in `.specweave/increments/####-name/`
-2. If not, create: spec.md, plan.md, tasks.md
-
-## Context Loading (70%+ Token Reduction)
-**CRITICAL**: Always read `context-manifest.yaml` first!
-Only load files listed in manifest.
-```
-
-**Detection**: Checks for Cursor editor process or .cursor/ directory
-
----
-
-### 3. Copilot Adapter (Basic Automation)
-
-**Files Installed**:
-- `.github/copilot/instructions.md` - Workspace instructions for Copilot
-
-**Features**:
-- Workspace-level guidance read by Copilot
-- Context manifests referenced in instructions
-- Suggestions based on SpecWeave structure
-
-**Instruction File** (.github/copilot/instructions.md):
-```markdown
-# SpecWeave Workspace Instructions
-
-## Project Overview
-This project uses SpecWeave for spec-driven development.
-
-## Workflow: Creating Features
-1. Create increment folder: `.specweave/increments/####-short-name/`
-2. Create spec.md (WHAT and WHY)
-3. Create plan.md (HOW)
-4. Create tasks.md (Implementation)
-
-## Context Loading (CRITICAL)
-Always read context-manifest.yaml first!
-```
-
-**Detection**: Checks for GitHub Copilot extension in VS Code
-
----
-
-### 4. Generic Adapter (Manual Workflow)
-
-**Files Installed**:
-- `SPECWEAVE.md` - Complete step-by-step manual guide
-
-**Features**:
-- Works with ANY AI tool (ChatGPT web, Claude web, Gemini, etc.)
-- Clear manual workflow
-- Copy-paste instructions
-- 100% compatibility (no tool dependencies)
-
-**Manual Guide** (SPECWEAVE.md):
-```markdown
-# SpecWeave Manual Workflow
-
-## Step 1: Create Feature
-```bash
-mkdir -p .specweave/increments/0001-feature-name
-```
-
-## Step 2: Create spec.md
-[Detailed template and instructions]
-
-## Step 3: Load Context
-Copy files listed in `context-manifest.yaml` to your AI chat.
-```
-
-**Detection**: Always returns `true` (universal fallback)
-
----
-
-## Command Mechanism
-
-**Critical Insight**: Commands work differently across tools.
-
-### Claude Code (Native Slash Commands)
-- User types `/create-increment "user auth"` in Claude chat
-- Command file in `.claude/commands/create-increment.md` is loaded
-- Command executes with full context
-
-### Cursor (Instruction-Based)
-- User types: "create increment for user auth"
-- Cursor reads `.cursorrules` which contains workflow instructions
-- AI follows instructions step-by-step
-
-### GitHub Copilot (Instruction Files)
-- User types: "create increment for user auth"
-- Copilot reads `.github/copilot/instructions.md`
-- AI follows workspace instructions
-
-### Generic (Manual Copy-Paste)
-- User reads `SPECWEAVE.md`
-- User copies relevant sections to AI chat
-- User guides AI through workflow manually
-
-**Pattern**: Each adapter uses **instruction files** appropriate to the tool's capabilities.
-
-## Installation
-
-### For Users (Select Adapter)
-
-```bash
-# Auto-detect tool and install appropriate adapter
-npx specweave init my-project
-
-# Or specify adapter explicitly
-npx specweave init my-project --adapter claude
-npx specweave init my-project --adapter cursor
-npx specweave init my-project --adapter copilot
-npx specweave init my-project --adapter generic
-```
-
-### For Developers (Install All Adapters)
-
-```bash
-# Install all adapters to SpecWeave framework
-npm run install:adapters
-```
-
-## Adding New Adapters
-
-To add support for a new tool:
-
-1. **Create adapter directory**: `src/adapters/your-tool/`
-2. **Create adapter class**: `src/adapters/your-tool/adapter.ts`
-3. **Implement IAdapter interface**
-4. **Add template files**: Tool-specific instruction files
-5. **Add to registry**: Update `registry.yaml`
-6. **Add test cases**: Minimum 3 test cases
-7. **Update CLI**: Add detection logic
-
-**Example**:
-```typescript
-// src/adapters/windsurf/adapter.ts
-import { AdapterBase } from '../adapter-base';
-
-export class WindsurfAdapter extends AdapterBase {
-  name = 'windsurf';
-  description = 'Windsurf adapter with semi-automation';
-  automationLevel = 'semi' as const;
-
-  async detect(): Promise<boolean> {
-    // Check if Windsurf is installed
-    return this.commandExists('windsurf');
-  }
-
-  getFiles(): AdapterFile[] {
-    return [
-      {
-        sourcePath: '.windsurfrules',
-        targetPath: '.windsurfrules',
-        description: 'Windsurf workflow instructions'
-      }
-    ];
-  }
-
-  getInstructions(): string {
-    return `
-# Windsurf Adapter Installed
-
-Your project is now configured for Windsurf.
-...
-    `;
-  }
-}
-```
-
-## Testing Adapters
-
-Each adapter MUST have minimum 3 test cases in `test-cases/`:
-
-```
-src/adapters/cursor/
-├── adapter.ts
-├── .cursorrules (template)
-└── test-cases/
-    ├── test-1-install.yaml
-    ├── test-2-detection.yaml
-    └── test-3-workflow.yaml
-```
-
-## Related Documentation
-
-- [adapter-interface.ts](./adapter-interface.ts) - Complete interface definition
-- [adapter-base.ts](./adapter-base.ts) - Base class implementation
-- [registry.yaml](./registry.yaml) - List of all adapters
-- [.specweave/increments/0002-multi-tool-support/](../../.specweave/increments/0002-multi-tool-support/) - Implementation plan
-
-## Design Philosophy
-
-**Core Principle**: Separate tool-agnostic core from tool-specific enhancements.
-
-**Benefits**:
-1. ✅ Users can switch AI tools without losing SpecWeave benefits
-2. ✅ 100% market coverage (works with ANY AI)
-3. ✅ No tool lock-in
-4. ✅ Best experience with supported tools, functional experience with any tool
-5. ✅ Easy to add support for new tools
-
-**Inspiration**:
-- **spec-kit** (GitHub): Agent-agnostic approach, plain text commands
-- **BMAD-METHOD**: Portable prompt bundles work across multiple AIs
-
----
-
-**Status**: Implementation in progress (Increment 0002)
-**Branch**: features/002-multi-tool-support
-**Target**: v0.2.0-beta.1

package/src/adapters/adapter-base.ts

@@ -1,182 +0,0 @@
-/**
- * Base Adapter Class
- *
- * Provides common functionality for all adapters.
- * Concrete adapters extend this class and implement tool-specific logic.
- */
-
-import fs from 'fs-extra';
-import * as path from 'path';
-import { execSync } from 'child_process';
-import {
-  IAdapter,
-  AdapterOptions,
-  RequirementsResult,
-  AdapterFile,
-  AutomationLevel
-} from './adapter-interface.js';
-import { getDirname } from '../utils/esm-helpers.js';
-import type { Plugin } from '../core/types/plugin.js';
-
-const __dirname = getDirname(import.meta.url);
-
-export abstract class AdapterBase implements IAdapter {
-  abstract name: string;
-  abstract description: string;
-  abstract automationLevel: AutomationLevel;
-
-  /**
-   * Default detection - override in concrete adapters
-   */
-  async detect(): Promise<boolean> {
-    return false;
-  }
-
-  /**
-   * Check common requirements (Node.js, Git)
-   * Concrete adapters can override to add tool-specific checks
-   */
-  async checkRequirements(): Promise<RequirementsResult> {
-    const result: RequirementsResult = {
-      met: true,
-      missing: [],
-      warnings: []
-    };
-
-    // Check Node.js version
-    const nodeVersion = process.version;
-    const majorVersion = parseInt(nodeVersion.split('.')[0].slice(1));
-
-    if (majorVersion < 18) {
-      result.met = false;
-      result.missing.push(`Node.js >= 18.0.0 (current: ${nodeVersion})`);
-    }
-
-    // Check Git
-    try {
-      execSync('git --version', { stdio: 'ignore' });
-    } catch (error) {
-      result.warnings.push('Git not found - version control features may not work');
-    }
-
-    return result;
-  }
-
-  /**
-   * Get files to install - must be implemented by concrete adapters
-   */
-  abstract getFiles(): AdapterFile[];
-
-  /**
-   * Install adapter files to project
-   */
-  async install(options: AdapterOptions): Promise<void> {
-    const files = this.getFiles();
-    const adapterSourceDir = path.join(__dirname, this.name);
-
-    console.log(`\n📦 Installing ${this.name} adapter files...`);
-
-    for (const file of files) {
-      const sourcePath = path.join(adapterSourceDir, file.sourcePath);
-      const targetPath = path.join(options.projectPath, file.targetPath);
-
-      // Ensure target directory exists
-      await fs.ensureDir(path.dirname(targetPath));
-
-      // Copy file
-      if (await fs.pathExists(sourcePath)) {
-        await fs.copy(sourcePath, targetPath);
-        console.log(`  ✅ ${file.targetPath} - ${file.description}`);
-      } else {
-        console.warn(`  ⚠️  Source file not found: ${sourcePath}`);
-      }
-    }
-  }
-
-  /**
-   * Post-installation actions - can be overridden by concrete adapters
-   */
-  async postInstall(options: AdapterOptions): Promise<void> {
-    // Default: Display instructions
-    console.log('\n' + this.getInstructions());
-  }
-
-  /**
-   * Get usage instructions - must be implemented by concrete adapters
-   */
-  abstract getInstructions(): string;
-
-  /**
-   * Helper: Check if a command exists in PATH
-   */
-  protected async commandExists(command: string): Promise<boolean> {
-    try {
-      const { execSync } = require('child_process');
-      execSync(`which ${command}`, { stdio: 'ignore' });
-      return true;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * Helper: Check if a file exists
-   */
-  protected async fileExists(filePath: string): Promise<boolean> {
-    try {
-      await fs.access(filePath);
-      return true;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * Helper: Read template file and replace variables
-   */
-  protected async readTemplate(
-    templatePath: string,
-    variables: Record<string, string>
-  ): Promise<string> {
-    let content = await fs.readFile(templatePath, 'utf-8');
-
-    // Replace all {{variable}} with actual values
-    for (const [key, value] of Object.entries(variables)) {
-      content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
-    }
-
-    return content;
-  }
-
-  /**
-   * Check if this adapter supports plugins
-   * Default: No plugin support (override in concrete adapters)
-   */
-  supportsPlugins(): boolean {
-    return false;
-  }
-
-  /**
-   * Compile and install a plugin
-   * Default: Throw error (override in concrete adapters that support plugins)
-   */
-  async compilePlugin(plugin: Plugin): Promise<void> {
-    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
-  }
-
-  /**
-   * Unload a plugin
-   * Default: Throw error (override in concrete adapters that support plugins)
-   */
-  async unloadPlugin(pluginName: string): Promise<void> {
-    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
-  }
-
-  /**
-   * Get installed plugins
-   * Default: Return empty array (override in concrete adapters that support plugins)
-   */
-  async getInstalledPlugins(): Promise<string[]> {
-    return [];
-  }
-}