Walkthrough

This PR redesigns the patch application output system by introducing structured result types (PatchGroup enum, PatchResult interface, ApplyCustomizationResult), centralizing patch application logic into a unified patches array in applyCustomization, updating return types to include detailed patch results, and modifying display consumers to render and handle these results.

Changes

Sequence Diagram

sequenceDiagram
    participant CLI as CLI/App
    participant applyC as applyCustomization()
    participant patches as applyPatches()
    participant patch as Patch Execution
    participant result as Results Aggregator
    participant display as printPatchResults()

    CLI->>applyC: invoke with config
    applyC->>applyC: precompute common values
    applyC->>patches: call with patches array
    
    loop For each patch
        patches->>patch: execute patch function
        patch-->>result: record PatchResult<br/>(id, name, group, applied, details)
        result->>result: accumulate results
    end
    
    patches-->>applyC: return all results
    applyC->>applyC: update config with patches
    applyC-->>CLI: return ApplyCustomizationResult<br/>(config + results)
    
    CLI->>display: call printPatchResults(results)
    display->>display: group by PatchGroup
    display->>display: filter by isShowUnchanged
    display-->>CLI: render patch outcome

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related PRs

• Move patching helpers to helpers.ts #426 — Modifies src/patches/index.ts exports and public patching-related APIs with helper function refactoring, directly related to this PR's export changes.
• Fix all patches for CC 2.1.2 #352 — Touches patches subsystem and modifies src/patches/index.ts patch application code alongside individual patch implementations.
• Rework showDiff to use smart diffing; --show-unchanged; system prompt whitespace fix #424 — Modifies patch/results display and --show-unchanged feature, importing/exporting from same modules and symbols as this PR.

Poem

🐰 Patches once scattered, now unified and bright,
Results grouped neatly, displayed just right!
From function to function, the flow's redesigned,
Patch outcomes revealed—no details left behind! ✨

• 📝 Generate docstrings

• X
• Mastodon
• Reddit
• LinkedIn