@cleocode/core 2026.3.59 → 2026.3.60

package/dist/skills/skill-paths.js

@@ -0,0 +1,220 @@
+/**
+ * Multi-source skill path resolver for CAAMP integration.
+ * Ported from lib/skills/skill-paths.sh
+ *
+ * Resolves skills, protocols, and shared resources from multiple locations.
+ * Supports CAAMP canonical paths, project-embedded paths, and explicit overrides.
+ *
+ * Priority order:
+ * 1. CLEO_SKILL_PATH entries (explicit overrides, highest priority)
+ * 2. Source-determined paths based on CLEO_SKILL_SOURCE
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { existsSync, lstatSync, readlinkSync, realpathSync } from 'node:fs';
+import { delimiter, join, resolve } from 'node:path';
+import { getCanonicalSkillsDir } from '@cleocode/caamp';
+/**
+ * Get the CAAMP canonical skill location.
+ * Delegates to caamp's getCanonicalSkillsDir() which is XDG-aware.
+ * @task T4552
+ */
+function getCaampCanonical() {
+    return getCanonicalSkillsDir();
+}
+/**
+ * Get the project-embedded skill location.
+ * @task T4552
+ */
+function getProjectEmbedded(projectRoot) {
+    const root = projectRoot ?? process.cwd();
+    return join(root, 'skills');
+}
+/**
+ * Get the project root directory.
+ * @task T4552
+ */
+function getProjectRoot(cwd) {
+    return cwd ?? process.cwd();
+}
+/**
+ * Safely resolve to a real path.
+ * @task T4552
+ */
+function safeRealpath(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+/**
+ * Get ordered skill search paths based on configuration.
+ *
+ * Priority:
+ * 1. CLEO_SKILL_PATH entries (colon-separated, explicit overrides)
+ * 2. Source-determined paths based on CLEO_SKILL_SOURCE
+ *
+ * CLEO_SKILL_SOURCE modes:
+ * - auto: CAAMP canonical + embedded (default)
+ * - caamp: CAAMP canonical only
+ * - embedded: Project embedded only
+ *
+ * @task T4552
+ */
+export function getSkillSearchPaths(projectRoot) {
+    const sourceMode = (process.env['CLEO_SKILL_SOURCE'] ?? 'auto');
+    const paths = [];
+    // Explicit override paths get highest priority
+    const overridePaths = process.env['CLEO_SKILL_PATH'];
+    if (overridePaths) {
+        for (const p of overridePaths.split(delimiter)) {
+            if (p && existsSync(p)) {
+                paths.push({ path: p, origin: 'override' });
+            }
+        }
+    }
+    const caampDir = getCaampCanonical();
+    const embeddedDir = getProjectEmbedded(projectRoot);
+    // Source-determined paths
+    switch (sourceMode) {
+        case 'caamp':
+            if (existsSync(caampDir)) {
+                paths.push({ path: caampDir, origin: 'caamp' });
+            }
+            break;
+        case 'embedded':
+            if (existsSync(embeddedDir)) {
+                paths.push({ path: embeddedDir, origin: 'embedded' });
+            }
+            break;
+        default:
+            // CAAMP first (external package takes precedence), then embedded
+            if (existsSync(caampDir)) {
+                paths.push({ path: caampDir, origin: 'caamp' });
+            }
+            if (existsSync(embeddedDir)) {
+                paths.push({ path: embeddedDir, origin: 'embedded' });
+            }
+            break;
+    }
+    return paths;
+}
+/**
+ * Resolve a skill directory containing SKILL.md.
+ * Searches all paths from getSkillSearchPaths() in priority order.
+ * First match wins.
+ *
+ * @task T4552
+ */
+export function resolveSkillPath(skillName, projectRoot) {
+    const searchPaths = getSkillSearchPaths(projectRoot);
+    for (const { path: searchPath } of searchPaths) {
+        const candidate = join(searchPath, skillName);
+        if (existsSync(join(candidate, 'SKILL.md'))) {
+            return safeRealpath(candidate);
+        }
+    }
+    return null;
+}
+/**
+ * Resolve a protocol .md file.
+ *
+ * Search order per base path:
+ * 1. {base}/_ct-skills-protocols/{protocol_name}.md (Strategy B shared dir)
+ * 2. {PROJECT_ROOT}/src/protocols/{protocol_name}.md (legacy embedded fallback)
+ *
+ * @task T4552
+ */
+export function resolveProtocolPath(protocolName, projectRoot) {
+    const searchPaths = getSkillSearchPaths(projectRoot);
+    // Search Strategy B shared directories in each base path
+    for (const { path: searchPath } of searchPaths) {
+        const candidate = join(searchPath, '_ct-skills-protocols', `${protocolName}.md`);
+        if (existsSync(candidate)) {
+            return safeRealpath(candidate);
+        }
+    }
+    // Legacy fallback: project root protocols directory
+    const root = getProjectRoot(projectRoot);
+    const legacy = join(root, 'src', 'protocols', `${protocolName}.md`);
+    if (existsSync(legacy)) {
+        return safeRealpath(legacy);
+    }
+    return null;
+}
+/**
+ * Resolve a shared resource .md file.
+ *
+ * Search order per base path:
+ * 1. {base}/_ct-skills-shared/{resource_name}.md (Strategy B shared dir)
+ * 2. {base}/_shared/{resource_name}.md (legacy embedded layout)
+ *
+ * @task T4552
+ */
+export function resolveSharedPath(resourceName, projectRoot) {
+    const searchPaths = getSkillSearchPaths(projectRoot);
+    for (const { path: searchPath } of searchPaths) {
+        // Strategy B: _ct-skills-shared/ directory
+        const candidate = join(searchPath, '_ct-skills-shared', `${resourceName}.md`);
+        if (existsSync(candidate)) {
+            return safeRealpath(candidate);
+        }
+        // Legacy: _shared/ directory within each base path
+        const legacy = join(searchPath, '_shared', `${resourceName}.md`);
+        if (existsSync(legacy)) {
+            return safeRealpath(legacy);
+        }
+    }
+    return null;
+}
+/**
+ * Classify the source of a skill directory.
+ *
+ * Determines where a skill directory lives in the search hierarchy:
+ * - "embedded": Within the project's skills/ directory
+ * - "caamp": Within the CAAMP canonical directory (~/.agents/skills)
+ * - "project-link": Symlink pointing to project directory
+ * - "global-link": Symlink pointing to CAAMP or external location
+ *
+ * @task T4552
+ */
+export function getSkillSourceType(skillDir, projectRoot) {
+    const normalizedDir = safeRealpath(skillDir);
+    const caampDir = safeRealpath(getCaampCanonical());
+    const embeddedDir = getProjectEmbedded(projectRoot);
+    const root = getProjectRoot(projectRoot);
+    // Check if skill_dir is a symlink
+    try {
+        const stats = lstatSync(skillDir);
+        if (stats.isSymbolicLink()) {
+            const linkTarget = safeRealpath(readlinkSync(skillDir));
+            // Symlink target under CAAMP = global-link
+            if (linkTarget.startsWith(caampDir)) {
+                return 'global-link';
+            }
+            // Symlink target under project = project-link
+            if (linkTarget.startsWith(embeddedDir) || linkTarget.startsWith(root)) {
+                return 'project-link';
+            }
+            // Symlink to somewhere else
+            return 'global-link';
+        }
+    }
+    catch {
+        // If lstat fails, continue with directory-based classification
+    }
+    // Not a symlink - classify by containing directory
+    if (normalizedDir.startsWith(resolve(embeddedDir)) ||
+        normalizedDir.startsWith(join(root, 'skills'))) {
+        return 'embedded';
+    }
+    if (normalizedDir.startsWith(caampDir)) {
+        return 'caamp';
+    }
+    // Could not classify (likely from explicit CLEO_SKILL_PATH override)
+    return null;
+}
+//# sourceMappingURL=skill-paths.js.map

package/dist/skills/skill-paths.js.map

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

package/dist/skills/test-utility.js

@@ -0,0 +1,55 @@
+/**
+ * Test utility functions for implementation protocol validation.
+ * Ported from lib/skills/test-utility.sh
+ *
+ * Provides date formatting and timestamp generation helpers
+ * used in skill test validation workflows.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/**
+ * Format a date string in ISO 8601 format.
+ * Converts a YYYY-MM-DD date string to a full ISO 8601 timestamp.
+ *
+ * @param inputDate - Date string in YYYY-MM-DD format
+ * @returns ISO 8601 formatted string (e.g., "2026-02-03T00:00:00Z")
+ * @throws Error if date format is invalid or missing
+ * @task T4552
+ */
+export function formatIsoDate(inputDate) {
+    if (!inputDate) {
+        throw new Error('Date required');
+    }
+    // Validate format YYYY-MM-DD
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(inputDate)) {
+        throw new Error('Invalid date format. Expected YYYY-MM-DD');
+    }
+    return `${inputDate}T00:00:00Z`;
+}
+/**
+ * Get current timestamp in ISO 8601 format.
+ * Returns the current UTC time as an ISO 8601 string.
+ *
+ * @returns Current timestamp (e.g., "2026-02-16T14:30:00Z")
+ * @task T4552
+ */
+export function getCurrentTimestamp() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * Validate that a string is a valid ISO 8601 date.
+ * @task T4552
+ */
+export function isValidIsoDate(dateStr) {
+    const date = new Date(dateStr);
+    return !Number.isNaN(date.getTime()) && date.toISOString().startsWith(dateStr.slice(0, 10));
+}
+/**
+ * Format a Date object to a YYYY-MM-DD string.
+ * @task T4552
+ */
+export function formatDateYMD(date) {
+    return date.toISOString().split('T')[0];
+}
+//# sourceMappingURL=test-utility.js.map

