@pennyfarthing/core 6.6.0

package/packages/core/dist/workflow/test-cache.test.js

@@ -0,0 +1,438 @@
+/**
+ * Tests for Story 31-8: Test Result Caching
+ *
+ * These tests verify the test cache module that eliminates redundant
+ * test runs in subagents by caching results in the session file.
+ *
+ * Test categories:
+ * 1. parseTestCache() - Parse cache from session file markdown
+ * 2. validateTestCache() - Validate cache freshness
+ * 3. formatTestCache() - Format cache for session file
+ * 4. createTestCacheEntry() - Create entry from results
+ * 5. shouldSkipTests() - Convenience function for subagents
+ *
+ * Run with: npm test
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { parseTestCache, validateTestCache, formatTestCache, createTestCacheEntry, shouldSkipTests, DEFAULT_CACHE_MAX_AGE_MINUTES } from './test-cache.js';
+// Test fixtures
+const VALID_CACHE_SECTION = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234def5678 |
+| Result | GREEN |
+| Pass | 78 |
+| Fail | 0 |
+| Duration | 36s |
+`;
+const CACHE_WITH_SKIPS = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234def5678 |
+| Result | YELLOW |
+| Pass | 75 |
+| Fail | 0 |
+| Skip | 3 |
+| Duration | 34s |
+`;
+const CACHE_WITH_FAILURES = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234def5678 |
+| Result | RED |
+| Pass | 70 |
+| Fail | 8 |
+| Duration | 42s |
+`;
+const SESSION_WITH_CACHE = `# Story 31-8: Eliminate Redundant Test Runs
+
+| Field | Value |
+|-------|-------|
+| Story | 31-8 |
+| Title | Eliminate redundant test runs in subagents |
+| Points | 2 |
+
+## Acceptance Criteria
+
+- [ ] Test suite runs only once per TDD phase
+
+${VALID_CACHE_SECTION}
+
+## Technical Context
+
+Some context here...
+`;
+const SESSION_WITHOUT_CACHE = `# Story 31-8: Eliminate Redundant Test Runs
+
+| Field | Value |
+|-------|-------|
+| Story | 31-8 |
+| Title | Eliminate redundant test runs in subagents |
+
+## Acceptance Criteria
+
+- [ ] Test suite runs only once per TDD phase
+
+## Technical Context
+
+Some context here...
+`;
+describe('Test Cache (31-8)', () => {
+    describe('parseTestCache() - Parse cache from session file', () => {
+        it('should parse valid cache section with all required fields', () => {
+            const entry = parseTestCache(SESSION_WITH_CACHE);
+            assert.ok(entry, 'Should parse cache entry');
+            assert.strictEqual(entry.lastRun, '2026-01-14T09:00:00Z');
+            assert.strictEqual(entry.gitSha, 'abc1234def5678');
+            assert.strictEqual(entry.result, 'GREEN');
+            assert.strictEqual(entry.passCount, 78);
+            assert.strictEqual(entry.failCount, 0);
+            assert.strictEqual(entry.durationSeconds, 36);
+        });
+        it('should parse cache with skip count', () => {
+            const entry = parseTestCache(CACHE_WITH_SKIPS);
+            assert.ok(entry, 'Should parse cache entry');
+            assert.strictEqual(entry.result, 'YELLOW');
+            assert.strictEqual(entry.passCount, 75);
+            assert.strictEqual(entry.failCount, 0);
+            assert.strictEqual(entry.skipCount, 3);
+        });
+        it('should parse cache with failures', () => {
+            const entry = parseTestCache(CACHE_WITH_FAILURES);
+            assert.ok(entry, 'Should parse cache entry');
+            assert.strictEqual(entry.result, 'RED');
+            assert.strictEqual(entry.passCount, 70);
+            assert.strictEqual(entry.failCount, 8);
+        });
+        it('should return null when no cache section exists', () => {
+            const entry = parseTestCache(SESSION_WITHOUT_CACHE);
+            assert.strictEqual(entry, null);
+        });
+        it('should return null for malformed cache table', () => {
+            const malformed = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+`; // Missing required fields
+            const entry = parseTestCache(malformed);
+            assert.strictEqual(entry, null);
+        });
+        it('should return null for invalid result value', () => {
+            const invalid = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234 |
+| Result | INVALID |
+| Pass | 78 |
+| Fail | 0 |
+| Duration | 36s |
+`;
+            const entry = parseTestCache(invalid);
+            assert.strictEqual(entry, null);
+        });
+        it('should handle case-insensitive field names', () => {
+            const mixedCase = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| LAST RUN | 2026-01-14T09:00:00Z |
+| Git Sha | abc1234 |
+| result | green |
+| PASS | 78 |
+| fail | 0 |
+| duration | 36s |
+`;
+            const entry = parseTestCache(mixedCase);
+            assert.ok(entry, 'Should parse case-insensitive fields');
+            assert.strictEqual(entry.result, 'GREEN');
+        });
+        it('should handle duration with or without s suffix', () => {
+            const withS = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234 |
+| Result | GREEN |
+| Pass | 78 |
+| Fail | 0 |
+| Duration | 36s |
+`;
+            const withoutS = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | 2026-01-14T09:00:00Z |
+| Git SHA | abc1234 |
+| Result | GREEN |
+| Pass | 78 |
+| Fail | 0 |
+| Duration | 36 |
+`;
+            const entryWithS = parseTestCache(withS);
+            const entryWithoutS = parseTestCache(withoutS);
+            assert.ok(entryWithS, 'Should parse with s suffix');
+            assert.ok(entryWithoutS, 'Should parse without s suffix');
+            assert.strictEqual(entryWithS.durationSeconds, 36);
+            assert.strictEqual(entryWithoutS.durationSeconds, 36);
+        });
+    });
+    describe('validateTestCache() - Validate cache freshness', () => {
+        it('should return valid for fresh cache with matching SHA', () => {
+            const now = new Date('2026-01-14T09:01:00Z'); // 1 minute after cache
+            const result = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'abc1234def5678',
+                currentTime: now
+            });
+            assert.strictEqual(result.valid, true);
+            assert.ok(result.reason.includes('Valid cache'));
+            assert.ok(result.entry);
+        });
+        it('should return invalid when cache not found', () => {
+            const result = validateTestCache(SESSION_WITHOUT_CACHE, {
+                currentGitSha: 'abc1234def5678'
+            });
+            assert.strictEqual(result.valid, false);
+            assert.ok(result.reason.includes('No test cache found'));
+        });
+        it('should return invalid when git SHA differs', () => {
+            const result = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'different1234567',
+                currentTime: new Date('2026-01-14T09:01:00Z')
+            });
+            assert.strictEqual(result.valid, false);
+            assert.ok(result.reason.includes('Code changed'));
+            assert.ok(result.entry, 'Should still return the entry');
+        });
+        it('should return invalid when cache is too old', () => {
+            const now = new Date('2026-01-14T09:15:00Z'); // 15 minutes after cache
+            const result = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'abc1234def5678',
+                currentTime: now,
+                maxAgeMinutes: 5
+            });
+            assert.strictEqual(result.valid, false);
+            assert.ok(result.reason.includes('Cache too old'));
+        });
+        it('should use default max age when not specified', () => {
+            const now = new Date('2026-01-14T09:04:00Z'); // 4 minutes after cache
+            const result = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'abc1234def5678',
+                currentTime: now
+            });
+            assert.strictEqual(result.valid, true); // 4min < 5min default
+        });
+        it('should allow custom max age', () => {
+            const now = new Date('2026-01-14T09:10:00Z'); // 10 minutes after cache
+            const resultDefault = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'abc1234def5678',
+                currentTime: now,
+                maxAgeMinutes: 5 // default
+            });
+            const resultExtended = validateTestCache(SESSION_WITH_CACHE, {
+                currentGitSha: 'abc1234def5678',
+                currentTime: now,
+                maxAgeMinutes: 15 // extended
+            });
+            assert.strictEqual(resultDefault.valid, false, 'Should fail with 5min limit');
+            assert.strictEqual(resultExtended.valid, true, 'Should pass with 15min limit');
+        });
+        it('should handle invalid timestamp in cache', () => {
+            const invalid = `## Test Cache
+
+| Field | Value |
+|-------|-------|
+| Last Run | not-a-timestamp |
+| Git SHA | abc1234 |
+| Result | GREEN |
+| Pass | 78 |
+| Fail | 0 |
+| Duration | 36s |
+`;
+            const result = validateTestCache(invalid, {
+                currentGitSha: 'abc1234'
+            });
+            assert.strictEqual(result.valid, false);
+            assert.ok(result.reason.includes('Invalid timestamp'));
+        });
+    });
+    describe('formatTestCache() - Format cache for session file', () => {
+        it('should format basic cache entry', () => {
+            const entry = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234def5678',
+                result: 'GREEN',
+                passCount: 78,
+                failCount: 0,
+                durationSeconds: 36
+            };
+            const formatted = formatTestCache(entry);
+            assert.ok(formatted.includes('## Test Cache'));
+            assert.ok(formatted.includes('| Last Run | 2026-01-14T09:00:00Z |'));
+            assert.ok(formatted.includes('| Git SHA | abc1234def5678 |'));
+            assert.ok(formatted.includes('| Result | GREEN |'));
+            assert.ok(formatted.includes('| Pass | 78 |'));
+            assert.ok(formatted.includes('| Fail | 0 |'));
+            assert.ok(formatted.includes('| Duration | 36s |'));
+        });
+        it('should include skip count when present', () => {
+            const entry = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234def5678',
+                result: 'YELLOW',
+                passCount: 75,
+                failCount: 0,
+                skipCount: 3,
+                durationSeconds: 34
+            };
+            const formatted = formatTestCache(entry);
+            assert.ok(formatted.includes('| Skip | 3 |'));
+        });
+        it('should not include skip row when skipCount is undefined', () => {
+            const entry = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234',
+                result: 'GREEN',
+                passCount: 78,
+                failCount: 0,
+                durationSeconds: 36
+            };
+            const formatted = formatTestCache(entry);
+            assert.ok(!formatted.includes('| Skip |'));
+        });
+        it('should produce valid markdown table', () => {
+            const entry = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234',
+                result: 'RED',
+                passCount: 70,
+                failCount: 8,
+                durationSeconds: 42
+            };
+            const formatted = formatTestCache(entry);
+            const lines = formatted.split('\n').filter(l => l.trim());
+            // Should have header, separator, and at least 6 data rows
+            assert.ok(lines.length >= 8, `Should have at least 8 lines, got ${lines.length}`);
+            assert.ok(lines[0].includes('## Test Cache'));
+            assert.ok(lines[1].includes('| Field | Value |'));
+            assert.ok(lines[2].includes('|-------|-------|'));
+        });
+    });
+    describe('createTestCacheEntry() - Create entry from results', () => {
+        it('should create GREEN entry when no failures', () => {
+            const entry = createTestCacheEntry({ passCount: 78, failCount: 0, durationSeconds: 36 }, 'abc1234', new Date('2026-01-14T09:00:00Z'));
+            assert.strictEqual(entry.result, 'GREEN');
+            assert.strictEqual(entry.passCount, 78);
+            assert.strictEqual(entry.failCount, 0);
+            assert.strictEqual(entry.gitSha, 'abc1234');
+            assert.strictEqual(entry.lastRun, '2026-01-14T09:00:00.000Z');
+        });
+        it('should create RED entry when failures exist', () => {
+            const entry = createTestCacheEntry({ passCount: 70, failCount: 8, durationSeconds: 42 }, 'def5678');
+            assert.strictEqual(entry.result, 'RED');
+            assert.strictEqual(entry.failCount, 8);
+        });
+        it('should create YELLOW entry when skips exist but no failures', () => {
+            const entry = createTestCacheEntry({ passCount: 75, failCount: 0, skipCount: 3, durationSeconds: 34 }, 'ghi9012');
+            assert.strictEqual(entry.result, 'YELLOW');
+            assert.strictEqual(entry.skipCount, 3);
+        });
+        it('should prioritize RED over YELLOW when both failures and skips', () => {
+            const entry = createTestCacheEntry({ passCount: 65, failCount: 5, skipCount: 8, durationSeconds: 40 }, 'jkl3456');
+            assert.strictEqual(entry.result, 'RED', 'Failures should take priority');
+        });
+        it('should use current time when timestamp not provided', () => {
+            const before = new Date();
+            const entry = createTestCacheEntry({ passCount: 78, failCount: 0, durationSeconds: 36 }, 'abc1234');
+            const after = new Date();
+            const entryTime = new Date(entry.lastRun);
+            assert.ok(entryTime >= before, 'Entry time should be after call start');
+            assert.ok(entryTime <= after, 'Entry time should be before call end');
+        });
+    });
+    describe('shouldSkipTests() - Convenience function for subagents', () => {
+        it('should return skip=true for valid cache', () => {
+            const _now = new Date('2026-01-14T09:01:00Z');
+            const _result = shouldSkipTests(SESSION_WITH_CACHE, 'abc1234def5678', 5);
+            // Note: This test depends on the current time, so we use a mock
+            // For the implementation, we'll need to check if the validation
+            // passes with default time handling
+        });
+        it('should return skip=false when cache not found', () => {
+            const result = shouldSkipTests(SESSION_WITHOUT_CACHE, 'abc1234');
+            assert.strictEqual(result.skip, false);
+            assert.ok(result.reason.includes('No test cache found'));
+            assert.strictEqual(result.cachedResult, undefined);
+        });
+        it('should return skip=false when SHA differs', () => {
+            const result = shouldSkipTests(SESSION_WITH_CACHE, 'different1234');
+            assert.strictEqual(result.skip, false);
+            assert.ok(result.reason.includes('Code changed'));
+        });
+        it('should include cached result when valid', () => {
+            // For a truly time-independent test, we'd need dependency injection
+            // This test verifies the structure of the response
+            const withCache = parseTestCache(SESSION_WITH_CACHE);
+            assert.ok(withCache, 'Test setup: cache should parse');
+            // The shouldSkipTests function will return cachedResult only if valid
+            // Since we can't mock time easily, we verify the function signature
+            // Use very high max age (1 year in minutes) to ensure cache is always valid
+            const result = shouldSkipTests(SESSION_WITH_CACHE, 'abc1234def5678', 525600);
+            // With a very high max age, the cache should be valid
+            assert.strictEqual(result.skip, true);
+            assert.strictEqual(result.cachedResult, 'GREEN');
+        });
+    });
+    describe('DEFAULT_CACHE_MAX_AGE_MINUTES constant', () => {
+        it('should be 5 minutes', () => {
+            assert.strictEqual(DEFAULT_CACHE_MAX_AGE_MINUTES, 5);
+        });
+    });
+    describe('Round-trip: format and parse', () => {
+        it('should parse what was formatted', () => {
+            const original = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234def5678',
+                result: 'GREEN',
+                passCount: 78,
+                failCount: 0,
+                durationSeconds: 36
+            };
+            const formatted = formatTestCache(original);
+            const parsed = parseTestCache(formatted);
+            assert.ok(parsed, 'Should parse formatted cache');
+            assert.strictEqual(parsed.lastRun, original.lastRun);
+            assert.strictEqual(parsed.gitSha, original.gitSha);
+            assert.strictEqual(parsed.result, original.result);
+            assert.strictEqual(parsed.passCount, original.passCount);
+            assert.strictEqual(parsed.failCount, original.failCount);
+            assert.strictEqual(parsed.durationSeconds, original.durationSeconds);
+        });
+        it('should handle skip count in round-trip', () => {
+            const original = {
+                lastRun: '2026-01-14T09:00:00Z',
+                gitSha: 'abc1234def5678',
+                result: 'YELLOW',
+                passCount: 75,
+                failCount: 0,
+                skipCount: 3,
+                durationSeconds: 34
+            };
+            const formatted = formatTestCache(original);
+            const parsed = parseTestCache(formatted);
+            assert.ok(parsed, 'Should parse formatted cache with skips');
+            assert.strictEqual(parsed.skipCount, 3);
+        });
+    });
+});
+//# sourceMappingURL=test-cache.test.js.map

package/packages/core/dist/workflow/test-cache.test.js.map

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

package/packages/core/dist/workflow/workflow-loader.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Workflow Loader
+ *
+ * Story 31-2: Load workflow definitions from YAML files
+ *
+ * This module provides functions to:
+ * - Load a single workflow YAML file
+ * - Load all workflows from a directory
+ * - Validate loaded workflows against the schema
+ *
+ * Uses validateWorkflow() from workflow-schema.ts (Story 31-1)
+ */
+import { type WorkflowDefinition, type WorkflowValidationError } from './workflow-schema.js';
+/**
+ * Result of loading a single workflow file
+ */
+export interface WorkflowLoadResult {
+    /** Whether the load and validation succeeded */
+    success: boolean;
+    /** Path to the workflow file */
+    filePath: string;
+    /** Parsed and validated workflow (only present if success) */
+    workflow?: WorkflowDefinition;
+    /** Validation or parse errors (only present if failed) */
+    errors?: WorkflowValidationError[];
+}
+/**
+ * Result of loading multiple workflows from a directory
+ */
+export interface WorkflowLoadResults {
+    /** Successfully loaded and validated workflows */
+    workflows: WorkflowDefinition[];
+    /** Files that failed to load or validate */
+    errors: Array<{
+        filePath: string;
+        errors: WorkflowValidationError[];
+    }>;
+}
+/**
+ * Load and validate a single workflow YAML file
+ *
+ * @param filePath - Absolute or relative path to the workflow YAML file
+ * @returns Load result with workflow or errors
+ *
+ * @example
+ * ```typescript
+ * const result = loadWorkflowFile('.claude/workflows/tdd.yaml');
+ * if (result.success) {
+ *   console.log(`Loaded workflow: ${result.workflow.name}`);
+ * } else {
+ *   console.error('Errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function loadWorkflowFile(filePath: string): WorkflowLoadResult;
+/**
+ * Load and validate all workflow YAML files from a directory
+ *
+ * Only processes files with .yaml or .yml extensions.
+ * Returns partial results - valid workflows are returned even if some fail.
+ *
+ * @param dirPath - Path to directory containing workflow files
+ * @returns Load results with workflows and errors
+ *
+ * @example
+ * ```typescript
+ * const results = loadWorkflowsFromDir('.claude/workflows');
+ * console.log(`Loaded ${results.workflows.length} workflows`);
+ * if (results.errors.length > 0) {
+ *   console.error(`${results.errors.length} files failed to load`);
+ * }
+ * ```
+ */
+export declare function loadWorkflowsFromDir(dirPath: string): WorkflowLoadResults;
+export type { WorkflowDefinition, WorkflowPhase, WorkflowTriggers, WorkflowValidationError, WorkflowValidationResult } from './workflow-schema.js';
+//# sourceMappingURL=workflow-loader.d.ts.map

