@cleocode/core 2026.3.42 → 2026.3.43

package/dist/skills/precedence-integration.d.ts

@@ -0,0 +1,46 @@
+import { type SkillsPrecedence } from '@cleocode/caamp';
+import type { ResolvedSkillPath, SkillInstallationContext } from './precedence-types.js';
+/**
+ * Get effective skill paths for a provider considering precedence
+ * @param providerId - The ID of the provider
+ * @param scope - The scope ('global' or 'project')
+ * @param projectRoot - Optional project root path for project-scoped resolution
+ * @returns Array of resolved skill paths with precedence information
+ * @throws Error if provider not found
+ */
+export declare function resolveSkillPathsForProvider(providerId: string, scope: 'global' | 'project', projectRoot?: string): Promise<ResolvedSkillPath[]>;
+/**
+ * Get all providers that use a specific precedence mode
+ * @param precedence - The precedence mode to filter by
+ * @returns Array of provider IDs using the specified precedence
+ */
+export declare function getProvidersWithPrecedence(precedence: SkillsPrecedence): string[];
+/**
+ * Build complete skills map with precedence information
+ * @returns Array of provider skill configurations with precedence data
+ */
+export declare function getSkillsMapWithPrecedence(): Array<{
+    providerId: string;
+    toolName: string;
+    precedence: SkillsPrecedence;
+    paths: {
+        global: string | null;
+        project: string | null;
+    };
+}>;
+/**
+ * Determine target installation paths for a skill
+ * @param context - The installation context including target providers and project root
+ * @returns Array of installation targets with provider ID and path
+ */
+export declare function determineInstallationTargets(context: SkillInstallationContext): Promise<Array<{
+    providerId: string;
+    path: string;
+}>>;
+/**
+ * Check if provider supports agents path
+ * @param providerId - The ID of the provider to check
+ * @returns True if provider has agents path configuration
+ */
+export declare function supportsAgentsPath(providerId: string): Promise<boolean>;
+//# sourceMappingURL=precedence-integration.d.ts.map

package/dist/skills/precedence-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precedence-integration.d.ts","sourceRoot":"","sources":["../../src/skills/precedence-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkB9B;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEjF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,KAAK,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC1D,CAAC,CAED;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAoBtD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7E"}

package/dist/skills/precedence-types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Skills Precedence Types - Phase 3B of T5238
+ * Re-exports CAAMP precedence types and adds CLEO-specific wrapper types.
+ * @task T5238
+ */
+export type { ProviderSkillsCapability, SkillsPrecedence, } from '@cleocode/caamp';
+export { buildSkillsMap, getEffectiveSkillsPaths, getProvidersBySkillsPrecedence, } from '@cleocode/caamp';
+import type { SkillsPrecedence } from '@cleocode/caamp';
+export interface SkillsPrecedenceConfig {
+    defaultPrecedence?: SkillsPrecedence;
+    providerOverrides?: Record<string, SkillsPrecedence>;
+}
+export interface ResolvedSkillPath {
+    path: string;
+    source: 'vendor' | 'agents' | 'marketplace';
+    scope: 'global' | 'project';
+    precedence: SkillsPrecedence;
+    providerId: string;
+}
+export interface SkillInstallationContext {
+    skillName: string;
+    source: string;
+    targetProviders: string[];
+    precedenceMode?: SkillsPrecedence;
+    projectRoot?: string;
+}
+//# sourceMappingURL=precedence-types.d.ts.map

package/dist/skills/precedence-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precedence-types.d.ts","sourceRoot":"","sources":["../../src/skills/precedence-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC5C,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/skills/routing-table.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Dynamic Skill Routing Table
+ *
+ * Token-efficiency routing table that determines whether each operation
+ * is more efficient via MCP (lower overhead) or CLI (more flexible).
+ *
+ * MCP operations avoid CLI process startup overhead (~200ms + ~50 tokens)
+ * and are preferred for rapid, repeated queries. CLI is preferred for
+ * operations that benefit from human-readable output or shell integration.
+ *
+ * @task T5240
+ * @epic T5149
+ */
+/**
+ * Routing entry describing the preferred channel for an operation.
+ */
+export interface RoutingEntry {
+    /** Domain name (e.g. 'tasks', 'memory', 'session') */
+    domain: string;
+    /** Operation name (e.g. 'brain.search', 'show') */
+    operation: string;
+    /** Preferred channel for token efficiency */
+    preferredChannel: 'mcp' | 'cli' | 'either';
+    /** Reason for the channel preference */
+    reason: string;
+}
+/**
+ * Static routing table for all canonical operations.
+ *
+ * Operations are grouped by domain with channel preferences based on:
+ * - MCP: lower overhead (no CLI startup), direct DB access, structured JSON
+ * - CLI: human-readable output, shell integration, interactive prompts
+ * - Either: no significant difference or context-dependent
+ */
+export declare const ROUTING_TABLE: RoutingEntry[];
+/**
+ * Look up the preferred channel for a given domain + operation.
+ *
+ * @param domain - Domain name
+ * @param operation - Operation name
+ * @returns Preferred channel ('mcp', 'cli', or 'either' as fallback)
+ */
+export declare function getPreferredChannel(domain: string, operation: string): 'mcp' | 'cli' | 'either';
+/**
+ * Get routing entries for a specific domain.
+ *
+ * @param domain - Domain name
+ * @returns All routing entries for the domain
+ */
+export declare function getRoutingForDomain(domain: string): RoutingEntry[];
+/**
+ * Get all operations that prefer a specific channel.
+ *
+ * @param channel - Channel preference to filter by
+ * @returns Matching routing entries
+ */
+export declare function getOperationsByChannel(channel: 'mcp' | 'cli' | 'either'): RoutingEntry[];
+//# sourceMappingURL=routing-table.d.ts.map

