@libar-dev/architect 1.0.0-pre.3

package/dist/generators/pipeline/merge-patterns.js

@@ -0,0 +1,50 @@
+/**
+ * @architect
+ * @architect-generator @architect-infra
+ * @architect-pattern MergePatterns
+ * @architect-status completed
+ * @architect-implements OrchestratorPipelineFactoryMigration
+ * @architect-product-area Generation
+ * @architect-uses PatternHelpers
+ *
+ * ## MergePatterns - Dual-Source Pattern Merging
+ *
+ * Merges patterns from TypeScript and Gherkin sources with conflict detection.
+ * Each pattern name must be unique across both sources.
+ *
+ * Target: src/generators/pipeline/merge-patterns.ts
+ * See: DD-2 (OrchestratorPipelineFactoryMigration)
+ *
+ * **When to Use:** When combining TypeScript and Gherkin extracted patterns into a single list with conflict detection.
+ */
+import { Result as R } from '../../types/result.js';
+import { getPatternName } from '../../api/pattern-helpers.js';
+/**
+ * Merge patterns from TypeScript and Gherkin sources with conflict detection
+ *
+ * Exported for testing purposes - allows direct unit testing of merge logic
+ * without running the full pipeline.
+ *
+ * @param tsPatterns - Patterns extracted from TypeScript files
+ * @param gherkinPatterns - Patterns extracted from Gherkin feature files
+ * @returns Result containing merged patterns or error if conflicts detected
+ */
+export function mergePatterns(tsPatterns, gherkinPatterns) {
+    // Check for conflicts (same pattern name in both sources)
+    const conflicts = [];
+    const tsPatternNames = new Set(tsPatterns.map((p) => getPatternName(p)));
+    for (const gherkinPattern of gherkinPatterns) {
+        const patternName = getPatternName(gherkinPattern);
+        if (tsPatternNames.has(patternName)) {
+            conflicts.push(patternName);
+        }
+    }
+    if (conflicts.length > 0) {
+        return R.err(`Pattern conflicts detected: ${conflicts.join(', ')}. ` +
+            `These patterns are defined in both TypeScript and Gherkin sources. ` +
+            `Each pattern should only be defined in one source.`);
+    }
+    // No conflicts - merge patterns
+    return R.ok([...tsPatterns, ...gherkinPatterns]);
+}
+//# sourceMappingURL=merge-patterns.js.map

package/dist/generators/pipeline/merge-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-patterns.js","sourceRoot":"","sources":["../../../src/generators/pipeline/merge-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAuC,EACvC,eAA4C;IAE5C,0DAA0D;IAC1D,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,GAAG,CACV,+BAA+B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACrD,qEAAqE;YACrE,oDAAoD,CACvD,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/generators/pipeline/relationship-resolver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @architect
+ * @architect-pattern RelationshipResolver
+ * @architect-status active
+ * @architect-arch-role service
+ * @architect-arch-context generator
+ * @architect-arch-layer application
+ * @architect-used-by TransformDataset
+ * @architect-uses ExtractedPattern, RelationshipEntry, ImplementationRef, PatternHelpers
+ *
+ * ## RelationshipResolver - Reverse Lookup and Dangling Reference Detection
+ *
+ * Computes reverse relationship lookups (implementedBy, extendedBy, enables, usedBy)
+ * and detects dangling references in the pattern graph. These are the 2nd and 3rd
+ * passes of the MasterDataset transformation pipeline.
+ */
+import type { ExtractedPattern } from '../../validation-schemas/index.js';
+import type { RelationshipEntry } from '../../validation-schemas/master-dataset.js';
+import type { DanglingReference } from './transform-types.js';
+/**
+ * Build reverse lookups for relationship index entries.
+ *
+ * Iterates over patterns to compute:
+ * - implementedBy: which patterns implement this pattern (with file + description)
+ * - extendedBy: which patterns extend this pattern
+ * - enables: which patterns depend on this pattern (reverse of dependsOn)
+ * - usedBy: which patterns use this pattern (reverse of uses)
+ *
+ * Mutates the `relationshipIndex` entries in place, then sorts reverse-computed
+ * arrays for consistent output ordering.
+ *
+ * @param patterns - All extracted patterns
+ * @param relationshipIndex - Mutable relationship index (entries are mutated)
+ */
+export declare function buildReverseLookups(patterns: readonly ExtractedPattern[], relationshipIndex: Record<string, RelationshipEntry>): void;
+/**
+ * Detect dangling references in pattern relationship fields.
+ *
+ * Checks uses, dependsOn, implementsPatterns, extendsPattern, and seeAlso
+ * fields for references to patterns that don't exist in the dataset.
+ *
+ * @param patterns - All extracted patterns
+ * @param allPatternNames - Set of all valid pattern names
+ * @returns Array of dangling references found
+ */
+export declare function detectDanglingReferences(patterns: readonly ExtractedPattern[], allPatternNames: ReadonlySet<string>): DanglingReference[];
+//# sourceMappingURL=relationship-resolver.d.ts.map

