Rename generate target to proto; dev data dir run/ -> srv/

Aligns with the platform engineering standards.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
2026-09-20 15:04:45 -07:00
co-authored by Claude Fable 5.1
parent a1250d05ee
commit e01b45a921
6 changed files with 15 additions and 15 deletions
+2 -2
View File
@@ -34,8 +34,8 @@ clients/python/.pytest_cache/
clients/python/*.egg-info/ clients/python/*.egg-info/
clients/lisp/**/*.fasl clients/lisp/**/*.fasl
# manual testing # local development data
run/ srv/
.env .env
/cmd/mciasctl/mciasctl /cmd/mciasctl/mciasctl
/cmd/mciasdb/mciasdb /cmd/mciasdb/mciasdb
+1 -1
View File
@@ -1290,7 +1290,7 @@ The Makefile `docker` target automates the build step with the version tag.
| `build` | Compile all binaries to `bin/` using current GOOS/GOARCH | | `build` | Compile all binaries to `bin/` using current GOOS/GOARCH |
| `test` | `go test -race ./...` | | `test` | `go test -race ./...` |
| `lint` | `golangci-lint run ./...` | | `lint` | `golangci-lint run ./...` |
| `generate` | `go generate ./...` (re-generates proto stubs) | | `proto` | `go generate ./...` (re-generates proto stubs) |
| `man` | Build man pages; compress to `.gz` in `man/` | | `man` | Build man pages; compress to `.gz` in `man/` |
| `install` | Run `dist/install.sh` | | `install` | Run `dist/install.sh` |
| `docker` | `docker build -t mcias:$(VERSION) -t mcias:latest .` | | `docker` | `docker build -t mcias:$(VERSION) -t mcias:latest .` |
+9 -9
View File
@@ -6,11 +6,11 @@
# make vet — run go vet # make vet — run go vet
# make lint — run golangci-lint # make lint — run golangci-lint
# make all — vet → lint → test → build (CI pipeline) # make all — vet → lint → test → build (CI pipeline)
# make generate — regenerate protobuf stubs (requires protoc) # make proto — regenerate protobuf stubs (requires protoc)
# make proto-lint — lint proto files with buf # make proto-lint — lint proto files with buf
# make man — build compressed man pages # make man — build compressed man pages
# make install — run deploy/scripts/install.sh (requires root) # make install — run deploy/scripts/install.sh (requires root)
# make devserver — build and run mciassrv against run/ config # make devserver — build and run mciassrv against srv/ config
# make clean — remove bin/ and generated artifacts # make clean — remove bin/ and generated artifacts
# make dist — build release tarballs for linux/amd64 and linux/arm64 # make dist — build release tarballs for linux/amd64 and linux/arm64
# make docker — build Docker image tagged mcias:$(VERSION) and mcias:latest # make docker — build Docker image tagged mcias:$(VERSION) and mcias:latest
@@ -95,19 +95,19 @@ proto-lint:
buf breaking --against '.git#branch=master,subdir=proto' buf breaking --against '.git#branch=master,subdir=proto'
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
# generate — regenerate protobuf stubs from proto/ definitions # proto — regenerate protobuf stubs from proto/ definitions
# Requires: protoc, protoc-gen-go, protoc-gen-go-grpc # Requires: protoc, protoc-gen-go, protoc-gen-go-grpc
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
.PHONY: generate .PHONY: proto
generate: proto:
$(GO) generate ./... $(GO) generate ./...
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
# devserver — build and run mciassrv against the local run/ config # devserver — build and run mciassrv against the local srv/ config
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
.PHONY: devserver .PHONY: devserver
devserver: build devserver: build
$(BIN_DIR)/mciassrv -config run/mcias.conf $(BIN_DIR)/mciassrv -config srv/mcias.conf
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
# man — build compressed man pages # man — build compressed man pages
@@ -195,8 +195,8 @@ help:
@echo " vet Run go vet" @echo " vet Run go vet"
@echo " lint Run golangci-lint" @echo " lint Run golangci-lint"
@echo " proto-lint Lint proto files with buf" @echo " proto-lint Lint proto files with buf"
@echo " generate Regenerate protobuf stubs" @echo " proto Regenerate protobuf stubs"
@echo " devserver Build and run mciassrv against run/ config" @echo " devserver Build and run mciassrv against srv/ config"
@echo " man Build compressed man pages" @echo " man Build compressed man pages"
@echo " install Install to /usr/local/bin (requires root)" @echo " install Install to /usr/local/bin (requires root)"
@echo " clean Remove build artifacts" @echo " clean Remove build artifacts"
+1 -1
View File
@@ -823,7 +823,7 @@ ARCHITECTURE.md for future implementation.
--- ---
**Makefile** **Makefile**
- Targets: build, test, lint, generate, man, install, clean, dist, docker - Targets: build, test, lint, proto, man, install, clean, dist, docker
- build: compiles all four binaries to bin/ with CGO_ENABLED=1 and - build: compiles all four binaries to bin/ with CGO_ENABLED=1 and
-trimpath -ldflags="-s -w" -trimpath -ldflags="-s -w"
- dist: cross-compiled tarballs for linux/amd64 and linux/arm64 - dist: cross-compiled tarballs for linux/amd64 and linux/arm64
+1 -1
View File
@@ -472,7 +472,7 @@ See ARCHITECTURE.md §18 for full design rationale and artifact inventory.
- `build` — compile all binaries to `bin/` - `build` — compile all binaries to `bin/`
- `test``go test -race ./...` - `test``go test -race ./...`
- `lint``golangci-lint run ./...` - `lint``golangci-lint run ./...`
- `generate``go generate ./...` (proto stubs from Phase 7) - `proto``go generate ./...` (proto stubs from Phase 7)
- `man` — build compressed man pages - `man` — build compressed man pages
- `install` — run `dist/install.sh` - `install` — run `dist/install.sh`
- `docker``docker build -t mcias:$(VERSION) -t mcias:latest .` - `docker``docker build -t mcias:$(VERSION) -t mcias:latest .`
+1 -1
View File
@@ -161,7 +161,7 @@ curl -k https://mcias.metacircular.net:8443/v1/health
make build # compile all binaries to bin/ make build # compile all binaries to bin/
make test # go test -race ./... make test # go test -race ./...
make lint # golangci-lint run ./... make lint # golangci-lint run ./...
make generate # regenerate protobuf stubs (requires protoc) make proto # regenerate protobuf stubs (requires protoc)
make man # build compressed man pages make man # build compressed man pages
make clean # remove bin/ and generated artifacts make clean # remove bin/ and generated artifacts
make dist # cross-compiled tarballs for linux/amd64 and linux/arm64 make dist # cross-compiled tarballs for linux/amd64 and linux/arm64