feat(proto): add agent.proto contract + buf toolchain (tsk_V9IrIk2g5Q78)
Introduces the frozen control-plane ↔ agent gRPC contract and the full
buf v2 code-generation pipeline that task #6/#14/#15 depend on.
Changes:
- server/proto/pangolin/agent/v1/agent.proto: AgentService with 6 RPCs
(Enroll, Register, Heartbeat, Subscribe, Ack, ReportUsage) and all
supporting message types (Command + 5 payload variants, ConfigSnapshot,
CredentialEntry, NodeLoad, UsageItem). Red-line comments prohibit
user_id/email and destination-address fields per privacy policy.
- server/buf.yaml: v2 format, STANDARD lint + FILE breaking rules.
- server/buf.gen.yaml: remote protoc-gen-go v1.36.4 + protoc-gen-go-grpc
v1.5.1 plugins, out=internal/pb, paths=source_relative.
- server/internal/pb/pangolin/agent/v1/: generated agent.pb.go +
agent_grpc.pb.go committed to repo (CI diff-clean verified).
- server/Makefile: proto / proto-lint / proto-breaking targets added.
- server/tools.go: buf v1.70.0, protoc-gen-go, protoc-gen-go-grpc pinned.
- server/go.mod / go.sum: buf and grpc tool deps added via go mod tidy.
Acceptance verified:
buf lint → zero warnings
buf generate × 2 → git diff clean (idempotent)
go build ./... → passes
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
wangjia
6e2657049e