agentic-qe 1.9.4 → 2.1.0

package/dist/core/skills/DynamicSkillLoader.js

@@ -0,0 +1,353 @@
+"use strict";
+/**
+ * Dynamic Skill Loader with LRU Cache and Progressive Disclosure
+ * Achieves 98% token reduction by lazy-loading skills on demand
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicSkillLoader = void 0;
+exports.getDefaultLoader = getDefaultLoader;
+exports.resetDefaultLoader = resetDefaultLoader;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Dynamic Skill Loader with LRU caching and progressive disclosure
+ */
+class DynamicSkillLoader {
+    constructor(config = {}) {
+        this.manifest = null;
+        this.cache = new Map();
+        this.usageStats = new Map();
+        this.config = {
+            skillsDir: path.resolve(process.cwd(), '.claude/skills'),
+            manifestPath: path.resolve(process.cwd(), '.claude/skills/skills-manifest.json'),
+            cacheSize: 10, // Keep 10 most recently used skills in memory
+            cacheTTL: 30 * 60 * 1000, // 30 minutes
+            preloadCritical: true,
+            enableAnalytics: true,
+            ...config
+        };
+    }
+    /**
+     * Initialize loader and load manifest
+     */
+    async initialize() {
+        await this.loadManifest();
+        if (this.config.preloadCritical && this.manifest) {
+            await this.preloadCriticalSkills();
+        }
+    }
+    /**
+     * Load skill metadata from manifest
+     */
+    async loadManifest() {
+        try {
+            const content = await fs.readFile(this.config.manifestPath, 'utf-8');
+            this.manifest = JSON.parse(content);
+            return this.manifest;
+        }
+        catch (error) {
+            throw new Error(`Failed to load skill manifest from ${this.config.manifestPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get manifest (load if not already loaded)
+     */
+    async getManifest() {
+        if (!this.manifest) {
+            await this.loadManifest();
+        }
+        return this.manifest;
+    }
+    /**
+     * Lazy load full skill content on demand
+     */
+    async loadSkill(id) {
+        // Check cache first
+        const cached = this.getCachedSkill(id);
+        if (cached) {
+            this.updateUsageStats(id, 0, false); // No load time for cache hit
+            return cached;
+        }
+        // Load from disk
+        const startTime = Date.now();
+        if (!this.manifest) {
+            await this.loadManifest();
+        }
+        const metadata = this.manifest.skills.find(s => s.id === id);
+        if (!metadata) {
+            throw new Error(`Skill not found: ${id}`);
+        }
+        const skillPath = path.join(this.config.skillsDir, metadata.path);
+        try {
+            const content = await fs.readFile(skillPath, 'utf-8');
+            const frontmatter = this.parseFrontmatter(content);
+            const skill = {
+                metadata,
+                content,
+                frontmatter,
+                loadedAt: new Date()
+            };
+            const loadTime = Date.now() - startTime;
+            // Add to cache
+            this.addToCache(id, skill);
+            // Update usage stats
+            if (this.config.enableAnalytics) {
+                this.updateUsageStats(id, loadTime, true);
+            }
+            return skill;
+        }
+        catch (error) {
+            throw new Error(`Failed to load skill ${id} from ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Load multiple skills at once (e.g., skill + dependencies)
+     */
+    async loadSkills(ids) {
+        return Promise.all(ids.map(id => this.loadSkill(id)));
+    }
+    /**
+     * Search skills by filter criteria
+     */
+    async searchSkills(filter) {
+        if (!this.manifest) {
+            await this.loadManifest();
+        }
+        let results = [...this.manifest.skills];
+        // Filter by category
+        if (filter.category) {
+            results = results.filter(s => s.category === filter.category);
+        }
+        // Filter by priority
+        if (filter.priority) {
+            results = results.filter(s => s.priority === filter.priority);
+        }
+        // Filter by dependencies
+        if (filter.hasDependencies !== undefined) {
+            results = results.filter(s => filter.hasDependencies
+                ? s.dependencies && s.dependencies.length > 0
+                : !s.dependencies || s.dependencies.length === 0);
+        }
+        // Keyword search (exact match in keywords array)
+        if (filter.keyword) {
+            const keyword = filter.keyword.toLowerCase();
+            results = results.filter(s => s.keywords.some(k => k.toLowerCase().includes(keyword)));
+        }
+        // Query search (full-text in name and description)
+        if (filter.query) {
+            const query = filter.query.toLowerCase();
+            results = results.filter(s => s.name.toLowerCase().includes(query) ||
+                s.description.toLowerCase().includes(query));
+        }
+        return results;
+    }
+    /**
+     * Get skill metadata without loading full content
+     */
+    async getMetadata(id) {
+        if (!this.manifest) {
+            await this.loadManifest();
+        }
+        return this.manifest.skills.find(s => s.id === id) || null;
+    }
+    /**
+     * Get all skills for a category
+     */
+    async getSkillsByCategory(category) {
+        return this.searchSkills({ category: category });
+    }
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(skillId) {
+        if (skillId) {
+            return this.usageStats.get(skillId) || {
+                skillId,
+                loadCount: 0,
+                lastLoaded: new Date(),
+                avgLoadTime: 0,
+                usedByAgents: []
+            };
+        }
+        return Array.from(this.usageStats.values());
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        const totalAccesses = Array.from(this.cache.values())
+            .reduce((sum, entry) => sum + entry.accessCount, 0);
+        const cacheHits = totalAccesses - this.cache.size; // Approximate
+        return {
+            size: this.cache.size,
+            maxSize: this.config.cacheSize,
+            hitRate: totalAccesses > 0 ? cacheHits / totalAccesses : 0
+        };
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Preload critical priority skills
+     */
+    async preloadCriticalSkills() {
+        if (!this.manifest)
+            return;
+        const criticalSkills = this.manifest.skills
+            .filter(s => s.priority === 'critical')
+            .map(s => s.id);
+        if (criticalSkills.length > 0) {
+            await Promise.all(criticalSkills.map(id => this.loadSkill(id)));
+        }
+    }
+    /**
+     * Get skill from cache if valid
+     */
+    getCachedSkill(id) {
+        const entry = this.cache.get(id);
+        if (!entry)
+            return null;
+        // Check TTL
+        if (this.config.cacheTTL > 0) {
+            const age = Date.now() - entry.insertedAt.getTime();
+            if (age > this.config.cacheTTL) {
+                this.cache.delete(id);
+                return null;
+            }
+        }
+        // Update access stats
+        entry.accessCount++;
+        entry.lastAccessed = new Date();
+        return entry.skill;
+    }
+    /**
+     * Add skill to LRU cache
+     */
+    addToCache(id, skill) {
+        // If cache is full, evict LRU entry
+        if (this.cache.size >= this.config.cacheSize) {
+            this.evictLRU();
+        }
+        this.cache.set(id, {
+            skill,
+            insertedAt: new Date(),
+            accessCount: 1,
+            lastAccessed: new Date()
+        });
+    }
+    /**
+     * Evict least recently used entry
+     */
+    evictLRU() {
+        let oldestId = null;
+        let oldestTime = Date.now();
+        for (const [id, entry] of this.cache.entries()) {
+            const lastAccessed = entry.lastAccessed.getTime();
+            if (lastAccessed < oldestTime) {
+                oldestTime = lastAccessed;
+                oldestId = id;
+            }
+        }
+        if (oldestId) {
+            this.cache.delete(oldestId);
+        }
+    }
+    /**
+     * Update usage statistics
+     */
+    updateUsageStats(skillId, loadTime, wasLoaded) {
+        if (!this.config.enableAnalytics)
+            return;
+        const stats = this.usageStats.get(skillId) || {
+            skillId,
+            loadCount: 0,
+            lastLoaded: new Date(),
+            avgLoadTime: 0,
+            usedByAgents: []
+        };
+        if (wasLoaded) {
+            stats.loadCount++;
+            stats.lastLoaded = new Date();
+            // Update rolling average load time
+            stats.avgLoadTime =
+                (stats.avgLoadTime * (stats.loadCount - 1) + loadTime) / stats.loadCount;
+        }
+        this.usageStats.set(skillId, stats);
+    }
+    /**
+     * Parse frontmatter from markdown file
+     */
+    parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return {};
+        const frontmatter = {};
+        const lines = match[1].split('\n');
+        for (const line of lines) {
+            const colonIndex = line.indexOf(':');
+            if (colonIndex === -1)
+                continue;
+            const key = line.substring(0, colonIndex).trim();
+            const value = line.substring(colonIndex + 1).trim();
+            frontmatter[key] = value;
+        }
+        return frontmatter;
+    }
+}
+exports.DynamicSkillLoader = DynamicSkillLoader;
+/**
+ * Default singleton instance
+ */
+let defaultLoader = null;
+/**
+ * Get default loader instance
+ */
+function getDefaultLoader(config) {
+    if (!defaultLoader) {
+        defaultLoader = new DynamicSkillLoader(config);
+    }
+    return defaultLoader;
+}
+/**
+ * Reset default loader (useful for testing)
+ */
+function resetDefaultLoader() {
+    defaultLoader = null;
+}
+//# sourceMappingURL=DynamicSkillLoader.js.map

package/dist/core/skills/DynamicSkillLoader.js.map

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

package/dist/core/skills/ManifestGenerator.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Manifest Generator for Dynamic Skill Loading
+ * Scans skill directories and generates/updates skills-manifest.json
+ */
+import { SkillManifest, SkillPriority } from './types.js';
+/**
+ * Configuration for manifest generation
+ */
+export interface ManifestGeneratorConfig {
+    /** Path to skills directory */
+    skillsDir: string;
+    /** Output path for manifest */
+    outputPath: string;
+    /** Default priority for skills without explicit priority */
+    defaultPriority: SkillPriority;
+    /** Estimate tokens per line of content */
+    tokensPerLine: number;
+}
+/**
+ * Manifest Generator for creating and updating skill manifests
+ */
+export declare class ManifestGenerator {
+    private config;
+    constructor(config?: Partial<ManifestGeneratorConfig>);
+    /**
+     * Generate manifest from skill directories
+     */
+    generate(): Promise<SkillManifest>;
+    /**
+     * Update existing manifest with new/changed skills
+     */
+    update(): Promise<SkillManifest>;
+    /**
+     * Validate existing manifest against actual skill files
+     */
+    validate(): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Scan skill directories and extract metadata
+     */
+    private scanSkillDirectories;
+    /**
+     * Get list of skill directories
+     */
+    private getSkillDirectories;
+    /**
+     * Extract metadata from a skill directory
+     */
+    private extractMetadata;
+    /**
+     * Parse YAML frontmatter from markdown
+     */
+    private parseFrontmatter;
+    /**
+     * Detect category based on skill ID and frontmatter
+     */
+    private detectCategory;
+    /**
+     * Check if category is valid
+     */
+    private isValidCategory;
+    /**
+     * Detect priority based on skill ID and frontmatter
+     */
+    private detectPriority;
+    /**
+     * Extract description from content (first paragraph after frontmatter)
+     */
+    private extractDescription;
+    /**
+     * Extract keywords from frontmatter and content
+     */
+    private extractKeywords;
+    /**
+     * Estimate token count for content
+     */
+    private estimateTokens;
+    /**
+     * Format skill ID as human-readable name
+     */
+    private formatName;
+    /**
+     * Calculate category counts
+     */
+    private calculateCategoryCounts;
+    /**
+     * Get file modification time
+     */
+    private getFileStats;
+    /**
+     * Write manifest to file
+     */
+    private writeManifest;
+}
+/**
+ * CLI entry point for manifest generation
+ */
+export declare function generateManifest(options?: Partial<ManifestGeneratorConfig>): Promise<SkillManifest>;
+/**
+ * CLI entry point for manifest update
+ */
+export declare function updateManifest(options?: Partial<ManifestGeneratorConfig>): Promise<SkillManifest>;
+/**
+ * CLI entry point for manifest validation
+ */
+export declare function validateManifest(options?: Partial<ManifestGeneratorConfig>): Promise<{
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}>;
+//# sourceMappingURL=ManifestGenerator.d.ts.map

package/dist/core/skills/ManifestGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestGenerator.d.ts","sourceRoot":"","sources":["../../../src/core/skills/ManifestGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAiB,aAAa,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,eAAe,EAAE,aAAa,CAAC;IAC/B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;CACvB;AAoCD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAUzD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAgBxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA8CtC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAmDnF;;OAEG;YACW,oBAAoB;IAuBlC;;OAEG;YACW,mBAAmB;IAWjC;;OAEG;YACW,eAAe;IA0B7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;YACW,YAAY;IAU1B;;OAEG;YACW,aAAa;CAI5B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG7G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3G;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAGxJ"}