@pennyfarthing/core 7.5.0 → 7.6.1

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/trimodal.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Tri-Modal Support for MSSCI-12086
+ *
+ * Provides mode selection and path resolution for stepped workflows
+ * supporting create/validate/edit modes.
+ */
+import type { WorkflowDefinition } from './workflow-schema.js';
+/**
+ * Valid tri-modal mode values
+ */
+export type TrimodalMode = 'create' | 'validate' | 'edit';
+/**
+ * Result of parsing --mode flag from arguments
+ */
+export interface TrimodalParseResult {
+    /** Whether parsing succeeded */
+    success: boolean;
+    /** Parsed mode (undefined if no flag provided) */
+    mode?: TrimodalMode;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Result of validating a mode against a workflow
+ */
+export interface ModeValidationResult {
+    /** Whether the mode is valid for this workflow */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Result of resolving steps path for a mode
+ */
+export interface StepsPathResult {
+    /** Whether resolution succeeded */
+    success: boolean;
+    /** Resolved steps path */
+    path?: string;
+    /** Step file pattern */
+    pattern?: string;
+    /** Error message if resolution failed */
+    error?: string;
+}
+/**
+ * Parse --mode flag from command line arguments
+ *
+ * Supports:
+ * - --mode create
+ * - --mode validate
+ * - --mode edit
+ * - --mode=create (equals syntax)
+ * - -m create (shorthand)
+ *
+ * @param args - Command line arguments
+ * @returns Parse result with mode or error
+ */
+export declare function parseTrimodalFlag(args: string[]): TrimodalParseResult;
+/**
+ * Validate that a mode is supported by a workflow
+ *
+ * @param mode - Mode to validate
+ * @param workflow - Workflow definition to check against
+ * @returns Validation result
+ */
+export declare function validateMode(mode: TrimodalMode, workflow: WorkflowDefinition): ModeValidationResult;
+/**
+ * Resolve the steps path for a given mode
+ *
+ * Priority:
+ * 1. workflow.modes[mode] if defined
+ * 2. workflow.steps.path as fallback
+ *
+ * @param workflow - Workflow definition
+ * @param mode - Selected mode
+ * @returns Steps path result
+ */
+export declare function resolveStepsPath(workflow: WorkflowDefinition, mode: TrimodalMode): StepsPathResult;
+/**
+ * Get the default mode for a workflow
+ *
+ * @param workflow - Workflow definition
+ * @returns Default mode ('create' if not specified, undefined for phased workflows)
+ */
+export declare function getDefaultMode(workflow: WorkflowDefinition): TrimodalMode | undefined;
+//# sourceMappingURL=trimodal.d.ts.map

package/packages/core/dist/workflow/trimodal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trimodal.d.ts","sourceRoot":"","sources":["../../src/workflow/trimodal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,CA4BrE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,kBAAkB,GAC3B,oBAAoB,CAgBtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,YAAY,GACjB,eAAe,CAqBjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY,GAAG,SAAS,CAarF"}

package/packages/core/dist/workflow/trimodal.js

@@ -0,0 +1,118 @@
+/**
+ * Tri-Modal Support for MSSCI-12086
+ *
+ * Provides mode selection and path resolution for stepped workflows
+ * supporting create/validate/edit modes.
+ */
+/** Valid mode values */
+const VALID_MODES = ['create', 'validate', 'edit'];
+/**
+ * Parse --mode flag from command line arguments
+ *
+ * Supports:
+ * - --mode create
+ * - --mode validate
+ * - --mode edit
+ * - --mode=create (equals syntax)
+ * - -m create (shorthand)
+ *
+ * @param args - Command line arguments
+ * @returns Parse result with mode or error
+ */
+export function parseTrimodalFlag(args) {
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Handle --mode=value syntax
+        if (arg.startsWith('--mode=')) {
+            const value = arg.slice(7);
+            if (!VALID_MODES.includes(value)) {
+                return { success: false, error: `Invalid mode "${value}". Must be one of: create, validate, edit` };
+            }
+            return { success: true, mode: value };
+        }
+        // Handle --mode value or -m value syntax
+        if (arg === '--mode' || arg === '-m') {
+            const value = args[i + 1];
+            if (!value || value.startsWith('-')) {
+                return { success: false, error: '--mode flag requires a value (create, validate, or edit)' };
+            }
+            if (!VALID_MODES.includes(value)) {
+                return { success: false, error: `Invalid mode "${value}". Must be one of: create, validate, edit` };
+            }
+            return { success: true, mode: value };
+        }
+    }
+    // No mode flag found - that's okay, return success with undefined mode
+    return { success: true };
+}
+/**
+ * Validate that a mode is supported by a workflow
+ *
+ * @param mode - Mode to validate
+ * @param workflow - Workflow definition to check against
+ * @returns Validation result
+ */
+export function validateMode(mode, workflow) {
+    // If workflow has no modes config, any mode is valid (uses steps.path fallback)
+    if (!workflow.modes) {
+        return { valid: true };
+    }
+    // Check if the mode has a path defined in workflow.modes
+    const modePath = workflow.modes[mode];
+    if (modePath) {
+        return { valid: true };
+    }
+    return {
+        valid: false,
+        error: `Mode "${mode}" is not defined in workflow "${workflow.name}". Available modes: ${Object.keys(workflow.modes).filter(k => k !== 'default').join(', ')}`
+    };
+}
+/**
+ * Resolve the steps path for a given mode
+ *
+ * Priority:
+ * 1. workflow.modes[mode] if defined
+ * 2. workflow.steps.path as fallback
+ *
+ * @param workflow - Workflow definition
+ * @param mode - Selected mode
+ * @returns Steps path result
+ */
+export function resolveStepsPath(workflow, mode) {
+    // Stepped workflows require steps config
+    if (!workflow.steps) {
+        return {
+            success: false,
+            error: `Workflow "${workflow.name}" is not a stepped workflow (no steps configuration)`
+        };
+    }
+    const pattern = workflow.steps.pattern;
+    // Try mode-specific path first
+    if (workflow.modes) {
+        const modePath = workflow.modes[mode];
+        if (modePath) {
+            return { success: true, path: modePath, pattern };
+        }
+    }
+    // Fall back to steps.path
+    return { success: true, path: workflow.steps.path, pattern };
+}
+/**
+ * Get the default mode for a workflow
+ *
+ * @param workflow - Workflow definition
+ * @returns Default mode ('create' if not specified, undefined for phased workflows)
+ */
+export function getDefaultMode(workflow) {
+    // Phased workflows don't use modes
+    if (workflow.type === 'phased' || !workflow.steps) {
+        return undefined;
+    }
+    // If modes config exists with a default, use it
+    if (workflow.modes?.default) {
+        return workflow.modes.default;
+    }
+    // Default to 'create' for stepped workflows without explicit default
+    return 'create';
+}
+//# sourceMappingURL=trimodal.js.map

package/packages/core/dist/workflow/trimodal.js.map

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