@cleocode/cleo 2026.2.5

package/dist/core/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 !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/core/skills/test-utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utility.js","sourceRoot":"","sources":["../../../src/core/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,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;AACvF,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/core/skills/types.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Type definitions for the skills system.
+ * Re-exports overlapping CAAMP types for downstream consumers.
+ * @epic T4454
+ * @task T4516
+ */
+export type { Provider, SkillMetadata as CaampSkillMetadata, McpServerConfig, CtSkillEntry, CtDispatchMatrix, CtManifest, CtManifestSkill, CtProfileDefinition, CtValidationResult, CtValidationIssue, } from '@cleocode/caamp';
+/** Skill frontmatter parsed from SKILL.md YAML header. */
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    version?: string;
+    author?: string;
+    tags?: string[];
+    triggers?: string[];
+    dispatchPriority?: number;
+    model?: string;
+    allowedTools?: string[];
+    invocable?: boolean;
+    command?: string;
+    protocol?: SkillProtocolType;
+}
+/** Skill definition loaded from disk. */
+export interface Skill {
+    name: string;
+    dirName: string;
+    path: string;
+    skillMdPath: string;
+    frontmatter: SkillFrontmatter;
+    content?: string;
+}
+/** Lightweight skill summary for manifest/listing. */
+export interface SkillSummary {
+    name: string;
+    dirName: string;
+    description: string;
+    tags: string[];
+    version: string;
+    invocable: boolean;
+    command?: string;
+    protocol?: SkillProtocolType;
+}
+/** Skill manifest (cached aggregate of all discovered skills). */
+export interface SkillManifest {
+    _meta: {
+        generatedAt: string;
+        ttlSeconds: number;
+        skillCount: number;
+        searchPaths: string[];
+    };
+    skills: SkillSummary[];
+}
+/** RCSD-IVTR protocol types. */
+export type SkillProtocolType = 'research' | 'consensus' | 'specification' | 'decomposition' | 'implementation' | 'contribution' | 'release' | 'artifact-publish' | 'provenance';
+/** Agent configuration from AGENT.md or agent definition. */
+export interface AgentConfig {
+    name: string;
+    description: string;
+    model?: string;
+    allowedTools?: string[];
+    customInstructions?: string;
+}
+/** Agent registry entry. */
+export interface AgentRegistryEntry {
+    name: string;
+    path: string;
+    config: AgentConfig;
+    installedAt: string;
+}
+/** Agent registry (persisted). */
+export interface AgentRegistry {
+    _meta: {
+        version: string;
+        lastUpdated: string;
+    };
+    agents: AgentRegistryEntry[];
+}
+/** CAAMP search order for skill discovery. */
+export type SkillSearchScope = 'cleo-home' | 'agent-skills' | 'app-embedded' | 'marketplace' | 'project-custom';
+/** Ordered search path entry. */
+export interface SkillSearchPath {
+    scope: SkillSearchScope;
+    path: string;
+    priority: number;
+}
+/** Dispatch strategy for skill selection. */
+export type DispatchStrategy = 'label' | 'type' | 'keyword' | 'fallback';
+/** Dispatch result from skill_auto_dispatch. */
+export interface DispatchResult {
+    skill: string;
+    strategy: DispatchStrategy;
+    confidence: number;
+    protocol?: SkillProtocolType;
+}
+/** Token definition from placeholders.json. */
+export interface TokenDefinition {
+    token: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
+    pattern?: string;
+}
+/** Token validation result. */
+export interface TokenValidationResult {
+    valid: boolean;
+    token: string;
+    value?: string;
+    error?: string;
+}
+/** Token injection context. */
+export interface TokenContext {
+    taskId: string;
+    date: string;
+    topicSlug: string;
+    epicId?: string;
+    sessionId?: string;
+    outputDir?: string;
+    manifestPath?: string;
+    [key: string]: string | undefined;
+}
+/** Orchestrator context thresholds. */
+export interface OrchestratorThresholds {
+    warning: number;
+    critical: number;
+}
+/** Pre-spawn check result. */
+export interface PreSpawnCheckResult {
+    canSpawn: boolean;
+    spawnStatus: 'ok' | 'warning' | 'stale' | 'blocked';
+    recommendation: 'continue' | 'wrap_up' | 'stop' | 'verify_compliance';
+    context: {
+        percentage: number;
+        currentTokens: number;
+        maxTokens: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+        status: string;
+        stale: boolean;
+    };
+    reasons: Array<{
+        code: string;
+        message: string;
+    }>;
+    taskValidation?: {
+        exists: boolean;
+        taskId: string;
+        status?: string;
+        title?: string;
+        spawnable: boolean;
+    } | null;
+    complianceValidation?: Record<string, unknown> | null;
+}
+/** Spawn prompt result. */
+export interface SpawnPromptResult {
+    taskId: string;
+    template: string;
+    topicSlug: string;
+    date: string;
+    outputDir: string;
+    outputFile: string;
+    prompt: string;
+}
+/** Dependency wave for parallel execution. */
+export interface DependencyWave {
+    wave: number;
+    tasks: Array<{
+        id: string;
+        title: string;
+        priority?: string;
+        status: string;
+        depends: string[];
+    }>;
+}
+/** Dependency analysis result. */
+export interface DependencyAnalysis {
+    epicId: string;
+    totalTasks: number;
+    completedTasks: number;
+    pendingTasks: number;
+    activeTasks: number;
+    waves: DependencyWave[];
+    readyToSpawn: Array<{
+        id: string;
+        title: string;
+        priority?: string;
+        wave: number;
+    }>;
+    blockedTasks: Array<{
+        id: string;
+        title: string;
+        depends: string[];
+        wave: number;
+    }>;
+}
+/** HITL summary for session handoff. */
+export interface HitlSummary {
+    timestamp: string;
+    stopReason: string;
+    session: {
+        id: string | null;
+        epicId: string | null;
+        focusedTask: string | null;
+        progressNote: string | null;
+    };
+    progress: {
+        completed: number;
+        pending: number;
+        active: number;
+        blocked: number;
+        total: number;
+        percentComplete: number;
+    };
+    completedTasks: Array<{
+        id: string;
+        title: string;
+    }>;
+    remainingTasks: Array<{
+        id: string;
+        title: string;
+        status: string;
+        priority?: string;
+    }>;
+    readyToSpawn: Array<{
+        id: string;
+        title: string;
+        priority?: string;
+    }>;
+    handoff: {
+        resumeCommand: string;
+        nextSteps: string[];
+    };
+}
+/** Research manifest entry (MANIFEST.jsonl). */
+export interface ManifestEntry {
+    id: string;
+    file: string;
+    title: string;
+    date: string;
+    status: 'complete' | 'partial' | 'blocked' | 'archived';
+    agent_type?: string;
+    topics: string[];
+    key_findings: string[];
+    actionable: boolean;
+    needs_followup: string[];
+    linked_tasks?: string[];
+    audit?: Record<string, unknown>;
+}
+/** Manifest validation result. */
+export interface ManifestValidationResult {
+    exists: boolean;
+    passed: boolean;
+    stats?: {
+        totalLines: number;
+        validEntries: number;
+        invalidEntries: number;
+    };
+    issues: string[];
+}
+/** Compliance verification result. */
+export interface ComplianceResult {
+    previousTaskId: string;
+    researchId: string | null;
+    checks: {
+        manifestEntryExists: boolean;
+        researchLinkedToTask: boolean;
+        returnStatusValid: boolean | null;
+    };
+    canSpawnNext: boolean;
+    violations: string[];
+    warnings: string[];
+}
+/** Installed skill tracking. */
+export interface InstalledSkill {
+    name: string;
+    version: string;
+    installedAt: string;
+    sourcePath: string;
+    symlinkPath: string;
+}
+/** Installed skills file. */
+export interface InstalledSkillsFile {
+    _meta: {
+        version: string;
+        lastUpdated: string;
+    };
+    skills: Record<string, InstalledSkill>;
+}
+/** Canonical skill name mapping (user-friendly to ct-prefixed). */
+export declare const SKILL_NAME_MAP: Record<string, string>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/skills/types.js

