@pennyfarthing/core 7.0.2 → 7.4.1

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":"AAAA;;;;;GAKG;AA6CH,wBAAwB;AACxB,MAAM,WAAW,GAA4B,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,6BAA6B;QAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,KAAK,2CAA2C,EAAE,CAAC;YACtG,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAqB,EAAE,CAAC;QACxD,CAAC;QAED,yCAAyC;QACzC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0DAA0D,EAAE,CAAC;YAC/F,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAqB,CAAC,EAAE,CAAC;gBACjD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,KAAK,2CAA2C,EAAE,CAAC;YACtG,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAqB,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAkB,EAClB,QAA4B;IAE5B,gFAAgF;IAChF,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,yDAAyD;IACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,SAAS,IAAI,iCAAiC,QAAQ,CAAC,IAAI,uBAAuB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KAC/J,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,IAAkB;IAElB,yCAAyC;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,aAAa,QAAQ,CAAC,IAAI,sDAAsD;SACxF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IAEvC,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAA4B;IACzD,mCAAmC;IACnC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Tri-Modal Support Tests for MSSCI-12086
+ *
+ * Tests for tri-modal workflow execution in BikePaths:
+ * - Mode selection via --mode flag
+ * - Steps path resolution based on mode
+ * - Session state mode tracking
+ * - Default mode behavior
+ */
+export {};
+//# sourceMappingURL=trimodal.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trimodal.test.d.ts","sourceRoot":"","sources":["../../src/workflow/trimodal.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,395 @@
+/**
+ * Tri-Modal Support Tests for MSSCI-12086
+ *
+ * Tests for tri-modal workflow execution in BikePaths:
+ * - Mode selection via --mode flag
+ * - Steps path resolution based on mode
+ * - Session state mode tracking
+ * - Default mode behavior
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { parseTrimodalFlag, resolveStepsPath, validateMode, getDefaultMode, } from './trimodal.js';
+import { initWorkflowState, parseSessionState, formatWorkflowState, updateSessionContent } from './session-state.js';
+// ============================================================================
+// AC1: Mode selectable via --mode create|validate|edit flag
+// ============================================================================
+describe('AC1: Mode flag parsing', () => {
+    describe('parseTrimodalFlag', () => {
+        it('should parse --mode create flag', () => {
+            const result = parseTrimodalFlag(['--mode', 'create']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'create');
+        });
+        it('should parse --mode validate flag', () => {
+            const result = parseTrimodalFlag(['--mode', 'validate']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'validate');
+        });
+        it('should parse --mode edit flag', () => {
+            const result = parseTrimodalFlag(['--mode', 'edit']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'edit');
+        });
+        it('should handle --mode=create syntax', () => {
+            const result = parseTrimodalFlag(['--mode=create']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'create');
+        });
+        it('should handle -m shorthand flag', () => {
+            const result = parseTrimodalFlag(['-m', 'validate']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'validate');
+        });
+        it('should return undefined mode when no flag provided', () => {
+            const result = parseTrimodalFlag([]);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, undefined);
+        });
+        it('should return error for invalid mode value', () => {
+            const result = parseTrimodalFlag(['--mode', 'invalid']);
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('invalid'));
+        });
+        it('should return error for --mode without value', () => {
+            const result = parseTrimodalFlag(['--mode']);
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('requires'));
+        });
+        it('should handle mode flag among other arguments', () => {
+            const result = parseTrimodalFlag(['workflow', 'start', 'architecture', '--mode', 'edit', '--verbose']);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.mode, 'edit');
+        });
+    });
+    describe('validateMode', () => {
+        const workflowWithAllModes = {
+            name: 'test-workflow',
+            type: 'stepped',
+            steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            modes: {
+                default: 'create',
+                create: './steps/',
+                validate: './steps-validate/',
+                edit: './steps-edit/',
+            },
+        };
+        const workflowWithPartialModes = {
+            name: 'partial-workflow',
+            type: 'stepped',
+            steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            modes: {
+                default: 'create',
+                create: './steps/',
+                // validate and edit not defined
+            },
+        };
+        it('should accept create mode when workflow supports it', () => {
+            const result = validateMode('create', workflowWithAllModes);
+            assert.strictEqual(result.valid, true);
+        });
+        it('should accept validate mode when workflow supports it', () => {
+            const result = validateMode('validate', workflowWithAllModes);
+            assert.strictEqual(result.valid, true);
+        });
+        it('should accept edit mode when workflow supports it', () => {
+            const result = validateMode('edit', workflowWithAllModes);
+            assert.strictEqual(result.valid, true);
+        });
+        it('should reject mode not defined in workflow', () => {
+            const result = validateMode('validate', workflowWithPartialModes);
+            assert.strictEqual(result.valid, false);
+            assert.ok(result.error?.includes('validate'));
+        });
+        it('should accept any mode for workflow without modes config', () => {
+            const workflowNoModes = {
+                name: 'no-modes',
+                type: 'stepped',
+                steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            };
+            // When workflow has no modes config, any mode should work (uses steps.path)
+            const result = validateMode('create', workflowNoModes);
+            assert.strictEqual(result.valid, true);
+        });
+    });
+});
+// ============================================================================
+// AC2: Steps loaded from mode-specific directory
+// ============================================================================
+describe('AC2: Mode-specific steps path resolution', () => {
+    describe('resolveStepsPath', () => {
+        const trimodalWorkflow = {
+            name: 'architecture',
+            type: 'stepped',
+            steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            modes: {
+                default: 'create',
+                create: './steps/',
+                validate: './steps-validate/',
+                edit: './steps-edit/',
+            },
+        };
+        it('should resolve create mode to create path', () => {
+            const result = resolveStepsPath(trimodalWorkflow, 'create');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.path, './steps/');
+        });
+        it('should resolve validate mode to validate path', () => {
+            const result = resolveStepsPath(trimodalWorkflow, 'validate');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.path, './steps-validate/');
+        });
+        it('should resolve edit mode to edit path', () => {
+            const result = resolveStepsPath(trimodalWorkflow, 'edit');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.path, './steps-edit/');
+        });
+        it('should fall back to steps.path when no modes config', () => {
+            const workflowNoModes = {
+                name: 'simple',
+                type: 'stepped',
+                steps: { path: './default-steps/', pattern: 'step-{nn}-*.md' },
+            };
+            const result = resolveStepsPath(workflowNoModes, 'create');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.path, './default-steps/');
+        });
+        it('should fall back to steps.path when mode path not defined', () => {
+            const partialModes = {
+                name: 'partial',
+                type: 'stepped',
+                steps: { path: './fallback/', pattern: 'step-{nn}-*.md' },
+                modes: {
+                    default: 'create',
+                    create: './create-steps/',
+                    // validate not defined
+                },
+            };
+            const result = resolveStepsPath(partialModes, 'validate');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.path, './fallback/');
+        });
+        it('should return error for phased workflow (no steps)', () => {
+            const phasedWorkflow = {
+                name: 'tdd',
+                type: 'phased',
+                phases: [{ name: 'setup', agent: 'sm' }],
+            };
+            const result = resolveStepsPath(phasedWorkflow, 'create');
+            assert.strictEqual(result.success, false);
+            assert.ok(result.error?.includes('stepped'));
+        });
+        it('should preserve pattern from workflow definition', () => {
+            const result = resolveStepsPath(trimodalWorkflow, 'create');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.pattern, 'step-{nn}-*.md');
+        });
+    });
+});
+// ============================================================================
+// AC3: Mode tracked in session state
+// ============================================================================
+describe('AC3: Session state mode tracking', () => {
+    describe('initWorkflowState with mode', () => {
+        it('should initialize state with create mode', () => {
+            const state = initWorkflowState('architecture', 'stepped', 'create');
+            assert.strictEqual(state.name, 'architecture');
+            assert.strictEqual(state.type, 'stepped');
+            assert.strictEqual(state.mode, 'create');
+        });
+        it('should initialize state with validate mode', () => {
+            const state = initWorkflowState('architecture', 'stepped', 'validate');
+            assert.strictEqual(state.mode, 'validate');
+        });
+        it('should initialize state with edit mode', () => {
+            const state = initWorkflowState('architecture', 'stepped', 'edit');
+            assert.strictEqual(state.mode, 'edit');
+        });
+        it('should allow undefined mode for workflows without tri-modal', () => {
+            const state = initWorkflowState('simple', 'stepped');
+            assert.strictEqual(state.mode, undefined);
+        });
+    });
+    describe('formatWorkflowState with mode', () => {
+        it('should include mode in formatted output', () => {
+            const state = initWorkflowState('architecture', 'stepped', 'validate');
+            const formatted = formatWorkflowState(state);
+            assert.ok(formatted.includes('**Mode:** validate'));
+        });
+        it('should omit mode line when mode is undefined', () => {
+            const state = initWorkflowState('simple', 'stepped');
+            const formatted = formatWorkflowState(state);
+            assert.ok(!formatted.includes('**Mode:**'));
+        });
+    });
+    describe('parseSessionState with mode', () => {
+        it('should parse mode from session content', () => {
+            const content = `
+# Story
+
+## Workflow State
+- **Workflow Name:** architecture
+- **Type:** stepped
+- **Mode:** edit
+- **Started:** 2026-01-21T10:00:00Z
+- **Last Updated:** 2026-01-21T10:30:00Z
+- **Current Step:** 3
+- **Steps Completed:** [1, 2]
+- **Status:** in_progress
+`;
+            const result = parseSessionState(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.state?.mode, 'edit');
+        });
+        it('should handle session without mode field', () => {
+            const content = `
+# Story
+
+## Workflow State
+- **Workflow Name:** simple
+- **Type:** stepped
+- **Started:** 2026-01-21T10:00:00Z
+- **Last Updated:** 2026-01-21T10:30:00Z
+- **Current Step:** 1
+- **Steps Completed:** []
+- **Status:** in_progress
+`;
+            const result = parseSessionState(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.state?.mode, undefined);
+        });
+    });
+    describe('updateSessionContent preserves mode', () => {
+        it('should preserve mode when updating session state', () => {
+            const state = initWorkflowState('architecture', 'stepped', 'validate');
+            state.currentStep = 2;
+            state.stepsCompleted = [1];
+            const content = '# Story\n\n## Overview\nSome content\n';
+            const result = updateSessionContent(content, state);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.content?.includes('**Mode:** validate'));
+        });
+    });
+});
+// ============================================================================
+// AC4: Defaults to create mode when --mode not specified
+// ============================================================================
+describe('AC4: Default mode behavior', () => {
+    describe('getDefaultMode', () => {
+        it('should return workflow modes.default when defined', () => {
+            const workflow = {
+                name: 'test',
+                type: 'stepped',
+                steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+                modes: {
+                    default: 'validate',
+                    create: './create/',
+                    validate: './validate/',
+                },
+            };
+            const mode = getDefaultMode(workflow);
+            assert.strictEqual(mode, 'validate');
+        });
+        it('should return create when modes.default is create', () => {
+            const workflow = {
+                name: 'test',
+                type: 'stepped',
+                steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+                modes: {
+                    default: 'create',
+                    create: './create/',
+                },
+            };
+            const mode = getDefaultMode(workflow);
+            assert.strictEqual(mode, 'create');
+        });
+        it('should return create when no modes config exists', () => {
+            const workflow = {
+                name: 'simple',
+                type: 'stepped',
+                steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            };
+            const mode = getDefaultMode(workflow);
+            assert.strictEqual(mode, 'create');
+        });
+        it('should return undefined for phased workflows', () => {
+            const workflow = {
+                name: 'tdd',
+                type: 'phased',
+                phases: [{ name: 'setup', agent: 'sm' }],
+            };
+            const mode = getDefaultMode(workflow);
+            assert.strictEqual(mode, undefined);
+        });
+    });
+    describe('Integration: flag parsing with defaults', () => {
+        const trimodalWorkflow = {
+            name: 'architecture',
+            type: 'stepped',
+            steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            modes: {
+                default: 'create',
+                create: './steps/',
+                validate: './steps-validate/',
+                edit: './steps-edit/',
+            },
+        };
+        it('should use create mode when no --mode flag and workflow defaults to create', () => {
+            const parseResult = parseTrimodalFlag([]);
+            const effectiveMode = parseResult.mode ?? getDefaultMode(trimodalWorkflow);
+            assert.strictEqual(effectiveMode, 'create');
+        });
+        it('should use explicit mode when --mode flag provided', () => {
+            const parseResult = parseTrimodalFlag(['--mode', 'edit']);
+            const effectiveMode = parseResult.mode ?? getDefaultMode(trimodalWorkflow);
+            assert.strictEqual(effectiveMode, 'edit');
+        });
+        it('should use workflow default mode when no flag and default is not create', () => {
+            const validateDefaultWorkflow = {
+                ...trimodalWorkflow,
+                modes: { ...trimodalWorkflow.modes, default: 'validate' },
+            };
+            const parseResult = parseTrimodalFlag([]);
+            const effectiveMode = parseResult.mode ?? getDefaultMode(validateDefaultWorkflow);
+            assert.strictEqual(effectiveMode, 'validate');
+        });
+    });
+});
+// ============================================================================
+// Edge cases and error handling
+// ============================================================================
+describe('Edge cases', () => {
+    it('should handle empty workflow modes object', () => {
+        const workflow = {
+            name: 'test',
+            type: 'stepped',
+            steps: { path: './steps/', pattern: 'step-{nn}-*.md' },
+            modes: {}, // Empty modes object (technically invalid but defensive)
+        };
+        const result = resolveStepsPath(workflow, 'create');
+        // Should fall back to steps.path
+        assert.strictEqual(result.success, true);
+        assert.strictEqual(result.path, './steps/');
+    });
+    it('should handle case-sensitive mode values', () => {
+        // Modes should be lowercase
+        const result = parseTrimodalFlag(['--mode', 'Create']);
+        assert.strictEqual(result.success, false);
+        assert.ok(result.error?.includes('Create'));
+    });
+    it('should preserve mode across session state round-trip', () => {
+        // Create state with mode
+        const original = initWorkflowState('arch', 'stepped', 'validate');
+        // Format to markdown
+        const formatted = formatWorkflowState(original);
+        // Create session content
+        const sessionContent = `# Story\n\n${formatted}\n`;
+        // Parse it back
+        const parsed = parseSessionState(sessionContent);
+        assert.strictEqual(parsed.success, true);
+        assert.strictEqual(parsed.state?.mode, 'validate');
+        assert.strictEqual(parsed.state?.name, 'arch');
+        assert.strictEqual(parsed.state?.type, 'stepped');
+    });
+});
+//# sourceMappingURL=trimodal.test.js.map

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

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

package/packages/core/dist/workflow/variable-resolver.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Variable Resolver for MSSCI-12081
+ *
+ * Resolves {variable} placeholders in step file content from multiple sources
+ * with priority-based fallback chain.
+ */
+/**
+ * Represents a source of variable values
+ */
+export interface VariableSource {
+    /** Name of this source (e.g., 'workflow', 'session', 'environment') */
+    name: string;
+    /** Priority level (lower number = higher priority) */
+    priority: number;
+    /** Map of variable names to their values */
+    values: Record<string, string>;
+}
+/**
+ * Result of variable resolution
+ */
+export interface ResolveResult {
+    /** Content with variables resolved (unresolved variables left as-is) */
+    content: string;
+    /** List of variables that were successfully resolved */
+    resolved: string[];
+    /** List of variables that could not be resolved */
+    unresolved: string[];
+    /** Map of variable name to source name that provided the value */
+    sources: Record<string, string>;
+}
+/**
+ * Options for the convenience resolveStepVariables function
+ */
+export interface ResolveStepOptions {
+    /** Variables from workflow YAML (highest priority) */
+    workflowVars?: Record<string, unknown>;
+    /** Variables from session file */
+    sessionVars?: Record<string, string>;
+    /** Path to config file */
+    configPath?: string;
+    /** Project root path (for {project_root} variable) */
+    projectRoot?: string;
+}
+/**
+ * Resolve variables in content from prioritized sources
+ *
+ * @param content - The content containing {variable} placeholders
+ * @param sources - Array of variable sources, sorted by priority
+ * @returns ResolveResult with resolved content and metadata
+ */
+export declare function resolveVariables(content: string, sources: VariableSource[]): ResolveResult;
+/**
+ * Convenience function to resolve variables in step file content
+ *
+ * Automatically builds sources from:
+ * 1. Workflow variables (priority 1)
+ * 2. Session variables (priority 2)
+ * 3. Config file values (priority 3)
+ * 4. Environment/system variables (priority 4)
+ * 5. Default values (priority 5)
+ *
+ * @param stepContent - The step file content to process
+ * @param options - Optional configuration for variable sources
+ * @returns ResolveResult with resolved content and metadata
+ */
+export declare function resolveStepVariables(stepContent: string, options?: ResolveStepOptions): ResolveResult;
+//# sourceMappingURL=variable-resolver.d.ts.map

package/packages/core/dist/workflow/variable-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/workflow/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0CD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EAAE,GACxB,aAAa,CAyCf;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAmDf"}