From 4c01c88143635cf8b154c936fb0ac6546a509a85 Mon Sep 17 00:00:00 2001
From: James O'Doherty <james@theodohertyfamily.com>
Date: Fri, 22 May 2026 09:21:07 -0400
Subject: Implement platform compatibility stubs and update AGENTS.md

---
 internal/namespace/namespace.go      | 6 ++++++
 internal/namespace/namespace_stub.go | 5 +++++
 internal/wireguard/wireguard.go      | 6 ++++++
 internal/wireguard/wireguard_stub.go | 5 +++++
 4 files changed, 22 insertions(+)
 create mode 100644 internal/namespace/namespace.go
 create mode 100644 internal/namespace/namespace_stub.go
 create mode 100644 internal/wireguard/wireguard.go
 create mode 100644 internal/wireguard/wireguard_stub.go

(limited to 'internal')

diff --git a/internal/namespace/namespace.go b/internal/namespace/namespace.go
new file mode 100644
index 0000000..ed9c468
--- /dev/null
+++ b/internal/namespace/namespace.go
@@ -0,0 +1,6 @@
+//go:build linux
+
+package namespace
+
+// The namespace package handles the creation and management of
+// Linux network and user namespaces.
diff --git a/internal/namespace/namespace_stub.go b/internal/namespace/namespace_stub.go
new file mode 100644
index 0000000..352ec13
--- /dev/null
+++ b/internal/namespace/namespace_stub.go
@@ -0,0 +1,5 @@
+//go:build !linux
+
+package namespace
+
+// The namespace package provides stubs for non-Linux platforms.
diff --git a/internal/wireguard/wireguard.go b/internal/wireguard/wireguard.go
new file mode 100644
index 0000000..bd7124a
--- /dev/null
+++ b/internal/wireguard/wireguard.go
@@ -0,0 +1,6 @@
+//go:build linux
+
+package wireguard
+
+// The wireguard package manages the userspace WireGuard device
+// and its binding to the Linux TUN interface.
diff --git a/internal/wireguard/wireguard_stub.go b/internal/wireguard/wireguard_stub.go
new file mode 100644
index 0000000..a6b8dac
--- /dev/null
+++ b/internal/wireguard/wireguard_stub.go
@@ -0,0 +1,5 @@
+//go:build !linux
+
+package wireguard
+
+// The wireguard package provides stubs for non-Linux platforms.
-- 
cgit v1.2.3