fix(runtime): enumerate Windows network interfaces

[proggeramlug]

Summary

• implement the Windows os.networkInterfaces() backend with GetAdaptersAddresses
• match Node/libuv behavior for live adapters, friendly names, MAC fallback, loopback detection, IPv4/IPv6 netmasks, CIDRs, and IPv6 scope IDs
• strengthen the existing parity fixture so an empty interface object no longer passes silently

Validation

• cargo test -p perry-runtime os_network::tests
• cargo check --tests --no-default-features --features full,regex-engine,diagnostics --target x86_64-pc-windows-msvc -p perry-runtime
• ./run_parity_tests.sh --suite node-suite --module os --filter network-interfaces-shape
• cargo fmt --all -- --check
• deno fmt --check test-parity/node-suite/os/collections/network-interfaces-shape.ts
• git diff --check

Fixes #6621

Summary by CodeRabbit

• New Features

  • Windows now reports active network interfaces through os.networkInterfaces().
  • Interface results include addresses, netmasks, MAC addresses, loopback status, CIDRs, and IPv6 scope IDs.

• Bug Fixes

  • Fixed Windows network interface enumeration returning an empty object.
  • Improved consistency of network details across supported platforms.

• Tests

  • Added validation for interface fields, address formats, MAC addresses, CIDRs, and IPv6 scope IDs.

[coderabbitai]

📝 Walkthrough

Walkthrough

Windows os.networkInterfaces() now enumerates active adapters through GetAdaptersAddresses, maps IPv4 and IPv6 details into runtime results, and adds helper and shape validation tests.

Changes

Windows network interface support

Layer / File(s)	Summary
MAC and netmask helpers crates/perry-runtime/src/os_network.rs	Shared MAC formatting and prefix-derived IPv4/IPv6 netmask helpers are added, with existing platform-specific MAC collection updated to use them.
Windows adapter enumeration crates/perry-runtime/Cargo.toml, crates/perry-runtime/src/os_network.rs, changelog.d/7080-windows-network-interfaces.md	Windows networking APIs are enabled, active adapters are collected with address, netmask, MAC, CIDR, loopback, and IPv6 scope information, and the Windows behavior is documented.
Network shape validation crates/perry-runtime/src/os_network.rs, test-parity/node-suite/os/collections/network-interfaces-shape.ts	Unit, Windows runtime, and parity checks validate MACs, netmasks, CIDRs, scope IDs, and field types.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Runtime
  participant GetAdaptersAddresses
  participant NetworkShapeChecks
  Runtime->>GetAdaptersAddresses: request adapter addresses
  GetAdaptersAddresses-->>Runtime: adapter and unicast address data
  Runtime->>Runtime: derive netmasks, CIDRs, MACs, and IPv6 scope IDs
  Runtime-->>NetworkShapeChecks: return network interface entries
  NetworkShapeChecks->>NetworkShapeChecks: validate entry fields and formats

Loading

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: adding Windows network interface enumeration.
Description check	✅ Passed	The description covers the main behavior change, linked issue, and validation, though it omits the template's explicit Changes/Test plan sections.
Linked Issues check	✅ Passed	The PR implements Windows GetAdaptersAddresses-based enumeration and maps the required adapter fields into OsNetworkAddress.
Out of Scope Changes check	✅ Passed	The changes stay focused on Windows network interfaces, related tests, and a changelog note; no unrelated code appears included.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/6621-windows-network-interfaces

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@crates/perry-runtime/src/os_network.rs`:
- Around line 211-353: Add the missing std::mem::size_of import in the Windows
networking code so the unqualified size_of calls in collect_windows_adapters
compile. Keep the existing socket-size comparisons unchanged.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 4f32b5e8-daef-4567-b8da-71635cdf8025

📥 Commits

Reviewing files that changed from the base of the PR and between 9a3967b and d74bdd1.

📒 Files selected for processing (4)

• changelog.d/7080-windows-network-interfaces.md
• crates/perry-runtime/Cargo.toml
• crates/perry-runtime/src/os_network.rs
• test-parity/node-suite/os/collections/network-interfaces-shape.ts