package/dist/generators/pipeline/relationship-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-resolver.d.ts","sourceRoot":"","sources":["../../../src/generators/pipeline/relationship-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACnD,IAAI,CAgEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,iBAAiB,EAAE,CAwCrB"}

package/dist/generators/pipeline/relationship-resolver.js

@@ -0,0 +1,132 @@
+/**
+ * @architect
+ * @architect-pattern RelationshipResolver
+ * @architect-status active
+ * @architect-arch-role service
+ * @architect-arch-context generator
+ * @architect-arch-layer application
+ * @architect-used-by TransformDataset
+ * @architect-uses ExtractedPattern, RelationshipEntry, ImplementationRef, PatternHelpers
+ *
+ * ## RelationshipResolver - Reverse Lookup and Dangling Reference Detection
+ *
+ * Computes reverse relationship lookups (implementedBy, extendedBy, enables, usedBy)
+ * and detects dangling references in the pattern graph. These are the 2nd and 3rd
+ * passes of the MasterDataset transformation pipeline.
+ */
+import { getPatternName } from '../../api/pattern-helpers.js';
+/**
+ * Build reverse lookups for relationship index entries.
+ *
+ * Iterates over patterns to compute:
+ * - implementedBy: which patterns implement this pattern (with file + description)
+ * - extendedBy: which patterns extend this pattern
+ * - enables: which patterns depend on this pattern (reverse of dependsOn)
+ * - usedBy: which patterns use this pattern (reverse of uses)
+ *
+ * Mutates the `relationshipIndex` entries in place, then sorts reverse-computed
+ * arrays for consistent output ordering.
+ *
+ * @param patterns - All extracted patterns
+ * @param relationshipIndex - Mutable relationship index (entries are mutated)
+ */
+export function buildReverseLookups(patterns, relationshipIndex) {
+    for (const pattern of patterns) {
+        const patternKey = getPatternName(pattern);
+        const entry = relationshipIndex[patternKey];
+        if (!entry)
+            continue;
+        // Build implementedBy reverse lookup with full ImplementationRef
+        for (const implemented of entry.implementsPatterns) {
+            const target = relationshipIndex[implemented];
+            if (target) {
+                const alreadyAdded = target.implementedBy.some((impl) => impl.name === patternKey);
+                if (!alreadyAdded) {
+                    const desc = pattern.directive.description;
+                    const firstLine = desc ? desc.split('\n')[0]?.trim() : undefined;
+                    const description = firstLine && firstLine.length > 0
+                        ? firstLine.slice(0, 100) + (firstLine.length > 100 ? '...' : '')
+                        : undefined;
+                    target.implementedBy.push({
+                        name: patternKey,
+                        file: pattern.source.file,
+                        description,
+                    });
+                }
+            }
+        }
+        // Build extendedBy reverse lookup
+        if (entry.extendsPattern) {
+            const target = relationshipIndex[entry.extendsPattern];
+            if (target && !target.extendedBy.includes(patternKey)) {
+                target.extendedBy.push(patternKey);
+            }
+        }
+        // Build enables reverse lookup (dependsOn -> enables)
+        for (const dep of entry.dependsOn) {
+            const target = relationshipIndex[dep];
+            if (target && !target.enables.includes(patternKey)) {
+                target.enables.push(patternKey);
+            }
+        }
+        // Build usedBy reverse lookup (uses -> usedBy)
+        for (const used of entry.uses) {
+            const target = relationshipIndex[used];
+            if (target && !target.usedBy.includes(patternKey)) {
+                target.usedBy.push(patternKey);
+            }
+        }
+    }
+    // Sort reverse-computed arrays for consistent output
+    for (const entry of Object.values(relationshipIndex)) {
+        entry.implementedBy.sort((a, b) => a.file.localeCompare(b.file));
+        entry.extendedBy.sort((a, b) => a.localeCompare(b));
+        entry.enables.sort((a, b) => a.localeCompare(b));
+        entry.usedBy.sort((a, b) => a.localeCompare(b));
+    }
+}
+/**
+ * Detect dangling references in pattern relationship fields.
+ *
+ * Checks uses, dependsOn, implementsPatterns, extendsPattern, and seeAlso
+ * fields for references to patterns that don't exist in the dataset.
+ *
+ * @param patterns - All extracted patterns
+ * @param allPatternNames - Set of all valid pattern names
+ * @returns Array of dangling references found
+ */
+export function detectDanglingReferences(patterns, allPatternNames) {
+    const danglingReferences = [];
+    for (const pattern of patterns) {
+        const patternKey = getPatternName(pattern);
+        for (const ref of pattern.uses ?? []) {
+            if (!allPatternNames.has(ref)) {
+                danglingReferences.push({ pattern: patternKey, field: 'uses', missing: ref });
+            }
+        }
+        for (const ref of pattern.dependsOn ?? []) {
+            if (!allPatternNames.has(ref)) {
+                danglingReferences.push({ pattern: patternKey, field: 'dependsOn', missing: ref });
+            }
+        }
+        for (const ref of pattern.implementsPatterns ?? []) {
+            if (!allPatternNames.has(ref)) {
+                danglingReferences.push({ pattern: patternKey, field: 'implementsPatterns', missing: ref });
+            }
+        }
+        if (pattern.extendsPattern && !allPatternNames.has(pattern.extendsPattern)) {
+            danglingReferences.push({
+                pattern: patternKey,
+                field: 'extendsPattern',
+                missing: pattern.extendsPattern,
+            });
+        }
+        for (const ref of pattern.seeAlso ?? []) {
+            if (!allPatternNames.has(ref)) {
+                danglingReferences.push({ pattern: patternKey, field: 'seeAlso', missing: ref });
+            }
+        }
+    }
+    return danglingReferences;
+}
+//# sourceMappingURL=relationship-resolver.js.map

