specweave 0.33.4 → 0.33.6

package/plugins/specweave-core/skills/design-patterns/SKILL.md

@@ -1,245 +0,0 @@
----
-name: design-patterns
-description: Expert knowledge of Gang of Four (GoF) design patterns including creational (Singleton, Factory, Builder, Prototype), structural (Adapter, Decorator, Proxy, Facade), and behavioral (Strategy, Observer, Command, Template Method, Chain of Responsibility). Modern TypeScript/JavaScript implementations with real-world use cases. Activates for design patterns, factory pattern, singleton, strategy pattern, observer pattern, decorator pattern, adapter pattern, builder pattern, proxy pattern, facade pattern, template method.
-allowed-tools: Read, Grep, Glob
----
-
-# Design Patterns Expert
-
-Master of GoF design patterns with modern TypeScript implementations.
-
-## Creational Patterns
-
-**Factory Pattern**:
-```typescript
-interface Animal {
-  speak(): string;
-}
-
-class Dog implements Animal {
-  speak() { return 'Woof!'; }
-}
-
-class Cat implements Animal {
-  speak() { return 'Meow!'; }
-}
-
-class AnimalFactory {
-  static create(type: 'dog' | 'cat'): Animal {
-    switch (type) {
-      case 'dog': return new Dog();
-      case 'cat': return new Cat();
-    }
-  }
-}
-```
-
-**Singleton Pattern**:
-```typescript
-class Database {
-  private static instance: Database;
-  
-  private constructor() {} // Private constructor
-  
-  static getInstance(): Database {
-    if (!Database.instance) {
-      Database.instance = new Database();
-    }
-    return Database.instance;
-  }
-}
-```
-
-**Builder Pattern**:
-```typescript
-class UserBuilder {
-  private user: Partial<User> = {};
-  
-  setName(name: string) {
-    this.user.name = name;
-    return this;
-  }
-  
-  setEmail(email: string) {
-    this.user.email = email;
-    return this;
-  }
-  
-  build(): User {
-    if (!this.user.name || !this.user.email) {
-      throw new Error('Missing required fields');
-    }
-    return this.user as User;
-  }
-}
-
-// Usage
-const user = new UserBuilder()
-  .setName('John')
-  .setEmail('john@example.com')
-  .build();
-```
-
-## Structural Patterns
-
-**Adapter Pattern**:
-```typescript
-// Old API
-class OldLogger {
-  logMessage(message: string) { console.log(message); }
-}
-
-// New interface
-interface Logger {
-  log(level: string, message: string): void;
-}
-
-// Adapter
-class LoggerAdapter implements Logger {
-  constructor(private oldLogger: OldLogger) {}
-  
-  log(level: string, message: string) {
-    this.oldLogger.logMessage(`[${level}] ${message}`);
-  }
-}
-```
-
-**Decorator Pattern**:
-```typescript
-interface Coffee {
-  cost(): number;
-  description(): string;
-}
-
-class SimpleCoffee implements Coffee {
-  cost() { return 5; }
-  description() { return 'Simple coffee'; }
-}
-
-class MilkDecorator implements Coffee {
-  constructor(private coffee: Coffee) {}
-  
-  cost() { return this.coffee.cost() + 2; }
-  description() { return this.coffee.description() + ', milk'; }
-}
-
-// Usage
-let coffee: Coffee = new SimpleCoffee();
-coffee = new MilkDecorator(coffee);
-coffee.cost(); // 7
-```
-
-**Proxy Pattern**:
-```typescript
-class RealImage {
-  constructor(private filename: string) {
-    this.loadFromDisk();
-  }
-  
-  private loadFromDisk() {
-    console.log('Loading:', this.filename);
-  }
-  
-  display() {
-    console.log('Displaying:', this.filename);
-  }
-}
-
-class ProxyImage {
-  private realImage?: RealImage;
-  
-  constructor(private filename: string) {}
-  
-  display() {
-    if (!this.realImage) {
-      this.realImage = new RealImage(this.filename); // Lazy loading
-    }
-    this.realImage.display();
-  }
-}
-```
-
-## Behavioral Patterns
-
-**Strategy Pattern**:
-```typescript
-interface SortStrategy {
-  sort(data: number[]): number[];
-}
-
-class QuickSort implements SortStrategy {
-  sort(data: number[]) { /* quicksort */ return data; }
-}
-
-class MergeSort implements SortStrategy {
-  sort(data: number[]) { /* mergesort */ return data; }
-}
-
-class Sorter {
-  constructor(private strategy: SortStrategy) {}
-  
-  setStrategy(strategy: SortStrategy) {
-    this.strategy = strategy;
-  }
-  
-  sort(data: number[]) {
-    return this.strategy.sort(data);
-  }
-}
-```
-
-**Observer Pattern**:
-```typescript
-interface Observer {
-  update(data: any): void;
-}
-
-class Subject {
-  private observers: Observer[] = [];
-  
-  attach(observer: Observer) {
-    this.observers.push(observer);
-  }
-  
-  notify(data: any) {
-    this.observers.forEach(o => o.update(data));
-  }
-}
-
-class EmailObserver implements Observer {
-  update(data: any) {
-    console.log('Sending email:', data);
-  }
-}
-```
-
-**Command Pattern**:
-```typescript
-interface Command {
-  execute(): void;
-  undo(): void;
-}
-
-class SaveCommand implements Command {
-  constructor(private editor: Editor) {}
-  
-  execute() { this.editor.save(); }
-  undo() { this.editor.restore(); }
-}
-
-class CommandInvoker {
-  private history: Command[] = [];
-  
-  execute(command: Command) {
-    command.execute();
-    this.history.push(command);
-  }
-  
-  undo() {
-    const command = this.history.pop();
-    command?.undo();
-  }
-}
-```
-
-Apply design patterns to solve common problems elegantly!

