specweave 0.11.0 → 0.12.0

package/dist/src/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/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"}