CircleCI plugin support

[ewega]

Summary

Add CircleCI as a supported DevOps tool in the CLI. CircleCI is a popular cloud CI/CD platform providing build and deployment data for DORA metrics (deployment frequency, change failure rate).

Upstream Plugin

circleci in incubator-devlake/backend/plugins/circleci/

Property	Value
Plugin slug	circleci
Auth	AccessToken (custom header: Circle-Token)
Scope type	Projects (Id string, includes Slug and OrganizationId)
Scope ID field	id
Default endpoint	https://circleci.com/api/v2/
Remote-scope API	Yes
Connection test	Yes

Dependencies

Blocked by:

• Generic scope ID extraction and remote-scope API client #86 — Scope ID extraction (needs ScopeIDField)

Not blocked by #85 — CircleCI uses AccessToken, compatible with current auth model. The custom header format (Circle-Token) is handled by the DevLake backend.

Changes

• Add ConnectionDef for circleci in connectionRegistry:
  • Endpoint: "https://circleci.com/api/v2/"
  • SupportsTest: true
  • TokenPrompt: "CircleCI personal API token"
  • EnvVarNames: []string{"CIRCLECI_TOKEN", "CIRCLE_TOKEN"}
  • EnvFileKeys: []string{"CIRCLECI_TOKEN", "CIRCLE_TOKEN"}
  • ScopeIDField: "id"
  • ScopeFunc: scopeCircleCIHandler
• Implement scopeCircleCIHandler:
  • Use client.ListRemoteScopes("circleci", connID, "", "") to list projects
  • Let user select projects interactively
  • PUT selected projects as scopes
• Set Available: true

Acceptance Criteria

• gh devlake configure connection add --plugin circleci creates a CircleCI connection
• CircleCI appears in interactive plugin picker
• CircleCI scopes list projects for selection
• Connection test works
• go build ./..., go test ./..., go vet ./... pass

[ewega]

@codex[agent] Please implement CircleCI plugin support now from latest main. Add the ConnectionDef, implement the scope handler via DevLake remote scopes, keep all behavior registry-driven, add tests, update README/docs, run go build ./..., go test ./..., and go vet ./..., and open a PR that closes #92.

[ewega]

Implemented and merged. CircleCI is now a fully available plugin in the CLI.

Merged PR:

• PR Addressing PR comments #136 — Add CircleCI plugin support (branch codex/add-circleci-plugin-support): circleci ConnectionDef with Available: true, ScopeIDField: "id", scopeCircleCIHandler for listing/selecting projects via remote scopes, tests, docs

All acceptance criteria satisfied: --plugin circleci connection creation, interactive plugin picker, project scope browsing, connection test, and CI gates pass.