@pennyfarthing/core 7.0.2 → 7.4.1

package/packages/core/dist/workflow/handoff.js

@@ -0,0 +1,411 @@
+/**
+ * Workflow-Driven Handoff
+ *
+ * Replaces hardcoded handoff files with workflow-driven logic.
+ * Reads phase requirements from workflow definitions.
+ *
+ * Provides functions to:
+ * - Find current phase in a workflow
+ * - Determine next phase (forward or rejection loop)
+ * - Check gate conditions based on gate type
+ * - Format session file updates for phase transitions
+ */
+import { existsSync, readFileSync } from 'fs';
+/**
+ * Find a phase by name in a workflow definition
+ *
+ * @param workflow - The workflow definition to search
+ * @param phaseName - Name of the phase to find
+ * @returns The phase definition or null if not found
+ *
+ * @example
+ * ```typescript
+ * const phase = findCurrentPhase(workflow, 'red');
+ * if (phase) {
+ *   console.log(`Found phase: ${phase.name}, agent: ${phase.agent}`);
+ * }
+ * ```
+ */
+export function findCurrentPhase(workflow, phaseName) {
+    if (!workflow.phases) {
+        return null;
+    }
+    return workflow.phases.find(phase => phase.name === phaseName) ?? null;
+}
+/**
+ * Get the next phase in the workflow
+ *
+ * For normal progression, returns the next phase in sequence.
+ * For rejection (verdict='rejected'), returns the phase to loop back to
+ * (typically the most recent phase with a tests_pass gate).
+ *
+ * @param workflow - The workflow definition
+ * @param currentPhaseName - Name of the current phase
+ * @param options - Options for handling rejection loops
+ * @returns The next phase or null if at end/not found
+ *
+ * @example
+ * ```typescript
+ * // Normal progression
+ * const next = getNextPhase(workflow, 'red');
+ *
+ * // Rejection loop
+ * const next = getNextPhase(workflow, 'review', { verdict: 'rejected' });
+ * ```
+ */
+export function getNextPhase(workflow, currentPhaseName, options) {
+    if (!workflow.phases) {
+        return null;
+    }
+    const currentIndex = workflow.phases.findIndex(phase => phase.name === currentPhaseName);
+    if (currentIndex === -1) {
+        return null;
+    }
+    // Handle rejection: loop back to previous phase with tests_pass gate
+    if (options?.verdict === 'rejected') {
+        // Search backwards for a phase with tests_pass gate
+        for (let i = currentIndex - 1; i >= 0; i--) {
+            const phase = workflow.phases[i];
+            if (phase.gate?.type === 'tests_pass') {
+                return phase;
+            }
+        }
+        // Fallback: return the phase immediately before current
+        if (currentIndex > 0) {
+            return workflow.phases[currentIndex - 1];
+        }
+        return null;
+    }
+    // Forward progression: return next phase in sequence
+    if (currentIndex < workflow.phases.length - 1) {
+        return workflow.phases[currentIndex + 1];
+    }
+    // At final phase - no next
+    return null;
+}
+/**
+ * Check if a gate condition is satisfied
+ *
+ * Gate types:
+ * - tests_fail: testsRed must be true
+ * - tests_pass: testsGreen must be true
+ * - approval: verdict must be provided (approved or rejected)
+ * - manual: always passes
+ * - (none): always passes
+ *
+ * @param workflow - The workflow definition
+ * @param phaseName - Name of the phase to check
+ * @param context - Gate check context with test results, verdicts, etc.
+ * @returns Gate check result
+ *
+ * @example
+ * ```typescript
+ * const result = checkGate(workflow, 'red', { testsRed: true });
+ * if (result.passed) {
+ *   // Proceed with handoff
+ * }
+ * ```
+ */
+export function checkGate(workflow, phaseName, context) {
+    const phase = findCurrentPhase(workflow, phaseName);
+    if (!phase) {
+        return {
+            passed: false,
+            message: `Phase "${phaseName}" not found in workflow`
+        };
+    }
+    // No gate defined - always passes
+    if (!phase.gate) {
+        return { passed: true };
+    }
+    const gateType = phase.gate.type;
+    switch (gateType) {
+        case 'tests_fail':
+            // RED phase: tests must be failing
+            if (context.testsRed === true) {
+                return { passed: true, gateType };
+            }
+            return {
+                passed: false,
+                gateType,
+                message: 'Tests must be failing (RED) to proceed from this phase'
+            };
+        case 'tests_pass':
+            // GREEN phase: tests must be passing
+            if (context.testsGreen === true) {
+                return { passed: true, gateType };
+            }
+            return {
+                passed: false,
+                gateType,
+                message: `Tests must be passing (GREEN) to proceed. Currently ${context.testFailCount ?? 0} failing.`
+            };
+        case 'approval':
+            // Review phase: verdict must be provided
+            if (context.verdict === 'approved' || context.verdict === 'rejected') {
+                return { passed: true, gateType };
+            }
+            return {
+                passed: false,
+                gateType,
+                message: 'Verdict (approved or rejected) is required to proceed from this phase'
+            };
+        case 'manual':
+            // Manual gate: always passes
+            return { passed: true, gateType };
+        default:
+            // Unknown gate type - treat as manual (pass)
+            return { passed: true, gateType };
+    }
+}
+/**
+ * Format the workflow tracking section for a session file update
+ *
+ * @param params - Phase transition parameters
+ * @returns Markdown string for the workflow tracking section
+ *
+ * @example
+ * ```typescript
+ * const markdown = formatPhaseTransition({
+ *   workflowName: 'tdd',
+ *   fromPhase: 'red',
+ *   toPhase: 'green',
+ *   startedAt: '2026-01-13T14:00:00Z',
+ *   endedAt: '2026-01-13T14:30:00Z'
+ * });
+ * ```
+ */
+export function formatPhaseTransition(params) {
+    const { workflowName, fromPhase, toPhase, startedAt, endedAt } = params;
+    const duration = calculateDuration(startedAt, endedAt);
+    const now = new Date().toISOString();
+    // Build markdown for the workflow tracking section
+    const lines = [
+        `**Workflow:** ${workflowName}`,
+        `**Phase:** ${toPhase}`,
+        `**Phase Started:** ${now}`,
+        '',
+        '### Phase History',
+        '| Phase | Started | Ended | Duration |',
+        '|-------|---------|-------|----------|',
+        `| ${fromPhase} | ${startedAt} | ${endedAt} | ${duration} |`
+    ];
+    return lines.join('\n');
+}
+/**
+ * Calculate duration between two ISO 8601 timestamps
+ *
+ * @param startedAt - Start timestamp
+ * @param endedAt - End timestamp
+ * @returns Formatted duration string (e.g., "30m", "2h 30m", "45s")
+ */
+export function calculateDuration(startedAt, endedAt) {
+    const start = new Date(startedAt);
+    const end = new Date(endedAt);
+    // Handle invalid timestamps
+    if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+        return '0m';
+    }
+    const diffMs = Math.abs(end.getTime() - start.getTime());
+    const diffSeconds = Math.floor(diffMs / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    const diffHours = Math.floor(diffMinutes / 60);
+    // Format based on duration length
+    if (diffSeconds < 60) {
+        return `${diffSeconds}s`;
+    }
+    if (diffHours === 0) {
+        return `${diffMinutes}m`;
+    }
+    const remainingMinutes = diffMinutes % 60;
+    if (remainingMinutes === 0) {
+        return `${diffHours}h`;
+    }
+    return `${diffHours}h ${remainingMinutes}m`;
+}
+/**
+ * Read handoff mode from Cyclist settings file
+ * Returns 'manual' as default if file doesn't exist or is invalid
+ *
+ * @param settingsPath - Path to the settings file (JSON or YAML)
+ * @returns The handoff mode setting
+ */
+export function readHandoffMode(settingsPath) {
+    try {
+        if (!existsSync(settingsPath)) {
+            return 'manual';
+        }
+        const content = readFileSync(settingsPath, 'utf-8');
+        // Try JSON first, then YAML
+        if (settingsPath.endsWith('.json') || content.trim().startsWith('{')) {
+            return parseHandoffModeFromJson(content);
+        }
+        else {
+            return parseHandoffModeFromYaml(content);
+        }
+    }
+    catch {
+        return 'manual';
+    }
+}
+/**
+ * Parse handoff mode from JSON string
+ * Handles both new format (handoff_mode) and legacy format (auto_handoff boolean)
+ *
+ * @param jsonContent - JSON string containing settings
+ * @returns The handoff mode setting
+ */
+export function parseHandoffModeFromJson(jsonContent) {
+    try {
+        const parsed = JSON.parse(jsonContent);
+        const workflow = parsed?.workflow;
+        if (!workflow) {
+            return 'manual';
+        }
+        // New format: handoff_mode
+        if (workflow.handoff_mode === 'auto' || workflow.handoff_mode === 'manual') {
+            return workflow.handoff_mode;
+        }
+        // Legacy format: auto_handoff boolean
+        if ('auto_handoff' in workflow) {
+            return workflow.auto_handoff === true ? 'auto' : 'manual';
+        }
+        return 'manual';
+    }
+    catch {
+        return 'manual';
+    }
+}
+/**
+ * Parse handoff mode from YAML string
+ * Handles both new format (handoff_mode) and legacy format (auto_handoff boolean)
+ *
+ * @param yamlContent - YAML string containing settings
+ * @returns The handoff mode setting
+ */
+export function parseHandoffModeFromYaml(yamlContent) {
+    try {
+        // Simple YAML parsing for handoff_mode - look for the pattern
+        // workflow:
+        //   handoff_mode: auto|manual
+        const lines = yamlContent.split('\n');
+        let inWorkflow = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed === 'workflow:') {
+                inWorkflow = true;
+                continue;
+            }
+            if (inWorkflow) {
+                // Check for new format
+                const modeMatch = trimmed.match(/^handoff_mode:\s*['"]?(auto|manual)['"]?$/);
+                if (modeMatch) {
+                    return modeMatch[1];
+                }
+                // Check for legacy format
+                const autoMatch = trimmed.match(/^auto_handoff:\s*(true|false)$/i);
+                if (autoMatch) {
+                    return autoMatch[1].toLowerCase() === 'true' ? 'auto' : 'manual';
+                }
+                // Exit workflow section when we hit a non-indented line
+                if (!line.startsWith(' ') && !line.startsWith('\t') && trimmed !== '') {
+                    inWorkflow = false;
+                }
+            }
+        }
+        return 'manual';
+    }
+    catch {
+        return 'manual';
+    }
+}
+/**
+ * Get handoff behavior based on mode
+ *
+ * @param mode - The handoff mode setting
+ * @returns Behavior configuration for the mode
+ */
+export function getHandoffBehavior(mode) {
+    if (mode === 'auto') {
+        return {
+            action: 'immediate',
+            requiresConfirmation: false,
+        };
+    }
+    return {
+        action: 'prompt',
+        requiresConfirmation: true,
+        message: 'Ready for handoff. Confirm to proceed to next agent.',
+    };
+}
+/**
+ * Format handoff history entry for session file
+ * Creates a markdown section with table row for the handoff
+ *
+ * @param entry - Handoff history entry to format
+ * @returns Markdown string for the handoff history section
+ */
+export function formatHandoffHistory(entry) {
+    const lines = [
+        '## Handoff History',
+        '',
+        '| Phase | Agent | Timestamp | Mode |',
+        '|-------|-------|-----------|------|',
+        `| ${entry.phase} | ${entry.agent} | ${entry.timestamp} | ${entry.handoffMode} |`,
+    ];
+    return lines.join('\n');
+}
+// =============================================================================
+// Context Clear Signal (Story MSSCI-11840)
+// =============================================================================
+/**
+ * Threshold for context percentage to trigger context clear
+ * When auto mode is enabled and context exceeds this threshold, emit CONTEXT_CLEAR
+ */
+export const CONTEXT_CLEAR_THRESHOLD = 60;
+/**
+ * Determine if CONTEXT_CLEAR marker should be emitted
+ *
+ * Returns true when:
+ * - handoffMode is 'auto'
+ * - contextPercent exceeds CONTEXT_CLEAR_THRESHOLD
+ *
+ * @param params - Context clear parameters
+ * @returns true if CONTEXT_CLEAR should be emitted
+ */
+export function shouldEmitContextClear(params) {
+    return params.handoffMode === 'auto' && params.contextPercent > CONTEXT_CLEAR_THRESHOLD;
+}
+/**
+ * Format the CYCLIST marker for context clear or regular handoff
+ *
+ * When auto mode and high context: returns CONTEXT_CLEAR marker
+ * Otherwise: returns regular HANDOFF marker
+ *
+ * @param params - Context clear parameters including nextAgent
+ * @returns Marker string (<!-- CYCLIST:CONTEXT_CLEAR:/agent --> or <!-- CYCLIST:HANDOFF:/agent -->)
+ */
+export function formatContextClearMarker(params) {
+    const { nextAgent = '/dev' } = params;
+    if (shouldEmitContextClear(params)) {
+        return `<!-- CYCLIST:CONTEXT_CLEAR:${nextAgent} -->`;
+    }
+    return `<!-- CYCLIST:HANDOFF:${nextAgent} -->`;
+}
+/**
+ * Format a human-readable output message for context clear handoffs
+ *
+ * Includes context percentage and the marker for Cyclist to detect
+ *
+ * @param params - Context clear parameters
+ * @returns Formatted output string for display
+ */
+export function formatContextClearOutput(params) {
+    const { contextPercent, nextAgent = '/dev' } = params;
+    const marker = formatContextClearMarker(params);
+    if (shouldEmitContextClear(params)) {
+        return `Context at ${contextPercent}% - emitting CONTEXT_CLEAR for automatic session clear and reload.\n\n${marker}`;
+    }
+    return `Handoff to ${nextAgent}\n\n${marker}`;
+}
+//# sourceMappingURL=handoff.js.map

package/packages/core/dist/workflow/handoff.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * Tests for Story 31-7: Workflow-Driven Handoff Subagent
+ *
+ * These tests define the contract for the handoff module that
+ * replaces 5 hardcoded handoff files (sm-handoff, tea-handoff, dev-handoff,
+ * reviewer-handoff-approve, reviewer-handoff-reject).
+ *
+ * The handoff module reads phase requirements from workflow definitions
+ * and performs gate checks based on phase gate type.
+ *
+ * Test categories:
+ * 1. findCurrentPhase() - Locate phase by name in workflow
+ * 2. getNextPhase() - Determine next phase (forward or rejection loop)
+ * 3. checkGate() - Run gate-specific checks
+ * 4. formatPhaseTransition() - Format session file updates
+ * 5. Integration - Full handoff scenarios with TDD/trivial workflows
+ *
+ * Run with: npm test
+ */
+export {};
+//# sourceMappingURL=handoff.test.d.ts.map

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

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