feat: generated API clients and facade with retries, RMW PUT and pagination

.github/dependabot.yml

@@ -9,6 +9,12 @@ updates:
     groups:
       gomod:
         patterns: ["*"]
+    ignore:
+      # Code generation must match the platform: these move together with
+      # its oapi-codegen version, not on their own.
+      - dependency-name: github.com/oapi-codegen/*
+      - dependency-name: github.com/getkin/kin-openapi
+      - dependency-name: github.com/oasdiff/*
   - package-ecosystem: github-actions
     directory: /
     schedule:

.github/workflows/checks.yml

@@ -24,6 +24,11 @@ jobs:
         run: |
           go mod tidy
           git diff --exit-code -- go.mod go.sum
+      - name: generated code is up to date
+        run: |
+          make generate
+          git diff --exit-code
+          test -z "$(git status --porcelain)"
 
   test:
     name: test (${{ matrix.os }})

Makefile

@@ -8,7 +8,7 @@ VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo dev)
 LDFLAGS := -s -w -X github.com/devlyft/cli/internal/version.Version=$(VERSION)
 
 .DEFAULT_GOAL := build
-.PHONY: build test cover lint fmt vuln tidy check snapshot clean help
+.PHONY: build test cover lint fmt vuln tidy generate vendor-specs check snapshot clean help
 
 build: ## Build the devlyft binary into bin/
 	go build -trimpath -ldflags '$(LDFLAGS)' -o $(BIN) ./cmd/devlyft
@@ -32,6 +32,13 @@ vuln: ## Check dependencies for known vulnerabilities
 tidy: ## Tidy go.mod and go.sum
 	go mod tidy
 
+generate: ## Regenerate API clients and mocks from internal/api/specs
+	go generate ./internal/api/...
+
+vendor-specs: ## Re-vendor pruned specs from the platform repo (needs access; REF=<sha>)
+	hack/vendor-specs.sh $(REF)
+	$(MAKE) generate
+
 check: lint test vuln ## Run everything CI runs
 
 snapshot: ## Build unsigned release archives for every platform into dist/

go.mod

@@ -2,17 +2,52 @@ module github.com/devlyft/cli
 
 go 1.26.0
 
+toolchain go1.26.10
+
 require (
+	github.com/getkin/kin-openapi v0.133.0
+	github.com/google/uuid v1.6.0
 	github.com/itchyny/gojq v0.12.19
+	github.com/oapi-codegen/runtime v1.6.0
 	github.com/spf13/cobra v1.10.2
+	go.uber.org/mock v0.6.0
+	go.yaml.in/yaml/v3 v3.0.5
 	golang.org/x/term v0.47.0
 	sigs.k8s.io/yaml v1.6.0
 )
 
 require (
+	github.com/apapsch/go-jsonmerge/v2 v2.0.0 // indirect
+	github.com/dprotaso/go-yit v0.0.0-20220510233725-9ba8df137936 // indirect
+	github.com/go-openapi/jsonpointer v0.22.5 // indirect
+	github.com/go-openapi/swag/jsonname v0.25.5 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/itchyny/timefmt-go v0.1.8 // indirect
+	github.com/josharian/intern v1.0.0 // indirect
+	github.com/kr/text v0.2.0 // indirect
+	github.com/mailru/easyjson v0.7.7 // indirect
+	github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826 // indirect
+	github.com/oapi-codegen/oapi-codegen/v2 v2.5.1 // indirect
+	github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 // indirect
+	github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 // indirect
+	github.com/perimeterx/marshmallow v1.1.5 // indirect
+	github.com/speakeasy-api/jsonpath v0.6.0 // indirect
+	github.com/speakeasy-api/openapi-overlay v0.10.2 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
+	github.com/vmware-labs/yaml-jsonpath v0.3.2 // indirect
+	github.com/woodsbury/decimal128 v1.3.0 // indirect
 	go.yaml.in/yaml/v2 v2.4.2 // indirect
+	golang.org/x/mod v0.30.0 // indirect
+	golang.org/x/sync v0.19.0 // indirect
 	golang.org/x/sys v0.49.0 // indirect
+	golang.org/x/text v0.32.0 // indirect
+	golang.org/x/tools v0.39.0 // indirect
+	gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect
+	gopkg.in/yaml.v2 v2.4.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)
+
+tool (
+	github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen
+	go.uber.org/mock/mockgen
 )