Makefile

# ChromaDB Java Client Makefile
# This Makefile provides convenient commands for common development tasks

# Variables
MAVEN := mvn
JAVA := java
CHROMA_MATRIX_VERSIONS := 1.0.0 1.3.7 1.5.5

# Color output
RED := \033[0;31m
GREEN := \033[0;32m
YELLOW := \033[0;33m
BLUE := \033[0;34m
NC := \033[0m # No Color

# Default target
.DEFAULT_GOAL := help

# Check for required tools
.PHONY: check-tools
check-tools:
	@command -v $(JAVA) >/dev/null 2>&1 || { echo "$(RED)Error: Java is not installed$(NC)"; exit 1; }
	@command -v $(MAVEN) >/dev/null 2>&1 || { echo "$(RED)Error: Maven is not installed$(NC)"; exit 1; }
	@echo "$(GREEN)✓ All required tools are installed$(NC)"

##@ Core Build Targets

.PHONY: build
build: check-tools ## Clean and compile the project
	@echo "$(BLUE)Building project...$(NC)"
	$(MAVEN) clean compile

.PHONY: test
test: check-tools ## Run all tests
	@echo "$(BLUE)Running tests...$(NC)"
	$(MAVEN) test

.PHONY: package
package: check-tools ## Create JAR package
	@echo "$(BLUE)Creating JAR package...$(NC)"
	$(MAVEN) clean package

.PHONY: install
install: check-tools ## Install to local Maven repository
	@echo "$(BLUE)Installing to local Maven repository...$(NC)"
	$(MAVEN) clean install

.PHONY: clean
clean: check-tools ## Clean build artifacts
	@echo "$(BLUE)Cleaning build artifacts...$(NC)"
	$(MAVEN) clean

##@ Testing Targets

.PHONY: test-unit
test-unit: check-tools ## Run unit tests only
	@echo "$(BLUE)Running unit tests...$(NC)"
	$(MAVEN) test -Dtest="!*Integration*"

.PHONY: test-integration
test-integration: check-tools ## Run integration tests only
	@echo "$(BLUE)Running integration tests...$(NC)"
	$(MAVEN) -Pintegration test

.PHONY: test-matrix
test-matrix: check-tools ## Run full unit + integration test matrix across all pinned Chroma versions
	@echo "$(BLUE)Running unit tests...$(NC)"
	$(MAVEN) --batch-mode test
	@echo "$(BLUE)Running integration tests across Chroma versions: $(CHROMA_MATRIX_VERSIONS)$(NC)"
	@set -e; for v in $(CHROMA_MATRIX_VERSIONS); do \
	  echo "$(BLUE)  Testing with Chroma $$v...$(NC)"; \
	  CHROMA_VERSION=$$v $(MAVEN) --batch-mode -Pintegration test || exit $$?; \
	done
	@echo "$(GREEN)test-matrix complete$(NC)"

# NOTE: test-matrix is the canonical version-matrix target. test-phase-02-parity is kept for backward compatibility.
.PHONY: test-phase-02-parity
test-phase-02-parity: check-tools ## Run Phase 2 parity matrix for locked Chroma versions
	mvn -q -Dtest=ChromaClientImplTest,ChromaHttpCollectionTest,ChromaDtosContractTest test
	CHROMA_VERSION=1.5.5 mvn -q -Pintegration -Dtest=TenantDatabaseIntegrationTest,CollectionLifecycleIntegrationTest,RecordOperationsIntegrationTest,SchemaAndQueryTextsIntegrationTest test
	CHROMA_VERSION=1.3.7 mvn -q -Pintegration -Dtest=TenantDatabaseIntegrationTest,CollectionLifecycleIntegrationTest,RecordOperationsIntegrationTest,SchemaAndQueryTextsIntegrationTest test

.PHONY: test-phase-02-cloud-parity
test-phase-02-cloud-parity: check-tools ## Run optional live Chroma Cloud parity tests (requires CHROMA_* credentials)
	mvn -q -Pintegration -Dtest=CloudAuthIntegrationTest,CloudParityIntegrationTest test

.PHONY: test-phase-02-approval
test-phase-02-approval: check-tools ## Run approval gate: local 1.5.5 parity baseline + cloud parity tests
	CHROMA_VERSION=1.5.5 mvn -q -Pintegration -Dtest=TenantDatabaseIntegrationTest,CollectionLifecycleIntegrationTest,RecordOperationsIntegrationTest,SchemaAndQueryTextsIntegrationTest test
	mvn -q -Pintegration -Dtest=CloudAuthIntegrationTest,CloudParityIntegrationTest test

.PHONY: test-version
test-version: check-tools ## Test with specific ChromaDB version (use CHROMA_VERSION=x.x.x)
ifndef CHROMA_VERSION
	@echo "$(RED)Error: CHROMA_VERSION not specified$(NC)"
	@echo "Usage: make test-version CHROMA_VERSION=1.5.2"
	@exit 1
endif
	@echo "$(BLUE)Testing with ChromaDB version $(CHROMA_VERSION)...$(NC)"
	CHROMA_VERSION=$(CHROMA_VERSION) $(MAVEN) test

.PHONY: test-class
test-class: check-tools ## Run specific test class (use TEST=ClassName)
ifndef TEST
	@echo "$(RED)Error: TEST not specified$(NC)"
	@echo "Usage: make test-class TEST=YourTestClass"
	@exit 1
endif
	@echo "$(BLUE)Running test class $(TEST)...$(NC)"
	$(MAVEN) test -Dtest=$(TEST)

.PHONY: test-method
test-method: check-tools ## Run specific test method (use TEST=ClassName#methodName)
ifndef TEST
	@echo "$(RED)Error: TEST not specified$(NC)"
	@echo "Usage: make test-method TEST=YourTestClass#yourTestMethod"
	@exit 1
endif
	@echo "$(BLUE)Running test method $(TEST)...$(NC)"
	$(MAVEN) test -Dtest=$(TEST)

##@ Development Utilities

.PHONY: deps
deps: check-tools ## Download/update dependencies
	@echo "$(BLUE)Resolving dependencies...$(NC)"
	$(MAVEN) dependency:resolve

.PHONY: deps-tree
deps-tree: check-tools ## Display dependency tree
	@echo "$(BLUE)Displaying dependency tree...$(NC)"
	$(MAVEN) dependency:tree

.PHONY: deps-analyze
deps-analyze: check-tools ## Analyze dependencies for conflicts
	@echo "$(BLUE)Analyzing dependencies...$(NC)"
	$(MAVEN) dependency:analyze

.PHONY: versions
versions: check-tools ## Check for dependency updates
	@echo "$(BLUE)Checking for dependency updates...$(NC)"
	$(MAVEN) versions:display-dependency-updates

.PHONY: compile
compile: check-tools ## Compile source code without cleaning
	@echo "$(BLUE)Compiling source code...$(NC)"
	$(MAVEN) compile

.PHONY: test-compile
test-compile: check-tools ## Compile test source code
	@echo "$(BLUE)Compiling test source code...$(NC)"
	$(MAVEN) test-compile

##@ Release Targets

.PHONY: release-prepare
release-prepare: check-tools ## Prepare for release (update versions)
	@echo "$(YELLOW)Preparing for release...$(NC)"
	@echo "Current version: $$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout)"
	@read -p "Enter new version: " VERSION && \
	$(MAVEN) versions:set -DnewVersion=$$VERSION && \
	echo "$(GREEN)✓ Version updated to $$VERSION$(NC)"

.PHONY: release-rollback
release-rollback: check-tools ## Rollback version changes
	@echo "$(YELLOW)Rolling back version changes...$(NC)"
	$(MAVEN) versions:revert

.PHONY: snapshot
snapshot: check-tools ## Deploy snapshot version
	@echo "$(BLUE)Deploying snapshot...$(NC)"
	$(MAVEN) clean deploy

.PHONY: release
release: check-tools ## Full release (CI only - requires GPG signing)
	@echo "$(YELLOW)⚠️  This target is intended for CI use only$(NC)"
	@echo "$(BLUE)Performing full release...$(NC)"
	$(MAVEN) clean deploy -P release

.PHONY: release-check
release-check: check-tools ## Validate release readiness (version, docs, artifacts if built)
	@echo "$(BLUE)Running release checks...$(NC)"
	@VERSION=$$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout) && \
	echo "  Version: $$VERSION" && \
	echo "$$VERSION" | grep -qv "SNAPSHOT" || { echo "$(RED)FAIL: Version $$VERSION contains -SNAPSHOT$(NC)"; exit 1; } && \
	echo "  $(GREEN)Version format OK$(NC)"
	@VERSION=$$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout) && \
	grep -q "\[$$VERSION\]" CHANGELOG.md || { echo "$(RED)FAIL: No CHANGELOG.md entry for $$VERSION$(NC)"; exit 1; } && \
	echo "  $(GREEN)CHANGELOG.md entry OK$(NC)"
	@VERSION=$$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout) && \
	grep -q "$$VERSION" README.md || { echo "$(RED)FAIL: README.md does not reference version $$VERSION$(NC)"; exit 1; } && \
	echo "  $(GREEN)README.md version reference OK$(NC)"
	@grep -q "^## TODO" README.md && { echo "$(RED)FAIL: README.md contains stale TODO section$(NC)"; exit 1; } || \
	echo "  $(GREEN)No stale TODO section OK$(NC)"
	@ARTIFACT_ID=$$($(MAVEN) help:evaluate -Dexpression=project.artifactId -q -DforceStdout) && \
	VERSION=$$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout) && \
	if [ -d target ]; then \
		for f in \
			"$${ARTIFACT_ID}-$${VERSION}.jar" \
			"$${ARTIFACT_ID}-$${VERSION}-sources.jar" \
			"$${ARTIFACT_ID}-$${VERSION}-javadoc.jar" \
			"$${ARTIFACT_ID}-$${VERSION}.jar.md5" \
			"$${ARTIFACT_ID}-$${VERSION}.jar.sha512"; do \
			test -s "target/$$f" || { echo "$(RED)FAIL: target/$$f missing or empty$(NC)"; exit 1; }; \
		done && \
		echo "  $(GREEN)Artifacts OK$(NC)"; \
	else \
		echo "  $(YELLOW)SKIP: target/ not found (run release-dry-run for full validation)$(NC)"; \
	fi
	@echo "$(GREEN)release-check passed$(NC)"

.PHONY: release-dry-run
release-dry-run: check-tools ## Build release artifacts locally without signing or deploying
	@echo "$(BLUE)Running release dry-run (no GPG, no deploy)...$(NC)"
	$(MAVEN) --batch-mode clean verify -Dgpg.skip=true
	@$(MAKE) release-check
	@echo "$(GREEN)release-dry-run complete$(NC)"

##@ Docker Targets

.PHONY: docker-test
docker-test: ## Run tests in Docker environment
	@echo "$(BLUE)Running tests in Docker...$(NC)"
	docker run --rm -v $(PWD):/workspace -w /workspace maven:3-openjdk-8 mvn test

.PHONY: docker-build
docker-build: ## Build project in Docker environment
	@echo "$(BLUE)Building in Docker...$(NC)"
	docker run --rm -v $(PWD):/workspace -w /workspace maven:3-openjdk-8 mvn clean package

##@ Utility Targets

.PHONY: info
info: check-tools ## Display project information
	@echo "$(BLUE)Project Information:$(NC)"
	@echo "  Name: $$($(MAVEN) help:evaluate -Dexpression=project.name -q -DforceStdout)"
	@echo "  Group ID: $$($(MAVEN) help:evaluate -Dexpression=project.groupId -q -DforceStdout)"
	@echo "  Artifact ID: $$($(MAVEN) help:evaluate -Dexpression=project.artifactId -q -DforceStdout)"
	@echo "  Version: $$($(MAVEN) help:evaluate -Dexpression=project.version -q -DforceStdout)"
	@echo "  Java Version: $$($(JAVA) -version 2>&1 | head -1)"
	@echo "  Maven Version: $$($(MAVEN) -version | head -1)"

.PHONY: help
help: ## Display this help message
	@echo "ChromaDB Java Client - Development Tasks"
	@echo ""
	@echo "Usage: make [target]"
	@echo ""
	@awk 'BEGIN {FS = ":.*##"; printf "$(YELLOW)Available targets:$(NC)\n"} \
		/^[a-zA-Z_-]+:.*?##/ { printf "  $(GREEN)%-20s$(NC) %s\n", $$1, $$2 } \
		/^##@/ { printf "\n$(BLUE)%s$(NC)\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
	@echo ""
	@echo "$(YELLOW)Examples:$(NC)"
	@echo "  make build                     # Build the project"
	@echo "  make test                      # Run all tests"
	@echo "  make test-version CHROMA_VERSION=1.5.2   # Test with specific version"
	@echo "  make test-class TEST=YourTestClass   # Run specific test class"
	@echo "  make help                      # Show this help"

# Quick shortcuts
.PHONY: b
b: build ## Shortcut for build

.PHONY: t
t: test ## Shortcut for test

.PHONY: c
c: clean ## Shortcut for clean

.PHONY: i
i: install ## Shortcut for install