GitLab

Integracja z platformą GitLab umożliwia Speedwave bezpośrednią współpracę z serwisem GitLab.com oraz instalacjami self-hosted: przeglądanie kodu, analizę git blame na poziomie wierszy, obsługę merge requestów, inspekcję logów potoków CI/CD oraz zarządzanie zgłoszeniami.

Architektura i separacja poświadczeń

GitLab działa w odrębnym kontenerze workera. Dane konfiguracyjne znajdują się w katalogu ~/.speedwave/tokens/<projekt>/gitlab/ (zawierając adres instancji oraz token Personal Access Token) i są montowane do kontenera w trybie tylko do odczytu.

Adres instancji jest rozwiązywany w kolejności: zapisany plik konfiguracyjny, zmienna środowiskowa GITLAB_URL lub domyślny adres https://gitlab.com.

Żądania z sesji Claude trafiają przez bezstanowy Tool Gateway bezpośrednio do workera GitLab.

Zestawienie narzędzi

Worker GitLab udostępnia 46 operacji:

Repozytoria i analiza kodu

Narzędzie	Zakres działania
`listProjectIds`, `getProjectFull`	Lista dostępnych projektów oraz odczyt pełnych metadanych wybranego repozytorium.
`searchCode`	Wyszukiwanie kodu w dostępnych projektach lub pojedynczym repozytorium.
`getTree`, `getFile`	Przeglądanie drzewa plików oraz odczyt zawartości pliku.
`getBlame`	Odczyt historii modyfikacji poszczególnych linii kodu (git blame).
`listBranches`, `getBranch`, `compareBranches`	Wykaz gałęzi, pobieranie szczegółów oraz porównywanie commitów między gałęziami.
`createBranch`	Tworzenie nowej gałęzi z podanej referencji.
`deleteBranch`	Usuwanie niechronionej gałęzi.
`listCommits`, `listBranchCommits`, `getCommitDiff`	Przegląd historii commitów z filtrami oraz pobieranie ujednoliconych diffów.
`searchCommits`	Wyszukiwanie w treściach wiadomości commitów.

Obsługa merge requestów

Narzędzie	Zakres działania
`listMrIds`, `getMrFull`, `getMrChanges`	Przegląd merge requestów, odczyt pełnych danych oraz pobieranie diffa zmian.
`createMergeRequest`, `updateMergeRequest`	Tworzenie nowych merge requestów oraz edycja istniejących.
`approveMergeRequest`	Zatwierdzanie merge requestów.
`mergeMergeRequest`	Scalanie merge requestów z opcją squash i usuwania gałęzi źródłowej.
`listMrCommits`, `listMrPipelines`	Wykaz commitów i potoków powiązanych z merge requestem.
`listMrNotes`, `createMrNote`	Odczyt i dodawanie komentarzy ogólnych pod merge requestem.
`listMrDiscussions`, `createMrDiscussion`	Odczyt oraz inicjowanie wątków dyskusyjnych w przeglądzie zmian.

Potoki CI/CD i zgłoszenia

Narzędzie	Zakres działania
`listPipelineIds`, `getPipelineFull`	Lista wykonań potoków CI oraz odczyt statusu zadań.
`getJobLog`	Pobieranie logów konsolowych wybranego zadania CI.
`retryPipeline`	Ponowienie nieudanego potoku CI/CD.
`triggerPipeline`	Ręczne uruchomienie potoku na wybranej gałęzi.
`listArtifacts`, `downloadArtifact`	Przegląd i pobieranie artefaktów wygenerowanych w zadaniach.
`deleteArtifacts`	Czyszczenie archiwów artefaktów.
`listIssues`, `getIssue`	Przegląd i pobieranie szczegółów zgłoszeń w projekcie.
`createIssue`, `updateIssue`, `closeIssue`	Tworzenie, edycja oraz zamykanie zgłoszeń.
`listLabels`, `createLabel`	Zarządzanie etykietami projektu.
`createTag`, `deleteTag`	Tworzenie i usuwanie tagów Git.
`createRelease`	Tworzenie oficjalnych wydań GitLab Releases na podstawie tagów.

Konfiguracja

W aplikacji Desktop otwórz projekt i przejdź do widoku Integracje -> GitLab.
Wprowadź Adres GitLaba (https://gitlab.com lub adres własnego serwera https://gitlab.example.com).
Wygeneruj token Personal Access Token (prefiks glpat-) z uprawnieniami api, read_repository oraz write_repository w profilu GitLab.
Wklej token w formularzu i zapisz ustawienia.

Bezpieczeństwo

Worker GitLaba operuje wyłącznie na swoim tokenie zamontowanym w trybie tylko do odczytu. Tool Gateway nie przechowuje poświadczeń. Wszelkie operacje podlegają uprawnieniom konta powiązanego z tokenem oraz regułom chronionych gałęzi i tagów w GitLabie. Szczegóły znajdziesz w rozdziale Zarządzanie poświadczeniami.