Add poe2arb upload for syncing local ARB changes with POEditor

[Albert221]

Summary

Adds a new poe2arb upload subcommand that synchronizes local ARB file changes back to POEditor. Unlike seed (which is meant for one-shot first-time imports and deliberately never overwrites), upload is intended for the day-to-day workflow of pushing local ARB edits to POEditor — including changes to terms that already exist remotely.

Behavior

1. Lists project terms via /terms/list (asking for the template language so we can show translations as a preview).
2. Compares them with the terms in the local template ARB file.
3. If any terms exist remotely but not locally, the command prints the orphan terms (with their template-language values when available) and aborts:

   • the following 2 term(s) exist in POEditor but not in local ARB files:
     • - obsoleteTerm = "no longer used"
     • - anotherOldOne
   • aborting. Re-run with --force to delete these terms from POEditor and continue the upload.
   

   Re-running with --force deletes them via /terms/delete and proceeds.
4. Adds missing project languages (same as seed).
5. Uploads each ARB to POEditor with overwrite=1, template language first so term definitions get registered before non-template translations come in. Same paid/free rate-limit handling as seed.

Design notes

• Term deletion uses /terms/delete with an explicit list rather than the upload endpoint's sync_terms=1. The latter deletes every term in the project that's not in the upload, which would silently wipe terms belonging to other prefixes (sibling packages in a multi-package POE project). The explicit-list approach respects the existing --term-prefix scoping: termInPrefixScope only flags remote terms whose prefix matches the local one for deletion.
• The fuzzy-trigger flag is intentionally not sent — translations get overwritten as-is without disturbing fuzzy state.
• The existing Client.Upload signature was extended to take an UploadOptions{Overwrite} struct; seed uses the zero value, preserving its non-destructive default.

Tests

• New poeditor/client_test.go covers ListTerms (with translation parsing for both string and plural-object content forms), DeleteTerms (incl. empty-input no-op), Upload (overwrite=0/overwrite=1/rate-limit error propagation), GetProjectLanguages, and AddLanguage against an httptest.Server mock.
• New cmd/upload_test.go covers the prefix-scope diff logic (termInPrefixScope, termsToDelete), template-ARB term parsing (readLocalTermNames), and ARB-file discovery / template ordering helpers.

Test plan

• go build ./...
• go test ./...
• go tool staticcheck -checks=all ./...
• go tool gofumpt -d clean
• Manual smoke test against a real POE project — run poe2arb upload (expect abort listing orphan terms), then poe2arb upload --force (expect deletion + overwriting upload).

README

Adds a new "Synchronizing local ARB changes with POEditor" section under Usage, documenting the workflow, the --force flag, and the prefix-scope safety guarantee.

---

Generated by Claude Code