specweave 0.9.1 → 0.10.1

package/dist/utils/external-resource-validator.js

@@ -0,0 +1,400 @@
+/**
+ * External Resource Validator
+ *
+ * Validates and creates external resources (Jira projects, boards, etc.)
+ * Smart enough to:
+ * - Check if resources exist
+ * - Prompt user to select existing or create new
+ * - Create missing resources automatically
+ * - Update .env with actual IDs after creation
+ *
+ * @module utils/external-resource-validator
+ * @since 0.9.5
+ */
+import fs from 'fs-extra';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+// ============================================================================
+// Jira Resource Validator
+// ============================================================================
+export class JiraResourceValidator {
+    constructor(envPath = '.env') {
+        this.envPath = envPath;
+        // Load from .env
+        const env = this.loadEnv();
+        this.apiToken = env.JIRA_API_TOKEN || '';
+        this.email = env.JIRA_EMAIL || '';
+        this.domain = env.JIRA_DOMAIN || '';
+    }
+    /**
+     * Load .env file
+     */
+    loadEnv() {
+        try {
+            if (!fs.existsSync(this.envPath)) {
+                return {};
+            }
+            const content = fs.readFileSync(this.envPath, 'utf-8');
+            const env = {};
+            content.split('\n').forEach((line) => {
+                const match = line.match(/^([^=:#]+)=(.*)$/);
+                if (match) {
+                    const key = match[1].trim();
+                    const value = match[2].trim();
+                    env[key] = value;
+                }
+            });
+            return env;
+        }
+        catch (error) {
+            return {};
+        }
+    }
+    /**
+     * Update .env file with new values
+     */
+    async updateEnv(updates) {
+        try {
+            let content = '';
+            if (fs.existsSync(this.envPath)) {
+                content = fs.readFileSync(this.envPath, 'utf-8');
+            }
+            // Update existing or append new
+            Object.entries(updates).forEach(([key, value]) => {
+                const regex = new RegExp(`^${key}=.*$`, 'm');
+                if (regex.test(content)) {
+                    content = content.replace(regex, `${key}=${value}`);
+                }
+                else {
+                    content += `\n${key}=${value}`;
+                }
+            });
+            fs.writeFileSync(this.envPath, content.trim() + '\n');
+            console.log(chalk.green(`✅ Updated ${this.envPath}`));
+        }
+        catch (error) {
+            console.error(chalk.red(`❌ Failed to update ${this.envPath}: ${error.message}`));
+            throw error;
+        }
+    }
+    /**
+     * Call Jira API
+     */
+    async callJiraApi(endpoint, method = 'GET', body) {
+        const url = `https://${this.domain}/rest/api/3/${endpoint}`;
+        const auth = Buffer.from(`${this.email}:${this.apiToken}`).toString('base64');
+        const curlCommand = `curl -s -X ${method} \
+      -H "Authorization: Basic ${auth}" \
+      -H "Content-Type: application/json" \
+      ${body ? `-d '${JSON.stringify(body)}'` : ''} \
+      "${url}"`;
+        try {
+            const { stdout } = await execAsync(curlCommand);
+            return JSON.parse(stdout);
+        }
+        catch (error) {
+            console.error(chalk.red(`Jira API error: ${error.message}`));
+            throw error;
+        }
+    }
+    /**
+     * Fetch all Jira projects
+     */
+    async fetchProjects() {
+        try {
+            const response = await this.callJiraApi('project');
+            return response.map((p) => ({
+                id: p.id,
+                key: p.key,
+                name: p.name,
+            }));
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Check if project exists
+     */
+    async checkProject(projectKey) {
+        try {
+            const project = await this.callJiraApi(`project/${projectKey}`);
+            return {
+                id: project.id,
+                key: project.key,
+                name: project.name,
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Create new Jira project
+     */
+    async createProject(projectKey, projectName) {
+        console.log(chalk.blue(`📦 Creating Jira project: ${projectKey} (${projectName})...`));
+        const body = {
+            key: projectKey,
+            name: projectName,
+            projectTypeKey: 'software',
+            leadAccountId: await this.getCurrentUserId(),
+        };
+        try {
+            const project = await this.callJiraApi('project', 'POST', body);
+            console.log(chalk.green(`✅ Project created: ${projectKey}`));
+            return {
+                id: project.id,
+                key: project.key,
+                name: project.name,
+            };
+        }
+        catch (error) {
+            console.error(chalk.red(`❌ Failed to create project: ${error.message}`));
+            throw error;
+        }
+    }
+    /**
+     * Get current user ID (for project lead)
+     */
+    async getCurrentUserId() {
+        try {
+            const user = await this.callJiraApi('myself');
+            return user.accountId;
+        }
+        catch (error) {
+            throw new Error('Failed to get current user ID');
+        }
+    }
+    /**
+     * Fetch all boards for a project
+     */
+    async fetchBoards(projectKey) {
+        try {
+            const response = await this.callJiraApi(`board?projectKeyOrId=${projectKey}`);
+            return response.values.map((b) => ({
+                id: b.id,
+                name: b.name,
+                type: b.type,
+            }));
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Check if board exists by ID
+     */
+    async checkBoard(boardId) {
+        try {
+            const board = await this.callJiraApi(`board/${boardId}`);
+            return {
+                id: board.id,
+                name: board.name,
+                type: board.type,
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Create new Jira board
+     */
+    async createBoard(boardName, projectKey) {
+        console.log(chalk.blue(`📦 Creating Jira board: ${boardName} in project ${projectKey}...`));
+        const body = {
+            name: boardName,
+            type: 'scrum',
+            filterId: await this.getOrCreateFilter(projectKey),
+            location: {
+                type: 'project',
+                projectKeyOrId: projectKey,
+            },
+        };
+        try {
+            const board = await this.callJiraApi('board', 'POST', body);
+            console.log(chalk.green(`✅ Board created: ${boardName} (ID: ${board.id})`));
+            return {
+                id: board.id,
+                name: board.name,
+                type: board.type,
+            };
+        }
+        catch (error) {
+            console.error(chalk.red(`❌ Failed to create board: ${error.message}`));
+            throw error;
+        }
+    }
+    /**
+     * Get or create filter for board
+     */
+    async getOrCreateFilter(projectKey) {
+        // For simplicity, create a basic filter
+        // In production, you might want to check for existing filters first
+        const body = {
+            name: `${projectKey} Issues`,
+            jql: `project = ${projectKey}`,
+        };
+        try {
+            const filter = await this.callJiraApi('filter', 'POST', body);
+            return filter.id;
+        }
+        catch (error) {
+            throw new Error(`Failed to create filter: ${error.message}`);
+        }
+    }
+    /**
+     * Validate and fix Jira configuration
+     */
+    async validate() {
+        console.log(chalk.blue('\n🔍 Validating Jira configuration...\n'));
+        const result = {
+            valid: true,
+            project: { exists: false },
+            boards: { valid: true, existing: [], missing: [], created: [] },
+            envUpdated: false,
+        };
+        const env = this.loadEnv();
+        const projectKey = env.JIRA_PROJECT;
+        const boardsConfig = env.JIRA_BOARDS || '';
+        // 1. Validate project
+        console.log(chalk.gray(`Checking project: ${projectKey}...`));
+        const project = await this.checkProject(projectKey);
+        if (!project) {
+            console.log(chalk.yellow(`⚠️  Project "${projectKey}" not found\n`));
+            // Fetch existing projects
+            const existingProjects = await this.fetchProjects();
+            // Prompt user
+            const { action } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'action',
+                    message: 'What would you like to do?',
+                    choices: [
+                        { name: 'Select an existing project', value: 'select' },
+                        { name: 'Create a new project', value: 'create' },
+                        { name: 'Cancel', value: 'cancel' },
+                    ],
+                },
+            ]);
+            if (action === 'cancel') {
+                result.valid = false;
+                return result;
+            }
+            if (action === 'select') {
+                const { selectedProject } = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'selectedProject',
+                        message: 'Select a project:',
+                        choices: existingProjects.map((p) => ({
+                            name: `${p.key} - ${p.name}`,
+                            value: p.key,
+                        })),
+                    },
+                ]);
+                // Update .env
+                await this.updateEnv({ JIRA_PROJECT: selectedProject });
+                result.project = { exists: true, key: selectedProject };
+                result.envUpdated = true;
+            }
+            else if (action === 'create') {
+                const { projectName } = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'projectName',
+                        message: 'Enter project name:',
+                        default: projectKey,
+                    },
+                ]);
+                const newProject = await this.createProject(projectKey, projectName);
+                result.project = {
+                    exists: true,
+                    key: newProject.key,
+                    id: newProject.id,
+                    name: newProject.name,
+                };
+            }
+        }
+        else {
+            console.log(chalk.green(`✅ Project "${projectKey}" exists\n`));
+            result.project = {
+                exists: true,
+                key: project.key,
+                id: project.id,
+                name: project.name,
+            };
+        }
+        // 2. Validate boards (smart per-board detection)
+        if (boardsConfig) {
+            console.log(chalk.gray(`Checking boards: ${boardsConfig}...`));
+            const boardEntries = boardsConfig.split(',').map((b) => b.trim());
+            const finalBoardIds = [];
+            for (const entry of boardEntries) {
+                const isNumeric = /^\d+$/.test(entry);
+                if (isNumeric) {
+                    // Entry is a board ID - validate it exists
+                    const boardId = parseInt(entry, 10);
+                    const board = await this.checkBoard(boardId);
+                    if (board) {
+                        console.log(chalk.green(`  ✅ Board ${boardId}: ${board.name} (exists)`));
+                        result.boards.existing.push(board.id);
+                        finalBoardIds.push(board.id);
+                    }
+                    else {
+                        console.log(chalk.yellow(`  ⚠️  Board ${boardId}: Not found`));
+                        result.boards.missing.push(entry);
+                        result.boards.valid = false;
+                    }
+                }
+                else {
+                    // Entry is a board name - create it
+                    console.log(chalk.blue(`  📦 Creating board: ${entry}...`));
+                    try {
+                        const board = await this.createBoard(entry, projectKey);
+                        console.log(chalk.green(`  ✅ Created: ${entry} (ID: ${board.id})`));
+                        result.boards.created.push({ name: entry, id: board.id });
+                        finalBoardIds.push(board.id);
+                    }
+                    catch (error) {
+                        console.log(chalk.red(`  ❌ Failed to create ${entry}: ${error.message}`));
+                        result.boards.missing.push(entry);
+                        result.boards.valid = false;
+                    }
+                }
+            }
+            // Update .env if any boards were created
+            if (result.boards.created.length > 0) {
+                console.log(chalk.blue('\n📝 Updating .env with board IDs...'));
+                await this.updateEnv({ JIRA_BOARDS: finalBoardIds.join(',') });
+                result.boards.existing = finalBoardIds;
+                result.envUpdated = true;
+                console.log(chalk.green(`✅ Updated JIRA_BOARDS: ${finalBoardIds.join(',')}`));
+            }
+            // Summary
+            console.log();
+            if (result.boards.missing.length > 0) {
+                console.log(chalk.yellow(`⚠️  Issues found: ${result.boards.missing.length} board(s)\n`));
+            }
+            else {
+                console.log(chalk.green(`✅ All boards validated/created successfully\n`));
+            }
+        }
+        return result;
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Validate Jira resources
+ */
+export async function validateJiraResources(envPath = '.env') {
+    const validator = new JiraResourceValidator(envPath);
+    return validator.validate();
+}
+//# sourceMappingURL=external-resource-validator.js.map

package/dist/utils/external-resource-validator.js.map

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

package/dist/utils/plugin-validator.d.ts

@@ -0,0 +1,161 @@
+/**
+ * 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
+ */
+/**
+ * Result of plugin installation attempt
+ */
+export interface InstallResult {
+    success: boolean;
+    component: string;
+    error?: string;
+    details?: string;
+}
+/**
+ * Options for plugin validation
+ */
+export interface ValidationOptions {
+    /** Auto-install missing components (default: false) */
+    autoInstall?: boolean;
+    /** Increment description for context-aware plugin detection */
+    context?: string;
+    /** Show what would be installed without installing (default: false) */
+    dryRun?: boolean;
+    /** Show detailed validation steps (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Result of plugin validation
+ */
+export interface ValidationResult {
+    /** True if all required components are installed */
+    valid: boolean;
+    /** Timestamp of validation */
+    timestamp: number;
+    /** Missing components */
+    missing: {
+        marketplace: boolean;
+        corePlugin: boolean;
+        contextPlugins: string[];
+    };
+    /** Installed components */
+    installed: {
+        corePlugin: boolean;
+        corePluginVersion?: string;
+        contextPlugins: string[];
+    };
+    /** Recommendations for user */
+    recommendations: string[];
+    /** Errors encountered during validation */
+    errors: string[];
+    /** Cache information */
+    cache?: {
+        hit: boolean;
+        age: number;
+    };
+}
+/**
+ * Plugin keyword mappings
+ * Maps plugin names to keywords that should trigger their suggestion
+ * Scoring: 2+ keyword matches = high confidence (plugin suggested)
+ */
+export declare const PLUGIN_KEYWORDS: Record<string, string[]>;
+/**
+ * Plugin Validator
+ *
+ * Validates SpecWeave plugin installation and provides auto-installation
+ * capabilities. Uses caching to minimize validation overhead.
+ */
+export declare class PluginValidator {
+    private cacheFile;
+    private verbose;
+    constructor();
+    /**
+     * Main validation entry point
+     *
+     * @param options - Validation options
+     * @returns Validation result with missing/installed components
+     */
+    validate(options?: ValidationOptions): Promise<ValidationResult>;
+    /**
+     * Check if SpecWeave marketplace is registered
+     *
+     * @returns True if marketplace is registered correctly
+     */
+    checkMarketplace(): Promise<boolean>;
+    /**
+     * Check if core plugin (specweave) is installed
+     *
+     * @returns Plugin installation info
+     */
+    checkCorePlugin(): Promise<{
+        installed: boolean;
+        version?: string;
+    }>;
+    /**
+     * Check if a specific plugin is installed
+     *
+     * @param pluginName - Name of plugin to check
+     * @returns Plugin installation info
+     */
+    checkPlugin(pluginName: string): Promise<{
+        installed: boolean;
+        version?: string;
+    }>;
+    /**
+     * Detect required plugins based on keywords in description
+     *
+     * @param description - Increment description or context
+     * @returns List of required plugin names
+     */
+    detectRequiredPlugins(description: string): string[];
+    /**
+     * Install SpecWeave marketplace
+     *
+     * @returns Installation result
+     */
+    installMarketplace(): Promise<InstallResult>;
+    /**
+     * Install a plugin
+     *
+     * @param pluginName - Name of plugin to install
+     * @returns Installation result
+     */
+    installPlugin(pluginName: string): Promise<InstallResult>;
+    /**
+     * Get cached validation result
+     *
+     * @returns Cached result if valid, null otherwise
+     */
+    private getCachedValidation;
+    /**
+     * Set cached validation result
+     *
+     * @param result - Validation result to cache
+     */
+    private setCachedValidation;
+    /**
+     * Log message if verbose mode enabled
+     */
+    private log;
+}
+/**
+ * Validate plugins (convenience function)
+ *
+ * @param options - Validation options
+ * @returns Validation result
+ */
+export declare function validatePlugins(options?: ValidationOptions): Promise<ValidationResult>;
+/**
+ * Check if SpecWeave is properly installed
+ *
+ * @returns True if marketplace and core plugin are installed
+ */
+export declare function isSpecWeaveInstalled(): Promise<boolean>;
+//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/utils/plugin-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE;QACP,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,2BAA2B;IAC3B,SAAS,EAAE;QACT,UAAU,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,+BAA+B;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,OAAO,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAgCD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA6HpD,CAAC;AAqBF;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAkB;;IAUjC;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0I1E;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IA4C1C;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAIF;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCpD;;;;;OAKG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAoBpD;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IAqClD;;;;;OAKG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C/D;;;;OAIG;YACW,mBAAmB;IAsBjC;;;;OAIG;YACW,mBAAmB;IAmBjC;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAI7D"}