@cleocode/cleo 2026.2.5

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

@@ -0,0 +1,102 @@
+/**
+ * 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 { parseSkillFile as caampParseSkillFile, discoverSkill as caampDiscoverSkill, discoverSkills as caampDiscoverSkills } from '@cleocode/caamp';
+import type { Skill, SkillFrontmatter, SkillSearchPath, SkillSummary, SkillManifest } from './types.js';
+/**
+ * Build the CAAMP skill search paths in priority order.
+ * Uses CAAMP's canonical path functions for standard locations.
+ * @task T4516
+ */
+export declare function getSkillSearchPaths(cwd?: string): SkillSearchPath[];
+/**
+ * Get the primary skills directory (app-embedded).
+ * @task T4516
+ */
+export declare function getSkillsDir(cwd?: string): string;
+/**
+ * Get the shared skills resources directory.
+ * @task T4516
+ */
+export declare function getSharedDir(cwd?: string): string;
+/**
+ * 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 declare function mapSkillName(input: string): {
+    canonical: string;
+    mapped: boolean;
+};
+/**
+ * List all known canonical skill names (unique values from the map).
+ * @task T4516
+ */
+export declare function listCanonicalSkillNames(): string[];
+/**
+ * Parse YAML-like frontmatter from a SKILL.md file.
+ * Handles the --- delimited header with key: value pairs.
+ * @task T4516
+ */
+export declare function parseFrontmatter(content: string): SkillFrontmatter;
+/**
+ * Discover a single skill from a directory.
+ * Tries CAAMP's parseSkillFile first, falls back to local parsing.
+ * @task T4516
+ */
+export declare function discoverSkill(skillDir: string): Skill | null;
+/**
+ * Discover all skills in a single directory.
+ * Scans for subdirectories containing SKILL.md.
+ * @task T4516
+ */
+export declare function discoverSkillsInDir(dir: string): Skill[];
+/**
+ * Discover all skills across CAAMP search paths.
+ * Returns skills in priority order (earlier paths take precedence).
+ * @task T4516
+ */
+export declare function discoverAllSkills(cwd?: string): Skill[];
+/**
+ * Find a specific skill by name across all search paths.
+ * @task T4516
+ */
+export declare function findSkill(name: string, cwd?: string): Skill | null;
+/**
+ * Convert a Skill to a lightweight SkillSummary.
+ * @task T4516
+ */
+export declare function toSkillSummary(skill: Skill): SkillSummary;
+/**
+ * Generate a skill manifest from discovered skills.
+ * @task T4516
+ */
+export declare function generateManifest(cwd?: string): SkillManifest;
+/**
+ * Resolve a skill template path (SKILL.md) by name.
+ * @task T4516
+ */
+export declare function resolveTemplatePath(name: string, cwd?: string): string | null;
+/**
+ * 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 { caampParseSkillFile, caampDiscoverSkill, caampDiscoverSkills };
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/core/skills/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAEL,cAAc,IAAI,mBAAmB,EACrC,aAAa,IAAI,kBAAkB,EACnC,cAAc,IAAI,mBAAmB,EACtC,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAmBnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAkBlF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA4ElE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmB5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CA8BxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAiBvD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAqBlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAWzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CAa5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7E;AAMD;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/core/skills/discovery.js

@@ -0,0 +1,331 @@
+/**
+ * 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 { join, basename } from 'node:path';
+import { getCanonicalSkillsDir, parseSkillFile as caampParseSkillFile, discoverSkill as caampDiscoverSkill, discoverSkills as caampDiscoverSkills, } from '@cleocode/caamp';
+import { SKILL_NAME_MAP } from './types.js';
+import { getCleoHome, getProjectRoot } from '../paths.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 paths = [
+        { scope: 'cleo-home', path: join(cleoHome, 'skills'), priority: 1 },
+        { scope: 'agent-skills', path: getCanonicalSkillsDir(), priority: 2 },
+        { scope: 'app-embedded', path: join(projectRoot, 'skills'), priority: 3 },
+        { scope: 'project-custom', path: join(projectRoot, '.cleo', 'skills'), priority: 5 },
+    ];
+    // 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.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Get the primary skills directory (app-embedded).
+ * @task T4516
+ */
+export function getSkillsDir(cwd) {
+    return join(getProjectRoot(cwd), 'skills');
+}
+/**
+ * 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 { caampParseSkillFile, caampDiscoverSkill, caampDiscoverSkills };
+//# sourceMappingURL=discovery.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * Skill dispatch and protocol selection.
+ * Augments CLEO's multi-strategy dispatch with @cleocode/caamp catalog dispatch matrix.
+ *
+ * Implements multi-strategy dispatch:
+ *   1. Label-based: task labels match skill tags
+ *   2. Catalog-based: ct-skills dispatch matrix (via CAAMP catalog bridge)
+ *   3. Type-based: task type maps to protocol
+ *   4. Keyword-based: title/description matches triggers
+ *   5. Fallback: ct-task-executor
+ *
+ * @epic T4454
+ * @task T4517
+ */
+import type { Task } from '../../types/task.js';
+import type { DispatchResult, SkillProtocolType } from './types.js';
+/**
+ * Auto-dispatch a task to the most appropriate skill.
+ * Tries strategies in priority order: label -> catalog -> type -> keyword -> fallback.
+ * @task T4517
+ */
+export declare function autoDispatch(task: Task, cwd?: string): DispatchResult;
+/**
+ * Dispatch with explicit skill override.
+ * Verifies the skill exists before returning.
+ * @task T4517
+ */
+export declare function dispatchExplicit(skillName: string, cwd?: string): DispatchResult | null;
+/**
+ * Get the protocol type for a dispatch result.
+ * @task T4517
+ */
+export declare function getProtocolForDispatch(result: DispatchResult): SkillProtocolType | null;
+/**
+ * Prepare spawn context for a dispatched skill.
+ * Returns the skill name and protocol needed for token injection.
+ * @task T4517
+ */
+export declare function prepareSpawnContext(task: Task, overrideSkill?: string, cwd?: string): {
+    skill: string;
+    protocol: SkillProtocolType | null;
+    dispatch: DispatchResult;
+};
+/** Result of multi-skill composition. */
+export interface MultiSkillComposition {
+    skillCount: number;
+    primarySkill: string;
+    skills: Array<{
+        skill: string;
+        mode: 'full' | 'progressive';
+        estimatedTokens: number;
+    }>;
+    totalEstimatedTokens: number;
+    prompt: string;
+}
+/**
+ * Compose multiple skills into a single prompt with progressive disclosure.
+ * Ports skill_prepare_spawn_multi from lib/skills/skill-dispatch.sh.
+ *
+ * The first skill is loaded fully (primary). Secondary skills use progressive
+ * disclosure (frontmatter + first section only) to save context budget.
+ *
+ * @task T4712
+ * @epic T4663
+ */
+export declare function prepareSpawnMulti(skillNames: string[], tokenValues: Record<string, string>, cwd?: string): MultiSkillComposition;
+//# sourceMappingURL=dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/core/skills/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA4KpB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAyBrE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUvF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,aAAa,CAAC,EAAE,MAAM,EACtB,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAUjF;AAMD,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAkDD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,CAAC,EAAE,MAAM,GACX,qBAAqB,CA8CvB"}