networking

type Action string

type EnsureOptions struct {
	// DryRun: compute the planned change but don't write the
	// file. The resulting Result includes a Diff field so the
	// caller can preview what would change.
	DryRun bool
}

type Result struct {
	// Action is the outcome enum.
	Action Action

	// Reason is a short human-readable explanation. Required
	// for every action; the caller uses it for the operator-
	// facing line.
	Reason string

	// Diff is the unified diff of the .wslconfig change for
	// DryRun + Configured outcomes. Empty for NoOp /
	// AlreadyConfigured / Unsupported.
	Diff string

	// NextStep is the operator-facing follow-up — for the
	// Configured outcome, this is the `wsl --shutdown && wsl`
	// command. Empty otherwise.
	NextStep string

	// ConfigPath is the resolved .wslconfig path the action
	// targeted (or would have targeted). Empty when InWSL2 was
	// false.
	ConfigPath string
}

type WSL2State struct {
	// InWSL2 is true when /proc/version contains "WSL2" — the
	// canonical kernel-side marker for the WSL2 distro. Native
	// Linux + WSL1 + macOS + Windows-without-WSL all surface
	// false; the rest of the struct is then meaningless and the
	// caller should treat the WSL2 fix as a no-op.
	InWSL2 bool

	// WindowsBuild is the major build number from
	// `cmd.exe /c ver` (e.g. 19045 for Windows 10 22H2 or 22631
	// for Windows 11 23H2). Zero when the probe failed.
	WindowsBuild int

	// WSLVersion is the version string from `wsl.exe --version`
	// (e.g. "2.7.3"). Empty when wsl.exe isn't reachable from
	// inside the distro (very old WSL where --version is
	// missing).
	WSLVersion string

	// WindowsUser is the host-side $env:USERNAME read via
	// powershell.exe. Used to resolve the .wslconfig path
	// (`/mnt/c/Users/<user>/.wslconfig`). Empty when the probe
	// failed; in that case WSLConfigPath is also empty and
	// EnsureMirrored surfaces a clear error.
	WindowsUser string

	// WSLConfigPath is the resolved POSIX path the Linux guest
	// uses to read / write the Windows-side .wslconfig. Empty
	// when WindowsUser wasn't resolvable.
	WSLConfigPath string

	// NetworkingMode is the current value of [wsl2].networkingMode
	// in .wslconfig. Empty string means "key not present" — WSL2
	// then uses the default NAT mode. Known values: "nat",
	// "mirrored", "bridged", "none". We don't validate the value
	// strictly; an unknown mode is preserved verbatim through
	// reads + writes.
	NetworkingMode string

	// MirroredSupported is true when WindowsBuild >=
	// MinMirroredBuild. WSL version isn't a hard gate — any WSL
	// 2.x shipping with Windows 11 22H2 supports mirrored mode;
	// the version field is informational.
	MirroredSupported bool
}

type WSLConfig struct {
	// contains filtered or unexported fields
}