package/plugins/specweave-core/skills/software-architecture/SKILL.md

@@ -1,84 +0,0 @@
----
-name: software-architecture
-description: Expert software architecture covering architectural patterns (microservices, monolith, event-driven, CQRS), scalability, distributed systems, CAP theorem, database architecture, API design, system design, domain-driven design (DDD), hexagonal architecture, and architecture decision records (ADRs). Activates for software architecture, system design, microservices, monolith, event-driven, CQRS, scalability, distributed systems, CAP theorem, DDD, hexagonal architecture, ADR.
-allowed-tools: Read, Grep, Glob
----
-
-# Software Architecture Expert
-
-Master of architectural patterns, system design, and scalability.
-
-## Architectural Patterns
-
-**Layered Architecture**:
-```
-Presentation Layer (UI)
-  ↓
-Business Logic Layer (Services)
-  ↓
-Data Access Layer (Repositories)
-  ↓
-Database
-```
-
-**Hexagonal Architecture (Ports & Adapters)**:
-```typescript
-// Core Domain (business logic, no dependencies)
-interface PaymentPort {
-  process(amount: number): Promise<void>;
-}
-
-// Adapter (infrastructure)
-class StripeAdapter implements PaymentPort {
-  async process(amount: number) { /* Stripe API */ }
-}
-
-// Application uses port, not concrete implementation
-class CheckoutService {
-  constructor(private payment: PaymentPort) {}
-}
-```
-
-**Event-Driven Architecture**:
-```typescript
-// Producer
-eventBus.publish({ type: 'OrderPlaced', orderId: '123' });
-
-// Consumers (decoupled)
-eventBus.subscribe('OrderPlaced', inventoryService.reserve);
-eventBus.subscribe('OrderPlaced', emailService.notify);
-```
-
-**CQRS** (Command Query Responsibility Segregation):
-- Commands: Write operations, change state
-- Queries: Read operations, no side effects
-- Separate models for read/write optimization
-
-## Scalability Patterns
-
-**Horizontal Scaling**: Add more servers
-**Vertical Scaling**: Bigger server
-**Caching**: Redis, CDN, application cache
-**Database Sharding**: Partition by key (user_id, region)
-**Read Replicas**: Offload read traffic
-**Load Balancing**: Distribute traffic evenly
-
-## CAP Theorem
-
-**Consistency**: All nodes see same data
-**Availability**: Every request gets response
-**Partition Tolerance**: System works despite network failures
-
-Can only guarantee 2 of 3:
-- **CP**: Consistent + Partition-tolerant (sacrifice availability)
-- **AP**: Available + Partition-tolerant (eventual consistency)
-- **CA**: Consistent + Available (no partition tolerance, single node)
-
-## Domain-Driven Design
-
-**Ubiquitous Language**: Shared vocabulary
-**Bounded Contexts**: Explicit boundaries
-**Aggregates**: Consistency boundaries
-**Entities**: Objects with identity
-**Value Objects**: Immutable, no identity
-**Domain Events**: Business occurrences

