specweave 0.12.7 → 0.13.1

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

@@ -0,0 +1,442 @@
+/**
+ * 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 strategy = env.JIRA_STRATEGY || 'project-per-team';
+        // Determine project key(s) based on strategy
+        let projectKeys = [];
+        if (strategy === 'project-per-team') {
+            // Multiple projects (JIRA_PROJECTS is comma-separated)
+            const projectsEnv = env.JIRA_PROJECTS || '';
+            if (!projectsEnv) {
+                console.log(chalk.red('❌ JIRA_PROJECTS not found in .env'));
+                result.valid = false;
+                return result;
+            }
+            projectKeys = projectsEnv.split(',').map(p => p.trim()).filter(p => p);
+        }
+        else {
+            // Single project (component-based or board-based)
+            const projectKey = env.JIRA_PROJECT;
+            if (!projectKey) {
+                console.log(chalk.red('❌ JIRA_PROJECT not found in .env'));
+                result.valid = false;
+                return result;
+            }
+            projectKeys = [projectKey];
+        }
+        // 1. Validate project(s)
+        console.log(chalk.gray(`Strategy: ${strategy}`));
+        console.log(chalk.gray(`Checking project(s): ${projectKeys.join(', ')}...\n`));
+        for (const projectKey of projectKeys) {
+            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 for project "${projectKey}"?`,
+                        choices: [
+                            { name: 'Select an existing project', value: 'select' },
+                            { name: 'Create a new project', value: 'create' },
+                            { name: 'Skip this project', value: 'skip' },
+                            { name: 'Cancel validation', value: 'cancel' },
+                        ],
+                    },
+                ]);
+                if (action === 'cancel') {
+                    result.valid = false;
+                    return result;
+                }
+                if (action === 'skip') {
+                    console.log(chalk.yellow(`⏭️  Skipped project "${projectKey}"\n`));
+                    continue;
+                }
+                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 (handle both single and multiple projects)
+                    if (strategy === 'project-per-team') {
+                        // Replace this project key in JIRA_PROJECTS
+                        const updatedKeys = projectKeys.map(k => k === projectKey ? selectedProject : k);
+                        await this.updateEnv({ JIRA_PROJECTS: updatedKeys.join(',') });
+                    }
+                    else {
+                        await this.updateEnv({ JIRA_PROJECT: selectedProject });
+                    }
+                    result.project = { exists: true, key: selectedProject };
+                    result.envUpdated = true;
+                    console.log(chalk.green(`✅ Project "${selectedProject}" selected\n`));
+                }
+                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`));
+                result.project = {
+                    exists: true,
+                    key: project.key,
+                    id: project.id,
+                    name: project.name,
+                };
+            }
+        }
+        console.log(); // Empty line after project validation
+        // 2. Validate boards (smart per-board detection)
+        // Boards only apply to board-based strategy
+        const boardsConfig = env.JIRA_BOARDS || '';
+        if (boardsConfig && strategy === 'board-based') {
+            console.log(chalk.gray(`Checking boards: ${boardsConfig}...`));
+            // For board-based strategy, use the single project key
+            const projectKeyForBoards = projectKeys[0];
+            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, projectKeyForBoards);
+                        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/src/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/src/utils/generate-skills-index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Skills Index Generator
+ *
+ * Generates SKILLS-INDEX.md from all SKILL.md files
+ * Simulates Claude Code's progressive disclosure for non-native tools
+ *
+ * This allows GitHub Copilot, Cursor, and other AI tools to:
+ * 1. Quickly scan all available skills (single file read)
+ * 2. Match user requests to activation keywords
+ * 3. Load full SKILL.md only when relevant
+ * 4. Follow skill workflows for consistent output
+ *
+ * Usage:
+ *   import { generateSkillsIndex } from './generate-skills-index';
+ *   await generateSkillsIndex();
+ *
+ * Or run directly:
+ *   npx ts-node src/utils/generate-skills-index.ts
+ */
+/**
+ * Main function: Generate skills index
+ */
+export declare function generateSkillsIndex(outputPath?: string): Promise<void>;
+//# sourceMappingURL=generate-skills-index.d.ts.map

package/dist/src/utils/generate-skills-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-skills-index.d.ts","sourceRoot":"","sources":["../../../src/utils/generate-skills-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuYH;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD5E"}