skills/gitea-skill-expert-it/SKILL.md

---
name: gitea-skill-expert-it
description: >-
  Połączenie z Gitea Expert-IT (gitea.expert-it.agency-ai.dev): credentials,
  clone, pull, push, API. Używaj na początku nowej sesji agenta przy pracy z
  repozytoriami na tym hoście Gitea.
---

# Gitea Expert-IT — skill operacyjny

**Instancja:** https://gitea.expert-it.agency-ai.dev  
**API base:** `https://gitea.expert-it.agency-ai.dev/api/v1/`  
**Wersja Gitea:** 1.26.x  
**Właściciel repozytoriów (user/org):** `tomasz-syn-grzegorza`

---

## Credentials (lokalna maszyna dev)

| Pole | Wartość |
|------|---------|
| **Gitea user** | `tomasz-syn-grzegorza` |
| **Gitea PAT** | z `~/.git-credentials` (lokalnie; **nie commituj** do git) |
| **Plik zapisu** | `~/.git-credentials` (chmod 600) |
| **Git credential helper** | `store` |

### Szybki export (każda nowa sesja terminala / agenta)

```bash
export GITEA_USER="tomasz-syn-grzegorza"
export GITEA_PAT="$(python3 - <<'PY'
import re, pathlib
c = pathlib.Path.home() / ".git-credentials"
for line in c.read_text().splitlines():
    m = re.search(r"gitea\.expert-it\.agency-ai\.dev.*:([^@]+)@", line)
    if m:
        print(m.group(1))
        break
PY
)"
export GITEA_BASE="https://gitea.expert-it.agency-ai.dev"
export GITEA_API="$GITEA_BASE/api/v1"
```

**Nigdy nie commituj PAT do git.** Ten plik leży poza repozytoriami projektów (`Pulpit/cursor/`).

### Nagłówek API (obowiązkowy format)

```
Authorization: token $GITEA_PAT
```

**NIE używaj** `Bearer` — Gitea zwróci 401.

---

## Znane repozytoria

| Projekt | Repo | Lokalna ścieżka (dev) |
|---------|------|------------------------|
| One Gateway | `tomasz-syn-grzegorza/one-gateway` | `/home/tomasz-syn-grzegorza/Pulpit/cursor/one-gateway` |
| Site Slavic Pulse | `tomasz-syn-grzegorza/site-slavic-pulse-com` | `/home/tomasz-syn-grzegorza/Pulpit/cursor/site-slavic-pulse-com` |
| Site Agencja AI | `tomasz-syn-grzegorza/site-agencja-ai-com` | `/home/tomasz-syn-grzegorza/Pulpit/cursor/site-agencja-ai-com` |
| Cursor Deploy Appwrite | `tomasz-syn-grzegorza/cursor-deploy-appwrite` | `/home/tomasz-syn-grzegorza/Pulpit/docker/cursor-deploy-appwrite` |

URL klonowania (HTTPS):

```
https://gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/<repo>.git
```

---

## Procedura agenta — nowa sesja

1. **Załaduj credentials**
   ```bash
   export GITEA_USER="tomasz-syn-grzegorza"
   export GITEA_PAT="$(python3 - <<'PY'
import re, pathlib
c = pathlib.Path.home() / ".git-credentials"
for line in c.read_text().splitlines():
    m = re.search(r"gitea\.expert-it\.agency-ai\.dev.*:([^@]+)@", line)
    if m:
        print(m.group(1))
        break
PY
)"
   export GITEA_BASE="https://gitea.expert-it.agency-ai.dev"
   ```

2. **Wejdź do projektu**
   ```bash
   cd /home/tomasz-syn-grzegorza/Pulpit/cursor/one-gateway   # lub inny projekt z tabeli
   ```

3. **Sprawdź stan**
   ```bash
   git status -sb
   git fetch origin
   git log origin/main..HEAD --oneline    # lokalne commity nie na serwerze
   ```

4. **Pobierz zmiany (pull)**
   ```bash
   git pull --rebase origin main
   ```
   Dla repo ze gałęzią `master`: `git pull --rebase origin master`

