@pennyfarthing/core 7.5.0 → 7.6.0

package/packages/core/dist/workflow/gate-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-handler.d.ts","sourceRoot":"","sources":["../../src/workflow/gate-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC;IACnD,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAkC7D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAiBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,YAAY,GACrB,MAAM,CA8CR;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,EAAE,CAoCzE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAgBrE"}

package/packages/core/dist/workflow/gate-handler.js

@@ -0,0 +1,189 @@
+/**
+ * Gate Handler for MSSCI-12085
+ *
+ * Unifies gate detection from three sources:
+ * 1. Workflow YAML: gates.after_steps array
+ * 2. Step-meta: gate: true field
+ * 3. Content marker: <!-- GATE --> in step content
+ *
+ * Also handles gate prompt extraction and decision recording.
+ */
+// Regex to detect gate marker (exact match with spaces, allows surrounding whitespace on the line)
+const GATE_MARKER_REGEX = /^\s*<!-- GATE -->\s*$/m;
+// Default prompt when no custom prompt is provided
+const DEFAULT_GATE_PROMPT = 'Review the output above. Continue to next step or revise?';
+/**
+ * Detect if a step has a gate from any of the three sources
+ *
+ * Priority (for source reporting): workflow > step-meta > marker
+ * Logic: OR - any source triggers a gate
+ *
+ * @param params - Detection parameters
+ * @returns GateInfo with detection result
+ */
+export function detectGate(params) {
+    const { stepNumber, afterSteps, stepMeta, stepContent } = params;
+    let isGate = false;
+    let source = null;
+    // Check workflow gates.after_steps (highest priority)
+    if (afterSteps && afterSteps.includes(stepNumber)) {
+        isGate = true;
+        source = 'workflow';
+    }
+    // Check step-meta gate: true (second priority)
+    else if (stepMeta && stepMeta.gate === true) {
+        isGate = true;
+        source = 'step-meta';
+    }
+    // Check content marker (lowest priority)
+    else if (GATE_MARKER_REGEX.test(stepContent)) {
+        isGate = true;
+        source = 'marker';
+    }
+    // Extract prompt if gate detected
+    let prompt;
+    if (isGate) {
+        prompt = extractGatePrompt(stepContent, stepMeta);
+    }
+    return {
+        isGate,
+        source,
+        prompt,
+        stepNumber,
+    };
+}
+// Regex to extract ## Gate Prompt section content
+// Captures until next ## heading or end of string
+const GATE_PROMPT_SECTION_REGEX = /## Gate Prompt\n([\s\S]*?)(?=\n## |\n*$)/;
+/**
+ * Extract gate prompt from step content or metadata
+ *
+ * Priority: ## Gate Prompt section > step-meta gate_prompt > default
+ *
+ * @param content - Step markdown content
+ * @param meta - Optional step metadata
+ * @returns Gate prompt text
+ */
+export function extractGatePrompt(content, meta) {
+    // Priority 1: Check for ## Gate Prompt section in content
+    const sectionMatch = content.match(GATE_PROMPT_SECTION_REGEX);
+    if (sectionMatch) {
+        const sectionContent = sectionMatch[1].trim();
+        if (sectionContent) {
+            return sectionContent;
+        }
+    }
+    // Priority 2: Check for gate_prompt in step-meta
+    if (meta && typeof meta.gate_prompt === 'string' && meta.gate_prompt) {
+        return meta.gate_prompt;
+    }
+    // Priority 3: Return default prompt
+    return DEFAULT_GATE_PROMPT;
+}
+/**
+ * Record a gate decision to session file content
+ *
+ * Adds or updates the ## Gate Decisions section with a markdown table
+ *
+ * @param sessionContent - Current session file content
+ * @param decision - Gate decision to record
+ * @returns Updated session content
+ */
+export function recordGateDecision(sessionContent, decision) {
+    // Normalize line endings
+    const normalized = sessionContent.replace(/\r\n/g, '\n');
+    // Parse existing decisions
+    const existingDecisions = parseGateDecisions(normalized);
+    // Add the new decision
+    const allDecisions = [...existingDecisions, decision];
+    // Format the new section
+    const newSection = formatGateDecisions(allDecisions);
+    // Check if section already exists
+    const sectionMatch = normalized.match(GATE_DECISIONS_SECTION_REGEX);
+    if (sectionMatch) {
+        // Replace existing section
+        return normalized.replace(GATE_DECISIONS_SECTION_REGEX, newSection + '\n');
+    }
+    // Insert new section - find a good location
+    // Preferred: before ## Workflow State or after ## Acceptance Criteria
+    const workflowStateMatch = normalized.match(/\n## Workflow State/);
+    if (workflowStateMatch && workflowStateMatch.index !== undefined) {
+        return (normalized.slice(0, workflowStateMatch.index) +
+            '\n\n' +
+            newSection +
+            normalized.slice(workflowStateMatch.index));
+    }
+    // Fallback: insert before last ## section or at end
+    const lastSectionMatch = normalized.match(/\n(## [^\n]+)(?![\s\S]*\n## )/);
+    if (lastSectionMatch && lastSectionMatch.index !== undefined) {
+        return (normalized.slice(0, lastSectionMatch.index) +
+            '\n\n' +
+            newSection +
+            normalized.slice(lastSectionMatch.index));
+    }
+    // Last resort: append at end
+    return normalized + '\n\n' + newSection + '\n';
+}
+// Regex to find ## Gate Decisions section
+const GATE_DECISIONS_SECTION_REGEX = /## Gate Decisions\n([\s\S]*?)(?=\n## |\n*$)/;
+// Regex to parse a table row: | step | choice | time | notes |
+const TABLE_ROW_REGEX = /^\|\s*(\d+)\s*\|\s*(continue|revise)\s*\|\s*([^\|]+)\s*\|\s*([^\|]*)\s*\|$/;
+/**
+ * Parse existing gate decisions from session file
+ *
+ * @param sessionContent - Session file content
+ * @returns Array of gate decisions
+ */
+export function parseGateDecisions(sessionContent) {
+    // Normalize line endings to LF
+    const normalized = sessionContent.replace(/\r\n/g, '\n');
+    const sectionMatch = normalized.match(GATE_DECISIONS_SECTION_REGEX);
+    if (!sectionMatch) {
+        return [];
+    }
+    const sectionContent = sectionMatch[1];
+    const lines = sectionContent.split('\n');
+    const decisions = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip header row and separator row
+        if (trimmed.startsWith('| Step') || trimmed.startsWith('|---')) {
+            continue;
+        }
+        const match = trimmed.match(TABLE_ROW_REGEX);
+        if (match) {
+            const step = parseInt(match[1], 10);
+            const choice = match[2];
+            const timestamp = match[3].trim();
+            const notesRaw = match[4].trim();
+            // Convert '-' back to undefined, unescape pipes
+            const notes = notesRaw === '-' || notesRaw === ''
+                ? undefined
+                : notesRaw.replace(/\\\|/g, '|');
+            decisions.push({ step, choice, timestamp, notes });
+        }
+    }
+    return decisions;
+}
+/**
+ * Format gate decisions as markdown table
+ *
+ * @param decisions - Array of gate decisions
+ * @returns Markdown table string
+ */
+export function formatGateDecisions(decisions) {
+    const lines = [
+        '## Gate Decisions',
+        '| Step | Choice | Time | Notes |',
+        '|------|--------|------|-------|',
+    ];
+    for (const decision of decisions) {
+        // Escape pipe characters in notes to prevent table corruption
+        const notes = decision.notes
+            ? decision.notes.replace(/\|/g, '\\|')
+            : '-';
+        lines.push(`| ${decision.step} | ${decision.choice} | ${decision.timestamp} | ${notes} |`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=gate-handler.js.map

package/packages/core/dist/workflow/gate-handler.js.map

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

package/packages/core/dist/workflow/gate-handler.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for Story MSSCI-12085: Gate detection and approval flow
+ *
+ * Tests the unified gate detection system that combines three sources:
+ * 1. Workflow YAML: gates.after_steps array
+ * 2. Step-meta: gate: true field
+ * 3. Content marker: <!-- GATE --> in step content
+ *
+ * Also tests gate prompt extraction and decision recording in session files.
+ *
+ * Run with: npm test
+ */
+export {};
+//# sourceMappingURL=gate-handler.test.d.ts.map

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

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