phase 1 core platform
Milestone 1.1.2: Auth Protobuf and Codegen — complete.
Milestone 1.1.2: Auth Protobuf and Codegen
Status: Complete
Goal: 1.1 Persistence and auth data plane
Summary
Add ibex.auth.v1 protobuf definitions for token validation (and future auth RPCs), register in Buf module, document local buf generate for Go stubs without committing gen/.
Branch
chore/m1-1-2-auth-proto-codegen (merged)
PR title (example)
chore(proto): auth protobuf and codegen (m1.1.2)
Estimated effort
2 days
Prerequisites
- 1.1.1 merged (schema exists for later implementation)
Tasks
- ADR-0006: auth proto package layout, RPC naming, error model
- Create
packages/proto/proto/ibex/auth/v1/auth.protowithAuthService:-
ValidateToken(ValidateTokenRequest) returns (ValidateTokenResponse) - Messages: token string, org_id, agent_id optional, permission bitmap, expiry
-
go_packageoption aligned with ADR-0004
-
- Update
packages/proto/buf.yaml/ lint if needed for new package - Update
packages/proto/buf.gen.yamlfor Go output path underpackages/proto/gen/go/... - Document local generation in
packages/proto/README.md - CI:
buf lintincludes auth package; breaking check againstmainbaseline - Add
.gitignoreconfirmation forgen/(already policy) - Optional:
make proto-gentarget (local only) in dev-tool.sh - Contract tests:
make proto-test,make proto-test-integration; CIproto-contractjob
Files affected
| Path | Action |
|---|---|
packages/proto/proto/ibex/auth/v1/auth.proto | Add |
packages/proto/README.md | Update |
docs/adr/ADR-0006-auth-proto-contract.md | Add |
docs/API_DOCUMENTATION.md | gRPC section reference if internal API documented |
infra/scripts/dev-tool.sh | Optional proto-gen |
packages/proto/auth_contract_test.go | Add |
packages/proto/auth_contract_integration_test.go | Add |
Testing requirements
buf lintpassbuf breakingpass against main (after first merge, baseline exists)- No generated files committed
make proto-testandmake proto-test-integrationpass
Documentation updates
- ADR-0006
- packages/proto/README.md
- roadmap CURRENT_STATE after merge
Definition of done
- Auth proto reviewed against ARCHITECTURE.md auth validation pipeline
- Buf CI green
- Local
buf generateproduces importable Go stubs for auth service work - No service implementation in this PR
- Contract unit and integration tests in CI
Risks
| Risk | Mitigation |
|---|---|
| Proto churn before implementation | Keep v1 minimal; breaking changes via buf breaking |
| Import path mismatch | Match root module github.com/Rick1330/ibex-harness/... |
Merge
Edit on GitHub
Last updated on