@pennyfarthing/core 7.0.2 → 7.4.1

package/packages/core/dist/workflow/step-parser.test.js

@@ -0,0 +1,470 @@
+/**
+ * Tests for Story MSSCI-12079: Step file parser with <step-meta> extraction
+ *
+ * These tests define the contract for parsing step files in stepped workflows.
+ * Step files are markdown documents with an optional <step-meta> YAML block.
+ *
+ * Expected interface:
+ * - parseStepFile(content: string, filename?: string): StepParseResult
+ * - parseStepFromPath(filePath: string): Promise<StepParseResult>
+ *
+ * Run with: npm test
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+// Import will fail until implementation exists - this confirms RED state
+import { parseStepFile, parseStepFromPath } from './step-parser.js';
+describe('Step File Parser (MSSCI-12079)', () => {
+    describe('AC1: Parser extracts step-meta YAML block', () => {
+        it('should extract step-meta block from valid step file', () => {
+            const content = `# Step 2: Context Analysis
+
+<step-meta>
+number: 2
+name: context-analysis
+gate: true
+</step-meta>
+
+## Purpose
+Analyze the project context...
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true, 'Should successfully parse valid step file');
+            assert.ok(result.step, 'Should return parsed step');
+            assert.ok(result.step.meta, 'Should include raw meta object');
+            assert.strictEqual(result.step.meta?.number, 2);
+            assert.strictEqual(result.step.meta?.name, 'context-analysis');
+            assert.strictEqual(result.step.meta?.gate, true);
+        });
+        it('should strip step-meta block from content', () => {
+            const content = `# Step 1: Introduction
+
+<step-meta>
+number: 1
+name: introduction
+</step-meta>
+
+## Welcome
+This is the introduction step.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step);
+            // Content should not contain the step-meta block
+            assert.ok(!result.step.content.includes('<step-meta>'), 'Content should not include step-meta opening tag');
+            assert.ok(!result.step.content.includes('</step-meta>'), 'Content should not include step-meta closing tag');
+            // Content should still include the markdown
+            assert.ok(result.step.content.includes('## Welcome'), 'Content should preserve markdown after meta');
+            assert.ok(result.step.content.includes('This is the introduction step'), 'Content should preserve body text');
+        });
+        it('should handle step-meta with extra fields', () => {
+            const content = `<step-meta>
+number: 3
+name: custom-step
+gate: false
+custom_field: some-value
+another_field: 123
+</step-meta>
+
+Content here.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step?.meta);
+            assert.strictEqual(result.step.meta.custom_field, 'some-value');
+            assert.strictEqual(result.step.meta.another_field, 123);
+        });
+        it('should handle step-meta at different positions in file', () => {
+            // Meta after heading
+            const content = `# Step 5: Review
+
+Some preamble text here.
+
+<step-meta>
+number: 5
+name: review
+</step-meta>
+
+## Instructions
+Do the review.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 5);
+            assert.strictEqual(result.step?.name, 'review');
+        });
+    });
+    describe('AC2: Parser returns step number, name, gate flag', () => {
+        it('should return number from meta', () => {
+            const content = `<step-meta>
+number: 7
+name: final-step
+</step-meta>
+
+Content.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 7);
+        });
+        it('should return name from meta', () => {
+            const content = `<step-meta>
+number: 1
+name: initialization-step
+</step-meta>
+
+Content.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.name, 'initialization-step');
+        });
+        it('should return gate flag from meta when true', () => {
+            const content = `<step-meta>
+number: 3
+name: checkpoint
+gate: true
+</step-meta>
+
+This step has a gate.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true);
+        });
+        it('should return gate flag from meta when false', () => {
+            const content = `<step-meta>
+number: 2
+name: no-gate
+gate: false
+</step-meta>
+
+This step has no gate.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, false);
+        });
+        it('should default gate to false when not specified in meta', () => {
+            const content = `<step-meta>
+number: 4
+name: implicit-no-gate
+</step-meta>
+
+No gate field specified.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, false, 'Gate should default to false');
+        });
+        it('should preserve content field with markdown intact', () => {
+            const content = `<step-meta>
+number: 1
+name: test
+</step-meta>
+
+# Heading
+
+Some **bold** and *italic* text.
+
+\`\`\`typescript
+const x = 1;
+\`\`\`
+
+- List item 1
+- List item 2
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step?.content.includes('# Heading'));
+            assert.ok(result.step?.content.includes('**bold**'));
+            assert.ok(result.step?.content.includes('const x = 1;'));
+            assert.ok(result.step?.content.includes('- List item 1'));
+        });
+    });
+    describe('AC3: Parser handles missing meta gracefully', () => {
+        it('should extract number and name from filename when no meta block', () => {
+            const content = `# Step 3: Architecture Design
+
+This step file has no meta block.
+
+## Instructions
+Design the architecture.
+`;
+            const result = parseStepFile(content, 'step-03-architecture-design.md');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 3);
+            assert.strictEqual(result.step?.name, 'architecture-design');
+        });
+        it('should handle step-{n} filename pattern (single digit)', () => {
+            const content = `No meta here.`;
+            const result = parseStepFile(content, 'step-5-review.md');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 5);
+            assert.strictEqual(result.step?.name, 'review');
+        });
+        it('should handle step-{nn} filename pattern (double digit)', () => {
+            const content = `No meta here.`;
+            const result = parseStepFile(content, 'step-12-final-review.md');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 12);
+            assert.strictEqual(result.step?.name, 'final-review');
+        });
+        it('should return entire content when no meta block', () => {
+            const fullContent = `# Full Content
+
+All of this should be in the content field.
+
+## Section 1
+Text here.
+
+## Section 2
+More text.
+`;
+            const result = parseStepFile(fullContent, 'step-01-full.md');
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step?.content.includes('# Full Content'));
+            assert.ok(result.step?.content.includes('## Section 1'));
+            assert.ok(result.step?.content.includes('## Section 2'));
+        });
+        it('should return error when no meta and filename cannot be parsed', () => {
+            const content = `No meta block here.`;
+            const result = parseStepFile(content, 'random-file.md');
+            assert.strictEqual(result.success, false, 'Should fail without meta or parseable filename');
+            assert.ok(result.error, 'Should include error message');
+        });
+        it('should return error when no meta and no filename provided', () => {
+            const content = `No meta block here and no filename.`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, false, 'Should fail without meta or filename');
+            assert.ok(result.error, 'Should include error message');
+        });
+        it('should handle empty file', () => {
+            const result = parseStepFile('', 'step-01-empty.md');
+            assert.strictEqual(result.success, true, 'Empty file with valid filename should succeed');
+            assert.strictEqual(result.step?.number, 1);
+            assert.strictEqual(result.step?.name, 'empty');
+            assert.strictEqual(result.step?.content, '');
+        });
+        it('should handle malformed YAML in meta block gracefully', () => {
+            const content = `<step-meta>
+number: not-a-number
+name: [invalid yaml
+gate: {broken
+</step-meta>
+
+Content after bad meta.
+`;
+            const result = parseStepFile(content, 'step-01-fallback.md');
+            // Should fall back to filename parsing, not crash
+            assert.strictEqual(result.success, true, 'Should fall back to filename when meta is malformed');
+            assert.strictEqual(result.step?.number, 1);
+            assert.strictEqual(result.step?.name, 'fallback');
+        });
+    });
+    describe('AC4: Gate detection from meta or marker', () => {
+        it('should detect gate from meta gate: true', () => {
+            const content = `<step-meta>
+number: 1
+name: gated-step
+gate: true
+</step-meta>
+
+No marker in content.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true, 'Gate should be true from meta');
+        });
+        it('should detect gate from <!-- GATE --> marker in content', () => {
+            const content = `<step-meta>
+number: 2
+name: marker-gate
+</step-meta>
+
+## Instructions
+Do the thing.
+
+<!-- GATE -->
+- [C] Continue
+- [R] Revise
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true, 'Gate should be true from marker');
+        });
+        it('should detect gate from marker when no meta block', () => {
+            const content = `# Step 3: Review
+
+Do the review.
+
+## Gate
+
+<!-- GATE -->
+- [C] Continue to next step
+- [R] Revise this step
+`;
+            const result = parseStepFile(content, 'step-03-review.md');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true, 'Gate should be detected from marker');
+        });
+        it('should prefer meta gate: true over missing marker', () => {
+            const content = `<step-meta>
+number: 1
+name: meta-wins
+gate: true
+</step-meta>
+
+No marker here, but meta says gate is true.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true);
+        });
+        it('should prefer meta gate: false over marker in content', () => {
+            // Meta explicitly says no gate, even though marker exists
+            const content = `<step-meta>
+number: 5
+name: meta-overrides
+gate: false
+</step-meta>
+
+## Gate Section
+
+<!-- GATE -->
+This marker should be ignored because meta says gate: false.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, false, 'Meta gate: false should override marker');
+        });
+        it('should handle multiple gate markers (use first occurrence)', () => {
+            const content = `<step-meta>
+number: 1
+name: multi-gate
+</step-meta>
+
+## First Gate
+
+<!-- GATE -->
+First gate marker.
+
+## Second Gate
+
+<!-- GATE -->
+Second gate marker should not matter.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true);
+        });
+        it('should detect gate marker with surrounding whitespace', () => {
+            const content = `<step-meta>
+number: 1
+name: whitespace-gate
+</step-meta>
+
+Content.
+
+   <!-- GATE -->
+
+More content.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.gate, true, 'Should detect marker with whitespace');
+        });
+        it('should not detect gate from similar but different markers', () => {
+            const content = `<step-meta>
+number: 1
+name: no-gate
+</step-meta>
+
+<!-- NOT A GATE -->
+<!-- GATES -->
+<!-- gate -->
+<!--GATE-->
+
+These are not the gate marker you're looking for.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            // Only exact "<!-- GATE -->" should match (case sensitive, with spaces)
+            assert.strictEqual(result.step?.gate, false, 'Should not match similar markers');
+        });
+    });
+    describe('Edge Cases', () => {
+        it('should handle step-meta with only number', () => {
+            const content = `<step-meta>
+number: 42
+</step-meta>
+
+Content.
+`;
+            const result = parseStepFile(content, 'step-42-named-in-file.md');
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 42);
+            // Name should come from filename since not in meta
+            assert.strictEqual(result.step?.name, 'named-in-file');
+        });
+        it('should handle step-meta with only name', () => {
+            const content = `<step-meta>
+name: only-name
+</step-meta>
+
+Content.
+`;
+            const result = parseStepFile(content, 'step-07-ignored.md');
+            assert.strictEqual(result.success, true);
+            // Number should come from filename since not in meta
+            assert.strictEqual(result.step?.number, 7);
+            assert.strictEqual(result.step?.name, 'only-name');
+        });
+        it('should handle unicode in content', () => {
+            const content = `<step-meta>
+number: 1
+name: unicode
+</step-meta>
+
+# こんにちは 🌍
+
+Content with émojis 🎉 and spëcial çharacters.
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step?.content.includes('こんにちは'));
+            assert.ok(result.step?.content.includes('🌍'));
+        });
+        it('should handle Windows line endings (CRLF)', () => {
+            const content = `<step-meta>\r\nnumber: 1\r\nname: crlf\r\n</step-meta>\r\n\r\nContent with CRLF.\r\n`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.strictEqual(result.step?.number, 1);
+            assert.strictEqual(result.step?.name, 'crlf');
+        });
+        it('should preserve indentation in content', () => {
+            const content = `<step-meta>
+number: 1
+name: indented
+</step-meta>
+
+    indented line
+        double indented
+\ttab indented
+`;
+            const result = parseStepFile(content);
+            assert.strictEqual(result.success, true);
+            assert.ok(result.step?.content.includes('    indented line'));
+            assert.ok(result.step?.content.includes('        double indented'));
+        });
+    });
+    describe('parseStepFromPath', () => {
+        it('should be an async function', () => {
+            // This test verifies the function signature
+            assert.strictEqual(typeof parseStepFromPath, 'function');
+            // The actual file reading tests would need mock filesystem
+            // but we verify the function exists and returns a promise-like value
+        });
+    });
+});
+//# sourceMappingURL=step-parser.test.js.map

package/packages/core/dist/workflow/step-parser.test.js.map

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