core/go-infra
8
0
Fork 0
Code Issues 4 Pull requests 1 Projects Releases Packages Wiki Activity Actions
go-infra/CLAUDE.md

44 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
# CLAUDE.md
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
## Project Overview
fix(tests): update error assertions for coreerr.E format and add missing tests Test assertions were out of sync with the coreerr.E() error format introduced in 9a24df3 — updated 8 assertions from "prefix 404" to "prefix: HTTP 404". Added round-trip tests for UpdateRecord, EnsureRecord, ClearACMEChallenge, CreateLoadBalancer, DeleteLoadBalancer, CreateSnapshot, GetLoadBalancer, ListLoadBalancers, GetServer, and unit tests for HostsByRole/AppServers. Coverage: 62.5% → 80.9%. Updated CLAUDE.md to reflect go-log/go-io dependencies and coding standards. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-17 08:34:06 +00:00
`core/go-infra` provides infrastructure provider API clients (Hetzner Cloud, Hetzner Robot, CloudNS) and a YAML-based infrastructure configuration parser. Dependencies: `go-log` (error handling), `go-io` (file I/O), `yaml.v3`, and `testify` (tests).
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
## Build & Test
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
```bash
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
go test ./... # run all tests
go test -race ./... # run all tests with race detector
go test -run TestFoo ./... # run a single test by name
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
```
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
No build step needed for the library. The `cmd/` packages are CLI commands registered via `forge.lthn.ai/core/cli` and are built as part of the parent `core` CLI tool, not standalone binaries.
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
## Architecture
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
Single `infra` package (root directory) with four source files:
- **`client.go`** — `APIClient` with retry, exponential backoff + jitter, rate-limit (`429` + `Retry-After`) handling. Functional options pattern (`WithHTTPClient`, `WithRetry`, `WithAuth`, `WithPrefix`). Two execution paths: `Do` (JSON decode) and `DoRaw` (raw bytes).
- **`hetzner.go`** — `HCloudClient` (Bearer token auth, Hetzner Cloud API: servers, load balancers, snapshots) and `HRobotClient` (Basic auth, Hetzner Robot API: dedicated servers). Both embed `APIClient` via delegation.
- **`cloudns.go`** — `CloudNSClient` (query-param auth, CloudNS DNS API). Uses `DoRaw` because CloudNS returns non-standard JSON (e.g. `{}` for empty lists). Includes `EnsureRecord` (idempotent upsert) and ACME DNS-01 challenge helpers.
- **`config.go`** — `Config` struct parsed from `infra.yaml` via `Load()` or `Discover()` (walks parent dirs). Defines the full infrastructure topology: hosts, load balancers, DNS, SSL, database, cache, containers, S3, CDN, CI/CD, monitoring, backups.
### CLI Commands (`cmd/`)
These are subcommands for the parent `core` CLI, registered via `cli.RegisterCommands()` in `init()`:
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
- **`cmd/prod`** — Production infrastructure management (`status`, `setup`, `dns`, `lb`, `ssh`). Reads `infra.yaml`.
- **`cmd/monitor`** — Security finding aggregator. Pulls from GitHub code scanning, Dependabot, and secret scanning APIs via `gh` CLI.
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
## Coding Standards
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
- UK English in comments and strings
fix(tests): update error assertions for coreerr.E format and add missing tests Test assertions were out of sync with the coreerr.E() error format introduced in 9a24df3 — updated 8 assertions from "prefix 404" to "prefix: HTTP 404". Added round-trip tests for UpdateRecord, EnsureRecord, ClearACMEChallenge, CreateLoadBalancer, DeleteLoadBalancer, CreateSnapshot, GetLoadBalancer, ListLoadBalancers, GetServer, and unit tests for HostsByRole/AppServers. Coverage: 62.5% → 80.9%. Updated CLAUDE.md to reflect go-log/go-io dependencies and coding standards. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-17 08:34:06 +00:00
- **Error handling**: Use `coreerr.E()` from `go-log`, never `fmt.Errorf` or `errors.New`
- **File I/O**: Use `coreio.Local.Read()` from `go-io`, never `os.ReadFile`
docs: add CLAUDE.md project instructions Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-13 13:38:01 +00:00
- Tests use `testify` (`assert` + `require`)
- Test naming: `TestType_Method_Good`, `TestType_Method_Bad`, `TestType_Method_Ugly` suffixes (Good = happy path, Bad = expected errors, Ugly = edge cases)
- Tests use `httptest.NewServer` for HTTP mocking — no mock libraries
feat: extract infra package from go-devops Standalone infrastructure provider APIs: Hetzner Cloud, Hetzner Robot, CloudNS DNS, and YAML infrastructure configuration parser. Shared HTTP client with retry, exponential backoff, and rate-limit handling. 69 tests passing with race detector. Zero framework dependencies. Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 11:34:52 +00:00
- License: EUPL-1.2
Reference in a new issue Copy permalink