@pennyfarthing/cyclist 10.4.0 → 11.0.0

package/src/public/hooks/usePlanModeExit.ts

@@ -1,105 +0,0 @@
-/**
- * usePlanModeExit - Smooth plan mode exit with tirepump choice
- *
- * Story: MSSCI-14327
- *
- * Handles the transition from plan mode to accept mode after plan approval,
- * and offers the user a choice to tirepump (commit/push) changes.
- */
-
-import { useState, useCallback } from 'react';
-import type { Mode } from '../components/ModeSwitch/index';
-
-/** The Claude CLI mode to transition to after plan exit */
-export const PLAN_EXIT_MODE = 'acceptEdits';
-
-export interface PlanModeExitOptions {
-  currentMode: Mode;
-  setMode: (mode: Mode) => void;
-  approved: boolean;
-  wsConnected?: boolean;
-}
-
-export interface TirepumpOption {
-  action: 'tirepump' | 'continue';
-  label: string;
-}
-
-export interface PlanModeExitResult {
-  showTirepumpChoice: boolean;
-  options?: TirepumpOption[];
-  localOnly?: boolean;
-}
-
-export interface TirepumpChoiceOptions {
-  choice: 'tirepump' | 'continue';
-  currentAgent?: string;
-  setMode?: (mode: Mode) => void;
-  onContextClear?: (data: { agent: string }) => void;
-}
-
-export interface TirepumpChoiceResult {
-  contextCleared: boolean;
-  action: 'tirepump' | 'continue';
-}
-
-const TIREPUMP_OPTIONS: TirepumpOption[] = [
-  { action: 'tirepump', label: 'Commit & push changes' },
-  { action: 'continue', label: 'Continue without committing' },
-];
-
-export async function handlePlanModeExit(
-  options: PlanModeExitOptions
-): Promise<PlanModeExitResult> {
-  const { currentMode, setMode, approved, wsConnected } = options;
-
-  if (!approved) {
-    return { showTirepumpChoice: false };
-  }
-
-  // Transition from plan to accept if not already there
-  if (currentMode !== 'accept') {
-    setMode('accept');
-  }
-
-  const localOnly = wsConnected === false;
-
-  return {
-    showTirepumpChoice: true,
-    options: TIREPUMP_OPTIONS,
-    ...(localOnly && { localOnly: true }),
-  };
-}
-
-export async function handleTirepumpChoice(
-  options: TirepumpChoiceOptions
-): Promise<TirepumpChoiceResult> {
-  const { choice, currentAgent, onContextClear } = options;
-
-  if (choice === 'tirepump') {
-    onContextClear?.({ agent: currentAgent ?? '' });
-    return { contextCleared: true, action: 'tirepump' };
-  }
-
-  return { contextCleared: false, action: 'continue' };
-}
-
-export function usePlanModeExit() {
-  const [showChoice, setShowChoice] = useState(false);
-  const [exitResult, setExitResult] = useState<PlanModeExitResult | null>(null);
-
-  const exitPlanMode = useCallback(async (options: PlanModeExitOptions) => {
-    const result = await handlePlanModeExit(options);
-    setExitResult(result);
-    setShowChoice(result.showTirepumpChoice);
-    return result;
-  }, []);
-
-  const chooseTirepump = useCallback(async (options: TirepumpChoiceOptions) => {
-    const result = await handleTirepumpChoice(options);
-    setShowChoice(false);
-    return result;
-  }, []);
-
-  return { showChoice, exitResult, exitPlanMode, chooseTirepump };
-}

package/src/public/hooks/useResponsiveLayout.ts

