Files
clawgo/Makefile

457 lines
17 KiB
Makefile

.PHONY: all build build-variants build-linux-slim build-all build-all-variants package-all install install-win uninstall clean help test test-docker install-bootstrap-docs sync-embed-workspace cleanup-embed-workspace test-only clean-test-artifacts dev
# Build variables
BINARY_NAME=clawgo
BUILD_DIR=build
CMD_DIR=cmd
MAIN_GO=$(CMD_DIR)/main.go
# Version
VERSION?=$(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
BUILD_TIME=$(shell date +%FT%T%z)
STRIP_SYMBOLS?=1
BASE_LDFLAGS=-X main.version=$(VERSION) -X main.buildTime=$(BUILD_TIME)
EXTRA_LDFLAGS=
ifeq ($(STRIP_SYMBOLS),1)
EXTRA_LDFLAGS+= -s -w
endif
LDFLAGS=-ldflags "$(BASE_LDFLAGS) $(EXTRA_LDFLAGS)"
# Go variables
GO?=go
GOFLAGS?=
BUILD_FLAGS?=-trimpath -buildvcs=false
COMPRESS_BINARY?=0
UPX_FLAGS?=--best --lzma
# Linux slim build knobs (opt-in, keeps default behavior unchanged)
LINUX_SLIM_TAGS?=purego,netgo,osusergo
LINUX_SLIM_CGO?=0
LINUX_SLIM_LDFLAGS?=-buildid=
LINUX_SLIM_BUILD_FLAGS?=-trimpath -buildvcs=false -tags "$(LINUX_SLIM_TAGS)"
LINUX_SLIM_PATH=$(BUILD_DIR)/$(BINARY_NAME)-linux-$(ARCH)-slim
# Cross-platform build matrix (space-separated GOOS/GOARCH pairs)
BUILD_TARGETS?=linux/amd64 linux/arm64 linux/riscv64 darwin/amd64 darwin/arm64 windows/amd64 windows/arm64
CHANNELS?=telegram discord feishu maixcam qq dingtalk whatsapp
CHANNEL_PACKAGE_VARIANTS?=full none $(CHANNELS)
empty:=
space:=$(empty) $(empty)
comma:=,
ALL_CHANNEL_OMIT_TAGS=$(subst $(space),$(comma),$(addprefix omit_,$(CHANNELS)))
FULL_BUILD_TAGS=with_tui
NOCHANNELS_TAGS=$(ALL_CHANNEL_OMIT_TAGS),with_tui
# Installation
INSTALL_PREFIX?=/usr/local
INSTALL_BIN_DIR=$(INSTALL_PREFIX)/bin
INSTALL_MAN_DIR=$(INSTALL_PREFIX)/share/man/man1
# Workspace and Skills
USER_HOME:=$(if $(SUDO_USER),$(shell eval echo ~$(SUDO_USER)),$(HOME))
CLAWGO_HOME?=$(USER_HOME)/.clawgo
WORKSPACE_DIR?=$(CLAWGO_HOME)/workspace
WORKSPACE_SKILLS_DIR=$(WORKSPACE_DIR)/skills
BUILTIN_SKILLS_DIR=$(CURDIR)/skills
WORKSPACE_SOURCE_DIR=$(CURDIR)/workspace
EMBED_WORKSPACE_DIR=$(CURDIR)/cmd/workspace
DEV_CONFIG?=$(if $(wildcard $(CURDIR)/config.json),$(CURDIR)/config.json,$(CLAWGO_HOME)/config.json)
DEV_ARGS?=--debug gateway run
DEV_WORKSPACE?=$(WORKSPACE_DIR)
# OS detection
UNAME_S:=$(shell uname -s)
UNAME_M:=$(shell uname -m)
# Platform-specific settings
ifeq ($(UNAME_S),Linux)
PLATFORM=linux
ifeq ($(UNAME_M),x86_64)
ARCH=amd64
else ifeq ($(UNAME_M),aarch64)
ARCH=arm64
else ifeq ($(UNAME_M),riscv64)
ARCH=riscv64
else
ARCH=$(UNAME_M)
endif
else ifeq ($(UNAME_S),Darwin)
PLATFORM=darwin
ifeq ($(UNAME_M),x86_64)
ARCH=amd64
else ifeq ($(UNAME_M),arm64)
ARCH=arm64
else
ARCH=$(UNAME_M)
endif
else
PLATFORM=$(UNAME_S)
ARCH=$(UNAME_M)
endif
BINARY_PATH=$(BUILD_DIR)/$(BINARY_NAME)-$(PLATFORM)-$(ARCH)
# Default target
all: build
## build: Build the clawgo binary for current platform
build: sync-embed-workspace
@echo "Building $(BINARY_NAME) for $(PLATFORM)/$(ARCH)..."
@mkdir -p $(BUILD_DIR)
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
$(GO) build $(GOFLAGS) $(BUILD_FLAGS) -tags "$(FULL_BUILD_TAGS)" $(LDFLAGS) -o $(BINARY_PATH) ./$(CMD_DIR); \
if [ "$(COMPRESS_BINARY)" = "1" ]; then \
if command -v upx >/dev/null 2>&1; then \
upx $(UPX_FLAGS) "$(BINARY_PATH)" >/dev/null; \
echo "Compressed binary with upx ($(UPX_FLAGS))"; \
else \
echo "Warning: COMPRESS_BINARY=1 but upx not found, skipping compression"; \
fi; \
fi
@echo "Build complete: $(BINARY_PATH)"
@ln -sf $(BINARY_NAME)-$(PLATFORM)-$(ARCH) $(BUILD_DIR)/$(BINARY_NAME)
## build-variants: Build current-platform full, no-channel, and per-channel binaries
build-variants: sync-embed-workspace
@echo "Building channel variants for $(PLATFORM)/$(ARCH): $(CHANNEL_PACKAGE_VARIANTS)"
@mkdir -p $(BUILD_DIR)
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
for variant in $(CHANNEL_PACKAGE_VARIANTS); do \
tags=""; \
suffix=""; \
if [ "$$variant" = "none" ]; then \
tags="$(NOCHANNELS_TAGS)"; \
suffix="-nochannels"; \
elif [ "$$variant" = "full" ]; then \
tags="$(FULL_BUILD_TAGS)"; \
elif [ "$$variant" != "full" ]; then \
for ch in $(CHANNELS); do \
if [ "$$ch" != "$$variant" ]; then \
tags="$${tags:+$$tags,}omit_$$ch"; \
fi; \
done; \
suffix="-$$variant"; \
fi; \
out="$(BUILD_DIR)/$(BINARY_NAME)-$(PLATFORM)-$(ARCH)$$suffix"; \
echo " -> $$variant"; \
if [ -n "$$tags" ]; then \
$(GO) build $(GOFLAGS) $(BUILD_FLAGS) -tags "$$tags" $(LDFLAGS) -o "$$out" ./$(CMD_DIR); \
else \
$(GO) build $(GOFLAGS) $(BUILD_FLAGS) $(LDFLAGS) -o "$$out" ./$(CMD_DIR); \
fi; \
if [ "$(COMPRESS_BINARY)" = "1" ] && command -v upx >/dev/null 2>&1; then \
upx $(UPX_FLAGS) "$$out" >/dev/null; \
fi; \
done
@echo "Variant builds complete: $(BUILD_DIR)"
## build-linux-slim: Build a Linux-only slim binary (no feature trimming, no channel disabling)
build-linux-slim: sync-embed-workspace
@echo "Building $(BINARY_NAME) slim profile for linux/$(ARCH)..."
@mkdir -p $(BUILD_DIR)
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
CGO_ENABLED=$(LINUX_SLIM_CGO) GOOS=linux GOARCH=$(ARCH) $(GO) build $(GOFLAGS) $(LINUX_SLIM_BUILD_FLAGS) -ldflags "$(BASE_LDFLAGS) $(EXTRA_LDFLAGS) $(LINUX_SLIM_LDFLAGS)" -o $(LINUX_SLIM_PATH) ./$(CMD_DIR); \
if [ "$(COMPRESS_BINARY)" = "1" ]; then \
if command -v upx >/dev/null 2>&1; then \
upx $(UPX_FLAGS) "$(LINUX_SLIM_PATH)" >/dev/null; \
echo "Compressed slim binary with upx ($(UPX_FLAGS))"; \
else \
echo "Warning: COMPRESS_BINARY=1 but upx not found, skipping compression"; \
fi; \
fi
@echo "Build complete: $(LINUX_SLIM_PATH)"
## build-all: Build clawgo for all configured platforms (override with BUILD_TARGETS="linux/amd64 ...")
build-all: sync-embed-workspace
@echo "Building for multiple platforms: $(BUILD_TARGETS)"
@mkdir -p $(BUILD_DIR)
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
for target in $(BUILD_TARGETS); do \
goos="$${target%/*}"; \
goarch="$${target#*/}"; \
out="$(BUILD_DIR)/$(BINARY_NAME)-$$goos-$$goarch"; \
if [ "$$goos" = "windows" ]; then out="$$out.exe"; fi; \
echo " -> $$goos/$$goarch"; \
CGO_ENABLED=0 GOOS=$$goos GOARCH=$$goarch $(GO) build $(GOFLAGS) $(BUILD_FLAGS) -tags "$(FULL_BUILD_TAGS)" $(LDFLAGS) -o "$$out" ./$(CMD_DIR); \
if [ "$(COMPRESS_BINARY)" = "1" ] && command -v upx >/dev/null 2>&1; then \
upx $(UPX_FLAGS) "$$out" >/dev/null; \
fi; \
done
@echo "All builds complete"
## build-all-variants: Build full, no-channel, and per-channel binaries for all configured platforms
build-all-variants: sync-embed-workspace
@echo "Building all channel variants for multiple platforms: $(BUILD_TARGETS)"
@mkdir -p $(BUILD_DIR)
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
for target in $(BUILD_TARGETS); do \
goos="$${target%/*}"; \
goarch="$${target#*/}"; \
for variant in $(CHANNEL_PACKAGE_VARIANTS); do \
tags=""; \
suffix=""; \
if [ "$$variant" = "none" ]; then \
tags="$(NOCHANNELS_TAGS)"; \
suffix="-nochannels"; \
elif [ "$$variant" = "full" ]; then \
tags="$(FULL_BUILD_TAGS)"; \
elif [ "$$variant" != "full" ]; then \
for ch in $(CHANNELS); do \
if [ "$$ch" != "$$variant" ]; then \
tags="$${tags:+$$tags,}omit_$$ch"; \
fi; \
done; \
suffix="-$$variant"; \
fi; \
out="$(BUILD_DIR)/$(BINARY_NAME)-$$goos-$$goarch$$suffix"; \
if [ "$$goos" = "windows" ]; then out="$$out.exe"; fi; \
echo " -> $$goos/$$goarch [$$variant]"; \
if [ -n "$$tags" ]; then \
CGO_ENABLED=0 GOOS=$$goos GOARCH=$$goarch $(GO) build $(GOFLAGS) $(BUILD_FLAGS) -tags "$$tags" $(LDFLAGS) -o "$$out" ./$(CMD_DIR); \
else \
CGO_ENABLED=0 GOOS=$$goos GOARCH=$$goarch $(GO) build $(GOFLAGS) $(BUILD_FLAGS) $(LDFLAGS) -o "$$out" ./$(CMD_DIR); \
fi; \
if [ "$(COMPRESS_BINARY)" = "1" ] && command -v upx >/dev/null 2>&1; then \
upx $(UPX_FLAGS) "$$out" >/dev/null; \
fi; \
done; \
done
@echo "All variant builds complete"
## package-all: Create compressed archives and checksums for full, no-channel, and per-channel build variants
package-all: build-all-variants
@echo "Packaging build artifacts..."
@set -e; cd $(BUILD_DIR); \
for target in $(BUILD_TARGETS); do \
goos="$${target%/*}"; \
goarch="$${target#*/}"; \
for variant in $(CHANNEL_PACKAGE_VARIANTS); do \
suffix=""; \
archive_suffix=""; \
if [ "$$variant" = "none" ]; then \
suffix="-nochannels"; \
archive_suffix="-nochannels"; \
elif [ "$$variant" != "full" ]; then \
suffix="-$$variant"; \
archive_suffix="-$$variant"; \
fi; \
bin="$(BINARY_NAME)-$$goos-$$goarch$$suffix"; \
if [ "$$goos" = "windows" ]; then \
bin="$$bin.exe"; \
archive="$(BINARY_NAME)-$$goos-$$goarch$$archive_suffix.zip"; \
zip -q -j "$$archive" "$$bin"; \
else \
archive="$(BINARY_NAME)-$$goos-$$goarch$$archive_suffix.tar.gz"; \
tar -czf "$$archive" "$$bin"; \
fi; \
done; \
done
@set -e; cd $(BUILD_DIR); \
if command -v sha256sum >/dev/null 2>&1; then \
sha256sum *.tar.gz *.zip 2>/dev/null | tee checksums.txt || true; \
elif command -v shasum >/dev/null 2>&1; then \
shasum -a 256 *.tar.gz *.zip 2>/dev/null | tee checksums.txt || true; \
fi
@echo "Package complete: $(BUILD_DIR)"
## sync-embed-workspace: Sync workspace seed files into cmd/workspace for go:embed
sync-embed-workspace:
@echo "✓ Embed assets ready in $(EMBED_WORKSPACE_DIR)"
@if [ ! -d "$(WORKSPACE_SOURCE_DIR)" ]; then \
echo "✗ Missing source workspace directory: $(WORKSPACE_SOURCE_DIR)"; \
exit 1; \
fi
@echo "Syncing workspace seed files for embedding..."
@mkdir -p "$(EMBED_WORKSPACE_DIR)"
@rsync -a --delete "$(WORKSPACE_SOURCE_DIR)/" "$(EMBED_WORKSPACE_DIR)/"
@echo "✓ Synced workspace to $(EMBED_WORKSPACE_DIR)"
## cleanup-embed-workspace: Remove synced embed workspace artifacts
cleanup-embed-workspace:
@if [ -d "$(EMBED_WORKSPACE_DIR)" ]; then \
find "$(EMBED_WORKSPACE_DIR)" -mindepth 1 ! -name 'embedkeep.txt' -exec rm -rf {} +; \
fi
@echo "✓ Cleaned embedded workspace artifacts"
## install: Install clawgo to system and copy builtin skills
install: build
@echo "Installing $(BINARY_NAME)..."
@mkdir -p "$(INSTALL_BIN_DIR)"
@set -e; \
PID_FILE="$(CLAWGO_HOME)/gateway.pid"; \
if [ -f "$$PID_FILE" ]; then \
PID="$$(cat "$$PID_FILE" 2>/dev/null || true)"; \
if [ -n "$$PID" ] && kill -0 "$$PID" 2>/dev/null; then \
echo "Detected running $(BINARY_NAME) process (PID=$$PID), stopping..."; \
kill "$$PID" 2>/dev/null || true; \
for _i in 1 2 3 4 5; do \
if ! kill -0 "$$PID" 2>/dev/null; then \
break; \
fi; \
sleep 1; \
done; \
if kill -0 "$$PID" 2>/dev/null; then \
echo "Process still running, force killing PID=$$PID..."; \
kill -9 "$$PID" 2>/dev/null || true; \
fi; \
fi; \
rm -f "$$PID_FILE"; \
fi; \
RUNNING_PIDS="$$(pgrep -x $(BINARY_NAME) 2>/dev/null || true)"; \
if [ -n "$$RUNNING_PIDS" ]; then \
echo "Detected additional running $(BINARY_NAME) process(es): $$RUNNING_PIDS, stopping..."; \
kill $$RUNNING_PIDS 2>/dev/null || true; \
sleep 1; \
RUNNING_PIDS="$$(pgrep -x $(BINARY_NAME) 2>/dev/null || true)"; \
if [ -n "$$RUNNING_PIDS" ]; then \
echo "Force killing remaining process(es): $$RUNNING_PIDS"; \
kill -9 $$RUNNING_PIDS 2>/dev/null || true; \
fi; \
fi; \
BIN_PATH="$(INSTALL_BIN_DIR)/$(BINARY_NAME)"; \
OVERWRITE_BIN="y"; \
RESET_WORKSPACE="n"; \
if [ -f "$$BIN_PATH" ]; then \
printf "Detected existing binary at %s. Overwrite executable? (y/n): " "$$BIN_PATH"; \
read -r OVERWRITE_BIN; \
printf "Reset workspace at %s (delete and reload)? (y/n): " "$(WORKSPACE_DIR)"; \
read -r RESET_WORKSPACE; \
fi; \
if [ "$$OVERWRITE_BIN" = "y" ]; then \
cp "$(BUILD_DIR)/$(BINARY_NAME)" "$$BIN_PATH"; \
chmod +x "$$BIN_PATH"; \
echo "Installed binary to $$BIN_PATH"; \
else \
echo "Skipped binary overwrite."; \
fi; \
if [ "$$RESET_WORKSPACE" = "y" ]; then \
echo "Resetting workspace: $(WORKSPACE_DIR)"; \
rm -rf "$(WORKSPACE_DIR)"; \
mkdir -p "$(WORKSPACE_DIR)"; \
rsync -a "$(WORKSPACE_SOURCE_DIR)/" "$(WORKSPACE_DIR)/"; \
echo "Workspace reloaded from $(WORKSPACE_SOURCE_DIR)"; \
fi
@echo "Installation complete!"
## install-user: Install clawgo to ~/.local and copy builtin skills
install-user:
@$(MAKE) install INSTALL_PREFIX=$(USER_HOME)/.local
## install-win: Prepare Windows install bundle (binary + PowerShell installer)
install-win: build-all
@echo "Preparing Windows install bundle..."
@mkdir -p "$(BUILD_DIR)/windows-install"
@cp "$(BUILD_DIR)/$(BINARY_NAME)-windows-amd64.exe" "$(BUILD_DIR)/windows-install/$(BINARY_NAME).exe"
@printf '%s\n' \
'$ErrorActionPreference = "Stop"' \
'$targetDir = Join-Path $$env:USERPROFILE ".clawgo\\bin"' \
'New-Item -ItemType Directory -Force -Path $$targetDir | Out-Null' \
'Copy-Item -Force ".\\clawgo.exe" (Join-Path $$targetDir "clawgo.exe")' \
'$$userPath = [Environment]::GetEnvironmentVariable("Path", "User")' \
'if (-not ($$userPath -split ";" | Where-Object { $$_ -eq $$targetDir })) {' \
' [Environment]::SetEnvironmentVariable("Path", "$$userPath;$$targetDir", "User")' \
'}' \
'Write-Host "Installed clawgo to $$targetDir"' \
'Write-Host "Reopen terminal then run: clawgo status"' \
> "$(BUILD_DIR)/windows-install/install-win.ps1"
@echo "✓ Bundle ready: $(BUILD_DIR)/windows-install"
@echo "Windows usage: copy folder to Windows, run PowerShell as user: ./install-win.ps1"
## uninstall: Remove clawgo from system
uninstall:
@echo "Uninstalling $(BINARY_NAME)..."
@rm -f $(INSTALL_BIN_DIR)/$(BINARY_NAME)
@echo "Removed binary from $(INSTALL_BIN_DIR)/$(BINARY_NAME)"
@echo "Note: Only the executable file has been deleted."
@echo "If you need to delete all configurations (config.json, workspace, etc.), run 'make uninstall-all'"
## uninstall-all: Remove clawgo and all data
uninstall-all:
@echo "Removing workspace and skills..."
@rm -rf $(CLAWGO_HOME)
@echo "Removed workspace: $(CLAWGO_HOME)"
@echo "Complete uninstallation done!"
## clean: Remove build artifacts
clean:
@echo "Cleaning build artifacts..."
@rm -rf $(BUILD_DIR)
@echo "Clean complete"
## test: Run Go tests without leaving build artifacts (cleans embed workspace and test cache)
test: sync-embed-workspace
@echo "Running tests..."
@set -e; trap '$(MAKE) cleanup-embed-workspace clean-test-artifacts' EXIT; \
$(GO) test ./...
## test-only: Backward-compatible alias for Go tests
test-only: test
## clean-test-artifacts: Remove test caches/artifacts generated by go test
clean-test-artifacts:
@$(GO) clean -testcache
## deps: Update dependencies
deps:
@$(GO) get -u ./...
@$(GO) mod tidy
## run: Build and run clawgo
run: build
@$(BUILD_DIR)/$(BINARY_NAME) $(ARGS)
## dev: Sync workspace and run the local gateway in foreground for debugging
dev: sync-embed-workspace
@if [ ! -f "$(DEV_CONFIG)" ]; then \
echo "✗ Missing config file: $(DEV_CONFIG)"; \
echo " Override with: make dev DEV_CONFIG=/path/to/config.json"; \
exit 1; \
fi
@set -e; trap '$(MAKE) -C $(CURDIR) cleanup-embed-workspace' EXIT; \
echo "Starting local gateway debug session..."; \
echo " Config: $(DEV_CONFIG)"; \
echo " Workspace: $(DEV_WORKSPACE)"; \
echo " Args: $(DEV_ARGS)"; \
CLAWGO_CONFIG="$(DEV_CONFIG)" $(GO) run $(GOFLAGS) ./$(CMD_DIR) $(DEV_ARGS)
## test-docker: Build and compile-check in Docker (Dockerfile.test)
test-docker: sync-embed-workspace
@echo "Running Docker compile test..."
@set -e; trap '$(MAKE) cleanup-embed-workspace' EXIT; \
docker build -f Dockerfile.test -t clawgo:test .
@echo "Docker compile test passed"
## help: Show this help message
help:
@echo "clawgo Makefile"
@echo ""
@echo "Usage:"
@echo " make [target]"
@echo ""
@echo "Targets:"
@grep -E '^## ' $(MAKEFILE_LIST) | sed 's/## / /'
@echo ""
@echo "Examples:"
@echo " make build # Build for current platform"
@echo " make dev # Run local gateway in foreground with debug logs"
@echo " make install # Install to /usr/local/bin"
@echo " make install-user # Install to ~/.local/bin"
@echo " make uninstall # Remove from /usr/local/bin"
@echo " make install-skills # Install skills to workspace"
@echo ""
@echo "Environment Variables:"
@echo " INSTALL_PREFIX # Installation prefix (default: /usr/local)"
@echo " WORKSPACE_DIR # Workspace directory (default: ~/.clawgo/workspace)"
@echo " DEV_CONFIG # Config path for make dev"
@echo " DEV_ARGS # CLI args for make dev (default: --debug gateway run)"
@echo " DEV_WORKSPACE # Workspace path used by make dev"
@echo " VERSION # Version string (default: git describe)"
@echo " STRIP_SYMBOLS # 1=strip debug/symbol info (default: 1)"
@echo ""
@echo "Current Configuration:"
@echo " Platform: $(PLATFORM)/$(ARCH)"
@echo " Binary: $(BINARY_PATH)"
@echo " Install Prefix: $(INSTALL_PREFIX)"
@echo " Workspace: $(WORKSPACE_DIR)"