@poolzin/pool-bot 2026.3.7 → 2026.3.9

package/dist/skills/registry.js

@@ -0,0 +1,397 @@
+/**
+ * Skills registry
+ * Manages skill discovery, storage, and lifecycle
+ *
+ * @module skills/registry
+ */
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { EventEmitter } from "node:events";
+import { SkillError, } from "./types.js";
+import { parseSkill, isSkillFile } from "./parser.js";
+import { scanSkill } from "./security.js";
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    localPaths: [],
+    autoScan: true,
+    strictSecurity: false,
+    cacheTtlMs: 5 * 60 * 1000, // 5 minutes
+};
+// ============================================================================
+// Skills Registry
+// ============================================================================
+export class SkillsRegistry extends EventEmitter {
+    skills = new Map();
+    config;
+    scanCache = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ========================================================================
+    // Event Handling
+    // ========================================================================
+    emitEvent(type, skillId, data) {
+        const event = {
+            type,
+            skillId,
+            timestamp: new Date(),
+            data,
+        };
+        this.emit(type, event);
+    }
+    onSkillEvent(type, handler) {
+        this.on(type, handler);
+    }
+    // ========================================================================
+    // Skill Discovery
+    // ========================================================================
+    /**
+     * Scan all configured paths for skills
+     */
+    async scan() {
+        const errors = [];
+        let loaded = 0;
+        for (const path of this.config.localPaths) {
+            try {
+                const result = await this.scanPath(path);
+                loaded += result.loaded;
+                errors.push(...result.errors);
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        return { loaded, errors };
+    }
+    /**
+     * Scan a single path for skills
+     */
+    async scanPath(basePath) {
+        const errors = [];
+        let loaded = 0;
+        try {
+            const entries = await readdir(basePath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillPath = join(basePath.toString(), entry.name, "SKILL.md");
+                try {
+                    if (await isSkillFile(skillPath)) {
+                        const skill = await parseSkill(skillPath);
+                        // Run security scan if auto-scan enabled
+                        if (this.config.autoScan) {
+                            skill.securityReport = await scanSkill(skill);
+                            skill.verification = skill.securityReport.result;
+                            // Auto-disable if strict security and failed
+                            if (this.config.strictSecurity &&
+                                skill.verification === "failed") {
+                                skill.enabled = false;
+                                skill.status = "disabled";
+                            }
+                        }
+                        this.skills.set(skill.metadata.id, skill);
+                        this.emitEvent("skill:loaded", skill.metadata.id);
+                        loaded++;
+                    }
+                }
+                catch (error) {
+                    errors.push(new SkillError("LOAD_ERROR", `Failed to load skill from ${skillPath}: ${error}`, entry.name, error));
+                }
+            }
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        return { loaded, errors };
+    }
+    /**
+     * Watch for skill changes (placeholder for future implementation)
+     */
+    async watch() {
+        // TODO: Implement file watching for hot-reload
+        // This would use fs.watch or chokidar
+        throw new SkillError("CONFIG_ERROR", "Watch mode not yet implemented");
+    }
+    // ========================================================================
+    // Skill CRUD
+    // ========================================================================
+    /**
+     * Get a skill by ID
+     */
+    get(id) {
+        return this.skills.get(id);
+    }
+    /**
+     * Get all skills
+     */
+    getAll() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Get skill reference (lightweight)
+     */
+    getRef(id) {
+        const skill = this.skills.get(id);
+        if (!skill)
+            return undefined;
+        return {
+            id: skill.metadata.id,
+            name: skill.metadata.name,
+            description: skill.metadata.description,
+            category: skill.metadata.category,
+            tags: skill.metadata.tags,
+            version: skill.metadata.version,
+            status: skill.status,
+            verification: skill.verification,
+            enabled: skill.enabled,
+        };
+    }
+    /**
+     * Get all skill references
+     */
+    getAllRefs() {
+        return this.getAll().map((skill) => ({
+            id: skill.metadata.id,
+            name: skill.metadata.name,
+            description: skill.metadata.description,
+            category: skill.metadata.category,
+            tags: skill.metadata.tags,
+            version: skill.metadata.version,
+            status: skill.status,
+            verification: skill.verification,
+            enabled: skill.enabled,
+        }));
+    }
+    /**
+     * Add or update a skill
+     */
+    async add(skill) {
+        const exists = this.skills.has(skill.metadata.id);
+        this.skills.set(skill.metadata.id, skill);
+        this.emitEvent(exists ? "skill:updated" : "skill:loaded", skill.metadata.id);
+    }
+    /**
+     * Remove a skill
+     */
+    remove(id) {
+        const existed = this.skills.delete(id);
+        if (existed) {
+            this.emitEvent("skill:unloaded", id);
+        }
+        return existed;
+    }
+    /**
+     * Check if skill exists
+     */
+    has(id) {
+        return this.skills.has(id);
+    }
+    // ========================================================================
+    // Skill State Management
+    // ========================================================================
+    /**
+     * Enable a skill
+     */
+    enable(id) {
+        const skill = this.skills.get(id);
+        if (!skill)
+            return false;
+        if (skill.verification === "failed" && this.config.strictSecurity) {
+            throw new SkillError("SECURITY_VIOLATION", `Cannot enable skill ${id}: failed security scan`, id);
+        }
+        skill.enabled = true;
+        skill.status = "installed";
+        this.emitEvent("skill:enabled", id);
+        return true;
+    }
+    /**
+     * Disable a skill
+     */
+    disable(id) {
+        const skill = this.skills.get(id);
+        if (!skill)
+            return false;
+        skill.enabled = false;
+        skill.status = "disabled";
+        this.emitEvent("skill:disabled", id);
+        return true;
+    }
+    /**
+     * Toggle skill enabled state
+     */
+    toggle(id) {
+        const skill = this.skills.get(id);
+        if (!skill)
+            return false;
+        return skill.enabled ? this.disable(id) : this.enable(id);
+    }
+    // ========================================================================
+    // Search
+    // ========================================================================
+    /**
+     * Search skills with filters
+     */
+    search(filters = {}, page = 1, pageSize = 20) {
+        let results = this.getAll();
+        // Apply filters
+        if (filters.category) {
+            results = results.filter((s) => s.metadata.category === filters.category);
+        }
+        if (filters.tags?.length) {
+            results = results.filter((s) => filters.tags.some((tag) => s.metadata.tags.includes(tag)));
+        }
+        if (filters.status) {
+            results = results.filter((s) => s.status === filters.status);
+        }
+        if (filters.verification) {
+            results = results.filter((s) => s.verification === filters.verification);
+        }
+        if (filters.enabledOnly) {
+            results = results.filter((s) => s.enabled);
+        }
+        if (filters.query) {
+            const query = filters.query.toLowerCase();
+            results = results.filter((s) => s.metadata.name.toLowerCase().includes(query) ||
+                s.metadata.description.toLowerCase().includes(query) ||
+                s.metadata.tags.some((t) => t.toLowerCase().includes(query)));
+        }
+        // Pagination
+        const total = results.length;
+        const start = (page - 1) * pageSize;
+        const paginated = results.slice(start, start + pageSize);
+        return {
+            skills: paginated.map((s) => ({
+                id: s.metadata.id,
+                name: s.metadata.name,
+                description: s.metadata.description,
+                category: s.metadata.category,
+                tags: s.metadata.tags,
+                version: s.metadata.version,
+                status: s.status,
+                verification: s.verification,
+                enabled: s.enabled,
+            })),
+            total,
+            page,
+            pageSize,
+        };
+    }
+    /**
+     * Find skills by tag
+     */
+    findByTag(tag) {
+        return this.getAllRefs().filter((s) => s.tags.includes(tag));
+    }
+    /**
+     * Find skills by category
+     */
+    findByCategory(category) {
+        return this.getAllRefs().filter((s) => s.category === category);
+    }
+    // ========================================================================
+    // Statistics
+    // ========================================================================
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const skills = this.getAll();
+        const byCategory = {};
+        const byVerification = {};
+        for (const skill of skills) {
+            // Count by category
+            byCategory[skill.metadata.category] =
+                (byCategory[skill.metadata.category] || 0) + 1;
+            // Count by verification
+            byVerification[skill.verification] =
+                (byVerification[skill.verification] || 0) + 1;
+        }
+        return {
+            total: skills.length,
+            enabled: skills.filter((s) => s.enabled).length,
+            disabled: skills.filter((s) => !s.enabled).length,
+            byCategory,
+            byVerification,
+        };
+    }
+    // ========================================================================
+    // Import/Export
+    // ========================================================================
+    /**
+     * Export all skills to JSON
+     */
+    export() {
+        const data = this.getAll().map((skill) => ({
+            metadata: skill.metadata,
+            status: skill.status,
+            verification: skill.verification,
+            enabled: skill.enabled,
+            userConfig: skill.userConfig,
+        }));
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Import skills from JSON
+     */
+    async import(json) {
+        const data = JSON.parse(json);
+        for (const partial of data) {
+            if (!partial.metadata?.id)
+                continue;
+            // Try to reload from source
+            const existing = this.skills.get(partial.metadata.id);
+            if (existing) {
+                // Update state only
+                if (partial.enabled !== undefined) {
+                    existing.enabled = partial.enabled;
+                }
+                if (partial.userConfig) {
+                    existing.userConfig = partial.userConfig;
+                }
+            }
+        }
+    }
+    // ========================================================================
+    // Cleanup
+    // ========================================================================
+    /**
+     * Clear all skills
+     */
+    clear() {
+        for (const id of this.skills.keys()) {
+            this.emitEvent("skill:unloaded", id);
+        }
+        this.skills.clear();
+        this.scanCache.clear();
+    }
+    /**
+     * Dispose of registry resources
+     */
+    dispose() {
+        this.clear();
+        this.removeAllListeners();
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+let globalRegistry = null;
+/**
+ * Get or create global registry instance
+ */
+export function getRegistry(config) {
+    if (!globalRegistry) {
+        globalRegistry = new SkillsRegistry(config);
+    }
+    return globalRegistry;
+}
+/**
+ * Reset global registry (useful for testing)
+ */
+export function resetRegistry() {
+    globalRegistry?.dispose();
+    globalRegistry = null;
+}