@cleocode/cleo 2026.2.5

package/dist/core/skills/orchestrator/validator.js

@@ -0,0 +1,297 @@
+/**
+ * Orchestrator protocol compliance validation.
+ * Ports lib/skills/orchestrator-validator.sh.
+ *
+ * Validates subagent output compliance, orchestrator behavior,
+ * manifest integrity, and pre-spawn compliance checks.
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTaskPath, getAgentOutputsAbsolute, getManifestPath as getManifestPathFromPaths } from '../../paths.js';
+// validateReturnMessage used for protocol validation in validate_return_message
+// import { validateReturnMessage } from '../validation.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const KEY_FINDINGS_MIN = 3;
+const KEY_FINDINGS_MAX = 7;
+const MANIFEST_REQUIRED_FIELDS = [
+    'id', 'file', 'title', 'date', 'status', 'topics', 'key_findings', 'actionable',
+];
+const VALID_STATUSES = new Set(['complete', 'partial', 'blocked', 'archived']);
+// ============================================================================
+// Manifest Helpers
+// ============================================================================
+/** Alias for centralized getManifestPath to avoid name conflicts with local usages. */
+function getManifestPath(cwd) {
+    return getManifestPathFromPaths(cwd);
+}
+/**
+ * Read all manifest entries from MANIFEST.jsonl.
+ */
+function readManifestEntries(cwd) {
+    const manifestPath = getManifestPath(cwd);
+    if (!existsSync(manifestPath))
+        return [];
+    const content = readFileSync(manifestPath, 'utf-8');
+    const entries = [];
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip invalid lines
+        }
+    }
+    return entries;
+}
+// ============================================================================
+// Subagent Output Validation
+// ============================================================================
+/**
+ * Validate a subagent's manifest entry for protocol compliance.
+ * @task T4519
+ */
+export function validateSubagentOutput(researchId, cwd) {
+    const issues = [];
+    const checkedRules = [
+        'MANIFEST_ENTRY_EXISTS',
+        'REQUIRED_FIELDS_PRESENT',
+        'STATUS_VALID_ENUM',
+        'KEY_FINDINGS_COUNT_3_7',
+        'DATE_ISO_8601',
+        'TOPICS_ARRAY_NON_EMPTY',
+        'NEEDS_FOLLOWUP_ARRAY',
+        'ACTIONABLE_BOOLEAN',
+        'OUTPUT_FILE_EXISTS',
+    ];
+    const entries = readManifestEntries(cwd);
+    const entry = entries.find(e => e.id === researchId);
+    if (!entry) {
+        issues.push(`MANIFEST_ENTRY_MISSING: No manifest entry found for id=${researchId}`);
+        return { passed: false, issues, checkedRules };
+    }
+    // Check required fields
+    for (const field of MANIFEST_REQUIRED_FIELDS) {
+        if (!(field in entry)) {
+            issues.push(`MISSING_FIELD: ${field}`);
+        }
+    }
+    // Validate status
+    if (entry.status && !VALID_STATUSES.has(entry.status)) {
+        issues.push(`INVALID_STATUS: ${entry.status} (must be complete|partial|blocked|archived)`);
+    }
+    // Validate key_findings count
+    if (!Array.isArray(entry.key_findings)) {
+        issues.push('KEY_FINDINGS_NOT_ARRAY');
+    }
+    else if (entry.key_findings.length < KEY_FINDINGS_MIN) {
+        issues.push(`KEY_FINDINGS_TOO_FEW: count=${entry.key_findings.length} (must be ${KEY_FINDINGS_MIN}-${KEY_FINDINGS_MAX})`);
+    }
+    else if (entry.key_findings.length > KEY_FINDINGS_MAX) {
+        issues.push(`KEY_FINDINGS_TOO_MANY: count=${entry.key_findings.length} (must be ${KEY_FINDINGS_MIN}-${KEY_FINDINGS_MAX})`);
+    }
+    // Validate date format
+    if (entry.date && !/^\d{4}-\d{2}-\d{2}$/.test(entry.date)) {
+        issues.push(`INVALID_DATE: ${entry.date} (must be YYYY-MM-DD)`);
+    }
+    // Validate topics
+    if (!Array.isArray(entry.topics) || entry.topics.length === 0) {
+        issues.push('TOPICS_EMPTY: topics must be a non-empty array');
+    }
+    // Validate actionable
+    if (typeof entry.actionable !== 'boolean') {
+        issues.push('ACTIONABLE_NOT_BOOLEAN');
+    }
+    // Check output file exists
+    if (entry.file) {
+        const absOutputDir = getAgentOutputsAbsolute(cwd);
+        const filePath = join(absOutputDir, entry.file);
+        if (!existsSync(filePath)) {
+            issues.push(`FILE_NOT_FOUND: Expected file at ${filePath}`);
+        }
+    }
+    return { passed: issues.length === 0, issues, checkedRules };
+}
+// ============================================================================
+// Manifest Integrity
+// ============================================================================
+/**
+ * Validate the entire manifest file integrity.
+ * @task T4519
+ */
+export function validateManifestIntegrity(cwd) {
+    const manifestPath = getManifestPath(cwd);
+    if (!existsSync(manifestPath)) {
+        return { exists: false, passed: true, issues: [] };
+    }
+    const content = readFileSync(manifestPath, 'utf-8');
+    const lines = content.split('\n').filter(l => l.trim());
+    const issues = [];
+    let validEntries = 0;
+    let invalidEntries = 0;
+    const seenIds = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        // Check valid JSON
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            issues.push(`LINE_${lineNum}_INVALID_JSON: Parse error`);
+            invalidEntries++;
+            continue;
+        }
+        // Check id field
+        if (!entry.id) {
+            issues.push(`LINE_${lineNum}_MISSING_ID: No id field`);
+            invalidEntries++;
+            continue;
+        }
+        // Check duplicate ID
+        if (seenIds.has(entry.id)) {
+            issues.push(`LINE_${lineNum}_DUPLICATE_ID: ${entry.id} already exists`);
+            invalidEntries++;
+            continue;
+        }
+        seenIds.add(entry.id);
+        // Check file exists
+        if (entry.file) {
+            const absOutputDir = getAgentOutputsAbsolute(cwd);
+            const filePath = join(absOutputDir, entry.file);
+            if (!existsSync(filePath)) {
+                issues.push(`LINE_${lineNum}_FILE_MISSING: ${entry.file} does not exist`);
+            }
+        }
+        validEntries++;
+    }
+    return {
+        exists: true,
+        passed: issues.length === 0,
+        stats: {
+            totalLines: lines.length,
+            validEntries,
+            invalidEntries,
+        },
+        issues,
+    };
+}
+// ============================================================================
+// Pre-Spawn Compliance Verification
+// ============================================================================
+/**
+ * Verify previous agent completed protocol compliance before spawning next.
+ * @task T4519
+ */
+export function verifyCompliance(previousTaskId, researchId, cwd) {
+    const violations = [];
+    const warnings = [];
+    const entries = readManifestEntries(cwd);
+    // Find manifest entry for previous task
+    let entry;
+    if (researchId) {
+        entry = entries.find(e => e.id === researchId);
+    }
+    else {
+        // Search by linked_tasks
+        entry = entries.find(e => e.linked_tasks?.includes(previousTaskId) ||
+            e.needs_followup?.includes(previousTaskId));
+        // Try ID pattern match
+        if (!entry) {
+            const taskNum = previousTaskId.replace(/^T/, '');
+            entry = entries.find(e => e.id.includes(taskNum));
+        }
+    }
+    const manifestEntryExists = !!entry;
+    if (!manifestEntryExists) {
+        violations.push(`MANIFEST_ENTRY_MISSING: No manifest entry found for task ${previousTaskId}`);
+    }
+    // Check research linked to task
+    let researchLinkedToTask = false;
+    if (entry) {
+        researchLinkedToTask = entry.linked_tasks?.includes(previousTaskId) ?? false;
+        if (!researchLinkedToTask) {
+            warnings.push(`RESEARCH_NOT_LINKED: Research entry exists but not linked to task ${previousTaskId}`);
+        }
+    }
+    // Check return status
+    let returnStatusValid = null;
+    if (entry) {
+        returnStatusValid = VALID_STATUSES.has(entry.status);
+        if (!returnStatusValid) {
+            violations.push(`INVALID_MANIFEST_STATUS: ${entry.status}`);
+        }
+    }
+    return {
+        previousTaskId,
+        researchId: entry?.id ?? null,
+        checks: {
+            manifestEntryExists,
+            researchLinkedToTask,
+            returnStatusValid,
+        },
+        canSpawnNext: violations.length === 0,
+        violations,
+        warnings,
+    };
+}
+/**
+ * Validate orchestrator compliance (post-hoc behavioral checks).
+ * @task T4519
+ */
+export function validateOrchestratorCompliance(epicId, cwd) {
+    const violations = [];
+    const warnings = [];
+    const manifestPath = getManifestPath(cwd);
+    // Check manifest usage
+    if (!existsSync(manifestPath)) {
+        warnings.push(`ORC-005_NO_MANIFEST: Manifest file not found at ${manifestPath}`);
+    }
+    else {
+        const content = readFileSync(manifestPath, 'utf-8').trim();
+        if (!content) {
+            warnings.push('ORC-005_EMPTY_MANIFEST: Manifest exists but has no entries');
+        }
+    }
+    // Check dependency order (ORC-004) for completed tasks
+    if (epicId) {
+        const todoPath = getTaskPath(cwd);
+        if (existsSync(todoPath)) {
+            try {
+                const data = JSON.parse(readFileSync(todoPath, 'utf-8'));
+                const tasks = (data.tasks ?? []).filter((t) => t.parentId === epicId && t.status === 'done');
+                // Sort by updatedAt and check for dependency violations
+                const sorted = tasks.sort((a, b) => new Date(a.updatedAt ?? '').getTime() - new Date(b.updatedAt ?? '').getTime());
+                const completionOrder = sorted.map(t => t.id);
+                for (let i = 0; i < sorted.length; i++) {
+                    const deps = sorted[i].depends ?? [];
+                    for (const dep of deps) {
+                        const depIdx = completionOrder.indexOf(dep);
+                        if (depIdx >= 0 && depIdx >= i) {
+                            violations.push(`ORC-004_DEPENDENCY_ORDER: Task ${sorted[i].id} completed before dependency ${dep}`);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip on parse error
+            }
+        }
+    }
+    return {
+        compliant: violations.length === 0,
+        violations,
+        warnings,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/skills/orchestrator/validator.js.map

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

package/dist/core/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}/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/core/skills/skill-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-paths.d.ts","sourceRoot":"","sources":["../../../src/core/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;AAwCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CA0C3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAmBf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,IAAI,CAkBf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,GAAG,IAAI,CAwCxB"}

package/dist/core/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, realpathSync, readlinkSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Get the CAAMP canonical skill location.
+ * @task T4552
+ */
+function getCaampCanonical() {
+    const agentsHome = process.env['AGENTS_HOME'] ?? join(homedir(), '.agents');
+    return join(agentsHome, 'skills');
+}
+/**
+ * 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(':')) {
+            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;
+        case 'auto':
+        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}/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, '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/core/skills/skill-paths.js.map

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

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

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