PROD-2195 / PROD-2196: Fix hidden CLI flags in --help and correct README

[5PK]

Summary

Fixes PROD-2195 (CLI --help omits real flags) and PROD-2196 (README inaccurate/outdated for several pull & sync flags).

PROD-2195 — hidden flags in --help

Root cause: yargs silently hides any option whose alias array contains the option's own key. sourceGuid, targetGuid, overwrite, force, and autoPublish all listed their own name as an alias, so they never rendered in pull/push/sync help.

Additionally, update declared "reset" as an alias, colliding with the separate reset option — this hid --reset from help and overwrote --update's description with reset's text.

• Removed the self-referencing aliases (all other case/dash variants are kept and still work)
• Decoupled --reset from --update; moved the Reset/RESET case variants onto the reset option. Note: previously --reset also implied --update=true via the alias collision; they are now independent flags (pull and sync force update=true in their handlers anyway)
• Removed the dead targetGuid override in the push builder — it was defined before the ...systemArgs spread, which silently reverted its demandOption: true. The requirement is enforced in auth.validateCommand() after .env priming, so the documented AGILITY_TARGET_GUID fallback keeps working
• targetGuid help text now mentions the AGILITY_TARGET_GUID fallback

All systemArgs options (--sourceGuid, --targetGuid, --overwrite, --force, --reset, --autoPublish, etc.) now appear in pull/push/sync --help — verified against a local build.

PROD-2196 — README corrections (all 5 reported items)

1. --overwrite now documented as conflict-scoped (only overwrites target items in conflict with the source), matching the implementation in the model/content pushers
2. --models-with-deps now documented as including pages (plus templates), matching the CLI behavior and help text
3. pull --sourceGuid marked optional with AGILITY_GUID .env fallback
4. Documented previously missing flags: --channel, --preview, --dryRun, --contentIDs, --pageIDs, --insecure, --legacyFolders, --baseUrl, --token, --force, --reset, plus a note on developer modes (--dev, --local, --preprod, --test)
5. --elements default list now includes Sitemaps

🤖 Generated with Claude Code

[5PK]

Superseded by #163. This PR was based on the older PROD-2195-2196 branch and documented several flags that #163 removes as part of the PROD-2195 system-args cleanup. Closing in favor of #163, which reconciles the README with the removed flags.