package/dist/generators/pipeline/relationship-resolver.js.map

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

package/dist/generators/pipeline/sequence-utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern SequenceTransformUtils
+ * @architect-status active
+ * @architect-implements DesignReviewGeneration
+ * @architect-arch-role service
+ * @architect-arch-context generator
+ * @architect-arch-layer application
+ * @architect-include pipeline-stages
+ * @architect-uses MasterDataset, ExtractedPattern
+ * @architect-product-area:Generation
+ *
+ * ## SequenceTransformUtils - Sequence Index Builder
+ *
+ * Builds pre-computed SequenceIndexEntry objects from patterns that have
+ * sequence diagram annotations. Used during the single-pass transform to
+ * populate MasterDataset.sequenceIndex.
+ *
+ * ### Layer Boundary
+ *
+ * This module intentionally duplicates the Input/Output/Invariant regex
+ * patterns from parseBusinessRuleAnnotations (renderable/codecs/helpers.ts)
+ * to avoid a cross-layer dependency from pipeline → codec. The regexes are
+ * simple (3 patterns) and stable.
+ */
+import type { BusinessRule } from '../../validation-schemas/extracted-pattern.js';
+import type { SequenceIndexEntry } from '../../validation-schemas/master-dataset.js';
+export interface SequenceIndexBuildResult {
+    readonly entry: SequenceIndexEntry | undefined;
+    readonly issues: readonly string[];
+}
+/**
+ * Build a SequenceIndexEntry from a pattern's orchestrator and business rules.
+ *
+ * Returns undefined if no rules have sequence-step tags (the pattern has an
+ * orchestrator annotation but no step-annotated rules).
+ */
+export declare function buildSequenceIndexEntry(orchestrator: string, rules: readonly BusinessRule[]): SequenceIndexEntry | undefined;
+/**
+ * Build a SequenceIndexEntry and collect validation issues for malformed annotations.
+ *
+ * Returns:
+ * - `entry` when the sequence annotations are valid
+ * - `issues` when step-tagged rules are ambiguous or incomplete
+ * - no entry and no issues when no rules have sequence-step tags
+ */
+export declare function buildSequenceIndexEntryWithValidation(orchestrator: string, rules: readonly BusinessRule[]): SequenceIndexBuildResult;
+//# sourceMappingURL=sequence-utils.d.ts.map

