@pennyfarthing/core 7.4.0 → 7.5.0

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

@@ -1,281 +0,0 @@
-/**
- * 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;
-/**
- * Threshold for context percentage to trigger context clear
- * When auto mode is enabled and context exceeds this threshold, emit CONTEXT_CLEAR
- */
-export declare const CONTEXT_CLEAR_THRESHOLD = 60;
-/**
- * Parameters for context clear marker decision
- */
-export interface ContextClearParams {
-    /** Current handoff mode from settings */
-    handoffMode: HandoffMode;
-    /** Current context usage percentage (0-100) */
-    contextPercent: number;
-    /** Next agent to load after clear (for marker value) */
-    nextAgent?: string;
-}
-/**
- * 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 declare function shouldEmitContextClear(params: ContextClearParams): boolean;
-/**
- * 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 declare function formatContextClearMarker(params: ContextClearParams): string;
-/**
- * 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 declare function formatContextClearOutput(params: ContextClearParams): string;
-//# sourceMappingURL=generic-handoff.d.ts.map

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

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

package/dist/workflow/generic-handoff.js

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