Files
kandev/docs/plans/gitlab-integration-parity/task-01-workspace-connection.md
T
2026-08-24 11:09:03 +00:00

92 lines
4.0 KiB
Markdown

---
id: "01-workspace-connection"
title: "Workspace-scoped GitLab connection"
status: done
wave: 1
depends_on: []
plan: "plan.md"
spec: "../../specs/integrations/requirements/gitlab-integration.md"
---
# Task 01: Workspace-Scoped GitLab Connection
## Acceptance
- Each workspace reads, writes, tests, deletes, and health-checks exactly one
GitLab host/auth configuration. All GitLab clients resolve from the
authoritative workspace ID, and valid `http://`/`https://` self-managed
origins preserve their configured scheme through every provider path.
- Legacy global host/token data migrates idempotently to the active or earliest
workspace; copying a connection copies a PAT but no watches or task links.
- The GitLab settings and browse pages switch connections with the active
workspace and never display or use another workspace's status.
## Verification
```bash
cd apps/backend && rtk go test ./internal/gitlab/... ./internal/backendapp/...
cd apps && rtk pnpm --filter @kandev/web test -- --run lib/api/domains/gitlab-api.test.ts components/gitlab/gitlab-settings.test.tsx components/integrations/integration-copy-config.test.ts hooks/domains/gitlab/use-gitlab-status.test.ts
cd apps/web && rtk pnpm run typecheck
```
## Files Likely Touched
- `apps/backend/internal/gitlab/models.go`
- `apps/backend/internal/gitlab/store.go`
- `apps/backend/internal/gitlab/store_config.go` (new)
- `apps/backend/internal/gitlab/store_config_test.go` (new)
- `apps/backend/internal/gitlab/service.go`
- `apps/backend/internal/gitlab/service_config.go` (new)
- `apps/backend/internal/gitlab/service_config_test.go` (new)
- `apps/backend/internal/gitlab/copy.go` (new)
- `apps/backend/internal/gitlab/factory.go`
- `apps/backend/internal/gitlab/factory_test.go`
- `apps/backend/internal/gitlab/provider.go`
- `apps/backend/internal/gitlab/provider_test.go`
- `apps/backend/internal/gitlab/controller.go`
- `apps/backend/internal/gitlab/controller_config.go` (new)
- `apps/backend/internal/gitlab/controller_config_test.go` (new)
- `apps/backend/internal/gitlab/controller_watches.go`
- `apps/backend/internal/gitlab/handlers.go`
- `apps/backend/internal/gitlab/poller.go`
- `apps/backend/internal/gitlab/service_search.go`
- `apps/backend/internal/gitlab/service_watches.go`
- `apps/backend/internal/gitlab/service_issue_watches.go`
- `apps/backend/internal/backendapp/services.go`
- `apps/backend/internal/backendapp/gitlab_service_test.go`
- `apps/web/lib/types/gitlab.ts`
- `apps/web/lib/api/domains/gitlab-api.ts`
- `apps/web/lib/api/domains/gitlab-api.test.ts`
- `apps/web/components/gitlab/gitlab-settings.tsx`
- `apps/web/components/gitlab/gitlab-settings.test.tsx`
- `apps/web/components/integrations/integration-copy-config.ts`
- `apps/web/components/integrations/integration-copy-config.test.ts`
- `apps/web/components/integrations/integrations-menu.tsx`
- `apps/web/hooks/domains/gitlab/use-gitlab-status.ts`
- `apps/web/hooks/domains/gitlab/use-gitlab-status.test.ts` (new)
- `apps/web/app/gitlab/gitlab-page-client.tsx`
## Dependencies
None.
## Inputs
- Spec: `What` workspace connection bullets, `gitlab_configs`, Connection API,
Connection health, Permissions, Persistence guarantees.
- ADR: `docs/decisions/0030-workspace-scoped-integration-settings.md`.
- Patterns: `apps/backend/internal/jira/{store.go,service.go,provider.go,copy.go,handlers.go}`,
`apps/backend/internal/linear/`, and
`apps/web/components/integrations/integration-copy-config.ts`.
- Constraint: keep `GITLAB_TOKEN` as an explicit environment fallback only;
never serialize a secret value or authenticated URL.
- Constraint: do not upgrade or reject an existing `http://` self-managed host;
normalize origin/trailing slash while preserving its scheme.
## Output Contract
Report the config schema/migration, client resolution boundary, compatibility
surface removed or retained, frontend workspace behavior, files changed, tests
run, blockers, and residual credential-isolation risks. Mark this task `done`
and update `plan.md` only after targeted verification passes.