specweave 0.9.1 → 0.10.1

package/dist/utils/plugin-validator.js

@@ -0,0 +1,565 @@
+/**
+ * Plugin Validation System
+ *
+ * Proactively validates SpecWeave plugin installation before workflow commands.
+ * Ensures marketplace is registered, core plugin is installed, and context-specific
+ * plugins are available.
+ *
+ * @module plugin-validator
+ * @since 0.9.4
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Plugin keyword mappings
+ * Maps plugin names to keywords that should trigger their suggestion
+ * Scoring: 2+ keyword matches = high confidence (plugin suggested)
+ */
+export const PLUGIN_KEYWORDS = {
+    'specweave-github': [
+        'github',
+        'git',
+        'issues',
+        'pull request',
+        'pr',
+        'repository',
+        'commit',
+    ],
+    'specweave-jira': [
+        'jira',
+        'epic',
+        'story',
+        'sprint',
+        'backlog',
+        'atlassian',
+    ],
+    'specweave-ado': [
+        'azure devops',
+        'ado',
+        'azure',
+        'devops',
+        'work item',
+        'boards',
+    ],
+    'specweave-payments': [
+        'stripe',
+        'billing',
+        'payment',
+        'subscription',
+        'invoice',
+        'checkout',
+    ],
+    'specweave-frontend': [
+        'react',
+        'nextjs',
+        'next.js',
+        'vue',
+        'angular',
+        'svelte',
+        'frontend',
+        'ui',
+    ],
+    'specweave-kubernetes': [
+        'kubernetes',
+        'k8s',
+        'helm',
+        'pod',
+        'deployment',
+        'service mesh',
+        'kubectl',
+    ],
+    'specweave-ml': [
+        'machine learning',
+        'ml',
+        'tensorflow',
+        'pytorch',
+        'model',
+        'training',
+        'dataset',
+    ],
+    'specweave-observability': [
+        'prometheus',
+        'grafana',
+        'monitoring',
+        'metrics',
+        'alerting',
+        'observability',
+    ],
+    'specweave-security': [
+        'security',
+        'owasp',
+        'vulnerability',
+        'penetration',
+        'audit',
+        'csrf',
+        'xss',
+    ],
+    'specweave-diagrams': [
+        'diagram',
+        'c4',
+        'mermaid',
+        'architecture',
+        'visualization',
+        'flowchart',
+    ],
+    'specweave-backend-nodejs': [
+        'nodejs',
+        'express',
+        'fastify',
+        'nestjs',
+        'backend',
+        'api',
+    ],
+    'specweave-backend-python': [
+        'python',
+        'fastapi',
+        'django',
+        'flask',
+        'backend',
+        'api',
+    ],
+    'specweave-backend-dotnet': [
+        'dotnet',
+        '.net',
+        'aspnet',
+        'asp.net',
+        'c#',
+        'csharp',
+    ],
+    'specweave-docs-preview': [
+        'documentation',
+        'docs',
+        'preview',
+        'docusaurus',
+        'publish',
+    ],
+    'specweave-e2e-testing': [
+        'playwright',
+        'e2e',
+        'end-to-end',
+        'browser',
+        'visual regression',
+    ],
+};
+/** Cache TTL in seconds (5 minutes) */
+const CACHE_TTL = 300;
+/** Confidence threshold for plugin detection (2+ keyword matches) */
+const KEYWORD_CONFIDENCE_THRESHOLD = 2;
+/** SpecWeave marketplace configuration */
+const SPECWEAVE_MARKETPLACE_CONFIG = {
+    source: {
+        source: 'github',
+        repo: 'anton-abyzov/specweave',
+        path: '.claude-plugin',
+    },
+};
+// ============================================================================
+// Main Validator Class
+// ============================================================================
+/**
+ * Plugin Validator
+ *
+ * Validates SpecWeave plugin installation and provides auto-installation
+ * capabilities. Uses caching to minimize validation overhead.
+ */
+export class PluginValidator {
+    constructor() {
+        this.verbose = false;
+        this.cacheFile = path.join(os.homedir(), '.specweave', 'validation-cache.json');
+    }
+    /**
+     * Main validation entry point
+     *
+     * @param options - Validation options
+     * @returns Validation result with missing/installed components
+     */
+    async validate(options = {}) {
+        this.verbose = options.verbose ?? false;
+        // Check cache first (unless verbose mode)
+        if (!options.verbose && !options.dryRun) {
+            const cached = await this.getCachedValidation();
+            if (cached) {
+                this.log('Using cached validation result');
+                return cached;
+            }
+        }
+        const result = {
+            valid: true,
+            timestamp: Date.now(),
+            missing: {
+                marketplace: false,
+                corePlugin: false,
+                contextPlugins: [],
+            },
+            installed: {
+                corePlugin: false,
+                contextPlugins: [],
+            },
+            recommendations: [],
+            errors: [],
+        };
+        try {
+            // Step 1: Check marketplace
+            this.log('Checking marketplace registration...');
+            if (!(await this.checkMarketplace())) {
+                result.valid = false;
+                result.missing.marketplace = true;
+                result.recommendations.push('Register SpecWeave marketplace in ~/.claude/settings.json');
+                // Auto-install marketplace if requested
+                if (options.autoInstall && !options.dryRun) {
+                    this.log('Auto-installing marketplace...');
+                    const installResult = await this.installMarketplace();
+                    if (!installResult.success) {
+                        result.errors.push(`Failed to install marketplace: ${installResult.error}`);
+                    }
+                    else {
+                        result.missing.marketplace = false;
+                        this.log('Marketplace installed successfully');
+                    }
+                }
+            }
+            else {
+                this.log('Marketplace registered ✓');
+            }
+            // Step 2: Check core plugin
+            this.log('Checking core plugin (specweave)...');
+            const corePluginInfo = await this.checkCorePlugin();
+            if (!corePluginInfo.installed) {
+                result.valid = false;
+                result.missing.corePlugin = true;
+                result.recommendations.push('Install core plugin: /plugin install specweave');
+                // Auto-install core plugin if requested
+                if (options.autoInstall && !options.dryRun) {
+                    this.log('Auto-installing core plugin...');
+                    const installResult = await this.installPlugin('specweave');
+                    if (!installResult.success) {
+                        result.errors.push(`Failed to install core plugin: ${installResult.error}`);
+                    }
+                    else {
+                        result.missing.corePlugin = false;
+                        result.installed.corePlugin = true;
+                        this.log('Core plugin installed successfully');
+                    }
+                }
+            }
+            else {
+                result.installed.corePlugin = true;
+                result.installed.corePluginVersion = corePluginInfo.version;
+                this.log(`Core plugin installed ✓ (${corePluginInfo.version})`);
+            }
+            // Step 3: Detect context plugins (if context provided)
+            if (options.context) {
+                this.log('Detecting context plugins from description...');
+                const requiredPlugins = this.detectRequiredPlugins(options.context);
+                if (requiredPlugins.length > 0) {
+                    this.log(`Detected plugins: ${requiredPlugins.join(', ')}`);
+                    for (const plugin of requiredPlugins) {
+                        const pluginInfo = await this.checkPlugin(plugin);
+                        if (!pluginInfo.installed) {
+                            result.valid = false;
+                            result.missing.contextPlugins.push(plugin);
+                            result.recommendations.push(`Install context plugin: /plugin install ${plugin}`);
+                            // Auto-install context plugin if requested
+                            if (options.autoInstall && !options.dryRun) {
+                                this.log(`Auto-installing context plugin: ${plugin}...`);
+                                const installResult = await this.installPlugin(plugin);
+                                if (!installResult.success) {
+                                    result.errors.push(`Failed to install ${plugin}: ${installResult.error}`);
+                                }
+                                else {
+                                    result.installed.contextPlugins.push(plugin);
+                                    this.log(`${plugin} installed successfully`);
+                                }
+                            }
+                        }
+                        else {
+                            result.installed.contextPlugins.push(plugin);
+                            this.log(`${plugin} already installed ✓`);
+                        }
+                    }
+                }
+                else {
+                    this.log('No context plugins detected');
+                }
+            }
+            // Cache result (if not dry-run)
+            if (!options.dryRun) {
+                await this.setCachedValidation(result);
+            }
+            return result;
+        }
+        catch (error) {
+            result.valid = false;
+            result.errors.push(`Validation error: ${error.message}`);
+            return result;
+        }
+    }
+    /**
+     * Check if SpecWeave marketplace is registered
+     *
+     * @returns True if marketplace is registered correctly
+     */
+    async checkMarketplace() {
+        try {
+            const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+            // Check if settings.json exists
+            if (!(await fs.pathExists(settingsPath))) {
+                this.log('settings.json not found');
+                return false;
+            }
+            // Read settings
+            const settings = await fs.readJson(settingsPath);
+            // Check if specweave marketplace is registered
+            const marketplace = settings.extraKnownMarketplaces?.specweave;
+            if (!marketplace) {
+                this.log('SpecWeave marketplace not registered');
+                return false;
+            }
+            // Validate marketplace structure
+            if (marketplace.source.source === 'github' &&
+                marketplace.source.repo === 'anton-abyzov/specweave' &&
+                marketplace.source.path === '.claude-plugin') {
+                this.log('Marketplace configuration valid');
+                return true;
+            }
+            // Check if it's a local marketplace (dev mode)
+            if (marketplace.source.source === 'local') {
+                this.log('Development mode detected (local marketplace)');
+                return true;
+            }
+            this.log('Marketplace configuration invalid');
+            return false;
+        }
+        catch (error) {
+            this.log(`Error checking marketplace: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * Check if core plugin (specweave) is installed
+     *
+     * @returns Plugin installation info
+     */
+    async checkCorePlugin() {
+        return this.checkPlugin('specweave');
+    }
+    /**
+     * Check if a specific plugin is installed
+     *
+     * @param pluginName - Name of plugin to check
+     * @returns Plugin installation info
+     */
+    async checkPlugin(pluginName) {
+        try {
+            // Execute: claude plugin list --installed | grep "{pluginName}"
+            // Note: This assumes Claude CLI is available
+            const { stdout } = await execAsync(`claude plugin list --installed 2>/dev/null | grep -i "${pluginName}"`);
+            if (stdout.trim()) {
+                // Parse version from output (format: "name  version  description")
+                const match = stdout.match(/(\d+\.\d+\.\d+)/);
+                const version = match ? match[1] : undefined;
+                this.log(`Plugin ${pluginName} found (version: ${version})`);
+                return { installed: true, version };
+            }
+            this.log(`Plugin ${pluginName} not found`);
+            return { installed: false };
+        }
+        catch (error) {
+            // grep returns exit code 1 if no matches (not an error)
+            if (error.code === 1) {
+                this.log(`Plugin ${pluginName} not found`);
+                return { installed: false };
+            }
+            // Check if Claude CLI is not available
+            if (error.message.includes('command not found')) {
+                this.log('Claude CLI not available');
+                throw new Error('Claude CLI not available. Please ensure Claude Code is installed.');
+            }
+            this.log(`Error checking plugin ${pluginName}: ${error.message}`);
+            return { installed: false };
+        }
+    }
+    /**
+     * Detect required plugins based on keywords in description
+     *
+     * @param description - Increment description or context
+     * @returns List of required plugin names
+     */
+    detectRequiredPlugins(description) {
+        const scores = {};
+        const lowerDesc = description.toLowerCase();
+        // Score each plugin based on keyword matches
+        for (const [plugin, keywords] of Object.entries(PLUGIN_KEYWORDS)) {
+            scores[plugin] = keywords.filter((kw) => lowerDesc.includes(kw.toLowerCase())).length;
+        }
+        // Return plugins with score >= threshold (high confidence)
+        const detected = Object.entries(scores)
+            .filter(([_, score]) => score >= KEYWORD_CONFIDENCE_THRESHOLD)
+            .map(([plugin]) => plugin)
+            .sort((a, b) => scores[b] - scores[a]); // Sort by score (highest first)
+        return detected;
+    }
+    /**
+     * Install SpecWeave marketplace
+     *
+     * @returns Installation result
+     */
+    async installMarketplace() {
+        try {
+            const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
+            // Create .claude directory if needed
+            await fs.ensureDir(path.dirname(settingsPath));
+            // Read existing settings or create new
+            let settings = {};
+            if (await fs.pathExists(settingsPath)) {
+                settings = await fs.readJson(settingsPath);
+            }
+            // Add SpecWeave marketplace
+            settings.extraKnownMarketplaces =
+                settings.extraKnownMarketplaces || {};
+            settings.extraKnownMarketplaces.specweave = SPECWEAVE_MARKETPLACE_CONFIG;
+            // Write settings
+            await fs.writeJson(settingsPath, settings, { spaces: 2 });
+            this.log('Marketplace configuration written to settings.json');
+            return {
+                success: true,
+                component: 'marketplace',
+                details: settingsPath,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                component: 'marketplace',
+                error: error.message,
+            };
+        }
+    }
+    /**
+     * Install a plugin
+     *
+     * @param pluginName - Name of plugin to install
+     * @returns Installation result
+     */
+    async installPlugin(pluginName) {
+        try {
+            // Execute: claude plugin install {pluginName}
+            // Note: This requires Claude CLI to be available
+            this.log(`Executing: claude plugin install ${pluginName}`);
+            const { stdout, stderr } = await execAsync(`claude plugin install ${pluginName}`);
+            // Check if installation succeeded
+            const pluginInfo = await this.checkPlugin(pluginName);
+            if (pluginInfo.installed) {
+                return {
+                    success: true,
+                    component: pluginName,
+                    details: stdout.trim() || stderr.trim(),
+                };
+            }
+            return {
+                success: false,
+                component: pluginName,
+                error: 'Installation completed but plugin not detected',
+                details: stdout.trim() || stderr.trim(),
+            };
+        }
+        catch (error) {
+            // Check if Claude CLI is not available
+            if (error.message.includes('command not found')) {
+                return {
+                    success: false,
+                    component: pluginName,
+                    error: 'Claude CLI not available. Please install manually using /plugin install command.',
+                };
+            }
+            return {
+                success: false,
+                component: pluginName,
+                error: error.message,
+            };
+        }
+    }
+    /**
+     * Get cached validation result
+     *
+     * @returns Cached result if valid, null otherwise
+     */
+    async getCachedValidation() {
+        try {
+            if (!(await fs.pathExists(this.cacheFile))) {
+                return null;
+            }
+            const cache = await fs.readJson(this.cacheFile);
+            const age = (Date.now() - cache.timestamp) / 1000; // seconds
+            if (age > CACHE_TTL) {
+                this.log(`Cache expired (age: ${age}s, TTL: ${CACHE_TTL}s)`);
+                return null;
+            }
+            this.log(`Cache hit (age: ${age}s)`);
+            return { ...cache.result, cache: { hit: true, age } };
+        }
+        catch (error) {
+            this.log(`Error reading cache: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Set cached validation result
+     *
+     * @param result - Validation result to cache
+     */
+    async setCachedValidation(result) {
+        try {
+            await fs.ensureDir(path.dirname(this.cacheFile));
+            const cache = {
+                timestamp: Date.now(),
+                result,
+            };
+            await fs.writeJson(this.cacheFile, cache, { spaces: 2 });
+            this.log('Validation result cached');
+        }
+        catch (error) {
+            this.log(`Error writing cache: ${error.message}`);
+            // Non-fatal error, continue
+        }
+    }
+    /**
+     * Log message if verbose mode enabled
+     */
+    log(message) {
+        if (this.verbose) {
+            console.log(`[PluginValidator] ${message}`);
+        }
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Validate plugins (convenience function)
+ *
+ * @param options - Validation options
+ * @returns Validation result
+ */
+export async function validatePlugins(options = {}) {
+    const validator = new PluginValidator();
+    return validator.validate(options);
+}
+/**
+ * Check if SpecWeave is properly installed
+ *
+ * @returns True if marketplace and core plugin are installed
+ */
+export async function isSpecWeaveInstalled() {
+    const validator = new PluginValidator();
+    const result = await validator.validate({ autoInstall: false });
+    return result.valid;
+}
+//# sourceMappingURL=plugin-validator.js.map

package/dist/utils/plugin-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.js","sourceRoot":"","sources":["../../src/utils/plugin-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,7 @@
     "test:e2e": "playwright test tests/e2e/ --grep-invert=\"(should default to claude adapter|should use claude adapter when explicitly requested|should use generic adapter|should create .claude|should initialize project with specweave init|should create correct directory structure|should handle non-interactive mode correctly|should validate config.json structure|should create .specweave directory structure|should create CLAUDE.md and AGENTS.md|should initialize git repository|should install SpecWeave|should scaffold SaaS|should create proper directory|should create required configuration|should install core skills|should install core agents|should have deployment|should have Stripe|ADO Sync)\"",
     "test:integration": "echo 'Integration tests are temporarily disabled (excluded in jest.config.cjs line 31)' && exit 0",
     "test": "npm run test:smoke && npm run test:e2e",
+    "validate:plugins": "node scripts/validate-plugin-manifests.cjs",
     "metrics:dora": "node dist/metrics/dora-calculator.js",
     "generate:diagrams": "bash scripts/generate-diagram-svgs.sh",
     "docs:dev": "cd docs-site && npm start",

package/plugins/specweave/commands/specweave-do.md

@@ -40,6 +40,53 @@ You are helping the user implement a SpecWeave increment by executing tasks from
 
 ## Workflow
 
+### Step 0: Plugin Validation (MANDATORY - ALWAYS FIRST! v0.9.4+)
+
+🚨 **CRITICAL**: Before ANY task execution, validate SpecWeave plugin installation.
+
+**Why This Matters**:
+- Ensures SpecWeave marketplace is registered in Claude Code
+- Ensures core `specweave` plugin is installed
+- Prevents execution failures from missing dependencies
+- Enables seamless environment migration (local → VM → Cloud IDE)
+
+**Implementation**:
+
+Use the Bash tool to run:
+```bash
+npx specweave validate-plugins --auto-install
+```
+
+**Expected Output (Success)**:
+```
+✅ All plugins validated!
+   • Core plugin: installed (v0.9.4)
+```
+
+**Expected Output (Missing Components)**:
+```
+❌ Missing components detected:
+   • SpecWeave marketplace not registered
+   • Core plugin (specweave) not installed
+
+📦 Installing missing components...
+   ✅ Marketplace registered (.claude/settings.json)
+   ✅ Core plugin installed (specweave)
+
+🎉 Environment ready! Proceeding with task execution...
+```
+
+**What to Do After Validation**:
+
+1. ✅ **If validation passes**: Proceed to Step 1
+2. ⚠️ **If validation fails with errors**: Show error messages and STOP (do NOT proceed)
+3. 🔄 **If auto-install succeeded**: Proceed to Step 1
+4. ⚠️ **If auto-install failed**: Show manual instructions and STOP
+
+**DO NOT PROCEED** to Step 1 until plugin validation passes!
+
+---
+
 ### Step 1: Load Context
 
 1. **Find increment directory**: