@pennyfarthing/core 6.6.0

package/packages/core/dist/workflow/generic-handoff.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Generic 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 type { WorkflowDefinition, WorkflowPhase } from './workflow-schema.js';
+/**
+ * Context for gate checks - provides test results, verdicts, etc.
+ */
+export interface GateContext {
+    /** For tests_fail gate: are tests currently failing? */
+    testsRed?: boolean;
+    /** For tests_pass gate: are all tests passing? */
+    testsGreen?: boolean;
+    /** Number of passing tests */
+    testPassCount?: number;
+    /** Number of failing tests */
+    testFailCount?: number;
+    /** For approval gate: approved or rejected */
+    verdict?: 'approved' | 'rejected';
+}
+/**
+ * Options for getNextPhase to handle rejection loops
+ */
+export interface NextPhaseOptions {
+    /** For approval gates: determines forward vs loop-back */
+    verdict?: 'approved' | 'rejected';
+}
+/**
+ * Result of checking a gate condition
+ */
+export interface GateCheckResult {
+    /** Whether the gate check passed */
+    passed: boolean;
+    /** Gate type that was checked (undefined if phase has no gate) */
+    gateType?: string;
+    /** Human-readable message (especially on failure) */
+    message?: string;
+}
+/**
+ * Context for handoff operations
+ */
+export interface HandoffContext {
+    /** Story ID being worked on */
+    storyId: string;
+    /** Current workflow name */
+    workflowName: string;
+    /** Current phase name */
+    currentPhase: string;
+    /** Session file path */
+    sessionFile: string;
+}
+/**
+ * Result of a handoff operation
+ */
+export interface HandoffResult {
+    /** Whether handoff succeeded */
+    success: boolean;
+    /** Next phase to transition to */
+    nextPhase?: string;
+    /** Next agent to invoke */
+    nextAgent?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Parameters for formatting phase transition
+ */
+export interface PhaseTransitionParams {
+    workflowName: string;
+    fromPhase: string;
+    toPhase: string;
+    startedAt: string;
+    endedAt: string;
+    isRejection?: boolean;
+}
+/**
+ * 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 declare function findCurrentPhase(workflow: WorkflowDefinition, phaseName: string): WorkflowPhase | 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 declare function getNextPhase(workflow: WorkflowDefinition, currentPhaseName: string, options?: NextPhaseOptions): WorkflowPhase | 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 declare function checkGate(workflow: WorkflowDefinition, phaseName: string, context: GateContext): GateCheckResult;
+/**
+ * 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 declare function formatPhaseTransition(params: PhaseTransitionParams): string;
+/**
+ * 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 declare function calculateDuration(startedAt: string, endedAt: string): string;
+/**
+ * Handoff mode type - auto triggers immediately, manual prompts first
+ */
+export type HandoffMode = 'auto' | 'manual';
+/**
+ * Handoff behavior based on mode
+ */
+export interface HandoffBehavior {
+    /** What action to take */
+    action: 'immediate' | 'prompt';
+    /** Whether user confirmation is required */
+    requiresConfirmation: boolean;
+    /** Message to show user (for prompt action) */
+    message?: string;
+}
+/**
+ * Entry for handoff history tracking
+ */
+export interface HandoffHistoryEntry {
+    phase: string;
+    agent: string;
+    timestamp: string;
+    handoffMode: HandoffMode;
+}
+/**
+ * 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 declare function readHandoffMode(settingsPath: string): HandoffMode;
+/**
+ * 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 declare function parseHandoffModeFromJson(jsonContent: string): HandoffMode;
+/**
+ * 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 declare function parseHandoffModeFromYaml(yamlContent: string): HandoffMode;
+/**
+ * Get handoff behavior based on mode
+ *
+ * @param mode - The handoff mode setting
+ * @returns Behavior configuration for the mode
+ */
+export declare function getHandoffBehavior(mode: HandoffMode): HandoffBehavior;
+/**
+ * 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 declare function formatHandoffHistory(entry: HandoffHistoryEntry): string;
+//# sourceMappingURL=generic-handoff.d.ts.map

package/packages/core/dist/workflow/generic-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-handoff.d.ts","sourceRoot":"","sources":["../../src/workflow/generic-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAKtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAC5B,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,GAAG,IAAI,CAoCtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,eAAe,CA2DjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAkB3E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA6B5E;AAMD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,4CAA4C;IAC5C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAgBjE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAuBzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAyCzE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAarE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAUvE"}

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

@@ -0,0 +1,358 @@
+/**
+ * Generic 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');
+}
+//# sourceMappingURL=generic-handoff.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Tests for Story 31-7: Generic Workflow-Driven Handoff Subagent
+ *
+ * These tests define the contract for the generic handoff module that
+ * replaces 5 hardcoded handoff files (sm-handoff, tea-handoff, dev-handoff,
+ * reviewer-handoff-approve, reviewer-handoff-reject).
+ *
+ * The generic handoff 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=generic-handoff.test.d.ts.map

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

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