package/dist/skills/test-utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utility.js","sourceRoot":"","sources":["../../src/skills/test-utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,GAAG,SAAS,YAAY,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;AAC3C,CAAC"}

package/dist/skills/types.js

@@ -0,0 +1,118 @@
+/**
+ * Type definitions for the skills system.
+ *
+ * ## Dual Type System: CAAMP vs CLEO Skills
+ *
+ * The skill type system has two layers reflecting the CAAMP/CLEO split:
+ *
+ * ### CAAMP types (re-exported as `CaampSkillMetadata`, `CtSkillEntry`, etc.)
+ * - Defined in `@cleocode/caamp` -- the cross-agent skill standard.
+ * - **`CaampSkillMetadata`**: Minimal metadata parsed from SKILL.md YAML header
+ *   by CAAMP's `parseSkillFile()`. Contains: name, description, version, license,
+ *   compatibility, metadata, allowedTools.
+ * - **`CtSkillEntry`**: A discovered skill with location + metadata. Used by CAAMP's
+ *   discovery and install pipeline.
+ * - Use CAAMP types when interacting with CAAMP APIs (skill discovery, install,
+ *   provider lock files, skill precedence resolution).
+ *
+ * ### CLEO types (`Skill`, `SkillFrontmatter`, `SkillSummary`, `SkillManifest`)
+ * - Defined here -- CLEO's extended skill domain model.
+ * - **`SkillFrontmatter`**: Superset of CaampSkillMetadata. Adds CLEO-specific
+ *   fields: tags, triggers, dispatchPriority, model, invocable, command, protocol.
+ *   Parsed by CLEO's own SKILL.md reader with richer YAML support.
+ * - **`Skill`**: Full in-memory skill object with filesystem paths and parsed content.
+ * - **`SkillSummary`**: Lightweight projection for listings (cached in SkillManifest).
+ * - Use CLEO types for skill dispatch, orchestration, CLI display, and manifest caching.
+ *
+ * ### Relationship
+ * - `SkillFrontmatter` is a functional superset of `CaampSkillMetadata`:
+ *   every field in CaampSkillMetadata exists in SkillFrontmatter (name, description,
+ *   version, allowedTools). SkillFrontmatter adds CLEO-specific extension fields.
+ * - A `Skill` (CLEO) wraps a `SkillFrontmatter` with filesystem context, whereas
+ *   a `CtSkillEntry` (CAAMP) wraps a `CaampSkillMetadata` with install metadata.
+ * - When converting between layers, map `CaampSkillMetadata` -> `SkillFrontmatter`
+ *   (all CAAMP fields carry over; CLEO-specific fields default to undefined).
+ *
+ * @epic T4454
+ * @task T4516
+ */
+// ============================================================================
+// Skill Name Mapping
+// ============================================================================
+/** Canonical skill name mapping (user-friendly to ct-prefixed). */
+export const SKILL_NAME_MAP = {
+    // Task execution
+    'TASK-EXECUTOR': 'ct-task-executor',
+    'task-executor': 'ct-task-executor',
+    'ct-task-executor': 'ct-task-executor',
+    EXECUTOR: 'ct-task-executor',
+    executor: 'ct-task-executor',
+    // Research
+    'RESEARCH-AGENT': 'ct-research-agent',
+    'research-agent': 'ct-research-agent',
+    'ct-research-agent': 'ct-research-agent',
+    RESEARCH: 'ct-research-agent',
+    research: 'ct-research-agent',
+    // Epic architect
+    'EPIC-ARCHITECT': 'ct-epic-architect',
+    'epic-architect': 'ct-epic-architect',
+    'ct-epic-architect': 'ct-epic-architect',
+    ARCHITECT: 'ct-epic-architect',
+    architect: 'ct-epic-architect',
+    // Spec writer
+    'SPEC-WRITER': 'ct-spec-writer',
+    'spec-writer': 'ct-spec-writer',
+    'ct-spec-writer': 'ct-spec-writer',
+    SPEC: 'ct-spec-writer',
+    spec: 'ct-spec-writer',
+    // Test writer
+    'TEST-WRITER-BATS': 'ct-test-writer-bats',
+    'test-writer-bats': 'ct-test-writer-bats',
+    'ct-test-writer-bats': 'ct-test-writer-bats',
+    'TEST-WRITER': 'ct-test-writer-bats',
+    'test-writer': 'ct-test-writer-bats',
+    BATS: 'ct-test-writer-bats',
+    bats: 'ct-test-writer-bats',
+    // Library implementer
+    'LIBRARY-IMPLEMENTER-BASH': 'ct-library-implementer-bash',
+    'library-implementer-bash': 'ct-library-implementer-bash',
+    'ct-library-implementer-bash': 'ct-library-implementer-bash',
+    'LIB-IMPLEMENTER': 'ct-library-implementer-bash',
+    'lib-implementer': 'ct-library-implementer-bash',
+    'BASH-LIB': 'ct-library-implementer-bash',
+    'bash-lib': 'ct-library-implementer-bash',
+    // Validator
+    VALIDATOR: 'ct-validator',
+    validator: 'ct-validator',
+    'ct-validator': 'ct-validator',
+    VALIDATE: 'ct-validator',
+    validate: 'ct-validator',
+    // Documentor
+    DOCUMENTOR: 'ct-documentor',
+    documentor: 'ct-documentor',
+    'ct-documentor': 'ct-documentor',
+    DOCS: 'ct-documentor',
+    docs: 'ct-documentor',
+    // Docs sub-skills
+    'DOCS-LOOKUP': 'ct-docs-lookup',
+    'docs-lookup': 'ct-docs-lookup',
+    'ct-docs-lookup': 'ct-docs-lookup',
+    'DOCS-WRITE': 'ct-docs-write',
+    'docs-write': 'ct-docs-write',
+    'ct-docs-write': 'ct-docs-write',
+    'DOCS-REVIEW': 'ct-docs-review',
+    'docs-review': 'ct-docs-review',
+    'ct-docs-review': 'ct-docs-review',
+    // Skill management
+    'SKILL-CREATOR': 'ct-skill-creator',
+    'skill-creator': 'ct-skill-creator',
+    'ct-skill-creator': 'ct-skill-creator',
+    'SKILL-LOOKUP': 'ct-skill-lookup',
+    'skill-lookup': 'ct-skill-lookup',
+    'ct-skill-lookup': 'ct-skill-lookup',
+    // Orchestrator
+    ORCHESTRATOR: 'ct-orchestrator',
+    orchestrator: 'ct-orchestrator',
+    'ct-orchestrator': 'ct-orchestrator',
+};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AA8YH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,iBAAiB;IACjB,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,kBAAkB,EAAE,kBAAkB;IACtC,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,kBAAkB;IAE5B,WAAW;IACX,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,mBAAmB;IACxC,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,mBAAmB;IAE7B,iBAAiB;IACjB,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,mBAAmB;IACxC,SAAS,EAAE,mBAAmB;IAC9B,SAAS,EAAE,mBAAmB;IAE9B,cAAc;IACd,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,gBAAgB;IAClC,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,gBAAgB;IAEtB,cAAc;IACd,kBAAkB,EAAE,qBAAqB;IACzC,kBAAkB,EAAE,qBAAqB;IACzC,qBAAqB,EAAE,qBAAqB;IAC5C,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,qBAAqB;IACpC,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,qBAAqB;IAE3B,sBAAsB;IACtB,0BAA0B,EAAE,6BAA6B;IACzD,0BAA0B,EAAE,6BAA6B;IACzD,6BAA6B,EAAE,6BAA6B;IAC5D,iBAAiB,EAAE,6BAA6B;IAChD,iBAAiB,EAAE,6BAA6B;IAChD,UAAU,EAAE,6BAA6B;IACzC,UAAU,EAAE,6BAA6B;IAEzC,YAAY;IACZ,SAAS,EAAE,cAAc;IACzB,SAAS,EAAE,cAAc;IACzB,cAAc,EAAE,cAAc;IAC9B,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc;IAExB,aAAa;IACb,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,eAAe;IAC3B,eAAe,EAAE,eAAe;IAChC,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;IAErB,kBAAkB;IAClB,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,gBAAgB;IAClC,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,eAAe;IAC7B,eAAe,EAAE,eAAe;IAChC,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,gBAAgB;IAElC,mBAAmB;IACnB,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,kBAAkB,EAAE,kBAAkB;IACtC,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,iBAAiB,EAAE,iBAAiB;IAEpC,eAAe;IACf,YAAY,EAAE,iBAAiB;IAC/B,YAAY,EAAE,iBAAiB;IAC/B,iBAAiB,EAAE,iBAAiB;CACrC,CAAC"}

