Extend localization sync command to support return reasons

[ricardotejedorsanz]

This PR enhances the existing sync_en_localizations command to support return reasons, enabling automatic synchronization of English translations from the data files to the localization files.

Command usage:

# Sync only return reasons
bundle exec ./bin/product_taxonomy sync_en --target return_reasons

# Sync all targets (categories, attributes, values, return_reasons)
bundle exec ./bin/product_taxonomy sync_en

What it does:

1. Reads return reasons from data/return_reasons.yml
2. Extracts translatable fields (name, description)
3. Generates English localization entries
4. Writes to data/localizations/return_reasons/en.yml
5. Maintains consistent format with categories and attributes localizations

Why this matters:

• Establishes the foundation for multi-locale support
• Ensures English localizations stay in sync with data changes
• Follows the same pattern as categories/attributes localization
• Prepares for future Smartling integration (long-term localization strategy)

Localization file structure:

---
en:
  return_reasons:
    changed-my-mind:
      name: Changed my mind
      description: Buyer changed their mind about the purchase
    item-not-as-described:
      name: Item not as described
      description: Product did not match description or expectations

Localization strategy:
With open-sourcing, return reasons should follow the same localization workflow as taxonomy fields through the public repo. Long-term, this means:

• Return reasons translations happen during taxonomy release preparation for the public repo
• Merchants can view localized versions and suggest translation fixes in the public repository

However, for the initial batch rollout, we suggest to use a pragmatic approach:

• Use TP in Core (as originally planned)
• Reproduce the localized files in the public repo format
• Avoids blocking rollout timelines due to translation turnaround + ongoing platform migration setup work

Design decisions:

• Added return_reasons as a valid target alongside categories, attributes, values
• Uses the existing localizations_serializer.rb for consistent output
• This PR establishes English localization sync; for V1, additional locale files will be added manually in follow-up PRs once translations are ready in Core
• Command maintains backward compatibility (existing targets unaffected)

Review notes:

• Minimal changes to sync_en_localizations_command.rb: adds return_reasons case
• May include changes to command.rb if shared localization logic was extracted
• The localization file was already created in PR 1, this command keeps it synchronized
• Important for the long-term localization workflow: this establishes the pattern for future locale additions

Files to Include

• dev/lib/product_taxonomy/commands/sync_en_localizations_command.rb
• dev/lib/product_taxonomy/commands/command.rb (if there are shared changes)

Dependencies

• PR 1 (requires return reasons localization data)

Review Focus

• Localization sync logic
• Support for return reasons
• Command improvements

[ricardotejedorsanz]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Add CLI command for return reasons #791 : 2 dependent PRs (#794 , #802 )
• Extend localization sync command to support return reasons #795 👈 (View in Graphite)
• Implement return reasons model and distribution pipeline #790 : 1 other dependent PR (#792 )
• Add return reasons data and category mappings #789
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.