Add advanced networking: port ranges/UDP, DNS search/opt, IPAM config, connection inspection

[Copilot]

Implements four advanced networking capabilities from issue #7: configurable port forwarding (UDP + ranges), robust internal DNS, IPAM-based custom subnets, and connection inspection.

Port forwarding

parsePortSpec now returns [PublishPort] and handles protocol suffixes and port ranges:

ports:
  - "8080-8082:80-82"      # range: expands to 3 PublishPort entries
  - "5353:53/udp"           # protocol suffix
  - "127.0.0.1:8443:443/tcp"

DNS (dns_search, dns_opt)

New fields on ServiceConfig, wired into DNSConfiguration.searchDomains and options. A DNS config object is only created when at least one of dns, dns_search, or dns_opt is set; nameservers are never injected implicitly.

dns_search:
  - example.com
dns_opt:
  - "ndots:5"

Custom networks / IPAM

NetworkConfig gains an ipam field (IPAMConfig → [IPAMPool]) for subnet, IP range, and gateway customization:

networks:
  backend:
    ipam:
      config:
        - subnet: "172.28.0.0/16"
          ip_range: "172.28.5.0/24"
          gateway: "172.28.5.254"

External networks (external: true + name:) continue to work as before.

Connection inspection

New inspectConnections(project:) async throws -> [ServiceConnections] on ComposeOrchestrator returns each service's live Attachments and PublishPorts. Containers not yet created (BackendError.notFound) are silently skipped; all other errors propagate.

• Fixes Adicionar recursos avançados de rede #7

[Copilot]

Pull request overview

This PR extends ComposeEngine’s networking support by enhancing port spec parsing (UDP + ranges), adding DNS search/options fields to the service model and container configuration, introducing IPAM fields on network configs, and adding a new API to inspect live container connections.

Changes:

• Updated parsePortSpec to return multiple PublishPort entries, supporting protocol suffixes and port ranges.
• Added dns_search / dns_opt to ServiceConfig and wired them into ContainerConfiguration.DNSConfiguration.
• Added NetworkConfig.ipam model types and tests, plus a new inspectConnections(project:) API for connection snapshots.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
Tests/ComposeEngineTests/ComposeEngineTests.swift	Adds/updates tests for UDP + ranged ports, DNS search/options decoding, and IPAM decoding.
Sources/ComposeEngine/Models/ComposeModels.swift	Extends Compose model types with DNS search/options on services and IPAM config on networks.
Sources/ComposeEngine/ComposeOrchestrator.swift	Implements connection inspection API, updates port publishing to consume multiple ports, and wires DNS search/options into container config.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[djpfs]

resolve the comments

[djpfs]

@copilot resolve the merge conflicts on this branch.

[Copilot]

@copilot resolve the merge conflicts on this branch.

Resolved and committed in 2c9f98d.