kandev/docs/plans/gitlab-workflow-sync/task-01-gitlab-repo-content-client.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
01-gitlab-repo-content-client	GitLab client repository-content methods	done	1		plan.md	../../specs/gitlab-workflow-sync/spec.md

Task 01: GitLab Client Repository-Content Methods

Acceptance

1. gitlab.Client exposes ListRepoTree(ctx, projectPath, path, ref string) ([]RepoTreeEntry, error) and GetRepoFileContent(ctx, projectPath, path, ref string) ([]byte, error), implemented by PATClient (REST), MockClient (seedable), and NoopClient (not-configured error). GLabClient inherits via its embedded *PATClient and needs no change.
2. PATClient.ListRepoTree targets GET /projects/:id/repository/tree with a non-recursive listing, percent-encodes the full projectPath as one path segment (so group/subgroup/project resolves), and follows pagination until exhausted. GetRepoFileContent targets GET /projects/:id/repository/files/:file_path/raw?ref=<ref> with the file path percent-encoded.
3. RepoTreeEntry carries at least Name, Path, and Type ("blob" / "tree"), and 404/403 responses surface as errors distinguishable enough for callers to wrap with context.

Verification

cd apps/backend && go test ./internal/gitlab/... -race

Files Likely Touched

• apps/backend/internal/gitlab/models.go — RepoTreeEntry.
• apps/backend/internal/gitlab/client.go — interface methods.
• apps/backend/internal/gitlab/pat_client.go — REST implementation.
• apps/backend/internal/gitlab/mock_client.go — in-memory implementation.
• apps/backend/internal/gitlab/noop_client.go — stubs.
• apps/backend/internal/gitlab/pat_client_test.go (or a new pat_client_repo_contents_test.go).

Inputs

• Spec ## API Surface → ### gitlab.Client.
• ListProjectBranches at pat_client.go:531 is the closest existing REST method — mirror its endpoint construction, projectRef() helper usage, pagination, and error handling.
• All Client methods take projectPath (never owner+repo); match that.

Risks

• Nested subgroup paths silently 404 if projectRef() does not encode the full path as a single segment. Cover with an explicit multi-segment test.
• A directory larger than one page truncates the synced workflow set. Paginate and assert it in a test.

Output Contract

Four GitLab client implementations compile against the extended interface, with tests covering nested paths, pagination, and the not-found path. No consumer outside internal/gitlab changes in this task.