kandev/docs/plans/dev-network-address-logging/task-01-restore-network-logging.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
01-restore-network-logging	Restore network startup logging	done	1		plan.md	../../specs/platform/requirements/go-dev-launcher.md

Task 01: Restore network startup logging

Implement the startup-banner contract added to the Go dev-launcher spec.

Acceptance

• dev, start, and run print a network: URL for each unique non-loopback, non-link-local host address on the backend port.
• IPv4 addresses appear before IPv6 addresses, and IPv6 URLs use brackets.
• Interface enumeration errors do not prevent startup or remove the localhost URL.
• Explicit loopback or specific bind hosts do not advertise unrelated interfaces.
• Internal Vite and agentctl ports remain absent from the network-address lines.

Verification

Run from the repository root:

cd apps/backend && go test -run 'Test(ListHostNetworkAddresses|NetworkURLsForPort|LogStartup)' ./internal/launcher

Files likely touched

• apps/backend/internal/launcher/network.go
• apps/backend/internal/launcher/network_test.go
• apps/backend/internal/launcher/start.go
• docs/public/cli.md

Dependencies

None.

Parallelism

Sequential. The helper, shared logger, and regression tests define one output contract.

Inputs

• docs/specs/platform/requirements/go-dev-launcher.md, startup output section and scenarios.
• The previous Node behavior in apps/cli/src/shared.ts at the pre-migration revision, especially listHostNetworkAddresses, networkUrlsForPort, and logStartupInfo.
• The current shared Go logger in apps/backend/internal/launcher/start.go.

Output contract

Summarize the changed files, exact test command and result, any remaining platform-specific risk, and synchronize this task and plan.md status.

Results

• cd apps/backend && go test -run TestLogStartupPrintsNetworkAddress ./internal/launcher — failed before the fix with the expected missing network: assertion.
• cd apps/backend && go test -run 'Test(ListHostNetworkAddresses|NetworkURLsForPort|LogStartup)' ./internal/launcher — passed, 4 tests.
• cd apps/backend && go test ./internal/launcher — passed, 196 tests.
• cd apps/backend && go test -run TestLogStartupSuppressesNetworkAddressesForLoopbackBind ./internal/launcher — failed before the bind-host fix, then passed after the fix.
• cd apps/backend && go test -run 'Test(NetworkAddressesForBindHost|LogStartupSuppressesNetworkAddressesForLoopbackBind)' ./internal/launcher — passed.
• rtk git diff --check — passed.
• gofmt -w apps/backend/internal/launcher/network.go apps/backend/internal/launcher/network_test.go apps/backend/internal/launcher/start.go — completed successfully.
• node --test scripts/validate-public-docs.test.mjs — passed, 61 tests.
• node scripts/validate-public-docs.mjs — passed, 41 published docs pages.
• Platform risk: native interface enumeration is covered by injected fixtures on this Linux runner; non-Linux native enumeration remains unverified.
• Cleanup: no temporary files, processes, or external runtime state created.