refactor: replace Go workspace with single module (#1485)

Remove the go.work multi-module workspace and consolidate go/api,
go/core, and go/adk into a single module at go/go.mod. This fixes
external import resolution which was broken because Go requires
module-prefixed tags (go/api/vX.Y.Z) for multi-module repos, and replace
directives are ignored when consumed as a dependency.

- Merge three go.mod files into one (github.com/kagent-dev/kagent/go)
- Remove go.work, per-module go.mod/go.sum, and replace directives
- Simplify Dockerfile to copy single go.mod/go.sum
- Simplify Makefile (no more per-module loops)
- Update CI cache paths and working directories
- Remove go module tagging step from release workflow
- Fix pre-existing runtime_test.go probe config expectations

---------

Signed-off-by: Eitan Yarmush <eitan.yarmush@solo.io>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: EItanya

.github/workflows/ci.yaml

@@ -111,7 +111,7 @@ jobs:
 
       - name: Run e2e tests
         if: success()
-        working-directory: go/core
+        working-directory: go
         run: |
           # Get the Kind network gateway IP that pods can reach
           HOST_IP=$(docker network inspect kind -f '{{range .IPAM.Config}}{{if .Gateway}}{{.Gateway}}{{"\n"}}{{end}}{{end}}' | grep -E '^[0-9]+\.' | head -1)
@@ -148,12 +148,12 @@ jobs:
         with:
           go-version: "1.26"
           cache: true
-          cache-dependency-path: go/*/go.sum
+          cache-dependency-path: go/go.sum
 
       - name: Run Go unit tests
         working-directory: go
         run: |
-          go test -race -skip 'TestE2E.*' -v ./api/... ./adk/... ./core/...
+          go test -race -skip 'TestE2E.*' -v ./...
 
   helm-unit-tests:
     env:
@@ -267,12 +267,12 @@ jobs:
         with:
           go-version: "1.26"
           cache: true
-          cache-dependency-path: go/*/go.sum
+          cache-dependency-path: go/go.sum
       - name: golangci-lint
         uses: golangci/golangci-lint-action@v9
         with:
           version: v2.11.3
-          working-directory: go/core
+          working-directory: go
 
   python-test:
     env:
@@ -342,7 +342,7 @@ jobs:
         with:
           go-version: "1.26"
           cache: true
-          cache-dependency-path: go/*/go.sum
+          cache-dependency-path: go/go.sum
 
       - name: Generate controller manifests
         run: make controller-manifests

.github/workflows/tag.yaml

@@ -147,21 +147,6 @@ jobs:
         fi
         make build-cli
         make helm-version
-    - name: Create Go module tags
-      if: startsWith(github.ref, 'refs/tags/')
-      run: |
-        VERSION=$(echo "$GITHUB_REF" | cut -c12-)
-
-        # Create module-prefixed tags for each Go sub-module
-        for module in api core adk; do
-          TAG="go/${module}/${VERSION}"
-          echo "Creating tag: ${TAG}"
-          git tag "${TAG}"
-        done
-
-        # Push all module tags
-        git push origin "go/api/${VERSION}" "go/core/${VERSION}" "go/adk/${VERSION}"
-
     - name: Release
       uses: softprops/action-gh-release@v2
       if: startsWith(github.ref, 'refs/tags/')

.gitignore

@@ -23,9 +23,6 @@ test_results
 # Dependency directories (remove the comment below to include it)
 # vendor/
 
-# Go workspace file
-go.work
-
 # Go CLI binary
 go/cli/bin/*
 

Makefile

@@ -52,9 +52,9 @@ KAGENT_ADK_IMG ?= $(DOCKER_REGISTRY)/$(DOCKER_REPO)/$(KAGENT_ADK_IMAGE_NAME):$(K
 GOLANG_ADK_IMG ?= $(DOCKER_REGISTRY)/$(DOCKER_REPO)/$(GOLANG_ADK_IMAGE_NAME):$(GOLANG_ADK_IMAGE_TAG)
 SKILLS_INIT_IMG ?= $(DOCKER_REGISTRY)/$(DOCKER_REPO)/$(SKILLS_INIT_IMAGE_NAME):$(SKILLS_INIT_IMAGE_TAG)
 
-#take from go/core/go.mod
+#take from go/go.mod
 AWK ?= $(shell command -v gawk || command -v awk)
-TOOLS_GO_VERSION ?= $(shell $(AWK) '/^go / { print $$2 }' go/core/go.mod)
+TOOLS_GO_VERSION ?= $(shell $(AWK) '/^go / { print $$2 }' go/go.mod)
 export GOTOOLCHAIN=go$(TOOLS_GO_VERSION)
 
 # Version information for the build
@@ -105,7 +105,7 @@ init-git-hooks:  ## Use the tracked version of Git hooks from this repo
 
 # KMCP
 KMCP_ENABLED ?= true
-KMCP_VERSION ?= $(shell $(AWK) '/github\.com\/kagent-dev\/kmcp/ { print substr($$2, 2) }' go/core/go.mod) # KMCP version defaults to what's referenced in go.mod
+KMCP_VERSION ?= $(shell $(AWK) '/github\.com\/kagent-dev\/kmcp/ { print substr($$2, 2) }' go/go.mod) # KMCP version defaults to what's referenced in go.mod
 
 HELM_ACTION=upgrade --install
 

go/Dockerfile

@@ -10,16 +10,13 @@ ARG BUILDPLATFORM
 ARG BUILD_PACKAGE=core/cmd/controller/main.go
 
 WORKDIR /workspace
-# Copy the Go workspace and all module manifests
-COPY go.work .
-COPY api/go.mod api/go.sum api/
-COPY core/go.mod core/go.sum core/
-COPY adk/go.mod adk/go.sum adk/
+# Copy the Go module manifests
+COPY go.mod go.sum .
 # cache deps before building and copying source so that we don't need to re-download as much
 # and so that source changes don't invalidate our downloaded layer
 RUN --mount=type=cache,target=/root/go/pkg/mod,rw      \
     --mount=type=cache,target=/root/.cache/go-build,rw \
-     go work sync && go mod download
+     go mod download
 # Copy all source
 COPY api/ api/
 COPY core/ core/

go/Makefile

@@ -29,68 +29,65 @@ manifests: controller-gen generate ## Generate ClusterRole and CustomResourceDef
 generate: controller-gen ## Generate code containing DeepCopy, DeepCopyInto, and DeepCopyObject method implementations.
 	$(CONTROLLER_GEN) object:headerFile="api/hack/boilerplate.go.txt" paths="./api/..."
 
-## Workspace modules
-MODULES := api core adk
-
 ##@ Development
 
 .PHONY: fmt
-fmt: ## Run go fmt against all modules.
-	@for m in $(MODULES); do echo "fmt $$m"; (cd $$m && go fmt ./...); done
+fmt: ## Run go fmt.
+	go fmt ./...
 
 .PHONY: vet
-vet: ## Run go vet against all modules.
-	@for m in $(MODULES); do echo "vet $$m"; (cd $$m && go vet ./...); done
+vet: ## Run go vet.
+	go vet ./...
 
 .PHONY: lint
-lint: golangci-lint ## Run golangci-lint against all modules.
-	@for m in $(MODULES); do echo "lint $$m"; (cd $$m && $(GOLANGCI_LINT) run) || exit 1; done
+lint: golangci-lint ## Run golangci-lint.
+	$(GOLANGCI_LINT) run
 
 .PHONY: lint-fix
-lint-fix: golangci-lint ## Run golangci-lint with auto-fix against all modules.
-	@for m in $(MODULES); do echo "lint-fix $$m"; (cd $$m && $(GOLANGCI_LINT) run --fix) || exit 1; done
+lint-fix: golangci-lint ## Run golangci-lint with auto-fix.
+	$(GOLANGCI_LINT) run --fix
 
 .PHONY: lint-config
 lint-config: golangci-lint ## Verify golangci-lint linter configuration.
-	@for m in $(MODULES); do echo "lint-config $$m"; (cd $$m && $(GOLANGCI_LINT) config verify) || exit 1; done
+	$(GOLANGCI_LINT) config verify
 
 .PHONY: govulncheck
-govulncheck: ## Run govulncheck against all modules.
+govulncheck: ## Run govulncheck.
 	$(call go-install-tool,bin/govulncheck,golang.org/x/vuln/cmd/govulncheck,latest)
-	@for m in $(MODULES); do echo "govulncheck $$m"; (cd $$m && go mod tidy -v && ../bin/govulncheck-latest ./...) || exit 1; done
+	go mod tidy -v && bin/govulncheck-latest ./...
 
 ##@ Build (core module — CLI binaries)
 
 core/bin/kagent-local:
-	cd core && CGO_ENABLED=0 go test -race ./cli/...
-	cd core && CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o bin/kagent-local ./cli/cmd/kagent
+	go test -race ./core/cli/...
+	CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-local ./core/cli/cmd/kagent
 
 core/bin/kagent-linux-amd64:
-	cd core && CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o bin/kagent-linux-amd64 ./cli/cmd/kagent
+	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-linux-amd64 ./core/cli/cmd/kagent
 
 core/bin/kagent-linux-amd64.sha256: core/bin/kagent-linux-amd64
 	sha256sum core/bin/kagent-linux-amd64 > core/bin/kagent-linux-amd64.sha256
 
 core/bin/kagent-linux-arm64:
-	cd core && CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -ldflags "$(LDFLAGS)" -o bin/kagent-linux-arm64 ./cli/cmd/kagent
+	CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-linux-arm64 ./core/cli/cmd/kagent
 
 core/bin/kagent-linux-arm64.sha256: core/bin/kagent-linux-arm64
 	sha256sum core/bin/kagent-linux-arm64 > core/bin/kagent-linux-arm64.sha256
 
 core/bin/kagent-darwin-amd64:
-	cd core && CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o bin/kagent-darwin-amd64 ./cli/cmd/kagent
+	CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-darwin-amd64 ./core/cli/cmd/kagent
 
 core/bin/kagent-darwin-amd64.sha256: core/bin/kagent-darwin-amd64
 	sha256sum core/bin/kagent-darwin-amd64 > core/bin/kagent-darwin-amd64.sha256
 
 core/bin/kagent-darwin-arm64:
-	cd core && CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -ldflags "$(LDFLAGS)" -o bin/kagent-darwin-arm64 ./cli/cmd/kagent
+	CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-darwin-arm64 ./core/cli/cmd/kagent
 
 core/bin/kagent-darwin-arm64.sha256: core/bin/kagent-darwin-arm64
 	sha256sum core/bin/kagent-darwin-arm64 > core/bin/kagent-darwin-arm64.sha256
 
 core/bin/kagent-windows-amd64.exe:
-	cd core && CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o bin/kagent-windows-amd64.exe ./cli/cmd/kagent
+	CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags "$(LDFLAGS)" -o core/bin/kagent-windows-amd64.exe ./core/cli/cmd/kagent
 
 core/bin/kagent-windows-amd64.exe.sha256: core/bin/kagent-windows-amd64.exe
 	sha256sum core/bin/kagent-windows-amd64.exe > core/bin/kagent-windows-amd64.exe.sha256
@@ -104,15 +101,15 @@ build: core/bin/kagent-linux-amd64.sha256 core/bin/kagent-linux-arm64.sha256 cor
 
 .PHONY: run
 run: fmt vet ## Run a controller from your host.
-	cd core && go run ./cmd/controller/main.go
+	go run ./core/cmd/controller/main.go
 
 .PHONY: test
-test: ## Run all unit tests across the workspace.
-	UPDATE_GOLDEN=$(UPDATE_GOLDEN) go test -race -skip 'TestE2E.*' -v ./api/... ./core/... ./adk/...
+test: ## Run all unit tests.
+	UPDATE_GOLDEN=$(UPDATE_GOLDEN) go test -race -skip 'TestE2E.*' -v ./...
 
 .PHONY: e2e
 e2e: ## Run end-to-end tests.
-	cd core && go test -v github.com/kagent-dev/kagent/go/core/test/e2e -failfast
+	go test -v github.com/kagent-dev/kagent/go/core/test/e2e -failfast
 
 ##@ Dependencies
 
@@ -130,9 +127,9 @@ GOLANGCI_LINT = $(LOCALBIN)/golangci-lint
 ## Tool Versions
 CONTROLLER_TOOLS_VERSION ?= v0.19.0
 #ENVTEST_VERSION is the version of controller-runtime release branch to fetch the envtest setup script (i.e. release-0.20)
-ENVTEST_VERSION ?= $(shell cd core && go list -m -f "{{ .Version }}" sigs.k8s.io/controller-runtime | awk -F'[v.]' '{printf "release-%d.%d", $$2, $$3}')
+ENVTEST_VERSION ?= $(shell go list -m -f "{{ .Version }}" sigs.k8s.io/controller-runtime | awk -F'[v.]' '{printf "release-%d.%d", $$2, $$3}')
 #ENVTEST_K8S_VERSION is the version of Kubernetes to use for setting up ENVTEST binaries (i.e. 1.31)
-ENVTEST_K8S_VERSION ?= $(shell cd core && go list -m -f "{{ .Version }}" k8s.io/api | awk -F'[v.]' '{printf "1.%d", $$3}')
+ENVTEST_K8S_VERSION ?= $(shell go list -m -f "{{ .Version }}" k8s.io/api | awk -F'[v.]' '{printf "1.%d", $$3}')
 GOLANGCI_LINT_VERSION ?= v2.10.1
 
 .PHONY: controller-gen