@cleocode/core 2026.4.9 → 2026.4.11

package/dist/skills/agents/registry.js

@@ -0,0 +1,161 @@
+/**
+ * Agent registry management.
+ * Ports lib/skills/agent-registry.sh.
+ *
+ * Maintains a registry of available agents and their configurations.
+ * Persisted to ~/.cleo/agent-registry.json.
+ *
+ * @epic T4454
+ * @task T4518
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { getCleoHome } from '../../paths.js';
+import { getAgentsDir, parseAgentConfig } from './config.js';
+// ============================================================================
+// Registry Paths
+// ============================================================================
+/**
+ * Get the agent registry file path.
+ * @task T4518
+ */
+export function getRegistryPath() {
+    return join(getCleoHome(), 'agent-registry.json');
+}
+// ============================================================================
+// Registry CRUD
+// ============================================================================
+/**
+ * Read the agent registry, creating if needed.
+ * @task T4518
+ */
+export function readRegistry() {
+    const registryPath = getRegistryPath();
+    if (existsSync(registryPath)) {
+        try {
+            const content = readFileSync(registryPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // Corrupt registry, return empty
+        }
+    }
+    return {
+        _meta: {
+            version: '1.0.0',
+            lastUpdated: new Date().toISOString(),
+        },
+        agents: [],
+    };
+}
+/**
+ * Save the agent registry.
+ * @task T4518
+ */
+export function saveRegistry(registry) {
+    const registryPath = getRegistryPath();
+    const dir = dirname(registryPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    registry._meta.lastUpdated = new Date().toISOString();
+    writeFileSync(registryPath, JSON.stringify(registry, null, 2), 'utf-8');
+}
+/**
+ * Register an agent in the registry.
+ * @task T4518
+ */
+export function registerAgent(name, path, config) {
+    const registry = readRegistry();
+    // Remove existing entry if present
+    registry.agents = registry.agents.filter((a) => a.name !== name);
+    const entry = {
+        name,
+        path,
+        config,
+        installedAt: new Date().toISOString(),
+    };
+    registry.agents.push(entry);
+    saveRegistry(registry);
+    return entry;
+}
+/**
+ * Unregister an agent from the registry.
+ * @task T4518
+ */
+export function unregisterAgent(name) {
+    const registry = readRegistry();
+    const initialCount = registry.agents.length;
+    registry.agents = registry.agents.filter((a) => a.name !== name);
+    if (registry.agents.length < initialCount) {
+        saveRegistry(registry);
+        return true;
+    }
+    return false;
+}
+/**
+ * Get an agent from the registry by name.
+ * @task T4518
+ */
+export function getAgent(name) {
+    const registry = readRegistry();
+    return registry.agents.find((a) => a.name === name) ?? null;
+}
+/**
+ * List all registered agents.
+ * @task T4518
+ */
+export function listAgents() {
+    return readRegistry().agents;
+}
+/**
+ * Scan the agents/ directory and register all found agents.
+ * @task T4518
+ */
+export function syncRegistry(cwd) {
+    const agentsDir = getAgentsDir(cwd);
+    const registry = readRegistry();
+    const result = { added: [], removed: [], unchanged: [] };
+    if (!existsSync(agentsDir)) {
+        return result;
+    }
+    // Discover agents on disk
+    const diskAgents = new Map();
+    const entries = readdirSync(agentsDir);
+    for (const entry of entries) {
+        if (entry.startsWith('.'))
+            continue;
+        const agentDir = join(agentsDir, entry);
+        try {
+            const config = parseAgentConfig(agentDir);
+            if (config) {
+                diskAgents.set(entry, config);
+            }
+        }
+        catch {
+            // Skip invalid agents
+        }
+    }
+    // Track existing names
+    const existingNames = new Set(registry.agents.map((a) => a.name));
+    // Add new agents
+    for (const [name, config] of diskAgents) {
+        if (existingNames.has(name)) {
+            result.unchanged.push(name);
+        }
+        else {
+            registerAgent(name, join(agentsDir, name), config);
+            result.added.push(name);
+        }
+    }
+    // Remove agents no longer on disk
+    const diskNames = new Set(diskAgents.keys());
+    for (const existing of existingNames) {
+        if (!diskNames.has(existing)) {
+            unregisterAgent(existing);
+            result.removed.push(existing);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/agents/registry.js.map

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

package/dist/skills/discovery.js

@@ -0,0 +1,333 @@
+/**
+ * Skill discovery and path resolution.
+ * Delegates canonical path resolution and standard discovery to @cleocode/caamp.
+ * Keeps CLEO-specific discovery logic (local project skill scanning, name mapping).
+ *
+ * CAAMP integration notes (T4679):
+ * - Path resolution: uses CAAMP's getCanonicalSkillsDir() for standard locations
+ * - Basic metadata: CAAMP's parseSkillFile() returns SkillMetadata (name, desc, version)
+ * - Extended metadata: CLEO's parseFrontmatter() adds tags, triggers, protocol, etc.
+ * - discoverSkill() uses parseFrontmatter() because CLEO needs the extended fields
+ * - For external/marketplace skills needing only basic metadata, use caampParseSkillFile()
+ *
+ * @epic T4454
+ * @task T4516
+ * @task T4679
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { discoverSkill as caampDiscoverSkill, discoverSkills as caampDiscoverSkills, parseSkillFile as caampParseSkillFile, getCanonicalSkillsDir, getProjectAgentsDir, } from '@cleocode/caamp';
+import { getCleoHome, getProjectRoot } from '../paths.js';
+import { SKILL_NAME_MAP } from './types.js';
+// ============================================================================
+// CAAMP Search Path Resolution
+// ============================================================================
+/**
+ * Build the CAAMP skill search paths in priority order.
+ * Uses CAAMP's canonical path functions for standard locations.
+ * @task T4516
+ */
+export function getSkillSearchPaths(cwd) {
+    const projectRoot = getProjectRoot(cwd);
+    const cleoHome = getCleoHome();
+    const projectAgentsSkills = join(getProjectAgentsDir(projectRoot), 'skills');
+    const paths = [
+        { scope: 'agent-skills', path: getCanonicalSkillsDir(), priority: 1 },
+        { scope: 'project-custom', path: projectAgentsSkills, priority: 2 },
+    ];
+    // Include marketplace cache if configured
+    const mpCacheDir = process.env['CLEO_SKILLS_MP_CACHE'] ?? join(cleoHome, '.skills-cache');
+    if (existsSync(mpCacheDir)) {
+        paths.push({ scope: 'marketplace', path: mpCacheDir, priority: 4 });
+    }
+    return paths.filter((entry) => existsSync(entry.path)).sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Get the primary skills directory (app-embedded).
+ * @task T4516
+ */
+export function getSkillsDir(cwd) {
+    void cwd;
+    return getCanonicalSkillsDir();
+}
+/**
+ * Get the shared skills resources directory.
+ * @task T4516
+ */
+export function getSharedDir(cwd) {
+    return join(getSkillsDir(cwd), '_shared');
+}
+// ============================================================================
+// Skill Name Resolution
+// ============================================================================
+/**
+ * Map a user-friendly skill name to the canonical ct-prefixed directory name.
+ * Supports: UPPER-CASE, lower-case, with/without ct- prefix.
+ * @task T4516
+ */
+export function mapSkillName(input) {
+    // Direct lookup in the map
+    if (SKILL_NAME_MAP[input]) {
+        return { canonical: SKILL_NAME_MAP[input], mapped: true };
+    }
+    // Try uppercase normalization
+    const upperInput = input.toUpperCase().replace(/_/g, '-');
+    if (SKILL_NAME_MAP[upperInput]) {
+        return { canonical: SKILL_NAME_MAP[upperInput], mapped: true };
+    }
+    // Fallback: normalize to ct-prefixed lowercase
+    let normalized = input.toLowerCase().replace(/_/g, '-');
+    if (!normalized.startsWith('ct-')) {
+        normalized = `ct-${normalized}`;
+    }
+    return { canonical: normalized, mapped: false };
+}
+/**
+ * List all known canonical skill names (unique values from the map).
+ * @task T4516
+ */
+export function listCanonicalSkillNames() {
+    return [...new Set(Object.values(SKILL_NAME_MAP))];
+}
+// ============================================================================
+// Frontmatter Parsing
+// ============================================================================
+/**
+ * Parse YAML-like frontmatter from a SKILL.md file.
+ * Handles the --- delimited header with key: value pairs.
+ * @task T4516
+ */
+export function parseFrontmatter(content) {
+    const lines = content.split('\n');
+    const result = {};
+    if (lines[0]?.trim() !== '---') {
+        return { name: '', description: '' };
+    }
+    let inFrontmatter = true;
+    let currentKey = '';
+    let currentList = [];
+    let inList = false;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trim() === '---') {
+            // End of frontmatter
+            if (inList && currentKey) {
+                result[currentKey] = currentList;
+            }
+            inFrontmatter = false;
+            break;
+        }
+        if (!inFrontmatter)
+            break;
+        // List item continuation
+        if (line.match(/^\s+-\s+/) && inList) {
+            currentList.push(line
+                .replace(/^\s+-\s+/, '')
+                .trim()
+                .replace(/^["']|["']$/g, ''));
+            continue;
+        }
+        // New key: value pair
+        const kvMatch = line.match(/^(\w[\w_-]*):\s*(.*)/);
+        if (kvMatch) {
+            // Save previous list if any
+            if (inList && currentKey) {
+                result[currentKey] = currentList;
+                inList = false;
+            }
+            const key = kvMatch[1];
+            const value = kvMatch[2].trim();
+            if (value === '' || value === '|') {
+                // Start of list or multiline
+                currentKey = key;
+                currentList = [];
+                inList = true;
+            }
+            else if (value === 'true' || value === 'false') {
+                result[key] = value === 'true';
+            }
+            else if (/^\d+$/.test(value)) {
+                result[key] = parseInt(value, 10);
+            }
+            else {
+                result[key] = value.replace(/^["']|["']$/g, '');
+            }
+        }
+    }
+    // Convert known camelCase keys
+    const fm = result;
+    return {
+        name: fm['name'] ?? '',
+        description: fm['description'] ?? '',
+        version: fm['version'],
+        author: fm['author'],
+        tags: fm['tags'],
+        triggers: fm['triggers'],
+        dispatchPriority: fm['dispatchPriority'],
+        model: fm['model'],
+        allowedTools: (fm['allowed_tools'] ?? fm['allowedTools']),
+        invocable: fm['invocable'],
+        command: fm['command'],
+        protocol: fm['protocol'],
+    };
+}
+// ============================================================================
+// Skill Discovery
+// ============================================================================
+/**
+ * Discover a single skill from a directory.
+ * Tries CAAMP's parseSkillFile first, falls back to local parsing.
+ * @task T4516
+ */
+export function discoverSkill(skillDir) {
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillMdPath)) {
+        return null;
+    }
+    const content = readFileSync(skillMdPath, 'utf-8');
+    const frontmatter = parseFrontmatter(content);
+    const dirName = basename(skillDir);
+    return {
+        name: frontmatter.name || dirName,
+        dirName,
+        path: skillDir,
+        skillMdPath,
+        frontmatter,
+        content,
+    };
+}
+/**
+ * Discover all skills in a single directory.
+ * Scans for subdirectories containing SKILL.md.
+ * @task T4516
+ */
+export function discoverSkillsInDir(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const skills = [];
+    try {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            // Skip hidden dirs and _shared
+            if (entry.startsWith('.') || entry.startsWith('_'))
+                continue;
+            const entryPath = join(dir, entry);
+            try {
+                if (statSync(entryPath).isDirectory()) {
+                    const skill = discoverSkill(entryPath);
+                    if (skill) {
+                        skills.push(skill);
+                    }
+                }
+            }
+            catch {
+                // Skip entries we can't stat
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return skills;
+}
+/**
+ * Discover all skills across CAAMP search paths.
+ * Returns skills in priority order (earlier paths take precedence).
+ * @task T4516
+ */
+export function discoverAllSkills(cwd) {
+    const searchPaths = getSkillSearchPaths(cwd);
+    const seen = new Set();
+    const skills = [];
+    for (const sp of searchPaths) {
+        const found = discoverSkillsInDir(sp.path);
+        for (const skill of found) {
+            // First discovery wins (higher priority path)
+            if (!seen.has(skill.dirName)) {
+                seen.add(skill.dirName);
+                skills.push(skill);
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Find a specific skill by name across all search paths.
+ * @task T4516
+ */
+export function findSkill(name, cwd) {
+    const { canonical } = mapSkillName(name);
+    const searchPaths = getSkillSearchPaths(cwd);
+    for (const sp of searchPaths) {
+        const skillDir = join(sp.path, canonical);
+        const skill = discoverSkill(skillDir);
+        if (skill)
+            return skill;
+    }
+    // Try without ct- prefix (legacy)
+    if (canonical.startsWith('ct-')) {
+        const legacy = canonical.slice(3);
+        for (const sp of searchPaths) {
+            const skillDir = join(sp.path, legacy);
+            const skill = discoverSkill(skillDir);
+            if (skill)
+                return skill;
+        }
+    }
+    return null;
+}
+/**
+ * Convert a Skill to a lightweight SkillSummary.
+ * @task T4516
+ */
+export function toSkillSummary(skill) {
+    return {
+        name: skill.name,
+        dirName: skill.dirName,
+        description: skill.frontmatter.description,
+        tags: skill.frontmatter.tags ?? [],
+        version: skill.frontmatter.version ?? '0.0.0',
+        invocable: skill.frontmatter.invocable ?? false,
+        command: skill.frontmatter.command,
+        protocol: skill.frontmatter.protocol,
+    };
+}
+/**
+ * Generate a skill manifest from discovered skills.
+ * @task T4516
+ */
+export function generateManifest(cwd) {
+    const searchPaths = getSkillSearchPaths(cwd);
+    const skills = discoverAllSkills(cwd);
+    return {
+        _meta: {
+            generatedAt: new Date().toISOString(),
+            ttlSeconds: 300,
+            skillCount: skills.length,
+            searchPaths: searchPaths.map((p) => p.path),
+        },
+        skills: skills.map(toSkillSummary),
+    };
+}
+/**
+ * Resolve a skill template path (SKILL.md) by name.
+ * @task T4516
+ */
+export function resolveTemplatePath(name, cwd) {
+    const skill = findSkill(name, cwd);
+    return skill?.skillMdPath ?? null;
+}
+// ============================================================================
+// CAAMP Skill Discovery Re-exports (T4679)
+// ============================================================================
+/**
+ * Parse a SKILL.md file using CAAMP's parser.
+ * Returns basic SkillMetadata (name, description, version, license, etc.).
+ * Use this for external/marketplace skills that don't need CLEO-specific fields.
+ * For CLEO skills requiring tags/triggers/protocol, use parseFrontmatter() instead.
+ *
+ * @task T4679
+ */
+export { caampDiscoverSkill, caampDiscoverSkills, caampParseSkillFile };
+//# sourceMappingURL=discovery.js.map

package/dist/skills/discovery.js.map

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