@pennyfarthing/core 7.5.0 → 7.6.1

package/packages/core/dist/workflow/generic-sm-setup.js.map

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

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

@@ -0,0 +1,281 @@
+/**
+ * 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=handoff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/workflow/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;AAMD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAE1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAQ3E;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAS3E"}