agentic-qe 1.9.4 → 2.1.0

package/dist/core/skills/DependencyResolver.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Dependency Resolver for Skill Loading
+ * Handles skill dependency graphs with cycle detection and optimal load ordering
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyResolver = void 0;
+exports.createDependencyResolver = createDependencyResolver;
+exports.visualizeDependencyTree = visualizeDependencyTree;
+/**
+ * Skill Dependency Resolver
+ * Resolves skill dependencies with cycle detection and optimal ordering
+ */
+class DependencyResolver {
+    constructor(manifest, options = {}) {
+        this.manifest = manifest;
+        this.skillMap = new Map(manifest.skills.map(s => [s.id, s]));
+        this.options = {
+            maxDepth: 10,
+            includeOptional: true,
+            cycleStrategy: 'warn',
+            ...options,
+        };
+    }
+    /**
+     * Resolve dependencies for a single skill
+     */
+    resolve(skillId) {
+        return this.resolveMultiple([skillId]);
+    }
+    /**
+     * Resolve dependencies for multiple skills
+     */
+    resolveMultiple(skillIds) {
+        const visited = new Set();
+        const loadOrder = [];
+        const cycles = [];
+        const unresolved = [];
+        // Build dependency tree for each skill
+        const trees = [];
+        for (const skillId of skillIds) {
+            const result = this.buildDependencyTree(skillId, [], 0, visited);
+            trees.push(result.node);
+            cycles.push(...result.cycles);
+            unresolved.push(...result.unresolved);
+        }
+        // Topological sort for optimal load order
+        const sortedOrder = this.topologicalSort(skillIds);
+        loadOrder.push(...sortedOrder);
+        // Merge trees into single root
+        const mergedTree = {
+            id: 'root',
+            depth: -1,
+            dependencies: trees,
+        };
+        return {
+            loadOrder,
+            tree: mergedTree,
+            cycles: this.deduplicateCycles(cycles),
+            unresolved,
+        };
+    }
+    /**
+     * Get all skills that depend on a given skill (reverse dependencies)
+     */
+    getDependents(skillId) {
+        const dependents = [];
+        for (const skill of this.manifest.skills) {
+            if (skill.dependencies?.includes(skillId)) {
+                dependents.push(skill.id);
+            }
+        }
+        return dependents;
+    }
+    /**
+     * Get direct dependencies of a skill
+     */
+    getDirectDependencies(skillId) {
+        const skill = this.skillMap.get(skillId);
+        return skill?.dependencies || [];
+    }
+    /**
+     * Get all transitive dependencies (full dependency closure)
+     */
+    getTransitiveDependencies(skillId) {
+        const resolution = this.resolve(skillId);
+        return resolution.loadOrder.filter(id => id !== skillId);
+    }
+    /**
+     * Check if adding a dependency would create a cycle
+     */
+    wouldCreateCycle(fromSkillId, toSkillId) {
+        // Check if toSkillId already depends on fromSkillId
+        const deps = this.getTransitiveDependencies(toSkillId);
+        return deps.includes(fromSkillId);
+    }
+    /**
+     * Build dependency tree recursively
+     */
+    buildDependencyTree(skillId, path, depth, globalVisited) {
+        const cycles = [];
+        const unresolved = [];
+        // Check for cycle
+        if (path.includes(skillId)) {
+            const cycleStart = path.indexOf(skillId);
+            const cycle = [...path.slice(cycleStart), skillId];
+            cycles.push(cycle);
+            if (this.options.cycleStrategy === 'error') {
+                throw new Error(`Circular dependency detected: ${cycle.join(' -> ')}`);
+            }
+            // Return leaf node to break cycle
+            return {
+                node: { id: skillId, depth, dependencies: [] },
+                cycles,
+                unresolved,
+            };
+        }
+        // Check max depth
+        if (depth > this.options.maxDepth) {
+            return {
+                node: { id: skillId, depth, dependencies: [] },
+                cycles,
+                unresolved,
+            };
+        }
+        const skill = this.skillMap.get(skillId);
+        if (!skill) {
+            return {
+                node: { id: skillId, depth, dependencies: [] },
+                cycles,
+                unresolved: [{ skillId, missing: [skillId] }],
+            };
+        }
+        // Check for missing dependencies
+        const missing = (skill.dependencies || []).filter(dep => !this.skillMap.has(dep));
+        if (missing.length > 0) {
+            unresolved.push({ skillId, missing });
+        }
+        // Build children
+        const dependencies = [];
+        const newPath = [...path, skillId];
+        for (const depId of skill.dependencies || []) {
+            if (!this.skillMap.has(depId))
+                continue;
+            if (globalVisited.has(depId) && !path.includes(depId)) {
+                // Already fully processed, add as leaf
+                dependencies.push({ id: depId, depth: depth + 1, dependencies: [] });
+            }
+            else {
+                const result = this.buildDependencyTree(depId, newPath, depth + 1, globalVisited);
+                dependencies.push(result.node);
+                cycles.push(...result.cycles);
+                unresolved.push(...result.unresolved);
+            }
+        }
+        globalVisited.add(skillId);
+        return {
+            node: { id: skillId, depth, dependencies },
+            cycles,
+            unresolved,
+        };
+    }
+    /**
+     * Topological sort for optimal load order (dependencies first)
+     */
+    topologicalSort(startIds) {
+        const result = [];
+        const visited = new Set();
+        const visiting = new Set(); // For cycle detection
+        const visit = (skillId) => {
+            if (visited.has(skillId))
+                return;
+            if (visiting.has(skillId))
+                return; // Cycle, skip
+            visiting.add(skillId);
+            const skill = this.skillMap.get(skillId);
+            if (skill?.dependencies) {
+                for (const depId of skill.dependencies) {
+                    if (this.skillMap.has(depId)) {
+                        visit(depId);
+                    }
+                }
+            }
+            visiting.delete(skillId);
+            visited.add(skillId);
+            result.push(skillId);
+        };
+        // Start from requested skills
+        for (const startId of startIds) {
+            visit(startId);
+        }
+        return result;
+    }
+    /**
+     * Deduplicate cycle arrays (same cycle may be detected from different starting points)
+     */
+    deduplicateCycles(cycles) {
+        const seen = new Set();
+        const unique = [];
+        for (const cycle of cycles) {
+            // Normalize cycle by starting from smallest element
+            const normalized = this.normalizeCycle(cycle);
+            const key = normalized.join('->');
+            if (!seen.has(key)) {
+                seen.add(key);
+                unique.push(normalized);
+            }
+        }
+        return unique;
+    }
+    /**
+     * Normalize cycle to start from smallest element for deduplication
+     */
+    normalizeCycle(cycle) {
+        if (cycle.length <= 1)
+            return cycle;
+        // Remove duplicate end if present
+        const normalized = cycle[0] === cycle[cycle.length - 1]
+            ? cycle.slice(0, -1)
+            : cycle;
+        // Find index of smallest element
+        let minIndex = 0;
+        for (let i = 1; i < normalized.length; i++) {
+            if (normalized[i] < normalized[minIndex]) {
+                minIndex = i;
+            }
+        }
+        // Rotate to start from smallest
+        return [...normalized.slice(minIndex), ...normalized.slice(0, minIndex)];
+    }
+}
+exports.DependencyResolver = DependencyResolver;
+/**
+ * Create a dependency resolver from manifest
+ */
+function createDependencyResolver(manifest, options) {
+    return new DependencyResolver(manifest, options);
+}
+/**
+ * Visualize dependency tree as ASCII art
+ */
+function visualizeDependencyTree(node, prefix = '') {
+    const lines = [];
+    if (node.id !== 'root') {
+        lines.push(`${prefix}${node.id}`);
+    }
+    const childPrefix = node.id === 'root' ? '' : prefix + '  ';
+    for (let i = 0; i < node.dependencies.length; i++) {
+        const child = node.dependencies[i];
+        const isLast = i === node.dependencies.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        const nextPrefix = childPrefix + (isLast ? '    ' : '│   ');
+        lines.push(`${childPrefix}${connector}${child.id}`);
+        if (child.dependencies.length > 0) {
+            lines.push(visualizeDependencyTree(child, nextPrefix));
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=DependencyResolver.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * Dynamic Skill Loader with LRU Cache and Progressive Disclosure
+ * Achieves 98% token reduction by lazy-loading skills on demand
+ */
+import { Skill, SkillMetadata, SkillManifest, SkillLoaderConfig, SkillUsageStats, SkillSearchFilter } from './types.js';
+/**
+ * Dynamic Skill Loader with LRU caching and progressive disclosure
+ */
+export declare class DynamicSkillLoader {
+    private manifest;
+    private cache;
+    private usageStats;
+    private config;
+    constructor(config?: Partial<SkillLoaderConfig>);
+    /**
+     * Initialize loader and load manifest
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load skill metadata from manifest
+     */
+    loadManifest(): Promise<SkillManifest>;
+    /**
+     * Get manifest (load if not already loaded)
+     */
+    getManifest(): Promise<SkillManifest>;
+    /**
+     * Lazy load full skill content on demand
+     */
+    loadSkill(id: string): Promise<Skill>;
+    /**
+     * Load multiple skills at once (e.g., skill + dependencies)
+     */
+    loadSkills(ids: string[]): Promise<Skill[]>;
+    /**
+     * Search skills by filter criteria
+     */
+    searchSkills(filter: SkillSearchFilter): Promise<SkillMetadata[]>;
+    /**
+     * Get skill metadata without loading full content
+     */
+    getMetadata(id: string): Promise<SkillMetadata | null>;
+    /**
+     * Get all skills for a category
+     */
+    getSkillsByCategory(category: string): Promise<SkillMetadata[]>;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(skillId?: string): SkillUsageStats | SkillUsageStats[];
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: number;
+    };
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Preload critical priority skills
+     */
+    private preloadCriticalSkills;
+    /**
+     * Get skill from cache if valid
+     */
+    private getCachedSkill;
+    /**
+     * Add skill to LRU cache
+     */
+    private addToCache;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Update usage statistics
+     */
+    private updateUsageStats;
+    /**
+     * Parse frontmatter from markdown file
+     */
+    private parseFrontmatter;
+}
+/**
+ * Get default loader instance
+ */
+export declare function getDefaultLoader(config?: Partial<SkillLoaderConfig>): DynamicSkillLoader;
+/**
+ * Reset default loader (useful for testing)
+ */
+export declare function resetDefaultLoader(): void;
+//# sourceMappingURL=DynamicSkillLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicSkillLoader.d.ts","sourceRoot":"","sources":["../../../src/core/skills/DynamicSkillLoader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,KAAK,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAYpB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAYnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAY5C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAO3C;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAmD3C;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIjD;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CvE;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAO5D;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIrE;;OAEG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,EAAE;IAapE;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAanE;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;YACW,qBAAqB;IAYnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,kBAAkB,CAKxF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}