[plan] Review and decide on small helper files (map_helpers, git_helpers)

[github-actions]

Objective

Review very small helper files and decide whether to keep them for future growth or merge them into related files.

Context

Two helper files contain minimal functions:

• map_helpers.go (2 functions) - Map manipulation utilities
• git_helpers.go (1 function) - Git utilities

These files may be:

• Kept for future expansion as more helpers are added
• Merged into more general utility files
• Moved to appropriate packages (e.g., git_helpers.go → pkg/gitutil)

Approach

1. Analyze map_helpers.go:

   • Review the 2 functions and their usage across the codebase
   • Determine if more map helpers are likely to be added
   • Decision: Keep for growth OR merge into general utilities

2. Analyze git_helpers.go:

   • Review the single function and its purpose
   • Check if it belongs in pkg/gitutil package
   • Check if more Git helpers are needed
   • Decision: Keep for growth OR move to pkg/gitutil OR merge elsewhere

3. Document decision:

   • If keeping: Add file header explaining purpose and future use
   • If merging: Move functions and update imports
   • If moving to pkg/gitutil: Relocate and update imports

4. Verify no breakage:

   • Run all tests after any changes
   • Ensure imports are correctly updated

Files to Review

• pkg/workflow/map_helpers.go (2 functions)
• pkg/workflow/git_helpers.go (1 function)
• Potentially: pkg/gitutil/ (target for git_helpers)

Acceptance Criteria

• map_helpers.go reviewed with documented decision
• git_helpers.go reviewed with documented decision
• If keeping: File headers added explaining purpose
• If merging/moving: Functions relocated and imports updated
• All tests pass (make test)
• Decision rationale documented in commit message
  Related to [refactor] Semantic Function Clustering Analysis - Code Organization Opportunities #7136

AI generated by Plan Command for #7136