package/dist/skills/routing-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-table.d.ts","sourceRoot":"","sources":["../../src/skills/routing-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,gBAAgB,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,EAyOvC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,EAAE,CAExF"}

package/dist/skills/skill-paths.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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
+ */
+/** Source type classification for a skill directory. */
+export type SkillSourceType = 'embedded' | 'caamp' | 'project-link' | 'global-link';
+/** Skill source mode. */
+export type SkillSourceMode = 'auto' | 'caamp' | 'embedded';
+/** Search path entry with its origin. */
+export interface SkillSearchPath {
+    path: string;
+    origin: 'override' | 'caamp' | 'embedded';
+}
+/**
+ * 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 declare function getSkillSearchPaths(projectRoot?: string): SkillSearchPath[];
+/**
+ * Resolve a skill directory containing SKILL.md.
+ * Searches all paths from getSkillSearchPaths() in priority order.
+ * First match wins.
+ *
+ * @task T4552
+ */
+export declare function resolveSkillPath(skillName: string, projectRoot?: string): string | 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 declare function resolveProtocolPath(protocolName: string, projectRoot?: string): string | 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 declare function resolveSharedPath(resourceName: string, projectRoot?: string): string | 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 declare function getSkillSourceType(skillDir: string, projectRoot?: string): SkillSourceType | null;
+//# sourceMappingURL=skill-paths.d.ts.map

package/dist/skills/skill-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-paths.d.ts","sourceRoot":"","sources":["../../src/skills/skill-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,CAAC;AAEpF,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;CAC3C;AAuCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAyC3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2CjG"}

package/dist/skills/test-utility.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 declare function formatIsoDate(inputDate: string): string;
+/**
+ * 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 declare function getCurrentTimestamp(): string;
+/**
+ * Validate that a string is a valid ISO 8601 date.
+ * @task T4552
+ */
+export declare function isValidIsoDate(dateStr: string): boolean;
+/**
+ * Format a Date object to a YYYY-MM-DD string.
+ * @task T4552
+ */
+export declare function formatDateYMD(date: Date): string;
+//# sourceMappingURL=test-utility.d.ts.map

package/dist/skills/test-utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utility.d.ts","sourceRoot":"","sources":["../../src/skills/test-utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD"}

package/dist/skills/types.d.ts

@@ -0,0 +1,281 @@
+/**
+ * Type definitions for the skills system.
+ * Re-exports overlapping CAAMP types for downstream consumers.
+ * @epic T4454
+ * @task T4516
+ */
+import type { TaskRef, TaskRefPriority } from '@cleocode/contracts';
+export type { CtDispatchMatrix, CtManifest, CtManifestSkill, CtProfileDefinition, CtSkillEntry, CtValidationIssue, CtValidationResult, McpServerConfig, Provider, SkillMetadata as CaampSkillMetadata, } 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[];
+}
+/** RCASD-IVTR+C 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<Pick<TaskRef, 'id' | 'title'>>;
+    remainingTasks: Array<TaskRef & {
+        priority?: string;
+    }>;
+    readyToSpawn: TaskRefPriority[];
+    handoff: {
+        resumeCommand: string;
+        nextSteps: string[];
+    };
+}
+/** Research manifest entry (MANIFEST.jsonl). */
+export interface ManifestEntry {
+    id: string;
+    file: string;
+    title: string;
+    date: string;
+    status: 'completed' | '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/skills/types.d.ts.map

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

package/dist/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/skills/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/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;AAmBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAwDrE;AAyDD;;;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/skills/version.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Skills version tracking.
+ *
+ * CAAMP's skills-lock is the exclusive source of truth for skill versions.
+ *
+ * @epic T4454
+ * @task T4521
+ * @task T4680
+ */
+/**
+ * Get the installed version of a skill from CAAMP lock state.
+ */
+export declare function getInstalledVersionAsync(name: string): Promise<string | null>;
+/**
+ * Check if a specific skill needs an update via CAAMP.
+ */
+export declare function checkSkillUpdateAsync(name: string): Promise<{
+    needsUpdate: boolean;
+    currentVersion?: string;
+    latestVersion?: string;
+}>;
+/**
+ * Check all installed skills for available updates via CAAMP.
+ */
+export declare function checkAllSkillUpdatesAsync(): Promise<Array<{
+    name: string;
+    installedVersion: string;
+    availableVersion: string;
+    needsUpdate: boolean;
+}>>;
+//# sourceMappingURL=version.d.ts.map

package/dist/skills/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/skills/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAWD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CACxD,KAAK,CAAC;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CACH,CAYA"}