@@ -0,0 +1,86 @@
+/**
+ * Type definitions for the skills system.
+ * Re-exports overlapping CAAMP types for downstream consumers.
+ * @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/core/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyWH,+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,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,kBAAkB;IAE9B,WAAW;IACX,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,mBAAmB;IACxC,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,mBAAmB;IAE/B,iBAAiB;IACjB,gBAAgB,EAAE,mBAAmB;IACrC,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,mBAAmB;IACxC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,mBAAmB;IAEhC,cAAc;IACd,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,gBAAgB;IAClC,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,gBAAgB;IAExB,cAAc;IACd,kBAAkB,EAAE,qBAAqB;IACzC,kBAAkB,EAAE,qBAAqB;IACzC,qBAAqB,EAAE,qBAAqB;IAC5C,aAAa,EAAE,qBAAqB;IACpC,aAAa,EAAE,qBAAqB;IACpC,MAAM,EAAE,qBAAqB;IAC7B,MAAM,EAAE,qBAAqB;IAE7B,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,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,cAAc;IAC9B,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;IAE1B,aAAa;IACb,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,eAAe;IAC7B,eAAe,EAAE,eAAe;IAChC,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IAEvB,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,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,iBAAiB,EAAE,iBAAiB;CACrC,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Skill validation functions.
+ * Ports lib/skills/skill-validate.sh.
+ *
+ * Validates skill structure, frontmatter requirements, and protocol compliance.
+ *
+ * @epic T4454
+ * @task T4517
+ */
+/** Validation issue severity. */
+export type IssueSeverity = 'error' | 'warning' | 'info';
+/** Single validation issue. */
+export interface ValidationIssue {
+    severity: IssueSeverity;
+    code: string;
+    message: string;
+    path?: string;
+}
+/** Validation result for a skill. */
+export interface SkillValidationResult {
+    valid: boolean;
+    skillName: string;
+    skillPath: string;
+    issues: ValidationIssue[];
+    errorCount: number;
+    warningCount: number;
+}
+/**
+ * Validate a skill directory structure and content.
+ * @task T4517
+ */
+export declare function validateSkill(skillDir: string): SkillValidationResult;
+/**
+ * Validate multiple skills at once.
+ * @task T4517
+ */
+export declare function validateSkills(skillDirs: string[]): SkillValidationResult[];
+/**
+ * Validate a return message against protocol-compliant patterns.
+ * @task T4517
+ */
+export declare function validateReturnMessage(message: string): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/skills/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAwDrE;AA6DD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,qBAAqB,EAAE,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BzF"}

package/dist/core/skills/validation.js

@@ -0,0 +1,176 @@
+/**
+ * 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 { join, basename } 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