Codeman/src/utils/regex-patterns.ts

/**
 * @fileoverview Shared regex patterns for terminal and token parsing.
 *
 * Pre-compiled patterns avoid re-compilation overhead on each use.
 * Import these patterns instead of defining them locally.
 *
 * @module utils/regex-patterns
 */

/**
 * Comprehensive ANSI escape pattern that handles:
 * - SGR (colors/styles): ESC [ params m
 * - CSI sequences (cursor, scroll, etc.): ESC [ params letter
 * - OSC sequences (title, etc.): ESC ] ... BEL or ESC ] ... ST
 * - Single-char escapes: ESC = or ESC >
 *
 * Use this when you need complete ANSI stripping including OSC sequences.
 * Note: Has global flag - reset lastIndex before exec() if reusing.
 */
// eslint-disable-next-line no-control-regex
export const ANSI_ESCAPE_PATTERN_FULL = /\x1b(?:\[[0-9;?]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|[=>])/g;

/**
 * Simple ANSI CSI-only pattern for basic escape code stripping.
 * Matches: ESC [ params letter (e.g., colors, cursor movement)
 *
 * Use this for faster stripping when OSC sequences aren't a concern.
 * Note: Has global flag - reset lastIndex before exec() if reusing.
 */
// eslint-disable-next-line no-control-regex
export const ANSI_ESCAPE_PATTERN_SIMPLE = /\x1b\[[0-9;]*[A-Za-z]/g;

/**
 * Pattern to extract token count from Claude's status line.
 * Matches: "123.4k tokens", "5234 tokens", "1.2M tokens"
 *
 * Capture groups:
 * - Group 1: The numeric value (e.g., "123.4", "5234", "1.2")
 * - Group 2: Optional suffix (k, K, m, M) or undefined
 */
export const TOKEN_PATTERN = /(\d+(?:\.\d+)?)\s*([kKmM])?\s*tokens/;

/**
 * Strips ANSI escape codes from text using the comprehensive pattern.
 * @param text - Text containing ANSI escape codes
 * @returns Text with ANSI codes removed
 */
export function stripAnsi(text: string): string {
  return text.replace(ANSI_ESCAPE_PATTERN_FULL, '');
}

/**
 * Regex to validate safe file paths (no shell metacharacters).
 * Shared by schemas.ts and tmux-manager.ts for consistent path validation.
 */
/**
 * Braille spinner characters used by Claude Code's Ink UI.
 * Matches any of: ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧
 * Used on the hot path (every PTY chunk) — pre-compiled for performance.
 */
export const SPINNER_PATTERN = /[⠋⠙⠹⠸⠼⠴⠦⠧]/;

/**
 * Claude Code's live working status line, e.g.
 *   `✻ Actualizing… (13m 23s · ↓ 47.5k tokens)`
 *   `✽ Herding… (3s · esc to interrupt)`
 *
 * Matched on the ELLIPSIS + elapsed timer, never on the leading glyph: the
 * animation cycles through `· ✢ ✳ ∗ ✻ ✽` (two of those are ordinary punctuation)
 * and the gerund is randomized per turn, while the finished line (`✻ Cooked for
 * 2m 49s`) carries the same glyph with no `…` and no parenthesis. Feed this
 * ANSI-STRIPPED data: tmux colours the timer separately, so the raw stream has
 * escape sequences sitting between the `…` and the `(`.
 *
 * A sighting is proof the pane is working; its ABSENCE proves nothing, because
 * tmux repaints partially and the whole line reaches the PTY only occasionally
 * (see `session-activity.ts` for what carries the idle decision instead).
 */
export const CLAUDE_WORKING_LINE_PATTERN = /…\s*\((?:\d+h\s+)?(?:\d+m\s+)?\d+s\b|esc to interrupt/;

export const SAFE_PATH_PATTERN = /^[\p{L}\p{N}_/\-. ~]+$/u;

/**
 * Execute a global regex pattern against data, calling the callback for each match.
 * Automatically resets lastIndex before execution.
 */
export function execPattern(pattern: RegExp, data: string, callback: (match: RegExpExecArray) => void): void {
  pattern.lastIndex = 0;
  let match: RegExpExecArray | null;
  while ((match = pattern.exec(data)) !== null) {
    callback(match);
  }
}