Walkthrough

This PR introduces a data-driven patch system with filtering capabilities, expanding CLI options to include --patches, --list-patches, and --list-system-prompt-patches for managing patch selection and enumeration. The patch application flow now propagates an optional filter through patch and system prompt processing.

Changes

Sequence Diagram(s)

sequenceDiagram
    actor User
    participant CLI as CLI Handler
    participant ApplyFn as applyCustomization()
    participant PatchImpl as Patch Implementations
    participant SysPrompt as applySystemPrompts()
    participant Config as Config Writer

    User->>CLI: Invoke with --patches [filter]
    CLI->>ApplyFn: Call with patchFilter
    ApplyFn->>PatchImpl: Apply patches (data-driven)
    PatchImpl->>PatchImpl: Check patchFilter, skip if not matching
    PatchImpl-->>ApplyFn: Return results (applied/skipped)
    ApplyFn->>SysPrompt: Apply prompts with patchFilter
    SysPrompt->>SysPrompt: Check patchFilter, skip non-matching
    SysPrompt-->>ApplyFn: Return prompt results
    ApplyFn->>Config: Write updated config
    Config-->>ApplyFn: Success
    ApplyFn-->>CLI: Return ApplyCustomizationResult
    CLI->>CLI: printPatchResults(results, patchFilter)
    CLI-->>User: Display filtered results

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• Redesign --apply output #433: Builds on the same PatchResult/ApplyCustomizationResult infrastructure and extends it with data-driven PATCH_DEFINITIONS, patch filtering, and CLI option integration.
• Simplify the user message display patch #429: Modifies src/patches/index.ts patch application code; the main PR's restructuring of patches into definitions impacts how individual patches like user-message-display are invoked.
• Remove interactive apply in favor of more detailed --apply #434: Overlaps on CLI/apply flow modifications in src/index.tsx, adding patch filtering and --list-* handlers alongside apply signature changes.

Poem

🐰 Patches now dance in data's array,
Filtered flows light up the way,
Lists appear with --patches command,
System prompts, oh so grand!
From chaos blooms a tidy land! ✨

• 📝 Generate docstrings

• X
• Mastodon
• Reddit
• LinkedIn