Add environment-aware connection methods to Address and Ports contracts.

[gustavofreze]

No description provided.

[Copilot]

Pull request overview

Adds environment-aware connection helpers to container address/port contracts so callers can automatically choose the correct host/port depending on whether they’re running inside Docker or on the host.

Changes:

• Extend Contracts\Address and Contracts\Ports with environment-aware connection methods.
• Implement the new methods in internal Address and Ports models using HostEnvironment::isInsideDocker().
• Add unit tests (with file_exists overrides) and document usage in the README.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
src/Contracts/Address.php	Adds getHostForConnection() to the public Address contract.
src/Contracts/Ports.php	Adds getPortForConnection() to the public Ports contract.
src/Internal/Containers/Address/Address.php	Implements environment-aware host selection.
src/Internal/Containers/Address/Ports.php	Implements environment-aware port selection.
tests/Unit/Internal/Containers/Address/AddressTest.php	Tests host selection inside vs outside Docker.
tests/Unit/Internal/Containers/Address/PortsTest.php	Tests port selection inside vs outside Docker.
tests/Unit/Internal/Containers/Overrides/file_exists_inside_docker.php	Test override to simulate “inside Docker”.
README.md	Documents the new environment-aware connection helpers with examples.