Welcome to the Bluefly.io code repository. By logging in, you agree to comply with our terms of service and code of conduct.

Skip to content

Migrate apidog-sync Service to agent-router and agent-buildkit

Objective

Move apidog-sync from technical-guide to its logical homes: runtime service in agent-router, CLI commands in agent-buildkit.

Tasks

agent-router (Runtime Integration)

  • Move `apidog-sync/src/services/` → `agent-router/src/services/apidog/`
  • Move `apidog-sync/src/controllers/` → `agent-router/src/api/controllers/apidog/`
  • Move `apidog-sync/proto/batch-import.proto` → `agent-router/proto/apidog/`
  • Move `apidog-sync/src/grpc/` → `agent-router/src/grpc/apidog/`
  • Integrate with existing OpenTelemetry and Prometheus
  • Serve endpoints at `/api/v1/apidog/*`
  • Update agent-router OpenAPI spec

agent-buildkit (CLI Commands)

  • Add `buildkit apidog sync` command
  • Add `buildkit apidog validate` command
  • Add `buildkit apidog publish` command
  • Commands delegate to agent-router service or use Apidog API directly

Testing

  • Contract tests for new endpoints
  • Integration tests for gRPC streaming
  • CLI command tests

Related

  • Epic: #1
  • Next: #3 (design-system-api migration)

Files to Move

``` apidog-sync/ ├── src/services/ → agent-router/src/services/apidog/ ├── src/controllers/ → agent-router/src/api/controllers/apidog/ ├── src/grpc/ → agent-router/src/grpc/apidog/ ├── proto/ → agent-router/proto/apidog/ └── openapi/ → agent-router/openapi/apidog-integration.yaml ```