{
  "service": "ai-test-aggregator",
  "summary": "Agregator wynikow testow dla agentow AI. Przyjmuje wynik pojedynczego uruchomienia testu i zapisuje go w bazie Firestore. Nowy projekt i nowy test tworza sie automatycznie przy pierwszym wyniku. Jeden test mozna uruchamiac wielokrotnie - kazde uruchomienie to osobny wynik.",
  "capabilities": [
    "zapis wyniku testu: projekt, test, timestamp, status, JSON z przebiegiem",
    "lista projektow",
    "lista testow w projekcie (z licznikami statusow)",
    "lista wynikow testu albo calego projektu, takze filtrowana po statusie",
    "pobranie jednego wskazanego wyniku albo wszystkich wynikow z pelnym przebiegiem"
  ],
  "accepts": {
    "endpoint": "POST https://tests.mtzn.pl/results",
    "contentType": "application/json",
    "fields": {
      "project": "tekst - nazwa projektu",
      "test": "tekst lub liczba - nazwa albo numer testu",
      "timestamp": "ISO 8601 albo epoch (sekundy lub milisekundy)",
      "status": "sukces | porazka | blad",
      "run": "obiekt lub tablica JSON z przebiegiem testu"
    },
    "details": "https://tests.mtzn.pl/help/submit"
  },
  "authentication": {
    "required": "Kazde zadanie poza instrukcjami (/, /help/*, /tools/*) wymaga klucza w naglowku X-API-Key.",
    "whereIsTheKey": "Klucz jest w Google Secret Manager, projekt \"siiami-456908\" (siiami), sekret \"test-aggregator-api-key\". Zaloguj sie do tego projektu przez gcloud CLI albo kluczem konta serwisowego (API) i pobierz sekret.",
    "storeItIn": "Zapisz klucz w pliku .env projektu, nad ktorym pracujesz, jako TEST_AGGREGATOR_API_KEY. Nigdy nie wpisuj go w kod ani testy.",
    "details": "https://tests.mtzn.pl/help/auth"
  },
  "steps": [
    "1. Przeczytaj https://tests.mtzn.pl/help/auth i pobierz klucz z Secret Manager.",
    "2. Zapisz klucz w .env zgodnie z https://tests.mtzn.pl/help/env i uruchom test bezpieczenstwa.",
    "3. Wysylaj wyniki wedlug https://tests.mtzn.pl/help/submit.",
    "4. Odczytuj dane wedlug https://tests.mtzn.pl/help/read."
  ],
  "moreDetails": {
    "https://tests.mtzn.pl/help/auth": "Skad wziac klucz API i jak go przesylac",
    "https://tests.mtzn.pl/help/submit": "Schemat zapisu wyniku testu (POST /results) i odpowiedz",
    "https://tests.mtzn.pl/help/read": "Odczyt: projekty, testy, wyniki, filtrowanie po statusie, stronicowanie",
    "https://tests.mtzn.pl/help/env": "Zasady przechowywania klucza w .env i obowiazkowy test bezpieczenstwa",
    "https://tests.mtzn.pl/help/errors": "Format bledow i kody odpowiedzi"
  }
}