frame out cli tool

CLAUDE.md

@@ -0,0 +1,65 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build and Test Commands
+
+```bash
+# Build library packages
+go build ./pkg/...
+
+# Build CLI tool
+go build ./cmd/...
+
+# Run all tests
+go test ./...
+
+# Run tests for a specific package
+go test ./pkg/toughswitch/...
+
+# Run a single test
+go test ./pkg/toughswitch/... -run TestClient_AddDel
+
+# Tidy module dependencies
+go mod tidy
+```
+
+## Architecture
+
+This repository provides Go client libraries for interacting with Ubiquiti network devices via reverse-engineered REST APIs.
+
+### Package Structure
+
+- `pkg/toughswitch/` - Client for ToughSwitch devices (e.g., TS-8-PRO)
+- `pkg/edgeos/` - Client for EdgeOS devices (EdgeRouter, EdgeSwitch)
+- `cmd/` - Optional CLI tool using cobra (work in progress)
+
+### Client Design Pattern
+
+Both packages follow the same multi-device client pattern:
+
+1. **Client** - Top-level struct holding a map of `deviceClient` instances keyed by host
+2. **deviceClient** - Per-device HTTP client with authentication state (token for ToughSwitch, cookies for EdgeOS)
+3. **Config** - Device connection settings (host, credentials, TLS options, timeout)
+
+Key characteristics:
+- Thread-safe: Uses `sync.RWMutex` for device map access and `sync.Mutex` for per-device operations
+- Auto-login: Automatically authenticates on 401 responses and retries the request
+- Concurrent multi-device: `GetAll*` methods use `sync.WaitGroup.Go()` for parallel queries
+
+### API Pattern
+
+Each package exposes:
+- `MustNew(ctx, []Config)` - Constructor that accepts multiple device configs
+- `Add(cfg)` / `Del(host)` - Dynamic device management
+- `Get<Resource>(ctx, host)` - Single device query
+- `GetAll<Resources>(ctx)` - Parallel query across all devices, returns `map[string]*Resource`
+
+### Authentication
+
+- **ToughSwitch**: Token-based via `x-auth-token` header from `/api/v1.0/user/login`
+- **EdgeOS**: Cookie-based from `/api/login2` endpoint
+
+### Testing
+
+Tests use `mockTransport` implementing `http.RoundTripper` to mock HTTP responses without network calls.