plan(cross-port-tg): Plan 3 — Java port (with cross-port API divergence rationale)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dmealing