package/dist/skills/validation.js

@@ -0,0 +1,183 @@
+/**
+ * Skill validation functions.
+ * Ports lib/skills/skill-validate.sh.
+ *
+ * Validates skill structure, frontmatter requirements, and protocol compliance.
+ *
+ * @epic T4454
+ * @task T4517
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { parseFrontmatter } from './discovery.js';
+// ============================================================================
+// Structural Validation
+// ============================================================================
+/** Valid protocol types for validation. */
+const VALID_PROTOCOLS = new Set([
+    'research',
+    'consensus',
+    'specification',
+    'decomposition',
+    'implementation',
+    'contribution',
+    'release',
+    'artifact-publish',
+    'provenance',
+]);
+/**
+ * Validate a skill directory structure and content.
+ * @task T4517
+ */
+export function validateSkill(skillDir) {
+    const issues = [];
+    const dirName = basename(skillDir);
+    // Check directory exists
+    if (!existsSync(skillDir)) {
+        issues.push({
+            severity: 'error',
+            code: 'SKILL_DIR_NOT_FOUND',
+            message: `Skill directory not found: ${skillDir}`,
+        });
+        return buildResult(dirName, skillDir, issues);
+    }
+    // Check SKILL.md exists
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillMdPath)) {
+        issues.push({
+            severity: 'error',
+            code: 'SKILL_MD_MISSING',
+            message: 'SKILL.md not found in skill directory',
+            path: skillMdPath,
+        });
+        return buildResult(dirName, skillDir, issues);
+    }
+    // Parse and validate frontmatter
+    const content = readFileSync(skillMdPath, 'utf-8');
+    const fm = parseFrontmatter(content);
+    validateFrontmatter(fm, issues, skillMdPath);
+    // Check naming convention
+    if (!dirName.startsWith('ct-') && !dirName.startsWith('_')) {
+        issues.push({
+            severity: 'warning',
+            code: 'NAMING_CONVENTION',
+            message: `Skill directory should use ct- prefix: ${dirName}`,
+        });
+    }
+    // Check for optional files
+    const optionalFiles = ['README.md', 'references'];
+    for (const file of optionalFiles) {
+        const filePath = join(skillDir, file);
+        if (!existsSync(filePath)) {
+            issues.push({
+                severity: 'info',
+                code: 'OPTIONAL_MISSING',
+                message: `Optional file/dir not found: ${file}`,
+                path: filePath,
+            });
+        }
+    }
+    return buildResult(dirName, skillDir, issues);
+}
+/**
+ * Validate skill frontmatter content.
+ * @task T4517
+ */
+function validateFrontmatter(fm, issues, path) {
+    // Required fields
+    if (!fm.name) {
+        issues.push({
+            severity: 'error',
+            code: 'FM_NAME_MISSING',
+            message: 'Frontmatter missing required "name" field',
+            path,
+        });
+    }
+    if (!fm.description) {
+        issues.push({
+            severity: 'error',
+            code: 'FM_DESCRIPTION_MISSING',
+            message: 'Frontmatter missing required "description" field',
+            path,
+        });
+    }
+    // Protocol validation
+    if (fm.protocol && !VALID_PROTOCOLS.has(fm.protocol)) {
+        issues.push({
+            severity: 'error',
+            code: 'FM_INVALID_PROTOCOL',
+            message: `Invalid protocol type: ${fm.protocol}. Valid: ${[...VALID_PROTOCOLS].join(', ')}`,
+            path,
+        });
+    }
+    // Version format
+    if (fm.version && !/^\d+\.\d+\.\d+/.test(fm.version)) {
+        issues.push({
+            severity: 'warning',
+            code: 'FM_VERSION_FORMAT',
+            message: `Version should be X.Y.Z or YYYY.M.patch format: ${fm.version}`,
+            path,
+        });
+    }
+    // Invocable skills must have a command
+    if (fm.invocable && !fm.command) {
+        issues.push({
+            severity: 'warning',
+            code: 'FM_INVOCABLE_NO_COMMAND',
+            message: 'Invocable skill should define a "command" field',
+            path,
+        });
+    }
+}
+/**
+ * Validate multiple skills at once.
+ * @task T4517
+ */
+export function validateSkills(skillDirs) {
+    return skillDirs.map(validateSkill);
+}
+/**
+ * Validate a return message against protocol-compliant patterns.
+ * @task T4517
+ */
+export function validateReturnMessage(message) {
+    const validPatterns = [
+        /^Research complete\. See MANIFEST\.jsonl for summary\.$/,
+        /^Epic created\. See MANIFEST\.jsonl for summary\.$/,
+        /^Tests complete\. See MANIFEST\.jsonl for summary\.$/,
+        /^Documentation complete\. See MANIFEST\.jsonl for summary\.$/,
+        /^Task complete\. See MANIFEST\.jsonl for summary\.$/,
+        /^\[.+\] complete\. See MANIFEST\.jsonl for summary\.$/,
+        /^\[.+\] partial\. See MANIFEST\.jsonl for details\.$/,
+        /^\[.+\] blocked\. See MANIFEST\.jsonl for blocker details\.$/,
+    ];
+    const trimmed = message.trim();
+    if (!trimmed) {
+        return { valid: false, error: 'Return message is empty' };
+    }
+    for (const pattern of validPatterns) {
+        if (pattern.test(trimmed)) {
+            return { valid: true };
+        }
+    }
+    return {
+        valid: false,
+        error: `Return message does not match protocol format: "${trimmed.slice(0, 100)}"`,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function buildResult(skillName, skillPath, issues) {
+    const errorCount = issues.filter((i) => i.severity === 'error').length;
+    const warningCount = issues.filter((i) => i.severity === 'warning').length;
+    return {
+        valid: errorCount === 0,
+        skillName,
+        skillPath,
+        issues,
+        errorCount,
+        warningCount,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/skills/validation.js.map

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

package/dist/skills/version.js

@@ -0,0 +1,57 @@
+/**
+ * Skills version tracking.
+ *
+ * CAAMP's skills-lock is the exclusive source of truth for skill versions.
+ *
+ * @epic T4454
+ * @task T4521
+ * @task T4680
+ */
+import { checkAllSkillUpdates as caampCheckAllSkillUpdates, checkSkillUpdate as caampCheckSkillUpdate, getTrackedSkills as caampGetTrackedSkills, } from '@cleocode/caamp';
+/**
+ * Get the installed version of a skill from CAAMP lock state.
+ */
+export async function getInstalledVersionAsync(name) {
+    try {
+        const tracked = await caampGetTrackedSkills();
+        const entry = tracked[name];
+        return entry?.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a specific skill needs an update via CAAMP.
+ */
+export async function checkSkillUpdateAsync(name) {
+    try {
+        const result = await caampCheckSkillUpdate(name);
+        return {
+            needsUpdate: result.hasUpdate,
+            currentVersion: result.currentVersion,
+            latestVersion: result.latestVersion,
+        };
+    }
+    catch {
+        return { needsUpdate: false };
+    }
+}
+/**
+ * Check all installed skills for available updates via CAAMP.
+ */
+export async function checkAllSkillUpdatesAsync() {
+    try {
+        const results = await caampCheckAllSkillUpdates();
+        return Object.entries(results).map(([name, status]) => ({
+            name,
+            installedVersion: status.currentVersion ?? 'unknown',
+            availableVersion: status.latestVersion ?? 'unknown',
+            needsUpdate: status.hasUpdate,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/skills/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/skills/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,oBAAoB,IAAI,yBAAyB,EACjD,gBAAgB,IAAI,qBAAqB,EACzC,gBAAgB,IAAI,qBAAqB,GAC1C,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IAKtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,SAAS;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAQ7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,yBAAyB,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,IAAI;YACJ,gBAAgB,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;YACpD,gBAAgB,EAAE,MAAM,CAAC,aAAa,IAAI,SAAS;YACnD,WAAW,EAAE,MAAM,CAAC,SAAS;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}