GO ?= go # 版本号的唯一来源是仓库根的 CHANGELOG.md(正本 §6.1:版本号只有一个来源)。 # 刻意**不用** `git describe --tags`:CI 检出是 `git fetch --depth 50`,取不到 tag, # 那会让版本号在本地正常、在 CI 上静默退化(见 docs/agents/traps.md trap-5)。 VERSION ?= $(shell python3 scripts/version.py 2>/dev/null || echo dev) COMMIT_SHA ?= $(shell git rev-parse --short=12 HEAD 2>/dev/null || echo unknown) BUILD_TIME ?= $(shell date -u +%Y-%m-%dT%H:%M:%SZ) LDFLAGS := -X knowledge-governance/internal/version.Number=$(VERSION) -X knowledge-governance/internal/version.CommitSHA=$(COMMIT_SHA) -X knowledge-governance/internal/version.BuildTime=$(BUILD_TIME) .PHONY: test vet build web-test web-typecheck web-build verify version changelog-check version-contract image test: $(GO) test ./... vet: $(GO) vet ./... build: $(GO) build -trimpath -ldflags "$(LDFLAGS)" ./cmd/... web-test: npm --prefix web test web-typecheck: npm --prefix web run typecheck web-build: npm --prefix web run build # 本地门禁:一条命令跑完、**串行**、失败即停(正本 §3.1)。CI 的 build 作业跑同一套。 verify: changelog-check test vet build version-contract web-test web-typecheck web-build # 打印当前版本号(唯一来源:CHANGELOG.md 顶部那个已发布版本) version: @python3 scripts/version.py # 变更记录结构自检:每个已发布版本都必须有「改了什么」「怎么验收」两节 changelog-check: @python3 scripts/check_changelog.py # 版本契约:注入进二进制的号必须等于 CHANGELOG 顶部(不注入时该用例会 SKIP,属正常) version-contract: $(GO) test -ldflags "$(LDFLAGS)" -run TestNumberMatchesChangelog -v ./internal/version/... # 构建镜像。三个 build-arg 必须显式传入 —— 不传就落成 dev/unknown(故意的: # 一个显眼的 dev 好过一个看起来正常的假版本号)。compose.yaml 的 args 透传见 PR TODO。 image: docker build --build-arg VERSION=$(VERSION) --build-arg COMMIT_SHA=$(COMMIT_SHA) \ --build-arg BUILD_TIME=$(BUILD_TIME) -t knowledge-governance-p1:$(VERSION)-$(COMMIT_SHA) .