specweave 1.0.71 → 1.0.73

package/dist/src/core/plugins/skill-trigger-extractor.js

@@ -0,0 +1,352 @@
+/**
+ * Skill Trigger Extractor
+ *
+ * Extracts activation trigger keywords from SKILL.md and AGENT.md files.
+ * These triggers enable automatic skill activation based on user prompts.
+ *
+ * @module core/plugins/skill-trigger-extractor
+ * @version 1.0.0
+ */
+import * as path from 'path';
+import * as fs from '../../utils/fs-native.js';
+/**
+ * SkillTriggerExtractor - Extract activation triggers from plugin skills
+ */
+export class SkillTriggerExtractor {
+    /**
+     * Extract triggers from a single SKILL.md or AGENT.md content
+     *
+     * @param content - File content
+     * @param name - Skill/agent name
+     * @param plugin - Parent plugin name
+     * @param type - 'skill' or 'agent'
+     * @param filePath - Path to the file
+     * @returns Extracted triggers
+     */
+    extractFromContent(content, name, plugin, type, filePath) {
+        const description = this.extractDescription(content);
+        const triggers = this.extractTriggerKeywords(content, description);
+        return {
+            name,
+            plugin,
+            type,
+            description,
+            triggers,
+            path: filePath
+        };
+    }
+    /**
+     * Extract description from YAML frontmatter
+     *
+     * @param content - File content
+     * @returns Description string
+     */
+    extractDescription(content) {
+        const frontmatterMatch = content.match(/^---\n([\s\S]+?)\n---/);
+        if (frontmatterMatch) {
+            const descMatch = frontmatterMatch[1].match(/description:\s*(.+)/);
+            if (descMatch) {
+                return descMatch[1].trim();
+            }
+        }
+        return '';
+    }
+    /**
+     * Extract trigger keywords from content and description
+     *
+     * Looks for:
+     * 1. "Activates for:" sections in description
+     * 2. Keywords in YAML frontmatter
+     * 3. Technology names and patterns in the description
+     *
+     * @param content - Full file content
+     * @param description - Extracted description
+     * @returns Array of normalized trigger keywords
+     */
+    extractTriggerKeywords(content, description) {
+        const triggers = new Set();
+        // 1. Extract from "Activates for:" pattern in description
+        const activatesForMatch = description.match(/Activates\s+for[:\s]+(.+?)(?:\.|$)/i);
+        if (activatesForMatch) {
+            const keywords = this.parseKeywordList(activatesForMatch[1]);
+            keywords.forEach(k => triggers.add(k));
+        }
+        // 2. Extract from "Use when" or "Use this skill when" patterns
+        const useWhenMatch = description.match(/Use\s+(?:this\s+skill\s+)?when[:\s]+(.+?)(?:\.|$)/i);
+        if (useWhenMatch) {
+            const keywords = this.extractTechnologyTerms(useWhenMatch[1]);
+            keywords.forEach(k => triggers.add(k));
+        }
+        // 3. Extract keywords from YAML frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]+?)\n---/);
+        if (frontmatterMatch) {
+            const keywordsMatch = frontmatterMatch[1].match(/keywords:\s*\[([^\]]+)\]/);
+            if (keywordsMatch) {
+                const keywords = this.parseKeywordList(keywordsMatch[1]);
+                keywords.forEach(k => triggers.add(k));
+            }
+        }
+        // 4. Extract technology terms from description
+        const techTerms = this.extractTechnologyTerms(description);
+        techTerms.forEach(t => triggers.add(t));
+        // 5. Look for "When to Use" sections in content
+        const whenToUseMatch = content.match(/##\s*When to Use[^\n]*\n([\s\S]+?)(?:\n##|$)/i);
+        if (whenToUseMatch) {
+            const techTerms = this.extractTechnologyTerms(whenToUseMatch[1]);
+            // Only add strong technology terms from this section
+            techTerms.filter(t => this.isStrongTechnologyTerm(t)).forEach(t => triggers.add(t));
+        }
+        return Array.from(triggers).filter(t => t.length >= 2);
+    }
+    /**
+     * Parse a keyword list from comma/or separated string
+     *
+     * @param text - Keyword list text
+     * @returns Array of normalized keywords
+     */
+    parseKeywordList(text) {
+        const keywords = [];
+        // Split by comma, "or", slash, pipe
+        const parts = text.split(/[,|\/]|\s+or\s+/gi);
+        for (const part of parts) {
+            const cleaned = part.trim()
+                .replace(/^["']|["']$/g, '') // Remove quotes
+                .replace(/\s+/g, ' ') // Normalize whitespace
+                .toLowerCase();
+            if (cleaned.length >= 2 && !this.isStopWord(cleaned)) {
+                keywords.push(cleaned);
+            }
+        }
+        return keywords;
+    }
+    /**
+     * Extract technology terms from text
+     *
+     * @param text - Text to extract from
+     * @returns Array of technology terms
+     */
+    extractTechnologyTerms(text) {
+        const terms = new Set();
+        // Known technology patterns (case-insensitive)
+        const techPatterns = [
+            // Cloud Providers
+            /\bAWS\b/gi, /\bAzure\b/gi, /\bGCP\b/gi, /\bGoogle Cloud\b/gi,
+            // Kubernetes
+            /\bKubernetes\b/gi, /\bK8s\b/gi, /\bEKS\b/gi, /\bAKS\b/gi, /\bGKE\b/gi,
+            /\bHelm\b/gi, /\bGitOps\b/gi, /\bArgoCD\b/gi, /\bFlux\b/gi, /\bIstio\b/gi,
+            // Mobile
+            /\bReact Native\b/gi, /\bExpo\b/gi, /\biOS\b/gi, /\bAndroid\b/gi,
+            /\bSwift\b/gi, /\bKotlin\b/gi, /\bFlutter\b/gi,
+            // Frontend
+            /\bReact\b/gi, /\bVue\.?js\b/gi, /\bAngular\b/gi, /\bNext\.?js\b/gi,
+            /\bNuxt\b/gi, /\bSvelte\b/gi, /\bTailwind\b/gi, /\bCSS\b/gi,
+            // Backend
+            /\bNode\.?js\b/gi, /\bExpress\b/gi, /\bNestJS\b/gi, /\bFastify\b/gi,
+            /\bDjango\b/gi, /\bFlask\b/gi, /\bFastAPI\b/gi,
+            /\bSpring Boot\b/gi, /\b\.NET\b/gi, /\bASP\.NET\b/gi,
+            /\bRuby on Rails\b/gi, /\bRails\b/gi, /\bLaravel\b/gi,
+            /\bGo\b/gi, /\bGolang\b/gi, /\bRust\b/gi,
+            // Databases
+            /\bPostgreSQL\b/gi, /\bPostgres\b/gi, /\bMySQL\b/gi, /\bMongoDB\b/gi,
+            /\bRedis\b/gi, /\bElasticsearch\b/gi, /\bCassandra\b/gi,
+            /\bPrisma\b/gi, /\bTypeORM\b/gi, /\bSequelize\b/gi, /\bMongoose\b/gi,
+            // Messaging
+            /\bKafka\b/gi, /\bRabbitMQ\b/gi, /\bSQS\b/gi, /\bPubSub\b/gi,
+            // DevOps/Infra
+            /\bTerraform\b/gi, /\bDocker\b/gi, /\bCI\/CD\b/gi,
+            /\bGitHub Actions\b/gi, /\bJenkins\b/gi, /\bGitLab CI\b/gi,
+            /\bPrometheus\b/gi, /\bGrafana\b/gi, /\bDatadog\b/gi,
+            // Testing
+            /\bPlaywright\b/gi, /\bCypress\b/gi, /\bJest\b/gi, /\bVitest\b/gi,
+            /\bSelenium\b/gi, /\bE2E\b/gi, /\bTDD\b/gi, /\bBDD\b/gi,
+            // Security
+            /\bOWASP\b/gi, /\bJWT\b/gi, /\bOAuth\b/gi, /\bSSL\b/gi, /\bTLS\b/gi,
+            /\bCORS\b/gi, /\bCSRF\b/gi, /\bXSS\b/gi,
+            // ML/AI
+            /\bTensorFlow\b/gi, /\bPyTorch\b/gi, /\bMLflow\b/gi,
+            /\bScikit-learn\b/gi, /\bPandas\b/gi, /\bNumPy\b/gi,
+            // API
+            /\bREST API\b/gi, /\bGraphQL\b/gi, /\btRPC\b/gi, /\bgRPC\b/gi,
+            /\bOpenAPI\b/gi, /\bSwagger\b/gi,
+            // Payments
+            /\bStripe\b/gi, /\bPayPal\b/gi, /\bPCI\b/gi,
+            // General
+            /\bTypeScript\b/gi, /\bJavaScript\b/gi, /\bPython\b/gi, /\bJava\b/gi,
+            /\bC#\b/gi, /\bRuby\b/gi, /\bPHP\b/gi
+        ];
+        for (const pattern of techPatterns) {
+            const matches = text.match(pattern);
+            if (matches) {
+                matches.forEach(m => terms.add(m.toLowerCase().trim()));
+            }
+        }
+        return Array.from(terms);
+    }
+    /**
+     * Check if a term is a strong technology term (not generic)
+     *
+     * @param term - Term to check
+     * @returns True if strong technology term
+     */
+    isStrongTechnologyTerm(term) {
+        const strongTerms = new Set([
+            'kubernetes', 'k8s', 'eks', 'aks', 'gke', 'helm', 'gitops', 'argocd',
+            'react native', 'expo', 'ios', 'android', 'flutter',
+            'react', 'vue', 'angular', 'next.js', 'nextjs', 'nuxt', 'svelte',
+            'node.js', 'nodejs', 'express', 'nestjs', 'fastify',
+            'django', 'flask', 'fastapi', 'spring boot', '.net', 'asp.net',
+            'postgresql', 'postgres', 'mysql', 'mongodb', 'redis',
+            'prisma', 'typeorm', 'sequelize', 'mongoose',
+            'kafka', 'rabbitmq', 'terraform', 'docker',
+            'playwright', 'cypress', 'jest', 'vitest',
+            'stripe', 'paypal', 'owasp', 'jwt', 'oauth',
+            'tensorflow', 'pytorch', 'mlflow',
+            'graphql', 'trpc', 'grpc', 'openapi'
+        ]);
+        return strongTerms.has(term.toLowerCase());
+    }
+    /**
+     * Check if word is a stop word (common words to ignore)
+     *
+     * @param word - Word to check
+     * @returns True if stop word
+     */
+    isStopWord(word) {
+        const stopWords = new Set([
+            'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+            'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+            'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+            'could', 'should', 'may', 'might', 'must', 'shall', 'can', 'need',
+            'this', 'that', 'these', 'those', 'i', 'you', 'he', 'she', 'it',
+            'we', 'they', 'what', 'which', 'who', 'when', 'where', 'why', 'how',
+            'all', 'each', 'every', 'both', 'few', 'more', 'most', 'other',
+            'some', 'such', 'only', 'own', 'same', 'so', 'than', 'too', 'very',
+            'just', 'use', 'using', 'used', 'create', 'creating', 'created',
+            'build', 'building', 'built', 'implement', 'implementing',
+            'help', 'helps', 'helping', 'want', 'wants', 'wanted', 'need', 'needs'
+        ]);
+        return stopWords.has(word.toLowerCase());
+    }
+    /**
+     * Scan all plugins and extract triggers
+     *
+     * @param pluginsDir - Path to plugins directory
+     * @returns Array of extracted triggers
+     */
+    async scanAllPlugins(pluginsDir) {
+        const allTriggers = [];
+        // Get all plugin directories
+        if (!(await fs.pathExists(pluginsDir))) {
+            return allTriggers;
+        }
+        const entries = await fs.readdir(pluginsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const pluginPath = path.join(pluginsDir, entry.name);
+            const pluginName = entry.name;
+            // Scan skills
+            const skillsDir = path.join(pluginPath, 'skills');
+            if (await fs.pathExists(skillsDir)) {
+                const skillEntries = await fs.readdir(skillsDir, { withFileTypes: true });
+                for (const skillEntry of skillEntries) {
+                    if (!skillEntry.isDirectory())
+                        continue;
+                    const skillPath = path.join(skillsDir, skillEntry.name, 'SKILL.md');
+                    if (await fs.pathExists(skillPath)) {
+                        const content = await fs.readFile(skillPath, 'utf-8');
+                        const triggers = this.extractFromContent(content, skillEntry.name, pluginName, 'skill', skillPath);
+                        allTriggers.push(triggers);
+                    }
+                }
+            }
+            // Scan agents
+            const agentsDir = path.join(pluginPath, 'agents');
+            if (await fs.pathExists(agentsDir)) {
+                const agentEntries = await fs.readdir(agentsDir, { withFileTypes: true });
+                for (const agentEntry of agentEntries) {
+                    if (!agentEntry.isDirectory())
+                        continue;
+                    const agentPath = path.join(agentsDir, agentEntry.name, 'AGENT.md');
+                    if (await fs.pathExists(agentPath)) {
+                        const content = await fs.readFile(agentPath, 'utf-8');
+                        const triggers = this.extractFromContent(content, agentEntry.name, pluginName, 'agent', agentPath);
+                        allTriggers.push(triggers);
+                    }
+                }
+            }
+        }
+        return allTriggers;
+    }
+    /**
+     * Build the skill triggers index from extracted triggers
+     *
+     * @param triggers - Array of extracted triggers
+     * @returns Skill triggers index
+     */
+    buildIndex(triggers) {
+        const keywords = {};
+        const skills = {};
+        for (const trigger of triggers) {
+            // Full qualified name: plugin:type:name
+            const fqn = `${trigger.plugin}:${trigger.name}`;
+            // Add to skills metadata
+            skills[fqn] = {
+                plugin: trigger.plugin,
+                type: trigger.type,
+                triggers: trigger.triggers,
+                description: trigger.description.substring(0, 150),
+                fqn
+            };
+            // Build inverted index
+            for (const keyword of trigger.triggers) {
+                if (!keywords[keyword]) {
+                    keywords[keyword] = [];
+                }
+                if (!keywords[keyword].includes(fqn)) {
+                    keywords[keyword].push(fqn);
+                }
+            }
+        }
+        return {
+            keywords,
+            skills,
+            generatedAt: new Date().toISOString(),
+            skillCount: Object.keys(skills).length,
+            keywordCount: Object.keys(keywords).length
+        };
+    }
+    /**
+     * Match a user prompt against the trigger index
+     *
+     * @param prompt - User prompt
+     * @param index - Skill triggers index
+     * @returns Array of matched skill FQNs sorted by relevance
+     */
+    matchPrompt(prompt, index) {
+        const matches = new Map();
+        // Normalize prompt
+        const normalizedPrompt = prompt.toLowerCase();
+        // Check each keyword
+        for (const [keyword, skillFqns] of Object.entries(index.keywords)) {
+            // Check if keyword appears in prompt
+            if (normalizedPrompt.includes(keyword)) {
+                for (const fqn of skillFqns) {
+                    const existing = matches.get(fqn) || { score: 0, keywords: [] };
+                    existing.score += keyword.length; // Longer keywords = higher score
+                    existing.keywords.push(keyword);
+                    matches.set(fqn, existing);
+                }
+            }
+        }
+        // Convert to array and sort by score
+        return Array.from(matches.entries())
+            .map(([fqn, data]) => ({
+            fqn,
+            score: data.score,
+            matchedKeywords: data.keywords
+        }))
+            .sort((a, b) => b.score - a.score);
+    }
+}
+//# sourceMappingURL=skill-trigger-extractor.js.map

package/dist/src/core/plugins/skill-trigger-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-trigger-extractor.js","sourceRoot":"","sources":["../../../../src/core/plugins/skill-trigger-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAoD/C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;;;;;;OASG;IACH,kBAAkB,CAChB,OAAe,EACf,IAAY,EACZ,MAAc,EACd,IAAuB,EACvB,QAAgB;QAEhB,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEnE,OAAO;YACL,IAAI;YACJ,MAAM;YACN,IAAI;YACJ,WAAW;YACX,QAAQ;YACR,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,OAAe;QACxC,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAChE,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACnE,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,sBAAsB,CAAC,OAAe,EAAE,WAAmB;QACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,0DAA0D;QAC1D,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACnF,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,+DAA+D;QAC/D,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC7F,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,4CAA4C;QAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAChE,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC5E,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzD,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;QAC3D,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAExC,gDAAgD;QAChD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACtF,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,qDAAqD;YACrD,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,IAAY;QACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,oCAAoC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE;iBACxB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,gBAAgB;iBAC5C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,uBAAuB;iBAC5C,WAAW,EAAE,CAAC;YAEjB,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACK,sBAAsB,CAAC,IAAY;QACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAEhC,+CAA+C;QAC/C,MAAM,YAAY,GAAG;YACnB,kBAAkB;YAClB,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB;YAC7D,aAAa;YACb,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW;YACtE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa;YACzE,SAAS;YACT,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe;YAChE,aAAa,EAAE,cAAc,EAAE,eAAe;YAC9C,WAAW;YACX,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB;YACnE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW;YAC3D,UAAU;YACV,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;YACnE,cAAc,EAAE,aAAa,EAAE,eAAe;YAC9C,mBAAmB,EAAE,aAAa,EAAE,gBAAgB;YACpD,qBAAqB,EAAE,aAAa,EAAE,eAAe;YACrD,UAAU,EAAE,cAAc,EAAE,YAAY;YACxC,YAAY;YACZ,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe;YACpE,aAAa,EAAE,qBAAqB,EAAE,iBAAiB;YACvD,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB;YACpE,YAAY;YACZ,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc;YAC5D,eAAe;YACf,iBAAiB,EAAE,cAAc,EAAE,cAAc;YACjD,sBAAsB,EAAE,eAAe,EAAE,iBAAiB;YAC1D,kBAAkB,EAAE,eAAe,EAAE,eAAe;YACpD,UAAU;YACV,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc;YACjE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW;YACvD,WAAW;YACX,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW;YACnE,YAAY,EAAE,YAAY,EAAE,WAAW;YACvC,QAAQ;YACR,kBAAkB,EAAE,eAAe,EAAE,cAAc;YACnD,oBAAoB,EAAE,cAAc,EAAE,aAAa;YACnD,MAAM;YACN,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY;YAC7D,eAAe,EAAE,eAAe;YAChC,WAAW;YACX,cAAc,EAAE,cAAc,EAAE,WAAW;YAC3C,UAAU;YACV,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY;YACpE,UAAU,EAAE,YAAY,EAAE,WAAW;SACtC,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACK,sBAAsB,CAAC,IAAY;QACzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;YAC1B,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;YACpE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;YACnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;YAChE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS;YACnD,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS;YAC9D,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO;YACrD,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU;YAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ;YAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ;YACzC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;YAC3C,YAAY,EAAE,SAAS,EAAE,QAAQ;YACjC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;SACrC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,IAAY;QAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;YACxB,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;YACnE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;YACpE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;YAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;YACjE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI;YAC/D,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;YACnE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;YAC9D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;YAClE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS;YAC/D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc;YACzD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;SACvE,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,MAAM,WAAW,GAAwB,EAAE,CAAC;QAE5C,6BAA6B;QAC7B,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;YAE9B,cAAc;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;oBACtC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;wBAAE,SAAS;oBAExC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACpE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CACtC,OAAO,EACP,UAAU,CAAC,IAAI,EACf,UAAU,EACV,OAAO,EACP,SAAS,CACV,CAAC;wBACF,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,cAAc;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;oBACtC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;wBAAE,SAAS;oBAExC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACpE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CACtC,OAAO,EACP,UAAU,CAAC,IAAI,EACf,UAAU,EACV,OAAO,EACP,SAAS,CACV,CAAC;wBACF,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,QAA6B;QACtC,MAAM,QAAQ,GAA6B,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAkC,EAAE,CAAC;QAEjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,wCAAwC;YACxC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAEhD,yBAAyB;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG;gBACZ,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;gBAClD,GAAG;aACJ,CAAC;YAEF,uBAAuB;YACvB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACzB,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ;YACR,MAAM;YACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;YACtC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;SAC3C,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,MAAc,EAAE,KAAyB;QACnD,MAAM,OAAO,GAAuD,IAAI,GAAG,EAAE,CAAC;QAE9E,mBAAmB;QACnB,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAE9C,qBAAqB;QACrB,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,qCAAqC;YACrC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;oBAChE,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,iCAAiC;oBACnE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAChC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,IAAI,CAAC,QAAQ;SAC/B,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/src/core/plugins/skill-trigger-index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Skill Trigger Index Manager
+ *
+ * Manages the skill triggers index file used for automatic skill activation.
+ *
+ * @module core/plugins/skill-trigger-index
+ * @version 1.0.0
+ */
+import { SkillTriggersIndex } from './skill-trigger-extractor.js';
+/**
+ * SkillTriggerIndexManager - Generate and manage skill triggers index
+ */
+export declare class SkillTriggerIndexManager {
+    private extractor;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Generate the skill triggers index from all plugins
+     *
+     * @param pluginsDir - Path to plugins directory (relative or absolute)
+     * @returns Generated index
+     */
+    generateIndex(pluginsDir?: string): Promise<SkillTriggersIndex>;
+    /**
+     * Save index to file
+     *
+     * @param index - Skill triggers index
+     * @param indexPath - Path to save index (relative or absolute)
+     */
+    saveIndex(index: SkillTriggersIndex, indexPath?: string): Promise<string>;
+    /**
+     * Load index from file
+     *
+     * @param indexPath - Path to index file (relative or absolute)
+     * @returns Loaded index or null if not found
+     */
+    loadIndex(indexPath?: string): Promise<SkillTriggersIndex | null>;
+    /**
+     * Generate and save index (convenience method)
+     *
+     * @param pluginsDir - Path to plugins directory
+     * @param indexPath - Path to save index
+     * @returns Generated index and path
+     */
+    generateAndSave(pluginsDir?: string, indexPath?: string): Promise<{
+        index: SkillTriggersIndex;
+        path: string;
+    }>;
+    /**
+     * Match a user prompt against the index
+     *
+     * @param prompt - User prompt
+     * @param index - Optional pre-loaded index
+     * @returns Matched skills with scores
+     */
+    matchPrompt(prompt: string, index?: SkillTriggersIndex): Promise<Array<{
+        fqn: string;
+        score: number;
+        matchedKeywords: string[];
+    }>>;
+    /**
+     * Check if index needs regeneration
+     *
+     * @param maxAgeMs - Maximum age in milliseconds (default: 24 hours)
+     * @returns True if index needs regeneration
+     */
+    needsRegeneration(maxAgeMs?: number): Promise<boolean>;
+    /**
+     * Get index statistics
+     *
+     * @returns Index stats or null if not found
+     */
+    getStats(): Promise<{
+        skillCount: number;
+        keywordCount: number;
+        generatedAt: string;
+        topKeywords: Array<{
+            keyword: string;
+            skillCount: number;
+        }>;
+    } | null>;
+}
+/**
+ * CLI helper to generate index
+ */
+export declare function generateSkillTriggersIndexCLI(projectRoot?: string, pluginsDir?: string, indexPath?: string, verbose?: boolean): Promise<void>;
+/**
+ * CLI helper to test prompt matching
+ */
+export declare function testPromptMatchingCLI(prompt: string, projectRoot?: string, verbose?: boolean): Promise<void>;
+//# sourceMappingURL=skill-trigger-index.d.ts.map

package/dist/src/core/plugins/skill-trigger-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-trigger-index.d.ts","sourceRoot":"","sources":["../../../../src/core/plugins/skill-trigger-index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAyB,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAYzF;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAK/C;;;;;OAKG;IACG,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAcrE;;;;;OAKG;IACG,SAAS,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/E;;;;;OAKG;IACG,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAgBvE;;;;;;OAMG;IACG,eAAe,CACnB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,KAAK,EAAE,kBAAkB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD;;;;;;OAMG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAU5E;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,GAAE,MAA4B,GAAG,OAAO,CAAC,OAAO,CAAC;IAajF;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7D,GAAG,IAAI,CAAC;CAoBV;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,GAAE,MAAsB,EACnC,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAsB,EACnC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/src/core/plugins/skill-trigger-index.js

@@ -0,0 +1,196 @@
+/**
+ * Skill Trigger Index Manager
+ *
+ * Manages the skill triggers index file used for automatic skill activation.
+ *
+ * @module core/plugins/skill-trigger-index
+ * @version 1.0.0
+ */
+import * as path from 'path';
+import * as fs from '../../utils/fs-native.js';
+import { SkillTriggerExtractor } from './skill-trigger-extractor.js';
+/**
+ * Default path for the skill triggers index
+ */
+const DEFAULT_INDEX_PATH = '.specweave/state/skill-triggers-index.json';
+/**
+ * Default plugins directory
+ */
+const DEFAULT_PLUGINS_DIR = 'plugins';
+/**
+ * SkillTriggerIndexManager - Generate and manage skill triggers index
+ */
+export class SkillTriggerIndexManager {
+    constructor(projectRoot = process.cwd()) {
+        this.extractor = new SkillTriggerExtractor();
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Generate the skill triggers index from all plugins
+     *
+     * @param pluginsDir - Path to plugins directory (relative or absolute)
+     * @returns Generated index
+     */
+    async generateIndex(pluginsDir) {
+        const resolvedPluginsDir = pluginsDir
+            ? path.isAbsolute(pluginsDir) ? pluginsDir : path.join(this.projectRoot, pluginsDir)
+            : path.join(this.projectRoot, DEFAULT_PLUGINS_DIR);
+        // Scan all plugins
+        const triggers = await this.extractor.scanAllPlugins(resolvedPluginsDir);
+        // Build index
+        const index = this.extractor.buildIndex(triggers);
+        return index;
+    }
+    /**
+     * Save index to file
+     *
+     * @param index - Skill triggers index
+     * @param indexPath - Path to save index (relative or absolute)
+     */
+    async saveIndex(index, indexPath) {
+        const resolvedPath = indexPath
+            ? path.isAbsolute(indexPath) ? indexPath : path.join(this.projectRoot, indexPath)
+            : path.join(this.projectRoot, DEFAULT_INDEX_PATH);
+        // Ensure directory exists
+        await fs.ensureDir(path.dirname(resolvedPath));
+        // Write index
+        await fs.writeJSON(resolvedPath, index, { spaces: 2 });
+        return resolvedPath;
+    }
+    /**
+     * Load index from file
+     *
+     * @param indexPath - Path to index file (relative or absolute)
+     * @returns Loaded index or null if not found
+     */
+    async loadIndex(indexPath) {
+        const resolvedPath = indexPath
+            ? path.isAbsolute(indexPath) ? indexPath : path.join(this.projectRoot, indexPath)
+            : path.join(this.projectRoot, DEFAULT_INDEX_PATH);
+        if (!(await fs.pathExists(resolvedPath))) {
+            return null;
+        }
+        try {
+            return await fs.readJSON(resolvedPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Generate and save index (convenience method)
+     *
+     * @param pluginsDir - Path to plugins directory
+     * @param indexPath - Path to save index
+     * @returns Generated index and path
+     */
+    async generateAndSave(pluginsDir, indexPath) {
+        const index = await this.generateIndex(pluginsDir);
+        const savedPath = await this.saveIndex(index, indexPath);
+        return { index, path: savedPath };
+    }
+    /**
+     * Match a user prompt against the index
+     *
+     * @param prompt - User prompt
+     * @param index - Optional pre-loaded index
+     * @returns Matched skills with scores
+     */
+    async matchPrompt(prompt, index) {
+        const loadedIndex = index || await this.loadIndex();
+        if (!loadedIndex) {
+            return [];
+        }
+        return this.extractor.matchPrompt(prompt, loadedIndex);
+    }
+    /**
+     * Check if index needs regeneration
+     *
+     * @param maxAgeMs - Maximum age in milliseconds (default: 24 hours)
+     * @returns True if index needs regeneration
+     */
+    async needsRegeneration(maxAgeMs = 24 * 60 * 60 * 1000) {
+        const index = await this.loadIndex();
+        if (!index) {
+            return true;
+        }
+        const generatedAt = new Date(index.generatedAt).getTime();
+        const now = Date.now();
+        return (now - generatedAt) > maxAgeMs;
+    }
+    /**
+     * Get index statistics
+     *
+     * @returns Index stats or null if not found
+     */
+    async getStats() {
+        const index = await this.loadIndex();
+        if (!index) {
+            return null;
+        }
+        // Get top 20 keywords by skill count
+        const keywordCounts = Object.entries(index.keywords)
+            .map(([keyword, skills]) => ({ keyword, skillCount: skills.length }))
+            .sort((a, b) => b.skillCount - a.skillCount)
+            .slice(0, 20);
+        return {
+            skillCount: index.skillCount,
+            keywordCount: index.keywordCount,
+            generatedAt: index.generatedAt,
+            topKeywords: keywordCounts
+        };
+    }
+}
+/**
+ * CLI helper to generate index
+ */
+export async function generateSkillTriggersIndexCLI(projectRoot = process.cwd(), pluginsDir, indexPath, verbose = false) {
+    const manager = new SkillTriggerIndexManager(projectRoot);
+    if (verbose) {
+        console.log('🔍 Scanning plugins for skill triggers...');
+    }
+    const { index, path: savedPath } = await manager.generateAndSave(pluginsDir, indexPath);
+    if (verbose) {
+        console.log(`✅ Generated skill triggers index:`);
+        console.log(`   Skills: ${index.skillCount}`);
+        console.log(`   Keywords: ${index.keywordCount}`);
+        console.log(`   Path: ${savedPath}`);
+        // Show top keywords
+        const stats = await manager.getStats();
+        if (stats && stats.topKeywords.length > 0) {
+            console.log('\n📊 Top keywords:');
+            for (const { keyword, skillCount } of stats.topKeywords.slice(0, 10)) {
+                console.log(`   ${keyword}: ${skillCount} skills`);
+            }
+        }
+    }
+}
+/**
+ * CLI helper to test prompt matching
+ */
+export async function testPromptMatchingCLI(prompt, projectRoot = process.cwd(), verbose = false) {
+    const manager = new SkillTriggerIndexManager(projectRoot);
+    const index = await manager.loadIndex();
+    if (!index) {
+        console.error('❌ No skill triggers index found. Run refresh-marketplace.sh first.');
+        process.exit(1);
+    }
+    const matches = await manager.matchPrompt(prompt, index);
+    if (matches.length === 0) {
+        console.log('❌ No skills matched for prompt:', prompt);
+        return;
+    }
+    console.log(`✅ Matched ${matches.length} skills for prompt:`);
+    console.log(`   "${prompt}"\n`);
+    for (const match of matches.slice(0, 10)) {
+        const skill = index.skills[match.fqn];
+        console.log(`   📦 ${match.fqn}`);
+        console.log(`      Score: ${match.score}`);
+        console.log(`      Keywords: ${match.matchedKeywords.join(', ')}`);
+        if (verbose && skill) {
+            console.log(`      Description: ${skill.description}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=skill-trigger-index.js.map