5. **Wypchnij zmiany (push)** — tylko gdy użytkownik poprosi o commit/push
   ```bash
   git add <pliki>
   git commit -m "opis zmian"
   git push -u origin main
   ```

6. **Jeśli push wisi** (brak promptu hasła)
   ```bash
   git remote set-url origin "https://$GITEA_USER:$GITEA_PAT@gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/one-gateway.git"
   git push -u origin main
   git remote set-url origin "https://gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/one-gateway.git"
   ```

---

## Clone (pierwszy raz)

```bash
cd /home/tomasz-syn-grzegorza/Pulpit/cursor
git clone "https://$GITEA_USER:$GITEA_PAT@gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/one-gateway.git"
cd one-gateway
git remote set-url origin "https://gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/one-gateway.git"
```

Publiczne repo można klonować bez tokenu; prywatne wymagają PAT w URL lub `credential.helper store`.

---

## API — typowe operacje

### Sprawdź repo

```bash
curl -sS "$GITEA_API/repos/tomasz-syn-grzegorza/one-gateway" \
  -H "Authorization: token $GITEA_PAT" | python3 -m json.tool
```

### Utwórz repo

```bash
curl -sS -X POST "$GITEA_API/user/repos" \
  -H "Authorization: token $GITEA_PAT" \
  -H "Content-Type: application/json" \
  -d '{"name":"nowy-projekt","description":"...","private":false}'
```

Endpoint **`/api/v1/user/repos`** — nie `/repos/create` (404).

### Zmień nazwę repo

```bash
curl -sS -X PATCH "$GITEA_API/repos/tomasz-syn-grzegorza/stara-nazwa" \
  -H "Authorization: token $GITEA_PAT" \
  -H "Content-Type: application/json" \
  -d '{"name":"nowa-nazwa"}'
```

### Container registry (obrazy Docker)

```
gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/<image>:latest
```

Logowanie (CI / lokalnie):

```bash
echo "$GITEA_PAT" | docker login gitea.expert-it.agency-ai.dev -u "$GITEA_USER" --password-stdin
```

Sekrety CI w repo (Gitea Actions): `GITEA_USER`, `GITEA_TOKEN` — ustawiane w ustawieniach repo, nie w git.

---

## Gałęzie i konwencja

| Gałąź | Zastosowanie |
|-------|----------------|
| `main` | One Gateway, większość projektów |
| `master` | site-slavic-pulse-com, site-agencja-ai-com |
| `feature/*` | nowe funkcje |
| `fix/*` | poprawki |
| `infra/*` | docker, deploy, CI |

Przed pracą: `git pull`. Po pracy: commit + push tylko na prośbę użytkownika.

---

## Pułapki

1. **Auth:** `Authorization: token <PAT>` — nie `Bearer`
2. **Create repo:** `POST /api/v1/user/repos` — nie `/repos/create`
3. **SSH:** na niektórych hostach zablokowany — używaj HTTPS
4. **LRC hook (Hermes):** przed pierwszym commitem w nowym repo: `mkdir -p .git/lrc && touch .git/lrc/disabled-git`
5. **Nie commituj:** `.env` z sekretami, PAT, RTX API keys
6. **Stara nazwa:** `one-gateway-cursor` została przemianowana na **`one-gateway`**

---

## Checklist push (agent)

- [ ] `git status` — świadomie wybrane pliki (bez `.env`, bez sekretów)
- [ ] `git diff` — sensowny zakres zmian
- [ ] commit message opisuje *dlaczego*
- [ ] `git push origin <branch>`
- [ ] po pushu: `git status -sb` → bez `ahead`

---

## Powiązane pliki w projektach

| Plik | Opis |
|------|------|
| `cursor/one-gateway/GITEA.md` | Push one-gateway |
| `cursor/one-gateway/packages/agency-gitea-collaboration/SKILL.md` | Protokół Hermes + Cursor |
| `cursor/one-gateway/deploy/docs/INSTALL.md` | Instalacja produkcyjna |

---

*Skill lokalny — credentials z `~/.git-credentials`. Nie commituj tego pliku do publicznych repo.*