package/plugins/specweave-docs/commands/preview.md

@@ -1,274 +0,0 @@
----
-name: specweave-docs:preview
-description: Launch Docusaurus documentation server for internal living docs. Validates docs first, auto-fixes issues, auto-setup on first run. Port 3015.
----
-
-# Documentation Preview Command
-
-Launch Docusaurus development server with hot reload, Mermaid diagrams, and auto-generated sidebar.
-
-**CRITICAL**: Runs pre-flight validation to catch issues BEFORE starting the server.
-
-## Your Task
-
-**IMPORTANT**: This command must work in ANY SpecWeave user project, not just the SpecWeave repo itself.
-
-### Step 1: Check Prerequisites
-
-```bash
-# Verify internal docs exist
-ls -la .specweave/docs/internal/
-
-# If missing, inform user:
-# "No internal documentation found at .specweave/docs/internal/.
-#  Run 'specweave init' first or create the folder structure."
-```
-
-### Step 1.5: CRITICAL - Run Pre-Flight Validation
-
-**ALWAYS run validation BEFORE starting the server!**
-
-```typescript
-import { DocsValidator } from '../../../src/utils/docs-validator.js';
-
-const validator = new DocsValidator({
-  docsPath: '.specweave/docs/internal',
-  autoFix: true,  // Auto-fix common issues
-});
-
-console.log('\n🔍 Running pre-flight validation...\n');
-const result = await validator.validate();
-
-// Show summary
-console.log(DocsValidator.formatResult(result));
-
-// If errors remain after auto-fix, STOP and report
-if (!result.valid) {
-  console.log('\n❌ Documentation has errors that must be fixed before preview.');
-  console.log('   Fix the issues above, then try again.\n');
-  process.exit(1);
-}
-
-console.log('\n✅ Validation passed! Starting server...\n');
-```
-
-**What this catches:**
-- YAML frontmatter errors (unquoted colons, tabs)
-- MDX compatibility issues (unquoted attributes, unclosed tags)
-- Duplicate routes
-- Broken internal links
-
-**Auto-fixes applied:**
-- Wraps YAML values with colons in quotes
-- Quotes HTML attributes
-- Adds closing slashes to void elements (`<br>` → `<br />`)
-- Converts tabs to spaces in YAML
-
-### Step 2: Check for Cached Installation
-
-```bash
-# Check if Docusaurus is already set up in cache
-if [ -d ".specweave/cache/docs-site/node_modules" ]; then
-  echo "✓ Docusaurus installation found in cache"
-  NEEDS_INSTALL=false
-else
-  echo "⚙ First-time setup: Installing Docusaurus (~30 seconds)..."
-  NEEDS_INSTALL=true
-fi
-```
-
-### Step 3: First-Time Setup (if needed)
-
-If `NEEDS_INSTALL=true`, create the cached Docusaurus installation:
-
-```bash
-# Create cache directory
-mkdir -p .specweave/cache/docs-site
-
-# Create package.json
-cat > .specweave/cache/docs-site/package.json << 'EOF'
-{
-  "name": "specweave-docs-preview",
-  "version": "1.0.0",
-  "private": true,
-  "scripts": {
-    "start": "docusaurus start --port 3015",
-    "build": "docusaurus build",
-    "clear": "docusaurus clear"
-  },
-  "dependencies": {
-    "@docusaurus/core": "^3.9.2",
-    "@docusaurus/preset-classic": "^3.9.2",
-    "@docusaurus/theme-mermaid": "^3.9.2",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.0.0",
-    "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "engines": {
-    "node": ">=20.0"
-  }
-}
-EOF
-
-# Create Docusaurus config pointing to internal docs
-cat > .specweave/cache/docs-site/docusaurus.config.ts << 'EOF'
-import {themes as prismThemes} from 'prism-react-renderer';
-import type {Config} from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
-
-const config: Config = {
-  title: 'Internal Documentation',
-  tagline: 'SpecWeave Living Documentation',
-  favicon: 'img/favicon.ico',
-  future: { v4: true },
-  url: 'http://localhost:3015',
-  baseUrl: '/',
-  onBrokenLinks: 'warn',
-  onBrokenMarkdownLinks: 'warn',
-  i18n: { defaultLocale: 'en', locales: ['en'] },
-  markdown: { mermaid: true, format: 'md' },
-  themes: ['@docusaurus/theme-mermaid'],
-  presets: [
-    [
-      'classic',
-      {
-        docs: {
-          // Path relative to this config file → ../../docs/internal/
-          path: '../../docs/internal',
-          routeBasePath: '/',
-          sidebarPath: './sidebars.ts',
-          showLastUpdateTime: true,
-          sidebarCollapsible: true,
-          sidebarCollapsed: true,
-        },
-        blog: false,
-        theme: { customCss: './src/css/custom.css' },
-      } satisfies Preset.Options,
-    ],
-  ],
-  themeConfig: {
-    colorMode: {
-      defaultMode: 'dark',
-      disableSwitch: false,
-      respectPrefersColorScheme: true,
-    },
-    navbar: {
-      title: 'Internal Docs',
-      items: [
-        {to: '/', label: 'Home', position: 'left'},
-        {type: 'search', position: 'right'},
-      ],
-    },
-    footer: {
-      style: 'dark',
-      copyright: `SpecWeave Living Documentation`,
-    },
-    prism: {
-      theme: prismThemes.github,
-      darkTheme: prismThemes.dracula,
-      additionalLanguages: ['bash', 'typescript', 'yaml', 'json'],
-    },
-    mermaid: { theme: {light: 'neutral', dark: 'dark'} },
-  } satisfies Preset.ThemeConfig,
-};
-
-export default config;
-EOF
-
-# Create auto-generated sidebar
-cat > .specweave/cache/docs-site/sidebars.ts << 'EOF'
-import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
-
-const sidebars: SidebarsConfig = {
-  docs: [
-    {
-      type: 'autogenerated',
-      dirName: '.',
-    },
-  ],
-};
-
-export default sidebars;
-EOF
-
-# Create minimal CSS
-mkdir -p .specweave/cache/docs-site/src/css
-cat > .specweave/cache/docs-site/src/css/custom.css << 'EOF'
-:root {
-  --ifm-color-primary: #2563eb;
-  --ifm-code-font-size: 95%;
-}
-[data-theme='dark'] {
-  --ifm-color-primary: #60a5fa;
-}
-EOF
-
-# Create static folder with placeholder favicon
-mkdir -p .specweave/cache/docs-site/static/img
-echo '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" font-size="90">📚</text></svg>' > .specweave/cache/docs-site/static/img/favicon.ico
-
-# Install dependencies using PUBLIC npm registry (avoids Azure DevOps/private registry issues)
-cd .specweave/cache/docs-site && npm install --registry=https://registry.npmjs.org --legacy-peer-deps
-```
-
-### Step 4: Start the Server
-
-```bash
-cd .specweave/cache/docs-site && npm start
-```
-
-This will:
-- Start Docusaurus on **http://localhost:3015**
-- Enable hot reload (edit markdown, see changes instantly)
-- Render Mermaid diagrams
-- Auto-generate sidebar from folder structure
-
-### Output to User
-
-After starting, display:
-
-```
-📚 Documentation Preview Server Started!
-
-   URL: http://localhost:3015
-   Content: .specweave/docs/internal/
-
-   Features:
-   • Hot reload - edit markdown, see changes instantly
-   • Mermaid diagrams - architecture diagrams render beautifully
-   • Auto sidebar - generated from folder structure
-   • Dark/light mode - toggle in navbar
-
-   Press Ctrl+C to stop the server.
-```
-
-## What You Get
-
-- **Hot reload** - Edit markdown, see changes instantly
-- **Auto sidebar** - Generated from folder structure
-- **Mermaid diagrams** - Architecture diagrams render beautifully
-- **Dark/light mode** - Toggle in navbar
-- **Local search** - Instant search across all docs
-
-## Troubleshooting
-
-### Port already in use
-```bash
-lsof -i :3015 && kill -9 $(lsof -t -i :3015)
-```
-
-### Reinstall from scratch
-```bash
-rm -rf .specweave/cache/docs-site && /specweave-docs:preview
-```
-
-### npm registry issues
-The setup uses `--registry=https://registry.npmjs.org` to bypass private registry configurations.
-
-## See Also
-
-- `/specweave-docs:build` - Build static site for deployment
-- `/specweave-docs:organize` - Generate themed indexes for large folders
-- `/specweave-docs:health` - Documentation health report