package/dist/generators/pipeline/sequence-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-utils.d.ts","sourceRoot":"","sources":["../../../src/generators/pipeline/sequence-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAwDnG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAuFD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,wBAAwB,CA2G1B"}

package/dist/generators/pipeline/sequence-utils.js

@@ -0,0 +1,235 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern SequenceTransformUtils
+ * @architect-status active
+ * @architect-implements DesignReviewGeneration
+ * @architect-arch-role service
+ * @architect-arch-context generator
+ * @architect-arch-layer application
+ * @architect-include pipeline-stages
+ * @architect-uses MasterDataset, ExtractedPattern
+ * @architect-product-area:Generation
+ *
+ * ## SequenceTransformUtils - Sequence Index Builder
+ *
+ * Builds pre-computed SequenceIndexEntry objects from patterns that have
+ * sequence diagram annotations. Used during the single-pass transform to
+ * populate MasterDataset.sequenceIndex.
+ *
+ * ### Layer Boundary
+ *
+ * This module intentionally duplicates the Input/Output/Invariant regex
+ * patterns from parseBusinessRuleAnnotations (renderable/codecs/helpers.ts)
+ * to avoid a cross-layer dependency from pipeline → codec. The regexes are
+ * simple (3 patterns) and stable.
+ */
+/**
+ * Parse sequence-step and sequence-module from a rule's tag array.
+ *
+ * Tags arrive normalized (without @architect- prefix) from the scanner.
+ */
+function parseRuleSequenceTags(tags) {
+    let step;
+    const modules = [];
+    for (const tag of tags) {
+        if (tag.startsWith('sequence-step:')) {
+            const parsed = parseInt(tag.split(':')[1] ?? '', 10);
+            if (!Number.isNaN(parsed)) {
+                step = parsed;
+            }
+        }
+        else if (tag.startsWith('sequence-module:')) {
+            const value = tag.split(':')[1] ?? '';
+            modules.push(...value
+                .split(',')
+                .map((m) => m.trim())
+                .filter(Boolean));
+        }
+    }
+    return { step, modules };
+}
+/**
+ * Extract Input, Output, and Invariant from a rule description.
+ *
+ * Duplicates the regex patterns from parseBusinessRuleAnnotations in
+ * renderable/codecs/helpers.ts to avoid a cross-layer import.
+ */
+function parseSequenceAnnotations(description) {
+    let input;
+    let output;
+    let invariant;
+    const invariantPattern = /\*\*Invariant:\*\*\s*([\s\S]*?)(?=\*\*[A-Z]|\*\*$|$)/i;
+    const invariantMatch = invariantPattern.exec(description);
+    if (invariantMatch?.[1]) {
+        invariant = invariantMatch[1]
+            .replace(/\n\s*\n/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    const inputPattern = /\*\*Input:\*\*\s*([\s\S]*?)(?=\*\*[A-Z]|\*\*$|$)/i;
+    const inputMatch = inputPattern.exec(description);
+    if (inputMatch?.[1]) {
+        input = inputMatch[1]
+            .replace(/\n\s*\n/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    const outputPattern = /\*\*Output:\*\*\s*([\s\S]*?)(?=\*\*[A-Z]|\*\*$|$)/i;
+    const outputMatch = outputPattern.exec(description);
+    if (outputMatch?.[1]) {
+        output = outputMatch[1]
+            .replace(/\n\s*\n/g, ' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    return { input, output, invariant };
+}
+// =============================================================================
+// Data Flow Type Extraction
+// =============================================================================
+/**
+ * Extract the type name from an Input or Output annotation string.
+ *
+ * Format: "TypeName -- field1, field2, field3" → "TypeName"
+ * Or just: "TypeName" → "TypeName"
+ */
+function extractTypeName(annotation) {
+    const dashIndex = annotation.indexOf('--');
+    if (dashIndex >= 0) {
+        return annotation.slice(0, dashIndex).trim();
+    }
+    return annotation.trim();
+}
+/**
+ * Decide whether an annotation should contribute to dataFlowTypes.
+ *
+ * Keeps structured type declarations (`TypeName -- fields`), bare identifiers,
+ * and type-ish parameter signatures such as `targetDir: string`, while excluding
+ * prose outputs like "package.json updated with process and docs scripts".
+ */
+function extractDataFlowTypeName(annotation) {
+    const trimmed = annotation.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    if (trimmed.includes('--')) {
+        return extractTypeName(trimmed);
+    }
+    if (!/\s/.test(trimmed)) {
+        return trimmed;
+    }
+    return /[:<>{}\[\]|&()]/.test(trimmed) ? trimmed : undefined;
+}
+// =============================================================================
+// Index Builder
+// =============================================================================
+/**
+ * Build a SequenceIndexEntry from a pattern's orchestrator and business rules.
+ *
+ * Returns undefined if no rules have sequence-step tags (the pattern has an
+ * orchestrator annotation but no step-annotated rules).
+ */
+export function buildSequenceIndexEntry(orchestrator, rules) {
+    return buildSequenceIndexEntryWithValidation(orchestrator, rules).entry;
+}
+/**
+ * Build a SequenceIndexEntry and collect validation issues for malformed annotations.
+ *
+ * Returns:
+ * - `entry` when the sequence annotations are valid
+ * - `issues` when step-tagged rules are ambiguous or incomplete
+ * - no entry and no issues when no rules have sequence-step tags
+ */
+export function buildSequenceIndexEntryWithValidation(orchestrator, rules) {
+    const steps = [];
+    const parsedRules = [];
+    const stepNumbers = new Map();
+    const issues = [];
+    for (const rule of rules) {
+        if (!rule.tags || rule.tags.length === 0)
+            continue;
+        const { step, modules } = parseRuleSequenceTags(rule.tags);
+        if (step === undefined)
+            continue;
+        if (modules.length === 0) {
+            issues.push(`Rule "${rule.name}" has @architect-sequence-step:${String(step)} but no @architect-sequence-module values`);
+            continue;
+        }
+        const annotations = parseSequenceAnnotations(rule.description);
+        const rulesForStep = stepNumbers.get(step) ?? [];
+        rulesForStep.push(rule.name);
+        stepNumbers.set(step, rulesForStep);
+        parsedRules.push({
+            stepNumber: step,
+            ruleName: rule.name,
+            modules,
+            annotations,
+            errorScenarios: rule.errorScenarioNames ?? [],
+        });
+    }
+    for (const [stepNumber, ruleNames] of stepNumbers.entries()) {
+        if (ruleNames.length > 1) {
+            issues.push(`Duplicate @architect-sequence-step:${String(stepNumber)} used by rules: ${ruleNames.join(', ')}`);
+        }
+    }
+    if (issues.length > 0) {
+        return { entry: undefined, issues };
+    }
+    if (parsedRules.length === 0) {
+        return { entry: undefined, issues: [] };
+    }
+    for (const parsedRule of parsedRules) {
+        steps.push({
+            stepNumber: parsedRule.stepNumber,
+            ruleName: parsedRule.ruleName,
+            modules: [...parsedRule.modules],
+            input: parsedRule.annotations.input,
+            output: parsedRule.annotations.output,
+            invariant: parsedRule.annotations.invariant,
+            errorScenarios: [...parsedRule.errorScenarios],
+        });
+    }
+    // Sort by step number
+    steps.sort((a, b) => a.stepNumber - b.stepNumber);
+    // Deduplicate participants: orchestrator first, then modules in step order
+    const seen = new Set([orchestrator]);
+    const participants = [orchestrator];
+    for (const step of steps) {
+        for (const mod of step.modules) {
+            if (!seen.has(mod)) {
+                seen.add(mod);
+                participants.push(mod);
+            }
+        }
+    }
+    // Collect all error scenario names
+    const errorPaths = steps.flatMap((s) => s.errorScenarios);
+    // Collect distinct data flow type names from Input/Output
+    const typeNames = new Set();
+    for (const step of steps) {
+        if (step.input) {
+            const inputType = extractDataFlowTypeName(step.input);
+            if (inputType) {
+                typeNames.add(inputType);
+            }
+        }
+        if (step.output) {
+            const outputType = extractDataFlowTypeName(step.output);
+            if (outputType) {
+                typeNames.add(outputType);
+            }
+        }
+    }
+    const dataFlowTypes = [...typeNames];
+    return {
+        entry: {
+            orchestrator,
+            steps,
+            participants,
+            errorPaths,
+            dataFlowTypes,
+        },
+        issues: [],
+    };
+}
+//# sourceMappingURL=sequence-utils.js.map

package/dist/generators/pipeline/sequence-utils.js.map

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

package/dist/generators/pipeline/transform-dataset.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @architect
+ * @architect-generator @architect-core
+ * @architect-pattern TransformDataset
+ * @architect-status completed
+ * @architect-implements PatternRelationshipModel
+ * @architect-arch-role service
+ * @architect-arch-context generator
+ * @architect-arch-layer application
+ * @architect-include pipeline-stages
+ * @architect-uses MasterDataset, ExtractedPattern, TagRegistry, NormalizeStatus
+ * @architect-used-by Orchestrator
+ * @architect-usecase "When computing all pattern views in a single pass"
+ * @architect-usecase "When transforming raw extracted data for generators"
+ * @architect-extract-shapes RuntimeMasterDataset, RawDataset, transformToMasterDataset
+ *
+ * ## TransformDataset - Single-Pass Pattern Transformation
+ *
+ * Transforms raw extracted patterns into a MasterDataset with all pre-computed
+ * views. This is the core of the unified transformation pipeline, computing
+ * status groups, phase groups, quarter groups, category groups, and source
+ * groups in a single iteration over the pattern array.
+ *
+ * ### When to Use
+ *
+ * - Use in orchestrator after pattern extraction and merging
+ * - Use when you need pre-computed views for multiple generators
+ *
+ * ### Key Concepts
+ *
+ * - **Single-pass**: O(n) complexity regardless of view count
+ * - **Immutable output**: Returns a new MasterDataset object
+ * - **Workflow integration**: Uses workflow config for phase names
+ */
+import type { StatusCounts } from '../../validation-schemas/master-dataset.js';
+import type { TransformResult, RuntimeMasterDataset, RawDataset } from './transform-types.js';
+/**
+ * Transform raw extracted data into a MasterDataset with all pre-computed views.
+ *
+ * This is a ONE-PASS transformation that computes:
+ * - Status-based groupings (completed/active/planned)
+ * - Phase-based groupings with counts
+ * - Quarter-based groupings for timeline views
+ * - Category-based groupings for taxonomy
+ * - Source-based views (TypeScript vs Gherkin, roadmap, PRD)
+ * - Aggregate statistics (counts, phase count, category count)
+ * - Optional relationship index
+ *
+ * Convenience wrapper that returns just the dataset.
+ * Use `transformToMasterDatasetWithValidation` to get validation summary.
+ *
+ * @param raw - Raw dataset with patterns, registry, and optional workflow
+ * @returns MasterDataset with all pre-computed views
+ */
+export declare function transformToMasterDataset(raw: RawDataset): RuntimeMasterDataset;
+/**
+ * Transform raw extracted data into a MasterDataset with validation summary.
+ *
+ * This is the full transformation that includes:
+ * - Pre-loop validation against ExtractedPatternSchema
+ * - Status-based groupings (completed/active/planned)
+ * - Phase-based groupings with counts
+ * - Quarter-based groupings for timeline views
+ * - Category-based groupings for taxonomy
+ * - Source-based views (TypeScript vs Gherkin, roadmap, PRD)
+ * - Aggregate statistics (counts, phase count, category count)
+ * - Relationship index with dangling reference detection
+ * - Validation summary with malformed patterns and unknown statuses
+ *
+ * @param raw - Raw dataset with patterns, registry, and optional workflow
+ * @returns TransformResult with dataset and validation summary
+ */
+export declare function transformToMasterDatasetWithValidation(raw: RawDataset): TransformResult;
+/**
+ * Compute completion percentage from status counts
+ */
+export declare function completionPercentage(counts: StatusCounts): number;
+/**
+ * Check if all items in a phase/group are completed
+ */
+export declare function isFullyCompleted(counts: StatusCounts): boolean;
+//# sourceMappingURL=transform-dataset.d.ts.map

package/dist/generators/pipeline/transform-dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-dataset.d.ts","sourceRoot":"","sources":["../../../src/generators/pipeline/transform-dataset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAKH,OAAO,KAAK,EAEV,YAAY,EAMb,MAAM,4CAA4C,CAAC;AAMpD,OAAO,KAAK,EAGV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAU9B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,UAAU,GAAG,oBAAoB,CAE9E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sCAAsC,CAAC,GAAG,EAAE,UAAU,GAAG,eAAe,CAkRvF;AAyBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE9D"}