package/packages/core/dist/workflow/workflow-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loader.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAE7B,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,4CAA4C;IAC5C,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,uBAAuB,EAAE,CAAC;KACnC,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAkDrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAsCzE;AAGD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC"}

package/packages/core/dist/workflow/workflow-loader.js

@@ -0,0 +1,133 @@
+/**
+ * Workflow Loader
+ *
+ * Story 31-2: Load workflow definitions from YAML files
+ *
+ * This module provides functions to:
+ * - Load a single workflow YAML file
+ * - Load all workflows from a directory
+ * - Validate loaded workflows against the schema
+ *
+ * Uses validateWorkflow() from workflow-schema.ts (Story 31-1)
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { validateWorkflow } from './workflow-schema.js';
+/**
+ * Load and validate a single workflow YAML file
+ *
+ * @param filePath - Absolute or relative path to the workflow YAML file
+ * @returns Load result with workflow or errors
+ *
+ * @example
+ * ```typescript
+ * const result = loadWorkflowFile('.claude/workflows/tdd.yaml');
+ * if (result.success) {
+ *   console.log(`Loaded workflow: ${result.workflow.name}`);
+ * } else {
+ *   console.error('Errors:', result.errors);
+ * }
+ * ```
+ */
+export function loadWorkflowFile(filePath) {
+    // 1. Read file from disk
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown file read error';
+        return {
+            success: false,
+            filePath,
+            errors: [{
+                    field: 'file',
+                    message: message.includes('ENOENT') ? `File not found: ${filePath}` : message
+                }]
+        };
+    }
+    // 2. Parse YAML
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown YAML parse error';
+        return {
+            success: false,
+            filePath,
+            errors: [{
+                    field: 'yaml',
+                    message: `YAML parse error: ${message}`
+                }]
+        };
+    }
+    // 3. Call validateWorkflow()
+    const result = validateWorkflow(parsed);
+    // 4. Return result
+    if (result.valid && result.workflow) {
+        return {
+            success: true,
+            filePath,
+            workflow: result.workflow
+        };
+    }
+    return {
+        success: false,
+        filePath,
+        errors: result.errors
+    };
+}
+/**
+ * Load and validate all workflow YAML files from a directory
+ *
+ * Only processes files with .yaml or .yml extensions.
+ * Returns partial results - valid workflows are returned even if some fail.
+ *
+ * @param dirPath - Path to directory containing workflow files
+ * @returns Load results with workflows and errors
+ *
+ * @example
+ * ```typescript
+ * const results = loadWorkflowsFromDir('.claude/workflows');
+ * console.log(`Loaded ${results.workflows.length} workflows`);
+ * if (results.errors.length > 0) {
+ *   console.error(`${results.errors.length} files failed to load`);
+ * }
+ * ```
+ */
+export function loadWorkflowsFromDir(dirPath) {
+    const workflows = [];
+    const errors = [];
+    // 1. Check directory exists
+    if (!existsSync(dirPath)) {
+        return { workflows, errors };
+    }
+    // 2. List files and filter for .yaml/.yml extensions
+    let files;
+    try {
+        files = readdirSync(dirPath);
+    }
+    catch {
+        return { workflows, errors };
+    }
+    const yamlFiles = files.filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    // 3. Call loadWorkflowFile() for each
+    for (const file of yamlFiles) {
+        const filePath = join(dirPath, file);
+        const result = loadWorkflowFile(filePath);
+        // 4. Aggregate results
+        if (result.success && result.workflow) {
+            workflows.push(result.workflow);
+        }
+        else if (result.errors) {
+            errors.push({
+                filePath,
+                errors: result.errors
+            });
+        }
+    }
+    return { workflows, errors };
+}
+//# sourceMappingURL=workflow-loader.js.map