@@ -1,173 +0,0 @@
-/**
- * useResponsiveLayout - Responsive breakpoint detection hook
- *
- * Story MSSCI-12770: Responsive Breakpoints
- *
- * Provides:
- * - Breakpoint detection (small <1024, medium 1024-1440, large >1440)
- * - Sidebar width recommendations
- * - Minimum dimension violation detection
- * - Resize event handling
- */
-
-import { useState, useEffect, useCallback } from 'react';
-
-// =============================================================================
-// Constants
-// =============================================================================
-
-/**
- * Breakpoint thresholds in pixels
- */
-export const BREAKPOINTS = {
-  small: 1024,  // < 1024px
-  large: 1440,  // >= 1440px
-} as const;
-
-/**
- * Sidebar widths for each breakpoint
- */
-export const SIDEBAR_WIDTHS = {
-  medium: 300,  // Default width
-  large: 400,   // Expanded width for large screens
-} as const;
-
-/**
- * Minimum supported dimensions
- */
-export const MIN_DIMENSIONS = {
-  width: 800,
-  height: 600,
-} as const;
-
-/**
- * CSS custom property names for breakpoints
- */
-export const CSS_BREAKPOINT_VARS = '--breakpoint-small: 1024px; --breakpoint-large: 1440px;';
-
-/**
- * Media query strings for CSS-in-JS usage
- */
-export const MEDIA_QUERIES = {
-  small: '(max-width: 1023px)',
-  medium: '(min-width: 1024px) and (max-width: 1439px)',
-  large: '(min-width: 1440px)',
-} as const;
-
-// =============================================================================
-// Types
-// =============================================================================
-
-export type Breakpoint = 'small' | 'medium' | 'large';
-
-export interface MinimumViolation {
-  width: boolean;
-  height: boolean;
-}
-
-export interface ResponsiveLayoutState {
-  /** Current breakpoint based on window width */
-  breakpoint: Breakpoint;
-  /** True if width < 1024px */
-  isSmall: boolean;
-  /** True if width >= 1024px and < 1440px */
-  isMedium: boolean;
-  /** True if width >= 1440px */
-  isLarge: boolean;
-  /** Current window width */
-  width: number;
-  /** Current window height */
-  height: number;
-  /** Recommended sidebar width for current breakpoint */
-  sidebarWidth: number;
-  /** True if either dimension is below minimum */
-  isBelowMinimum: boolean;
-  /** Which dimensions violate minimums */
-  minimumViolation: MinimumViolation;
-}
-
-// =============================================================================
-// Helper Functions
-// =============================================================================
-
-/**
- * Determine breakpoint from width
- */
-function getBreakpoint(width: number): Breakpoint {
-  if (width < BREAKPOINTS.small) {
-    return 'small';
-  }
-  if (width >= BREAKPOINTS.large) {
-    return 'large';
-  }
-  return 'medium';
-}
-
-/**
- * Get sidebar width for breakpoint
- */
-function getSidebarWidth(breakpoint: Breakpoint): number {
-  if (breakpoint === 'large') {
-    return SIDEBAR_WIDTHS.large;
-  }
-  return SIDEBAR_WIDTHS.medium;
-}
-
-/**
- * Check minimum dimension violations
- */
-function checkMinimumViolation(width: number, height: number): MinimumViolation {
-  return {
-    width: width < MIN_DIMENSIONS.width,
-    height: height < MIN_DIMENSIONS.height,
-  };
-}
-
-// =============================================================================
-// Hook
-// =============================================================================
-
-/**
- * React hook for responsive layout detection
- *
- * Detects current breakpoint based on window dimensions and provides
- * utilities for responsive behavior.
- */
-export function useResponsiveLayout(): ResponsiveLayoutState {
-  const getWindowDimensions = useCallback(() => {
-    return {
-      width: typeof window !== 'undefined' ? window.innerWidth : 1200,
-      height: typeof window !== 'undefined' ? window.innerHeight : 800,
-    };
-  }, []);
-
-  const [dimensions, setDimensions] = useState(getWindowDimensions);
-
-  useEffect(() => {
-    const handleResize = () => {
-      setDimensions(getWindowDimensions());
-    };
-
-    window.addEventListener('resize', handleResize);
-    return () => {
-      window.removeEventListener('resize', handleResize);
-    };
-  }, [getWindowDimensions]);
-
-  const breakpoint = getBreakpoint(dimensions.width);
-  const minimumViolation = checkMinimumViolation(dimensions.width, dimensions.height);
-
-  return {
-    breakpoint,
-    isSmall: breakpoint === 'small',
-    isMedium: breakpoint === 'medium',
-    isLarge: breakpoint === 'large',
-    width: dimensions.width,
-    height: dimensions.height,
-    sidebarWidth: getSidebarWidth(breakpoint),
-    isBelowMinimum: minimumViolation.width || minimumViolation.height,
-    minimumViolation,
-  };
-}
-
-export default useResponsiveLayout;

package/src/public/hooks/useSprint.ts

