@pennyfarthing/core 6.6.0

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

@@ -0,0 +1,245 @@
+/**
+ * Workflow Router
+ *
+ * Routes stories to appropriate workflows based on explicit tags,
+ * trigger rules, and defaults.
+ *
+ * Priority algorithm:
+ * 1. Explicit workflow: tag on story
+ * 2. Trigger tag match (story tags intersect workflow trigger tags)
+ * 3. Type match (story type in workflow trigger types)
+ * 4. Points match (story points within workflow trigger range)
+ * 5. Default workflow fallback
+ */
+/**
+ * Helper to check if a trigger's constraints are satisfied by a story
+ * This ensures ALL constraints in a trigger must match (AND logic within a trigger)
+ */
+function doesStoryMatchTrigger(story, triggers, matchType) {
+    if (!triggers) {
+        return false;
+    }
+    // For explicit tag and default, we don't need to check other constraints
+    if (matchType === 'explicit-tag' || matchType === 'default') {
+        return true;
+    }
+    // For other match types, we need to verify all constraints are met
+    // If story has a type, check type constraint if it exists
+    if (story.type && triggers.types && triggers.types.length > 0) {
+        if (!triggers.types.includes(story.type)) {
+            return false;
+        }
+    }
+    // Check points constraint if it exists
+    if (triggers.points) {
+        if (story.points === undefined) {
+            return false;
+        }
+        const { min, max } = triggers.points;
+        const hasMin = min !== undefined;
+        const hasMax = max !== undefined;
+        if (hasMin && story.points < min) {
+            return false;
+        }
+        if (hasMax && story.points > max) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Route a story to the appropriate workflow
+ *
+ * @param story - Story metadata for routing decisions
+ * @param workflows - Available workflow definitions
+ * @returns Routing result with matched workflow and reason, or null if no match
+ *
+ * @example
+ * ```typescript
+ * const story = { id: '31-3', type: 'feature', points: 3 };
+ * const result = routeStoryToWorkflow(story, workflows);
+ * if (result) {
+ *   console.log(`Using workflow: ${result.workflow.name}`);
+ *   console.log(`Reason: ${result.reason}`);
+ * }
+ * ```
+ */
+export function routeStoryToWorkflow(story, workflows) {
+    if (workflows.length === 0) {
+        return null;
+    }
+    // Priority 1: Explicit workflow:xyz tag
+    const explicitMatch = findExplicitTagMatch(story, workflows);
+    if (explicitMatch) {
+        return explicitMatch;
+    }
+    // Priority 2: Trigger tag match
+    const tagMatch = findTriggerTagMatch(story, workflows);
+    if (tagMatch) {
+        return tagMatch;
+    }
+    // Priority 3: Type match
+    const typeMatch = findTypeMatch(story, workflows);
+    if (typeMatch) {
+        return typeMatch;
+    }
+    // Priority 4: Points match
+    const pointsMatch = findPointsMatch(story, workflows);
+    if (pointsMatch) {
+        return pointsMatch;
+    }
+    // Priority 5: Default fallback
+    const defaultMatch = findDefaultWorkflow(workflows);
+    if (defaultMatch) {
+        return defaultMatch;
+    }
+    return null;
+}
+/**
+ * Find workflow by explicit workflow:xyz tag
+ */
+function findExplicitTagMatch(story, workflows) {
+    if (!story.tags || story.tags.length === 0) {
+        return null;
+    }
+    // Find first workflow: tag
+    for (const tag of story.tags) {
+        if (tag.startsWith('workflow:')) {
+            const workflowName = tag.slice('workflow:'.length);
+            const workflow = workflows.find(w => w.name === workflowName);
+            if (workflow) {
+                return {
+                    workflow,
+                    reason: `Matched explicit tag 'workflow:${workflowName}' to workflow '${workflow.name}'`
+                };
+            }
+            // Explicit tag didn't match any workflow - continue to other matching rules
+        }
+    }
+    return null;
+}
+/**
+ * Find workflow by trigger tags (story tags intersect workflow trigger.tags)
+ */
+function findTriggerTagMatch(story, workflows) {
+    if (!story.tags || story.tags.length === 0) {
+        return null;
+    }
+    // Filter out workflow: tags (those are handled by explicit match)
+    const storyTags = story.tags.filter(t => !t.startsWith('workflow:'));
+    if (storyTags.length === 0) {
+        return null;
+    }
+    for (const workflow of workflows) {
+        const triggerTags = workflow.triggers?.tags;
+        if (!triggerTags || triggerTags.length === 0) {
+            continue;
+        }
+        // Check if any story tag matches any trigger tag
+        const matchingTag = storyTags.find(t => triggerTags.includes(t));
+        if (matchingTag) {
+            // Verify all other constraints are met
+            if (doesStoryMatchTrigger(story, workflow.triggers, 'trigger-tag')) {
+                return {
+                    workflow,
+                    reason: `Matched tag '${matchingTag}' to workflow '${workflow.name}'`
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Find workflow by type match (story.type in workflow.triggers.types)
+ *
+ * When multiple workflows match by type, prefer the one with more specific
+ * constraints (e.g., points ranges). This ensures that "refactor with 2 points"
+ * matches "trivial" (which has points.max: 2) rather than "agent-docs"
+ * (which has no points constraint).
+ */
+function findTypeMatch(story, workflows) {
+    if (!story.type) {
+        return null;
+    }
+    // Collect all type matches, sorted by specificity
+    // Specificity: workflows with points constraints > workflows without
+    const typeMatches = [];
+    for (const workflow of workflows) {
+        const triggerTypes = workflow.triggers?.types;
+        if (!triggerTypes || triggerTypes.length === 0) {
+            continue;
+        }
+        if (triggerTypes.includes(story.type)) {
+            // Verify all constraints are met (including points if specified)
+            if (doesStoryMatchTrigger(story, workflow.triggers, 'type')) {
+                // Calculate specificity: workflows with points constraints are more specific
+                const hasPointsConstraint = workflow.triggers?.points !== undefined;
+                const specificity = hasPointsConstraint ? 1 : 0;
+                typeMatches.push({ workflow, specificity });
+            }
+        }
+    }
+    // Sort by specificity descending, then return the first match
+    if (typeMatches.length > 0) {
+        typeMatches.sort((a, b) => b.specificity - a.specificity);
+        const match = typeMatches[0];
+        return {
+            workflow: match.workflow,
+            reason: `Matched type '${story.type}' to workflow '${match.workflow.name}'`
+        };
+    }
+    return null;
+}
+/**
+ * Find workflow by points range (story.points within workflow.triggers.points min/max)
+ */
+function findPointsMatch(story, workflows) {
+    if (story.points === undefined) {
+        return null;
+    }
+    for (const workflow of workflows) {
+        const triggerPoints = workflow.triggers?.points;
+        if (!triggerPoints) {
+            continue;
+        }
+        const { min, max } = triggerPoints;
+        const hasMin = min !== undefined;
+        const hasMax = max !== undefined;
+        // Must have at least one constraint
+        if (!hasMin && !hasMax) {
+            continue;
+        }
+        // Check constraints
+        const meetsMin = !hasMin || story.points >= min;
+        const meetsMax = !hasMax || story.points <= max;
+        if (meetsMin && meetsMax) {
+            // Verify all constraints are met
+            if (doesStoryMatchTrigger(story, workflow.triggers, 'points')) {
+                const rangeDesc = hasMin && hasMax
+                    ? `${min}-${max}`
+                    : hasMin
+                        ? `>=${min}`
+                        : `<=${max}`;
+                return {
+                    workflow,
+                    reason: `Matched points ${story.points} (range: ${rangeDesc}) to workflow '${workflow.name}'`
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Find default workflow (triggers.default: true)
+ */
+function findDefaultWorkflow(workflows) {
+    const defaultWorkflow = workflows.find(w => w.triggers?.default === true);
+    if (defaultWorkflow) {
+        return {
+            workflow: defaultWorkflow,
+            reason: `Using default workflow '${defaultWorkflow.name}'`
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=workflow-router.js.map

package/packages/core/dist/workflow/workflow-router.js.map

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

package/packages/core/dist/workflow/workflow-router.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tests for Story 31-3: Story-to-workflow Routing Engine
+ *
+ * These tests define the contract for routing stories to workflows based on:
+ * - Explicit workflow tags (highest priority)
+ * - Trigger matching (tags, types, points)
+ * - Default fallback workflow
+ *
+ * The router (workflow-router.ts) will implement these functions to pass these tests.
+ *
+ * Acceptance Criteria:
+ * - AC1: Stories with workflow tag use specified workflow
+ * - AC2: Story type mapping to workflows configurable
+ * - AC3: Default workflow when no match
+ * - AC4: Routing decision logged for debugging
+ *
+ * Run with: npm test
+ */
+export {};
+//# sourceMappingURL=workflow-router.test.d.ts.map

package/packages/core/dist/workflow/workflow-router.test.d.ts.map

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