fix(api): bind ssh gateway on ipv4

[onutc]

Summary

• bind the embedded SSH gateway explicitly on IPv4 instead of an unspecified address
• add a unit test covering the generated SSH listen address

Testing

• cd api && go test ./...

[gitrank-connector]

👍 GitRank PR Analysis

Score: 20 points

Metric	Value
Component	Other (1× multiplier)
Severity	P2 - Medium (20 base pts)
Final Score	20 × 1 = 20

Eligibility Checks

Check	Status
Issue/Bug Fix	✅
Fix Implementation	✅
PR Documented	✅
Tests	✅
Lines Within Limit	✅

Impact Summary

This PR fixes an SSH gateway binding issue where unspecified addresses (:port) could become IPv6-only in certain Kubernetes clusters, preventing proper traffic routing. The fix explicitly binds to IPv4 (0.0.0.0:port) with clear documentation of the rationale. A comprehensive unit test is added to verify the correct listen address is generated.

Analysis Details

Component Classification: This PR affects the SSH gateway configuration in the API, which doesn't fit neatly into standard component categories. It's classified as OTHER since it's a networking/infrastructure configuration fix rather than a feature or major architectural change.

Severity Justification: This is a P2 (Medium) severity bug fix. The issue addresses a functional problem where the SSH gateway fails to bind correctly in certain Kubernetes environments (IPv6-only clusters), but a workaround exists (manual configuration). The fix prevents service unavailability in affected deployments but doesn't represent a critical security vulnerability or complete service outage.

Eligibility Notes: All eligibility checks pass. The PR fixes a reported bug (IPv6-only binding issue in Kubernetes), the implementation correctly addresses the problem with explicit IPv4 binding, documentation is clear with inline comments, and comprehensive tests are included. Tests are required for this type of change because it's a bug fix in business logic (gateway configuration) that affects runtime behavior and needs verification.

---

Analyzed by GitRank 🤖