@@ -1,147 +0,0 @@
-/**
- * useSprint Hook
- *
- * React hook for subscribing to sprint data.
- * Story MSSCI-14189 - Enhanced Sprint Panel
- *
- * Uses WebSocket /ws/sprint for real-time updates.
- */
-
-import { useState, useEffect, useRef } from 'react';
-
-// =============================================================================
-// Types matching EnhancedSprintPanel expectations
-// =============================================================================
-
-export interface SprintStory {
-  id: string;
-  title: string;
-  points: number;
-  status: 'backlog' | 'in_progress' | 'done' | 'cancelled' | 'blocked';
-  jiraKey: string | null;
-  hasContext?: boolean;
-  assignedTo?: string | null;
-  completed?: string | null;
-  started?: string | null;
-  workflow?: string | null;
-  priority?: string | null;
-  description?: string | null;
-}
-
-export interface SprintEpic {
-  id: string;
-  title: string;
-  jiraKey: string | null;
-  stories: SprintStory[];
-  hasContext?: boolean;
-}
-
-export interface FutureEpic {
-  id: string;
-  title: string;
-  description: string;
-  estimatedPoints: number;
-  status: 'ready' | 'blocked' | 'planning';
-}
-
-export interface SprintData {
-  currentStory: SprintStory | null;
-  nextStory: SprintStory | null;
-  epics: SprintEpic[];
-  futureEpics: FutureEpic[];
-  sprint: {
-    number: number;
-    name: string;
-    done: number;
-    remaining: number;
-    inProgress: number;
-    endDate: string;
-  };
-}
-
-interface UseSprintResult {
-  data: SprintData | null;
-  isLoading: boolean;
-  error: Error | null;
-}
-
-/** WebSocket message format from /ws/sprint */
-interface SprintMessage extends Partial<SprintData> {
-  type: 'init' | 'update';
-}
-
-export function useSprint(): UseSprintResult {
-  const [data, setData] = useState<SprintData | null>(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-  const wsRef = useRef<WebSocket | null>(null);
-  const reconnectTimeoutRef = useRef<ReturnType<typeof setTimeout>>();
-  const isMountedRef = useRef(true);
-
-  useEffect(() => {
-    const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
-    const wsUrl = `${protocol}//${window.location.host}/ws/sprint`;
-
-    const connect = () => {
-      // Don't reconnect if component has unmounted
-      if (!isMountedRef.current) {
-        return;
-      }
-
-      try {
-        wsRef.current = new WebSocket(wsUrl);
-
-        wsRef.current.onopen = () => {
-          console.debug('[useSprint] WebSocket connected');
-        };
-
-        wsRef.current.onmessage = (event) => {
-          try {
-            const msg = JSON.parse(event.data) as SprintMessage;
-            if (msg.type === 'init' || msg.type === 'update') {
-              // Extract data, excluding type field
-              const { type: _type, ...sprintData } = msg;
-              setData((prev) => {
-                if (!prev) return sprintData as SprintData;
-                // Merge partial updates
-                return { ...prev, ...sprintData } as SprintData;
-              });
-              setIsLoading(false);
-              setError(null);
-            }
-          } catch (err) {
-            console.error('[useSprint] Failed to parse message:', err);
-          }
-        };
-
-        wsRef.current.onclose = () => {
-          console.debug('[useSprint] WebSocket closed, reconnecting...');
-          reconnectTimeoutRef.current = setTimeout(connect, 2000);
-        };
-
-        wsRef.current.onerror = (err) => {
-          console.error('[useSprint] WebSocket error:', err);
-          setError(new Error('WebSocket connection failed'));
-        };
-      } catch (err) {
-        console.error('[useSprint] WebSocket init failed:', err);
-        setError(err instanceof Error ? err : new Error('Failed to connect'));
-        setIsLoading(false);
-      }
-    };
-
-    connect();
-
-    return () => {
-      isMountedRef.current = false;
-      if (reconnectTimeoutRef.current) {
-        clearTimeout(reconnectTimeoutRef.current);
-      }
-      if (wsRef.current) {
-        wsRef.current.close();
-      }
-    };
-  }, []);
-
-  return { data, isLoading, error };
-}

package/src/public/hooks/useStatsStrip.ts

@@ -1,204 +0,0 @@
-/**
- * useStatsStrip Hook
- *
- * React hook for fetching and subscribing to stats strip data.
- * Story MSSCI-12699 - StatsStrip Component
- *
- * IPC DEPRECATED - Now uses WebSocket for all data:
- * - /ws/context: Context percentage, used/total tokens
- * - /ws/stats: Model name
- * - /api/identity: PWD, Jira email, GitHub username (REST, fetched once)
- */
-
-import { useState, useEffect, useCallback, useRef } from 'react';
-
-export interface ContextData {
-  percent: number;
-  used?: number;
-  total?: number;
-}
-
-export interface StatsData {
-  model: string | null;
-}
-
-export interface ProjectInfoData {
-  pwd: string;
-  jiraEmail: string | null;
-  githubUsername: string | null;
-}
-
-interface UseStatsStripResult {
-  context: ContextData | null;
-  stats: StatsData | null;
-  projectInfo: ProjectInfoData | null;
-  isLoading: boolean;
-  error: Error | null;
-}
-
-const WS_RECONNECT_DELAY = 2000;
-
-export function useStatsStrip(): UseStatsStripResult {
-  const [context, setContext] = useState<ContextData | null>(null);
-  const [stats, setStats] = useState<StatsData | null>(null);
-  const [projectInfo, setProjectInfo] = useState<ProjectInfoData | null>(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-
-  // Track load state for each source
-  const loadStateRef = useRef({
-    context: false,
-    stats: false,
-    projectInfo: false,
-  });
-
-  const checkLoadComplete = useCallback(() => {
-    const state = loadStateRef.current;
-    if (state.context && state.stats && state.projectInfo) {
-      setIsLoading(false);
-    }
-  }, []);
-
-  // WebSocket for /ws/context
-  useEffect(() => {
-    let ws: WebSocket | null = null;
-    let reconnectTimer: ReturnType<typeof setTimeout> | null = null;
-    let mounted = true;
-
-    const connect = () => {
-      const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
-      ws = new WebSocket(`${protocol}//${window.location.host}/ws/context`);
-
-      ws.onopen = () => {
-        console.log('[useStatsStrip] Context WebSocket connected');
-      };
-
-      ws.onmessage = (event) => {
-        try {
-          const data = JSON.parse(event.data);
-          if (data.type === 'init' || data.type === 'update') {
-            const ctx = data.context;
-            if (ctx) {
-              setContext({
-                percent: ctx.percent ?? 0,
-                used: ctx.tokens ?? undefined,
-                total: ctx.available ? (ctx.tokens ?? 0) + ctx.available : undefined,
-              });
-            }
-            if (!loadStateRef.current.context) {
-              loadStateRef.current.context = true;
-              checkLoadComplete();
-            }
-          }
-        } catch (err) {
-          console.error('[useStatsStrip] Failed to parse context message:', err);
-        }
-      };
-
-      ws.onclose = () => {
-        if (mounted) {
-          reconnectTimer = setTimeout(connect, WS_RECONNECT_DELAY);
-        }
-      };
-
-      ws.onerror = (err) => {
-        console.error('[useStatsStrip] Context WebSocket error:', err);
-        ws?.close();
-      };
-    };
-
-    connect();
-
-    return () => {
-      mounted = false;
-      if (reconnectTimer) clearTimeout(reconnectTimer);
-      ws?.close();
-    };
-  }, [checkLoadComplete]);
-
-  // WebSocket for /ws/stats
-  useEffect(() => {
-    let ws: WebSocket | null = null;
-    let reconnectTimer: ReturnType<typeof setTimeout> | null = null;
-    let mounted = true;
-
-    const connect = () => {
-      const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
-      ws = new WebSocket(`${protocol}//${window.location.host}/ws/stats`);
-
-      ws.onopen = () => {
-        console.log('[useStatsStrip] Stats WebSocket connected');
-      };
-
-      ws.onmessage = (event) => {
-        try {
-          const data = JSON.parse(event.data);
-          // Stats sends data directly (not wrapped in type)
-          setStats({ model: data.model ?? null });
-          // Also extract pwd from stats (updated on Bash tool completions)
-          if (data.pwd) {
-            setProjectInfo(prev => ({
-              pwd: data.pwd,
-              jiraEmail: prev?.jiraEmail ?? null,
-              githubUsername: prev?.githubUsername ?? null,
-            }));
-          }
-          if (!loadStateRef.current.stats) {
-            loadStateRef.current.stats = true;
-            checkLoadComplete();
-          }
-        } catch (err) {
-          console.error('[useStatsStrip] Failed to parse stats message:', err);
-        }
-      };
-
-      ws.onclose = () => {
-        if (mounted) {
-          reconnectTimer = setTimeout(connect, WS_RECONNECT_DELAY);
-        }
-      };
-
-      ws.onerror = (err) => {
-        console.error('[useStatsStrip] Stats WebSocket error:', err);
-        ws?.close();
-      };
-    };
-
-    connect();
-
-    return () => {
-      mounted = false;
-      if (reconnectTimer) clearTimeout(reconnectTimer);
-      ws?.close();
-    };
-  }, [checkLoadComplete]);
-
-  // REST for /api/identity (jiraEmail, githubUsername - fetched once)
-  // pwd comes from /ws/stats (updated on Bash tool completions)
-  useEffect(() => {
-    const fetchIdentity = async () => {
-      try {
-        const response = await fetch('/api/identity');
-        if (response.ok) {
-          const data = await response.json();
-          // Merge with existing projectInfo (preserve pwd from stats)
-          setProjectInfo(prev => ({
-            pwd: prev?.pwd ?? '',
-            jiraEmail: data.jiraEmail ?? null,
-            githubUsername: data.githubUsername ?? null,
-          }));
-        }
-      } catch (err) {
-        console.error('[useStatsStrip] Failed to fetch identity:', err);
-        setError(err instanceof Error ? err : new Error('Failed to fetch identity'));
-      } finally {
-        loadStateRef.current.projectInfo = true;
-        checkLoadComplete();
-      }
-    };
-
-    fetchIdentity();
-  }, [checkLoadComplete]);
-
-  return { context, stats, projectInfo, isLoading, error };
-}