agentic-qe 2.0.0 → 2.1.1

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/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"}