feat: initial commit

2026-08-29 13:17:59 +02:00
commit 142f5f5759
91 changed files with 6155 additions and 0 deletions
@@ -0,0 +1,41 @@
+---
+name: repo-recon
+description: Rozpoznanie repozytorium przed zmianą - ustalenie systemu budowania, menedżera zależności, komendy testowej, miejsc użycia biblioteki i realnego promienia rażenia zmiany. Użyj zawsze jako pierwszy krok migracji, upgrade'u SDK lub większego refaktoru.
+license: Apache-2.0
+metadata:
+  owner: pubi-platform
+  version: "1.0.0"
+---
+
+# Rozpoznanie repozytorium
+
+Celem jest **fakt, nie domysł**. Każde stwierdzenie w raporcie musi wynikać z odczytanego pliku
+lub wyniku wyszukiwania.
+
+## Procedura
+
+1. **System budowania i menedżer zależności** - sprawdź w tej kolejności:
+   `pyproject.toml`, `requirements*.txt`, `setup.cfg`, `pom.xml`, `build.gradle*`, `package.json`,
+   `go.mod`. Zanotuj plik, który realnie deklaruje wersję biblioteki (może być więcej niż jeden -
+   np. `pyproject.toml` + `constraints.txt`).
+2. **Aktualna wersja pakietu** - odczytaj dosłownie zapis wersji (`==`, `~=`, `^`, zakres).
+   Zapis ma znaczenie: `~=1.4` migruje się inaczej niż `==1.4.2`.
+3. **Miejsca użycia** - `search_repo` po nazwie modułu importu (uwaga: nazwa pakietu
+   dystrybucyjnego bywa inna niż nazwa modułu, np. `acme-sdk` -> `import acme`).
+   Zbierz: pliki, symbole (klasy, metody), liczbę wystąpień.
+4. **Komenda weryfikacji** - znajdź jak repozytorium się testuje: sekcja `[tool.pytest.ini_options]`,
+   `Makefile`, `tox.ini`, `.gitlab-ci.yml` (tylko do odczytu!). Jeśli brak - zaraportuj brak,
+   nie wymyślaj komendy.
+5. **Promień rażenia** - oceń, czy użycia są skupione w warstwie adaptera (niskie ryzyko),
+   czy rozlane po kodzie domenowym (wysokie ryzyko).
+
+## Wynik
+
+Zwróć strukturę zgodną ze schematem `RepoProfile`. Pola, których nie udało się ustalić,
+oznaczaj jako `null` i wypisz w `gaps` - to sygnał dla planisty, że potrzebna jest decyzja człowieka.
+
+## Antywzorce
+
+- Zgadywanie komendy testowej ("pewnie pytest") - jeśli nie ma dowodu, wpisz `gaps`.
+- Pomijanie plików lock (`poetry.lock`, `package-lock.json`) - one też pinują wersję.
+- Raportowanie użyć na podstawie samej nazwy pakietu bez sprawdzenia aliasów importu.